tmerritt/disasm
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
disasm/NROM/Ice Climber (JE)/iceclimber_label_map.tsv
T
tmerrittandClaude Opus 4.8 49e117bfcc Fix Pass 3 symbol application and add promotion criteria to PROMPTS.md 
- Apply symbols.inc hardware register names to Defender 2 (U) (51 operands)
- Apply symbols.inc hardware register names to Donkey Kong 3 (JUE) (36 operands)
- Add APU register symbols (-) to Defender 2 (U) and Donkey Kong 3 (JUE) symbols.inc
- Apply symbols to Donkey Kong Jr. Math (U) (80 operands: 11 single + 69 hardware)
- Apply symbols to Excitebike (JU) (786 operands: 785 single + 1 hardware)
- Add promotion criteria to PROMPTS.md: symbol/local substitution,
  ROM-specific semantic naming, and verification checklist

Add branch/jump target naming requirement to PROMPTS.md

All branches and jumps must target symbolic labels with descriptive names
derived from program flow role (e.g., _Loop, _Next, _Done, _Store, _Return),
never raw address literals. Adds criterion 8 to verification checklist.

Rename all OVERVIEW.md to README.md; add root README content to top-level

- Rename all OVERVIEW.md files to README.md throughout the repo (47 files)
- Prepend README.md content to top-level OVERVIEW.md before rename
- Fix apply_symbols.py NAME_RE regex to handle spaced assignments
- Apply symbols.inc to Defender 2 (U) (51 hardware operands)
- Apply symbols.inc to Donkey Kong 3 (JUE) (36 hardware operands)
- Apply symbols.inc to Donkey Kong Jr. Math (U) (80 operands: 11 single + 69 hardware)
- Apply symbols.inc to Excitebike (JU) (786 operands: 785 single + 1 hardware)
- Add missing Zp18/FrameCounter aliases to Excitebike prg.s
- Build all 27 top-level projects: byte-identical

Promote Donkey Kong Jr. Math back to _wip tier

Moves code from `copilot` folder and verifies each builds after

Add pre-commit hook for byte-identical verification

Add .git/hooks/pre-commit that runs 'make' then 'make clean' in each
project directory before committing. This ensures every project builds
byte-identical before any commit is accepted.

Also includes all file moves from the Donkey Kong Jr. Math (U) demotion
and other file restructuring from the session.

moves code out of copilot folder, its all AI generated.
Moves NROM games into NROM folder

removes copilot folder from Lunar Pool
Adds makefile to build all projects recursively

Updates docs to reflect changes in layout

Repromotes Donkey Kong Jr Math
Repromotes Excitebike
Promotes Popeye (JU) (PRG 1)
Updates Makefile to provide summary of build failure/success

Promote Raid on Bungeling Bay (U): Pass 2/3 partial, whole-ROM byte-identical

Move _wip/NROM/Raid on Bungeling Bay (U) to NROM/ and switch the build
from a PRG-only compare to a whole-ROM one:

  - header.s/chr.s added (one-line .incbin of header.bin / chr.bin)
  - linker.cfg gains HEADER ($0000, $0010) and CHR ($0000, $2000)
    areas ahead of PRG ($C000, $4000)
  - rom.nes symlink to the space-containing original ROM name
  - Makefile builds header.o/prg.o/chr.o into reconstructed.nes and
    compares it against rom.nes ('Byte-identical ROM verified.')
  - one leftover neutral indirect operand jmp (Zp01) at $E2EC becomes
    jmp (IndDispatch01); apply_symbols.py reports 0 substitutions pending

README.md / TODO.md / AGENTS.md updated: 29 promoted, 7 in _wip/.

Pac-Man (U): Pass 2 complete (label renaming) + Pass 3 partial (ZP aliases, table names)

Pass 2 — fresh map derived from the committed split, not from any drafted
map (the drafted maps in other projects were audited and found not
applicable):

  - all 194 address-derived Label_XXXX definitions renamed to semantic
    routine-entry names plus <Routine>_<Role>_<addr> internal branch
    targets; zero Label_ remains
  - all 49 jsr/jmp call sites resolved from raw $XXXX to labels; zero
    raw $XXXX call operands remain
  - routinemap.tsv / derived_names.tsv record the derivation

Pass 3 (partial):

  - 15 proven semantic zero-page aliases added to locals.inc
    (GameState, NmiFlag, ScrollX/Y, PpuCtrlShadow, OamDmaPage,
    CocktailModeFlag, ActivePlayerFlag, GameplaySuspended, FrameCounter,
    StateTimer, Player1/2Input, ActiveInput, CopyrightVerified)
  - 112 operands substituted into prg.s (11 single + 101 hardware)
  - key data tables named: ProgrammerSig ($C0EB), GameStateDispatchTable
    ($C253), TitleScreenData ($C2FD), EntityPtrTable ($D912),
    AudioCommandTable ($EFDD)

Also corrects the README's claim that the RESET vector points at padding:
$FF00 holds real boot code (sei/cld, PPU off, double vblank wait, then
jmp ColdStart at $C042).

.gitignore: ignore reconstructed_prg.bin (build artifact of the _wip
Makefiles; '**/reconstructed.*' does not match the underscore form).

Promote Pac-Man (U): Pass 2/3 complete, whole-ROM byte-identical

Move _wip/NROM/Pac-Man (U) to NROM/ and switch the build from a PRG-only
compare to a whole-ROM one:

  - header.s/chr.s added (one-line .incbin of header.bin / chr.bin)
  - linker.cfg gains HEADER ($0000, $0010) and CHR ($0000, $2000)
    areas ahead of PRG ($C000, $4000)
  - rom.nes symlink to 'Pac-Man (U) [!].nes' (the original ROM name
    contains a space and brackets)
  - Makefile builds header.o/prg.o/chr.o into reconstructed.nes and
    compares it against rom.nes
  - reconstructed.nes is 24,592 bytes, MD5 a69d310f8cae9397fbd39f204672b5c7
    - equal to the original ROM; the header/prg/chr splits were checked
    against the original before promotion and are byte-exact

