Getting started

This repository holds the commented disassembly of Konami's Circus Charlie for the MSX (RC-712, 1984). It does not hold the cartridge: the ROM image is not distributed.

What you need

It is exactly 16,384 bytes and its fingerprint is:

sha256  89e1badac10e65886590d55e735ed794e5ca3c41142e6637b3e7ac6b25d042c0

To check it:

make comprueba

Rebuilding all of it

commandwhat it doeswhat it proves
make listadotraces the flow and generates src/circus.asm with the notesthat the listing comes from the cartridge and src/circus.notes, not hand edits
make verifyreassembles with pasmo and comparesthat the listing IS the ROM, byte for byte
make sanitysplits the 16,384 bytes into code and datathat not one byte is left unassigned
make test49 teststhat the numbers on this site are the listing's
make imagenesdraws everything in docs/imagenes/ from the ROMthat the formats are read right
make coteja_montaje / make coteja_arranque / make coteja_pistacompare against openMSX dumpszero bytes different

All three comparisons need the emulator dumps first: tools/omsx_montaje.tcl and tools/omsx_arranque.tcl (the ring one uses the same dumps as the start), each with its usage line in the header. See In the emulator.