home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / control / spec25 / spec525.doc < prev    next >
Text File  |  1990-08-08  |  26KB  |  656 lines
  1.  
  2.  
  3.  
  4.      SPEC525.DOC                Wednesday, August 8, 1990                 Page 1
  5.  
  6.  
  7.       
  8.       
  9.       
  10.       
  11.       
  12.       
  13.                           +---------------------+
  14.                           |                     |
  15.                           |    S P E C 5 2 5    |
  16.                           |   (SPECTRUM  525)   |
  17.                           |                     |
  18.                           +---------------------+
  19.       
  20.       
  21.       
  22.                                 Version 3.1
  23.       
  24.       
  25.       
  26.                           A Mouse Control Program
  27.                                   for the
  28.                 JRC Model NRD-525 General Coverage Receiver
  29.       
  30.                                     by
  31.       
  32.                              James P. Hawkins
  33.       
  34.                               August 8, 1990
  35.       
  36.                       (First Release) April 24, 1990
  37.       
  38.       
  39.                   Copyright (C) 1989-90, James P. Hawkins
  40.                             All Rights Reserved
  41.       
  42.       
  43.                              James P. Hawkins
  44.                                P.O. Box 9146
  45.                          Trenton, New Jersey 08650
  46.       
  47.       
  48.       
  49.       
  50.       
  51.       
  52.       
  53.       
  54.       
  55.       
  56.       
  57.       
  58.       
  59.       
  60.       
  61.       
  62.  
  63.  
  64.  
  65.      SPEC525.DOC                Wednesday, August 8, 1990                 Page 2
  66.  
  67.       
  68.       
  69.       
  70.       
  71.       
  72.       
  73.                          * * * S P E C 5 2 5 * * *
  74.                               (SPECTRUM 525)
  75.       
  76.       
  77.      INTRODUCTION
  78.          This program was written by James  P.  Hawkins  WA2WHV  as  a
  79.          visual  means  of  controlling  the JRC NRD-525.  Most of the
  80.          receiver controls  are  available  on  the  PC  screen.   The
  81.          salient   feature  of  this  program  is  the  display  of  a
  82.          multicolored frequency  spectrum  chart,  divided  into  band
  83.          allocations.  Each allocation can be clicked on as if it were
  84.          a menu selection which causes a frequency calibrated expanded
  85.          dial.   In  addition  to  the  frequency  marks, the dial can
  86.          contain station names  or  any  markings  the  user  desires.
  87.          These  markings  are stored in data files.  It requires a VGA
  88.          graphics as the resolution must be high enough to resolve the
  89.          frequency  dial.   The program is actually an ACTIVE spectrum
  90.          chart, broken up into 6 bands.  At this  time,  the  data  is
  91.          based  files  which  represent  the  hour  of the day and one
  92.          common file which contains markings which will appear for any
  93.          time of day.
  94.       
  95.      INSTALLATION
  96.          Before proceeding, make a backup copy of  the  diskette.   To
  97.          install spec525, insert the diskette and type a:install.  The
  98.          installation will leave you in the C:  The program  is  setup
  99.          to  operate on port COM1 at 1200 baud.  If you wish to change
  100.          the  port  to  COM2,  edit  the  SPEC525.INI  file  so   that
  101.          port=COM2.  The same applies for ports COM3 and COM4.  To set
  102.          the baud rate to 1200  on  your  receiver,  hold  the  "memo"
  103.          button  down  and  press  the '8' button repeatedly until the
  104.          number 1200 is observed on the frequency  dial.   You  should
  105.          now be able to start the program by typing spec525.
  106.       
  107.          If you want the program to be universally executable add  the
  108.          following line to the end of your autoexec.bat file.
  109.       
  110.                  path=%PATH%;c:\spec525
  111.       
  112.          The program needs an SPEC525.INI  file  present  in  whatever
  113.          current directory you are in when you invoke it.  If there is
  114.          none present, it will attempt to create one.  The data  files
  115.          used  by  spec525 should reside in whatever path is specified
  116.          by the "path=" line in SPEC525.INI.  Initially it is  set  to
  117.  
  118.  
  119.  
  120.      SPEC525.DOC                Wednesday, August 8, 1990                 Page 3
  121.  
  122.  
  123.          C:   If you have the demo, type DEMO525 to start the program.
  124.          If it's the registered version type SPEC525.
  125.       
  126.      CONTROLS
  127.          This section describes the graphics control panel.
  128.       
  129.          Dial Pointer
  130.              On the  top  of  the  screen  is  a  dial  pointer  which
  131.              indicates  the current selected position on the frequency
  132.              spectrum or dial.  It starts up at zero.
  133.       
  134.          Spectrum/Magnified Bandspread
  135.              The area  below  the  dial  displays  a  portion  of  the
  136.              frequency  spectrum  between 100KHz and 34 MHz, depending
  137.              on what the  band  switch  is  set  to  (read  on).   The
  138.              spectrum  display  consists  of  color  coded areas, each
  139.              representing a specific allocation of the band.  The left
  140.              mouse  button  may  be  clicked  on or dragged across the
  141.              spectrum to change the  frequency  in  10KHz  increments.
  142.              The  dial pointer will follow and remain where it is left
  143.              when the mouse button is released.  If  the  right  mouse
  144.              button  is  clicked  on  one  of the allocations, it will
  145.              expand or magnify into a frequency calibrated dial  which
  146.              is  controllable  in  1KHz increments with the left mouse
  147.              button.  On the bandspread dial, is a  horizontal  center
  148.              line,  above  which  are  frequency markings.  Below this
  149.              line are labeled markings which may be added  or  changed
  150.              by the user.
  151.       
  152.          Fine Tune
  153.              The fine tune dial, which is below and to the  center  of
  154.              the  spectrum  dial,  allows  the  user  to tune in 10 Hz
  155.              increments by clicking or dragging in the lower  half  of
  156.              the  box with the left mouse button.  The dial pointer in
  157.              the upper half will follow and  remain  where  the  mouse
  158.              button is released.
  159.       
  160.          Fine Tune Offset Indicator
  161.              This indicator is to the right of the fine tune  bar  and
  162.              indicates  the plus or minus offset which is added to the
  163.              main dial when the fine tuning is changed.
  164.       
  165.          Memory Channel Map - MCM
  166.              MCM is  a  visual  representation  of  the  200  receiver
  167.              channels  numbered every fifth square from 0 to 195.  The
  168.              squares seem small  at  first,  but  are  quite  easy  to
  169.              select.   The  channel  map is in halfway down the screen
  170.              and contains  two  rows  of  squares.   The  top  row  is
  171.              numbered  to 95 and the bottom row is numbered to 195.  A
  172.              channel is addressed by simply moving the cursor  onto  a
  173.              square and clicking the left mouse button.  There are two
  174.              selections which determine whether clicking a channel map
  175.              square  will  store  the  current  receiver  settings  or
  176.              retrieve  those  already  contained  in    the   receiver
  177.              channel.   They  are  labeled RECALL and STORE with "MCM"
  178.  
  179.  
  180.  
  181.      SPEC525.DOC                Wednesday, August 8, 1990                 Page 4
  182.  
  183.  
  184.              appearing below them.  The highlighted option is the  one
  185.              in  effect  and  it will remain in effect until the other
  186.              option is chosen by clicking the  mouse  on  the  option.
  187.              Initially  the program starts in a RECALL mode to prevent
  188.              inadvertant destruction of  a  channel.   The  user  must
  189.              deliberately chose STORE.
  190.       
  191.              With this method, the user may easily store large  groups
  192.              of  frequencies  very  quickly by alternately clicking to
  193.              the frequency, then clicking the memory channel while  in
  194.              STORE  mode.   The  user may also type in frequencies and
  195.              channels as will be shown.
  196.       
  197.          Slew control
  198.              This is below and to the left of the Spectrum display and
  199.              consists of a circle and two arrows on either side.  This
  200.              control is only effective when the display  is  magnified
  201.              to  a  bandspread.   Clicking on the right or left arrows
  202.              steps the expanded display to the next allocation without
  203.              having  to  go  back  to  the  spectrum.  Clicking on the
  204.              circle,  simply  redisplays  the  current  band  display.
  205.              Slewing  is  limited  to  either  end of the current band
  206.              selection.
  207.       
  208.      RECEIVER CONTROLS
  209.          In the lower half  of  the  screen  are  other  controls  and
  210.          indicators.  A selection is made by "clicking" the left mouse
  211.          button on your selection.  When a selection is made the  menu
  212.          item  displays  black  lettering  on  white  background  in a
  213.          reverse video fashion.  The NON-MODE  menu  (SET  FREQ,  DIAL
  214.          MARK, SAVE DB, CHAN STO. CHAN REC.)  does not highlight as it
  215.          does not put the receiver into any mode.
  216.       
  217.          Digital Frequency and Time Indicator
  218.              Indicates the time and current frequency setting  of  the
  219.              receiver  PLUS  the value of timeshift in the SPEC525.INI
  220.              file.  The user  may  edit  the  timeshift  parameter  to
  221.              display  any  timezone shifted from his/her PC time.  The
  222.              best choice is probably Universal Time.
  223.       
  224.          Mode Switch
  225.              Allows selection of RTTY, CW, USB, LSB, AM, FM, FAX using
  226.              the  left  mouse  button.   The  black  area  at  the top
  227.              indicates the current setting.
  228.       
  229.          Bandwidth Switch
  230.              Allows selection of receiver  bandwith  to  WIDE,  INTER,
  231.              NARROW,  AUX.   Note  that  the NARROW selection will not
  232.              work without the optional CFL-232 filter mounted.
  233.       
  234.          CHAN STO. and CHAN REC.
  235.              Allows setting of receiver channels.  Clicking on CHANnel
  236.              STOre  will  prompt  the user for a channel number.  Upon
  237.              entering the channel number, the receiver channel will be
  238.              set to the current program parameters.
  239.  
  240.  
  241.  
  242.      SPEC525.DOC                Wednesday, August 8, 1990                 Page 5
  243.  
  244.  
  245.       
  246.              Clicking the CHANnel RECall will prompt the  user  for  a
  247.              channel  number.   Upon entering the number, the receiver
  248.              will be set to the parameters contained in  that  channel
  249.              number.
  250.       
  251.              I may remove these menu options to make room for  others,
  252.              as the previously explained channel map method of storing
  253.              and recalling receiver settings  is  a  visual  and  more
  254.              convenient way of setting channels.
  255.       
  256.          DIAL MARK and SAVE DB
  257.              Allows setting of memory and dial labeling.  Clicking  on
  258.              the  DIAL  MARK  causes the program to ask for a typed in
  259.              input at the bottom of the screen.  When the  user  types
  260.              in a label, followed by a carriage return, the bandspread
  261.              dial will display a labeled tick mark at  the  point  the
  262.              the  frequency  was  set when the label was typed in.  If
  263.              the program  is  on  an  expanded  dial,  the  dial  will
  264.              redisplay to show the new mark, however, if the frequency
  265.              is not in range of the current expanded  dial,  the  mark
  266.              will  not show up unless the user goes to the appropriate
  267.              expanded dial.  This might happen in the case of a  typed
  268.              in  frequency.  REMOVAL of a dial mark is accomplished by
  269.              setting  the  dial  to  the  mark  to  be  removed,  then
  270.              following  the  above  procedure,  but  entering  only an
  271.              <ENTER>.   The  SAVE  DB  option  stores  the  dial  mark
  272.              information  in  the  data  base for the particular hour.
  273.              The labels are temporary unless the user clicks the  SAVE
  274.              DB option.
  275.       
  276.          SET FREQ Option
  277.              When this option is "clicked", the prompt will ask for an
  278.              input frequency to be typed in KHz.  This allows the user
  279.              to type in a specific frequency manually.   This  feature
  280.              in conjunction with the DIAL MARK function can be used to
  281.              enter a series of frequencies  and  labels  from  a  list
  282.              without having to view them or move the frequency dial or
  283.              change the bandswitch.  Also by using the  DBASE  option,
  284.              the  entry  can  be  made for the appropriate hour of the
  285.              day.  It is important to remember, however that  SAVE  DB
  286.              must be clicked to store them away.
  287.       
  288.          SEARCH and SRCH NEXT
  289.              This  selection  allows  the  program  to  search  for  a
  290.              specific  station  name  entry when typed in by the user.
  291.              First occurrences of a label will be found  by  selecting
  292.              SEARCH.  Subsequent occurrences of the same label will be
  293.              found by using SRCH NEXT.  If you click the SEARCH option
  294.              it  prompts  you  for a label. So, if you type in wwv, it
  295.              will  look  for  the  first  occurrence  or  lowest   wwv
  296.              frequency.  If you then click SRCH NEXT, it will look for
  297.              the next occurrence of wwv.  Each time  you  select  SRCH
  298.              NEXT it will look for the next occurrence.  So if you had
  299.              entered all the wwv frequencies, it will select  2.5  MHZ
  300.  
  301.  
  302.  
  303.      SPEC525.DOC                Wednesday, August 8, 1990                 Page 6
  304.  
  305.  
  306.              first  then as you keep selecting SRCH NEXT it will cycle
  307.              through 5.0, 10.0, 15.0, 20.0 and 25.0 MHZ and then cycle
  308.              back  to  the  first.   So  if  I  want  to find the best
  309.              reception of WWV, I just  type  it  in  once,  then  keep
  310.              searching  for the best.  Input is not sensitive to upper
  311.              or  lower  case  so  it  does  not  matter  whether   the
  312.              characters are upper or lower case.
  313.       
  314.          AGC
  315.              AGC FAST/SLOW/OFF
  316.       
  317.          ATTEN
  318.              Attenuator ON/OFF.
  319.       
  320.          REM
  321.              Remote control ON/OFF.  This frees up the receiver to  be
  322.              controlled  manually,  by  disabling program control.  If
  323.              receiver is turned on after program is started,  you  can
  324.              synchronize  the  receiver  with  the program by clicking
  325.              remote off, then remote on.  Turning on  remote,  outputs
  326.              ALL   of   the  saved  receiver  status.   This  is  also
  327.              convenient  if  you  want  to  turn   the   remote   off,
  328.              temporarily change the actual receiver controls, then put
  329.              it back to the state it was in by turning the remote  on.
  330.              The  idea  being that the receiver should be in the state
  331.              the program is in when the receiver is listening.
  332.       
  333.          DBASE
  334.              Database file 0-23.  Selects which file to use  for  dial
  335.              markings.   The  numbers  represent  the hour of the day.
  336.              The program automatically  selects  the  data  file  that
  337.              represents  the current hour of the day as it is known by
  338.              the PC.  When the hour changes, the  data  file  changes,
  339.              thus changing the dial markings.  The datafiles are named
  340.              dbandN.525 where  N  represents  the  hour  of  the  day.
  341.              Another  file is cmnband.525.  This file contains station
  342.              names and frequencies that are to be displayed regardless
  343.              of  hour such as Citizens band channel numbers, WWV, etc.
  344.              Dbase files are found in the directory path specified  by
  345.              the  path setting in the SPEC525.INI file which exists in
  346.              whatever current directory the user is in at the time  of
  347.              program execution.
  348.       
  349.          ADB
  350.              Automatic database, disables automatic time switching  of
  351.              data file.
  352.       
  353.          Bandswitch
  354.              Selects the frequency range of the spectrum display.
  355.       
  356.          RECEIVER STATUS SAVE
  357.              The uses editable data contained in the SPEC525.INI  file
  358.              to  initialize.   As  previously  stated,  SPEC525.INI is
  359.              located in whatever directory the user is in at the  time
  360.              of  program  invocation.   When  a user exits the program
  361.  
  362.  
  363.  
  364.      SPEC525.DOC                Wednesday, August 8, 1990                 Page 7
  365.  
  366.  
  367.              normally by clicking on the exit menu selection,  control
  368.              settings  and frequency settings are saved SPEC525.INI in
  369.              the form of NRD-525 command strings.  The port name, baud
  370.              rate  and  datapath  and  timeshift are also specified in
  371.              this file.  When the program is started, it looks for the
  372.              values in this file to reset controls.  If a value is not
  373.              present, a default setting, hardcoded in the  program  is
  374.              used.
  375.       
  376.              The  "timeshift="  entry  in  SPEC525.INI   allows   time
  377.              adjustment for time conversion to any time zone including
  378.              Universal time.  For example if Universal time is desired
  379.              and  your  PC is set to EDT, then set timeshift=4 for a 4
  380.              hour time difference.   The  program  will  then  display
  381.              Universal  time.  Set timeshift=0 if you want the program
  382.              to display the time set in your PC.
  383.       
  384.              The user may edit these values manually and the order  is
  385.              unimportant.   When  the  program is terminated normally,
  386.              the file will  be  rewritten.   Missing  values  will  be
  387.              entered and modified values will be changed.
  388.       
  389.              If the file does not exist or is empty, the program  will
  390.              create one with the default values.
  391.       
  392.              This editable form makes it  possible  for  the  user  to
  393.              write   another   program  which  can  set  the  receiver
  394.              parameters as they are all documented  with  the  NRD-525
  395.              interface  card.   An example of the contents of the file
  396.              is as follows:
  397.       
  398.                      port=COM1
  399.                      baud=1200
  400.                      datapath=C:\USR\JIM\
  401.                      timeshift=4
  402.                      A0
  403.                      B3
  404.                      C001
  405.                      D0
  406.                      E1
  407.                      F00113000
  408.                      G0
  409.                      I0
  410.       
  411.              The default settings are as follows:
  412.                      port=COM1
  413.                      baud=1200
  414.                      datapath=c:\spec525\
  415.                      timeshift=0
  416.                      A0
  417.                      B0
  418.                      C001
  419.                      D4
  420.                      E1
  421.                      F00113000
  422.  
  423.  
  424.  
  425.      SPEC525.DOC                Wednesday, August 8, 1990                 Page 8
  426.  
  427.  
  428.                      G0
  429.                      I0
  430.          FUTURE PLANS
  431.              When time allows, I am planning to add an additional menu
  432.              to  the  program  which  will  allow  the user to LOAD or
  433.              COMBINE station data from other  named  data  files  then
  434.              save  the  file  under  any desired name.  For example, a
  435.              single  file  may  contain  a  set  of  frequencies   for
  436.              HURRICANE  tracking; another might contain stations which
  437.              contain Spanish Speaking Stations.  These can  be  loaded
  438.              separately   or   combined.   Another  could  be  a  file
  439.              containing dipole antenna lengths so  that  when  loaded,
  440.              the  dial  will  be  a rule to calculate antenna lengths.
  441.              Any  ideas  on  ways  to  implement  these  features  are
  442.              welcome.   Send  me  postal  mail  or  contact me through
  443.              CompuServe ID 71760,3362.
  444.       
  445.       
  446.       
  447.       
  448.       
  449.       
  450.       
  451.       
  452.       
  453.       
  454.       
  455.       
  456.       
  457.       
  458.       
  459.       
  460.       
  461.       
  462.       
  463.       
  464.       
  465.       
  466.       
  467.       
  468.       
  469.       
  470.       
  471.       
  472.       
  473.       
  474.       
  475.       
  476.       
  477.       
  478.       
  479.       
  480.       
  481.       
  482.       
  483.  
  484.  
  485.  
  486.      SPEC525.DOC                Wednesday, August 8, 1990                 Page 9
  487.  
  488.  
  489.       
  490.       
  491.       
  492.       
  493.       
  494.       
  495.       
  496.       
  497.       
  498.       
  499.       
  500.       
  501.       
  502.       
  503.       
  504.       
  505.       
  506.       
  507.       
  508.       
  509.       
  510.       
  511.       
  512.      SHAREWARE and COPYRIGHT NOTICE
  513.       
  514.          Welcome to user supported software (commonly referred  to  as
  515.          "SHAREWARE").   User  supported  software  allows  you to try
  516.          software before you buy, and when you do  buy,  to  pay  much
  517.          less  than for commercially developed software.  This is true
  518.          because there are no costs  for  advertising,  sales  staffs,
  519.          fancy  packaging  and  distribution  costs  bundled  into the
  520.          software. Just good software, not glossy  packaging,  and  no
  521.          hassles.  Pay  only  if  you  like  it.  Your registration of
  522.          SPEC525 will encourage more development of this type software
  523.          and  ultimately  provide  better  software at lower prices to
  524.          everyone.  SPEC525 3.1 and  its  follow  on  products  depend
  525.          entirely upon your support for their existence.  This program
  526.          is a demob, but the only disabled feature is the  ability  to
  527.          save  new  label  entries (SAVE DB) and the number of station
  528.          labels is limited to 200.  If you register  this  program,  I
  529.          will mail you a fully working copy of the program.
  530.       
  531.          SPEC525 V3.1 is protected by U.S. and international copyright
  532.          laws.   SPEC525  was  written  by  me,  James  P.  Hawkins in
  533.          Microsoft C and is Copyright (c) 1988-90 by James P. Hawkins.
  534.          All rights are reserved.
  535.       
  536.          _________________________________________________________________
  537.       
  538.          You  are specifically granted the right to use SPEC525 3.1 on
  539.          a 30 day trial basis.  If you like it and you  want  a  fully
  540.          functional  copy,  you  must  register  your  copy by sending
  541.          $36.50 to
  542.       
  543.                                James P. Hawkins
  544.  
  545.  
  546.  
  547.      SPEC525.DOC                Wednesday, August 8, 1990                Page 10
  548.  
  549.  
  550.                                  P.O. Box 9146
  551.                             Trenton, NJ 08650-1146
  552.       
  553.                     Residents of NJ must include sales tax.
  554.                     (Currently 7%, so please send $39.05).
  555.          _________________________________________________________________
  556.       
  557.          You are also encouraged to share SPEC525 V3.1 with others and
  558.          to distribute copies on computerized bulletin board  systems,
  559.          however you may not:
  560.       
  561.          1)  Charge  for,  or  otherwise  sell,  lease  or  rent  this
  562.              program.  This  also  prohibits  bundling of this program
  563.              with some other product or service.
  564.          2) Modify the program or its documentation in any way.
  565.          3) Distribute the program without this .DOC file.
  566.          4) Distribute this program as part of  a  promotion  for  any
  567.              commercial  venture  or as an inducement to purchase some
  568.              product or service.
  569.       
  570.      You MAY, however, charge a fee for  the  actual  distribution  of
  571.      this  program.  In this case, it must be made clear to the person
  572.      receiving SPEC525 that a registration fee is still  required,  if
  573.      the user intends to keep SPEC525.
  574.       
  575.      Warrantee: This program is being provided "AS IS". It  is  up  to
  576.      the  user  to determine the suitability of this program for their
  577.      purposes. The user takes all responsibility  for  any  direct  or
  578.      consequential  damages.   It is written for VGA graphics only.  A
  579.      monochrome version may be made available in the future when I get
  580.      the chance.
  581.       
  582.      Support: Please DO report all bugs, difficulties or  improvements
  583.      desired.   Registered  users will be notified of the availability
  584.      of the updates.
  585.       
  586.      I have not yet determined the price of updates.  It  will  depend
  587.      on  the change.  If an update is only serious bug fixes, the cost
  588.      will be very minimal.   If  major  enhancements  are  added,  the
  589.      update will be more.
  590.       
  591.       
  592.       
  593.       
  594.       
  595.       
  596.       
  597.       
  598.       
  599.       
  600.       
  601.       
  602.       
  603.       
  604.       
  605.  
  606.  
  607.  
  608.      SPEC525.DOC                Wednesday, August 8, 1990                Page 11
  609.  
  610.  
  611.       
  612.       
  613.       
  614.       
  615.       
  616.       
  617.       
  618.       
  619.       
  620.       
  621.       
  622.       
  623.       
  624.       
  625.       
  626.       
  627.       
  628.       
  629.       
  630.       
  631.       
  632.       
  633.       
  634.       
  635.       
  636.       
  637.       
  638.       
  639.       
  640.       
  641.       
  642.       
  643.       
  644.       
  645.       
  646.       
  647.       
  648.       
  649.       
  650.       
  651.       
  652.       
  653.       
  654.       
  655.  
  656.