tranZPUter-Dateisystem (TZFS) -- Benutzerhandbuch

TZFS Benutzerhandbuch

Das tranZPUter Filing System (TZFS) ist ein in Z80-Assembler geschriebenes Firmware-Paket fuer die tranZPUter-Familie von Z80-Erweiterungsplatinen. Es ist eine Portierung des Rom Filing System (RFS), angepasst an die Architektur des tranZPUters: Anstatt eine physische Flash-ROM-Karte zu programmieren, wird TZFS bei jedem Start automatisch vom I/O-Prozessor (K64F oder ZPU) des tranZPUter-Boards von der SD-Karte in den 512 KB RAM geladen. Das Ergebnis ist ein erweiterter Monitor, der SD-Karten-Dateiverwaltung, CP/M 2.2 Boot, einen integrierten Z80-Assembler und -Disassembler, Hardware-Maschinenemulation, Soft-CPU-Umschaltung, VGA-Ausgangssteuerung und mehr als 40 neue Befehle hinzufuegt -- und dabei den vertrauten SA-1510 * -Prompt und jeden Originalbefehl beibehaelt.
Dieses Handbuch behandelt alles, was fuer den Einstieg und die taegliche Nutzung von TZFS erforderlich ist. Fuer Hardwarearchitektur und Build-System-Details siehe den Technischen Leitfaden. Fuer Quellcode-Interna und Firmware-Entwicklung siehe das Entwicklerhandbuch.

Unterstuetzte Hardware

TZFS unterstuetzt fuenf Hardwareplattformen, die jeweils zur Kompilierzeit ueber Build-Flags ausgewaehlt werden. Das resultierende Firmware-Image und der verfuegbare Funktionsumfang unterscheiden sich je nach Ziel. Befehle, die in der Monitor-Befehlsreferenz mit (T) gekennzeichnet sind, stehen nur auf den tranZPUter SW-, SW-700- und Fusion-Plattformen zur Verfuegung. Diese Befehle fehlen bei FusionX und picoZ80, wo die entsprechende Funktionalitaet nativ von FPGA oder RP2350 bereitgestellt wird.
Plattform Build-Flag Beschreibung Einschraenkungen
tranZPUter SW BUILD_MZ700 (Standard) Urspruengliches tranZPUter-Design. Das FPGA implementiert Hardwareemulation aller Sharp MZ-Modelle, den T80 Soft-Core Z80 CPU, den ZPU Evolution Soft-CPU und VGA-Ausgang. Der K64F I/O-Prozessor verwaltet SD-Kartenzugriff und andere Soft-Services. Keine – voller Funktionsumfang.
tranZPUter SW-700 v1.3 BUILD_MZ700 Aktuelles Produktionsmodell. Verbessertes PCB-Layout des SW. Gleiche FPGA- und K64F-Faehigkeiten, voller Funktionsumfang. Keine – voller Funktionsumfang.
tranZPUter Fusion BUILD_MZ700 Kombiniert das tranZPUter-Board mit einem FPGA-Videomodul. Gleiche FPGA- und K64F-Faehigkeiten, voller Funktionsumfang. Keine – voller Funktionsumfang.
tranZPUter FusionX BUILD_FUSIONX FPGA-basierte virtuelle Implementierung des tranZPUters. Hardwareemulation, CPU-Umschaltung und VGA-Steuerung werden nativ vom FPGA uebernommen. Hardwareemulation, CPU-Umschaltung und VGA-Befehle (T) sind ueber TZFS nicht verfuegbar. Alle Datei-, Band- und Speicherbefehle sind verfuegbar.
picoZ80 BUILD_PICOZ80 RP2350-basierte Z80-Ersatzplatine. Gleiche Architekturaufteilung wie FusionX – FPGA/RP2350 uebernimmt Low-Level-Hardwarefunktionen. Gleiche Einschraenkungen wie FusionX: keine (T)-Befehle ueber TZFS. Alle Datei-, Band- und Speicherbefehle sind verfuegbar.
Zusaetzliche Build-Flags BUILD_MZ80A, BUILD_MZ1500 und BUILD_MZ2000 waehlen das Ziel-MZ-Modell beim Bau fuer Nicht-MZ-700-Maschinen. Diese beeinflussen Standard-Tape-Timing und bestimmte Memory-Map-Konstanten, aendern aber nicht den Befehlssatz.

