fscai2cgbtx version 26040900
Tool to read or write GBTX registers via an I2C-channel of a GBT-SCA chip,
connected to any FLX-device GBT (2-bit HDLC) E-link:
read or write a single byte from or to the given GBTX register address
or write to multiple consecutive GBTX 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.
(NB: this tool is similar to the fice tool, not fgbtxconf).
Usage:
 fscai2cgbtx -h|V -d<devnr> -D<dma> -e<elink> -G<lnk> -g<group> -p<path>
             -R -Z -W -C<ichan> -I<iaddr> -a<addr>
              [<byte>] | <filename>
  -h         : Show this help text.
  -V         : Show version.
  -c         : In combination with <filename>: compare GBTX/lpGBT register
               contents to file contents and display the differences.
  -d <devnr> : FLX-device to use (default: 0).
  -D <dma>   : DMA controller number for receiving (default: 0).
  -e <elink> : E-link number (hex) or use -G/g/p options.
  -G <lnk>   : GBT-link number.
  -g <group> : Group number (default: 7=EC).
  -p <path>  : E-path number (default: 7=EC).
  -R         : Reset GBT-SCA.
  -Z         : Do not receive and display the GBT-SCA replies.
  -W         : Read writable registers only (default: all).
  -C <ichan> : GBT-SCA I2C channel number.
  -I <iaddr> : GBTX I2C address (hex).
  -a <addr>  : GBTX register address (decimal or hex, 0x.. or x..) to read or write.
 <byte>      : Byte value (decimal or hex, 0x.. or x..)
               to write to GBTX register <addr> (option -a).
 <filename>  : Name of file with GBTX (hex) register data to compare against,
               or to write to consecutive registers (if one value per line;
               also accepts files with address+value (both hex) per line,
               separated by a space.
=> Examples:
Read all registers of GBTX (I2C address 1) connected to GBT-SCA I2C-channel 0,
GBT-SCA connected to FLX-device GBT link 3 EC-link:
  fscai2cgbtx -G3 -I1 -C0 (or: fscai2cgbtx -eff -I1 -C0)
Compare contents of GBT-conf.txt to GBTX registers:
  fscai2cgbtx -G3 -I1 -C0 -c GBT-conf.txt
Read GBTX register 32 (0x20):
  fscai2cgbtx -G3 -I1 -C0 -a32 (or: fscai2cgbtx -G3 -I1 -C0 -a0x20)
Write 0xA5 to GBTX register 32 (0x20):
  fscai2cgbtx -G3 -I1 -C0 -a32 0xA5
Write contents of GBTX-conf.txt to GBTX registers:
  fscai2cgbtx -G3 -I1 -C0 GBTX-conf.txt
