Zugriff auf die Modul-EEPROMs

Transkript

1 MAX-P- und P-Bibliotheken EEPROM-Zugriff 1 Zugriff auf die Modul-EEPROMs Jedes X-Bus-Modul verfügt über ein EEPROM, in dem modulspezifische Daten gespeichert werden. Neben einigen Bereichen, die vom Betriebssystem oder den Modul-Device-Treibern genutzt werden, steht ein großer Bereich für Anwenderdaten zur Verfügung. Dieser ist jedoch nicht werksseitig angelegt sondern muss zunächst mit max_create_eeprom_area angelegt werden. Bevor mit den folgenden en Zugriffe auf ein EEPROM erfolgen, muss zunächst mit max_open_eeprom der Zugriff initialisiert werden. max_get_eeprom_info Information über EEPROM FUNTION max_get_eeprom_info (card : WORD; : WORD; : WORD; VAR info : MAX_EEPINFO_TYPE) : MAX_ERROR; MAX_ERROR max_get_eeprom_info (USHORT card, USHORT, USHORT, MAX_EEPINFO_TYPE *info); Mit dieser können Angaben über das EEPROM abgefragt werden. info Zeiger auf eine Datenstruktur, in die die Informationen eingetragen werden. MAX_EEPINFO_TYPE hat folgenden Aufbau (alle Elemente sind vom Typ ULONG): Element ulversion ullength Bedeutung Version der EEPROM-Inhaltsdefinition Größe des EEPROMs in Bytes ulorg Organisation des EEPROMs (0=Byte, 1=Wort, 2=Doppelwort). Dieser Eintrag entscheidet darüber, wie bei den übrigen EEPROM-en die Parameter size und offset interpretiert werden.

2 MAX-P- und P-Bibliotheken EEPROM-Zugriff 2 ulbuffersize Größe des EEPROM-Schreibpuffers ulflags z.z. ist nur MAX_EEP_AUTO_IN definiert, welches bedeutet, dass das EEPROM mit Auto-Inkrement der Adressen arbeitet ulspeed max. Geschwindigkeit, mit der auf das serielle EEPROM zugegriffen wird max_open_eeprom Öffnen des EEPROMs FUNTION max_open_eeprom (card : WORD; : WORD; : WORD; flags : WORD) : MAX_ERROR; MAX_ERROR max_open_eeprom (USHORT card, USHORT, USHORT, USHORT flags); Mit dieser wird ein EEPROM-Zugriff initialisiert. flags reserviert, =0 setzen. max_close_eeprom Schließen des EEPROMs FUNTION max_close_eeprom (card : WORD; : WORD; : WORD; flags : WORD) : MAX_ERROR; MAX_ERROR max_close_eeprom (USHORT card, USHORT, USHORT, USHORT flags); Mit dieser wird ein EEPROM-Zugriff beendet.

3 MAX-P- und P-Bibliotheken EEPROM-Zugriff 3 flags reserviert, =0 setzen. max_get_free_eeprom_block Größter freier Block im EEPROM FUNTION max_get_free_eeprom_block (card : WORD; : WORD; : WORD; VAR length : LONGWORD) : MAX_ERROR; MAX_ERROR max_get_free_eeprom_block (USHORT card, USHORT, USHORT, ULONG *length); Mit dieser kann die Größe des größten zusammenhängenden unbenutzten EEPROM-Bereiches ermittelt werden. length Zeiger auf eine Variable, in die die Größe (in Bytes) des größten freien Blocks eingetragen wird. max_create_eeprom_area Anlegen eines EEPROM-Bereiches FUNTION max_create_eeprom_area (card : WORD; : WORD; : WORD; : WORD; size : WORD; flags : WORD ) : MAX_ERROR; MAX_ERROR max_create_eeprom_area (USHORT card, USHORT, USHORT, USHORT, USHORT size, USHORT flags); Mit dieser wird ein Speicherbereich im EEPROM eines Moduls angelegt. Wenn der gewünschte Bereich bereits angelegt worden ist, liefert die ERR_EEPROM_REGION_EXISTS zurück.