TZFS beziehen

Vorgefertigte Firmware-Images sind im releases/-Verzeichnis des Gitea-Repositorys verfuegbar und koennen direkt ohne Build-Tools verwendet werden. Im Gegensatz zu RFS erfordert TZFS kein Programmieren physischer ROM-Chips -- der K64F- oder ZPU-I/O-Prozessor laedt die TZFS-Firmware bei jedem Start automatisch von der SD-Karte in den 512 KB RAM des tranZPUters.
Zur Installation kopieren Sie die vorgefertigte Firmware-Binaerdatei und die zugehoerigen SD-Karten-Dateien auf eine FAT-formatierte Micro-SD-Karte und stecken diese in den SD-Kartensteckplatz des tranZPUter-Boards. Der I/O-Prozessor erkennt die Firmware beim Start und laedt sie transparent, bevor der Z80 aus dem Reset entlassen wird.
Um aus dem Quellcode zu bauen, klonen Sie das Repository und fuehren Sie aus: 
./build.sh
Das Build-Skript assembliert TZFS fuer das Standardziel (BUILD_MZ700). Uebergeben Sie das entsprechende Flag fuer eine andere Plattform: 
./build.sh BUILD_FUSIONX=1      # FusionX-Build
./build.sh BUILD_PICOZ80=1      # picoZ80-Build
./build.sh BUILD_MZ80A=1        # MZ-80A-Ziel (SW/SW-700/Fusion)
Wenn Sie aus dem Quellcode bauen moechten, ist der einfachste Weg das automatische Setup-Skript fuer Ihre Plattform -- setup_TZFS.sh (macOS / Linux / WSL) oder setup_TZFS_windows.ps1 (Windows, natives Git Bash, kein WSL). Jedes ist eigenstaendig: Kopieren Sie die eine Datei fuer Ihre Plattform und fuehren Sie sie aus, und es installiert die erforderlichen Werkzeuge, laedt das Inhaltspaket herunter und kann den Build fuer Sie ausfuehren, ohne dass tiefgehende Kenntnisse der Toolchain erforderlich sind. Siehe den Technischen Leitfaden -- Build-System fuer die Schritt-fuer-Schritt-Anleitung.
Nach dem Bau kopieren Sie die Ausgabedatei zusammen mit der SD-Karten-Dateisammlung auf die SD-Karte. Siehe den Technischen Leitfaden -- Build-System fuer vollstaendige Details des Build-Prozesses und des Ausgabe-Layouts.

Erster Start

Setzen Sie die SD-Karte ein, verbinden Sie das tranZPUter-Board mit einer kompatiblen Sharp MZ-Maschine und schalten Sie ein. Der K64F- oder ZPU-I/O-Prozessor laedt die TZFS-Firmware in den 512 KB RAM des tranZPUters. Der Z80 wird dann aus dem Reset entlassen und fuehrt TZFS direkt aus. Das vertraute SA-1510-Anmeldebanner erscheint, ergaenzt mit "+ TZFS" zur Bestaetigung der erfolgreichen Initialisierung: 
SHARP MZ-80A
Monitor SA-1510  + TZFS

*
Das * ist der Standard-SA-1510-Monitor-Prompt. Alle Original-SA-1510-Befehle funktionieren genau wie auf der unmodifizierten Maschine. Geben Sie H ein, um einen seitenweisen Hilfebildschirm mit allen TZFS-Befehlen anzuzeigen. Druecken Sie Leertaste zum Weiterschalten.
Fehlt der Text + TZFS, wurde TZFS nicht korrekt initialisiert. Die haeufigsten Ursachen sind eine fehlende oder falsch vorbereitete SD-Karte oder eine Firmware-Binaerdatei, die nicht zur Ziel-Hardwareplattform passt. Pruefen Sie, ob die SD-Karte richtig eingesetzt ist und die korrekte TZFS-Firmware-Binaerdatei fuer Ihre Board-Variante enthaelt.

