[z180-stamp-cpm3.git] / cbios / sdio.180

	TITLE 'sd disk handler'\r
\r
;    CP/M-80 Version 3     --  Modular BIOS\r
\r
\r
    ; Disk drive dispatching tables for linked BIOS\r
\r
	public sd0,sd1,sd2,sd3\r
	public sd4,sd5,sd6,sd7\r
\r
    ; Variables containing parameters passed by BDOS\r
\r
	extrn @xdph\r
	extrn @adrv,@rdrv\r
	extrn @trk,@sect,@cnt\r
	extrn @dma,@dbnk\r
\r
    ; System Control Block variables\r
\r
	extrn @ermde		; BDOS error mode\r
\r
    ; Utility routines in standard BIOS\r
\r
	extrn ?wboot		; warm boot vector\r
	extrn ?pmsg,pr.inln	; print message @<HL>, print inline message\r
	extrn pr.crlf		; print <cr><lf>\r
	extrn ?pderr		; print BIOS disk error header\r
	extrn ?conin,?cono	; con in and out\r
	extrn ?const		; get console status\r
\r
	extrn bnk2phy		;\r
	extrn msg.sm		;\r
	extrn msg.recv		;\r
	extrn add_hla\r
\r
\r
    ; Port Address Equates\r
\r
	include config.inc\r
	include z180reg.inc\r
\r
    ; CP/M 3 Disk definition macros\r
\r
	include cpm3slr.lib\r
\r
    ; Z180 macro library instruction definitions (ignored by slr180)\r
\r
	include z180.lib\r
\r
    ; common control characters\r
\r
cr	equ	13\r
lf	equ	10\r
bell	equ	7\r
\r
\r
	dseg\r
\r
    ; Extended Disk Parameter Headers (XPDHs)\r
\r
	dw	sd$write\r
	dw	sd$read\r
	dw	sd$login\r
	dw	sd$init0\r
	db	0,0		; relative drive zero\r
sd0:	dph 0,dpbsimhd512\r
\r
	dw	sd$write\r
	dw	sd$read\r
	dw	sd$login\r
	dw	sd$init1\r
	db	1,0		; relative drive one\r
sd1:	dph 0,dpbsimhd512\r
\r
	dw	sd$write\r
	dw	sd$read\r
	dw	sd$login\r
	dw	sd$init2\r
	db	2,0		; relative drive zero\r
sd2:	dph 0,dpbsimhd512\r
\r
	dw	sd$write\r
	dw	sd$read\r
	dw	sd$login\r
	dw	sd$init3\r
	db	3,0		; relative drive one\r
sd3:	dph 0,dpbsimhd512\r
\r
\r
	dw	sd$write\r
	dw	sd$read\r
	dw	sd$login\r
	dw	sd$init4\r
	db	4,0		; relative drive zero\r
sd4:	dph 0,dpbsimhd512\r
\r
	dw	sd$write\r
	dw	sd$read\r
	dw	sd$login\r
	dw	sd$init5\r
	db	5,0		; relative drive one\r
sd5:	dph 0,dpbsimhd512\r
\r
	dw	sd$write\r
	dw	sd$read\r
	dw	sd$login\r
	dw	sd$init6\r
	db	6,0		; relative drive zero\r
sd6:	dph 0,dpbsimhd512\r
\r
	dw	sd$write\r
	dw	sd$read\r
	dw	sd$login\r
	dw	sd$init7\r
	db	7,0		; relative drive one\r
sd7:	dph 0,dpbsimhd512\r
\r
\r
	cseg			; DPB must be resident\r
\r
dpbsimhd512:\r
	dpb 512,8,2048,4096,1024,6\r
\r
\r
	dseg			; rest is banked\r
\r
; Disk I/O routines for standardized BIOS interface\r
\r
; Initialization entry point.\r
; called for first time initialization.\r
\r
sd$init0:\r
	call	pr.inln			;\r
	db	'sdio: SD Card driver'cr,lf,0\r
	ret\r
\r
sd$init1:\r
sd$init2:\r
sd$init3:\r
sd$init4:\r
sd$init5:\r
sd$init6:\r
sd$init7:\r
	ret	; all initialization done by drive 0\r
