8.9 KiB
Validation and acceptance scope
Source-tree hygiene, 2026-11-18
Removed the inherited 162-byte Word owner/lock file docs/~$Co3FPGA.docx
from the current tree and ignore future Word lock files. Its history is preserved
in the original upstream commits (first present in the January 2022 check-ins;
updated May 2024). The actual CoCo3FPGA DOCX/PDF manuals are retained. This changes
no FPGA logic, ROM or existing image; no FPGA rebuild or hardware test is
claimed for this documentation-only cleanup. Existing build/source receipts keep
their original pinned revisions.
The lock file was also listed in the maintained source-copy inventory. Remove that metadata entry so a fresh checkout can prepare its build directory. Existing fit receipts retain the old inventory identity and are not backfilled; their qualified prebuilt packages remain pinned to their original source revision. A fresh build of the cleaned checkout records the revised inventory normally. Preparation-only validation with Quartus17.0.2 passes; this is not a new fit.
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:
768ee9db2923bf7b7acf7f57473c6c56f92d14ffc6d6bd88719148f80c9a2d42
Quartus summary 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 are classified: 288 contain measured paths that pass, and 80 are explicitly empty recovery/removal checks. The smallest enumerated detailed-path slack is +0.065 ns, distinct from the summary setup minimum above. 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:
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 classify 368 report scopes at both slow and fast corners: 288 measured scopes pass, and 80 synchronous-only recovery/removal scopes are explicitly empty. 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.
Earlier hardware evidence: RBF a4b6ef0b (not final RBF 768ee9db)
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.