TZFS-Monitorbefehle

Der vollstaendige TZFS-Befehlssatz ist unten aufgefuehrt. Befehle mit der Kennzeichnung (T) sind nur auf den tranZPUter SW-, SW-700- und Fusion-Plattformen verfuegbar (mit K64F-I/O-Prozessor). Diese Befehle fehlen bei FusionX- und picoZ80-Builds, wo die entsprechenden Hardwarefunktionen nativ bereitgestellt werden.
Befehl Parameter Beschreibung
4 – Umschaltung auf 40-Zeichen-Anzeigemodus.
8 – Umschaltung auf 80-Zeichen-Anzeigemodus.
ASM <address> Startet den integrierten Z80-Assembler ab <address>. Geben Sie Mnemonics zeilenweise ein; assemblierte Bytes werden in den RAM geschrieben und die Adresse rueckt automatisch vor.
B – Aktiviert oder deaktiviert den Tastendruck-Piepton.
BASIC – Findet SA-5510 BASIC auf der SD-Karte, laedt und fuehrt es aus.
CD [<directory>] Wechselt das aktive SD-Karten-Verzeichnis. Ohne Argument wird der aktuelle Pfad angezeigt.
CP <src> <dst> <size> Kopiert einen Speicherblock. Alle Argumente sind 4-stellige Hex-Werte: Quelladresse, Zieladresse, Byteanzahl.
CPM – Laedt CP/M 2.2 von der SD-Karte und bootet.
D <addr> [<addr2>] Hex- und ASCII-Dump des Speichers von <addr> bis <addr2> (oder 20 Zeilen). Pause bei jeder Bildschirmseite; D zum Weiterblaettern, U zum Zurueckblaettern, X zum Beenden.
DASM <addr> [<addr2>] Disassembliert Z80-Maschinencode von <addr> bis <addr2>.
DIR [<wildcard>] Seitenweise Verzeichnisauflistung des aktiven SD-Karten-Verzeichnisses. Optionales Wildcard-Muster, z.B. DIR *.MZF.
EC <name or file no.> Loescht eine Datei von der SD-Karte nach Name oder Nummer.
EX – Beendet TZFS und startet die Maschine im Originalmodus (ohne TZFS) neu.
F [<drive>] Bootet von Diskette. Fragt nach Laufwerksnummer, falls nicht angegeben.
FILL <start> <end> [,<value>] Fuellt Speicher von <start> bis <end> mit <value> (Standard 0x00).
FREQ <kHz> Setzt die CPU-Frequenz in kHz. 0 stellt den Board-Standard wieder her.
H – Zeigt den seitenweisen Hilfebildschirm an.
J <address> Springt zu (fuehrt aus ab) der angegebenen Hex-Adresse.
L / LT [<filename>] [,<M>] Laedt vom Band (CMT) und fuehrt aus. Optionales ,M gibt das Maschinenmodell fuer das Tape-Timing an.
LTNX [<filename>] [,<M>] Laedt vom Band ohne Ausfuehrung.
LC <name or no.> [,<M>] Laedt ein Programm von der SD-Karte und fuehrt es aus.
LCNX <name or no.> [,<M>] Laedt von der SD-Karte ohne Ausfuehrung.
M <address> Interaktiver Speichereditor.
MZ (T) [<mc>] Aktiviert Hardwareemulation fuer den Maschinencode mc.
MZ80K (T) – Aktiviert Sharp MZ-80K Hardwareemulation.
MZ80C (T) – Aktiviert Sharp MZ-80C Hardwareemulation.
MZ1200 (T) – Aktiviert Sharp MZ-1200 Hardwareemulation.
MZ80A (T) – Aktiviert Sharp MZ-80A Hardwareemulation.
MZ700 (T) – Aktiviert Sharp MZ-700 Hardwareemulation.
MZ1500 (T) – Aktiviert Sharp MZ-1500 Hardwareemulation.
MZ800 (T) – Aktiviert Sharp MZ-800 Hardwareemulation.
MZ80B (T) – Aktiviert Sharp MZ-80B Hardwareemulation.
MZ2000 (T) – Aktiviert Sharp MZ-2000 Hardwareemulation.
MZ2200 (T) – Aktiviert Sharp MZ-2200 Hardwareemulation.
MZ2500 (T) – Aktiviert Sharp MZ-2500 Hardwareemulation.
P – Fuehrt einen Test am angeschlossenen Drucker aus.
R – Fuehrt einen umfassenden DRAM-Speichertest aus (0x1200-0xCFFF).
RIO <port> Liest einen I/O-Port und gibt den Wert aus.
S / ST <start> <end> <exec> [,<M>] Speichert einen Speicherbereich auf Band (CMT).
SC <start> <end> <exec> Speichert einen Speicherbereich auf der SD-Karte.
SD2T <name or no.> [,<M>] Kopiert eine Datei von der SD-Karte auf Band (CMT).
T – Testet den 8253-Timerchip.
T2SD [B] [,<M>] Kopiert Band auf SD-Karte. Das B-Flag aktiviert den Bulk-Modus.
T80 (T) – Wechselt von der Hardware-Z80 zum internen Soft-T80-CPU-Kern.
TC [-]<value> Setzt die Tape-Delay-Kompensation.
V – Verifiziert eine gerade auf Band geschriebene Datei gegen die Daten im Speicher.
VBORDER (T) <colour> Setzt die VGA-Ausgangs-Rahmenfarbe (0-15).
VGA (T) <mode> Setzt den VGA-Ausgangsmodus (0=aus, 1=640x480, 2=800x600).
VMODE (T) <mode> Setzt den aktiven Videomodus fuer die emulierte Maschine.
WIO <port> <value> Schreibt <value> an I/O-Port <port>.
Z80 (T) – Wechselt vom Soft-CPU zurueck zur Hardware-Z80 (extern).
ZPU (T) – Wechselt zum ZPU Evolution Soft-CPU-Kern und bootet zOS.

