home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / c128 / util / smw128v2.sfx / smw128.v2.doc < prev    next >
Text File  |  1990-09-04  |  14KB  |  297 lines
  1. ╙MARTWATCH 128 ╓ERSION 2
  2.  
  3. ┼RIC ├. ╥AFANAN
  4. ┴UGUST 28, 1990
  5.  
  6. ├OPYRIGHT 1990
  7. ┴LL ╥IGHTS ╥ESERVED
  8.  
  9. ╘HIS IS ╞REEWARE. ┘OU MAY DISTRIBUTE IT FREELY, BUT YOU MAY NOT SELL IT.
  10.  
  11.  
  12. ╬╧╘┼ - ╘HE PLANS AND SOFTWARE PRESENTED ARE TO BE USED AT YOUR OWN RISK. ╘HE
  13. AUTHOR CANNOT BE HELD RESPONSIBLE FOR ANY DAMAGE INCURRED THROUGH THE USE OF
  14. THIS INFORMATION.
  15. ┘OU KNOW, ╔ ╥┼┴╠╠┘ HATE DOING THAT!  ┴T ANY RATE, THE UTMOST CARE HAS BEEN
  16. TAKEN TO ENSURE THAT A MINIMUM OF RISK WILL BE ENCOUNTERED.  ╘HE PROJECT IS
  17. REALLY SIMPLE EVEN FOR THE NOVICE ELECTRONICS HOBBYIST, BUT IF YOU'RE NOT
  18. CONFIDENT OF YOUR ABILITY, THEN BY ALL MEANS, GET SOME HELP.
  19. ╔F YOU NEED ASSURANCE THAT THIS PROJECT WILL NOT CAUSE YOUR COMPUTER TO MELT,
  20. TAKE A LOOK AT THE NUMBER OF DOWNLOADS OF THE ╙MARTWATCH DRIVERS ON ╤LINK (MINE
  21. WAS ABOUT 80 AT LAST COUNT, AND WITH THE ╟┼╧╙ DRIVERS, IT NUMBERS IN THE
  22. HUNDREDS!), AND ALSO READ THE COMMENTS.
  23.  
  24.  
  25. ╙MARTWATCH - ╫HAT IS IT?
  26. ------------------------
  27.  
  28. ╘HE ╙MARTWATCH IS A BATTERY-BACKED ├LOCK/├ALENDAR CHIP.  ╔T WILL KEEP THE
  29. CORRECT TIME, EVEN WHEN THE POWER TO THE COMPUTER IS TURNED OFF.  ╘HE
  30. ╙MARTWATCH WAS ORIGINALLY MADE FOR THE ╔┬═ AND ╔┬═-COMPATIBLE COMPUTERS, BUT
  31. WITH A LITTLE WORK, IT CAN BE ADAPTED TO WORK WITH THE ├OMMODORE ├128 AND
  32. ├128─.
  33.  
  34. ╘HE ORIGINAL ├OMMODORE DRIVER FOR THE ╙MARTWATCH WAS DEVELOPED BY ╦EN ╫ALLACE.
  35. ╚IS DRIVER IS AN ┴UTO-┼XEC PROGRAM FOR ╟┼╧╙, THAT WILL AUTOMATICALLY READ THE
  36. ╙MARTWATCH AND SET ╟┼╧╙' TIME AND DATE.  ╘HE FIRST DRIVER FOR THE 128'S ╬ATIVE
  37. ═ODE WAS ╙MARTWATCH128.  ╙INCE THEN, THERE HAVE BEEN NUMEROUS ADAPTATIONS OF
  38. ╦EN ╫ALLACE'S CODE, INCLUDING DRIVERS FOR:
  39.  
  40. - ╘HE ╫RITE ╙TUFF WORDPROCESSOR, BY ╩AMES ╟REEK,
  41. - THE ╒LTRATERM AND ╓╘-100 ╘ERM PROGRAMS, BY ┬RAD ─UMLER, AND
  42. - AN UPDATED ╟┼╧╙ DRIVER AND A ├64 DRIVER, BY ╩.╞. ╚OWARD.
  43.  
  44. ╘HIS IS THE SECOND VERSION OF ╙MARTWATCH128.  ╘HE CHANGES INCLUDE:
  45.  
  46. - ╘HE ╞┴╙╘ MODE BUG HAS BEEN SQUASHED.  ╘HE ORIGINAL ╙MARTWATCH128 DID NOT
  47.   LIKE ╞┴╙╘ MODE.
  48. - ╬EW SUPPORT FOR ─ATE READING.  ╘HE ORIGINAL ╙MARTWATCH128 MADE THE USER
  49.   FIGURE OUT HOW TO READ THE DATE.  ╓ERSION 2 WILL NOW PUT THE DATE INTO
  50.   A STRING VARIABLE (─╘$) FOR MAXIMUM EASE OF USE.
  51. - ╘HE '╙MARTWATCH-╬OT-├ONNECTED' ┬ELL HAS NOW BEEN MADE OPTIONAL.
  52. - ┴ BETTER METHOD OF CHECKING FOR ╙MARTWATCH ╥EAD ERRORS HAS BEEN IMPLEMENTED.
  53.  
  54. ╘HE ORIGINAL FEATURES STILL REMAINING ARE:
  55.  
  56. - ╙ETTING OF ╘╔$, ╘IME-OF-─AY ├LOCK #1, AND ╘IME-OF-─AY ├LOCK #2 IN ANY
  57.   COMBINATION, ALL USER-SELECTABLE.
  58. - ┴BILITY TO SET THE ╙MARTWATCH TO THE DESIRED TIME AND DATE.
  59.  
  60.  
  61. ╘HE .╙╞╪ SHOULD CONTAIN THE FOLLOWING FILES:
  62.  
  63. - ╙═╫128.╓2.─╧├    - ┘OU'RE READING IT.
  64. - ╓╔┼╫ ╙├╚┼═┴╘╔├   - ┬┴╙╔├ PROGRAM TO VIEW THE ╙MARTWATCH SCHEMATIC.
  65. - ╙═╫.╙├╚┼═┴╘╔├    - ╘HE SCHEMATIC.
  66. - ╙═╫ ╘┼╙╘         - ┬┴╙╔├ PROGRAM TO TEST THE ╙MARTWATCH.
  67. - ╙═╫128.╓2/2757   - ╓ERSION 2 ═╠ DRIVER TO READ THE ╙MARTWATCH.
  68. - ╙═╫128.╓2/4870   - ╙AME THING BUT IN A DIFFERENT MEMORY LOCATION.
  69. - ╙┼╘╙═╫.╓2/3075   - ╓ERSION 2 ═╠ DRIVER TO SET THE ╙MARTWATCH.
  70. - ╙┼╘╙═╫.╓2/6000   - ┴GAIN, THE SAME THING BUT IN A DIFFERENT MEMORY LOCATION.
  71.  
  72. ┬UT ╫┴╔╘! - THAT'S NOT ALL!....
  73.  
  74. ╬ONE OF THE ╟┼╧╙ DRIVERS WORK CORRECTLY UNDER ╟┼╧╙128 80-COLUMN MODE.  ╙O ╔
  75. TOOK THE BEST OF THEM (╩.╞. ╚OWARD'S DRIVER) AND ADAPTED IT.
  76. ╒SE ├ONVERT 2.5 TO CHANGE IT BACK TO ╟┼╧╙ FORMAT.
  77.  
  78. - ╟┼╧╙/╥┼┴─        - ┴N ┴UTO┼XEC PROGRAM TO SET ╟┼╧╙ TIME FROM THE ╙MARTWATCH.
  79.  
  80.  
  81. ╚OW DO YOU BUILD IT?
  82. --------------------
  83.  
  84. ╘HESE ARE THE PARTS YOU'LL NEED:
  85.  
  86. - ╧NE (1)     ╙MARTWATCH OR ─╙1216┼ (─ALLAS ╙EMICONDUCTOR).
  87.               ╘HE ╙MARTWATCH CAN BE FOUND AT ╥ADIO ╙HACK, BUT IT CAN BE
  88.               BOUGHT ═╒├╚ CHEAPER FROM OTHER SOURCES.
  89.        ╬╧╘┼ - ═AKE SURE THE CHIP IS A ─╙1216┼ CHIP. ╘HERE ARE OTHER VERSIONS
  90.               OF THE ─╙1216, BUT WE WANT AN '┼' SERIES CHIP.
  91. - ╘HREE (3)   100╦ OHM ╥ESISTORS (ANY WATTAGE) FOR ┼LECTROSTATIC ╨ROTECTION.
  92. - ╧NE (1)     28-PIN ─╔╨ SOCKET, TO MOUNT THE ╙MARTWATCH ON.
  93. - ???         ┼NOUGH WIRE TO CONNECT THE PARTS TOGETHER. (NOT MUCH AT ALL)
  94. - ╧NE (1)     ┬OX TO PUT IT IN.
  95. - ╧NE (1)     9-PIN ─-╙UB CONNECTOR (FEMALE) TO PLUG INTO THE ╩OYSTICK PORT.
  96.  
  97. ┴LL THESE PARTS CAN BE BOUGHT AT ╥ADIO ╙HACK.
  98.  
  99. ┴LL THE ╙MARTWATCH DRIVERS ASSUME THAT THE ╙MARTWATCH IS CONNECTED TO ╩OYSTICK
  100. ╨ORT #2.  ╘HE PLANS OUTLINED BELOW ARE FOR CONNECTING THE ╙MARTWATCH TO THE
  101. ╩OYSTICK PORT USING A REGULAR ╩OYSTICK PLUG.  ╘HIS IS THE SIMPLEST WAY TO DO
  102. IT, BUT IT HAS THE DISADVANTAGE OF TAKING UP THE MOST-USED JOYSTICK PORT!
  103. ╘HERE HAVE BEEN MANY SUCCESSFUL ATTEMPTS TO GET AROUND THIS LIMITATION.  ╙OME
  104. IDEAS WHICH MAY INTEREST YOU:
  105.  
  106. - ╔F YOU HAVE A ├128─, THEN JUST MOUNT THE ╙MARTWATCH ╔╬╙╔─┼ OF THE COMPUTER.
  107.   ╘HE ╩OYSTICK LINES ARE ALL ACCESSIBLE, AND YOU SAVE ON THE COST OF A BOX
  108.   AND JOYSTICK PLUG.  ┘OU DO ╓╧╔─ YOUR COMPUTER'S WARRANTY HOWEVER (LIKE IT
  109.   HASN'T RUN OUT ALREADY ANYWAY!) AND YOU NEED TO BE SURE THE ╙MARTWATCH
  110.   DOESN'T SHORT-OUT WITH ANYTHING.
  111. - ╒SE A ┘-ADAPTER IN THE ╩OYSTICK PORT.  ╘HESE ARE THOSE CABLES WHICH PLUG
  112.   INTO YOUR JOYSTICK PORT AND SPLIT INTO 2 SOCKETS FOR 2 JOYSTICKS.  ╘HEY'RE
  113.   CHEAP AND ALSO ALLOW NORMAL USE OF THE JOYSTICK PORT #2.
  114.  
  115. ╘HERE'S NO NEED TO WORRY ABOUT ACCIDENTALLY ACCESSING THE ╙MARTWATCH WHEN
  116. SHARING THE JOYSTICK PORT WITH A JOYSTICK.  ╘HE ╙MARTWATCH CAN ONLY BE ACCESSED
  117. AFTER SENDING A ╨ATTERN ╥ECOGNITION ╙EQUENCE, AND THE ODDS OF THAT ACCIDENTALLY
  118. HAPPENING IS LESS THAN 1 IN 10^19 !!
  119.  
  120.  
  121. ╧NCE YOU'VE DECIDED WHERE TO PUT THE ╙MARTWATCH, WE CAN START BUILDING IT.  ╘HE
  122. FIRST THING WE NEED TO DO IS LOOK AT THE SCHEMATIC.  ╘O DO THIS, JUST RUN THE
  123. '╓╔┼╫ ╙├╚┼═┴╘╔├' PROGRAM.  ╘HIS WILL DISPLAY A WIRING DIAGRAM FOR THE
  124. CONNECTIONS NEEDED.  ╔F YOU NEED TO GET A PRINTED COPY OF THE SCHEMATIC, JUST
  125. USE ANY OF THE ╚I-╥ES PRINTER DUMP PROGRAMS AVAILABLE ON ╤LINK.
  126.  
  127. ╬OTE THE BOXES IN THE LOWER CORNERS OF THE PICTURE - THESE WILL HELP YOU TO
  128. FIND THE CORRECT PINS ON THE CHIP AND JOYSTICK PLUG.  ┴LSO, ┬┼ ╥┼┴╠╠┘ ├┴╥┼╞╒╠
  129. ╔╬ ├╧╬╬┼├╘╔╬╟ ╘╚┼ +5╓ ╘╧ ╘╚┼ ├╧╥╥┼├╘ ╨╔╬╙.  ╘HIS IS ABOUT THE ONLY THING THAT
  130. CAN DO ANY DAMAGE TO YOUR COMPUTER, SO MAKE SURE YOU HOOK IT UP CORRECTLY!
  131.  
  132. ┴NOTHER ╬╧╘┼ - BE VERY CAREFUL WHEN HANDLING THE ╙MARTWATCH CHIP.  ╠IKE ALL
  133. CHIPS, IT IS SUSCEPTIBLE TO ELECTROSTATIC DISCHARGES.  ╘HIS MEANS THAT IF YOU
  134. TOUCH THE EXPOSED PINS WRONG, YOU'RE LIKELY TO SEND A JOLT OF STATIC
  135. ELECTRICITY THROUGH IT AND FRY IT'S INNARDS!  ╧F COURSE THERE WON'T BE ANY
  136. INDICATION OF THIS, AND WHEN YOU TEST IT, IT WON'T WORK, AND THEN YOU'LL BE
  137. BLAMING ME FOR WRITING A FAULTY DRIVER OR DRAWING MESSED UP PLANS, WHEN IN ALL
  138. ACTUALITY.... <GRIN>
  139.  
  140. ┴NYWAY, JUST BE REALLY CAREFUL.  ╔N FACT, YOU SHOULDN'T HAVE TO TOUCH THE
  141. ╙MARTWATCH CHIP AT ALL UNTIL YOU'RE JUST ABOUT TO TEST IT.  ┴LL THE WIRING IS
  142. DONE BETWEEN THE ╩OYSTICK PLUG AND THE ╔├ SOCKET.  ╘HIS IS FOR CONVENIENCE AS
  143. WELL AS FOR SAFETY.
  144.  
  145. ╔T SHOULDN'T TAKE ANYMORE THAN A COUPLE OF HOURS TO GET THIS BUILT, AND THAT'S
  146. ASSUMING THAT YOU ARE TAKING EXTRA-SPECIAL CARE TO PUT IT TOGETHER.  ╧NCE IT'S
  147. COMPLETED, THEN WE CAN TEST IT.
  148.  
  149.  
  150. ╘ESTING THE ╙MARTWATCH
  151. ----------------------
  152.  
  153. ╘ESTING THE ╙MARTWATCH IS AS EASY AS RUNNING THE '╙═╫ ╘┼╙╘' PROGRAM. ╘HE
  154. PROGRAM WILL KEEP YOU INFORMED ABOUT WHAT IT IS DOING.  ╔F ALL GOES WELL, THEN
  155. YOU SHOULD SEE THE INDICATIONS ON THE SCREEN.
  156.  
  157. ┘OU CAN ALSO USE THE ╘EST PROGRAM AS AN EXAMPLE OF HOW TO USE THE ╙MARTWATCH IN
  158. YOUR OWN PROGRAMS.
  159.  
  160. ╔F YOU DO GET ANY FAULTY INDICATIONS, CHANCES ARE THAT YOU CONNECTED A WIRE TO
  161. THE WRONG PIN.  ═OST OF THE ERRORS OCCUR BECAUSE OF THIS (╥EMEMBER, USE THE
  162. PIN-OUT GUIDES IN THE SCHEMATIC).  ╘HIS PROBLEM IS USUALLY NOT FATAL, SINCE
  163. MOST OF THE PINS OF THE ╙MARTWATCH AREN'T CONNECTED TO ANYTHING.  ╙O, RECHECK
  164. YOUR WIRING AND CONNECTIONS, AND TRY AGAIN.
  165.  
  166.  
  167. ╒SING THE ╙MARTWATCH
  168. --------------------
  169.  
  170. ╧NCE YOU'VE GOT THE ╙MARTWATCH BUILT AND WORKING, YOU CAN EASILY USE IT FROM
  171. YOUR OWN PROGRAMS, EITHER ┬┴╙╔├ OR ═╠.  ╒NFORTUNATELY, MOST COMMERCIAL PROGRAMS
  172. DO NOT SUPPORT ┴╬┘ KIND OF ├LOCK/├ALENDAR CHIP SO IT WILL BE OF LITTLE USE IN
  173. THOSE.  ╘HE EXCEPTIONS ARE ╟┼╧╙, ╘HE ╫RITE ╙TUFF, ╒LTRATERM, AND THE ╓╘-100
  174. TERM, AND THOSE PROGRAMS WE'RE ADAPTED TO WORK WITH THE ╙MARTWATCH BY THE USERS
  175. THEMSELVES.  ╔F YOU HAVE A FAVORITE PROGRAM THAT YOU WOULD LIKE TO GET WORKING
  176. WITH THE ╙MARTWATCH, ┴╬─ YOU KNOW ═ACHINE ╠ANGUAGE PROGRAMMING, ╔ HAVE ALSO
  177. UPLOADED THE SOURCE FILES FOR THE ╙MARTWATCH DRIVERS SO YOU CAN SEE HOW TO
  178. ACCESS AND READ THE ╙MARTWATCH AND ADAPT IT FOR YOUR OWN USE.
  179.  
  180. ┴NYWAY, BACK TO THE DRIVERS INCLUDED IN THIS PACKAGE.
  181.  
  182. ╘HE FIRST THING YOU WANT TO DO IS SET ╙MARTWATCH TO THE CORRECT ╘IME AND ─ATE.
  183. ╙O, ┬╠╧┴─ EITHER '╙┼╘╙═╫.╓2/3075' OR '╙┼╘╙═╫.╓2/6000' INTO MEMORY.  ┬OTH
  184. FUNCTION IDENTICALLY, BUT ARE IN DIFFERENT LOCATIONS IN CASE OF CONFLICTS WITH
  185. ANY OTHER ═╠ ROUTINES YOU'RE USING. ╘HE ╙MARTWATCH USES THE ╘IME FROM ╘╔$ AND
  186. THE ─ATE IS PASSED TO IT USING THE ╙┘╙ CALL.  ╘HE ╙YNTAX FOR USING THE ╙ET
  187. ╙MARTWATCH DRIVER IS:
  188.  
  189. ╙┘╙ ╪╪╪╪, MONTH, DAY, YEAR, WEEKDAY
  190.  
  191. ╪╪╪╪     - ╘HE ADDRESS OF THE ROUTINE.
  192.            ╙┼╘╙═╫.╓2/3075 - ╪╪╪╪ = 3075
  193.            ╙┼╘╙═╫.╓2/6000 - ╪╪╪╪ = 6000
  194. MONTH    - ╩ANUARY = 1 ... ─ECEMBER = 12.
  195. DAY      - 1 TO 31 DEPENDING ON THE MONTH.
  196. YEAR     - 1 TO 99. ╘HE CENTURY IS NOT RECORDED, BUT ALL DRIVERS ASSUME 19╪╪.
  197. WEEKDAY  - ╙UNDAY = 1 ... ╙ATURDAY = 7.
  198.  
  199. ╘HE DRIVERS DO ╬╧ ERROR-CHECKING.  ┘OU CAN PUT IN A MONTH OF 99 IF YOU WISH.
  200. ╘HE RESULTS WILL BE UNPREDICTABLE THOUGH, AND IT MAY EVEN CAUSE YOUR COMPUTER
  201. TO LOCK-UP THE NEXT TIME YOU TRY TO READ THE ╙MARTWATCH.
  202.  
  203. ╘╔$ SHOULD BE SET ╩╒╙╘ ┬┼╞╧╥┼ YOU CALL THE ╙ET ROUTINE. ╘HIS WILL ENSURE A HIGH
  204. DEGREE OF ACCURACY, ESPECIALLY SINCE ╘╔$ ISN'T NOTED FOR ITS PRECISE
  205. TIME-KEEPING ABILITY.
  206.  
  207. ┘OU SHOULD ONLY HAVE TO SET THE ╙MARTWATCH ONCE.  ┴FTER THAT, IT KEEPS THE ╘IME
  208. AND ─ATE AUTOMATICALLY.
  209.  
  210.  
  211. ┴FTER YOU'VE SET THE ╙MARTWATCH, YOU'LL PROBABLY WANT TO READ IT EVERY NOW AND
  212. THEN.  ╘O DO THIS, ┬╠╧┴─ EITHER '╙═╫128.╓2/2757' OR '╙═╫128.╓2/4870'.  ╘HEY DO
  213. THE SAME THING BUT ARE IN DIFFERENT LOCATIONS.  ╩UST IN CASE YOU DECIDE TO HAVE
  214. A ╙ET DRIVER AND A ╥EAD DRIVER IN MEMORY AT THE SAME TIME, YOU SHOULD KNOW THAT
  215. THE LOWER-ADDRESSED DRIVERS WILL CONFLICT WITH EACH OTHER AND THE
  216. HIGHER-ADDRESSED DRIVERS WILL ALSO CONFLICT WITH EACH OTHER.  ╘O READ THE ╘IME
  217. AND THE ─ATE FROM THE ╙MARTWATCH, USE THIS ╙YNTAX:
  218.  
  219. ╙┘╙ ╪╪╪╪, OPTIONS
  220.  
  221. ╪╪╪╪     - ╘HE ADDRESS OF THE ROUTINE.
  222.            ╙═╫128.╓2/2757 - ╪╪╪╪ = 2757
  223.            ╙═╫128.╓2/4870 - ╪╪╪╪ = 4870
  224. OPTIONS  - ╘HERE ARE A NUMBER OF OPTIONS AVAILABLE.
  225.            ╘O CHOOSE AN OPTION, ADD IN THESE VALUES:
  226.  
  227.              +1    - ╙ET ╘╔$.
  228.              +2    - ╙ET ╘IME-OF-─AY ├LOCK #1.
  229.              +4    - ╙ET ╘IME-OF-─AY ├LOCK #2.
  230.              +8    - ╙ET ─╘$ (THE ─ATE ╙TRING).
  231.              +16   - ─ISABLE THE '╙MARTWATCH-╬OT-├ONNECTED' ┬ELL.
  232.              +128  - ╨RINT THE ├REDITS/╓ERSION.
  233.  
  234. ╞OR YOU ═╠ PROGRAMMERS OUT THERE:
  235.  
  236.                                         ╬O ┬ELL     ╙ET ╘╧─ #2  ╙ET ╘╔$
  237.                                        /           /           /
  238.           BIT #     7     ╪     ╪     4     3     2     1     0
  239.                    /                       /           /
  240.                    ╨RINT ├REDITS/╓ERSION   ╙ET ─╘$     ╙ET ╘╧─ #1
  241.  
  242. ╞OR EXAMPLE, TO SET ╘╔$ AND ─╘$, YOU WOULD ADD 1+8 = 9. ┘OUR OPTIONS VALUE
  243. WOULD BE 9.
  244.  
  245. ╥EMEMBER, ╘╔$ IS IN 24-HOUR FORMAT (MILITARY TIME).  ┘OU MAY HAVE TO CONVERT
  246. THAT TO 12-HOUR TIME IF YOU WANT TO USE ╘╔$ IN YOUR OWN PROGRAMS.
  247.  
  248. ╘HE ╘╧─ CLOCKS ON THE OTHER HAND ARE ALREADY IN 12-HOUR FORMAT.  ╘HEY ARE ALSO
  249. VERY ACCURATE.  ╘HE ONLY PROBLEM WITH USING THEM IS THAT THERE IS NO BUILT-IN
  250. COMMAND TO ACCESS THE ╘╧─ CLOCKS.  ╔N ┬┴╙╔├, YOU MUST READ THEM MANUALLY USING
  251. ╨┼┼╦ COMMANDS.
  252.  
  253. ╘HE '╬O ┬ELL' OPTION HAS BEEN ADDED TO ALLOW THE USER TO PROGRAM HIS/HER OWN
  254. RESPONSE TO THE '╬OT ├ONNECTED' ERROR.  ╔N ORDER TO CHECK IF THERE WAS AN ERROR
  255. IN READING THE ╙MARTWATCH, A VALUE IS RETURNED IN THE ┴CCUMULATOR REGISTER.
  256. ╘HIS CAN BE EASILY TESTED IN ═╠, AND DOING SO FROM ┬┴╙╔├ IS ONLY A LITTLE MORE
  257. INVOLVED. ╔N ┬┴╙╔├, USE THE COMMAND '╥╥┼╟ ┴' IMMEDIATELY AFTER CALLING THE ╥EAD
  258. DRIVER.  ╘HIS WILL DEPOSIT THE ┴CCUMULATOR VALUE INTO THE ┬┴╙╔├ VARIABLE ┴.
  259. ╘HE VALUE WILL EQUAL '0' IF THERE WAS NO ERROR, AND '255' IF THERE WAS.  ╔T'S
  260. AS SIMPLE AS THAT.
  261.  
  262. ╨RINTING THE ├REDITS/╓ERSION IS SELF-EXPLANATORY.
  263.  
  264. ╫HEN YOU CHOOSE THE ╙ET ─╘$ OPTION, THE VARIABLE ─╘$ IS SET TO THE ─ATE READ
  265. FROM THE ╙MARTWATCH.  ╔F ─╘$ DOES NOT EXIST AT THE TIME, THE ROUTINE WILL
  266. CREATE ─╘$.  ╔F ─╘$ ─╧┼╙ EXIST, THE CONTENTS OF ─╘$ WILL BE REPLACED BY THE
  267. ─ATE.
  268.  
  269. ─╘$ WILL CONTAIN THE ═ONTH, ─AY, ┘EAR, AND ╫EEKDAY IN THAT ORDER.  ╔T WILL BE
  270. WRITTEN IN ╒PPERCASE/╠OWERCASE LETTERS, AND CONTAIN STANDARD ─ATE FORMATTING.
  271. ╘HE ╫EEKDAY WILL ┴╠╫┴┘╙ BE 11 CHARACTERS LONG.  ╔F THE ╫EEKDAY NAME IS LESS
  272. THAN 11 CHARACTERS (THEY ALL ARE) THE REST IS PADDED WITH SPACES.  ╘HIS IS
  273. BECAUSE THERE ARE NOT THAT MANY USES FOR THE ╫EEKDAY, AND IN MOST CASES IT
  274. NEEDS TO BE DISCARDED.  ╘O CUT THE ╫EEKDAY FROM ─╘$, USE THE FOLLOWING ┬┴╙╔├
  275. COMMAND:
  276.  
  277. ─╘$ = ╠┼╞╘$( ─╘$, ╠┼╬(─╘$) - 11)
  278.  
  279. ╘HIS WILL CUT OFF THE LAST 11 CHARACTERS FROM ─╘$ AND LEAVE THE ─ATE INTACT.
  280.  
  281. ╔F YOU FIND YOUR COMPUTER HANGING-UP WHEN TRYING TO READ THE ╙MARTWATCH,
  282. ESPECIALLY WHEN THE LAST THING IT PRINTED WAS A '┬┴─ ╙╒┬╙├╥╔╨╘' OR '╘┘╨┼
  283. ═╔╙═┴╘├╚' ERROR, TRY ╙┼╘╘╔╬╟ THE ╙MARTWATCH AGAIN.  ├HANCES ARE THAT THE ╘IME
  284. AND ─ATE IN THE ╙MARTWATCH GOT GARBLED, WHICH IN TURN CAUSED THE ╥EAD DRIVER TO
  285. READ IN GARBAGE, AND YOU KNOW THE OLD SAYING ABOUT GARBAGE IN....
  286.  
  287.  
  288. ╫RAPPING IT UP...
  289. -----------------
  290.  
  291. ╫ELL THAT ABOUT DOES IT FOR THE DOCUMENTATION. ╔ HOPE ╔ COVERED EVERYTHING
  292. THOROUGHLY ENOUGH.  ╔F NOT, ╔ CAN BE REACHED ON ╤LINK AS ═E┼RIC, AND ╔'LL BE
  293. HAPPY TO GIVE YOU ANY ASSISTANCE THAT ╔ CAN.
  294.  
  295. ┼RIC ├. ╥AFANAN
  296. ┴UGUST 28, 1990
  297.