home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / HARDWARE / TIMSET52.ZIP / RTCLK.DOC < prev    next >
Encoding:
Text File  |  1989-09-17  |  7.0 KB  |  131 lines
  1.                    THE STRICKLAND REAL-TIME CLOCK PROGRAMS
  2.  
  3.              Copyright (C) 1988, Tom Strickland, Alexandria, VA
  4.  
  5.   The Strickland RT clock programs CLKDRV.SYS, RTCLOCK.COM, REALTIME.COM, and
  6. DOSTIME.COM are designed to provide a standard, universal method of
  7. addressing a certain widely used species of real-time (RT) clock that is not
  8. an AT-CMOS.  Depending on the manufacturer, the supporting software that
  9. comes with these clocks can have names like GETTIME, SETTIME, TIMER, CLSET,
  10. etc.  All of these manufacturer-supplied programs act and feel different, and
  11. they all talk to the RT clock in different ways, even though the clock
  12. supplied by all the manufacturers is essentially the same one.
  13.  
  14.   The most important difference between manufacturers is the way they handle
  15. the year with these clocks.  No two seem to do it the same way.  Another
  16. important difference is that some of the proprietary programs allow you to
  17. put new time and date on the command line, while others insist on making you
  18. respond to prompts for that information.  Some of the manufacturers supply
  19. one program to set the RT clock and another program to read it, while other
  20. manufacturers use one program to do either, depending on what command line
  21. parameter is used.  Finally, some manufacturers fix things so only their
  22. programs can even detect the presence of the RT clock, even though it's
  23. basically the same clock that all the other manufacturers are using.  In
  24. short, each manufacturer locks you into his particular way of dealing with
  25. the same clock, and in the process makes it practically impossible for anyone
  26. else to write programs that can work directly with all these clocks.
  27.  
  28.   Strickland's free RT clock programs talk to all these clocks in the same
  29. way, and this brings some distinct advantages that are not available with the
  30. original proprietary software that came with them.
  31.  
  32.   The chief advantage of Strickland's programs is that they open the way for
  33. programmers to write application software that can work with all such clocks,
  34. regardless of brand.  The first such program is TIMESET, which can set
  35. most brands of this type of RT clock to Naval Observatory time.  But
  36. Strickland's programs open the way for many more applications to be written
  37. that can work directly with these clocks.  The AT CMOS clock is handled 
  38. essentially the same way by all manufacturers, to the benefit of the
  39. owners of those clocks.  Now, with Strickland's RT clock software, the owners
  40. of these other RT clocks (in most but not all cases) will be able to enjoy
  41. the same benefits of standardization that the owners of AT CMOS clocks do.  
  42.  
  43.   There are some important rules to follow in using the Strickland programs. 
  44. Remember that these rules apply only to RT clocks that are not the AT CMOS:
  45.  
  46. Rule 1.   IF YOU WANT TIMESET.EXE TO SET YOUR REAL-TIME CLOCK BY THE
  47.           NAVAL OBSERVATORY, YOU HAVE TO USE STRICKLAND'S RT CLOCK SOFWARE.
  48.           Put your clock's original programs away because they and TIMESET
  49.           are incompatible.
  50.  
  51.  
  52. Rule 2.   YOU CAN'T USE BOTH YOUR ORIGINAL RT CLOCK SOFTWARE AND
  53.           STRICKLAND'S SOFTWARE.  It has to be one system or the other.
  54.  
  55.   If you set your RT clock with Strickland's RTCLOCK.COM (or with
  56. TIMESET.EXE) you should not use the original software that came with your
  57. RT clock to try to read that clock, because it will return the wrong date.
  58. Conversely, if you set your RT clock with your original software, it's futile
  59. to try to read it later with Strickland's REALTIME.COM because it, too, will
  60. return the wrong date.
  61.  
  62.   You have to pick one system or the other -- either Strickland's or somebody
  63. else's -- and stick with it for both setting and reading the RT clock.  This
  64. also means that if you choose Strickland's software, you have to change your
  65. AUTOEXEC.BAT file to remove the name of any original software for your RT
  66. clock that is there and replace it with a comparable one from Strickland's
  67. set.  Thus, if your AUTOEXEC.BAT file has a line that tells the proprietary
  68. program TIMER.COM to move RT time and date to DOS on boot-up, you have to
  69. replace it with a line that tells Strickland's RTCLOCK.COM to do the same
  70. thing, like this:
  71.  
  72.                                RTCLOCK -G
  73.  
  74. (unless you are using the Strickland RT clock driver--see below).  The -G
  75. means get the time/date from the RT clock and send it to DOS.
  76.  
  77.   Later, if you change the time or date in DOS, either directly or through
  78. the action of some program, you can send the new time or date to the RT clock
  79. with:
  80.  
  81.                                RTCLOCK -S
  82.  
  83. (unless you are using the Strickland RT clock driver--see below).
  84.  
  85.   Thereafter, you can read the RT clock's time and date by running
  86. Strickland's REALTIME.COM in DOS, but not by running the comparable program
  87. that came with your RT clock.  If you use the original software you'll get
  88. erroneous readings.
  89.  
  90.   Remember: pick one system or the other and use it consistently.  If you
  91. want TIMESET to set your RT clock, however, you have no choice:  it has to be
  92. Strickland's system, because that's the system TIMESET uses.
  93.  
  94. Rule 3.   IF YOU INSTALL STRICKLAND'S RT CLOCK DRIVER YOU SHOULD NOT USE
  95.           ANY OTHER CLOCKSETTING SOFTWARE TO CHANGE THE TIME OR DATE IN YOUR
  96.           RT CLOCK -- NEITHER STRICKLAND'S RTCLOCK.COM NOR THE CLOCKSETTING
  97.           SOFTWARE THAT CAME WITH YOUR RT CLOCK.
  98.  
  99.   With the driver installed, there is no need to use RTCLOCK.COM or any other
  100. program to move time/date between DOS and the RT clock.  The driver takes
  101. care of that any time you change time or date in DOS, or even look at it. 
  102. You also do not need to use any special software to read the RT clock when
  103. the driver is installed, because the driver moves that information to DOS
  104. whenever you ask the DOS clock/calendar to report the time or date.
  105.  
  106.   You will get strange results if you try to set your RT clock with special
  107. software if the driver is installed.  Don't do it, because the program that
  108. sets your RT clock gets into an unwholesome competition with the driver. 
  109. Think of it this way:  RTCLOCK (or any other program for accessing the RT
  110. clock) is like a messenger that knocks on the door separating the DOS
  111. clock/calendar and the RT clock to deliver messages from one to the other. 
  112. But CLKDRV.SYS knocks the whole wall down, so there is no need for an outside
  113. messenger and no need for knocking.  If you nevertheless send RTCLOCK or
  114. another program to pound on a door that no longer exists, it just gets in the
  115. driver's way and causes confusion.  CLKDRV.SYS wants to hog the whole show. 
  116. Let it.
  117.  
  118.   To install Strickland's CLKDRV.SYS you have to put this line in your
  119. CONFIG.SYS file:
  120.  
  121.                          DEVICE = CLKDRV.SYS.
  122.  
  123. Then reboot your system--but only after you have removed any RT clock program
  124. names from your AUTOEXEC.BAT file.
  125.  
  126.  
  127.   Questions about the Strickland RT clock programs should be directed to Tom
  128. Strickland, co-sysop of the Corral BBS, (703-360-5097, 1200/2400/9600 baud,
  129. 8 data bits, no parity).
  130.  
  131.