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

CAS READ

&BCA1

Einen Datensatz vom Band lesen.

Original (SOFT 968): „Read a record from tape.“

🔀Wie der Aufruf die Routine erreicht

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

📖Beschreibung

⚙️ Wirkung

  • Einen ganzen Datensatz von der Kassette lesen. Diese Routine wird von den übergeordneten Routinen (CAS IN CHAR, CAS IN DIRECT und CAS CATALOG unter anderem) verwendet, um die Kopf- und Datensätze zu lesen, aus denen eine Datei besteht.

🧮 Register auf einen Blick

EingabeADEHL
AusgabeACarry
verändertABCDEFHLIX

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

➡️ Einsprungbedingungen

  • HL enthält die Adresse, an die die gelesenen Daten gelegt werden sollen.
  • DE enthält die Länge der zu lesenden Daten.
  • A enthält das am Ende des Leaders erwartete Synchronisationszeichen.

⬅️ Rücksprungbedingungen

  • Wenn der Datensatz erfolgreich gelesen wurde:
  • Carry gesetzt.
  • A verändert.
  • Wenn ein Fehler aufgetreten ist oder der Benutzer Escape gedrückt hat:
  • Carry gelöscht.
  • A enthält einen Fehlercode.
  • Immer:
  • BC, DE, HL, IX und andere Flags verändert.
  • Alle anderen Register bleiben erhalten.

📝 Hinweise aus dem Handbuch

  • Eine Datenlänge von 0, die an diese Routine übergeben wird, wird als 65536 Bytes interpretiert. (Dies ist nicht nützlich).
  • Es ist nicht notwendig, einen ganzen Datensatz vom Band zu lesen. Wenn die übergebene Länge kleiner als die tatsächliche Länge des Datensatzes ist, werden nur die entsprechenden Bytes gelesen. Der Versuch, mehr Bytes aus einem Datensatz zu lesen als geschrieben wurden, führt zu einem Fehler, normalerweise einem Überlauffehler (siehe unten).
  • Das Synchronisationszeichen wird verwendet, um Kopfdatensätze (Sync ist #2C) von Datensätzen (Sync ist #16) zu unterscheiden. Andere Synchronisationszeichen könnten verwendet werden, wenn der Datensatz auf diese Weise geschrieben wurde.
  • 0 Abbruch Der Benutzer hat die Escape-Taste gedrückt.
  • 1 Überlauf Der Cassette Manager hat ein Bit gefunden, das zu lang zum Lesen war.
  • 2 CRC Ein CRC-Fehler wurde festgestellt.
  • Der Kassettenmotor wird von dieser Routine gestartet (falls er nicht bereits läuft) und nach Abschluss des Lesens in seinen vorherigen Zustand zurückversetzt.
  • Da das Lesen des Bandes strenge Timing-Anforderungen erfordert, sind Interrupts deaktiviert, während das Band gelesen wird (potenziell ein Zeitraum von über 5 Minuten). Es wäre unangenehm, wenn der Soundchip die ganze Zeit Geräusche machen würde, daher wird der Sound Manager heruntergefahren (SOUND RESET). Wenn das Lesen vom Band abgeschlossen ist, werden Interrupts wieder aktiviert.

🧪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
ℹ️ Ohne Band meldet der Simulator „Escape“ (Carry 0, Zero 1).
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

CAS CHECK &BCA4CAS WRITE &BC9E
💡 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 WRITE &BC9ECAS CHECK &BCA4 →