Bandbetrieb

TZFS behaelt die volle CMT-Unterstuetzung (Kassette) neben dem SD-Karten-Dateisystem bei. Alle Original-Bandbefehle funktionieren wie auf dem unmodifizierten SA-1510-Monitor. TZFS erweitert sie um die Auswahl des Maschinenmodell-Timings und fuegt Komfortbefehle fuer den Dateitransfer zwischen Band und SD-Karte hinzu.
Laden vom Band
Verwenden Sie L (oder den Alias LT) zum Laden eines Programms vom Band und Ausfuehren. Verwenden Sie LTNX zum Laden ohne Ausfuehrung. Ein optionaler Dateiname kann angegeben werden -- wenn angegeben, durchsucht TZFS das Band bis ein passender Header gefunden wird. Ohne Dateiname wird die erste gefundene Datei geladen.
Der optionale ,M-Parameter waehlt das Maschinenmodell, dessen Tape-Timing-Parameter fuer den Ladevorgang verwendet werden.
Code Maschinenmodell
K Sharp MZ-80K
C Sharp MZ-80C
1 Sharp MZ-1200
A Sharp MZ-80A
7 Sharp MZ-700
8 Sharp MZ-800
B Sharp MZ-80B
2 Sharp MZ-2000 
* L              ; Naechste Banddatei laden und ausfuehren (Standard-Timing)
* LT INVADERS    ; Auf Band nach INVADERS suchen und ausfuehren
* LTNX ,7        ; Naechste Datei mit MZ-700-Tape-Timing laden, nicht ausfuehren
Speichern auf Band
Verwenden Sie S (oder ST) zum Speichern eines Speicherbereichs auf Band. Geben Sie Startadresse, Endadresse und Ausfuehrungsadresse als aufeinanderfolgende 4-stellige Hex-Werte an, dann geben Sie den Dateinamen ein, wenn Sie dazu aufgefordert werden. Der optionale ,M-Parameter waehlt das Tape-Timing fuer das Ziel-Maschinenmodell: 
* S120020001200
FILE NAME? MYPROG
SAVING...
Verifizierung einer Bandaufnahme
Verwenden Sie V unmittelbar nach dem Speichern, um zu ueberpruefen, ob die auf Band geschriebenen Daten mit den noch im Speicher befindlichen Daten uebereinstimmen. TZFS liest das Band zurueck und vergleicht es Byte fuer Byte.
Band auf SD-Karte kopieren
T2SD laedt die naechste Datei vom Band und speichert sie direkt im aktiven SD-Karten-Verzeichnis. Das optionale B-Flag aktiviert den Bulk-Modus, der Dateien hintereinander vom Band liest, bis das Bandende erreicht ist oder ein Fehler auftritt. 
* T2SD          ; Naechste Banddatei auf SD-Karte kopieren
* T2SD B        ; Bulk-Kopie -- alle Dateien vom Band auf SD-Karte lesen
* T2SD B,7      ; Bulk-Kopie mit MZ-700-Tape-Timing
SD-Karte auf Band kopieren
SD2T laedt eine benannte Datei (oder Datei nach Nummer) aus dem aktiven SD-Karten-Verzeichnis und schreibt sie auf Band. Der optionale ,M-Parameter waehlt das Tape-Timing fuer den Schreibvorgang: 
* SD2T INVADERS      ; INVADERS von SD-Karte auf Band schreiben
* SD2T 04,7          ; Datei 04 mit MZ-700-Timing auf Band schreiben
Tape-Delay-Kompensation
Der TC-Befehl passt einen Kompensationswert an, der auf alle Tape-Timing-Berechnungen angewendet wird. Fuehren Sie TC ohne Argumente aus, um den aktuellen Wert anzuzeigen. Verwenden Sie TC ohne Praefix zum Erhoehen oder TC mit einem --Praefix zum Verringern der Kompensation. 
* TC            ; Aktuellen Kompensationswert anzeigen
* TC 2          ; Kompensation um 2 Schritte erhoehen
* TC -1         ; Kompensation um 1 Schritt verringern

