PETSCII Commander 64 1.09 - P2i Lab, 2026
=========================================

A small "system" for the Commodore 64, on one 512 KB cartridge: a
two-column Disk Shell, a Desktop of six big tiles, a SID tune player, a
text editor that sends BASIC programs to the C64, a voice that reads
texts aloud, a fast loader, and ECCGMS, the terminal program that calls
BBSes (the P2i Lab BBS first). Free and open source.

Web page: https://p2i-lab.com/c64/

New in 1.09 (03/11/2026)
------------------------

- Keep both: C (copy) or M (move) onto a file of the same name on the
  other side asked "Replace NAME?", Yes or No. It now offers Replace,
  Keep both (chosen at first) or Cancel. Keep both copies the new one
  under a new name: a number before its extension (super-mario.sid:
  super-mario2.sid, then 3...), the first one not on that disk, shown
  on the info line: RETURN takes it, or change it first; STOP: not
  copied. Keys: R (or Y) Replace, K Keep both, C (or N, STOP) Cancel,
  or the arrows (the joystick) and RETURN.
- The SID player no longer crashes when you leave a long tune that
  starts at $C000 for another one.
- ECCGMS 1.33 inside (the MiSTer's modem found by itself...: see its
  MANUAL.md).

In 1.08 (01/11/2026)
--------------------

