tranZPUter-Dateisystem (TZFS)

Das TranZputer Filing System ist ein Port des Rom Filing System, das auf der Rom Disk Hardware-Upgrade-Platine verwendet wird. Es verwendet vieles der gleichen Software-Funktionalitaet und bietet folglich die gleichen Dienste -- die Unterschiede liegen in der Verwendung eines anderen Speichermodells. Sein Zweck ist es, Methoden zur Manipulation von auf der SD-Karte gespeicherten Dateien bereitzustellen und eine erweiterte Kommandozeilenschnittstelle, den TZFS-Monitor, anzubieten. Der Befehlssatz umfasst SD-Dateimanipulation und -sicherung sowie eine Reihe von Befehlen, die auf den MZ700/800-Computern zu finden sind. Die Einfuehrung des tranZPUter FusionX mit seinem virtuellen I/O-Prozessor veranlasste die Trennung dieser Software aus dem tranZPUter-Repository in ein eigenstaendiges Modul. TZFS laeuft auf der gesamten tranZPUter-Reihe, einschliesslich der neueren tranZPUterFusionX- und tranZPUterFusion-Geraete. Die SD-Karte und ROMs werden vom K64F-I/O-Prozessor verwaltet. Eine Service-Request-API wurde geschrieben, wobei ein gemeinsamer Speicherblock (640 Byte) in Verbindung mit einer physischen I/O-Anfrage verwendet wird, um Befehle und Daten zwischen dem Z80 und dem K64F auszutauschen. TZFS praesentiert sich dem Benutzer als erweiterte Version des Host-Monitorprogramms (z.B. SA-1510, 1Z-013A usw.) mit Anwendungsspeicherung und -abruf sowohl in Flash-RAM- als auch SD-Karten-Geraeten.

Beim Einschalten des Sharp MZ-700 wird dem Benutzer eine Kommandozeilenschnittstelle namens Monitor praesentiert. Der TZFS-Monitor ist eine Erweiterung des Basismonitors. Nach dem Einsetzen der tranZPUter SW-Karte wird TZFS durch den folgenden Befehl am Monitor-Prompt '*' gestartet:

Es ist moeglich, den Start direkt in TZFS zu automatisieren. Erstellen Sie dazu eine leere Datei im Stammverzeichnis der SD-Karte namens TZFSBOOT.FLG. Zusaetzlich kann eine Datei AUTOEXEC.BAT erstellt werden, die Befehle enthaelt, die TZFS nach dem Start automatisch ausfuehrt.

Sobald TZFS gebootet ist, erscheint das typische 1Z-013A-Monitor-Anmeldebanner mit dem Anhang "+ TZFS". Der vollstaendige Befehlssatz ist in der folgenden Tabelle aufgefuehrt:

Es ist moeglich, alle Sharp MZ-Serie-Bandformate ueber TZFS-Befehle zu lesen und zu schreiben. Der ,M-Parameter gibt das Maschinenmodell fuer das Tape-Timing an: K=MZ-80K, C=MZ-80C, 1=MZ-1200, A=MZ-80A, 7=MZ-700, 8=MZ-800, B=MZ-80B, 2=MZ-2000.

Der SA-5510 BASIC-Interpreter wurde disassembliert und fuer die SD-Karten-Nutzung unter TZFS kompatibel gemacht. Die neue Version heisst "BASIC SA-5510-TZ".

Eine Version von Microsoft NASCOM 4.7b BASIC wurde fuer die tranZPUter-Plattform portiert und um TZFS-Befehle erweitert.

Der empfohlene Weg, TZFS zu bauen, ist das eigenstaendige Setup-Skript fuer Ihre Plattform. Es installiert die Voraussetzungen (eine Java-JRE fuer den GLASS-Z80-Assembler, eine C-Toolchain + make zum Kompilieren des mitgelieferten cpmtools-Submoduls sowie perl/git/coreutils; unter Windows Git Bash + Java), klont das Repository, laedt das ~110 MB grosse Inhaltspaket (TZFS_Files.zip) herunter und kann die ROM-Images bauen -- alles interaktiv, mit sinnvollen Standardwerten, die Sie durch Druecken der Eingabetaste uebernehmen koennen. Kopieren Sie einfach die einzelne Datei fuer Ihre Plattform und fuehren Sie sie aus.

chmod +x setup_TZFS.sh
./setup_TZFS.sh

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\setup_TZFS_windows.ps1

Setzen Sie die Umgebungsvariable TZFS_REPO_URL, um die Standard-Repository-URL (https://git.eaw.app/eaw/TZFS.git) zu ueberschreiben, ohne das Skript zu bearbeiten, und TZFS_FILES_URL, um auf ein alternatives Inhaltspaket zu verweisen.

Ausgabe und Neuerstellung. ROM-Images und CP/M-Disk-Images werden nach roms/ geschrieben. Um spaeter neu zu bauen, wechseln Sie in das Checkout-Verzeichnis; unter macOS fuehren Sie zuerst source ./tzfs_env.sh aus; dann fuehren Sie ./build.sh aus (oder ./build.sh -m, um auch die MZF-Quellen erneut zu verarbeiten). Nach dem Bau kopieren Sie die Ausgabe mit tools/copytosd.sh auf eine FAT32-formatierte SD-Karte (siehe A Typical Build unten fuer die vollstaendige Anleitung).

Der Bau der Software und des endgueltigen Ladeimages kann durch Klonen des Repositorys und Ausfuehren der bereitgestellten Build-Skripte erfolgen.

cd <software>
./build.sh

# Auf SD-Karte kopieren:
tools/copytosd.sh -D$(pwd) -M/media/user/K64F -tMZ-700

Die API basiert auf einem gemeinsamen RAM-Block im 64K-Speicherraum des Z80, ueber den die Interprozesskommunikation stattfindet. Wenn der Z80 einen Dienst benoetigt, schreibt er einen Befehl in das svcControl.cmd-Feld und setzt das svcControl.result-Feld auf REQUEST. Der Z80 schreibt dann an einen Ausgangsport (0x68), der wiederum einen Interrupt an den K64F sendet.

Eine der Funktionen des tranZPUter-Hardware-Designs ist die Moeglichkeit, Speicherkarten frei innerhalb des 512-Makrozellen-CPLD zu erstellen. Die definierten Modi umfassen den Original-Modus, TZFS-Modi (0-5), CP/M-Modi (6-7), MZ-700-Kompatibilitaetsmodi (10-14), MZ-800/MZ-2000-Modi und K64F-Zugriffsmodi (21-31). Siehe die vollstaendige Modustabelle in der englischen Version.