K3TZ AO-07 Telemetry Decoder Version 0.5 08-JUL-2002
---------------------------------------------------------------------
Program Description:

This program is designed to read a text file of AO-07 telemetry values and decode them into their respective parameters.  The CW telemetry from AO-07 is in the format:

1xx 1xx 1xx 1xx
2xx 2xx 2xx 2xx
3xx 3xx 3xx 3xx
4xx 4xx 4xx 4xx
5xx 5xx 5xx 5xx
6xx 6xx 6xx 6xx

Where the xx above equals the telemetry data copied from the CW beacon.
---------------------------------------------------------------------
Telemetry File:

This program requires that you create a text file with the SAME format as shown above.  Use a text editor such as Notepad to create this file.

If you miss a data channel, simply put an x where the data channel value would of been.  For example, if you copied:

101 102 1?3 104
201 2?? 203 204
301 302 303 304
401 402 403 404
501 502 503 50?
601 602 603 604

where the ? is the number you missed, place an x (case sensitive) for a placeholder.

The above would become:

101 102 1x3 104
201 2xx 203 204
301 302 303 304
401 402 403 404
501 502 503 50x
601 602 603 604

Any data channels with an x in the value will be set to zero for that data channel.

You can also add three other lines to the text file that the program can decode: Orbit, Date, and Time.

These three parameters have to be entered on their OWN line as follows (case sensitive):

ORBIT 25346
DATE 07-JUL-2002
TIME 21:13

These three parameters are optional.

A sample telemetry file is included named "ao-07 tlm sample.txt" which demonstrates all of the above.
---------------------------------------------------------------------
Running the Program:

After installation, click on Start, Program Files (or All Programs for XP users), K3TZ AO-07 Telemetry Decoder, K3TZ AO-07 Telemetry Decoder.

The window layout is pretty self-explanatory.  Click on File, Open, to open the telemetry text file that you created.

The first line in the input file is displayed in the "File I/O" frame in the "Input Data" text box located in the lower right.  Clicking on the "Next" button will load the next line of the telemetry text file.  Keep clicking on the "Next" button until the end of the file is reached.

Once you have a telemetry text file chosen, you can click on the button labeled "Auto" and the program will automatically advance to the next line every 200ms.  This is useful for creating spreadsheet files as explained below.  Once the "Auto" button is pressed, its label changes to "Stop".  Clicking on this button will stop the program from reading the file.

This program can tolerate blank lines and the "HI HI" that precedes every telemetry "block".
---------------------------------------------------------------------
Creating a ".csv" output file:

By clicking on the "Create .csv output file" checkbox, a comma-delimited file by the name of ao-07.csv will be created in the same directory as the input file.  This file can be directly imported into a spreadsheet program such as Excel.  If you want to create a spreadsheet file, it is advisable to click on this checkbox first before opening the input file.  Use the "Auto" button as explained above to quickly move through the file, and automatically create the output file.  The comma-seperated values that are being written to the output file are displayed in the "File I/O" frame in the "Output Data" text box.
---------------------------------------------------------------------
Best 73,
Tim - K3TZ
http://www.qsl.net/k3tz/index.html
---------------------------------------------------------------------