                ͻ
                          DOVE-OSCAR-17 Satellite        
                        Telemetry Decoding Program       
                    KD2BD Software - Copyright 1995    
                ͼ
                

INTRODUCTION
============
The DOVE-OSCAR-17 Satellite Telemetry Decoding Program version 1.1 is
a simple and easy-to-use telemetry decoding program designed to decode
ASCII telemetry transmissions made by the DOVE-OSCAR-17 satellite.  It
was created to satisify the needs of DOVE enthusiasts around the world
who desire a simple telemetry decoding program for the DOVE spacecraft.
Version 1.1 supercedes version 1.0 released in 1994 that was found to
produce incorrect results for telemetry channels 30 and 45.

A version of this program is also available for the Linux operating
system.  See CONDITIONS OF USE below before using this software.

DOVE-OSCAR-17 uses a narrow-band FM beacon to transmits stored voice 
messages and telemetry information on a carrier frequency of 145.825 MHz.  
A standard 2-meter FM receiver and packet radio terminal node controller 
(TNC-2 clone) along with PC terminal software are used to decode the AX.25 
transmissions from the spacecraft and store those transmissions in an ASCII 
text file for processing by this program.


PROGRAM OPERATION
=================
The DOVE-OSCAR-17 satellite telemetry decoding program operates from 
the MS-DOS command line.  The decoded output is normally directed to the 
system console, but it is suggested that the output is re-directed to a 
text file for easier analysis.

The following are several examples of how the program may be executed:

dove file1.tlm file2.tlm ...  | more      : Directs output to console
dove file1.tlm file2.tlm ... >> prn       : Directs output to printer
dove file1.tlm file2.tlm ... >> file.txt  : Directs output to text file
               
...where file1.tlm and file2.tlm are ASCII text files containing captured
DOVE telemetry frames.  The program has the ability to read in a number of 
telemetry files if more than one is available for analysis.  A separate 
report is generated for each file successfully decoded.


TELEMETRY DECODING
==================
The following is a portion of a transmission made by DOVE-OSCAR-17 that was 
captured by KD2BD in New Jersey on 31-Jan-95 when the spacecraft was nearly 
3000 kilometers away:

DOVE-1>TIME-1 <UI>:
PHT: uptime is 235/01:14:12.  Time is Tue Jan 31 15:17:53 1995

SWITCH>SWITCH <DM>
DOVE-1>TLM <UI>:
00:59 01:58 02:86 03:33 04:55 05:59 06:6B 07:52 08:70 09:70 0A:A1
0B:FF 0C:E8 0D:DA 0E:F1 0F:24 10:DB 11:9F 12:01 13:DA 14:9D 15:AA
16:79 17:74 18:77 19:76 1A:78 1B:47 1C:7E 1D:7A 1E:CD 1F:64 20:D3

DOVE-1>TLM <UI>:
21:BF 22:7A 23:27 24:1C 25:38 26:19 27:00 28:00 29:00 2A:02 2B:84
2C:01 2D:72 2E:59 2F:9D 30:D0 31:9D 32:01 33:00 34:A7 35:AA 36:AA
37:AB 38:8E

The DOVE-OSCAR-17 satellite telemetry decoding program searches the input
file for valid telemetry frames such as the ones shown above and re-arranges 
those frames in the event they were captured out of sequence.  The program 
accepts the first set of valid telemetry frames contained in the input file.  
Telemetry frames must begin with the header "DOVE-1>TLM" and be followed by 
hexadecimal telemetry values on the three lines following the header.  This 
format is consistant with a TAPR TNC-2 terminal node controller with 
HEADERLN ON.  If a time frame is detected in the input file, then a time 
stamp is included in the final telemetry report generated by the program.  
Status frames are ignored by this program since their significance changes 
with satellite on-board computer software revisions, and contain data 
primarily of interest to spacecraft controllers only.


TELEMETRY REPORT EXAMPLE
========================
The DOVE-OSCAR-17 satellite telemetry decoding program produced the 
following report based on the telemetry above:
 
 --------------- DOVE-1 Satellite Telemetry Analysis By KD2BD --------------

DOVE-1/OSCAR-17 Raw Telemetry:

DOVE-1>TIME-1:
PHT: uptime is 235/01:14:12.  Time is Tue Jan 31 15:17:53 1995

DOVE-1>TLM:
00:59 01:58 02:86 03:33 04:55 05:59 06:6B 07:52 08:70 09:70 0A:A1
0B:FF 0C:E8 0D:DA 0E:F1 0F:24 10:DB 11:9F 12:01 13:DA 14:9D 15:AA
16:79 17:74 18:77 19:76 1A:78 1B:47 1C:7E 1D:7A 1E:CD 1F:64 20:D3

