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

+105
View File
@@ -0,0 +1,105 @@
# Menu tree and operating guide
Select **Computer → Coco 3 Plus**, then press F12 for its core menu. Escape/F12
closes the OSD; Left returns from a page. MiSTer's own system menu supplies core
selection, configuration saving and other host-wide controls. The following tree
is the Plus `CONF_STR` organization; conditional rows depend on assigned devices.
```text
Coco 3 Plus
├─ Cartridges & Multi-Pak
│ ├─ Startup slot: Slot 1 / Slot 2 / Slot 3 / Slot 4
│ ├─ Slot 1: Empty / ROM file / Floppy / CoCo SDC / Sound & Speech /
│ │ Orchestra90 / Audio expansions / RS232
│ │ └─ Slot 1 ROM (when that socket provides program ROM)
│ ├─ Slot 2: same device choices; Slot 2 ROM
│ ├─ Slot 3: same device choices; Slot 3 ROM
│ ├─ Slot 4: same device choices; Slot 4 ROM
│ ├─ ROM pool: 256K total; Max ROM: 128K per slot
│ └─ ROM load error: size/full (only on error)
├─ Floppy Disks
│ ├─ Drive 0: DSK
│ ├─ Drive 1: DSK
│ ├─ Drive 2: DSK
│ └─ Drive 3: DSK
├─ CoCo SDC
│ ├─ SDC Drive 0: DSK / VHD
│ ├─ SDC Drive 1: DSK / VHD
│ └─ OS9 floppy mounts: /d0 / /d1 / /d3 / /d4 (DSK)
├─ Sound & Expansion
│ ├─ Expansion: Extended palette / Sound & Speech
│ ├─ Assign SSC in Multi-Pak (when no SSC-capable socket exists)
│ ├─ Sound & Speech not ready / ready / error
│ ├─ Orchestra90 stereo enabled (when assigned)
│ └─ Audio = SSC + Orchestra90 (explanation)
├─ Cassette
│ ├─ Load Cassette: CAS
│ ├─ Stop & Rewind
│ ├─ Monitor Tape Sound: No / Yes
│ ├─ Save Cassette: CAS
│ └─ Transport: Playback / Rewind / Record
├─ Machine
│ ├─ Memory Size: 512K / 1M / 2M / 16M
│ ├─ Force Turbo: No / Yes
│ ├─ Turbo Speed: CoCo Ctrl / 0.89 / 1.78 / 2.86 / 3.58 / 7.16 / 9.54 MHz
│ ├─ Auto Run: Off / DOS / AUTO.BAS
│ ├─ Cold Boot
│ └─ Reset
├─ Display
│ ├─ Aspect ratio: Original / Full Screen / Wide / [ARC1]
│ ├─ Scandoubler Fx: None / HQ2x / CRT 25% / CRT 50% / CRT 75%
│ ├─ CoCo3 LC: Yes / No-(SG6=Yes)
│ ├─ Artifact Type: MESS / Simple / NONE
│ └─ Artifact Color Set: 0 / 1
├─ Input
│ ├─ D-Pad Joystick emu: No / Yes
│ ├─ Swap Joysticks: Off / On
│ └─ Mouse as right joystick: Off / On
└─ Advanced
├─ Load COCO Font: BIN
├─ Swap MiSTer Uart: RS CART / Default
├─ Swap Uart to IO: RS IO / MiSTer
├─ Display Debug: Off / On
└─ Easter Egg
```
The root has nine stable pages. Hidden legacy cartridge and SSC firmware loaders
remain in the configuration string for native startup-file compatibility. They
are not additional top-level pages or everyday user setup steps.
## Choosing devices and disks
Built-in devices move sockets. Selecting a second Floppy, for example, moves the
existing controller and its mounted disks to the newly chosen socket. Assigning
Sound & Speech or Orchestra90 separately can split the corresponding portion out
of Audio expansions. Other instances are cleared deterministically, preserving
one instance of each real built-in controller. ROM files may occupy multiple
sockets simultaneously within the shared allocation limit.
Startup slot chooses the socket selected when the guest starts; it does not
rotate disk-controller types or change which disk image is mounted. The guest
can subsequently change its Multi-Pak selectors. Use Floppy Disks or CoCo SDC to
mount media for that controller. The rows are disabled when the corresponding
controller is absent. The OS9 mount names intentionally retain the upstream
/d0, /d1, /d3, /d4 conventions; they are not renumbered to imply new drive logic.
Changing a socket device restarts the CoCo. Mount media and save your MiSTer core
configuration after arranging the machine. On the next launch, remembered ROMs
are restored with the saved layout; no manual SSC chip-ROM loading is needed.
The installer preserves an existing Plus CFG rather than imposing a new layout.
## Sound and display
Assign an SSC-capable socket, select Sound & Speech on the expansion page and
check ready before running cartridge software. Extended palette and SSC share
register space, so this is an ownership selection. Audio expansions is a
compatibility convenience for SSC plus Orchestra90, not a third sound chip.
MiSTer supplies audio through its supported HDMI/analog configuration; a remote
video capture device may omit or mute HDMI audio even when core output works.
## Returning to MiSTer
Use MiSTer's OSD system/core-selection controls to choose another core without
a physical power switch. Save guest files first. Guest Reset/Cold Boot operate
on the CoCo environment; they are different from loading another RBF or turning
the whole MiSTer off.