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:
1 parent
4cedb2d94a
commit
a1b27b2233
12 files changed
+478
-32
No files matched your search
@@ -0,0 +1,3 @@
|
|||||||
|
*.DSK binary
|
||||||
|
*.dsk binary
|
||||||
|
*.png binary
|
||||||
+18
@@ -0,0 +1,18 @@
|
|||||||
|
.DS_Store
|
||||||
|
._*
|
||||||
|
__pycache__/
|
||||||
|
*.pyc
|
||||||
|
*.o
|
||||||
|
*.a
|
||||||
|
*.bin
|
||||||
|
*.map
|
||||||
|
*.lst
|
||||||
|
*.link
|
||||||
|
*.i
|
||||||
|
*.hex
|
||||||
|
*.dsk
|
||||||
|
*.DSK
|
||||||
|
!/CoCoLetters.DSK
|
||||||
|
build/
|
||||||
|
.build/
|
||||||
|
.cache/
|
||||||
Binary file not shown.
@@ -16,11 +16,11 @@ MAX_NUM_DICT_BLOCKS = 9
|
|||||||
|
|
||||||
# Required libraries.
|
# Required libraries.
|
||||||
DECBFILE_LIB = decbfile
|
DECBFILE_LIB = decbfile
|
||||||
DECBFILE_LIB_DIR = decbfile
|
DECBFILE_LIB_DIR = $(wildcard decbfile)
|
||||||
BCONTROL_LIB = bcontrol
|
BCONTROL_LIB = bcontrol
|
||||||
BCONTROL_LIB_DIR = bcontrol
|
BCONTROL_LIB_DIR = $(wildcard bcontrol)
|
||||||
BSOUND_LIB = bsound
|
BSOUND_LIB = bsound
|
||||||
BSOUND_LIB_DIR = bsound
|
BSOUND_LIB_DIR = $(wildcard bsound)
|
||||||
|
|
||||||
# Main program.
|
# Main program.
|
||||||
SRC = \
|
SRC = \
|
||||||
@@ -52,9 +52,18 @@ HEADERS = \
|
|||||||
CursorBlinker.h \
|
CursorBlinker.h \
|
||||||
PositionIterator.h
|
PositionIterator.h
|
||||||
|
|
||||||
LIBS = -L $(DECBFILE_LIB_DIR) -l$(DECBFILE_LIB) \
|
# VCC Plus can supply staged library directories through Project Settings.
|
||||||
-L $(BCONTROL_LIB_DIR) -l$(BCONTROL_LIB) \
|
# Otherwise its cmoc wrapper already searches the bundled headers and archives.
|
||||||
-L $(BSOUND_LIB_DIR) -l$(BSOUND_LIB)
|
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
|
BIN = $(PACKAGE_SHORT).bin
|
||||||
DSK = $(PACKAGE)-$(VERSION).dsk
|
DSK = $(PACKAGE)-$(VERSION).dsk
|
||||||
PCLEARARG = 1
|
PCLEARARG = 1
|
||||||
@@ -103,7 +112,7 @@ DEFINES = \
|
|||||||
$(FIXED_SEED)
|
$(FIXED_SEED)
|
||||||
CFLAGS = --$(TARGET) $(WERROR) $(INTERMEDIATE) $(NO_RELOCATE) $(OPTIM) \
|
CFLAGS = --$(TARGET) $(WERROR) $(INTERMEDIATE) $(NO_RELOCATE) $(OPTIM) \
|
||||||
$(DEFINES) \
|
$(DEFINES) \
|
||||||
-I $(DECBFILE_LIB_DIR) -I $(BCONTROL_LIB_DIR) -I $(BSOUND_LIB_DIR) \
|
$(LIB_INCLUDES) \
|
||||||
--stack-space=$(STACKSPACE)
|
--stack-space=$(STACKSPACE)
|
||||||
LDFLAGS = --$(TARGET) $(ORG) $(INTERMEDIATE)
|
LDFLAGS = --$(TARGET) $(ORG) $(INTERMEDIATE)
|
||||||
|
|
||||||
@@ -124,17 +133,20 @@ INSTALL_LOADER = install-coco-boot-loader
|
|||||||
XROAR = xroar
|
XROAR = xroar
|
||||||
PARSE_COCO_BIN = parse-coco-bin
|
PARSE_COCO_BIN = parse-coco-bin
|
||||||
|
|
||||||
|
.DEFAULT_GOAL := all
|
||||||
|
.DELETE_ON_ERROR:
|
||||||
|
.PHONY: all build disk clean
|
||||||
all: $(DSK)
|
all: $(DSK)
|
||||||
|
build: all
|
||||||
|
disk: $(DSK)
|
||||||
|
|
||||||
$(BIN): $(OBJ) $(DECBFILE_LIB_DIR)/lib$(DECBFILE_LIB).a \
|
$(BIN): $(OBJ) $(LIB_INPUTS)
|
||||||
$(BCONTROL_LIB_DIR)/lib$(BCONTROL_LIB).a \
|
|
||||||
$(BSOUND_LIB_DIR)/lib$(BSOUND_LIB).a
|
|
||||||
$(CMOC) -o $(BIN) $(LDFLAGS) $(OBJ) $(LIBS)
|
$(CMOC) -o $(BIN) $(LDFLAGS) $(OBJ) $(LIBS)
|
||||||
|
|
||||||
.PHONY: dict
|
.PHONY: dict
|
||||||
dict: $(WORD_LENGTH_FILENAME)
|
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)
|
$(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 $(DATA_FILENAME)
|
||||||
test -f $(WORD_LENGTH_FILENAME)
|
test -f $(WORD_LENGTH_FILENAME)
|
||||||
@@ -190,10 +202,15 @@ binaries: $(DSK)
|
|||||||
#
|
#
|
||||||
.PHONY: recurse
|
.PHONY: recurse
|
||||||
recurse:
|
recurse:
|
||||||
|
ifeq ($(strip $(LIB_DIRS)),)
|
||||||
|
@echo "Using the prebuilt VCC Plus libraries."
|
||||||
|
else
|
||||||
$(MAKE) -C $(DECBFILE_LIB_DIR) $(RECURSION)
|
$(MAKE) -C $(DECBFILE_LIB_DIR) $(RECURSION)
|
||||||
$(MAKE) -C $(BCONTROL_LIB_DIR) $(RECURSION)
|
$(MAKE) -C $(BCONTROL_LIB_DIR) $(RECURSION)
|
||||||
$(MAKE) -C $(BSOUND_LIB_DIR) $(RECURSION)
|
$(MAKE) -C $(BSOUND_LIB_DIR) $(RECURSION)
|
||||||
|
|
||||||
|
endif
|
||||||
|
|
||||||
# Automatic prerequisite generation.
|
# Automatic prerequisite generation.
|
||||||
%.d: %.c
|
%.d: %.c
|
||||||
$(CMOC) --deps-only $(CFLAGS) $<
|
$(CMOC) --deps-only $(CFLAGS) $<
|
||||||
|
|||||||
+205
@@ -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)
|
||||||
@@ -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.
|
|
||||||
|
|
||||||
Home page: <http://sarrazip.com/dev/FIXME.html>
|
## Download and run
|
||||||
|
|
||||||
Insert the floppy disk that contains this game in drive 0,
|
Download [CoCoLetters.DSK](CoCoLetters.DSK). Mount a writable copy in drive 0 of a
|
||||||
then type DOS and press the Enter key.
|
**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.
|
1. Open this repository’s root folder in **Develop → C Development → Open**.
|
||||||
* RGB monitor.
|
2. Select **Release**, then choose **Build Disk**.
|
||||||
* Floppy disk controller.
|
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)
|
- Author: [Pierre Sarrazin](http://sarrazip.com/).
|
||||||
* bcontrol (>= 0.1.6) (keyboard and joystick support)
|
- [Project page](http://sarrazip.com/dev/coco-letters.html).
|
||||||
* bsound (>= 0.1.4) (sound)
|
- [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
|
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
|
||||||
0.1.0 20??-FIXME First public release.
|
public-domain notices. See [COPYING](COPYING) and the original source notices.
|
||||||
@@ -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.
|
||||||
@@ -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.
|
||||||
@@ -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 |
@@ -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"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
Reference in new issue
Block a user