\r
\r
; This entry is called when a logical drive is about to\r
; be logged into for the purpose of density determination.\r
; It may adjust the parameters contained in the disk\r
; parameter header pointed at by <DE>\r
;\r
;     absolute drive number in @adrv (8 bits)	+0\r
;     relative drive number in @rdrv (8 bits)	+1\r
\r
sd$login:\r
	xor	a\r
	ld	(residual),a\r
	ld	hl,send_msg+1\r
	ld	(hl),0		;login function\r
	inc	hl\r
	ld	bc,(@adrv)\r
	ld	(hl),c		;@adrv\r
	inc	hl\r
	ld	(hl),b		;@rdrv\r
	inc	hl\r
\r
	ex	de,hl		;xdph to hl\r
	xor	a		;bank 0\r
	call	bnk2phy		;phys. linear address\r
	ex	de,hl\r
	ld	(hl),e\r
	inc	hl\r
	ld	(hl),d\r
	inc	hl\r
	ld	(hl),a\r
\r
	ld	hl,send_msg\r
	ld	b,send_msg_login_len\r
	call	msg.sm\r
\r
	ld	hl,recv_msg\r
	ld	b,recv_msg_len	; max receive message len\r
	call	msg.recv\r
\r
	ld	a,(recv_msg_rc)\r
	or	a\r
	ret	z\r
	ld	hl,0\r
	ld	(@xdph),hl\r
	ret			;\r
\r
\r
\r
; disk READ and WRITE entry points.\r
; these entries are called with the following arguments:\r
;\r
;     absolute drive number in @adrv (8 bits)	+0\r
;     relative drive number in @rdrv (8 bits)	+1\r
;     disk track address    in @trk (16 bits)	+2\r
;     disk sector address   in @sect(16 bits)	+4\r
;     multi sector count    in @cnt  (8 bits)	+6\r
;     disk transfer address in @dma (16 bits)	+7\r
;     disk transfer bank    in @dbnk (8 bits)	+9\r
;     pointer to XDPH 	    in <DE>\r
;\r
;     they transfer the appropriate data, perform retries\r
;     if necessary, then return an error code in <A>\r
\r
sd$read:\r
	ld	de,read$msg	; point at " Read "\r
	ld	c,1\r
	jr	rw$common\r
sd$write:\r
	ld	de,write$msg	; point at " Write "\r
	ld	c,2\r
rw$common:\r
\r
	ld	hl,residual	; remainng sectors from last multi io?\r
	ld	a,(hl)\r
	sub	a,1\r
	jr	c,rwc_new_sectors\r
\r
	ld	(hl),a\r
	xor	a\r
	ret\r
\r
rwc_new_sectors:\r
	ld	b,1		; assume 1 sector to transfer\r
	ld	a,(@cnt)\r
	or	a\r
	jr	z,rwc_doit\r
\r
	ld	b,a		; number of sectors to transfer\r
	dec	a		; save remaining\r
	ld	(hl),a\r
	xor	a		; reset multi sector count\r
	ld	(@cnt),a\r
\r
; compute pysical transfer address\r
;     prepare message\r
;     and send it to AVR.\r
\r
rwc_doit:\r
	ld	hl,send_msg+1\r
	ld	(hl),c\r
	inc	hl\r
	ld	a,b\r
	ex	de,hl\r
	ld	(operation$name),hl ; save message for errors\r
	ld	hl,@adrv	;address of arguments\r
	ld	bc,6\r
	ldir\r
	ld	(de),a		;number of sectors\r
	inc	de\r
	push	de\r
	ld	e,(hl)		;dma address\r
	inc	hl\r
	ld	d,(hl)\r
	inc	hl\r
	ld	a,(hl)		;bank\r
	ex	de,hl\r
	call	bnk2phy		;phys. linear address\r
	ex	de,hl\r
	pop	hl\r
	ld	(hl),e\r
	inc	hl\r
	ld	(hl),d\r
	inc	hl\r
	ld	(hl),a\r
\r
retry:\r
\r
	ld	hl,send_msg\r
	ld	b,send_msg_rw_len\r
	call	msg.sm\r
