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:
1 parent
8b8cf72d1f
commit
cb40fed3b9
126 files changed
+12795
-528
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user