Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- homecomputer:ac1:picoac1 [2024/03/29 14:39] – [Bedienung] volkerp
+++ homecomputer:ac1:picoac1 [2024/12/05 13:18] (aktuell) – [Hardware] volkerp
@@ Zeile 21: / Zeile 21: @@
 Nach dem Anschließen der Stromversorgung sollte der picoAC1 ein Bild ähnlich wie folgt anzeigen:
-TODO
+{{:homecomputer:ac1:picoac1_start.jpg?600|}}
+Die mittig auf der Leiterplatte sitzende LED kennzeichnet den AC1-Betriebsmodus. Im CP/M-Betrieb ist sie dunkel ((nur bei BWS-Zugriffen wird sie kurz aktiviert))
 ===== Bedienung =====
@@ Zeile 28: / Zeile 31: @@
 Das Standard-System des picoAC1 ist eine Erweiterung des originalen Monitors 3.1 [[homecomputer:ac1:monitor31|]]. Statt des Minibasics gibt es zusätzliche Kommandos zur Arbeit mit der SD-Karte. Das Minibasic ist trotzdem mit dem Kommando "Z" verfügbar (s. [[#externe_funktionen|]]).
+{{:homecomputer:ac1:picoac1_start_monitor.jpg?600|}}\\ Verzeichnisse anzeigen, wechseln, Dateien anzeigen, Spiel laden, starten
+{{:homecomputer:ac1:picoac1_ghosttown.jpg?600|}}\\ Spiel
 ==== Tastatur ====
@@ Zeile 88: / Zeile 99: @@
 ===== Beispiel =====
-TODO
+  * {{ :homecomputer:ac1:picoac1_sd.zip |}} Inhalt der SD-Karte; einfach entpacken
+Auf der SD-Karte ist folgende Verzeichnisstruktur angelegt:
+<code>
+E: (PICOAC1)
+├───.ac1bin             der "Papierkorb"
+├───basic8k             BASIC8K_SD + Beispiele
+├───cpm                 Diskettenimages + Bios + dsk.sys + os.sys
+│   ├───ARCHIV          leere Images
+│   └───EXTERN          CP/M-Programme zum Import via LDEX
+├───edas                picoEDAS + Beispiele
+├───forth               Forth83 der IG Forth
+├───minibas             Minibasic-Programme
+└───spiele              Maschinencode-Spiele
+</code>
 ==== Systemdateien ====
@@ Zeile 106: / Zeile 132: @@
 im System "picoAC1   Monitor  V3.1 plus" stehen statt des Minibasic im EPROM zusätzliche Monitorkommandos. Diese dienen vor allem der Arbeit mit der SD-Karte.
-Die zusätzlichen Monitorkommandos sind **Kleinbuchstaben**, die originalen Kommandos des [[homecomputer:ac1:monitor31|Monitors 3.1]] i.d.R. **Grossbuchstaben**.
+Die zusätzlichen Monitorkommandos sind **Kleinbuchstaben**, die originalen Kommandos des [[homecomputer:ac1:monitor31|Monitors 3.1]] i.d.R. **Großbuchstaben**.
 Monitorkommandos bestehen aus einem Buchstaben/Zeichen und Argumenten.
@@ Zeile 116: / Zeile 142: @@
 Die Zeichenkette wird durch ein Leerzeichen abgeschlossen. Nachfolgende Zeichen werden ignoriert. D.h. Zeichenketten können keine Leerzeichen beinhalten.
+**s aaaa eeee ssss Dateiname/Infotext (save)**
+Hiermit kann man eine File ab der Adresse aaaa bis zur Adresse eeee mit der Startadresse ssss unter dem Namen Dateiname (Länge max 16 Zeichen) auf SD-Karte abspeichern. Dem Dateinamen kann ein Infotext angefügt werden. Beide Teile werden durch '/' getrennt. In diesem Fall wird im Header nicht der Dateiname sondern die Info gespeichert, die beim Laden angezeigt wird. Leerzeichen sind in der Gesamtheit nicht möglich.
-==== s - save - Daten auf SD-Karte schreiben ====
+**l Dateiname/Nr (list/load)**
-    s AAAA EEEE SSSS Dateiname/Infotext
+l (kleines "L") dient zum Auflisten bzw. Laden von Daten von der SD-Karte. Wird kein Dateiname angegeben oder enthält Dateiname das Wildcardzeichen "*", so wird das aktuelle Verzeichnis aufgelistet. Angezeigt werden alle Dateien, auf die Maske passt. Vorangestellt ist jedem Dateinamen eine Nummer (Index). Anhand dieser Indexnummer kann eine Datei geladen werden. Die Sortierung kann mit + und - gesteuert werden: l + -> Sortierung nach Änderungsdatum aufsteigend, l - -> Sortierung nach Änderungsdatum absteigend.\\
+Wird ein Dateiname oder eine Nummer angegeben, wird die Datei wird im aktuell gewählten Verzeichnis gesucht und ab der im Header angegebenen Anfangsadresse in den RAM geladen. Danach wird die Startadresse im Header nach ARG1 geladen, sodass das Programm mit "J:" gestartet werden kann. Die restlichen Headerparameter werden nur angezeigt.
-  AAAA Anfangsadresse
+**a AADR Dateiname (absolute)**
-  EEEE Endadresse
-  SSSS Startadresse
-  Dateiname - zulässige Zeichen entspr. FAT32, keine Wildcards, nicht casesensitiv
-  Infotext (optional)
-Dem Dateinamen kann ein Infotext angefügt werden. Beide Teile werden durch '/' getrennt. In diesem Fall wird im Header nicht der Dateiname sondern die Info gespeichert, die beim Laden angezeigt wird. Leerzeichen sind in der Gesamtheit nicht möglich.
+Lädt die Datei an Absolut-Adresse AADR. AADR < 1000H werden zurückgewiesen. Weiteres Verhalten wie beim "l"-Kommando.
-==== l - list/load - Daten von SD-Karte laden/aufisten ====
+**r Dateiname (remove)**
-    l Dateiname (kleines "L")
+Verschiebt Datei in den Papierkorb-Systemordner ".ac1bin". Am PC können Dateien in diesem Verzeichnis "wiederbelebt" oder endgültig gelöscht werden.
-Die Datei wird im aktuell gewählten Verzeichnis gesucht und ab der im Header angegebenen Anfangsadresse in den RAM geladen.
+**d Verzeichnisname/Nr (directory)**
-Danach wird die Startadresse im Header nach ARG1 geladen, sodass das Programm mit "J:" gestartet werden kann.
-Die restlichen Headerparameter werden nur angezeigt.
-Dateiinhalt des aktuellen Verzeichnisses auflisten
+Ohne Parameter werden alle Verzeichnisse aufgelistet. Enthält Verzeichnisname das Wildcardzeichen "*", so werden nur passende Verzeichnisse aufgelistet. Die Sortierung kann mit + und - gesteuert werden (vgl. Kommanndo "l").\\
+Wird ein Verzeichnisname oder eine Nummer angegeben, wird in das entsprechende Verzeichnis gewechselt. Mit "d /" wird ins Root-Verzeichnis gewechselt.
-    l *       --> gesamten Inhalt anzeigen. Der "*" kann entfallen.
+Es wird mit einer Verzeichnisebene unterhalb von Root gearbeitet. Weitere Unterverzeichnisse werden nicht unterstützt.
-    l XX*   --> alle Dateien anzeigen, die mit "XX" beginnen
+Beim Auflisten wird das aktuell gewählte Verzeichnis mit einem '*' markiert.
-    l *.bas --> alle Dateien anzeigen, die mit ".bas" enden
+Es ist möglich, direkt von einem in ein anderes Verzeichnis zu wechseln. Ein Umweg über das Root-Verzeichnis ist nicht erforderlich.
-Das "l"-Kommando bezieht sich auf das aktuell ausgewählte Verzeichnis. O.g. Kommandos geben eine alphabetisch sortierte Liste aus.
+**m Verzeichnisname (makedir)**
-    l + --> Sortierung nach Änderungsdatum aufsteigend
+Es wird ein neues Verzeichnis unterhalb von Root angelegt. Es ist dabei unerheblich, ob man sich aktuell im Root- oder einem Unterverzeichnis befindet. Das Löschen von Verzeichnissen kann nur am PC erfolgen.
-    l -   --> Sortierung nach Änderungsdatum absteigend
-Dateilisten sind auf 256 Einträge eines Verzeichnisses begrenzt.
+**t YYYY-MM-DD*hh:mm:ss (time)**
-Laden von Dateien an Hand der Indexnummer
+Ohne Parameter wird die aktuelle Uhrzeit angezeigt, mit Parameter wird die Uhr gestellt. Die Systemzeit ist dabei in UTC (MEZ-1h | MESZ-2h) zu setzen. Diese Zeitbasis wird zum Speichern auf SD-Karte benötigt. Andernfalls wird am PC ein falscher Zeitstempel angezeigt!
-Mit dem l-Kommando können Inhalte des aktuell gewählten Verzeichnisses angezeigt werden. Vorangestellt ist jedem Dateinamen eine lfd Nummer (Index). Anhand dieser Indexnummer keine eine Datei geladen werden.
+**c v:h:r (color)**
-Beispiel 1:
-    l 5 --> lädt die Datei mit der lfd Nummer 05.
+Setzt die drei Bildschirmfarben für Vordergrund, Hintergrund und Rahmen. Ohne Parameter wird die Farbliste ausgeben.
+Der dritte Parameter ist optional. Bei weglassen wird '0' = Schwarz angenommen. Beispiel: "c 7:0:3"
-Beispiel 2:
+**H (help)**
+**h (help)**
-    l -   --> Anzeigen der Dateinamen, aktuellste Datei zuerst
+Anzeige der Bedienung des Ur-Monitors 3.1 mit H, die Bedienung der Monitorerweiterungen mit "h".
-    l 1  --> lädt die zuletzt gespeicherte Datei
-Die Nummerierung richtet sich immer nach der zuletzt angezeigten Liste.
+==== Drucken in Datei ====
-Nebenwirkung: Es sollten keine Datei- und Verzeichnisnamen vergeben werden, die ausschließlich aus Numerischen Zeichen bestehen. Mindestens ein Buchstabe, Sonderzeichen oder Punkt sollte enthalten sein.
+    Left-Strg + Alt + p
-==== a - addr - Laden von Dateien an Absolut-Adresse im RAM ====
+Dabei handelt es sich um eine Hilfsfunktion, um Zeichen, die von Anwendungsprogrammen an eine Druckerschnittstelle im Monitor übergeben werden, in eine Textdatei umzulenken. Diese Dateien können **NUR** am PC betrachtet, bearbeitet oder gedruckt werden.
+Gestartet wird die Funktion mit der Tastenkombination Left-Strg + Alt + P. Dabei wird automatisch ein Dateiname PXXXX.txt erzeugt, wobei XXXX eine fortlaufende Nummer ist, die in der .config gespeichert wird.
+Danach ist das Anwenderprogramm zum Drucken zu veranlassen und nach Abschluss des Vorgangs ist wiederholt Left-Strg + Alt + P zu betätigen. Erst dann wird die Datei auf der SD-Karte gespeichert.
+In der Statuszeile wird Dateiname und Fortschritt angezeigt.
+==== Externe Funktionen ====
-    a AADR Dateiname
+Funktionen / Kommandos, die nicht im EPROM Platz gefunden haben oder weichen mussten, lassen sich im Flash des picoIO einbinden und per Kommandozeichen über die ZCOM-Schnittstelle in den RAM laden und starten.
-AADR < 1000H werden zurückgewiesen. Es wird nur die Anfangsadresse geprüft.
+Aktuell eingebundene Kommandos:
-Weiteres Verhalten wie beim "l"-Kommando
-Beispiel:
+    Z --> MiniBasic-Interpreter nach 0F000h laden und dort starten.
-    a C000 5
+Beim Verlassen wird angeboten, das Basic-Programm per Kommandozeile zu speichern. Hierzu ist das Prompt-Symbol '#' zu löschen und ein individueller Name zu vergeben.
-Lädt die 5.Datei der zuletzt ausgegebenen Liste nach 0C000H.
+===== Hardware =====
-==== r - remove - Datei in Papierkorb verschieben ====
+Die Funktionsweise der Hardware ist auf https://www.bw38.de/picoac1 ausführlich beschrieben. Hier nur ein paar Bemerkungen:
+^ Merkmal     ^ Beschreibung                                             ^
+| CPU         | U880                                                     |
+| ROM         | 4K 0000-0FFF (Monitor)                                   |
+| RAM         | 64K 1000-FFFF (ab 0000 im CP/M-Modus)                    |
+| Takt        | 1,2,4,8 MHz                                              |
+| Anzeige     | 64x32 Zeichen, s/w, versch. Zeichensätze möglich         |
+| Tastatur    | ASCII                                                    |
+| Peripherie  | 1 PIO, 1 CTC                                             |
+|             | Videoprozessor (raspberry pico )                         |
+|             | I/O-Prozessor (USB-Keyboard, SD-Karte) (raspberry pico)  |
-    r Dateiname
+^ Port | Verwendung |
+| 00-03 | CTC |
+| 04-07 | PIO |
+| 1C(-1F) | CP/M-Umschaltung |
-Der Dateiname wird um einen TimestampSuffix der aktuellen Systemzeit (.YYMMDDhhmmss) ergänzt und die Datei in den Systemordner ".ac1bin" auf der SD-Karte verschoben. Am PC können Dateien in diesem Verzeichnis "wiederbelebt" oder endgültig gelöscht werden.
-==== d - directory - Verzeichnisse anzeigen / wechseln ====
+Der picoAC1 entspricht einem AC1 mit 64K RAM und CP/M-Umschaltung.
+Auf der Platine sitzt ein 128K-SRAM. Dessen Kapazität kann allerdings nicht komplett genutzt werden. Die beiden 64K-Bänke werden parallel genutzt. Die untere Bank (A16=L) wird als Bildwiederholspeicher und Arbeitszellenspeicher genutzt (1000h-17FFh), auf andere Bereiche der Bank ist kein Zugriff möglich! Die obere Bank (A16=H) wird als normaler RAM ab 2000h, genutzt, im CP/M-Modus durchgehend ab 0000-FFFFh.
-    d Verzeichnisname --> Setzen des aktuellen Arbeitsverzeichnisses
+Die Umschaltung in den CP/M-Modus erfolgt durch ein Latch auf Port 1Ch(..1Fh). OUT 1Ch, Bit0=0 schaltet den AC1-Modus ein (Monitor-ROM, BWS aktiv), OUT 1Ch, Bit0=1 schaltet den CP/M-Modus ein (durchgehend RAM).
-    d* --> Auflisten aller Verzeichnisse, alphabetisch sortiert, '*' kann entfallen
-    d+ --> Liste nach Dateidatum sortiert, aufsteigend
-    d- --> Liste nach Dateidatum sortiert, absteigend
-    d *abc* --> auflisten aller Ordner, die die Zeichenfolge "abc" im Namen enthalten.
-    d / --> wechseln ins Root-Verzeichnis
-    d1 --> wechseln ins Verzeichnis mit ldf Nummer(1), entspr. der zuletzt ausgegebenen Liste
-Es wird mit einer Verzeichnisebene unterhalb von Root gearbeitet. Weitere Unterverzeichnisse werden nicht unterstützt.
+<a2s>
-Beim Auflisten wird das aktuell gewählte Verzeichnis mit einem '*' markiert.
+  FFFF      #-----------#     #-----------#
-Es ist möglich, direkt von einem in ein anderes Verzeichnis zu wechseln. Ein Umweg über das Root-Verzeichnis ist nicht erforderlich.
+            |           |     |           |
+            |           |     |           |
+            |  RAM      |     |  RAM      |
+            |           |     |           |
+            |           |     |           |
+      #-----------#     |           |
+            |  Mon-RAM  |     |           |
+            |  2K       |     |           |
+      #-----------#     |           |
+            |  BWS      |     |           |
+            |  2K       |     |           |
+      #-----------#     |           |
+            |  Monitor  |     |           |
+            |  4K       |     |           |
+      #-----------#     #-----------#
-==== m - makedir - Verzeichnis anlegen ====
+              OUT 1Ch,0         OUT 1Ch,1
+</a2s>
-    m Verzeichnisname
-Es wird ein neues Verzeichnis unterhalb von Root angelegt. Es ist dabei unerheblich, ob man sich aktuell im Root- oder einem Unterverzeichnis befindet. Es kann kein Verzeichnis angelegt werden, wenn bereits eine gleichnamige Datei im Wurzelverzeichnis existiert.
+Zeichensätze:
-Das Löschen von Verzeichnissen kann nur am PC erfolgen.
-==== t - time - Zeitfunktionen ====
+{{:homecomputer:ac1:picoac1_zs_ac1.jpg?600|}}\\ Zeichensatz AC1
-    t YYYY-MM-DD*hh:mm:ss
+{{:homecomputer:ac1:picoac1_zs_scch.jpg?600|}}\\ Zeichensatz SCCH mit Umlauten
-    t 2023-09-03*18:05:45 --> Systemzeit setzen
-    t --> Anzeige der aktuellen Systemzeit
-Falls ein RTC-Modul installiert ist, wird die Zeit beim picoIO-Start übernommen.
-Die Systemzeit ist in UTC (MEZ-1h | MESZ-2h) zu setzen. Diese Zeitbasis wird zum Speichern auf SD-Karte benötigt. Andernfalls wird am PC ein falscher Zeitstempel angezeigt.
-Beim Setzen der Systemzeit ist das Format einzuhalten. Entscheidend ist die Position der Ziffern in der Zeichenkette. Die Trennzeichen sind beliebig.
+===== CP/M =====
-Die Eingabe erfolgt als Zeichenkette und unterliegt o.g. Einschränkungen, d.h. Leerzeichen sind unzulässig.
-==== c - color - Bildschirmfarben ====
+Aktuell gibt es eine CP/M-2.2-kompatible Implementierung.
-    c 7:0:3 -> Zeichen-, Hintergrund- und Rahmenfarbe
+Für den Betrieb von CP/M sind auf der SD-Karte diverse Dateien abzulegen, am besten in einem eigenen Verzeichnis.
-    c --> Farbliste ausgeben
-Der dritte Parameter ist optional. Bei weglassen wird '0' = Schwarz angenommen.
+TODO
-==== h/H - help - Hilfetexte ausgeben ====
+Es gibt 6 Laufwerke A-F, die als Disketten-Image auf der SD-Karte liegen.
+C und D sind dabei 8 MByte große "Festplatten". Die Erstbefüllung dieser "Disketten" erfolgt mit dem internen Kommando LDEX oder am PC mit den [[cpm:cpmtools|]].
-    H --> Bedienung "Ur-"Monitor"
+Der Bildschirmtreiber nutzt die Cursor-Positionierung nach SCP. Steuerzeichen:
-    h --> Bedienung "Monitorerweiterungen"
+<code>
+; Bildschirm-Steuerzeichen, SCP-kompatibel
+; 00h            NOP (keine Wirkung)
+; 01h            Cursor links oben (home)
+; 07h            akustisches  Zeichen (keine Funktion)
+; 08h            Cursor zurueck
+; 0ah            Linefeed (neue Zeile)
+; 0ch            Bildschirm  löschen (verzögert zum Lesen  der
+;                zuletzt ausgegebenen Bildschirmzeilen), Cursor
+;                links oben
+; 0dh            Carriage Return (an Zeilenanfang)
+; 14h            Rest des Bildschirms löschen
+; 15h            Cursor nach rechts
+; 16h            Rest der Zeile löschen
+; 18h            Zeile löschen, Cursor an Zeilenanfang
+; 1ah            Cursor eine Zeile hoch
+; 1bh            Einleitung  Cursorpositionierfolge, die näch-
+;                sten beiden Bytes beinhalten Zeile und  Spalte
+;                Offset 00h oder 80h
+; 7fh            Delete (streichen Zeichen links vom Kursor)
+; 20H..7EH       ASCII-Zeichen
+</code>
-==== Drucken in Datei ====
+Hier die **diskdefs** für die [[cpm:cpmtools|]] (ohne Gewähr!)
-    LStrg + Alt + p
+<code>
+# 800K AC1PICO-Hausformat
+diskdef ac1
+  seclen 512
+  tracks 10
+  sectrk 160
+  blocksize 2048
+  maxdir 256
+  skew 0
+  boottrk 0
+  os 2.2
+end
-Dabei handelt es sich um eine Hilfsfunktion, um Zeichen, die von Anwendungsprogrammen an eine Druckerschnittstelle im Monitor übergeben werden, in eine Textdatei umzulenken. Diese Dateien können **NUR** am PC betrachtet, bearbeitet oder gedruckt werden.
+# 8MB AC1PICO-Hausformat
-Gestartet wird die Funktion mit der Tastenkombination LStrg + Alt + P. Dabei wird automatisch ein Dateiname PXXXX.txt erzeugt, wobei XXXX eine fortlaufende Nummer ist, die in der .config gespeichert wird.
+diskdef ac1_8mb
-Danach ist das Anwenderprogramm zum Drucken zu veranlassen und nach Abschluss des Vorgangs ist wiederholt LStrg + Alt + P zu betätigen. Erst dann wird die Datei auf der SD-Karte gespeichert.
+  seclen 512
-In der Statuszeile wird Dateiname und Fortschritt angezeigt.
+  tracks 32
+  sectrk 512
+  blocksize 4096
+  maxdir 512
+  skew 0
+  boottrk 0
+  os 2.2
+end
+</code>
-==== Externe Funktionen ====
+Starten von CP/M aus dem Monitor:
-Funktionen / Kommandos, die nicht im EPROM Platz gefunden haben oder weichen mussten, lassen sich im Flash des picoIO einbinden und per Kommandozeichen über die ZCOM-Schnittstelle in den RAM laden und starten.
+{{:homecomputer:ac1:picoac1_cpm1.jpg?600|}}\\ Verzeichnis wechseln, Bios laden, Bios starten
-Aktuell eingebundene Kommandos:
+Importieren und Starten von CP/M-Programmen:
-    Z --> MiniBasic-Interpreter nach 0F000h laden und dort starten.
-Beim Verlassen wird angeboten, das Basic-Programm per Kommandozeile zu speichern. Hierzu ist das Prompt-Symbol '#' zu löschen und ein individueller Name zu vergeben.
+{{:homecomputer:ac1:picoac1_cpm3.jpg?600|}}\\ mit LDEX werden Programme aus dem SD-Karten-Unterverzeichnis "extern" auf die CP/M-Diskette kopiert.