DOVE-1>TLM:
21:BF 22:7A 23:27 24:1C 25:38 26:19 27:00 28:00 29:00 2A:02 2B:84
2C:01 2D:72 2E:59 2F:9D 30:D0 31:9D 32:01 33:00 34:A7 35:AA 36:AA
37:AB 38:8E

DOVE-1/OSCAR-17 Decoded Telemetry:

[00] Rx E/F Audio (W)    2.19    V(p-p)
[01] Rx E/F Audio (N)    2.16    V(p-p)
[02] Mixer Bias V        1.37     Volts
[03] Osc. Bias V         0.52     Volts
[04] Rx A Audio (W)      2.09    V(p-p)
[05] Rx A Audio (N)      2.19    V(p-p)
[06] Rx A DISC           0.50       KHz
[07] Rx A S Meter       82.00    Counts
[08] Rx E/F DISC        -1.48       KHz
[09] Rx E/F S Meter    112.00    Counts
[10] +5 Volt Bus         4.91     Volts
[11] +5V Rx Current     25.50        mA
[12] +2.5V VREF          2.51     Volts
[13] +8.5V Bus           8.52     Volts
[14] IR Detector       241.00    Counts
[15] LO Monitor I        1.33        mA
[16] +10V Bus           11.11     Volts
[17] GaAs FET Bias I     4.13        mA
[18] Ground REF          0.01     Volts
[19] +Z Array V         22.30     Volts
[20] Rx Temp             6.05    Deg. C
[21] +X (RX) Temp       -1.82    Deg. C
[22] Battery 1 V         1.38     Volts
[23] Battery 2 V         1.39     Volts
[24] Battery 3 V         1.38     Volts
[25] Battery 4 V         1.37     Volts
[26] Battery 5 V         1.38     Volts
[27] Battery 6 V         1.57     Volts
[28] Battery 7 V         1.38     Volts
[29] Battery 8 V         1.37     Volts
[30] Array Voltage      21.96     Volts
[31] +5V Bus             5.05     Volts
[32] +8.5V Bus           8.92     Volts
[33] +10V Bus           11.63     Volts
[34] BCR Set Point     132.64    Counts
[35] BCR Load Curr     185.12        mA
[36] 8.5V Bus Curr      43.97        mA
[37] +5V Bus Curr      246.38        mA
[38] -X Array Curr      43.00        mA
[39] +X Array Curr     -13.49        mA
[40] -Y Array Curr     -11.96        mA
[41] +Y Array Curr     -11.41        mA
[42] -Z Array Curr     -11.63        mA
[43] +Z Array Curr     289.59        mA
[44] Ext Power Curr    -17.50        mA
[45] BCR Input Curr    422.60        mA
[46] BCR Output Curr   289.81        mA
[47] Bat 1 Temp          6.05    Deg. C
[48] Bat 2 Temp        -24.81    Deg. C
[49] Baseplate Temp      6.05    Deg. C
[50] FM TX#1 RF Out      0.02     Watts
[51] FM TX#2 RF Out     -0.00     Watts
[52] PSK TX HPA Temp    -0.00    Deg. C
[53] +Y Array Temp      -1.82    Deg. C
[54] RC PSK HPA Temp    -1.82    Deg. C
[55] RC PSK BP Temp     -2.42    Deg. C
[56] +Z Array Temp      15.13    Deg. C


The calibration equations used in this program are those released by 
spacecraft controllers in 1990.  The decimal numbers in [brackets] specify 
the telemetry channel number presented in the report.  These are displayed
as hexadecimal digits in telemetry transmissions made by DOVE-OSCAR-17.


CONDITIONS OF USE
=================
The files contained in this software package are the property of John A. 
Magliacane, copyright 1994.  You are welcomed to share this software with 
others provided it is distributed in a complete and unmodified form and
provided no fee or other consideration is charged or accepted.  You are 
granted the right to use this software for non-commercial purposes without 
further permission.  Commercial use of this software without the expressed 
written permission of the author is strictly forbidden.  John A. Magliacane, 
the author of this software, shall not be liable in any way for any damages
arising out of the proper or improper use of this software or its related
files.

A considerable amount of time and effort has gone into the development of 
this program.  If you find this software useful, a contribution of $10 or
more would be appreciated.  Not only would a contribution help compensate 
for the hard work and long hours that have gone into the development of this 
satellite telemetry decoding program, but your financial support will also 
serve as encouragement for the author to pursue enhanced versions of this 
and other related software.  

Checks should be made payable in U.S. funds to the author and sent to the
following address:

        John A. Magliacane, KD2BD
        1320 Willow Drive
        Sea Girt, New Jersey  08750-2315

Comments and suggestions regarding this program are also welcomed with your
contribution.  

Thank you!

73, de John, KD2BD
