home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / rtty / dove3w13 / dove3wwg.doc next >
Text File  |  1990-03-19  |  16KB  |  454 lines
  1. DOVE3WWG DOVE OSCAR-17 Telemetry Decoder Mon Feb 26 23:46:37 1990
  2. ═════════════════════════════════════════════════════════════════
  3.  
  4. New Version 1.3 Features:
  5. ═════════════════════════
  6.  
  7.     *    Option -c on the command line, causes the display to be
  8.         shown in color.
  9.  
  10.     *    Option "-s callsign" (or prefix) limits data capture to 
  11.         frames starting with callsign or prefix. This is handy if
  12.         you have more that one HAPN card active in your PC. For
  13.         example:
  14.  
  15.         D> DOVE3WWG -s DOVE-
  16.  
  17.         will only capture those frames starting with "DOVE-".
  18.  
  19.     *    Should run on just about any kind of monitor. No graphics
  20.         are required, and color is optional. Hercules is supported.
  21.  
  22.  
  23. Version 1.0 Features:
  24. ═════════════════════
  25.  
  26.     *    Raw input from a file. This makes the program useful
  27.         to non HAPN card users and permits review of old data.
  28.  
  29.     *    NK6KTLM file compatible. If you've captured files or
  30.         edited them into the format required by the NK6KTLM
  31.         decoder, then DOVE3WWG will process them asis.
  32.  
  33.     *    HAPN card support.  Just point your antenna, and leave
  34.         DOVE3WWG running. It obtains its data directly from
  35.         the HAPN card (requires M25 & HAPN1.SYS however). No
  36.         FIXUP is required on the captured telemetry file since
  37.         C25 is not used.
  38.  
  39.     *    When capturing from the HAPN card, a telemetry file name is
  40.         generated automatically for ease of capture. File names
  41.         are based upon UTC date and time. If by chance the generated
  42.         name exists, no problem-- the file is appended to.
  43.  
  44.     *    When output redirection is not used, the formatted screen
  45.         continually updates as new packets come in (from file or
  46.         HAPN card). The bottom 2 lines scroll to show other
  47.         information packets.
  48.  
  49.     *    When output is directed to a file (for printing), the
  50.         format is automatically adjusted for the purpose. It
  51.         can be used in this form as input to other graphical
  52.         software packages.
  53.  
  54.     *    Packets from the HAPN card are UTC date and time stamped.
  55.         This is useful when data capture of the satellite time
  56.         stamps is poor.
  57.  
  58.     *    Data not understood by this program is not discarded. It
  59.         simply passes through (and captured).
  60.  
  61.  
  62. Copyright Status:
  63. ═════════════════
  64.  
  65.         Its free. It would be nice if everyone could send a small
  66.     donation to AMSAT, or join. But it is not expected or required.
  67.  
  68.         Please copy it and distribute it amongst your friends.  
  69.     Although this program is free, certain authorized organizations
  70.     may charge a fee for copying and distribution (hopefully just to
  71.     recover costs).
  72.  
  73.  
  74. Installing:
  75. ═══════════
  76.  
  77.     The DOVE3WWG is designed to be completely self contained and
  78. "hassle free". However there are some small points to be dealt with
  79. first.
  80.  
  81.     Only the executable file DOVE3WWG.EXE is required for its operation.
  82. There are no supporting data files to make it operate. Just copy this file
  83. where your other command files go (according to your PATH).
  84.  
  85.     For proper UTC time generation, there must exist an environment
  86. variable TZ. This is the variable as used by the Microsoft C library. The
  87. following shows an example of how to set it:
  88.  
  89.     set TZ=EST5EDT
  90.  
  91.     The example shows that:
  92.  
  93.         1.    The local time zone is Eastern Standard Time (EST).
  94.         2.    UTC is 5 hours ahead (TZ=EST+5EDT is also valid).
  95.             This can be a signed number.
  96.         3.    The time zone is Eastern Daylight savings Time
  97.             when it is in effect (EDT)
  98.         4.    Microsoft default if the variable is NOT defined
  99.             is "set TZ=PST8PDT" (DOVE3WWG will complain if it
  100.             is not set).
  101.  
  102.     If daylight savings is never in effect, then omit the "EDT".
  103.  
  104.     You will also have to adjust this value when you switch to/from
  105. daylight savings time. Don't forget! The telemetry capture files will
  106. contain bad time stamps if you do!
  107.  
  108.     If the H.A.P.N. telemtery capture feature is to be used, there
  109. are some addtional prerequisits.
  110.  
  111.     1.    H.A.P.N. card must be installed (of course).
  112.     2.    HAPN1.SYS driver must be installed.
  113.     3.    M25.EXE must have been installed for use.
  114.  
  115.     Non H.A.P.N. users will still be able to feed file data into
  116. the program for useful decoding.
  117.  
  118.     Ok, now lets play!
  119.  
  120.  
  121. General Introduction:
  122. ═════════════════════
  123.  
  124.     The DOVE3WWG program has 2 basic "input modes" and 2 two
  125. basic "output modes". You may mix and match them as you wish. But
  126. first lets just list the modes available:
  127.  
  128.     Input Modes:
  129.     ════════════
  130.  
  131.         a)    Standard input (by DOS redirection)
  132.         b)    H.A.P.N. packet radio card input
  133.  
  134.     Output Modes:
  135.     ═════════════
  136.  
  137.         a)    Standard output to a file (DOS redirected)
  138.         b)    Formatted screen (no redirection)
  139.  
  140.     Furthermore, there is one more "output" that is built into
  141. this program. When the H.A.P.N. card is used for "input", a telemetry
  142. capture file is opened for appending (if it exists). The name is generated
  143. by taking the UTC date and time and formatting a file name in the current
  144. directory as follows:
  145.  
  146.     ydddhhmm.O17
  147.  
  148.     where:    y    is the last digit of the year
  149.             y = 0 for 1990, y = 1 for 1991, etc.
  150.         ddd    is the day of the year.
  151.             ddd = 0 is jan 1, 31 is feb 1, etc.
  152.         hhmm    UTC hour and minute.
  153.         .O17    represents OSCAR-17
  154.  
  155.  
  156. Command Options:
  157. ════════════════
  158.  
  159.     DOVE3WWG -h        Gives help (or -?)
  160.  
  161.     or
  162.     DOVE3WWG [-c] [-s prefix]
  163.  
  164.     where:    -c        Uses colour (or color when state side).
  165.         -s prefix    Capture only frames starting with 'prefix'.
  166.                 (Normal use is -s DOVE or -sDOVE)
  167.  
  168.     note:            Options are case sensitive.
  169.  
  170. Examples of Use:
  171. ════════════════
  172.  
  173.     D> DOVE3WWG                Captures from HAPN card
  174.                         and updates screen parameters
  175.                         as they come in. A capture
  176.                         file is written also.
  177.  
  178.     D> DOVE3WWG -sVE3            Same as above, but this tests
  179.                         its ability to reject all but
  180.                         VE3 frames (use -s DOVE for
  181.                         satellite).
  182.  
  183.     D> DOVE3WWG <00550245.O17        This command reviews an old
  184.                         telemetry file that was
  185.             captured starting on Feb 25, 1990 0245 UTC. The values
  186.             are updated on the screen as if they came in from the
  187.             H.A.P.N. card, only much faster.
  188.  
  189.     D> DOVE3WWG <00550245.O17 -c        This command is the same as
  190.                         the above, except that the 
  191.             formatted screen display is done in colour.
  192.  
  193.     D> DOVE3WWG <00550245.O17 >FEB25.RPT    This command processes the
  194.                         same telemetry file, except
  195.             that the information is formatted and written to
  196.             report file FEB25.RPT. The format differs from the
  197.             screen to be more suitable for printing. The output
  198.             file can also be used as input to graphing packages.
  199.  
  200.     D> DOVE3WWG >FEB25.RPT            This command captures from
  201.                         the H.A.P.N. card, but gen-
  202.             erates the report into file FEB25.RPT while doing
  203.             so. A telemetry capture file is written as well.
  204.  
  205.  
  206.  
  207. Testing it Out:
  208. ═══════════════
  209.  
  210.     The best thing to do is to test this program out BEFORE a real
  211. DOVE satellite pass. There is a sample TEST.O17 file to feed into the 
  212. program as input. This will show you what you can expect from a live
  213. pass in "fast forward" (assuming you are watching the formatted screen).
  214. Try the following:
  215.  
  216.     D> DOVE3WWG < TEST.O17
  217.  
  218.     Did the initial UTC date and time at the top right look correct?
  219. If not, adjust the value of your environment variable TZ.
  220.  
  221.     After having done that, now is a good time to test the data
  222. capture facility (non H.A.P.N. card users ignore). Make sure your
  223. HAPN1.SYS is installed, and M25.EXE has been run prior to invoking
  224. the following command (with no arguments):
  225.  
  226.     D> DOVE3WWG
  227.  
  228.     In this mode, the command formats a screen and will await
  229. telemetry packets to decode. The top right (again) should show the correct
  230. UTC date and time. Since this test is probably being done at a time when the
  231. satellite is unavailable, it is best to try it by tuning your packet
  232. radio to a busy packet frequency. You should begin to see packet traffic
  233. appear on the bottom 2 lines which will scroll away. No parameters will
  234. update on the screen, unless by a fluke that some traffic happened to
  235. possess the correct format.  While this is happening, data is being
  236. captured to a *.O17 file, and the UTC date and time should be updating
  237. on the screen when the program is not busy processing packets (time updates
  238. on the screen cease when traffic is present, and updates resume at idle
  239. periods).
  240.  
  241.     While capturing data from the H.A.P.N. card, use ^C or the
  242. Control-Break key to terminate the program. All files and the H.A.P.N.
  243. card will be closed down gracefully.
  244.  
  245.  
  246. Telemetry File Format:
  247. ══════════════════════
  248.  
  249.     A couple of notes on the capture file are in order. First of
  250. all, each packet is time stamped as it comes in. An example appears
  251. as follows:
  252.  
  253.  
  254. :: Thu Mar 01 04:19:52 1990 UTC
  255. DOVE-1>TIME-1:
  256. PHT: uptime is 076/13:47:53.  Time is Thu Mar 01 04:16:47 1990
  257.  
  258.  
  259.     The line starting with "::" identifies the line that was added
  260. by DOVE3WWG, and is only as accurate as your PC system clock. However,
  261. in this case, we can see that either my PC clock is out, or the DOVE
  262. clock has drifted (probably my PC), or maybe both.
  263.  
  264.     The purpose of the time stamps are to overcome the problem of
  265. a series of packets that might be recieved without time stamps under
  266. marginal receive conditions. These lines are easy to remove if that
  267. becomes necessary, since each line begins with "::".
  268.  
  269.     Only DOVE-1>TLM: packets are decoded. The following are also
  270. from the satellite, but are simply recorded without interpretation
  271. (time stamps removed here):
  272.  
  273.  
  274. DOVE-1>STATUS:
  275. 80 00 00 85 B0 18 77 02 00 B0 00 00 B0 00 00 00 00 00 00 00
  276. DOVE-1>WASH:
  277. wash addr:1900:0000, edac=0x07
  278. DOVE-1>TIME-1:
  279. PHT: uptime is 076/13:48:03.  Time is Thu Mar 01 04:16:57 1990
  280. DOVE-1>BCRXMT:
  281. vbat= 11.082 vlo1= 10.569 vlo2= 10.069 vmax= 11.569 temp=  5.451
  282.  
  283.  
  284.     A couple of telemetry packet look as follows:
  285.  
  286.  
  287. DOVE-1>TLM:
  288. 00:58 01:58 02:88 03:31 04:58 05:58 06:6E 07:45 08:6C 09:66 0A:A1
  289. 0B:DB 0C:E8 0D:D8 0E:00 0F:24 10:D0 11:93 12:00 13:02 14:B0 15:9B
  290. 16:92 17:8C 18:8F 19:90 1A:8D 1B:86 1C:94 1D:90 1E:26 1F:5F 20:BF
  291. DOVE-1>TLM:
  292. 21:A6 22:77 23:11 24:15 25:2E 26:00 27:00 28:00 29:00 2A:00 2B:00
  293. 2C:00 2D:2A 2E:01 2F:9E 30:CC 31:9F 32:16 33:64 34:C6 35:9F 36:A8
  294. 37:A8 38:BA 39:99 3A:00
  295.  
  296.  
  297.     This program tries to be forgiving about this data. Rather than
  298. rely on the "DOVE-1>TLM:" to follow a consistant format, the program does
  299. some simple tests on a given line to see if it is a "TLM" line. A line that
  300. follows the format of:
  301.  
  302.  
  303. 21:A6 22:77 23:11 24:15 25:2E 26:00 27:00 28:00 29:00 2A:00 2B:00
  304.  
  305.  
  306. will be accepted regardless of its origin. Some may be using TNC's that
  307. capture the block of TLM data as follows:
  308.  
  309.  
  310. DOVE-1>TLM:00:58 01:58 02:88 03:31 04:58 05:58 06:6E 07:45 08:6C 09:66 0A:A1
  311. 0B:DB 0C:E8 0D:D8 0E:00 0F:24 10:D0 11:93 12:00 13:02 14:B0 15:9B
  312. 16:92 17:8C 18:8F 19:90 1A:8D 1B:86 1C:94 1D:90 1E:26 1F:5F 20:BF
  313. DOVE-1>TLM:21:A6 22:77 23:11 24:15 25:2E 26:00 27:00 28:00 29:00 2A:00 2B:00
  314. 2C:00 2D:2A 2E:01 2F:9E 30:CC 31:9F 32:16 33:64 34:C6 35:9F 36:A8
  315. 37:A8 38:BA 39:99 3A:00
  316.  
  317.  
  318. In this case, DOVE3WWG starts its simple tests beyond the first ":",
  319. and proceeds as if there was no difference. This permits you to feed it
  320. your existing NK6KTLM data (DOVE only) files as well.
  321.  
  322.  
  323. Live Capture:
  324. ═════════════
  325.  
  326.     The biggest challenge here is knowing when to listen for it. Hope-
  327. fully you already have a program to help with that. If not, there are several
  328. available from AMSAT-NA and other organizations. Make sure you use up to date
  329. keplerian data. It should be no older than a couple of months at most.
  330.  
  331.     Finally, just tune to 145.825 Mhz. I find that the computer sometimes
  332. copies better at 145.830 at the beginning of the pass. This is due in part to
  333. doppler shift (and imperfections in my rig). I later switch back to 145.825.
  334. Your mileage may vary, enjoy!
  335.  
  336.  
  337. Appendix A:
  338. ═══════════
  339.  
  340. (From Bob Grier N4HY)
  341.  
  342. Spacecraft:  DOVE-1:                  Rev: 1
  343.                           Date: 1/7/90  
  344.  
  345. Equations are in the form: Y = A*N^2 + B*N + C
  346. where: 
  347.     N = Telemetry Count (00 - FF) 
  348.     A, B, C = Equation Coefficients
  349.     Y = Result (In Specified Units)
  350.  
  351. HEX   Descripion:     C:          B:       A:       Units:     
  352.              cccccccccc   bbbbbbbbbb   aaaaaaaaaa  uuuuuu
  353.  
  354.  0    Rx E/F Audio(W)+0.000      +0.0246      0.000       V(p-p)
  355.  1    Rx E/F Audio(N)+0.000      +0.0246      0.000       V(p-p)
  356.  2    Mixer Bias V:  +0.000      +0.0102      0.000       Volts
  357.  3    Osc. Bisd V:   +0.000      +0.0102      0.000       Volts 
  358.  4    Rx A Audio (W):+0.000      +0.0246      0.000       V(p-p)
  359.  5    Rx A Audio (N):+0.000      +0.0246      0.000       V(p-p)
  360.  6    Rx A DISC:     +10.427      -0.09274     0.000       kHz
  361.  7    Rx A S meter:  +0.000      +1.000       0.000       Counts
  362.  8    Rx E/F DISC:   +9.6234      -0.09911     0.000       kHz
  363.  9    Rx E/F S meter:+0.000      +1.000       0.000       Counts
  364.  A    +5 Volt Bus:   +0.000      +0.0305      0.000       Volts
  365.  B    +5V Rx Current:+0.000      +0.000100    0.000       Amps
  366.  C    +2.5V  VREF:   +0.000      +0.0108      0.000       Volts
  367.  D    8.5V BUS:      +0.000      +0.0391      0.000       Volts
  368.  E    IR Detector:   +0.000      +1.000       0.000       Counts
  369.  F    LO Monitor I:  +0.000      +0.000037    0.000       Amps
  370. 10    +10V Bus:      +0.000      +0.05075     0.000       Volts
  371. 11    GASFET Bias I: +0.000      +0.000026    0.000       Amps
  372. 12    Ground REF:    +0.000      +0.0100      0.000       Volts
  373. 13    +Z Array V:    +0.000      +0.1023      0.000       Volts
  374. 14    Rx Temp:         +101.05      -0.6051      0.000       Deg. C
  375. 15    +X (RX) temp:  +101.05      -0.6051      0.000       Deg. C
  376. 16    Bat 1 V:         +1.7932      -0.0034084   0.000       Volts
  377. 17    Bat 2 V:         +1.7978      -0.0035316   0.000       Volts
  378. 18    Bat 3 V:         +1.8046      -0.0035723   0.000       Volts
  379. 19    Bat 4 V:         +1.7782      -0.0034590   0.000       Volts
  380. 1A    Bat 5 V:         +1.8410      -0.0038355   0.000       Volts
  381. 1B    Bat 6 V:         +1.8381      -0.0038450   0.000       Volts
  382. 1C    Bat 7 V:         +1.8568      -0.0037757   0.000       Volts
  383. 1D    Bat 8 V:         +1.7868      -0.0034068   0.000       Volts
  384. 1E    Array V:         +7.205      +0.07200     0.000       Volts
  385. 1F    +5V Bus:         +1.932      +0.0312      0.000       Volts
  386. 20    +8.5V Bus:     +5.265      +0.0173      0.000       Volts
  387. 21    +10V Bus:      +7.469      +0.021765    0.000       Volts
  388. 22    BCR Set Point: -8.762      +1.1590      0.000       Counts
  389. 23    BCR Load Cur:  -0.0871      +0.00698     0.000       Amps
  390. 24    +8.5V Bus Cur: -0.00920      +0.001899    0.000       Amps
  391. 25    +5V Bus Cur:   +0.00502      +0.00431     0.000       Amps
  392. 26    -X Array Cur:  -0.01075      +0.00215     0.000       Amps
  393. 27    +X Array Cur:  -0.01349      +0.00270     0.000       Amps
  394. 28    -Y Array Cur:  -0.01196      +0.00239     0.000       Amps
  395. 29    +Y Array Cur:  -0.01141      +0.00228     0.000       Amps
  396. 2A    -Z Array Cur:  -0.01653      +0.00245     0.000       Amps
  397. 2B    +Z Array Cur:  -0.01137      +0.00228     0.000       Amps
  398. 2C    Ext Power Cur: -0.02000      +0.00250     0.000       Amps
  399. 2D    BCR Input Cur: +0.06122      +0.00317     0.000       Amps
  400. 2E    BCR Output Cur:-0.01724      +0.00345     0.000       Amps
  401. 2F    Bat 1 Temp:    +101.05      -0.6051      0.000       Deg. C
  402. 30    Bat 2 Temp:    +101.05      -0.6051      0.000       Deg. C
  403. 31    Baseplt Temp:  +101.05      -0.6051      0.000       Deg. C
  404. 32    FM TX#1 RF OUT:+0.0256      -0.000884    +0.0000836  Watts
  405. 33    FM TX#2 RF OUT:-0.0027      +0.001257    +0.0000730  Watts
  406. 34    PSK TX HPA Temp+101.05      -0.6051      0.000       Deg. C
  407. 35    +Y Array Temp: +101.05      -0.6051      0.000       Deg. C
  408. 36    RC PSK HPA Temp+101.05      -0.6051      0.000       Deg. C
  409. 37    RC PSK BP Temp:+101.05      -0.6051      0.000       Deg. C
  410. 38    +Z Array Temp: +101.05      -0.6051      0.000       Deg. C 
  411. 39    S band TX Out: -0.0451      +0.00403     0.000       Watts
  412. 3A    S band HPA Temp+101.05      -0.6051      0.000       Deg. C
  413.  
  414.  
  415. Special Thanks:
  416. ═══════════════
  417.  
  418.     Hats off to all on the Microsat team for making the project a
  419. reality. Many thanks also for sharing the telemetry decoding information
  420. at an early stage. Of course, special thanks to:
  421.  
  422.     idacrd!mac@princeton.edu (Robert McGwier N4HY)
  423.  
  424.  
  425. AMSAT-NA:
  426. ═════════
  427. The Radio Amateur Satellite Corporation,
  428. 850 Sligo Ave.,
  429. Silver Spring, MD USA 20910
  430. (301) 589-6062
  431.  
  432. H.A.P.N.
  433. ════════
  434. (for the HAPN-1 Packet Radio Adapter)
  435.  
  436. Hamilton and Area Packet Network
  437. Box 4466, Station D,
  438. Hamilton, Ontario, Canada
  439. L8V 4S7
  440.  
  441. The Author:
  442. ═══════════
  443.  
  444. Warren W. Gay VE3WWG
  445. 3 Goldsmith Avenue,
  446. St. Catharines, Ontario, Canada.
  447. L2M 2V7
  448.  
  449. Packet radio:    VE3WWG @ VE3NUU
  450. or:               @ VE3HPL
  451. or:               @ VE3RD
  452.  
  453. Unix:        !ncrcan!brambo!wwg
  454.