ECCGMS 1.33 (Enhanced CCGMS) - P2i Lab, 2026
=============================================

A terminal program for the Commodore 64: with it, your C64 calls BBSes
over the Internet. ECCGMS is CCGMS Future 0.2 (Craig Smith, alwyz,
Michael Steil) with a new, easy interface and new features by P2i Lab:
a list of BBSes at startup, the modem found by itself, a menu of six big
tiles, settings with help that save themselves, a voice that reads
English or French aloud, and more with the P2i Lab BBS (bbs.p2i-lab.com,
port 6400).

Web page, and the user guide to read online:
https://p2i-lab.com/c64/

New in 1.33: the MiSTer's modem (the voices, VOICE1 and VOICE1FR, do
not change: those of 1.31 are right).
- The MiSTer's modem (UP9600, MidiLink) is found by itself: ECCGMS said
  "No modem answered" at every start, while a call set by hand worked
  (the first key sent to the modem came out wrong).
- On a MiSTer, turn its parallel cable off: in the C64 core's menu
  (F12), Drives, Parallel Cable: Off. On Auto, it takes the user port
  (the modem) each time the disk works: slow downloads, a broken screen
  after one. ECCGMS 1.33 waits for the port where it matters most.
- ECCGMS hangs MidiLink up when you quit or press C= STOP (it stayed in
  the call).
- With the P2i Lab BBS: after a download, ECCGMS tells the BBS when it is
  ready (the BBS's next screen came while the disk was still busy).
- F1, R no longer offers a .sid file (a tune, not a program).
- The user guide: the MiSTer's settings, DolphinDOS and SpeedDOS (ECCGMS
  can't work with them: their KERNAL has no RS232 routines), MidiLink's
  echo and its loud dial sound (ATM0).

In 1.32: a check of the whole program for hidden freezes (the
voices and VOICE1, VOICE1FR do not change: those of 1.31 are right).
- After the voice was loaded, the C64 could freeze for good with 80
  columns, F8, or a modem on the user port: the voice's file had left
  its own interrupt vectors in place. ECCGMS puts its own back.
- F5, then #9: the next commands went to drive 8, not 9 (S0: erased the
  file on the wrong disk). Fixed: they go to the drive chosen.
- No drive, no disk, or a file that is not there: F2, F4 (L and S),
  F6, C= F1, C= F3, the voice, F1 R and the settings at startup could
  freeze the C64 (it waited for the drive forever). ECCGMS now reads
  the drive's status first, and says why it can't (a full or protected
  disk is no longer reported as saved by F4 S).
- A drive switched on less than a second before ECCGMS asks it: ECCGMS
  waits for it to be ready (it froze).
- C= F5 (send the directory) with a modem on the user port: the C64 and
  the drive could wait for each other forever. Fixed.
