Hauptsprungleiste🔤 Text VDUEintrag Nr. 59CPC 464/664/6128

TXT GET CONTROLS

&BBB1

Adresse der Steuercodetabelle abrufen.

Original (SOFT 968): „Fetch address of control code table.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

Die Adresse der Steuercodetabelle abrufen.

🧮 Register auf einen Blick

Eingabekeine

AusgabeHL

verändertkeine

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

➡️ Einsprungbedingungen

Keine Bedingungen.

⬅️ Rücksprungbedingungen

HL enthält die Adresse der Steuercodetabelle.
Alle anderen Register und Flags bleiben erhalten.

📝 Hinweise aus dem Handbuch

Alle Streams teilen sich eine Steuercodetabelle, sodass Änderungen an der Tabelle alle Streams betreffen.
Die Steuercodetabelle hat einen 3-Byte-Eintrag für jeden Steuercode. Die Einträge werden in aufsteigender Reihenfolge gespeichert, sodass der Eintrag für #00 der erste und der für #1F der letzte ist. Das erste Byte jedes Eintrags ist die Anzahl der Parameter, die der Steuercode benötigt; die anderen beiden Bytes sind die Adresse der Routine, die aufgerufen werden soll, um den Steuercode zu verarbeiten, wenn alle seine Parameter empfangen wurden. Die Routine muss sich in den zentralen 32K des RAM befinden und folgende Schnittstelle einhalten:
Eintritt:
A enthält das zuletzt zum Puffer hinzugefügte Zeichen.
B enthält die Länge des Puffers (einschließlich des Steuercodes).
C enthält dasselbe wie A.
HL enthält die Adresse des Steuercodepuffers (zeigt auf den Steuercode).
Austritt:
AF, BC, DE, HL verändert.
Alle anderen Register bleiben erhalten.
Da der Steuerpuffer nur Platz für 9 Parameterzeichen hat, sollte die Anzahl der benötigten Parameter auf 9 oder weniger begrenzt werden.
Die Steuercodetabelle wird auf ihre Standardroutinen zurückgesetzt, wenn TXT RESET aufgerufen wird.
🔀In der Firmware V1.1 gibt das erste Byte jedes Eintrags außerdem an, ob der Steuercode deaktiviert werden soll, wenn der VDU deaktiviert ist, oder ob er immer befolgt werden soll. Bit 7 des Bytes ist gesetzt, wenn der Code deaktiviert werden soll.

🔀 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

ℹ️ Die Routinenadressen in der Tabelle sind im Simulator 0 (die Codes werden in TypeScript ausgeführt).

; TXT GET CONTROLS (&BBB1) – Beispiel für VisualZ80
; Aufruf aus BASIC: CALL &4000
        org &4000
        call &bbb1      ; TXT GET CONTROLS: Adresse der Steuercode-Tabelle
        push hl
        ld hl,t
        call text
        pop hl
        push hl
        call hex16
        call crlf
        pop hl
        ld de,3*15      ; Eintrag für Code 15 (SI)
        add hl,de
        ld a,(hl)       ; 1. Byte = Anzahl Parameter
        push af
        ld hl,t2
        call text
        pop af
        call hex8
        ret
t:      db "Tabelle bei &",0
t2:     db "SI braucht Parameter: ",0
; --- Hilfsroutinen (Ausgabe über die Firmware) ---
crlf:   ld a,13         ; Zeilenumbruch (CR + LF)
        call &bb5a
        ld a,10
        jp &bb5a
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

TXT OUTPUT &BB5A

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

← TXT GET M TABLE &BBAE TXT STR SELECT &BBB4 →