AMSpiriT Lite — Kurzreferenz

AMSpiriT Lite ist ein Linux/Windows-Amstrad-CPC-Emulator, der auf dem AMSpiriT-Kern von David MANUEL basiert.

Steuertasten

Taste	Aktion
`F1`	Diese Hilfe im Browser öffnen
`F2`	PNG-Screenshot im aktuellen Verzeichnis speichern
`F4`	Schnellspeicherung im aktuellen Slot
`Shift`+`F4`	Schnellladung aus dem aktuellen Slot
`F6`	Debugger: Schritt zurück (Rewind, im Pausenmodus und falls verfügbar)
`F7`	Debugger: pausieren, falls aktiv; Einzelschritt (BASIC-Anweisung oder Z80-Befehl), falls pausiert
`F8`	Debugger: Prozedurschritt (Z80 `CALL`/`CALL cc` oder BASIC `GOSUB`; sonst ein einfacher Schritt)
`F9`	Debugger: fortsetzen (nur im Pausenmodus)
`Shift`+`F9`	Turbo-Modus ein-/ausschalten (volle Geschwindigkeit, Audio stumm)
`F10`	Kalt-Reset (Cold Boot)
`Shift`+`F10`	Warm-Reset (Warm Restart)
`F11` (nur SDL)	Monitor-Voreinstellung wählen (Farbe CTM644, Grün GT65, TV, ASIC-Varianten)
`Shift`+`F11`	Bildschirmtypen durchschalten (Farbe, Grünmonitor, ASIC-Varianten)
`Ctrl`+`F11` (nur SDL)	FPS-Anzeige ein-/ausblenden
`Ctrl`+`Shift`+`F11` (nur SDL)	CRTC-Debug-Visualisierungsmodi durchschalten
`F12`	Vollbild / Fenstermodus umschalten
`Shift`+`F12`	Ansicht umschalten: sichtbarer CPC-Bildschirm ↔ vollständiger CRTC-Rahmen
`Ctrl`+`F12`	Debug-Bildschirm umschalten (aktueller Frame ↔ Überlagerung)
`Pause`	Emulation pausieren / fortsetzen
`→` (pausiert)	Um einen Frame vorwärts spulen
`←` / `→` (pausiert, Rewind aktiv)	Rückspul-Verlauf Frame für Frame navigieren
`Alt`+`F4`	Fenster schließen (vom Fenstermanager verwaltet)
`Ctrl`+`1` bis `Ctrl`+`0`	CPC-Ziffernblock 1–0 (für Laptops ohne Ziffernblock)
Mausrad (oben/unten)	Lautstärke anpassen (±10% pro Schritt)
Mittlere Maustaste	Stummschaltung ein-/ausschalten

Hinweis: F6-F9 entsprechen dem Einzelschritt-Debugger der Webseite (--web-server). BASIC- oder Z80-Modus wird automatisch erkannt, je nachdem ob gerade ein BASIC-Programm läuft — es gibt keinen Tab zur Auswahl wie auf der Webseite.

Dateien laden

Ziehen Sie eine Datei auf das Emulatorfenster, um sie zu laden. Das Qt-Frontend hat auch ein Datei-Menü zum Öffnen eines Dateidialogs.

Tipp: Halten Sie Ctrl gedrückt, während Sie eine Datei ablegen, um vor dem Laden einen Kalt-Reset durchzuführen — nützlich, um ein Disk-Image in einem sauberen Maschinenzustand zu starten.

Format	Beschreibung
`.dsk`	Standard-Disk-Image
`.hfe` / `.ipf`	High-Fidelity-Disk-Image (CAPS)
`.cdt`	Kassette (CDT)
`.sna`	Snapshot (gespeicherter Zustand)
`.cpr`	CPC Plus / GX4000 Cartridge — wechselt automatisch zum CPC 6128+-Modell und CRTC-Typ 3

Snapshot-Slots

AMSpiriT Lite verwaltet 4 Schnellspeicher-Slots (1–4) pro Spiel. Slots werden zusammen mit dem ROM/Disk-Image gespeichert und bleiben zwischen Sitzungen erhalten.

