tmerritt/disasm
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Promote Donkey Kong (JU): Pass 3 complete, whole-ROM byte-identical

Browse Source 
Pass 3 named the 10 data regions in prg.s, then the project was promoted
out of _wip/ so `make` now proves header + PRG + CHR against the original
ROM instead of only the PRG bank.

Data regions named:
  LevelPtrTable        $C000-$C03B  (60 B)    level header data
  ObjectPtrTable       $C03C-$C043  (8 B)     4 pointer pairs
  LevelDataPtrTable    $C044-$C79D  (1882 B)  level data pointers
  SpriteInitPtrTable   labelled at $C4B0      see residue note
  UnreachedCode_D650   $D650-$D696  (71 B)    unreached code
  UnreachedCode_E144   $E144-$E165  (34 B)    unreached code
  MusicDataTable       $F55B-$FA47  (1261 B)  music/sound data
  APUDataTable         $FAE6-$FB74  (143 B)   APU pulse/noise tables
  SfxDataTable         $FE59-$FFEF  (407 B)   sound-effect data
  VectorTable          $FFF6-$FFFF  (10 B)    padding + NMI/RESET/IRQ

Promotion (per the AGENTS.md checklist):
  - git mv "_wip/Donkey Kong (JU)" "Donkey Kong (JU)"
  - add copilot/rom.nes -> ../Donkey Kong (JU).nes symlink
  - add header.s / chr.s (one-line .incbin of header.bin / chr.bin)
  - linker.cfg gains HEADER ($0000/16 B) and CHR ($0000/8 KB)
  - Makefile switched from `cmp reconstructed_prg.bin prg.bin` to
    `cmp reconstructed.nes rom.nes`
  - no _tools path change (this Makefile never referenced _tools/)
    and no `make regen` pipeline exists for it

Doc corrections:
  - project OVERVIEW.md said Mirroring Vertical; header byte 6 = $00
    means Horizontal (the root index was right) — fixed
  - root OVERVIEW.md: row 18 now BYTE-IDENTICAL, tier paragraph and
    summary table refreshed (they had drifted around the Lunar Pool and
    Urban Champion promotions), new per-project detail entry
  - counts corrected to 19 top-level / 17 _wip in OVERVIEW.md,
    TODO.md and AGENTS.md

Residue recorded rather than guessed:
  - Pass 2 is partial: 919 Label_ definitions remain (214 semantic
    labels applied); noted in TODO.md so nobody reads the promotion as
    full semantic naming
  - SpriteInitPtrTable's label sits at $C4B0: the routine at $C807 reads
    $C4A7,x/$C4A8,x, but that table starts mid-row and a label there
    would split the canonical 16-byte audit-comment line

Verification:
  make clean && make  -> "Byte-identical ROM verified."
  verify_pass1.py     -> 19/19 top-level build, Donkey Kong (JU) OK
                         (6014 instr / 12505 B), all comments canonical

Doc-drift sweep: build tiers, mirroring, and stale status tails

Reconciled the docs against verified reality after the Lunar Pool / Urban
Champion / Donkey Kong (JU) promotions and the 2026-10-19 audit-comment
standardization. No source behaviour changed except the two build fixes below.

Build tier (whole-ROM vs PRG-only)
  - AGENTS.md: the 17 `_wip/` projects are real disassemblies at the PRG-build
    tier, not "skeletons"; header.s/chr.s/rom.nes are promotion additions;
    verify_pass1.py covers the top-level projects.
  - Root OVERVIEW.md: `_wip` prose, audit-comment narrative and summary table
    refreshed (37.5% figure, SEEDED vs OK wording, re-trace false alarm).
  - Promoted projects whose build blocks still claimed `make` emits
    `reconstructed_prg.bin` compared to `prg.bin` (Balloon Fight, Baseball,
    CIRCUS, Clu Clu Land, Excitebike, NES PowerPad, Pac-Man (USA), Tennis):
    now describe the whole-ROM `reconstructed.nes` vs `rom.nes`.
  - Lunar Pool / Urban Champion / CIRCUS also had stale `cd "_wip/..."`
    build paths and "Promotion" items; retargeted to their top-level folders.

Mirroring (header byte 6 bit 0: 0 = Horizontal, 1 = Vertical)
  - Corrected DK Jr. prose "horizontal mirroring (flag 6 = $01)" -> vertical,
    and both `_wip/Pac-Man` variant notes "Both use vertical mirroring" ->
    horizontal (both are byte-6 = $00).
  - Re-audited every project OVERVIEW: 0 rows and 0 prose claims now disagree.

