tmerritt
9aef410424
Adds remaining NROM as _wip Update gitignore to not keep object files Adds AGENTS.md as this is an AI helped project
3.0 KiB
Popeye (JU) (PRG 1) — Skeleton Project
ROM: _wip/Popeye (JU) (PRG 1)/Popeye (JU) (PRG 1) [!].nes (24,592 bytes, iNES). Status: SKELETON — not yet disassembled. The entire 16 KB PRG bank is a single unclassified block; copilot/prg.s is the default-project skeleton (default_project.tar.gz) that reproduces it as one .incbin. The skeleton build is byte-identical at the PRG level.
Companion note: Popeye (JU) (PRG 0) holds a different PRG image of the same title (different mirroring flag, too). Neither is currently known to be a superset of the other.
ROM Facts
| Property | Value |
|---|---|
| Mapper | 0 (NROM) — from the iNES header |
| PRG | 16 KB (header claims map at CPU $C000–$FFFF) |
| CHR | 8 KB |
| Mirroring | Vertical |
| Battery-backed flag | clear |
| ROM SHA-256 | 0016065132a2dc98afb1181a735edcb9c656b0b89af4e0771e94807ba67bd8b4 |
| PRG SHA-256 | 72f06b36f4e908e15639564e83a32e0afe680189e82f0f9d7fa5a9fadaa2e646 |
Interrupt Vectors (taken from PRG $3FFA–$3FFF)
| Vector | Target | Note |
|---|---|---|
| NMI | $C701 |
per-frame heartbeat |
| RESET | $C649 |
enters at $C649 inside the first pages (the Donkey Kong Jr.-style non-$C000 entry) |
| IRQ | $FFF0 |
lands in the vector-page padding — unused placeholder |
copilot/ Contents
| File | Purpose |
|---|---|
Popeye (JU) (PRG 1) [!].nes |
original ROM image (reference) |
prg.bin / header.bin / chr.bin |
split image, produced by _tools/splitnes.py |
prg.s |
Pass-1 skeleton: .incbin "prg.bin", $0000, $4000 (whole PRG) |
symbols.inc |
shared NES hardware constants (PPU/APU/controller, from the skeleton) |
locals.inc |
project-local zero-page aliases — empty for now (filled in Pass 2) |
linker.cfg |
PRG at $C000, 16 KB, fill = yes |
Makefile |
links reconstructed_prg.bin and cmps it against prg.bin |
reconstructed_prg.bin |
build output from the last verified build |
Header/CHR are reproduced verbatim from header.bin/chr.bin (not linked): make verifies PRG bytes only at this stage, which is exactly what a skeleton proves. When this project is promoted to a full disassembly, header.s / chr.s (as e.g. Burger Time (U)) and a full-ROM make target get added.
Build
cd "_wip/Popeye (JU) (PRG 1)/copilot"
make # → cmp reconstructed_prg.bin prg.bin → "BYTE-IDENTICAL"
Next Steps (per PROMPTS.md)
- Pass 1 — replace the blanket
.incbinwith classified code/data: trace reachability from RESET ($C649) and NMI ($C701), emit per-instruction; PRG:$xxxx AA BBannotations, keep unreached bytes as explicit.byteblocks. - Pass 2 — replace
Label_/Sub_names with semantic routine names; filllocals.inc. - Pass 3 — name data tables/structures; release provisional flags.
- Promotion — move to a top-level
<name>/copilot/folder, add full-ROM build (header.s + chr.s + vectors), and write the power-on flowOVERVIEW.mdin the established style; then it joins the root index's numbered inventory.