Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- z9001:software:usb [2025/01/24 16:35] – volkerp
+++ z9001:software:usb [2025/08/29 12:16] (aktuell) – [Download] neue Version f. ch376 volkerp
@@ Zeile 1: / Zeile 1: @@
-====== VDIP-OS USB ======
+====== OS-Erweiterung USB+SD ======
-**USB/VDIP im OS-Modus**\\
+Software zur Verwendung moderner [[..:erweiterungen/massenspeicher|Massenspeicher]] als Alternative zum Kassetten-Rekorder.
-Volker Pohlers, 2016
-{{youtube>lWoKiIBZa0A}}
+{{:z9001:module_sonstige:gide_usb_rtc_modul.jpg?0x200|}} {{:z9001:module_sonstige:ch376-modul_felge.jpg?0x200|}}{{:z9001:erweiterungen:sd-module3.jpg?0x100|}}
-**2024: Aktuell wird das VDIP-OS an die neue Hardware mit [[z9001:module_sonstige:usbmodul|CH376]] angepasst :-)**
+**2016: USB/VDIP im OS-Modus**
-Verwenden eines USB-Sticks zum Speichern/Laden anstelle eines Kassettenrekorders.\\
+**2024: Version für CH376 [[z9001:module_sonstige:usbmodul|CH376]]**
-Das System lässt sich auch im Emulator [[#jkcemu]] testen!
-Für das [[#usb-os]] am originalen Z9001 bzw. KC87 benötigt man:
+**2025: Version für SD-Modul [[z9001:erweiterungen:sdcard2|]]**
-  - kein,eins oder zwei RAM-Module (16K .. 48K RAM)
-  - ein ROM-Modul auf Adresse C000 eingestellt, Eprom-Inhalt modul.rom (8k)
-  - ein USB-Modul (PIO + VDIP), z.B. eine teilbestückte [[z9001:module_sonstige:gide_usb|GUR-Platine]]
-  - mit einen VDIP-Modul (VDIP1 von vinculum oder Nachbau V2DIP).
-Beschreibung des VDIP-Moduls s. [[z9001:module_sonstige:gide_usb#vdip1|VDIP1]] und [[z9001:module_sonstige:gide_usb#v2dip|]].
+{{youtube>lWoKiIBZa0A}}
+{{:z9001:erweiterungen:kc87_sd_os.mp4|Start SD-Modul von Kingstener}}
-Beschreibung **GUR-Platine** siehe [[z9001:module_sonstige:gide_usb|]].
+Verwenden eines USB-Sticks bzw. SD-Karte zum Speichern/Laden anstelle eines Kassettenrekorders.\\
+Das System lässt sich auch im Emulator [[#jkcemu]] testen!
-Es funktionieren auch kompatible Module wie **GU-K1520 von Kingstener** oder das **[[z1013:module:usb|Z1013-USB-Modul]] von Lötspitze**. Prinzipiell wird nur eine PIO und ein VDIP-Modul benötigt. Die [[z9001:module_sonstige:gide_usb#hardware1|Schaltung]] ist für alle Module gleich!
+===== Download =====
-{{:z9001:module_sonstige:usb-modul-0.jpg?300|}} {{:z9001:module_sonstige:gurv3_usb.jpg?300|}}\\ GUR-V3-Modul, und Teilbestückung nur USB
+  * eigenständige aktuelle Version f. Modul mit ROM {{ :z9001:software:usb-os.zip |}} Stand 27.08.2025, incl. Quellcodes etc.
+  * Binär-Version {{ :z9001:software:usb-os-bin.zip |}} Stand 27.08.2025
+  * Handbuch {{ :z9001:software:usb-os.pdf |}} (CH376+VDIP) Stand 18.08.2025
+  * Handbuch SD-OS {{ :z9001:software:sd-os.pdf |}} Stand 18.08.2025
-An das [[z9001:module_sonstige:gide_usb#vdip1|VDIP1-Modul]] wird ein USB-Stick angesteckt. Unterstützt werden USB 1.1 und USB 2.0-Sticks. Ein 8GB-Stick wurde erfolgreich getestet. Der Stick muss mit **FAT12, FAT16 oder FAT32** formatiert sein.
+**Hinweis**: Das Programm wird als USBX/SDX/CHX auch im Rahmen der Mega-Flash-Software gepflegt.
-Ein [[z9001:module_sonstige:gide_usb#v2dip|V2DIP-Modul]] unterstützt normalerweise nur FAT 16 und FAT32.
-**Jumper** GUR-Modul. Bei Teilbestückung USB gibt es nur Jumper JP5
-  * USB Jumper JP5 (unter dem DOM-Modul) v.u.n.o. A2..A7. Es ist nur A5 gejumpert (Port DCh)
-  * GIDE Jumper JP2 (Mitte) v.l.n.r. A4..A7, hi-Teil-PortAdr. Es ist A5 und A7 gejumpert (Port 50h)
-  * DOM Jumper J2 (quer): gesteckt für Stromversorgung des DOM-Moduls
-| Adressbereich | - | |
-| I/O-Adressen | GIDE | 54h-5Fh (empfohlener Port für Z9001) |
-| | USB | DCh..DFh (empfohlener Port für Z9001) |
-Hinweis Für das Modul {{http://www.kingsteners.homepage.t-online.de/Erweiterungen| **GU-K1520 von Kingstener**}} muss ein spezieller GAL genutzt werden, der die Port-Adresse DCh für USB unterstützt.
+===== Beschreibung =====
 {{:z9001:software:usb-dos.gif|}} {{:z9001:software:usb-64k-sram.gif|}} {{:z9001:software:usb-os-dir.png|DIR und CD im OS}} {{:z9001:software:basic-dir.png|DIR und CD in RAM-BASIC}}
-VDIP-OS ermöglicht eine umfangreiche Unterstützung von USB-Sticks
+USB-OS ermöglicht eine umfangreiche Unterstützung von USB-Sticks
-u.a. als Ersatz für den Kassettenrekorder direkt vom Z9001-Modus aus. Die Software setzt keine speziellen Module voraus und könnte auch von Kassette geladen werden, Sinnvoller ist es, ein passendes ROM-Modul zu nutzen ([[z9001:module_sonstige:megaflash|Mega-Flash]], Ulrichs Kombi-Modul[[http://www.sax.de/~zander/z9001/module/kombi.html]], u.a.m.)
+u.a. als Ersatz für den Kassettenrekorder direkt vom Z9001-Modus aus. Die Software setzt keine speziellen Module voraus und könnte auch von Kassette geladen werden, Sinnvoller ist es, ein passendes ROM-Modul zu nutzen (robotron-ROM-Modul, in [[z9001:module_sonstige:megaflash|Mega-Flash]], Ulrichs Kombi-Modul[[http://www.sax.de/~zander/z9001/module/kombi.html]] u.a.m. ist die Software bereits enthalten).
 Dazu werden die CALL5-Routinen für Kassettenarbeit abgefangen und für das VDIP/USB-Modul genutzt.
@@ Zeile 53: / Zeile 40: @@
 Es ist schon cool, wenn man mit dem normalen OS-SAVE plötzlich auf einen USB-Stick schreibt :-).
-Für einen 100%-igen Kassettenersatz müsste man die Routinen MAREK und KARAM aus dem Z9001-OS ersetzen. Das geht aber nur, wenn man den System-ROM gegen einen EPROM mit einem angepasstem OS austauscht.
+**Autoren**: Von mir stammt die Einbindung ins Betriebssystem, die Dokumentation und viele Zusatzprogramme.
-===== Download =====
+VDIP: Der eigentliche Zugriff auf das VDIP-Modul stammt von den UTOOLS von Mario Leubner.\\
+CH376: Der phys. Treiber stammt von Bruce Abbot, die Anpassung an den Z9001 erfolgte durch R. Hecht.
-  * Programm, Quellcodes ursprüngliche Version {{:z9001:software:z9001_vdip_os.zip|}}
-  * eigenständige aktuelle Version f. Modul mit ROM {{ :z9001:software:usb-os.zip |}} Stand 24.1.2025, incl. Quellcodes etc.
-  * Binär-Version {{ :z9001:software:usb-os-bin.zip |}} Stand 24.1.2025
-  * Handbuch {{ :z9001:software:usb-os.pdf |}}
-  * Handbuch SD-OS {{ :z9001:software:sd-os.pdf |}}
-Hinweis! Das Programm wird als USBX auch im Rahmen der Mega-Flash-Software gepflegt.
-Autoren: Von mir stammt die Einbindung ins Betriebssystem. Der eigentliche Zugriff auf das VDIP-Modul stammt von den UTOOLS von Mario Leubner.
-**2019**: Ich habe eine eigenständige Version usb-os.zip für die Arbeit ohne Mega-Modul/Kombi-Modul zusammengestellt. Die enthaltenen Programme für den USB-Stick und die Anleitung gelten auch für die Mega-Flash-Version.
-Im ROM sind auch die vom Mega-Flash bekannten Kommandos LOAD,SAVE,RUN,MEM,DUMP etc. enthalten.
-**2024**: Der Quellcode wurde umstrukturiert und aufgeräumt.
-**24.1.25**: Es können nun Programmversionen für [[z9001:erweiterungen:sdcard2|SD-Modul]] + [[z9001:module_sonstige:usbmodul|CH376]] erzeugt werden.
-Abweichungen:
-^ USB-OS  ^ Mega-Flash  ^
-| DIR     | DDIR        |
-| MENU    | DIR         |
-Anleitung s. Handbuch {{ :z9001:software:usb-os.pdf |Handbuch }} und usb-os.txt im Download-Paket.
 ===== Laden =====
@@ Zeile 93: / Zeile 59: @@
 In der aktuellen Software zum [[z9001:module_sonstige:megaflash|]] wird der Treiber mit
-  USBX
+  USBX       (VDIP-Modul)
+  bzw. SDX   (CD-Modul)
-gestartet. (s. obiges Bild, dort noch Start mit altem Namen USB)
+  bzw. CHX   (CH376)
+gestartet. (USBX s. Bild oben, dort noch Start mit altem Namen USB)
 ===== Befehle =====
@@ Zeile 108: / Zeile 75: @@
 | **OS-SAVE fname[.typ] aadr eadr [sadr]**  | OS-Kommando zum Speichern                                                                                               |
+Abweichungen((im Mega-Flash gibt es bereits die Kommandos DIR und MENU, daher ist hier DDIR nötig)):
+^ USB-OS  ^ Mega-Flash  ^
+| DIR     | DDIR        |
+| MENU    | DIR         |
+Anleitung s. Handbuch {{ :z9001:software:usb-os.pdf |Handbuch }} und usb-os.txt im Download-Paket.
 Im Z9001-OS kann mit "DOS" bzw. "CAOS" zwischen USB und Kassette umgeschaltet werden.
-**USB** allgemeine Funktionen, Verzeichniswechsel
+**USB** (VDIP) allgemeine Funktionen, Verzeichniswechsel
 ^ Kommando ^ Bemerkung ^
@@ Zeile 132: / Zeile 105: @@
-===== USBX =====
+===== USBX/SDX/CHX =====
-USBX ist eine Variante der USB-Software, die in der [[z9001:software:mega|]] enthalten ist. Sie wird als Treiber geladen und bleibt dann bis zum nächsten Reset aktiv. Bei Strg-C (Warmstart) wird der Treiber automatisch reinitialisiert.
+USBX/SDX/CHX sind die Varianten der USB-Software, die in der [[z9001:software:mega|]] enthalten sind. Die jeweilige Software wird als Treiber geladen und bleibt dann bis zum nächsten Reset aktiv. Bei Strg-C (Warmstart) wird der Treiber automatisch reinitialisiert.
-**Eine Nutzung des reinen Treibers ohne zusätzliche System-Software ist nur eingeschränkt möglich (keine Laden und Speichern im OS, kein Laden und Speichern im BASIC)! Deshalb ist es nur sinnvoll, USBX via Mega-Flash u.ä. anzuwenden**
+**Eine Nutzung des reinen Treibers ohne zusätzliche System-Software ist nur eingeschränkt möglich (keine Laden und Speichern im OS, kein Laden und Speichern im BASIC)! Deshalb ist es nur sinnvoll, USBX etc. via Mega-Flash anzuwenden**
 Mit
   HELP USB
 gibt es eine kurze Hilfe.
 gestartet bzw. initialisiert wird mit
   USBX
+  SDX
+  CHX
-Das VDIP1 meldet sich mit
-  Ver03.69VDAPF On-Line:
-  Device Detected P2
-  No Upgrade
-  D:\>
-Ver03.698VDAPF ist die Firmwareversion (VDAP Disk And Peripheral Firmware Release 3.68)\\
-P2 steht für USB-Port 2 ((Die VDIP-Firmware kann 2 USB-Ports treiben. Das VDIP1-Modul hat nur einen USB-Anschluss (Port2), es ist möglich, einen weiteren zu ergänzen, s. VDIP1 Datasheet))\\
-D: steht für Drive, gemeint ist der USB-Stick. Das ist **kein** CP/M-Laufwerksbuchstabe!
-Nach dem Start kann  wird nun wie von Kassette gewohnt gearbeitet, mit LOAD und SAVE (bzw. OS-SAVE) können Speicherbereiche geladen bzw. gesichert werden, unter BASIC entsprechend mit CLOAD/CSAVE.
-Kommt beim Start ein Timeout, hilft
-  DOS
-DOS reinitialisiert den Treiber. Auch nach Reset muss unbedingt DOS gestartet werden, ehe wieder auf den USB-Stick geschrieben werden kann!
 Im OS werden Kommandos(Programme) nun zuerst im Speicher gesucht (oder im Mega-Modul), wird nichts gefunden, wird auf dem externen Speicher gesucht. Bei Kassettenbetrieb kommt die Ausschrift "start tape", bei USB entfällt das. Wenn ein Programm gefunden wurde, wird es geladen und gestartet. Wird es nicht gefunden, kommt die Meldung
@@ Zeile 174: / Zeile 129: @@
-===== USB-OS =====
+===== USB-OS (VDIP) =====
-| Dateiname | (modul.rom) |
+| Dateiname | (vdipos.rom) |
 | Laden in | OS |
 | Programmstandort | C000-C3FF |
@@ Zeile 187: / Zeile 142: @@
 Es wird kein Arbeitsspeicherbereich wie in der Mega-Flash-Version benötigt, die Software liegt komplett im ROM.
+Das VDIP1 meldet sich mit
+  Ver03.69VDAPF On-Line:
+  Device Detected P2
+  No Upgrade
+  D:\>
+Ver03.698VDAPF ist die Firmwareversion (VDAP Disk And Peripheral Firmware Release 3.68)\\
+P2 steht für USB-Port 2 ((Die VDIP-Firmware kann 2 USB-Ports treiben. Das VDIP1-Modul hat nur einen USB-Anschluss (Port2), es ist möglich, einen weiteren zu ergänzen, s. VDIP1 Datasheet))\\
+D: steht für Drive, gemeint ist der USB-Stick. Das ist **kein** CP/M-Laufwerksbuchstabe!
+Nach dem Start kann  wird nun wie von Kassette gewohnt gearbeitet, mit LOAD und SAVE (bzw. OS-SAVE) können Speicherbereiche geladen bzw. gesichert werden, unter BASIC entsprechend mit CLOAD/CSAVE.
+Kommt beim Start ein Timeout, hilft
+  DOS
+DOS reinitialisiert den Treiber. Auch nach Reset muss unbedingt DOS gestartet werden, ehe wieder auf den USB-Stick geschrieben werden kann!
 Es gibt ein paar spezielle Kommandos zur Arbeit mit USB.
 Das wichtigste Kommando ist USB. Mit diesem Kommando der USB-Stick
-reinitialisiert, werden Verzeichnisse angelegt uam.
+reinitialisiert, werden Verzeichnisse angelegt u.a.m.
 <code>
@@ Zeile 279: / Zeile 254: @@
 eine Verzeichnisebene zurück und CD "/" wechselt direkt ins Root-Verzeichnis.
+**5.2.2025**: Das externe Programm DIRX [maske] analysiert die Dateien, auf die die Maske passt und
+zeigt bei Basic-Programmen Typ, Schutz, und Länge (dez.) an, bei anderen Dateien
+die FCB-Felder Anfangsadresse, Endadresse, Startadresse (hex.)
+===== USB-OS CH376 =====
+| Dateiname | (ch376os.rom) |
+| Laden in | OS |
+| Programmstandort | C000-C3FF |
+| OS-Kommando | # und s.u. |
+USB-OS ist eine kleine autarke Software für eine USB-Modul mit CH376 mit einem 4K(8K)-ROM auf C000h.
+Es gelten die gleichen Hinweise wie bei USB-OS (VDIP), mit ein paar Abweichungen:
+  * Es wird etwas Arbeitsspeicherbereich benötigt ( 153h..17Fh, PathName, filename)
+  * Es gibt kein Kommando USB
+===== SD-OS =====
+| Dateiname | (sdosc0.rom) |
+| Laden in | OS |
+| Programmstandort | C000-C3FF |
+| OS-Kommando | #  u.a.m. |
+SD-OS ist zu USB-OS kompatible Software für ein [[z9001:erweiterungen:sdcard2|SD-Modul]] und einem 4K(8K)-ROM auf C000h.
+Mit dieser Software ist ein sofortiger Betrieb des Z9001 mit SD-Karte möglich. Direkt nach dem Einschalten wird mit SD-OS geladen und gestartet, es muss kein Treiber aktiviert werden.
+In der im Download beliegenden Beschreibung ist die Installation und Benutzung ausführlicher beschrieben.
+Alternativ:
+| Dateiname | sdos.com, sdos38.com |
+| Laden in | OS |
+| Programmstandort | B200-BFFF, 3800-3FFF |
+| OS-Kommando | # u.a.m. |
+Für den Einsatz ohne extra ROM-Modul. Die Software wird vom SD-Modul geladen; dazu ist ein Kabel mit dem Kassetteneingang zu verbinden. Der Start der Software erfolgt "X", siehe Beschreibung sd-os.pdf.
 ===== Programme =====
@@ Zeile 335: / Zeile 346: @@
 Um herauszufinden, wie ein Programm auf Kassette schreibt, gibt es im Mega-Flash ein kleines Hilfsprogramm CALL5DBG. Dieses ist nach DOS/CAOS neu zu starten. Es werden die Kassettenfunktionen mit Namen ausgegeben, gefolgt von DMA, BLNR und LBLNR (Stand vor Aufruf der eigentlichen Funktionen).
+===== Hardware =====
+s. [[..:erweiterungen:massenspeicher|]]
+Für das [[#usb-os]] am originalen Z9001 bzw. KC87 benötigt man:
+  - kein,eins oder zwei RAM-Module (16K .. 48K RAM)
+  - ein ROM-Modul auf Adresse C000 eingestellt, Eprom-Inhalt modul.rom (8k)
+  - ein USB-Modul (PIO + VDIP), z.B. eine teilbestückte [[z9001:module_sonstige:gide_usb|GUR-Platine]]
+  - mit einen VDIP-Modul (VDIP1 von vinculum oder Nachbau V2DIP).
+Alternativ: ein SD-Modul oder ein CH376-Modul
+==== VDIP ====
+Beschreibung des VDIP-Moduls s. [[z9001:module_sonstige:gide_usb#vdip1|VDIP1]] und [[z9001:module_sonstige:gide_usb#v2dip|]].
+Beschreibung **GUR-Platine** (whbuebchen) siehe [[z9001:module_sonstige:gide_usb|]].
+Es funktionieren auch kompatible Module wie **GU-K1520 von Kingstener** [[z9001:module_sonstige:guk_v8|]] oder das **[[z1013:module:usb|Z1013-USB-Modul]] von Lötspitze**. Prinzipiell wird nur eine PIO und ein VDIP-Modul benötigt. Die [[z9001:module_sonstige:gide_usb#hardware1|Schaltung]] ist für alle Module gleich!
+An das [[z9001:module_sonstige:gide_usb#vdip1|VDIP1-Modul]] wird ein USB-Stick angesteckt. Unterstützt werden USB 1.1 und USB 2.0-Sticks. Ein 8GB-Stick wurde erfolgreich getestet. Der Stick muss mit **FAT12, FAT16 oder FAT32** formatiert sein.
+Ein [[z9001:module_sonstige:gide_usb#v2dip|V2DIP-Modul]] unterstützt normalerweise nur FAT 16 und FAT32.
+**Jumper** GUR-Modul (whbuebchen). Bei Teilbestückung USB gibt es nur Jumper JP5
+  * USB Jumper JP5 (unter dem DOM-Modul) v.u.n.o. A2..A7. Es ist nur A5 gejumpert (Port DCh)
+  * GIDE Jumper JP2 (Mitte) v.l.n.r. A4..A7, hi-Teil-PortAdr. Es ist A5 und A7 gejumpert (Port 50h)
+  * DOM Jumper J2 (quer): gesteckt für Stromversorgung des DOM-Moduls
+| Adressbereich | - | |
+| I/O-Adressen | GIDE | 54h-5Fh (empfohlener Port für Z9001) |
+| | USB | DCh..DFh (empfohlener Port für Z9001) |
+Hinweis Für das Modul [[z9001:module_sonstige:guk_v8|]] **GU-K1520 von Kingstener** muss ein spezieller GAL genutzt werden, der die Port-Adresse DCh für USB unterstützt.
+==== SD-Modul ====
+s. [[..:erweiterungen:sdcard2|]]
+==== CH376-Modul ====
+[[..:module_sonstige:usbmodul|]]
 ===== Historie =====
 **27.02.2019** erste eigenständige Modul-Version
+Ich habe eine eigenständige Version usb-os.zip für die Arbeit ohne Mega-Modul/Kombi-Modul zusammengestellt. Die enthaltenen Programme für den USB-Stick und die Anleitung gelten auch für die Mega-Flash-Version.
+Im ROM sind auch die vom Mega-Flash bekannten Kommandos LOAD,SAVE,RUN,MEM,DUMP etc. enthalten.
 **05.03.2019** Neue Kommandos DIR und CD zur einfachen Arbeit mit USB
@@ Zeile 381: / Zeile 438: @@
 **22.10.2024**
-Umstrukturierung Code
+Der Quellcode wurde umstrukturiert und aufgeräumt.
+**10.2024**
+R.Hecht Adaption an CH376-USB-Modul [[z9001:module_sonstige:usbmodul|CH376]]
+**23.01.2025**
+Version für Kingsteners SD-Modul [[z9001:erweiterungen:sdcard2|SD-Modul]]
+**04.02.2025**
+CALL 5 DIR erweitert um Ablage im Speicher, neues Programm DIRX.COM