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
@@ -1,19 +1,53 @@
|
||||
# CoCo3 Mister
|
||||
# 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.
|
||||
|
||||
## CoCo3FPGA port to MiSTer
|
||||
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.
|
||||
|
||||
This is a port of Gary Becker's famous CoCo3 in an FPGA to the MiSTer platform by Stan Hodge, Gary Becker and Alan Steremberg.
|
||||
## Build and install on Windows
|
||||
|
||||
## Roms Needed
|
||||
Install Git, Python 3.10+, and Quartus Prime Lite **17.0.2 Build 602** with
|
||||
Cyclone V device support. From this checkout in PowerShell:
|
||||
|
||||
* boot0.rom - 32K coco3 rom
|
||||
* boot1.rom - 8K Disk extended color basic rom
|
||||
```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
|
||||
```
|
||||
|
||||
Note: This core requires the external sdram memory module (128M) to function.
|
||||
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.
|
||||
|
||||
Rename your roms, and place them in the games/CoCo3/ directory
|
||||
otherwise you will get a black screen
|
||||
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.
|
||||
Reference in new issue
Block a user