home *** CD-ROM | disk | FTP | other *** search
- ; M7JC-2.ASM Apple/J-Cat overlay file for MDM727. 03/10/84
- ;+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
- ;
- ; This file is a patch of M7AP-1.ASM overlay designed to
- ; allow auto-dialing through a Novation J-Cat modem.
- ;
- ; The equates and patches in this file are set up for the combination
- ; of an Apple Super Serial Card in slot 2, with a Novation J-Cat modem.
- ; The J-cat is 300-baud only, so I have eliminated the routine for
- ; changing baud rate that was in the original.
- ;
- ; In order to dial with the J-Cat, the modem's OHK line (pin 7 on the
- ; modem's card-edge connector; blue unconnected line in the DB25
- ; connector provided with the modem) must be connected to the Apple's
- ; AN(1) annunciator (pin 14 on the game I/O socket). {Actually, it
- ; could be connected to one of the other annunciator ports, if the
- ; "onhook" and "offhook" equates below are changed to refer to that
- ; annunciator.}
- ; -- David W. Walker 71076,411
- ;++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
- ;
- ; This overlay file enables Apple II computers with the Apple Super
- ; Serial card and external modem to use the MDM727 phone modem program.
- ; It also supports the following Apple modem configurations:
- ;
- ; a) CCS 7710 serial interface and external modem
- ; b) SSM serial interface and external modem
- ; c) Apple communications interface and external modem
- ;
- ; You will want to look this file over carefully. There are a number of
- ; options that you can use to configure the program to suit your taste.
- ; Much of the information contained here is not in the MDM727.ASM file.
- ;
- ; Edit this file for your preferences then follow the "TO USE:" example.
- ;
- ; TO USE: First edit this file filling in answers for your own
- ; equipment. Then assemble with ASM.COM or equivalent
- ; assembler. Then use DDT to overlay the the results
- ; of this program to the original .COM file:
- ;
- ; A>DDT MDM727.COM
- ; DDT VERS 2.2
- ; NEXT PC
- ; 4900 0100
- ; -IM7JC-1.HEX (note the "I" command)
- ; -R ("R" loads in the .HEX file)
- ; NEXT PC
- ; 4900 0000
- ; -G0 (return to CP/M)
- ; A>SAVE 73 MDM727.COM (now have a modified .COM file)
- ;
- ; = = = = = = = = = = = = = = = = = =
- ;
- ; 03/10/84 - Addresses for MDM727 - D. W. Walker
- ; 02/19/84 - Addresses for MDM724 - D. W. Walker
- ; 10/04/83 - J-Cat dialing routines added - D. W. Walker
- ; 07/27/83 - Renamed to work with MDM712 - Irv Hoff
- ; 07/01/83 - Revised to work with MDM711 - Irv Hoff
- ; 06/22/83 - Revised to work with MDM710 - Irv Hoff
- ; 05/27/83 - Updated to work with MDM709 - Irv Hoff
- ; 05/15/83 - Revised to work with MDM708 - Irv Hoff
- ; 04/11/83 - Updated to work with MDM707 - Irv Hoff
- ; 04/04/83 - Updated to work with MDM706 - Irv Hoff
- ; 02/27/83 - Updated to work with MDM705 - Irv Hoff
- ; 02/12/83 - Used MDM703CF to make this file
- ; for Apple computers using a var-
- ; iety of serial interface cards
- ; with external modem. - Bruce Kargol
- ;
- ; = = = = = = = = = = = = = = = = =
- ;
- BELL: EQU 07H ;bell
- CR: EQU 0DH ;carriage return
- ESC: EQU 1BH ;escape
- LF: EQU 0AH ;linefeed
- ;
- YES: EQU 0FFH
- NO: EQU 0
- ;
- ;
- CCS: EQU NO ;YES for CCS 7710
- COMCARD: EQU NO ;YES for Apple comcard
- SSC: EQU YES ;YES for Super Serial Card
- SSM: EQU NO ;YES for SSM serial card
- ;
- IF CCS
- MODDATP: EQU 0E0A1H ;data port of CCS 7710
- MODCTL1: EQU 0E0A0H ;status port of CCS 7710
- ENDIF ;endif CCS
- ;
- IF COMCARD
- MODDATP: EQU 0E0AFH ;data port of Comcard
- MODCTL1: EQU 0E0AEH ;status port of Comcard
- ENDIF ;endif Comcard
- ;
- IF SSM
- MODDATP: EQU 0E0A5H ;data port of SSM
- MODCTL1: EQU 0E0A4H ;status port of SSM
- ENDIF ;endif SSM
- ;
- IF SSC
- MODDATP: EQU 0E0A8H ;data port of Apple Super Serial Card
- MODCTL1: EQU 0E0A9H ;modem status port of Super Serial Card
- COMMAND: EQU 0E0AAH ;SSC command register
- MODBDP: EQU 0E0ABH ;SSC ACIA control register
- ;
- MODRCVB: EQU 08H ;bit to test for received data
- MODRCVR: EQU 08H ;modem receive ready
- MODSNDB: EQU 10H ;bit to test for ready to send
- MODSNDR: EQU 10H ;modem send ready bit
- DTR EQU 0BH ;dtr,xmit on(rts low),irq disabled
- ENDIF ;endif SSC
- ;
- ;
- ; Apple status bit equates for CCS, Comcard and SSM
- ;
- IF NOT SSC
- MODSNDB: EQU 02H ;bit to test for send
- MODSNDR: EQU 02H ;value when ready
- MODRCVB: EQU 01H ;bit to test for receive
- MODRCVR: EQU 01H ;value when ready
- ENDIF ;not SSC
- ;
- ; Equates for routines in the body of MDM727.COM, needed to make
- ; the J-Cat auto-dialing routines work with the PMMI routines in
- ; MDM727:
- ;
- ;
- DIAL15: EQU 05DFH
- DIALAGN: EQU 05FBH
- CONMADE: EQU 06A9H
- DIALA2: EQU 0725H
- DIALBGN: EQU 07A9H
- DISCONNT: EQU 0820H
- WAIT: EQU 09BEH
- FNKCHR: EQU 12C9H
- RESTART: EQU 141FH
- INITADR: EQU 1484H
- RETURN: EQU 196EH
- GOLIST: EQU 2033H
- BREAK: EQU 2098H
- TYPE: EQU 2B71H
- ;
- ; Values for Novation J-Cat using Ann(1) as offhook line
- ;
- ONHOOK EQU 0E05AH
- OFFHOOK EQU 0E05BH
- ;
- ;
- ORG 100H
- ;
- ;
- ; Change the clock speed to match your equipment
- ;
- DS 3 ;(for "JMP START" instruction)
- ;
- ; J-Cat dialing routines patched over PMMI routines {DWW 10-04-83}
- ; IF J-Cat OHK line is not connected, set both PMMIMODEM and
- ; SMARTMODEM to NO
- ;
- PMMIMODEM: DB YES ;yes=J-Cat auto-dial enabled 103H
- SMARTMODEM: DB NO ;yes=HAYES Smartmodem, no=non-pmmi 104H
- TOUCHPULSE: DB 'T' ;T=touch, P=pulse (Smartmodem-only) 105H
- CLOCK: DB 20 ;clock speed in MHz x10, 25.5 MHz max. 106H
- ;20=2 MHh, 37=3.68 MHz, 40=4 MHz, etc.
- MSPEED: DB 1 ;0=110 1=300 2=450 3=600 4=710 5=1200 107H
- ;6=2400 7=4800 8=9600 9=19200 default
- BYTDLY: DB 5 ;0=0 delay 1=10ms 5=50 ms - 9=90 ms 108H
- ;default time to send character in ter-
- ;minal mode file transfer for slow BBS.
- CRDLY: DB 3 ;0=0 delay 1=100 ms 5=500 ms - 9=900 ms 109H
- ;default time for extra wait after CRLF
- ;in terminal mode file transfer
- NOOFCOL: DB 5 ;number of DIR columns shown 10AH
- SETUPTST: DB NO ;yes=user-added Setup routine 10BH
- SCRNTEST: DB YES ;Cursor control routine 10CH
- ACKNAK: DB YES ;yes=resend a record after any non-ACK 10DH
- ;no=resend a record after a valid NAK
- BAKUPBYTE: DB NO ;yes=change any file same name to .BAK 10EH
- CRCDFLT: DB YES ;yes=default to CRC checking 10FH
- TOGGLECRC: DB YES ;yes=allow toggling of CRC to Checksum 110H
- CONVBKSP: DB NO ;yes=convert backspace to rub 111H
- TOGGLEBK: DB YES ;yes=allow toggling of bksp to rub 112H
- ADDLF: DB NO ;no=no LF after CR to send file in' 113H
- ;terminal mode (added by remote echo)
- TOGGLELF: DB YES ;yes=allow toggling of LF after CR 114H
- TRANLOGON: DB YES ;yes=allow transmission of logon 115H
- ;write logon sequence at location LOGON
- SAVCCP: DB NO ;yes=do not overwrite CCP 116H
- LOCONEXTCHR: DB NO ;yes=local command if EXTCHR precedes 117H
- ;no=external command if EXTCHR precedes
- TOGGLELOC: DB YES ;yes=allow toggling of LOCONEXTCHR 118H
- LSTTST: DB YES ;yes=printer available on printer port 119H
- XOFFTST: DB NO ;yes=checks for XOFF from remote while 11AH
- ;sending a file in terminal mode
- XONWAIT: DB NO ;yes=wait for XON after CR while 11BH
- ;sending a file in terminal mode
- TOGXOFF: DB YES ;yes=allow toggling of XOFF checking 11CH
- IGNORCTL: DB YES ;yes=CTL-chars above ^M not displayed 11DH
- EXTRA1: DB 0 ;for future expansion 11EH
- EXTRA2: DB 0 ;for future expansion 11FH
- BRKCHR: DB '@'-40H ;^@ = Send 300 ms. break tone 120H
- NOCONNCT: DB 'N'-40H ;^N = Disconnect from the phone line 121H
- LOGCHR: DB 'L'-40H ;^L = Send logon 122H
- LSTCHR: DB 'P'-40H ;^P = Toggle printer 123H
- UNSAVE: DB 'R'-40H ;^R = Close input text buffer 124H
- TRANCHR: DB 'T'-40H ;^T = Transmit file to remote 125H
- SAVECHR: DB 'Y'-40H ;^Y = Open input text buffer 126H
- EXTCHR: DB '\'-40H ;^\ = Send next character 127H
- DS 2 ; 128H
- ;
- IN$MODCTL1: LDA MODCTL1 ! RET ;in modem control port 12AH
- DS 6
- OUT$MODDATP: STA MODDATP ! RET ;out modem data port 134H
- DS 6
- IN$MODDATP: LDA MODDATP ! RET ;in modem data port 13EH
- DS 6 ;spares if needed
- ;
- ANI$MODRCVB: ANI MODRCVB ! RET ;bit to test for receive ready 148H
- CPI$MODRCVR: CPI MODRCVR ! RET ;value of rcv. bit when ready 14BH
- ANI$MODSNDB: ANI MODSNDB ! RET ;bit to test for send ready 14EH
- CPI$MODSNDR: CPI MODSNDR ! RET ;value of send bit when ready 151H
- DS 12 ;PMMI only calls 154H
- ;
- LOGONPTR: DW LOGON ;for user message. 160H
- DS 6 ; 162H
- JMP$GOODBYE: JMP GOODBYE ; 168H
- JMP$INITMOD: JMP INITMOD ;go to user written routine 16BH
- RET ! NOP ! NOP ;(by-passes PMMI routine) 16EH
- RET ! NOP ! NOP ;(by-passes PMMI routine) 171H
- RET ! NOP ! NOP ;(by-passes PMMI routine) 174H
- JMP$SETUPR: JMP SETUPR ; 177H
- JMP$SPCLMENU: JMP SPCLMENU ; 17AH
- JMP$SYSVER: JMP SYSVER ; 17DH
- JMP$BREAK: JMP SENDBRK ; 180H
- ;
- ;
- ; Do not change the following six lines.
- ;
- JMP$ILPRT: DS 3 ; 183H
- JMP$INBUF DS 3 ; 186H
- JMP$INLNCOMP: DS 3 ; 189H
- JMP$INMODEM DS 3 ; 18CH
- JMP$NXTSCRN: DS 3 ; 18FH
- JMP$TIMER: DS 3 ; 192H
- ;
- ;
- CLREOS: CALL JMP$ILPRT ; 195H
- EOSCLR: DB esc,'Y',0,0,0 ; 198H
- RET ; 19DH
- ;
- CLRSCRN: CALL JMP$ILPRT ; 19EH
- DB esc,'*',0,0,0 ; 1A1H
- RET ; 1A6H
- ;
- SYSVER: CALL JMP$ILPRT ; 1A7H
- DB 'Version for Apple II with J-Cat modem'
- DB CR,LF,0
- RET
- ;.....
- ;
- ;
- ; NOTE: You can change the SYSVER message to be longer or shorter. The
- ; end of your last routine should terminate by 0400H (601 bytes
- ; available after start of SYSVER) if using the Hayes Smartmodem
- ; or by address 0C00H (2659 bytes) otherwise.
- ;
- ;
- ; You can put in a message at this location which can be called up with
- ; CTL-O if TRANLOGON has been set TRUE. You can put in several lines if
- ; desired. End with a 0.
- ;
- ;
- LOGON: DB 'Logon message here',0
- ;
- ; The following is used to initialize the Apple SSC on execution of the
- ; program.
- ;
- INITMOD: mvi a,1 ;default transfer time to 300
- sta mspeed
- mvi a,DTR
- sta COMMAND
- lda MODBDP ;current baudrate from moddll
- ani 0f0h ;zero the last 4 bits
- ;
- initmod1: ori 06h ;get default baudrate (300)
- ani 9fh ;set 8 data bits
- ani 7fh ;set 1 stop bit
- sta MODBDP ;store default baudrate
- ret
- ;.....
- ;
- SETUPR: jmp initmod
- ;
- ; J-Cat is 300 baud only -- no need to change
- ;
- ;.....
- ;
- ; send break through SSC -- 233 msec space
- ;
- SENDBRK:
- lda COMMAND
- push psw ; save register content
- ori 0ch ; set bits 2,3
- sta COMMAND ; break line
- push b
- lxi b,233 ; wait 233 msec
- call delay
- pop b
- pop psw ; get original register
- sta COMMAND ; restore it
- ret
- ;
- GOODBYE:
- sta ONHOOK
- push b
- lxi b,25 ;on hook for 25 msec
- call delay
- pop b
- sta OFFHOOK
- push b
- lxi b,20 ;off hook for 20 msec
- call delay
- pop b
- sta ONHOOK ;final disconnect
- RET
- ;
- ; wait for the number of millisecs in B,C
-
- delay: push d ;save d,e
- inr b ;bump b for later dcr
- ;
- delay1 mvi e,126 ;delay count for 1 millisec (Apple Z80 clock=2.041mhz)
-
- delay2 dcr e ;count
- jnz delay2 ; down
-
- dcr c ;more millisecs?
- jnz delay1 ; yes
- dcr b ;no - more in hi byte?
- jnz delay1 ; yes
- pop d ; no, restore d,e
- ret
- ;
- ;-----------------------------------------------------------------------
- ;
- ; The following routine can be used to display commands on the screen
- ; of interest to users of this equipment.
- ;
- SPCLMENU: RET
- ;
- ;-----------------------------------------------------------------------
- ;
- ;
- ; NOTE: MUST TERMINATE PRIOR TO 0400H (with Smartmodem)
- ; 0C00H (without Smartmodem)
- ;
- ;-----------------------------------------------------------------------
- ;
- ; J-Cat Dialing Routines
- ;
- ; Wait for carrier
- ;
- org DIAL15
-
- mvi d,20h ; mask for carrier detected bit
- mvi c,96h ; limit time waiting for carrier
- call WAIT
- jnc CONMADE
- call hangup
- jmp DIALAGN
-
- ; Dial a digit
-
- org DIALA2+8
-
- pulse: push b
- sta ONHOOK
- lxi b,61 ;pulse
- call delay
- sta OFFHOOK
- lxi b,39 ;delay between pulses
- call delay
- pop b
- dcr c ;any more pulses?
- jnz pulse ;yes, do them
- lxi b,300 ;300-millisec delay between digits
- call delay
- ret
-
- ; Wait 2 seconds for dial tone
-
- org DIALBGN+5
-
- mvi a,dtr
- sta MODCTL1 ; enable modem
- sta offhook ; connect phone
- lxi b,2000
- call delay
- ora a ; clear carry
- ret
-
- ; Hang up phone
-
- org DISCONNT
-
- hangup: jmp goodbye
-
- ; Check for carrier
-
- org WAIT+5
- lda MODCTL1 ;get modem status
-
- ; Patch out PMMI-specific routines, etc.
-
- org RESTART+20H
- cnz SETUPR ; original calls address not used here
-
- org RETURN+23H
- call JMP$INITMOD ; J-Cat needs re-init after dialing
-
- org BREAK
- jmp JMP$BREAK ; don't use PMMI break routine
-
- ; The Microsoft CP/M BIOS implementation always returns FALSE
- ; for the status of the LST: device, so the MDM727 printer output
- ; routine never sends anything to the printer. To repair that, the
- ; simplest patch is to skip over the LST: status test in MDM727.
- ; That requires a printer fast enough to keep up with the screen
- ; output. At 300 baud, that may be feasible:
-
- org GOLIST+4
- nop ; patch out return if LST: not ready
-
- ; Another cure, if your printer card can deliver a status byte, would
- ; be to patch in a status test (returning zero if printer not ready,
- ; non-zero if printer can accept a character) in some unused space
- ; and patch a CALL to that routine at GOLIST. That requires yet another
- ; patch, because the INITADR routine in MDM727 automatically patches a
- ; call to the BIOS LISTST routine at GOLIST. Here's an example, for a
- ; Videx PSIO card (serial port) in slot 1:
-
- org 0D00H ; unused space
- PRNTST: lda 0E099H ; PSIO status port
- ani 10H ; check bit 4
- ret ; carry set = ready
-
- org INITADR+15h
- NOP
- NOP
- NOP
-
- org GOLIST
- call PRNTST
- ora a ; duplicate original code
- rz
-
- END