Aktion	Taste / Button
Schnellspeicherung im aktuellen Slot	`F4`
Schnellladung aus dem aktuellen Slot	`Shift`+`F4`
Zum nächsten Slot wechseln (pausiert)	Gamepad Start / + Taste
Zum vorherigen Slot wechseln (pausiert)	Gamepad Select / − Taste
In Slot speichern (laufend)	Gamepad Start / + Taste
Aus Slot laden (laufend)	Gamepad Select / − Taste

Im Qt-Frontend sind Snapshot-Slots auch über das Menü Emulation → Snapshots zugänglich.

Rewind / Rückspulen

Die optionale Rewind-Funktion zeichnet einen zirkulären Puffer von CPC-Zustand-Snapshots im RAM während der Ausführung auf. Im pausiert-Modus können Sie vorwärts und rückwärts durch den aufgezeichneten Verlauf navigieren — nützlich zum Debuggen, zum Finden des richtigen Moments für Screenshots oder zum Rückspulen nach einem falschen Zug in einem Spiel.

Aktivieren Sie Rewind beim Start mit --enable-rewind. Im Qt-Frontend verwenden Sie das Menü Emulation → Rewind zum Aktivieren und Anpassen der Einstellungen.

Taste / Aktion	Beschreibung
`←` (pausiert)	Um einen Frame rückwärts im Rewind-Verlauf spulen
`→` (pausiert)	Um einen Frame vorwärts spulen (zur Gegenwart), oder einen normalen Frame, wenn auf dem aktuellen Stand
D-pad ← (Gamepad, pausiert)	In Rewind rückwärts spulen
D-pad → (Gamepad, pausiert)	In Rewind vorwärts spulen / fortsetzen, wenn auf aktuellem Stand

Die Statusleiste / Titel zeigt < N / M während des Rückspulens (N Frames vor dem ältesten, M insgesamt gespeichert).

Speicher: jeder Snapshot belegt ungefähr 1,6 MB. Der Standard-Puffer enthält 100 Snapshots (~160 MB); passen Sie mit --rewind-slots N an.

Turbo-Modus

Der Turbo-Modus deaktiviert die 50-Hz-Kadenz und schaltet das Audio aus, sodass der Emulator mit voller CPU-Geschwindigkeit läuft. Nützlich, um lange Kassettenladezeiten oder Intros zu überspringen.

Drücken Sie Shift+F9, um den Turbo-Modus jederzeit ein- oder auszuschalten.
Bei Start mit --turbo zusammen mit --autotype oder -A stoppt der Turbo automatisch, wenn die automatische Tippsequenz abgeschlossen ist.

Gamepad / Joystick

Das Qt-Frontend nutzt die SDL2 GameController API (XInput unter Windows, evdev unter Linux, GameController auf macOS). Das SDL-Frontend nutzt die Legacy-Joystick-API. Beide erkennen Controller beim Start und bei Verbindung; der erste gefundene Controller wird dem CPC-Joystick-Port 1 zugeordnet.

Taste	Aktion (während der Ausführung)	Aktion (pausiert)
A	Feuer 1	—
B	Feuer 2	—
X	Feuer 3	—
Y / Guide	Pausieren	Fortsetzen
Start / +	Schnellspeicherung im aktuellen Slot	Zum nächsten Slot wechseln
Select / −	Schnellladung aus dem aktuellen Slot	Zum vorherigen Slot wechseln
Linker Stick / D-pad	Richtungen (Oben/Unten/Links/Rechts)	Rewind navigieren (falls aktiv)

SDL-Frontend: nutzt rohe Joystick-Buttonnummern (Taste 0–3 = Feuer 1/2/3/Pause, Taste 7/9 = Start, Taste 6/8 = Select). Die CPC Plus analoge Achse wird auf beiden Frontends unterstützt.

Web-Debug-Server

