Introduce Coco 3 Plus for MiSTer

Add original-firmware Sound & Speech, four configurable Multi-Pak sockets,
bounded per-slot ROM allocation and a nine-page menu organized around devices
and media. Repair inherited clock/reset/CPU-memory/video paths and add explicit
conditional external-I/O timing contracts. Preserve native Main startup-file
ordering, saved layouts, stock-core separation and the coco3plus media profile.

Provide native Windows tool downloads, pinned ToolShed ROM assembly, fresh
Quartus builds, functional and fitted timing checks, reviewed release packaging
and passwordless SSH installation with backups. Retain original component
notices, document contribution copyright and keep SSC ROM inputs outside Git.

Validation: Quartus17.0.2 Build602 seed5, zero errors; 15 functional jobs,
368 both-corner timing scopes and eight tooling-integrity checks pass.
The renamed build reaches Disk BASIC, PRINT1+1 returns2 and SSC loads ready.
Physical cold power cycling and conditional board-delay assumptions remain
separate. Full original upstream histories are preserved before this single
consolidated implementation commit.
This commit is contained in:
bholman committed 2026-11-18 16:00:45 -07:00
1 parent 8b8cf72d1f
commit cb40fed3b9
126 files changed
+12795 -528

No files matched your search

+132
View File
@@ -0,0 +1,132 @@
# Validation and acceptance scope
## Final named release, 2026-11-18
The final source embeds **Coco 3 Plus** as its display identity and retains
`coco3plus` as its native MGL profile. Original contribution copyright notices
are added without replacing upstream notices. A fresh native Quartus17.0.2
seed5 compile completes in **14:33**, **0 errors / 73 warnings**. It uses
**19,067 ALMs (45%)**, **495 RAM blocks (90%)** and produces a **3,946,736-byte** RBF:
```text
768ee9db2923bf7b7acf7f57473c6c56f92d14ffc6d6bd88719148f80c9a2d42
```
Minimum constrained slack: setup **+0.089 ns**, hold **+0.212 ns**, recovery
**+0.691 ns**, removal **+0.701 ns**, pulse width **+0.396 ns**. All 15 functional
jobs pass through the documented Windows entry point using the standalone
checkout's own verified/extracted simulator. The actual Main name-reader
fixture additionally confirms the spaced display name and unchanged canonical
profile override. All **368 fitted report scopes** pass, with remaining optional
pin contracts explicitly classified in validation/standalone.json. No timing
exceptions or physical delay assumptions were relaxed for the rename.
Release-tool review adds eight passing integrity tests: committed-only source
export excludes untracked notes and ROMs, public packages omit firmware, dirty
selected sources stop packaging, incomplete simulator setup stays unpublished,
and same-size binary corruption is detected. New HDL dependencies use a maintained
inventory; the build receipt reads the actual QSF seed. Resumed timing audits
require the original RBF, fitted netlist, input and Tcl-script identities. Older
unbound evidence is deliberately rejected; all 368 scopes were rerun with the
bound evidence format. These tooling corrections do not alter the fitted RTL.
This is a new bitstream, so previous extensive hardware observations below
belong to the earlier hash. Final deployment/startup observations are separately
recorded in validation/deployment.json. The shared logical implementation is
covered by the final-source regressions; no new human listening or cold-power
test is inferred merely from that relationship.
## First standalone reconstruction, 2026-11-18
The new repository was created from a complete upstream mirror, with no research
repository ancestry. The baseline is
`8b8cf72d1fb4de1d05345de8d5b92ec2d500fcd2`; original upstream refs are recorded in
validation/upstream-refs.json. The consolidated implementation is maintained on
main. Source-import hashes record the qualified implementation inputs and three
project-description comment rewrites; no private conversation/evidence archive
is required to build this project.
All public dependencies were freshly downloaded and hash-verified from the new
repository's scripts. Native Windows LWASM 4.25 assembled all four ToolShed ROMs
to the expected SHA-256 values. SSC original inputs were separately verified and
remain ignored. No VCC Plus checkout/build or private emulator binary was used
for this standalone build or these regressions.
The first standalone Quartus **17.0.2 Build 602** compile, seed 5, completed in
**14:38**, with **0 errors and 73 warnings**. Utilization is **19,098 ALMs (46%)**,
**495 RAM blocks (90%)** and 3,897,605 block-memory bits (69%). The RBF is
3,951,104 bytes, SHA-256:
```text
a4b6ef0b3641bbbc1b42de88502b677a1ec5e3809e2a17abf6f1e75c2a38451e
```
This first build is byte-identical to the previously qualified and hardware-tested
image. It still reported the retired COCO3-BH embedded identity, which the final
release changes to Coco 3 Plus. Its fit has minimum constrained setup **+0.069 ns**, hold **+0.252 ns**,
recovery **+0.692 ns**, removal **+0.742 ns**, pulse width **+0.396 ns** and summary
TNS zero. Generated build logs and exact source hashes remain under ignored build
storage; the sanitized reproducibility record is validation/standalone.json.
All **15 standalone functional jobs** pass: MPI allocation/config/router and actual
core bindings; original-ROM SSC system; registered interfaces; reset/buffer
domains; exhaustive keyboard phase; peripheral phase; SDRAM commands; delayed
CPU/video data; audio; pixel; I2C; original Main startup parser; original Main menu
parser; original/candidate video comparison. Negative controls include incorrect
buffer cadence, pixel duty/address corruption and old initialization behavior.
All seven native detailed timing audits pass **368 report scopes** at both slow
and fast corners. This includes 34 MPI reports, 144 live SSC path reports,
CPU/reset/NMI/UART/video scopes, and 48 substantive conditional external-I/O
reports. Explicitly empty synchronous-only recovery/removal subscopes are listed
as empty, not counted as an observed path with positive slack.
The first exported test run found missing dynamically named reset benches, a
canonical-name fixture mismatch, and a video-runner argument mismatch. These
were export-harness defects; corrected fixtures pass in a fresh output folder.
No RTL/timing exceptions were changed to satisfy the exported tests.
## Hardware evidence on these exact RBF bytes
Previous physical validation of the same image includes normal Disk BASIC startup,
saved non-default socket layout, Slot1/Slot4 ROM autoload, independent socket
banks/selectors, fresh configuration boot and Colour Lab grid/ramp/stripes/return.
Further autonomous checks include:
- 14 guided Sound Lab cases plus repeated/FF-operand cases: 20 transaction
records across seven validated saved reports. One deliberate active-speech
abort/reset returns to normal operation and completes the full greeting.
- Disk BASIC formatting of an authored scratch disk, writing and reading 256
exact numeric pairs across two granules; guest sums and host extraction agree.
- Supplied 512K RAM stress advancing pages for 135 seconds with no error display.
- Quadrapassel startup, keyboard movement, pause and quit.
- Mouse-as-right-joystick axes and button1 changes.
Human SSC audibility was confirmed during earlier integration checks. The later
autonomous report marks remain UNSURE/NOT_OBSERVED; no new listening score is
manufactured from screenshots or transaction completion. An earlier hardware
game check also confirmed USB joystick/game audio, with separate build attribution.
The initial standalone installer/path activation reached BASIC, `PRINT 1+1`
returned 2 and the OSD reported automatic Sound & Speech ready and Orchestra90
enabled. The saved CFG and stock RBF were preserved. Final renamed-image
activation is recorded separately in validation/deployment.json. Rebuilding identical bytes
does not itself prove a newly changed launcher/installer path works.
## Explicit remaining limits
The native external constraints use the controller's documented Alliance -7
SDRAM and bounded board-delay assumptions. The enclosed development module's
exact chip/speed suffix and PCB delays have not been independently measured.
This is conditional timing closure, not universal SDRAM-module or whole-board
electrical certification. Some HPS/muxed/asynchronous optional pins have separate
contracts outside these fabric STA budgets.
Cold power removal/reapplication remains a physical operator check. Longer memory
stress, every turbo/large-memory setting, all UART/serial electrical paths, every
SDC/VHD/OS9 and cassette-write format, all joystick types and exhaustive waveform
equivalence remain outside the enumerated acceptance scope. Firmware diagnostics
and human listening complement rather than replace timing/simulation evidence.
A dedicated bootable SD image requires separate first-boot/expansion/cold-start
qualification on a spare card; a verified core overlay is not that qualification.