4.14 Laufwerksfunktionen

• DMAread	Sektoren von Festplatte lesen.
• DMAwrite	Sektoren auf Festplate schreiben.
• Flopfmt	Spur auf einer Diskette formatieren.
• Floprate	Seekrate und Timeout der Floppy setzen.
• Floprd	Einzelne Sektoren lesen.
• Flopver	Sektoren einer Diskette überprüfen.
• Flopwr	Einzelne Sektoren schreiben.
• Metaclose	Gibt ein MetaDOS Gerät wieder frei.
• Metadiscinfo	Ermittelt aktuelle Status-Informationen.
• Metagettoc	Liefert das Inhaltsverzeichnis eines Gerätes.
• Metainit	Informationen über MetaDOS Version ermitteln.
• Metaioctl	Schickt GEMDOS-Opcodes an ein MetaDOS Gerät.
• Metaopen	Initialisiert ein MetaDOS Gerät.
• Metaread	Liest Daten von einem MetaDOS Gerät.
• Metaseek	Seeks to a physical address.
• Metasetsongtime	Startet eine Audio-Wiedergabe.
• Metastartaudio	Startet eine Audio-Wiedergabe.
• Metastatus	Ermittelt den Status eines MetaDOS Gerätes.
• Metastopaudio	Beendet eine Audio-Wiedergabe.
• Metawrite	Schreibt Daten auf ein MetaDOS Gerät.
• Protobt	Bootsektor für Diskette im Speicher generieren.

Querverweis: GEMDOS-Dateifunktionen GEMDOS-Verzeichnisfunktionen

4.14.1 DMAread

Name:

»DMA read« - liest einzelne Sektoren von einer DMA-Einheit.

Xbiosnummer:

Deklaration:

int16_t DMAread( int32_t sector, int16_t count, void *buffer, int16_t devno );

Beschreibung:

Die XBIOS-Routine DMAread liest einzelne oder mehrere Sektoren von einem ACSI- oder SCSI Gerät. Es gilt:

Parameter

Bedeutung

sector

erste Sektornummer

count

Anzahl der Sektoren

buffer

Anfangsadresse im Speicher

devno

Gerätenummer. Es gilt:

0..7:	ACSI-Geräte
8..15:	SCSI-Geräte (TOS 2.06 und ab 3.00)
16	IDE-Geräte (TOS 2.06 und ab 3.06)

Alle anderen Werte sind für zukünftige Erweiterungen reserviert.

Hinweis: In vielen Fällen ist es sinnvoller, statt dieser Funktion Rwabs zu verwenden. Der angegebene Speicherbereich muß für die jeweilige Hardware beschreibbar sein (Stichwort: Fast-RAM-Buffer). SCSI-Geräte werden von dieser Funktion nicht per DMA, sondern per Handshake betrieben.

Ergebnis:

Die Funktion liefert als Ergebnis eine 0, wenn kein Fehler passiert ist, ansonsten einen Fehlercode.

Verfügbar:

Diese Funktion steht erst ab TOS 2.00 zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding DMAwrite Floprd Flopwr Rwabs

4.14.1.1 Bindings für DMAread

#include <tos.h>

int16_t DMAread( int32_t sector, int16_t count, void *buffer, int16_t devno );

Assembler:

move.w    devno,-(sp)  ; Offset 12
pea       buffer       ; Offset  8
move.w    count,-(sp)  ; Offset  6
move.l    sector,-(sp) ; Offset  2
move.w    #42,-(sp)    ; Offset  0
trap      #14          ; XBIOS aufrufen
lea       $E(sp),sp    ; Stack korrigieren

4.14.2 DMAwrite

Name:

»DMA write« - schreibt einzelne Sektoren auf eine DMA-Einheit.

Xbiosnummer:

Deklaration:

int16_t DMAwrite( int32_t sector, int16_t count, void *buffer, int16_t devno );

Beschreibung:

Die XBIOS-Routine DMAwrite schreibt einzelne oder mehrere Sektoren auf ein ACSI- oder SCSI-Gerät. Es gilt:

Parameter

Bedeutung

sector

erste Sektornummer

count

Anzahl der Sektoren

buffer

Anfangsadresse im Speicher

devno

Gerätenummer. Es gilt:

0..7:	ACSI-Geräte
8..15:	SCSI-Geräte (TOS 2.06 und ab 3.00)
16	IDE-Geräte (TOS 2.06 und ab 3.06)

Alle anderen Werte sind für zukünftige Erweiterungen reserviert.

Hinweis: In vielen Fällen ist es sinnvoller, statt dieser Funktion Rwabs zu verwenden. Der angegebene Speicherbereich muß für die jeweilige Hardware lesbar sein (Stichwort: Fast-RAM-Buffer). SCSI-Geräte werden von dieser Funktion nicht per DMA, sondern per Handshake betrieben.

