View source for USB to ethernet networking

With [[USB host mode]] it's possible to setup and utilize a wired network connection for times when you don't have access to WiFi (e.g., hotel rooms). Although it's possible to carry around a small WiFi router, it's frequently more cost effective and convenient to connect the tablet to the wired connection directly.

== Pre-requisites ==

In order to do use a USB ethernet adaptor, you'll need to make sure that you have [http://wiki.maemo.org/USB_host_mode USB host mode] up and working properly (with an OTG cable or a software switch). OS2008 natively supports USB adapters based upon the RTL8150 chipset such as the [http://i.i.com.com/cnwk.1d/sc/7767395-2-200-0.gif Linksys USB100M]; however it's possible to find other devices that are supported by custom compiled modules.

If you're looking for a "ready to go" solution  simply  pick up a supported USB100M along with your [http://www.electronicproductonline.com/catalog/product_info.php?cPath=35_67&products_id=2043 USB OTG adapter].

== Setup ==

Once you've got some compatible hardware ready to go, the easiest step is to next install the [http://www.electronicproductonline.com/~electron/catalog/supportFiles/usbLAN_0.4.6_armel.deb USB LAN package]. The updated version of the package utilizes the [http://www.electronicproductonline.com/~electron/catalog/supportFiles/dbus-scripts_1.0.3_armel.deb dbus-scripts package], which can also be easily installed by following this.

The package will setup a few scripts and install all of the additional USB LAN drivers that are available for the OS:

 catc.ko
 dm9601.ko
 kaweth.ko
 mcs7830.ko
 pegasus.ko
 rt73.ko ''(Added in 0.4.6 for external USB Wifi adapters)''

<small>''Note: anyone who knows of other commonly supported and tested working devices using these drivers, please add them to the end of this entry.''</small>