SD-Karten-Operationen

TZFS nutzt den K64F- oder ZPU-I/O-Prozessor des tranZPUters fuer den Zugriff auf eine FAT-formatierte SD-Karte ueber eine Service-Request-API. Dateien werden als Standard-MZF-Format-Dateien in einer konventionellen Verzeichnisstruktur gespeichert. Alle SD-Karten-Befehle arbeiten im aktuell aktiven Verzeichnis, das mit CD geaendert werden kann.
Verzeichnis auflisten
Verwenden Sie DIR fuer eine seitenweise Auflistung des aktiven SD-Karten-Verzeichnisses. Ein optionales Wildcard-Muster schraenkt die Auflistung ein: 
* DIR               ; Alle Dateien im aktiven Verzeichnis auflisten
* DIR *.MZF         ; Nur .MZF-Dateien auflisten
* DIR INVADERS*     ; Dateien auflisten, deren Namen mit INVADERS beginnen
Verzeichnis wechseln
Verwenden Sie CD zur Navigation in der SD-Karten-Verzeichnisstruktur. Ohne Argument zeigt CD den aktuellen Pfad an: 
* CD                ; Aktuellen Verzeichnispfad anzeigen
* CD MZ700          ; In Unterverzeichnis MZ700 wechseln
* CD ..             ; Eine Ebene nach oben gehen
Programme laden
Verwenden Sie LC zum Laden eines Programms aus dem aktiven SD-Karten-Verzeichnis und Ausfuehren. Verwenden Sie LCNX zum Laden ohne Ausfuehrung. Dateien koennen nach Name oder nach der im DIR-Listing angezeigten Nummer angegeben werden: 
* LC INVADERS        ; INVADERS aus dem aktiven Verzeichnis laden und ausfuehren
* LCNX INVADERS      ; Laden ohne Ausfuehrung (nuetzlich zum Debuggen)
* LC 04              ; Datei Nummer 04 laden und ausfuehren
* LC STARTREK,7      ; STARTREK fuer MZ-700-Speichermodell laden
Programme speichern
Verwenden Sie SC zum Speichern eines Speicherbereichs im aktiven SD-Karten-Verzeichnis: 
* SC120020001200
FILE NAME? MYPROG
SAVED
Dateien loeschen
Verwenden Sie EC zum Loeschen einer Datei aus dem aktiven SD-Karten-Verzeichnis: 
* EC OLDPROG         ; Datei namens OLDPROG loeschen
* EC 07              ; Datei Nummer 07 loeschen

