USB ethernet adaptors: Difference between revisions

From OLPC
Jump to navigation Jump to search
(reorg, cleanup)
Line 1: Line 1:
For OLPC development, having network connectivity is a big advantage.
For OLPC development, having network connectivity is a big advantage.
Wireless connectivity is less reliable than wired Ethernet, provides lower bandwidth, and is often harder to set up. There are also frequent bugs in the wireless chip and/or Sugar configuration software for wireless.
Wireless connectivity is less reliable than wired Ethernet, provides lower bandwidth, and is often harder to set up. There are also bugs in the wireless chip and/or Sugar configuration software for wireless.
It is often the best solution to use [[USB peripherals|USB]] Ethernet adapters.
It is often the best solution to use [[USB peripherals|USB]] Ethernet adapters.


== General remarks ==
Not all USB Ethernet adapters found e.g., on eBay work "out of the box" with the [[XO]] laptop (especially the cheap USB 1.1 ones), so let's list devices that are known to work here.
Not all USB Ethernet adapters found e.g., on eBay work "out of the box" with the [[XO]] laptop (especially the cheap USB 1.1 ones), so let's list devices that are known to work here.

'''Note:''' You might need to [[reboot]] your laptop after inserting the adapter. This may not be plug-and-play!
On the other hand, do check before you reboot, it might already be working, as per "rtl8150" support above.


Keep in mind that some vendors will change the chipset in an adapter without changing its model number. Check your store's return policy before purchasing, ''caveat emptor''.
Keep in mind that some vendors will change the chipset in an adapter without changing its model number. Check your store's return policy before purchasing, ''caveat emptor''.


For example, D-Link has an annoying tendency to silently replace the chipset in their models without changing the model name. This means that even if a particular model is known to be compatible, this might not apply to the unit you have acquired.
The standard [[OS images|OS image]] currently contains a driver for the AX8817X chipset (please confirm, this is what my research suggests.)


== Compatible devices ==
These devices have been verified to be compatible:
''When adding or updating this list, don't forget to sign your comment, give your [[How_to_check_the_OS_and_firmware_versions|build version]], and mention if you had to reboot your XO to use the device.


Users have verified the following devices to be compatible:
WARNING: D-Link has an annoying tendency to silently replace the chipset in their models without changing the model name. This means that even if a particular model is known to be compatible, this might not apply to the unit you have acquired.