- C= F1: 12 files at most ("All" on a bigger disk wrote over memory).
- Smaller fixes: the user port modem (an interrupt left on after the
  modem was turned off), UP9600 with no modem (a time limit), the
  cartridge's dictionary (an interrupt from the modem card lost), a
  settings file too long (another CCGMS's: it went over the program),
  the start after a program (SYS 64738) with the cartridge.
- The help lists F2; the voice says which file is missing (VOICE1 or
  VOICE1FR); the MiSTer's menu is named as it is (Uart Connection).
- The cartridge reads its help texts from the cartridge itself: room
  for these fixes.

In 1.31: a fix for the voices (VOICE1 and VOICE1FR, on the disk
and in the cartridge). Between two parts of a sentence, the voice
waits for one of the C64's timers. The first model of the C64's CIA
chip (the 6526 of the first C64s, and VICE's by default) sometimes
loses that timer's signal, about once in nine pauses: the voice then
waited forever, the C64 froze, and STOP did nothing. It now waits in a
way that cannot fail, and STOP also works during the pauses. Take the
new VOICE1 and VOICE1FR (or the new disk): the voices of 1.2 to 1.3
still work with 1.31, but can freeze. And RESTORE during the voice
with a UP9600 modem no longer drops ECCGMS to BASIC.

In 1.3: a French voice (the file VOICE1FR, 58 blocks: on the disk
and in the cartridge). F7, Language: English or French; the P2i Lab
BBS sets it to the language you chose there, and whispers to the French
voice the words it would get wrong (the C64 has no accents: the BBS
tells it how they sound). The cartridge is now 256 KB (the French voice
inside). With a REU, a modem set at $DF00 (where the REU is too: they
can't share it, e.g. in VICE) is no longer asked: ECCGMS says why and
looks for the modem. And ECCGMS started with no disk in a 1541, the
disk put in later: the settings, the voice and the downloads load and
save again (the 1541 kept answering "74, drive not ready"). The VOICE1
of 1.2 to 1.24 works with 1.3.

In 1.24: five fixes, found by a review of the code. Receiving
several files (C= F3) no longer deletes a file: after a "Replace it?
Y" earlier, it scratched that old name for each file it received; and
its first file no longer fails with an empty "Drive 8:". With an
UP9600 (the MiSTer's), RESTORE while the voice speaks no longer drops
ECCGMS to BASIC. A malformed word whispered by a BBS can no longer
hang the voice. And the help now says it right: F5, then #9, to use
drive 9 (a file name can no longer start with #). The VOICE1 of 1.2
to 1.23 works with 1.24.

In 1.23: when the modem set before does not answer at startup,
ECCGMS first hangs up, in case a call is still on (a WiFi modem that
does not watch DTR stays online when the C64 is switched off and on),
then asks the modem again. In VICE, when TCPSerial does not take VICE's
connection, ECCGMS no longer freezes on "Hanging up": it says "No modem
answered" within half a minute. While the P2i Lab BBS sends a program, a
line under the counters shows its blocks on your disk so far, out of how
many ("On the disk: 4 of 12 blocks"). And in PETSCII Commander 64's
cartridge, a SID tune program from the BBS now goes back to PETSCII
Commander 64 when you stop it, and the BBS can send you the real .sid file
for its SID player. The VOICE1 of 1.2 to 1.22 works with 1.23.

In 1.22: four fixes. The cartridge often stayed on a black screen
when switched on, in VICE most of all: it asked the disk drive for its
settings while the drive was still starting, and then both waited for
each other forever. It now waits for the drive (3 seconds at most).
After a beep, a faint note no longer goes on. Once the voice is loaded,
only "The voice is ready." stays on the screen. And in the terminal (T
on the list), what you type now shows with every modem: ECCGMS turns the
modem's echo on, or says that no modem answered. The VOICE1 of 1.2 and
1.21 works with 1.22.

In 1.21: ECCGMS on a cartridge, eccgms.crt (in the zip
ECCGMS-1.33-cartridge.zip, below): ready about 3 seconds after you
switch on, with a voice that knows nearly 8,000 more words. And a fix: in
the buffer (F4), pressing > when it was full let it go past its end:
what came next could overwrite the voice, then crash the C64 (an old bug
of CCGMS). On the disk, nothing else changes: the VOICE1 of 1.2 works
with 1.21.

In 1.2: with the P2i Lab BBS, the voice says nearly every word
right. The BBS knows exactly what the voice would say, and for the words
it would get wrong, it sends their right sounds, hidden, just after the
text. On other BBSes, the voice reads as before. ECCGMS and VOICE1 go
together: take both (the VOICE1 of 1.1 does not work with 1.2).

In 1.1: the keys on a PC keyboard (VICE, MiSTer) in the help (F1,
then ?); the Speaks setting (F7): the P2i Lab BBS's answers read aloud at
once, or only when you press C= V; in the P2i Lab BBS's News and
Encyclopedia, C= V reads just the article. On a PC keyboard, C= is Tab
and RUN/STOP is Esc: C= V is Tab + V. To stop the voice, hold STOP (Esc)
down. And one voice instead of two: 1.0's clear voice (VOICE2, with a
REU) paused in the middle of sentences, so it is gone for now; if you
used it, ECCGMS 1.1 turns on its voice (VOICE1) instead, by itself.
STOP skips the voice's loading at startup, and the messages shown while
ECCGMS works (loading, saving...) are in light red. And the voice reads
better: hours (5 p.m., 7:15), numbers (1,250, -3, 13th, the 1980s),
abbreviations (Mr., Dr., e.g., U.S.), acronyms (FBI, US) and more common
words, and speaks a little slower.

In the zip ECCGMS-1.33.zip
--------------------------

  eccgms.d64     the disk: all you need. ECCGMS, its voices (VOICE1,
                 English; VOICE1FR, French) and LICENSE, for VICE, a
                 MiSTer, an Ultimate or an SD2IEC; or write it to a real
                 floppy from a PC (with a cable such as a ZoomFloppy).
  ECCGMS.PRG     the same three programs, as separate files: only if
  VOICE1.PRG     you don't use the disk. Then copy them onto the same
  VOICE1FR.PRG   disk or SD card. On the C64 they must be named ECCGMS,
                 VOICE1 and VOICE1FR (on a PC, ".PRG" only says that
                 they are programs). To check on the C64: LOAD"$",8
                 then LIST.
  MANUAL.md      the user guide (a text file: open it with Notepad or any
                 text editor, or read it on the web page)
  LICENSE.txt    the licenses (BSD 3-Clause; CMUdict's)

Start: put the disk in drive 8 and turn your modem on (MANUAL.md,
section 2, or the web page), then type LOAD"ECCGMS",8,1 and RUN.
"UNPACKING..." shows for a few seconds: ECCGMS is packed, so that it
loads faster. The voice is optional, and off at first: F1, then V, turns
it on.

In the zip ECCGMS-1.33-cartridge.zip
------------------------------------

  eccgms.crt       ECCGMS on a cartridge (256 KB, "Magic Desk"), for
                   VICE, a MiSTer, an Ultimate or a Kung Fu Flash: ready
                   in about 3 seconds, with its voices (English and
                   French); the English one knows nearly 8,000 more
                   words.
  eccgms-data.d64  a blank disk: mount it as drive 8, ECCGMS keeps its
                   settings and your downloads on it.
  MANUAL.md, LICENSE.txt, README.txt: as above. How to set up each
                   machine: MANUAL.md, section 2, "The cartridge" (the
                   modem must not be at $DE00: VICE, ACIA at $DF00
                   and VICE's REU off; Ultimate, ACIA at DF80).

Start: put eccgms-data.d64 in drive 8 and turn your modem on, then plug
in the cartridge and switch on (in VICE, attaching it restarts the C64):
there is nothing to type. Hold C= while switching on to start without
it.

In the zip ECCGMS-1.33-source.zip (for programmers only)
-------------------------------------------------------

You don't need it to use ECCGMS. The source code: ccgmsterm/ (CCGMS
Future and the ECCGMS changes, 6502 assembly for ca65), voix/ (the voices:
6502 code and their exact models in Python, the cartridge's big
dictionary and the French voice's rules; also the engine of 1.0's
clear voice, kept for later), pack/
(the packer), cart/ (the cartridge's start and its .crt file),
fabriquer.sh (the build script).

To build (Linux, or WSL on Windows): install cc65 (for example
"sudo apt install cc65") and Python 3, then

    bash fabriquer.sh

It writes build/eccgms.d64 (and build/eccgms.prg, not packed) and
build/eccgms.crt (the cartridge). If cc65 is not in the PATH, start it
like this:

    CC65_BIN=/path/to/cc65/bin bash fabriquer.sh

Credits
-------

- ECCGMS 1.33, P2i Lab, 2026: the new interface, the voices, the P2i Lab
  BBS features, the cartridge.
- CCGMS Future 0.2 (c) 2016-2022 Craig Smith, alwyz, Michael Steil
  (https://github.com/mist64/ccgmsterm), after CCGMS by Craig Smith
  (1985-1988).
- CMUdict (c) 1993-2015 Carnegie Mellon University: the voice's English
  rules were learned from it, and the cartridge's big dictionary comes
  from it.

Open source, BSD 3-Clause License: see LICENSE.txt.