Hardwareemulation

Diese Funktion ist nur auf den tranZPUter SW-, SW-700- und Fusion-Plattformen verfuegbar (T).
Das FPGA des tranZPUters implementiert Hardwareemulation auf Hardwareebene der gesamten Sharp MZ-Familie. Wenn ein Hardwareemulationsbefehl ausgegeben wird, bittet die TZFS-Firmware den K64F, das korrekte Monitor-ROM fuer die Zielmaschine von der SD-Karte in den SRAM zu laden. Anschliessend rekonfiguriert das FPGA seine Video- und Speicherzuordnungslogik entsprechend der Zielmaschine und die Maschine startet im vollstaendigen Kompatibilitaetsmodus neu. 
* MZ 700         ; MZ-700-Hardwareemulation aktivieren
* MZ700          ; Aequivalenter Alias
* MZ             ; MZ-80A-Emulation aktivieren (Standard)
* MZ 2000        ; MZ-2000-Hardwareemulation aktivieren
Um nach der Emulation in den nativen Modus der Host-Maschine zurueckzukehren, geben Sie den entsprechenden MZ-Befehl fuer den Host ein (z.B. MZ80A, wenn der Host ein MZ-80A ist) oder schalten Sie die Maschine aus und wieder ein.

CPU-Umschaltung

Diese Funktion ist nur auf den tranZPUter SW-, SW-700- und Fusion-Plattformen verfuegbar (T).
Das FPGA des tranZPUters implementiert zwei Soft-CPU-Kerne neben der externen Hardware-Z80: T80 (eine Soft-Core-Z80-Implementierung) und ZPU Evolution (eine 32-Bit-Stack-CPU).
Befehl Beschreibung
Z80 Zurueck zur Hardware-Z80 (extern) wechseln. Dies ist der Standardzustand nach dem Booten.
T80 Zum im FPGA implementierten T80 Soft-Core Z80 wechseln.
ZPU Zum im FPGA implementierten ZPU Evolution Soft-CPU wechseln und zOS booten. 
* T80            ; Zum Soft-T80-Kern wechseln
* Z80            ; Zurueck zur externen Z80 wechseln
* ZPU            ; Zum ZPU Evolution-Kern wechseln und zOS booten
* FREQ 4000      ; CPU-Frequenz auf 4 MHz setzen
* FREQ 0         ; Board-Standardfrequenz wiederherstellen

Videosteuerung

Diese Funktion ist nur auf den tranZPUter SW-, SW-700- und Fusion-Plattformen verfuegbar (T).
Das tranZPUter-FPGA bietet VGA-Videoausgang. Drei Befehle steuern ihn:
Befehl Parameter Beschreibung
VGA <mode> VGA-Ausgangsmodus setzen. 0 = aus, 1 = 640x480, 2 = 800x600.
VBORDER <colour> VGA-Rahmenfarbe setzen (0-15).
VMODE <mode> Aktiven Videomodus fuer die emulierte Maschine setzen. 
* VGA 1          ; VGA-Ausgang bei 640x480 aktivieren
* VGA 2          ; VGA-Ausgang bei 800x600 aktivieren
* VGA 0          ; VGA-Ausgang deaktivieren
* VBORDER 4      ; Rahmenfarbe auf 4 setzen
* VMODE 2        ; Videomodus 2 fuer das aktive Emulationsziel setzen

BASIC verwenden

TZFS kann den Sharp SA-5510 BASIC-Interpreter automatisch von der SD-Karte finden und laden. Vom Monitor-Prompt aus geben Sie ein: 
* BASIC
TZFS durchsucht das aktive SD-Karten-Verzeichnis nach dem SA-5510 BASIC-Image, laedt es in den RAM und fuehrt es aus. Da TZFS BASIC von der SD-Karte statt aus dem ROM laedt, ist es einfach, mehrere BASIC-Versionen auf der SD-Karte bereitzuhalten.

CP/M 2.2 ausfuehren

