home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / control / radctl03 / radio.doc < prev   
Text File  |  1990-05-07  |  37KB  |  1,671 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                 RADIO REMOTE CONTROL PROGRAM
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                        By Lydia Rosa
  23.  
  24.  
  25.    Copyright 1990 by Lydia Rosa
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                 RADIO REMOTE CONTROL PROGRAM
  36.   WHAT'S NEW IN THIS RELEASE
  37.  
  38.  
  39.  
  40.  
  41.    Version 0.3
  42.       Added the TXADR command to allow addresses other than 8 for
  43.       the ICOM radios.
  44.  
  45.       Fixed a bug in the SEARCH function.
  46.  
  47.    Version 0.2
  48.       Initial Release
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96. WHAT'S NEW IN THIS RELEASE                               1
  97.  
  98.                 RADIO REMOTE CONTROL PROGRAM
  99.   DISCLAIMERS
  100.  
  101.  
  102.  
  103.  
  104.  
  105.      IBM is a tradmark of IBM corporation.
  106.  
  107.      ICOM is a tradmark of ICOM incorporated.
  108.  
  109.      KENWOOD is a tradmark of KENWOOD corporation.
  110.  
  111.      DBASE III is a trademark of Ashton-Tate.
  112.  
  113.    The author  takes no  responsibility for any damages that
  114.   may occur due to the operation of this program.
  115.  
  116.    This  program  is being distributed  as  SHAREWARE.  This
  117.   means that voluntary contributions are the only  source of
  118.   remuneration  obtained  for this  work. A contribution  of
  119.   $20.00 gives you the following:
  120.  
  121.         1.  Automatic upgrades to the program.
  122.         2.  Fixes for any bugs.
  123.         3.  Schematics and instructions for the interfaces.
  124.         4.  A clear conscience.
  125.  
  126.  
  127.   Please mail all contributions and problem reports to
  128.  
  129.      Lydia Rosa
  130.      P.O. Box 414
  131.      Marlboro, N.Y.
  132.      12542
  133.  
  134.     Thank you for your support.
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159. DISCLAIMERS                                              2
  160.  
  161.                 RADIO REMOTE CONTROL PROGRAM
  162.   INTRODUCTION
  163.  
  164.  
  165.  
  166.      The  RADIO  REMOTE CONTROL PROGRAM will  allow  you  to
  167.   control your ICOM-R7000, or KENWOOD R-5000 radio  from any
  168.   IBM compatible  PC,XT or AT.  With the  standard interface
  169.   adapters provided by the manufactures of these radios, you
  170.   can  store and  recall  banks of  100  channels.  Using  a
  171.   special interface curcuit, you can scan,  search,  and log
  172.   active channels. This curcuit  is provided  free of charge
  173.   to all registered users.
  174.  
  175.     The program allows you to  select various baud rates, as
  176.   well  as COM port 1 or 2.  Commands  are buffered,  and an
  177.   interface to a DBASE data file is provided.
  178.  
  179.     Although  it has not been tested, this program may  work
  180.   with other radio  models produced  by  the manufactures of
  181.   the supported radios.
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222. INTRODUCTION                                             3
  223.  
  224.                 RADIO REMOTE CONTROL PROGRAM
  225.   REQUIREMENTS
  226.  
  227.  
  228.  
  229.     In order to run this  program you will need an IBM PC,XT
  230.   or AT  running  DOS 3.0  or higher.  The program  requires
  231.   about 128k of available RAM to run.
  232.  
  233.     If  you are controlling  the R7000, you will need either
  234.   the ICOM CI-V  interface adapter,  or  the modified  RS232
  235.   interface.  If  you  wish  to  use  the  signal  detection
  236.   feature of this program, you will need to use the modified
  237.   interface.
  238.  
  239.     For the R-5000, you  will need  the  IC-10 option kit. A
  240.   modification must be made to the R-5000 if you wish to use
  241.   the signal detection feature of this program.
  242.  
  243.     It is highly recommended that the  modified interface be
  244.   used for all radios.  Most of the features of this program
  245.   make  use   of   the  detection  of  an  available  signal
  246.   (SQUELCH).  These radios do  NOT  currently  have  squelch
  247.   detection as part of the standard interface. Although this
  248.   program will  work  fine without  this  signal  detection,
  249.   operations such as SCAN and SEARCH will have no usability.
  250.  
  251.     The interface curcuit is  a  inexpensive, easy  to build
  252.   project.  All  the  parts  are readily  available  at  any
  253.   electronic  store.  Estimated  cost  for each interface is
  254.   $15. Plans  and  instructions  for  these  interfaces  are
  255.   provided to you when you become a registered user.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285. REQUIREMENTS                                             4
  286.  
  287.                 RADIO REMOTE CONTROL PROGRAM
  288.   STARTUP
  289.  
  290.  
  291.  
  292.     To   start  the  program,  make  sure  the  program  and
  293.   datafiles are in the default drive. If running the R-7000,
  294.   enter ICOM at the DOS prompt. If running the R-5000, enter
  295.   KENWOOD.
  296.  
  297.   The  program  will load,  and  then  execute any  existing
  298.   profile. Once the program loads, the first page panel will
  299.   be displayed.
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348. STARTUP                                                  5
  349.  
  350.                 RADIO REMOTE CONTROL PROGRAM
  351.   THE DISPLAY
  352.  
  353.  
  354.  
  355.     The display panel shows you the status of your radio, as
  356.   well as the  status of the program.  At  the top left hand
  357.   corner  of  the screen  is displayed the current BAUD rate
  358.   and COM port  being used to  talk  to  the radio.  At  the
  359.   Bottom of the screen is a status  line showing the various
  360.   parameter settings. If there is a signal  present  on  the
  361.   radio, the word "SIG" will be displayed in  the lower left
  362.   hand  corner.   This  display  is   only   valid   if  the
  363.   modification has been made to detect squelch.
  364.  
  365.     In the  center  of  the  screen, the  status  of  memory
  366.   channels is displayed. These  channels reflect the current
  367.   setting in the COMPUTER's memory. They  can be used to set
  368.   the  radio's memory if so  desired.  There are  100 memory
  369.   slots available  in  this program.  Since only  20 of them
  370.   can be displayed at a  time,  the PgUp  and  PgDn keys are
  371.   used to  display  the  rest.  Information  can be directly
  372.   entered into most of the fields displayed.
  373.  
  374.     Toward  the  bottom  of the screen is the  COMMAND line.
  375.   This is where commands  to  the  program  are entered. All
  376.   command data is automatically converted to  upper case. To
  377.   the  right of the command line is the LAST  LOGGED status.
  378.   This   indicates   the   last   information    (frequency,
  379.   modulation) sent by the radio.
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411. THE DISPLAY                                              6
  412.  
  413.                 RADIO REMOTE CONTROL PROGRAM
  414.   DATA FIELDS
  415.  
  416.  
  417.  
  418.      Each  memory   channel  displayed  has  several  fields
  419.   associated  with it. Most of these fields can be  modified
  420.   just moving the cursor to the field and typing.
  421.  
  422.  
  423.  
  424.  
  425.   VALID
  426.  
  427.  
  428.  
  429.      The  VALID field  determines  whether  or not  SCAN and
  430.   SEARCH will use the frequency currently entered into  that
  431.   channel.  The field is set ON by entering an "X" while the
  432.   cursor is positioned on that  field. The  space  bar turns
  433.   the  VALID flag OFF. The SCAN operation will NOT scan that
  434.   memory   channel   on  the  ICOM   if   the   VALID  field
  435.   corresponding  to  that memory channel  is  OFF.  For  the
  436.   SEARCH operation, any frequency entered in a memory record
  437.   that  has the  VALID flag off will NOT cause the search to
  438.   stop and log.
  439.  
  440.      Entering  a "P" in  the  valid  field  will  cause  the
  441.   channel to become the current priory channel.
  442.  
  443.  
  444.  
  445.  
  446.   DELAY
  447.  
  448.  
  449.  
  450.     The  DELAY  field  is use during the SCAN operation.  If
  451.   delay is set ON, scanning  will continue one second  after
  452.   the  signal ends  on that channel.  If  delay  is set OFF,
  453.   then  scanning will continue immediately  after the signal
  454.   ends.  The  field  is set ON by  entering an "X" while the
  455.   cursor is positioned on  that  field. Any other  key turns
  456.   the  DELAY  flag OFF.  Delay affects  only  the  specified
  457.   memory channel.
  458.  
  459.  
  460.  
  461.  
  462.   FREQUENCY
  463.  
  464.  
  465.  
  466.     The FREQUENCY field is used to record or set the current
  467.   memory channel frequency. When a SCAN or SEARCH stops on a
  468.   channel  or frequency, the frequency  currently set in the
  469.   ICOM is  logged in the appropriate  display channel. If  a
  470.   frequency is entered into  a specific  channel, the memory
  471.   channel on the  ICOM corresponding  to the  channel on the
  472.  
  473.  
  474. DATA FIELDS                                              7
  475.  
  476.                 RADIO REMOTE CONTROL PROGRAM
  477.   display is set to that frequency. The frequency is entered
  478.   by positioning the  cursor  to the FREQUENCY field of  the
  479.   desired channel,  and  entering  in the desired frequency.
  480.   Only number input is accepted. The decimal point is always
  481.   assumed, and never  entered.  The  LOAD  command will also
  482.   set  the frequency  to  correspond with the  radio  memory
  483.   channel.
  484.  
  485.  
  486.  
  487.  
  488.   MODE
  489.  
  490.  
  491.  
  492.     The MODE field  is used  to  display  or set a specified
  493.   memory channels modulation.  If a memory channel is logged
  494.   by the SCAN  operation,  the selected modulation  of  that
  495.   channel  will  be  displayed  in  this  field. A channel's
  496.   modulation  can  be set by moving  the  cursor to the MODE
  497.   field  and  entering   in  the  desired  modulation.  MODE
  498.   recognized by the program are as follows:
  499.  
  500.      radio                valid modulation
  501.     ICOM                  AM, FM, FMN, SSB, CW ,LSB ,USB
  502.     KENWOOD               AM, FM, FSK, CW, LSB, USB
  503.  
  504.   Note that the ICOM  will  accept  CW, LSB  and  USB. These
  505.   modes have no meaning  for the R-7000, but are accepted by
  506.   the  ICOM interface.  They  are provided for compatibility
  507.   with other ICOM radios.
  508.  
  509.  
  510.  
  511.  
  512.   COUNT
  513.  
  514.  
  515.      This field  displays  the number of times a signal  was
  516.   detected  on  a  specific  channel. This field  cannot  be
  517.   altered. It can, however  be reset. The RESET command will
  518.   cause this value  to  be  reset to 0.  Ctl-END  will  also
  519.   reset  the  COUNT,  as  well as  all  other  fields on the
  520.   selected information line.
  521.  
  522.  
  523.  
  524.  
  525.   DURATION
  526.  
  527.  
  528.      This field displays the average number  of seconds that
  529.   a signal  was  detected  on a specific channel. This field
  530.   cannot be altered.  It  can, however be reset.  The  RESET
  531.   command  will cause this value to be reset to  0.  Ctl-END
  532.   will also reset the DURATION, as  well as all other fields
  533.   on the selected information line.
  534.  
  535.  
  536.  
  537. DATA FIELDS                                              8
  538.  
  539.                 RADIO REMOTE CONTROL PROGRAM
  540.   SERVICE
  541.  
  542.  
  543.  
  544.      This field is used to record the service for a specific
  545.   channel.  It is not modified by any of the commands except
  546.   DBASE.  This  is   a   scratch  pad  location  to   record
  547.   information about a specific frequency.  The DBASE command
  548.   will fill  in this field from the frequency database if it
  549.   finds a match of the current FREQUENCY.
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600. DATA FIELDS                                              9
  601.  
  602.                 RADIO REMOTE CONTROL PROGRAM
  603.   COMMANDS
  604.  
  605.  
  606.  
  607.      All  commands  are entered  from  the COMMAND  line.  A
  608.   command  stack  is  provided,  so  that  a command can  be
  609.   entered  before  the  previous  command  is  complete. The
  610.   number  of  commands   stacked  is  limited  only  by  the
  611.   available memory in your computer.
  612.  
  613.     When  a command is stacked,  the  status  line  (on  the
  614.   bottom  of  the screen) is updated  to show the number  of
  615.   commands  queued.  The "Q" indicator shows  the  number of
  616.   stacked commands. Pressing ESC will terminate the  command
  617.   in process, and cause the next command  in the queue to be
  618.   processed.
  619.  
  620.      If a command is not valid when entered, the system will
  621.   "BEEP" and the invalid command will be left in the COMMAND
  622.   line, so  that it can be changed. This will also happen if
  623.   there are too many commands in the command stack.
  624.  
  625.  
  626.  
  627.  
  628.   BAUD  {value}
  629.  
  630.  
  631.      The communication  baud rate between the RS232 port and
  632.   the  radio is set with  this  command. The default is 1200
  633.   baud.  Any  valid baud rate  can be set. However, for  the
  634.   program to work, the radio and the computer MUST be set to
  635.   the same baud rate.  The ICOM supports  9600, 1200 and 300
  636.   bauds ONLY.  The ICOM  baud rate  is selected by  a jumper
  637.   inside the unit. It is set at the factory to 1200 baud. It
  638.   is recommended  that  9600  be  used,  for  efficiency  in
  639.   communications between the computer and radio. This is the
  640.   default baud rate for  the  ICOM  program. The KENWOOD  is
  641.   hard-wired for a 4800  baud rate. This is the default baud
  642.   rate for the KENWOOD program.
  643.  
  644.  
  645.  
  646.  
  647.   CHANNEL {channel-number}
  648.  
  649.  
  650.      The  CHANNEL  command  sets  the  radio  to  a specific
  651.   channel.  Example: CHANNEL  3  will set the selected radio
  652.   to memory channel 3.
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663. COMMANDS                                                10
  664.  
  665.                 RADIO REMOTE CONTROL PROGRAM
  666.   CLEAR
  667.  
  668.  
  669.      The CLEAR  command will clear all memory  channels from
  670.   the computer's memory. All  FREQUENCY and  SERVICE  fields
  671.   are reset to blanks. The DELAY fields are set off, and the
  672.   COUNT  and  DURATION fields are reset to  0.  The first 20
  673.   frequencies are marked as VALID, and the rest of the VALID
  674.   fields are set off.
  675.  
  676.      This command only affects the COMPUTER memories. It has
  677.   no affect on the radio channels.
  678.  
  679.  
  680.  
  681.  
  682.   COM1
  683.  
  684.  
  685.     This command  sets the communications port for the radio
  686.   to COM1.  This is the default  setting. After this command
  687.   executes, all communication between the  computer  and the
  688.   radio will be through the COM1 port.
  689.  
  690.  
  691.  
  692.  
  693.   COM2
  694.  
  695.  
  696.     This command sets the  communications port for the radio
  697.   to COM2.  After  this command  executes, all communication
  698.   between  the  computer and the  radio  will be through the
  699.   COM2 port.
  700.  
  701.  
  702.  
  703.  
  704.   DBASE
  705.  
  706.  
  707.     A sample  DBASE compatible  file  is  provided  to  hold
  708.   details  about  various  frequencies.  This  file  can  be
  709.   updated using DBASE-III or any clone capable of updating a
  710.   DBASE  type file.  The  file is called  FREQLIST.DBF.  The
  711.   sample  file contains information on  nationally allocated
  712.   frequencies.
  713.  
  714.     When  the  DBASE  command is issued,  this  database  is
  715.   searched  for  matching frequencies. If  a match is  found
  716.   between the FREQUENCY field, and the database, the SERVICE
  717.   field is copied from the database. This is an  easy way to
  718.   update  the SERVICE field.  Please  note  that  the  DBASE
  719.   command can take a long time  to  complete,  based  on the
  720.   size of the database file and the available memory.
  721.  
  722.     When  processing  the  DBASE command,  the program  will
  723.   attempt to  buffer  as much information  in free memory as
  724.  
  725.  
  726. COMMANDS                                                11
  727.  
  728.                 RADIO REMOTE CONTROL PROGRAM
  729.   possible. Since  processing from disk  takes  a lot longer
  730.   than processing from memory,  this will speed up the DBASE
  731.   search. The memory for this buffering comes from the  free
  732.   memory left  over after the program  is  loaded. The  more
  733.   free memory available,  the  faster the DBASE  search will
  734.   finish.
  735.  
  736.     It is  very important that the structure of the provided
  737.   DBASE file be maintained. This program will not be able to
  738.   process this file if certain field structures are altered.
  739.   See  the section  on  data file formats for the details on
  740.   this file.
  741.  
  742.  
  743.  
  744.  
  745.   DIR  {filespec}
  746.  
  747.  
  748.     When issued, this command displays files on  the current
  749.   drive/directory.  If  issued  by  itself,  ALL  files  are
  750.   listed.  If  a filespec  is  included,  only  those  files
  751.   matching  the spec  are  listed. This  command CANNOT list
  752.   files on a drive/directory other than the current one.
  753.  
  754.  
  755.  
  756.  
  757.   FILENAME  {filespec}
  758.  
  759.  
  760.     The FILENAME command  will set the current file used for
  761.   SAVE  and  RECALL commands.  Please  note  that  only  the
  762.   filename  and extension should be  entered.  Paths  should
  763.   NOT be included. This  program  can only save or load from
  764.   the current directory.
  765.  
  766.  
  767.  
  768.  
  769.   FKn {command}
  770.  
  771.  
  772.     The FK command allows setting of function keys 1-10. "n"
  773.   is the  function key you wish  to  set. Any valid  program
  774.   command can  be set  to the  selected  function  key.  The
  775.   program  comes with a few  of the  keys  already  defined.
  776.   These can be overridden using the FK command.
  777.  
  778.    Example: FK2 QUIT
  779.    After execution  of this command, pressing Function key 2
  780.   will cause the program to terminate.
  781.  
  782.    DEFAULT settings:
  783.      F1 - HELP, F3 - QUIT, F5 - SCAN, F7 - HALT
  784.  
  785.  
  786.  
  787.  
  788.  
  789. COMMANDS                                                12
  790.  
  791.                 RADIO REMOTE CONTROL PROGRAM
  792.   HALT
  793.  
  794.  
  795.     If the program is SCANning, SEARCHing,  or LOADing, this
  796.   command will terminate  that function. It is equivalent to
  797.   pressing the ESC key.
  798.  
  799.  
  800.  
  801.  
  802.   HELP
  803.  
  804.  
  805.     The  HELP  command  will  display a  list of  ALL  valid
  806.   commands, and  a short  description  of  each. The current
  807.   setting of function keys is also displayed.
  808.  
  809.  
  810.  
  811.  
  812.   INC {value}
  813.  
  814.  
  815.     The  INC  command  sets  the  increment  value  used for
  816.   SEARCH.  The  value  entered will be added to  the current
  817.   frequency  for  each  step  of  the  SEARCH  routine.  The
  818.   increment value is assumed to be in kilohertz, and must be
  819.   in the rang of .1 to 999.9.
  820.  
  821.  
  822.  
  823.  
  824.   LOAD
  825.  
  826.  
  827.      This command  loads  the  computer memory channels with
  828.   the  contents  of the  radio's memory  channels.  All  the
  829.   COUNT,  and  DURATION  values are  set to  0.  The SERVICE
  830.   fields are clears, and all DELAY flags are turned off. The
  831.   first  20 channels are  marked as  valid. This  command is
  832.   useful initializing the program's memory channels.
  833.  
  834.  
  835.  
  836.  
  837.   LPT1
  838.  
  839.  
  840.     LPT1 sets the default printer port to LPT1.  The printer
  841.   port is  used  by the PRINT command.  This is the  default
  842.   printer port for this program.
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852. COMMANDS                                                13
  853.  
  854.                 RADIO REMOTE CONTROL PROGRAM
  855.   LPT2
  856.  
  857.  
  858.     LPT2 sets the default printer  port to LPT2. The printer
  859.   port is used by the PRINT command.
  860.  
  861.  
  862.  
  863.  
  864.   NOSIGNAL
  865.  
  866.  
  867.     This command turns off the signal sensing for the radio.
  868.   The signal sense is the  CARRIER DETECT line of the  RS232
  869.   port.  If the modified  interface is  not  installed, this
  870.   signal does not reflect  the state of the radio's squelch.
  871.   Issuing the  NOSIGNAL command  tells the program to ignore
  872.   the state of this line. When signal  detection is off, the
  873.   signal status field displays the word OFF constantly.
  874.  
  875.  
  876.  
  877.  
  878.   PRINT
  879.  
  880.  
  881.     When  issued,  this  command  prints the contents of the
  882.   computer's memory channels to the default printer.
  883.  
  884.  
  885.  
  886.  
  887.   PRIORITY  {channel-number}
  888.  
  889.  
  890.     Any of the  100  channels can be selected  as a priority
  891.   channel.  During  SCAN, the  selected  priority channel is
  892.   polled once  a  second.  If  there  is  a  signal  on  the
  893.   priority  channel,  scanning will  stop  on  the  priority
  894.   channel until the signal is  no  longer present.  Scanning
  895.   will  then resume  with the last  channel that was scanned
  896.   before the priority channel activated.
  897.  
  898.     To turn off the priority  scan,  enter  PRIORITY with no
  899.   channel number.
  900.  
  901.  
  902.  
  903.  
  904.   QUIT
  905.  
  906.  
  907.     This command terminates the program and  returns to  DOS
  908.   (or the calling environment).
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915. COMMANDS                                                14
  916.  
  917.                 RADIO REMOTE CONTROL PROGRAM
  918.   RECALL {filename} {SET}
  919.  
  920.  
  921.     RECALL  loads  the  computer  memories  with  the values
  922.   specified  in  the  current file.  If  a  channel  is  not
  923.   included in the file, then it will not be set. The radio's
  924.   memories  are  not  affected  unless  the  SET  option  is
  925.   included in command. If  a  filename is included  with the
  926.   command, the file specified will  be read, and the current
  927.   filename will be set to the file entered. If a filename is
  928.   NOT included  in  the  command, then  the current filename
  929.   will be used.
  930.  
  931.   NOTE:If the filename you wish to recall is called SET, and
  932.   you do  NOT wish to set the  memories,  you  will  need to
  933.   first issue the FILENAME command, then  the RECALL with no
  934.   options. This is because  the program will  not be able to
  935.   tell that  the SET keyword is a filename and NOT a command
  936.   option.
  937.  
  938.  
  939.  
  940.  
  941.   RESET
  942.  
  943.  
  944.     When this  command  is  issued, all  COUNT  and DURATION
  945.   values are reset to 0.
  946.  
  947.  
  948.  
  949.  
  950.   RESUME {value}
  951.  
  952.  
  953.     The value entered here controls how long SCAN  or SEARCH
  954.   will  remain  on  a channel after a signal  is detected. A
  955.   value  of  0 causes  scanning to continue ONLY  after  the
  956.   signal  is  no longer  present. Any other value will cause
  957.   scanning to  resume  after  the number  of seconds entered
  958.   have elapsed.
  959.  
  960.       For example if the command RESUME 3 was entered, and a
  961.   SCAN operation detected  a squelch on  channel 1, scanning
  962.   would stop on channel 1 for 3 seconds, then continue on to
  963.   the next channel.
  964.  
  965.  
  966.  
  967.  
  968.  
  969.   SAVE  {filename}
  970.  
  971.  
  972.     This command  will save  the  contents  of the  computer
  973.   memory to the current filename specified.  If the filename
  974.   is  not specified, the current filename will be used. If a
  975.   file  already exists,  it  is  updated  with  the  current
  976.  
  977.  
  978. COMMANDS                                                15
  979.  
  980.                 RADIO REMOTE CONTROL PROGRAM
  981.   settings.
  982.  
  983.  
  984.  
  985.  
  986.   SCAN
  987.  
  988.  
  989.     The  SCAN  command  starts the  radio  scanning  through
  990.   selected memory channels. Memory channels that are flagged
  991.   with the VALID field  will  be  scanned. Channels with the
  992.   VALID  flag  off  will  be  bypassed.  When  a  signal  is
  993.   detected, scanning will stop, and the memory channel being
  994.   scanned  will  be displayed  in inverse.  When the  signal
  995.   stops, scanning will continue.
  996.  
  997.     Several  parameters and  memory  channel settings affect
  998.   the operation  of  SCAN.  Each  channel  has a  VALID flag
  999.   associated  with  it.  If  this  flag  is  set   off,  the
  1000.   corresponding memory channel  in  the  radio will  NOT  be
  1001.   scanned. If the DELAY  field  of the corresponding  memory
  1002.   channel is set, the program will delay 1  second after the
  1003.   signal stops before resuming scan.
  1004.  
  1005.     The SPEED setting  determines how fast each channel will
  1006.   be  scanned. In  the event  that a  scan  is  too fast  to
  1007.   respond to certain frequencies, it can be  slowed with the
  1008.   SPEED settings.
  1009.  
  1010.     The  RESUME  setting determines  the  action  after  the
  1011.   squelch breaks. If RESUME is set  to  0, scanning will not
  1012.   continue until  the  signal  ends. If  RESUME is any other
  1013.   value, scanning will resume  after  the number  of seconds
  1014.   specified by RESUME.
  1015.  
  1016.     If a channel is set to be a PRIORITY channel, it will be
  1017.   scanned  once every second. If a signal is detected on the
  1018.   priority  channel normal scanning stops, and the radio  is
  1019.   set to receive the  priority channel. Normal scanning will
  1020.   resume  when  the  signal  is  no  longer present  on  the
  1021.   PRIORITY channel.
  1022.  
  1023.     Note  that  any  of  the parameters  or  memory  channel
  1024.   settings can  be set either before the scan is started, or
  1025.   during  the  scan.  The  new parameters  will take  effect
  1026.   immediately in either case.
  1027.  
  1028.  
  1029.  
  1030.  
  1031.   SEARCH
  1032.  
  1033.  
  1034.      SEARCH allows you  to  scan a range  of frequencies for
  1035.   action.  The  range  is  selected  by  the  START and STOP
  1036.   values. The INC  value determines  the step size for  each
  1037.   frequency increment. The SPEED  value determines how  fast
  1038.   the next increment will be selected.
  1039.  
  1040.  
  1041. COMMANDS                                                16
  1042.  
  1043.                 RADIO REMOTE CONTROL PROGRAM
  1044.  
  1045.     During a SEARCH operation, a frequency is  set into  the
  1046.   radio, and a check is  made for a signal. If no  signal is
  1047.   found, the frequency is  incriminated by the INC value and
  1048.   the operation  repeated.  When  the  frequency reaches the
  1049.   STOP value, the search starts again at the START value.
  1050.  
  1051.     If a signal is  found during SEARCH, the memory channels
  1052.   are  searched  for  the  active  frequency. If the  active
  1053.   frequency is found in one of the computer memory channels,
  1054.   and the channel is marked as VALID, the COUNT and DURATION
  1055.   fields  will  be  updated.  If the memory channel  is  NOT
  1056.   marked  as  VALID,  searching  continues  with  the   next
  1057.   frequency.
  1058.  
  1059.     If  a  signal  is  found during SEARCH,  and  the active
  1060.   frequency  is  NOT  found  in one  of the  computer memory
  1061.   channel, the active frequency is logged in the first clear
  1062.   memory channel.  If there are no free memory channels, the
  1063.   FULL status  indicator will be displayed,  and the  log of
  1064.   the  current  active channel will be  lost. You can free a
  1065.   memory channel during SEARCH by moving the cursor  to  the
  1066.   row of  the  selected channel and  pressing CTL-END. Since
  1067.   there  are only 100  channels available, this mean that  a
  1068.   search   can  only  locate   a   maximum   of  100  active
  1069.   frequencies.
  1070.  
  1071.     The RESUME  value controls SEARCH  in the same manner as
  1072.   SCAN. If RESUME  is  set to 0, searching will resume AFTER
  1073.   the signal  is no longer present.  If RESUME is set  to  a
  1074.   number  greater than 0,  searching will resume that number
  1075.   of seconds after signal has been detected.
  1076.  
  1077.  
  1078.  
  1079.   SET
  1080.  
  1081.  
  1082.     SET causes the values in the computer memory channels to
  1083.   be set into the radio's memory  channels. All 100 channels
  1084.   are set.  Note that it may take a minute or so for all the
  1085.   memories to be set.
  1086.  
  1087.  
  1088.  
  1089.  
  1090.   SIGNAL
  1091.  
  1092.  
  1093.     SIGNAL turns the sense for the signal detection on. This
  1094.   is  the  default  condition for the  program.  It  is  the
  1095.   opposite command of NOSIGNAL.
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104. COMMANDS                                                17
  1105.  
  1106.                 RADIO REMOTE CONTROL PROGRAM
  1107.   SORT
  1108.  
  1109.  
  1110.     SORT  will sort  the memories by frequency in  ascending
  1111.   order. It is most  useful  to  do a sort during or after a
  1112.   SEARCH operation.
  1113.  
  1114.  
  1115.  
  1116.  
  1117.   SPEED {value}
  1118.  
  1119.  
  1120.     This  command sets the scanning and searching speed. The
  1121.   value  should be a  number  between  0 and  32768. A Speed
  1122.   value  of  0  will  result  in  the fastest scan possible.
  1123.   Higher numbers cause a slower scan. The number is used  as
  1124.   a countdown in the scan loop. The larger the  number,  the
  1125.   slower the scan/search rate.
  1126.  
  1127.  
  1128.  
  1129.  
  1130.   START {value}
  1131.  
  1132.  
  1133.     The  value set  in  this command controls  the  starting
  1134.   frequency for the SEARCH  operation.  The  value  must  be
  1135.   frequency in the range of the radio.
  1136.  
  1137.  
  1138.  
  1139.  
  1140.   STOP  {value)
  1141.  
  1142.  
  1143.     The value  set  in  this  command  controls  the  ending
  1144.   frequency  for  the SEARCH operation. The  value  must  be
  1145.   frequency in the range of the radio.
  1146.  
  1147.  
  1148.  
  1149.  
  1150.   TXADR {value)
  1151.  
  1152.  
  1153.     ICOM radios can be set to respond to various  addresses.
  1154.   This allows multiple  radios to  be connected on  the ICOM
  1155.   C-IV bus.  The default address of the R-7000 is 8. This is
  1156.   the default setting for this program. The TXADR allows the
  1157.   program to talk  to radios with  a  different address. The
  1158.   value entered must be an  integer between  1 and 255. This
  1159.   command has no affect when running the KENWOOD program.
  1160.  
  1161.   NOTE:If the program does  not  appear  to  be comunicating
  1162.   with your radio, make sure that the TXADR value is matched
  1163.   with the remote control address of your radio. This is set
  1164.   by a jumper inside ICOM radios.
  1165.  
  1166.  
  1167. COMMANDS                                                18
  1168.  
  1169.                 RADIO REMOTE CONTROL PROGRAM
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230. COMMANDS                                                19
  1231.  
  1232.                 RADIO REMOTE CONTROL PROGRAM
  1233.   SPECIAL KEYS
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.   ENTER
  1241.  
  1242.  
  1243.     The ENTER key finalizes input to the program. If pressed
  1244.   while on the COMMAND line, the entered command is executed
  1245.   (if valid). If pressed while  on the  FREQUENCY field, the
  1246.   entered frequency  is set into the radio's memory, and the
  1247.   cursor is moved to the MODE field. If pressed while on the
  1248.   MODE  field,  the  entered   modulation  is   checked  for
  1249.   validity.  If the modulation is  valid, it is set into the
  1250.   radio's memory, and the cursor moves to the SERVICE field.
  1251.  
  1252.    If the  cursor is on any other  field, ENTER will move it
  1253.   to the next field in the current row.
  1254.  
  1255.  
  1256.  
  1257.  
  1258.   ESC
  1259.  
  1260.  
  1261.     Pressing  ESC  terminates the current  operation.  It is
  1262.   equivalent to the HALT command.
  1263.  
  1264.  
  1265.  
  1266.  
  1267.   Backspace
  1268.  
  1269.  
  1270.     The destructive backspace key only works  on the command
  1271.   line. When  entered, the current character is deleted, and
  1272.   the cursor moves to the previous character.
  1273.  
  1274.  
  1275.  
  1276.  
  1277.   HOME
  1278.  
  1279.  
  1280.     The  HOME  key will move  the cursor to the beginning of
  1281.   the current field.
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293. SPECIAL KEYS                                            20
  1294.  
  1295.                 RADIO REMOTE CONTROL PROGRAM
  1296.   END
  1297.  
  1298.  
  1299.     If pressed  while  on the SERVICE field,  the  cursor is
  1300.   moved  to the last  entered  character  in that field.  If
  1301.   pressed while on the command line, the cursor is moved  to
  1302.   the last entered character in the command.
  1303.  
  1304.  
  1305.  
  1306.  
  1307.   ctl-END
  1308.  
  1309.  
  1310.     This   key  clears  all  information  from  the  current
  1311.   channel.  The  current channel  is the line  on which  the
  1312.   cursor is currently on.  When pressed, the VALID and DELAY
  1313.   flags  are cleared, the FREQUENCY field  is set to blanks,
  1314.   the MODE  field  is set to '???',  the COUNT and  DURATION
  1315.   fields are zeroed, and the SERVICE field is set to blanks.
  1316.   This key  only  affects the computer memory. The  radio is
  1317.   left un-affected.
  1318.  
  1319.  
  1320.  
  1321.  
  1322.   ctl-HOME
  1323.  
  1324.  
  1325.     This key will move the  cursor between the command  line
  1326.   and the memory  channel fields. It allows  for  a  hot-key
  1327.   switch between field editing and command editing.
  1328.  
  1329.  
  1330.  
  1331.  
  1332.   Cursor keys
  1333.  
  1334.  
  1335.     Cursor keys allow movement around the screen to edit the
  1336.   various fields, and contents of fields. The left and right
  1337.   keys  move within  a  field. The up  and down arrows  move
  1338.   between rows. The program will only allow the cursor to be
  1339.   placed on a changeable  field.
  1340.  
  1341.  
  1342.  
  1343.  
  1344.   PgDn/PgUp
  1345.  
  1346.  
  1347.     These keys move  between the pages of the display. There
  1348.   are 5  pages of channel  displays.  Each  page displays 20
  1349.   channels. PgDn  selects the next  page, PgUp  displays the
  1350.   previous page.
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356. SPECIAL KEYS                                            21
  1357.  
  1358.                 RADIO REMOTE CONTROL PROGRAM
  1359.   INS
  1360.  
  1361.  
  1362.     INS selects or cancels  insert mode. Insert mode  allows
  1363.   inserting of characters in a field.
  1364.  
  1365.  
  1366.  
  1367.  
  1368.   DEL
  1369.  
  1370.  
  1371.     The  DEL  key  deletes  the  characters  at  the  cursor
  1372.   location.
  1373.  
  1374.  
  1375.  
  1376.  
  1377.   Function keys
  1378.  
  1379.  
  1380.      Function  keys F1-F10 can be set by the  user using the
  1381.   FK command.  When  one  of  these  keys  is  pressed,  the
  1382.   current command assigned to this key is executed. Function
  1383.   keys that have not been set do not cause  any action to be
  1384.   taken.
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419. SPECIAL KEYS                                            22
  1420.  
  1421.                 RADIO REMOTE CONTROL PROGRAM
  1422.   PROFILE
  1423.  
  1424.  
  1425.  
  1426.     The  profile   is   a   file  named  pgrname.PRO,  where
  1427.   "progname"  is  the  name  of  the  program  you  started.
  1428.   EXAMPLE:  KENWOOD.PRO   is   the  profile  that  would  be
  1429.   executed when the KENWOOD  program  was run.  The  profile
  1430.   contains a collection of valid commands.  The  primary use
  1431.   of the  profile is to set up the program for your specific
  1432.   setup. Any  valid command can be included in  the profile.
  1433.   A sample profile for each of program  has been included on
  1434.   the distribution disk.  If you  do not wish any profile to
  1435.   be run, it may be deleted.
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482. PROFILE                                                 23
  1483.  
  1484.                 RADIO REMOTE CONTROL PROGRAM
  1485.   DATA FILE FORMATS
  1486.  
  1487.  
  1488.  
  1489.  
  1490.     There  are several files that this program makes use of.
  1491.   These  files are  used  to store and retrieve data used by
  1492.   the program.
  1493.  
  1494.  
  1495.  
  1496.  
  1497.   FREQLIST.DBF
  1498.  
  1499.  
  1500.  
  1501.     This  is  a  standard  DBASE  III+  type data  file.  It
  1502.   contains   frequencies  and  allocations   for  the  radio
  1503.   spectrum. There  are three fields that are  used  by  this
  1504.   program.
  1505.  
  1506.     field name     allocation       description
  1507.     -----------------------------------------------------------
  1508.     FREQUENCY      decimal 9.4      holds the frequency in Mhz
  1509.     DESCRIPT       character 50     usage of the frequency
  1510.     ACTION         logical          flags the frequency in use
  1511.  
  1512.     If the ACTION field is not present, the program will use
  1513.   the DESCRIPT  field to  determine ACTION. A blank DESCRIPT
  1514.   field signals an inactive channel.
  1515.  
  1516.     The length of the  DESCRIPT field can be changed,  if so
  1517.   desired.  This  program  only uses the first  38  chars of
  1518.   this field.
  1519.  
  1520.     Any other fields  can be added or deleted from this file
  1521.   without affecting the operation of  the program.  However,
  1522.   if either the  FREQUENCY or DESCRIPT field  is not present
  1523.   in the database, the DBASE function will not operate.
  1524.  
  1525.  
  1526.  
  1527.  
  1528.   frequency data files
  1529.  
  1530.  
  1531.  
  1532.     The  SAVE  command  creates  a  file  with  the  current
  1533.   settings  of memory channels, and various scan parameters.
  1534.   The file created is an ASCII readable file. Each record is
  1535.   terminated by a CR/LF sequence.  One record represets  one
  1536.   memory channel or  one scan parameter. Each field is blank
  1537.   delimited.  The file can be altered (or created) using any
  1538.   standard text editor.
  1539.  
  1540.    If the first  non-blank character in a record  is  a '*',
  1541.   that  record  is  ignored. This  provides  a way  to imbed
  1542.   comments in any data file.
  1543.  
  1544.  
  1545. DATA FILE FORMATS                                       24
  1546.  
  1547.                 RADIO REMOTE CONTROL PROGRAM
  1548.  
  1549.    The format for a memory channel entry is as follows:
  1550.  
  1551.     field   name       value range      description
  1552.     ----------------------------------------------------------------
  1553.         1   CHANNEL     0-100           channel number to set
  1554.         2   FREQUENCY   0-999.9999      frequency in Mhz
  1555.         3   MODE        3 chars         valid modulation for radio
  1556.         4   COUNT       0-999999        count of squelch breaks
  1557.         5   DURATION    0-999999        total duration of squelch
  1558.         6   VALID       VALID/NOTVALID  indicator of channel valid
  1559.         7   DELAY       DELAY/NODELAY   indicator of channel delay
  1560.         8   SERVICE     38 chars        service for channel
  1561.  
  1562.    The  service  field follows  the first blank after DELAY.
  1563.   All  chars  up to the  CR/LF are taken.  If there are more
  1564.   then 38 chars in the service field, they are ignored.
  1565.  
  1566.    The format for a scan parameter entry is as follows:
  1567.  
  1568.              parm   value
  1569.  
  1570.    The valid parameters and there values are as follows:
  1571.     parmameter         value       description
  1572.     START              0-999.999   start frequency in Mhz
  1573.     STOP               0-999.999   stop frequency in Mhz
  1574.     INC                .1-99.9     increment in Khz
  1575.     SPEED              0-32768     scanning speed
  1576.     RESUME             0-32768     resume value
  1577.  
  1578.  
  1579.  
  1580.  
  1581.   profile
  1582.  
  1583.  
  1584.  
  1585.     The  profile is a  file with  valid  commands that  gets
  1586.   executed when the program starts. The profile name is
  1587.                  progname.PRO  where  "progname" is the name
  1588.   of the program running.
  1589.  
  1590.    Any  command that can be executed on the command line can
  1591.   be placed  in  the profile.  Each  record  in  the profile
  1592.   contains  one  command  (and  parameters)  followed  by  a
  1593.   CR/LF. If the  first non-blank character in  a record is a
  1594.   '*',  the  record is ignored.  This  allows  the  user  to
  1595.   comment the profile.
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608. DATA FILE FORMATS                                       25
  1609.  
  1610.                 RADIO REMOTE CONTROL PROGRAM
  1611.   RS232 INTERFACE
  1612.  
  1613.  
  1614.  
  1615.  
  1616.     This   program   is   designed   to   use   the   serial
  1617.   communications port  (RS232) of the IBM computer. In order
  1618.   to interface a radio to this port, an interface adapter is
  1619.   needed  designed   for  the  specific  radio.  Each  radio
  1620.   manufacturer makes such an adapter.  However, none  of the
  1621.   adapters   supplied  from  the  manufacturer  provide  for
  1622.   squelch  detection.  Without  this detection,  the  signal
  1623.   sensing functions of this program will not work.
  1624.  
  1625.     For each radio supported, a circuit and instructions are
  1626.   available.  This circuit  provides the  squelch  detection
  1627.   needed  by this program.  The interface circuits are  easy
  1628.   to build, and require few parts.  All of the  parts can be
  1629.   obtained  cheaply at  any electronics  supply  store.  The
  1630.   schematics and instructions are provided to all registered
  1631.   users.
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671. RS232 INTERFACE                                         26