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

CDL re-trace: 1942 (JU) 46.6%, Galaga (U) 32.3% (Pass 2/3 complete)

Browse Source 
Pass 3 _wip: semantic ZP aliases for Sqoon (U) (FrameCounter, PpuCtrlShadow, NmiFrameFlag) and Elevator Action (U) (PpuCtrlShadow, NmiSaveA/X/Y)
Pass 3 Slalom (U): semantic ZP aliases (PpuCtrlShadow, PpuMaskShadow)
Pass 3 Kung Fu (U): semantic ZP alias (PpuCtrlShadow)
Pass 3 Othello (U): semantic ZP alias (PpuCtrlShadow)
Pass 3 1942 (JU): semantic ZP alias (PpuCtrlShadow)
Pass 3 Galaga (U): semantic ZP aliases (PpuCtrlShadow, PpuMaskShadow)
Docs: add power-on flow + data-table inventory to READMEs of 13 promoted NROM projects
Pass 3 Elevator Action (U): add NmiFrameFlag alias
Pass 3 Elevator Action (U): full ZP naming (23 aliases) + 25 named data tables, 59.4% coverage
Pass 1/2/3 re-trace: recover unreached code in 7 NROM projects (Sqoon 56.4%, Elevator Action 59.3%, Kung Fu 52.1%, 1942 52.1%)
Pass 3 Sqoon (U): full ZP naming (22 aliases) + 17 named data tables
Pass 3 Kung Fu (U): full ZP naming (21 aliases) + 13 named data tables
Pass 3 Othello (U): full ZP naming (18 aliases) + 27 named data tables
Pass 3 1942 (JU): full ZP naming (14 aliases) + 19 named data tables
Pass 3 Galaga (U): full ZP naming (15 aliases) + 14 named data tables
Pass 3 Slalom (U): full ZP naming (16 aliases) + 16 named data tables
Pass 2/3: re-apply naming to Slalom (U), Othello (U), Galaga (U) after re-seed
Pass 1/2/3 re-trace: recover unreached code in 6 more promoted NROM projects
Pass 3 Stack-Up (JU): full ZP naming (15 aliases) + 12 named data tables
Pass 3 Tag Team Wrestling (U): full ZP naming (20 aliases) + 11 named data tables
Pass 3 Kung Fu (U) (a1): full ZP naming (20 aliases) + 12 named data tables
Pass 3 Magmax (U): full ZP naming (18 aliases) + 6 named data tables
Pass 3 Soccer (JU): full ZP naming (18 aliases) + 9 named data tables
Pass 3 Ms Pac-Man (Namco) (U): full ZP naming (18 aliases) + 8 named data tables
Docs: refresh coverage numbers and data-table inventories for 13 promoted NROM projects
This commit is contained in:
tmerritt committed 2026-10-21 16:43:54 -04:00
1 parent 0a49ee6da7
commit 6740550ac0
55 files changed
+160669 -46941
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

