home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / club100 / tel / xmdpw6.doc < prev    next >
Text File  |  2006-10-19  |  7KB  |  138 lines
  1. Information on XMDPW6.100/200: Update of 7/18/88
  2. ------------------------------------------------
  3.  
  4. 1.  What it Does That's New
  5.     -----------------------
  6.  
  7. XMDPW6.CO is a full-featured machine language communications program which
  8. provides xmodem upload from and download to external devices, inclouding the
  9. DVI, Chipmunk and the Booster Pak.   XMDPW6.CO is essentially identical to
  10. XMDPW5.CO --except it supports upload and download of files from/to external
  11. devices (CAS:, 0:, R:, etc.). Note that it will NOT let you download to a
  12. TDD, due to both the phone and the TDD needing the comm chip (internal modem
  13. operates on same UART as the RS-232 port).  See XMDPW5.DOC (Lib 3) for a
  14. summary of XMDPW5 features and usage.
  15.  
  16. Is XMDPW6.CO for you?  Only if you need to upload from or download to
  17. Chipmunk, DVI, Booster Pack -- or some other external device connected to
  18. the Model 100/102/200 system bus.  Note that Booster Pack has X-TEL built
  19. in-- an excellent program (but you may prefer some XMDPW6 features, like
  20. split screen in COnference, macros and DIRACC).  I don't recommend getting
  21. this program to use CAS: as your external device; CAS: makes things go very
  22. slow, since all I/O is done in Xmodem 128 byte blocks!
  23.  
  24. Based on the above observations, XMDPW5.CO will remain the standard
  25. version..  But both versions will be available and supported.
  26.  
  27. 2.  The XMDPW6 Files, and Installation
  28.     ----------------------------------
  29.  
  30. The following files are provided:
  31.  
  32.     o XMDPW6.100 (Lib 3)  -- Relocating 100/102 Basic Loader
  33.     o XMDPW6.200 (Lib 10) -- Relocating Tandy 200 Basic Loader
  34.     o XMDPW6.ASM (Lib 3)  -- The ADSM.CO source of XMDPW6.CO (100/102)
  35.     o XMD62A.SRC & XMD62B.SRC -- Linked ADSM.CO source files for the 200
  36.           (both Lib 10)          version of XMDPW6.CO.
  37.     o XM6CHP.200 (Lib 10) -- A 200 version to be loaded below CDOS (and DVI
  38.                              OS, I believe); see below
  39.     o XMDPW6.INF (Lib 3)  -- This file, on installation and usage, including
  40.                              latest any reports of functional or non-
  41.                              functional hardware combinations (at the end of
  42.                              this file)
  43.     o XMDHZ6.100 (Lib 3)  -- Provides autodial/redial utility for Hayes
  44.                              compatible modems and XMDPW6.CO (100/102 only)
  45.  
  46. XMDPW6.100 is a relocating Basic loader which will create XMDPW6.CO in the
  47. 100/102 at a memory location of your choice (obviously subject to memory
  48. limitations, etc.).  Just load it as a BA program and run it.
  49.  
  50. If you use XMDPW6.100 with the Chipmunk, note the following important tip
  51. from Denny Thomas: "CDOS doesn't like having a program end at the last byte
  52. before its MAXRAM (57967).  What you need to do is run the loader program
  53. again and instead of hitting [CR] for the default location, type in the
  54. value 57960.  That gives a 7 byte buffer between XMDPW6 and CDOS.  There is
  55. no reason that I have ever found why this happens, but it just seems to be a
  56. quirk of CDOS".
  57.  
  58. XMDPW6.200 does the same thing in the Tandy 200.  However, due to the
  59. limited per-bank memory of the 200, it may not be feasible to run the Basic
  60. loader with the loading location set low enough to leave room for either
  61. CDOS or the DVI's operating system.  So I've provided XM6CHP.200, a hex form
  62. of XMDPW6.CO for the 200.  Use HXFER.200 (Lib 10) to load this program to
  63. its default running location (Himem = 51600), which puts its END address
  64. abbout 50 bytes below the beginning of CDOS.  And, using ADSM (Lib 10) and the
  65. two-part linked source of XMDPW6.200 (XMD62A.SRC & XMD62B.SRC), you have the
  66. option of assembling th eprogram to run at any ORG address you prefer or
  67. need (including the ORG = 51600 I chose).
  68.  
  69. 3.  Usage with Device Files
  70.     -----------------------
  71.  
  72. To specify a device file, type the name as Pre:File, where File is the
  73. file name and Pre: is the device prefix.  Pre: is 0: (or 1:) for disk
  74. files [Chipmunk CDOS or DVI OS], R: for Booster Pack, RAM: for RAM files
  75. (the RAM: can be omitted in this case), and CAS: for cassette files.  The
  76. extension can be omitted, but if given, MUST be .DO.  Only ascii files
  77. (i.e., those supported by the built-in Basic ROM file code) are supported;
  78. but these files can be extended ascii (8 bit "binary").  But if you want
  79. to send or receive BA or CO files in their binary format, you must have X-
  80. TEL -- the only Model 100 software I know of that deals with all file
  81. types for upload and download.
  82.  
  83. 4.  Usage and Operating Notes
  84.     -------------------------
  85.  
  86. Note that the Tandy 200 version of this program will overwrite files if
  87. download is to an existing file; backup or rename as required.  The 100/102
  88. now prompts before overwrite of a RAM file, but will overwrite external
  89. device files.
  90.  
  91. If you start a download to RAM, and do not have enough memory, the program
  92. will exit to TERM in the middle of the file transfer, and you will get
  93. some garbage on the screen.  When you next get a CIS prompt, use SHIFT-F6
  94. to go to BAsic and then Kill enough files to get the space you need; or
  95. download to a device file.  The handling of OM (out-of-memory) errors
  96. needs a bit of work to make it a bit cleaner; perhaps in a later version
  97. or update of this version.
  98.  
  99. Model 100/102 version (only): You can do a checksum of a RAM or device file
  100. while on line.  SHIFT-F2 accesses this code.  This will feel slow, compared
  101. to other M/L checksummers (e.g., QKRCHK) due to use of BAsic file access
  102. code;  But it is fast enough.
  103.  
  104. XMDPW6.CO for the 200 (only) has the following small bug:  You cannot set
  105. the dialing mode to 10 or 20 pps from within the program.  Go to Telcom to
  106. change STAT.
  107.  
  108. In order to conveniently return from Basic to Term when using the DIRACC
  109. Basic access function, define Basic key 6 as:
  110.  
  111.     Key 6, "Term"+chr$(24)+callxxxxx"+chr$(13), where xxxxx = TOP+27.
  112.  
  113. If you use the auxiliary program XMDHZ6.100 for autodial/redial with a
  114. Hayes-compatible modem (e.g., WorldPort), the above function key
  115. definition is performed when you run XMDHZ6.  Note that XMDHZ6 will require
  116. customizing for your loading addresses -- and that XMDHZ6.100 will not work
  117. on the 200, just the 100 and 102.
  118.  
  119. 5.  Hardware Notes
  120.     --------------
  121.  
  122. I have little of the hardware which this program supports (no Tandy 200,
  123. DVI, Chipmunk or Booster Pak).  These early reports are from Denny Thomas,
  124. Mo Budlong and Eiji Miura.
  125.  
  126.    o Model 100 -- Tested with RAM:, CAS:, Chipmunk and Booster Pak (internal
  127.                   or external modem).  And Mo Budlong has verified that
  128.                   XMDPW6 funtions with the new Gold Card.
  129.  
  130.    o Tandy 200 -- Works with RAM: and CAS:.  Works with Chipmunk and
  131.                   external modem; does not work with Chipmunk and internal
  132.                   modem (no theory as to why this is).
  133.  
  134. Please report any experiences you have with XMDPW6.
  135.  
  136. Phil Wheeler -- 71266,125
  137. Torrance, CA -- 7/18/88
  138.