From 68389e8ca11c1b7a35586e2f269f9f5a6c62230f Mon Sep 17 00:00:00 2001 From: Brian Holman Date: Sat, 21 Nov 2026 22:59:26 -0700 Subject: [PATCH] Record fitted joystick validation and preserve contribution order --- docs/VALIDATION.md | 28 +++- validation/contributions.json | 254 +++++++++++++++++----------------- 2 files changed, 152 insertions(+), 130 deletions(-) diff --git a/docs/VALIDATION.md b/docs/VALIDATION.md index 5fb18ce..e3e69b0 100644 --- a/docs/VALIDATION.md +++ b/docs/VALIDATION.md @@ -6,9 +6,31 @@ Source and extracted-RTL evidence identifies crossed secondary buttons in the inherited MiSTer wrapper. The service-manual PIA oracle fails on the unchanged binding and passes524288 combinations after correction, including both port swaps, simultaneous button presses, mouse primary-button gating and keyboard -row sharing. No new core has been installed or tested with CocoMan yet. Full -functional suite, native Quartus fit and detailed timing are being run separately; -prior 1.0.0 hardware and fitted results below do not qualify the changed RBF. +row sharing. All 16 functional regression jobs pass, including that new test. + +A native Quartus Prime Lite 17.0.2 Build 602 fit at seed 5 completes with zero +errors and 73 warnings in 15:03. The build uses 19,280 ALMs (46%) and 495 RAM +blocks (90%). All summary slacks are positive; minimum setup is +0.041 ns. +Seven fitted path audits cover both timing corners: 368 report scopes, of which +288 contain paths and 80 synchronous-only recovery/removal scopes are explicitly +empty. All populated scopes are nonnegative. No illegal or unconstrained clocks +remain. Existing classified asynchronous/board pin contracts remain subject to +the documented conditional SDRAM and PCB profile, not universal electrical +qualification. + +The resulting RBF is 3,963,336 bytes, SHA-256 +`ec0faf3ebf90a88e76d52814f8b3abbf63f8bede7af1ad00b1cd9df6610ede9a`. +Project inputs match the committed bf36c0569a8296f3561f50d2d2c11e9c3353a673 +implementation exactly. Reproducible receipts reside under ignored +`build/joystick-secondary-20261121/build.json`, +`build/joystick-secondary-timing-20261121/result.json`, and +`build/joystick-secondary-regressions-20261121/regression-logs/result.json`. + +No changed core has been installed or tested with CocoMan yet. Hardware button +values, two-button gameplay, saved settings and fresh-image four-disk startup +remain pending; prior 1.0.0 hardware observations do not qualify the changed RBF. +The DE1 native GPIO contract is separate. This correction changes only the +MiSTer USB boundary binding; no DE1 RTL or hardware qualification is claimed. ## Source-tree hygiene, 2026-11-18 diff --git a/validation/contributions.json b/validation/contributions.json index b19b351..7e6f3ce 100644 --- a/validation/contributions.json +++ b/validation/contributions.json @@ -1,128 +1,128 @@ -{ - "copyright": "Copyright (c) 2026 Brian K. Holman", - "scope": "Original Plus contributions only; original component rights retained", - "modified_inherited_files": [ - ".gitignore", - "CoCo3.qsf", - "CoCo3.sv", - "README.md", - "files.qip", - "rtl/CoCo3FPGA.sdc", - "rtl/EE_Cold_Bt.v", - "rtl/UART_6551/6551rx.v", - "rtl/UART_6551/uart_6551.v", - "rtl/coco3fpga.sv", - "rtl/fdc.sv", - "rtl/mc6809glb/mc6809glb.v", - "rtl/sdc.sv", - "rtl/sdc_top.sv", - "rtl/sdram/sdram2.sv", - "sys/i2c.v", - "sys/mcp23009.sv" - ], - "new_project_files": [ - ".gitattributes", - "AGENTS.md", - "CHANGELOG.md", - "COPYRIGHT.md", - "LICENSES/Coco3Plus-BSD-3-Clause.txt", - "LICENSING.md", - "NOTICE.md", - "docs/BUG_FIXES.md", - "docs/BUILD_WINDOWS.md", - "docs/FEATURES.md", - "docs/INSTALL.md", - "docs/MENUS.md", - "docs/SD_IMAGE.md", - "docs/VALIDATION.md", - "external-io.sdc", - "reset-cpu.sdc", - "roms/README.md", - "rtl/bh_mpi_config.sv", - "rtl/bh_mpi_rom.sv", - "rtl/bh_mpi_router.sv", - "rtl/cpu_sdram_bridge.sv", - "rtl/ssc/LICENSE", - "rtl/ssc/ssc_audio.sv", - "rtl/ssc/ssc_ay8913.sv", - "rtl/ssc/ssc_cartridge.sv", - "rtl/ssc/ssc_glue.sv", - "rtl/ssc/ssc_host.sv", - "rtl/ssc/ssc_mister_bridge.sv", - "rtl/ssc/ssc_sp0256.sv", - "rtl/ssc/ssc_sp0256_memory.sv", - "rtl/ssc/ssc_sp0256_tables.vh", - "rtl/ssc/ssc_tms7000.sv", - "rtl/ssc/ssc_tms7000_alu.sv", - "rtl/ssc/ssc_tms7000_bcd.sv", - "rtl/ssc/ssc_tms7000_decode.sv", - "rtl/ssc/ssc_tms7000_defs.vh", - "rtl/ssc/ssc_tms7000_exec.sv", - "rtl/ssc/ssc_tms7000_io.sv", - "rtl/ssc/ssc_tms7000_memory.sv", - "rtl/ssc/ssc_tms7000_pacer.sv", - "scripts/bh_mpi_timing.tcl", - "scripts/coco3_bh_profile.py", - "scripts/external_io_timing.tcl", - "scripts/nmi_timing_paths.tcl", - "scripts/reset_cpu_timing_paths.tcl", - "scripts/rom_inputs.py", +{ + "copyright": "Copyright (c) 2026 Brian K. Holman", + "scope": "Original Plus contributions only; original component rights retained", + "modified_inherited_files": [ + ".gitignore", + "CoCo3.qsf", + "CoCo3.sv", + "README.md", + "files.qip", + "rtl/CoCo3FPGA.sdc", + "rtl/EE_Cold_Bt.v", + "rtl/UART_6551/6551rx.v", + "rtl/UART_6551/uart_6551.v", + "rtl/coco3fpga.sv", + "rtl/fdc.sv", + "rtl/mc6809glb/mc6809glb.v", + "rtl/sdc.sv", + "rtl/sdc_top.sv", + "rtl/sdram/sdram2.sv", + "sys/i2c.v", + "sys/mcp23009.sv" + ], + "new_project_files": [ + ".gitattributes", + "AGENTS.md", + "CHANGELOG.md", + "COPYRIGHT.md", + "LICENSES/Coco3Plus-BSD-3-Clause.txt", + "LICENSING.md", + "NOTICE.md", + "docs/BUG_FIXES.md", + "docs/BUILD_WINDOWS.md", + "docs/FEATURES.md", + "docs/INSTALL.md", + "docs/MENUS.md", + "docs/SD_IMAGE.md", + "docs/VALIDATION.md", + "external-io.sdc", + "reset-cpu.sdc", + "roms/README.md", + "rtl/bh_mpi_config.sv", + "rtl/bh_mpi_rom.sv", + "rtl/bh_mpi_router.sv", + "rtl/cpu_sdram_bridge.sv", + "rtl/ssc/LICENSE", + "rtl/ssc/ssc_audio.sv", + "rtl/ssc/ssc_ay8913.sv", + "rtl/ssc/ssc_cartridge.sv", + "rtl/ssc/ssc_glue.sv", + "rtl/ssc/ssc_host.sv", + "rtl/ssc/ssc_mister_bridge.sv", + "rtl/ssc/ssc_sp0256.sv", + "rtl/ssc/ssc_sp0256_memory.sv", + "rtl/ssc/ssc_sp0256_tables.vh", + "rtl/ssc/ssc_tms7000.sv", + "rtl/ssc/ssc_tms7000_alu.sv", + "rtl/ssc/ssc_tms7000_bcd.sv", + "rtl/ssc/ssc_tms7000_decode.sv", + "rtl/ssc/ssc_tms7000_defs.vh", + "rtl/ssc/ssc_tms7000_exec.sv", + "rtl/ssc/ssc_tms7000_io.sv", + "rtl/ssc/ssc_tms7000_memory.sv", + "rtl/ssc/ssc_tms7000_pacer.sv", + "scripts/bh_mpi_timing.tcl", + "scripts/coco3_bh_profile.py", + "scripts/external_io_timing.tcl", + "scripts/nmi_timing_paths.tcl", + "scripts/reset_cpu_timing_paths.tcl", + "scripts/rom_inputs.py", "scripts/run_regressions.py", - "scripts/source_snapshot.py", - "scripts/ssc_integrated_timing.tcl", - "scripts/test_bh_menu.py", - "scripts/test_bh_mpi.py", - "scripts/test_bh_mpi_core.py", - "scripts/test_coco3_bh_startup.py", - "scripts/test_external_audio.py", - "scripts/test_external_i2c.py", - "scripts/test_external_pixel.py", - "scripts/test_external_sdram.py", - "scripts/test_external_sdram_commands.py", - "scripts/test_joystick_button_routing.py", - "scripts/test_keyboard_control_phase.py", - "scripts/test_peripheral_phase.py", - "scripts/test_registered_interfaces.py", - "scripts/test_reset_domains.py", - "scripts/test_ssc_mister_system.py", - "scripts/test_video_sdram.py", - "scripts/uart_timing_paths.tcl", - "scripts/validation_common.py", - "scripts/video_timing_paths.tcl", - "tests/bh_mpi_core_tb.sv", - "tests/bh_mpi_startup_tb.sv", - "tests/bh_mpi_tb.sv", - "tests/boot_control_tb.sv", - "tests/bridge_protocol_tb.sv", - "tests/completion_phase_tb.sv", - "tests/cpu_sdram_bridge_tb.sv", - "tests/disk_buffer_pipeline_tb.sv", - "tests/external_audio_tb.sv", - "tests/external_i2c_tb.sv", - "tests/external_sdram_commands_tb.sv", - "tests/keyboard_control_phase_tb.sv", - "tests/peripheral_phase_tb.sv", - "tests/reset_domains_tb.sv", - "tests/ssc_mister_system_tb.sv", - "tests/test_release_guards.py", - "tests/test_tooling_guards.py", - "tests/video_sdram_tb.sv", - "tools/audit_timing.py", - "tools/bootstrap.py", - "tools/build_fpga.py", - "tools/build_roms.py", - "tools/cocoroms.json", - "tools/install_mister.py", - "tools/project_inputs.json", - "tools/release.py", - "tools/timing_coverage.py", - "tools/toolchain.json", - "uart-reset.sdc", - "windows/Build-FPGA.ps1", - "windows/Build-ROMs.ps1", - "windows/Install-MiSTer.ps1", - "windows/Package-Release.ps1", - "windows/Setup-Tools.ps1", - "windows/Test.ps1" - ] -} + "scripts/test_joystick_button_routing.py", + "scripts/source_snapshot.py", + "scripts/ssc_integrated_timing.tcl", + "scripts/test_bh_menu.py", + "scripts/test_bh_mpi.py", + "scripts/test_bh_mpi_core.py", + "scripts/test_coco3_bh_startup.py", + "scripts/test_external_audio.py", + "scripts/test_external_i2c.py", + "scripts/test_external_pixel.py", + "scripts/test_external_sdram.py", + "scripts/test_external_sdram_commands.py", + "scripts/test_keyboard_control_phase.py", + "scripts/test_peripheral_phase.py", + "scripts/test_registered_interfaces.py", + "scripts/test_reset_domains.py", + "scripts/test_ssc_mister_system.py", + "scripts/test_video_sdram.py", + "scripts/uart_timing_paths.tcl", + "scripts/validation_common.py", + "scripts/video_timing_paths.tcl", + "tests/bh_mpi_core_tb.sv", + "tests/bh_mpi_startup_tb.sv", + "tests/bh_mpi_tb.sv", + "tests/boot_control_tb.sv", + "tests/bridge_protocol_tb.sv", + "tests/completion_phase_tb.sv", + "tests/cpu_sdram_bridge_tb.sv", + "tests/disk_buffer_pipeline_tb.sv", + "tests/external_audio_tb.sv", + "tests/external_i2c_tb.sv", + "tests/external_sdram_commands_tb.sv", + "tests/keyboard_control_phase_tb.sv", + "tests/peripheral_phase_tb.sv", + "tests/reset_domains_tb.sv", + "tests/ssc_mister_system_tb.sv", + "tests/test_release_guards.py", + "tests/test_tooling_guards.py", + "tests/video_sdram_tb.sv", + "tools/audit_timing.py", + "tools/bootstrap.py", + "tools/build_fpga.py", + "tools/build_roms.py", + "tools/cocoroms.json", + "tools/install_mister.py", + "tools/project_inputs.json", + "tools/release.py", + "tools/timing_coverage.py", + "tools/toolchain.json", + "uart-reset.sdc", + "windows/Build-FPGA.ps1", + "windows/Build-ROMs.ps1", + "windows/Install-MiSTer.ps1", + "windows/Package-Release.ps1", + "windows/Setup-Tools.ps1", + "windows/Test.ps1" + ] +}