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

+53
View File
@@ -0,0 +1,53 @@
# Component licenses and distribution
This is a mixed-license derivative. Original file notices remain authoritative;
this document does not relicense third-party code, ROMs or Intel/Altera IP.
New original Plus work and modifications are copyright (c) 2026 Brian K. Holman;
the precise scope is recorded in COPYRIGHT.md. Those original contributions are
available under LICENSES/Coco3Plus-BSD-3-Clause.txt, subject to the original
licenses of any combined or derived material.
## Inherited and derived source
| Component | Inspected source notice |
|---|---|
| Core/video and related Gary Becker material | BSD-style source and synthesized-form redistribution conditions, including notice/disclaimer retention and no endorsement. See individual headers. |
| MiSTer HPS interface, SDRAM controller and John Kent CPU variants | GPL version 3 or later in the applicable headers. SDRAM modifications also retain Stan Hodge/Sorgelig provenance. |
| Other MiSTer framework helpers | File-specific terms; some GPL version 2 or later. Keep each header, not a single inferred replacement license. |
| New SSC controller/speech/wiring derived from reference models | BSD-3-Clause; retain rtl/ssc/LICENSE and component attribution to Tim Lindner, Joseph Zbiciak and hap. |
| New MPI and original Plus helpers/tests/tooling | BSD-3-Clause for original contributions, with preserved reference-source terms where extracted code is involved. |
| Generated Intel/Altera IP and device primitives | Their original vendor notices/terms; a project-level BSD/GPL declaration does not replace these. |
| Greg Miller mc6809glb CPU | Original copyright-only header retained. No explicit upstream license grant found in that file. See assumption below. |
For a combined distribution containing GPL-covered material, retain the applicable
GPL terms and provide the corresponding source, build scripts and notices as
required by those licenses. A bitstream-only release must not omit the source
and license obligations that apply to its components. See the original
[GNU GPLv3](https://www.gnu.org/licenses/gpl-3.0.html),
[GNU GPLv2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html) and file headers.
This repository's permissive contribution license is not a blanket assertion
that the complete synthesized design is BSD-only.
## Maintainer assumption: Greg Miller CPU
The Coco 3 Plus FPGA Maintainer currently proceeds on the assumption that Greg
Miller's original CPU implementation is public domain. This is a **maintainer
assumption, not a confirmed upstream dedication or permission grant**. The
original copyright notice remains in rtl/mc6809glb/mc6809glb.v. If contrary or
clarifying information is received, amend this notice and distribution practice.
New Plus modifications are identified separately; this assumption does not
erase another author's rights or claim their work as original Plus code.
## ROMs, software libraries and external tools
SSC ROMs are external user-supplied inputs and are ignored by Git. The public
setup script does not fetch them. ToolShed cocoroms assembly is downloaded at a
pinned revision with original source notices retained; reproducible assembly is
not proof of blanket ROM redistribution permission. Included diagnostic/game
media require their own terms. Do not publish a library or a locally complete
release overlay merely because it was useful for private validation.
LWTOOLS, OSS CAD Suite, Quartus and MiSTer Linux/Main/Mr. Fusion have separate
licenses. Downloading or invoking those tools does not transfer their copyright
to this project. A future standalone image must preserve its operating-system,
bootloader and image-builder notices/source obligations in addition to the core's.