Der Emulator enthält einen eingebetteten HTTP-Debug-Server (standardmäßig aktiv, gebunden an 127.0.0.1:6128), der eine vollständige Web-Oberfläche im Browser bereitstellt: Z80-Register, Gate Array, PSG, FDC, Speicher-Heatmap, ASIC, Disk, Konfiguration, Scripting und mehr.

amspirit-lite-sdl [--no-web-server] [--web-addr 0.0.0.0] [--web-port 6128] [--web-html Pfad/zur/ui.html]

Option	Beschreibung
`--web-server`	Server aktivieren (standardmäßig aktiv)
`--no-web-server`	Server deaktivieren
`--web-addr <Adresse>`	Bind-Adresse (Standard: `127.0.0.1` — nur lokal; `0.0.0.0` für alle Schnittstellen)
`--web-port <Port>`	Listening-Port (Standard: `6128`)
`--web-html <Datei>`	Pfad zur HTML-UI-Datei (Standard: `amspirit-lite.html` neben der Binärdatei)
`--lua-full-stdlib`	Erlaubt an die Web-API per POST gesendeten Skripten die volle Lua-Stdlib (`io`, `os.execute`, `package`, `debug`). Standardmäßig deaktiviert — solche Skripte laufen in einer Sandbox mit Dateizugriff nur über die abgeschottete `fs.*`-Tabelle. Jede in Ihrem Browser geöffnete Seite kann die API erreichen — aktivieren Sie dies nur auf einem vertrauenswürdigen Rechner.

Die Datei amspirit-lite.html kann ohne Neukompilierung bearbeitet werden. Falls sie fehlt, wird die in der Binärdatei eingebettete UI als Fallback verwendet.

Die Oberfläche ist in Tabs gegliedert: Keyboard, BASIC, Debug (Z80/Disassembly/Breakpoints), ROMs (ROM-Karte), Audio, Heat Map (Speicher), ASIC, Poke, Script, Config, Disk und Settings.

BASIC-Editor

Der BASIC-Tab arbeitet mit Locomotive-BASIC-Programmen:

Einfügen oder Hochladen von Locomotive-BASIC-Quellcode
Einspritzen: tokenisiert und schreibt das Programm direkt in den CPC-RAM unter Adresse 0x0170
Exportieren: liest und detokenisiert das aktuelle BASIC-Programm aus dem RAM
Parameter: ?reset=1 (Kalt-Reset zuerst), ?run=1 (Auto-Typ RUN nach dem Einspritzen)
Maximale Größe: ~44 KB pro CPC-Modell

Tastaturbelegung

Der Keyboard-Tab zeigt das aktuelle Tastatur-Layout und alle zugeordneten Tasten an (Referenz zum Lesen für das Debugging von Tastatureingabeproblemen).

ROM-Karte

Der ROMs-Tab zeigt den aktuellen ROM-Katalog: welche Firmware, welches Erweiterungs-ROM (R<n>:) und welche Cartridge-Bank in jedem Slot geladen ist, und woher sie stammt. Er bietet eine Kompaktansicht und eine Ansicht pro Slot.

Snapshot-Slots werden nicht über die Web-Oberfläche verwaltet — verwenden Sie F4 / Shift+F4 oder das Qt-Menü Emulation → Snapshots.

Befehlszeilenoptionen

amspirit-lite-sdl [OPTIONEN] [DATEI]

Emulation

