This file is superseeded by the website for aprstlm: 
http://www.xciv.org/~iain/aprstlm/

Specifically usefull may be the "Big Cheat Sheets" which live at:

http://www.xciv.org/~iain/aprstlm/bigcheatsheet-raw.png
http://www.xciv.org/~iain/aprstlm/bigcheatsheet-eng.png

The main inspiration behind the user interface of aprstlm came from:

a) The look of NASA's Flight Control Rooms, at MCC Houston.
b) The look of ao40tlmview
c) aprsDOS

The screen is divided up into a number of windows. At the top,
on the left, we have a clock window, which shows the time in UTC,
Local Time, and also Mission Elapsed Time (MET).

UTC and Local Time is in ANSI Format, ie YYYY/MM/DD HH:MM:SS
However, "MET" is different, and is in the format OOOOO/DDDD HH:MM:SS
where:

OOOOO Is the Orbit number of the satellite. This is retrieved from
      the predict server, and reads "-----" if the predict server
      was unavaliable. Note that for PCSAT2 it inheirits the orbit
      number of ISS, since PCSAT2 is attached to ISS.

DDDD  Days since Launch (or deployment in the case of PCSAT2)

HH:MM:SS are the familiar Hours, Minutes, and Seconds, since 
         Launch or deployment.


Next, in the middle, at the top of the screen is the header
window, which just tells you which satellite you are viewing


On the right hand at the top, is the "Location" window. This
shows the longitude, latitude, range, and eclipse values from
the predict server, if avaliable.


Below the clock,header, and location windows, we have the main
telemetry window. This can have a number of different layouts,
and you can switch between them using the [TAB] key.

Normally, there will always be a "RAW Telemetry Values" layout,
and a "Telemetry Engineering Values" layout. Others may be added,
depending on each satellite's requirements.

(For example, RAFT is unlikely to even need two layouts, only
having one telemetry frame, we can get both the raw and engineering
layout on one window, but PCSAT requires 4 (A-Side "Raw Telemetry",
"Space Environment (Temps)", B-Side "Raw Telemetry, and finally
"Electrical Power Telemetry Values")

At program start, all values will remain blank until the program
receives a telemetry packet containing those values.

On the right hand side of each telemetry value, there is a hidden
"S". Should we fail to get a telemetry frame in a specified amount
of time (5 minutes currently), then the S will show on a Cyan
background. All values in the frame will show the "S" (For "static"
data)

In the case of the raw layout, then the "S" is per frame of course.


Beneath the main telemetry window on the left, we have the Binary
Command Bits window. This shows the state of each of the binary
command bits in the latest received telemetry frame.

Normal text indicates a "1" in the telemetry frame, Reverse video
indicates a "0". Note for PCSAT2, for the FM Repeater bit, the
code does check both bit7 and bit8, and does the correct thing.

There is a hidden "S" against each item, that will light if
we have no telemetry within the timeout period. This window will
remain blank until we receive telemetry.


On the right-hand side of the binary command bits window, we have
a window showing the last time we received each telemetry frame.

This window can show the time in UTC, Local Time, Mission Elapsed
Time, or Time Elapsed since the frame was received. Use the "T"
key to switch between the different time formats. 

The (hidden) 'static' "S" is also on the right-hand size of each 
Frame Date. Again, the window will be blank (except for it's
title), until telemetry is received.


At the Bottom of the screen we have two windows. In the case of
PCSAT2, they are used for the ARM Values (on the left), and, on
the right, we have some timers, and other telemetry values,
that have to be inferred from some of the engineering values.
(see http://web.usna.navy.mil/%7ebruninga/pec/PC2tlmNotes.txt)

Normal text means the Relay is set (Z Bit=0), reverse video means
it is "Armed" (Z Bit=-1).

The two timers are similar in that reverse video indicates they are
set. Ditto for the LVSHUNT. The static "S", is again avaliable to the
right of each value.

The "ROLL" value is not an actual telemetry value, but goes
reverse video, if the telemetry counter rolls over from 999
to 000.

The values in these bottom two windows are very PCSAT2 specific,
and unlikely to be needed for other APRS satellites (In fact
most of them are to do with crew safety, due to the fact that
PCSAT2 is attached to the ISS).

This means that these two windows can be used for other functions
on other satellites.

For PCSAT, the left hand window is used to display the +5V Ref level,
as well as the two bits that indicate if the Batteries, or Transmitters
have been isolated. Normal text means the bit is not set, inverse video
means that theyve been isolated from each other.