CP/M 2.2 ist auf allen TZFS-Plattformen verfuegbar. Vom Monitor-Prompt: 
* CPM
TZFS findet das CP/M-Image auf der SD-Karte, laedt es und uebergibt die Kontrolle an den CP/M CCP. Der Prompt wechselt zu A>. Der Zugriff auf Laufwerke erfolgt ueber die K64F- oder ZPU-I/O-Prozessor-Service-API, die CP/M-BIOS-Aufrufe in SD-Karten-Dateioperationen uebersetzt.

Fehlerbehebung

Monitor startet, aber "TZFS" wird im Banner nicht angezeigt

  • SD-Karte nicht eingesetzt oder nicht erkannt -- pruefen Sie, ob die Karte vollstaendig im SD-Kartensteckplatz des tranZPUter-Boards sitzt.
  • Falsche Firmware-Binaerdatei auf der SD-Karte -- stellen Sie sicher, dass die TZFS-Binaerdatei zu Ihrer Board-Variante passt.
  • SD-Karte nicht FAT-formatiert -- der K64F/ZPU-I/O-Prozessor erwartet eine Standard-FAT-formatierte Karte.
  • I/O-Prozessor-Firmware veraltet -- stellen Sie sicher, dass der K64F oder ZPU-I/O-Prozessor eine Firmware-Version ausfuehrt, die die TZFS-Service-Request-API unterstuetzt.

Hardwareemulation, CPU-Umschaltung oder VGA-Befehle werden nicht erkannt

  • Auf FusionX oder picoZ80 ausgefuehrt -- mit (T) gekennzeichnete Befehle sind auf diesen Plattformen nicht verfuegbar. Dies ist erwartetes Verhalten.
  • Falsches Build-Ziel -- ueberpruefen Sie, ob die TZFS-Firmware mit dem richtigen Flag fuer Ihre Hardware gebaut wurde.

Bandladevorgaenge schlagen fehl oder erzeugen Fehler

  • Tape-Timing-Nichtueberein stimmung -- verwenden Sie den ,M-Parameter zur Auswahl des passenden Maschinenmodell-Timings.
  • Bandkopf-Geschwindigkeitsvariation -- verwenden Sie den TC-Befehl zur Anpassung der Tape-Delay-Kompensation.
  • Bandzustand -- gealterte oder schlecht gelagerte Baender koennen Aussetzer haben. Reinigen Sie den Bandkopf mit Isopropylalkohol.

CP/M startet nicht oder zeigt BIOS-Fehler

  • CP/M-Image nicht auf der SD-Karte vorhanden -- stellen Sie sicher, dass die SD-Karte das CP/M-Boot-Image im aktiven Verzeichnis enthaelt.
  • Falsches aktives Verzeichnis -- navigieren Sie mit CD zum Verzeichnis, das das CP/M-Image enthaelt.
  • I/O-Prozessor-Service-Timeout -- wenn der K64F oder ZPU nicht innerhalb des erwarteten Zeitfensters auf eine BIOS-Serviceanfrage antwortet, bleibt CP/M haengen. Schalten Sie das Board aus und wieder ein.

Maschine stuerzt ab oder setzt sich unerwartet zurueck nach dem Laden eines Programms

  • Programm fuer falsches Maschinenmodell -- aktivieren Sie die entsprechende Hardwareemulation vor dem Laden.
  • Programm ueberschreibt TZFS-Arbeitsbereich -- verwenden Sie LCNX statt LC zum Laden ohne Ausfuehrung und pruefen Sie die Ladeadresse mit D.

Referenzseiten

Ressource Link
TZFS-Projektseite /sharpmz-upgrades-tzfs/
TZFS Technischer Leitfaden /sharpmz-upgrades-tzfs-technicalguide/
TZFS Entwicklerhandbuch /sharpmz-upgrades-tzfs-developersguide/
tranZPUter SW-Projektseite /tranzputer/
tranZPUter Fusion-Projektseite /tranzputerfusion/
picoZ80 (RP2350 Z80-Ersatz) /picoz80/
RFS Benutzerhandbuch (Begleit-Firmware) /sharpmz-upgrades-rfs-usermanual/
Sharp MZ-Serie technische Referenz Im Repository-Verzeichnis docs/ enthalten