=== Step by step ===
<ol>
<li>Install the [http://www.electronicproductonline.com/~electron/catalog/supportFiles/dbus-scripts_1.0.3_armel.deb dbus-scripts package].</li>
<li>Install the [http://www.electronicproductonline.com/~electron/catalog/supportFiles/usbLAN_0.4.6_armel.deb USB LAN package].</li>
</ol>

<ol>
</ol>

Once the packages are installed any RTL8150 device will operate as follows:

<ol>
<li>Connect USB device to LAN cabling.</li>
<li>Connect USB device to the tablet.</li>
<li>Wait for the USB messages to popup ("USB Device Not Supported", "No Filesystem Found").</li>
<li>Launch your web browser or whatever application you want to use.</li>
<li>Surf and enjoy.</li>
</ol>

<ol>
</ol>

For devices other than those based on the RTL8150 you'll manually need to call <code>usbEthUp.sh</code> after you connect your device, and <code>usbEthDown.sh</code> after you remove it to get the network settings in place. These scrips can be found in <code>/usr/sbin</code>.

When you're done with your wired connection simply unplug the network adapter from the USB host cable (this lets the tablet recognize that the adapter has been unplugged), then disconnect your host cable from the tablet (and manually set it out of host mode if required). Also, don't forget to choose "Disconnect" from the connection window (click on the little WiFi icon), or your tablet will try to stay connected to "'''WIRED'''" until you restart or manually force a new connection.

== Performance ==

Do not expect a wired connection to help you gain faster transfer speeds. In testing, it has been found that the CPU on the tablet maxes out at approximate 5-7Mbps, well beneath the threshold of wired networks or USB connectivity.

There is also an important consideration regarding the type of network adapter you select to use. The Linksys USB100M for example is only listed as USB 1.1, not USB 2.0, but still functions above the maximum sustainable speed of the tablet. Conversely, while the USB 2.0 version of the same device should work, it required additional drivers and actually requests more power than the USB OTG bus on the tablet is willing to provide, so you'd end up needing an externally powered USB hub to use it. Thus while the USB 2.0 adapter might seem better, in actually for the tablets it's actually a worse choice.

== Tested Devices ==

How to test:

# Make sure you have the latest driver and scripts installed as noted above. You will also need [[root access]] installed.
# Open XTerm.
# Connect your USB adapters (including OTG adapter if you are using that product).
# Connect your USB ethernet device.
#You will see error messages that can be ignored.
# Run <code>sudo becomeroot</code> in XTerm.
# Run <code>/usr/sbin/usbEthUp.sh</code>.
# Note messages.  A successful connection will be indicated by an acquired IP address (<cod>Lease ''xxx''.''xxx''.''xxx''.''xxx'' obtained</code>, where <code>''xxx''</code> represents parts of an IP address).
# Run <code>dmesg</code>.
# Scroll up through messages until you discover text describing the ethernet adapter, containing codes prefixed by v (vendor code) and p (product code). The characters following v and p will be entered into the appropriate fields as shown below.
# Any unknown information should be added after the corresponding field as ''Unknown''.

The following USB ethernet devices have been tested:

==== Crystal Blue USB to Ethernet 10/100 LAN Adapter ====

* '''Ethernet chipset:''' [http://www.davicom.com.tw/page1.aspx?no=143762 Davicom DM9601 USB Ethernet]
* '''Vendor ID:''' 0a46
* '''Product ID:''' 9601
* '''External power required:''' No
* '''Functionality:''' Success is sporadic with these; they are technically okay, but lacking in reliability.  Out of 4 tested by me, only 2 worked.
* '''Cost:''' Low to very low
* '''Status:''' <font color=red>Not recommended</font>
* '''Notes:''' This adapter is seen all over eBay, usually in translucent blue but variants are also found in clear, white and black.  FYI, there is a [http://readlist.com/lists/freebsd.org/freebsd-current/10/52177.html FreeBSD patch] to get it to work on that OS.
* '''Tested by:''' Texrat

==== SMC EZ Connect USB 2202USB/ETH ====

* '''Ethernet chipset:''' ADMtek ADM8511
* '''Vendor ID:''' 0707
* '''Product ID:''' 0200
* '''External power required:''' No
* '''Functionality:''' Works very well, very quick internet access
* '''Cost:''' Moderate to low
* '''Status:''' <font color=green>Highly recommended</font>
* '''Notes:''' Adapter did not work with earlier releases of tablet driver.  Uses detachable USB pigtail.
* '''Tested by:''' Texrat

==== Targus ACP50 universal notebook hub ====

* '''Ethernet chipset:''' ADMtek 8515
* '''Vendor ID:''' 0451 (hub)
* '''Product ID:''' 2036 (hub)
* '''Vendor ID:''' 07a6 (ethernet)
* '''Product ID:''' 8515 (ethernet)
* '''External power required:''' Yes
* '''Functionality:''' Works well, very stable
* '''Cost:''' High to moderately high
* '''Status:''' <font color=green>Recommended</font>
* '''Notes:''' Hub loses ethernet and USB functionality if it is simultaneously used as USB charging solution for the tablet.
* '''Tested by:''' Texrat

==== Trendnet TU-ET100C ====

* '''Ethernet chipset:''' ADMtek ADM8511 "Pegasus II"
* '''Vendor ID:''' 07a6
* '''Product ID:''' 8511
* '''External power required:''' No
* '''Functionality:''' Works well, very stable
* '''Cost:''' US$15-25 as of October 2008
* '''Status:''' <font color=green>Recommended</font>
* '''Notes:''' Non-detachable tail, approximately 3 feet long.  Only one light.  Addendum by Texrat: [http://talk.maemo.org/forums/showpost.php?p=242053&postcount=88 noted by one tester] as drawing an unusually high amount of current ("more than N810's 192 mA limit").
* '''Tested by:''' SKarp

==== Netgear EA101 USB Ethernet ====

* '''Ethernet chipset:''' Kawasaki LSI KL5KLUSB101B 
* '''Vendor ID:''' 0846
* '''Product ID:''' 1001
* '''External power required:''' No
* '''Functionality:''' Works well, quick internet access
* '''Cost:''' Moderate to low
* '''Status:''' <font color=green>Recommended</font>
* '''Notes:''' Form factor is a bit bulky, but it has indicator lights for power, link/activity and packet collisions.  Uses detachable USB pigtail.  [http://www.mavetju.org/mail/view_message.php?list=freebsd-doc&id=1493000 Other adapters] that use this chipset are the LinkSys USB10T, the 3Com 3c19250, the ADS Technologies USB-10BT, the Peracom USB Ethernet Adapter, the Entrega NET-USB-E45 and NET-HUB-3U1E, the ATen UC10T, the D-Link DSB-650, Corega USB-T and the SMC 2102USB and 2104USB.
* '''Tested by:''' Texrat

==== DIGITUS 10/100 Mbps Fast Ethernet USB adapter DN-3015 ====

* '''Ethernet chipset:''' RTL8150 Fast Ethernet Adapter
* '''Vendor ID:''' 0x0bda Realtek Semiconductor Corp
* '''Product ID:''' 0x8150 RTL8150 Fast Ethernet Adapter
* '''External power required:''' No
* '''Functionality:''' Works well
* '''Cost:''' EUR 13.- (Feb. 2009)
* '''Status:''' <font color=green>Recommended</font>
* '''Tested by:''' walto

== Wishlist ==

* Automatic detection and activation of all devices passing functionality test (i.e., plug and play).
* advanced control panel configuration (helpful for static IP, etc).


[[Category:Users]]
[[Category:USB]]
[[Category:Networking]]