Ergebnis:

Die Funktion liefert als Ergebnis eine 0, wenn kein Fehler passiert ist, ansonsten einen Fehlercode.

Verfügbar:

Diese Funktion steht erst ab TOS 2.00 zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding DMAread Floprd Flopwr Rwabs

4.14.2.1 Bindings für DMAwrite

#include <tos.h>

int16_t DMAwrite( int32_t sector, int16_t count, void *buffer, int16_t devno );

Assembler:

move.w    devno,-(sp)  ; Offset 12
pea       buffer       ; Offset  8
move.w    count,-(sp)  ; Offset  6
move.l    sector,-(sp) ; Offset  2
move.w    #43,-(sp)    ; Offset  0
trap      #14          ; XBIOS aufrufen
lea       $E(sp),sp    ; Stack korrigieren

4.14.3 Flopfmt

Name:

»Floppy format« - formatiert einzelne Spuren auf einer Diskette.

Xbiosnummer:

Deklaration:

int16_t Flopfmt( void *buf, int32_t filler, int16_t devno, int16_t spt, int16_t trackno, int16_t sideno, int16_t interlv, int32_t magic, int16_t virgin );

Beschreibung:

Die XBIOS-Routine Flopfmt formatiert eine oder mehrere Spuren auf einer Diskette. Es gilt:

Parameter	Bedeutung
buf	Zeiger auf einen Bereich, in dem die Daten für die Spur gespeichert werden können.
filler	bei allen TOS-Versionen < 1.02 unbenutzt, und auf 0 zu setzen. Ab dem Blitter-TOS gilt: wenn interlv = -1 ist, so ist filler als Zeiger auf eine Tabelle von Sektornummern anzusehen (16Bit-Worte). Dadurch ergibt sich die Möglichkeit, die Reihenfolge der Sektoren auf der Spur frei zu wählen.
devno	0 = Laufwerk-A, 1 = Laufwerk-B
spt	Sektoren pro Spur (normal: 9). Falls der Cookie _FDC gesetzt ist, sind auch Werte von 18 (High-Density) bzw. 36 (Extra-High-Density) Sektoren erlaubt. Die Umschaltung der verschiedenen Schreibverfahren findet bei 13 (HD) bzw. 26 (ED) statt.
trackno	Nummer der Spur (0..79)
sideno	0: Seite-1 1: Seite-2 (bei doppelseitigen Disketten)
interlv	bestimmt, wie viele physikalische Sektoren jeweils zwischen zwei logischen Sektoren liegen (normal: 1)
magic	0x87654321, sonst wird nicht formatiert.
virgin	Bitmuster, welches beim Formatieren in jeden Sektor geschrieben wird (normal: 0xe5e5). Die oberen vier Bits dürfen nicht gesetzt werden, da dies sonst vom Controller als Kommando interpretiert würde.

Hinweis: Ab dem Blitter-TOS erlaubt es das Desktop, eine Liste von Sektornummern zu übergeben, um Spuren derart zu spiralisieren, daß beim Spurwechsel möglichst wenig Zeit mit dem Warten auf den nächsten Sektor verloren wird.

Bei einem normalen Format (9 Sektoren pro Spur) muss der über den Parameter buf angegebene Speicherbereich eine Größe von mindestens 8 Kbyte besitzen; in anderen Fällen muss der Puffer evtl. noch vergrößert werden.

Ergebnis:

Die Funktion liefert als Ergebnis eine 0, wenn kein Fehler passiert ist. Im Fehlerfall wird eine durch 0 abgeschlossene Liste der fehlerhaften Sektoren in den Puffer geschrieben.

Verfügbar:

Alle TOS Versionen.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Flopwr

4.14.3.1 Bindings für Flopfmt

#include <tos.h>

int16_t Flopfmt( void *buf, int32_t filler, int16_t devno, int16_t spt, int16_t trackno, int16_t sideno, int16_t interlv, int32_t magic, int16_t virgin );

Assembler:

move.w    virgin,-(sp)  ; Offset 24
move.l    magic,-(sp)   ; Offset 20
move.w    interlv,-(sp) ; Offset 18
move.w    sideno,-(sp)  ; Offset 16
move.w    trackno,-(sp) ; Offset 14
move.w    spt,-(sp)     ; Offset 12
move.w    devno,-(sp)   ; Offset 10
move.l    filler,-(sp)  ; Offset  6
pea       buf           ; Offset  2
move.w    #10,-(sp)     ; Offset  0
trap      #14           ; XBIOS aufrufen
lea       $1A(sp),sp    ; Stack korrigieren

GFA-Basic

Fehler%=Xbios(10,L:buf%,L:filler%,W:devno%,W:spt%,W:trackno%,W:sideno%,W:interlv%,L:magic%,W:virgin%)