Stale status tails
  - Retitled/restatused the `_wip` OVERVIEWs to their real `prg.s` (Golf,
    Ice Climber (U), Lode Runner, Millipede, Pac-Man Tengen, Pac-Man (U),
    Popeye 0/1, Raid, Raid a2, Hogan's Alley, Mario Bros); Golf's
    skeleton-era contents rows and Next Steps corrected.
  - Dropped the skeleton-era "## Next Steps (per `PROMPTS.md`)" heading and
    the "(from the skeleton)" wording across all project OVERVIEWs.
  - Rewrote Lunar Pool / Urban Champion Next Steps (both already Pass 1-3
    complete and promoted; their tails still described pending Pass 2 and
    promotion); fixed root row 13 (Wild Gunman) and row 20 (Duck Hunt).

Also lands two code fixes carried with this sweep:
  - `_wip/Hogan's Alley (JU)`: $E9F1-$E9FD and $EA13-$EA14 reclassified as
    data with canonical audit comments (the seeded build had decoded a data
    table base as code, breaking the build since 2ae09f7). `make` ->
    BYTE-IDENTICAL again; reconstructed_prg.bin/.lbl refreshed.
  - `_wip/Pyramid (U)`: `Label_D72E` -> `NMI:` (byte-identical).

Verification:
  make (Hogan's Alley, Pyramid)      -> BYTE-IDENTICAL, BYTE-IDENTICAL
  _tools/verify_pass1.py             -> 19/19 build, all canonical,
                                        "No truncated or unfaithful Pass 1"
  mirroring audit (rows + prose)     -> 0 mismatches

Donkey Kong (JU): complete Pass 2 — all 919 Label_ definitions named

The last non-zero Label_ residue in the repo is now gone. Every one of the
919 address-derived definitions in copilot/prg.s is replaced:

* 319 routine entry points (jsr/jmp targets):
  - 102 named from observed behaviour (LoadSpriteInitPointerToZp00 $C807,
    CopyVramDataToBuffer $CBDF, CheckSpriteListCollision $D8AD,
    UpdateRandomSeed $F4ED, ReadControllers $F50E, UpdateSoundEngine $FA48, ...)
  - 217 left as SubC<addr> — honest residue where the body is too
    context-dependent to name without guessing (Golf: 108, Mario Bros: 223)
  - the 77 already-named entries untouched
* 600 internal branch targets named <Routine>_Block / <Routine>_Block_n in
  address order within their owning routine (DK Jr./Balloon Fight convention).
  Ownership is control-flow containment, so a loop that physically precedes
  its own entry lands correctly (FlushPpuBuffer_Block $F1EC under $F228).
* Two proposal collisions disambiguated by indexing zero-page slot:
  UpdateObjectListZp5D/DispatchObjectStateZp5E ($DA16/$DA4C) vs
  UpdateObjectListZpAE/DispatchObjectStateZpAF ($E1E9/$E250).

jsr/jmp operands stay numeric (Wild Gunman style); only branch operands are
symbolic. Applied with _tools/pass2.py apply (919 defs + 2,622 refs rewritten,
comments re-aligned); the ROM still rebuilds byte-identically and
verify_pass1.py reports 19/19 canonical with no truncated split.

Docs synced: project OVERVIEW.md gains a Pass 2 Details section, root
OVERVIEW.md rows + conventions, TODO.md section 4 closed. dk_full_map.tsv now
records the complete applied map (its zp rows remain unapplied proposals).

_wip status correction: five false "Pass 2 complete" claims + map audit

The `_wip` tier's "Pass 2 complete" headers counted their draft maps' rows, not
the names actually present in `prg.s`, and described the count of *neutral*
`ZpXX` slots in `locals.inc` as "zero-page semantic aliases". Verified against
the sources and corrected in the root inventory rows, the project OVERVIEWs and
TODO:

  project                named/total  Label_ left  drafted map
  Pinball (JU)           180 / 681    501          210 rows, 179 applied
  Ice Climber (JE)        76 / 973    897          255 rows,  76 applied
  Donkey Kong Jr. Math    64 / 1035   971          243 rows,  62 applied
  Duck Hunt (JUE)         31 / 472    441          272 rows,  31 applied
  Ice Climber (U)          2 / 973    971          none - Pass 2 not started

No `_wip` project is Pass 2 complete. Ice Climber (U) was the worst case: the
2026-10-19 sweep itself restated it "Pass 2 complete" while describing its 971
`Label_` definitions in the same paragraph - a copy-paste from (JE); (U) has no
map file at all.

Drafted maps audited row by row against the committed split: they are not
applicable. 100/243 (DK Jr. Math), 96/255 (Ice Climber (JE)) and 17/210
(Pinball) rows point at addresses that are not instruction boundaries - they
were built against an older code/data split - while most of the rest are
unlabelled boundaries that no operand references, or (Duck Hunt) competing
candidate names for one label (`Label_C2BF` alone carries 205). Rows that are
both insertable and corroborated by control flow: 0 in every map. Recorded as
stale and kept for provenance; Pass 2 here needs a fresh map derived from the
committed split.

Also corrected while verifying:
- Mario Bros entry counts (docs said 252 / 90 + 165 / 477 sites / 156 neutral
  slots; the file holds 262 distinct `jsr`/`jmp` targets = 39 semantic + 223
  `SubC<addr>`, 478 sites, 151 slots).
- root `_wip` prose line/label ranges (4,482-17,180 lines, 192-971 `Label_`,
  11,126 total) and the Ice Climber code figure (74.6% / 6,112 instr, not
  74.7% / 6,113).
- TODO §4 re-scoped to the promoted tier, with the `_wip` residue table added.

Verification: `make` across all 17 `_wip` projects -> BYTE-IDENTICAL (17/17);
`_tools/verify_pass1.py` -> 19/19 build, all canonical, "No truncated or
unfaithful Pass 1 found". No source bytes changed.

Balloon Fight (JU): apply locals.inc/symbols.inc names to prg.s (Pass 3)

Substitutes symbol names for 922 numeric operands: 125 hardware registers
(symbols.inc) and 797 of 813 zero-page/RAM operands (locals.inc). The 15
multi-alias addresses were resolved per routine; 16 operands stay numeric
because $13 is used there as a plain high-byte scratch beside Temp12 and
none of its three aliases fits.

- _tools/apply_symbols.py: the substitution tool (dry run by default;
  --sites supplies per-routine choices for multi-alias addresses, --report
  lists the residue). Only the operand token is rewritten, so the
  `; CPU:$.... PRG:....  XX XX` audit comments survive byte for byte.
- prg.s: operand tokens only. make prints "Byte-identical ROM verified."
- OVERVIEW.md (project): instruction quotes now match prg.s, new
  alias-reuse table, and section 10 rewritten from the stale "497 Label_"
  prose to the real naming state and the 16-site residue.
- OVERVIEW.md (root), TODO.md, AGENTS.md: status, counts, tool list.

verify_pass1.py: 19/19 OK, all audit comments canonical.

Bomberman (U): apply locals.inc/symbols.inc names to prg.s (Pass 3)

Substitutes 362 zero-page operands in copilot/prg.s with the names already
declared in copilot/locals.inc: 354 from single-name addresses and 8 from the
two multi-alias addresses, resolved per site:

  $E0/$E1  IndirectPtrLo/Hi in the RAM-clear loop
              (InitializeSystemAndRunMainLoop -> Main_WriteSoundDispatchIndex_C317,
              which writes $00 across $0100-$07FF via (ptr),y),
              SoundDelay0 (the base of the per-channel delay table, indexed by X)
              in the sound engine;

No symbols.inc substitution was needed: copilot/prg.s contains no numeric
hardware operands ($2000-$4017) at all. All 362 operands were already written
with two hex digits, so no ca65 `a:` prefix was required.

make -> Byte-identical ROM verified. Operand token only; mnemonics, spacing and
the trailing `; CPU:$.... PRG:....  XX XX` audit comments are untouched.

Remaining numeric operands (758) address bytes that no .inc file names:
505 zero-page (133 addresses), 171 RAM $0100-$07FF (46 addresses) and 82
table reads in $8000+ (54 addresses).

Bomberman (U): substitute 24 in-file table labels at ROM operand sites

Uses the new `--labels` option of `apply_symbols.py` with the
ld65 `-Ln` output (`reconstructed.lbl`). Only labels that prg.s
actually defines and that live in the PRG (+) are considered,
so CHR/header segment labels cannot leak in.

24 numeric operands (`lda ,x`, `adc ,y`, etc.) now read
`lda SystemPaletteData,x`, `adc GameplayObjectClassTable,y`, etc.
All 24 point at exact label addresses; the remaining 58 ROM-space
numeric operands point at interior bytes or unlabelled tables and
stay numeric.

make -> Byte-identical ROM verified.

Bomberman (U): update docs for Pass 3 symbol application

- Project OVERVIEW.md: corrected source file from main.s to prg.s/header.s/chr.s;
  output name from reconstructed_bomberman.nes to reconstructed.nes;
  rewritten §10 Zero-Page/RAM Symbols table to match locals.inc (with aliases
  and unnamed residue documented);
  fixed §4 step 1/4 to use IndirectPtrLo/Hi and SoundDelay0 names;
  fixed §11 InesHeader location (now header.s);
  added §2 Pass 3 summary table;
  added §13 notes on legacy main.s and Main_WriteSoundDispatchIndex_C317 misnomer.

- Root OVERVIEW.md §3: updated source line count (7,553), file list, and added
  Pass 3 summary.

Both builds verified byte-identical.

Pass 3 symbol application to all 19 top-level projects (2026-10-19)

Ran _tools/apply_symbols.py --write on all 19 promoted projects to substitute
symbolic names from symbols.inc (hardware registers) and locals.inc (zero-page
RAM aliases, forward references) into prg.s operands. The tool preserves the
canonical audit comments (; CPU:$XXXX PRG:XXXX AA BB) and preserves byte
identity — all projects still rebuild byte-identical to their original ROMs.

Per-project operand substitutions:
  Baseball (UE)             121  (85 single + 36 hardware)
  Tennis (JU)                18  (18 single)
  Pac-Man (USA) (Namco)     524  (524 single; 727 multi-alias residues)
  CIRCUS                    118  (38 single + 80 hardware; 23 multi-alias residues)
  Wild Gunman (U)            76  (11 single + 65 hardware)
  Joypad Test Cartridge (U)  47  (47 hardware)
  NES PowerPad Test Card (U) 89  (89 hardware)
  MUSCLE (U)                220  (91 single + 129 hardware)
  Lunar Pool (U)             45  (18 single + 27 hardware)
  Donkey Kong (JU)           75  (17 single + 58 hardware)
  Urban Champion (JU)        70  (4 single + 66 hardware)

Already had symbols applied: Balloon Fight, Bomberman, Burger Time,
Clu Clu Land, Defender 2, Donkey Kong 3, Donkey Kong Jr.

Skipped: Excitebike (JU) — inline prg.s definitions conflict with locals.inc
values and source operands don't match ROM byte encodings; automatic
substitution breaks byte identity.

Documentation updated:
  OVERVIEW.md — added Pass 3 symbol notes to all 19 project entries,
  added Urban Champion as section #36
  TODO.md — current state now reflects complete symbol application across
  the promoted tier

Verification: python3 _tools/verify_pass1.py reports all 19 projects OK/SEEDED,
all canonical comments, no truncated or unfaithful Pass 1.
This commit is contained in:
tmerritt committed 2026-10-19 14:55:08 -04:00
1 parent 53ad50ffb6
commit 71ada15de0
79 files changed
+9455 -7687
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

Lunar Pool (U)/copilot/prg.s
+45 -45
View File
@@ -982,7 +982,7 @@ UpdateObjectSound:
; Clobbers: Undetermined in Pass 1.
; -----------------------------------------------------------------------------
UpdateObjectSound_Silence:
sta a:$006F,y ; CPU:$C321 PRG:0321 99 6F 00
sta a:Zp6F,y ; CPU:$C321 PRG:0321 99 6F 00
dey ; CPU:$C324 PRG:0324 88
bne UpdateObjectSound_Silence ; CPU:$C325 PRG:0325 D0 FA
sta $05F0 ; CPU:$C327 PRG:0327 8D F0 05
@@ -1030,7 +1030,7 @@ UpdateObjectSound_Emit:
asl a ; CPU:$C341 PRG:0341 0A
tay ; CPU:$C342 PRG:0342 A8
lda #$00 ; CPU:$C343 PRG:0343 A9 00
sta a:$0070,y ; CPU:$C345 PRG:0345 99 70 00
sta a:Zp70,y ; CPU:$C345 PRG:0345 99 70 00
sta a:$0071,y ; CPU:$C348 PRG:0348 99 71 00
sta a:$0072,y ; CPU:$C34B PRG:034B 99 72 00
sta a:$0073,y ; CPU:$C34E PRG:034E 99 73 00
@@ -1041,7 +1041,7 @@ UpdateObjectSound_Emit:
ora $0541,x ; CPU:$C35C PRG:035C 1D 41 05
bne UpdateObjectSound_Sustain ; CPU:$C35F PRG:035F D0 3E
lda #$01 ; CPU:$C361 PRG:0361 A9 01
sta a:$0070,y ; CPU:$C363 PRG:0363 99 70 00
sta a:Zp70,y ; CPU:$C363 PRG:0363 99 70 00
sta a:$0072,y ; CPU:$C366 PRG:0366 99 72 00
sta a:$0073,y ; CPU:$C369 PRG:0369 99 73 00
lda $0546,x ; CPU:$C36C PRG:036C BD 46 05
@@ -1098,7 +1098,7 @@ UpdateObjectSound_Sustain:
lda $056E,x ; CPU:$C3A3 PRG:03A3 BD 6E 05
sta $05E0,y ; CPU:$C3A6 PRG:03A6 99 E0 05
lda #$01 ; CPU:$C3A9 PRG:03A9 A9 01
sta a:$0070,y ; CPU:$C3AB PRG:03AB 99 70 00
sta a:Zp70,y ; CPU:$C3AB PRG:03AB 99 70 00
; -----------------------------------------------------------------------------
; Routine: UpdateObjectSound_CheckVolume
; Global: Contextual control-flow entry identified from its parent routine and incoming branch usage.
@@ -2333,16 +2333,16 @@ DrainVramQueue:
; Clobbers: Undetermined in Pass 1.
; -----------------------------------------------------------------------------
DrainVramQueue_Slot:
lda a:$00D0,y ; CPU:$CC91 PRG:0C91 B9 D0 00
lda a:vram_slot_len,y ; CPU:$CC91 PRG:0C91 B9 D0 00
beq DrainVramQueue_NextSlot ; CPU:$CC94 PRG:0C94 F0 24
tax ; CPU:$CC96 PRG:0C96 AA
lda a:$00D3,y ; CPU:$CC97 PRG:0C97 B9 D3 00
lda a:vram_slot_addr_hi,y ; CPU:$CC97 PRG:0C97 B9 D3 00
sta PPUADDR ; CPU:$CC9A PRG:0C9A 8D 06 20
lda a:$00D2,y ; CPU:$CC9D PRG:0C9D B9 D2 00
lda a:vram_slot_addr_lo,y ; CPU:$CC9D PRG:0C9D B9 D2 00
sta PPUADDR ; CPU:$CCA0 PRG:0CA0 8D 06 20
tya ; CPU:$CCA3 PRG:0CA3 98
pha ; CPU:$CCA4 PRG:0CA4 48
lda a:$00D1,y ; CPU:$CCA5 PRG:0CA5 B9 D1 00
lda a:vram_slot_ofs,y ; CPU:$CCA5 PRG:0CA5 B9 D1 00
tay ; CPU:$CCA8 PRG:0CA8 A8
; -----------------------------------------------------------------------------
; Routine: DrainVramQueue_CopyLoop
@@ -2354,7 +2354,7 @@ DrainVramQueue_Slot:
; Clobbers: Undetermined in Pass 1.
; -----------------------------------------------------------------------------
DrainVramQueue_CopyLoop:
lda a:$00A0,y ; CPU:$CCA9 PRG:0CA9 B9 A0 00
lda a:vram_buf,y ; CPU:$CCA9 PRG:0CA9 B9 A0 00
sta PPUDATA ; CPU:$CCAC PRG:0CAC 8D 07 20
iny ; CPU:$CCAF PRG:0CAF C8
dex ; CPU:$CCB0 PRG:0CB0 CA
@@ -2362,7 +2362,7 @@ DrainVramQueue_CopyLoop:
pla ; CPU:$CCB3 PRG:0CB3 68
tay ; CPU:$CCB4 PRG:0CB4 A8
lda #$00 ; CPU:$CCB5 PRG:0CB5 A9 00
sta a:$00D0,y ; CPU:$CCB7 PRG:0CB7 99 D0 00
sta a:vram_slot_len,y ; CPU:$CCB7 PRG:0CB7 99 D0 00
; -----------------------------------------------------------------------------
; Routine: DrainVramQueue_NextSlot
; Global: Contextual control-flow entry identified from its parent routine and incoming branch usage.
@@ -2432,7 +2432,7 @@ FlushPaletteToPpu:
; Clobbers: Undetermined in Pass 1.
; -----------------------------------------------------------------------------
FlushPaletteToPpu_Loop:
lda a:$0080,y ; CPU:$CCF3 PRG:0CF3 B9 80 00
lda a:palette_shadow,y ; CPU:$CCF3 PRG:0CF3 B9 80 00
sta PPUDATA ; CPU:$CCF6 PRG:0CF6 8D 07 20
iny ; CPU:$CCF9 PRG:0CF9 C8
dex ; CPU:$CCFA PRG:0CFA CA
@@ -3528,9 +3528,9 @@ PlaceFieldTile_Done:
; -----------------------------------------------------------------------------
UploadFieldMap:
lda #$24 ; CPU:$D1BB PRG:11BB A9 24
sta $2006 ; CPU:$D1BD PRG:11BD 8D 06 20
sta PPUADDR ; CPU:$D1BD PRG:11BD 8D 06 20
lda #$00 ; CPU:$D1C0 PRG:11C0 A9 00
sta $2006 ; CPU:$D1C2 PRG:11C2 8D 06 20
sta PPUADDR ; CPU:$D1C2 PRG:11C2 8D 06 20
ldx #$06 ; CPU:$D1C5 PRG:11C5 A2 06
ldy #$00 ; CPU:$D1C7 PRG:11C7 A0 00
jsr $CBA9 ; CPU:$D1C9 PRG:11C9 20 A9 CB
@@ -3617,7 +3617,7 @@ UploadFieldMap_Found:
; -----------------------------------------------------------------------------
UploadFieldMap_Store:
ldy #$00 ; CPU:$D1FB PRG:11FB A0 00
sta $2007 ; CPU:$D1FD PRG:11FD 8D 07 20
sta PPUDATA ; CPU:$D1FD PRG:11FD 8D 07 20
jsr $CB5F ; CPU:$D200 PRG:1200 20 5F CB
lda ppu_addr_hi ; CPU:$D203 PRG:1203 A5 FD
cmp #$08 ; CPU:$D205 PRG:1205 C9 08
@@ -7851,9 +7851,9 @@ DrawStageBanner:
; ---- data $EBF3-$EBF7 (5 bytes) ----
.byte $61, $67, $65, $3B, $00 ; CPU:$EBF3 PRG:2BF3 61 67 65 3B 00
lda Zp0D ; CPU:$EBF8 PRG:2BF8 A5 0D
sta $2007 ; CPU:$EBFA PRG:2BFA 8D 07 20
sta PPUDATA ; CPU:$EBFA PRG:2BFA 8D 07 20
lda Zp0E ; CPU:$EBFD PRG:2BFD A5 0E
sta $2007 ; CPU:$EBFF PRG:2BFF 8D 07 20
sta PPUDATA ; CPU:$EBFF PRG:2BFF 8D 07 20
jsr $CBC9 ; CPU:$EC02 PRG:2C02 20 C9 CB
; ---- data $EC05-$EC0B (7 bytes) ----
.byte $3B, $73, $74, $61, $72, $74, $00 ; CPU:$EC05 PRG:2C05 3B 73 74 61 72 74 00
@@ -7944,7 +7944,7 @@ LoadStageScene_PlaceBalls:
; Clobbers: Undetermined in Pass 1.
; -----------------------------------------------------------------------------
LoadStageScene_VaryTiles:
lda $2007 ; CPU:$EC87 PRG:2C87 AD 07 20
lda PPUDATA ; CPU:$EC87 PRG:2C87 AD 07 20
tax ; CPU:$EC8A PRG:2C8A AA
cmp #$DE ; CPU:$EC8B PRG:2C8B C9 DE
bne LoadStageScene_VaryTiles_Next ; CPU:$EC8D PRG:2C8D D0 1F
@@ -7970,9 +7970,9 @@ LoadStageScene_VaryTiles:
; -----------------------------------------------------------------------------
LoadStageScene_VaryTiles_Write:
jsr $CAA3 ; CPU:$ECA2 PRG:2CA2 20 A3 CA
stx $2007 ; CPU:$ECA5 PRG:2CA5 8E 07 20
stx PPUDATA ; CPU:$ECA5 PRG:2CA5 8E 07 20
jsr $CAAE ; CPU:$ECA8 PRG:2CA8 20 AE CA
lda $2007 ; CPU:$ECAB PRG:2CAB AD 07 20
lda PPUDATA ; CPU:$ECAB PRG:2CAB AD 07 20
; -----------------------------------------------------------------------------
; Routine: LoadStageScene_VaryTiles_Next
; Global: Contextual control-flow entry identified from its parent routine and incoming branch usage.
@@ -7994,11 +7994,11 @@ LoadStageScene_VaryTiles_Next:
cmp #$02 ; CPU:$ECC0 PRG:2CC0 C9 02
bne LoadStageScene_LoadLayout ; CPU:$ECC2 PRG:2CC2 D0 0F
lda #$20 ; CPU:$ECC4 PRG:2CC4 A9 20
sta $2006 ; CPU:$ECC6 PRG:2CC6 8D 06 20
sta PPUADDR ; CPU:$ECC6 PRG:2CC6 8D 06 20
lda #$82 ; CPU:$ECC9 PRG:2CC9 A9 82
sta $2006 ; CPU:$ECCB PRG:2CCB 8D 06 20
sta PPUADDR ; CPU:$ECCB PRG:2CCB 8D 06 20
lda #$43 ; CPU:$ECCE PRG:2CCE A9 43
sta $2007 ; CPU:$ECD0 PRG:2CD0 8D 07 20
sta PPUDATA ; CPU:$ECD0 PRG:2CD0 8D 07 20
; -----------------------------------------------------------------------------
; Routine: LoadStageScene_LoadLayout
; Global: Contextual control-flow entry identified from its parent routine and incoming branch usage.
@@ -10186,7 +10186,7 @@ FillAttributeTable:
; Clobbers: Undetermined in Pass 1.
; -----------------------------------------------------------------------------
FillAttributeTable_Loop:
sta a:$00FF,x ; CPU:$F66B PRG:366B 9D FF 00
sta a:ppu_addr_src_hi,x ; CPU:$F66B PRG:366B 9D FF 00
dex ; CPU:$F66E PRG:366E CA
bne FillAttributeTable_Loop ; CPU:$F66F PRG:366F D0 FA
jmp $CD9D ; CPU:$F671 PRG:3671 4C 9D CD
@@ -10729,7 +10729,7 @@ StampBallMarker_TopLeft:
jsr $CAF7 ; CPU:$F8C9 PRG:38C9 20 F7 CA
jsr $F989 ; CPU:$F8CC PRG:38CC 20 89 F9
lda #$DA ; CPU:$F8CF PRG:38CF A9 DA
sta $2007 ; CPU:$F8D1 PRG:38D1 8D 07 20
sta PPUDATA ; CPU:$F8D1 PRG:38D1 8D 07 20
; -----------------------------------------------------------------------------
; Routine: StampBallMarker_TopRight
; Global: Contextual control-flow entry identified from its parent routine and incoming branch usage.
@@ -10750,7 +10750,7 @@ StampBallMarker_TopRight:
jsr $CAF7 ; CPU:$F8E3 PRG:38E3 20 F7 CA
jsr $F989 ; CPU:$F8E6 PRG:38E6 20 89 F9
lda #$DB ; CPU:$F8E9 PRG:38E9 A9 DB
sta $2007 ; CPU:$F8EB PRG:38EB 8D 07 20
sta PPUDATA ; CPU:$F8EB PRG:38EB 8D 07 20
; -----------------------------------------------------------------------------
; Routine: StampBallMarker_BottomLeft
; Global: Contextual control-flow entry identified from its parent routine and incoming branch usage.
@@ -10771,7 +10771,7 @@ StampBallMarker_BottomLeft:
jsr $CAF7 ; CPU:$F8FD PRG:38FD 20 F7 CA
jsr $F989 ; CPU:$F900 PRG:3900 20 89 F9
lda #$D9 ; CPU:$F903 PRG:3903 A9 D9
sta $2007 ; CPU:$F905 PRG:3905 8D 07 20
sta PPUDATA ; CPU:$F905 PRG:3905 8D 07 20
; -----------------------------------------------------------------------------
; Routine: StampBallMarker_BottomRight
; Global: Contextual control-flow entry identified from its parent routine and incoming branch usage.
@@ -10793,7 +10793,7 @@ StampBallMarker_BottomRight:
jsr $CAF7 ; CPU:$F918 PRG:3918 20 F7 CA
jsr $F989 ; CPU:$F91B PRG:391B 20 89 F9
lda #$D8 ; CPU:$F91E PRG:391E A9 D8
sta $2007 ; CPU:$F920 PRG:3920 8D 07 20
sta PPUDATA ; CPU:$F920 PRG:3920 8D 07 20
rts ; CPU:$F923 PRG:3923 60
; -----------------------------------------------------------------------------
; Routine: StampBallMarker_IfEmpty
@@ -10809,13 +10809,13 @@ StampBallMarker_IfEmpty:
stx ppu_addr_hi ; CPU:$F927 PRG:3927 86 FD
sty ppu_addr_lo ; CPU:$F929 PRG:3929 84 FC
jsr $F989 ; CPU:$F92B PRG:392B 20 89 F9
lda $2007 ; CPU:$F92E PRG:392E AD 07 20
lda $2007 ; CPU:$F931 PRG:3931 AD 07 20
lda PPUDATA ; CPU:$F92E PRG:392E AD 07 20
lda PPUDATA ; CPU:$F931 PRG:3931 AD 07 20
cmp #$DC ; CPU:$F934 PRG:3934 C9 DC
bcc StampBallMarker_Abort ; CPU:$F936 PRG:3936 90 50
cmp #$DF ; CPU:$F938 PRG:3938 C9 DF
bcs StampBallMarker_Abort ; CPU:$F93A PRG:393A B0 4C
lda $2007 ; CPU:$F93C PRG:393C AD 07 20
lda PPUDATA ; CPU:$F93C PRG:393C AD 07 20
cmp #$DC ; CPU:$F93F PRG:393F C9 DC
bcc StampBallMarker_Abort ; CPU:$F941 PRG:3941 90 45
cmp #$DF ; CPU:$F943 PRG:3943 C9 DF
@@ -10828,27 +10828,27 @@ StampBallMarker_IfEmpty:
adc #$00 ; CPU:$F94F PRG:394F 69 00
tax ; CPU:$F951 PRG:3951 AA
jsr $F989 ; CPU:$F952 PRG:3952 20 89 F9
lda $2007 ; CPU:$F955 PRG:3955 AD 07 20
lda $2007 ; CPU:$F958 PRG:3958 AD 07 20
lda PPUDATA ; CPU:$F955 PRG:3955 AD 07 20
lda PPUDATA ; CPU:$F958 PRG:3958 AD 07 20
cmp #$DC ; CPU:$F95B PRG:395B C9 DC
bcc StampBallMarker_Abort ; CPU:$F95D PRG:395D 90 29
cmp #$DF ; CPU:$F95F PRG:395F C9 DF
bcs StampBallMarker_Abort ; CPU:$F961 PRG:3961 B0 25
lda $2007 ; CPU:$F963 PRG:3963 AD 07 20
lda PPUDATA ; CPU:$F963 PRG:3963 AD 07 20
cmp #$DC ; CPU:$F966 PRG:3966 C9 DC
bcc StampBallMarker_Abort ; CPU:$F968 PRG:3968 90 1E
cmp #$DF ; CPU:$F96A PRG:396A C9 DF
bcs StampBallMarker_Abort ; CPU:$F96C PRG:396C B0 1A
jsr $CAA3 ; CPU:$F96E PRG:396E 20 A3 CA
lda #$DA ; CPU:$F971 PRG:3971 A9 DA
sta $2007 ; CPU:$F973 PRG:3973 8D 07 20
sta PPUDATA ; CPU:$F973 PRG:3973 8D 07 20
lda #$DB ; CPU:$F976 PRG:3976 A9 DB
sta $2007 ; CPU:$F978 PRG:3978 8D 07 20
sta PPUDATA ; CPU:$F978 PRG:3978 8D 07 20
jsr $F989 ; CPU:$F97B PRG:397B 20 89 F9
lda #$D9 ; CPU:$F97E PRG:397E A9 D9
sta $2007 ; CPU:$F980 PRG:3980 8D 07 20
sta PPUDATA ; CPU:$F980 PRG:3980 8D 07 20
lda #$D8 ; CPU:$F983 PRG:3983 A9 D8
sta $2007 ; CPU:$F985 PRG:3985 8D 07 20
sta PPUDATA ; CPU:$F985 PRG:3985 8D 07 20
; -----------------------------------------------------------------------------
; Routine: StampBallMarker_Abort
; Global: Contextual control-flow entry identified from its parent routine and incoming branch usage.
@@ -10870,8 +10870,8 @@ StampBallMarker_Abort:
; Clobbers: none.
; -----------------------------------------------------------------------------
SetPpuAddr:
stx $2006 ; CPU:$F989 PRG:3989 8E 06 20
sty $2006 ; CPU:$F98C PRG:398C 8C 06 20
stx PPUADDR ; CPU:$F989 PRG:3989 8E 06 20
sty PPUADDR ; CPU:$F98C PRG:398C 8C 06 20
rts ; CPU:$F98F PRG:398F 60
; -----------------------------------------------------------------------------
; Routine: SetBallSpriteAttributes
@@ -11661,10 +11661,10 @@ ComputeBallVelocity_Moving:
ldy ppu_addr_src_hi ; CPU:$FC24 PRG:3C24 A4 FF
clc ; CPU:$FC26 PRG:3C26 18
adc Zp24 ; CPU:$FC27 PRG:3C27 65 24
sta a:$0012,y ; CPU:$FC29 PRG:3C29 99 12 00
sta a:Zp12,y ; CPU:$FC29 PRG:3C29 99 12 00
txa ; CPU:$FC2C PRG:3C2C 8A
adc Zp25 ; CPU:$FC2D PRG:3C2D 65 25
sta a:$0013,y ; CPU:$FC2F PRG:3C2F 99 13 00
sta a:Zp13,y ; CPU:$FC2F PRG:3C2F 99 13 00
lda Zp1E ; CPU:$FC32 PRG:3C32 A5 1E
sta ppu_addr_lo ; CPU:$FC34 PRG:3C34 85 FC
lda Zp1F ; CPU:$FC36 PRG:3C36 A5 1F
@@ -11689,10 +11689,10 @@ ComputeBallVelocity_Moving:
ldy ppu_addr_src_hi ; CPU:$FC5D PRG:3C5D A4 FF
sec ; CPU:$FC5F PRG:3C5F 38
sbc Zp24 ; CPU:$FC60 PRG:3C60 E5 24
sta a:$0010,y ; CPU:$FC62 PRG:3C62 99 10 00
sta a:Zp10,y ; CPU:$FC62 PRG:3C62 99 10 00
txa ; CPU:$FC65 PRG:3C65 8A
sbc Zp25 ; CPU:$FC66 PRG:3C66 E5 25
sta a:$0011,y ; CPU:$FC68 PRG:3C68 99 11 00
sta a:Zp11,y ; CPU:$FC68 PRG:3C68 99 11 00
rts ; CPU:$FC6B PRG:3C6B 60
; -----------------------------------------------------------------------------
; Routine: ProjectObjectPosition
@@ -11704,9 +11704,9 @@ ComputeBallVelocity_Moving:
; Clobbers: Undetermined in Pass 1.
; -----------------------------------------------------------------------------
ProjectObjectPosition:
lda a:$0010,y ; CPU:$FC6C PRG:3C6C B9 10 00
lda a:Zp10,y ; CPU:$FC6C PRG:3C6C B9 10 00
sta ppu_addr_lo ; CPU:$FC6F PRG:3C6F 85 FC
lda a:$0011,y ; CPU:$FC71 PRG:3C71 B9 11 00
lda a:Zp11,y ; CPU:$FC71 PRG:3C71 B9 11 00
sta ppu_addr_hi ; CPU:$FC74 PRG:3C74 85 FD
jsr $FE4A ; CPU:$FC76 PRG:3C76 20 4A FE
sty Zp18 ; CPU:$FC79 PRG:3C79 84 18