WebOS Internals - User contributions [en]

USBnet Setup

2011-03-19T03:56:44Z

Sgonzalez: /* Mac OS X */

= Introduction =
USBnet allows you to create an IP network over the USB cable. This will allow you to talk to your WebOS Device without WiFi or Bluetooth, and it keeps the battery charged.

== Device Setup ==
=== With Linux Access to Your Device ===

''To enable Linux Access to your device, see [[Portal:Accessing_Linux|Accessing Linux]]''

# Run '''usbnet enable''' as root.
# Restart the device as instructed.
# After the reboot, run '''ifconfig''' as root and verify you now have a usb0 interface.
#* Note the IP Address listed, it is needed in the Computer Setup. The default should be 192.168.0.202.
#* If desired, the IP can be changed in /etc/network/interfaces.
#** After a change, run ''''ifdown usb0; ifup usb0'' as root to pick up the change.

==== Optional Setup to enable DHCP ====
If you do not want to have to manually setup the network on your computer, do the following to enable the DHCP server on your device to serve requests on the usb0 interface.
# Open ''/etc/dnsmasq.palm.conf'' in your editor of choice.
#* '''vi''' is available on a stock WebOS Device, for a quick tutorial on its use, see: http://www.unix-manuals.com/tutorials/vi/vi-in-10-1.html
# Add '''interface=usb0''' below the existing interface line.
# Add '''dhcp-range=192.168.0.11,192.168.0.12,12h''' below the existing dhcp-range.
# Run '''stop dnsmasq; start dnsmasq''' as root to apply the changes.

== Computer Setup ==
=== Microsoft Windows ===
''Note: If you have previously installed Novacom, bring up Windows Task Manager before proceeding. Once you install USBnet with the instructions below, you may discover a conflict between USBnet and novacomd where the novacomd process will consume lots of CPU and your machine will become very unresponsive. Since you have Task Manager up already, you can easily use it to kill novacomd if this occurs.''
==== Windows XP ====
===== Driver Installation =====
#Download the driver here: [http://gitorious.org/webos-internals/usbnet-pre/blobs/raw/master/windows/usbnet-pre.inf usbnet-pre windows driver(32 bit)] or [http://gitorious.org/webos-internals/usbnet-pre/blobs/raw/master/windows/usbnet-pre-64.inf usbnet-pre windows driver(64 bit)] and save the file to disk as usbnet-pre.inf
#Plug the Pre into your computer. The Add New Hardware Wizard should come up, asking to install an ethernet gadget.
#Follow detailed instructions (screenshots and all) here if you are unfamiliar with installing drivers: [http://docwiki.gumstix.org/index.php/Windows_XP_usbnet Windows XP USBnet install]
#When you finish, you should have a new network icon in "Network Connections"
===== Network Setup =====
#Goto "Network Connections" via Network Places or the Control Panel
#Right-click on the new network, which probably be named Local Area Connection 2
#Select Properties
#Double click on Internet Protocol (TCP/IP)
#Click Advanced
#Un-check Automatic metric, put 100 in its place. This will keep Windows from attempting to [http://support.microsoft.com/default.aspx/kb/299540 route] traffic over the Pre (it won't work anyway). Note: 100 may be too high. If it seems that network traffic is being routed to the pre (IE - your internet connection apparently dies), try setting this to something lower (like 60).
#Click OK
===== Setting the IP Address Manually =====
# If you did not enable DHCP, you will need to set an IP address manually:
## Set your IP address as 192.168.0.203
##* This could be anything except the IP address of the WebOS device's usb0 interface, if you changed the IP Address of the device, make sure to choose an IP address on the same subnet.
## Subnet mask: 255.255.255.0
## Default Gateway: 192.168.0.202
##* This should be the IP address of the WebOS device's usb0 interface, if you changed the IP Address of the device, make sure to use that.
## Set DNS to your preferred servers.
# Hit OK
===== Testing the Connection =====
The network should now be setup. To verify the connection, ssh to the IP Address of your WebOS device's usb0 interface. If unchanged it should be 192.168.0.202. If everything is setup properly, you should be prompted for a login.

===== Notes =====

* This has only been tested on Windows XP 32 bit. For Windows 2000, you will need an additional download from Microsoft. The link is in the header of the INF file.
* I have several confirmations via the precentral forums that this only works on XP SP3. SP2 gives "error code 10, the device cannot start". Has anyone followed this process and had it work on XP SP2? Update: Upgraded to SP3 on my laptop, and it immediately started working. ''- zinge''
* The 64 bit driver is unverified at this point, but I think it works.
* I was having all kinds of issues with this on my WinXP notebook. Clicking on the safely remove hardware icon in the tray indicated two devices associated with the Pre: Novacom and a USB drive. Stopping the Novacom service resolved the issues. Note that I need to do this each time that I attach the Pre via USB. ''- wayne47''
* In Step 9. UNCheck Automatic metric, put 100 in its place. ''- Sniperlcd''
** I put 100 and it didn´t work, but when i put 10, it worked.... i think metric should be 10

==== Windows Vista (64-bit) ====

