Files
CoCo3_Plus_MiSTer/docs/MENUS.md
T
bholman cb40fed3b9 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.
2026-11-18 16:00:45 -07:00

4.7 KiB

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.

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.