Pass 3 residue closed.  The last 7 multi-alias zero-page operands are
resolved per site through a new sites.tsv, each proven from context
rather than guessed:

  - jmp ($0010) at $C250/$D3CA/$D90F/$D9B6 -> (DispatchPtrLo); each
    is immediately preceded by sta DispatchPtrLo/sta DispatchPtrHi
  - jmp ($00FE) at $EFDA -> (AudioHandlerPtrLo); preceded by
    sta AudioHandlerPtrLo/sta AudioHandlerPtrHi
  - sta a:$0000,y at $C048/$C089 -> a:Zp00,y; the literal zero-page
    base in the two ZP clear loops, so the neutral name is used rather
    than the semantic WorkPtrLo.  The 'a:' prefix survives the
    substitution, so the bytes stay 99 00 00 (sta abs,Y)

apply_symbols.py now reports 119 operands substituted (101 hardware,
11 single-name, 7 site) and 0 residue.

New tool _tools/align_audit_comments.py: re-aligns the audit comment to
column 35 after a substitution lengthens an operand (nesdis.py pads each
instruction to 31 characters).  Whitespace-only, so the byte identity
cannot change.  405 lines re-aligned in this project; all 2,387 audit
comments still match prg.bin at the stated PRG offset, 0 mismatches.

Docs: root README.md / TODO.md / AGENTS.md updated - 30 promoted, 6 in
_wip/; a per-project detail entry for Pac-Man (U) added; the stale
'Donkey Kong 3 (JUE) has no README.md' claim corrected (it has a
318-line one).

Promote Raid on Bungeling Bay (U) [a2]: Pass 3 complete, whole-ROM byte-identical

Move _wip/NROM/Raid on Bungeling Bay (U) [a2] to NROM/ and switch the build
from a PRG-only compare to a whole-ROM one:

  - header.s/chr.s added (one-line .incbin of header.bin / chr.bin)
  - linker.cfg gains HEADER ($0000, $0010) and CHR ($0000, $2000)
    areas ahead of PRG ($C000, $4000)
  - rom.nes symlink to 'Raid on Bungeling Bay (U) [a2].nes' (the original
    ROM name contains spaces and brackets)
  - reconstructed.nes is 24,592 bytes, MD5 659d340a1e9d420eee28df13319b0094
    - equal to the original ROM; the header/prg/chr splits were checked
    against the original before promotion and are byte-exact

Pass 3 - 15 semantic zero-page aliases, each applied only at the sites
where its role is proven:

  - PpuCtrlShadow ($C2), 15 sites: the reset entry primes it right after
    'sta PPUCTRL', and every other use is an ora/and/eor followed by
    'sta PPUCTRL'
  - NmiPathSelector ($C4), 5 sites: written 1 at $C3E9 and 0 at $C962
  - GameState ($D6), 6 sites: 'cmp #$02' and used as an index at $C4C7
  - FrameSubCounter ($55), 6 sites: set to $0A at $C520, decremented per
    NMI at $C07B
  - PrngPeriodCounter ($EA) / PrngSeedB ($EB) / PrngState ($EC), 13 sites:
    the PRNG state
  - PtrLo ($00) / PtrHi ($01), 8 sites: the 16-bit pair $1C13 and $1610
    compared at $E785/$E791
  - IndDispatch01 ($01) / IndDispatch02 ($02), 3 sites: the computed
    dispatch at $E2EC
  - IndDispatch1B ($1B) / IndDispatch1C ($1C), 6 sites: the dispatch at
    $E7A3
  - IndDispatch17 ($17) / IndDispatch19 ($19): the dispatches at $E79D
    and $E7A0

Addresses that carry two names keep the neutral ZpXX name where the other
role applies - $01 is PtrHi at the 16-bit compare and IndDispatch01 at the
dispatch; $17 is IndDispatch17 at the dispatch and Zp17 for the absolute
RAM $0017 store in the copy loop at $E895/$E8D0.

New tool _tools/apply_zp_aliases.py does the per-site substitution:
apply_symbols.py only rewrites *numeric* operands, so it cannot rename an
operand that is already written as a neutral ZpXX name.  The tool keeps the
ca65 'a:' prefix (dropping it would turn 'sta a:Zp17,y' into a zero-page
store and change the bytes) and rewrites only the operand token, so the
audit comment survives byte for byte.