Option	Beschreibung
`-m <Modell>`	CPC-Modell: `464`, `664`, `6128` (Standard), `6128+`, `464+`, `GX4000`
`-c <Typ>`	CRTC-Typ (0 bis 4)
`--ram <Ko>`	Gesamt-RAM in Ko: 128 (Standard), 192, 320, 576
`-R <Pfad>` / `--rom-path <Pfad>`	ROMs-Verzeichnis
`-C <Pfad>` / `--config <Pfad>`	Konfigurationsverzeichnis
`-l <Sprache>` / `--lang <Sprache>`	ROM-Sprache (setzt das `CPC_COUNTRY` des Kerns): FR (Standard), EN, SP, DA
`--lang-ui <Sprache>`	Web-/UI-Sprache: en (Standard), fr, es, de (automatisch erkannt aus `$LANG`)
`-k <Layout>` / `--keyboard <Layout>`	Host-Tastatur-Layout: fr (Standard), uk, us
`--keymap <Datei>`	Eine benutzerdefinierte Tastaturbelegungsdatei laden
`-F` / `--fullscreen`	Im Vollbildmodus starten
`-w` / `--windowed`	Fenstermodus (überschreibt `--fullscreen`)
`--zoom <N>`	Anfänglicher Fenster-Zoomfaktor (1=768×542, 2=1536×1084, …); Standard 2 mit automatischem Fallback auf 1
`--size <BxH>`	Anfängliche Fenstergröße, z. B. `1280x960`
`-Z` / `--turbo`	Im Turbo-Modus starten (volle Geschwindigkeit)
`--monitor <Voreinstellung>`	CRT-Monitor-Voreinstellung: off (Standard), ctm644, gt65, tv
`--reset`	Gespeicherte Konfiguration ignorieren, mit Standardwerten starten
`--no-splash` / `--splash`	Startbildschirm überspringen / erzwingen (`--splash` überschreibt `--no-splash` aus der Konfiguration)

Automatisches Laden und Tippen

Option	Beschreibung
`-A` / `--autorun[=DATEI]`	Startet die Boot-Disk automatisch: errät das passende `RUN"<Datei>`/`\|CPM`, oder erzwingt einen Dateinamen mit `--autorun=DATEI`
`-T <Name>` / `--run <Name>`	Tippt automatisch `RUN"<Name>` beim Start
`-t <Text>` / `--autotype <Text>`	Tippt eine wörtliche Zeichenkette nach dem Start in den CPC (`\n` = Enter)
`--autotype-file <Datei>`	Tippt den Inhalt einer Textdatei nach dem Start in den CPC

Audio und Anzeige

Option	Beschreibung
`-L <ms>` / `--audio-latency <ms>`	Audio-Puffer-Latenz in Millisekunden (Standard: 80 — erhöhen bei Audioknistern)
`--audio-device <Name>`	Name des Audio-Ausgabegeräts (Standard: System-Standard)
`--show-overlay`	FPS-Anzeige in der oberen linken Ecke einblenden (rot = zu langsam, blau = zu schnell)

Scripting

Option	Beschreibung
`--script <Datei>`	Ein CSL- oder Lua-Skript ausführen (volle Stdlib — `--script` ist ein lokaler, vertrauenswürdiger Ladevorgang, im Gegensatz zu an die Web-API gesendeten Skripten)
`--ssm`	SSM-Modus aktivieren: reagiert auf die Z80-Opcodes `ED FE`/`FF`/`00`
`--ssm-both`	Mit `--ssm`: bei `ED FE` oder `ED FF` sowohl einen Snapshot als auch einen Screenshot speichern
`--debug-script`	Jede ausgeführte CSL/Lua-Zeile während des Skriptlaufs protokollieren

Rewind / Rückspulen

Option	Beschreibung
`--enable-rewind`	Rückspul-Puffer im RAM aktivieren (nimmt alle N Frames einen Snapshot auf)
`--rewind-interval <N>`	Frames zwischen Rewind-Snapshots (Standard: 10)
`--rewind-slots <N>`	Maximale Anzahl von Snapshots im Puffer (Standard: 100, ~160 MB)

Web-Debug-Server

Option	Beschreibung
`--web-server`	Eingebetteten HTTP-Debug-Server aktivieren (standardmäßig aktiv)
`--no-web-server`	Server deaktivieren
`--web-addr <Adresse>`	Bind-Adresse (Standard: `127.0.0.1`)
`--web-port <Port>`	Listening-Port (Standard: `6128`)
`--web-html <Datei>`	Pfad zur Debug-UI-HTML-Datei
`--lua-full-stdlib`	Erlaubt an die Web-API gesendeten Skripten die volle Lua-Stdlib statt der Sandbox (siehe Abschnitt Web-Debug-Server)

Binärdateien

