roch_ftdi

Utilities for flashing and enabling roch's USB connection. This package contains tools for flashing the roch's FTDI chip (usually done at the factory). The special firmware for the FTDI chip (USB to serial converter) enables it to appear as /dev/roch on the user's PC.

Homepage: http://wiki.ros.org/roch_ftdi

Overview

SawYer flashes a serial id, 'roch' into the chip's eeprom at the factory.
Users copy across the udev rule '57-roch.rules' to /etc/udev/rules.d directory.
Plug in roch, it will appear on /dev/roch

Programming the Eeprom

Install roch_ftdi package
Plug in the device
Execute ftdi_roch

If roch_ftdi package is not installed yet:

$ sudo apt-get update
$ sudo apt-get install ros-indigo-roch-ftdi

For more detailed information about installation, refer to the http://wiki.ros.org/roch/Tutorials/Installation

If it is the only FTDI device plugged in, simply

$ sudo /opt/ros/indigo/lib/roch_ftdi/ftdi_roch

will do the job, if not - optionally add an argument with the current serial id of the FTDI chip you want to flash to the last command.

If things go bums up, then you will find an eeprom.backup saved in your current directory that you can reflash back to the chip (using ftdi_write_eeprom).

$ sudo /opt/ros/indigo/lib/roch_ftdi/ftdi_write_eeprom -f eeprom.req

Preparing Udev

$ sudo addgroup $USER dialout
$ sudo cp 57-roch.rules /etc/udev/rules.d
$ sudo service udev reload
$ sudo service udev restart

Logout and log back in to make sure the dialout group permissions take affect.

Issues

WILL NOT WORK WITH libftdi 0.17!!!

libftdi needs to be upgraded to work for TYPE_R (can see FT232R on the iInterface variable in lsusb) FTDI chips. To workaround on lucid(Ubuntu 10.04), simply uninstall libftdi and download the sources for version 0.2/0.3 and above (might also work on 0.18 from emails I've read).

http://www.intra2net.com/en/developer/libftdi/download.php

Might work out of the box on oneric(Ubuntu 11.10), but I haven't tried.

Notes

Our Chip : Important specifications and data for our chip (mostly gathered from lsusb -v).
src/ftdi_roch.cpp : Primary utility, reads the device eeprom, converts strings for roch, and reflashes.
src/ftdi_read_eeprom.cpp : Reads and saves a device's eeprom to binary file on pc.
src/ftdi_scan.cpp : Scans FTDI devices for the serial strings.
src/ftdi_write_eeprom.cpp : Writes a backed up eeprom binary to the device.
src/find_devices.cpp : Detect the presence of FTDI devices.
src/get_serial_number.cpp : Print serial number of all the FTDI devices connected. with manufacture and product name.
src/flasher.cpp : Flash FTDI chip's serial number with 'roch_' prefix.
src/unflasher.cpp : Turn back FTDI chip's serial number to original.
src/reset_device.cpp : Reset the all FTDI devices connected, to reload as standard FTDI device, after the flashing serial number.
src/overwrite_serial_number.cpp : Overwrite serial number of FTDI device.

System Utilities

lsusb

Make sure you use sudo, if not, it will only retrieve part of the information.

$ lsusb
Bus 002 Device 002: ID 0bda:5411 Realtek Semiconductor Corp. 
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 002: ID 8087:07dc Intel Corp. 
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
...
Bus 002 Device 005: ID 10c4:ea60 Cygnal Integrated Products, Inc. CP210x UART Bridge / myAVR mySmartUSB light
// Get the two numbers to the left of the FTDI device (bus and device number) (e.g. 002, 005)
$ sudo lsusb -v -s 002:005

Results from lsusb

udevadm

Much more detailed information of a currently connected device.

$ ls /dev/ttyUSB*
/dev/ttyUSB0
$ sudo udevadm info -a -n /dev/ttyUSB0

Results from udevadm