Hauptsprungleiste💾 Cassette Manager / AMSDOSEintrag Nr. 129CPC 464/664/6128

CAS IN DIRECT

&BC83

Die Eingabedatei in den Speicher lesen.

Original (SOFT 968): „Read the input file into store.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

Die Eingabedatei direkt in einem Durchgang in den Speicher lesen, anstatt Zeichen für Zeichen.

🧮 Register auf einen Blick

EingabeHL

AusgabeCarryHLZero

verändertABCDEFHLIX

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

➡️ Einsprungbedingungen

HL enthält die Adresse, an die die Datei gelegt werden soll (beliebig im RAM).

⬅️ Rücksprungbedingungen

Wenn die Datei erfolgreich gelesen wurde:
Carry gesetzt.
Zero gelöscht.
HL enthält die Einstiegsadresse (aus dem Header).
A verändert.
Wenn die Datei nicht wie erwartet geöffnet ist:
Carry gelöscht.
Zero gelöscht.
In V1.1: A enthält eine Fehlernummer (#0E).
In V1.0: A verändert.
HL 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.
HL verändert.
Immer:
BC, DE, IX und andere Flags verändert.
Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

Diese Routine kann zwei Fehlernummern zurückgeben:
#00: Der Benutzer hat Escape gedrückt.
#0E: Der Stream ist nicht zum direkten Lesen geöffnet oder der Benutzer hat zuvor Escape gedrückt. Der Lesestream muss neu geöffnet werden (durch CAS IN OPEN). Wenn der Stream für Zeichenzugriff verwendet wurde (durch Aufruf von CAS IN CHAR), dann ist es nicht möglich, die Datei direkt zu lesen. Es ist ebenso wenig möglich, mehr als einmal direkt aus der Datei zu lesen. Dies wird lediglich verändert die Kopie der gelesenen Datei.
Der Puffer der gelesenen Daten, als der Stream geöffnet wurde, wird an seine korrekte Position kopiert und der Rest der Datei (falls vorhanden) wird ebenfalls in den Speicher gelesen.
Verwandte Einträge: CAS IN DIRECT (DISC)
CAS IN CHAR CAS IN OPEN
CAS IN CLOSE CAS OUT DIRECT

💾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

Die Eingabedatei direkt in den Speicher lesen, und zwar auf einmal statt Zeichen für Zeichen.

🧮 Register auf einen Blick

EingabeHL

AusgabeACarryHLZero

verändertABCDEFHLIX

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

➡️ Einsprungbedingungen

HL enthält die Adresse, an die die Datei gelegt werden soll (überall im RAM).

⬅️ Rücksprungbedingungen

Wenn die Datei erfolgreich gelesen wurde:
Carry gesetzt.
Zero gelöscht.
HL enthält die Einstiegsadresse (aus dem Header).
A verändert.
Wenn der Stream nicht wie erwartet geöffnet ist:
Carry gelöscht.
Zero gelöscht.
A enthält eine Fehlernummer (#0E).
HL verändert.
Wenn das Lesen aus einem anderen Grund fehlgeschlagen ist:
Carry gelöscht.
Zero gesetzt.
A enthält eine Fehlernummer.
HL verändert.
Immer:
BC, DE, IX und andere Flags verändert.
Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

Der Lesestream muss neu geöffnet werden (durch CAS IN OPEN). Wenn der Stream für Zeichenzugriff verwendet wurde (durch Aufruf von CAS IN CHAR oder CAS TEST EOF), dann ist es nicht möglich, die Datei direkt zu lesen. Es ist ebenso wenig möglich, mehr als einmal direkt aus der Datei zu lesen. (Jeder Versuch, dies zu tun, wird verändert die Kopie der gelesenen Datei.)
Wenn die Datei einen Header hat, dann ist die Anzahl der gelesenen Bytes diejenige, die im 24-Bit-Dateilängenfeld aufgezeichnet ist (Bytes 64..66 des Disc-Datei-Headers). Wenn kein Header vorhanden ist, wird die Datei bis zum harten Dateiende gelesen.
Das CP/M-Dateiendezeichen #1A wird nicht als Dateiende behandelt.

🧪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

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

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

← CAS IN CHAR &BC80 CAS RETURN &BC86 →