Option	Beschreibung
`--bin-address <Adresse>`	Ladeadresse für eine rohe/kopflose `.bin`-Datei (z. B. `4000`, `B04:2000` — ein einzelner Wert bezieht sich auf die 64K-Basis); wird bei AMSDOS-Header-Dateien ignoriert und von der Dateinamenskonvention `name@adresse.bin` überschrieben
`--bin-entry <Adresse>`	Einsprungpunkt nach dem Laden einer rohen `.bin`-Datei (flache 16-Bit-Adresse); impliziert sofortige Ausführung

Diagnose und Sonstiges

Option	Beschreibung
`-v` / `--verbose`, `-q` / `--quiet`	Log-Ausführlichkeit erhöhen oder unterdrücken
`-K` / `--debug-keys`	Ausführliche Tastatur-Debug-Ausgabe aktivieren
`-J` / `--debug-joystick`	Ausführliche Joystick-Debug-Ausgabe aktivieren
`--debug-rewind`	Rewind-Speichern/-Abrufen mit Slot-Index und Verlaufsgröße protokollieren
`--debug-webapi`	Eingehende Web-API-Anfragen, Antworten und SSE-Ereignisse protokollieren
`--debug-audio`	Audio-Statistiken (Unterlauf/verworfene Bytes) jede Sekunde protokollieren
`--dump-keymap[=DATEI]`	Aktuelles Keymap nach `DATEI` exportieren (Standard: `keymap-sdl.cfg`) und beenden
`-X <N>` / `--autoExit <N>`	Nach N Frames der 50-Hz-Schleife automatisch beenden (pausierte Frames zählen mit) — für automatisierte Tests
`--save-log <Datei>`	Gesamte Log-Ausgabe in `<Datei>` speichern
`--report[=Pfad]`	Einen Diagnosebericht erstellen
`--update-url <URL>`	Update-Manifest-Endpunkt überschreiben (Tests)

Tastenbelegung konfigurieren (keymap.cfg)

Generieren Sie eine Keymap-Datei mit der Option --dump-keymap, bearbeiten Sie sie nach Ihren Wünschen und starten Sie den Emulator neu:

amspirit-lite-sdl --dump-keymap=keymap.cfg

(Ohne Dateiname schreibt --dump-keymap keymap-sdl.cfg in das aktuelle Verzeichnis.)

Platzieren Sie die generierte keymap.cfg-Datei in Ihrem Verzeichnis ROMs/ oder config/ (oder verweisen Sie --keymap direkt darauf). Die Datei verwendet INI-Format mit zwei Abschnitten: [keyboard layout] und [emulator hotkeys].

Unterstützte Tastenkombinationsaktionen: PAUSE, MUTE, HELP, SCREENSHOT, SNAPSHOT_SAVE, SNAPSHOT_LOAD, VOLUME_UP, VOLUME_DOWN, TURBO, HARD_RESET, SOFT_RESET, FULLSCREEN, FULL_FRAME, CYCLE_SCREEN, CYCLE_DEBUG_SCREEN, TOGGLE_OVERLAY, CYCLE_CRTC, CYCLE_MONITOR, FRAME_STEP, DEBUG_STEP, DEBUG_STEP_OVER, DEBUG_RESUME, DEBUG_STEP_BACK, DEBUG_CLEAR_BREAKPOINTS, OPEN_FILE, QUIT

Tastaturformat: Einzelne Taste (F1, A, Escape, Return, Space) oder Modifizierer (Ctrl+X, Shift+F1, Alt+Shift+P). Groß-/Kleinschreibung wird ignoriert.

Änderungen werden beim Neustart wirksam. Um den Code einer Taste zu finden, starten Sie den Emulator mit -K und suchen Sie nach DOWN-Meldungen in der Konsole. Hinweis: SDL- und Qt-Anwendungen verwenden unterschiedliche Tastencodes; verwenden Sie separate Keymap-Dateien für jede, wenn Sie beide ausführen.

AMSpiriT-Kern von David MANUEL — Linux-Port von Siko — amspirit.fr