Hauptsprungleiste🧠 KernelEintrag Nr. 156CPC 464/664/6128

KL FIND COMMAND

&BCD4

Suche nach einem RSX, Hintergrund-ROM oder Vordergrund-ROM zur Verarbeitung eines Befehls.

Original (SOFT 968): „Search for an RSX, background ROM or foreground ROM to process a command.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

Alle Erweiterungs-ROMs und RSXs haben Befehlstabellen derselben Form. Diese Routine durchsucht alle RSXs und Hintergrund-ROMs in der Liste der externen Befehlsserver des Kernel nach einer Übereinstimmung mit dem gegebenen Befehlsnamen. Wenn der Name gefunden wird, wird die 'Far-Adresse' der zugehörigen Routine zurückgegeben. Wenn der Befehl kein Hintergrund- oder RSX-Befehl ist, werden alle auffindbaren Vordergrund-ROMs nach einem Vordergrundprogramm mit dem gegebenen Namen durchsucht. Wenn ein Vordergrundprogramm gefunden wird, geht das System sofort in dieses über.

🧮 Register auf einen Blick

EingabeHL

AusgabeCCarryHL

verändertABCDEHL

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

➡️ Einsprungbedingungen

HL enthält die Adresse des zu suchenden Befehlsnamens.

⬅️ Rücksprungbedingungen

Wenn ein RSX- oder Hintergrund-ROM-Befehl gefunden wurde:
Carry gesetzt.
C enthält die ROM-Auswahladresse.
HL enthält die Adresse der Routine.
Wenn der Befehl nicht gefunden wurde:
Carry gelöscht.
C und HL verändert.
Immer:
A, B und DE verändert.
Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

Der übergebene Befehlsname muss sich im RAM befinden, kann aber unter einem ROM liegen. Der Name kann beliebig viele Zeichen lang sein, aber nur die ersten 16 Zeichen sind von Bedeutung. Alle alphabetischen Zeichen im Namen sollten in Großbuchstaben sein und das letzte Zeichen des Namens sollte Bit 7 gesetzt haben.
Die zurückgegebenen ROM-Auswahl- und Routineadressen sind geeignet für den Aufruf von KL FAR PCHL.
initialisiert (siehe KL ROM WALK, KL INIT BACK und KL LOG EXT). Die Befehlstabellen werden in der umgekehrten Reihenfolge durchsucht, in der die Befehlsserver eingeführt wurden. Somit werden RSXs tendenziell Vorrang vor Hintergrund-ROMs haben, da RSXs im Allgemeinen nach Hintergrund-ROMs initialisiert werden. Hintergrund-ROMs werden normalerweise in umgekehrter Reihenfolge der ROM-Auswahladressen initialisiert, sodass ROMs mit niedrigeren Nummern Vorrang vor höheren haben werden.
Siehe Abschnitt 10.2 für eine Beschreibung des Formats von Erweiterungs-ROM-Befehlstabellen.
Der erste Eintrag in der Befehlsnamens-Tabelle eines Hintergrund-ROMs (derjenige, der mit dem Einschalt-Eintrag verbunden ist) kann als Name des ROMs verwendet werden. KL FIND COMMAND kann daher verwendet werden, um herauszufinden, ob ein bestimmtes Hintergrund-ROM initialisiert wurde.
🔀Bei der Suche nach einem Vordergrundprogramm werden ROMs beginnend mit ROM 0 und aufwärts durchsucht. Die Suche endet, wenn die erste unbenutzte ROM-Adresse größer als 0 in der Firmware V1.0 und größer als 15 in der Firmware V1.1 gefunden wird.
Das integrierte BASIC kann durch Suchen und Aufrufen des Befehls 'BASIC' erreicht werden.
Wenn ein Vordergrund-ROM-Befehl gefunden wird, wird das ROM bedingungslos angesprungen; diese Routine kehrt nie zurück.

🔀 markiert: Unterschiede zwischen Firmware V1.0 (464) und V1.1 (664/6128).

🧪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

; KL FIND COMMAND (&BCD4) – Beispiel für VisualZ80
; Aufruf aus BASIC: CALL &4000
        org &4000
        ld bc,tabelle
        ld hl,arbeit
        call &bcd1      ; RSX anmelden
        ld hl,such
        call &bcd4      ; KL FIND COMMAND
        push hl
        ld hl,t
        call text
        pop hl
        jp hex16        ; Adresse des Sprungleisten-Eintrags
tabelle: dw namen
        jp zwei
namen:  db "ZWE","I"+&80
        db 0
arbeit: ds 4
such:   db "ZWE","I"+&80
zwei:   ret
t:      db "Gefunden bei &",0
; --- Hilfsroutinen (Ausgabe über die Firmware) ---
hex16:  ld a,h          ; HL als vier Hex-Ziffern ausgeben
        call hex8
        ld a,l
        jr hex8
hex8:   push af         ; A als zwei Hex-Ziffern ausgeben
        rrca
        rrca
        rrca
        rrca
        call nibble
        pop af
nibble: and &0f         ; unteres Halbbyte als Ziffer 0-9/A-F
        add a,"0"
        cp "9"+1
        jr c,ziffer
        add a,7
ziffer: jp &bb5a        ; TXT OUTPUT
text:   ld a,(hl)       ; nullterminierten Text ab HL ausgeben
        or a
        ret z
        call &bb5a      ; TXT OUTPUT
        inc hl
        jr text

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.

&FFFF

&0000

&FFFF

&C000

&0000

P/V

Z80-Takte: 0 TCPC-Zeit: 0 µsROMs: unten aus, oben ausRAM-Konfig: &C0

Nächste Befehle (Disassembler)

0000ED FEHLE ▸ RESET ENTRY

0002C9RET

000300NOP

000400NOP

000500NOP

000600NOP

000700NOP

0008ED FEHLE ▸ 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)

Datei	Typ	Länge	Laden
HALLO.TXT	ASCII	33	–
ZAHLEN.BIN	binär	6	&5000
MUSTER.DAT	binär	16	&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

KL INIT BACK &BCCE KL LOG EXT &BCD1 KL ROM WALK &BCCB MC START PROGRAM &BD16

💡 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.

← KL LOG EXT &BCD1 KL NEW FRAME FLY &BCD7 →