Log10GHz for Palm Pilot

by Paul Wade W1GHZ copyright 1999
Released to the public domain July 1999

version 0.2 July 1999 initial public release.
version 0.3 (beta)  August 1999
- fixes a problem with the GMT offset getting lost.
version 0.4 August 1999
- now asks for other grid first, returns heading so you
  can aim the antenna, then asks for call to record QSO
  (thanks to Matt, KB1VC for suggestion: saves switching
   back and forth between BD and logging)

This is a tiny logging program for the Palm Pilot for the
ARRL 10 GHz &up Cumulative Contest.  Version 0.3 and 0.4 have two
separate logging programs:  10g_log for 10 GHz ONLY operation, 
to minimize input entries, and log_cum, a multiband version.
I used the multiband version for the 1999 UHF contest and the
10 GHz only version for the first weekend of the ARRL 10 GHz contest.

The logger only records the data, as a MEMO PAD record.  It can
be exported to a PC (or Mac) and postprocessed for scoring, either
manually or with software I haven't written yet.  It could probably 
be done with a spreadsheet. 

some of the routines are translated from BD.PAS:

   PROGRAM Bearing_Distance;
                   {Determines bearing and distance based on}
                   {algorithm compensating for earth's shape}
                   {Copyright 1993 Michael R. Owen, W9IP & }
                   {               Paul Wade, N1BWT }
                   {Released to the public domain Feb 23, 1993}

                   {NOTE: NORTH latitude, WEST longitude apre positive;   }
                   {      South & East should be input as negative numbers}


to C by Matt Reilly KB1VC, then PocketC by Paul Wade W1GHZ.

*****
NOTE: PocketC is shareware, by Orbworks (www.orbworks.com), and
is required for BD_Palm to run.  You should register your copy
to be legal.
*****


TO INSTALL:

1. Install PocketC.prc on your Palm Pilot.

2. Install MathLib.prc on your Palm Pilot, if you don't
   have it already.
   
3. Install log_10g.prc on your Palm Pilot.
   (Multiband: log_cum.prc)

4. Tap the 10G icon.
   (Multiband: "Log" icon) 



RUNNING:

When the program starts, it asks for your call, then searches the MEMO PAD
for a record starting with the same string.  If it finds it, it asks for 
your current location, then proceeds to append additional contacts to the
log.  

If it does not find an existing log, it starts a new one, asking for your
GMT offset (I assume that your Palm Pilot is on local time and you wish to
log in Zulu).  Then you are prompted for your current location and can begin
loggin.

For each contact, you are prompted for a grid, then Bearing and Distance are
displayed. Next you are prompted for a call, [and band if multiband version] 
then asked to confirm the information before writing it to the log.  If you 
make a mistake, just enter "N" and re-enter the information.

Between contacts, you may simply turn off the Palm Pilot; it will power up
right where you left off.

If you move to a new grid, closing and restarting the program will prompt
for the new location.

The GMT offset (version 0.3+) is stored in a MEMO PAD record called GMTzone.
If you were to change timezones, you would have to manually edit the number
stored in this record.  The current GMT offset is displayed at startup.

QUIRKS:

1. The program does minimal checking for grid format only.  Anything else gets
entered, but you can easily edit the log in the MEMO PAD.

2. The GMT conversion does not adjust the date; i.e., if you log a contact
at 10:23 PM EDT, it will be logged as 2623Z on the current local date.  This
is much easier to fix in a postprocessor.

3. No Daylight Savings Time adjustment.  When it changes, or if you move to a 
new time zone, edit the GMT offset in the MEMO PAD record called GMTzone.  It
is an integer on the second line.

4. The band entry in the multiband version is simply a string, with no checking.
You may enter frequency, wavelength, ARRL alphanumeric band designators, or 
anything else you like.  Fix it later in postprocessing.  [Note that this means
you are not limited to microwaves -- you could enter 160M, another contest that
uses grid squares.]

COMPILING:

If you want to fiddle with the program, you may recompile.  

1. Rename the source files to *.txt

2. Load each source file to the Palm Pilot as a separate memo
   in MEMO PAD.
   
3. Start PocketC and compile.


ENHANCEMENTS:

This is intended to be a small, easy to use logging program.  This program only
takes 6K of storage.  Try that with Windows!

version 0.4 is up to 7K with bearing calculation.


COMMENTS and BUG REPORTS to wade@tiac.net
