Skip to content

Cartridges and CRO Files

WacKEDmaN edited this page Nov 13, 2026 · 4 revisions

Cartridges and CRO files

Cartridges

The 464 Plus, 6128 Plus and GX4000 take cartridges. A classic CPC takes them too (below). Use the Cartridge window or Media → Cartridge → Load cartridge (.cpr, .cro)..., or drop the file on the window.

  • CPR is the usual cartridge image format. A raw cartridge image (.bin, whole 16 KB pages) also loads.
  • Eject takes the cartridge out: the machine starts without it (a Plus on its system cartridge).
  • On a classic CPC (464, 664, 6128) a cartridge loads and the machine stays as it is: the same model, CRTC and expansions. The cartridge is mapped as on a Plus: page 0 is the lower ROM, and &DFxx selects the other pages. On a real CPC, an M4 Board loads cartridges the same way.
    • Most cartridges run. A cartridge that unlocks the Plus ASIC (for example Sonic) needs a Plus or a GX4000.
    • With no machine chosen, a cartridge starts a GX4000 (or a Plus when there is no GX4000).
    • On the command line, --model cpc6128 --cart <file> runs the cartridge on a 6128. --cart with no --model starts a GX4000.

PicoGX

The PicoGX is a cartridge that loads other cartridges from a MicroSD card. It is in the Cartridge window, under the cartridge buttons.

The PicoGX is off until you add it. Select Use a PicoGX to add it. Clear it to remove the PicoGX from the machine: if it is in the slot, the machine starts again without a cartridge.

  1. Click Choose its SD card folder... and choose a folder on your computer. That folder is the SD card.
  2. The list shows the folder as the PicoGX's menu does:
    • A sub-folder shows only if it holds a cartridge somewhere inside it.
    • The files are .cpr, .bin, .cro and .dsk.
    • (i) marks a file that has a .txt file with the same name beside it. Click the file to see the text.
  3. Double-click a file, or click it and then Launch.

Other buttons:

  • Last: launches the last file again (the PicoGX puts it at the top of its menu).
  • AutoFlash: shows when the card's PicoGX.cfg has AutoFlash=<file> in its [Special] section.

The PicoGX's own menu

The real PicoGX shows a menu on the CPC screen. That menu is inside the PicoGX firmware file (.uf2, from the PicoGX releases). The emulator does not include it, but it can run it from your own copy:

  1. Click Firmware (.uf2)... and choose the firmware file.
  2. Click Start the PicoGX menu. The menu shows the SD card folder.

In the menu (keyboard, or joystick on a GX4000):

  • Up / Down: choose a row. Left / Right: change the page.
  • Enter (fire 1): enter a folder, or launch a file.
  • ESC or DEL (fire 2): go back up a folder.
  • P: show the file's .txt information.

Command line: cpcse --picogx <folder> --picogx-menu <file.uf2>.

What programs can use

The PicoGX's Programming.md:

  • The save: 16 KB per cartridge, read and written with the PicoGX's read, write and stop commands. It goes into saves/<name>.SAV on the card, and loads again when the cartridge is launched.
  • Cartridges up to 1.5 MB: a read of &3FFC-&3FFF in cartridge bank 0 chooses the 512 KB block.

Limits:

  • A .dsk file goes into drive A and the cartridge stays. This needs a machine with a disc drive (a 6128 Plus).

Command line: cpcse --picogx <folder> --picogx-launch <file>.

CRO files

A CRO file ("Containers ROms", by Logon-System) holds groups of ROMs.

  • A group of bankable ROMs is a Plus cartridge. The ROMs are its pages.
  • A group of low, high and Multiface II ROMs is a ROM set for a classic CPC: it starts the CPC with that OS, those upper ROMs in their slots, and that Multiface II ROM, until the next start or eject.
  • Each group has an address mask (GMSK): the cartridge address is ANDed with it. A 64K cartridge with mask &FFFF repeats through the 512K, as its ROM chip does. A page with no ROM reads 0.

Choose the group

  • When a CRO with more than one group loads, a box asks which group to run. Keep the one running keeps the group the CRO started with (the group with number 0, or the first group).
  • Media → Cartridge → CRO group changes the group of the CRO in the machine.
  • In the CRO editor, the In the machine list shows the groups of the CRO in the machine. Click one to run it.
  • On the command line, --cro-group <n> chooses the group.

The CRO editor

Open it with Tools → CRO editor. It makes new CRO files and changes CRO files. The files it writes are the same, byte for byte, as Logon-System's CRO manager writes.

The file

  • New: a new CRO with one empty group.
  • Open...: open a CRO file. Edit this file opens the CRO in the machine.
  • Save, Save as....

Groups

The list shows each group: its number, label, number of ROMs, and whether it is a cartridge or CPC ROMs.

  • Add group: a new empty group with the next free number.
  • Import a cartridge...: a CPR file (its pages) or a raw cartridge image becomes a new group. Its mask is set so that its pages repeat as the ROM chip of that size does.
  • Remove, Up, Down.
  • Run: puts the editor's groups into the machine and runs the selected group, saved or not.

For the selected group:

  • Number (GNUM): a group's number. Two groups cannot have the same number.
  • Label (GLBL).
  • Mask (GMSK): none (&FFFFFFFF), 16K, 32K, 64K, 128K, 256K or 512K.

ROMs

The list shows each ROM of the group: its name, its page or ROM number, and its size.

  • Add a ROM file...: a ROM file from your PC (an AMSDOS header is removed).
    • Into a cartridge group, the file goes in as pages, 16K each, on the next free pages.
    • Into a CPC group, it goes in as a high (upper) ROM on the lowest free ROM number.
  • Remove, Up, Down.

For the selected ROM:

  • Name (RID): up to 16 characters.
  • Type (RTYP): Low (the OS), High (an upper ROM), Bankable (a cartridge page) or Multiface II.
  • Logical (RLOG): for a high ROM, its upper ROM number (0 to 255).
  • Physical (RPHY): for a bankable ROM, its cartridge page (0 to 31).
  • Replace the bytes..., Save the bytes....

Problems

Under the lists, the editor shows what is wrong, for example:

  • two groups with the same number;
  • two bankable ROMs on the same page, or a page past 31;
  • two high ROMs with the same number, or a number past 255;
  • more than one low ROM or Multiface II ROM in a group;
  • a ROM of a size the hardware does not have;
  • a group that mixes cartridge pages and CPC ROMs.

Clone this wiki locally