\r
	ld	hl,recv_msg\r
	ld	b,recv_msg_len	; max receive message len\r
	call	msg.recv\r
	ld	a,(recv_msg_rc)\r
	or	a\r
	ret	z		; check status and return to BDOS if no error\r
\r
; suppress error message if BDOS is returning errors to application...\r
\r
	ld	a,(@ermde)\r
	cp	0ffh\r
	jr	z,hard$error\r
\r
	; Had permanent error, print message like:\r
	; BIOS Err on d: T-nn, S-mm, <operation> <type>, Retry ?\r
\r
	call	?pderr		; print message header\r
\r
	ld	hl,(operation$name)\r
	call	?pmsg		; last function (read or write)\r
\r
	ld	a,(recv_msg_rc)\r
	and	a,07fh\r
	jr	z,fatfs_err\r
\r
	ld	hl,drvmsg0	; point at first driver error message\r
	ld	c,drvmsg_count\r
	call	pdecoded\r
\r
fatfs_err:\r
	ld	a,(recv_msg_rc)\r
	tst	080h\r
	jr	z,prompt	; no fatfs error\r
\r
	call	pr.inln\r
	db	'FatFs: ',0\r
\r
	ld	hl,fr$msg0	; point at first FatFs message\r
	ld	c,fr$msg$count\r
	ld	a,(recv_msg_rc+1)\r
	call	pdecoded\r
\r
prompt:\r
	call	pr.inln\r
	db	' Retry (Y/N) ? ',0\r
\r
	call	u$conin$echo	; get operator response\r
	cp	'Y'\r
	jr	z,retry		; Yes, then retry once more\r
\r
hard$error:\r
				; otherwise,\r
	xor	a\r
	ld	(residual),a\r
	ld	a,(recv_msg_rc)	; return hard error to BDOS\r
	ld	c,0ffh\r
	cp	6		; media changed?\r
	jr	z,e_exit\r
	ld	c,2\r
	cp	5		; disk read only?\r
	jr	z,e_exit\r
	dec	c\r
e_exit:\r
	ld	a,c\r
	ret\r
\r
; Print message to error code in A\r
;\r
\r
pdecoded:\r
	push	bc\r
	push	de\r
	push	hl		; put pointer to first message on stack\r
	cp	c\r
	jr	c,pdc_1\r
	xor	a\r
pdc_1:\r
	ld	bc,0\r
	ld	e,a		; save message number\r
	xor	a\r
	inc	e\r
pdc_nxt_str:\r
	dec	e\r
	ex	(sp),hl\r
	jr	z,pdc_found\r
	ex	(sp),hl\r
	cpir\r
	jr	z,pdc_nxt_str\r
				; not found (should not happen)\r
pdc_found:\r
	pop	hl\r
	call	?pmsg\r
	pop	de\r
	pop	bc\r
	ret\r
\r
\r
; get console input, echo it, and shift to upper case\r
\r
u$conin$echo:\r
\r
	call	?const\r
	or	a\r
	jr	z,u$c1		; see if any char already struck\r
	call	?conin\r
	jr	u$conin$echo	; yes, eat it and try again\r
u$c1:\r
	call	?conin\r
	push	af\r
	ld	c,a\r
	cp	' '-1\r
	call	nc,?cono\r
	pop	af\r
	cp	'a'\r
	ret	c\r
	sub	'a'-'A'		; make upper case\r
	ret\r
\r
\r
residual:\r
	db	0\r
\r
send_msg:\r
	db	2	; disk command\r
	ds	1	; subcommand (login/read/write)\r
	ds	1	; @adrv\r
	ds	1	; @rdrv\r
			; -read/write-		-login-\r
	ds	2	; @trk 			xdph address\r
	ds	2	; @sect			  (3 byte)\r
	ds	1	; @cnt\r
	ds	3	; transfer addr\r
send_msg_rw_len equ	$ - send_msg\r
send_msg_login_len equ	7\r
\r
\r
recv_msg:\r
	ds	1	; len\r
	ds	1	; command\r
	ds	1	; subcommand\r
recv_msg_rc:\r
	ds	1	; result code\r
	ds	4	; room for additional parameter\r
recv_msg_len equ $ - recv_msg\r
\r
\r
    ; error message components\r
\r
operation$name:\r
	dw	read$msg\r
read$msg:\r
	db	', Read, ',0\r
