Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- z9001:software:usb [2022/09/28 09:00] – [JKCEMU] 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
-Verwenden eines USB-Sticks zum Speichern/Laden anstelle eines Kassettenrekorders.
+{{:z9001:module_sonstige:gide_usb_rtc_modul.jpg?0x200|}} {{:z9001:module_sonstige:ch376-modul_felge.jpg?0x200|}}{{:z9001:erweiterungen:sd-module3.jpg?0x100|}}
+**2016: USB/VDIP im OS-Modus**
-Benötigt wird ein **[[z9001:module_sonstige:gide_usb|]]** mit einem VDIP1-Modul oder einem V2DIP-Modul.
+**2024: Version für CH376 [[z9001:module_sonstige:usbmodul|CH376]]**
-Beschreibung des VDIP-Moduls s. [[z9001:module_sonstige:gide_usb#vdip1|VDIP1]] und [[z9001:module_sonstige:gide_usb#v2dip|]].
-Es funktionieren auch kompatible Module wie **GU-K1520 von Kingstener** oder das **[[z1013:module:usb|Z1013-USB-Modul]] von Lötspitze**. Prozipiell wird nur eine PIO und ein VDIP-Modul benötigt. Die [[z9001:module_sonstige:gide_usb#hardware1|Schaltung]] ist für alle Module gleich!
+**2025: Version für SD-Modul [[z9001:erweiterungen:sdcard2|]]**
-{{:z9001:module_sonstige:usb-modul-0.jpg?300|}} {{:z9001:module_sonstige:vdip1-1.jpg?300|}}\\ Modul, und Teilbestückung nur USB
+{{youtube>lWoKiIBZa0A}}
+{{:z9001:erweiterungen:kc87_sd_os.mp4|Start SD-Modul von Kingstener}}
+Verwenden eines USB-Sticks bzw. SD-Karte zum Speichern/Laden anstelle eines Kassettenrekorders.\\
+Das System lässt sich auch im Emulator [[#jkcemu]] testen!
-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.
+===== Download =====
-Ein [[z9001:module_sonstige:gide_usb#v2dip|V2DIP-Modul]] unterstützt normalerweise nur FAT 16 und FAT32.
-**Jumper**:
+  * 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
-  * USB Jumper JP5 (unter dem DOM-Modul) v.u.n.o. A2..A7. Es ist nur A5 gejumpert (Port DCh)
+**Hinweis**: Das Programm wird als USBX/SDX/CHX auch im Rahmen der Mega-Flash-Software gepflegt.
-  * 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 44: / 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 05.10.2021, incl. Quellcodes etc.
-  * Binär-Version {{ :z9001:software:usb-os-bin.zip |}}
-  * Handbuch {{ :z9001:software:usb-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.
+===== Laden =====
-**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.
+**USB-OS**
-Im ROM sind auch die vom Mega-Flash bekannten Kommandos LOAD,SAVE,RUN,MEM,DUMP etc. enthalten.
-Abweichungen:
+Das USB-System startet automatisch vom ROM-Modul.
-^ USB-OS  ^ Mega-Flash  ^
-| DIR     | DDIR        |
-| MENU    | DIR         |
-Anleitung s. Handbuch {{ :z9001:software:usb-os.pdf |Handbuch }} und usb-os.txt im Download-Paket.
+**Megaflash-Software**
-===== Laden =====
 Die derzeitige Version **USB** belegt den Speicherbereich von B800h-BCFFh. Das ist ein Kompromiss, um trotzdem mit BASIC, Assembler u.v.a. Programmen testen zu können, ohne ständig auf EOR oder anderes achten zu müssen. Der Speicher für Treiber oder andere Systemtools bleibt frei, der Speicher am RAM-Ende (unterhalb C000h) steht auch zur Verfügung.
@@ Zeile 73: / 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 88: / 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 Diskette und Kassette umgeschaltet werden.
+Im Z9001-OS kann mit "DOS" bzw. "CAOS" zwischen USB und Kassette umgeschaltet werden.
-**USB** allgemeine Funktionen, Verzeichiswechsel
+**USB** (VDIP) allgemeine Funktionen, Verzeichniswechsel
 ^ Kommando ^ Bemerkung ^
@@ Zeile 112: / 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 154: / Zeile 129: @@
-===== USB-OS =====
+===== USB-OS (VDIP) =====
-| Dateiname | (modul.rom) |
+| Dateiname | (vdipos.rom) |
 | Laden in | OS |
 | Programmstandort | C000-C3FF |
@@ Zeile 167: / 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 259: / Zeile 254: @@
 eine Verzeichnisebene zurück und CD "/" wechselt direkt ins Root-Verzeichnis.
-**09.12.2019**: Neues Kommando HELP, DIR-Anzeige in BASIC nun ohne Erweiterung, interne Anpassungen
+**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 274: / Zeile 306: @@
 von Diskette (incl. Feldern und ASCII).
-Im aktuellen [[z9001:module_sonstige:megaflash|]] ist dieses BASIC bereits enthalten.
+Zusätzlich gibt es die neuen Basic-Befehle DIR und CD.
-{{:z9001:software:usb-basic.gif|}}\\ Es wird ein Kopfblock 0 geschrieben, der nur den korrekten Dateinamen enthält (Byte 0..11). Damit sind BASIC-Programme speicherkompatibel zu OS-Programmen.
-:!: **23.11.2017: Die aktuelle Software schreibt den Kopfblock 0 nicht mehr**, wenn ein spezielles Flag (fcb+24='N') gesetzt ist. Das
-wird nun in BASIC genutzt. Damit sind die erzeugten SSS-Dateien kompatibel zu CP/M (ZBS). Sie werden im USB-OS auch mit dem Dateityp .ZBS gespeichert.
 **ZMxx** funktioniert (gepatchte Version). mit AP=T und Paadr_eadr_sadr wird gespeichert (s. [[z9001:software:zm#kassettenarbeit|]]. Die originalen Versionen funktionieren nicht mit Diskette/USB. Die Punch/Reader-Treiber für Kassette springen leider direkt in den Monitor und nutzen nicht CALL 5.
@@ Zeile 290: / Zeile 317: @@
 ===== JKCEMU =====
-**Ausprobieren/Nutzen von USB-OS im JKCEMU**
+**Ausprobieren/Verwenden von USB-OS im [[http://www.jens-mueller.org/jkcemu|JKCEMU - Kleincomputer-Emulator]]**
 {{:z9001:software:jkcemu-usb-os.jpg?600|}}
@@ Zeile 319: / 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 350: / Zeile 423: @@
 Testweise SYSINFO0 im Modul-ROM enthalten.
 Anleitungen, Handbücher etc. im Paket!
+**01.07.2021**
+ausführliche Modul-Dokumentation als PDF, Programmübersicht "usb-stick programme.txt"
+FILL ohne Parameter löscht 300-BFFF (ala CLEAR MEMORY)
+CTRL-C bei DIR in BASIC bricht ab (vorher Rücksprung ins OS)
+CRT-Treiber im OS integeriert (schnelles CLS, ASCII-Spezialzeichen mit @)
+CALL 5 CLOAD neu A=3 wie A=1, aber ohne initiales GVAL (Anwendung s. HLPKDO)
+R-NLREG, R-PERDAT korrigiert. WORD, SYSINFO, HLPEDIT, CRT40 aktualisiert
+neu CHIP-8, Programme Kassetten INFORMATIK
+zusätzliche und korrigierte Dokus.
+**05.10.2021**
+SYSINFO0 Umstellung von bitbuster_extreme auf ZX7.
+**22.10.2024**
+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