Hauptsprungleiste⌨️ Key Manager (Tastatur)Eintrag Nr. 5CPC 464/664/6128

KM SET EXPAND

&BB0F

Eine Erweiterungszeichenkette setzen.

Original (SOFT 968): „Set an expansion string.“

🔀Wie der Aufruf die Routine erreicht

Dein Programm            RAM-Sprungleiste            Low Kernel (RAM/ROM)        unteres ROM
─────────────            ────────────────            ────────────────────        ───────────
CALL &BB0F  ───────▶  &BB0F: RST 1 ─────────▶  &0008 LOW JUMP:           KM SET EXPAND
                         DW Low Address            ROM-Zustand merken,  ───▶  (Routine)
                         (Bit 15 = oberes ROM aus)  unteres ROM an                  │
     ◀──────────────────────────────────────────  ROM-Zustand zurück  ◀──── RET ──┘

📖Beschreibung

⚙️ Wirkung

  • Die einer Erweiterungsmarke zugehörige Erweiterungszeichenkette setzen.

🧮 Register auf einen Blick

EingabeBCHL
AusgabeCarry
verändertABCDEFHL

Automatisch aus den Bedingungen abgeleitet – bei Fallunterscheidungen („wenn … dann“) gilt der Volltext unten.

➡️ Einsprungbedingungen

  • B enthält die Erweiterungsmarke für die zu setzende Erweiterung.
  • C enthält die Länge der Zeichenkette.
  • HL enthält die Adresse der Zeichenkette.

⬅️ Rücksprungbedingungen

  • Wenn die Erweiterung in Ordnung ist:
  • Carry gesetzt.
  • Wenn die Zeichenkette zu lang war oder die Marke ungültig war:
  • Carry gelöscht.
  • Immer:
  • A, BC, DE, HL und andere Flags verändert.
  • Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

  • Die zu setzende Zeichenkette kann sich irgendwo im RAM befinden. Erweiterungszeichenketten können nicht direkt aus dem ROM gesetzt werden.
  • Die Zeichen in der Zeichenkette werden nicht erweitert (oder anderweitig behandelt). Es ist daher möglich, jedes beliebige Zeichen in eine Erweiterungszeichenkette einzufügen.
  • Wenn im Erweiterungspuffer nicht genügend Platz für die neue Zeichenkette vorhanden ist, wird keine Änderung an den Erweiterungen vorgenommen.
  • Wenn die gesetzte Zeichenkette gerade zur Zeichenerzeugung verwendet wird (durch KM READ CHAR oder KM WAIT CHAR), wird der ungelesene Teil der Zeichenkette verworfen. Das nächste Zeichen wird aus dem Tastenpuffer gelesen.
  • Diese Routine aktiviert Interrupts.

🧪Beispielprogramm – ausführen, ändern, Schritt für Schritt

Das Programm liegt bei &4000 und würde auf dem echten CPC mit CALL &4000 aus BASIC gestartet. Hier läuft es im Z80-Emulator; die Firmware ist nachgebildet.
bereit
🐞 Im großen Debugger öffnen
0
1
2
3
Rand
Modus 1 · Basis &C000 · Versatz &0000
Tastenpuffer: leer
Gedrückt gehaltene Tasten (für KM TEST KEY / KM GET JOYSTICK) per Klick umschalten; die Zahl ist die Tastennummer.
Register & Flags
AF
&FFFF
BC
&0000
DE
&0000
HL
&0000
IX
&FFFF
IY
&FFFF
SP
&C000
PC
&0000
S
1
Z
1
Y
1
H
1
X
1
P/V
1
N
1
C
1
Z80-Takte: 0 TCPC-Zeit: 0 µsROMs: unten aus, oben ausRAM-Konfig: &C0
Nächste Befehle (Disassembler)
0000HLE ▸ RESET ENTRY
0002RET
0003NOP
0004NOP
0005NOP
0006NOP
0007NOP
0008HLE ▸ LOW JUMP
Firmware
Firmware jetzt
▶ RESET ENTRY · Details
Letzte Falle: –
Letzte Firmware-Aufrufe
noch keine
Weitere Anzeigen: Speicher, Stapel, Ton, Dateien, Drucker, Kernel
Speicher
400000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
401000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
402000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
403000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
404000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
405000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
406000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
407000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ················
PCSP(HL)(DE)Leseansicht mit aktueller ROM-/Bank-Einblendung
Stapel
C0000000← SP
C0020000
C0040000
C0060000
C0080000
C00A0000
C00C0000
C00E0000
Ton (Sound Manager)
Kanal A
still
4 von 4 Plätzen frei
Kanal B
still
4 von 4 Plätzen frei
Kanal C
still
4 von 4 Plätzen frei
Dateien (simuliertes Laufwerk)
DateiTypLängeLaden
HALLO.TXTASCII33–
ZAHLEN.BINbinär6&5000
MUSTER.DATbinär16&6000
Eingabe: keine · Ausgabe: keine
Drucker
(noch nichts gedruckt)
Kernel: Zeit & Ereignisse
Zeit (KL TIME PLEASE): 0 × 1/300 s = 0.00 s · Interrupts: 0
keine Ereignisblöcke angemeldet

🔗Verwandte Einträge

KM GET EXPAND &BB12KM READ CHAR &BB09KM WAIT CHAR &BB06
💡 Quellen
Amstrad SOFT 968 „CPC 464/664/6128 Firmware“, Abschnitt 15 (Beschreibung, übersetzt); Adresse und Name abgeglichen mit Taylor/Defoe „The Amstrad CPC Firmware Guide“. Simulation: eigene Nachbildung (HLE) – Laufzeiten der Firmware selbst werden nicht nachgebildet.
← KM CHAR RETURN &BB0CKM GET EXPAND &BB12 →