write$msg:\r
	db	', Write, ',0\r
\r
    ; general driver errors\r
\r
drvmsg0:	db	'Unknown Error, ',0\r
drvmsg1:	db	'Invalid Parameter(s), ',0\r
drvmsg2:	db	'Invalid Drive, ',0\r
drvmsg3:	db	'Bus Timeout, ',0\r
drvmsg4:	db	'Access beyond disk size, ',0\r
drvmsg5:	db	'Write protected, ',0\r
drvmsg6:	db	'No media, ',0\r
drvmsg_size	equ	$ - drvmsg0\r
drvmsg_count	equ	7\r
\r
    ; fat file system errors\r
\r
fr$msg0:	db	'Unknown Error,',0\r
fr$msg1:	db	'DISK_ERR,',0\r
fr$msg2:	db	'INT_ERR,',0\r
fr$msg3:	db	'NOT_READY,',0\r
fr$msg4:	db	'NO_FILE,',0\r
fr$msg5:	db	'NO_PATH,',0\r
fr$msg6:	db	'INVALID_NAME,',0\r
fr$msg7:	db	'DENIED,',0\r
fr$msg8:	db	'EXIST,',0\r
fr$msg9:	db	'INVALID_OBJECT,',0\r
fr$msg10:	db	'WRITE_PROTECTED,',0\r
fr$msg11:	db	'INVALID_DRIVE,',0\r
fr$msg12:	db	'NOT_ENABLED,',0\r
fr$msg13:	db	'NO_FILE_SYSTEM,',0\r
fr$msg14:	db	'MKFS_ABORTED,',0\r
fr$msg15:	db	'TIMEOUT,',0\r
fr$msg16:	db	'LOCKED,',0\r
fr$msg17:	db	'NOT_ENOUGH_CORE,',0\r
fr$msg18:	db	'TOO_MANY_OPEN_FILES,',0\r
fr$msg19:	db	'FR_INVALID_PARAMETER,',0\r
fr$msg20:	db	'short read/write,',0\r
fr$msg$size	equ	$ - fr$msg0\r
fr$msg$count	equ	21\r
\r
	end\r
Commit	Line	Data
ea5293bb L	1	TITLE 'sd disk handler'\r
	2	\r
	3	; CP/M-80 Version 3 -- Modular BIOS\r
	4	\r
	5	\r
ea5293bb L	6	; Disk drive dispatching tables for linked BIOS\r
	7	\r
	8	public sd0,sd1,sd2,sd3\r
b625464d	9	public sd4,sd5,sd6,sd7\r
ea5293bb L	10	\r
	11	; Variables containing parameters passed by BDOS\r
	12	\r
a28ee78c	13	extrn @xdph\r
ea5293bb	14	extrn @adrv,@rdrv\r
1d26b866 L	15	extrn @trk,@sect,@cnt\r
1d26b866 L	16	extrn @dma,@dbnk\r
ea5293bb L	17	\r
	18	; System Control Block variables\r
	19	\r
	20	extrn @ermde ; BDOS error mode\r
	21	\r
	22	; Utility routines in standard BIOS\r
	23	\r
	24	extrn ?wboot ; warm boot vector\r
d12d8b38 L	25	extrn ?pmsg,pr.inln ; print message @<HL>, print inline message\r
d12d8b38 L	26	extrn pr.crlf ; print <cr><lf>\r
ea5293bb L	27	extrn ?pderr ; print BIOS disk error header\r
	28	extrn ?conin,?cono ; con in and out\r
	29	extrn ?const ; get console status\r
	30	\r
	31	extrn bnk2phy ;\r
	32	extrn msg.sm ;\r
	33	extrn msg.recv ;\r
	34	extrn add_hla\r
	35	\r
	36	\r
	37	; Port Address Equates\r
	38	\r
	39	include config.inc\r
	40	include z180reg.inc\r
	41	\r
	42	; CP/M 3 Disk definition macros\r
	43	\r
	44	include cpm3slr.lib\r
	45	\r
	46	; Z180 macro library instruction definitions (ignored by slr180)\r
	47	\r
	48	include z180.lib\r
	49	\r
	50	; common control characters\r
	51	\r
	52	cr equ 13\r
	53	lf equ 10\r
	54	bell equ 7\r
	55	\r
	56	\r
