Skip to content

Releases

CPCSyntaxError v0.17.0

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 16 Nov 20:28

CPCSyntaxError v0.17.0

A large update of the tools and the interface.

Assembler and C windows

  • Undo and redo (Ctrl+Z, Ctrl+Y or Ctrl+Shift+Z) for each tab. The history stays when the editor loses the focus (for example after F9).
  • Find and replace: Ctrl+F, Ctrl+H, F3 and Shift+F3, and Enter in the find box. "Aa" matches the case, "Word" finds whole words only. All the matches on the screen are marked. Replace all is one step for Undo.
  • Go to definition: F12, Ctrl+click, or the right-click menu. It looks in the file on show, then in the other files of the program, then in the symbols of the last build.
  • A Labels tab lists the names the file defines (labels, EQU and macros; in C, functions, #define and globals). A click goes to the line.
  • Ctrl+/ puts a comment on or off for the selected lines (; or //). Tab and Shift+Tab move the selected lines in or out.
  • A NOP column shows the cost of each line in NOPs, also for lines with several instructions separated by :. The costs were measured on the emulated CPC. Put the mouse on a cost to see each instruction's cost.
  • Drag a .asm, .c or .bas file onto the window to open it.
  • RASM is now version 3.3.3 from its GitHub, with no changes of ours.

BASIC window

  • It opens the files BASIC saves: tokenized, with or without an AMSDOS header, also protected ones. ASCII files open as before.
  • Find and replace (Ctrl+F, Ctrl+H, F3), with "Undo the replace".

Debugger

  • Watches window: an address or a label (with an offset, such as table+2), as a byte or a word. A value that changes shows in another colour for a second. Type a new value and press Enter to write it.
  • Memory → Search: bytes (?? is any byte), text (in any case) or a word, in the Z80's 64K or in all the RAM. A click on a result shows it in the hex editor.
  • Export .asm (in the disassembly): a range of memory as RASM source, with labels for its jumps and calls. The export is assembled again, and what does not give back the same bytes is written as db. The OS and BASIC ROMs of the 6128 come back byte for byte.
  • The timing line shows the difference to 19968 NOPs (one frame), when the count is 22000 NOPs or less.
  • PSG tab: a scope for each channel, and a switch to mute each one (the sound only; the chip does not change).

Graphics Finder

  • Draw on the picture, as in WinAPE. The pens of the mode are shown with their numbers, in their real colours. Tools: Pen, Line, Box, Filled box and Fill. A right-click on a pixel takes its pen.
  • Undo and redo (Ctrl+Z, Ctrl+Y) for each stroke, shape, fill, paste and import.
  • Right-click a pen to change its ink: the 27 CPC colours, or red, green and blue on a Plus.
  • Copy tile and Paste tile.
  • Import PNG into the selected tile: each pixel gets the pen with the nearest ink.

Interface

  • Themes (Window → Settings → Colours and themes): a colour for each part of the interface, five themes included, and your own themes saved as .cpctheme files. The default is the look the program always had.
  • Command palette (Ctrl+Shift+P): type part of a command's name and press Enter.
  • Copy the screen to the clipboard (Ctrl+Shift+C, or the File menu).
  • Help → Keyboard shortcuts: every key of the program in one window.

CPCSyntaxError v0.16.0

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 14 Nov 12:38

CPCSyntaxError v0.16.0

Fast disc loading

Two new settings in the Discs window and the Media menu. Both are off until you turn them on.

  • Turbo: while the disc drive works, the whole CPC runs faster (up to 20 times, or as fast as your computer goes). When the program starts, it runs at normal speed again. Every loader works, protected loaders too. The status bar shows "DISC TURBO".
  • Instant loading:
    • The files and sectors that AMSDOS reads go into memory at once: LOAD, RUN", CAT, |CPM, and loaders that use AMSDOS's sector command. There is no wait for the motor and no wait for a seek. A 20 KB LOAD" takes 0.1 s instead of 5 s.
    • Loaders that drive the disc controller themselves get each sector without a wait for the disc to turn. The bytes still come at the speed of a real drive, so their read loops work as on a real CPC.
    • Protected sectors (CRC errors, deleted data, weak sectors) keep the timing of the disc.
    • It works with AMSDOS on the 464, 664, 6128 and the Plus, and with ParaDOS. Other DOS ROMs load at the normal speed (use Turbo).
    • Command line: --disc-instant.

Security audit

A full audit of the code added since the last one, with new fuzz tests and AddressSanitizer and UBSan builds.

  • Albireo (CH376): a program on the CPC could create a file such as ..\..\NAME and so write outside the folder of the USB stick or SD card. It could also create files with the names of Windows devices (CON, AUX). This is fixed. The file layer of the M4, IDE, SYMBiFACE and Albireo cards now refuses every name that could reach outside its folder.
  • Albireo (CH376): a program could ask for a file of 4 GB, and the emulator then tried to make it in memory. A file is now at most 256 MB ("disc full" after that).
  • BASIC window: a number such as 1E999 gave an undefined value. It is now kept as text, as BASIC itself keeps it.
  • Smaller changes: cartridge pages are always 16 KB, the MCP and command API servers take at most 32 connections at once, and the flow-control queue of the Albireo UART has a limit.

Machine profiles ask before they change folders

A machine profile can name the folders of the M4, IDE, Albireo and SYMBiFACE III cards and the HD20 image. A program on the CPC can write to those folders. If a profile names folders that are not yours, the emulator now asks: keep your folders, use the folders of the profile, or cancel. On the command line, --machine keeps your folders, and --machine-folders uses the folders of the profile.

CPCSyntaxError v0.15.1

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 13 Nov 08:30

CPCSyntaxError v0.15.1

Program icon

  • CPCSyntaxError has its own icon now.
  • Windows: the .exe has the icon, so Explorer, shortcuts and the task bar show it.
  • All systems: the window has the icon (title bar, task bar and window switcher).
  • macOS: the .app has the icon. Linux: the package has cpcse.png for a desktop shortcut, and the Flatpak uses the new icon.

PicoGX: its real menu

  • If you have the PicoGX firmware file (.uf2, from the PicoGX releases), the PicoGX's own menu now runs on the CPC screen.
  • In the Cartridge window, select Firmware (.uf2)..., then Start the PicoGX menu. From the command line: --picogx <folder> --picogx-menu <file.uf2>.
  • The menu shows the SD card folder. You can enter a folder, go back (ESC), change the page, show the .txt information of a file (P), and launch a file.
  • The emulator reads the menu from your own firmware file when you start it. The firmware is not included.

PicoGX on and off

  • The Cartridge window has a Use a PicoGX switch. When it is off, the machine has no PicoGX.
  • If you turn it off while the PicoGX is in the slot, the machine starts again without a cartridge.
  • It is off for a new install. If you chose a PicoGX SD card folder in v0.15.0, it stays on.

C and assembler windows

  • Drag the bar between the editor and the messages to change their sizes. Double-click the bar to go back to the first size. Each window keeps its size.
  • The Symbols table has a wider Value column that you can resize. It shows the value in decimal too.

Linux

  • On some Linux desktops the whole window flashed when a tooltip opened. The emulator now tells the X11 compositor not to stop for its window.
  • If it still flashes, turn off Window → Windows can leave the main window (or start with --no-os-windows). Tooltips and windows then stay inside the main window. This takes effect at the next start.

CPCSyntaxError v0.15.0

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 12 Nov 16:14

CPCSyntaxError v0.15.0

MCP server for AI agents

  • AI agents (Claude Code, Claude Desktop, Cursor, VS Code and others) can now drive the emulator with the Model Context Protocol.
  • Turn it on in Settings → External debugging → MCP server, or start the emulator with --mcp. It is off until you turn it on.
  • The address is http://127.0.0.1:6129/mcp. For Claude Code:
    claude mcp add --transport http cpcse http://127.0.0.1:6129/mcp
  • 23 tools: load and run files, type, press keys, read and write memory and registers, breakpoints and watchpoints, step, run frames, wait for a stop, disassemble, and screenshots (sent to the agent as images).
  • It answers only this computer. A request from a web page is refused.

PicoGX cartridge

  • The PicoGX SD-card cartridge (github.com/Neo2003/PicoGX) is in the Cartridge window.
  • Choose a folder to be its SD card, then pick a CPR, BIN, CRO or DSK file from it. The list shows the folders and files as the PicoGX does, the last cartridge, an AutoFlash cartridge from PicoGX.cfg, and the .txt information beside a file.
  • Programs can use the PicoGX's 16 KB save (saves/<name>.SAV on the card) and cartridges up to 1.5 MB, as its Programming.md describes.
  • Command line: --picogx <folder> --picogx-launch <file>.
  • The PicoGX's own menu program is not published, so the Cartridge window is the menu.

CRTC fixes from a review of every SHAKER screen against the real CPC photos

  • The Gate Array's VSYNC black band now starts on the character where the VSYNC starts, at each chip's own pixel (ACCC 16.2.1). Before, it started on the next line. SHAKER DT/A on CRTC 0, 1 and 2.
  • CRTC 2: when R5 adds lines after the frame's last row, those lines now show the memory after the last row, and only the next frame starts again from R12/R13 (ACCC p.82). SHAKER AP/J, AP/K and BRETURN.

Other changes

  • 464 and 664 with a ROM board that uses RAMDIS: writes still go to the internal RAM, as on the real machine. Only the 6128 takes its RAM off the bus.

CPCSyntaxError v0.14.3

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 12 Nov 04:54

CPCSyntaxError v0.14.3

BASIC window: real numbers are correct

  • "From the machine" now shows real numbers as BASIC 1.1's own LIST shows them.
  • Before, a line such as FOR a=0 TO 6.4 STEP 0.3 came into the editor as FOR a=0 TO 6.400000000372529 STEP 0.30000000004656613.
  • Cause: BASIC keeps a real number in 5 bytes (about 9 digits). The window printed it with all the digits of a PC number.
  • Now the window writes the shortest number that gives the same 5 bytes back. The format is the BASIC LIST format: 6.4, 0.3, 0.00001, 1.23456789E+09, 1E+10, 2.5E-20.
  • When a number needs a 10th digit, the window keeps it, so "To the machine" puts back the same bytes.
  • Tested on the 464, 664 and 6128 BASIC ROMs.

Thanks to the user who reported this problem.

CPCSyntaxError v0.14.2

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 08 Nov 11:03

CPCSyntaxError v0.14.2

This release corrects the soft scroll of the Plus and the GX4000.

Fixes

  • Plus soft scroll, left edge: the border extension (bit 7 of the ASIC register &6804) now covers the first character that the CRTC displays. Before, a game that scrolls with it showed a column of characters at the left edge of the play area (for example Ghosts'n Goblins GX).
  • Plus soft scroll, smooth movement: when the scroll value went back to 0, the frame before it was drawn without its scroll. The picture jumped back 12 pixels and then 16 pixels forward, once every 8 frames (Ghosts'n Goblins GX, when Arthur walks left). The picture now moves smoothly in both directions.

Command line

  • --keys "ArrowRight*200" holds a key for 200 frames.
  • --keys "ArrowLeft!" presses a key and keeps it held, for the frames that --seq saves.

CPCSyntaxError v0.14.1

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 07 Nov 17:23

CPCSyntaxError v0.14.1

This release lets a classic CPC load cartridges, adds an Expansion port window to the debugger, and corrects the CM14 monitor on the 6128 Plus.

Cartridges on a classic CPC

  • Load a CPR on a 464, 664 or 6128 and the machine stays as it is: the same model, CRTC and expansions. The emulator no longer changes to a Plus or a GX4000.
  • 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, or on a Plus, a cartridge loads as before.

Expansion port window

Debug → Expansion port shows the CPC's 50-way expansion connector.

  • The pins: each pin has a lamp that lights while its signal is active and then fades, so a short pulse such as /NMI or /RESET can be seen. The address and data pins show the last I/O cycle. The tooltip on a pin tells what it does, how much of the last second it was active, and how often it switched on.
  • Boards on the bus: each fitted board, the ports it decodes, its reads and writes each second, and its last access. A board that decodes only some address bits is shown as a bit pattern.
  • Port clashes: the ports that two fitted boards both answer, for example the SSA-1 and the Kempston mouse at &FBEE. A real bus has the same clash.
  • I/O log: the last 256 I/O cycles with the PC, the port, the value and the devices that answered.
  • Stop on access: the CPC stops, as at a breakpoint, on an I/O cycle that reaches a board you choose.
  • The window samples only while it is open.

Fixes

  • Monitor (CM14, 6128 Plus): a second sync about 30 characters after the line sync that runs past the half line now moves the picture slowly to the right, as on a real CM14. The CTM is not changed. SHAKER DH/B2, D3/A6 and D3/B6 on CRTC 3 now match the photographs of a real 6128 Plus.
  • Rewind: the text now says that the Albireo boards, the Albireo serial link and the HD20 are not rewound.
  • Expansions: every expansion was checked. Each board, when you remove it, leaves the machine as it was before it was fitted.

CPCSyntaxError v0.14.0

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 07 Nov 12:57

CPCSyntaxError v0.14.0

This release adds machine profiles. It also has many CRTC, Gate Array and monitor fixes. They come from a screen-by-screen review of the SHAKER test suite against photos of a real CPC and against AmSpiriT-lite.

Machine profiles

You can now save a machine with all its expansions in a file, and load it again with one click.

  • Machine > Machine profiles shows your saved profiles. Click a profile to load it.
  • Save this machine as a profile... saves:
    • the model, RAM, CRTC, Gate Array and Z80
    • the keyboard region, the joystick and the monitor set
    • the firmware ROMs you chose and every expansion ROM slot
    • every expansion with its settings and folders: M4, Multiface II, RS232C, SYMBiFACE II/III, mouse interface, IDE, both Albireo boards, HD20, light gun, GFX9000, OPL4, PlayCity, speech, the MP3 card and the DAC
  • Save this machine with its media... also saves the discs in drives A and B, the tape and the cartridge.
  • A profile is the whole machine. When you load it, an expansion that it does not name is removed, and the machine restarts.
  • You can also load a profile with File > Open, drop a .cpcmachine file on the window, or start with --machine <name or file>.
  • Profiles are kept in the machines folder beside the program. They are text files with the same lines as cpcse.ini, so you can also write them by hand.

Fixes

  • M4: when you remove the M4, it now comes out of the machine. Before, a board that was fitted earlier stayed in after a restart.
  • CRTC 0: an R7 write equal to C4 starts the VSYNC on C0=R0 of a line, except on the last line of a row (SHAKER AI/D, B6/A).
  • CRTC 1: the RFD ("rupture for dummies") stops at the end of its frame. When the last line is cancelled with R4 only, the RFD occurs on one frame of two (SHAKER D9).
  • CRTC 3 and 4:
    • Status 2 bit 4 is the comparator that ends the additional lines. Bit 0 does not fire again in the additional lines (SHAKER DU/B2, DU/D, DU/G27).
    • The R8 SKEW function is now a delay line, as on CRTC 0. An R8 change is seen from the next character (SHAKER A2/C).
  • Gate Array: a colour change now shows on the character that the Gate Array displays, one character before the CRTC's (ACCC 9.2.2). In mode 2 on the 6128 Plus, it shows at the same place as in the other modes (SHAKER A9, DI).
  • Monitor:
    • Many syncs on a line (SHAKER D4) now move the picture over a few lines, as the real monitor does.
    • One line with no sync no longer bends the picture under it (SHAKER DT/B1).
  • CPC Plus:
    • The IM 2 response to an ASIC DMA interrupt is 6 µs. The Sonic special stage works again.
    • A Plus snapshot keeps RMR2, the cartridge page and the sprite magnification.

CPCSyntaxError v0.13.1

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 06 Nov 13:27

CPCSyntaxError v0.13.1

This release adds the serial link of the Albireo 1.1 board. It also adds the last CH376 command that was not emulated.

Albireo 1.1: the serial link

The Albireo 1.0 and 1.1 boards have a UART (an SC16C650B) with a USB serial link to another computer. The Albireo 2.0 has no UART.

To fit it, tick Serial link (Albireo 1.1) under Albireo 1 in Expansions.

  • The UART is at &FEB0-&FEB7. It has 32-byte FIFOs, automatic RTS/CTS and Xon/Xoff flow control, and a loopback mode. Its clock is 24 MHz, so the line can run at 1.5 Mbaud.

  • The far end can be:

    • nothing
    • a port on your PC that another program connects to
    • a connection to host:port
    • a serial port of your PC
    • a loopback plug

    For a PC program that opens a COM port, use a virtual serial port pair (for example com0com).

  • Interrupts: the UART sends its interrupt to the CPC's INT when MCR bit 2 is 0, and to NMI when MCR bit 3 is 0. These sources can also cause an interrupt:

    • the CRTC CURSOR signal
    • the CH376
    • the DTR line of the far end
  • DIP switches:

    • S1 lets the CH376 interrupt through.
    • S2 resets the CH376 with the CPC.
    • S3 lets the far end reset the CPC.
    • S4 makes the DTR line of the far end an interrupt.
  • On the command line: --albireo-serial <line> (tcp:host:port, listen:port, com:COM3, loopback or -) and --albireo-switches 1100 (S1 to S4).

The test program of the Albireo manual (16c650.bas) runs. With a loopback plug, it gets back all the bytes it sends.

CH376: DISK_BOC_CMD

The CH376 now does command 50H. This command sends a SCSI command to a USB stick: INQUIRY, READ CAPACITY, TEST UNIT READY, REQUEST SENSE, MODE SENSE, START STOP and READ/WRITE (10) with no blocks. As on the real chip, it gives an error on the SD card.

Build

  • The macOS package is built again when a version is tagged. GitHub stopped the macos-14 build machine, and the automatic build of v0.13.0 failed. The v0.13.0 packages came from a later build of the same source.

CPCSyntaxError v0.13.0

Choose a tag to compare

@WacKEDmaN WacKEDmaN released this 06 Nov 12:11

CPCSyntaxError v0.13.0

This release adds the Albireo board, CPCtelera_next 1.04a support in the C window, and the original RASM from its GitHub. It also has CRTC and Plus fixes that the SHAKER test screens and a Plus demo showed.

Albireo (CH376: SD card and USB)

Expansions > Albireo fits one or two Albireo boards. Each board has a CH376 chip with an SD card and a USB port.

  • Board 1 is at &FE80. Board 2 is at &FE40 (the board with JP2/JP3 cut).
  • The SD card is a folder on your PC. The CPC sees it as one FAT16 disc. What the CPC writes goes back into the folder.
  • The USB port has no device, a USB stick (a folder, as one FAT16 disc) or a USB mouse (your PC's mouse, for SymbOS and FutureOS).
  • UniDOS with its Albireo node finds the board at boot. SAVE and LOAD work on the card.
  • On the command line: --albireo <folder>, --albireo-usb <folder|mouse|none>, --albireo2 <folder> and --albireo2-usb <folder|mouse|none>. Use - for a board with no SD card.

Not emulated: the UART and the interrupt line of other board versions. The software must poll the chip, as on the Albireo 2.0.

C programs (CPCtelera)

CPCtelera_next 1.04a (github.com/Arnaud6128/cpctelera, branch cpctelera_next) now builds all its 60 examples without Cygwin. The new asset steps are:

  • AKS2DATA uses the Arkos Tracker 3 converters for your system (Windows, Linux or macOS). The old converters are the fallback.
  • PACKRLEWB packs data with the RLE-WB method.
  • IMG2SP CONVERT_PALETTE_PLUS writes a Plus palette (12-bit RGB values).
  • IMG2SP SET_PALETTE_PLUS gives the palette as RGB colours. The image converter matches each pixel to these colours.
  • IMG2SP SET_IMG_FORMAT spritehardware makes Plus hardware sprites: 16 x 16 pixels, one pen in each byte, no masks.

Other changes:

  • AKS2C works for the older CPCtelera 1.4 projects.
  • When SDCC 4.6 stops with its internal error in constant propagation, the build compiles that file again with --nogenconstprop.
  • The library cache and the temporary files of the build are now in the cache folder beside the program (or under CPCSE_HOME). They are not in the system's temporary folder.
  • The C window is now a window of its own, next to the assembler window.

Assembler: RASM from its GitHub

RASM is now the original RASM (EdouardBerge/rasm, commit 0e25710), with none of our own changes.

  • The WinAPE choice now gives RASM's own options: & is a hex prefix and expressions work as in Maxam. RASM knows these WinAPE directives itself: BRK, LIST, NOLIST, LET, CHARSET, RELOCATE_START, RELOCATE_END and RELOCATE_TABLE.
  • Our WinAPE additions are gone: BYTE, TEXT, WORD, RMEM, DEFL, END, WRITE, SAVE, CHECKSUM, memory() and RUN address,breakpoint.
  • A BRK label sets a debugger breakpoint.

CRTC fixes

  • VSYNC protection (all CRTCs): the block on a new VSYNC is lifted only when a step of C4 in the VSYNC changes the C4=R7 equality, against the R7 of that moment (ACCC §16.3).
  • CRTC 0, R0=0: while the counters are frozen, the first-line R6 conflict and the display restore at C4=C9=0 do not apply (ACCC §13.2.4).
  • CRTC 0, interlace: the parity of C9 changes at each row end when R9 is odd, with R8 at any value.
  • CRTC 2: an R7 write starts a "ghost" VSYNC only in the HSYNC pulse itself.
  • CRTC 3 and 4: they now share one VSYNC start rule.
  • Late end of HSYNC (ACCC §27.7.2): the number of idle T-states that let the interrupt through is now set for each CRTC (CRTC 0 and 2: 2, CRTC 1: 0, CRTC 3 and 4: never).

Plus (ASIC) fixes

  • PRI (programmable raster interrupt): the ASIC now raises it 1 microsecond after the end of the Gate Array's HSYNC, as ACCC §27.6.1 and §27.6.5 give. The plasma of the demo RE-WIRED now goes to the right edge of the screen.

SYMBiFACE III

  • The ROM table on the SD card (CPC\ROMTABLE\BANKnnn) works with TMTLOGIC's ROM manager SF3-RM.BAS: the ROMs fitted now, read and save a ROM, ROM names, the banks and the start bank.
  • |SROM of the SF3-RSX ROM puts a ROM into a slot at once.

MIDI out

  • macOS: MIDI goes to Apple's software synthesizer.
  • Linux: MIDI goes to an ALSA sequencer port "CPCSyntaxError", connected to the first synthesizer found (for example FluidSynth or TiMidity). The program runs without libasound.