Naming correction in the promoted sibling.  Finishing this dump showed that
$EA was misnamed 'VBlankWaitCounter': the routine at $C412 is the game's
pseudo-random generator (the classic eor/asl/php/lsr/plp/rol scrambler,
called from thirteen gameplay sites, twice in a row at $CDF4/$CDF9 with the
second result masked #$07), so $EA is the scrambler's phase counter.
Renamed PrngPeriodCounter in both dumps and named $EB/$EC PrngSeedB /
PrngState.  The sibling's two 'sta a:IndDispatch17,y' operands were also
wrong - they are absolute stores to RAM $0017, not the dispatch pointer -
and are now 'a:Zp17,y', matching the file's 'a:' = absolute convention.

Audit-comment alignment re-done with _tools/align_audit_comments.py (1,040
lines here, 1,080 in the sibling).  Both files still match prg.bin at every
stated PRG offset: 5,467 and 5,483 audit comments, 0 mismatches.

Docs: root README.md / TODO.md / AGENTS.md updated - 31 promoted, 5 in
_wip/; per-project detail entries added for both Raid dumps.

Promote Pac-Man (Tengen) (U): Pass 2/3 from scratch, whole-ROM byte-identical

Move _wip/NROM/Pac-Man (Tengen) (U) to NROM/ and switch the build from a
PRG-only compare to a whole-ROM one:

  - header.s/chr.s added (one-line .incbin of header.bin / chr.bin)
  - linker.cfg gains HEADER ($0000, $0010) and CHR ($0000, $2000)
    areas ahead of PRG ($C000, $4000)
  - rom.nes symlink to 'Pac-Man (Tengen) (U) [!].nes'
  - reconstructed.nes is 24,592 bytes, MD5 d34e7a74d8d2c231b6cc601210e28ad0
    - equal to the original ROM; the header/prg/chr splits were checked
    against the original before promotion and are byte-exact

Disassembled from scratch.  No name, map or file was carried over from the
sibling 'Pac-Man (U)' dump; the map was derived from this dump's own
committed split and the two were only compared afterwards.

Pass 2 (new tool _tools/apply_pass2_map.py):
  - all 194 Label_XXXX definitions renamed to semantic routine entries plus
    <Routine>_<Role> branch targets; zero Label_ remains
  - all 48 raw $XXXX jsr/jmp operands resolved to labels; zero raw $XXXX
    call or branch operands remain
  - the map is in routinemap.tsv

Pass 3:
  - 30 semantic zero-page aliases, each applied only at the sites where its
    role is proven (per-site choice in sites.tsv; the addresses that carry
    two roles keep the neutral ZpXX name elsewhere).  _tools/
    derive_zp_aliases.py records how the set was derived, and locals.inc
    records the reason for every remaining neutral slot
  - 28 data tables named (new tool _tools/name_data_region.py), including
    CharacterDataTable ($C66A) and CharacterNameStrings ($C67E), where the
    ROM itself names Blinky, Pinky, Inky and Clyde - which is why the four
    indexed entities are called ghosts and not 'actors'
  - apply_symbols.py reports 0 substitutions pending and 0 residue
  - audit-comment alignment re-done with _tools/align_audit_comments.py;
    all 2,479 audit comments still match prg.bin at the stated PRG offset

Pass 1 correction - six command handlers recovered (new tool
_tools/recode_region.py).  ScriptCommandTable ($EFDD) is read by the traced
instruction at $EFCC, and six of its entries point at $F00A, $F022, $F03A,
$F052, $F062 and $F072 - all of which the tracer had left as data, and two
of which it had mis-split across the 'jmp $EF61' at $F01F and $F04F.
Those 120 bytes are code here, decoded straight from the ROM; the six
handlers tile $F00A-$F081 exactly.  The same gap exists in the promoted
'Pac-Man (U)' dump, which has not been corrected - recorded in both READMEs.

Residue (documented, not guessed): the unreached main game logic at
$C45A-$C55F is still .byte data.  It is code - the tracer's own decoder
walks it cleanly and the dispatch table at $C511 points into it - but
nothing reaches it, so it cannot be entered without a guess.  The same gap
exists in the promoted 'Pac-Man (U)' dump.  Re-deriving it is a Pass 1 job;
a Mesen Code Data Logger capture is the tool the repo uses for it.

Docs: root README.md / TODO.md / AGENTS.md updated - 32 promoted, 4 in
_wip/; a per-project detail entry added for the Tengen dump.

Promote Pyramid (U): Pass 1 corrected, Pass 2/3 complete, whole-ROM byte-identical

Move _wip/NROM/Pyramid (U) to NROM/ and switch the build from a PRG-only
compare to a whole-ROM one:

  - header.s/chr.s added (one-line .incbin of header.bin / chr.bin)
  - linker.cfg gains HEADER ($0000, $0010) and CHR ($0000, $2000)
    areas ahead of PRG ($C000, $4000)
  - rom.nes symlink to 'Pyramid (U) (Sachen).nes'
  - reconstructed.nes is 24,592 bytes, MD5 aa285ff17f25dd05da5996b7466c59e2
    - equal to the original ROM; the header/prg/chr splits were checked
    against the original before promotion and are byte-exact

Pass 1 correction - the committed split was a strict subset of the correct
one.  This game dispatches through 'jmp' trampoline tables that live
*inside* the data regions, and the tracer cannot follow a jmp there, so
828 bytes of code were still marked as data.  Four such tables were found
($C01E 3 entries, $C02A 6, $C042 2, $C054 5) plus ten more entries at
$C000-$C01B; all sixteen targets decode as valid instructions.  Seeding
them, the $C800 boot mainline and six further code starts recovers the
whole lot, plus a five-byte stub at $DF89 (lda $33 / jmp $DECB) that sat
in a hole between two routines.  The re-trace loses NO committed code byte
and takes the split from 34.5% to 39.6% (3,130 instructions / 6,493 code
bytes).  'make regen' reproduces it, so the split stays verifiable.

Pass 2 - a fresh map derived from this dump's own committed split:
  - 428 Label_XXXX definitions renamed; zero Label_ residue
  - 320 raw $XXXX jsr/jmp operands resolved; zero raw $XXXX branch
    operands remain
  - 431 routine entries and the 32 data blocks named from the code
  - the internal branch-target names are derived mechanically from the
    branch that reaches them by the new _tools/derive_branch_names.py
    (beq -> OnZero, bne -> OnNonzero, bcc/bcs -> the carry cases, a
    backwards branch -> Loop)
  - recorded in routinemap.tsv

Pass 3:
  - 24 semantic zero-page aliases, each applied only where its role is
    proven; the 57 slots that stay neutral are each listed with the reason
    in locals.inc (the neutral set lives in zp_aliases.inc so that
    'make regen' can rebuild locals.inc from prg.bin)
  - 32 data tables named - TaskVectorTable1/2, LevelScriptData,
    MusicPeriodTable, SoundEnvelopeTable, the actor tables - recorded in
    data_region_names.tsv
  - apply_symbols.py reports 0 substitutions pending and 0 residue; no
    hardware register is left as a raw literal
  - the audit comments are now canonical on every line, data included
    (the old file carried only 'PRG:$xxxx' on its 1,358 data lines);
    all 3,762 audit comments match prg.bin at their stated PRG offset

Kept as-is, not 'cleaned up':
  - sta $4100 stays a raw operand.  The iNES header claims mapper 0 but
    the boot code writes past the NES register space; the ROM does not
    explain it, so it is recorded rather than guessed
  - the 'A'/'V' check on RAM $0120/$0121 and its seed/clear routines
    are named for what they do, not for what they are for
  - the ninth entry of the $C3A6 task vector table ($D820) is a junk
    slot and stays data

Docs: root README.md / TODO.md / AGENTS.md updated - 33 promoted, 3 in
_wip/; a per-project detail entry added.

Hogan's Alley (JU): Pass 1 correction, Pass 2, Pass 3, promoted to NROM/

The light-gun game whose engine dispatches through *inline* tables:
`IndirectCall` at $C34D pops the return address of the `jsr` that called
it and reads a 16-bit handler pointer from the word that follows, so all
six handler tables ($C124 19 entries, $C219 4, $C89C 14, $CDD1 1, $D234 2,
$D3D6 14) live inside the code stream and the static tracer cannot follow
them.

Pass 1 correction.  The committed split was a strict subset of the correct
one -- 41.8% of the PRG was classified as code.  A fresh Mesen Code Data
Logger capture was merged with the four captures already in the folder
(hogans_merged.cdl, the OR of five per-byte flag arrays, 6,544 code bytes)
and _tools/cdl_reclass.py rewrote the split to match what the CPU actually
fetched: 1,216 bytes moved from data to code, five the other way, 59 labels
emitted.  The split is now 49.1% code (3,950 instructions, 8,041 bytes).
The four branch targets the reclassifier could not prove were turned into
labels by the new _tools/resolve_raw_branches.py.

Pass 2.  206 routine entries hand-named from this dump's own code and 413
internal branch targets derived mechanically by _tools/derive_branch_names.py:
630 Label_XXXX definitions gone, 484 raw $XXXX call operands resolved, 15
call targets the tracer had never labelled given a label.  Recorded in
routinemap.tsv.  No SubC<addr> residue was needed -- every entry the engine
reaches is named after what it does.

Pass 3.  60 semantic zero-page aliases, each applied only where its role is
proven (zp_aliases.inc, zp_alias_sites.tsv); the slots that stay neutral are
each listed with the reason.  All 34 data blocks named
(data_region_names.tsv).  apply_symbols.py reports 1 residue: `sta a:$00B4,y`
at $C203, the same address as Zp40/ActorPalette but forced to absolute
addressing, so it must stay numeric.

Promotion.  header.s, chr.s and a HEADER/PRG/CHR linker.cfg added, rom.nes
symlinked to the original ROM; the whole-ROM cmp passes on the first
promoted build.  There is deliberately no `make regen` target: the Pass 1
split here is the static trace corrected by a CDL capture, and the base the
correction was applied to is not what the current _tools/nesdis.py
produces, so prg.s is the maintained source of truth.

Tools changed:
  nesdis.py             --split/--note/--provenance options, so a data
                          region can carry its own name and explanation;
                          a forced-data address is no longer reported as a
                          recovered routine entry
  apply_pass2_map.py    can create the label for a call target the tracer
                          left unlabelled; no longer double-labels it
  apply_zp_aliases.py   --at-file, an address-based per-site list
  derive_branch_names.py keeps the map's own header instead of writing a
                          fixed one
  resolve_raw_branches.py  new: turns `bXX *+$NN` operands into labels
  build_hogans_map.py   new: the hand-written Pass 2 map builder

The existing regen pipelines (MUSCLE (U), Urban Champion (JU)) still
reproduce prg.s byte for byte.

Apply the symbols.inc register names at Pass 1; fix a dropped byte in cdl_reclass

nesdis.py now names the hardware registers as it renders the operands, so a
project's Pass 1 output already reads `lda PPUSTATUS` instead of `lda $2002`
and the Pass 3 apply_symbols.py step has nothing left to do for them.

  * nesdis.py --symbols FILE reads a symbols.inc-style file and substitutes
    the register names.  Only unambiguous entries in the $2000-$4017 window
    are used: $4017 is both JOY2 and APUFRAMECOUNTER, so it stays numeric
    and apply_symbols.py reports it as multi-alias residue, exactly as
    before.  The default is the symbols.inc next to --out, so a new project
    gets the names without asking; --no-symbols opts out.
  * The renderer records the operand's numeric value on the Insn, because
    operand_value() used to re-parse the operand text and could no longer
    read a name.
  * The controller bit masks in symbols.inc (PAD_A and friends) are
    constants, not addresses, and are still never substituted.

MUSCLE (U) and Urban Champion (JU) keep --no-symbols: their committed
prg.s was produced with the registers named by the Pass 3 apply_symbols.py
step, and the columns in those files reflect the in-place substitution.
Adding the missing apply_symbols.py step to both regen pipelines makes
them reproduce their committed prg.s byte for byte again - neither did
before this change (MUSCLE was 440 lines out, Urban Champion 772).

cdl_reclass.py had a bug that cost a byte: a region whose last source row
straddled the region's end was replaced by a regeneration of the region
only, so the tail of that row was dropped.  Mario Bros (JU) hit it at
$C595, where the rebuild came out one byte short and every label after it
shifted.  A region now covers the whole rows it replaces.

pass2.py reflow takes an optional column argument; the default is
unchanged (the ';' lands on the same column as before).

Mario Bros (JU): Pass 1 correction, Pass 2, Pass 3, promoted to NROM/

A two-player platformer whose handler tables are *inline*: the pointers sit
in the middle of the code stream, right after the `jsr` that reads them, so
the static tracer could never follow them.

Pass 1 correction.  The committed split was a strict subset of the correct
one -- only 72.0% of the PRG was classified as code.  A Mesen Code Data
Logger capture of this ROM (mario_mesen.cdl, 10,915 code bytes) showed
1,010 bytes the tracer had left as data were code; two branch targets the
capture never reached ($E4CB and $E639) were forced with --override for 57
more, so 1,067 bytes moved from data to code and 22 moved the other way.
The split is now 78.4% code (6,210 instructions, 12,847 bytes).  The three
branch targets the reclassifier could not prove were turned into labels by
_resolve_raw_branches.py, which now refuses to put a label on a `.byte` row.

Pass 2.  206 routine entries and 519 internal branch targets: 931
Label_XXXX definitions gone, 51 raw $XXXX call operands resolved and 12 call
targets the tracer had never labelled given a label.  Zero SubC residue --
the 185 entries a previous session had left as address-derived residue were
all named from this dump's own code.  Recorded in routinemap.tsv.

Pass 3.  25 semantic zero-page aliases, each applied only where its role is
proven (zp_aliases.inc); the slots that stay neutral are each listed with the
reason.  35 data tables named -- GameStateHandlerTable, EnemyBehaviourTable,
EnemyScriptTable, EnemyTypePointerTable, SoundRoutineTable,
NoteFrequencyTable and the rest -- and recorded in
data_region_names.tsv.  apply_symbols.py reports 0 residue.

Promotion.  header.s, chr.s and a HEADER/PRG/CHR linker.cfg added, rom.nes
symlinked to the original ROM; the whole-ROM cmp passes on the first
promoted build.  There is deliberately no `make regen` target: the Pass 1
split here is the static trace corrected by a CDL capture, and the base the
correction was applied to is not what the current _tools/nesdis.py
produces, so prg.s is the maintained source of truth.

Tools:
  apply_pass2_map.py     renames a label of any spelling -- SubC<addr> is
                          the honest residue form -- and its references
                          follow it; one combined pattern, so a 16,000-line
                          file does not need a substitution per label
  resolve_raw_branches.py refuses to label a data row
  build_mario_map.py      new: the hand-written Pass 2 map builder

Remove the old _wip/NROM/Mario Bros (JU) folder (promoted to NROM/)

Mario Bros (JU): add the promoted-tier header, CHR, rom.nes symlink and zero-page aliases

Moves _ROMS/<ROM> into _wip/<MAPPER>/<ROM>

Sync the docs and the skeleton tool with the 857-project _wip tier

The _wip/ tier now holds 857 projects across 30 mapper folders, all
building byte-identical for the whole ROM.  README.md, TODO.md and
AGENTS.md still described the old 39-project tier, so bring them in line
with WIP.md, which carries the tier's index.

The tier is no longer 39 projects of NROM-256 with a 16/32 KB PRG:
only two projects have a 16 KB PRG, 151 have 32 KB, 523 have 128 KB and
one has 1.5 MB, so most of it is a banked mapper whose image does not fit
the 6502's address space.  Those projects link their MEMORY areas at .nes
file offsets rather than CPU addresses, which is the only option and the
honest model; the 39 older projects keep the CPU-address layout because
their PRG really is one contiguous window.

make_skeleton.py gains the two layouts (--layout flat|cpu), the board
name for the mapper, and a fix for find_rom() mistaking the build
output reconstructed.nes for the source ROM.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-10-20 16:44:06 -04:00

13 KiB
Raw Permalink Blame History

1labelLabel_C014Reset
2labelLabel_C01EWaitVBlank_1
3labelLabel_C024WaitVBlank2_1
4labelLabel_C03FInitRAM
5labelLabel_C041ClearZeropage
6labelLabel_C052InitSystem
7labelLabel_C058InitAPU_1
8labelLabel_C06DMainGameLoop
9labelLabel_C05EInitAPU_3
10labelLabel_C070GameLoopEntry_1
11labelLabel_C076NmiHandler
12labelLabel_C083NmiFrameUpdate
13labelLabel_C095NmiFrameUpdate2
14labelLabel_C0D3UpdateGameState
15labelLabel_C0D3GameStateUpdate
16labelLabel_C0F1UpdateGameState2_1
17labelLabel_C0FAUpdateGameState3_1
18labelLabel_C100UpdateGameState3_3
19labelLabel_C100UpdateGameState4
20labelLabel_C103UpdateGameState5
21labelLabel_C10AUpdateGameState6
22labelLabel_C126GameLoopEntry_3
23labelLabel_C126GameLoopEntry_4
24labelLabel_C138UpdateGameState2_3
25labelLabel_C138UpdateGameState2_4
26labelLabel_C141UpdateGameState2_5
27labelLabel_C148WaitVBlankFrame
28labelLabel_C148WaitVBlankFrame2
29labelLabel_C14EInitSprites_1
30labelLabel_C150CopySprites
31labelLabel_C15ACopySprites2
32labelLabel_C218UpdateSprites_1
33labelLabel_C21AUpdateSprites2_1
34labelLabel_C2ABUpdateSprites2_3
35labelLabel_C437CheckZp34
36labelLabel_C44AUpdateSprites2_4
37labelLabel_C4C0UpdateSprites3_1
38labelLabel_C4D7InitSprites_3
39labelLabel_C542UpdateSprites_3
40labelLabel_C5A7UpdateSprites2_5
41labelLabel_C5D3UpdateSprites3_3
42labelLabel_C620CheckZp14
43labelLabel_C6FBUpdateSprites2_6
44labelLabel_C6FBUpdateSprites3_4
45labelLabel_C6FCCheckZpAD
46labelLabel_C726CheckZp55
47labelLabel_C728UpdateSprites2_7
48labelLabel_C73DUpdateSprites3_5
49labelLabel_C777UpdateSprites4_1
50labelLabel_C7C1UpdateSprites4_3
51labelLabel_C7F5UpdateSprites4_4
52labelLabel_C81DGameLoopEntry_5
53labelLabel_C821InitGameState
54labelLabel_C83DUpdateSprites2_8
55labelLabel_C868UpdateSprites2_9
56labelLabel_C883InitSprites2_1
57labelLabel_C891ClearSpriteRAM
58labelLabel_C89AUpdateSprites2_10
59labelLabel_C8A4UpdateSprites2_11
60labelLabel_C8E0UpdateSprites3_6
61labelLabel_C8EEUpdateSprites4_5
62labelLabel_C94BUpdateSprites5_1
63labelLabel_C9D7UpdateSprites6
64labelLabel_C9F8UpdateSprites7_1
65labelLabel_CA1AUpdateSprites7_3
66labelLabel_CA29UpdateSprites8
67labelLabel_CA33UpdateSprites9
68labelLabel_CA36UpdateSprites10
69labelLabel_CA40UpdateSprites11
70labelLabel_CA44UpdateSprites12
71labelLabel_CA4CUpdateSprites13
72labelLabel_CACEInitSprites_4
73labelLabel_CAEDInitSprites2_3
74labelLabel_CB00UpdateController
75labelLabel_CB35UpdateController2_1
76labelLabel_CB35UpdateController2_3
77labelLabel_CB78UpdateSprites_4
78labelLabel_CB81UpdateSprites2_12
79labelLabel_CB8CUpdateSprites3_7
80labelLabel_CB8EUpdateSprites4_6
81labelLabel_CB9DUpdateSprites5_3
82labelLabel_CAEDInitSprites2_4
83labelLabel_CAEDInitSprites3
84labelLabel_CB35UpdateController2_4
85labelLabel_CB8CUpdateSprites4_7
86labelLabel_CB9DUpdateSprites5_4
87labelLabel_CF0BUpdateSound
88labelLabel_CF16UpdateSound2_1
89labelLabel_CF2AUpdateSound2_3
90labelLabel_CF39UpdateSound2_4
91labelLabel_CF96UpdateSound3_1
92labelLabel_CFBAUpdateSound3_3
93labelLabel_CFBAUpdateSound3_4
94labelLabel_CFC5UpdateSound3_5
95labelLabel_CFF9UpdateSound4_1
96labelLabel_D01BUpdateSound4_3
97labelLabel_D042UpdateSound4_4
98labelLabel_D044UpdateSound4_5
99labelLabel_D08EUpdateSound4_6
100labelLabel_D08FUpdateSound4_7
101labelLabel_D114UpdateSound4_8
102labelLabel_D117UpdateSound4_9
103labelLabel_D114UpdateSound4_10
104labelLabel_D117UpdateSound4_11
105labelLabel_D12BUpdateSound5_1
106labelLabel_D131UpdateSound5_3
107labelLabel_D160UpdateSound6
108labelLabel_D19AUpdateSound7
109labelLabel_D1A4UpdateSound8_1
110labelLabel_D1AAUpdateSound8_3
111labelLabel_D1CFUpdateSound9
112labelLabel_D208UpdateSound10
113labelLabel_D25DUpdateSound11
114labelLabel_D275UpdateSound12_1
115labelLabel_D28BUpdateSound12_3
116labelLabel_D2CBUpdateSound12_4
117labelLabel_D2DFUpdateSound13_1
118labelLabel_D2FDUpdateSound13_3
119labelLabel_D323UpdateSound14
120labelLabel_D326UpdateSound15_1
121labelLabel_D32FUpdateSound15_3
122labelLabel_D360UpdateSound16_1
123labelLabel_D36AUpdateSound16_3
124labelLabel_D37BUpdateSound16_4
125labelLabel_D37EUpdateSound17
126labelLabel_D3AAUpdateSound18
127labelLabel_D3CCUpdateSound19_1
128labelLabel_D4A1UpdateSound19_3
129labelLabel_D4B9UpdateSound19_4
130labelLabel_D4CFUpdateSound19_5
131labelLabel_D4F0UpdateSound20
132labelLabel_D5C1UpdateSound21_1
133labelLabel_D5D1UpdateSound21_3
134labelLabel_D5F5UpdateSound22_1
135labelLabel_D6A8UpdateSound22_3
136labelLabel_D730UpdateSound23_1
137labelLabel_D739UpdateSound23_3
138labelLabel_DBB6UpdateSound24_1
139labelLabel_DBC8UpdateSound24_3
140labelLabel_DBE3UpdateSound25_1
141labelLabel_DBFAUpdateSound25_3
142labelLabel_DC0DUpdateSound26_1
143labelLabel_DC11UpdateSound26_3
144labelLabel_DC3EUpdateSound26_4
145labelLabel_DCAAUpdateSound26_5
146labelLabel_DCDDUpdateSound26_6
147labelLabel_DCE3UpdateSound26_7
148labelLabel_DCECUpdateSound26_8
149labelLabel_DD32UpdateSound26_9
150labelLabel_DD5DUpdateSound26_10
151labelLabel_DD75UpdateSound26_11
152labelLabel_DD78UpdateSound26_12
153labelLabel_DD8FUpdateSound26_13
154labelLabel_DD92UpdateSound26_14
155labelLabel_DDA3UpdateSound26_15
156labelLabel_DDACUpdateSound26_16
157labelLabel_DDBEUpdateSound26_17
158labelLabel_DDBEUpdateSound27_1
159labelLabel_DDBEUpdateSound28_1
160labelLabel_DDC7UpdateSound27_3
161labelLabel_DDF1UpdateSound28_3
162labelLabel_DE30UpdateSound29_1
163labelLabel_DE41UpdateSound29_3
164labelLabel_DE63UpdateSound29_4
165labelLabel_DE75UpdateSound30_1
166labelLabel_DE7EUpdateSound30_3
167labelLabel_DE30UpdateSoundEngine
168labelLabel_E023WaitVBlank_3
169labelLabel_E025WaitVBlank2_3
170labelLabel_E02CWaitVBlank3
171labelLabel_E035WaitPPUReady
172labelLabel_E046WaitFrame
173labelLabel_E049InitPPU
174labelLabel_E09BInitSprites_5
175labelLabel_E0E3DrawSprite
176labelLabel_E0EFWritePPU
177labelLabel_E0F6WritePPU2
178labelLabel_E0FDInitGame
179labelLabel_E278UpdateBallTrajectory
180labelLabel_E28AInitSound
181labelLabel_E293InitSprites2_5
182labelLabel_E2A6UpdateBallPhysics
183labelLabel_E3E2UpdateGameMode
184labelLabel_E403CheckGameState
185labelLabel_E40EUpdateDisplay
186labelLabel_E459UpdateDisplay2
187labelLabel_E48CUpdateSprites3_8
188labelLabel_E497UpdateDisplay3
189labelLabel_E4E2UpdateDisplay4
190labelLabel_E506PlaySound
191labelLabel_E535PlaySoundEffect
192labelLabel_E54APlayMusic
193labelLabel_E5B2UpdateMusic
194labelLabel_E609UpdateMusicEngine
195labelLabel_E68FUpdateMusicChannel
196labelLabel_E7ACUpdateMusicChannel2
197labelLabel_E94DUpdateSoundEffects
198labelLabel_E96AUpdateSoundChannel2
199labelLabel_E9EDUpdateSoundChannel3
200labelLabel_EA2FUpdateSoundChannels
201labelLabel_EA50UpdateSoundEffect
202labelLabel_EA58UpdateSoundEffect2
203labelLabel_EAD1UpdateSoundChannel4
204labelLabel_EAE5UpdateSoundChannel5
205labelLabel_EB0DUpdateSoundChannel6
206labelLabel_EB27UpdateSoundChannel7
207labelLabel_EB9DUpdateSoundChannel8
208labelLabel_EBF9UpdateSoundChannel9
209labelLabel_EC80UpdateMusic2
210labelLabel_EC8DUpdateMusicChannel10
211labelLabel_ED06UpdateMusicChannel11
212labelLabel_EDB0UpdateMusicChannel12
213labelLabel_EDEDUpdateMusicChannel13
214labelLabel_EDF2UpdateMusicChannel14
215labelLabel_EE3DUpdateMusicChannel15
216labelLabel_EE4DUpdateMusicChannel16
217labelLabel_EF28UpdateMusicChannel17
218labelLabel_EF79UpdateMusicChannel18
219labelLabel_EFD3UpdateMusicChannel19
220labelLabel_EFDCUpdateMusicChannel20
221labelLabel_F03FUpdateMusicChannel21
222labelLabel_F06FUpdateMusicChannel22
223labelLabel_F0C4UpdateMusicChannel23
224labelLabel_F0DFUpdateMusicChannel24
225labelLabel_F0E7UpdateMusicChannel25
226labelLabel_F138UpdateMusicChannel26
227labelLabel_F140UpdateMusicChannel27_1
228labelLabel_F1FBUpdateMusicChannel27_3
229labelLabel_F226UpdateMusicChannel29
230labelLabel_F2F0UpdateMusicChannel30
231labelLabel_F321UpdateMusicChannel31_1
232labelLabel_F3B9UpdateMusicChannel32_1
233labelLabel_F3E8UpdateMusicChannel31_3
234labelLabel_F41EUpdateMusicChannel32_3
235labelLabel_F44BUpdateMusicChannel33
236labelLabel_FB2CUpdateAPU
237labelLabel_FB40UpdateAPU2
238labelLabel_FB43UpdateAPU3
239labelLabel_FB46UpdateAPU4
240labelLabel_FB49UpdateAPU5
241labelLabel_FB5DUpdateAPU6
242labelLabel_FB6EUpdateAPU7
243labelLabel_FBDDUpdateAPU8
244labelLabel_FC0FUpdateAPU9
245labelLabel_FC2BUpdateAPU10
246labelLabel_FC72UpdateAPU11
247labelLabel_FCE2UpdateAPU12
248labelLabel_FD0DUpdateAPU13
249labelLabel_FD55UpdateAPU14
250labelLabel_FD91UpdateAPU15
251labelLabel_FFDCUpdateAPU16
252labelLabel_FFE3UpdateAPU17
253labelLabel_FFE9UpdateAPU18
254labelLabel_FFF0UpdateAPU19
255labelLabel_FFF7ResetVector
256zpZp00TempPtrLo
257zpZp01TempPtrHi
258zpZp02TempReg
259zpZp03TempReg2
260zpZp04TempReg3
261zpZp05TempReg3
262zpZp06TempReg4
263zpZp07TempReg5
264zpZp08TempReg6
265zpZp09TempReg7
266zpZp0ATempReg8
267zpZp0BTempReg9
268zpZp0CTempReg10
269zpZp0DTempReg11
270zpZp0ETempReg12
271zpZp0FTempReg13
272zpZp10PPUCtrlShadow
273zpZp11PPUMaskShadow
274zpZp12PPUScrollX
275zpZp13PPUScrollY
276zpZp14TempReg14
277zpZp15TempReg15
278zpZp16TempReg16
279zpZp17TempReg17
280zpZp18TempReg17
281zpZp19TempReg18
282zpZp1ATempReg18
283zpZp1BTempReg19
284zpZp1CTempReg20
285zpZp1DTempReg21
286zpZp1ETempReg22
287zpZp1FTempReg23
288zpZp20TempReg24
289zpZp21TempReg25
290zpZp22TempReg26
291zpZp23TempReg27
292zpZp24TempReg28
293zpZp25TempReg29
294zpZp26TempReg30
295zpZp27TempReg31
296zpZp28TempReg32
297zpZp29TempReg33
298zpZp2ATempReg34
299zpZp2BTempReg35
300zpZp2CTempReg36
301zpZp2DTempReg37
302zpZp2ETempReg38
303zpZp2FTempReg39
304zpZp30TempReg40
305zpZp31TempReg41
306zpZp32TempReg42
307zpZp33TempReg43
308zpZp34TempReg44
309zpZp35TempReg45
310zpZp36TempReg46
311zpZp37TempReg47
312zpZp38TempReg48
313zpZp39TempReg49
314zpZp3ATempReg50
315zpZp3BTempReg51
316zpZp3CTempReg52
317zpZp3DTempReg53
318zpZp3ETempReg54
319zpZp3FTempReg55
320zpZp40TempReg56
321zpZp41TempReg57
322zpZp42TempReg58
323zpZp43TempReg59
324zpZp44TempReg60
325zpZp45TempReg61
326zpZp46TempReg62
327zpZp47TempReg63
328zpZp48TempReg64
329zpZp49TempReg65
330zpZp4ATempReg66
331zpZp4BTempReg67
332zpZp4CTempReg68
333zpZp4DTempReg69
334zpZp4ETempReg70
335zpZp4FTempReg74
336zpZp50TempReg75
337zpZp51TempReg76
338zpZp52TempReg77
339zpZp53TempReg78
340zpZp54TempReg79
341zpZp55TempReg80
342zpZp56TempReg81
343zpZp57TempReg82
344zpZp58TempReg83
345zpZp59TempReg84
346zpZp5ATempReg85
347zpZp5BTempReg86
348zpZp5CTempReg87
349zpZp5DTempReg88
350zpZp5ETempReg89
351zpZp5FTempReg90
352zpZp5FTempReg91
353zpZp60TempReg92
354zpZp61TempReg93
355zpZp62TempReg94
356zpZp63TempReg95
357zpZp64TempReg96
358zpZp65TempReg97
359zpZp66TempReg98
360zpZp67TempReg99
361zpZp68TempReg100
362zpZp6ATempReg101
363zpZp6BTempReg102
364zpZp6CTempReg103
365zpZp6DTempReg104
366zpZp6ETempReg105
367zpZp6FTempReg106
368zpZp70TempReg107
369zpZp71TempReg108
370zpZp72TempReg109
371zpZp73TempReg110
372zpZp74TempReg111
373zpZp75TempReg112
374zpZp76TempReg113
375zpZp77TempReg114
376zpZp78TempReg114
377zpZp79TempReg115
378zpZp7ATempReg115
379zpZp7BTempReg116
380zpZp7CTempReg117
381zpZp7DTempReg118
382zpZp7ETempReg119
383zpZp7FTempReg120
384zpZp80TempReg122
385zpZp81TempReg123
386zpZp82TempReg124
387zpZp83TempReg125
388zpZp84TempReg126
389zpZp85TempReg127
390zpZp86TempReg128
391zpZp87TempReg129
392zpZp88TempReg130
393zpZp89TempReg131
394zpZp8ATempReg132
395zpZp8BTempReg133
396zpZp8CTempReg134
397zpZp8DTempReg135
398zpZp8ETempReg136
399zpZp8FTempReg137
400zpZp90TempReg138
401zpZp91TempReg139
402zpZp92TempReg140
403zpZp93TempReg141
404zpZp94TempReg142
405zpZp95TempReg143
406zpZp96TempReg144
407zpZp97TempReg145
408zpZp98TempReg146
409zpZp99TempReg146
410zpZp9ATempReg147
411zpZp9BTempReg148
412zpZp9CTempReg149
413zpZp9DTempReg150
414zpZp9ETempReg151
415zpZp9FTempReg152
416zpZpA0TempReg153
417zpZpA1TempReg154
418zpZpA2TempReg155
419zpZpA3TempReg156
420zpZpA4TempReg157
421zpZpA5TempReg158
422zpZpA6TempReg160
423zpZpA7TempReg161
424zpZpA8TempReg162
425zpZpA9TempReg163
426zpZpAATempReg164
427zpZpABTempReg164
428zpZpACTempReg165
429zpZpADTempReg166
430zpZpAETempReg167
431zpZpAFTempReg168
432zpZpB0TempReg169
433zpZpB1TempReg170
434zpZpB2TempReg171
435zpZpB3TempReg172
436zpZpB4TempReg173
437zpZpB5TempReg174
438zpZpB6TempReg175
439zpZpB7TempReg176
440zpZpB8TempReg177
441zpZpB9TempReg177
442zpZpBATempReg178
443zpZpBBTempReg179
444zpZpBCTempReg180
445zpZpBDTempReg181
446zpZpBETempReg182
447zpZpBFTempReg183
448zpZpC0TempReg184
449zpZpC1TempReg185
450zpZpC2TempReg186
451zpZpC3TempReg187
452zpZpC4TempReg188
453zpZpC5TempReg189
454zpZpC6TempReg190
455zpZpC7TempReg191
456zpZpC8TempReg192
457zpZpC9TempReg193
458zpZpCATempReg194
459zpZpCBTempReg195
460zpZpCCTempReg196
461zpZpCDTempReg197
462zpZpCETempReg198
463zpZpCFTempReg199
464zpZpD0TempReg185
465zpZpD1TempReg186
466zpZpD2TempReg187
467zpZpD3TempReg188
468zpZpD4TempReg189
469zpZpD5TempReg190
470zpZpD6TempReg191
471zpZpD7TempReg192
472zpZpD8TempReg193
473zpZpD9TempReg194
474zpZpDATempReg195
475zpZpDBTempReg196
476zpZpDCTempReg197
477zpZpDDTempReg198
478zpZpDETempReg199
479zpZpDFTempReg200
480zpZpE0TempReg201
481zpZpE1TempReg202
482zpZpE2TempReg203
483zpZpE3TempReg204
484zpZpE4TempReg205
485zpZpE5TempReg206
486zpZpE6TempReg207
487zpZpE7TempReg208
488zpZpE8TempReg209
489zpZpE9TempReg210
490zpZpEATempReg211
491zpZpEBTempReg212
492zpZpECTempReg213
493zpZpEDTempReg214
494zpZpEETempReg215
495zpZpEFTempReg216
496zpZpF0TempReg217
497zpZpF1TempReg218
498zpZpF2TempReg219
499zpZpF3TempReg220
500zpZpF4TempReg221
501zpZpF5TempReg222
502zpZpF6TempReg223
503zpZpF7TempReg224
504zpZpF8TempReg225
505zpZpF9TempReg226
506zpZpFATempReg227
507zpZpFBTempReg228
508zpZpFCTempReg229
509zpZpFDTempReg230
510zpZpFETempReg231
511zpZpFFTempReg233
Reference in new issue View Git Blame Copy Permalink