50f3b8f0 L	57	dseg\r
50f3b8f0 L	58	\r
ea5293bb L	59	; Extended Disk Parameter Headers (XPDHs)\r
	60	\r
	61	dw sd$write\r
	62	dw sd$read\r
	63	dw sd$login\r
	64	dw sd$init0\r
	65	db 0,0 ; relative drive zero\r
	66	sd0: dph 0,dpbsimhd512\r
	67	\r
	68	dw sd$write\r
	69	dw sd$read\r
	70	dw sd$login\r
	71	dw sd$init1\r
	72	db 1,0 ; relative drive one\r
	73	sd1: dph 0,dpbsimhd512\r
	74	\r
	75	dw sd$write\r
	76	dw sd$read\r
	77	dw sd$login\r
d12d8b38	78	dw sd$init2\r
ea5293bb L	79	db 2,0 ; relative drive zero\r
	80	sd2: dph 0,dpbsimhd512\r
	81	\r
	82	dw sd$write\r
	83	dw sd$read\r
	84	dw sd$login\r
d12d8b38	85	dw sd$init3\r
ea5293bb L	86	db 3,0 ; relative drive one\r
	87	sd3: dph 0,dpbsimhd512\r
	88	\r
	89	\r
b625464d L	90	dw sd$write\r
	91	dw sd$read\r
	92	dw sd$login\r
	93	dw sd$init4\r
	94	db 4,0 ; relative drive zero\r
	95	sd4: dph 0,dpbsimhd512\r
	96	\r
	97	dw sd$write\r
	98	dw sd$read\r
	99	dw sd$login\r
	100	dw sd$init5\r
	101	db 5,0 ; relative drive one\r
	102	sd5: dph 0,dpbsimhd512\r
	103	\r
	104	dw sd$write\r
	105	dw sd$read\r
	106	dw sd$login\r
	107	dw sd$init6\r
	108	db 6,0 ; relative drive zero\r
	109	sd6: dph 0,dpbsimhd512\r
	110	\r
	111	dw sd$write\r
	112	dw sd$read\r
	113	dw sd$login\r
	114	dw sd$init7\r
	115	db 7,0 ; relative drive one\r
	116	sd7: dph 0,dpbsimhd512\r
	117	\r
	118	\r
ea5293bb L	119	cseg ; DPB must be resident\r
	120	\r
	121	dpbsimhd512:\r
	122	dpb 512,8,2048,4096,1024,6\r
	123	\r
	124	\r
	125	dseg ; rest is banked\r
	126	\r
	127	; Disk I/O routines for standardized BIOS interface\r
	128	\r
	129	; Initialization entry point.\r
	130	; called for first time initialization.\r
	131	\r
	132	sd$init0:\r
3ba53775 L	133	call pr.inln ;\r
3ba53775 L	134	db 'sdio: SD Card driver'cr,lf,0\r
ea5293bb L	135	ret\r
	136	\r
	137	sd$init1:\r
	138	sd$init2:\r
	139	sd$init3:\r
b625464d L	140	sd$init4:\r
	141	sd$init5:\r
	142	sd$init6:\r
	143	sd$init7:\r
ea5293bb L	144	ret ; all initialization done by drive 0\r
	145	\r
	146	\r
ea5293bb L	147	; This entry is called when a logical drive is about to\r
	148	; be logged into for the purpose of density determination.\r
	149	; It may adjust the parameters contained in the disk\r
	150	; parameter header pointed at by <DE>\r
a28ee78c L	151	;\r
	152	; absolute drive number in @adrv (8 bits) +0\r
	153	; relative drive number in @rdrv (8 bits) +1\r
