From 2fa72e1df0e0c3f4892195b03df86d1b8261e78c Mon Sep 17 00:00:00 2001 From: mid-kid Date: Fri, 11 Sep 2020 01:17:59 +0200 Subject: Document character values --- Makefile | 22 +- data/text_chars.asm | 279 ++++++++++++++++ include/hardware.inc | 907 +++++++++++++++++++++++++++++++++++++++++++++++++++ source/bank_00.asm | 517 ----------------------------- source/bank_02.asm | 2 +- source/hardware.inc | 907 --------------------------------------------------- 6 files changed, 1197 insertions(+), 1437 deletions(-) create mode 100644 data/text_chars.asm create mode 100644 include/hardware.inc delete mode 100644 source/hardware.inc diff --git a/Makefile b/Makefile index 2cf4922..87151fb 100644 --- a/Makefile +++ b/Makefile @@ -1,10 +1,7 @@ name := picross baserom := DMGAKVJ0.1 -dir_source := source dir_build := build -dir_gfx := gfx -dir_tools := tools RGBASM := rgbasm RGBGFX := rgbgfx @@ -17,13 +14,14 @@ RGBFIXFLAGS := -p 0xff -c -m 0x1b -r 0x03 -k "01" -i "AKVJ" -t "POKEPICROSS" rwildcard = $(foreach d, $(wildcard $1*), $(filter $(subst *, %, $2), $d) $(call rwildcard, $d/, $2)) -objects := $(patsubst $(dir_source)/%.asm, $(dir_build)/%.o, \ - $(call rwildcard, $(dir_source)/, *.asm)) +objects := $(patsubst %.asm, $(dir_build)/%.o, \ + $(call rwildcard, source data, *.asm)) objects += $(dir_build)/shim.o -gfx := $(patsubst $(dir_gfx)/%.png, $(dir_build)/gfx/%.bin, \ - $(call rwildcard, $(dir_gfx)/, *.png)) +gfx := $(patsubst %.png, $(dir_build)/%.bin, \ + $(call rwildcard, gfx, *.png)) +.PRECIOUS: $(gfx) .SECONDEXPANSION: .PHONY: all @@ -39,14 +37,14 @@ $(name).gbc: layout.link $(objects) | $(baserom) $(RGBFIX) $(RGBFIXFLAGS) -v $@ $(dir_build)/shim.asm: shim.sym | $$(dir $$@) - $(dir_tools)/makeshim.py $< > $@ + tools/makeshim.py $< > $@ $(dir_build)/%.o: $(dir_build)/%.asm | $(gfx) $$(dir $$@) - $(RGBASM) $(RGBASMFLAGS) -i $(dir_build)/ -i $(dir_source)/ -M $(@:.o=.d) -o $@ $< -$(dir_build)/%.o: $(dir_source)/%.asm | $(gfx) $$(dir $$@) - $(RGBASM) $(RGBASMFLAGS) -i $(dir_build)/ -i $(dir_source)/ -M $(@:.o=.d) -o $@ $< + $(RGBASM) $(RGBASMFLAGS) -i $(dir_build)/ -i include/ -M $(@:.o=.d) -o $@ $< +$(dir_build)/%.o: %.asm | $(gfx) $$(dir $$@) + $(RGBASM) $(RGBASMFLAGS) -i $(dir_build)/ -i include/ -M $(@:.o=.d) -o $@ $< -$(dir_build)/gfx/%.bin: $(dir_gfx)/%.png | $$(dir $$@) +$(dir_build)/%.bin: %.png | $$(dir $$@) $(RGBGFX) -o $@ $< .PRECIOUS: %/ diff --git a/data/text_chars.asm b/data/text_chars.asm new file mode 100644 index 0000000..0af5ccf --- /dev/null +++ b/data/text_chars.asm @@ -0,0 +1,279 @@ +SECTION "data/text_chars", ROM0[$286f] +text_chars_widths:: + db 7 ; あ + db 7 ; い + db 7 ; う + db 7 ; え + db 7 ; お + db 7 ; か + db 7 ; き + db 4 ; く + db 7 ; け + db 7 ; こ + db 6 ; さ + db 6 ; し + db 7 ; す + db 7 ; せ + db 7 ; そ + db 7 ; た + db 7 ; ち + db 7 ; つ + db 7 ; て + db 7 ; と + db 7 ; な + db 7 ; に + db 7 ; ぬ + db 7 ; ね + db 7 ; の + db 7 ; は + db 7 ; ひ + db 7 ; ふ + db 8 ; へ + db 7 ; ほ + db 6 ; ま + db 7 ; み + db 7 ; む + db 7 ; め + db 7 ; も + db 7 ; や + db 7 ; ゆ + db 6 ; よ + db 6 ; ら + db 6 ; り + db 6 ; る + db 7 ; れ + db 6 ; ろ + db 7 ; わ + db 6 ; を + db 7 ; ん + db 5 ; っ + db 5 ; ゃ + db 5 ; ゅ + db 4 ; ょ + db 9 ; が + db 8 ; ぎ + db 7 ; ぐ + db 8 ; げ + db 8 ; ご + db 9 ; ざ + db 7 ; じ + db 9 ; ず + db 8 ; ぜ + db 8 ; ぞ + db 8 ; だ + db 8 ; ぢ + db 8 ; づ + db 8 ; で + db 8 ; ど + db 9 ; ば + db 9 ; び + db 9 ; ぶ + db 8 ; べ + db 9 ; ぼ + db 9 ; ぱ + db 9 ; ぴ + db 9 ; ぷ + db 8 ; ぺ + db 10 ; ぽ + db 5 ; ぁ + db 5 ; ぃ + db 4 ; ぅ + db 4 ; ぇ + db 5 ; ぉ + db 7 ; ア + db 7 ; イ + db 7 ; ウ + db 7 ; エ + db 7 ; オ + db 7 ; カ + db 7 ; キ + db 7 ; ク + db 7 ; ケ + db 7 ; コ + db 7 ; サ + db 7 ; シ + db 7 ; ス + db 7 ; セ + db 7 ; ソ + db 7 ; タ + db 7 ; チ + db 7 ; ツ + db 7 ; テ + db 5 ; ト + db 7 ; ナ + db 7 ; ニ + db 6 ; ヌ + db 7 ; ネ + db 6 ; ノ + db 7 ; ハ + db 7 ; ヒ + db 7 ; フ + db 8 ; ヘ + db 7 ; ホ + db 7 ; マ + db 6 ; ミ + db 7 ; ム + db 7 ; メ + db 7 ; モ + db 7 ; ヤ + db 7 ; ユ + db 7 ; ヨ + db 7 ; ラ + db 6 ; リ + db 7 ; ル + db 6 ; レ + db 7 ; ロ + db 7 ; ワ + db 7 ; ヲ + db 7 ; ン + db 5 ; ッ + db 5 ; ャ + db 5 ; ュ + db 4 ; ョ + db 9 ; ガ + db 8 ; ギ + db 9 ; グ + db 9 ; ゲ + db 9 ; ゴ + db 8 ; ザ + db 8 ; ジ + db 9 ; ズ + db 9 ; ゼ + db 9 ; ゾ + db 9 ; ダ + db 8 ; ヂ + db 8 ; ヅ + db 9 ; デ + db 6 ; ド + db 8 ; バ + db 8 ; ビ + db 9 ; ブ + db 8 ; ベ + db 8 ; ボ + db 9 ; パ + db 7 ; ピ + db 8 ; プ + db 8 ; ペ + db 8 ; ポ + db 5 ; ァ + db 4 ; ィ + db 5 ; ゥ + db 5 ; ェ + db 5 ; ォ + db 6 ; 0 + db 4 ; 1 + db 6 ; 2 + db 6 ; 3 + db 6 ; 4 + db 6 ; 5 + db 6 ; 6 + db 6 ; 7 + db 6 ; 8 + db 6 ; 9 + db 5 ; - + db 7 ; A + db 6 ; B + db 7 ; C + db 6 ; D + db 6 ; E + db 6 ; F + db 7 ; G + db 6 ; H + db 3 ; I + db 7 ; J + db 6 ; K + db 6 ; L + db 7 ; M + db 7 ; N + db 7 ; O + db 6 ; P + db 7 ; Q + db 6 ; R + db 6 ; S + db 7 ; T + db 7 ; U + db 7 ; V + db 7 ; W + db 7 ; X + db 7 ; Y + db 6 ; Z + db 6 ; a + db 5 ; b + db 5 ; c + db 5 ; d + db 5 ; e + db 6 ; f + db 6 ; g + db 5 ; h + db 1 ; i + db 5 ; j + db 5 ; k + db 2 ; l + db 7 ; m + db 5 ; n + db 5 ; o + db 5 ; p + db 5 ; q + db 5 ; r + db 5 ; s + db 5 ; t + db 5 ; u + db 5 ; v + db 7 ; w + db 6 ; x + db 6 ; y + db 5 ; z + db 0 + db 4 ; 、 + db 4 ; 。 + db 5 ; 『 + db 5 ; 』 + db 8 ; × + db 5 ; “ + db 5 ; ” + db 4 ; ! + db 5 ; ? + db 5 ; : + db 2 ; ; + db 2 ; , + db 2 ; . + db 4 ; · + db 3 ; ( + db 3 ; ) + db 7 ; ~ + db 8 ; ♂ + db 5 ; ♀ + db 0 + db 0 + db 0 + db 0 + db 0 + db 0 + db 0 + db 0 + db 0 + db 0 + db 0 + db 0 + db 0 + +def_tile: macro +; The image is 2bpp, 8x8 tiles, but the characters themselves are 16x10... +_x = \1 +_y = \2 +_pos = $20 * (_x + 8 * _y) ; Max char width = 2 tiles, width = 8 chars +_pos = _pos + 4 * _y ; Characters are 2 pixels taller than a tile +_pos = _pos + $f0 * (_y / 4) ; Every 4 rows skip a whole tile + dw _pos +endm + +text_chars_offsets:: +y = 0 +rept 32 ; height of image in characters +x = 0 +rept 8 ; width of image in characters + def_tile x, y +x = x + 1 +endr +y = y + 1 +endr diff --git a/include/hardware.inc b/include/hardware.inc new file mode 100644 index 0000000..4b145d2 --- /dev/null +++ b/include/hardware.inc @@ -0,0 +1,907 @@ +;* +;* Gameboy Hardware definitions +;* +;* Based on Jones' hardware.inc +;* And based on Carsten Sorensen's ideas. +;* +;* Rev 1.1 - 15-Jul-97 : Added define check +;* Rev 1.2 - 18-Jul-97 : Added revision check macro +;* Rev 1.3 - 19-Jul-97 : Modified for RGBASM V1.05 +;* Rev 1.4 - 27-Jul-97 : Modified for new subroutine prefixes +;* Rev 1.5 - 15-Aug-97 : Added _HRAM, PAD, CART defines +;* : and Nintendo Logo +;* Rev 1.6 - 30-Nov-97 : Added rDIV, rTIMA, rTMA, & rTAC +;* Rev 1.7 - 31-Jan-98 : Added _SCRN0, _SCRN1 +;* Rev 1.8 - 15-Feb-98 : Added rSB, rSC +;* Rev 1.9 - 16-Feb-98 : Converted I/O registers to $FFXX format +;* Rev 2.0 - : Added GBC registers +;* Rev 2.1 - : Added MBC5 & cart RAM enable/disable defines +;* Rev 2.2 - : Fixed NR42,NR43, & NR44 equates +;* Rev 2.3 - : Fixed incorrect _HRAM equate +;* Rev 2.4 - 27-Apr-13 : Added some cart defines (AntonioND) +;* Rev 2.5 - 03-May-15 : Fixed format (AntonioND) +;* Rev 2.6 - 09-Apr-16 : Added GBC OAM and cart defines (AntonioND) +;* Rev 2.7 - 19-Jan-19 : Added rPCMXX (ISSOtm) +;* Rev 2.8 - 03-Feb-19 : Added audio registers flags (Álvaro Cuesta) +;* Rev 2.9 - 28-Feb-20 : Added utility rP1 constants +;* Rev 3.0 - 27-Aug-20 : Register ordering, byte-based sizes, OAM additions, general cleanup (Blitter Object) + +; If all of these are already defined, don't do it again. + + IF !DEF(HARDWARE_INC) +HARDWARE_INC SET 1 + +rev_Check_hardware_inc : MACRO +;NOTE: REVISION NUMBER CHANGES MUST BE ADDED +;TO SECOND PARAMETER IN FOLLOWING LINE. + IF \1 > 3.0 ;PUT REVISION NUMBER HERE + WARN "Version \1 or later of 'hardware.inc' is required." + ENDC +ENDM + +_VRAM EQU $8000 ; $8000->$9FFF +_VRAM8000 EQU _VRAM +_VRAM8800 EQU _VRAM+$800 +_VRAM9000 EQU _VRAM+$1000 +_SCRN0 EQU $9800 ; $9800->$9BFF +_SCRN1 EQU $9C00 ; $9C00->$9FFF +_SRAM EQU $A000 ; $A000->$BFFF +_RAM EQU $C000 ; $C000->$CFFF / $C000->$DFFF +_RAMBANK EQU $D000 ; $D000->$DFFF +_OAMRAM EQU $FE00 ; $FE00->$FE9F +_IO EQU $FF00 ; $FF00->$FF7F,$FFFF +_AUD3WAVERAM EQU $FF30 ; $FF30->$FF3F +_HRAM EQU $FF80 ; $FF80->$FFFE + +; *** MBC5 Equates *** + +rRAMG EQU $0000 ; $0000->$1fff +rROMB0 EQU $2000 ; $2000->$2fff +rROMB1 EQU $3000 ; $3000->$3fff - If more than 256 ROM banks are present. +rRAMB EQU $4000 ; $4000->$5fff - Bit 3 enables rumble (if present) + + +;*************************************************************************** +;* +;* Custom registers +;* +;*************************************************************************** + +; -- +; -- P1 ($FF00) +; -- Register for reading joy pad info. (R/W) +; -- +rP1 EQU $FF00 + +P1F_5 EQU %00100000 ; P15 out port, set to 0 to get buttons +P1F_4 EQU %00010000 ; P14 out port, set to 0 to get dpad +P1F_3 EQU %00001000 ; P13 in port +P1F_2 EQU %00000100 ; P12 in port +P1F_1 EQU %00000010 ; P11 in port +P1F_0 EQU %00000001 ; P10 in port + +P1F_GET_DPAD EQU P1F_5 +P1F_GET_BTN EQU P1F_4 +P1F_GET_NONE EQU P1F_4 | P1F_5 + + +; -- +; -- SB ($FF01) +; -- Serial Transfer Data (R/W) +; -- +rSB EQU $FF01 + + +; -- +; -- SC ($FF02) +; -- Serial I/O Control (R/W) +; -- +rSC EQU $FF02 + + +; -- +; -- DIV ($FF04) +; -- Divider register (R/W) +; -- +rDIV EQU $FF04 + + +; -- +; -- TIMA ($FF05) +; -- Timer counter (R/W) +; -- +rTIMA EQU $FF05 + + +; -- +; -- TMA ($FF06) +; -- Timer modulo (R/W) +; -- +rTMA EQU $FF06 + + +; -- +; -- TAC ($FF07) +; -- Timer control (R/W) +; -- +rTAC EQU $FF07 + +TACF_START EQU %00000100 +TACF_STOP EQU %00000000 +TACF_4KHZ EQU %00000000 +TACF_16KHZ EQU %00000011 +TACF_65KHZ EQU %00000010 +TACF_262KHZ EQU %00000001 + + +; -- +; -- IF ($FF0F) +; -- Interrupt Flag (R/W) +; -- +rIF EQU $FF0F + + +; -- +; -- AUD1SWEEP/NR10 ($FF10) +; -- Sweep register (R/W) +; -- +; -- Bit 6-4 - Sweep Time +; -- Bit 3 - Sweep Increase/Decrease +; -- 0: Addition (frequency increases???) +; -- 1: Subtraction (frequency increases???) +; -- Bit 2-0 - Number of sweep shift (# 0-7) +; -- Sweep Time: (n*7.8ms) +; -- +rNR10 EQU $FF10 +rAUD1SWEEP EQU rNR10 + +AUD1SWEEP_UP EQU %00000000 +AUD1SWEEP_DOWN EQU %00001000 + + +; -- +; -- AUD1LEN/NR11 ($FF11) +; -- Sound length/Wave pattern duty (R/W) +; -- +; -- Bit 7-6 - Wave Pattern Duty (00:12.5% 01:25% 10:50% 11:75%) +; -- Bit 5-0 - Sound length data (# 0-63) +; -- +rNR11 EQU $FF11 +rAUD1LEN EQU rNR11 + + +; -- +; -- AUD1ENV/NR12 ($FF12) +; -- Envelope (R/W) +; -- +; -- Bit 7-4 - Initial value of envelope +; -- Bit 3 - Envelope UP/DOWN +; -- 0: Decrease +; -- 1: Range of increase +; -- Bit 2-0 - Number of envelope sweep (# 0-7) +; -- +rNR12 EQU $FF12 +rAUD1ENV EQU rNR12 + + +; -- +; -- AUD1LOW/NR13 ($FF13) +; -- Frequency low byte (W) +; -- +rNR13 EQU $FF13 +rAUD1LOW EQU rNR13 + + +; -- +; -- AUD1HIGH/NR14 ($FF14) +; -- Frequency high byte (W) +; -- +; -- Bit 7 - Initial (when set, sound restarts) +; -- Bit 6 - Counter/consecutive selection +; -- Bit 2-0 - Frequency's higher 3 bits +; -- +rNR14 EQU $FF14 +rAUD1HIGH EQU rNR14 + + +; -- +; -- AUD2LEN/NR21 ($FF16) +; -- Sound Length; Wave Pattern Duty (R/W) +; -- +; -- see AUD1LEN for info +; -- +rNR21 EQU $FF16 +rAUD2LEN EQU rNR21 + + +; -- +; -- AUD2ENV/NR22 ($FF17) +; -- Envelope (R/W) +; -- +; -- see AUD1ENV for info +; -- +rNR22 EQU $FF17 +rAUD2ENV EQU rNR22 + + +; -- +; -- AUD2LOW/NR23 ($FF18) +; -- Frequency low byte (W) +; -- +rNR23 EQU $FF18 +rAUD2LOW EQU rNR23 + + +; -- +; -- AUD2HIGH/NR24 ($FF19) +; -- Frequency high byte (W) +; -- +; -- see AUD1HIGH for info +; -- +rNR24 EQU $FF19 +rAUD2HIGH EQU rNR24 + + +; -- +; -- AUD3ENA/NR30 ($FF1A) +; -- Sound on/off (R/W) +; -- +; -- Bit 7 - Sound ON/OFF (1=ON,0=OFF) +; -- +rNR30 EQU $FF1A +rAUD3ENA EQU rNR30 + + +; -- +; -- AUD3LEN/NR31 ($FF1B) +; -- Sound length (R/W) +; -- +; -- Bit 7-0 - Sound length +; -- +rNR31 EQU $FF1B +rAUD3LEN EQU rNR31 + + +; -- +; -- AUD3LEVEL/NR32 ($FF1C) +; -- Select output level +; -- +; -- Bit 6-5 - Select output level +; -- 00: 0/1 (mute) +; -- 01: 1/1 +; -- 10: 1/2 +; -- 11: 1/4 +; -- +rNR32 EQU $FF1C +rAUD3LEVEL EQU rNR32 + + +; -- +; -- AUD3LOW/NR33 ($FF1D) +; -- Frequency low byte (W) +; -- +; -- see AUD1LOW for info +; -- +rNR33 EQU $FF1D +rAUD3LOW EQU rNR33 + + +; -- +; -- AUD3HIGH/NR34 ($FF1E) +; -- Frequency high byte (W) +; -- +; -- see AUD1HIGH for info +; -- +rNR34 EQU $FF1E +rAUD3HIGH EQU rNR34 + + +; -- +; -- AUD4LEN/NR41 ($FF20) +; -- Sound length (R/W) +; -- +; -- Bit 5-0 - Sound length data (# 0-63) +; -- +rNR41 EQU $FF20 +rAUD4LEN EQU rNR41 + + +; -- +; -- AUD4ENV/NR42 ($FF21) +; -- Envelope (R/W) +; -- +; -- see AUD1ENV for info +; -- +rNR42 EQU $FF21 +rAUD4ENV EQU rNR42 + + +; -- +; -- AUD4POLY/NR43 ($FF22) +; -- Polynomial counter (R/W) +; -- +; -- Bit 7-4 - Selection of the shift clock frequency of the (scf) +; -- polynomial counter (0000-1101) +; -- freq=drf*1/2^scf (not sure) +; -- Bit 3 - Selection of the polynomial counter's step +; -- 0: 15 steps +; -- 1: 7 steps +; -- Bit 2-0 - Selection of the dividing ratio of frequencies (drf) +; -- 000: f/4 001: f/8 010: f/16 011: f/24 +; -- 100: f/32 101: f/40 110: f/48 111: f/56 (f=4.194304 Mhz) +; -- +rNR43 EQU $FF22 +rAUD4POLY EQU rNR43 + + +; -- +; -- AUD4GO/NR44 ($FF23) +; -- +; -- Bit 7 - Inital +; -- Bit 6 - Counter/consecutive selection +; -- +rNR44 EQU $FF23 +rAUD4GO EQU rNR44 + + +; -- +; -- AUDVOL/NR50 ($FF24) +; -- Channel control / ON-OFF / Volume (R/W) +; -- +; -- Bit 7 - Vin->SO2 ON/OFF (Vin??) +; -- Bit 6-4 - SO2 output level (volume) (# 0-7) +; -- Bit 3 - Vin->SO1 ON/OFF (Vin??) +; -- Bit 2-0 - SO1 output level (volume) (# 0-7) +; -- +rNR50 EQU $FF24 +rAUDVOL EQU rNR50 + +AUDVOL_VIN_LEFT EQU %10000000 ; SO2 +AUDVOL_VIN_RIGHT EQU %00001000 ; SO1 + + +; -- +; -- AUDTERM/NR51 ($FF25) +; -- Selection of Sound output terminal (R/W) +; -- +; -- Bit 7 - Output sound 4 to SO2 terminal +; -- Bit 6 - Output sound 3 to SO2 terminal +; -- Bit 5 - Output sound 2 to SO2 terminal +; -- Bit 4 - Output sound 1 to SO2 terminal +; -- Bit 3 - Output sound 4 to SO1 terminal +; -- Bit 2 - Output sound 3 to SO1 terminal +; -- Bit 1 - Output sound 2 to SO1 terminal +; -- Bit 0 - Output sound 0 to SO1 terminal +; -- +rNR51 EQU $FF25 +rAUDTERM EQU rNR51 + +; SO2 +AUDTERM_4_LEFT EQU %10000000 +AUDTERM_3_LEFT EQU %01000000 +AUDTERM_2_LEFT EQU %00100000 +AUDTERM_1_LEFT EQU %00010000 +; SO1 +AUDTERM_4_RIGHT EQU %00001000 +AUDTERM_3_RIGHT EQU %00000100 +AUDTERM_2_RIGHT EQU %00000010 +AUDTERM_1_RIGHT EQU %00000001 + + +; -- +; -- AUDENA/NR52 ($FF26) +; -- Sound on/off (R/W) +; -- +; -- Bit 7 - All sound on/off (sets all audio regs to 0!) +; -- Bit 3 - Sound 4 ON flag (read only) +; -- Bit 2 - Sound 3 ON flag (read only) +; -- Bit 1 - Sound 2 ON flag (read only) +; -- Bit 0 - Sound 1 ON flag (read only) +; -- +rNR52 EQU $FF26 +rAUDENA EQU rNR52 + +AUDENA_ON EQU %10000000 +AUDENA_OFF EQU %00000000 ; sets all audio regs to 0! + + +; -- +; -- LCDC ($FF40) +; -- LCD Control (R/W) +; -- +rLCDC EQU $FF40 + +LCDCF_OFF EQU %00000000 ; LCD Control Operation +LCDCF_ON EQU %10000000 ; LCD Control Operation +LCDCF_WIN9800 EQU %00000000 ; Window Tile Map Display Select +LCDCF_WIN9C00 EQU %01000000 ; Window Tile Map Display Select +LCDCF_WINOFF EQU %00000000 ; Window Display +LCDCF_WINON EQU %00100000 ; Window Display +LCDCF_BG8800 EQU %00000000 ; BG & Window Tile Data Select +LCDCF_BG8000 EQU %00010000 ; BG & Window Tile Data Select +LCDCF_BG9800 EQU %00000000 ; BG Tile Map Display Select +LCDCF_BG9C00 EQU %00001000 ; BG Tile Map Display Select +LCDCF_OBJ8 EQU %00000000 ; OBJ Construction +LCDCF_OBJ16 EQU %00000100 ; OBJ Construction +LCDCF_OBJOFF EQU %00000000 ; OBJ Display +LCDCF_OBJON EQU %00000010 ; OBJ Display +LCDCF_BGOFF EQU %00000000 ; BG Display +LCDCF_BGON EQU %00000001 ; BG Display +; "Window Character Data Select" follows BG + + +; -- +; -- STAT ($FF41) +; -- LCDC Status (R/W) +; -- +rSTAT EQU $FF41 + +STATF_LYC EQU %01000000 ; LYC=LY Coincidence (Selectable) +STATF_MODE10 EQU %00100000 ; Mode 10 +STATF_MODE01 EQU %00010000 ; Mode 01 (V-Blank) +STATF_MODE00 EQU %00001000 ; Mode 00 (H-Blank) +STATF_LYCF EQU %00000100 ; Coincidence Flag +STATF_HBL EQU %00000000 ; H-Blank +STATF_VBL EQU %00000001 ; V-Blank +STATF_OAM EQU %00000010 ; OAM-RAM is used by system +STATF_LCD EQU %00000011 ; Both OAM and VRAM used by system +STATF_BUSY EQU %00000010 ; When set, VRAM access is unsafe + + +; -- +; -- SCY ($FF42) +; -- Scroll Y (R/W) +; -- +rSCY EQU $FF42 + + +; -- +; -- SCY ($FF43) +; -- Scroll X (R/W) +; -- +rSCX EQU $FF43 + + +; -- +; -- LY ($FF44) +; -- LCDC Y-Coordinate (R) +; -- +; -- Values range from 0->153. 144->153 is the VBlank period. +; -- +rLY EQU $FF44 + + +; -- +; -- LYC ($FF45) +; -- LY Compare (R/W) +; -- +; -- When LY==LYC, STATF_LYCF will be set in STAT +; -- +rLYC EQU $FF45 + + +; -- +; -- DMA ($FF46) +; -- DMA Transfer and Start Address (W) +; -- +rDMA EQU $FF46 + + +; -- +; -- BGP ($FF47) +; -- BG Palette Data (W) +; -- +; -- Bit 7-6 - Intensity for %11 +; -- Bit 5-4 - Intensity for %10 +; -- Bit 3-2 - Intensity for %01 +; -- Bit 1-0 - Intensity for %00 +; -- +rBGP EQU $FF47 + + +; -- +; -- OBP0 ($FF48) +; -- Object Palette 0 Data (W) +; -- +; -- See BGP for info +; -- +rOBP0 EQU $FF48 + + +; -- +; -- OBP1 ($FF49) +; -- Object Palette 1 Data (W) +; -- +; -- See BGP for info +; -- +rOBP1 EQU $FF49 + + +; -- +; -- WY ($FF4A) +; -- Window Y Position (R/W) +; -- +; -- 0 <= WY <= 143 +; -- When WY = 0, the window is displayed from the top edge of the LCD screen. +; -- +rWY EQU $FF4A + + +; -- +; -- WX ($FF4B) +; -- Window X Position (R/W) +; -- +; -- 7 <= WX <= 166 +; -- When WX = 7, the window is displayed from the left edge of the LCD screen. +; -- Values of 0-6 and 166 are unreliable due to hardware bugs. +; -- +rWX EQU $FF4B + + +; -- +; -- SPEED ($FF4D) +; -- Select CPU Speed (R/W) +; -- +rKEY1 EQU $FF4D +rSPD EQU rKEY1 + +KEY1F_DBLSPEED EQU %10000000 ; 0=Normal Speed, 1=Double Speed (R) +KEY1F_PREPARE EQU %00000001 ; 0=No, 1=Prepare (R/W) + + +; -- +; -- VBK ($FF4F) +; -- Select Video RAM Bank (R/W) +; -- +; -- Bit 0 - Bank Specification (0: Specify Bank 0; 1: Specify Bank 1) +; -- +rVBK EQU $FF4F + + +; -- +; -- HDMA1 ($FF51) +; -- High byte for Horizontal Blanking/General Purpose DMA source address (W) +; -- CGB Mode Only +; -- +rHDMA1 EQU $FF51 + + +; -- +; -- HDMA2 ($FF52) +; -- Low byte for Horizontal Blanking/General Purpose DMA source address (W) +; -- CGB Mode Only +; -- +rHDMA2 EQU $FF52 + + +; -- +; -- HDMA3 ($FF53) +; -- High byte for Horizontal Blanking/General Purpose DMA destination address (W) +; -- CGB Mode Only +; -- +rHDMA3 EQU $FF53 + + +; -- +; -- HDMA4 ($FF54) +; -- Low byte for Horizontal Blanking/General Purpose DMA destination address (W) +; -- CGB Mode Only +; -- +rHDMA4 EQU $FF54 + + +; -- +; -- HDMA5 ($FF55) +; -- Transfer length (in tiles minus 1)/mode/start for Horizontal Blanking, General Purpose DMA (R/W) +; -- CGB Mode Only +; -- +rHDMA5 EQU $FF55 + +HDMA5F_MODE_GP EQU %00000000 ; General Purpose DMA (W) +HDMA5F_MODE_HBL EQU %10000000 ; HBlank DMA (W) + +; -- Once DMA has started, use HDMA5F_BUSY to check when the transfer is complete +HDMA5F_BUSY EQU %10000000 ; 0=Busy (DMA still in progress), 1=Transfer complete (R) + + +; -- +; -- RP ($FF56) +; -- Infrared Communications Port (R/W) +; -- +rRP EQU $FF56 + + +; -- +; -- BCPS ($FF68) +; -- Background Color Palette Specification (R/W) +; -- +rBCPS EQU $FF68 + +BCPSF_AUTOINC EQU %10000000 ; Auto Increment (0=Disabled, 1=Increment after Writing) + + +; -- +; -- BCPD ($FF69) +; -- Background Color Palette Data (R/W) +; -- +rBCPD EQU $FF69 + + +; -- +; -- OCPS ($FF6A) +; -- Object Color Palette Specification (R/W) +; -- +rOCPS EQU $FF6A + +OCPSF_AUTOINC EQU %10000000 ; Auto Increment (0=Disabled, 1=Increment after Writing) + + +; -- +; -- OCPD ($FF6B) +; -- Object Color Palette Data (R/W) +; -- +rOCPD EQU $FF6B + + +; -- +; -- SMBK/SVBK ($FF70) +; -- Select Main RAM Bank (R/W) +; -- +; -- Bit 2-0 - Bank Specification (0,1: Specify Bank 1; 2-7: Specify Banks 2-7) +; -- +rSVBK EQU $FF70 +rSMBK EQU rSVBK + + +; -- +; -- PCM12 ($FF76) +; -- Sound channel 1&2 PCM amplitude (R) +; -- +; -- Bit 7-4 - Copy of sound channel 2's PCM amplitude +; -- Bit 3-0 - Copy of sound channel 1's PCM amplitude +; -- +rPCM12 EQU $FF76 + + +; -- +; -- PCM34 ($FF77) +; -- Sound channel 3&4 PCM amplitude (R) +; -- +; -- Bit 7-4 - Copy of sound channel 4's PCM amplitude +; -- Bit 3-0 - Copy of sound channel 3's PCM amplitude +; -- +rPCM34 EQU $FF77 + + +; -- +; -- IE ($FFFF) +; -- Interrupt Enable (R/W) +; -- +rIE EQU $FFFF + +IEF_HILO EQU %00010000 ; Transition from High to Low of Pin number P10-P13 +IEF_SERIAL EQU %00001000 ; Serial I/O transfer end +IEF_TIMER EQU %00000100 ; Timer Overflow +IEF_LCDC EQU %00000010 ; LCDC (see STAT) +IEF_VBLANK EQU %00000001 ; V-Blank + + +;*************************************************************************** +;* +;* Flags common to multiple sound channels +;* +;*************************************************************************** + +; -- +; -- Square wave duty cycle +; -- +; -- Can be used with AUD1LEN and AUD2LEN +; -- See AUD1LEN for more info +; -- +AUDLEN_DUTY_12_5 EQU %00000000 ; 12.5% +AUDLEN_DUTY_25 EQU %01000000 ; 25% +AUDLEN_DUTY_50 EQU %10000000 ; 50% +AUDLEN_DUTY_75 EQU %11000000 ; 75% + + +; -- +; -- Audio envelope flags +; -- +; -- Can be used with AUD1ENV, AUD2ENV, AUD4ENV +; -- See AUD1ENV for more info +; -- +AUDENV_UP EQU %00001000 +AUDENV_DOWN EQU %00000000 + + +; -- +; -- Audio trigger flags +; -- +; -- Can be used with AUD1HIGH, AUD2HIGH, AUD3HIGH +; -- See AUD1HIGH for more info +; -- + +AUDHIGH_RESTART EQU %10000000 +AUDHIGH_LENGTH_ON EQU %01000000 +AUDHIGH_LENGTH_OFF EQU %00000000 + + +;*************************************************************************** +;* +;* CPU values on bootup (a=type, b=qualifier) +;* +;*************************************************************************** + +BOOTUP_A_DMG EQU $01 ; Dot Matrix Game +BOOTUP_A_CGB EQU $11 ; Color GameBoy +BOOTUP_A_MGB EQU $FF ; Mini GameBoy (Pocket GameBoy) + +; if a=BOOTUP_A_CGB, bit 0 in b can be checked to determine if real CGB or +; other system running in GBC mode +BOOTUP_B_CGB EQU %00000000 +BOOTUP_B_AGB EQU %00000001 ; GBA, GBA SP, Game Boy Player, or New GBA SP + + +;*************************************************************************** +;* +;* Cart related +;* +;*************************************************************************** + +; $0143 Color GameBoy compatibility code +CART_COMPATIBLE_DMG EQU $00 +CART_COMPATIBLE_DMG_GBC EQU $80 +CART_COMPATIBLE_GBC EQU $C0 + +; $0146 GameBoy/Super GameBoy indicator +CART_INDICATOR_GB EQU $00 +CART_INDICATOR_SGB EQU $03 + +; $0147 Cartridge type +CART_ROM EQU $00 +CART_ROM_MBC1 EQU $01 +CART_ROM_MBC1_RAM EQU $02 +CART_ROM_MBC1_RAM_BAT EQU $03 +CART_ROM_MBC2 EQU $05 +CART_ROM_MBC2_BAT EQU $06 +CART_ROM_RAM EQU $08 +CART_ROM_RAM_BAT EQU $09 +CART_ROM_MMM01 EQU $0B +CART_ROM_MMM01_RAM EQU $0C +CART_ROM_MMM01_RAM_BAT EQU $0D +CART_ROM_MBC3_BAT_RTC EQU $0F +CART_ROM_MBC3_RAM_BAT_RTC EQU $10 +CART_ROM_MBC3 EQU $11 +CART_ROM_MBC3_RAM EQU $12 +CART_ROM_MBC3_RAM_BAT EQU $13 +CART_ROM_MBC5 EQU $19 +CART_ROM_MBC5_BAT EQU $1A +CART_ROM_MBC5_RAM_BAT EQU $1B +CART_ROM_MBC5_RUMBLE EQU $1C +CART_ROM_MBC5_RAM_RUMBLE EQU $1D +CART_ROM_MBC5_RAM_BAT_RUMBLE EQU $1E +CART_ROM_MBC7_RAM_BAT_GYRO EQU $22 +CART_ROM_POCKET_CAMERA EQU $FC +CART_ROM_BANDAI_TAMA5 EQU $FD +CART_ROM_HUDSON_HUC3 EQU $FE +CART_ROM_HUDSON_HUC1 EQU $FF + +; $0148 ROM size +; these are kilobytes +CART_ROM_32KB EQU $00 ; 2 banks +CART_ROM_64KB EQU $01 ; 4 banks +CART_ROM_128KB EQU $02 ; 8 banks +CART_ROM_256KB EQU $03 ; 16 banks +CART_ROM_512KB EQU $04 ; 32 banks +CART_ROM_1024KB EQU $05 ; 64 banks +CART_ROM_2048KB EQU $06 ; 128 banks +CART_ROM_4096KB EQU $07 ; 256 banks +CART_ROM_8192KB EQU $08 ; 512 banks +CART_ROM_1152KB EQU $52 ; 72 banks +CART_ROM_1280KB EQU $53 ; 80 banks +CART_ROM_1536KB EQU $54 ; 96 banks + +; $0149 SRAM size +; these are kilobytes +CART_SRAM_NONE EQU 0 +CART_SRAM_2KB EQU 1 ; 1 incomplete bank +CART_SRAM_8KB EQU 2 ; 1 bank +CART_SRAM_32KB EQU 3 ; 4 banks +CART_SRAM_128KB EQU 4 ; 16 banks + +CART_SRAM_ENABLE EQU $0A +CART_SRAM_DISABLE EQU $00 + +; $014A Destination code +CART_DEST_JAPANESE EQU $00 +CART_DEST_NON_JAPANESE EQU $01 + + +;*************************************************************************** +;* +;* Keypad related +;* +;*************************************************************************** + +PADF_DOWN EQU $80 +PADF_UP EQU $40 +PADF_LEFT EQU $20 +PADF_RIGHT EQU $10 +PADF_START EQU $08 +PADF_SELECT EQU $04 +PADF_B EQU $02 +PADF_A EQU $01 + +PADB_DOWN EQU $7 +PADB_UP EQU $6 +PADB_LEFT EQU $5 +PADB_RIGHT EQU $4 +PADB_START EQU $3 +PADB_SELECT EQU $2 +PADB_B EQU $1 +PADB_A EQU $0 + + +;*************************************************************************** +;* +;* Screen related +;* +;*************************************************************************** + +SCRN_X EQU 160 ; Width of screen in pixels +SCRN_Y EQU 144 ; Height of screen in pixels +SCRN_X_B EQU 20 ; Width of screen in bytes +SCRN_Y_B EQU 18 ; Height of screen in bytes + +SCRN_VX EQU 256 ; Virtual width of screen in pixels +SCRN_VY EQU 256 ; Virtual height of screen in pixels +SCRN_VX_B EQU 32 ; Virtual width of screen in bytes +SCRN_VY_B EQU 32 ; Virtual height of screen in bytes + + +;*************************************************************************** +;* +;* OAM related +;* +;*************************************************************************** + +; OAM attributes +; each entry in OAM RAM is 4 bytes (sizeof_OAM_ATTRS) +RSRESET +OAMA_Y RB 1 ; y pos +OAMA_X RB 1 ; x pos +OAMA_TILEID RB 1 ; tile id +OAMA_FLAGS RB 1 ; flags (see below) +sizeof_OAM_ATTRS RB 0 + +OAM_COUNT EQU 40 ; number of OAM entries in OAM RAM + +; flags +OAMF_PRI EQU %10000000 ; Priority +OAMF_YFLIP EQU %01000000 ; Y flip +OAMF_XFLIP EQU %00100000 ; X flip +OAMF_PAL0 EQU %00000000 ; Palette number; 0,1 (DMG) +OAMF_PAL1 EQU %00010000 ; Palette number; 0,1 (DMG) +OAMF_BANK0 EQU %00000000 ; Bank number; 0,1 (GBC) +OAMF_BANK1 EQU %00001000 ; Bank number; 0,1 (GBC) + +OAMF_PALMASK EQU %00000111 ; Palette (GBC) + +OAMB_PRI EQU 7 ; Priority +OAMB_YFLIP EQU 6 ; Y flip +OAMB_XFLIP EQU 5 ; X flip +OAMB_PAL1 EQU 4 ; Palette number; 0,1 (DMG) +OAMB_BANK1 EQU 3 ; Bank number; 0,1 (GBC) + + +;* +;* Nintendo scrolling logo +;* (Code won't work on a real GameBoy) +;* (if next lines are altered.) +NINTENDO_LOGO : MACRO + DB $CE,$ED,$66,$66,$CC,$0D,$00,$0B,$03,$73,$00,$83,$00,$0C,$00,$0D + DB $00,$08,$11,$1F,$88,$89,$00,$0E,$DC,$CC,$6E,$E6,$DD,$DD,$D9,$99 + DB $BB,$BB,$67,$63,$6E,$0E,$EC,$CC,$DD,$DC,$99,$9F,$BB,$B9,$33,$3E +ENDM + + ENDC ;HARDWARE_INC diff --git a/source/bank_00.asm b/source/bank_00.asm index a73c322..bfb542a 100644 --- a/source/bank_00.asm +++ b/source/bank_00.asm @@ -635,520 +635,3 @@ farcall_ret:: inc sp inc sp ret - -SECTION "text_chars_offsets", ROM0[$286f] -text_chars_widths:: - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 4 - db 7 - db 7 - db 6 - db 6 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 8 - db 7 - db 6 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 6 - db 6 - db 6 - db 6 - db 7 - db 6 - db 7 - db 6 - db 7 - db 5 - db 5 - db 5 - db 4 - db 9 - db 8 - db 7 - db 8 - db 8 - db 9 - db 7 - db 9 - db 8 - db 8 - db 8 - db 8 - db 8 - db 8 - db 8 - db 9 - db 9 - db 9 - db 8 - db 9 - db 9 - db 9 - db 9 - db 8 - db 10 - db 5 - db 5 - db 4 - db 4 - db 5 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 5 - db 7 - db 7 - db 6 - db 7 - db 6 - db 7 - db 7 - db 7 - db 8 - db 7 - db 7 - db 6 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 6 - db 7 - db 6 - db 7 - db 7 - db 7 - db 7 - db 5 - db 5 - db 5 - db 4 - db 9 - db 8 - db 9 - db 9 - db 9 - db 8 - db 8 - db 9 - db 9 - db 9 - db 9 - db 8 - db 8 - db 9 - db 6 - db 8 - db 8 - db 9 - db 8 - db 8 - db 9 - db 7 - db 8 - db 8 - db 8 - db 5 - db 4 - db 5 - db 5 - db 5 - db 6 - db 4 - db 6 - db 6 - db 6 - db 6 - db 6 - db 6 - db 6 - db 6 - db 5 - db 7 - db 6 - db 7 - db 6 - db 6 - db 6 - db 7 - db 6 - db 3 - db 7 - db 6 - db 6 - db 7 - db 7 - db 7 - db 6 - db 7 - db 6 - db 6 - db 7 - db 7 - db 7 - db 7 - db 7 - db 7 - db 6 - db 6 - db 5 - db 5 - db 5 - db 5 - db 6 - db 6 - db 5 - db 1 - db 5 - db 5 - db 2 - db 7 - db 5 - db 5 - db 5 - db 5 - db 5 - db 5 - db 5 - db 5 - db 5 - db 7 - db 6 - db 6 - db 5 - db 0 - db 4 - db 4 - db 5 - db 5 - db 8 - db 5 - db 5 - db 4 - db 5 - db 5 - db 2 - db 2 - db 2 - db 4 - db 3 - db 3 - db 7 - db 8 - db 5 - db 0 - db 0 - db 0 - db 0 - db 0 - db 0 - db 0 - db 0 - db 0 - db 0 - db 0 - db 0 - db 0 - -text_chars_offsets:: - dw $0000 - dw $0020 - dw $0040 - dw $0060 - dw $0080 - dw $00a0 - dw $00c0 - dw $00e0 - dw $0104 - dw $0124 - dw $0144 - dw $0164 - dw $0184 - dw $01a4 - dw $01c4 - dw $01e4 - dw $0208 - dw $0228 - dw $0248 - dw $0268 - dw $0288 - dw $02a8 - dw $02c8 - dw $02e8 - dw $030c - dw $032c - dw $034c - dw $036c - dw $038c - dw $03ac - dw $03cc - dw $03ec - dw $0500 - dw $0520 - dw $0540 - dw $0560 - dw $0580 - dw $05a0 - dw $05c0 - dw $05e0 - dw $0604 - dw $0624 - dw $0644 - dw $0664 - dw $0684 - dw $06a4 - dw $06c4 - dw $06e4 - dw $0708 - dw $0728 - dw $0748 - dw $0768 - dw $0788 - dw $07a8 - dw $07c8 - dw $07e8 - dw $080c - dw $082c - dw $084c - dw $086c - dw $088c - dw $08ac - dw $08cc - dw $08ec - dw $0a00 - dw $0a20 - dw $0a40 - dw $0a60 - dw $0a80 - dw $0aa0 - dw $0ac0 - dw $0ae0 - dw $0b04 - dw $0b24 - dw $0b44 - dw $0b64 - dw $0b84 - dw $0ba4 - dw $0bc4 - dw $0be4 - dw $0c08 - dw $0c28 - dw $0c48 - dw $0c68 - dw $0c88 - dw $0ca8 - dw $0cc8 - dw $0ce8 - dw $0d0c - dw $0d2c - dw $0d4c - dw $0d6c - dw $0d8c - dw $0dac - dw $0dcc - dw $0dec - dw $0f00 - dw $0f20 - dw $0f40 - dw $0f60 - dw $0f80 - dw $0fa0 - dw $0fc0 - dw $0fe0 - dw $1004 - dw $1024 - dw $1044 - dw $1064 - dw $1084 - dw $10a4 - dw $10c4 - dw $10e4 - dw $1108 - dw $1128 - dw $1148 - dw $1168 - dw $1188 - dw $11a8 - dw $11c8 - dw $11e8 - dw $120c - dw $122c - dw $124c - dw $126c - dw $128c - dw $12ac - dw $12cc - dw $12ec - dw $1400 - dw $1420 - dw $1440 - dw $1460 - dw $1480 - dw $14a0 - dw $14c0 - dw $14e0 - dw $1504 - dw $1524 - dw $1544 - dw $1564 - dw $1584 - dw $15a4 - dw $15c4 - dw $15e4 - dw $1608 - dw $1628 - dw $1648 - dw $1668 - dw $1688 - dw $16a8 - dw $16c8 - dw $16e8 - dw $170c - dw $172c - dw $174c - dw $176c - dw $178c - dw $17ac - dw $17cc - dw $17ec - dw $1900 - dw $1920 - dw $1940 - dw $1960 - dw $1980 - dw $19a0 - dw $19c0 - dw $19e0 - dw $1a04 - dw $1a24 - dw $1a44 - dw $1a64 - dw $1a84 - dw $1aa4 - dw $1ac4 - dw $1ae4 - dw $1b08 - dw $1b28 - dw $1b48 - dw $1b68 - dw $1b88 - dw $1ba8 - dw $1bc8 - dw $1be8 - dw $1c0c - dw $1c2c - dw $1c4c - dw $1c6c - dw $1c8c - dw $1cac - dw $1ccc - dw $1cec - dw $1e00 - dw $1e20 - dw $1e40 - dw $1e60 - dw $1e80 - dw $1ea0 - dw $1ec0 - dw $1ee0 - dw $1f04 - dw $1f24 - dw $1f44 - dw $1f64 - dw $1f84 - dw $1fa4 - dw $1fc4 - dw $1fe4 - dw $2008 - dw $2028 - dw $2048 - dw $2068 - dw $2088 - dw $20a8 - dw $20c8 - dw $20e8 - dw $210c - dw $212c - dw $214c - dw $216c - dw $218c - dw $21ac - dw $21cc - dw $21ec - dw $2300 - dw $2320 - dw $2340 - dw $2360 - dw $2380 - dw $23a0 - dw $23c0 - dw $23e0 - dw $2404 - dw $2424 - dw $2444 - dw $2464 - dw $2484 - dw $24a4 - dw $24c4 - dw $24e4 - dw $2508 - dw $2528 - dw $2548 - dw $2568 - dw $2588 - dw $25a8 - dw $25c8 - dw $25e8 - dw $260c - dw $262c - dw $264c - dw $266c - dw $268c - dw $26ac - dw $26cc - dw $26ec diff --git a/source/bank_02.asm b/source/bank_02.asm index 1300a2e..c083325 100644 --- a/source/bank_02.asm +++ b/source/bank_02.asm @@ -1,4 +1,4 @@ -SECTION "print_char", ROMX[$4c80], BANK[$02] +SECTION "text_char_draw", ROMX[$4c80], BANK[$02] ; Parameters: ; de - character to print ; b - x position diff --git a/source/hardware.inc b/source/hardware.inc deleted file mode 100644 index 4b145d2..0000000 --- a/source/hardware.inc +++ /dev/null @@ -1,907 +0,0 @@ -;* -;* Gameboy Hardware definitions -;* -;* Based on Jones' hardware.inc -;* And based on Carsten Sorensen's ideas. -;* -;* Rev 1.1 - 15-Jul-97 : Added define check -;* Rev 1.2 - 18-Jul-97 : Added revision check macro -;* Rev 1.3 - 19-Jul-97 : Modified for RGBASM V1.05 -;* Rev 1.4 - 27-Jul-97 : Modified for new subroutine prefixes -;* Rev 1.5 - 15-Aug-97 : Added _HRAM, PAD, CART defines -;* : and Nintendo Logo -;* Rev 1.6 - 30-Nov-97 : Added rDIV, rTIMA, rTMA, & rTAC -;* Rev 1.7 - 31-Jan-98 : Added _SCRN0, _SCRN1 -;* Rev 1.8 - 15-Feb-98 : Added rSB, rSC -;* Rev 1.9 - 16-Feb-98 : Converted I/O registers to $FFXX format -;* Rev 2.0 - : Added GBC registers -;* Rev 2.1 - : Added MBC5 & cart RAM enable/disable defines -;* Rev 2.2 - : Fixed NR42,NR43, & NR44 equates -;* Rev 2.3 - : Fixed incorrect _HRAM equate -;* Rev 2.4 - 27-Apr-13 : Added some cart defines (AntonioND) -;* Rev 2.5 - 03-May-15 : Fixed format (AntonioND) -;* Rev 2.6 - 09-Apr-16 : Added GBC OAM and cart defines (AntonioND) -;* Rev 2.7 - 19-Jan-19 : Added rPCMXX (ISSOtm) -;* Rev 2.8 - 03-Feb-19 : Added audio registers flags (Álvaro Cuesta) -;* Rev 2.9 - 28-Feb-20 : Added utility rP1 constants -;* Rev 3.0 - 27-Aug-20 : Register ordering, byte-based sizes, OAM additions, general cleanup (Blitter Object) - -; If all of these are already defined, don't do it again. - - IF !DEF(HARDWARE_INC) -HARDWARE_INC SET 1 - -rev_Check_hardware_inc : MACRO -;NOTE: REVISION NUMBER CHANGES MUST BE ADDED -;TO SECOND PARAMETER IN FOLLOWING LINE. - IF \1 > 3.0 ;PUT REVISION NUMBER HERE - WARN "Version \1 or later of 'hardware.inc' is required." - ENDC -ENDM - -_VRAM EQU $8000 ; $8000->$9FFF -_VRAM8000 EQU _VRAM -_VRAM8800 EQU _VRAM+$800 -_VRAM9000 EQU _VRAM+$1000 -_SCRN0 EQU $9800 ; $9800->$9BFF -_SCRN1 EQU $9C00 ; $9C00->$9FFF -_SRAM EQU $A000 ; $A000->$BFFF -_RAM EQU $C000 ; $C000->$CFFF / $C000->$DFFF -_RAMBANK EQU $D000 ; $D000->$DFFF -_OAMRAM EQU $FE00 ; $FE00->$FE9F -_IO EQU $FF00 ; $FF00->$FF7F,$FFFF -_AUD3WAVERAM EQU $FF30 ; $FF30->$FF3F -_HRAM EQU $FF80 ; $FF80->$FFFE - -; *** MBC5 Equates *** - -rRAMG EQU $0000 ; $0000->$1fff -rROMB0 EQU $2000 ; $2000->$2fff -rROMB1 EQU $3000 ; $3000->$3fff - If more than 256 ROM banks are present. -rRAMB EQU $4000 ; $4000->$5fff - Bit 3 enables rumble (if present) - - -;*************************************************************************** -;* -;* Custom registers -;* -;*************************************************************************** - -; -- -; -- P1 ($FF00) -; -- Register for reading joy pad info. (R/W) -; -- -rP1 EQU $FF00 - -P1F_5 EQU %00100000 ; P15 out port, set to 0 to get buttons -P1F_4 EQU %00010000 ; P14 out port, set to 0 to get dpad -P1F_3 EQU %00001000 ; P13 in port -P1F_2 EQU %00000100 ; P12 in port -P1F_1 EQU %00000010 ; P11 in port -P1F_0 EQU %00000001 ; P10 in port - -P1F_GET_DPAD EQU P1F_5 -P1F_GET_BTN EQU P1F_4 -P1F_GET_NONE EQU P1F_4 | P1F_5 - - -; -- -; -- SB ($FF01) -; -- Serial Transfer Data (R/W) -; -- -rSB EQU $FF01 - - -; -- -; -- SC ($FF02) -; -- Serial I/O Control (R/W) -; -- -rSC EQU $FF02 - - -; -- -; -- DIV ($FF04) -; -- Divider register (R/W) -; -- -rDIV EQU $FF04 - - -; -- -; -- TIMA ($FF05) -; -- Timer counter (R/W) -; -- -rTIMA EQU $FF05 - - -; -- -; -- TMA ($FF06) -; -- Timer modulo (R/W) -; -- -rTMA EQU $FF06 - - -; -- -; -- TAC ($FF07) -; -- Timer control (R/W) -; -- -rTAC EQU $FF07 - -TACF_START EQU %00000100 -TACF_STOP EQU %00000000 -TACF_4KHZ EQU %00000000 -TACF_16KHZ EQU %00000011 -TACF_65KHZ EQU %00000010 -TACF_262KHZ EQU %00000001 - - -; -- -; -- IF ($FF0F) -; -- Interrupt Flag (R/W) -; -- -rIF EQU $FF0F - - -; -- -; -- AUD1SWEEP/NR10 ($FF10) -; -- Sweep register (R/W) -; -- -; -- Bit 6-4 - Sweep Time -; -- Bit 3 - Sweep Increase/Decrease -; -- 0: Addition (frequency increases???) -; -- 1: Subtraction (frequency increases???) -; -- Bit 2-0 - Number of sweep shift (# 0-7) -; -- Sweep Time: (n*7.8ms) -; -- -rNR10 EQU $FF10 -rAUD1SWEEP EQU rNR10 - -AUD1SWEEP_UP EQU %00000000 -AUD1SWEEP_DOWN EQU %00001000 - - -; -- -; -- AUD1LEN/NR11 ($FF11) -; -- Sound length/Wave pattern duty (R/W) -; -- -; -- Bit 7-6 - Wave Pattern Duty (00:12.5% 01:25% 10:50% 11:75%) -; -- Bit 5-0 - Sound length data (# 0-63) -; -- -rNR11 EQU $FF11 -rAUD1LEN EQU rNR11 - - -; -- -; -- AUD1ENV/NR12 ($FF12) -; -- Envelope (R/W) -; -- -; -- Bit 7-4 - Initial value of envelope -; -- Bit 3 - Envelope UP/DOWN -; -- 0: Decrease -; -- 1: Range of increase -; -- Bit 2-0 - Number of envelope sweep (# 0-7) -; -- -rNR12 EQU $FF12 -rAUD1ENV EQU rNR12 - - -; -- -; -- AUD1LOW/NR13 ($FF13) -; -- Frequency low byte (W) -; -- -rNR13 EQU $FF13 -rAUD1LOW EQU rNR13 - - -; -- -; -- AUD1HIGH/NR14 ($FF14) -; -- Frequency high byte (W) -; -- -; -- Bit 7 - Initial (when set, sound restarts) -; -- Bit 6 - Counter/consecutive selection -; -- Bit 2-0 - Frequency's higher 3 bits -; -- -rNR14 EQU $FF14 -rAUD1HIGH EQU rNR14 - - -; -- -; -- AUD2LEN/NR21 ($FF16) -; -- Sound Length; Wave Pattern Duty (R/W) -; -- -; -- see AUD1LEN for info -; -- -rNR21 EQU $FF16 -rAUD2LEN EQU rNR21 - - -; -- -; -- AUD2ENV/NR22 ($FF17) -; -- Envelope (R/W) -; -- -; -- see AUD1ENV for info -; -- -rNR22 EQU $FF17 -rAUD2ENV EQU rNR22 - - -; -- -; -- AUD2LOW/NR23 ($FF18) -; -- Frequency low byte (W) -; -- -rNR23 EQU $FF18 -rAUD2LOW EQU rNR23 - - -; -- -; -- AUD2HIGH/NR24 ($FF19) -; -- Frequency high byte (W) -; -- -; -- see AUD1HIGH for info -; -- -rNR24 EQU $FF19 -rAUD2HIGH EQU rNR24 - - -; -- -; -- AUD3ENA/NR30 ($FF1A) -; -- Sound on/off (R/W) -; -- -; -- Bit 7 - Sound ON/OFF (1=ON,0=OFF) -; -- -rNR30 EQU $FF1A -rAUD3ENA EQU rNR30 - - -; -- -; -- AUD3LEN/NR31 ($FF1B) -; -- Sound length (R/W) -; -- -; -- Bit 7-0 - Sound length -; -- -rNR31 EQU $FF1B -rAUD3LEN EQU rNR31 - - -; -- -; -- AUD3LEVEL/NR32 ($FF1C) -; -- Select output level -; -- -; -- Bit 6-5 - Select output level -; -- 00: 0/1 (mute) -; -- 01: 1/1 -; -- 10: 1/2 -; -- 11: 1/4 -; -- -rNR32 EQU $FF1C -rAUD3LEVEL EQU rNR32 - - -; -- -; -- AUD3LOW/NR33 ($FF1D) -; -- Frequency low byte (W) -; -- -; -- see AUD1LOW for info -; -- -rNR33 EQU $FF1D -rAUD3LOW EQU rNR33 - - -; -- -; -- AUD3HIGH/NR34 ($FF1E) -; -- Frequency high byte (W) -; -- -; -- see AUD1HIGH for info -; -- -rNR34 EQU $FF1E -rAUD3HIGH EQU rNR34 - - -; -- -; -- AUD4LEN/NR41 ($FF20) -; -- Sound length (R/W) -; -- -; -- Bit 5-0 - Sound length data (# 0-63) -; -- -rNR41 EQU $FF20 -rAUD4LEN EQU rNR41 - - -; -- -; -- AUD4ENV/NR42 ($FF21) -; -- Envelope (R/W) -; -- -; -- see AUD1ENV for info -; -- -rNR42 EQU $FF21 -rAUD4ENV EQU rNR42 - - -; -- -; -- AUD4POLY/NR43 ($FF22) -; -- Polynomial counter (R/W) -; -- -; -- Bit 7-4 - Selection of the shift clock frequency of the (scf) -; -- polynomial counter (0000-1101) -; -- freq=drf*1/2^scf (not sure) -; -- Bit 3 - Selection of the polynomial counter's step -; -- 0: 15 steps -; -- 1: 7 steps -; -- Bit 2-0 - Selection of the dividing ratio of frequencies (drf) -; -- 000: f/4 001: f/8 010: f/16 011: f/24 -; -- 100: f/32 101: f/40 110: f/48 111: f/56 (f=4.194304 Mhz) -; -- -rNR43 EQU $FF22 -rAUD4POLY EQU rNR43 - - -; -- -; -- AUD4GO/NR44 ($FF23) -; -- -; -- Bit 7 - Inital -; -- Bit 6 - Counter/consecutive selection -; -- -rNR44 EQU $FF23 -rAUD4GO EQU rNR44 - - -; -- -; -- AUDVOL/NR50 ($FF24) -; -- Channel control / ON-OFF / Volume (R/W) -; -- -; -- Bit 7 - Vin->SO2 ON/OFF (Vin??) -; -- Bit 6-4 - SO2 output level (volume) (# 0-7) -; -- Bit 3 - Vin->SO1 ON/OFF (Vin??) -; -- Bit 2-0 - SO1 output level (volume) (# 0-7) -; -- -rNR50 EQU $FF24 -rAUDVOL EQU rNR50 - -AUDVOL_VIN_LEFT EQU %10000000 ; SO2 -AUDVOL_VIN_RIGHT EQU %00001000 ; SO1 - - -; -- -; -- AUDTERM/NR51 ($FF25) -; -- Selection of Sound output terminal (R/W) -; -- -; -- Bit 7 - Output sound 4 to SO2 terminal -; -- Bit 6 - Output sound 3 to SO2 terminal -; -- Bit 5 - Output sound 2 to SO2 terminal -; -- Bit 4 - Output sound 1 to SO2 terminal -; -- Bit 3 - Output sound 4 to SO1 terminal -; -- Bit 2 - Output sound 3 to SO1 terminal -; -- Bit 1 - Output sound 2 to SO1 terminal -; -- Bit 0 - Output sound 0 to SO1 terminal -; -- -rNR51 EQU $FF25 -rAUDTERM EQU rNR51 - -; SO2 -AUDTERM_4_LEFT EQU %10000000 -AUDTERM_3_LEFT EQU %01000000 -AUDTERM_2_LEFT EQU %00100000 -AUDTERM_1_LEFT EQU %00010000 -; SO1 -AUDTERM_4_RIGHT EQU %00001000 -AUDTERM_3_RIGHT EQU %00000100 -AUDTERM_2_RIGHT EQU %00000010 -AUDTERM_1_RIGHT EQU %00000001 - - -; -- -; -- AUDENA/NR52 ($FF26) -; -- Sound on/off (R/W) -; -- -; -- Bit 7 - All sound on/off (sets all audio regs to 0!) -; -- Bit 3 - Sound 4 ON flag (read only) -; -- Bit 2 - Sound 3 ON flag (read only) -; -- Bit 1 - Sound 2 ON flag (read only) -; -- Bit 0 - Sound 1 ON flag (read only) -; -- -rNR52 EQU $FF26 -rAUDENA EQU rNR52 - -AUDENA_ON EQU %10000000 -AUDENA_OFF EQU %00000000 ; sets all audio regs to 0! - - -; -- -; -- LCDC ($FF40) -; -- LCD Control (R/W) -; -- -rLCDC EQU $FF40 - -LCDCF_OFF EQU %00000000 ; LCD Control Operation -LCDCF_ON EQU %10000000 ; LCD Control Operation -LCDCF_WIN9800 EQU %00000000 ; Window Tile Map Display Select -LCDCF_WIN9C00 EQU %01000000 ; Window Tile Map Display Select -LCDCF_WINOFF EQU %00000000 ; Window Display -LCDCF_WINON EQU %00100000 ; Window Display -LCDCF_BG8800 EQU %00000000 ; BG & Window Tile Data Select -LCDCF_BG8000 EQU %00010000 ; BG & Window Tile Data Select -LCDCF_BG9800 EQU %00000000 ; BG Tile Map Display Select -LCDCF_BG9C00 EQU %00001000 ; BG Tile Map Display Select -LCDCF_OBJ8 EQU %00000000 ; OBJ Construction -LCDCF_OBJ16 EQU %00000100 ; OBJ Construction -LCDCF_OBJOFF EQU %00000000 ; OBJ Display -LCDCF_OBJON EQU %00000010 ; OBJ Display -LCDCF_BGOFF EQU %00000000 ; BG Display -LCDCF_BGON EQU %00000001 ; BG Display -; "Window Character Data Select" follows BG - - -; -- -; -- STAT ($FF41) -; -- LCDC Status (R/W) -; -- -rSTAT EQU $FF41 - -STATF_LYC EQU %01000000 ; LYC=LY Coincidence (Selectable) -STATF_MODE10 EQU %00100000 ; Mode 10 -STATF_MODE01 EQU %00010000 ; Mode 01 (V-Blank) -STATF_MODE00 EQU %00001000 ; Mode 00 (H-Blank) -STATF_LYCF EQU %00000100 ; Coincidence Flag -STATF_HBL EQU %00000000 ; H-Blank -STATF_VBL EQU %00000001 ; V-Blank -STATF_OAM EQU %00000010 ; OAM-RAM is used by system -STATF_LCD EQU %00000011 ; Both OAM and VRAM used by system -STATF_BUSY EQU %00000010 ; When set, VRAM access is unsafe - - -; -- -; -- SCY ($FF42) -; -- Scroll Y (R/W) -; -- -rSCY EQU $FF42 - - -; -- -; -- SCY ($FF43) -; -- Scroll X (R/W) -; -- -rSCX EQU $FF43 - - -; -- -; -- LY ($FF44) -; -- LCDC Y-Coordinate (R) -; -- -; -- Values range from 0->153. 144->153 is the VBlank period. -; -- -rLY EQU $FF44 - - -; -- -; -- LYC ($FF45) -; -- LY Compare (R/W) -; -- -; -- When LY==LYC, STATF_LYCF will be set in STAT -; -- -rLYC EQU $FF45 - - -; -- -; -- DMA ($FF46) -; -- DMA Transfer and Start Address (W) -; -- -rDMA EQU $FF46 - - -; -- -; -- BGP ($FF47) -; -- BG Palette Data (W) -; -- -; -- Bit 7-6 - Intensity for %11 -; -- Bit 5-4 - Intensity for %10 -; -- Bit 3-2 - Intensity for %01 -; -- Bit 1-0 - Intensity for %00 -; -- -rBGP EQU $FF47 - - -; -- -; -- OBP0 ($FF48) -; -- Object Palette 0 Data (W) -; -- -; -- See BGP for info -; -- -rOBP0 EQU $FF48 - - -; -- -; -- OBP1 ($FF49) -; -- Object Palette 1 Data (W) -; -- -; -- See BGP for info -; -- -rOBP1 EQU $FF49 - - -; -- -; -- WY ($FF4A) -; -- Window Y Position (R/W) -; -- -; -- 0 <= WY <= 143 -; -- When WY = 0, the window is displayed from the top edge of the LCD screen. -; -- -rWY EQU $FF4A - - -; -- -; -- WX ($FF4B) -; -- Window X Position (R/W) -; -- -; -- 7 <= WX <= 166 -; -- When WX = 7, the window is displayed from the left edge of the LCD screen. -; -- Values of 0-6 and 166 are unreliable due to hardware bugs. -; -- -rWX EQU $FF4B - - -; -- -; -- SPEED ($FF4D) -; -- Select CPU Speed (R/W) -; -- -rKEY1 EQU $FF4D -rSPD EQU rKEY1 - -KEY1F_DBLSPEED EQU %10000000 ; 0=Normal Speed, 1=Double Speed (R) -KEY1F_PREPARE EQU %00000001 ; 0=No, 1=Prepare (R/W) - - -; -- -; -- VBK ($FF4F) -; -- Select Video RAM Bank (R/W) -; -- -; -- Bit 0 - Bank Specification (0: Specify Bank 0; 1: Specify Bank 1) -; -- -rVBK EQU $FF4F - - -; -- -; -- HDMA1 ($FF51) -; -- High byte for Horizontal Blanking/General Purpose DMA source address (W) -; -- CGB Mode Only -; -- -rHDMA1 EQU $FF51 - - -; -- -; -- HDMA2 ($FF52) -; -- Low byte for Horizontal Blanking/General Purpose DMA source address (W) -; -- CGB Mode Only -; -- -rHDMA2 EQU $FF52 - - -; -- -; -- HDMA3 ($FF53) -; -- High byte for Horizontal Blanking/General Purpose DMA destination address (W) -; -- CGB Mode Only -; -- -rHDMA3 EQU $FF53 - - -; -- -; -- HDMA4 ($FF54) -; -- Low byte for Horizontal Blanking/General Purpose DMA destination address (W) -; -- CGB Mode Only -; -- -rHDMA4 EQU $FF54 - - -; -- -; -- HDMA5 ($FF55) -; -- Transfer length (in tiles minus 1)/mode/start for Horizontal Blanking, General Purpose DMA (R/W) -; -- CGB Mode Only -; -- -rHDMA5 EQU $FF55 - -HDMA5F_MODE_GP EQU %00000000 ; General Purpose DMA (W) -HDMA5F_MODE_HBL EQU %10000000 ; HBlank DMA (W) - -; -- Once DMA has started, use HDMA5F_BUSY to check when the transfer is complete -HDMA5F_BUSY EQU %10000000 ; 0=Busy (DMA still in progress), 1=Transfer complete (R) - - -; -- -; -- RP ($FF56) -; -- Infrared Communications Port (R/W) -; -- -rRP EQU $FF56 - - -; -- -; -- BCPS ($FF68) -; -- Background Color Palette Specification (R/W) -; -- -rBCPS EQU $FF68 - -BCPSF_AUTOINC EQU %10000000 ; Auto Increment (0=Disabled, 1=Increment after Writing) - - -; -- -; -- BCPD ($FF69) -; -- Background Color Palette Data (R/W) -; -- -rBCPD EQU $FF69 - - -; -- -; -- OCPS ($FF6A) -; -- Object Color Palette Specification (R/W) -; -- -rOCPS EQU $FF6A - -OCPSF_AUTOINC EQU %10000000 ; Auto Increment (0=Disabled, 1=Increment after Writing) - - -; -- -; -- OCPD ($FF6B) -; -- Object Color Palette Data (R/W) -; -- -rOCPD EQU $FF6B - - -; -- -; -- SMBK/SVBK ($FF70) -; -- Select Main RAM Bank (R/W) -; -- -; -- Bit 2-0 - Bank Specification (0,1: Specify Bank 1; 2-7: Specify Banks 2-7) -; -- -rSVBK EQU $FF70 -rSMBK EQU rSVBK - - -; -- -; -- PCM12 ($FF76) -; -- Sound channel 1&2 PCM amplitude (R) -; -- -; -- Bit 7-4 - Copy of sound channel 2's PCM amplitude -; -- Bit 3-0 - Copy of sound channel 1's PCM amplitude -; -- -rPCM12 EQU $FF76 - - -; -- -; -- PCM34 ($FF77) -; -- Sound channel 3&4 PCM amplitude (R) -; -- -; -- Bit 7-4 - Copy of sound channel 4's PCM amplitude -; -- Bit 3-0 - Copy of sound channel 3's PCM amplitude -; -- -rPCM34 EQU $FF77 - - -; -- -; -- IE ($FFFF) -; -- Interrupt Enable (R/W) -; -- -rIE EQU $FFFF - -IEF_HILO EQU %00010000 ; Transition from High to Low of Pin number P10-P13 -IEF_SERIAL EQU %00001000 ; Serial I/O transfer end -IEF_TIMER EQU %00000100 ; Timer Overflow -IEF_LCDC EQU %00000010 ; LCDC (see STAT) -IEF_VBLANK EQU %00000001 ; V-Blank - - -;*************************************************************************** -;* -;* Flags common to multiple sound channels -;* -;*************************************************************************** - -; -- -; -- Square wave duty cycle -; -- -; -- Can be used with AUD1LEN and AUD2LEN -; -- See AUD1LEN for more info -; -- -AUDLEN_DUTY_12_5 EQU %00000000 ; 12.5% -AUDLEN_DUTY_25 EQU %01000000 ; 25% -AUDLEN_DUTY_50 EQU %10000000 ; 50% -AUDLEN_DUTY_75 EQU %11000000 ; 75% - - -; -- -; -- Audio envelope flags -; -- -; -- Can be used with AUD1ENV, AUD2ENV, AUD4ENV -; -- See AUD1ENV for more info -; -- -AUDENV_UP EQU %00001000 -AUDENV_DOWN EQU %00000000 - - -; -- -; -- Audio trigger flags -; -- -; -- Can be used with AUD1HIGH, AUD2HIGH, AUD3HIGH -; -- See AUD1HIGH for more info -; -- - -AUDHIGH_RESTART EQU %10000000 -AUDHIGH_LENGTH_ON EQU %01000000 -AUDHIGH_LENGTH_OFF EQU %00000000 - - -;*************************************************************************** -;* -;* CPU values on bootup (a=type, b=qualifier) -;* -;*************************************************************************** - -BOOTUP_A_DMG EQU $01 ; Dot Matrix Game -BOOTUP_A_CGB EQU $11 ; Color GameBoy -BOOTUP_A_MGB EQU $FF ; Mini GameBoy (Pocket GameBoy) - -; if a=BOOTUP_A_CGB, bit 0 in b can be checked to determine if real CGB or -; other system running in GBC mode -BOOTUP_B_CGB EQU %00000000 -BOOTUP_B_AGB EQU %00000001 ; GBA, GBA SP, Game Boy Player, or New GBA SP - - -;*************************************************************************** -;* -;* Cart related -;* -;*************************************************************************** - -; $0143 Color GameBoy compatibility code -CART_COMPATIBLE_DMG EQU $00 -CART_COMPATIBLE_DMG_GBC EQU $80 -CART_COMPATIBLE_GBC EQU $C0 - -; $0146 GameBoy/Super GameBoy indicator -CART_INDICATOR_GB EQU $00 -CART_INDICATOR_SGB EQU $03 - -; $0147 Cartridge type -CART_ROM EQU $00 -CART_ROM_MBC1 EQU $01 -CART_ROM_MBC1_RAM EQU $02 -CART_ROM_MBC1_RAM_BAT EQU $03 -CART_ROM_MBC2 EQU $05 -CART_ROM_MBC2_BAT EQU $06 -CART_ROM_RAM EQU $08 -CART_ROM_RAM_BAT EQU $09 -CART_ROM_MMM01 EQU $0B -CART_ROM_MMM01_RAM EQU $0C -CART_ROM_MMM01_RAM_BAT EQU $0D -CART_ROM_MBC3_BAT_RTC EQU $0F -CART_ROM_MBC3_RAM_BAT_RTC EQU $10 -CART_ROM_MBC3 EQU $11 -CART_ROM_MBC3_RAM EQU $12 -CART_ROM_MBC3_RAM_BAT EQU $13 -CART_ROM_MBC5 EQU $19 -CART_ROM_MBC5_BAT EQU $1A -CART_ROM_MBC5_RAM_BAT EQU $1B -CART_ROM_MBC5_RUMBLE EQU $1C -CART_ROM_MBC5_RAM_RUMBLE EQU $1D -CART_ROM_MBC5_RAM_BAT_RUMBLE EQU $1E -CART_ROM_MBC7_RAM_BAT_GYRO EQU $22 -CART_ROM_POCKET_CAMERA EQU $FC -CART_ROM_BANDAI_TAMA5 EQU $FD -CART_ROM_HUDSON_HUC3 EQU $FE -CART_ROM_HUDSON_HUC1 EQU $FF - -; $0148 ROM size -; these are kilobytes -CART_ROM_32KB EQU $00 ; 2 banks -CART_ROM_64KB EQU $01 ; 4 banks -CART_ROM_128KB EQU $02 ; 8 banks -CART_ROM_256KB EQU $03 ; 16 banks -CART_ROM_512KB EQU $04 ; 32 banks -CART_ROM_1024KB EQU $05 ; 64 banks -CART_ROM_2048KB EQU $06 ; 128 banks -CART_ROM_4096KB EQU $07 ; 256 banks -CART_ROM_8192KB EQU $08 ; 512 banks -CART_ROM_1152KB EQU $52 ; 72 banks -CART_ROM_1280KB EQU $53 ; 80 banks -CART_ROM_1536KB EQU $54 ; 96 banks - -; $0149 SRAM size -; these are kilobytes -CART_SRAM_NONE EQU 0 -CART_SRAM_2KB EQU 1 ; 1 incomplete bank -CART_SRAM_8KB EQU 2 ; 1 bank -CART_SRAM_32KB EQU 3 ; 4 banks -CART_SRAM_128KB EQU 4 ; 16 banks - -CART_SRAM_ENABLE EQU $0A -CART_SRAM_DISABLE EQU $00 - -; $014A Destination code -CART_DEST_JAPANESE EQU $00 -CART_DEST_NON_JAPANESE EQU $01 - - -;*************************************************************************** -;* -;* Keypad related -;* -;*************************************************************************** - -PADF_DOWN EQU $80 -PADF_UP EQU $40 -PADF_LEFT EQU $20 -PADF_RIGHT EQU $10 -PADF_START EQU $08 -PADF_SELECT EQU $04 -PADF_B EQU $02 -PADF_A EQU $01 - -PADB_DOWN EQU $7 -PADB_UP EQU $6 -PADB_LEFT EQU $5 -PADB_RIGHT EQU $4 -PADB_START EQU $3 -PADB_SELECT EQU $2 -PADB_B EQU $1 -PADB_A EQU $0 - - -;*************************************************************************** -;* -;* Screen related -;* -;*************************************************************************** - -SCRN_X EQU 160 ; Width of screen in pixels -SCRN_Y EQU 144 ; Height of screen in pixels -SCRN_X_B EQU 20 ; Width of screen in bytes -SCRN_Y_B EQU 18 ; Height of screen in bytes - -SCRN_VX EQU 256 ; Virtual width of screen in pixels -SCRN_VY EQU 256 ; Virtual height of screen in pixels -SCRN_VX_B EQU 32 ; Virtual width of screen in bytes -SCRN_VY_B EQU 32 ; Virtual height of screen in bytes - - -;*************************************************************************** -;* -;* OAM related -;* -;*************************************************************************** - -; OAM attributes -; each entry in OAM RAM is 4 bytes (sizeof_OAM_ATTRS) -RSRESET -OAMA_Y RB 1 ; y pos -OAMA_X RB 1 ; x pos -OAMA_TILEID RB 1 ; tile id -OAMA_FLAGS RB 1 ; flags (see below) -sizeof_OAM_ATTRS RB 0 - -OAM_COUNT EQU 40 ; number of OAM entries in OAM RAM - -; flags -OAMF_PRI EQU %10000000 ; Priority -OAMF_YFLIP EQU %01000000 ; Y flip -OAMF_XFLIP EQU %00100000 ; X flip -OAMF_PAL0 EQU %00000000 ; Palette number; 0,1 (DMG) -OAMF_PAL1 EQU %00010000 ; Palette number; 0,1 (DMG) -OAMF_BANK0 EQU %00000000 ; Bank number; 0,1 (GBC) -OAMF_BANK1 EQU %00001000 ; Bank number; 0,1 (GBC) - -OAMF_PALMASK EQU %00000111 ; Palette (GBC) - -OAMB_PRI EQU 7 ; Priority -OAMB_YFLIP EQU 6 ; Y flip -OAMB_XFLIP EQU 5 ; X flip -OAMB_PAL1 EQU 4 ; Palette number; 0,1 (DMG) -OAMB_BANK1 EQU 3 ; Bank number; 0,1 (GBC) - - -;* -;* Nintendo scrolling logo -;* (Code won't work on a real GameBoy) -;* (if next lines are altered.) -NINTENDO_LOGO : MACRO - DB $CE,$ED,$66,$66,$CC,$0D,$00,$0B,$03,$73,$00,$83,$00,$0C,$00,$0D - DB $00,$08,$11,$1F,$88,$89,$00,$0E,$DC,$CC,$6E,$E6,$DD,$DD,$D9,$99 - DB $BB,$BB,$67,$63,$6E,$0E,$EC,$CC,$DD,$DC,$99,$9F,$BB,$B9,$33,$3E -ENDM - - ENDC ;HARDWARE_INC -- cgit v1.2.3