4 MAX-P- und P-Bibliotheken EEPROM-Zugriff 4 size flags Angabe, welcher Bereich angelegt werden soll. Für User- Programme muss dieser Wert = MAX_EEPAREA_ USER_DATA gesetzt werden. Andere Bereiche werden durch Systemprogramme bzw. beim Hersteller eingerichtet. Gewünschte Größe des Bereiches. Da einige Modul- Device-Treiber ebenfalls EEPROM-Speicher benötigen (z.b. für Initialisierungs- oder Korrekturdaten), sollte nicht der gesamte EEPROM-Speicher für Anwender-Daten reserviert werden bevor der MDD nicht seinen Bereich angelegt hat. Flags mit Eigenschaften des Bereiches: MAX_HEK_EEP_HEKSUM: in dem neu angelegten Bereich wird eine hecksumme angelegt, die mit jedem Schreibzugriff aktualisiert wird. Die Schreibzugriffe dauern dadurch länger, dafür ist die Datenkonsistenz des Bereiches gewährleistet. Das Feature ist noch nicht implementiert. MAX_EEP_PASSWORD: Bei Zugriffen auf den Bereich muss ein Passwort angegeben werden, das mit einem abgespeicherten Passwort verglichen wird. Die maximale Länge des Strings beträgt 8 Zeichen plus terminierende 0. Das Feature ist noch nicht implementiert. max_get_eeprom_area_size Größe eines EEPROM-Bereiches FUNTION max_get_eeprom_area_size (card : WORD; : WORD; : WORD; : WORD; VAR size : WORD) : MAX_ERROR; MAX_ERROR max_get_eeprom_area_size (USHORT card, USHORT, USHORT, USHORT, USHORT *size); Dieser liefert die Größe eines im EEPROM angelegten Bereiches.

5 MAX-P- und P-Bibliotheken EEPROM-Zugriff 5 size EEPROM-Bereich Zeiger auf eine Variable, in die die Länge des Bereiches (in Bytes) eingetragen wird max_delete_eeprom_area Löschen eines EEPROM-Bereiches FUNTION max_delete_eeprom_area (card : WORD; : WORD; : WORD; : WORD; onst spass: Phar) : MAX_ERROR; MAX_ERROR max_delete_eeprom_area (USHORT card, USHORT, USHORT, USHORT, char *spass); Mit dieser wird ein Speicherbereich im EEPROM eines Moduls gelöscht. spass Steckplatz des Moduls, auf dessen EEPROM zugegriffen Bereich, der gelöscht werden soll. User-Programme dürfen diesen Parameter nur = MAX_EEPAREA_USER_DATA setzen. Falls der Bereich mit Passwort-Schutz versehen ist, muss hier das Passwort als nullterminierter String übergeben werden. max_read_eeprom_area max_write_eeprom_area Zugriff auf einen EEPROM-Bereich

6 MAX-P- und P-Bibliotheken EEPROM-Zugriff 6 FUNTION max_read_eeprom_area (card : WORD; : WORD; : WORD; : WORD; offset : WORD; size : WORD; VAR data; onst spass: Phar)) : MAX_ERROR; FUNTION max_write_eeprom_area (card : WORD; : WORD; : WORD; : WORD; offset : WORD; size : WORD; VAR data; onst spass: Phar) : MAX_ERROR; MAX_ERROR max_read_eeprom_area (USHORT card, USHORT, USHORT, USHORT, USHORT offset, USHORT size, void *data, char *spass); MAX_ERROR max_write_eeprom_area (USHORT card, USHORT, USHORT, USHORT, USHORT offset, USHORT size, void *data, char *spass); Mit diesen en kann ein Speicherbereich im EEPROM eines Moduls gelesen bzw. beschrieben werden.. offset size data spass Bereich, der gelesen bzw. beschrieben werden soll. User- Programme dürfen zum Schreiben nur MAX_EEPAREA_ USER_DATA angeben. Gelesen werden können durch Angabe von MAX_EEPAREA_MODULNAME (Text mit der Kurzbezeichnung des Moduls) MAX_EEPAREA_ INFOTEXT (kurze Beschreibung des Moduls als Text), MAX_EEPAREA_MANUFATURER (Angaben zum Hersteller) oder MAX_EEPAREA_PROD_ DATA (Produktionsdaten) auch weitere Informationen (soweit sie vorhanden sind). Offset (in Bytes) zum Beginn des Bereiches Größe des zu lesenden oder zu schreibenden Blocks Zeiger auf die Daten Falls der Bereich mit Passwort-Schutz versehen ist, muss hier das Passwort als nullterminierter String übergeben

7 MAX-P- und P-Bibliotheken EEPROM-Zugriff 7 werden (maximale Länge des Strings: 8 Zeichen + terminierende 0). Andernfalls NULL setzen.