ea5293bb L	154	\r
ea5293bb L	155	sd$login:\r
1d26b866 L	156	xor a\r
1d26b866 L	157	ld (residual),a\r
ea5293bb L	158	ld hl,send_msg+1\r
	159	ld (hl),0 ;login function\r
	160	inc hl\r
	161	ld bc,(@adrv)\r
	162	ld (hl),c ;@adrv\r
	163	inc hl\r
	164	ld (hl),b ;@rdrv\r
	165	inc hl\r
	166	\r
	167	ex de,hl ;xdph to hl\r
	168	xor a ;bank 0\r
	169	call bnk2phy ;phys. linear address\r
	170	ex de,hl\r
	171	ld (hl),e\r
	172	inc hl\r
	173	ld (hl),d\r
	174	inc hl\r
	175	ld (hl),a\r
	176	\r
	177	ld hl,send_msg\r
	178	ld b,send_msg_login_len\r
	179	call msg.sm\r
	180	\r
	181	ld hl,recv_msg\r
	182	ld b,recv_msg_len ; max receive message len\r
	183	call msg.recv\r
	184	\r
a28ee78c L	185	ld a,(recv_msg_rc)\r
	186	or a\r
	187	ret z\r
	188	ld hl,0\r
	189	ld (@xdph),hl\r
ea5293bb L	190	ret ;\r
	191	\r
	192	\r
	193	\r
	194	; disk READ and WRITE entry points.\r
	195	; these entries are called with the following arguments:\r
	196	;\r
	197	; absolute drive number in @adrv (8 bits) +0\r
	198	; relative drive number in @rdrv (8 bits) +1\r
1d26b866 L	199	; disk track address in @trk (16 bits) +2\r
	200	; disk sector address in @sect(16 bits) +4\r
	201	; multi sector count in @cnt (8 bits) +6\r
ea5293bb L	202	; disk transfer address in @dma (16 bits) +7\r
	203	; disk transfer bank in @dbnk (8 bits) +9\r
	204	; pointer to XDPH in <DE>\r
	205	;\r
	206	; they transfer the appropriate data, perform retries\r
	207	; if necessary, then return an error code in <A>\r
	208	\r
	209	sd$read:\r
1d26b866 L	210	ld de,read$msg ; point at " Read "\r
1d26b866 L	211	ld c,1\r
ea5293bb	212	jr rw$common\r
ea5293bb	213	sd$write:\r
1d26b866 L	214	ld de,write$msg ; point at " Write "\r
	215	ld c,2\r
	216	rw$common:\r
1d26b866	217	\r
3735c546 L	218	ld hl,residual ; remainng sectors from last multi io?\r
	219	ld a,(hl)\r
	220	sub a,1\r
	221	jr c,rwc_new_sectors\r
	222	\r
	223	ld (hl),a\r
	224	xor a\r
	225	ret\r
1d26b866 L	226	\r
	227	rwc_new_sectors:\r
	228	ld b,1 ; assume 1 sector to transfer\r
3735c546 L	229	ld a,(@cnt)\r
	230	or a\r
	231	jr z,rwc_doit\r
	232	\r
	233	ld b,a ; number of sectors to transfer\r
	234	dec a ; save remaining\r
	235	ld (hl),a\r
	236	xor a ; reset multi sector count\r
	237	ld (@cnt),a\r
ea5293bb L	238	\r
	239	; compute pysical transfer address\r
	240	; prepare message\r
	241	; and send it to AVR.\r
	242	\r
1d26b866 L	243	rwc_doit:\r
	244	ld hl,send_msg+1\r
	245	ld (hl),c\r
	246	inc hl\r
	247	ld a,b\r
	248	ex de,hl\r
	249	ld (operation$name),hl ; save message for errors\r
ea5293bb	250	ld hl,@adrv ;address of arguments\r
1d26b866	251	ld bc,6\r
ea5293bb	252	ldir\r
b27f7b99	253	ld (de),a ;number of sectors\r
1d26b866	254	inc de\r
ea5293bb L	255	push de\r
	256	ld e,(hl) ;dma address\r
	257	inc hl\r
	258	ld d,(hl)\r
	259	inc hl\r
	260	ld a,(hl) ;bank\r
	261	ex de,hl\r
	262	call bnk2phy ;phys. linear address\r
	263	ex de,hl\r
	264	pop hl\r
	265	ld (hl),e\r
	266	inc hl\r
	267	ld (hl),d\r
	268	inc hl\r
	269	ld (hl),a\r
	270	\r
