README.TXT

TPS for Windows TOOLKIT

Toolkit Applications
--------------------

The toolkit comprises the following executable applications

	PKTREDU.EXE	Packet file reduction and format conversion
	FTOPCK.EXE	File to packet conversion
	PKTTOF.EXE	Packet to file conversion
	COLTOPKT.EXE	Tabular data file to packet conversion
	EXPTIME.EXE	Parameter record and error file time conversion
	EXPERR.EXE	Error code descriptive expansion
	PASPLICE.EXE	Parameter record file splicer
	FILEREDU.EXE	Text file reduction
	HEXDUMP.EXE	File hexadecimal display viewer

See the TPSDIST\DOCS folder for the Toolkit Reference manual.

Other Files
-----------

There are many other other files not mentioned in the Reference Manual. These are examples, supplied as is, for those familiar with command line operations and batch files.

EXMPL1.BAT - example of using PKTREDU, PASPLICE, COLTOPKT
EXMPL2.BAT - example of using EXPERR, FTOPKT, PKTTOF

TESTDEF1.BAT - example of using PKTREDU
TESTDEF2.BAT - another example of using PKTREDU
TESTDEF3.BAT - example of using FTOPKT, PKTTOF
TESTDEF4.BAT - another example of using FTOPKT, PKTTOF


TEMP.* - temporary output files
TEMP2.* - temporary output files

ATTITUDE.TXT - output of EXMPL1.BAT

ATTITUDE.BIN - output of EXMPL1.BAT

ATTITUDE.DAT - 
 output from EXMPL1.BAT, raw binary format equivalent of compressed 
 binary file 5.bin

EXPERR2.DAT - pre-recorded raw binary packet file for EXMPL2.BAT

EXPERR2.txt - output of EXMPL2.BAT

TPSERR.TXT - example TPS error file for use with EXMPL2.BAT

PAGE0000.DEF - 
 default page 0 file PAGE0000.BIN with packet format  sync 0x1234 and packet length 128 bytes.

PAGE0000.BIN - default TPS page 0 binary file

PAGE0000.TXT - default TPS page 0 source file - used by TESTDEF3.BAT

5.BIN - 
 copy of compressed binary packet file 5.BIN from the SAMPLES folders

PAGE0005.BIN - copy of compiled page file 5 from the SAMPLES folders

PAGE0016.BIN - copy of compiled page file 5 from the SAMPLES folders

PAGE0000.297 - 
 version of page0000.bin with 4-byte sync 0xaabbccdd and packet length 297 bytes

rollM.TXT - 
 pre-recorded parameter files from replay of 5.bin on SAMPLES page 5

pitchM.TXT - see rollM.TXT

yawM.TXT - see rollM.TXT

Example command line batch files:
EXMPL1.BAT
EXMPL2.BAT

------------
Undocumented
------------

An extra utility, HEXDUMP.EXE is also supplied, but not documented in the TOOLKIT Reference Manual. It is a simple hexadecimal file viewer with side-by-side ASCII translation.

Unlike the toolkit applications, HEXDUMP.EXE only requires the input filename with no 'infile:' prefix, e.g. to view the file 5.bin in hexadecimal, enter:

	hexdump 5.bin

and to pause the display after each screenful, enter:

	hexdump 5.bin | more

HEXDUMP writes the data to the display. However, by simply using the redirection symbol '>', the output can be redirected to a file.

	hexdump 5.bin > temp.txt

All files are treated as binary, i.e., every byte is displayed with no character translation for control codes.

This application is extremely useful for checking where the sync pattern appears in input, raw binary format packet data files.
