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

KL EVENT

&BCF2

Einen Ereignisblock 'anstupsen'.

Original (SOFT 968): „'Kick' an event block.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

  • Der Ereignismechanismus sorgt dafür, dass eine Ereignisroutine als Reaktion auf jedes 'Anstupsen' eines Ereignisblocks aufgerufen wird. KL EVENT führt das 'Anstupsen' durch.

🧮 Register auf einen Blick

EingabeHL
Ausgabekeine
verändertAFBCDEHL

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

➡️ Einsprungbedingungen

  • HL enthält die Adresse des Ereignisblocks.

⬅️ Rücksprungbedingungen

  • AF, BC, DE und HL verändert.
  • Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

  • Anders als die überwiegende Mehrheit der Kernel-Routinen kann diese Routine aus dem Interrupt-Pfad aufgerufen werden. Da die LOW JUMP-Anweisung im Haupt-Firmware-Jumpblock Interrupts aktiviert, kann der Benutzer den Adressteil der 'niedrigen Adresse' aus dem Jumpblock entnehmen und die oberen zwei Bits maskieren, um die Adresse im unteren ROM von
  • KL EVENT zu extrahieren. Der folgende Code macht dies:
  • LD DE,(KL_EVENT+1) ;Adresse von LOW JUMP extrahieren RES 7,D ;oberen ROM-Zustand aus 'niedriger Adresse' entfernen RES 6,D ;unteren ROM-Zustand aus 'niedriger Adresse' entfernen CALL PCDE_INSTRUCTION ;KL EVENT aufrufen
  • (Wenn der Benutzer diese Operation wiederholt durchführen möchte, wird empfohlen, die Adresse einmal zu extrahieren und irgendwo zu speichern).
  • Die Wirkung des 'Anstupsens' hängt vom Ereigniszähler im Ereignisblock ab:
  • Zähler < 0: Das Ereignis ist entschärft, und ein Anstupsen hat keine Wirkung.
  • Zähler > 0: Es gibt weitere ausstehende Anstupser und das Ereignis wird verarbeitet. Dieses Anstupsen erhöht einfach den Zähler (es sei denn, er hat bereits das Maximum von 127 erreicht). Sobald die Ereignisverarbeitung begonnen hat, läuft sie weiter, bis der Zähler null wird oder das Ereignis entschärft wird.
  • Zähler = 0: Das Ereignis ist scharfgeschaltet, aber die Ereignisverarbeitung ist nicht aktiv.
  • Wie die Ereignisverarbeitung eingeleitet wird, hängt von der Ereignisklasse ab.
  • Synchrone Ereignisse.
  • Synchrone Ereignisse werden in Prioritätsreihenfolge zur synchronen Ereigniswarteschlange hinzugefügt. Es liegt in der Verantwortung des Vordergrundprogramms, die synchrone Ereigniswarteschlange regelmäßig zu verarbeiten.
  • Synchrone Ereignisroutinen werden aufgerufen, wenn das Vordergrundprogramm KL DO SYNC aufruft; der Ereigniszähler wird dann behandelt, wenn KL DONE SYNC aufgerufen wird.
  • Asynchrone Ereignisse.
  • a. Nicht im Interrupt-Pfad
  • Die Ereignisroutine wird sofort aufgerufen. Wenn die Routine zurückkehrt und der Ereigniszähler größer als null ist, wird er dekrementiert. Wenn der Zähler noch größer als null ist, wird der Vorgang wiederholt.
  • b. Im Unterbrechungspfad – Normales Asynchrones Ereignis
  • Das Ereignis wird in die Warteschlange der ausstehenden Unterbrechungsereignisse eingereiht. Beim Verlassen des Unterbrechungspfads verarbeitet der Kernel alle Ereignisse in der Warteschlange der ausstehenden Unterbrechungen wie unter (a) oben beschrieben. Das bedeutet, dass die normalen asynchronen Ereignisroutinen in einer Erweiterung der normalen (Nicht-Unterbrechungs-)Verarbeitung zwischen Unterbrechungsrückkehr und Hauptprogramm aufgerufen werden. Die Routine unterliegt daher nicht den Einschränkungen, die für Routinen im Unterbrechungspfad gelten.
  • c. Im Unterbrechungspfad – Express Asynchrones Ereignis
  • Die Ereignisroutine wird sofort im Unterbrechungspfad aufgerufen. Die Routine muss sich an einer 'nahen Adresse' befinden (siehe KL INIT EVENT). Unter keinen Umständen darf die Routine Unterbrechungen aktivieren.
  • KL EVENT aktiviert Unterbrechungen, es sei denn, es wird aus dem Unterbrechungspfad aufgerufen.

🧪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

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