home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / xmodem / xmhz-1.aqm / XMHZ-1.ASM
Encoding:
Assembly Source File  |  1985-02-10  |  7.8 KB  |  227 lines
  1.  
  2. ; XMHZ-1.ASM - XMODEMxx PATCH FILE FOR HEATH/ZENITH Z100  11/17/83
  3. ;
  4. ; This file adapts XMODEMxx to the HEATH/ZENITH Z100 computers with ex-
  5. ; ternal modem.  To use, first edit any options desired into XMODEMxx.ASM,
  6. ; then assemble (can use ASM.COM) and load to get XMODEMxx.COM.  Then
  7. ; edit this file as needed (check the CONOUT routine if you want to loc-
  8. ; ally see file transfer time and the record count while programs are
  9. ; being sent).  Then assemble (can use ASM.COM) and merge via DDT or SID:
  10. ;
  11. ;    B>DDT XMODEMxx.COM
  12. ;    DDT VERS 2.2
  13. ;    NEXT  PC
  14. ;    1180 0100
  15. ;    -IXMHZ-1.HEX        (note the 'I' command)
  16. ;    -R            ('R' loads in the .HEX file)
  17. ;    NEXT  PC
  18. ;    1180 0000
  19. ;    -G0            (return to CP/M)
  20. ;    B>SAVE 16 XMODEMxx.COM  (now have a modified .COM file)
  21. ;
  22. ; NOTE: Save 21 (rather than 16) if LOGCAL is YES
  23. ;
  24. ;=======================================================================
  25. ;
  26. ; 11/17/83 - Renamed to XMHZ-1.ASM    - Irv Hoff
  27. ; 10/22/83 - Updated to XMODEM77    - Irv Hoff
  28. ; 09/27/83 - Modified for Zenith Z100    - Paul Matlin
  29. ;
  30. ; 03/07/83  Added instructions on how to adapt this file to XMODEM70.COM.
  31. ;        Standardized the format.  Added automatic MSPEED from "BYE"
  32. ;        program.  Added CONOUT information.  Adapted from XM70PMMI.
  33. ;                    - Irv Hoff
  34. ;
  35. ;=======================================================================
  36. ; 
  37. YES:    EQU    0FFH
  38. NO:    EQU    0
  39. ;
  40. ;=======================================================================
  41. ;
  42. ; Values shown are for the 2661-2 serial I/O
  43. ;
  44. MODDATP: EQU    0ECH        ;data in port
  45. MODDATO: EQU    MODDATP        ;data out port
  46. MODCTLP: EQU    MODDATP+1    ;line status register
  47. MODCTL2: EQU    MODDATP+1    ;modem status register
  48. MODSNDB: EQU    01H        ;bit to test for send
  49. MODSNDR: EQU    01H        ;value when ready
  50. MODRCVB: EQU    02        ;bit to tet for receive
  51. MODRCVR: EQU    02        ;value when ready
  52. MODDCDA: EQU    40H        ;value when active
  53. MODDCDB: EQU    40H        ;carrier detect bit
  54. MODPARE: EQU    08H        ;value for parity error
  55. MODOVRE: EQU    10H        ;value for overrun error
  56. MODFRME: EQU    20H        ;value for framing error
  57. ;
  58.  
  59. LSPEED:    EQU    YES        ;yes if using 'BYE' with speed selection
  60.                 ;no if using 'SPEED' manual selection
  61. MSPEED:    EQU    3CH        ;location of baud rate factor (set by
  62.                 ;'BYE')  set location in 'BYE' to agree.
  63.                 ;3dh and 3eh often used by newer ver-
  64.                 ;sions of 'ZCPR'.
  65. XSPEED:    EQU    1        ;speed for file time transfer without
  66.                 ;auto-set.  use one of the following:
  67.                 ;0=110 1=300 2=450 3=600 4=710 5=1200
  68. BASE:    EQU    100H        ;start of cp/m normal program area
  69. ;
  70. ;-------------------------------------------------------------------
  71. ;
  72. ; Jump table: The jump table must be in exactly the same sequence as the
  73. ; one in XMODEM.  Note the ORG of 103H - This jump table has no jump to
  74. ; 'BEGIN'.
  75.  
  76. ;
  77.      ORG    BASE+3        ;start after 'JMP BEGIN'
  78. ;
  79. ;
  80. ; NOTE:    For the Zenith Z100 the CONOUT address is 0F9FFH
  81. ;
  82. CONOUT:     JMP    0F9FFH        ;must be 00000h if not used, see below
  83. PMINIT:     JMP    MINIT        ;initialization routine (if needed)
  84. PUNINIT: JMP    UNINIT        ;undo whatever 'MINIT' did (or return)
  85. PSENDR:     JMP    SENDR        ;send character (via pop psw)
  86. PCAROK:     JMP    CAROK        ;test for carrier
  87. PMDIN:     JMP    MDIN        ;receive data byte
  88. PGETCHR: JMP    GETCHR        ;get character from modem
  89. PRCVRDY: JMP    RCVRDY        ;check receive ready
  90. PSNDRDY: JMP    SNDRDY        ;check send ready
  91. PSPEED:     JMP    SPEED        ;get speed value for file transfer time
  92. PEXTRA1: JMP    EXTRA1        ;extra for custom routine
  93. PEXTRA2: JMP    EXTRA2        ;extra for custom routine
  94. PEXTRA3: JMP    EXTRA3        ;extra for custom routine
  95. ;
  96. ;=======================================================================
  97. ;
  98. ; -- To Display the Record Count on the CRT During Program Transfers --
  99. ;    
  100. ;    This one addition requires some work on the part of the user.
  101. ; When "BYE" is added, CP/M is normally moved lower to accomodate the
  102. ; new program above CP/M.  Whenever BYE is called to enable the RCPM
  103. ; capability, it steals some of the addresses contained in the BIOS jump
  104. ; vector table.  In order to display on the CRT during program transfers
  105. ; you need to get into the BIOS console output routine directly, else
  106. ; what is being displayed also tries to go out the modem.  This is a big
  107. ; NO-NO at that time.  (This cannot be done automatically by XMODEM,
  108. ; since BYE has already taken the address we need to find, by the time
  109. ; XMODEM is automatically activated by the remote station.)
  110. ;
  111. ;    So with the disk containing BYE, but prior to activating BYE, do
  112. ; this:
  113. ;        1) Cold reboot to move CP/M (and BIOS) to the new area
  114. ;            needed when BYE is activated on the same disk.
  115. ;        2) Use DDT and dump the area from 0000H to 0002H.  This
  116. ;                   gives the warm reboot address in BIOS.
  117. ;        3) Add 9 Bytes to that address to get your console out-
  118. ;             put jump vector.
  119. ;        4) Pick off the address contained in the jump vector and
  120. ;             install that in "CONOUT", below.  Example of one
  121. ;             system in use:
  122. ;
  123. ;            FIRST, COLD REBOOT WITH DISK CONTAINING "BYE"
  124. ;
  125. ;      0000  C3 03 E0    (location of warm reboot on disk with BYE
  126. ;
  127. ;            PRIOR TO ACTIVATING BYE BUT ON SAME DISK
  128. ;
  129. ;      E003  C3 E9 E0    (BIOS warm reboot jump vector on this disk)
  130. ;      E006  C3 00 E9    (BIOS get console status routine)
  131. ;      E009  C3 B7 E1    (BIOS console input routine)
  132. ;      E00C  C3 D4 E1    (BIOS console output routine)
  133. ;
  134. ;        The address we need is thus E1D4.  Put that below, in
  135. ;        our example it would be:    CONOUT   JMP   0E1D4H
  136. ;
  137. ;
  138. ;    CONOUT:      JMP    00000H    ;If you wish to show the record count
  139. ;                ;during program transfer, fill in this
  140. ;                ;address at 'CONOUT' above.
  141. ;
  142. ;                    - Irv Hoff
  143. ;
  144. ;=======================================================================
  145. ;
  146. ; ---> CAROK - check for presence of carrier.  RET with Z = carrier on
  147. ;
  148. CAROK:    IN    MODCTL2        ;read modem status
  149.     ANI    MODDCDB        ;get carrier detect bit
  150.     CPI    MODDCDA        ;test bit
  151.     RET
  152. ;
  153. ;=======================================================================
  154. ;
  155. EXTRA1:    RET            ;for later use
  156. EXTRA2:    RET            ;for later use
  157. EXTRA3:    RET            ;for later use
  158. ;
  159. ;=======================================================================
  160. ;
  161. ; ---> GETCHR - get a character, same as MDIN
  162. ; ---> MDIN - - get a character, same as GETCHR
  163. ;
  164. GETCHR:
  165. MDIN:    IN    MODDATP        ;get character from data in port
  166.     RET
  167. ;
  168. ;=======================================================================
  169. ;
  170. MINIT:    RET            ;no initialization required
  171. ;
  172. ;=======================================================================
  173. ;
  174. ; ---> RCVRDY - check receive ready.  RET with Z = character available.
  175. ;            Return with error code in A-reg.
  176. ;
  177. RCVRDY:    IN    MODCTLP        ;get modem status
  178.     PUSH    B        ;save scratch register
  179.     PUSH    PSW        ;check error status
  180.     ANI    MODFRME+MODOVRE+MODPARE
  181.     MOV    B,A        ;save it for a moment
  182.     POP    PSW
  183.     ANI    MODRCVB        ;isolate ready bit
  184.     CPI    MODRCVR        ;test it
  185.     MOV    A,B        ;get the error code char. back
  186.     POP    B
  187.     RET
  188. ;
  189. ;=======================================================================
  190. ;
  191. ; ---> SENDR - send character
  192. ;
  193. SENDR:    POP    PSW        ;get the character back
  194.     OUT    MODDATO        ;send it to the modem output
  195.     RET
  196. ;
  197. ;=======================================================================
  198. ;
  199. ; ---> SNDRDY - check if ready to send.
  200. ;
  201. SNDRDY:    IN    MODCTLP        ;get status byte
  202.     ANI    MODSNDB        ;isolate ready bit
  203.     CPI    MODSNDR        ;ready to send?
  204.     RET
  205. ;
  206. ;=======================================================================
  207. ;
  208. ; ---> SPEED - sets the time shown for program transfer.
  209. ;
  210. SPEED:     IF    LSPEED
  211.     LDA    MSPEED        ;get index for baud rate from 'BYE'
  212.      ENDIF
  213. ;
  214.      IF     NOT LSPEED
  215.     MVI    A,XSPEED    ;get index for baud rate from 'XSPEED'
  216.      ENDIF
  217. ;
  218.     RET
  219. ;
  220. ;=======================================================================
  221. ;
  222. UNINIT:    RET            ;not initialized, so no 'UN-INITIALIZE'
  223. ;
  224. ;=======================================================================
  225. ;
  226. ;
  227.