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,55 @@
|
||||
"""Conditional external timing coverage classification.
|
||||
Copyright (c) 2026 Brian K. Holman. BSD-3-Clause; see LICENSES/.
|
||||
"""
|
||||
import re
|
||||
|
||||
def parse_ucp(path):
|
||||
text = path.read_text(errors='replace')
|
||||
counts = {m[1].strip(): {'setup': int(m[2]), 'hold': int(m[3])}
|
||||
for m in re.finditer(r';\s*(Illegal Clocks|Unconstrained [^;]+?)\s*;\s*(\d+)\s*;\s*(\d+)\s*;', text)}
|
||||
inventory = {'input_ports': {}, 'output_ports': {}}
|
||||
section = None
|
||||
# Retain only the setup inventory (hold inventory repeats it).
|
||||
for line in text.split('; Hold Analysis ;')[0].splitlines():
|
||||
cols = [x.strip() for x in line.split(';')[1:-1]]
|
||||
if cols == ['Unconstrained Input Ports']:
|
||||
section = 'input_ports'
|
||||
elif cols == ['Unconstrained Output Ports']:
|
||||
section = 'output_ports'
|
||||
elif cols and cols[0] in ('Unconstrained Input Port Paths', 'Unconstrained Output Port Paths'):
|
||||
section = None
|
||||
elif section and len(cols) == 2 and cols[0] not in ('Input Port', 'Output Port'):
|
||||
inventory[section][cols[0]] = cols[1]
|
||||
if len(counts) != 6:
|
||||
raise RuntimeError('Incomplete unconstrained-count summary')
|
||||
return counts, inventory
|
||||
|
||||
|
||||
def classify(port):
|
||||
if port.startswith('SDRAM_'):
|
||||
return 'SDRAM synchronous: must be explicitly timed; no exception allowed'
|
||||
if port == 'HDMI_TX_CLK':
|
||||
return 'Forwarded video clock: two generated-clock modes; clock waveform/output latency, not a data receiver'
|
||||
if port.startswith('HDMI_TX_'):
|
||||
return 'ADV7513 video: both clock mux modes require setup/hold budgets'
|
||||
if port in ('HDMI_I2S', 'HDMI_LRCLK', 'HDMI_SCLK'):
|
||||
return 'ADV7513 I2S: source protocol slots plus bounded output propagation'
|
||||
if port == 'HDMI_MCLK':
|
||||
return 'Forwarded audio clock: clock waveform/output latency, not a data receiver'
|
||||
if port.startswith('HDMI_I2C_'):
|
||||
return 'HPS hard I2C peripheral boundary: fabric STA does not prove slave bus timing'
|
||||
if port in ('IO_SCL', 'IO_SDA'):
|
||||
return 'MCP23009 I2C: require source-matched protocol slots, propagation and board RC/slave contract'
|
||||
if port == 'SDCD_SPDIF':
|
||||
return 'Mode-dependent asynchronous card detect / SPDIF output'
|
||||
if port.startswith('SDIO_') or port == 'SD_SPI_CS':
|
||||
return 'Mode-dependent HPS SD-SPI / analog VGA mux; cannot use one synchronous pin budget'
|
||||
if port.startswith('LED['):
|
||||
return 'Human status indicator / overtake mode; no synchronous external receiver'
|
||||
if port == 'USER_IO[1]':
|
||||
return 'Optional external UART input: UART synchronizer and direct bit-banged PIA fanout'
|
||||
if port.startswith('USER_IO['):
|
||||
return 'Open-drain serial/debug output or alternate I2S; receiver/RC is external'
|
||||
if port.startswith('altera_reserved_'):
|
||||
return 'Tool-generated JTAG interface: separate programming/test timing contract'
|
||||
return 'UNCLASSIFIED: investigation required'
|
||||
Reference in new issue
Block a user