4.14.4 Floprate

Name:

»Floppy rate« - liest oder setzt die seek rate eines Floppylaufwerks.

Xbiosnummer:

Deklaration:

int16_t Floprate( int16_t devno, int16_t newrate );

Beschreibung:

Die XBIOS-Routine Floprate liefert bzw. setzt die aktuelle Seekrate. Es gilt:

Parameter

Bedeutung

devno

Laufwerksnummer

0	=	Laufwerk-A
1	=	Laufwerk-B usw.

newrate

-1	=	Seekrate nicht verändern
0	=	Rate von 6ms
1	=	Rate von 12ms
2	=	Rate von 2ms
3	=	Rate von 3ms

Hinweis: Ab MagiC 3 kann darüberhinaus per Floprate (-1, newrate) der Timeout für die Floppy eingestellt werden; ein Wert von 300 bedeutet 1,5 Sekunden (dies ist der Wert, der beim Booten per Default eingestellt ist).

Bei älteren ROM-TOS-Versionen muß man die vorher undokumentierten Systemvariablen verwenden:

TOS-Version	Laufwerk A	Laufwerk B
RAM-TOS	0x6ca	0x6ce
1.00	0xa08	0xa0c
1.02	0xa4e	0xa52

Zum portablen Setzen kann man die folgende Beispielroutine nutzen.

Das MilanTOS 4.08 (2003.09.03) macht nichts mit den Werten und liefert immer null zurück.

Ergebnis:

Die Funktion liefert die vorherige Seekrate als Ergebnis.

Verfügbar:

Die Funktion steht erst ab TOS 1.04 zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Flopwr Floprd Flopver Flopfmt

4.14.4.1 Bindings für Floprate

C:	#include <tos.h> int16_t Floprate( int16_t devno, int16_t newrate );
Assembler:	move.w newrate,-(sp) ; Offset 4 move.w devno,-(sp) ; Offset 2 move.w #41,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #6,sp ; Stack korrigieren

4.14.4.2 Seekrate für alle TOS-Versionen

/* Portables Setzen der Floppy-Seekrate für alle TOS-Versionen
   (außer RAM-TOS 1.00).
   Parameter: genau wie bei XBIOS-Funktion "Floprate()" */

int16_t SeekRate ( int16_t devno, int16_t newrate )
{
  int32_t stack;
  int16_t version;
  OSHEADER *sys;

  /* Zeiger auf OS-Header holen */
  stack = Super (0L);
  sys = *((OSHEADER **) 0x4f2);
  version = sys->os_version;
  Super ((void *)stack);

  /* bei neuem TOS einfach "Floprate()" aufrufen */
  if ( version >= 0x0104 )
    return Floprate ( devno, newrate );
  else
  {
    /* sonst Zeiger auf interne GEMDOS-Variablen
       berechnen */
    int16_t *sk, merk;

    if ( version == 0x0102 )
      sk = (int16_t *) 0x0a4e;
    else
      sk = (int16_t *) 0x0a08;

    /* Laufwerk B: 2 int16_t dahinter */
    if ( devno ) sk = &(sk[2]);

    merk = *sk;
    /* Wert nur bei ungleich -1 eintragen */
    if ( newrate != -1 ) *sk = newrate;

    /* alten Wert immer zurückliefern */
    return merk;
  }
}

4.14.5 Floprd

Name:

»Floppy read« - liest einzelne Sektoren von einer Platteneinheit.

Xbiosnummer:

Deklaration:

int16_t Floprd( void *buf, int32_t filler, int16_t devno, int16_t sectno, int16_t trackno, int16_t sideno, int16_t count );

Beschreibung:

Die XBIOS-Routine Floprd liest einen oder mehrere physikalische Sektoren von einer Diskette. Es gilt:

Parameter	Bedeutung

buf	Zeiger auf Speicherbereich für die eingelesenen Sektoren
filler	unbenutzt
devno	Laufwerk (0 = Laufwerk-A usw.)
sectno	Startsektor (normal zwischen 1 und 9)
trackno	Tracknummer (normal zwischen 0 und 79)
sideno	Seite der Diskette (0 oder 1)
count	Anzahl der zu lesenden Sektoren

Ergebnis:

Die Funktion liefert als Ergebnis eine 0, wenn kein Fehler passiert ist, ansonsten einen Fehlercode.

Verfügbar:

Alle TOS Versionen.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding DMAread DMAwrite Flopwr Rwabs

4.14.5.1 Bindings für Floprd

#include <tos.h>

int16_t Floprd( void *buf, int32_t filler, int16_t devno, int16_t sectno, int16_t trackno, int16_t sideno, int16_t count );

Assembler:

move.w    count,-(sp)   ; Offset 18
move.w    sideno,-(sp)  ; Offset 16
move.w    trackno,-(sp) ; Offset 14
move.w    sectno,-(sp)  ; Offset 12
move.w    devno,-(sp)   ; Offset 10
move.l    filler,-(sp)  ; Offset  6
pea       buf           ; Offset  2
move.w    #8,-(sp)      ; Offset  0
trap      #14           ; XBIOS aufrufen
lea       $14(sp),sp    ; Stack korrigieren

GFA-Basic

Fehler%=Xbios(8,L:buf%,L:filler%,W:devno%,W:sectno%,W:trackno%,W:sideno%,W:count%)

4.14.6 Flopver

Name:

»Floppy verify« - überprüft Disketten.

Xbiosnummer:

Deklaration:

int16_t Flopver( void *buf, int32_t filler, int16_t devno, int16_ sectno, int16_t trackno, int16_t sideno, int16_t count );

Beschreibung:

Die XBIOS-Routine Flopver überprüft, ob eine Reihe von Sektoren fehlerfrei von einem Disketten-Laufwerk gelesen werden kann. Es gilt:

Parameter

Bedeutung

buf

Zeiger auf einen 1024 Byte großen Speicherbereich, in den die zu verifizierenden Sektoren eingelesen werden können.

filler

unbenutzt (sollte auf 0 gesetzt werden)

devno

Laufwerk

0	=	Laufwerk-A
1	=	Laufwerk-B

sectno

Startsektor (normal zwischen 1 und 9)

trackno

Tracknummer (normal zwischen 0 und 79)

sideno

Seite der Diskette (0 oder 1)

count

Anzahl der zu überprüfenden Sektoren

Hinweis: Nach dem Aufruf findet man im Parameter buf eine durch Null abgeschlossene Liste von 16-Bit Worten mit den Nummern der defekten Sektoren. Die Funktion vergleicht also keine Sektoren mit einem Speicherbereich; stattdessen liest sie die Sektoren in den immer selben Puffer ein. Dabei wird nur überprüft, ob die Sektoren korrekt gelesen werden können, oder ob beim Lesen Lesefehler auftreten.

Ergebnis:

Die Funktion liefert als Ergebnis den Wert 0, wenn die im Parameter buf abgelegte Liste gültig ist und anderenfalls einen Wert ungleich Null.

Verfügbar:

Alle TOS Versionen.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding

4.14.6.1 Bindings für Flopver

#include <tos.h>

int16_t Flopver( void *buf, int32_t filler, int16_t devno, int16_ sectno, int16_t trackno, int16_t sideno, int16_t count );

Assembler:

move.w    count,-(sp)    ; Offset 18
move.w    sideno,-(sp)   ; Offset 16
move.w    trackno,-(sp)  ; Offset 14
move.w    sectno,-(sp)   ; Offset 12
move.w    devno,-(sp)    ; Offset 10
move.l    filler,-(sp)   ; Offset  6
pea       buf            ; Offset  2
move.w    #19,-(sp)      ; Offset  0
trap      #14            ; XBIOS aufrufen
lea       $14(sp),sp     ; Stack korrigieren

GFA-Basic

Fehler%=Xbios(19,L:buf%,L:filler%,W:devno%,W:sectno,W:trackno%,W:sideno%,W:count%)

4.14.7 Flopwr

Name:

»Floppy write« - schreibt einzelne Sektoren auf eine Platteneinheit.

Xbiosnummer:

Deklaration:

int16_t Flopwr( VOID *buf, int32_t filler, int16_t devno, int16_t sectno, int16_t trackno, int16_t sideno, int16_t count );

Beschreibung:

Die XBIOS-Routine Flopwr schreibt einen oder mehrere physikalische Sektoren auf eine Diskette. Es gilt:

Parameter	Bedeutung

buf	Zeiger auf Speicherbereich mit den zu schreibenden Sektoren
filler	unbenutzt
devno	Laufwerk (0=Laufwerk-A, 1=Laufwerk-B)
sectno	Startsektor (normal zwischen 1 und 9)
trackno	Tracknummer (normal zwischen 0 und 79)
sideno	Seite der Diskette (0 oder 1)
count	Anzahl der zu schreibenden Sektoren

Ergebnis:

Die Funktion liefert als Ergebnis eine 0, wenn kein Fehler passiert ist, ansonsten einen Fehlercode.

Verfügbar:

Alle TOS Versionen.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding DMAread DMAwrite Floprd

4.14.7.1 Bindings für Flopwr

#include <tos.h>

int16_t Flopwr( VOID *buf, int32_t filler, int16_t devno, int16_t sectno, int16_t trackno, int16_t sideno, int16_t count );

Assembler:

