Einleitung
Das Dokument beschreibt die MTCSApi.dll als Schnittstelle zwischen der Firmware auf dem Evaluation Kit MTCS-ME1 oder dem Board MTCS-C2 und der Bedienoberfläche. Die Software erfordert eine USB 2.0 Schnittstelle und wurde in C für WindowsXP entwickelt. Die Kommunikation erfolgt über USB oder eine serielle RS232 Schnittstelle.

EEPROM und Testoberfläche
Das Dokument enthält auch Informationen über das EEPROM und die Testoberfläche, die für die Kalibrierung und den Test der Sensoren verwendet werden.

Hauptfunktionen

• MTCSGetADCBuf: Liest den Messwertpuffer aus und gibt ADC-Werte zurück. Rückgabewerte signalisieren Fehler oder Erfolg.
• MTCSGetADC: Führt eine einfache Messung durch und liest ADC-Werte direkt aus.
• MTCSSetSwitch: Setzt den Schalter für die Transimpedanzverstärkung der Trenndiode.
• MTCSSetEPoti: Stellt die Helligkeit der LED-Beleuchtung ein.

RGB-Messfunktionen

• MTCSStartRGB: Startet die RGB-Integration mit festgelegter Intervallzeit und maximalen Integrationszyklen.
• MTCSStopRGB: Stoppt die Messung und liest aktuelle RGB-Werte aus.
• MTCSGetRGB: Liest aktuelle RGB-Werte und die Anzahl der durchlaufenen Iterationen aus.

Verstärkungs- und Summenfunktionen

• MTCSGetADCAVR2: Liest Verstärkung und ADC-Mittelwerte aus.
• MTCSGetADCSummen: Summiert ADC-Mittelwerte über eine bestimmte Zeitspanne.
• MTCSSetParameter: Setzt Verstärkungsfaktor und Toleranz.
• MTCSSearchAmplification: Sucht den optimalen Verstärkungsfaktor für die Messreihe.

Speicherfunktionen

• MTCSWriteMemToAdr: Schreibt Integerwerte in den EEPROM ab einer bestimmten Adresse.
• MTCSReadMemFromAdr: Liest Integerwerte aus dem EEPROM ab einer bestimmten Adresse.

Fehlercodes
Die Funktionen geben verschiedene Fehlercodes zurück, die auf illegale Kommandos, Parameterfehler oder Übertragungsfehler hinweisen.

1. Spezifikationen und Definitionen
Die Dokumentation beschreibt die Funktionen zur Interaktion mit dem EEPROM eines Colorimeters. Die Funktion MTCSReadMemFromAdr liest byteweise Daten aus dem EEPROM ab einer bestimmten Adresse. Die Funktion MTCSGetSerienNummer liest die Seriennummer des Geräts aus.

2. Parameter und Rückgabewerte
Für MTCSReadMemFromAdr sind die Parameter: iIndex (reserviert), cBuf (Puffer für EEPROM-Inhalt), iAdr (Startadresse), iAnz (Anzahl der zu lesenden Werte). Rückgabewerte sind 0 (fehlerfrei), 1 (Parameterfehler), 2 (illegales Kommando), 6 (zu viele Werte), 7 (Übertragungsfehler). Für MTCSGetSerienNummer sind die Parameter: iIndex (reserviert), cBuf (Puffer für Seriennummer). Rückgabewerte sind 0 (fehlerfrei), 2 (illegales Kommando), 7 (Übertragungsfehler).

3. EEPROM-Struktur
Der EEPROM des Mod EVA ist 1024 Byte groß, wobei die letzten 10 Byte reserviert sind. Der EEPROM des Colorimeter 2 ist 128 Byte groß, mit den oberen 16 Byte für die Seriennummer. Systemparameter umfassen Applikationscode, E-Poti, Dark/White Value, Fremdlichtkompensation, Anzahl Mittelwerte, Verstärkungsfaktor und Korrekturmatrizen.

4. Testoberfläche
Das Projekt „dll_test.dsw“ demonstriert die Nutzung der DLL-Funktionen in Microsoft Visual Studio 6.0. Die Initialisierung erfolgt mit MTCSInitSystem(). Parameter werden als Dezimalzahlen interpretiert, VendorID und ProductID als Hex-Zahlen.

5. Kontaktinformationen
Für weitere Informationen steht die MAZeT GmbH zur Verfügung: Göschwitzer Straße 32, 07745 Jena, Tel: +49 3641 2809-0, E-Mail: [email protected].