Filter keyboard rows grounded by joystick buttons before processing actions, preventing right fire from acting as A/D/E and undoing its release rotation. Arm X and Y independently so an uncentered vertical axis cannot block steering. Reproduce both defects in host regressions, retain ordinary CMOC input APIs, and update official project membership. Compact unchanged display data and make render profiling optional to preserve the original memory and stack bounds. Deliver QUADPSL02.DSK with fresh scores. Retire the old artifact from tracking while leaving the loaded local disk untouched. Host suites, official Release build and MC6809/512 KB keyboard/audio smoke checks pass. Actual joystick-port confirmation and the reported normal-window buzz remain pending.
56 lines
3.4 KiB
Markdown
56 lines
3.4 KiB
Markdown
# 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.
|