move.w    count,-(sp)    ; Offset 18
move.w    sideno,-(sp)   ; Offset 16
move.w    trackno,-(sp)  ; Offset 14
move.w    sectno,-(sp)   ; Offset 12
move.w    devno,-(sp)    ; Offset 10
move.l    filler,-(sp)   ; Offset  6
pea       buf            ; Offset  2
move.w    #9,-(sp)       ; Offset  0
trap      #14            ; XBIOS aufrufen
lea       $14(sp),sp     ; Stack korrigieren

GFA-Basic

Fehler%=Xbios(9,L:buf%,L:filler%,W:devno%,W:sectno%,W:trackno%,W:sideno,W:count%)

4.14.8 Metaclose

Name:	»Metaclose« - gibt ein MetaDOS-Gerät wieder frei.
Xbiosnummer:	50
Deklaration:	int32_t Metaclose( int16_t drive );
Beschreibung:	Die Funktion gibt das Laufwerk drive wieder frei.
Ergebnis:	Die Funktion liefert als Ergebnis einen Wert vom Typ int32_t zurück.
Verfügbar:	Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.
Gruppe:	Laufwerksfunktionen
Querverweis:	Binding Metaopen

4.14.8.1 Bindings für Metaclose

C:	int32_t Metaclose( int16_t drive );
Assembler:	move.w drive,-(sp) ; Offset 2 move.w #50,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #4,sp ; Stack korrigieren

4.14.9 Metadiscinfo

Name:

»Metadiscinfo« - ermittelt aktuelle Status-Informationen.

Xbiosnummer:

Deklaration:

int32_t Metadiscinfo( int16_t drive, CD_DISC_INFO *p );

Beschreibung:

Die Funktion ermittelt Informationen über den Status eines MetaDOS-Gerätes. Es gilt:

Parameter	Bedeutung
drive	gewünschtes Laufwerk
p	Adresse des aufnehmenden Puffers

Hinweis: Die Positionsangaben innerhalb der Struktur sind im BCD-MSF-Format codiert. Die Komponente index wird von alten BOS-Treibern nicht gesetzt, und die Komponente disctype ist bei SCSI-CD-ROMs nicht gesetzt.

Ergebnis:

Die Funktion liefert als Ergebnis einen Wert vom Typ int32_t zurück.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Metastatus

4.14.9.1 Bindings für Metadiscinfo

C:	int32_t Metadiscinfo( int16_t drive, CD_DISC_INFO *p );
Assembler:	pea p ; Offset 4 move.w drive,-(sp) ; Offset 2 move.w #63,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #8,sp ; Stack korrigieren

4.14.10 Metagettoc

Name:

»Metagettoc« - liefert das Inhaltsverzeichnis eines Gerätes.

Xbiosnummer:

Deklaration:

int32_t Metagettoc( int16_t drive, int16_t flag, CD_TOC_ENTRY *buffer );

Beschreibung:

Die Funktion liefert das Inhaltsverzeichnis eines Laufwerks zurück. Es gilt:

Parameter	Bedeutung
drive	gewünschtes Laufwerk
flag	reserviert für CDAR504
buffer	Puffer zur Aufnahme des Verzeichnisses

Hinweis: Der aufnehmende Puffer sollte Platz für 128 Einträge bieten. Jeder Eintrag besteht aus einer Tracknummer und MSF-Adresse (jeweils im BCD-Format). Für die Tracknummer gilt dabei:
0 = Record hat keine Bedeutung
0x01...0x99 = Tracknummer in BCD-Codierung
0xa0 = erster Track bei programmierter Reihenfolge
0xa2 = Ende der CD.

Ergebnis:

Die Funktion liefert als Ergebnis einen Wert vom Typ int32_t zurück.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Metaread Metawrite

4.14.10.1 Bindings für Metagettoc

C:	int32_t Metagettoc( int16_t drive, int16_t flag, CD_TOC_ENTRY *buffer );
Assembler:	pea buffer ; Offset 6 move.w flag,-(sp) ; Offset 4 move.w drive,-(sp) ; Offset 2 move.w #62,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen lea $A(sp),sp ; Stack korrigieren

4.14.11 Metainit

Name:	»Metainit« - Informationen über die installierte Version von MetaDOS ermitteln.
Xbiosnummer:	48
Deklaration:	void Metainit( META_INFO_1 *buffer );
Beschreibung:	Die XBIOS-Routine Metainit ermittelt Informationen über die aktuell installierte Version von MetaDOS, und der ihr bekannten Geräte. Es bietet sich folgendes Verfahren an: Inhalt der META_INFO_1 Struktur komplett löschen Funktion Metainit aufrufen Testen, ob die Komponente version noch einen Nullzeiger enthält (dann ist kein MetaDOS installiert).
Ergebnis:	Die Funktion liefert kein direktes Ergebnis.
Verfügbar:	Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.
Gruppe:	Laufwerksfunktionen
Querverweis:	Binding