* If driver/device fails to come online in network sharing center, go to ''Start->(Right Click) Computer->Properties->Device Manager'' and look for the device "Linux USB Ethernet/RNDIS Gadget" you can then right click and disable/enable the device.
* This device/driver can also be cycled with MS Windows own [http://support.microsoft.com/kb/311272 DevCon] application.
* For network setup and testing, see the relevant sections under Windows XP.

==== Windows 7 (64-bit) ====

* Windows 7 has the driver it needs already, but it won't set it up by itself. The driver you want is under "Microsoft Corporation" > "Remote NDIS based Internet Sharing Device.". See http://mytether.net/#other for complete directions.
* For network setup and testing, see the relevant sections under Windows XP.

==== Windows 7 RC Build 7100 (64-bit) ====

* User lars47 confirms this is working on Windows 7 x64. Wrestled with the driver installation at first, it would not install, Windows complained of a file in use. I rebooted, and the next time I plugged in the Pre via USB, it "just worked". Unsure if I caused the problem, or if a reboot is required/recommended.
* For network setup and testing, see the relevant sections under Windows XP.

=== Apple MacOS ===
==== Mac OS X ====

* [[User:mdklein|mdklein]] notes that as of 1.0.4 the g_composite driver appears to only operate usbnet in rndis mode which is not the method OS-X includes. He has made a version that implements CDC-ECM, but it breaks a few other things. Working on this.
* Allegedly, Mac OS X 10.4 should create a usb0 interface after you plug in a usbnet enabled pre. 10.5 needs a modified driver, which is not working for me (and carazy) yet. See [http://bugcommunity.com/wiki/index.php/Start_Guide_Mac_OS_X_10.5 this page] for more details.
* I don't know of anyone that has gotten USBNet driver to work on Mac OSX at all so for the time being, count it as unsupported. If anyone can figure it out please shed some light on us.
* MacOS X does not directly support RNDIS. The link provided is for a CDC Ethernet driver with a system-specific patch, which won't work.
* Both [http://mac.eltima.com/sync-mac.html Syncmate] and [http://www.markspace.com/products/windowsmobile/mac/windows-mobile-sync-software.html Missing Sync] appear to provide a RNDIS driver to access WinCE devices, which '''does not''' work with the Pre/Pixi. Someone should investigate.

=== GNU/Linux ===
==== Ubuntu ====
* Once usbnet was enabled on the Pre, my Ubuntu 9.04 (64 bit) immediately identified the Pre in the NetworkManager and worked without modification to the OS. It seems to already have a driver that works.
* In order to prevent Ubuntu Linux from automatically trying to connect to the internet while the phone is connected via USBnet:
** In the Network Manager icon, click "Edit Connections"
** Select the usb0 interface and select "Edit"
** Uncheck the box that says "Connect Automatically" (this is optional, but could prevent headaches)
** Under IPv4 Settings select Routes
*** Check the box next to "Use this connection only for resources on its network"
** Click Ok, Apply. Now you should be able to access your regular wifi/lan/internet
==== Gentoo ====
* If you are using a default kernel, and you enabled DHCP on the WebOS Device, this should work out of the box.
** Simply run as root dhcpcd usb0 once the device is connected.
** If you did not enable DHCP, see the Windows XP section for the relevant TCP/IP information.
* If you are using a custom kernel, make sure you have usbnet, cdc_ether and rndis_host either compiled-in or available as modules. The relevant kernel options are (from kernel 2.6.36-gentoo-r5):
Modules: usbnet cdc_ether rndis_host
Kernel Options:
Device Drivers --->
[*] Network device support --->
USB Network Adapters --->
<M> Multi-purpose USB Networking Framework
<M> CDC Ethernet support (smart devices such as cable modems)
<M> Host for RNDIS and ActiveSync devices (EXPERIMENTAL)

Application talk:FreeTether

2011-03-17T12:05:25Z

Sgonzalez:

* I reworked the USBnet page a bit, if possible you should mention that the reader should see the 'Computer Setup' section, also you could link directly to it via [[USBnet_Setup#Computer_Setup]] --[[User:Sgonzalez|Sgonzalez]] 12:05, 17 March 2011 (UTC)
* Also, I kinda get the desire to keep the talk page empty, but you should at least leave up a blurb that you have assumed maintainership of this page and that you would like all changes to be discussed here prior to them being made, to avoid problems in the future. --[[User:Sgonzalez|Sgonzalez]] 12:05, 17 March 2011 (UTC)

Talk:USBnet networking setup

2011-03-17T12:01:20Z

Sgonzalez:

* This page seems to be a duplicate of http://www.webos-internals.org/wiki/USBnet_Setup
* I read through both pages and concur, changing this page to a redirect [[User:Sgonzalez|Sgonzalez]]

Talk:USBnet networking setup

2011-03-17T12:01:08Z

Sgonzalez:

This page seems to be a duplicate of http://www.webos-internals.org/wiki/USBnet_Setup
I read through both pages and concur, changing this page to a redirect [[User:Sgonzalez|Sgonzalez]]

USBnet networking setup

2011-03-17T12:00:23Z

Sgonzalez: Redirce to USBnet_setup, all information is available there

#REDIRECT [[USBnet_Setup]]

USBnet Setup

2011-03-17T11:59:47Z

Sgonzalez: General cleanup, formatting, created more logical sections

= Introduction =
USBnet allows you to create an IP network over the USB cable. This will allow you to talk to your WebOS Device without WiFi or Bluetooth, and it keeps the battery charged.

== Device Setup ==
=== With Linux Access to Your Device ===

''To enable Linux Access to your device, see [[Portal:Accessing_Linux|Accessing Linux]]''

# Run '''usbnet enable''' as root.
# Restart the device as instructed.
# After the reboot, run '''ifconfig''' as root and verify you now have a usb0 interface.
#* Note the IP Address listed, it is needed in the Computer Setup. The default should be 192.168.0.202.
#* If desired, the IP can be changed in /etc/network/interfaces.
#** After a change, run ''''ifdown usb0; ifup usb0'' as root to pick up the change.

==== Optional Setup to enable DHCP ====
If you do not want to have to manually setup the network on your computer, do the following to enable the DHCP server on your device to serve requests on the usb0 interface.
# Open ''/etc/dnsmasq.palm.conf'' in your editor of choice.
#* '''vi''' is available on a stock WebOS Device, for a quick tutorial on its use, see: http://www.unix-manuals.com/tutorials/vi/vi-in-10-1.html
# Add '''interface=usb0''' below the existing interface line.
# Add '''dhcp-range=192.168.0.11,192.168.0.12,12h''' below the existing dhcp-range.
# Run '''stop dnsmasq; start dnsmasq''' as root to apply the changes.

== Computer Setup ==
=== Microsoft Windows ===
''Note: If you have previously installed Novacom, bring up Windows Task Manager before proceeding. Once you install USBnet with the instructions below, you may discover a conflict between USBnet and novacomd where the novacomd process will consume lots of CPU and your machine will become very unresponsive. Since you have Task Manager up already, you can easily use it to kill novacomd if this occurs.''
==== Windows XP ====
===== Driver Installation =====
#Download the driver here: [http://gitorious.org/webos-internals/usbnet-pre/blobs/raw/master/windows/usbnet-pre.inf usbnet-pre windows driver(32 bit)] or [http://gitorious.org/webos-internals/usbnet-pre/blobs/raw/master/windows/usbnet-pre-64.inf usbnet-pre windows driver(64 bit)] and save the file to disk as usbnet-pre.inf
#Plug the Pre into your computer. The Add New Hardware Wizard should come up, asking to install an ethernet gadget.
#Follow detailed instructions (screenshots and all) here if you are unfamiliar with installing drivers: [http://docwiki.gumstix.org/index.php/Windows_XP_usbnet Windows XP USBnet install]
#When you finish, you should have a new network icon in "Network Connections"
===== Network Setup =====
#Goto "Network Connections" via Network Places or the Control Panel
#Right-click on the new network, which probably be named Local Area Connection 2
#Select Properties
#Double click on Internet Protocol (TCP/IP)
#Click Advanced
#Un-check Automatic metric, put 100 in its place. This will keep Windows from attempting to [http://support.microsoft.com/default.aspx/kb/299540 route] traffic over the Pre (it won't work anyway). Note: 100 may be too high. If it seems that network traffic is being routed to the pre (IE - your internet connection apparently dies), try setting this to something lower (like 60).
#Click OK
===== Setting the IP Address Manually =====
# If you did not enable DHCP, you will need to set an IP address manually:
## Set your IP address as 192.168.0.203
##* This could be anything except the IP address of the WebOS device's usb0 interface, if you changed the IP Address of the device, make sure to choose an IP address on the same subnet.
## Subnet mask: 255.255.255.0
## Default Gateway: 192.168.0.202
##* This should be the IP address of the WebOS device's usb0 interface, if you changed the IP Address of the device, make sure to use that.
## Set DNS to your preferred servers.
# Hit OK
===== Testing the Connection =====
The network should now be setup. To verify the connection, ssh to the IP Address of your WebOS device's usb0 interface. If unchanged it should be 192.168.0.202. If everything is setup properly, you should be prompted for a login.

===== Notes =====

* This has only been tested on Windows XP 32 bit. For Windows 2000, you will need an additional download from Microsoft. The link is in the header of the INF file.
* I have several confirmations via the precentral forums that this only works on XP SP3. SP2 gives "error code 10, the device cannot start". Has anyone followed this process and had it work on XP SP2? Update: Upgraded to SP3 on my laptop, and it immediately started working. ''- zinge''
* The 64 bit driver is unverified at this point, but I think it works.
* I was having all kinds of issues with this on my WinXP notebook. Clicking on the safely remove hardware icon in the tray indicated two devices associated with the Pre: Novacom and a USB drive. Stopping the Novacom service resolved the issues. Note that I need to do this each time that I attach the Pre via USB. ''- wayne47''
* In Step 9. UNCheck Automatic metric, put 100 in its place. ''- Sniperlcd''
** I put 100 and it didn´t work, but when i put 10, it worked.... i think metric should be 10

==== Windows Vista (64-bit) ====

* If driver/device fails to come online in network sharing center, go to ''Start->(Right Click) Computer->Properties->Device Manager'' and look for the device "Linux USB Ethernet/RNDIS Gadget" you can then right click and disable/enable the device.
* This device/driver can also be cycled with MS Windows own [http://support.microsoft.com/kb/311272 DevCon] application.
* For network setup and testing, see the relevant sections under Windows XP.

==== Windows 7 (64-bit) ====

* Windows 7 has the driver it needs already, but it won't set it up by itself. The driver you want is under "Microsoft Corporation" > "Remote NDIS based Internet Sharing Device.". See http://mytether.net/#other for complete directions.
* For network setup and testing, see the relevant sections under Windows XP.

==== Windows 7 RC Build 7100 (64-bit) ====

* User lars47 confirms this is working on Windows 7 x64. Wrestled with the driver installation at first, it would not install, Windows complained of a file in use. I rebooted, and the next time I plugged in the Pre via USB, it "just worked". Unsure if I caused the problem, or if a reboot is required/recommended.
* For network setup and testing, see the relevant sections under Windows XP.

=== Apple MacOS ===
==== Mac OS X ====

* [http://www.wikidot.com/user:info/mdklein mdklein] notes that as of 1.0.4 the g_composite driver appears to only operate usbnet in rndis mode which is not the method OS-X includes. He has made a version that implements CDC-ECM, but it breaks a few other things. Working on this.

''*Allegedly, Mac OS X 10.4 should create a usb0 interface after you plug in a usbnet enabled pre. 10.5 needs a modified driver, which is not working for me (and carazy) yet. See [http://bugcommunity.com/wiki/index.php/Start_Guide_Mac_OS_X_10.5 this page] for more details.

''*I don't know of anyone that has gotten USBNet driver to work on Mac OSX at all so for the time being, count it as unsupported. If anyone can figure it out please shed some light on us.

MacOS X does not directly support RNDIS. The link provided is for a CDC Ethernet driver with a system-specific patch, which won't work.

Both [http://mac.eltima.com/sync-mac.html Syncmate] and [http://www.markspace.com/products/windowsmobile/mac/windows-mobile-sync-software.html Missing Sync] appear to provide a RNDIS driver to access WinCE devices, which '''does not''' work with the Pre/Pixi. Someone should investigate.

=== GNU/Linux ===
==== Ubuntu ====
* Once usbnet was enabled on the Pre, my Ubuntu 9.04 (64 bit) immediately identified the Pre in the NetworkManager and worked without modification to the OS. It seems to already have a driver that works.
* In order to prevent Ubuntu Linux from automatically trying to connect to the internet while the phone is connected via USBnet:
** In the Network Manager icon, click "Edit Connections"
** Select the usb0 interface and select "Edit"
** Uncheck the box that says "Connect Automatically" (this is optional, but could prevent headaches)
** Under IPv4 Settings select Routes
*** Check the box next to "Use this connection only for resources on its network"
** Click Ok, Apply. Now you should be able to access your regular wifi/lan/internet
==== Gentoo ====
* If you are using a default kernel, and you enabled DHCP on the WebOS Device, this should work out of the box.
** Simply run as root dhcpcd usb0 once the device is connected.
** If you did not enable DHCP, see the Windows XP section for the relevant TCP/IP information.
* If you are using a custom kernel, make sure you have usbnet, cdc_ether and rndis_host either compiled-in or available as modules. The relevant kernel options are (from kernel 2.6.36-gentoo-r5):
Modules: usbnet cdc_ether rndis_host
Kernel Options:
Device Drivers --->
[*] Network device support --->
USB Network Adapters --->
<M> Multi-purpose USB Networking Framework
<M> CDC Ethernet support (smart devices such as cable modems)
<M> Host for RNDIS and ActiveSync devices (EXPERIMENTAL)

Application talk:FreeTether

2011-03-16T16:26:15Z

Sgonzalez:

===Outdated Info===
With some testing of enabling/disabling usbnet and playing with /etc/dnsmasq.palm.conf as per the USBnet page, it seems that these steps are no longer needed to get USB tethering working. As a result I'm removing this section. [[User:Sgonzalez|Sgonzalez]]

I've been working with the developers of freeTether and getting their insight/blessing on the wiki content. Please consult the developers if you feel that some of the content is not needed in your opinion before removing the content. I understand that wikis are editable for the public, but consideration has to be taken into account whether or not people other than some need that content for help such is the case with setting up USBNet.

The USBnet section is needed for some users that do not know how to get it working. If it works for you out of the box, then there you can just skip that part. Why do you think it does not need to be there?

The USBnet content with reference to enabling usbnet and the dnsmasq edits are not needed. As far as I know this is because it is handled in freetether automatically, so to direct users to muck around with this seems wrong. Outright removal of the link isn;t correct, because it also covers getting the connected computer working, which is still needed, but we should at least indicate either next to the link or on the USBnet page itself that certain steps are not needed for the current version of freeTether. In any event, it would be a good idea to find out from the devs themselves it these steps are in fact deprecated. [[User:Sgonzalez|Sgonzalez]]

Ok. I will edit the Wiki when I get to a computer and rework that section a bit to just discuss its use for setting up the drivers to work with th OS the person may be using. I admit it was not clear about that part. You are correct about freetether already doing the dhcp/dnsmasq stuff.

thanks for your input. Sorry if I came off a bit brash. It was a long day. :)

No problem, just trying to give back a bit in thanks for the FOSS. [[User:Sgonzalez|Sgonzalez]]

Application talk:FreeTether

2011-03-16T12:59:22Z

Sgonzalez:

Application talk:FreeTether

2011-03-16T12:57:33Z

Sgonzalez:

Application talk:FreeTether

2011-03-16T12:57:16Z

Sgonzalez: /* Outdated Info */

USBnet Setup

2011-03-15T20:36:12Z

Sgonzalez: /* Linux Support */

USBnet allows you to create an IP network over the USB cable. This will allow you to talk to your Pre without WiFi or Bluetooth, and it keeps the battery charged.

This page is a duplicate of [[USBnet networking setup]]

== With Linux Access ==

run

'''usbnet enable'''

as root and then restart the device as instructed. When it comes back up, run 'ifconfig' and verify you now have a usb0 interface. Mine had the IP of 192.168.0.202. The IP can be changed in /etc/network/interfaces. After a change, bounce the usb0 interface: ifdown usb0; ifup usb0

== Optional Setup to enable DHCP (so you don't have to set the IP address below) ==

#Edit /etc/dnsmasq.palm.conf
#Add interface=usb0 below the existing interface line
#Add dhcp-range=192.168.0.11,192.168.0.12,12h below the existing dhcp-range
#Restart the dnsmasq process: stop dnsmasq; start dnsmasq

== On Windows XP ==

#Download the driver here: [http://gitorious.org/webos-internals/usbnet-pre/blobs/raw/master/windows/usbnet-pre.inf usbnet-pre windows driver(32 bit)] or [http://gitorious.org/webos-internals/usbnet-pre/blobs/raw/master/windows/usbnet-pre-64.inf usbnet-pre windows driver(64 bit)] and save the file to disk as usbnet-pre.inf
#Plug the Pre into your computer. The Add New Hardware Wizard should come up, asking to install an ethernet gadget.
#Follow detailed instructions (screenshots and all) here if you are unfamiliar with installing drivers: [http://docwiki.gumstix.org/index.php/Windows_XP_usbnet Windows XP USBnet install]
#When you finish, you should have a network setup. Goto "Network Connections" via Network Places or the Control Panel
#If you have previously installed Novacom on this machine, bring up Windows Task Manager before proceeding. You may find discover a conflict between USBnet and novacomd where the novacomd process will consume lots of CPU and your machine will become very unresponsive. Since you have Task Manager up already, you can easily use it to kill novacomd if this occurs.
#Right-click on the new network, which probably be named Local Area Connection 2
#Select Properties
#Double click on Internet Protocol (TCP/IP)
#Click Advanced
#UNCheck Automatic metric, put 100 in its place. This will keep Windows from attempting to [http://support.microsoft.com/default.aspx/kb/299540 route] traffic over the Pre (it won't work anyway). Note: 100 may be too high. If it seems that network traffic is being routed to the pre (IE - your internet connection apparently dies), try setting this to something lower (like 60).
#Click OK
#If you did not enable DHCP, you will need to set an IP address manually:
##Set your IP address as 192.168.0.203 ( could be anything except 192.168.0.202, assuming this is the Pre's address)
##Subnet mask: 255.255.255.0
##Default Gateway: 192.168.0.202 (your Pre's address for the usb0 interface)
##Set DNS to your preferred servers. Addresses are not currently resolving for me, regardless of the server I use
#Hit OK

The network should now be setup. To verify, ssh to 192.168.0.202, and you should be prompted for a login.

== Notes: ==

*This has only been tested on Windows XP 32 bit. For Windows 2000, you will need an additional download from Microsoft. The link is in the header of the INF file.

- From zinge: I have several confirmations via the precentral forums that this only works on XP sp3. Sp2 gives "error code 10, the device cannot start". Has anyone followed this process and had it work on XP sp2? Update: Upgraded to SP3 on my laptop, and it immediately started working.

*The 64 bit driver is unverified at this point, but I think it works.
*wayne47: I was having all kinds of issues with this on my WinXP notebook. Clicking on the safely remove hardware icon in the tray indicated two devices associated with the Pre: Novacom and a USB drive. Stopping the Novacom service resolved the issues. Note that I need to do this each time that I attach the Pre via USB.

== On Mac OS X ==

*[http://www.wikidot.com/user:info/mdklein mdklein] notes that as of 1.0.4 the g_composite driver appears to only operate usbnet in rndis mode which is not the method OS-X includes. He has made a version that implements CDC-ECM, but it breaks a few other things. Working on this.

''*Allegedly, Mac OS X 10.4 should create a usb0 interface after you plug in a usbnet enabled pre. 10.5 needs a modified driver, which is not working for me (and carazy) yet. See [http://bugcommunity.com/wiki/index.php/Start_Guide_Mac_OS_X_10.5 this page] for more details.

''*I don't know of anyone that has gotten USBNet driver to work on Mac OSX at all so for the time being, count it as unsupported. If anyone can figure it out please shed some light on us.

MacOS X does not directly support RNDIS. The link provided is for a CDC Ethernet driver with a system-specific patch, which won't work.

Both [http://mac.eltima.com/sync-mac.html Syncmate] and [http://www.markspace.com/products/windowsmobile/mac/windows-mobile-sync-software.html Missing Sync] appear to provide a RNDIS driver to access WinCE devices, which '''does not''' work with the Pre/Pixi. Someone should investigate.

== Windows Vista (64-bit) ==

*If driver/device fails to come online in network sharing center, simply click start->right click computer-> properties … Click Device manager and look for the device "Linux USB Ethernet/RNDIS Gadget" you can then right click disable/enable the device. That's all.
*This device/driver can also be cycled with MS Windows own [http://support.microsoft.com/kb/311272 DevCon] application.

== Windows 7 (64-bit) ==

* Windows 7 has the driver it needs already, but it won't set it up by itself. The driver you want is under "Microsoft Corporation" > "Remote NDIS based Internet Sharing Device.". See http://mytether.net/#other for complete directions.

== Windows 7 RC Build 7100 (64-bit) ==

*User lars47 confirms this is working on Windows 7 x64. Wrestled with the driver installation at first, it would not install, Windows complained of a file in use. I rebooted, and the next time I plugged in the Pre via USB, it "just worked". Unsure if I caused the problem, or if a reboot is required/recommended.

== Linux Support ==
=== Ubuntu ===
* Once usbnet was enabled on the Pre, my Ubuntu 9.04 (64 bit) immediately identified the Pre in the NetworkManager and worked without modification to the OS. It seems to already have a driver that works.
* In order to prevent Ubuntu Linux from automatically trying to connect to the internet while the phone is connected via USBnet:
** In the Network Manager icon, click "Edit Connections"
** Select the usb0 interface and select "Edit"
** Uncheck the box that says "Connect Automatically" (this is optional, but could prevent headaches)
** Under IPv4 Settings select Routes
*** Check the box next to "Use this connection only for resources on its network"
** Click Ok, Apply. Now you should be able to access your regular wifi/lan/internet
=== Gentoo ===
* If you are using a default kernel, this should work out of the box.
** Simply run as root dhcpcd usb0 once the device is connected.
* If you are using a custom kernel, make sure you have usbnet, cdc_ether and rndis_host either compiled-in or available as modules. The relevant kernel options are (from kernel 2.6.36-gentoo-r5):
Modules: usbnet cdc_ether rndis_host
Kernel Options:
Device Drivers --->
[*] Network device support --->
USB Network Adapters --->
<M> Multi-purpose USB Networking Framework
<M> CDC Ethernet support (smart devices such as cable modems)
<M> Host for RNDIS and ActiveSync devices (EXPERIMENTAL)

Application:FreeTether

2011-03-15T20:29:27Z

Sgonzalez: /* USB Tethering */

{{application
|name=freeTether
|type=webOS
|version=Version: 0.99.13
|tag=Networking
|screenshot=freeTether_0.99.12_main.png
|description=}}

== Overview ==
[[image:Icon_FreeTether.png|frameless|left]]
freeTether is an open source tethering application for webOS that turns your device into an access point/gateway that allows you to share your device's cellular data connection with other devices via WiFi, Bluetooth or USB.

== Installation ==

The following information will help with installing freeTether on your device.
 
{| style="color:black; background-color:#FFDEDE; border:1px solid #cc3333;" VAlign="middle" cellpadding="20" cellspacing="0" Width="100%"
|
==== Notice/Warning ====
 
'''freeTether currently is in a beta/testing phase and as such its use falls under the WebOS-Internals Testing Feed Rules.'''
 
'''Please take a few mintues to read over, understand and agree to the [http://www.webos-internals.org/wiki/Testing_Feeds#Rules_that_you_must_agree_to_before_using_these_feeds WebOS-Internals Testing Feed Rules] before continuing.'''
|}

==== Preparing Your Device ====
The following steps should be taken to prepare your device for the installation of freeTether.

<blockquote>
===== Remove Other Tethering Solutions =====
It is highly recommended to remove all previous versions of freeTether and freeTetherD, as well as, Mobile Hotspot. Other tethering solutions may conflict with freeTether as well.

===== Testing Feeds =====
freeTether is found in the WebOS-Internals Testing Feeds. The WebOS-Internals Testing Feeds need to be added to your Preware configuration. Please carefully follow the steps listed on the [http://www.webos-internals.org/wiki/Testing_Feeds#Configuring_the_WebOS_Internals_Testing_Feeds WebOS-Internals Testing Feed] page before continuing.
</blockquote>

==== Method ====
The following method is the recommend way to install freeTether. By installing with Preware, you'll be certain to have access to the latest versions of freeTether.

<blockquote>
===== [http://www.webos-internals.org/wiki/Application:Preware Preware] =====

# Open Preware
# Start typing “freetether” (no quotes), then press the enter/return key.
# Tap freeTether from the list
# Tap the Install button

'''Or'''

# Open Preware
# Tap Available Packages
# Tap Application > System Utilities
# Tap freeTether from the list
# Tap the Install button
</blockquote>

==== Updating ====

freeTether is being heavily developed and will have many updates during the beta/testing phase. Check Preware often for the latest updates to freeTether.

== Troubleshooting/FAQ ==
<blockquote>
'''Q: What version of webOS is freeTether available for?'''
 
A: freeTether is only available for webOS 1.4.5 and later.
 
 
'''Q: I think I've found a bug. What should I do?'''
 
A: freeTether is currently a beta/test release, so don't get all worked up if you encounter a bug. Please review the bug/features listed [http://redmine.webos-internals.org/projects/freetether/issues here] before submitting your own. You should also consider removing all other tethering solutions and then try again; as one of the other tethering solutions may be causing the issue with freeTether.
 
 
'''Q: I don't see freeTether listed in Preware. What am I doing wrong?'''
 
A: Make sure you have both testing feeds configured. You need the "ALL" feed and your device specific feed. See the [http://www.webos-internals.org/wiki/Testing_Feeds WebOS-Internals Testing Feed] wiki page for more information.
 
 
'''Q: Where can I find the testing feeds?'''
 
A: The Webos-Internals Testing Feed information can be found [http://www.webos-internals.org/wiki/Testing_Feeds#Configuring_the_WebOS_Internals_Testing_Feeds here].
</blockquote>

== System/Device Compatibility ==
Here is a list of some systems and their current status/compatibility with freeTether.
 

<blockquote>
{| border="1" cellspacing="0" cellpadding="5"
|-
!scope="col"|
!scope="col"| Bluetooth
!scope="col"| USB
!scope="col"| WIFI (Open)
!scope="col"| WIFI (WPA)
|-
!scope="row"| Linux
| Good
| Good
| Good
| Good
|-
!scope="row"| MacOSX <=10.5
| ?
| ?
| ?
| ?
|-
!scope="row"| MacOSX 10.6
| Good
| Broken
| Good
| Good
|-
!scope="row"| Windows 7 (x86)
| ?
| Good
| Good
| Good
|-
!scope="row"| Windows 7 (x64)
| Can work
| Good
| Good
| Good
|-
!scope="row"| PS3
| N/A
| N/A
| Good
| Good
|-
!scope="row"| Wii
| N/A
| N/A
| Good
| Needs Work
|-
!scope="row"| iPad
| N/A
| N/A
| Good
| Good
|-
|}
</blockquote>
 

== Usage ==
The following information will help to understand and use freeTether.

===== Overview =====
Each tethered interface has a section describing how to enable/disable the interface for tethering and how to configure any preferences for that interface, as well as, a section on configuring the TCP/IP options that the tethered interfaces will use.

===== WIFI Tethering =====
The following steps will assist you in configuring and using freeTether for WIFI tethering.
<blockquote>
'''Configure WIFI Preferences:'''
 
The WIFI Preferences can be accessed two ways.
 
# Tap the WIFI row listed in the Tethered Interfaces list.
# Tap or Swipe down the app menu and select WIFI Prefs.
</blockquote>

<blockquote>
'''Network:'''
 
This setting determines the name (SSID) of the WIFI hotspot network. Tap the Network row to change the SSID. ''(See Figure 1)''
 
'''Security:''' ''[Open | WPA2 Personal]''
 
This setting determines the type of security to be used for the WIFI hotspot network. Tap the Security row to change between the Open and WPA2 Personal. ''(See Figure 2)''
 

<center>'''''[The following settings are only available if WPA2 Personal is selected for the type of security.]'''''</center>

 
<blockquote>
'''Passphrase:'''
 
This setting determines the passphrase used. Tap the Passphrase row to toggle between showing or hiding of the passphrase.
 
To configure your own passphrase, tap the Set Passphase button. A passphrase can be created two different ways. ''(See Figure 3)''
<blockquote>
# Tap the text field ''(above the Generate Random button)'' and enter your passphrase. ''(The passphrase needs to have a minimum of eight (8) characters.)'' Then tap the Set Passphrase button.
# Tap the Generate Random button to have freeTether generate a passphrase for you. Then tap the Set Passphrase button.
</blockquote>
</blockquote>
 

'''Enable/Disable Wifi Tethering:'''
 
Toggle the On/Off switch to enable or disable the freeTether WiFi tethering.
</blockquote>
 

<blockquote>
<gallery widths=80px heights=80px perrow=7 caption="Tethered WiFi Preferences">
file:freetether_wifiprefs1.png|''Figure 1''
file:freetether_wifiprefs2.png|''Figure 2''
file:freetether_wifiprefs3.png|''Figure 3''
</gallery>
</blockquote>
 

===== Bluetooth Tethering =====
The following steps will assist you in configuring and using freeTether for Bluetooth tethering.
<blockquote>
'''Configure Bluetooth Preferences:'''
 
The Bluetooth Preferences can be accessed two ways.
 
# Tap the Bluetooth row listed in the Tethered Interfaces list.
# Tap or Swipe down the app menu and select Bluetooth Prefs.
</blockquote>

<blockquote>
'''PAN Profile:''' ''[Enabled | Disabled]''
 
This setting attempts to enable Bluetooth PAN support for those carriers that may disable Bluetooth PAN support. ''(See Figure 1)''
</blockquote>
 

<blockquote>
'''Enable/Disable Bluetooth Tethering:'''
 
Toggle the On/Off switch to enable or disable the freeTether Bluetooth tethering.
</blockquote>
 

<blockquote>
<gallery widths=80px heights=80px perrow=7 caption="Tethered Bluetooth Preferences">
file:freetether_btprefs.png|''Figure 1''
</gallery>
</blockquote>
 

===== USB Tethering =====


<blockquote>
'''Enable/Disable USB Tethering:'''
 
Toggle the On/Off switch to enable or disable the freeTether USB tethering.
</blockquote>
 

===== TCP/IP Preferences =====
The following steps will assist you in configuring the TCP/IP Preferences for freeTether.
<blockquote>
'''Configure TCP/IP Preferences:'''
 
The TCP/IP Preferences can be accessed two ways.
 
# Tap the DHCP Server section listed below the Tethered Interfaces list.
# Tap or Swipe down the app menu and select TCP/IP Prefs.
</blockquote>

<blockquote>
 
For a view of the TCP/IP Prefs... ''(See Figure 1)''
 
'''Gateway:'''
 
This setting determines the gateway address that is used by the tethered clients as their connection point to your device.
 
'''Subnet:'''
 
This setting determines the subnet address that is used by the tethered clients.
 
'''DHCP Start:'''
 
This setting determines the starting address used when allocating IP address to the tethered clients.
 
'''Max Leases:'''
 
This setting determines the maximum number of addresses available for allocation to the tethered clients.
 
'''Lease Time:'''
 
This setting determines the length of time the tethered client's address allocation is valid. ''(Time is in seconds.)''
 
</blockquote>
 

<blockquote>
<gallery widths=80px heights=80px perrow=7 caption="TCP/IP Preferences">
file:freetether_tcpipprefs.png|''Figure 1''
</gallery>
</blockquote>
 

== Resources ==

===== Donation to Developers =====
::* Please see the official PreCentral Forum thread opening post for the donation link.

===== Official Forum =====
::* [http://forums.precentral.net/webos-internals/272151-freetether-0-99-x.html Official PreCentral Forum Thread]

===== Official Bug/Feature Request Site =====
::*[http://redmine.webos-internals.org/projects/freetether/issues Official Bug/Feature Request Site]

== Status ==
freeTether currently is in a beta/testing phase and is being heavily developed.

===== Changelog =====
<blockquote>
:'''0.99.13 - Current Release''' - (''Released Jan. 14th, 2011'')
:* Disable settings while interface active
:* Add TCP/IP Preferences
 
:'''0.99.12'''
:* Default to Open for wifi tethering
:* Styling tweaks
:* Show passphrase hint
:* Menu options for each interface
 
:'''0.99.11'''
:* Add client info scene
:* End freeTether service on app close
 
:'''0.99.10'''
:* Default to WPA for wifi tethering
:* Provide default passphrase
:* Enforce min passphrase length
:* Random passphrase generator
 
:'''0.99.9'''
:* Service fixes for race conditions and client list reporting
:* Save and restore interface state
:* Fix spinner states and multi-interface toggling
:* Fix client list to correctly update hostnames
 
:'''0.99.7'''
:* Bluetooth PAN profile
 
:'''0.99.6'''
:* USB, Bluetooth and WiFi support
:* webOS 1.4.5 and 2.x.x support
:* Improved UI
</blockquote>

===== Known Issues =====
<blockquote>
Please see the issues list [http://redmine.webos-internals.org/projects/freetether/issues here] for more information on the known issues.
</blockquote>

Application talk:FreeTether

2011-03-15T20:08:20Z

Sgonzalez:

===Confused?===
Hmmm, I'm looking for freetether, but all I see is an icon and a screen shot. What gives? [[user:Goky|Goky]]

===Outdated Info===
With some testing of enabling/disabling usbnet and playing with /etc/dnsmasq.palm.conf as per the USBnet page, it seems that these steps are no longer needed to get USB tethering working. As a result I'm removing this section. [[User:Sgonzalez|Sgonzalez]]

Application talk:FreeTether

2011-03-15T19:52:35Z

Sgonzalez:

===Confused?===
Hmmm, I'm looking for freetether, but all I see is an icon and a screen shot. What gives? [[user:Goky]]
===Outdated Info===
With some testing of enabling/disabling usbnet and playing with /etc/dnsmasq.palm.conf as per the USBnet page, it seems that these steps are no longer needed to get USB tethering working. As a result I'm removing this section. [[User:Sgonzalez|Sgonzalez]]