Hauptsprungleiste💾 Cassette Manager / AMSDOSEintrag Nr. 128CPC 464/664/6128
CAS IN CHAR
&BC80
Ein Zeichen aus der Eingabedatei lesen.
Original (SOFT 968): „Read a character from the input file.“
🔀Wie der Aufruf die Routine erreicht
Dein Programm RAM-Sprungleiste Low Kernel (RAM/ROM) unteres ROM
───────────── ──────────────── ──────────────────── ───────────
CALL &BC80 ───────▶ &BC80: RST 1 ─────────▶ &0008 LOW JUMP: CAS IN CHAR
DW Low Address ROM-Zustand merken, ───▶ (Routine)
(Bit 15 = oberes ROM aus) unteres ROM an │
◀────────────────────────────────────────── ROM-Zustand zurück ◀──── RET ──┘📖Beschreibung
⚙️ Wirkung
- Ein Zeichen aus dem Eingabestrom lesen. Holt bei Bedarf Blöcke vom Band.
🧮 Register auf einen Blick
Eingabekeine
AusgabeACarryZero
verändertAFIX
Automatisch aus den Bedingungen abgeleitet – bei Fallunterscheidungen („wenn … dann“) gilt der Volltext unten.
➡️ Einsprungbedingungen
- Keine Bedingungen.
⬅️ Rücksprungbedingungen
- Wenn das Zeichen ordnungsgemäß gelesen wurde:
- Carry gesetzt.
- Zero gelöscht.
- A enthält das aus der Datei gelesene Zeichen.
- Wenn das Ende der Datei erreicht wurde:
- Carry gelöscht.
- Zero gelöscht.
- In V1.1: A enthält eine Fehlernummer (#0E oder #0F).
- In V1.0: A verändert.
- Wenn der Benutzer Escape gedrückt hat:
- Carry gelöscht.
- Zero gesetzt.
- In V1.1: A enthält eine Fehlernummer (#00).
- In V1.0: A verändert.
- Immer:
- IX und andere Flags verändert.
- Alle anderen Register bleiben erhalten.
📝 Hinweise aus dem Handbuch
- Diese Routine kann drei Fehlernummern zurückgeben:
- #00: Der Benutzer hat Escape gedrückt.
- #0E: Der Stream ist nicht zum Lesen von Zeichen geöffnet oder der Benutzer hat zuvor Escape gedrückt.
- #0F: Das Ende der Datei wurde erreicht.
- Sobald das erste Zeichen aus einer Datei gelesen wurde, kann sie nur noch für den zeichenweisen Zugriff verwendet werden. Es ist nicht möglich, zum direkten Lesen (durch CAS IN DIRECT) zu wechseln.
💾Variante mit AMSDOS (Diskette, CPC 664/6128)
Auf dem 664 und 6128 lenkt AMSDOS diesen Kassetten-Einsprung auf das Diskettenlaufwerk um (mit |TAPE zurück auf Kassette). Das Handbuch beschreibt die Diskettenfassung getrennt:
⚙️ Wirkung
- Ein Zeichen aus dem Eingabestream lesen.
🧮 Register auf einen Blick
Eingabekeine
AusgabeACarryZero
verändertFIX
Automatisch aus den Bedingungen abgeleitet – bei Fallunterscheidungen („wenn … dann“) gilt der Volltext unten.
➡️ Einsprungbedingungen
- Keine Bedingungen.
⬅️ Rücksprungbedingungen
- Wenn das Zeichen erfolgreich gelesen wurde:
- Carry gesetzt.
- Zero gelöscht.
- A enthält das aus der Datei gelesene Zeichen.
- Wenn das Ende der Datei erreicht wurde oder der Stream nicht wie erwartet geöffnet ist:
- Carry gelöscht.
- Zero gelöscht.
- A enthält eine Fehlernummer (#0E, #0F oder #1A).
- Wenn aus einem anderen Grund fehlgeschlagen:
- Carry gelöscht.
- Zero gesetzt.
- A enthält eine Fehlernummer.
- Immer:
- IX und andere Flags verändert.
- Alle anderen Register bleiben erhalten.
📝 Hinweise aus dem Handbuch
- Sobald das Zeichen aus einer Datei gelesen wurde, darf der Rest der Datei nur noch zeichenweise gelesen werden (mit CAS IN CHAR). Es ist unmöglich, zum direkten Lesen (durch CAS IN DIRECT) zu wechseln.
- Das CP/M-Dateiendezeichen (#1A) wird als Dateiende behandelt (Carry falsch, Zero falsch). Es ist jedoch möglich, weiter Zeichen zu lesen bis zum harten Dateiende. Die zurückgegebene Fehlernummer wird auf #1A für das weiche (CP/M-)Dateiende und auf #0F für das harte Dateiende gesetzt. Die Aktion zum Erkennen des weichen Dateiendes wird von der entsprechenden Kassettenversion der Routine nicht durchgeführt und gibt niemals #1A zurück, wenn Carry falsch ist.
- Wenn eine Datei mit Binärdaten mit dieser Routine gelesen wird, ist es notwendig, das weiche Dateiende zu erkennen und zu ignorieren.
🧪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.0
1
2
3
Rand
Modus 1 · Basis &C000 · Versatz &0000Tastenpuffer: 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)
0000ED FEHLE ▸ RESET ENTRY
0002C9RET
000300NOP
000400NOP
000500NOP
000600NOP
000700NOP
0008ED FEHLE ▸ LOW JUMP
Firmware
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
💡 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.