4.14.11.1 Bindings für Metainit

C:	void Metainit( META_INFO_1 *buffer );
Assembler:	pea buffer ; Offset 2 move.w #48,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #6,sp ; Stack korrigieren

4.14.12 Metaioctl

Name:

»Metaioctl« - schickt GEMDOS-Opcodes an ein MetaDOS Gerät.

Xbiosnummer:

Deklaration:

int32_t Metaioctl( int16_t drive, int32_t magic, int16_t opcode, void *buffer );

Beschreibung:

Die Funktion erlaubt es, Opcodes der GEMDOS-Routinen Dcntl bzw. Fcntl an ein MetaDOS Gerät abzusetzen. Es gilt:

Parameter	Bedeutung
drive	gewünschtes Laufwerk
magic	muss Wert 'FCTL' besitzen
opcode	abzusetzender Opcode
buffer	abhängig vom Opcode

Hinweis: Die Liste der CD-ROM Kommandos ist eine Aufstellung aller bekannten Opcodes, die bei der Arbeit mit CD-ROMs anfallen können.

Ergebnis:

Die Funktion liefert im Fehlerfall einen der folgenden Werte zurück:

EINVFN:	der angegebene Opcode wird nicht unterstützt.
EUNCMD:	die Funktion selbst (!) wird nicht unterstützt.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Dcntl Fcntl

4.14.12.1 Bindings für Metaioctl

int32_t Metaioctl( int16_t drive, int32_t magic, int16_t opcode, void *buffer );

Assembler:

pea       buffer       ; Offset 10
move.w    opcode,-(sp) ; Offset  8
move.l    magic,-(sp)  ; Offset  4
move.w    drive,-(sp)  ; Offset  2
move.w    #55,-(sp)    ; Offset  0
trap      #14          ; XBIOS aufrufen
lea       $E(sp),sp    ; Stack korrigieren

4.14.13 Metaopen

Name:

»Metaopen« - initialisiert ein MetaDOS-Gerät.

Xbiosnummer:

Deklaration:

int32_t Metaopen( int16_t drive, META_DRVINFO *buffer );

Beschreibung:

Die Funktion initialisiert ein MetaDOS-Gerät. Es gilt:

Parameter	Bedeutung

drive	gewünschtes Laufwerk
buffer	Puffer zur Aufnahme des Namens des Treibers

Hinweis: Falls der Treibername mit 'CD' beginnt, darf man davon ausgehen, daß es sich um einen CD-ROM-Treiber handelt.

Ergebnis:

Die Funktion liefert als Ergebnis einen Wert 0 wenn alles OK oder eine negative Fehlernummer.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Metaclose

4.14.13.1 Bindings für Metaopen

C:	int32_t Metaopen( int16_t drive, META_DRVINFO *buffer );
Assembler:	pea buffer ; Offset 4 move.w drive,-(sp) ; Offset 2 move.w #49,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #8,sp ; Stack korrigieren

4.14.14 Metaread

Name:

»Metaread« - liest Daten von einem MetaDOS-Gerät.

Xbiosnummer:

Deklaration:

int32_t Metaread( int16_t drive, void *buffer, int32_t blockno, int16_t count );

Beschreibung:

Die Funktion liest Daten von einem MetaDOS-Gerät. Es gilt:

Parameter	Bedeutung

drive	gewünschtes Laufwerk
buffer	Puffer zur Aufnahme der Daten
blockno	Nummer des Startblocks
count	Anzahl der zu lesenden Blöcke

Hinweis: Die Blockgröße beträgt bei CD-ROMs 2048 Bytes; dies kann jedoch leider nicht gezielt abgefragt werden. Aufgrund einer Begrenzung in Atari's BOS-Treibern können maximal 63 Blöcke an einem Stück gelesen werden.

Ergebnis:

Die Funktion liefert als Ergebnis einen Wert vom Typ int32_t zurück.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Metawrite

4.14.14.1 Bindings für Metaread

int32_t Metaread( int16_t drive, void *buffer, int32_t blockno, int16_t count );

Assembler:

move.w    count,-(sp)   ; Offset 10
move.l    blockno,-(sp) ; Offset  8
pea       buffer        ; Offset  4
move.w    drive,-(sp)   ; Offset  2
move.w    #51,-(sp)     ; Offset  0
trap      #14           ; XBIOS aufrufen
lea       $E(sp),sp     ; Stack korrigieren

4.14.15 Metaseek

Name:

»Metaseek« - Seeks to a physical address.

Xbiosnummer:

Binding:

int32_t Metaseek( int16_t drive, int32_t blockno );

Beschreibung:

The function will seek the physical unit to a physical address. The function call will return once the seek has been completed or on an error condition. The following apply:

Parameter	Bedeutung

