home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / HAMRADIO / RTCLOC.ZIP / RTCLOCK.DOC < prev    next >
Encoding:
Text File  |  1989-03-18  |  4.5 KB  |  113 lines
  1. RTCLOCK, version 1.31, by Michael Conley
  2.      Release date: March 17, 1989
  3.  
  4. UPDATE:
  5.     RTCLOCK version 1.31 adds the option to set the Real Time Clock
  6.     from the DOS Clock.  In addition, automatic detection of color
  7.     display has been added, as well as some minor refinements in the
  8.     WWV display routines.
  9.  
  10. PURPOSE:
  11.     RTCLOCK is intended for use on an AT class 80286 or 80386 machine.
  12.     It will read the real time clock and set the DOS clock from it, 
  13.     or read the DOS clock and set the real time clock from it, or it
  14.     will allow the user to set BOTH the real time clock and the DOS 
  15.     clock from the keyboard.    
  16.  
  17.     If you own the Heathkit "World's Most Accurate Clock" with a
  18.     serial interface, RTCLOCK will allow you to set BOTH your
  19.     real time clock and your DOS clock from WWV, the short-wave
  20.     time data service provided by the U.S. government.
  21.  
  22. OPERATION:
  23.     Five basic commands are supported, which may be entered either
  24.     on the command line or, if no command is specified, from a menu
  25.     within the program.
  26.  
  27.     <R> reads the real time clock, and sets the DOS clock.
  28.  
  29.     <D> reads the DOS clock, and sets the real time clock.
  30.  
  31.     <S> sets BOTH the real time clock and the DOS clock from
  32.         the keyboard.
  33.     
  34.     <W> sets BOTH the real time clock and the DOS clock from
  35.         serial data transmitted by the Heathkit "World's Most 
  36.         Accurate Clock."  Be sure to read SETUP for additional
  37.         configuration required for this option.
  38.  
  39.     <V> views the time data from the Heathkit "World's Most
  40.         Accurate Clock" until a key is pressed.  It does NOT
  41.         alter either of the system clocks.  Be sure to read
  42.         SETUP for additional configuration required for this 
  43.         option.    
  44.  
  45. SETUP:
  46.     Commands <R>, <D> and <S> require NO configuration.
  47.  
  48.     Commands <W> and <V> require the installation of an RS232
  49.     serial line from the Heathkit "World's Most Accurate Clock"
  50.     to the computer.  See the clock manual for wiring information.
  51.     Be sure to set the DIP switch inside the clock for the AUTO
  52.     mode, which provides CONTINUOUS output from the clock.  The
  53.     other mode would require manipulating the DTR line to request
  54.     clock data, and is NOT supported by the program.  Also be sure
  55.     to select an appropriate baud rate and program the correct year
  56.     using the DIP switches inside the clock.
  57.  
  58.     The program must be informed of the baud rate and the COM port
  59.     in either of two ways:
  60.  
  61.     1)  You may invoke the program and provide the configuration info
  62.         on the command line as follows:
  63.  
  64.         RTCLOCK W COM3 2400 [enter]
  65.  
  66.         Allowable choices here are  W or V  for the program mode,
  67.         COM1 thru COM4 for the data port, and 300, 600, 1200, 2400, 
  68.         4800, or 9600 for the baud rate.  Other choices or missing 
  69.         info will produce an error message.
  70.  
  71.     2)  You may create an ASCII text file (an example is included
  72.         in this distribution) with the port and baud rate on the
  73.         SAME line.  Name this file RTCLOCK.CNF and place it in the
  74.         same directory from which the program will be run.  An 
  75.         example of the file contents would be:
  76.  
  77.         COM3 2400
  78.  
  79.         Note: The parameters must be on the SAME line.
  80.  
  81.     Please also note that, if you enter the program with NOTHING on
  82.     the command line (i.e., menu mode) you MUST provide RTCLOCK.CNF
  83.     in order to use the W or V options, as these cannot be entered
  84.     from the menu.  A sample RTCLOCK.CNF is included with this
  85.     distribution.
  86.  
  87. SERIAL SETUP:
  88.     This release supports COM ports 1 thru 4 and functions entirely 
  89.     without interrupts.  This allows you to avoid the common problem 
  90.     of "interrupt sharing," where COM1 and COM3 share IRQ4, while 
  91.     COM2 and COM4 share IRQ3.
  92.  
  93.     We recommend that you set your serial I/O card for NO interrupts 
  94.     for the port selected for use with RTCLOCK to avoid possible con-
  95.     flicts with other serial devices.  However, the program will run
  96.     properly even in the event that interrupts are present on the port.
  97.  
  98. CONCLUSION:
  99.     Your comments and suggestions are welcome.  Please contact the
  100.     Charlatan's Cabin BBS (213) 654-7337 and leave a comment to the
  101.     Sysop (that's me.)  
  102.  
  103.     A brief warning:  TEST the clock hookup using a communications
  104.     program, such as Qmodem, to verify that it's hooked up and sending
  105.     data correctly.  RTCLOCK will simply TIME OUT if there is no output
  106.     from the clock in the W or V mode.  
  107.     If the clock IS connected, but it cannot produce the correct time, 
  108.     the program WILL gracefully exit with a message, so it can safely 
  109.     be used in a batch file, provided the serial line is present.
  110.  
  111.                           Michael Conley
  112.  
  113.