← ECCGMS and the P2i Lab BBS · eccgms.d64

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:

New in 1.33: the MiSTer's modem (the voices do not change: the VOICE1 and VOICE1FR of 1.31 are right).

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).

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

  1. 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.
  2. Prepare your machine: the modem on, and the disk in drive 8 (section 2).
  3. On the C64, type LOAD"ECCGMS",8,1 and RETURN, then RUN and RETURN.
  4. The first time, ECCGMS looks for your modem: when it has found it, press RETURN.
  5. 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 new to 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

The disk eccgms.d64 holds four files:

FileWhat it isSize
ECCGMSthe program95 blocks
VOICE1the voice, in English52 blocks
VOICE1FRthe voice, in French58 blocks
LICENSEthe 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)

  1. Copy eccgms.d64 to the MiSTer's SD card, for example into games/C64. The MiSTer must be connected to your network.
  2. 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).
  3. Still in its menu, Drives: Parallel Cable: Off (on an older core: Parallel port: Disabled, in Drives or Hardware; see below).
  4. In the MiSTer's own menu (Win+F12): Uart Connection: Modem, Link: TCP, Baud: 9600. Save.
  5. In the core's menu, mount eccgms.d64 in 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:

Ultimate 64, C64 Ultimate, Ultimate II+

  1. Connect the Ultimate to your network.
  2. 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).
  3. Copy eccgms.d64 to 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):

  1. In the TeensyROM's menu, open its Settings and press B until Special IO says Swiftlink. It keeps this setting.
  2. 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)

  1. Install VICE (free) and Java 21 or later (section 11).
  2. 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-click TCPSerial.jar instead: 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.
  3. 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.

Then Preferences menu, Save settings: VICE does not keep its settings by itself when it closes.

  1. Drag eccgms.d64 onto 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

  1. 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.
  2. 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 answer OK. (ECCGMS turns the modem's echo on there, so that what you type shows; if it says No modem answered, see section 10.)
  3. The disk: with an SD2IEC (an SD card drive for the C64), copy eccgms.d64 to its SD card and open it, with a file browser or with OPEN1,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).
  4. If calling gives ERROR (some modems do, for example those with the Zimodem firmware), choose ATD"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).

  1. 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.
  2. 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 $DF00 instead of $DE00, and VICE's REU off (its registers are at $DF00 too: ECCGMS then leaves $DF00 alone, and finds no modem); then Preferences, Save settings;
    • on an Ultimate: in its menu, ACIA (6551) Mapping: DF80/NMI (ECCGMS calls it "Ultimate (DF80)").
  3. 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.crt as a cartridge. To start with it every time: Hardware, Boot Cartridge;
    • Ultimate (Ultimate 64, C64 Ultimate, Ultimate II+): choose eccgms.crt in its menu, then Run Cart;
    • Kung Fu Flash (an SD card cartridge for a real C64): choose eccgms.crt in its menu.

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)

KeyWhat it does
Cursor keys, joystick (port 2), or 1-9choose a BBS (the list scrolls; 30 BBSes at most)
RETURN, SPACE, the fire buttoncall the BBS chosen
Eedit it: name, address (host or host:port), port, your user name and password there
Nadd a new BBS
DELdelete the BBS chosen (Y/N)
Acall an address you type (host:port)
Tthe terminal, without calling (to type the modem's commands: ECCGMS turns the modem's echo on, so that what you type shows)
F1the menu
F7the 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 keyVICEMiSTer
RUN/STOPEscEsc
C= (Commodore)TabTab or Alt
CTRLCtrlCtrl
CLR/HOMEHomeHome
INST/DELBackspaceBackspace
RESTOREPage UpF11
F2, F4, F6, F8F2, 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.

KeyWhat it does
F1the menu (all of ECCGMS); F1 again or STOP: back to the BBS, its screen as it was
F2read a text file on the screen (R, then its name), or send it to the BBS (S)
F3download a file
F4the buffer: a copy of what the BBS sends
F5a command for the disk drive
F6the files on the disk
F7the settings
F8change the text mode: PETSCII (C64 BBSes), ASCII (PC BBSes), 80 columns
C= STOPhang up
C= Vread the last text aloud (with the voice on)
CTRL F1, CTRL F3send macro 1, 2
CTRL F5send your user name for this BBS (from the list)
CTRL F7send your password for this BBS (from the list)
C= F1 / C= F3send / receive several files (Multi-Punter)
C= F5send the disk's directory
C= F7the screen into the buffer
C= CTRL 1-4 / SHIFT CTRL 1-4keep 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.

TileLetter: action
CallC the list of BBSes · H hang up
FilesD download (F3) · U upload · R run a program downloaded · F files on the disk (F6) · K disk command (F5)
VoiceV the voice: on, off · A read the last text again (C= V)
ScreenB the buffer (F4) · T PETSCII, ASCII, 80 columns (F8)
SettingsS 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.

SettingValues
ModemUser port (WiFi modem), UP9600, SwiftLink/Ultimate (DE00), SwiftLink (DF00) (not with a REU: it is at $DF00 too), SwiftLink (D700). I: find my modem
Speed300 to 38400 baud, as the modem allows
ProtocolPunter (most C64 BBSes, and the P2i Lab BBS), XMODEM, XMODEM-CRC, XMODEM-1K: the ways for a BBS to send you files
Voiceoff, on; on, loud with a SID 8580 (section 8)
Speaksat once (P2i Lab BBS): its answers are read aloud as they arrive; only with C= V: when you press C= V (section 8)
LanguageEnglish, 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
Echooff (the BBS sends back what you type), on
DialingATDT 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:

WrittenSaid
5 p.m., 9 AM, 7:15, 7:05, 17:00five 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.14one thousand two hundred fifty · two million five hundred thousand · three point one four
1st, 2nd, 13th, 21stfirst, second, thirteenth, twenty-first
1984, 2026, the 1980snineteen eighty-four, twenty twenty-six, the nineteen eighties
-3, 10-15, $5, $2 million, 50%, #1minus 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= VCommodore 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.

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:

  1. On the list, press RETURN: ECCGMS calls the P2i Lab BBS.
  2. 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.
  3. At "Handle", type new, then choose your handle (your nickname) and a password. The next times, type your handle and your password.
  4. 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:

10. Troubleshooting

What you seeWhat 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 worksECCGMS 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 unansweredthe 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 terminalMidiLink 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 stillthe 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 BBSMidiLink 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 SpeedDOSthese 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 showECCGMS 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 garbledpress 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 drivea 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 stucka 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 STOPhold 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 closedVICE forgot its settings: set the RS232 page again (section 2), then Preferences, Save settings
VICE: "No modem answered", the settings rightclose 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 startthe BBS's protocol must match (F7, Protocol; Punter for most C64 BBSes)

All free:

To...Software
imitate a C64 on a PCVICE: https://vice-emu.sourceforge.io/ (for Windows: https://vice-emu.sourceforge.io/windows.html)
give VICE a modemTCPSerial: 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 C64SyncTERM: https://syncterm.net/ (C64 mode, font "Commodore 64 (Lower)")
MiSTer: its modem, the C64 coreComputer Core Networking: https://mister-devel.github.io/MkDocs_MiSTer/advanced/computer/ ; the core: https://github.com/MiSTer-devel/C64_MiSTer
Ultimate: its modemModem support: https://1541u-documentation.readthedocs.io/en/latest/howto/modem.html
a WiFi modem's firmwareZimodem (on many WiFi modems): https://github.com/bozimmerman/Zimodem
the disk on a real C64an 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 pagehttps://p2i-lab.com/c64/

12. Credits