04134640	271	retry:\r
ea5293bb L	272	\r
	273	ld hl,send_msg\r
	274	ld b,send_msg_rw_len\r
	275	call msg.sm\r
	276	\r
	277	ld hl,recv_msg\r
	278	ld b,recv_msg_len ; max receive message len\r
	279	call msg.recv\r
	280	ld a,(recv_msg_rc)\r
	281	or a\r
	282	ret z ; check status and return to BDOS if no error\r
	283	\r
	284	; suppress error message if BDOS is returning errors to application...\r
	285	\r
	286	ld a,(@ermde)\r
	287	cp 0ffh\r
	288	jr z,hard$error\r
	289	\r
	290	; Had permanent error, print message like:\r
	291	; BIOS Err on d: T-nn, S-mm, <operation> <type>, Retry ?\r
	292	\r
	293	call ?pderr ; print message header\r
	294	\r
	295	ld hl,(operation$name)\r
	296	call ?pmsg ; last function (read or write)\r
	297	\r
	298	ld a,(recv_msg_rc)\r
04134640 L	299	and a,07fh\r
04134640 L	300	jr z,fatfs_err\r
ea5293bb	301	\r
04134640 L	302	ld hl,drvmsg0 ; point at first driver error message\r
	303	ld c,drvmsg_count\r
	304	call pdecoded\r
ea5293bb	305	\r
04134640	306	fatfs_err:\r
ea5293bb	307	ld a,(recv_msg_rc)\r
1d26b866	308	tst 080h\r
04134640	309	jr z,prompt ; no fatfs error\r
ea5293bb	310	\r
d12d8b38 L	311	call pr.inln\r
d12d8b38 L	312	db 'FatFs: ',0\r
ea5293bb	313	\r
04134640 L	314	ld hl,fr$msg0 ; point at first FatFs message\r
04134640 L	315	ld c,fr$msg$count\r
ea5293bb	316	ld a,(recv_msg_rc+1)\r
04134640	317	call pdecoded\r
ea5293bb	318	\r
04134640	319	prompt:\r
d12d8b38 L	320	call pr.inln\r
	321	db ' Retry (Y/N) ? ',0\r
	322	\r
ea5293bb	323	call u$conin$echo ; get operator response\r
04134640	324	cp 'Y'\r
c6fa1579	325	jr z,retry ; Yes, then retry once more\r
04134640	326	\r
ea5293bb L	327	hard$error:\r
ea5293bb L	328	; otherwise,\r
04134640 L	329	xor a\r
04134640 L	330	ld (residual),a\r
c6fa1579 L	331	ld a,(recv_msg_rc) ; return hard error to BDOS\r
	332	ld c,0ffh\r
	333	cp 6 ; media changed?\r
	334	jr z,e_exit\r
	335	ld c,2\r
	336	cp 5 ; disk read only?\r
	337	jr z,e_exit\r
	338	dec c\r
	339	e_exit:\r
	340	ld a,c\r
04134640	341	ret\r
ea5293bb	342	\r
04134640 L	343	; Print message to error code in A\r
	344	;\r
	345	\r
	346	pdecoded:\r
	347	push bc\r
	348	push de\r
	349	push hl ; put pointer to first message on stack\r
	350	cp c\r
	351	jr c,pdc_1\r
	352	xor a\r
	353	pdc_1:\r
	354	ld bc,0\r
	355	ld e,a ; save message number\r
	356	xor a\r
	357	inc e\r
	358	pdc_nxt_str:\r
	359	dec e\r
	360	ex (sp),hl\r
	361	jr z,pdc_found\r
	362	ex (sp),hl\r
	363	cpir\r
	364	jr z,pdc_nxt_str\r
	365	; not found (should not happen)\r
	366	pdc_found:\r
	367	pop hl\r
	368	call ?pmsg\r
	369	pop de\r
	370	pop bc\r
	371	ret\r
	372	\r
	373	\r
	374	; get console input, echo it, and shift to upper case\r
	375	\r
ea5293bb	376	u$conin$echo:\r
04134640	377	\r
ea5293bb L	378	call ?const\r
ea5293bb L	379	or a\r
04134640	380	jr z,u$c1 ; see if any char already struck\r
ea5293bb	381	call ?conin\r
04134640	382	jr u$conin$echo ; yes, eat it and try again\r
ea5293bb L	383	u$c1:\r
	384	call ?conin\r
	385	push af\r
	386	ld c,a\r