* D-Link DSB-H3ETX -- pegasus driver, combo hub and Ethernet (works for cjb)
* D-Link DSB-H3ETX -- pegasus driver, combo hub and Ethernet (works for cjb)
Line 17: Line 22:
* D-Link DSB-650TX
* D-Link DSB-650TX
* [http://en.wikipedia.org/wiki/FRITZ%21Box FRITZ!Box] (verified with FRITZ!Box Fon connected to XO via USB cable)
* [http://en.wikipedia.org/wiki/FRITZ%21Box FRITZ!Box] (verified with FRITZ!Box Fon connected to XO via USB cable)
* LinkSys USB200M - works for wiki user ywwg with updated module
* LinkSys USB200M - works for wiki user ywwg with updated module; "ethernet works fine after reboot with Linksys USB200M" -- [[User:Sunglint|Sunglint]] 18:43, 30 March 2008 (EDT); "Ethernet also wroked for me using Linksys200M adapter out of the box!" -- [Isaac Tabe]
* Linksys USB200M ver. 2.1 (verified w/build 303 OTB)
* Linksys USB200M ver. 2.1 (verified w/build 303 OTB)
* Linksys USB200M ver. 2.0 (according to the sticker on the device on version 653 OTB)
* Linksys USB200M ver. 2.0 (according to the sticker on the device on version 653 OTB)
Line 33: Line 38:
* Vivanco USB Fast Ethernet Adapter USB NET-N/23428 works. No reboot required.
* Vivanco USB Fast Ethernet Adapter USB NET-N/23428 works. No reboot required.


=== Unconfirmed devices ===
In theory, these devices should be compatible--please confirm that they are working:
In theory, these devices should be compatible--please confirm that they are working:


Line 46: Line 52:


* Conrad USB 2.0 10/100 MBit Ethernet Adapter Nr.: 97 31 19 | works fine out of the box (G1G1 XO Build 711 | http://www.conrad.com
* Conrad USB 2.0 10/100 MBit Ethernet Adapter Nr.: 97 31 19 | works fine out of the box (G1G1 XO Build 711 | http://www.conrad.com

----
== Device support implied by driver source code ==
[[User:Bert|Bert]] asked ''(on 09:47, 24 August 2006)'': Wouldn't the driver sources ([http://dev.laptop.org/git?p=olpc-2.6;a=blob;f=drivers/net/usb/asix.c;hb=HEAD drivers/net/usb/asix.c]) be the ultimate reference to what is supported? This should be the case, but unfortunately is not. Many manufacturers and merchants do not coordinate with the driver maintainers, so the source code lacks the information needed to be the "ultimate reference". For example, see the warnings above about D-Link changing chipsets without notice. Nonetheless, the source code has valuable information as follows:
[[User:Bert|Bert]] asked ''(on 09:47, 24 August 2006)'': Wouldn't the driver sources ([http://dev.laptop.org/git?p=olpc-2.6;a=blob;f=drivers/net/usb/asix.c;hb=HEAD drivers/net/usb/asix.c]) be the ultimate reference to what is supported?
: This should be the case, but unfortunately is not. Many manufacturers and merchants do not coordinate with the driver maintainers, so the source code lacks the information needed to be the "ultimate reference". For example, see the warnings above about D-Link changing chipsets without notice. Nonetheless, the source code has valuable information as follows:
awk '/products/{if(p)exit;p=1};/^.\/\//{if(p)print}'
awk '/products/{if(p)exit;p=1};/^.\/\//{if(p)print}'
drivers/usb/net/asix.c | sed 's|.*//|*|'
drivers/usb/net/asix.c | sed 's|.*//|*|'
Line 68: Line 76:
And this is only for the AX8817X chipset, there are many more drivers in drivers/usb/net/. In a current kernel config, all of them are enabled (see boot/config-2.6.17-1.2584.olpc1).
And this is only for the AX8817X chipset, there are many more drivers in drivers/usb/net/. In a current kernel config, all of them are enabled (see boot/config-2.6.17-1.2584.olpc1).


Maybe [http://dev.laptop.org/git?p=olpc-2.6;a=blob;f=drivers/usb/gadget/ether.c;hb=HEAD ether.c] is helpful too? -- ??, 2007-12-20
== Drivers? ==
21:39, 20 December 2007 (EST): Maybe [http://dev.laptop.org/git?p=olpc-2.6;a=blob;f=drivers/usb/gadget/ether.c;hb=HEAD ether.c] is helpful too?


----
'''Note: You might need to reboot your laptop after installing the adapter. This is NOT plug-and-play!'''
<br>Do check before you reboot, it might already be working, as per "rtl8150" mentioned above.
==Run ifconfig to see it working==
==Run ifconfig to see it working==
In [[Terminal Activity]], you can enter
In [[Terminal Activity]], you can enter

Revision as of 03:09, 24 November 2008

For OLPC development, having network connectivity is a big advantage. Wireless connectivity is less reliable than wired Ethernet, provides lower bandwidth, and is often harder to set up. There are also bugs in the wireless chip and/or Sugar configuration software for wireless. It is often the best solution to use USB Ethernet adapters.

General remarks

Not all USB Ethernet adapters found e.g., on eBay work "out of the box" with the XO laptop (especially the cheap USB 1.1 ones), so let's list devices that are known to work here.

Note: You might need to reboot your laptop after inserting the adapter. This may not be plug-and-play! On the other hand, do check before you reboot, it might already be working, as per "rtl8150" support above.

Keep in mind that some vendors will change the chipset in an adapter without changing its model number. Check your store's return policy before purchasing, caveat emptor.

For example, D-Link has an annoying tendency to silently replace the chipset in their models without changing the model name. This means that even if a particular model is known to be compatible, this might not apply to the unit you have acquired.

Compatible devices

When adding or updating this list, don't forget to sign your comment, give your build version, and mention if you had to reboot your XO to use the device.

Users have verified the following devices to be compatible:

  • D-Link DSB-H3ETX -- pegasus driver, combo hub and Ethernet (works for cjb)
  • D-Link DUB-E100
  • D-Link DSB-650TX
  • FRITZ!Box (verified with FRITZ!Box Fon connected to XO via USB cable)
  • LinkSys USB200M - works for wiki user ywwg with updated module; "ethernet works fine after reboot with Linksys USB200M" -- Sunglint 18:43, 30 March 2008 (EDT); "Ethernet also wroked for me using Linksys200M adapter out of the box!" -- [Isaac Tabe]
  • Linksys USB200M ver. 2.1 (verified w/build 303 OTB)
  • Linksys USB200M ver. 2.0 (according to the sticker on the device on version 653 OTB)
  • Linksys USB100M - works out of the box
  • Linksys USB1000 - no reboot necessary and Gigabit [Build 656] - not working for me after suspend (update.1 691, Q2D13)-danielfuhry
  • SMC 2208USB/ETH
  • AirLink101 ASOHOUSB USB 2.0 10/100Mbps (verified w/build 616)
  • Belkin USB 10/100 Ethernet adapter
  • BPI 10/100 FastEthernet (P/N BUE1M) works w/ build 656. Didn't need reboot, log reports "full-supported using driver rtl8150"
  • TRENDnet TU2-ET100.($25 at Radio Shack.) Works in build 703; no reboots/shutdowns necessary. Benanov. Worked for me right out of the box (after a shutdown or two) - build 653 - bought at TigerDirect.ca (I had to phone a rep since it appeared on the US site, but not the Canadian site).
  • Zoltan Tech USB2.0 Fast Ethernet adapter XO colours shown here Available online at XOExplosion.com & ILoveMyXO.com
  • Surecom EP-1427X-2 - works out of the box without reboot
  • CATC NetMate Link - works out-of-the-box on build 656, with the network adapter name as eth0 and the wireless network adapter as eth1. Reboot may be required.
  • LAN Adapter for nintendo Wii by datel ($20 at BestBuy) worked for me out of the box (just reboot) on build 703.
  • Vivanco USB Fast Ethernet Adapter USB NET-N/23428 works. No reboot required.

Unconfirmed devices

In theory, these devices should be compatible--please confirm that they are working:

  • D-Link DUN-E100 - please confirm that this is working

[ 3/15/2008 - I can confirm that D-Link DUB-E100 (both V. A3 and A1) worked fine right out of the box with Builds 656 & 650; no reboot needed. (I'm not sure there was a model DUN-E100; I could not find reference to it on D-Link's web site.)]

  • NetGear FA120 - confirmed this is working with build 650 on 25Dec07
  • SMC 2209USB/ETH - please confirm that this is working

[ EDIT: I can confirm that the SMC 2209 works fine, build 653. ]

Source: http://www.sustworks.com/site/news_usb_ethernet.html

  • Conrad USB 2.0 10/100 MBit Ethernet Adapter Nr.: 97 31 19 | works fine out of the box (G1G1 XO Build 711 | http://www.conrad.com

Device support implied by driver source code

Bert asked (on 09:47, 24 August 2006): Wouldn't the driver sources (drivers/net/usb/asix.c) be the ultimate reference to what is supported?

This should be the case, but unfortunately is not. Many manufacturers and merchants do not coordinate with the driver maintainers, so the source code lacks the information needed to be the "ultimate reference". For example, see the warnings above about D-Link changing chipsets without notice. Nonetheless, the source code has valuable information as follows:
awk '/products/{if(p)exit;p=1};/^.\/\//{if(p)print}'
drivers/usb/net/asix.c | sed 's|.*//|*|'
  • Linksys USB200M
  • Netgear FA120
  • DLink DUB-E100
  • Intellinet, ST Lab USB Ethernet
  • Hawking UF200, TrendNet TU2-ET100
  • Billionton Systems, USB2AR
  • ATEN UC210T
  • Buffalo LUA-U2-KTX
  • Sitecom LN-029 "USB 2.0 10/100 Ethernet adapter"
  • corega FEther USB2-TX
  • Surecom EP-1427X-2
  • goodway corp usb gwusb2e
  • ASIX AX/100
  • ASIX AX/100/1000
  • Linksys USB200M Rev 2
  • 0Q0 cable ethernet

And this is only for the AX8817X chipset, there are many more drivers in drivers/usb/net/. In a current kernel config, all of them are enabled (see boot/config-2.6.17-1.2584.olpc1).

Maybe ether.c is helpful too? -- ??, 2007-12-20

Run ifconfig to see it working

In Terminal Activity, you can enter

/sbin/ifconfig

and see what is and isn't working in networking. (Thanks to ektoric in the forum for the path explanation http://en.forum.laptop.org/viewtopic.php?f=1329&t=151544)