drive	gewünschtes Laufwerk
blockno	Block number to seek to

Ergebnis:

Die Funktion liefert als Ergebnis einen Wert vom Typ int32_t zurück.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Metaread Metawrite

4.14.15.1 Bindings für Metaseek

C:	int32_t Metaseek( int16_t drive, int32_t blockno );
Assembler:	move.l blockno,-(sp) ; Offset 4 move.w drive ; Offset 2 move.w #53,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #8,sp ; Stack korrigieren

4.14.16 Metasetsongtime

Name:

»Metasetsongtime« - startet eine Audio-Wiedergabe.

Xbiosnummer:

Binding:

Bindings für Metasetsongtime

Beschreibung:

Die Funktion startet eine Audio-Wiedergabe. Es gilt:

Parameter

Bedeutung

drive

gewünschtes Laufwerk

repeat

Repeat

0	=	ohne Wiederholung
1	=	mit Wiederholung

starttime

BCD-Anfangszeit in MSF-Codierung

endtime

BCD-Endzeit in MSF-Codierung

Hinweis: Der Repeat-Modus wird anscheinend nur von CDARGEN.BOS und auch nur für das Atari-CDAR504 unterstützt.

Ergebnis:

Die Funktion liefert als Ergebnis einen Wert vom Typ int32_t zurück.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Metastartaudio Metastopaudio

4.14.16.1 Bindings für Metasetsongtime

int32_t Metasetsongtime( int16_t drive, int16_t repeat, int32_t starttime, int32_t endtime );

Assembler:

move.l    endtime,-(sp)    ; Offset 10
move.l    starttime,-(sp)  ; Offset  6
move.w    repeat           ; Offset  4
move.w    drive            ; Offset  2
move.w    #61,-(sp)        ; Offset  0
trap      #14              ; XBIOS aufrufen
lea       $E(sp),sp        ; Stack korrigieren

4.14.17 Metastartaudio

Name:

»Metastartaudio« - startet eine Audio-Wiedergabe.

Xbiosnummer:

Binding:

int32_t Metastartaudio( int16_t drive, int16_t flag, uint8_t *bytearray);

Beschreibung:

Die Funktion startet eine Audio-Wiedergabe. Es gilt:

Parameter	Bedeutung

drive	gewünschtes Laufwerk
flag	Modus
bytearray	abhängig vom Parameter flag

Hinweis: Auf SCSI-Geräten existiert nur ein Modus (flag = 0). In diesem Fall übergibt man in bytearray[0] die Anzahl der Lieder, und in bytearray[1] die Nummer des ersten Liedes.

Ergebnis:

Die Funktion liefert als Ergebnis einen Wert vom Typ int32_t zurück.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Metasetsongtime Metastopaudio

4.14.17.1 Bindings für Metastartaudio

C:	int32_t Metastartaudio( int16_t drive, int16_t flag, uint8_t *bytearray);
Assembler:	pea bytearray ; Offset 6 move.w flag,-(sp) ; Offset 4 move.w drive,-(sp) ; Offset 2 move.w #59,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen lea $A(sp),sp ; Stack korrigieren

4.14.18 Metastatus

Name:

»Metastatus« - ermittelt den Status eines MetaDOS Gerätes.

Xbiosnummer:

Deklaration:

int32_t Metastatus( int16_t drive, void *buffer );

Beschreibung:

Die Funktion ermittelt den Status eines MetaDOS Gerätes. Es gilt:

Parameter	Bedeutung

drive	gewünschtes Laufwerk
buffer	abhängig von der Implementierung des BOS-Treibers

Achtung: Diese Funktion ist optional. Sie steht nur bei installiertem MetaDOS zur Verfügung.

Ergebnis:

Die Funktion liefert als Ergebnis einen 32-Bit Wert zurück, der wie folgt codiert ist:

High-Word:

0x0000	=	alles ok
0xffff	=	Fehler aufgetreten

Low-Word :

Bit-15	(Fehler)
Bit-07	(Timeout)
Bit-02	(Medienwechsel)
Bit-01	(Busy)

Alle anderen Bits des Low-Words sind z.Zt. reserviert.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Metadiscinfo

4.14.18.1 Bindings für Metastatus

C:	int32_t Metastatus( int16_t drive, void *buffer );
Assembler:	pea buffer ; Offset 4 move.w drive,-(sp) ; Offset 2 move.w #54,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #8,sp ; Stack korrigieren

4.14.19 Metastopaudio

Name:	»Metastopaudio« - beendet eine Audio-Wiedergabe.
Xbiosnummer:	60
Deklaration:	int32_t Metastopaudio( int16_t drive );
Beschreibung:	Die Funktion beendet die Audio-Wiedergabe für das Laufwerk drive.
Ergebnis:	Die Funktion liefert als Ergebnis einen Wert vom Typ int32_t zurück.
Verfügbar:	Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.
Gruppe:	Laufwerksfunktionen
Querverweis:	Binding Metastartaudio Metasetsongtime

