Beschreibung der Schnittstelle von MagiC zum ROM-TOS des Milan ============================================================== Stand: 30.06.1999, letzte Žnderungen mit '#' markiert. Zu den Adressen: MagiCs Systemvariablen beginnen bei 0x840L und enden bei 0x5000. Am besten erreicht MagiC die Milan-Schnittstelle ber den Beginn des System-ROMs, ber einen erweiterten TOS-Header. struct xsysheader { WORD shortbranch; /* bra.b ... */ WORD version; void * startadr; struct xsysheader *syshdr; void * begin_ram; void * ptr; void * gem_magics; LONG us_date_bcd; WORD countrycode_palflag; WORD gemdos_date; void * _mifl; char * kbshift; void ** act_pd; void * zero; /* hier Milan-Sachen */ WORD milan_reserved[4]; /* Ab hier die Erweiterung: */ LONG milan_magic; /* Muž z.B. 'Miln' sein */ MILAN_OS *milan_os; /* Zeiger auf die šbergabestruktur */ }; Die Schnittstelle soll im wesentlichen Funktionszeiger enthalten, die MagiC aufruft. Dazu kommt etwas Kleinkram. Die Struktur ist so gestaltet, daž sie im ROM liegen kann, indem statt variabler Werte stets Zeiger enthalten sind. typedef struct { LONG version; /* zun„chst 0 */ MEMINFO *meminfo; /* Informationen ber Speicherbl”cke */ BIOSFN *bios_fnx; /* Tabelle der BIOS-Funktionen */ BIOSFN *xbios_fnx; /* Tabelle der XBIOS-Funktionen */ DEVVECS *devvecs; /* Tabelle der Ger„tevektoren */ void *ihdvvecs; /* hdv_xxx initialisieren */ void *iexcvecs; /* HBL/LineA initialisieren */ void *iperiph; /* Peripherie initialisieren (MFP) */ void *dmaboot; /* von HD booten */ void *coldboot; /* Kaltstart */ void *init_maptab; /* fr Bconmap */ void *prn_wrts; /* mehrere Zeichen auf Prn */ void *hdl_pling; /* "Hook" fr Glocke */ void *hdl_klick; /* "Hook" fr Tastaturklick */ WORD *ncookies; /* Anzahl maschinenspez. Cookies */ void *inst_cookies; /* machinenspez. Cookies installieren */ void *get_cpu; /* CPU-Typ ermitteln */ void *get_fpu; /* FPU-Typ ermitteln */ void *gethtime; /* Uhrzeit/Datum wie Xbios Gettime */ void *vblhook; /* Fr MagiC-Interrupt VBL */ void *iinit_hz200; /* Fr MagiC-Interrupt hz_200 */ void *exit_hz200; void *iinit_ikbd; /* Fr MagiC-Interrupt IKBD */ void *exit_ikbd; void *dosound; /* wird mit 50 Hz im 200Hz-Int. aufgerufen */ void *autopacks; /* PKGs im Flash starten */ void *init_cpu1; /* CPU-"Roh"-Initialisierung */ void *init_cpu2: /* CPU-"Fein"-Initialisierung (cache an) */ void *gsx_entry: /* VDI-Einsprung */ LONG frb_adr; /* Adresse der FRB-Adresse */ void *prtbombs: /* Parameter: (a3 = sp, a4 = PD *) */ #void *caps_led; /* wird mit d0=kbshift aufgerufen */ #void *reserved[19]; /* alle NULL */ } MILAN_OS; # wird, wenn der Vektor nicht NULL ist, bei jedem Bet„tigen der #Taste CapsLock aufgerufen. Dabei wird die Variable kbshift in d0 #bergeben. ist wie im TOS. Die Routine darf die blichen Register ver„ndern. Sie wird, wie alle Routinen im TOS, nur bei jedem 4. Interrupt aufgerufen. gibt mehrere Zeichen auf die parallele Schnittstelle aus. Gibt die Anzahl der ausgegebenen Zeichen zurck. Assembler-Prototyp: d0 = long prn_wrts( a0 = char *buf, d0 = long count ). Darf d0-d2/a0-a2 „ndern. Im Prinzip kann man hier auch eine Schleife ber die normale BIOS- Ausgabe programmieren, aber es gibt vielleicht eine schnellere M”glichkeit. und sind mit TOS 1.6 eingefhrt worden. Ich k”nnte die Routinen auch einfach aus dem RAM bernehmen. W„re h”chstens kritisch, wenn jemand die umgebogen hat, bevor MagiC installiert wird. Sag Bescheid, wenn wir sie weglassen sollen. installiert alle maschinenspezifischen Cookies, d.h.: _CPU _FPU _VDO _MCH _SND _FDC Die Routine erh„lt einen Zeiger auf die Cookie-Tabelle in a0 sowie die Tabellenl„nge in d0. ist der Brutto-Platz in der Tabelle, d.h. sie hat Platz fr Cookies plus Ende-Kennung. Rckgabewert E_OK bzw. ERROR (šberlauf). Im Fall eines šberlaufs wird die Tabelle trotzdem initialisiert, d.h. das erste LONG auf 0L und das zweite auf NCOOKIES gesetzt. Prototyp: LONG inst_cookies( a0 = COOKIE *co, d0 = LONG ncookies ) initialisiert die Systemvektoren: hdv_init hdv_rw hdv_bpb hdv_mediach hdv_boot. Prototyp: void ihdvvecs( void ) initialisiert diejenigen Exception-Vektoren, welche _NICHT_ zu Bomben fhren sollen und nicht ignoriert werden sollen. Bevor dieser Aufruf gemacht wird, initialisiert MagiC die Vektoren 2..63 auf Bomben, aužer 25..31 auf "rte". Aužerdem initialisiert MagiC die Privilegsverletzung zur Emulation von "move sr,ea" und die Division durch Null (einfach als "rte"). Auf dem Atari mžten hier HBL und LineA initialisiert werden. initialisiert die Peripherieger„te mit ihren Exception- Vektoren. Auf dem Atari sind das die MFPs und ihre Vektoren. bootet von HD (SCSI/ACSI/IDE). Zu diesem Zeitpunkt hat MagiC bereits den Vektor hdv_boot aufgerufen, um von Floppy zu booten. Prototyp: void dmaboot( void ) macht einen Kaltstart. Prototyp: void dmaboot( void ) liefert z.B. 40 oder 60 oder 586, je nach CPU. Prototyp: WORD get_cpu( void ) liefert z.B. 0 (keine FPU), 1 (fr 68881), 2 (fr 68882), 40 (fr 68040) oder 60 (fr 68060), je nach CPU/FPU. Prototyp: WORD get_fpu( void ) arbeitet wie Xbios(23), die Routine l„žt sich aber mit "jsr" aufrufen, d.h. endet auf "rts". wird von MagiC im VBL-Interrupt aufgerufen, nachdem _frclock und vblsem bedient worden sind und bevor die VBL- Queue ausgefhrt wird. Die Routine darf alle Register d0-d7/a0-a6 ver„ndern und muž normal auf "rts" enden. Auf dem Atari wird hier die Umschaltung der Farbpalette, die Umschaltung der Bildschirmspeicheradresse sowie das Cursorblinken durchgefhrt. initialisiert die BCONMAP-Struktur. Prototyp: void imaptab( a0 = BCONMAP *bco ) und sind ROM-Routinen, die MagiC aufruft, um eine eigene 200Hz-Interrruptroutine bzw. eine Maus/Tastaturinterruptroutine einzuh„ngen. MagiC bergibt die Adresse seiner Routine in a0. Mit a0 == NULL klinkt es sich wieder aus. Fr 200Hz: MagiCs Routine inkrementiert _hz_200, macht seine eigene Tastatur-Wiederholung und ruft die User-Interruptroutinen auf. MagiC ruft dann auf, um die Interruptbehandlung abzuschliežen (diese Routine darf kein Register ver„ndern, ggf. kann hier auch "rts" stehen). MagiCs Routine beendet die Interrupt- Behandlung schliežlich mit "rte". Es ist wichtig, daž MagiC den Original-Interrupt-Frame bekommt, damit es feststellen kann, ob der Interrupt im Usermode oder im Supervisormode aufgetreten ist. Sound-Behandlung, Cursorblinken, VBL usw. sollte im ROM ausgefhrt werden, bevor MagiCs Routine aufgerufen wird. Fr ikbd: MagiCs Routine holt seine Parameter vom Stack. Die Daten sind gltig, wenn (sp) = 'Miln' ist. Dann: (sp) = 'Miln': Daten sind gltig dann: 4(sp) = 0: MIDI 4(sp) = 1: Tastatur 5(sp) = Atari-Scancode 4(sp) = 2: Mauspaket 5(sp),6(sp),7(sp) = char data[3] MagiC entfernt diese Variablen selber wieder vom Stack. MagiC ruft dann auf, um die Interruptbehandlung abzuschliežen (diese Routine darf kein Register ver„ndern, ggf. kann hier auch "rts" stehen). MagiCs Routine beendet die Interrupt- Behandlung schliežlich mit "rte". Es ist wichtig, daž MagiC den Original-Interrupt-Frame bekommt, damit es feststellen kann, ob der Interrupt im Usermode oder im Supervisormode aufgetreten ist. MagiC verwendet seine eigene IOREC-Struktur fr die Tastatur, die IORECs der anderen IOS-Ger„te werden vom ROM bernommen. Sondertasten sollten so wie in MagicMac kodiert werden: ; 0x49 ist Scancode fr PgUp ; 0x51 ist Scancode fr PgDn ; 0x4c ist Scancode fr AltGr ; 0x4f ist Scancode fr Ende Die Tabelle der Ger„tevektoren enth„lt die optimierten schnellen Original-Ger„tevektoren mit der Registerbergabe. Die Routinen drfen d0-d2/a0-a2 „ndern und erhalten ihre Parameter in (a0), 2(a0) usw. Der erste Assembler-Befehl jeder Routine muž lauten: "lea 6(sp),a0" (auch fr die Dummy-Funktionen der nicht vorhandenen Ger„te). Gibt es mehrere serielle Schnittstellen, die per Bconmap() umgeschaltet werden k”nnen, ist hier die erste (prim„re) eingetragen: struct { void *bconstat_dev0; /* Prn */ void *bconstat_dev1; /* Ser-1 */ void *bconstat_dev2; /* Con */ void *bconstat_dev3; /* MIDI */ void *bconstat_dev4; /* IKBD */ void *bconstat_dev5; /* RAW */ void *bconstat_dev6; void *bconstat_dev7; void *bconin_dev0; void *bconin_dev1; void *bconin_dev2; void *bconin_dev3; void *bconin_dev4; void *bconin_dev5; void *bconin_dev6; void *bconin_dev7; void *bcostat_dev0; void *bcostat_dev1; void *bcostat_dev2; void *bcostat_dev3; /* Achtung: MIDI/IKBD tauschen! */ void *bcostat_dev4; void *bcostat_dev5; void *bcostat_dev6; void *bcostat_dev7; void *bconout_dev0; void *bconout_dev1; void *bconout_dev2; void *bconout_dev3; void *bconout_dev4; void *bconout_dev5; void *bconout_dev6; void *bconsut_dev7; }; DEVVECS; Die Tabelle der (X)BIOS-Funktionen beginnt mit einem WORD, das die Anzahl der Funktionen festlegt. Die erste Funktion hat den Opcode 0, die letzte den Opcode -1. Die Routinen drfen d0-d2/a0-a2 „ndern und erhalten ihre Parameter in (a0), 2(a0) usw. Sie enden mit "rte": typedef struct { WORD len; /* L„nge der folgenden Tabelle */ void * bios_fn; /* Funktionszeiger */ /* ... weitere bios_fn ... */ } MEMINFO; MagiC ben”tigt Informationen ber das vorhandene RAM. Dazu gibt es eine Tabelle variabler L„nge. Das erste Element ist ST-RAM, weitere sind TT-RAM. Gibt es nur ST-RAM, ist == 1. Achtung!!! Das RAM, welches von dem Teil des Milan-ROM ben”tigt wird, den MagiC verwendet (Interrupt, VDI und (X)BIOS), darf natrlich _NICHT_ hier erscheinen, sonst wird es weggebgelt. Ich hoffe, daž weder (X)BIOS noch VDI des Milan ein Malloc() machen, sonst mssen wir uns etwas anderes ausdenken. typedef struct { WORD len; /* L„nge der folgenden Tabelle */ void * memadr; ULONG memlen; /* ... weitere memadr/memlen-Paare ... */ } MEMINFO;