ITI1480A-linux 3.0

Disclaimer

I am not affiliated with International Test Instruments in any way. ITI kindly accepted that I start reverse-engineering their windows-only software so I could use with Linux the I bought from them. I had no privileged access to any documentation of any kind.

Dependencies

• Python 2.4+ (though mostly tested with 2.7 nowadays) or pypy for ~7 times faster parsing

• libusb 1.0

• python-libusb1

• cycfx2prog

• udev (should come from your distribution)

• ply

Installation

Notes: paths and udev group are suitable for at least Debian. You may need to edit udev/ITI1480A.rules and adapt below paths.

python setup.py install
cp udev/ITI1480A.rules /etc/udev/rules.d/
cp udev/ITI1480A.sh /lib/udev/
wget -O /lib/firmware/ITI1480A.rbf http://www.internationaltestinstruments.com/Downloads/UlpiTest.rbf

• ITI’s FX2 firmware:

  spt2hex /path/to/ITI1480A.spt
  cp ITI1480A_1.ihx /lib/firmware/ITI1480A.ihx

  spt2hex may generate several files (ITI1480A_0.ihx, ITI1480A_1.ihx, …), use the highest-numbered one.

• Free Software FX2 firmware:

  To rebuild from source:

  FX2LIBDIR=/path_to/fx2lib/ make -C CY7C68013A

  To install:

  cp CY7C68013A/build/ITI1480A.ihx /lib/firmware/

To test installation, (re)plug your protocol analyser. If the “Host power” led turns on within a few seconds, your FX2 firmware was successfully installed and loaded, your analyser is ready to use.

Usage

To start a capture:

iti1480a-capture > captured.usb

Send signal SIGINT (^C) or SIGTERM to stop the capture, wait analyser to push all data to host and exit.

Send signal SIGTSTP (^Z) to pause the analyser, SIGCONT (fg) to resume.

To get a human-friendly text dump of a previos capture:

iti1480a-display -i captured.usb

To wath running capture without saving it:

iti1480a-capture | iti1480a-display -f

To watch running capture and save it for later analysis:

iti1480a-capture | iti1480a-display -ft captured.usb

By default, iti1480a-display hides a lot of verbose events, like NAK’ed and SOF transactions, or EOP events. You can tweak its filtering using -q (quieter) and -v (more verbose). Default verbosity level is 0, -q decrements it and -v increments it. Verbosity levels go from -1 (most quiet) to 4 (most verbose).

Example outputs: https://github.com/vpelletier/ITI1480A-linux/tree/master/examples

Red timestamps mean that output is detected as being non-chronological. This happens for implementation detail reasons, and is considered a bug (issue #4).