04134640 L	387	cp ' '-1\r
04134640 L	388	call nc,?cono\r
ea5293bb L	389	pop af\r
	390	cp 'a'\r
	391	ret c\r
04134640	392	sub 'a'-'A' ; make upper case\r
ea5293bb L	393	ret\r
	394	\r
	395	\r
1d26b866 L	396	residual:\r
1d26b866 L	397	db 0\r
ea5293bb L	398	\r
	399	send_msg:\r
	400	db 2 ; disk command\r
	401	ds 1 ; subcommand (login/read/write)\r
	402	ds 1 ; @adrv\r
	403	ds 1 ; @rdrv\r
1d26b866 L	404	; -read/write- -login-\r
	405	ds 2 ; @trk xdph address\r
	406	ds 2 ; @sect (3 byte)\r
	407	ds 1 ; @cnt\r
ea5293bb L	408	ds 3 ; transfer addr\r
ea5293bb L	409	send_msg_rw_len equ $ - send_msg\r
1d26b866	410	send_msg_login_len equ 7\r
ea5293bb L	411	\r
	412	\r
	413	recv_msg:\r
	414	ds 1 ; len\r
	415	ds 1 ; command\r
	416	ds 1 ; subcommand\r
	417	recv_msg_rc:\r
	418	ds 1 ; result code\r
	419	ds 4 ; room for additional parameter\r
	420	recv_msg_len equ $ - recv_msg\r
	421	\r
	422	\r
	423	; error message components\r
	424	\r
	425	operation$name:\r
	426	dw read$msg\r
	427	read$msg:\r
04134640	428	db ', Read, ',0\r
ea5293bb	429	write$msg:\r
04134640 L	430	db ', Write, ',0\r
04134640 L	431	\r
c6fa1579 L	432	; general driver errors\r
c6fa1579 L	433	\r
04134640 L	434	drvmsg0: db 'Unknown Error, ',0\r
	435	drvmsg1: db 'Invalid Parameter(s), ',0\r
	436	drvmsg2: db 'Invalid Drive, ',0\r
	437	drvmsg3: db 'Bus Timeout, ',0\r
c6fa1579 L	438	drvmsg4: db 'Access beyond disk size, ',0\r
	439	drvmsg5: db 'Write protected, ',0\r
	440	drvmsg6: db 'No media, ',0\r
04134640	441	drvmsg_size equ $ - drvmsg0\r
c6fa1579	442	drvmsg_count equ 7\r
04134640	443	\r
c6fa1579	444	; fat file system errors\r
04134640 L	445	\r
	446	fr$msg0: db 'Unknown Error,',0\r
	447	fr$msg1: db 'DISK_ERR,',0\r
	448	fr$msg2: db 'INT_ERR,',0\r
	449	fr$msg3: db 'NOT_READY,',0\r
	450	fr$msg4: db 'NO_FILE,',0\r
	451	fr$msg5: db 'NO_PATH,',0\r
	452	fr$msg6: db 'INVALID_NAME,',0\r
	453	fr$msg7: db 'DENIED,',0\r
	454	fr$msg8: db 'EXIST,',0\r
	455	fr$msg9: db 'INVALID_OBJECT,',0\r
	456	fr$msg10: db 'WRITE_PROTECTED,',0\r
	457	fr$msg11: db 'INVALID_DRIVE,',0\r
	458	fr$msg12: db 'NOT_ENABLED,',0\r
	459	fr$msg13: db 'NO_FILE_SYSTEM,',0\r
	460	fr$msg14: db 'MKFS_ABORTED,',0\r
	461	fr$msg15: db 'TIMEOUT,',0\r
	462	fr$msg16: db 'LOCKED,',0\r
	463	fr$msg17: db 'NOT_ENOUGH_CORE,',0\r
	464	fr$msg18: db 'TOO_MANY_OPEN_FILES,',0\r
	465	fr$msg19: db 'FR_INVALID_PARAMETER,',0\r
	466	fr$msg20: db 'short read/write,',0\r
ea5293bb	467	fr$msg$size equ $ - fr$msg0\r
c6fa1579	468	fr$msg$count equ 21\r
ea5293bb	469	\r
ea5293bb	470	end\r