Echelon U10/U20 Network Interface Driver for Linux ReadMe
Release 1.0, February 6, 2006

Copyright © 2006 Echelon Corporation
All Rights Reserved

1  Overview

This network interface driver provides the required support for the Echelon U10/U20 USB Network Interfaces on the Linux operating system.  Applications that use the de facto standard OpenLDV functions (ldv_open, ldv_read, ldv_write, ldv_close) can be used with the network interface driver.  For more information on how to program to the OpenLDV functions, download the OpenLDV Developer's Kit from http://www.echelon.com/downloads.

This network interface driver is licensed for royalty-free use exclusively with Echelon's U10/U20 USB Network Interfaces.

This file contains important information about this network interface driver.  Additional information and updates, including critical updates, may be available in Echelon’s Downloads Web page at http://www.echelon.com/downloads.

2  System Requirements

• x86 PC
• Redhat Linux 9 (Fedora Core 3 or Fedora Core 4) and the libftdi, libusb and hotplug libraries (other x86 Linux distributions probably work as well--although we have not tested them)
• Available USB 1.1 or 2.0 port
• Echelon U10 or U20 USB Network Interface

3  Installation

1. Download and uncompress the archive Ux0Linux100.zip.

2. Double-click the file DigitalHome-0.1-8.i386.rpm.  The U10/U20 network interface driver will install.  If it is the case that your kernel does not include libftdi, you will get an error message instead.  If that is the case, install libftdi-0.6-1.i386.rpm and then try installing DigitalHome-0.1-8.i386.rpm again.  If libftdi will not install, it is normally because libusb is also not included in your kernel.  If that is the case, install libusb-0.1.10a-1.i386.rpm, then libftdi-0.6-1.i386.rpm, then DigitalHome-0.1-8.i386.rpm.

3. If you will be developing OpenLDV applications on this box, double-click DigitalHome-devel-0.1-8.i386.rpm.  This RPM includes the headers needed to develop OpenLDV applications.
4. The installation can be checked at any time using the dhchk script that is installed by the RPM you installed in step 2.
5. Insert the U10/U20 USB Network Interface into an available USB port.
6. The first time that you use this software, you will want to continue with the following steps to verify that the software and hardware are working correctly.  Verify after inserting the U10/U20 that the USB hot-plug support is working by looking at /var/log/messages.  You should see messages similar to the following:
   
   Jul 6 15:34:02 localhost kernel: usb 1-2.4: new full speed USB device using uhci_hcd and address 29
   Jul 6 15:34:02 localhost default.hotplug[2254]: arguments (usb) env (SUBSYSTEM=usb OLDPWD=/ DEVPATH=/devices/pci0000:00/0000:00:07.2/usb1/1-2/1-2.4/1-2.4:1.0 PATH=/bin:/sbin:/usr/sbin:/usr/bin ACTION=add PWD=/etc/hotplug HOME=/ SHLVL=2 DEVICE=/proc/bus/usb/001/029 INTERFACE=255/255/255 PRODUCT=920/7500/400 TYPE=0/0/0 DEBUG=yes PHYSDEVBUS=usb SEQNUM=743 _=/bin/env)
   Jul 6 15:34:02 localhost default.hotplug[2254]: invoke /etc/hotplug/usb.agent ()
   Jul 6 15:34:02 localhost default.hotplug[2276]: arguments (usb) env (SUBSYSTEM=usb OLDPWD=/ DEVPATH=/devices/pci0000:00/0000:00:07.2/usb1/1-2/1-2.4 PATH=/bin:/sbin:/usr/sbin:/usr/bin ACTION=add PWD=/etc/hotplug HOME=/ SHLVL=2 PHYSDEVDRIVER=usb DEBUG=yes PHYSDEVBUS=usb SEQNUM=742 _=/bin/env)
   Jul 6 15:34:02 localhost default.hotplug[2276]: invoke /etc/hotplug/usb.agent ()
   Jul 6 15:34:06 localhost usb.agent[2254]: Setup 0x00 0x00 for USB product 920/7500/400
   Jul 6 15:34:06 localhost usb.agent[2254]: Setup usblta for USB product 920/7500/400
   Jul 6 15:34:06 localhost usb.agent[2254]: Module setup usblta for USB product 920/7500/400
   
   And when the U10/U20 is unplugged from the USB port you should see messages in /var/log/messages similar to the following:
   
   Jul 6 15:37:48 localhost kernel: usb 1-2.4: USB disconnect, address 29
   Jul 6 15:37:48 localhost default.hotplug[2335]: arguments (usb) env (SUBSYSTEM=usb OLDPWD=/ DEVPATH=/devices/pci0000:00/0000:00:07.2/usb1/1-2/1-2.4/1-2.4:1.0 PATH=/bin:/sbin:/usr/sbin:/usr/bin ACTION=remove PWD=/etc/hotplug HOME=/ SHLVL=2 DEVICE=/proc/bus/usb/001/029 INTERFACE=255/255/255 PRODUCT=920/7500/400 TYPE=0/0/0 DEBUG=yes PHYSDEVBUS=usb SEQNUM=744 _=/bin/env)
   Jul 6 15:37:48 localhost default.hotplug[2335]: invoke /etc/hotplug/usb.agent ()
   Jul 6 15:37:48 localhost default.hotplug[2354]: arguments (usb) env (SUBSYSTEM=usb OLDPWD=/ DEVPATH=/devices/pci0000:00/0000:00:07.2/usb1/1-2/1-2.4 PATH=/bin:/sbin:/usr/sbin:/usr/bin ACTION=remove PWD=/etc/hotplug HOME=/ SHLVL=2 DEBUG=yes PHYSDEVBUS=usb SEQNUM=745 _=/bin/env)
   Jul 6 15:37:48 localhost default.hotplug[2354]: invoke /etc/hotplug/usb.agent ()
   

7. To determine the serial number of your USBLTA, run the command lsusblta specifying a -v argument, and look for the line starting with 'iSerial'.

      # lsusblta -v
   The line starting with 'iSerial' will be approximately 14 lines down into the command results.  The 8 hexadecimal value at the end of the 'iSerial' line is the serial number of the U10/U20, and it is is this serial number that you specify when opening up the interface with an OpenLDV enabled application.

8. The NodeUtil application can optionally be used to test the readiness of the U10/U20 network interface, or to perform network maintenance or diagnostic operations.  To run NodeUtil, specify the 8-character serial number that you obtained from step 7 above the -D option. If using a U20, also specify the -S option, for example:
      # NodeUtil -D009AEEBD -S

   Documentation for NodeUtil is provided in the file NODEUTIL.TXT installed into the folder /usr/share/doc/DigitalHome-0.1.

9. You are now ready to run an OpenLDV compatible application.  For more information on how to program to the OpenLDV functions, download the OpenLDV Developer's Kit from http://www.echelon.com/downloads.  The DigitalHome-devel-0.1-8.i386.rpm includes the ported headers for writing an OpenLDV application.

4  License

The license that governs the use of this network interface driver is agreed to before downloading this software from Echelon's Web site.  The license is also available from the top level of the archive as License.htm.

5  Technical Support

This network interface driver is not supported by Echelon.  However, you may be able to get assistance from others on Echelon's WebBoard available at http://webserv.echelon.com.  If you have feedback, we'd still like to hear from you.  See the Feedback section below.

6  Feedback

Echelon welcomes your feedback on this network interface driver.  Please send feedback to interface@echelon.com.