home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Vectronix 2
/
VECTRONIX2.iso
/
FILES_01
/
EGON2_3.LZH
/
EGON_2_3
/
MANUAL.TXT
< prev
next >
Wrap
Text File
|
1995-04-05
|
19KB
|
397 lines
*** Diese Anleitung bezieht sich auf Version 1.1
der Egon! CD-Utilities ! Bitte lesen bezüglich
neuer Funktionen und Ergänzungen die Datei
READ.ME auf dieser Diskette ! ***
E G O N ! CD-Utilities Version 1.1
29.05.94
(c) EDV-Service Bontenackels
Fronhofstra₧e 9
52146 Würselen
Tel.: (0 24 05) 7 23 07
FAX : (0 24 05) 7 43 69
(p) Peter Hilbring
Inhaltsverzeichnis
Was ist EGON! ?
Was kann EGON! ?
Wie schlie₧e ich ein CD ROM an meinen Atari an ?
Welche CD-ROM Laufwerke kann ich benutzen ?
Wie installiere ich die EGON! CD-Utilities ?
Was befindet sich auf der Diskette ?
Aufbau der CONFIG.SYS Datei
EGON! für den Programmierer
- Aufbau der EGON_INFO-Struktur
- Die Parameterübergabe an die Funktionen
- Welche Funktion ist wozu zu gebrauchen ?
EGON! und MetaDOS
Anmerkungen
Was ist EGON! ?
EGON! ist ein MetaDOS CD-Rom Treiber der auf allen ST Modellen,
angefangen beim kleinsten ST, bis hin zum TT oder Falcon030
funktioniert.
Damit die Installation von EGON! ebenso einfach wie die
Installation einer Festplatte funktioniert, befindet sich auf der
ORIGINAL-Diskette ein Installationsprogramm (EGONINST.APP).
Was kann EGON! ?
EGON! ermöglicht es Ihnen, auf eine CD in einem angeschlossenen
CD-Rom Laufwerk genauso zuzugreifen, wie auf eine Partition einer
Festplatte oder eine Diskette. Sie können fast alles mit einer
CD machen was sie auch mit einer "normalen" Festplatte oder
Diskette machen könnten,...
... nur Schreiben auf eine CD ist leider nicht möglich.
Wie schlie₧e ich ein CD Rom an meinem Atari an ?
Nichts einfacher als das. Ein CD-Rom Laufwerk wird genau wie
eine Festplatte mit Ihrem Atari Computer verbunden. Bei einem
externen CD-Rom Laufwerk verbinden Sie den Computer mit einem
ACSI-Interface (bzw. Hostadapter) oder einem SCSI-Kabel mit der
entsprechenden Buchse des CD Laufwerks. Nun müssen Sie das
CD-Rom nur noch mit Strom versorgen und es kann losgehen.
Bei internen Laufwerken wie sie in Towern zum Einsatz kommen,
verfahren Sie ebenso.
Genauere Informationen entnehmen Sie dem Handbuch des Atari-
Computers oder der Anleitung zu Ihrem ACSI-Interface.
Welche CD-Rom Laufwerke kann ich benutzen ?
Im Prinzip funktioniert jedes SCSI-Laufwerk an Ihrem Atari.
Dieses schlie₧t leider die "billig-AT-Bus-Laufwerke" aus, die an
IBM-kompatiblen PCs benutzt werden können.
Wie installiere ich die EGON! CD-Utilities ?
Schlie₧en Sie das CD-Rom Laufwerk, wie oben beschrieben, an
Ihren Computer an. Nun legen Sie die NICHT schreibgeschützte
EGON!-Originaldiskette in Laufwerk A und führen mit der
linken Maustaste einen Doppelklick auf das Symbol für das
Diskettenlaufwerk A auf dem Desktop aus. In dem sich nun
öffnenden Fenster befinden sich mehrere Dateien.
Suchen Sie nun die Datei EGONINST.APP und starten sie das
Programm durch einen Doppelklick auf diese Datei.
Nach wenigen Augenblicken erscheint der erste Benutzerdialog des
Installationsprogrammes in dem Sie aufgefordert werden ihren
Namen und ihre Anschrift in die dafür vorgesehenen Felder
einzutragen. Au₧erdem sollten Sie noch die Seriennummer, welche
Sie auf dem Diskettenlabel der ORIGINAL-Diskette finden, in das
entsprechende Feld eintragen. Bitte gehen Sie bei diesen
Einträgen sorgfältig vor und tragen Sie keine Phantasienamen
oder ähnliches ein, da Updates nur durchgeführt werden
können, wenn Ihre eingegebenen Daten korrekt sind.
Sobald alles richtig eingegeben wurde klicken Sie bitte mit der
LINKEN Maustaste auf den INSTALLIERE... Button.
Jetzt sehen Sie den zweiten Benutzerdialog des EGON!-
Installationsprogrammes. In diesem Dialog stellen Sie über
Popupmenues das Laufwerk ein, auf dem die EGON! CD-Utilities
installiert werden sollen. Hier sollte man das Laufwerk anwählen
von dem aus auch Ihr Atari Computer gebootet wird. Normalerweise
ist dies Laufwerk C.
Als nächstes müssen Sie die Geräteadresse Ihres CD-Rom-
Laufwerkes eintragen. Für die Geräteadresseneinstellung ist
an den meisten externen CD-Rom-Laufwerken ein kleiner
"ID-Schalter" zu finden (häufig neben der SCSI-Anschlu₧buchse),
den man zwischen 0-6 (manchmal sogar 0-7) einstellen kann.
Die dort angezeigte Zahl ist die Geräteadresse des CD-Roms.
Wichtig ist, da₧ das CD-Rom nicht von Ihrem Festplattentreiber
angesprochen werden darf.
Wenn Sie den Atari-Treiber benutzen lassen Sie eine ID zwischen
den Festplatten und dem CD-Rom frei. Auf diese Art kann der
Atari-Treiber das CD Laufwerk nicht mehr finden und ansprechen.
Bei anderen Treibern entnehmen Sie bitte dem entsprechendem
Handbuch, wie man bestimmte Geräteadresse ausblendet.
Nun haben Sie die Qual der Wahl unter welchem Buchstaben das
CD-Rom Laufwerk verwaltet werden soll. So steht A für das erste
Diskettenlaufwerk, B für das zweite, C für die erste
Festplattenpartition und so weiter. Es ist zweckmä₧ig für das
CD-Rom einen Buchstaben zwischen D und P zu benutzen, da es
Programme gibt, die auf Laufwerke grö₧er P nicht zugreifen können
(obwohl der EGON!-Treiber Laufwerksbuchstaben bis V verwalten
kann).
Als letztes geben Sie bitte den Anschlu₧ an, an dem Sie das
CD-Rom Laufwerk betreiben möchten. Bei einem ST ist dies der
ACSI-Port, bei einem Falcon030 der SCSI-Port. Bei einem TT haben
Sie die freie Auswahl, je nachdem ob Sie das Laufwerk über ein
ACSI-Interface (Hostadapter) oder direkt am SCSI-Bus betreiben
möchten.
Bei der Installation werden auf dem Installationslaufwerk nach
dem AUTO- und dem METADOS-Ordner gesucht und diese(r) eventuell
angelegt.
In den AUTO-Ordner kopiert das EGON!-Installationsprogramm die
Dateien METADOS.PRG und CONFIG.SYS. Dabei wird eine evtl.
vorhandene CONFIG.SYS ausgewertet, und die eingetragenen
Werte übernommen. METADOS wird überschrieben.
In den METADOS-Ordner kommen die Geräte- und Dateisystemtreiber
EGON_ISO.DOS und EGON.BOS.
Das war auch schon alles. Nun können Sie einen Reset
durchführen und sich an Ihren neuen CD-ROM erfreuen.
Bitte beachten Sie, da₧ eine Installation von EGON! nur von
der Originaldiskette möglich ist, auf der auch keinesfalls
irgendwelche Ordnerstrukturen geändert werden dürfen.
Was befindet sich auf der Diskette ?
\README.1ST aktuelle Infos zu EGON!
\EGONINST.APP Das Installationsprogramm
\EGONINST.RSC Resourcefile
\MANUAL.TXT Dieser Text
\READ.ME aktuelle Ergänzungen zu
diesem Handbuch
\CPX\EGONLOCK.CPX CPX-Modul zum Verriegeln des
CD-ROMs
\CPX\EGONLOCK.TXT Anleitung zu EGONLOCK.CPX
\CPX\EGONPLAY.CPX AUDIO-Player als CPX-Modul
\CPX\EGONPLAY.TXT Anleitung zu EGONPLAY.CPX
\METADOS\METADOS.PRG Ataris MetaDOS Treiber
\METADOS\CONFIG.SYS Beispiel CONFIG.SYS Datei
\METADOS\README.TXT Readme Text von Atari
\METADOS\BOOT\ISO9669F.DOS ISO 9660 Dateisystemtreiber
\METADOS\BOOT\HSMAY86.DOS High Sierra Dateisystemtreiber
\METADOS\BOOT\CDARGEN.BOS Treiber für Atari CDAR-504
\MUCKE\MUCKE.APP komfortable AUDIO-CD-Player-
Software
\MUCKE\MUCKE.DAT AUDIO CD-Datenbank zu Mucke
\MUCKE\MUCKE.PAR Parameter-Datei zu Mucke
\MUCKE\README Anleitungstext zu Mucke
\LIB\METADOS.O MetaDOS Library für Pure C
\LIB\METADOS.H MetaDOS Headerfile
\LIB\TEST.C Beispielsourcen zu der Library
\LIB\TEST.TOS Beispielprogramm
\LIB\TEST.PRJ Projektdatei für Pure C
Aufbau der CONFIG.SYS Datei
;
; Config.sys Beschreibung der Systemkonfiguration.
;
; Physical Basic operating system format
;*BOS, [Physical Bos driver][Arguments],
; [Physical id]:[DMA channel], ...
; Device # meaning
; 0 - 7 ACSI device 0 - 7
; 8 - 15 SCSI device 0 - 7
;
; Die folgende Zeile meldet EGON.BOS als ACSI-Gerät 4 an
*BOS, C:\METADOS\EGON.BOS, Y:4
;
; Logical DOS format. (Dateisystem Treiber)
;*DOS [Logical DOS] [Arguments], [Logical id]:[physical id],...
;
; Als nächstes wird der EGON_ISO.DOS Treiber auf dem MetaDOS
; Gerät Y (welches die ACSI-Adresse 4 verwaltet, s.o.) als
; GEMDOS Laufwerk P installiert. Wie schon bei der Installation
; Erklärt wurde ist es vorteilhaft ein GEMDOS Laufwerk bis
; maximal P zu wählen, da einige Programme auf höhere Laufwerke
; nicht zugreifen können.
*DOS, C:\METADOS\EGON_ISO.DOS, O:Y
;
; MetaDOS kann auch Programme automatisch starten.
;
c:\auto\boot\ram512.prg ; Load in 512 byte ramdisk.
c:\auto\boot\gdos.prg ; Load in gdos.
c:\auto\boot\diab630.prg ; Load in diablo 630 emulator.
c:\auto\boot\sdump.prg ; Load in Screen dump to laser.
EGON! für den Programmierer (bitte aktuelle Ergänzungen im
READ.ME beachten !)
EGON! legt bei erfolgreicher Installation einen Cookie an.
Die Bezeichnung des Cookies ist EGON. Der Cookie zeigt auf eine
Struktur, die Einsprungadressen für grundlegende Lese- und
Schreibroutinen enthält. Über diese Routinen kann man auf
einfache Art und Weise Daten über den ACSI- bzw. SCSI-Bus
Übertragen.
Aufbau der EGON_INFO-Struktur:
typedef struct
{
void *smplscsi; /* Zeiger auf smplscsi */
void *rcvscsi; /* Zeiger auf rcvscsi */
void *wrtscsi; /* Zeiger auf wrtscsi */
void *clrcmdblk; /* Zeiger auf clrcmdblk */
void *cmdblk; /* Zeiger auf cmdblk */
UBYTE *info; /* Zeiger auf Versionsstring */
} EGON_INFO;
Die Parameterübergabe an die Funktionen
* smplscsi
D0.W : SCSI Unit Nummer (0-15)
D1.L : Grö₧e des Übertragungsbuffers in Bytes
D2.W : SCSI Befehlslänge (cmdblk) in Bytes
A0.L : Adresse des Übertragungsbuffers
Nach Beendigung der Funktion steht in D0.W ein
Rückgabewert. Ein Wert ungleich 0 deutet auf einen SCSI
Fehler hin, der mit dem SCSI Befehl REQUEST SENSE näher
untersucht werden kann. Bei einem Wert von 0 ist die
Funktion ohne Fehler beendet worden.
* rcvscsi
D0.W : SCSI Unit Nummer (0-15)
D1.L : Grö₧e des Übertragungsbuffers in Bytes
D2.W : SCSI Befehlslänge (cmdblk) in Bytes
A0.L : Adresse des Übertragungsbuffers
Nach Beendigung der Funktion steht in D0.W ein
Rückgabewert. Ein Wert ungleich 0 deutet auf einen SCSI
Fehler hin, der mit dem SCSI Befehl REQUEST SENSE näher
untersucht werden kann. Bei einem Wert von 0 ist die
Funktion ohne Fehler beendet worden.
* wrtscsi
D0.W : SCSI Unit Nummer (0-7)
D1.L : Grö₧e des Übertragungsbuffers in Bytes
D2.W : SCSI Befehlslänge (cmdblk) in Bytes
A0.L : Adresse des Übertragungsbuffers
Nach Beendigung der Funktion steht in D0.W ein
Rückgabewert. Ein Wert ungleich 0 deutet auf einen SCSI
Fehler hin, der mit dem SCSI Befehl REQUEST SENSE näher
untersucht werden kann. Bei einem Wert von 0 ist die
Funktion ohne Fehler beendet worden.
* clrcmdblk
A0.L : Zeiger auf eigenen cmdblk.
Es gibt keinen Rückgabewert.
Welche Funktion ist wozu zu gebrauchen
* smplscsi
Diese Funktion dient zum Verschicken von einfachen SCSI
Befehlen (ohne zusätzliche Daten) wie TEST UNIT READ
oder STARt UNIT.
* rcvscsi
Diese Funktion dient zur Datenübertragung vom CD Rom zum
Rechner. Die Daten werden in einem Übertragungsbuffer
zurückgeliefert. Ein typischer SCSI Befehl für die
Funktion ist READ.
* wrtscsi
Diese Funktion dient zur Datenübertragung zwischen
Rechner und CD Rom. Da man aber auf ein CD Rom nicht
schreiben kann ist eine sinnvolle Verwendung für diese
Funktion nur in der Konfiguration von CD Roms mittels
des SCSI Befehle MODE SELECT zu sehen.
* clrcmdblk
Diese Funktion löscht den Treiberinternen cmdblk. Ein
lokaler Kommandobuffer wird von dieser Funktion nicht
verändert. Es ist allerdings wichtig da₧ man nach jedem
Löschen des lokalen Kommandobuffers die Funktion
clrcmdblk aufruft um so "rätselhafte Phänomene" beim
Betrieb des Treibers zu vermeiden.
EGON! und MetaDOS
EGON! installiert sich mit Hilfe das Atari
MetaDOS-Treiberpaketes. Auf diese Art stehen dem Programmierer
somit auch die MetaDOS-XBIOS-Funktionen 48 bis 63 zur Verfügung.
Für diesen Zweck befindet sich auf der Diskette eine
MetaDOS-Library. Diese Library erfüllt die Pure-C
Aufrufkonventionen und befindet sich im LIB-Ordner der
ORIGINALDISKETTE.
Welche Funktionen gibt es in der Library und dem zugehörigem
Headerfile METADOS.H ?
typedef struct
{
ULONG drivemap; /* Tabelle mit Bits für die MetaDOS
Gerätetreiber "A.."Z" (Bit 0: "A") */
char *version; /* Zeichenkette mit Namen und
Versionsnummer von Meta-DOS */
LONG reserved[2];
} METAINFO;
int Metainit (METAINFO *buffer);
int Metaopen (int drive, char *buffer);
int Metaclose (int drive);
int Metaread (int drive, char *buffer, long block,
int count);
int Metawrite (int drive, char *buffer,
long block, int count);
int Metaseek (int drive, long block);
int Metastatus (int drive);
int Metaioctl (int drive, long magic,
int opcode, char *buffer);
int Metastartaudio (int drive, int flag, char *buffer);
int Metastopaudio (int drive);
int Metasetsongtime (int drive, int repeat,
long start, long end);
int Metagettoc (int drive, int flag, char *buffer);
int Metadiscinfo (int drive, char *buffer);
int Metagetdriveno (long drivemap);
Aufruf- und Übergabeparameter:
Metasetsongtime erwartet START und END im Formatwelches
von Metagettoc zurückgeliefertwird. REPEAT
wird nicht benutzt.
Metaopen In BUFFER sind ein Zeiger auf den
Versionsstring des BOS Treibers und 3
Null-Zeiger enthalten.
Metastartaudio BUFFER[0].B = Anzahl zu spielender
Tracks (normalerweise 1)
BUFFER[1].B = Track
FLAG mu₧ 0 sein.
Metagettoc BUFFER[0].B = Track Nr.
BUFFER[1].B bis BUFFER[3].B = Spielzeit
im BCD-Format. Beispiel: $26 $19 $60 hei₧t
26min 19sec 60/75tel Sekunden.
Dieses Format wird von Metasetsongtime
als Eingabe akzeptiert.
FLAG mu₧ 0 sein.
Metadiskinfo BUFFER[0].B = 0
BUFFER[1].B = First Track No.
BUFFER[2].B = Last Track No.
BUFFER[3].B = Track No.
BUFFER[4].L = Track relativ CD Rom
Address
BUFFER[8].L = Absolute Cd Rom
Address
BUFFER[12].L = End of CD absolute CD Rom
Address
BUFFER[16].B = Index No.
Alle Daten liegen im BCD-Code vor.
Anmerkungen
Atari, MetaDOS, GEMDOS, XBIOS, ST, TT und Falcon030 sind
Warenzeichen der Firma Atari Computer. MetaDOS
unterliegt dem Copyright der Firma Atari Computer.
Das Installationsprogramm entstand unter Zuhilfenahme der
EnhancedGEM-LIBRARY von Christian Grunenberg.