Browse Source

Update md.asm

update code comments after inlining
pull/164/head
b1ackmai1er 5 years ago
parent
commit
ef82f9ef71
  1. 81
      Source/HBIOS/md.asm

81
Source/HBIOS/md.asm

@ -732,10 +732,35 @@ FF_NXT2:
CALL PRTSTR ; AFTER SEARCH DISPLAY THE RESULT CALL PRTSTR ; AFTER SEARCH DISPLAY THE RESULT
#ENDIF #ENDIF
RET RET
;======================================================================
; ;
;COMMON FUNCTION CALL
;======================================================================
; COMMON FUNCTION CALL FOR:
;
; MD_FIDENT_R - IDENTIFY FLASH CHIP
; ON ENTRY DE:HL POINTS TO AN ADDRESS WITH THE ADDRESS RANGE OF THE
; CHIP TO BE IDENTIFIED.
; ON EXIT BC CONTAINS THE CHIP ID BYTES.
; A NO STATUS IS RETURNED
;
; MD_FERAS_R - ERASE FLASH SECTOR
; ON ENTRY DE:HL POINTS TO A 32 BIT MEMORY ADDRESS.
; ON EXIT A RETURNS STATUS 0=SUCCESS NZ=FAIL
;
; MD_FREAD_R - READ FLASH SECTOR
; ON ENTRY DE:HL POINTS TO A 32 BIT MEMORY ADDRESS.
; IX POINTS TO WHERE TO SAVE DATA
; ON EXIT A NO STATUS IS RETURNED
; MD_FWRIT_R - WRITE FLASH SECTOR
; ON ENTRY DE:HL POINTS TO A 32 BIT MEMORY ADDRESS.
; IX POINTS TO DATA TO BE WRITTEN
; ON EXIT A NO STATUS IS RETURNED
; ;
; GENERAL OPERATION:
; CALCULATE BANK AND ADDRESS DATA FROM ENTRY ADDRESS
; COPY FLASH CODE TO CODE BUFFER
; CALL RELOCATED FLASH CODE
; RETURN WITH ID CODE.
;====================================================================== ;======================================================================
; ;
FF_FNCALL: FF_FNCALL:
@ -823,19 +848,6 @@ FF_CALCA:
RET RET
; ;
;====================================================================== ;======================================================================
; IDENTIFY FLASH CHIP.
; CALCULATE BANK AND ADDRESS DATA FROM ENTRY ADDRESS
; COPY FLASH CODE TO CODE BUFFER
; CALL RELOCATED FLASH IDENTITY CODE
; RESTORE STACK
; RETURN WITH ID CODE.
;
; ON ENTRY DE:HL POINTS TO AN ADDRESS WITH THE ADDRESS RANGE OF THE
; CHIP TO BE IDENTIFIED.
; ON EXIT BC CONTAINS THE CHIP ID BYTES.
; NO STATUS IS RETURNED
;======================================================================
;======================================================================
; FLASH IDENTIFY ; FLASH IDENTIFY
; SELECT THE APPROPRIATE BANK / ADDRESS ; SELECT THE APPROPRIATE BANK / ADDRESS
; ISSUE ID COMMAND ; ISSUE ID COMMAND
@ -880,20 +892,7 @@ MD_FIDENT_R: ; THIS CODE GETS RELOCATED TO HIGH MEMORY
.FILL 8,0 ; STACK SPACE .FILL 8,0 ; STACK SPACE
MD_FIST .DW 0 ; SAVE STACK MD_FIST .DW 0 ; SAVE STACK
MD_I_SZ .EQU $-MD_FIDENT_R ; SIZE OF RELOCATABLE CODE BUFFER REQUIRED MD_I_SZ .EQU $-MD_FIDENT_R ; SIZE OF RELOCATABLE CODE BUFFER REQUIRED
;======================================================================
; ERASE FLASH SECTOR
; ;
; ON ENTRY DE:HL CONTAINS 32 BIT MEMORY ADDRESS.
; CALCULATE BANK AND ADDRESS DATA FROM ENTRY ADDRESS
; COPY FLASH CODE TO CODE BUFFER
; CALL RELOCATED FLASH ERASE CODE
; RESTORE STACK
; RETURN WITH STATUS CODE.
;
; ON ENTRY DE:HL POINTS TO AN ADDRESS IDENTIFYING THE CHIP
; ON EXIT A RETURNS STATUS 0=SUCCESS NZ=FAIL
;======================================================================
;====================================================================== ;======================================================================
; ERASE FLASH SECTOR. ; ERASE FLASH SECTOR.
; ;
@ -970,19 +969,6 @@ FF_WT6: POP AF ; RETURN TO ORIGINAL BANK
MD_S_SZ .EQU $-MD_FERAS_R ; SIZE OF RELOCATABLE CODE BUFFER REQUIRED MD_S_SZ .EQU $-MD_FERAS_R ; SIZE OF RELOCATABLE CODE BUFFER REQUIRED
; ;
;====================================================================== ;======================================================================
; READ FLASH SECTOR OF 4096 BYTES
;
; SET ADDRESS TO START OF SECTOR
; CALCULATE BANK AND ADDRESS DATA FROM SECTOR START ADDRESS
; COPY FLASH CODE TO CODE BUFFER
; CALL RELOCATED FLASH READ SECTOR CODE
; RESTORE STACK
;
; ON ENTRY DE:HL POINTS TO A 32 BIT MEMORY ADDRESS.
; IX POINTS TO WHERE TO SAVE DATA
; ON EXIT NO STATUS IS RETURNED
;======================================================================
;======================================================================
; FLASH READ SECTOR. ; FLASH READ SECTOR.
; ;
; SELECT THE APPROPRIATE BANK / ADDRESS ; SELECT THE APPROPRIATE BANK / ADDRESS
@ -1036,19 +1022,6 @@ MD_FRST .DW 0 ; SAVE STACK
MD_R_SZ .EQU $-MD_FREAD_R ; SIZE OF RELOCATABLE CODE BUFFER REQUIRED MD_R_SZ .EQU $-MD_FREAD_R ; SIZE OF RELOCATABLE CODE BUFFER REQUIRED
; ;
;====================================================================== ;======================================================================
; WRITE FLASH SECTOR OF 4096 BYTES
;
; SET ADDRESS TO START OF SECTOR
; CALCULATE BANK AND ADDRESS DATA FROM SECTOR START ADDRESS
; COPY FLASH CODE TO CODE BUFFER
; CALL RELOCATED FLASH WRITE SECTOR CODE
; RESTORE STACK
;
; ON ENTRY DE:HL POINTS TO A 32 BIT MEMORY ADDRESS.
; IX POINTS TO DATA TO BE WRITTEN
; ON EXIT NO STATUS IS RETURNED
;======================================================================
;======================================================================
; FLASH WRITE SECTOR. ; FLASH WRITE SECTOR.
; ;
; SELECT THE APPROPRIATE BANK / ADDRESS ; SELECT THE APPROPRIATE BANK / ADDRESS

Loading…
Cancel
Save