romdevtools 0.28.0 → 0.29.0

package/examples/snes/templates/sports-data.asm

@@ -1,7 +1,53 @@
-; ── sports-data.asm — font + paddle/ball sprite data for sports.c ────
-; One sprite tile: a solid 8×8 white block reused for paddles + ball.
+; ── sports-data.asm — NET SURGE's assembly half ──────────────────────────────
+;
+; What lives here (and why it can't live in sports.c):
+;   1. sram_read16/sram_write16 — battery SRAM accessors. SRAM sits at
+;      $70:0000 (declared in hdr.asm — see sports-hdr.asm), reachable only
+;      with long (24-bit) addressing, which tcc C pointers don't emit.
+;   2. Font + sprite + wallpaper tiles (rodata). One sprite tile: a solid
+;      8×8 white block reused for paddles + ball.
+;
+; Section names must stay unique vs snes_sfx_data.asm (also linked in).
 .include "hdr.asm"
 
+.SECTION ".sports_asm" SUPERFREE
+
+; ── HARDWARE IDIOM (load-bearing) — battery SRAM accessors ──────────────────
+; SRAM is mapped at $70:0000 (LoROM, SRAMSIZE $01 in sports-hdr.asm = 2 KB).
+; Long addressing only — there is no SRAM mirror in the program banks, which
+; is why these are asm and not C. tcc calling convention: u16 arg at 5,s
+; (after the 4-byte rtl frame), second arg at 7,s; u16 return in tcc__r0.
+
+; u16 sram_read16(u16 offset)
+sram_read16:
+    php
+    rep #$30
+    lda 5,s            ; offset
+    tax
+    sep #$20
+    lda.l $700000,x
+    sta.w tcc__r0
+    lda.l $700001,x
+    sta.w tcc__r0 + 1
+    plp
+    rtl
+
+; void sram_write16(u16 offset, u16 value)
+sram_write16:
+    php
+    rep #$30
+    lda 5,s            ; offset
+    tax
+    lda 7,s            ; value
+    sep #$20
+    sta.l $700000,x    ; low byte
+    xba
+    sta.l $700001,x    ; high byte
+    plp
+    rtl
+
+.ENDS
+
 .section ".rodata1" superfree
 
 tilfont:

package/examples/snes/templates/sports-hdr.asm

@@ -0,0 +1,57 @@
+;==LoRom== sports hdr.asm — PROJECT OVERRIDE of PVSnesLib's stock header
+;
+; Why this file exists: the stock include/hdr.asm declares CARTRIDGETYPE $00
+; (ROM only) and SRAMSIZE $00. The SNES cart header is the ONLY place battery
+; SRAM gets declared — snes9x (and real flash carts) size the save RAM from
+; these two bytes. Delete this file and the build still succeeds, the game
+; still runs, and saves silently stop existing: sram_read16/sram_write16 hit
+; open bus at $70:0000 and the best win streak never survives a power cycle.
+;
+; Everything except CARTRIDGETYPE/SRAMSIZE/NAME is byte-identical to the
+; stock header — the memory map and vectors MUST match what PVSnesLib's
+; crt0/libs were assembled against, or wlalink places sections inconsistently.
+
+.MEMORYMAP                      ; Begin describing the system architecture.
+  SLOTSIZE $8000                ; ROM slot is $8000 bytes (LoROM 32K banks).
+  DEFAULTSLOT 0
+  SLOT 0 $8000                  ; ROM
+  SLOT 1 $0 $2000               ; low WRAM mirror (tcc registers live at $0000)
+  SLOT 2 $2000 $E000            ; WRAM $2000-$FFFF
+  SLOT 3 $0 $10000              ; bank $7F WRAM (tcc C globals)
+.ENDME
+
+.ROMBANKSIZE $8000              ; 32 KByte ROM banks
+.ROMBANKS 8                     ; 2 Mbits (256 KB) — matches PVSnesLib stock
+
+.SNESHEADER
+  ID "SNES"
+
+  NAME "NET SURGE            "  ; Program Title - 21 bytes, space-padded.
+  ;    "123456789012345678901"
+
+  SLOWROM
+  LOROM
+
+  CARTRIDGETYPE $02             ; $02 = ROM + SRAM + battery  ← THE SAVE SWITCH
+  ROMSIZE $08                   ; $08 = 2 Mbits
+  SRAMSIZE $01                  ; $01 = 2 KB SRAM, mapped at $70:0000-$07FF
+  COUNTRY $01                   ; $01 = U.S.
+  LICENSEECODE $00
+  VERSION $00
+.ENDSNES
+
+.SNESNATIVEVECTOR               ; Native Mode interrupt vector table
+  COP EmptyHandler
+  BRK EmptyHandler
+  ABORT EmptyHandler
+  NMI VBlank                    ; PVSnesLib's vblank.asm handler
+  IRQ EmptyHandler
+.ENDNATIVEVECTOR
+
+.SNESEMUVECTOR                  ; Emulation Mode interrupt vector table
+  COP EmptyHandler
+  ABORT EmptyHandler
+  NMI EmptyHandler
+  RESET tcc__start              ; PVSnesLib crt0 entry
+  IRQBRK EmptyHandler
+.ENDEMUVECTOR