NROM/1942 (JU)/README.md
+58 -47
View File
@@ -2,66 +2,77 @@
## Status
**Pass 3.** All address-derived `Label_XXXX` definitions replaced;
every `jsr`/`jmp` operand symbolic; hardware-register operands resolved
via `apply_symbols.py` (0 residue); audit comments aligned; `make`
stays byte-identical.
`make` assembles `header.s`, `prg.s`, `chr.s`, links them with `ld65` and compares the
result against `rom.nes`:
```
Byte-identical ROM verified.
```
**Pass 3 complete; promoted.** `prg.s` is a traced disassembly with all
address-derived labels replaced, all `jsr`/`jmp` operands symbolic, hardware
registers named via `symbols.inc`, and `apply_symbols.py` reporting 0 residue.
Code coverage: 17,065 / 32,768 bytes (52.1%).
`make` assembles and verifies byte-identical to `rom.nes`.
## ROM
| Property | Value |
|----------|-------|
| Format | iNES |
| Mapper | 64 |
| Board | NROM-256 |
| Mapper | 0 (NROM) |
| PRG | 32 KB |
| CHR | 8 KB |
| Mirroring | Horizontal |
| Four-screen VRAM | no |
| Battery | no |
| PRG | 32 KB (2 x 16 KB), mapped at CPU $8000-$FFFF |
| CHR | 8 KB (1 x 8 KB) |
| Trainer | none |
| Footer | none |
| NMI vector | $C030 |
| RESET vector | $BF90 |
| IRQ vector | $BF90 |
| ROM file | `1942 (JU).nes` |
| SHA-256 | `017ff3154d09531d068c26869158776e2e441509cf9bbef8042964ad39b77349` |
### Header notes
## Power-on flow
- header byte 7 is `$44`; its upper nybble selects mapper bits 4-7
RESET enters at `$BF90`:
## Open work
sei ; CPU:$BF90 PRG:3F90 78
cld ; CPU:$BF91 PRG:3F91 D8
ldx #$F3 ; CPU:$BF92 PRG:3F92 A2 F3
txs ; CPU:$BF94 PRG:3F94 9A
lda #$10 ; CPU:$BF95 PRG:3F95 A9 10
sta PPUCTRL ; CPU:$BF97 PRG:3F97 8D 00 20
lda PPUSTATUS ; CPU:$BF9A PRG:3F9A AD 02 20
bpl Reset_OnNonnegative ; CPU:$BF9D PRG:3F9D 10 FB
lda $07BD ; CPU:$BF9F PRG:3F9F AD BD 07
cmp #$55 ; CPU:$BFA2 PRG:3FA2 C9 55
bne Reset_Loop ; CPU:$BFA4 PRG:3FA4 D0 07
lda $07BE ; CPU:$BFA6 PRG:3FA6 AD BE 07
- **Pass 1** - run `nesdis.py` over `prg.bin` to produce the code/data
split. The tracer reads the vectors from the last six bytes of the PRG
image, so the split seeds correctly.
- **Pass 1** must emit the canonical audit comment
`; CPU:$C123 PRG:0123 AD 21 03` at column 35 for every instruction.
- **Pass 2** - replace the address-derived `Label_XXXX` names and the raw
`$XXXX` call operands.
- **Pass 3** - semantic zero-page aliases (applied only at the sites where
their role is proven) and named data tables.
- **Promotion** to `NROM/<name>/` once Pass 3 is done, as `git mv`.
NMI handler at `$C030`:
## Files
sta Zp63 ; CPU:$C030 PRG:4030 85 63
stx Zp64 ; CPU:$C032 PRG:4032 86 64
sty Zp65 ; CPU:$C034 PRG:4034 84 65
lda PpuCtrlShadow ; CPU:$C036 PRG:4036 A5 8C
and #$7F ; CPU:$C038 PRG:4038 29 7F
sta PPUCTRL ; CPU:$C03A PRG:403A 8D 00 20
sta PpuCtrlShadow ; CPU:$C03D PRG:403D 85 8C
lda #$00 ; CPU:$C03F PRG:403F A9 00
| File | Purpose |
|------|---------|
| `prg.s` | Pass 0 PRG include (replaced by the Pass 1 disassembly) |
| `header.s` | iNES header include |
| `chr.s` | CHR include |
| `prg.bin` | 32768 bytes (32 KB) PRG image |
| `chr.bin` | 8192 bytes (8 KB) CHR image |
| `rom.nes` | byte-identical copy of the original ROM |
| `linker.cfg` | HEADER / PRG / CHR memory areas |
| `symbols.inc` | NES hardware register names |
| `locals.inc` | zero-page aliases (empty at Pass 0) |
| `Makefile` | build and byte-identity check |
## Data-table inventory (Pass 3)
- `$8494-$9FDA` (6983 bytes) - `LevelLayoutData`
- `$A08C-$A093` (8 bytes) - `PpuBitMaskTable`
- `$A2F2-$A311` (32 bytes) - `EnemyHandlerPointerTable`
- `$A3E2-$A73D` (860 bytes) - `LevelObjectSpawnTable`
- `$A770-$A815` (166 bytes) - `EnemySpritePatternTable`
- `$ABD0-$AC13` (68 bytes) - `EnemyHealthPointTable`
- `$AD99-$ADC8` (48 bytes) - `SpriteOamAttributeTable`
- `$B200-$B37A` (379 bytes) - `LevelTilemapData`
- `$B4DC-$B4DF` (4 bytes) - `PlayerScoreTable`
- `$B783-$B7C2` (64 bytes) - `EnemySpritePatternTable2`
- `$B9C5-$B9E4` (32 bytes) - `BoardBoundaryData`
- `$BB51-$BC85` (309 bytes) - `LevelGraphicData`
- `$BF0F-$BF57` (73 bytes) - `EnemyMovementDeltaTable`
- `$C366-$C3C9` (100 bytes) - `SpriteOamEntryTable`
- `$DF58-$DF7F` (40 bytes) - `EnemySpawnCoordinateTable`
- `$DFBE-$DFE5` (40 bytes) - `EnemySpawnCoordinateTable2`
- `$E19E-$E1DF` (66 bytes) - `EnemyMovementPatternTable`
- `$E24B-$E392` (328 bytes) - `EnemySpritePositionTable`
- `$E3A1-$EC0B` (2155 bytes) - `EnemyHandlerCodeTable`
## Build
```
Byte-identical ROM verified.
```