home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_01 / EGON2_3.LZH / EGON_2_3 / MANUAL.TXT < prev    next >
Text File  |  1995-04-05  |  19KB  |  397 lines
  1. *** Diese Anleitung bezieht sich auf Version 1.1 
  2.     der Egon! CD-Utilities ! Bitte lesen bezüglich
  3.     neuer Funktionen und Ergänzungen die Datei
  4.     READ.ME auf dieser Diskette ! ***
  5.  
  6.  
  7.          E G O N !    CD-Utilities  Version 1.1
  8.                                29.05.94
  9.                                
  10.  
  11.          (c) EDV-Service Bontenackels
  12.  
  13.              Fronhofstra₧e 9
  14.              52146 Würselen
  15.  
  16.              Tel.: (0 24 05) 7 23 07
  17.              FAX : (0 24 05) 7 43 69
  18.  
  19.  
  20.          (p) Peter Hilbring
  21.  
  22.  
  23.  
  24.  
  25.  
  26.       Inhaltsverzeichnis
  27.  
  28.           Was ist EGON! ?
  29.           Was kann EGON! ?
  30.           Wie schlie₧e ich ein CD ROM an meinen Atari an ?
  31.           Welche CD-ROM Laufwerke kann ich benutzen ?
  32.           Wie installiere ich die EGON! CD-Utilities ?
  33.           Was befindet sich auf der Diskette ?
  34.           Aufbau der CONFIG.SYS Datei
  35.           EGON! für den Programmierer
  36.            - Aufbau der EGON_INFO-Struktur
  37.            - Die Parameterübergabe an die Funktionen
  38.            - Welche Funktion ist wozu zu gebrauchen ?
  39.           EGON! und MetaDOS
  40.           Anmerkungen
  41.  
  42.  
  43.          Was ist EGON! ?
  44.  
  45.           EGON! ist ein MetaDOS CD-Rom Treiber der auf allen ST Modellen, 
  46.           angefangen beim kleinsten ST, bis hin zum TT oder Falcon030 
  47.           funktioniert.
  48.           Damit die Installation von EGON! ebenso einfach wie die 
  49.           Installation einer Festplatte funktioniert, befindet sich auf der 
  50.           ORIGINAL-Diskette ein Installationsprogramm (EGONINST.APP).
  51.  
  52.  
  53.         Was kann EGON! ?
  54.  
  55.           EGON! ermöglicht es Ihnen, auf eine CD in einem angeschlossenen 
  56.           CD-Rom Laufwerk genauso zuzugreifen, wie auf eine Partition einer 
  57.           Festplatte oder eine Diskette. Sie können fast alles mit einer 
  58.           CD machen was sie auch mit einer "normalen" Festplatte oder 
  59.           Diskette machen könnten,...
  60.           ... nur Schreiben auf eine CD ist leider nicht möglich.
  61.  
  62.  
  63.         Wie schlie₧e ich ein CD Rom an meinem Atari an ?
  64.  
  65.           Nichts einfacher als das. Ein CD-Rom Laufwerk wird genau wie 
  66.           eine Festplatte mit Ihrem Atari Computer verbunden. Bei einem 
  67.           externen CD-Rom Laufwerk verbinden Sie den Computer mit einem 
  68.           ACSI-Interface (bzw. Hostadapter) oder einem SCSI-Kabel mit der
  69.           entsprechenden Buchse des CD Laufwerks. Nun müssen Sie das 
  70.           CD-Rom nur noch mit Strom versorgen und es kann losgehen.
  71.           Bei internen Laufwerken wie sie in Towern zum Einsatz kommen,
  72.           verfahren Sie ebenso.
  73.           Genauere Informationen entnehmen Sie dem Handbuch des Atari-
  74.           Computers oder der Anleitung zu Ihrem ACSI-Interface.
  75.  
  76.  
  77.         Welche CD-Rom Laufwerke kann ich benutzen ?
  78.  
  79.           Im Prinzip funktioniert jedes SCSI-Laufwerk an Ihrem Atari. 
  80.           Dieses schlie₧t leider die "billig-AT-Bus-Laufwerke" aus, die an 
  81.           IBM-kompatiblen PCs benutzt werden können.
  82.  
  83.  
  84.         Wie installiere ich die EGON! CD-Utilities ?
  85.  
  86.           Schlie₧en Sie das CD-Rom Laufwerk, wie oben beschrieben, an 
  87.           Ihren Computer an. Nun legen Sie die NICHT schreibgeschützte 
  88.           EGON!-Originaldiskette in Laufwerk A und führen mit der 
  89.           linken Maustaste einen Doppelklick auf das Symbol für das 
  90.           Diskettenlaufwerk A auf dem Desktop aus. In dem sich nun 
  91.           öffnenden Fenster befinden sich mehrere Dateien.
  92.           Suchen Sie nun die Datei EGONINST.APP und starten sie das 
  93.           Programm durch einen Doppelklick auf diese Datei.
  94.           Nach wenigen Augenblicken erscheint der erste Benutzerdialog des 
  95.           Installationsprogrammes in dem Sie aufgefordert werden ihren 
  96.           Namen und ihre Anschrift in die dafür vorgesehenen Felder 
  97.           einzutragen. Au₧erdem sollten Sie noch die Seriennummer, welche 
  98.           Sie auf dem Diskettenlabel der ORIGINAL-Diskette finden, in das 
  99.           entsprechende Feld eintragen. Bitte gehen Sie bei diesen 
  100.           Einträgen sorgfältig vor und tragen Sie keine Phantasienamen 
  101.           oder ähnliches ein, da Updates nur durchgeführt werden 
  102.           können, wenn Ihre eingegebenen Daten korrekt sind.
  103.           Sobald alles richtig eingegeben wurde klicken Sie bitte mit der 
  104.           LINKEN Maustaste auf den INSTALLIERE... Button.
  105.           Jetzt sehen Sie den zweiten Benutzerdialog des EGON!- 
  106.           Installationsprogrammes. In diesem Dialog stellen Sie über 
  107.           Popupmenues das Laufwerk ein, auf dem die EGON! CD-Utilities 
  108.           installiert werden sollen. Hier sollte man das Laufwerk anwählen 
  109.           von dem aus auch Ihr Atari Computer gebootet wird. Normalerweise 
  110.           ist dies Laufwerk C.
  111.           
  112.           Als nächstes müssen Sie die Geräteadresse Ihres CD-Rom- 
  113.           Laufwerkes eintragen. Für die Geräteadresseneinstellung ist
  114.           an den meisten externen CD-Rom-Laufwerken ein kleiner 
  115.           "ID-Schalter" zu finden (häufig neben der SCSI-Anschlu₧buchse),
  116.           den man zwischen 0-6 (manchmal sogar 0-7) einstellen kann. 
  117.           Die dort angezeigte Zahl ist die Geräteadresse des CD-Roms.
  118.           Wichtig ist, da₧ das CD-Rom nicht von Ihrem Festplattentreiber
  119.           angesprochen werden darf. 
  120.           Wenn Sie den Atari-Treiber benutzen lassen Sie eine ID zwischen
  121.           den Festplatten und dem CD-Rom frei. Auf diese Art kann der 
  122.           Atari-Treiber das CD Laufwerk nicht mehr finden und ansprechen.
  123.           Bei anderen Treibern entnehmen Sie bitte dem entsprechendem 
  124.           Handbuch, wie man bestimmte Geräteadresse ausblendet.
  125.           
  126.           Nun haben Sie die Qual der Wahl unter welchem Buchstaben das 
  127.           CD-Rom Laufwerk verwaltet werden soll. So steht A für das erste 
  128.           Diskettenlaufwerk, B für das zweite, C für die erste 
  129.           Festplattenpartition und so weiter. Es ist zweckmä₧ig für das 
  130.           CD-Rom einen Buchstaben zwischen D und P zu benutzen, da es 
  131.           Programme gibt, die auf Laufwerke grö₧er P nicht zugreifen können 
  132.           (obwohl der EGON!-Treiber Laufwerksbuchstaben bis V verwalten 
  133.           kann).
  134.           Als letztes geben Sie bitte den Anschlu₧ an, an dem Sie das 
  135.           CD-Rom Laufwerk betreiben möchten. Bei einem ST ist dies der 
  136.           ACSI-Port, bei einem Falcon030 der SCSI-Port. Bei einem TT haben 
  137.           Sie die freie Auswahl, je nachdem ob Sie das Laufwerk über ein 
  138.           ACSI-Interface (Hostadapter) oder direkt am SCSI-Bus betreiben 
  139.           möchten.
  140.           Bei der Installation werden auf dem Installationslaufwerk nach 
  141.           dem AUTO- und dem METADOS-Ordner gesucht und diese(r) eventuell
  142.           angelegt.
  143.           In den AUTO-Ordner kopiert das EGON!-Installationsprogramm die 
  144.           Dateien METADOS.PRG und CONFIG.SYS. Dabei wird eine evtl. 
  145.           vorhandene CONFIG.SYS ausgewertet, und die eingetragenen 
  146.           Werte übernommen. METADOS wird überschrieben.
  147.           In den METADOS-Ordner kommen die Geräte- und Dateisystemtreiber
  148.           EGON_ISO.DOS und EGON.BOS.
  149.           Das war auch schon alles. Nun können Sie einen Reset 
  150.           durchführen und sich an Ihren neuen CD-ROM erfreuen.
  151.           Bitte beachten Sie, da₧ eine Installation von EGON! nur von
  152.           der Originaldiskette möglich ist, auf der auch keinesfalls
  153.           irgendwelche Ordnerstrukturen geändert werden dürfen. 
  154.  
  155.         Was befindet sich auf der Diskette ?
  156.         
  157.           \README.1ST             aktuelle Infos zu EGON!
  158.           \EGONINST.APP                  Das Installationsprogramm
  159.           \EGONINST.RSC                  Resourcefile
  160.           \MANUAL.TXT                    Dieser Text
  161.           \READ.ME                       aktuelle Ergänzungen zu
  162.                                diesem Handbuch
  163.           \CPX\EGONLOCK.CPX             CPX-Modul zum Verriegeln des 
  164.                                          CD-ROMs
  165.           \CPX\EGONLOCK.TXT              Anleitung zu EGONLOCK.CPX
  166.           \CPX\EGONPLAY.CPX              AUDIO-Player als CPX-Modul
  167.           \CPX\EGONPLAY.TXT              Anleitung zu EGONPLAY.CPX
  168.           \METADOS\METADOS.PRG           Ataris MetaDOS Treiber
  169.           \METADOS\CONFIG.SYS            Beispiel CONFIG.SYS Datei
  170.           \METADOS\README.TXT            Readme Text von Atari
  171.           \METADOS\BOOT\ISO9669F.DOS     ISO 9660 Dateisystemtreiber
  172.           \METADOS\BOOT\HSMAY86.DOS      High Sierra Dateisystemtreiber
  173.           \METADOS\BOOT\CDARGEN.BOS      Treiber für Atari CDAR-504
  174.           \MUCKE\MUCKE.APP               komfortable AUDIO-CD-Player-
  175.                                Software
  176.           \MUCKE\MUCKE.DAT               AUDIO CD-Datenbank zu Mucke
  177.           \MUCKE\MUCKE.PAR               Parameter-Datei zu Mucke
  178.           \MUCKE\README                  Anleitungstext zu Mucke
  179.           \LIB\METADOS.O                 MetaDOS Library für Pure C
  180.           \LIB\METADOS.H                 MetaDOS Headerfile
  181.           \LIB\TEST.C                    Beispielsourcen zu der Library
  182.           \LIB\TEST.TOS                  Beispielprogramm
  183.           \LIB\TEST.PRJ                  Projektdatei für Pure C
  184.                
  185.     
  186.         Aufbau der CONFIG.SYS Datei
  187.  
  188.           ;
  189.           ; Config.sys    Beschreibung der Systemkonfiguration.
  190.           ;
  191.           ; Physical Basic operating system format
  192.           ;*BOS, [Physical Bos driver][Arguments],
  193.           ;      [Physical id]:[DMA channel], ...
  194.           ;    Device #    meaning
  195.           ;    0 - 7        ACSI device 0 - 7
  196.           ;    8 - 15        SCSI device 0 - 7
  197.           ;
  198.           ; Die folgende Zeile meldet EGON.BOS als ACSI-Gerät 4 an
  199.           *BOS, C:\METADOS\EGON.BOS, Y:4
  200.           ;
  201.           ; Logical DOS format. (Dateisystem Treiber)
  202.           ;*DOS  [Logical DOS] [Arguments], [Logical id]:[physical id],...
  203.           ;
  204.           ; Als nächstes wird der EGON_ISO.DOS Treiber auf dem MetaDOS
  205.           ; Gerät Y (welches die ACSI-Adresse 4 verwaltet, s.o.) als 
  206.           ; GEMDOS Laufwerk P installiert. Wie schon bei der Installation
  207.           ; Erklärt wurde ist es vorteilhaft ein GEMDOS Laufwerk bis 
  208.           ; maximal P zu wählen, da einige Programme auf höhere Laufwerke 
  209.           ; nicht zugreifen können.
  210.           *DOS, C:\METADOS\EGON_ISO.DOS, O:Y
  211.           ;
  212.           ; MetaDOS kann auch Programme automatisch starten.
  213.           ;
  214.           c:\auto\boot\ram512.prg    ; Load in 512 byte ramdisk.
  215.           c:\auto\boot\gdos.prg        ; Load in gdos.
  216.           c:\auto\boot\diab630.prg    ; Load in diablo 630 emulator.
  217.           c:\auto\boot\sdump.prg    ; Load in Screen dump to laser.
  218.  
  219.  
  220.         EGON! für den Programmierer (bitte aktuelle Ergänzungen im 
  221.                                      READ.ME beachten !)
  222.  
  223.           EGON! legt bei erfolgreicher Installation einen Cookie an.
  224.           Die Bezeichnung des Cookies ist EGON. Der Cookie zeigt auf eine 
  225.           Struktur, die Einsprungadressen für grundlegende Lese- und 
  226.           Schreibroutinen enthält. Über diese Routinen kann man auf 
  227.           einfache Art und Weise Daten über den ACSI- bzw. SCSI-Bus 
  228.           Übertragen.
  229.  
  230.           Aufbau der EGON_INFO-Struktur:
  231.  
  232.              typedef struct
  233.              {
  234.                 void *smplscsi;  /* Zeiger auf smplscsi       */
  235.                 void *rcvscsi;   /* Zeiger auf rcvscsi        */
  236.                 void *wrtscsi;   /* Zeiger auf wrtscsi        */
  237.                 void *clrcmdblk; /* Zeiger auf clrcmdblk      */
  238.                 void *cmdblk;    /* Zeiger auf cmdblk         */
  239.                 UBYTE *info;     /* Zeiger auf Versionsstring */
  240.              } EGON_INFO;
  241.  
  242.           Die Parameterübergabe an die Funktionen
  243.  
  244.              * smplscsi
  245.                   D0.W : SCSI Unit Nummer (0-15)
  246.                   D1.L : Grö₧e des Übertragungsbuffers in Bytes
  247.                   D2.W : SCSI Befehlslänge (cmdblk) in Bytes
  248.                   A0.L : Adresse des Übertragungsbuffers
  249.  
  250.                   Nach Beendigung der Funktion steht in D0.W ein 
  251.                   Rückgabewert. Ein Wert ungleich 0 deutet auf einen SCSI 
  252.                   Fehler hin, der mit dem SCSI Befehl REQUEST SENSE näher 
  253.                   untersucht werden kann. Bei einem Wert von 0 ist die 
  254.                   Funktion ohne Fehler beendet worden.
  255.  
  256.              * rcvscsi
  257.                   D0.W : SCSI Unit Nummer (0-15)
  258.                   D1.L : Grö₧e des Übertragungsbuffers in Bytes
  259.                   D2.W : SCSI Befehlslänge (cmdblk) in Bytes
  260.                   A0.L : Adresse des Übertragungsbuffers
  261.  
  262.                   Nach Beendigung der Funktion steht in D0.W ein 
  263.                   Rückgabewert. Ein Wert ungleich 0 deutet auf einen SCSI 
  264.                   Fehler hin, der mit dem SCSI Befehl REQUEST SENSE näher 
  265.                   untersucht werden kann. Bei einem Wert von 0 ist die 
  266.                   Funktion ohne Fehler beendet worden.
  267.  
  268.              * wrtscsi
  269.                   D0.W : SCSI Unit Nummer (0-7)
  270.                   D1.L : Grö₧e des Übertragungsbuffers in Bytes
  271.                   D2.W : SCSI Befehlslänge (cmdblk) in Bytes
  272.                   A0.L : Adresse des Übertragungsbuffers
  273.  
  274.                   Nach Beendigung der Funktion steht in D0.W ein 
  275.                   Rückgabewert. Ein Wert ungleich 0 deutet auf einen SCSI 
  276.                   Fehler hin, der mit dem SCSI Befehl REQUEST SENSE näher 
  277.                   untersucht werden kann. Bei einem Wert von 0 ist die 
  278.                   Funktion ohne Fehler beendet worden.
  279.  
  280.              * clrcmdblk
  281.                   A0.L : Zeiger auf eigenen cmdblk.
  282.  
  283.                   Es gibt keinen Rückgabewert.
  284.  
  285.  
  286.           Welche Funktion ist wozu zu gebrauchen
  287.  
  288.              * smplscsi
  289.                   Diese Funktion dient zum Verschicken von einfachen SCSI 
  290.                   Befehlen (ohne zusätzliche Daten) wie TEST UNIT READ 
  291.                   oder STARt UNIT.
  292.  
  293.              * rcvscsi
  294.                   Diese Funktion dient zur Datenübertragung vom CD Rom zum 
  295.                   Rechner. Die Daten werden in einem Übertragungsbuffer 
  296.                   zurückgeliefert. Ein typischer SCSI Befehl für die 
  297.                   Funktion ist READ.
  298.  
  299.              * wrtscsi
  300.                   Diese Funktion dient zur Datenübertragung zwischen 
  301.                   Rechner und CD Rom. Da man aber auf ein CD Rom nicht 
  302.                   schreiben kann ist eine sinnvolle Verwendung für diese 
  303.                   Funktion nur in der Konfiguration von CD Roms mittels 
  304.                   des SCSI Befehle MODE SELECT zu sehen.
  305.  
  306.              * clrcmdblk
  307.                   Diese Funktion löscht den Treiberinternen cmdblk. Ein 
  308.                   lokaler Kommandobuffer wird von dieser Funktion nicht 
  309.                   verändert. Es ist allerdings wichtig da₧ man nach jedem 
  310.                   Löschen des lokalen Kommandobuffers die Funktion 
  311.                   clrcmdblk aufruft um so "rätselhafte Phänomene" beim 
  312.                   Betrieb des Treibers zu vermeiden.
  313.  
  314.  
  315.         EGON! und MetaDOS
  316.  
  317.           EGON! installiert sich mit Hilfe das Atari 
  318.           MetaDOS-Treiberpaketes. Auf diese Art stehen dem Programmierer 
  319.           somit auch die MetaDOS-XBIOS-Funktionen 48 bis 63 zur Verfügung.
  320.           Für diesen Zweck befindet sich auf der Diskette eine 
  321.           MetaDOS-Library. Diese Library erfüllt die Pure-C 
  322.           Aufrufkonventionen und befindet sich im LIB-Ordner der 
  323.           ORIGINALDISKETTE.
  324.  
  325.              Welche Funktionen gibt es in der Library und dem zugehörigem 
  326.              Headerfile METADOS.H ?
  327.  
  328.                 typedef struct
  329.                 {
  330.                    ULONG drivemap; /* Tabelle mit Bits für die MetaDOS 
  331.                                       Gerätetreiber "A.."Z" (Bit 0: "A") */
  332.                    char *version;    /* Zeichenkette mit Namen und 
  333.                                        Versionsnummer von Meta-DOS */
  334.                    LONG  reserved[2];
  335.                 } METAINFO;
  336.  
  337.              int Metainit (METAINFO *buffer);
  338.              int Metaopen (int drive, char *buffer);
  339.              int Metaclose (int drive);
  340.              int Metaread (int drive, char *buffer, long block,
  341.                            int count);
  342.              int Metawrite (int drive, char *buffer,
  343.                             long block, int count);
  344.              int Metaseek (int drive, long block);
  345.              int Metastatus (int drive);
  346.              int Metaioctl (int drive, long magic,
  347.                             int opcode, char *buffer);
  348.              int Metastartaudio (int drive, int flag, char *buffer);
  349.              int Metastopaudio (int drive);
  350.              int Metasetsongtime (int drive, int repeat,
  351.                                   long start, long end);
  352.              int Metagettoc (int drive, int flag, char *buffer);
  353.              int Metadiscinfo (int drive, char *buffer);
  354.              int Metagetdriveno (long drivemap);
  355.  
  356.              Aufruf- und Übergabeparameter:
  357.  
  358.                 Metasetsongtime erwartet START und END im Formatwelches 
  359.                                 von Metagettoc zurückgeliefertwird. REPEAT 
  360.                                 wird nicht benutzt.
  361.                 Metaopen        In BUFFER sind ein Zeiger auf den 
  362.                                 Versionsstring des BOS Treibers und 3 
  363.                                 Null-Zeiger enthalten.
  364.                 Metastartaudio  BUFFER[0].B = Anzahl zu spielender 
  365.                                               Tracks (normalerweise 1)
  366.                                 BUFFER[1].B = Track
  367.                                 FLAG mu₧ 0 sein.
  368.                 Metagettoc      BUFFER[0].B = Track Nr.
  369.                                 BUFFER[1].B bis BUFFER[3].B = Spielzeit
  370.                                 im BCD-Format. Beispiel: $26 $19 $60 hei₧t 
  371.                                 26min 19sec 60/75tel Sekunden.
  372.                                 Dieses Format wird von Metasetsongtime 
  373.                                 als Eingabe akzeptiert.
  374.                                 FLAG mu₧ 0 sein.
  375.                 Metadiskinfo    BUFFER[0].B = 0
  376.                                 BUFFER[1].B  = First Track No.
  377.                                 BUFFER[2].B  = Last Track No.
  378.                                 BUFFER[3].B = Track No.
  379.                                 BUFFER[4].L  = Track relativ CD Rom 
  380.                                                Address
  381.                                 BUFFER[8].L  = Absolute Cd Rom 
  382.                                                Address
  383.                                 BUFFER[12].L = End of CD absolute CD Rom 
  384.                                                Address
  385.                                 BUFFER[16].B = Index No.
  386.                                 Alle Daten liegen im BCD-Code vor.
  387.  
  388.  
  389.         Anmerkungen
  390.  
  391.           Atari, MetaDOS, GEMDOS, XBIOS, ST, TT und Falcon030 sind 
  392.           Warenzeichen der Firma Atari Computer. MetaDOS 
  393.           unterliegt dem Copyright der Firma Atari Computer.
  394.  
  395.           Das Installationsprogramm entstand unter Zuhilfenahme der 
  396.           EnhancedGEM-LIBRARY von Christian Grunenberg.
  397.