EXTERNE TREIBER in æ-STic ------------------------- æ-STic untersttzt ab Version 2.10 die Kommunikation mit Eprom- mern anderer Firmen ber externe Treiberprogramme, die zur Erle- digung verschiedener Aufgaben von æ-STic mit entsprechenden Pa- rametern gestartet werden. Der Treiber 'EPROMMER.TTP' muž folgende Funktionen beinhalten: INIT ---- Wird von æ-STic bei Anwahl eines externen Treibers aufgerufen, um diesem Gelegenheit zu geben, sich zu initalisieren, z.B. um die Schnittstelle einzurichten. Weiterhin kann der Aufruf Informationen ber die M”glichkeiten des Treibers liefern. Kommandozeile : INIT Returnwerte : <0 = Fehler beim Initalisieren Bit 0 gesetzt = Initalisierung OK Bit 1 gesetzt = Treiber untersttzt Leertest Bit 2 gesetzt = Treiber untersttzt EEPROM l”schen Bit 3 gesetzt = Treiber untersttzt Identit„ts- abfrage des Epromtyps DEINIT ------ Wird von æ-STic beim Wechsel auf einen der æ-Prommer oder beim Verlassen des Programms aufgerufen, um ggf. notwendige Deinit- ialisierungen vorzunehmen. Kommandozeile : DEINIT Returnwerte : 0 = ok <0 = Fehler beim Deinitalisieren PROGRAMMIEREN ------------- Wird zum Programmieren einer Datei aufgerufen.Unter 'DATEI' wird der vollst„ndige Pfad der zu brennenden Datei bergeben. 'PARAMETER' beinhaltet die zu zum gew„hlten Eprom geh”renden Pa- rameter. Kommandozeile : PROG 'PARAMETER' 'DATEI' Returnwerte : 0 = ok <0 = Fehler beim Programmieren AUSLESEN -------- Wird zum Auslesen eines Eproms aufgerufen. Unter 'DATEI' wird der Pfad und Name der Datei bergeben, unter dem æ-STic den aus- gelesenen Eprominhalt erwartet. 'PARAMETER' beinhaltet die zu zum gew„hlten Eprom geh”renden Pa- rameter. Kommandozeile : READ 'PARAMETER' 'DATEI' Returnwerte : 0 = ok <0 = Fehler beim Auslesen Folgende Funktionen sind optional (siehe INIT): LEERTEST -------- Ruft die Funktion 'LEERTEST' des Treibers auf. 'PARAMETER' beinhaltet die zu zum gew„hlten Eprom geh”renden Pa- rameter. Kommandozeile : TEST 'PARAMETER' Returnwerte : 0 = Eprom leer 1 = Eprom nicht leer <0 = Fehler beim Leertest EEPROM l”schen -------------- Ruft die Funktion 'EEPROM l”schen' des Treibers auf. 'PARAMETER' beinhaltet die zu zum gew„hlten Eprom geh”renden Pa- rameter. Kommandozeile : ERASE 'PARAMETER' Returnwerte : 0 = ok <0 = Fehler beim EEPROM l”schen IDENTITŽT --------- Ist der Eprommer in der Lage, die Identit„t des im Sockel be- findlichen Eprom festzustellen und unterttzt der Treiber diese Funktion, so bietet dieser Funktionsaufruf die M”glichkeit, daž æ-STic sich darauf einstellt. Kommandozeile : ID Returnwerte : >0 = Epromnummer <0 = Fehler beim Feststellen der ID Die Parameter werden im Normalfall via Kommandozeile bergeben. šberschreitet die zu bergebende Kommandozeile eine L„nge von 125 Byte, so wird das ARGV-Verfahren zur šbergabe verwendet. Weitere Anforderungen an den Treiber: - keinerlei Ausgaben auf dem Bildschirm - Bedienung der Schnittstelle zum Eprommer - als Returnwert wird ein WORD erwartet Die Datei 'EPROMMER.DAT' hat z.B. folgenden Aufbau: * * Ausschnitt aus der 'EPROMMER.DAT' fr den RS-EPROMMER * RS-EPROMMER,256 * #NUMMER,2,2,0 #NAME,7,6,0 #MODUS,21,4,0 #VPP,32,5,0 #EEPROM,44,4,0 #KBYTE,51,2,0 #PIN,56,2,0 #eprom,16,2,1 #eprom_mode,28,1,1 #eprom_vpp,40,1,1 * 01 | 2816 | 6 | fast | 1 | 21.00 | 2 | nein | 2 | 10 02 | 2816 | 6 | slow | 2 | 21.00 | 2 | nein | 2 | 10 . . Diese Demodatei wrde einen externer Treiber unter dem Namen 'RS-EPROMMER' in æ-STic einbinden. Der Treiber ben”tigt maximal 256 KByte freien Speicher. Die Anzeige in 'Epromauswahl', die Werte fr die Infozeile und auch die Parameter fr den Treiber ist durch definierte, aber auch frei definierbare KEYWORDS bestimmt. KEYWORD mssen vor den eigentlichen Datens„tzen und beschreiben, wie das Programm die Datens„tze interpretieren soll,welche Daten zur Anzeige bei 'Epromauswahl' verwendet werden und welche als Parameter an das Trieberprogramm bergeben werden. Die KEYWORD-Zeilen sind wie folgt aufgebaut: #NAME,7,5,0 | | | | | | | | | '---> 0=nur Epromauswahl / 1=nur Parameter / 2=beides | | | '-----> L„nge des Parameters | | '-------> Startposition des Parameters im Datensatz | '----------> Name des KEYWORDS '-------------> Kennzeichen fr KEYWORD 'EPROMAUSWAHL' und die Parameterbergabe an den externen Trieber wird entsprechend der Beschreibung durch die KEYWORDS aufgebaut. Beim Aufbau der Kommandozeile wird jeder Parameter durch SPACE getrennt , so daž eine Auswertung durch den Treiber einfach sein sollte. Die Reihenfolge ist durch die Reihenfolge der KEYWORDS bestimmt. Bei mehr als 125 Zeichen werden die Parameter und der Dateiname mit ARGV bergeben. Ein Leertestaufruf mit den Werten von Eprom 2 aus der Demodatei h„tte z.B. folgendes Format: 'TEST 6 2 2' Folgende Keywords sind æ-STic bekannt und werden, wenn sie als 'EPROMAUSWAHL'- Keywords gekennzeichnet sind, ggf. genutzt. 'NAME' = Klartextname des Eproms 'KBYTE' = Epromgr”že in KByte (KByte) 'MODUS' = Wie soll da Eprom programmiert werden? (Werte <> 0 werden als ms interpretiert, ansonsten Text, z.B. 'fast', 'slow') 'VPP' = Programmierspannung des Eproms (Volt) 'PIN' = Referenz zu den PIN-Bild-Nummern in æ-STic 'EEPROM' = Kennzeichnung von EEPROMS (0 oder 'nein' = ist keins / 1 oder 'ja'=ist eins) 'KBYTE' und 'NAME' mssen fr die 'EPROMAUSWAHL' vorhanden sein. Existiert eine Zeile (nicht Kommentar) vor den KEWORDS,so werden die maximal ersten 16 Zeichen als Prommername von æ-STic inter- pretiert. Eine durch Komma getrennte Angabe des von Treiber be- n”tigten Speicherplatzes wird von æ-STic zur Entscheidung ber die Notwendigkeit zur Auslagerung des Pufferbereichs auf Disket- te und Festplatte vor dem Starten des externen Treibers genutzt. Muž ausgelagert werden, so sucht æ-STic nach einer Envirement- variable 'TMP', 'TEMP' oder 'TEMPDIR' und benutzt den darin be- schriebenen Pfad bei gengend freiem Speicherpalatz zu Auslagern des Puffers. Andernfalls wird der Pfad von æ-STic genommen. Die Speicherverbrauchsangabe ist, wie die Angabe der gesamten Zeile, optional. Folgende Einschr„nkungen sind bei 'EPROMMER.DAT' zu beachten: - maximal 128 Zeilen - maximal 9 Epromgruppen (nach KBYTE-Werten) - maximal 12 Eproms/Gruppe - maximal 32768 Zeichen pro Zeile - maximal 32768 Zeichen als šbergabeparameter - maximal 70 Zeichen zur Ausgabe bei 'EPROMAUSWAHL' 'EPROMMER.DAT' darf Kommentarzeilen beinhalten. Sie sind durch ein vorangestelltes '*' zu kennzeichnen. Da jeder Eintrag 'getrimmt' wird, k”nnen Spaces zur šbersicht- lichkeit der Tabelle eingesetzt werden. EPROMTABELLE ------------ Die folgende Tabelle spart bei der Erstellung von eigenen Treiber (EPROMMER.DAT) unter Umst„nden eine Menge an Tipparbeit. * * Datei mit fast allen Eproms und deren Standardwerten * #NUMMER,2,2,0 #NAME,11,8,0 #VPP,22,5,0 #EEPROM,30,4,0 #KBYTE,39,3,0 #PIN,48,2,0 * *000000001111111111222222222233333333334444444444 *234567890123456789012345678901234567890123456789 * *NUMMER | NAME | VPP | EEPROM | KBYTE | PIN *------------------------------------------------ 00 | 2716 | 25.00 | nein | 2 | 1 01 | 2816 | 21.00 | ja | 2 | 10 02 | 52B13 | ----- | ja | 2 | 10 03 | 2817A | ----- | ja | 2 | 11 04 | 27C16 | 12.50 | nein | 2 | 1 05 | 27C16 | 25.00 | nein | 2 | 1 * 06 | 2732 | 25.00 | nein | 4 | 2 07 | 2732A | 21.00 | nein | 4 | 2 08 | 2532 | 25.00 | nein | 4 | 12 09 | 27C32 | 12.50 | nein | 4 | 2 10 | 2532 | 21.00 | nein | 4 | 2 11 | 38C32 | ----- | ja | 4 | 13 * 12 | 2764 | 21.00 | nein | 8 | 3 13 | 2864A | ----- | ja | 8 | 14 14 | 2865A | ----- | ja | 8 | 14 15 | 52B33 | ----- | ja | 8 | 15 16 | 2564 | 25.00 | nein | 8 | 16 17 | 27C64 | 12.50 | nein | 8 | 3 * 18 | 27128 | 21.00 | nein | 16 | 4 19 | 27C128 | 12.50 | nein | 16 | 4 20 | 27CP128Q | 12.50 | nein | 16 | 17 * 21 | 27256 | 21.00 | nein | 32 | 5 22 | 27C256 | 12.50 | nein | 32 | 5 23 | 28C256 | ----- | ja | 32 | 18 * 24 | 27C512 | 12.50 | nein | 64 | 6 25 | 27513 | 12.50 | nein | 64 | 19 26 | 27C512 | 12.50 | nein | 64 | 6 * 27 | 27C101 | 12.50 | nein | 128 | 7 28 | 27C301 | 12.50 | nein | 128 | 21 29 | 27C1001 | 12.50 | nein | 128 | 7 30 | 27C1000 | 12.50 | nein | 128 | 21 31 | 27010 | 12.75 | nein | 128 | 7 32 | 27011 | 12.50 | nein | 128 | 20 * 33 | 27C2001 | 12.50 | nein | 256 | 8 * 34 | 27C4001 | 12.50 | nein | 512 | 9