4.14.19.1 Bindings für Metastopaudio

C:	int32_t Metastopaudio( int16_t drive );
Assembler:	move.w drive,-(sp) ; Offset 2 move.w #60,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #4,sp ; Stack korrigieren

4.14.20 Metawrite

Name:

»Metawrite« - schreibt Daten auf ein MetaDOS-Gerät.

Xbiosnummer:

Deklaration:

int32_t Metawrite( int16_t drive, void *buffer, int32_t blockno, int16_t count );

Beschreibung:

Die Funktion schreibt Daten auf ein MetaDOS-Gerät. Es gilt:

Parameter	Bedeutung

drive	gewünschtes Laufwerk
buffer	Adresse des Datenpuffers
blockno	Nummer des Startblocks
count	Anzahl der zu schreibenden Blöcke

Hinweis: Bei einem CD-ROM hat diese Funktion natürlich keine Wirkung.

Ergebnis:

Die Funktion liefert als Ergebnis einen Wert vom Typ int32_t zurück.

Verfügbar:

Diese Funktion steht nur bei installiertem MetaDOS zur Verfügung.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Metaread

4.14.20.1 Bindings für Metawrite

int32_t Metawrite( int16_t drive, void *buffer, int32_t blockno, int16_t count );

Assembler:

move.w    count,-(sp)   ; Offset 10
move.l    blockno,-(sp) ; Offset  8
pea       buffer        ; Offset  4
move.w    drive,-(sp)   ; Offset  2
move.w    #52,-(sp)     ; Offset  0
trap      #14           ; XBIOS aufrufen
lea       $E(sp),sp     ; Stack korrigieren

4.14.21 Protobt

Name:

»prototype boot sector« - Standard-Boot-Sektor.

Xbiosnummer:

Deklaration:

void Protobt( void *buf, int32_t serialno, int16_t disktype, int16_t execflag );

Beschreibung:

Die XBIOS-Routine Protobt legt einen Boot-Sektor auf einer Diskette an. Das Argument buf verweist auf einen 512 Byte großen Puffer mit dem Inhalt des Boot-Sektors. Der Parameter serialno dient dazu, eine Seriennummer im Bootsektor abzuspeichern. Wenn die Variable serialno größer als 0x01000000 ist, dann wird eine Zufallszahl abgelegt. Mit disktype wird eine der folgenden Diskettenarten ausgewählt:

disktype	Bedeutung

-1	nicht verändern
0	40 Spuren, einseitig (180 Kbyte)
1	40 Spuren, doppelseitig (360 Kbyte)
2	80 Spuren, einseitig (360 Kbyte)
3	80 Spuren, doppelseitig (720 Kbyte)
4	High-Density (1,44 Mbyte) Wird nur unterstützt, wenn im Cookie _FDC der Wert für HD-Unterstützung eingetragen ist.
5	Extra-High-Density (2,88 Mbyte) Wird nur unterstützt, wenn im Cookie _FDC der Wert für ED-Unterstützung eingetragen ist.

Der Parameter execflag legt schließlich fest, ob die Informationen im Boot-Sektor als Programm ausgeführt werden können. Es gilt:

execflag	Bedeutung

-1	Bootsektor nicht verändern
0	Bootsektor nicht ausführen
1	Bootsektor ausführbar

Hinweis: Damit Disketten auch auf MSDOS-Systemen gelesen werden können, müssen in die ersten 3 Bytes des Bootsektors die Werte 0xE9, 0x00 und 0x4E oder 0xEB, 0x34 und 0x90 eingetragen werden; auf diese Art und Weise behandelte Disketten sind unter TOS dann allerdings nicht mehr bootbar.

Ergebnis:

Die Funktion liefert kein Ergebnis.

Verfügbar:

Alle TOS Versionen.

Gruppe:

Laufwerksfunktionen

Querverweis:

Binding Flopfmt

4.14.21.1 Bindings für Protobt

#include <tos.h>

void Protobt( void *buf, int32_t serialno, int16_t disktype, int16_t execflag );

Assembler:

move.w    execflag,-(sp)  ; Offset 12
move.w    disktype,-(sp)  ; Offset 10
move.l    serialno,-(sp)  ; Offset  6
pea       buf             ; Offset  2
move.w    #18,-(sp)       ; Offset  0
trap      #14             ; XBIOS aufrufen
lea       $E(sp),sp       ; Stack korrigieren

GFA-Basic

Fehler%=Xbios(18,L:buf%,L:serialno%,W:disktype%,W:execflag%)

XBIOS

Interruptfunktionen

MATRIX-XBIOS-Erweiterung