Files
open-roms/src/dos_m65/,aliases_dos.s
T

228 lines
8.4 KiB
ArmAsm

;
; Memory locations for the DOS
;
; NOTES:
; - starting from $8000, 16KB RAM is available (starting from $10000 in C65 address space)
; - additional 16KB RAM is reserved for DOS too ($14000-$17FFF), and can be banked-in if needed
;
; Temporary storage locations
;
!addr MEM_BUF = $1000 ; buffer for hypervisor calls; starting at $1000 VIC sees chargen, so this should be a safe place
;
; Page start+0
;
!addr MAGICSTR = $8000 ; magic string; if not matching, DOS considered non-functional
; Register storage
!addr REG_A = $8005
!addr REG_X = $8006
!addr REG_Y = $8007
!addr REG_Z = $8008
; System configuration
!addr RAM_ATTIC = $8009 ; $8000000-$87FFFFF RAM status; 0 = not present, $FF = present
!addr RAM_CELLAR = $800A ; $8800000-$8FFFFFF RAM status; 0 = not present, $FF = present
!addr RD_MSG = $800B ; code of the RAM disk message to be displayed on banner screen, $FF for none
; General DOS configuration
!addr UNIT_SDCARD = $800C ; unit number for device, 0 = none
!addr UNIT_FLOPPY0 = $800D ; as above - for the internal floppy
!addr UNIT_FLOPPY1 = $800E ; as above - for additional floppy drive
!addr UNIT_RAMDISK = $800F ; as above - for the RAM disk
; General DOS status
!addr IDX1_LISTENER = $8010 ; listener idx, >=$80 = none
!addr IDX2_LISTENER = $8011 ; listener idx * 2, >=$80 = none - for calling routines via vector table
!addr IDX1_TALKER = $8012 ; talker idx, >=$80 = none
!addr IDX2_TALKER = $8013 ; talker idx * 2, >=$80 = none - for calling routines via vector table
; Helper subroutines to fetch data
!addr code_LDA_nnnn_Y = $8014 ; - LDA nnnn, Y instruction
!addr par_LDA_nnnn_Y = $8015 ; - 2 bytes; address
!addr code_RTS_05 = $8017 ; - RTS instruction
; Parameters for utilities/helpers
!addr PAR_TRACK = $8018 ; track number, also for status/error
!addr PAR_SECTOR = $8019 ; sector number, also for status/error
!addr PAR_FSIZE_BYTES = $801A ; 4 bytes - file size in bytes
!addr PAR_FSIZE_BLOCKS = $801E ; 2 bytes - file size in blocks
!addr PAR_FTYPE = $8020 ; bits 0-5 - type, bits 6-7 - protected, closed
!addr PAR_FNAME = $8021 ; 16 bytes - filename, filled with $A0
!addr PAR_FPATTERN = $8031 ; 16 bytes - pattern to match, filled with $A0
!addr PAR_FSINSTANCE = $8041 ; 0 = SD card, 1/2 = floppy, 3 = ram disk
; Various temporary data
!addr XX_DIR_PHASE = $8042 ; directory output phase, values deponds on device driver, but 0 = not reading
!addr SD_DIR_PHASE = $8042 ; - SD card
!addr F0_DIR_PHASE = $8043 ; - floppy 0
!addr F1_DIR_PHASE = $8044 ; - floppy 0
!addr RD_DIR_PHASE = $8045 ; - ram disk
; Free space: $8046-$8063
!addr SD_ACPTR_helper = $8052 ; subroutine in RAM to read a byte
!addr code_LDA_01 = $8052 ; - LDA instruction
!addr SD_ACPTR_PTR = $8053 ; - 2 bytes; address in buffer, SD card
!addr code_RTS_01 = $8055 ; - RTS instruction
!addr F0_ACPTR_helper = $8056 ; subroutine in RAM to read a byte
!addr code_LDA_02 = $8056 ; - LDA instruction
!addr F0_ACPTR_PTR = $8057 ; - 2 bytes; address in buffer, floppy 0
!addr code_RTS_02 = $8059 ; - RTS instruction
!addr F1_ACPTR_helper = $805A ; subroutine in RAM to read a byte
!addr code_LDA_03 = $805A ; - LDA instruction
!addr F1_ACPTR_PTR = $805B ; - 2 bytes; address in buffer, floppy 1
!addr code_RTS_03 = $805D ; - RTS instruction
!addr RD_ACPTR_helper = $805E ; subroutine in RAM to read a byte
!addr code_LDA_04 = $805E ; - LDA instruction
!addr RD_ACPTR_PTR = $805F ; - 2 bytes; address in buffer, ram disk
!addr code_RTS_04 = $8061 ; - RTS instruction
!addr XX_ACPTR_LEN = $8062 ; 2 bytes - length of data left for ACPTR
!addr SD_ACPTR_LEN = $8062 ; - SD card
!addr F0_ACPTR_LEN = $8064 ; - floppy
!addr F1_ACPTR_LEN = $8064 ; - floppy
!addr RD_ACPTR_LEN = $8066 ; - ram disk
!addr XX_MODE = $8068 ; current mode (0 = none, 1 = receiving command/file name)
!addr SD_MODE = $8068 ; - SD card
!addr F0_MODE = $8069 ; - floppy 0
!addr F1_MODE = $806A ; - floppy 1
!addr RD_MODE = $806B ; - ram disk
!addr XX_CHANNEL = $806C ; current channel
!addr SD_CHANNEL = $806C ; - SD card
!addr F0_CHANNEL = $806D ; - floppy 0
!addr F1_CHANNEL = $806E ; - floppy 0
!addr RD_CHANNEL = $806F ; - ram disk
!addr XX_CMDFN_IDX = $8070 ; index byte for storing file name/command
!addr SD_CMDFN_IDX = $8070 ; - SD card
!addr F0_CMDFN_IDX = $8071 ; - floppy 0
!addr F1_CMDFN_IDX = $8072 ; - floppy 1
!addr RD_CMDFN_IDX = $8073 ; - ram disk
!addr XX_STATUS_IDX = $8074 ; index byte for reading status
!addr SD_STATUS_IDX = $8074 ; - SD card
!addr F0_STATUS_IDX = $8075 ; - floppy
!addr F1_STATUS_IDX = $8076 ; - floppy
!addr RD_STATUS_IDX = $8077 ; - ram disk
; Various, most likely to be reworked
!addr SD_DESC = $8078 ; current file descriptor
!addr F0_DIRENT = $8079 ; directory entry to read, 0-15
!addr F1_DIRENT = $807A ; directory entry to read, 0-15
!addr F0_LOADTRACK = $807B ; current track for file loading
!addr F0_LOADSECTOR = $807C ; current sector for file loading
!addr F1_LOADTRACK = $807D ; current track for file loading
!addr F1_LOADSECTOR = $807E ; current sector for file loading
!addr RD_MAXTRACK = $807F ; maximum RAM disk track number of loaded image
!addr RD_STARTSEG = $8080 ; RAM disk start address, 2nd most significant byte (or $FF if no RAM)
!addr RD_VALIDIMG = $8081 ; $00 = no valid image loaded
; Reserved: $8082-$81FF
;
; Various buffers, caches, and other large memory chunks
;
; General purpose buffers, 512 bytes each, each starts at page start - XXX dynamic alllocation to be written
!addr SHARED_BUF_0 = $8200 ; XXX temporarily hardcoded for usage by SD card
!addr SHARED_BUF_1 = $8400 ; XXX temporarily hardcoded for usage by floppy 0
!addr SHARED_BUF_2 = $8600 ; XXX temporarily hardcoded for usage by floppy 1
!addr SHARED_BUF_3 = $8800
!addr SHARED_BUF_4 = $8A00
!addr SHARED_BUF_5 = $8C00
!addr SHARED_BUF_6 = $8E00
!addr SHARED_BUF_7 = $9000
!addr SHARED_BUF_8 = $9200
!addr SHARED_BUF_9 = $9400
!addr SHARED_BUF_A = $9600
!addr SHARED_BUF_B = $9800
!addr SHARED_BUF_C = $9A00
!addr SHARED_BUF_D = $9C00
!addr SHARED_BUF_E = $9E00
; BAM cache for floppy drives; 2 KB (4 blocks) each, to cover up to ED floppies
!addr F0_BAM_CACHE = $A000 ; - floppy disk 0 BAM
!addr SHARED_BUF_X0 = $A200 ; - buffer which can be used if disk is not ED
!addr F1_BAM_CACHE = $A400 ; - floppy disk 1 BAM
!addr SHARED_BUF_X1 = $A600 ; - buffer which can be used if disk is not ED
; Memory shadow, needed for SD card support
!addr MEMSHADOW_BUF = $A800 ; 256 byte buffer for preserving original memory content
; Command/filename buffers, 256 bytes each
!addr SD_CMDFN_BUF = $A900 ; - SD card
!addr F0_CMDFN_BUF = $AA00 ; - floppy 0
!addr F1_CMDFN_BUF = $AB00 ; - floppy 1
!addr RD_CMDFN_BUF = $AD00 ; - ram disk
; Directory entry buffers, in BASIC format, $30 bytes each
!addr XX_DIRENT_BUF = $AE00
!addr SD_DIRENT_BUF = $AE00 ; - SD card
!addr F0_DIRENT_BUF = $AE30 ; - floppy 0
!addr F1_DIRENT_BUF = $AE60 ; - floppy 1
!addr RD_DIRENT_BUF = $AE90 ; - ram disk
; Status buffers, content terminated by 0, $30 bytes each
!addr XX_STATUS_BUF = $AEC0
!addr SD_STATUS_BUF = $AEC0 ; - SD card
!addr F0_STATUS_BUF = $AEF0 ; - floppy 0
!addr F1_STATUS_BUF = $AF20 ; - floppy 1
!addr RD_STATUS_BUF = $AF50 ; - ram disk
; Shared buffer metadata tables, 18 bytes each
!addr BUFTAB_UNIT = $AF50 ; which unit the buffer is assigned to
!addr BUFTAB_DEV = $AF62 ; which device within the unit
!addr BUFTAB_TRACK = $AF74 ; which track (or other kind of handle)
!addr BUFTAB_SECTOR = $AF86 ; which sector is stored in the first half of the buffer
; Common DMA list, 15 bytes
!addr DMAJOB_LIST = $AF98
!addr DMAJOB_SRC_MB = DMAJOB_LIST+2
!addr DMAJOB_DST_MB = DMAJOB_LIST+4
!addr DMAJOB_SIZE = DMAJOB_LIST+7 ; keep $0200 here
!addr DMAJOB_SRC_ADDR = DMAJOB_LIST+9
!addr DMAJOB_DST_ADDR = DMAJOB_LIST+12
;
; Reserved 20 KB for floppy track buffers + some area still free
;
!addr XX_REMAINING = $AFA7