Integrate CoCo Letters with VCC Plus and verified board startup

Add project library bindings, delivered CoCoLetters.DSK, actual board screenshots and installed build-43 public-MCP validation. Preserve upstream application sources and original notices.
This commit is contained in:
Brian Holman committed 2026-11-09 23:39:35 -07:00
1 parent 4cedb2d94a
commit a1b27b2233
12 files changed
+478 -32

No files matched your search

+3
View File
@@ -0,0 +1,3 @@
*.DSK binary
*.dsk binary
*.png binary
+18
View File
@@ -0,0 +1,18 @@
.DS_Store
._*
__pycache__/
*.pyc
*.o
*.a
*.bin
*.map
*.lst
*.link
*.i
*.hex
*.dsk
*.DSK
!/CoCoLetters.DSK
build/
.build/
.cache/
BIN
View File
Binary file not shown.
+28 -11
View File
@@ -16,11 +16,11 @@ MAX_NUM_DICT_BLOCKS = 9
# Required libraries.
DECBFILE_LIB = decbfile
DECBFILE_LIB_DIR = decbfile
DECBFILE_LIB_DIR = $(wildcard decbfile)
BCONTROL_LIB = bcontrol
BCONTROL_LIB_DIR = bcontrol
BCONTROL_LIB_DIR = $(wildcard bcontrol)
BSOUND_LIB = bsound
BSOUND_LIB_DIR = bsound
BSOUND_LIB_DIR = $(wildcard bsound)
# Main program.
SRC = \
@@ -52,9 +52,18 @@ HEADERS = \
CursorBlinker.h \
PositionIterator.h
LIBS = -L $(DECBFILE_LIB_DIR) -l$(DECBFILE_LIB) \
-L $(BCONTROL_LIB_DIR) -l$(BCONTROL_LIB) \
-L $(BSOUND_LIB_DIR) -l$(BSOUND_LIB)
# VCC Plus can supply staged library directories through Project Settings.
# Otherwise its cmoc wrapper already searches the bundled headers and archives.
LIB_DIRS = $(DECBFILE_LIB_DIR) $(BCONTROL_LIB_DIR) $(BSOUND_LIB_DIR)
LIB_INCLUDES = $(addprefix -I,$(LIB_DIRS))
LIBS = $(addprefix -L,$(LIB_DIRS)) -l$(DECBFILE_LIB) -l$(BCONTROL_LIB) -l$(BSOUND_LIB)
ifeq ($(strip $(DECBFILE_LIB_DIR)),)
LIBS += -ldskcon-standalone
endif
LIB_INPUTS = $(addsuffix /lib$(DECBFILE_LIB).a,$(DECBFILE_LIB_DIR)) \
$(addsuffix /lib$(BCONTROL_LIB).a,$(BCONTROL_LIB_DIR)) \
$(addsuffix /lib$(BSOUND_LIB).a,$(BSOUND_LIB_DIR))
BIN = $(PACKAGE_SHORT).bin
DSK = $(PACKAGE)-$(VERSION).dsk
PCLEARARG = 1
@@ -103,7 +112,7 @@ DEFINES = \
$(FIXED_SEED)
CFLAGS = --$(TARGET) $(WERROR) $(INTERMEDIATE) $(NO_RELOCATE) $(OPTIM) \
$(DEFINES) \
-I $(DECBFILE_LIB_DIR) -I $(BCONTROL_LIB_DIR) -I $(BSOUND_LIB_DIR) \
$(LIB_INCLUDES) \
--stack-space=$(STACKSPACE)
LDFLAGS = --$(TARGET) $(ORG) $(INTERMEDIATE)
@@ -124,17 +133,20 @@ INSTALL_LOADER = install-coco-boot-loader
XROAR = xroar
PARSE_COCO_BIN = parse-coco-bin
.DEFAULT_GOAL := all
.DELETE_ON_ERROR:
.PHONY: all build disk clean
all: $(DSK)
build: all
disk: $(DSK)
$(BIN): $(OBJ) $(DECBFILE_LIB_DIR)/lib$(DECBFILE_LIB).a \
$(BCONTROL_LIB_DIR)/lib$(BCONTROL_LIB).a \
$(BSOUND_LIB_DIR)/lib$(BSOUND_LIB).a
$(BIN): $(OBJ) $(LIB_INPUTS)
$(CMOC) -o $(BIN) $(LDFLAGS) $(OBJ) $(LIBS)
.PHONY: dict
dict: $(WORD_LENGTH_FILENAME)
$(DATA_FILENAME) $(WORD_LENGTH_FILENAME): $(BUILD_DATA) $(WORDLIST) defs.h
$(DATA_FILENAME) $(WORD_LENGTH_FILENAME) &: $(BUILD_DATA) $(WORDLIST) defs.h font4x8-ascii.c font5x8-A-Z.c
$(PERL) $(BUILD_DATA) $(WORDLIST) $(DATA_FILENAME) $(WORD_LENGTH_FILENAME) $(MIN_WORD_LEN) $(MAX_WORD_LEN) $(MAX_NUM_DICT_BLOCKS)
test -f $(DATA_FILENAME)
test -f $(WORD_LENGTH_FILENAME)
@@ -190,10 +202,15 @@ binaries: $(DSK)
#
.PHONY: recurse
recurse:
ifeq ($(strip $(LIB_DIRS)),)
@echo "Using the prebuilt VCC Plus libraries."
else
$(MAKE) -C $(DECBFILE_LIB_DIR) $(RECURSION)
$(MAKE) -C $(BCONTROL_LIB_DIR) $(RECURSION)
$(MAKE) -C $(BSOUND_LIB_DIR) $(RECURSION)
endif
# Automatic prerequisite generation.
%.d: %.c
$(CMOC) --deps-only $(CFLAGS) $<
+205
View File
@@ -0,0 +1,205 @@
PACKAGE = coco-letters
VERSION = 0.1.0
DISPLAY_NAME = CoCo Letters
# Must be at most 8 characters.
PACKAGE_SHORT = letters
# Length of the words to be selected from file $(WORDLIST).
MIN_WORD_LEN = 2
MAX_WORD_LEN = 5
# Maximum number of MMU blocks that can contain dictionary entries.
# See the memory map in HACKING.md.
MAX_NUM_DICT_BLOCKS = 9
# Required libraries.
DECBFILE_LIB = decbfile
DECBFILE_LIB_DIR = decbfile
BCONTROL_LIB = bcontrol
BCONTROL_LIB_DIR = bcontrol
BSOUND_LIB = bsound
BSOUND_LIB_DIR = bsound
# Main program.
SRC = \
main.c \
graphics.c \
file.c \
dict.c \
GameState.c \
GamePlayer.c \
WordSearch.c \
CursorBlinker.c \
PositionIterator.c
# N.B.: font4x8-ascii.c and font5x8-A-Z.c are not compiled.
# They are read by $(BUILD_DATA) to generate part of the game data file.
GENERATED_SRC = $(WORD_LENGTH_FILENAME)
HEADERS = \
defs.h \
graphics.h \
file.h \
dict.h \
GameState.h \
GamePlayer.h \
WordSearch.h \
palette.h \
board.h \
CursorBlinker.h \
PositionIterator.h
LIBS = -L $(DECBFILE_LIB_DIR) -l$(DECBFILE_LIB) \
-L $(BCONTROL_LIB_DIR) -l$(BCONTROL_LIB) \
-L $(BSOUND_LIB_DIR) -l$(BSOUND_LIB)
BIN = $(PACKAGE_SHORT).bin
DSK = $(PACKAGE)-$(VERSION).dsk
PCLEARARG = 1
# Dictionary.
# List of words.
WORDLIST = word-list.txt
# Files generated by the BUILD_DATA script from $(WORDLIST).
DATA_FILENAME = $(PACKAGE_SHORT).dat
WORD_LENGTH_FILENAME = word-length-index.c
# Script that builds DATA_FILENAME.
#
BUILD_DATA = build-data.pl
# Compilation and linking flags.
# The limit is $7F80 because 128 bytes are left for Basic's stack,
# which still exists at the moment when the user EXECs $(BIN).
#
ORG = --org=2000 --limit=7F80
TARGET = coco
INTERMEDIATE = #--intermediate
WERROR = -Werror
STACKSPACE = 2048
OPTIM = -fomit-frame-pointer -Oy
NDEBUG = -DNDEBUG
# Unsigned 16 bit integer other than 0.
# If defined, gets passed to srand().
# If not defined, timer is used.
#
FIXED_SEED = #-DFIXED_SEED=42
DEFINES = \
'-DDISPLAY_NAME="$(DISPLAY_NAME)"' \
-DVERSION=\"$(VERSION)\" \
$(NDEBUG) \
-DDATA_FILENAME=\"$(DATA_FILENAME)\" \
-DMIN_WORD_LEN=$(MIN_WORD_LEN) \
-DMAX_WORD_LEN=$(MAX_WORD_LEN) \
-DMAX_NUM_DICT_BLOCKS=$(MAX_NUM_DICT_BLOCKS) \
$(FIXED_SEED)
CFLAGS = --$(TARGET) $(WERROR) $(INTERMEDIATE) $(NO_RELOCATE) $(OPTIM) \
$(DEFINES) \
-I $(DECBFILE_LIB_DIR) -I $(BCONTROL_LIB_DIR) -I $(BSOUND_LIB_DIR) \
--stack-space=$(STACKSPACE)
LDFLAGS = --$(TARGET) $(ORG) $(INTERMEDIATE)
OBJ = $(GENERATED_SRC:.c=.o) $(SRC:.c=.o)
DISTFILES = \
README.md HACKING.md COPYING \
Makefile \
$(SRC) $(HEADERS) font4x8-ascii.c font5x8-A-Z.c autostart.c \
$(BUILD_DATA) $(WORDLIST)
# Tools.
CMOC = cmoc
PERL = perl
TAR = tar
WRITECOCOFILE = writecocofile
INSTALL_LOADER = install-coco-boot-loader
XROAR = xroar
PARSE_COCO_BIN = parse-coco-bin
all: $(DSK)
$(BIN): $(OBJ) $(DECBFILE_LIB_DIR)/lib$(DECBFILE_LIB).a \
$(BCONTROL_LIB_DIR)/lib$(BCONTROL_LIB).a \
$(BSOUND_LIB_DIR)/lib$(BSOUND_LIB).a
$(CMOC) -o $(BIN) $(LDFLAGS) $(OBJ) $(LIBS)
.PHONY: dict
dict: $(WORD_LENGTH_FILENAME)
$(DATA_FILENAME) $(WORD_LENGTH_FILENAME): $(BUILD_DATA) $(WORDLIST) defs.h
$(PERL) $(BUILD_DATA) $(WORDLIST) $(DATA_FILENAME) $(WORD_LENGTH_FILENAME) $(MIN_WORD_LEN) $(MAX_WORD_LEN) $(MAX_NUM_DICT_BLOCKS)
test -f $(DATA_FILENAME)
test -f $(WORD_LENGTH_FILENAME)
$(DSK): $(BIN) $(DATA_FILENAME) autostart.bin
$(PERL) -e 'print chr(255) x (35*18*256)' > $(DSK)
$(INSTALL_LOADER) $(DSK) autostart.bin
$(WRITECOCOFILE) --allocate-after-dir $(DSK) $(BIN)
$(WRITECOCOFILE) --allocate-before-dir $(DSK) $(DATA_FILENAME)
# Loader that goes on track 34 to be executed by the CoCo DOS command.
autostart.bin: autostart.c Makefile
$(CMOC) --dos -o $@ -D'COMMAND="CLEAR8:PCLEAR$(PCLEARARG):LOADM\"$(PACKAGE_SHORT)\":EXEC"' autostart.c
.PHONY: sizes
sizes: $(BIN)
$(PARSE_COCO_BIN) $(BIN)
%.o: %.c
$(CMOC) -c $(CFLAGS) -o $@ $<
.PHONY: clean-dict
clean-dict:
rm -f $(DATA_FILENAME) $(WORD_LENGTH_FILENAME)
clean: clean-dict
rm -f $(BIN) autostart.bin $(OBJ) $(OBJ:.o=.s) $(OBJ:.o=.lst) $(PACKAGE).map $(PACKAGE).link
distclean: clean
rm -f $(GENERATED_SRC) $(SRC:.c=.d)
.PHONY: dist distcheck
dist:
$(TAR) -czf $(PACKAGE)-$(VERSION).tar.gz --transform 's,^,$(PACKAGE)-$(VERSION)/,' $(DISTFILES)
distcheck: dist
mkdir ,distcheck
$(TAR) -C ,distcheck -xzf $(PACKAGE)-$(VERSION).tar.gz
$(MAKE) -C ,distcheck/$(PACKAGE)-$(VERSION) \
DECBFILE_LIB_DIR=../../$(DECBFILE_LIB_DIR) \
BCONTROL_LIB_DIR=../../$(BCONTROL_LIB_DIR) \
BSOUND_LIB_DIR=../../$(BSOUND_LIB_DIR)
rm -fr ,distcheck
@echo "SUCCESS: $(PACKAGE)-$(VERSION).tar.gz ready for distribution"
.PHONY: binaries
binaries: $(DSK)
$(TAR) -czf $(PACKAGE)-$(VERSION)-binaries.tar.gz $(PACKAGE)-$(VERSION).dsk
# Runs make with arguments $(RECURSION) in the library projects used by this package.
# Supports the -n (dry run) option.
# Example: make recurse RECURSION=clean
#
.PHONY: recurse
recurse:
$(MAKE) -C $(DECBFILE_LIB_DIR) $(RECURSION)
$(MAKE) -C $(BCONTROL_LIB_DIR) $(RECURSION)
$(MAKE) -C $(BSOUND_LIB_DIR) $(RECURSION)
# Automatic prerequisite generation.
%.d: %.c
$(CMOC) --deps-only $(CFLAGS) $<
.PHONY: cleandeps
cleandeps:
rm -f $(SRC:.c=.d)
include $(SRC:.c=.d)
+36 -21
View File
@@ -1,36 +1,51 @@
# Word Game
# CoCo Letters
Copyright © 2026 Pierre Sarrazin <http://sarrazip.com/>
A word game for the Color Computer 3 by **Pierre Sarrazin**. This repository
contains upstream version **0.1.0** with a VCC Plus project and playable disk.
License: GNU GPL v3 or later, except where stated otherwise.
See file COPYING.
![CoCo Letters board and letter rack running in VCC Plus](docs/screenshots/gameplay.png)
Home page: <http://sarrazip.com/dev/FIXME.html>
## Download and run
Insert the floppy disk that contains this game in drive 0,
then type DOS and press the Enter key.
Download [CoCoLetters.DSK](CoCoLetters.DSK). Mount a writable copy in drive 0 of a
**512 KB CoCo 3 / 6809 / Disk BASIC** machine and type:
```basic
DOS
```
# Requirements
Allow the dictionary to finish loading. Choose **R** for an RGB monitor, **E**
for easy difficulty and **U** to take the first turn. The board then shows the
letter rack and cursor. Follow the on-screen arrow/Enter instructions; **?**
opens help and **Break** opens options.
## Hardware
## Build in VCC Plus
* CoCo 3.
* RGB monitor.
* Floppy disk controller.
1. Open this repository’s root folder in **Develop → C Development → Open**.
2. Select **Release**, then choose **Build Disk**.
3. Use **Show Build Products** to find `coco-letters-0.1.0.dsk` in the build
snapshot. Mount a writable copy and type `DOS`.
The declared disk target is `all` in `Makefile`. The supplied `CoCoLetters.DSK` is
this disk image under a short download filename. VCC Plus provides the bundled
compiler, disk tools and supported target libraries.
## Software
The disk build and illustrated run were verified through the public MCP
interface in **VCC Plus 3.5.0 build 43**. [Validation details](docs/VALIDATION.md)
describe the observed behavior and its limits.
These libraries are needed to build this game from its source code:
## Original source
* decbfile (>= 0.1.13)
* bcontrol (>= 0.1.6) (keyboard and joystick support)
* bsound (>= 0.1.4) (sound)
- Author: [Pierre Sarrazin](http://sarrazip.com/).
- [Project page](http://sarrazip.com/dev/coco-letters.html).
- [Version 0.1.0 source archive](http://sarrazip.com/dev/coco-letters-0.1.0.tar.gz).
- Archive SHA-256: `ad7c7771845e1a35014644fb562634a558abee632e1d7738683db6e9e9e46b94`.
They can be obtained from the CMOC Home Page.
The [original README](docs/UPSTREAM_README.md) and source notices are preserved.
See [source provenance](docs/PROVENANCE.md) for the import and integration history.
## License
# Version history
0.1.0 20??-FIXME First public release.
The application is licensed under **GPL-3.0-or-later**, except where individual
files state otherwise. Fonts, loader and word-list files retain their separate
public-domain notices. See [COPYING](COPYING) and the original source notices.
+41
View File
@@ -0,0 +1,41 @@
# Source provenance
## Original package
- Original author: **Pierre Sarrazin**.
- Package: **coco-letters 0.1.0**.
- [Project page](http://sarrazip.com/dev/coco-letters.html).
- [Source archive](http://sarrazip.com/dev/coco-letters-0.1.0.tar.gz).
- Archive SHA-256: `ad7c7771845e1a35014644fb562634a558abee632e1d7738683db6e9e9e46b94`.
The VCCPlus source manifest records the historical download URL
`http://gvlsywt.cluster051.hosting.ovh.net/dev/coco-letters-0.1.0.tar.gz` with
the same archive SHA-256. The local `.tgz` filename does not represent a separate
version.
The checksum identifies the imported archive bytes, not an independent
proof of authenticity. Original file-specific license notices remain in effect.
## Git history and VCC Plus integration
The original distribution was a source archive. The initial commit,
`4cedb2d94ac8dc531c29a1310c1fcafdea0a6943`, imports its 29 original regular files before
integration. The original README is preserved byte-for-byte in `UPSTREAM_README.md`.
The integration retains the application C/header sources and original notices.
The adapted Makefile binds supported target libraries and disk support, while
`Makefile.orig` preserves the upstream recipe. `vccplus-project.json` declares
bundled decbfile, bcontrol, bsound and standalone-driver bindings and selects
the `all` disk target with a `DOS` launcher.
The top-level `CoCoLetters.DSK` is an intentional playable artifact. Generated object,
map/listing and incidental binary outputs are excluded. The public README,
actual screenshot and [validation record](VALIDATION.md) document the completed
installed build-43 public MCP build and observed run. Source import and later
hosting/avatar changes are separate events. The original archive and earlier
local project were not modified by this import.
## License scope
The application is licensed under **GPL-3.0-or-later**, except where individual
files state otherwise. Fonts, loader and word-list files retain their separate
public-domain notices. See [COPYING](COPYING) and the original source notices.
+36
View File
@@ -0,0 +1,36 @@
# Word Game
Copyright © 2026 Pierre Sarrazin <http://sarrazip.com/>
License: GNU GPL v3 or later, except where stated otherwise.
See file COPYING.
Home page: <http://sarrazip.com/dev/FIXME.html>
Insert the floppy disk that contains this game in drive 0,
then type DOS and press the Enter key.
# Requirements
## Hardware
* CoCo 3.
* RGB monitor.
* Floppy disk controller.
## Software
These libraries are needed to build this game from its source code:
* decbfile (>= 0.1.13)
* bcontrol (>= 0.1.6) (keyboard and joystick support)
* bsound (>= 0.1.4) (sound)
They can be obtained from the CMOC Home Page.
# Version history
0.1.0 20??-FIXME First public release.
+59
View File
@@ -0,0 +1,59 @@
# CoCo Letters installed-app validation
Verified **November 9, 2026** through the installed VCC Plus public MCP build
and disposable-playtest interface. The selected build and displayed state are
qualified below; this is not a full gameplay or regression-suite claim.
## Configuration
- VCC Plus **3.5.0 build 43**, bundled compiler/Make/disk tools.
- An isolated native copy of the installed app preserved the active CoCoMan
workspace. Its emulator code was unchanged; the bundle identity was changed
and the copy was ad-hoc signed for isolation.
- **Release**, **512 KB RAM**, **MC6809**, **Disk BASIC**.
- Approved Make recipe: `Makefile`; public build action: `disk`; target: `all`.
- Declared launch command: `DOS`.
- Declared bundled dependencies: decbfile, bcontrol, bsound and the separately
noticed standalone disk driver. The ordinary decbfile API and that optional
driver have distinct licensing notices.
## Build evidence
- Project ID: `27785999-3B78-416C-B286-F9E2FAF5B032`; source revision: `1`.
- Recipe ID: `717d0162c8a46ecbef1293e05748f9e7dea29911e997a5957f459ee96e068638`.
- Build ID: `0BD54AB7-4D5C-4C59-9F42-F751BE0A258A`; result: **succeeded**.
- Artifact ID: `276C97BD-F7E1-40B5-8A57-5357BB2F86C1`.
- `letters.bin`: **21,935 bytes**; SHA-256
`f26daa69d04abb84478f1ff6ae3490b82afe50c640354d29f596113cbf0c82e7`.
- `coco-letters-0.1.0.dsk`: **161,280 bytes**; SHA-256
`0b65f3b084063df01e34fee50d077f8108c0faa1c75fae95d6fdfde37648164e`.
The delivered `CoCoLetters.DSK` is byte-identical to the verified disk output.
No compiler warnings appeared in the available build log.
## Execution and screenshot
The dictionary loaded, then the RGB monitor (**R**), easy difficulty (**E**)
and user-first-turn (**U**) options reached the actual board and letter rack.
The 640 × 480 capture shows the user’s turn and starting-square instructions.
This goes beyond the earlier dictionary-loading screen; no word placement,
scoring, AI response or complete game was tested.
Dictionary loading was allowed an additional 3,000 video fields before the
RGB/easy/user-first selections. The MCP-owned run was `E5035C2A-A55C-4148-AAF1-4EE266A2DB28`. At gameplay capture it
had reached **4,332 video fields**, with **90,624 disk-read bytes**,
**0 disk writes**, and the same disk SHA-256 as the verified artifact.
The run was then stopped and its test disk retained by VCC Plus.
[The gameplay screenshot](screenshots/gameplay.png) is the actual **640 × 480**
framebuffer returned by MCP. SHA-256:
`9b293eaceead927f2e0745d7a32ae22b64ae48137eab62250829a9407f1ff804`.
The running.png image is the same board capture, replacing the initial loader-progress image.
## Scope
This establishes a fresh Release disk build, successful disk startup and the
specific displayed states and bounded inputs above. It does not claim full
rules/scoring/gameplay coverage, HD6309 execution, Intel/Rosetta qualification,
physical CoCo hardware or audible audio. No private connection grant or raw
host log is included.
Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

+52
View File
@@ -0,0 +1,52 @@
{
"entrySource": "main.c",
"makefile": "Makefile",
"buildTarget": "",
"cleanTarget": "clean",
"diskTarget": "all",
"binary": "letters.bin",
"diskImage": "coco-letters-0.1.0.dsk",
"launchMode": "disk",
"launchCommands": [
"DOS"
],
"jobs": 1,
"configurations": [
{
"name": "Debug",
"makeArguments": [
"INTERMEDIATE=--intermediate"
]
},
{
"name": "Release",
"makeArguments": []
}
],
"bundledLibraries": [
{
"library": "decbfile",
"minimumVersion": "0.1.13",
"directoryVariable": "DECBFILE_LIB_DIR",
"linkVariable": ""
},
{
"library": "bcontrol",
"minimumVersion": "0.1.6",
"directoryVariable": "BCONTROL_LIB_DIR",
"linkVariable": ""
},
{
"library": "bsound",
"minimumVersion": "0.1.4",
"directoryVariable": "BSOUND_LIB_DIR",
"linkVariable": ""
},
{
"library": "dskcon-standalone",
"minimumVersion": "",
"directoryVariable": "",
"linkVariable": "LIBS"
}
]
}