Files
CoCo3_Plus_MiSTer/README.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

54 lines
2.6 KiB
Markdown

# Coco 3 Plus for MiSTer
Coco 3 Plus extends [CoCo3_MiSTer](https://github.com/MiSTer-devel/CoCo3_MiSTer)
with a configurable four-slot Multi-Pak, an original-firmware Sound & Speech
implementation, a reorganized menu, and clock/reset/memory timing repairs.
The original upstream Git history is retained; the Plus implementation is one
consolidated commit on `main`. Other original branches and tags remain available.
The Computer menu entry is **Coco 3 Plus**. Media lives in
`/media/fat/games/coco3plus`, independently of the stock CoCo3 core.
This targets a DE10-Nano MiSTer with the upstream-required **128 MB SDRAM module**.
The separate original DE1 port is outside this repository.
## Build and install on Windows
Install Git, Python 3.10+, and Quartus Prime Lite **17.0.2 Build 602** with
Cyclone V device support. From this checkout in PowerShell:
```powershell
.\windows\Setup-Tools.ps1
.\windows\Build-ROMs.ps1
.\windows\Build-FPGA.ps1 -QuartusSh C:\intelFPGA_lite\17.0\quartus\bin64\quartus_sh.exe
# Place your separately obtained SSC ROMs in roms\ssc first.
.\windows\Install-MiSTer.ps1 -Load
```
The installer prompts for an IP address or hostname and uses your existing
passwordless SSH access. It preserves the stock core, existing games and saved
Plus configuration, and backs up replaced files. Save/quit the running guest
before installation: installation returns to the MiSTer menu.
The ROM build downloads pinned ToolShed assembly and uses native Windows LWASM;
it does not depend on another emulator checkout, Bash, WSL or CMOC. SSC's two chip
ROMs are separate inputs, ignored by Git and never downloaded by setup.
- [Windows toolchain and reproducible builds](docs/BUILD_WINDOWS.md)
- [Install, copy release files, first boot and rollback](docs/INSTALL.md)
- [Features and hardware behavior](docs/FEATURES.md)
- [Complete menu tree and operating notes](docs/MENUS.md)
- [Bug fixes: causes, implementation and checks](docs/BUG_FIXES.md)
- [Validation results and explicit limits](docs/VALIDATION.md)
- [Licenses and component provenance](LICENSING.md), [attribution](NOTICE.md)
- [Required ROM inputs](roms/README.md)
- [Standalone SD-image direction](docs/SD_IMAGE.md)
`Package-Release.ps1` produces a checked FAT-volume overlay for copying onto an
existing MiSTer card. The same payload is the basis for a future dedicated boot
image. An overlay alone is not a bootable image; MiSTer Linux and bootloader files
also reside on the SD card.
Timing results apply to the documented SDRAM/board-delay profile. Passing
simulation and static timing does not establish electrical compatibility with
every SDRAM module or validate every optional physical interface.