fice version 21122800
Tool to read or write GBTX or lpGBT registers via the IC-channel
of an FLX-device (lp)GBT link (for lpGBT optionally via the EC-channel):
read or write a single byte from or to the given GBTX/lpGBT register address
or write to multiple consecutive GBTX/lpGBT registers using the contents
of a file (i.e. ASCII file: 1 (register) byte value (hex) per line,
e.g. the 'TXT' file generated by the GBTXProgrammer tool).
Provide a file name *or* use option -a with an optional additional byte value
to read resp. write a single GBTX register or, without option -a,
to read all registers.
Without option -a and file name all registers are read out and displayed
either in one IC read operation or one-by-one (option -o).
Option -t displays the register values in a format that could be used
as a 'TXT' file for this tool or the I2C-dongle GBTX programmer.
Usage:
 fice [-h|V] [-d <devnr>] [-G <gbt>] [-1] [-e] [-i <dma>] [-I <i2c>] [-Z|R] [-t]
      [-a <addr> [<byte>] | <filename>]
  -h         : Show this help text.
  -V         : Show version.
  -1         : If lpGBT, assume v1 (default: v0)
  -a <addr>  : GBTX/lpGBT register address (decimal or hex, 0x.. or x..)
               to read or write.
  -d <devnr> : FLX-device to use (default: 0).
  -e         : Use the EC-channel (for lpGBT only).
  -G <gbt>   : GBT-link number.
  -i <dma>   : FLX-device DMA controller for receiving (default: 0).
  -I <i2c>   : GBTX/lpGBT I2C address.
  -o         : When reading all registers, do it one-by-one
               (default: one multi-reg read op).
  -R         : Receive replies on any E-link.
  -t         : Display one register value per line in output
               (i.e. 'TXT'-format like).
  -Z         : Do NOT receive and process/display replies.
 <byte>      : Byte value (decimal or hex, 0x.. or x..) to write to GBTX/lpGBT register (option -a).
 <filename>  : Name of file with GBTX/lpGBT register data to write
               to consecutive registers.
=> Examples:
Read all registers of GBTX/lpGBT (I2C address 1)
connected to FLX-device GBT link 3:
  fice -G 3 -I 1
Read GBTX/lpGBT register 32 (0x20):
  fice -G 3 -I 1 -a 32 (or: fice -G 1 -I 3 -a 0x20)
Write 0xA5 to GBTX/lpGBT register 32 (0x20):
  fice -G 3 -I 1 -a 32 0xA5
Write contents of GBT-conf.txt to GBTX/lpGBT registers:
  fice -G 3 -I 1 GBT-conf.txt
