ECCGMS 1.33 — User Guide
ECCGMS (Enhanced CCGMS) is a terminal program for the Commodore 64: it lets your C64 call BBSes over the Internet. (A BBS is a server you call to chat, read and write messages, play and download programs, as in the 80s.) 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: choose one with the cursor keys (or a joystick in port 2), press RETURN, and you are connected;
- your modem is found by itself at the first start, and every setting is saved by itself on the disk;
- a menu of 6 big tiles (F1): every action is at most two choices away, and each one also has a letter; settings with help (F7);
- a voice, if you want it (off at first), that reads English or French aloud: robot-like, in the style of SAM, on any C64 (no memory expansion needed); with the P2i Lab BBS, it takes the BBS's language by itself;
- with the P2i Lab BBS (bbs.p2i-lab.com, port 6400): games saved on your disk by themselves and run from the menu, Claude's answers read aloud;
- disk errors explained in plain English (no disk, disk full, write-protected...).
New in 1.33: the MiSTer's modem (the voices do not change: the VOICE1 and VOICE1FR of 1.31 are right).
- The MiSTer's modem is found by itself. With UP9600 (the MiSTer's modem, MidiLink), ECCGMS said "No modem answered" at every start, while a call set by hand worked: the first key it sent to the modem came out wrong, and MidiLink only answers a line that starts with
AT. - On a MiSTer, turn its parallel cable off: in the C64 core's menu (F12), Drives: Parallel Cable: Off. On Auto, its setting at first, 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 at the moments that matter most, and the "No modem answered" screen says it (section 2, MiSTer FPGA).
- ECCGMS hangs MidiLink up: when you quit or press C= STOP, the MiSTer's modem stayed in the call (it only hangs up on
+++followed at once byATH). - With the P2i Lab BBS: after a download it sent, ECCGMS tells the BBS when it is ready, so the BBS's next screen no longer arrives while the disk is still busy (its clear screen was lost).
- F1, R (run) no longer offers a
.sidfile: it is a tune for a SID player, not a program. - This guide: the MiSTer's settings (System ROM, Parallel Cable), why ECCGMS can't work with DolphinDOS or SpeedDOS (their KERNAL has no RS232 routines), MidiLink's echo and its loud dial sound (
ATM0), and six new lines in If something goes wrong.
In 1.32: a check of the whole program for hidden freezes (the voices do not change: the VOICE1 and VOICE1FR 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). They now 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.
- C= F1: 12 files at most ("All" on a bigger disk wrote over memory).
- Smaller fixes: the user port modem, 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), the cartridge's start after a program (SYS 64738).
- 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).
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: passe for passé). 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": section 10). 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 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, the light red "Loading the voice" goes away: only "The voice is ready." stays. 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: it is ready about 3 seconds after you switch on, and its voice knows nearly 8,000 more words (section 2, The cartridge). 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 (square, weather, machine...), it sends their right sounds, hidden, just after the text: the voice says them as the dictionary does (section 8). On other BBSes, it reads as before. ECCGMS 1.2 and its voice go together: take both (the disk eccgms.d64, or on the P2i Lab BBS: X, then 6 and 7).
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; and in the P2i Lab BBS's News and Encyclopedia, C= V reads just the article. And one voice instead of two: the clear voice of 1.0 (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; VOICE2 can be deleted from your disk. Also: 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; it is clearer (stronger consonants, the h whispered, the rhythm of English) and speaks a little slower, with a real pause after each sentence (section 8).
ECCGMS is free and open source (BSD license, see LICENSE.txt). Its screens are in English. Its web page: https://p2i-lab.com/c64/
Quick start
- Get eccgms.d64: it is the only file you need. It is a copy of a C64 floppy disk, in a file (a "disk image"), with ECCGMS and its voice on it: there is nothing else to download.
- Prepare your machine: the modem on, and the disk in drive 8 (section 2).
- On the C64, type
LOAD"ECCGMS",8,1and RETURN, thenRUNand RETURN. - The first time, ECCGMS looks for your modem: when it has found it, press RETURN.
- The P2i Lab BBS is first in the list: press RETURN to call it. On its first screen, press 3 (Commodore 64, English) or 1 (French), then type
newto create your account (section 9).
The voice is optional, and off at first: F1, then V, turns it on (section 8).
Or the cartridge: eccgms.crt (in ECCGMS-1.33-cartridge.zip), for VICE, a MiSTer, an Ultimate or a Kung Fu Flash: switch on, and ECCGMS is ready in about 3 seconds, with a voice that knows many more words (section 2, The cartridge).
1. What you need
- A Commodore 64: a real one, a MiSTer FPGA, an Ultimate 64 or C64 Ultimate, a C64 with an Ultimate II+ cartridge, or the VICE emulator on a PC. PAL or NTSC (European or American C64).
- A modem to the Internet: a WiFi modem plugged into a real C64, the modem built into a MiSTer or an Ultimate, or a small helper program for VICE. (It must understand the command
ATDT host:port; nearly all do.) ECCGMS knows these kinds:- a WiFi modem on the user port (2400 baud; 9600 with UP9600);
- a SwiftLink or Turbo232 cartridge (a serial cartridge for modems) at
$DE00(up to 38400 baud); - the modem built into the Ultimate cartridges and boards (they imitate a SwiftLink at
$DE00); - the TeensyROM cartridge's modem (a SwiftLink at
$DE00too, once its Special IO says so: section 2); - the MiSTer's internal modem (UP9600);
- in VICE: a SwiftLink and a small modem program (section 2).
- The ECCGMS disk in a disk drive (real or emulated): the drive ECCGMS was loaded from (usually 8). Leave it there: ECCGMS saves its settings and your downloads on it, and loads the voice from it, so it must not be write-protected.
- Or the cartridge,
eccgms.crt(VICE, MiSTer, Ultimate, Kung Fu Flash), with a blank disk in drive 8 for the settings and your downloads (section 2, The cartridge). - No memory expansion is needed. If there is a REU (RAM Expansion Unit), ECCGMS keeps its buffer in it (F4: 64 KB instead of 5.5 to 9.5 KB).
The disk eccgms.d64 holds four files:
| File | What it is | Size |
|---|---|---|
ECCGMS | the program | 95 blocks |
VOICE1 | the voice, in English | 52 blocks |
VOICE1FR | the voice, in French | 58 blocks |
LICENSE | the licenses, a text file (to read it in ECCGMS: F2, R, LICENSE) | 30 blocks |
You never load VOICE1 or VOICE1FR yourself: ECCGMS loads the one of its language (F7, Language) when you turn the voice on. ECCGMS is packed, so that it loads faster from a disk: it unpacks itself in a few seconds after loading.
2. Prepare your machine
Two things: the modem, and the disk in drive 8. A .d64 file is a copy of a whole C64 floppy disk: your machine uses it like a real disk in drive 8.
MiSTer FPGA (C64 core)
- Copy
eccgms.d64to the MiSTer's SD card, for example intogames/C64. The MiSTer must be connected to your network. - Start the C64 core. In its menu (F12), Hardware: Expansion: RS232, RS232 Connection: Internal, RS232 mode: UP9600, and the System ROM: the standard one (or JiffyDOS), not DolphinDOS or SpeedDOS (see below).
- Still in its menu, Drives: Parallel Cable: Off (on an older core: Parallel port: Disabled, in Drives or Hardware; see below).
- In the MiSTer's own menu (Win+F12): Uart Connection: Modem, Link: TCP, Baud: 9600. Save.
- In the core's menu, mount
eccgms.d64in drive 8: the MiSTer writes ECCGMS's settings and your downloads into this file.
ECCGMS then finds "UP9600 (user port)" at 9600 baud by itself. The MiSTer's guide: Computer Core Networking (section 11).
Why the parallel cable must be off. The core can give the user port to a parallel cable between the C64 and the disk drive, for the fast loaders DolphinDOS and SpeedDOS. On Auto (or Enabled), its setting at first, it does so every time the disk works, and for half a second after; and every time the modem is used during that half second, it waits half a second more. Meanwhile, whatever goes between ECCGMS and the modem is lost: a download is slow (each block written on the disk cuts the modem off), the BBS's next screen after a download can come out broken, and an AT right after the disk was used gets no answer. ECCGMS 1.33 waits for the port to come back at the few places where it matters most (the first AT at startup, the "ready" after a download), but only Off fixes the rest. Nothing is lost: the cable is only for DolphinDOS and SpeedDOS.
DolphinDOS and SpeedDOS replace the C64's KERNAL (System ROM) with their own, which has no RS232 routines and changes others that ECCGMS uses (finding the drive, the keyboard, saving the buffer...): ECCGMS can't work with them, and neither can most terminal programs (the core's own guide says so). Keep the standard ROM, or JiffyDOS (it works with ECCGMS).
MidiLink, the MiSTer's modem, is simpler than a real one:
- it repeats every key you type (its echo can't be turned off): in the terminal (T), set F7, Echo to off, or each key shows twice;
- its dial and connect sounds come from the MiSTer's Linux at full volume, much louder than the C64: type
ATM0in the terminal before you call (no sound;ATM1: back on;ATM20%: softer), or, on the SD card, inlinux/MidiLink.INI, setTCP_SOUND = FALSE(orMODEM_VOLUME = 20). If the sound gets quieter with the MiSTer's volume at its maximum, keep it one step lower (Harry, 03/11: the C64 very quiet, the modem's sound very loud); - it hangs up only on
+++followed at once byATH, and does not watch the C64: quitting ECCGMS, or a RESET, leaves the call on. ECCGMS 1.33 hangs it up properly when you quit or press C= STOP (with 1.32 and older: log off the BBS with its own command, Q on the P2i Lab BBS in English (D in French), before quitting; or, in Win+F12, set Uart Connection to None, then back to Modem).
Ultimate 64, C64 Ultimate, Ultimate II+
- Connect the Ultimate to your network.
- In its menu (firmware 3.7 or later), turn on the modem: ACIA / SwiftLink (the modem cartridge it imitates), at address
$DE00(where the C64 looks for it). - Copy
eccgms.d64to the Ultimate's USB stick or SD card. In its menu, choose the file, then Mount Disk (drive 8).
ECCGMS then finds "SwiftLink/Ultimate (DE00)" at 38400 baud by itself. The Ultimate's guide: Modem support (section 11).
TeensyROM
The TeensyROM cartridge imitates a SwiftLink and its modem only when its Special IO is set to it (the CCGMS of its own menu has it set already; a program you bring does not):
- In the TeensyROM's menu, open its Settings and press B until Special IO says Swiftlink. It keeps this setting.
- Start ECCGMS: from the TeensyROM's menu (its SD card), or from your disk drive.
ECCGMS then finds "SwiftLink/Ultimate (DE00)" at 38400 baud by itself. Use the disk version: the cartridge (eccgms.crt) needs $DE00 itself.
VICE (emulator)
- Install VICE (free) and Java 21 or later (section 11).
- VICE imitates a SwiftLink, but not the modem plugged into it: a small free program on your computer plays the modem. On Windows, get TCPSerial, unzip it and double-click
TCPSerial.bat; its settings are fine as they are. Leave its window open while you use ECCGMS.- If Windows stops
TCPSerial.bat(a blue "Windows protected your PC" window), double-clickTCPSerial.jarinstead: it then runs with no window, until you turn the computer off (to stop it sooner: Task Manager, "OpenJDK Platform binary", End task). - If Windows' firewall asks about Java, Cancel is enough: VICE is on the same computer.
- Linux or macOS:
java -jar TCPSerial.jar, in its folder.
- If Windows stops
- In VICE (x64sc), open the settings, page RS232 (the menus change a little from one VICE version to another):
- ACIA: on, base
$DE00, interrupt NMI, mode SwiftLink, on device 3 (Serial 3); - device 3:
127.0.0.1:25232, 38400 baud, IP232 off (unchecked: TCPSerial passes the bytes as they are; with IP232 on, VICE spoils the files you download); - the user port RS232: off.
- ACIA: on, base
Then Preferences menu, Save settings: VICE does not keep its settings by itself when it closes.
- Drag
eccgms.d64onto VICE's window: VICE puts it in drive 8 and starts ECCGMS. (Or: File menu, Attach disk image, drive 8; true drive emulation on or off, both work.)
ECCGMS finds "SwiftLink/Ultimate (DE00)" at 38400 baud by itself.
A real C64 with a WiFi modem
- Turn the C64 off. Plug the WiFi modem into the user port (or a SwiftLink cartridge and its modem into the cartridge port), then turn the C64 on.
- The modem must be connected to your WiFi: follow its own manual. To type its commands, start ECCGMS and press T on its list of BBSes. Type
AT, then RETURN: it should answerOK. (ECCGMS turns the modem's echo on there, so that what you type shows; if it says No modem answered, see section 10.) - The disk: with an SD2IEC (an SD card drive for the C64), copy
eccgms.d64to its SD card and open it, with a file browser or withOPEN1,8,15,"CD:ECCGMS.D64":CLOSE1. With a real 1541, write the image to a floppy from a PC first (for example with OpenCBM and a ZoomFloppy cable). Don't write-protect it. No PC, or no cable? If your C64 already has a terminal program (CCGMS or another), call the P2i Lab BBS with it (bbs.p2i-lab.com, port 6400) and press X on its main menu: in its ECCGMS section, download ECCGMS, VOICE1, VOICE1FR and LICENSE straight onto a floppy (section 9). - If calling gives
ERROR(some modems do, for example those with the Zimodem firmware), chooseATD"host:port"in the settings (F7, Dialing).
ECCGMS finds the modem by itself.
The cartridge (eccgms.crt)
ECCGMS also comes as a cartridge file: eccgms.crt, in the zip ECCGMS-1.33-cartridge.zip with a blank disk, eccgms-data.d64. Switch on, and ECCGMS is ready in about 3 seconds, its voices too (English and French): nothing to load from a disk. And its English voice knows nearly 8,000 more words (its big dictionary): about 1 word in 200 said wrong, instead of 1 in 10, on every BBS. It is a 256 KB "Magic Desk" cartridge (VICE, the MiSTer and the Kung Fu Flash read them up to 1 MB, the Ultimate up to 512 KB).
- The disk in drive 8: ECCGMS keeps its settings and your downloads on it. Mount
eccgms-data.d64(it is blank) as drive 8, or use any disk that is not write-protected (a real floppy, an SD2IEC...). With no disk, ECCGMS works, but saves nothing. - The modem: the cartridge listens at
$DE00, the usual address of a SwiftLink, so the modem must be somewhere else:- a WiFi modem on the user port, or UP9600 (the MiSTer's internal modem: as above);
- in VICE: the ACIA (step 3 of VICE, above) at base
$DF00instead of$DE00, and VICE's REU off (its registers are at$DF00too: ECCGMS then leaves$DF00alone, and finds no modem); then Preferences, Save settings; - on an Ultimate: in its menu, ACIA (6551) Mapping:
DF80/NMI(ECCGMS calls it "Ultimate (DF80)").
- The cartridge, last: it starts the C64 with ECCGMS.
- VICE: File menu, Attach cartridge image, then
eccgms.crt(or drag it onto VICE's window): VICE restarts the C64 with it; - MiSTer (C64 core): in its menu (F12), load
eccgms.crtas a cartridge. To start with it every time: Hardware, Boot Cartridge; - Ultimate (Ultimate 64, C64 Ultimate, Ultimate II+): choose
eccgms.crtin its menu, then Run Cart; - Kung Fu Flash (an SD card cartridge for a real C64): choose
eccgms.crtin its menu.
- VICE: File menu, Attach cartridge image, then
ECCGMS finds the modem by itself. Hold C= while switching on to start the C64 without ECCGMS (BASIC). On a Kung Fu Flash, its menu button brings back its menu, where you choose eccgms.crt again (there, RESET does not start the cartridge again). The cartridge is ECCGMS 1.33 itself: apart from starting it (no LOAD to type) and its voice (in the cartridge: it loads in under a second), everything in this guide applies to it.
3. Starting ECCGMS
When your machine is ready and the disk is in drive 8, type this on the C64's blue screen, with RETURN at the end of each line (on a C64 keyboard, " is SHIFT + 2):
LOAD"ECCGMS",8,1
RUN
(or LOAD"*",8,1 then RUN: ECCGMS is the first file. In VICE, if you dragged the disk onto the window, ECCGMS has already started.) UNPACKING... is shown for about 4 seconds, then ECCGMS starts.
With the cartridge, there is nothing to type: switch the C64 on (in VICE, attaching the cartridge restarts it), and ECCGMS is there about 3 seconds later.
The first time, ECCGMS looks for your modem: it tries each kind (SwiftLink at $DE00, the user port, SwiftLink at $DF00, UP9600), at the usual speeds, asking AT until the modem answers OK. (A SwiftLink at $D700 is not looked for: choose it in the settings. The cartridge does not look at $DE00, its own address, and also tries the Ultimate's modem at $DF80.) It keeps the one that answers and saves it on the disk. Press RETURN to see the list of BBSes. If no modem answers, ECCGMS says so: see section 10. The next times, it asks the same modem AT again. If it does not answer, ECCGMS first hangs up (Hanging up (if a call is still on)...: a modem left in a call sends AT to the BBS instead of answering it, as TCPSerial does after a RESET in VICE), asks again, and only then looks for another one (you changed your setup).
At the top of the start screen: the modem and its speed, the voice, the disk drive. Below: the list of BBSes.
4. The list of BBSes (the start screen)
| Key | What it does |
|---|---|
| Cursor keys, joystick (port 2), or 1-9 | choose a BBS (the list scrolls; 30 BBSes at most) |
| RETURN, SPACE, the fire button | call the BBS chosen |
| E | edit it: name, address (host or host:port), port, your user name and password there |
| N | add a new BBS |
| DEL | delete the BBS chosen (Y/N) |
| A | call an address you type (host:port) |
| T | the terminal, without calling (to type the modem's commands: ECCGMS turns the modem's echo on, so that what you type shows) |
| F1 | the menu |
| F7 | the settings |
| ? | help: the keys, the same on a PC keyboard, then the credits |
The BBS you called last is chosen at the next start. While calling, ECCGMS shows what the modem says, in plain words: busy (it tries again every 3 seconds), no answer, error. STOP stops calling. Calling while already connected hangs up first.
Once connected, CTRL F5 sends the user name and CTRL F7 the password that you typed for this BBS in its edit form (E).
5. In the terminal
Once connected, what you type goes to the BBS and what it sends is shown: in PETSCII (the C64's own characters and graphics), or, with F8, in ASCII for PC BBSes (their ANSI colors are shown).
The keys: C= is the Commodore key (bottom left, with the Commodore logo); STOP is the RUN/STOP key; on a C64 keyboard, F2, F4, F6 and F8 are SHIFT + F1, F3, F5 and F7.
On a PC keyboard (VICE, MiSTer), the C64's keys are:
| C64 key | VICE | MiSTer |
|---|---|---|
| RUN/STOP | Esc | Esc |
| C= (Commodore) | Tab | Tab or Alt |
| CTRL | Ctrl | Ctrl |
| CLR/HOME | Home | Home |
| INST/DEL | Backspace | Backspace |
| RESTORE | Page Up | F11 |
| F2, F4, F6, F8 | F2, F4, F6, F8 (no SHIFT) | the same |
So C= STOP (hang up) is Tab + Esc, and C= V (read aloud) is Tab + V: hold Tab down, then press the other key. In VICE set to the positional keyboard (Settings, Input devices, Keyboard), C= is Ctrl and CTRL is Tab. ECCGMS shows these keys too: F1, then ?, then RETURN.
| Key | What it does |
|---|---|
| F1 | the menu (all of ECCGMS); F1 again or STOP: back to the BBS, its screen as it was |
| F2 | read a text file on the screen (R, then its name), or send it to the BBS (S) |
| F3 | download a file |
| F4 | the buffer: a copy of what the BBS sends |
| F5 | a command for the disk drive |
| F6 | the files on the disk |
| F7 | the settings |
| F8 | change the text mode: PETSCII (C64 BBSes), ASCII (PC BBSes), 80 columns |
| C= STOP | hang up |
| C= V | read the last text aloud (with the voice on) |
| CTRL F1, CTRL F3 | send macro 1, 2 |
| CTRL F5 | send your user name for this BBS (from the list) |
| CTRL F7 | send your password for this BBS (from the list) |
| C= F1 / C= F3 | send / receive several files (Multi-Punter) |
| C= F5 | send the disk's directory |
| C= F7 | the screen into the buffer |
| C= CTRL 1-4 / SHIFT CTRL 1-4 | keep a copy of the screen (1-4) / bring it back (not with the voice on, which uses that memory) |
To use drive 9: F5 (disk command), then #9 and RETURN; it stays so until you change it again. (A file name cannot start with #.)
When the BBS hangs up, the modem says NO CARRIER: the call is over. You stay in the terminal: F1, then C, for the list of BBSes.
6. The menu (F1)
Six tiles: Call, Files, Voice, Screen, Settings, Help. Choose one with the cursor keys or the joystick (port 2), then RETURN or the fire button: the tile's actions. There, choose an action the same way. STOP: back one page. F1: the menu closes (back to the BBS as it was, or to the list).
Each action also has a letter, shown on its tile: press it, on the page of the six tiles or inside a tile, and it is done at once. And the F keys do what they do in the terminal.
| Tile | Letter: action |
|---|---|
| Call | C the list of BBSes · H hang up |
| Files | D download (F3) · U upload · R run a program downloaded · F files on the disk (F6) · K disk command (F5) |
| Voice | V the voice: on, off · A read the last text again (C= V) |
| Screen | B the buffer (F4) · T PETSCII, ASCII, 80 columns (F8) |
| Settings | S settings (F7) · M macros |
| Help | ? the keys (also on a PC keyboard), the credits · Q quit to BASIC |
The Voice tile shows the voice now: off, on, not ready (not loaded: V loads it again), skipped (STOP at startup: V loads it), 80 cols.
R: run a program downloaded. ECCGMS offers the last program you downloaded (you can type another name). RETURN: ECCGMS shows what it will type and asks Go ahead? (Y/N). Y: it hangs up, puts the C64 back as at power-on and types LOAD"NAME",8,1 for you, on the BASIC screen, so that you see how it is done, then RUN if the program is a BASIC one (loaded at $0801); other programs are only loaded, and ECCGMS reminds you to start them as their notes say (often with SYS). RETURN with no name: ECCGMS just hangs up and quits. Q in the menu quits to BASIC.
7. The settings (F7)
One setting per line; below, what the line chosen means. Cursor keys (or joystick) to choose, RETURN to change it, STOP to leave.
| Setting | Values |
|---|---|
| Modem | User port (WiFi modem), UP9600, SwiftLink/Ultimate (DE00), SwiftLink (DF00) (not with a REU: it is at $DF00 too), SwiftLink (D700). I: find my modem |
| Speed | 300 to 38400 baud, as the modem allows |
| Protocol | Punter (most C64 BBSes, and the P2i Lab BBS), XMODEM, XMODEM-CRC, XMODEM-1K: the ways for a BBS to send you files |
| Voice | off, on; on, loud with a SID 8580 (section 8) |
| Speaks | at once (P2i Lab BBS): its answers are read aloud as they arrive; only with C= V: when you press C= V (section 8) |
| Language | English, French: the voice's language (VOICE1 or VOICE1FR). The P2i Lab BBS sets it to the language chosen there (section 9). With the voice on, the other voice is loaded at once |
| Echo | off (the BBS sends back what you type), on |
| Dialing | ATDT host:port (most modems), ATD"host:port" (Zimodem) |
The settings save themselves on the disk when you leave (the file eccgms-setup; the first time, the ccgms-phone of a CCGMS on the disk is read, if there is one). If they cannot be saved, ECCGMS says why (no disk, write-protected...).
8. The voice
The voice is optional, and off at first. It is on the ECCGMS disk (VOICE1, and VOICE1FR for French): there is nothing else to get, and it works on any C64 (no REU needed). To turn it on: the menu, F1, then V (or F7, Voice). ECCGMS loads it from the disk (about 30 seconds on a 1541), then again at each start, until you turn it off (F1, then V again). While it loads, the start screen says "Voice loading (30 s on a 1541)..." in light red, and "STOP: skip" below: no need for the voice this time? Press STOP: ECCGMS does not load it (it stays on in the settings, and the start screen says skipped); F1, then V, loads it later. STOP also cancels the loading when you turn the voice on (F1, then V). With the cartridge, ECCGMS takes the voice from the cartridge, in under a second.
It sounds robot-like, in the style of SAM (1982), but made to be easy to understand: strong consonants (the h and the breath after p, t, k are whispered with the shape of the vowel after them, as when we speak), the rhythm of English (a vowel is longer before b, d, g, v, z than before p, t, k: bad, bat), a pause of about half a second after each sentence, a shorter one after a comma, and a long sentence cut before a small word (and, to, of...) when it has to be. It speaks calmly, and starts speaking about 0.4 s after the text.
It reads a text as you would aloud:
| Written | Said |
|---|---|
| 5 p.m., 9 AM, 7:15, 7:05, 17:00 | five P M, nine A M, seven fifteen, seven oh five, seventeen hundred (at 5 p.m. Then...: the dot ends the sentence) |
| 1,250 · 2,500,000 · 3.14 | one thousand two hundred fifty · two million five hundred thousand · three point one four |
| 1st, 2nd, 13th, 21st | first, second, thirteenth, twenty-first |
| 1984, 2026, the 1980s | nineteen eighty-four, twenty twenty-six, the nineteen eighties |
| -3, 10-15, $5, $2 million, 50%, #1 | minus three, ten to fifteen, five dollars, two million dollars, fifty percent, number one |
| Mr., Mrs., Dr., St, vs., etc. | mister, missus, doctor, saint, versus, et cetera (the dot does not end the sentence) |
| U.S., e.g., i.e. | letter by letter, without stopping at each dot |
| FBI, UN, US (in capitals, in a text with small letters) | letter by letter; SID, RAM, ROM, VIC: as words |
| C= V | Commodore V |
English spelling is irregular: the voice knows by heart about 240 common words that its rules would get wrong (key, hour, people...), and says about 9 words in 10 of a text exactly; the others (rare words, names) can sound odd. With the P2i Lab BBS, nearly all of them are right: the BBS knows exactly what the voice would say (it uses the same rules), and after each text it reads aloud, it whispers the right sounds of the words the voice would get wrong, from the Carnegie Mellon University (CMU) Pronouncing Dictionary (125,000 words). You see nothing of it: ECCGMS keeps them with the text, so C= V says them right too. Only names and words that the dictionary does not know can still sound odd.
With the cartridge, on every BBS: its voice also knows 7,990 more words by heart (its big dictionary, from the same CMU dictionary): the most common words that its rules would get wrong. About 1 word in 200 of a text is then said wrong, instead of 1 in 10.
With the voice on, ECCGMS reads texts aloud, in English (or in French: below): the answers of the P2i Lab BBS (Claude's, and your private messages), and, with C= V, the last text received (since the last key you typed). In the P2i Lab BBS's News and Encyclopedia, C= V reads just the article you are reading, page by page: its title and its text, not the menus or the link. To try it: on the P2i Lab BBS, X (the ECCGMS section), then V: type a sentence, and your C64 says it.
Read at once, or when you want? At first, the P2i Lab BBS's answers are read as soon as they arrive. F7, Speaks: only with C= V, and ECCGMS waits for C= V to read them.
In French: F7, Language: French (with the P2i Lab BBS, it is set by itself when you choose French there). ECCGMS then loads VOICE1FR, the French voice (from the disk: about 30 seconds on a 1541; from the cartridge, in under a second). It reads French as a French robot would: numbers (17h30: dix-sept heures trente; 1er, 2e; 2 500 000), the liaisons (les amis: lé-z-amis), the elisions (l'école), the questions (the voice goes up), and words cut at the right places. The C64 has no accents, and the voice reads texts without them: it guesses most words right (ete: été, ecole: école), about 97 words in 100; with the P2i Lab BBS, which knows the accents, it whispers the others (passe for passé, cote for côte): about 99 in 100.
- Hold STOP down (Esc on a PC keyboard) to stop the voice: ECCGMS looks at it between two parts of a sentence, so a quick press may be missed.
- Loud: on a C64C (SID 8580), the C64's sound is very quiet; ECCGMS sees the SID 8580 by itself and turns the voice up.
- With the voice on, a few features have less room (they use the same memory, 12 KB): without a REU, the buffer (F4: a copy of what the BBS sends) holds about 5.5 KB instead of 9.5 KB; and 80 columns and the screen copies (C= CTRL 1-4) can't be used with it. If you switch to 80 columns, the voice says not ready when you are back in 40 columns: F1, then V, loads it again.
- The voice was written by P2i Lab: it contains no code of SAM. Its pronunciation rules were drawn from the Carnegie Mellon University (CMU) Pronouncing Dictionary.
9. With the P2i Lab BBS
The P2i Lab BBS (bbs.p2i-lab.com, port 6400) is first in the list from the start.
Your first call:
- On the list, press RETURN: ECCGMS calls the P2i Lab BBS.
- On the BBS's first screen, press 3 (Commodore 64, English) or 1 (Commodore 64, French). With the voice on, ECCGMS takes the same language (F7, Language): the first time, it loads the other voice (about 30 seconds on a 1541, "Loading the voice"), then the BBS goes on. L on the BBS's main menu changes its language, and the voice's.
- At "Handle", type
new, then choose your handle (your nickname) and a password. The next times, type your handle and your password. - To hang up: C= STOP (hold the Commodore key, press RUN/STOP; on a PC keyboard: Tab + Esc).
ECCGMS tells the BBS which program it is, and then:
- Games to download: choose a game, then "1) for a real C64": ECCGMS receives it by itself (nothing to type), checks the drive, the disk and the free space on it first, and saves it. Under the counters, a line shows its blocks on the disk so far, out of how many: "On the disk: 004 of 12 blocks". Then F1, R runs it.
- SID music: the tune's page says whether it was made for a PAL C64 (Europe) or an NTSC one (America). "1) for a real C64", then ECCGMS asks which file: 1, the program (it plays the tune by itself: a PAL tune plays at the right speed on an NTSC C64 too); 2, the
.sidfile itself, for the SID player of PETSCII Commander 64 (in its cartridge, ECCGMS says so to the BBS, which recommends it). To play it: F1, Q and Y (back to PETSCII Commander 64), M (Music), and RETURN on the tune. - Claude (the AI) and your private messages: with the voice on, ECCGMS reads them aloud; the BBS waits until the voice has finished. (F7, Speaks: only with C= V, to hear them only when you press C= V.) The BBS whispers to the voice how to say the words it would get wrong (section 8): nearly every word is right.
- News and Encyclopedia: C= V reads the article on the screen (its title and text), page by page.
- The ECCGMS section (X on the main menu): a few pages about ECCGMS, and its files to download onto your disk (ECCGMS, VOICE1, VOICE1FR, LICENSE: with ECCGMS, they arrive by themselves, like the games), or
eccgms.d64for a PC. Handy to put ECCGMS and its voice on another disk, or to get a new version later. - Make your C64 talk (X, then V): as with SAM in 1982, type a sentence and RETURN: ECCGMS says it with its voice (in the BBS's language). RETURN alone: back.
10. Troubleshooting
| What you see | What to do |
|---|---|
| "No modem answered." at startup | (ECCGMS has already hung up, in case a call was still on: Hanging up (if a call is still on)....) Check that the modem is plugged in, on, and connected to your WiFi or network (VICE: TCPSerial running), and your machine's settings (section 2; a TeensyROM: Special IO, Swiftlink); then F7, I (find my modem). With the cartridge, the modem must not be at $DE00: VICE, ACIA at $DF00; Ultimate, DF80/NMI (section 2, The cartridge) |
| MiSTer: "No modem answered." at every start, but a call set by hand works | ECCGMS 1.32 and older: with UP9600, the first key sent when looking for the modem came out wrong, and MidiLink (the MiSTer's modem) answered nothing. Fixed in 1.33. With 1.32: press STOP during Asking the modem to skip the search, and keep F7, Modem: UP9600, Speed: 9600 |
MiSTer: downloads very slow, a broken screen after a download, a first AT unanswered | the core's parallel cable takes the user port each time the disk works: in its menu (F12), Drives: Parallel Cable: Off (Parallel port: Disabled on an older core). Section 2, MiSTer FPGA |
| MiSTer: each key shows twice in the terminal | MidiLink always repeats what you type: F7, Echo: off |
| MiSTer: the C64 (music, games, the voice) very quiet, the modem's dial very loud; at the MiSTer's maximum volume, quieter still | the dial sound comes from the MiSTer's Linux (MidiLink) at full volume: ATM0 in the terminal before calling, or TCP_SOUND = FALSE in linux/MidiLink.INI on the SD card; the MiSTer's volume one step below its maximum. Section 2, MiSTer FPGA |
MiSTer: after quitting ECCGMS, the next start finds no modem, or AT goes to the BBS | MidiLink was still in the call (it does not hang up when the C64 quits or resets). ECCGMS 1.33 hangs it up. With 1.32: in Win+F12, Uart Connection: None, then Modem; next time, log off the BBS first (Q on the P2i Lab BBS in English, D in French) |
| ECCGMS freezes or acts strangely from the start, on a C64 with DolphinDOS or SpeedDOS | these KERNALs have no RS232 routines: ECCGMS can't work with them. Use the standard KERNAL or JiffyDOS (MiSTer: F12, Hardware, System ROM) |
| In the terminal (T), what you type does not show | ECCGMS turns the modem's echo on when the terminal opens (ATE1; before 1.22, type ATE1 and RETURN yourself, even unseen). If it says No modem answered, see the first line of this table. On a BBS that does not send back what you type: F7, Echo: on |
| "The modem said ERROR: is the address right?" | check the BBS's address (E on the list); some modems (Zimodem) need F7, Dialing: ATD"host:port" |
| "The modem did not answer (60 s)." | the BBS may be offline: try again later, or check the address |
| The BBS's screen is garbled | press F8 to change the text mode: PETSCII for a C64 BBS, ASCII for a PC BBS. On the P2i Lab BBS, press 3 or 1 (Commodore 64) on its first screen, not 2 or 4 (PC) |
| "Insert a disk" | ECCGMS needs a disk in its drive (usually 8) for its settings and downloads (MiSTer, Ultimate, VICE: mount or attach eccgms.d64; with the cartridge, the blank disk eccgms-data.d64) |
| "The settings could not be saved" | the disk is write-protected, or the .d64 file is read-only or not mounted: make it writable and keep it in drive 8 |
| "The voice is not loaded" (File not found) | VOICE1 (English) or VOICE1FR (French: F7, Language) must be on the disk in the drive. If you copied the programs one by one, copy VOICE1 and VOICE1FR too, onto the same drive as ECCGMS (on the P2i Lab BBS: X, then 7 and 9). Without VOICE1FR, the French voice turns the voice off: F7, Language: English, then Voice: on |
| "This is not the voice of ECCGMS 1.33" | the VOICE1 on your disk is the one of another version of ECCGMS (1.1 or older): take the VOICE1 of 1.33 (the same as 1.31's and 1.32's) (on the P2i Lab BBS: X, then 7; or the disk eccgms.d64) |
| "The REU is at DF00, where the modem was set" | a REU and a SwiftLink can't both be at $DF00. VICE: Settings, Peripheral devices, RS232: ACIA at $DE00 (not with the cartridge: it uses $DE00), then F7, Modem, or I; or turn the REU off. With the cartridge and a REU in VICE, only a modem on the user port can work (UP9600) |
| "74, drive not ready" with a disk in the drive | a 1541 asked for a file with no disk in (started with no disk, the disk put in later) then thinks it has a second drive. Since 1.3, ECCGMS says "0:" (drive 0) before the names of its settings, its voices and every file it saves, which the 1541 needs then. With 1.24 or older, or another program: switch the drive off and on (VICE: reset drive 8), or start with the disk in |
| ECCGMS seems stuck | a message in light red that ends with "..." (Loading the voice, Saving the settings, Asking the modem, Hanging up, UNPACKING) means ECCGMS is working: wait. Loading the voice takes about 30 seconds on a 1541 |
| The voice stops in the middle of a text, and the C64 no longer answers, not even STOP (VICE, or a first C64) | the voices of 1.3 and older (VOICE1, VOICE1FR) can freeze like this, about once in nine pauses between two parts of a sentence: take those of 1.31 (on the P2i Lab BBS: X, then 7 and 9; or the disk eccgms.d64, or the new eccgms.crt). To get out: reset the C64 (VICE: Reset) |
| The voice goes on after STOP | hold STOP down (Esc on a PC keyboard) until it stops: ECCGMS looks at it between two parts of a sentence |
| C= V types a strange sign (VICE) | on a PC keyboard, C= is Tab (section 5): hold Tab, then press V |
| TCPSerial does not start (Windows) | double-click TCPSerial.jar instead of TCPSerial.bat (section 2) |
| VICE: "No modem answered" again after VICE was closed | VICE forgot its settings: set the RS232 page again (section 2), then Preferences, Save settings |
| VICE: "No modem answered", the settings right | close VICE, then TCPSerial (Task Manager, "OpenJDK Platform binary" or "Java", End task), and start TCPSerial again in a window (in its folder: java -jar TCPSerial.jar): it must say Waiting for IP232 connections on port 25232, then Connection opened when ECCGMS starts |
| VICE: a download stays on "Downloading", then "Nothing came for 45 seconds" | in VICE's RS232 settings, uncheck IP232 for device 3 (section 2) |
| A download does not start | the BBS's protocol must match (F7, Protocol; Punter for most C64 BBSes) |
11. Links
All free:
| To... | Software |
|---|---|
| imitate a C64 on a PC | VICE: https://vice-emu.sourceforge.io/ (for Windows: https://vice-emu.sourceforge.io/windows.html) |
| give VICE a modem | TCPSerial: https://github.com/MyDeveloperThoughts/tcpserial/releases (Windows, Linux, macOS; it needs Java 21 or later: https://adoptium.net/) |
| call the BBS from a PC, without a C64 | SyncTERM: https://syncterm.net/ (C64 mode, font "Commodore 64 (Lower)") |
| MiSTer: its modem, the C64 core | Computer Core Networking: https://mister-devel.github.io/MkDocs_MiSTer/advanced/computer/ ; the core: https://github.com/MiSTer-devel/C64_MiSTer |
| Ultimate: its modem | Modem support: https://1541u-documentation.readthedocs.io/en/latest/howto/modem.html |
| a WiFi modem's firmware | Zimodem (on many WiFi modems): https://github.com/bozimmerman/Zimodem |
| the disk on a real C64 | an SD2IEC (an SD card drive for the C64): https://www.c64-wiki.com/wiki/SD2IEC, or OpenCBM and a ZoomFloppy cable to write a real floppy from a PC: https://opencbm.sourceforge.io/ |
| ECCGMS, its page | https://p2i-lab.com/c64/ |
12. Credits
- ECCGMS 1.33, P2i Lab, 2026: the new interface, the voices, the P2i Lab BBS features, the cartridge. https://p2i-lab.com
- CCGMS Future 0.2 (c) 2016-2022 Craig Smith, alwyz, Michael Steil (https://github.com/mist64/ccgmsterm), after CCGMS by Craig Smith (1985-1988). alwyz thanks the CBM Hackers Mailing List, IRC #c64friends, pcollins/excess, larry/role, xlar54, and the users of AFTERLIFE BBS for testing, tips and bugfixes.
- CMUdict (c) 1993-2015 Carnegie Mellon University: the voice's English rules were learned from it, and the words of the cartridge's big dictionary and their sounds come from it. The voice also knows a short list of common words by heart; this list and the big dictionary were chosen with google-10000-english by Josh Kaufman and FrequencyWords by Hermit Dave (from OpenSubtitles 2018).
- Open source, BSD 3-Clause License: see LICENSE.txt for the full texts.