Datei: OS-Apps.DOK                             8. Februar im Jahre des CPC 2018


    Dokumentation zu einigen mitgelieferten Applikationen fr das Future OS
    =======================================================================

  I. OS Konfiguration: Das OS  kann  neu konfiguriert werden. Diese Applikation
     erlaubt das einstellen wichtiger Parameter.

 II. OS Infos: Informationen zum Status des OS anzeigen (RAM, ROM, etc).

III. Zeige-Tasten: Dieses Programm  zeigt  an  welche Tasten bzw. Kombinationen
     von Tasten gedrckt werden.

 IV. Zeichen-Demo: Es werden einige OS Funktionen des FutureOS demonstriert.










            I. Die Konfiguration des FutureOS mittels 'Konfig OS':
            ------------------------------------------------------
Das 'Konfig OS' Utility bietet  die  Mglichkeit  einen Vielzahl von Parametern
des FutureOS einzustellen. Zustzlich kann  man auch die Spurwechselzeit (Step-
Rates) aller Laufwerke einzen einstellen.
Die Konfiguration ist in den sogenannten  Konfig-Bytes enthalten. Die Daten der
aktuellen Konfiguration des FutureOS  knnen  auch  ins ROM geschrieben werden,
dadurch ist die neue Konfiguration beim Systemstart aktiv.
Auch die genderten Spurwechselzeiten knnen ins ROM bernommen werden.

Das Programm 'Konfig OS' ist auch im TOOL-ROM enthalten und kann somit auch aus
dem Erweiterungs-ROM gestartet werden.

ACHTUNG: Eine Vielzahl von Erweiterungs-Hardware  wird von FutureOS automatisch
erkannt und in den Bytes der Konfiguration vermerkt. Diese automatisch erkannte
Hardware wird von 'Konfig OS' nicht behandelt.

Nach dem Start des Programms 'Konfig  OS'  erscheint das Hauptmenu, dort stehen
acht Punkte zur Auswahl:






1. RAM-Konfig. zeigen/editieren
-------------------------------
Mit Punkt 1. ist es mglich  die  gerade aktive Konfiguration zu editieren. Die
Daten werden aus dem RAM gelesen,  und  nach  ihrer Anpassung wieder in das RAM
(ab System-Variable KF_MED) geschrieben.
Whlt man diesen Punkt,  dann  erscheint  zuerst  eine  Hilfs-Seite, die einige
Informationen ber die Bedienung gibt. Nach  dem  Druck einer Taste beginnt das
Editieren der Konfiguration. Dabei sind folgende Systemparameter editierbar:

- Festplatte und deren Typ (Dobbertin HD20 oder Vortex)
- Kassettenlaufwerk vorhanden
- Echtzeituhr, und deren Typ (Dobbertin oder dk'tronics)
- Zeit und Datum, entweder als Icon darstellen oder als Buchstaben (unten)
- Spartan-Modus, alle Icons immer darstellen oder nur nutzbare Icons darstellen
- DIR, sollen Inhaltsverzeichnisse automatisch oder mittels DIR gelesen werden
- Zahlensyste, hexadezimal oder dezimal
- Serielle Schnittstelle, und deren Typ
- Paralelle Schnittstelle, 7 oder 8 Bit
- Bildschirm farbig oder monochrom-grn
- Sprache des Anwenders, Deutsch, Englisch, Franzsisch oder Spanisch
- CPC Modell: 464/664/6128, 464plus/6128plus etc.
- MultiPlay vorhanden
- 8 Bit Digiblaster vorhanden
- Netzwerkkarte vorhanden

Fr jedes Laufwerk kann sein Vorhandensein, seine physikalische Gre, Spurzahl
und die Seitenzahl angegeben werden. Auerdem wird  noch die Version des OS und
die Versionsnummer des Anwenders (sammt Pseudo) angezeigt.

2. ROM-Konfig. zeigen/editieren
-------------------------------
Dieser Punkt entspricht Punkt 1.  Allerdings  wird  die Konfiguration aus ROM C
gelesen. Man editiert also die  im  ROM festgelegte Konfiguration, alle vorigen
nderungen im RAM (siehe Punkt  1)  werden  dadurch nichtig. Nach dem Editieren
werden die neue Konfiguration im RAM abgelegt und dort aktiviert.

3. Konfiguration in ROM kopieren
--------------------------------
Die aktuelle  Konfiguration  kann  mittels  Punkt  3.  vom  RAM  in  das  ROM C
installiert werden. Man  sollte  einfach  den  Anweisungen  auf  dem Bildschirm
folgen. Dies ist nur mglich  wenn  man  ein  X-MEM, SYMBiFACE II, FlashGordon,
MegaFlash, ROM-RAM-Box oder hnliches verwendet.  Bei der Verwendung von EPROMs
ist dies leider nicht mglich.

4. ROM-Konfig. ins RAM kopieren
-------------------------------
Die Konfiguration aus ROM C wird  ins  RAM kopiert (ab der RAM-Variablen KF_MED
- Adresse &B96E) und dadurch aktiv. Dies  ist  z.B. dann sinnvoll, wenn man die
unter Punkt 1 gemachten nderungen wieder rckgngig machen will.

5. SpurWechselZeitEn editieren
------------------------------
Mit den Cursortasten lassen sich  hier  die  Spurwechselzeiten (SWZ) aller acht
Floppy-Laufwerke einstellen. Auf/Ab whlt das  LW  (A  bis H) aus, rechts/links
selektiert die Spurwechselzeit im ms (hexadezimal).
Fr 3.5" und 5.25" Laufwerke solle eine SWZ  von 4 ms verwendet werden, und fr
3" Laufwerke eine SWZ von &0A (=  10)  ms.  Achtung:  Wenn man die SWZ zu klein
gewhlt hat, dann kann man nicht mehr mit dem Laufwerk arbeiten.
Mit Copy wird der Editiervorgang beendet, die neuen SWZ sind nun aktiv. Mittels
ESC wird der Vorgang abgebrochen, die SWZ bleiben unverndert erhalten.

6. SWZ vom RAM ins ROM kopieren
-------------------------------
Dieser Punkt erlaubt es die  unter  Punkt 5. genderten Spurwechselzeiten (SWZ)
ins ROM (von X-MEM, SF2, RRB, FG, MF  etc.) zu bernehmen. Wie auch unter Punkt
3. einfach den Anweisungen folgen.

7. Testsummen der ROMs anpassen
-------------------------------
Nachdem man eine genderte Konfiguration  ins  ROM  (des  X-MEM, RRB, SF2 etc.)
geschrieben hat oder die SWZ im  ROM  angepasst  hat sollten die Prfsummen der
ROMs angepasst werden. Dafr  kann  Punkt  7  verwendet werden. Alternativ kann
auch der ROManager verwendet werden.


8. Beenden der Konfiguration!
-----------------------------
Das Programm wird verlassen, die Konfiguration wird aktiviert. Auch die SWZ und
die Laufwerks-Variablen TURBO_A..M werden neu  initialisiert. Erst dadurch wird
die neue Konfiguration fr Floppy-Laufwerke aktiv.
Abgesehen vom Druck auf die  Ziffer  <8>  kann  man  das Programm jederzeit mit
Hilfe der ESC Taste verlassen.

Sinn dieses Programms: Er liegt vor allem darin, Optionen des OS anzupassen und
dem OS das Vorhandensein diverser Zusatzhardware anzuzeigen.
* Ersetzt man z.B. sein 40 Track B-Laufwerk  durch ein 80 Track LW, so kann und
sollte man das in den Konfigurations-Bytes  einstellen,  und das OS wird darauf
auch Rcksicht nehmen (z.B. Kopieren, Formatieren).
* Eine Applikation kann sich aus  den  Bytes der Konfiguration jederzeit genaue
Informationen holen in welcher Umgebung es gerade luft, deshalb sollte man die
Konfig-Bytes immer einigermaen sauber halten.
* Eine Demo z.B. braucht  nicht  mehr  abzufragen  ob  ein Farb- oder ein Grn-
Monitor angeschlossen ist, ein Blick in die Konfig-Bytes gengt.
* Ein Spiel kann z.B. abfragen, ob ein MultiPlay vorhanden ist.

Wichtiger Hinweis:
------------------
Eine Vielzahl von Parametern stellt  FutureOS beim Systemstart automatisch ein,
ein Blick in die Konfigurations-Bytes (siehe #OS-VAR.DEU ab KF_MED) lohnt sich.

                 II. Informationen zum System durch 'OS Infos'
                 ---------------------------------------------
Das Programm "OS Info" informiert ber den aktuellen Status des FutureOS, dabei
werden Informationen ber angeschlossenes Erweiterungs-RAM (E-RAM) und die ROMs
des OS, sowie ber Tastatur-Belegung und die Steuerzeichen gegeben.
Das Programm 'OS Infos' befindet sich auch im 'TOOL-ROM'.
Nach dem Start des  Programms  gelangt  man  ins  Hauptmenue,  dort stehen fnf
Punkte zur Auswahl:

1. Infos zur Exp.-RAM Belegung
------------------------------
Whlt man diesen Punkt, so erscheint zuerst eine Hilfsseite, die RAM-Verwaltung
und die Abkrzungen erklrt.
Nach dem Druck einer Taste wird man  ber die momentane RAM Belegung der ersten
512  KB  Erweiterungs-RAM  (E-RAM)  informiert,  dies  geschieht  grafisch  und
textalsich. Jeder 16 KB E-RAM Block  wird dargestellt und seine Verwendung wird
angezeigt. Unter FutureOS existiert fr jeden  16 KB Block eine eigene Variable
XRAM_C4..FF, die Aufschlu  ber  die  momentane  Verwendung  gibt. Abkrzungen
werden auf der Hilfsseite erklrt.
Nach dem Druck auf eine Taste wird  die Belegung der insgesamt adressierbaren 4
MB E-RAM informiert. Hierbei wird  das  Vorhandensein  /  das Fehlen von 128 KB
groen E-RAM Blcken angezeigt.
Der Druck einer weiteren Taste bringt einen zurck ins Hauptmenue.


2. Belegung der FutureOS ROMs
-----------------------------
Dieser Punkt zeigt an, unter welchen physikalischen  ROM Nummern die vier 16 KB
ROMs des FutureOS sitzen. Auerdem werden die Checksummen-Bytes der jehweiligen
ROMs (Adresse  &FFFF  im  ROM)  angezeigt,  darunter  wird  die  neu berechnete
Testsumme angezeigt. So kann man mit  einem  Blick die Integritt der vier ROMs
testen. Die beiden Testsummen eines jeden  ROMs sollten identisch sein, ist das
nicht der Fall so  knnen  sie  mittels  'Konfig  OS'  oder mit dem 'ROManager'
angepasst werden.
Achtung: wenn man z. B.  die  Konfigurations-Bytes  in  ROM C oder die Steprate
einens LWs in ROM B ndert, dann  sind die beiden Prfsummen des entsprechenden
ROMs nicht mehr identisch und sollten angeglicher werden.
Das Verfahren nachdem die Checksumme  gebildet  wird stimmt mit dem Algorithmus
von Dobberin, Inicron, Arnor, dk'tronics etc. berein.

3. Belegung der Tastatur-Ebenen
-------------------------------
Die Tastatur-Matrix des CPC verwaltet  80  Tasten (incl. zwei Joysticks). Jeder
Taste knnen vier verschiedene  Zeichen  zugeordnet  werden. Denn es existieren
vier Tastaturebenen: Normal, Shift, Control und Shift+Control.
Dieser Punkt zeigt die einer  Taste  aktuell  zugewiesenen  Zeichen an. Hat man
irgendeiner Taste einen anderen Wert zugewiesen, so erscheint das entsprechende
Zeichen invertiert. Bei einigen Zeichen  ist  die  Invertierung nicht leicht zu
erkennen. In der ersten Zeile die Standartbelegung als Referenz gegeben.

4. Status der Steuerzeichen 0-31
--------------------------------
Dieser Punkt zeigt an, ob irgendein Steuerzeichen verndert wurde. Es werden je
fr Mode 1 und Mode  2  alle  32  Steuerzeichen  geprft. Es erscheint entweder
"ROM" wenn das  Steuerzeichen  noch  unangetastet  ist,  oder  "RAM",  wenn die
Sprungadresse des Steuerzeichens verndert wurde.
Achtung: Vernderte Steuerzeichen knnen die Systemstabilitt beeinflussen!

5. Beenden dieser Applikation
-----------------------------
Wie man sich  unschwer  denken  kann,  dient  dieser  Punkt  zum  Verlassen des
Programms und der Rckkehr ins Turbo-Desktop des FutureOS.
Abgesehen vom Druck auf die  Ziffer  >5<  kann  man  das Programm jederzeit mit
Hilfe der ESC Taste verlassen.

Achtung: Es darf auf keinen Fall im Hauptmenue die Taste "0" gedrckt werden!
Diese  Spezialfunktion  ist  den   Anwendern   der  T8000  Gunhead  Erweiterung
vorbehalten!







                III. Anzeige der Tastatur mittels 'Zeige-Tasten'
                ------------------------------------------------
Das Programm Zeige-Tasten  ist  ein  Hilfsprogramm,  welches mehrere Funktionen
zugleich ausbt. Nach dem Start  des  Programms  wird links die Tastatur-Matrix
des CPC dargestellet. Mittig wird das  aktuelle Zeichen des ROM-Zeichensatz und
rechts das des  Zeichen-RAMs  dargestellt.  Das  rechte  Feld bleibt allerdings
leer, wenn ab &3800 kein extra RAM-Zeichesatz geladen wurde.
Man kann nun irgendwelche  Tasten  drcken,  wahlweise  mit Shift, Control oder
Shift & Control. Es ist  auch  mglich  mehrere Tasten gleichzeitig zu drcken.
Die Tastaturmatrix (links) zeigt dann interessante Effekte.
Bei jedem Tastendruck wird das,  dieser Taste zugewiesene, Zeichen dargestellt.
Auerdem wird oben rechts der HEX-Wert dieses Zeichens ausgegeben. Will man den
Wert irgend eines Zeichens ermitteln, so ist einfach die entsprechende Taste zu
drcken.
Drckt man mehrere Tasten zugleich,  dann  wird  das Zeichen angezeigt, das die
hchste Prioritt hat. Auf  diese  Weise  kann  man  also die Prioritt einiger
Tasten vergleichen.
Desweiteren  kann  man  dieses  Programm   benutzen,   um   zu  sehen  wie  die
Tastaturmatix reagiert wenn man mehrere  Tasten  gleichzeitig drckt. So knnen
Fehlfunktionen bei der Abfrage von Tasten-Kombinationen vermieden werden.
Das Programm kann man entweder mit der ESC Taste oder mit Control-D verlassen.




                                IV. Zeichen-Demo
                                ----------------
Dieses  kurze  Programm   demonstriert   einige  Zeichenausgabe-Funktionen  des
FutureOS. Der mitgelieferte Source-Code zeigt wie man auf einfachste Weise Text
darstellen kann.
Nach dem Start des Programms erscheint die Einfhrungsseite. Sie wird in Mode 2
mit 64 Zeichen auf  32  Zeilen  dargestellt.  Es  werden Texte in verschiedenen
Attributen  dargestellt:   normal,   invertiert,   kursiv,   unterstrichen  und
durchgestrichen. Nun kann man das Programm entweder mit ESC abbrechen, oder mit
irgendeiner Taste weitermachen.
Nach dem Tastendruck wird der Bildschirm  gelscht und auf Mode 1 ungeschalten.
Nun werden kurze Texte in allen  drei  Mode  1 Farben ausgegeben, auerdem wird
die Pen 1 & 2 Mischfarbe demostriert.  Man  sieht, dass FutureOS in Mode 1 auch
mit halben Spaces und zweifarbigen Zeichen arbeiten kann.
Nach einem weiteren  Druck  auf  eine  Taste  wird  eine  halbe Million Zeichen
(genauer gesagt 2048 * 256 = 524288 Zeichen) ausgegeben. Nun wartet der CPC auf
einen abschlieenden Tastendruck, der das Programm beendet.
Die halbe Million Zeichen wird in  ca.  23 Sekunden ausgegeben, der Acorn A5000
mit 32 Bit CPU braucht dafr immerhin auch  noch 20 Sekunden. Der CPC kann also
noch mithalten ;-) :D





Allen bisher besprochenen Programmen ist  der Source-Code beigefgt, dieser ist
ausreichend dokumentiert (siehe '900  FutureOS  Prog Source DE_EN 2018-01-17').
Dadurch ist es leicht  mglich  eigene  Programme  abzuleiten und den einfachen
Umgang mit den superschnellen OS Funktionen zu erlernen.

Weitere Programme fr das FutureOS:
-----------------------------------
In folgenden werden noch einige Applikationen  & Tools fr das FutureOS erwhnt
und in einer Zeile beschrieben. Diese Programme sind alle bei TFM of FutureSoft
erhltlich.  Leer-Disketten  plus  Rckporto  an:   Dr.  Stefan  Stumpferl  ///
Hasenberglstr. 57 /// 80933 Mnchen. Internet: http://www.FutureOS.de

Archi==>CPC ==> Konvertiert Acorn Sprite Format (z.B. Scans) auf CPC 17 KB
BildSchoner ==> Simpler Bildschirm-Schoner, einstellbare Wartezeit
Farben set  ==> Farben des FutureOS einstellen
Kl.Info.Sys ==> Informations-System, Beispiel fr die Verwendung des 'I' Icons
Konfig OS   ==> Konfiguration des FutureOS
MMcR-Format ==> Ultraschnelles Formatierprogramm (Data, System, 41 Spuren)
OS-Infos    ==> Informationen ber Belegung von RAM, ROM, Tastatur, Steuerzei.
Odie Schnee ==> Schneefallsimulation von Odie Soft.
SchiebeROMs ==> Verschiebt OS ROMs an beliebige ROM-Nummern (nur RRB, obsolet)
Zei Inst V2 ==> Installiert neuen Zeichensatz im RAM.
ZeichenDemo ==> Demo der Zeichenausgabe
ZeigeTasten ==> Darstellung gedrckter Tasten
Installiert neuen Zeichensatz im RAM.
----------------------------------
Sie sind Besitzer einer der folgenden ROM Erweiterungen: M4, X-MEM, MegaFlash, 
FlashGordo