- A new name: PETSCII Commander 64, so that everyone sees it is made
  for the Commodore 64. Its screens, ECCGMS in its cartridge ("Back to
  PETSCII Commander 64") and its files say it: the cartridge is now
  petscii_commander_64.crt. Nothing else changes.

In 1.07 (31/10/2026)
--------------------

- Fast load from an SD2IEC (ELoad) after a trip to ECCGMS, the text
  editor or the SID player: PETSCII Commander 64 knows an SD2IEC by the
  message it gives when it starts, read once; started again after
  ECCGMS (or the editor, a tune), it found the SD2IEC without it and
  used the slow KERNAL load. It now remembers which drives are SD2IECs
  and asks them again (the UI command: an SD2IEC just gives its
  message again). A 1541 was never affected: it is known by its ROM.

In 1.06 (31/10/2026)
--------------------

A check of the whole program for other hidden freezes, like the one of
drive 9 with no disk:
- Drive 9 with no disk could still freeze "9: reading..." (Harry, in
  VICE, after a SID tune found with the search): a drive asked to send
  a file it could not open (no disk, no such file) answers for only 70
  microseconds, and the C64 could miss it and wait forever. PETSCII
  Commander 64 now reads the drive's status first, every time it opens a
  file to read it.
- A drive switched on while the Disk Shell watches for drives (once a
  second), or just before F3 or D: it tests its memory for about a
  second, and a question asked meanwhile froze the C64. PETSCII
  Commander 64 now waits for the drive to be ready.
- With the files sorted by name (Settings, Files), R (rename), F5 (a
  disk command) and F7 (a new folder) broke the screen and froze the
  Disk Shell (new in 1.05). Fixed.
- Back from a program or a SID tune (SYS 828, STOP in the player): a
  timer left by the program could freeze the start at its first disk
  read. The cartridge's start now sets the timers as a reset does.
- ECCGMS 1.32 inside (its own fixes: see its README).
- Smaller fixes: the SID player opens its file as "0:name"; a long
  drive message no longer goes past its column; "(first 190)" instead
  of "(first 200)"; RESTORE no longer upsets one keyboard reading.

In 1.05 (31/10/2026)
--------------------

- ECCGMS 1.31 inside: its voices no longer freeze the C64. Between two
  parts of a sentence, the voice waits for a timer of the C64's CIA
  chip; the first model of that chip (the 6526 of the first C64s, and
  VICE's by default) sometimes loses the timer's signal, and the voice
  waited forever (STOP did nothing). And after the voice had spoken,
  the next disk read could freeze the C64 and the drive: the voice left
  that timer set to a length with which the KERNAL loses its signal too.
  The voice that reads texts in the Desktop and the viewer is the same:
  fixed too.
- A drive with no disk in the right column (in VICE: drive 9 on, no
  disk image): the right column shows drive 8 instead, and says
  "Drive 9: no disk? F3 reads it again." Put a disk in, press F3: drive
  9 is back on the right. D still chooses drive 9 (then its message).
- A column's message (why it is empty: "No disk in the drive.") is on
  two lines, no longer cut at the column's end.

In 1.04 (30/10/2026)
--------------------

- A drive switched on after the start (in VICE: drive 9 set in
  Settings, then a disk image) shows up by itself, about a second
  later, in the right column: no need to press D. F3 looks at once.
  Once two drives are shown, or a drive is chosen with D, nothing
  changes by itself.

In 1.03 (30/10/2026)
--------------------

- Settings, J: Joysticks. Both control ports, live: where each stick
  is pushed, its fire button, and buttons 2 and 3 of the joysticks that
  have them (the MiSTer's Fire 2 and Fire 3). Most games read port 2;
  on a MiSTer, its menu can swap the ports; in VICE, Settings, Joystick.

In 1.02 (30/10/2026)
--------------------

- Switched on with no disk in a 1541, the disk put in later: the
  settings, the files, the copies and the editor work again (the 1541
  kept answering "74, drive not ready").
- ECCGMS 1.3 inside: its French voice, and the language set by the P2i
  Lab BBS. The cartridge is now 512 KB (VICE, a MiSTer, an Ultimate and
  a Kung Fu Flash read it).

In 1.01 (30/10/2026)
--------------------

- A name with * ? , : = is refused where it would reach other files
  (copy, move, rename, delete, format, new folder, the editor's save):
  "s:letter?" deleted letter1 and letter2.
- F5 then UJ (the drive starts again): the C64 no longer freezes.
- A copy that meets a sector it can't read stops and says so; the
  editor too, instead of opening or saving half a text.
- The editor: F7 (to BASIC) with a 16-letter name.
- The SID player: tunes that use the memory under BASIC's ROM.
- The fast loader leaves the loading to the KERNAL when it is not
  Commodore's own.
- In a folder, the settings are kept until the C64 is off (saved there,
  they would be out of reach at the next start).
- ECCGMS 1.24 inside. A column shows 190 files at most (200 before).

In the zip PETSCII-Commander-64-1.09.zip
----------------------------------------

  petscii_commander_64.crt  the cartridge (512 KB, "Magic Desk"), for
                            VICE, a MiSTer, an Ultimate or a real C64
                            with a Kung Fu Flash
  pcmd_essai.d64            a disk to try it: a text, a PC text, a BASIC
                            program, three SID tunes
  README.txt                this file
  LICENSE.txt               the licenses

Start
-----

Put a disk in drive 8 (pcmd_essai.d64, or your own: PETSCII Commander 64
keeps its settings on it, in a file named pcmd-setup), then the
cartridge, last: about a second later, the Disk Shell.

  VICE        File menu, Attach disk image, drive 8; then File menu,
              Attach cartridge image: petscii_commander_64.crt (or drag it
              onto VICE's window). VICE restarts the C64 with it.
  MiSTer      copy both files to the SD card (for example games/C64); in
              the C64 core's menu (F12), mount the disk in drive 8, then
              load petscii_commander_64.crt as a cartridge.
  Ultimate    copy both files to its USB stick or SD card; in its menu,
              choose the disk, Mount Disk (drive 8), then
              petscii_commander_64.crt, Run Cart.
  Kung Fu     copy petscii_commander_64.crt to its SD card and choose it
  Flash       in its menu; the disk: a 1541, an SD2IEC...

Hold C= while you switch on: the C64 starts without the cartridge.

The keys
--------

Disk Shell: the cursor keys or the joystick (port 2) choose; left and
right, a column. RETURN opens: runs a program, plays a .SID tune, shows
a text, enters a folder or a .D64 image of an SD2IEC. SPACE marks a
file; C copies and M moves to the other column; DEL deletes, R renames,
V views, E edits, N formats, D goes to the next drive, F3 reads the disk
again, F5 sends a command to the drive, F7 makes a new folder, ? shows
the help, F1 the Desktop. A question comes in a window: Y or N, or the
arrows and RETURN.

Back to PETSCII Commander 64: from a program, RESET; from BASIC, SYS 828;
from ECCGMS, Q in its menu (F1).

Fast load: a program run from the Disk Shell, and the file shown by V,
load several times faster from a 1541 or a 1571 (a turbo), and from an
SD2IEC (ELoad); with JiffyDOS in the C64 and in the drive, JiffyDOS does
it. Settings (S on the Desktop), F: fast load off.

ECCGMS, to call BBSes: the Desktop's first tile. Its modem must not be
at $DE00, the cartridge's address: in VICE, the ACIA at $DF00 (and
VICE's REU off); on an Ultimate, at DF80; on a MiSTer, UP9600; on a real
C64, a WiFi modem on the user port. ECCGMS's user guide:
https://p2i-lab.com/c64/manual.html

En francais
-----------

PETSCII Commander 64 : un petit systeme pour le Commodore 64, dans une
cartouche de 512 Ko. Mettez une disquette dans le lecteur 8, puis la
cartouche (VICE : File, Attach cartridge image). Le Disk Shell montre
deux lecteurs cote a cote ; RETURN lance un programme, joue un morceau
SID, montre un texte ; F1 : le Desktop. Les ecrans sont en anglais. La
page du site, en francais aussi : https://p2i-lab.com/c64/

In the zip PETSCII-Commander-64-1.09-source.zip (for programmers only)
----------------------------------------------------------------------

You don't need it to use PETSCII Commander 64. commander/: the source (C
and 6502 assembly for cc65, Python tools), its tests (on a C64 imitated
in Python: ccgms/tests/c64sim.py, with drive1541.py and rom1541.py),
fabriquer.sh (the build script), README.md (in French: how everything
works). c64bbs/: the two files of the P2i Lab BBS that its tools use
(basiclib.py, sidlib.py) and the three SID tunes of the test disk.

To build the cartridge (Linux, or WSL on Windows): cc65, Python 3, and
ECCGMS's source in the folder ccgms (ECCGMS-1.33-source.zip, same web
page). The cc65 that made it: from git (https://github.com/cc65/cc65,
git checkout 8d86ca7, make), its bin folder given as CC65_BIN; Ubuntu's
cc65 2.19 makes PETSCII Commander 64 too big for its banks. With both zips
unzipped side by side:

    cd PETSCII-Commander-64-1.09-source
    cp -r ../ECCGMS-1.33-source/. ccgms/
    export CC65_BIN=/the/cc65/bin
    bash ccgms/fabriquer.sh
    bash commander/fabriquer.sh

commander/build/petscii_commander_64.crt is then the same cartridge, byte
for byte. The tests also need py65 and Pillow (pip install py65 pillow)
and the C64's ROMs in a folder (VICE has them: kernal-901227-03.bin,
basic-901226-01.bin, chargen-901225-01.bin; dos1541ii-251968-03.bin for
the real 1541):

    cd commander/tests
    C64_ROMS=/the/folder python3 t_commander.py

Credits
-------

- PETSCII Commander 64 1.09, P2i Lab, 2026.
- Its disk engine follows DraCopy (Sascha Bader, Dirk Jagdmann).
- Its fast loader follows the Covert Bitops Loadersystem (Lasse Oorni,
  MIT License), and its ELoad support Thomas Giesel's.
- ECCGMS: after CCGMS Future 0.2 (Craig Smith, alwyz, Michael Steil);
  its voice's English rules were learned from CMUdict (Carnegie Mellon
  University).

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