================== IRIG 106 Utilities ================== Copyright (C) 2010 Irig106.org Introduction ------------ These programs are relatively simple utility programs for reading and manipulating IRIG 106 format data files. They are run from a command line and are invoked with various command line parameters. Run just the command with no parameters to get a brief summary of available command line parameters. I106STAT -------- Generate a summary of data channels and message types found in an IRIG 106 data file. Usage: i106stat [flags] Input/output file names -r Log both sides of RT to RT transfers -v Verbose I106TRIM -------- Trim a data file based on start and/or stop time, or file offset. It is assumed the day is the same as the starting day. If the stop time is less than the start time, it is assumed that the time spans midnight. In this case stop time is the next day. There are some new requirements for modifying or adding TMATS records when rewriting data files. This utility makes no attempt to modify TMATS and so technically may result in a non-IRIG106 compliant data file. Usage: i106trim [+hh:mm:ss] [-hh:mm:ss] +hh:mm:ss - Start copy time -hh:mm:ss - Stop copy time +% - Start copy at position percent into the file -% - Stop copy at position percent into the file Or: fftrim to get stats IDMPTMATS --------- Read and print out the TMATS record in various formats Usage: idmptmat -c Output channel summary format (default) -t Output tree view format -r Output raw TMATS IDMP1553 -------- Read and dump 1553 messages in a humanly readable format. With no command line parameters, all 1553 messages are dumped. Output can be filtered by Channel ID, RT number, T/R bit, and Subaddress number. Output can be further limited by a decimation factor, useful for thing like INS data. Usage: idmp1553 [flags] Input/output file names -v Verbose -c ChNum Channel Number (default all) -r RT RT Address(1-30) (default all) -t T/R T/R Bit (0=R 1=T) (default all) -s SA Subaddress (default all) -d Num Dump 1 in 'Num' messages -i Dump data as decimal integers -u Dump status response -T Print TMATS summary and exit The output data fields are: Time Bus RT T/R SA WC Errs Data... Error Bits: 0x01 Word Error 0x02 Sync Error 0x04 Word Count Error 0x08 Response Timeout 0x10 Format Error 0x20 Message Error 0x80 RT to RT IDMPINS ------- Read and dump recorded INS data from F-16, C-130, and A-10 EGI aircraft in a humanly (and Microsoft Excel) readable form. On the command line specify channel number, RT address, TR bit, and Subaddress of the INS message. Use the -d flag to reduce the number of dumped INS points. Currently two types of INS messages are supported, the EGI INS unit commonly found on F-16, A-10, and C-130 aircraft, and the F-15 INS message type. Use the -a flag to output additional aircraft attitude data. The -g flag can be used to specify a reference position on the ground. More than one reference position can be specified by using multiple -g flags. When one or more reference positions are defined, the INS output will also include position and attitude information relative to that point. The -m flag can be used to only dump INS data points when within a prescribed distance from the reference point. The -T flag can be used to dump a brief TMATS summary of the data file to help in choosing command line parameters. Usage: idmpins [flags] Input/output file names -v Verbose -a Dump aircraft INS attitude -c Bus IRIG Channel Number -r RT INS RT Address(1-30) (default 6) -t T/R INS T/R Bit (0=R 1=T) (default 1) -s SA INS Message Subaddress (default 16) -d Num Dump 1 in 'Num' messages (default all) -i Type INS Type (default 1) 1 = F-16/C-130/A-10 EGI 2 = F-15 -g Lat Lon Elev Ground target position (ft) -m Dist Only dump within this many nautical miles of ground target position -T Print TMATS summary and exit IDMPGPS ------- Read GPS NMEA strings from a UART channel. NMEA GPGGA and GPRMC sentences are supported, and it is assumed both are available. Use the "-G" flag to restrict output to just those data fields supported by GPGGA. Use the "-C" flag to restrict output to data fields supported by GPRMC. The -g flag can be used to specify a reference position on the ground. More than one reference position can be specified by using multiple -g flags. When one or more reference positions are defined, the GPS output will also include position and attitude information relative to that point. The -m flag can be used to only dump GPS data points when within a prescribed distance from the reference point. Usage: idmpgps [flags] Input/output file names -v Verbose -c ChNum Channel Number (required) -G Print NMEA GGA data -C Print NMEA RMC data -g Lat Lon Elev Ground target position (ft) -m Dist Only dump within this many nautical miles of ground target position -T Print TMATS summary and exit IDMPUART -------- Read and dump UART packet data. By default UART data is dumped as a series of hexidecimal bytes. By default all channels will be dumped. Use the -c flag to select a single channel. Use the -s flag to dump the UART packet as an ASCII string. This is handy for data such as GPS NMEA sentences. Any non-printable ASCII data is dumped as a hexidecimal value. The -T flag can be used to dump a brief TMATS summary of the data file to help in choosing command line parameters. Usage: idmpUART [flags] Input/output file names -v Verbose -c ChNum Channel Number (default all) -s Print out data as ASCII string -T Print TMATS summary and exit The output data fields are: Time Chan-Subchan Data... IDMPTIME -------- Read and dump time packets. This is useful for debugging time problems. Usage: idmptime [flags] Input/output file names -v Verbose -c ChNum Channel Number (default all) -T Print TMATS summary and exit Time columns are: Channel ID Relative Time Counter Value Time Time Source Time Format Leap Year Flag IDMP429 ------- Read and dump ARINC 429 packets. Use the "-c" flag to restrict dumps to a specific channel number. Each channel may have multiple 429 buses. Use the "-b" flag to restrict dumps to a specific 429 bus. Usage: idmpa429 [flags] Input/output file names -v Verbose -c ChNum Channel Number (default all) -b BusNum 429 Bus Number (default all) -T Print TMATS summary and exit The output data fields are: Time ChanID BusNum Label SDI Data SSM IDMPETH -------