home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / cat / kenwood / ken_09 / amsoft.iii next >
Text File  |  1997-02-01  |  15KB  |  283 lines
  1.                           Kenwood TS-440 Low Band Computer
  2.                              Interface Control Program.
  3.             
  4.             Required Equipment:
  5.             
  6.                  IBM PC or Compatible with 128K memory (MIN) and a DSDD
  7.                  floppy disk drive.
  8.                  
  9.                  CGA or EGA Color Monitor
  10.             
  11.             Chapter 1.  Description
  12.             
  13.                  Upon  release   of  the   Kenwood   TS-440   low   band
  14.                  transceiver,  Kenwood   also   announced   a   computer
  15.                  interface option.   This  interface allows  control  of
  16.                  most front  panel aspects of the rig.  The only problem
  17.                  was that  no software  to control the rig was ever sold
  18.                  to use the powerful protocol.  That is until now.
  19.             
  20.                  TS440ctl.exe allows  the user  complete remote  control
  21.                  ability from a Personal Computer screen.  The following
  22.                  are the commands and controls available to the user:
  23.                  
  24.                       VFO A Frequency
  25.                       VFO B Frequency
  26.                       Memory Channel Selection
  27.                       Tuning
  28.                       RIT switch, tune, and dial
  29.                       Band selection
  30.                       Scan
  31.                       Split
  32.                       Lock
  33.                       Mode
  34.                  
  35.                  In  addition  to  the  above,  status  of  the  440  is
  36.                  constantly  updated  on  the  PC  screen.    With  this
  37.                  program, the  user may  access almost every function of
  38.                  the 440 from the PC.
  39.             
  40.             Chapter 2,  Setting Up for TS440ctl
  41.                  
  42.                  As mentioned above, TS440ctl contains a real time clock
  43.                  that reflects GMT time.  In order for the GMT time to
  44.                  be correct, you must first make sure that your system
  45.                  clock is set correctly for YOUR time zone.  Also, a new
  46.                  command must me inserted into your autoexec.bat file.
  47.                  If you are not familiar with this file, consult your
  48.                  DOS reference manual for details.
  49.                  
  50.                  TS440ctl needs to know the time zone that it is running
  51.                  in so that it may determine the correct number of hours
  52.                  to correct for Greenwich Mean Time.  The program
  53.                  figures this out by looking for a value called 
  54.                  timezone.   You set timezone to one of the following
  55.                  values:
  56.                  
  57.                       EDT  - Eastern Standard Time
  58.                       CDT  - Central Standard Time
  59.                       MDT  - Mountain Standard Time
  60.                       PDT  - Pacific Standard Time
  61.                  
  62.                  Enter the following line into your autoexec.bat file,
  63.                  or just enter at the DOS prompt:
  64.                  
  65.                       set timezone=XXX
  66.                       
  67.                  where XXX is the timezone where you reside.  The
  68.                  advantage to entering this into your autoexec.bat is
  69.                  that is saves the step each time you want to run the
  70.                  program.  The program defaults to MDT time, for that is
  71.                  the time zone I live.
  72.                       
  73.                  The TS-440  communicates with  the PC via an RS-232 EIA
  74.                  connection.   This is  typically connected to your PC's
  75.                  COM1 port.   A  3 wire  RS-232 cable  connects  to  the
  76.                  kenwood   communications    interface.       For   more
  77.                  information, refer  to the installation manual included
  78.                  with the interface unit.
  79.             
  80.             Chapter 3,  Using TS440ctl.exe
  81.             
  82.             Start-Up
  83.                  
  84.                  TS440ctl is started by typing
  85.                  
  86.                       TS440CTL
  87.                  
  88.                  at the DOS command line.  If you have a hard disk, make
  89.                  sure that you are in the directory, or have a path to
  90.                  the directory in which the program resides.  If you
  91.                  wish to use the second COM port (COM2), type
  92.                  
  93.                       TS440CTL 2
  94.                  
  95.                  When the program begins execution, you should hear the
  96.                  radio beep several times.  This is normal.  If the
  97.                  radio does not beep, check to see that all cables are
  98.                  properly connected and you are using the proper serial
  99.                  COM port for your computer.
  100.                  
  101.                  The start up status of the program is VFO A.  What ever
  102.                  frequency was tuned at the time of last use is the
  103.                  current frequency, as well as the mode, scan status,
  104.                  rit status and so on.  This information should
  105.                  immediately be updated on the screen.
  106.  
  107.             The Screen
  108.                  
  109.                  The  screen   for  TS440CTL  is  divided  into  several
  110.                  sections.   Each section  contains related information.
  111.                  For example, the top of the screen contains the current
  112.                  status of  all the  functions available,  that is VFO A
  113.                  frequency, VFO  B frequency, and current memory channel
  114.                  and channel frequency.  Based on the selected function,
  115.                  the word  above the  function will  be  illuminated  to
  116.                  indicate the  current selection.   The  current mode is
  117.                  also positioned on the first sector of the screen.
  118.             
  119.                  The second  sector contains  a "meter"  indicating  the
  120.                  current band. Based upon the current band, a pointer is
  121.                  placed under  the  band  position  on  the  meter.  The
  122.                  current XIT  and LOCK  status are  on the right side of
  123.                  the screen.
  124.             
  125.                  The center  of the  screen contains the current display
  126.                  frequency, RIT  status,  and  current  RIT  offset.  In
  127.                  addition, another  function indicator  is  provided  so
  128.                  that, by  looking at  this sector  alone, the  user can
  129.                  obtain most  of the  significant information  regarding
  130.                  the status of the radio.
  131.             
  132.                  The next sector contains the current scan status, spilt
  133.                  status, and  a graphic  indication of  the current  RIT
  134.                  offset.  A real time clock is also included.
  135.             
  136.                  An  lastly,   the  bottom  of  the  screen  contains  a
  137.                  reference of  all  the  control  commands  used.    The
  138.                  following sections  describe these  control commands in
  139.                  detail.
  140.             
  141.             Chapter 4, Keyboard Commands
  142.             
  143.                  Several PC  keys are  used to control the various front
  144.                  panel aspects  of  the  TS-440.    These  commands  are
  145.                  described here:
  146.             
  147.                  Function Keys
  148.                       F1   -    Decrements the current frequency by the
  149.                                 current step rate.
  150.                       
  151.                       F2   -    Increments the frequency by the current
  152.                                 step rate.
  153.                       
  154.                       F3   -    Decrements the RIT offset.
  155.                       
  156.                       F4   -    Increments the RIT offset.
  157.                       
  158.                       F5   -    Toggles the status of the RIT (on/ off).
  159.                       
  160.                       F6   -    Toggles the XIT status.
  161.  
  162.                       F7   -    Select frequency for VFO A.
  163.                                 This command will prompt the user for a
  164.                                 frequency to be placed into VFO A.
  165.                            
  166.                       F8   -    Same as above for VFO B.
  167.                       
  168.                       F9   -    Select Memory Channel.  This command     
  169.                                 prompts the user for the memory channel
  170.                                 desired.
  171.                       
  172.                       F10  -    Exit, quit the program.
  173.                       
  174.                       A    -    Switch to VFO A
  175.                       
  176.                       B    -    Switch to VFO B
  177.                       
  178.                       C    -    Clear current RIT offset.  This command
  179.                                 allows you to have the radio ignore the
  180.                                 current position of the RIT controller,
  181.                                 and use exclusively the remote control.
  182.                                 Note that if the control is moved on the
  183.                                 rig, the current controller position is
  184.                                 restored, and the program is updated as
  185.                                 to its status.
  186.                       
  187.                       M    -    Select memory as current function
  188.                       
  189.                       O    -    Select Mode.  This key scrolls through   
  190.                                 all the possible modes of the TS440 (AM,
  191.                                 FM, CW, ect...).
  192.                       
  193.                       P    -    Toggle split status.
  194.                       
  195.                       S    -    Toggle Scan Status.
  196.                       
  197.                       T    -    Transmit/ Receive toggle.  (Careful!)
  198.                       
  199.                       Alt F7-   Memory to VFO copy.
  200.                                 This command prompts for which VFO to    
  201.                                 copy to, and the channel you wish        
  202.                                 copied.
  203.             
  204.             Other notes
  205.                  While using  ts440ctl, you  may notice  that the screen
  206.                  updates do  not always  track the  status of the radio.
  207.                  In reality, the problem lies with the radios ability to
  208.                  relay information  back  to  the  PC.    The  interface
  209.                  specification states  that  an  update  of  information
  210.                  takes  place   every   1.5   seconds.   This   can   be
  211.                  misunderstood to  mean that at any time, information is
  212.                  updated every  1.5 seconds.   This,  in fact is not the
  213.                  case.   When activity  takes place on the radio, either
  214.                  using the  front panel  controls or  the PC,  an update
  215.                  will not  take place  until the  radio  sits  idle  for
  216.                  approximately 1.5  seconds.   A good example of this is
  217.                  spinning the  dial while watching the PC screen running
  218.                  ts440ctl.   You should  notice an  update taking  place
  219.                  AFTER the  spin has  stopped.  To counter this example,
  220.                  placing the  radio in  scan  mode  updates  the  screen
  221.                  approximately every  1.5 seconds.    From  the  limited
  222.                  information in  the documentation of this interface, it
  223.                  is not  possible to determine the exact pattern or rule
  224.                  chosen for  this, but  the end  result is  a  sometimes
  225.                  sluggish interface to this program.
  226.             
  227.                  During development  of this  program, every  effort was
  228.                  made to  insure that  status of the screen reflects the
  229.                  actual status  of the  radio.   If, at  some time,  you
  230.                  notice that  the screen  does not  reflect that status,
  231.                  perform some  action on  the keyboard, for example tune
  232.                  up and  then down.  This change should prompt the radio
  233.                  to update the status of the PC.
  234.             
  235.                  If you  use one  of the many keyboard speed up programs
  236.                  available, be  warned that if you hold a key down, then
  237.                  every key  will count.   For  example, if  you tune  by
  238.                  holding the  F1 key  down, it  may go  further that you
  239.                  want.
  240.             
  241.                  This program was written in Borland International Turbo
  242.                  C environment.   It  has been  tested on an PC/AT clone
  243.                  and a Tandy 1000.  If your PC is a close compatible, it
  244.                  should run  fine.   If  you  encounter  problems,  have
  245.                  suggestions, or just have questions drop me a line at
  246.             
  247.                                       Kenneth Byers
  248.                                            or
  249.                                    David Byers (W9HXL)
  250.                                  4813 West Greenway Road
  251.                                   Glendale, AZ   85306
  252.             
  253.                  If you find this program useful, please help a starving
  254.                  computer science  student by  mailing a donation to the
  255.                  above address.   In  addition to  the charity value, it
  256.                  will insure  that you  are notified of upgrades to this
  257.                  program.   Some of  the upgrades I am currently working
  258.                  on are:
  259.                  
  260.                       Bulk Memory Transfers which will allow you to keep
  261.                       libraries of  memory channels  on disk, and upload
  262.                       and download them to and from the radio.
  263.                       
  264.                       VFO to  Memory channel  storage which  will  allow
  265.                       you, at  the touch of a key, to store the contents
  266.                       of the current VFO to any memory channel.
  267.                       
  268.                       Utilities that  allow you  to manipulate memories,
  269.                       as well  as selecting  a memory VIA station ID, or
  270.                       any other comment field.
  271.                       
  272.                       Band Tracking,  allowing you  to select only legal
  273.                       HAM bands,  short wave  bands, or  a user  defined
  274.                       band pattern.
  275.                       
  276.                  It took  quite a  while  to  accumulate  the  knowledge
  277.                  required to  write a  program  of  this  type,  so  the
  278.                  recognition would  make it  all seem  worth while.    I
  279.                  would  suggest   a  possible  donation  of  20.00,  but
  280.                  anything helps.
  281.             
  282.                                Thank you, and enjoy.
  283.