HAM Radio 1/HamRadio.cdr/log/g3zcz15/hamdoc.doc

Text File | 1987-01-24 | 14KB | 341 lines

        G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 4




        1.0  INTRODUCTION

        This  disk contains a number of sets of programs for using  your
        microcomputer  in your hobby of Amateur Radio.   Each family  is
        described in detail in the relevant sections below.

        The programs have grown up around the applications discussed  in
        the  books  and  magazine articles.   Some of the  programs  are
        released  at this time to provide copies in source code  of  the
        package  written  for the Northstar Horizon.   This  dialect  of
        BASIC is somewhat different to the dialect spoken on the PC.  It
        is  expected  that  by the next release of  this  software,  the
        programs will have been converted.   On the other hand,  if  you
        use  the  DBASE2 logging package,  you will never use the  BASIC
        version again,  and in my opinion, when a logging package can be
        written in DBASE2 there is no need to ever write one in BASIC.

        The modules of the DBASE2 logging package provide one of the few
        examples  of software written in DBASE2 readily available in the
        PC field.

        2.0  COMPUTER AIDED DESIGN

        These  are  a set of programs showing examples of the use  of  a
        computer  for  design.   Descriptions of what  each  program  is
        supposed  to do are contained in my book,  SOFTWARE FOR  AMATEUR
        RADIO  published by TAB Books (Number 1560),  Blue Ridge Summit,
        Pa., 17214.


        2MFUND.BAS   Calculates the fundamental frequencies for crystals
                     at  8Mhz,  12MHz  and 18MHz for the USA  144MHz  FM
                     channel transmit frequencies, and the corresponding
                     45MHZ receive  frequency.   Book,  listing,  Figure
                     1.10.

        FREQPLOT.BAS Calculates the oscillator injection frequencies for
                     an  HF  amateur band transceiver having a 9MHZ  IF.
                     Book, listing, Figure 1.5.

        OSCFREQ.BAS  Calculates  the  resonant  frequency  of  a   tuned
                     circuit for a range of capacitance values,  given a
                     constant  value of inductance (input by the  user).
                     Book, listing, Figure 1.3.

        OSCPLOT.BAS  Calculates  resonant frequencies of an  oscillator.
                     Book, listing, Figure 1.8.

        OSCUPLK.BAS  Calculates  crystal fundamental frequencies (at  8,
                     12  and  18MHZ) that produce signals in  the  OSCAR
                     Mode  A  uplink range of 145.85 to  146MHz.   Book,
                     listing, Figure 1.13.









        G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 5


        UPLINK.BAS   Calculates  crystal fundamental frequencies (at  8,
                     12  and  18MHZ) that produce signals in  the  OSCAR
                     Mode  B uplink range of 145.85  to  146MHz.   Book,
                     listing, Figure 1.14.

        RESISTOR.BAS Calculates  the currents through a range of  resis-
                     tances  at various circuit input  voltages.   Book,
                     listing, Figure 1.2.




        3.0  LOGGING

        This is a set of programs written in Northstar BASIC for logging
        contacts  into a floppy disk data file.   Northstar BASIC uses a
        type '2' for programs by convention.   Each program is described
        in  detail  in chapter 2 of my book SOFTWARE FOR  AMATEUR  RADIO
        published by TAB Books (Number 1560),  Blue Ridge  Summit,  Pa.,
        17214.   The programs are given here on this version of the disk
        for the sake of completeness.   The package will be converted to
        PC-BASIC  in  the next release of this disk.   In the  meantime,
        feel  free  to  do your own  conversions,  or  purchase  a  used
        NORTHSTAR system and run the package of programs on it.

        FILES.2      Lists  log  or  data files on the  selected  floppy
                     disk.  Book, listing, Figure 2.4.

        HELP.2       Lists  programs or commands on the selected  floppy
                     disk.  Book, listing, Figure 2.5.

        LOG.2        Main  program  that  starts  the  package.    Book,
                     listing, Figure 2.6.

        LOGARNGE.2   This program is not in the book.   It rearranges  a
                     contest  log,  numbers the entries and readies  the
                     log  for transmission to a second computer  running
                     soft  sectored  CP/M  or  PC-DOS  (by  the  LOGSEND
                     program).   This  program  is  the first  stage  in
                     converting  the logs to a DBASE2 format on  a  more
                     modern machine.

        LOGDEL.2     Deletes a log file from the disk.   Book,  listing,
                     Figure 2.10.

        LOGEDIT.2    Allows  the user to edit the contents of a log data
                     file (For example, add QSL information as cards are
                     received).  Book, listing, Figure 2.11.

        LOGENTER.2   Allows new entries to be made into the log.   Book,
                     listing, Figure 2.12.

        LOGLIB.2     Library  of subroutines used in most of  the  other
                     programs  in the package.   Book,  listing,  Figure
                     2.7.








        G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 6



        LOGMERGE.2   Joins  a second log file to the end of  the  first.
                     Book, listing, Figure 2.13.

        LOGPRINT.2   Prints  the contents of a log file according to the
                     criteria  supplied by  the  user.   Book,  listing,
                     Figure 2.14.

        LOGRENAM.2   Renames a log file.  Book, listing, Figure 2.15.

        LOGRESTR.2   Restores a crashed log file.  Book, listing, Figure
                     2.16.

        LOGSEND.2    This  program is not in the book.   It transmits  a
                     contest  log that has been arranged by the LOGARNGE
                     program  from  the  serial port  of  the  Northstar
                     computer.   This  program was written  to  transfer
                     logs  between the Northstar system and an OSBORNE 1
                     microcomputer.   After 400 lines,  it stops so that
                     the  files on the OSBORNE can closed out and a  new
                     one  opened for the ballance of the original  file.
                     This program is the second stage in converting  the
                     logs  to a DBASE2 format on a more modern  machine.
                     In this instance the logs were further converted to
                     PC format diskettes for use by the remainder of the
                     package.

        NEWLOG.2     Creates  a  new  formatted log  data  file.   Book,
                     listing, Figure 2.9.

        QSLPRINT.2   Prints labels  containing the QSO information to be
                     stuck on QSL cards.  Book, listing, Figure 2.18.

        STNINFO.2    File which contains the custom station data.  Book,
                     listing, Figure 2.8.

        SYSTEM.2     Command processing program to load desired  program
                     and   run   it.    Book,   listing,   Figure   2.3.


        4.0   AWARDS

        This  section contains two stes of programs written for  storing
        Award  data  on  disk files.   Others will be  added  in  future
        releases.

                4.1  WAS Package

                This  is  a set of programs converted from the  versions
                written  in  Northstar  BASIC  described  in  detail  in
                chapter 3 of the book.

                WASENTER.BAS Enters  WAS  data  into  a  WAS   database.
                             Converted from book listing, Figure 3.2.









        G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 7


                WASGEN.BAS   Generates  a WAS database.   Converted from
                             book  listing,  Figure 3.1.  RUN  THIS  ONE
                             FIRST.

                WASPRINT.BAS Prints/displays a WAS database acoording to
                             criteria  set by the  operator.   Converted
                             from book listing, 3.3.

                4.2 DXCC Package

                DXCCDEL.BAS  This  program  is  not  in  the  book.   It
                             deletes a prefix from a DXCC database.

                DXCCEDIT.BAS This  program is also not in the book.   It
                             allows  the user to edit the contents of  a
                             prefix entry in a DXCC database.

                DXCCGEN.BAS  Puts  new  entries into  a  DXCC  database.
                             Book, listing, Figure 3.5.

                DXCCREAD.BAS Prints/displays   the   DXCC  database   as
                             selected  by  the  user.    Book,  listing,
                             Figure 3.7.

                DXCCSORT.BAS Sorts the DXCC database into prefix  order.
                             Book, listing, Figure 3.9.

                W3.DX        This  is a sample DXCC data file as used by
                             the DXCC package.   Book,  listing,  Figure
                             3.6.

                All  programs  in this section in this  release  contain
                minimal error checking.

        5.0  CONTESTS

        This is a set of programs written in Northstar BASIC for contest
        operation  in which the check list is stored in RAM and the  log
        data is written out to disk files.  Each program is described in
        detail in chapter 4 of the book.  The programs are given here on
        this  version  of the disk for the sake  of  completeness.   The
        package  will  be converted to PC-BASIC in the next  release  of
        this  disk (CONTEST16.2 is alrady converted and is on the  disk,
        [see CONTEST.BAS]).

        CKLSTGEN.2   Generates  a check list file in alphanumeric  order
                     from a log file.   This prorogram is to be used after
                     a contest.  Book, listing, Figure 4.8.

        CKLSTRD.2    Prints/displays a checklist file.   Book,  listing,
                     Figure 4.9.

        CONTST16.2   General purpose contest operating program.  Updated
                     version of Book, listing, Figure 4.1/4.11.









        G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 8


        LOGFUDGE.2   Cleans  up  a contest  log  file.   Book,  listing,
                     Figure 4.7.

        MBCKLSTG.2   Multiband  check  list  generator  program.   Book,
                     listing, Figure 4.12.

        SWPSTAKS.2   Contest program optimised for the ARRL  Sweepstakes
                     Contest.   It  shows which sections still remain to
                     be  worked  on screen in  real  time  time.   Book,
                     listing,  Figure 4.4 (Sweepstakes contest program).


        7.0  ANTENNA POSITION AND POINTING

        This  is  a  set  of programs written  in  Northstar  BASIC  for
        calculating  the  position to point the antenna for  various  DX
        locations.   Each program is described in detail in chapter 6 of
        the  book.   The programs are given here on this version of  the
        disk  for  the  sake  of  completeness.   The  package  will  be
        converted to PC-BASIC in the next release of this disk.

        QTHANY.2     Prints  pointing  information  for  any  QTH.   The
                     program   prompts  for  lattitude   and   logtitude
                     information first.  Book, listing, Figure 6.6.

        QTHDATA.TXT  Sample   listing  of  lattitude  and  logitude  for
                     various cities world wide.    Book, listing, Figure
                     6.7.

        QTHFUDGE.2   Cleans  up any errors in a QTHDATA file  after  the
                     QTHGEN  program has been  run.      Book,  listing,
                     Figure 6.12.

        QTHGEN.2     Used  for  entering data into a table of  latitudes
                     and longitudes.  Book, listing, Figure 6.8.

        QTHLIB.2     Computing  subroutines  used  by  other   programs.
                     Book, listing, Figure 6.2.

        QTHPOINT.2   Positions  antenna in calculated direction.   Book,
                     listing, Figure 6.10.

        QTHSORT.2    Sorts a QTHDATA file.  Book, listing, Figure 6.9.


        8.0  SATELLITES

        This  is  a  set  of programs written  in  Northstar  BASIC  for
        calculating   the   position  of,   and   tracking   the   OSCAR
        communications satellites.   Each program is described in detail
        in  chapter 7 of the book.   The programs are given here on this
        version of the disk for the sake of completeness.   The  package
        will  be replaced by a version written in PC-BASIC in  the  next
        release of this disk.

        PHASE1.2     Computes equatorial crossing information (Reference







        G3ZCZ AMATEUR RADIO SOFTWARE PACKAGE VERSION 1.5 PAGE 10


                     orbits)  for  OSCAR  Phase  2  satellites.    Book,
                     listing, Figure 7.3.

        PHASE2.2     Computes  antenna pointing information for  working
                     through OSCAR Phase 2 satellites.   Book,  listing,
                     Figure 7.9.