home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / MODEMS / XMODEM / XMPM-1.AQM / XMPM-1.ASM
Assembly Source File  |  2000-06-30  |  9KB  |  250 lines
  1.  
  2. ; XMPM-1.ASM - XMODEMxx PATCH FILE FOR PMMI MODEM  11/17/83
  3. ;
  4. ; This file adapts XMODEMxx to the PMMI modem.  To use, first edit any
  5. ; options desired into XMODEMxx.ASM, then assemble (can use ASM.COM) and
  6. ; load to get XMODEMxx.COM.  Then edit this file as needed (check the
  7. ; CONOUT routine if you want to locally see file transfer time and the
  8. ; record count while programs are being sent).  Then assemble (can use
  9. ; 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. ;    -IXMPM-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 XMPM-1.ASM    - Irv Hoff
  27. ; 10/22/83 - Updated to XMODEM77    - Irv Hoff
  28. ; 04/04/83 - Updated to XMODEM74    - Irv Hoff
  29. ; 03/27/83 - Updated to XMODEM73    - Irv Hoff
  30. ; 03/17/83 - Updated to XMODEM72    - Irv Hoff
  31. ; 03/15/83 - Updated to XMODEM71    - Irv Hoff
  32. ;
  33. ; 03/07/83  Added instructions on how to adapt this file to XMODEM70.COM.
  34. ;        Standardized the format.  Added automatic MSPEED from "BYE"
  35. ;        program.  Added CONOUT information.
  36. ;                    - Irv Hoff
  37. ;
  38. ; 02/11/83  Written by            - Sigi Kluger
  39. ;
  40. ;=======================================================================
  41. ; 
  42. YES:    EQU    0FFH
  43. NO:    EQU    0
  44. ;
  45. ;=======================================================================
  46. ;
  47. MODCTLP: EQU    0C0H        ;first control/status port
  48. MODCTL2: EQU    MODCTLP+3    ;second control/status port
  49. MODDATP: EQU    MODCTLP+1    ;data in port
  50. MODDATO: EQU    MODCTLP+1    ;data out port
  51. BAUDRP:  EQU    MODCTLP+2    ;baud rate output/modem status
  52. MODSNDB: EQU    1        ;bit to test for send
  53. MODSNDR: EQU    1        ;value when ready
  54. MODRCVB: EQU    2        ;bit to test for receive
  55. MODRCVR: EQU    2        ;value when ready
  56. MODDCDB: EQU    4        ;carrier detect bit
  57. MODDCDA: EQU    0        ;value when active
  58. MODPARE: EQU    08H        ;value for parity error
  59. MODOVRE: EQU    10H        ;value for overrun error
  60. MODFRME: EQU    20H        ;value for framing error
  61. ;
  62.  
  63. LSPEED:    EQU    YES        ;yes if using 'BYE' with speed selection
  64.                 ;no if using 'SPEED' manual selection
  65. MSPEED:    EQU    3CH        ;location of baud rate factor (set by
  66.                 ;'BYE')  set location in 'BYE' to agree.
  67.                 ;3dh and 3eh often used by newer ver-
  68.                 ;sions of 'ZCPR'.
  69. XSPEED:    EQU    1        ;speed for file time transfer without
  70.                 ;auto-set.  use one of the following:
  71.                 ;0=110 1=300 2=450 3=600 4=710 5=1200
  72. BASE:    EQU    100H        ;start of cp/m normal program area
  73. ;
  74. ;-------------------------------------------------------------------
  75. ;
  76. ; Jump table: The jump table must be in exactly the same sequence as the
  77. ; one in XMODEM.
  78. ;
  79. ;
  80.      ORG    BASE+3        ;start after 'JMP BEGIN'
  81. ;
  82. ;
  83. CONOUT:     JMP    00000H        ;must be 00000h if not used, see below
  84.                 ;(may be changed to  jmp  crtout, if
  85.                 ;routine below is used)
  86. PMINIT:     JMP    MINIT        ;initialization routine (if needed)
  87. PUNINIT: JMP    UNINIT        ;undo whatever 'MINIT' did (or return)
  88. PSENDR:     JMP    SENDR        ;send character (via pop psw)
  89. PCAROK:     JMP    CAROK        ;test for carrier
  90. PMDIN:     JMP    MDIN        ;receive data byte
  91. PGETCHR: JMP    GETCHR        ;get character from modem
  92. PRCVRDY: JMP    RCVRDY        ;check receive ready
  93. PSNDRDY: JMP    SNDRDY        ;check send ready
  94. PSPEED:     JMP    SPEED        ;get speed value for file transfer time
  95. PEXTRA1: JMP    EXTRA1        ;extra for custom routine
  96. PEXTRA2: JMP    EXTRA2        ;extra for custom routine
  97. PEXTRA3: JMP    EXTRA3        ;extra for custom routine
  98. ;
  99. ;=======================================================================
  100. ;
  101. ; -- To Display the Record Count on the CRT During Program Transfers --
  102. ;
  103. ;    The CRTOUT routine below may be used if you know the ports used
  104. ; by your CRT for status and data.  (Cannot be used with memory mapped
  105. ; displays.)  If using the CRTOUT routine, skip rest of this discussion.
  106. ;
  107. ;    This one addition requires some work on the part of the user.
  108. ; When "BYE" is added, CP/M is normally moved lower to accomodate the
  109. ; new program above CP/M.  Whenever BYE is called to enable the RCPM
  110. ; capability, it steals some of the addresses contained in the BIOS jump
  111. ; vector table.  In order to display on the CRT during program transfers
  112. ; you need to get into the BIOS console output routine directly, else
  113. ; what is being displayed also tries to go out the modem.  This is a big
  114. ; NO-NO at that time.  (This cannot be done automatically by XMODEM,
  115. ; since BYE has already taken the address we need to find, by the time
  116. ; XMODEM is automatically activated by the remote station.)
  117. ;
  118. ;    So with the disk containing BYE, but prior to activating BYE, do
  119. ; this:
  120. ;        1) Cold reboot to move CP/M (and BIOS) to the new area
  121. ;            needed when BYE is activated on the same disk.
  122. ;        2) Use DDT and dump the area from 0000H to 0002H.  This
  123. ;                   gives the warm reboot address in BIOS.
  124. ;        3) Add 9 Bytes to that address to get your console out-
  125. ;             put jump vector.
  126. ;        4) Pick off the address contained in the jump vector and
  127. ;             install that in "CONOUT", below.  Example of one
  128. ;             system in use:
  129. ;
  130. ;            FIRST, COLD REBOOT WITH DISK CONTAINING "BYE"
  131. ;
  132. ;      0000  C3 03 E0    (location of warm reboot on disk with BYE
  133. ;
  134. ;            PRIOR TO ACTIVATING BYE BUT ON SAME DISK
  135. ;
  136. ;      E003  C3 E9 E0    (BIOS warm reboot jump vector on this disk)
  137. ;      E006  C3 00 E9    (BIOS get console status routine)
  138. ;      E009  C3 B7 E1    (BIOS console input routine)
  139. ;      E00C  C3 D4 E1    (BIOS console output routine)
  140. ;
  141. ;        The address we need is thus E1D4.  Put that below, in
  142. ;        our example it would be:    CONOUT   JMP   0E1D4H
  143. ;
  144. ;
  145. ;    CONOUT:      JMP    00000H    ;If you wish to show the record count
  146. ;                ;during program transfer, fill in this
  147. ;                ;address at 'CONOUT' above.
  148. ;
  149. ;                    - Irv Hoff
  150. ;
  151. ;=======================================================================
  152. ;
  153. ; ---> CAROK - check for presence of carrier.  RET with Z = carrier on
  154. ;
  155. CAROK:    IN    BAUDRP        ;get status
  156.     ANI    MODDCDB        ;get carrier detect bit
  157.     CPI    MODDCDA        ;test bit
  158.     RET
  159. ;
  160. ;=======================================================================
  161. ;
  162. ; ---> CRTOUT - allows direct output to the CRT, in place of the CONOUT
  163. ;        address.  Do not use with memory mapped displays.  Change
  164. ;        the above to  CONOUT  JMP  CTROUT then change the follow-
  165. ;        ing if your ports are different -- your port may not be
  166. ;        the same and your 'ready bit' to check may be different.
  167. ;
  168. CRTOUT:    IN    20H        ;console status port
  169.     ANI    04H        ;see if ready to send another char.
  170.     JZ    CRTOUT        ;loop until ready
  171.     MOV    A,C        ;get the character
  172.     OUT    21H        ;output to console data port
  173.     RET
  174. ;
  175. ;=======================================================================
  176. ;
  177. EXTRA1:    RET            ;for later use
  178. EXTRA2:    RET            ;for later use
  179. EXTRA3:    RET            ;for later use
  180. ;
  181. ;=======================================================================
  182. ;
  183. ; ---> GETCHR - get a character, same as MDIN
  184. ; ---> MDIN - - get a character, same as GETCHR
  185. ;
  186. GETCHR:
  187. MDIN:    IN    MODDATP        ;get character from data in port
  188.     RET
  189. ;
  190. ;=======================================================================
  191. ;
  192. MINIT:    RET            ;no initialization required
  193. ;
  194. ;=======================================================================
  195. ;
  196. ; ---> RCVRDY - check receive ready.  RET with Z = character available.
  197. ;            Return with error code in A-reg.
  198. ;
  199. RCVRDY:    IN    MODCTLP        ;get modem status
  200.     PUSH    B        ;save scratch register
  201.     PUSH    PSW        ;check error status
  202.     ANI    MODFRME+MODOVRE+MODPARE
  203.     MOV    B,A        ;save it for a moment
  204.     POP    PSW
  205.     ANI    MODRCVB        ;isolate ready bit
  206.     CPI    MODRCVR        ;test it
  207.     MOV    A,B        ;get the error code char. back
  208.     POP    B
  209.     RET
  210. ;
  211. ;=======================================================================
  212. ;
  213. ; ---> SENDR - send character.  (Comes here via a "JZ SENDR" so no prob-
  214. ;              lem with the stack because of the "POP PSW".
  215. ;
  216. SENDR:    POP    PSW        ;get the character back
  217.     OUT    MODDATO        ;send it to the modem output
  218.     RET
  219. ;
  220. ;=======================================================================
  221. ;
  222. ; ---> SNDRDY - check if ready to send.
  223. ;
  224. SNDRDY:    IN    MODCTLP        ;get status byte
  225.     ANI    MODSNDB        ;isolate ready bit
  226.     CPI    MODSNDR        ;ready to send?
  227.     RET
  228. ;
  229. ;=======================================================================
  230. ;
  231. ; ---> SPEED - sets the time shown for program transfer.
  232. ;
  233. SPEED:     IF    LSPEED
  234.     LDA    MSPEED        ;get index for baud rate from 'BYE'
  235.      ENDIF
  236. ;
  237.      IF     NOT LSPEED
  238.     MVI    A,XSPEED    ;get index for baud rate from 'XSPEED'
  239.      ENDIF
  240. ;
  241.     RET
  242. ;
  243. ;=======================================================================
  244. ;
  245. UNINIT:    RET            ;not initialized, so no 'UN-INITIALIZE'
  246. ;
  247. ;=======================================================================
  248. ;
  249. ;
  250.     END