Publish VCC Plus OSS source distribution for 3.6.2 build 60

This commit is contained in:
Brian Holman committed 2026-11-13 00:14:03 -07:00
commit c652a5276d
1192 files changed
+272368

No files matched your search

+125
View File
@@ -0,0 +1,125 @@
# Analog sound routing and Quadrapassel regression
> Technical evidence extract for the VCC Plus white paper. Only reviewed contracts, mechanisms, methods, results and limitations are retained. Original validation dates and configuration limits remain historical; this export is not a new test run.
## Cause and correction
The native sampler mixed cartridge output into the speaker regardless of the
PIA sound-enable control and selected analog input. An idle Speech/Sound output
has unsigned midpoint 128. The old path emitted that as a large DC signal;
joystick polling switched the mux to the cassette branch and back, chopping it
into an audible waveform even though the game had disabled analog sound.
The sampler now follows the hardware routing:
| Analog selector | Source while sound is enabled |
| --- | --- |
| 0 | Six-bit CoCo DAC |
| 1 | Cassette input |
| 2 | Cartridge SND |
| 3 | Ground / silence |
The sound-enable control gates that analog path. Single-bit sound and the
modeled Orchestra-90 external RCA outputs remain independent. Cartridge PCM is
centered on 128; a zero sample remains a valid negative peak, distinct from an
absent/inactive sound device. The current DAC register is read even if the guest
last wrote it during a muted joystick measurement. Final float mixing saturates
rather than wrapping a signed packed word. Cartridge clocks and cassette
advancement continue while muted or unselected.
The native sampler uses the new read-only PIA sound snapshot and separate
cartridge speaker/external outputs. The original Windows packed mixer remains
unchanged. Existing DAC, single-bit and Orchestra-90 gain conventions are retained.
Hardware cross-checks: MAME's [CoCo implementation](https://github.com/mamedev/mame/blob/master/src/mame/trs/coco.cpp)
describes the selector map with its Tandy service-manual citation; its
[CoCo machine wiring](https://github.com/mamedev/mame/blob/master/src/mame/trs/coco12.cpp)
connects PIA selection, sound-enable inhibit and the separate single-bit path.
No MAME implementation was imported.
## Unchanged real game reproduction
The optional `tests/macos/audio-game-validation.cpp` boots a supplied DOS disk
through ordinary keyboard input, with local CoCo 3/Disk BASIC, Speech/Sound and
Orchestra-90 ROMs. The source disk is read-only host input; guest writes affect
only an owned memory copy. No text, registers or guest RAM are injected to create
the observed results. The matrix uses 512 KiB, 1x overclock and both emulated CPUs,
with a mounted stopped cassette and FD-502 in startup slot 4.
The real-game matrix ran on arm64. The test used Quadrapassel `QUADPSL01.DSK`, SHA-256
`4ac171e87c51dfd99b302b9e035a91a59c030144e5ae0661a6d2dfc84ba3a63f`.
Its repository remained clean and its source disk hash stayed unchanged.
After 1,800 settling fields, each idle capture spans 120 fields:
| Configuration | Before | Corrected |
| --- | --- | --- |
| FD-502 only, either CPU | Exact digital silence | Exact digital silence |
| FD-502 + Orchestra-90, either CPU | Exact digital silence | Exact digital silence |
| FD-502 + Speech/Sound, 6809 | 84,827 / 88,651 nonzero frames; 1,409 transitions; AC RMS 0.101581 | Every sample zero |
| FD-502 + both cartridges, 6809 | Same repeating erroneous signal | Every sample zero |
| FD-502 + Speech/Sound, 6309 | 84,818 / 88,651 nonzero frames; 1,421 transitions; AC RMS 0.101695 | Every sample zero |
| FD-502 + both cartridges, 6309 | Same repeating erroneous signal | Every sample zero |
With both cartridges present, normal Enter and D/right keyboard input started
the game and produced movement effects on both CPUs. Peak was 0.242188 and the
final half-second was exactly silent. Thus the correction does not globally mute
the game. Raw PCM, framebuffer captures and logs remain private and outside Git.
Example reproduction after building the current core through Xcode:
```sh
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer \
xcrun clang++ -std=c++17 -O2 -mmacosx-version-min=14.0 \
tests/macos/audio-game-validation.cpp /path/to/libVCCCore.a \
-o /tmp/audio-game-validation
/tmp/audio-game-validation /path/to/ROMs /path/to/game.DSK \
/tmp/audio-game-captures --expect-quiet
```
The quiet-title and movement assertions apply to a DOS-boot game with the same
Enter-to-start and D-to-move controls. It is an explicit optional compatibility
check, not a general assertion that every game's title screen should be silent.
## Regression qualification
- All 67 portable core checks passed, including the new authored routing
regression on both guest CPUs. It covers all mux states, the sound gate,
joystick-style selector changes, current DAC latch, unsigned midpoint and zero
cartridge samples, independent one-bit/Orchestra stereo, and saturation.
- Seventeen focused XCTest checks passed on arm64 and again on x86_64 under
Rosetta: audio buffer/scheduling/routing, cassette images and monitor, cartridge
behavior, real output-device pause/restart, and volume changes retaining clocks.
- Real-ROM speech and AY tone checks passed on both CPUs: 22 phonemes,
443,259 PCM frames, speech range 0.504 and tone range 0.332. Authored speech
fixtures now explicitly select and enable cartridge audio. Test WAV writers
retain actual signed PCM rather than subtracting another midpoint. Both speech
WAV hashes remain identical to the previously qualified greeting capture
recorded in the Speech/Sound guide.
- The guest Speech/Sound SDK checks passed on both CPUs with missing/absent and
real firmware, phrases, joystick polling, tones and noise. Orchestra-90 SDK
checks retained exact channel plateaus and approximately 3,996 frames/s at
normal speed and 3,986–3,988 at fast speed on both CPUs.
- The isolated native playback test passed with both real cartridges, the
unchanged game, and 25% volume. Across three seconds, emulated fields advanced
from 2,336 to 2,515 and the real output device consumed another 132,182 sample
frames. Nonzero-signal count remained zero and audio-engine start count stayed
one. No mute or engine restart manufactured silence.
The native test is opt-in through `VCC_AUDIO_GAME_DISK`; ordinary UI runs skip it
without that supplied disk or private ROMs. `--audio-game-listening ROM_DIRECTORY
DOS_BOOT_DISK` also selects the same temporary fixture and automatically pauses.
This is native output-consumption and digital-signal evidence, not a new human
listening confirmation, physical Intel test or macOS 14 runtime qualification.
The user's physical-machine observation remains the independent comparison.
The native case also passed independently after reopening its single main
window through **Window → VCC UI Tests** (45.061 seconds). The test now uses that
public reopening path and raises its window before capturing, avoiding saved
closed-window state and unrelated foreground-window captures. The final window
capture was visually checked against the game's splash screen and both sound
cartridges. The universal normal Debug app built successfully; no DMG or
installation was performed.