Files
Quadrapassel/docs/MEMORY_LAYOUT.md
T
Brian Holman a07c41555a Fix target joystick calibration arguments and scene transitions
Avoid a demonstrated CMOC -O2 removed-index-reload error with independent calibration and position pointers. Keep established joystick readiness across menus, stabilize shared fire/keyboard scans, and protect input sampling from IRQ interference.

Ship pristine QUADPSL04.DSK. Native right-port emulated analog/button checks pass for both directions, four lasting T-piece turns, and steering after keyboard resume. Host input/store/rules/video regressions and unchanged memory guards pass. Preserve personal score disks and record physical/128 KB/audio limits.
2026-11-11 14:26:06 -07:00

4.2 KiB
Raw Blame History

CoCo 3 memory contract

Current candidate uses stock Disk BASIC and PCLEAR1, then LOADM"QUAD.BIN":EXEC. PCLEAR0 was tested in an isolated official build-48 MC6809/512 KB machine and returned ?FC ERROR; it is not used.

The standard CMOC linker places code/constant data at $1400 and writable static data at $0E00. The one reserved legacy PMODE page ($0E00–$13FF) is deliberately used for the game's static variables. This is a CoCo 3-only program: it never calls PMODE or PCLS. HSCREEN 2 uses its separate physical graphics banks $30–$33. Graphics is initialized once before preferences are created. Scene changes clear only the framebuffer through the approved renderer, keeping ROM initialization outside live game state. No BASIC user program or prior low-resolution picture is preserved by launching this game. BASIC system RAM, text RAM and disk buffers below $0E00 remain intact.

The November 11 joystick update ends code/constants at $7AF6 and static data at $13F6 (1,526 bytes including initialized variables). The limits remain unchanged. The font uses 336 row bytes plus 12 punctuation codes; 198 bytes of font/packing data are stored in the low data region and only read by the renderer. $7B00–$7FFF is kept free for the foreground/ROM stack, with CMOC configured for 1,024 bytes. The split layout has passed settings and earned-score save/reload checks on MC6809/512 KB in the official app. Full stack qualification and actual 128 KB testing remain pending. This is a checked address budget, not a claim that 128 KB has passed.

tools/check_memory.pl verifies every nonempty link-map section independently. This is necessary because CMOC's --limit checks program_end, which is the low static-data end when --data is used. The build fails if code/constants extend past $7B00 or static data extends past $1400. No data or stack may occupy the renderer’s temporary $8000–$9FFF MMU window.

The approved C renderer temporarily maps task-0 slot 4 to graphics banks $30–$33, copies bounded chunks and restores the prior mapping before standard APIs run. CMOC does not implement volatile: a separate read function is used and emitted reads/stores must be audited in each delivered candidate. No authored assembly, custom interrupt handler or custom sound driver is used.

Menu text is loaded through standard decbfile APIs from twelve independently checksummed 512-byte pages in QPTEXT.DAT. The menu buffer shares storage with the 288-byte tile cache and 200-byte board cache; gameplay rebuilds those caches on resume. Original title lettering uses 84 bytes of shape data and a scanline scratch buffer, rather than a full-screen bitmap.

The score store keeps one 256-byte page and one 80-byte top-ten table in RAM. QPSAVE0.DAT/QPSAVE1.DAT each hold 35 sectors, with the commit header written last. Files longer than the schema allows are rejected and reported; the program does not truncate an unexpectedly oversized file. Missing/short inactive files can be created/extended using the documented file API. Only the two named save files are written. QPTEXT.DAT is read-only game data.

Build 02 packs each caption's scene and column into one byte, preserving all positions. The palette (11 bytes) and preference-validation table (15 bytes) use low static data; they are only read. Optional video timing instrumentation is enabled only by QUAD_PROFILE and is unavailable in Release. Every profile build still needs the unchanged link guard; profile configurations are unqualified.

Build 03 additionally moves the seven effect-duration bytes into low static storage (read only in use), iterates packed captions with a byte pointer, and compacts equivalent input handling/status text. Code/const end $7ACD; static end $13FD; reserved stack remains 1024 bytes. Full bcontrol position sampling was tried but exceeded the guard; the delivered path retains standard coco.h position reading with public interrupt protection.

Final build04's independent calibration/position pointers avoid the target compiler indexing defect. Code/const end $7AD4 (44 bytes free), static end $13FD (3 bytes free). The original MMU window, section limits and 1024-byte stack reserve are unchanged. Memory qualification remains actual-128-KB pending.