68k ASM defines

Here are preliminary ASM defines for memory locations and constants. For detailed descriptions, see Memory mapped registers.

This can be made into a file and included in your ASM source code to use register names instead of their (meaningless) addresses in RAM.

SCB1           equ $0000   ;VRAM, Sprite tilemaps FIXMAP         equ $7000   ;VRAM, Fix map SCB2           equ $8000   ;VRAM, Sprite shrink ratios SCB3           equ $8200   ;VRAM, Sprite Y positions and sizes SCB4           equ $8400   ;VRAM, Sprite X positions

BLACK          equ $8000 MIDBLUE        equ $1007 BLUE           equ $100F MIDGREEN       equ $2070 GREEN          equ $20F0 MIDCYAN        equ $3077 CYAN           equ $30FF MIDRED         equ $4700 RED            equ $4F00 MIDMAGENTA     equ $5707 MAGENTA        equ $5F0F ORANGE         equ $6F70 MIDYELLOW      equ $6770 YELLOW         equ $6FF0 MIDGREY        equ $7777 WHITE          equ $7FFF

RAMSTART       equ $100000 ;User RAM start PALETTES       equ $400000 ;Palette RAM start BACKDROPCOLOR  equ PALETTES+(16*2*256)-2

REG_P1CNT      equ $300000 ;Joystick port 1 REG_DIPSW      equ $300001 ;Dipswitches/Watchdog REG_SOUND      equ $320000 ;In/Out Z80 REG_STATUS_A   equ $320001 REG_P2CNT      equ $340000 ;Joystick port 2 REG_STATUS_B   equ $380000 REG_POUTPUT    equ $380001 ;Joypad port outputs REG_SLOT       equ $380021 ;Slot selection

REG_DISPENABL  equ $3A0001 ;Video output ON REG_DISPDSABL   equ $3A0011 ;Video output OFF REG_SWPROM     equ $3A0013 ;Use ROM vector table REG_CRDUNLOCK1 equ $3A0005 ;Allow /WE to pass through to memory card when low REG_CRDLOCK1   equ $3A0015 ;Don't allow /WE to pass through to memory card REG_CRDLOCK2   equ $3A0007 ;Don't allow /WE to pass through to memory card REG_CRDUNLOCK2 equ $3A0017 ;Allow /WE to pass through to memory card when high REG_CRDREGSEL 	equ $3A0009 REG_CRDNORMAL  equ $3A0019 REG_BRDFIX     equ $3A000B ;Use board fix tileset REG_CRTFIX     equ $3A001B ;Use ROM fix tileset REG_SRAMLOCK   equ $3A000D ;Write-protect SRAM REG_SRAMUNLOCK equ $3A001D ;Write-unprotect SRAM REG_PALBANK1   equ $3A000F ;Use palette bank 1 REG_PALBANK0   equ $3A001F ;Use palette bank 0 (default)

VRAM_ADDR      equ $3C0000 VRAM_RW        equ $3C0002 VRAM_MOD       equ $3C0004 REG_LSPCMODE   equ $3C0006 REG_TIMERHIGH  rqu $3C0008 REG_TIMERLOW   equ $3C000A REG_IRQACK     equ $3C000C REG_TIMERSTOP  equ $3C000E

BIOSF_SYSTEM_INT1  equ $C00438 BIOSF_SYSTEM_RETURN equ $C00444 BIOSF_SYSTEM_IO    equ $C0044A ;Sets RAM values from I/O ports BIOSF_CREDIT_CHECK equ $C00450 BIOSF_CREDIT_DOWN  equ $C00456 BIOSF_READ_CALENDAR equ $C0045C ;Set calendar addresses (10FDD2+), MVS only BIOSF_CARD         equ $C00468 ;Perform memory card operations BIOSF_CARD_ERROR   equ $C0046E ;In case a memory card error occurred, prompt user for action BIOSF_VIDEOEN      equ $C00470 ;Enable/disable video layers, CD only BIOSF_HOWTOPLAY    equ $C00474 ;Show how-to-play presentation, MVS only BIOSF_FIX_CLEAR    equ $C004C2 ;Clear fix layer BIOSF_LSP_1ST      equ $C004C8 ;Clear sprites BIOSF_MESS_OUT     equ $C004CE BIOSF_UPLOAD       equ $C00546 ;Upload data to DRAM, CD only BIOSF_CDDACMD      equ $C0056A ;Issue CDDA command, CD only
 * BIOS calls

REG_DMACPYSRC  equ $FF0064 ;longword: Copy source address ? REG_DMAFILDEST equ $FF0064 ;longword: Fill destination address ? REG_DMACPYDEST equ $FF0068 ;longword: Copy destination address ? REG_DMAFILVAL  equ $FF006C ;word: Fill value (word) ? REG_DMASIZE    equ $FF0070 ;longword?: Size (in 16 bit words) REG_DMASTART   equ $FF0060 ;byte: Start transfer ($40 ?)
 * DMA related:

REG_DISBLSPR   equ $FF0111 ;byte: 0/1 disable sprites REG_DISBLFIX   equ $FF0115 ;byte: 0/1 disable fix layer REG_ENVIDEO    equ $FF0119 ;byte: 0/1 enable video output REG_CDCONFIG   equ $FF011C ;word: jumper and lid switch input

REG_UPMAPSPR   equ $FF0121 ;bytes (0 or 1) REG_UPMAPPCM   equ $FF0123 REG_UPMAPZ80   equ $FF0127 REG_UPMAPFIX   equ $FF0129 REG_UPUNMAPSPR equ $FF0141 REG_UPUNMAPPCM equ $FF0143 REG_UPUNMAPZ80 equ $FF0147 REG_UPUNMAPFIX equ $FF0149 REG_DISBLIRQ   equ $FF016F REG_ENZ80      equ $FF0183

REG_CDDALEFTL  equ $FF0188 ;CD audio levels REG_CDDARIGHTL equ $FF018A

BIOS_SYSTEM_MODE equ $10FD80 ;Game/system mode (bit 7) BIOS_MVS_FLAG    equ $10FD82 BIOS_COUNTRY_CODE equ $10FD83 BIOS_GAME_DIP    equ $10FD84 ;start of soft DIPs settings (up to $10FD93)

BIOS_P1STATUS  equ $10FD94 BIOS_P1CURRENT equ $10FD95 ;joystick 1 state BIOS_P1PREVIOUS equ $10FD96 ;previous joystick 1 state BIOS_P1CHANGE  equ $10FD97 ;joystick 1 state change BIOS_P1REPEAT  equ $10FD98 ;joystick 1 repeat BIOS_P1TIMER   equ $10FD99
 * Set by BIOSF_SYSTEM_IO

BIOS_P2STATUS  equ $10FD9A BIOS_P2CURRENT equ $10FD9B ;joystick 2 state BIOS_P2PREVIOUS equ $10FD9C ;previous joystick 2 state BIOS_P2CHANGE  equ $10FD9D ;joystick 2 state change BIOS_P2REPEAT  equ $10FD9E ;joystick 2 repeat BIOS_P2TIMER   equ $10FD99

CNT_UP	       equ 0 CNT_DN	       equ 1 CNT_LE	       equ 2 CNT_RI	       equ 3 CNT_A	       equ 4 CNT_B	       equ 5 CNT_C	       equ 6 CNT_D	       equ 7
 * button definitions

BIOS_STATCURNT   equ $10FDAC ;joystick 1/2 start/select BIOS_STATCHANGE  equ $10FDAD ;previous joystick 1/2 start/select BIOS_USER_REQUEST equ $10FDAE BIOS_USER_MODE   equ $10FDAF BIOS_START_FLAG  equ $10FDB4 BIOS_MESS_BUSY   equ $10FDC2

BIOS_CRDF      equ $10FDC4 ;byte: function to perform when calling BIOSF_CRDACCESS, see below table BIOS_CRDRESULT equ $10FDC6 ;byte: 00 on success, else 80+ and encodes the error, see below table BIOS_CRDPTR    equ $10FDC8 ;longword: pointer to read from/write to BIOS_CRDSIZE    equ $10FDCC ;word: how much data to read/write from/to card BIOS_CRDNGH    equ $10FDCE ;word: usually game NGH. Unique identifier for the game that 'owns' the save file BIOS_CRDFILE   equ $10FDD0 ;word: each NGH has up to 16 save 'files' associated with
 * Memory card related:

BIOS_YEAR      equ $10FDD2 ;last 2 digits of year BIOS_MONTH     equ $10FDD3 BIOS_DAY       equ $10FDD4 BIOS_WEEKDAY   equ $10FDD5 ;Sunday = 00, Monday = 01 ... Saturday = 06 BIOS_HOUR      equ $10FDD6 ;24 hour time BIOS_MINUTE    equ $10FDD7 BIOS_SECOND    equ $10FDD8
 * Calendar, only on MVS (in BCD)

BIOS_SELECT_TIMER equ $10FDDA ;Byte: game start countdown BIOS_DEVMODE     equ $10FE80 ;Byte: non-zero for developer mode

BIOS_UPDEST    equ $10FEF4 ;longword: destination address (!) BIOS_UPSRC     equ $10FEF8 ;longword: source address BIOS_UPSIZE    equ $10FEFC ;longword: size BIOS_UPZONE    equ $10FEDA ;byte: zone (0=PRG, 1=FIX, 2=SPR, 3=Z80, 4=PCM, 5=PAT) BIOS_UPBANK    equ $10FEDB ;byte: bank
 * Upload to DRAM

SOUND_STOP     equ $D00046 ;byte