Implement CoCo 3 Quadrapassel and deliver build 01
Add gameplay, keyboard/joystick controls, disk-backed high scores and settings, standard CMOC effects, and the approved C graphics renderer. Include the clearer attributed font, title/credits updates, source-verified Modern and Classic (40.2) scoring, meaningful regression fixtures, and recorded guest validation. Deliver QUADPSL01.DSK with fresh high scores. Retain source, licenses and selected guest evidence; exclude personal disks, private connections and build scratch. Host rules/input/persistence/video checks and memory guards pass. Official 512 KB playtests pass the recorded checks; actual 128 KB/physical joystick qualification and the normal-window buzzing retest remain pending.
This commit is contained in:
1 parent
8a4b44bc73
commit
d412e35c4e
79 files changed
+4187
-16
No files matched your search
@@ -0,0 +1,123 @@
|
||||
# Audio routing correction — November 10, 2026
|
||||
|
||||
Brian reported constant noise during keyboard play, including while idle. That
|
||||
is outside the specification: sound should consist of brief event effects with
|
||||
silence between them. His earlier pacing feedback remains keyboard evidence;
|
||||
physical joystick testing is still pending.
|
||||
|
||||
## Correction
|
||||
|
||||
The old code initialized CardGame audio once at startup, then continuously called
|
||||
`readJoystickPositions`. The public CMOC documentation explicitly states that
|
||||
analog sound routing shares hardware with joystick measurements. The permitted
|
||||
CardGame example's initSound.c selects the DAC and enables sound; beep.c does not
|
||||
close that path on return. This leaves audio routing unmanaged between events.
|
||||
|
||||
The game now calls the documented `Player_disableSound()` helper before joystick
|
||||
sampling and at startup. Each enabled effect calls `initSound()` immediately
|
||||
before `beep()` and `Player_disableSound()` immediately afterward. This keeps the
|
||||
speaker path closed while idle and while the joystick selector is being changed.
|
||||
|
||||
The implementation uses standard CardGame and bsound APIs only. It installs no
|
||||
Player IRQ, supplies no custom interrupt/sound driver, and adds no direct hardware
|
||||
access. The quiet movement volume and existing event pitches/durations are kept.
|
||||
The half-frequency constants are the same values the previous code obtained by
|
||||
integer division; gameplay timing, scoring and save format are unchanged.
|
||||
|
||||
Public references read through the installed MCP manual:
|
||||
|
||||
- `programming-in-c/api.html#api-player-disablesound`: analog-path enable/disable
|
||||
shares hardware with joystick measurements; link bsound.
|
||||
- `programming-in-c/api.html#api-beep` and public cardgame.h: initialization,
|
||||
positive period/duration and bounded volume.
|
||||
- Public Player.h: standalone enable/disable helpers; Player_init/shutdown are
|
||||
associated with the optional player/IRQ service, which this game does not use.
|
||||
- Pierre Sarrazin's local CardGame 0.1.15 initSound.c/beep.c (public-domain
|
||||
examples) were read for reference. No assembly or register code was copied.
|
||||
|
||||
## Actual MCP captures
|
||||
|
||||
Official VCC Plus 3.5.5 (48), disposable CoCo 3 / 512 KB workers, stock fast mode.
|
||||
Each WAV captures 120 emulated fields directly, at 44,100 Hz, PCM16 stereo,
|
||||
88,651 or 88,652 sample frames. Both channels were checked.
|
||||
|
||||
| Context | Result |
|
||||
| --- | --- |
|
||||
| MC6809 title idle | Every sample zero |
|
||||
| MC6809 gameplay idle | Every sample zero in the captured no-event window |
|
||||
| MC6809 right-move action window | Short effect, peak 1,792 in each channel; 10 changing edges; last 500 ms exactly zero |
|
||||
| MC6809 idle after movement | Every sample zero |
|
||||
| MC6809 hard-drop/lock window | Short effect, peak 5,120 in each channel; 10 changing edges; last 500 ms exactly zero |
|
||||
| MC6809 pause menu idle | Every sample zero |
|
||||
| MC6809 Sound OFF, following a left-key action | Every sample zero; OFF was also verified on the guest settings screen |
|
||||
| MC6809 Sound OFF idle | Every sample zero |
|
||||
| HD6309 gameplay idle, reset emulation mode | Every sample zero |
|
||||
| HD6309 right-move action window | Short effect, peak 1,792 in each channel; 10 changing edges; last 500 ms exactly zero |
|
||||
|
||||
The movement peak is lower than the landing peak, preserving relative volume.
|
||||
Positive effect captures establish that silent windows are not simply a globally
|
||||
muted capture endpoint. Captures start after bounded input, so a silent post-key
|
||||
window alone does not establish whether an earlier very short effect played.
|
||||
|
||||
The unchanged baseline disk was also captured. Its sampled idle and post-movement
|
||||
windows were zero. **The reported continuous noise was not reproduced in the
|
||||
isolated worker.** The routing defect was corrected from the public contracts
|
||||
and source usage; confirmation that Brian's actual-app idle noise is gone still
|
||||
requires retesting that environment. These are direct guest PCM checks, not a
|
||||
claim of human listening, Mac output-device qualification or a 128 KB pass.
|
||||
|
||||
`tools/check_audio.py` checks all PCM channels for exact digital silence, or for
|
||||
a nonconstant effect with a silent final 500 ms. Example:
|
||||
|
||||
```sh
|
||||
python3 tools/check_audio.py test-output/audio/after-idle-game.wav --expect silent
|
||||
python3 tools/check_audio.py test-output/audio/after-lock-effect.wav --expect effect
|
||||
```
|
||||
|
||||
Raw WAVs and full receipts remain in ignored test-output/audio/. The MCP baseline
|
||||
used a freshly built disposable disk. The pre-update local writable image also
|
||||
contained QPSAVE0.DAT/QPSAVE1.DAT; that original is preserved under ignored
|
||||
local-media-backups/. A second private copy there replaces only QUAD.BIN with
|
||||
the corrected executable. Every other file and the DOS boot track were verified
|
||||
byte-identical. These personal save files are excluded from Git and MCP inputs.
|
||||
The personal emulator session was not operated or reset.
|
||||
|
||||
## Build identity
|
||||
|
||||
- Project revision 16, Release, build `CFC0A2F2-9247-4B1C-9CF8-8CC1AFE896B6`.
|
||||
- Artifact `261716EE-81C8-487D-A7BF-E5C9F51BC044`.
|
||||
- Binary: 26,370 bytes, SHA-256
|
||||
`5c9f3be05fde79e09a5a583740e676f2fb06eddc136dd9d419f62f12da6bebfe`.
|
||||
- Pristine Quadrapassel.DSK: 161,280 bytes, SHA-256
|
||||
`d23bc2a1aa60970becaf7ff8be064efc8ea47a5043adf9661d9a6c22bcedfd9b`.
|
||||
- Code/constants end $7AE8; static data end $1318; existing memory checks passed.
|
||||
- MC6809 run `0B67B031-7CEE-4CD7-98CA-649B295FECB3`.
|
||||
- HD6309 run `356B3452-D3AA-4EBA-8111-1D41EC9F9277`.
|
||||
- All owned runs are stopped. No implementation commit or push was requested.
|
||||
|
||||
## November 11 — normal-window buzz still reported
|
||||
|
||||
Brian confirmed the font candidate buzzes on its title screen before Start,
|
||||
including after quitting/reopening VCC Plus. The real 512 KB CoCo 3 does not
|
||||
buzz. During the authorized desktop check, pausing VCC Plus stopped the noise;
|
||||
Run was then restored without resetting the game or replacing mounted media.
|
||||
This establishes a normal-window playback symptom, not its cause.
|
||||
|
||||
The visible normal setup is MC6809/512 KB at 1x, with an FD-502/floppy controller,
|
||||
Speech/Sound Cartridge, Orchestra-90 and a stopped Hello World cassette. App
|
||||
sound is enabled at 50%. Those peripherals differ from the supported disposable
|
||||
worker; their presence alone does not establish that any cartridge causes the
|
||||
buzz. The public MCP audio tool captures only the disposable worker, not the
|
||||
normal window or microphone. No claim of hearing the actual speaker is made.
|
||||
|
||||
The new standard candidate reasserts Player_disableSound after joystick button/
|
||||
position sampling as well as before it. This is a defensive public-library
|
||||
change, not a demonstrated cure. It adds no custom audio code or hardware access.
|
||||
Official build 51, project revision 2, run
|
||||
`0174149F-48E6-4EB6-8D96-BC1BF0BF4C87`: title and gameplay idle captures are
|
||||
zero in both channels; movement peak 1792 in both channels, nine changing edges,
|
||||
last 500 ms zero. Each direct stereo capture covers 120 fields; the effect
|
||||
capture contains 88,651 frames, idle captures 88,652 at 44,100 Hz. Checks pass.
|
||||
Owned runs are stopped. The normal-window buzz remains unconfirmed fixed and
|
||||
needs the new candidate retested in that same environment. Full final identity
|
||||
and preserved-score disk are in TITLE_AND_SCORING_UPDATE.md.
|
||||
Reference in new issue
Block a user