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

KM READ KEY

&BB1B

Prüfen, ob eine Taste von der Tastatur verfügbar ist.

Original (SOFT 968): „Test if a key is available from the keyboard.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

Versuchen, eine Taste aus dem Tastenpuffer zu erhalten. Diese Routine wartet nicht, wenn nicht sofort eine Taste verfügbar ist.

🧮 Register auf einen Blick

Eingabekeine

AusgabeACarry

verändertAF

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

➡️ Einsprungbedingungen

Keine Bedingungen.

⬅️ Rücksprungbedingungen

Wenn eine Taste verfügbar war:
Carry gesetzt.
A enthält das Zeichen oder das Erweiterungs-Token.
Wenn keine Taste verfügbar war:
Carry gelöscht.
A verändert.
Immer:
Andere Flags verändert.
Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

Die nächste Taste wird aus dem Tastenpuffer gelesen und unter Verwendung der entsprechenden Tastenübersetzungstabelle übersetzt. Erweiterungs-Token werden nicht erweitert, sondern zur Behandlung durch den Benutzer ausgegeben, ebenso wie normale Zeichen. Andere Key Manager-Token (Shift Lock, Caps Lock und Ignorieren) werden befolgt, aber nicht ausgegeben.
🔀Diese Routine gibt immer eine Taste zurück, wenn eine verfügbar ist. Es ist daher möglich, den Tastenpuffer zu leeren, indem KM READ KEY wiederholt aufgerufen wird, bis es angibt, dass keine Taste verfügbar ist. Beachten Sie jedoch, dass das 'Zurücklegen'-Zeichen oder eine teilweise gelesene Erweiterungszeichenkette ignoriert wird. Es ist ratsam, KM READ CHAR zu verwenden, um diese beim Leeren der Key Manager-Puffer herauszuspülen, oder, in der V1.1-Firmware, KM FLUSH aufzurufen.

🔀 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

; KM READ KEY (&BB1B) – Beispiel für VisualZ80
; Aufruf aus BASIC: CALL &4000
        org &4000
        call &bb1b      ; KM READ KEY: nicht wartend
        jr nc,keine
        push af
        ld hl,t_taste
        call text
        pop af
        call hex8
        call crlf
        ret
keine:  ld hl,leer
        jp text
t_taste: db "Taste: &",0
leer:   db "Keine Taste",13,10,0
; --- Hilfsroutinen (Ausgabe über die Firmware) ---
crlf:   ld a,13         ; Zeilenumbruch (CR + LF)
        call &bb5a
        ld a,10
        jp &bb5a
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

KM FLUSH &BD3D KM READ CHAR &BB09 KM WAIT KEY &BB18

💡 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 WAIT KEY &BB18 KM TEST KEY &BB1E →