Software Description MTCS-ME1

Product catalog summary

Introduction
The document details the MTCSApi.dll, an interface for the MTCS-ME1 Evaluation Kit or MTCS-C2 board, requiring a USB 2.0 port and compatible with Windows XP. It highlights the necessity of using correct firmware and DLL versions for optimal performance.

MTCS Functions

MTCSInitSystem: Initializes the system with connection parameters, returning error codes for issues.
MTCSCloseDevice: Closes device connections, with error codes for closure problems.
MTCSDllGetVersion: Retrieves DLL version, requiring a response buffer.
MTCSReadVersion: Fetches firmware version, with error codes for errors.
MTCSReadMemory: Reads EEPROM contents, with error codes for errors.
MTCSWriteMemory: Writes to EEPROM, with error codes for errors.
MTCSSetShift: Adjusts ADC values, with error codes for connection errors.
MTCSSetUpdateMode: Puts firmware in update mode, with error codes for parameter issues.

Functions for MTCS-M1 TOP, FRONT, DARK TIA

MTCSGetADCxx: Measures reflective samples or constant brightness sources.
MTCSGetADCBL: Measures with stray light compensation, providing error codes for issues.
MTCSGetADCAVR: Measures with ADC mean values.

EEPROM and Test Interface
Details on EEPROM and test interface functionalities, including memory operations and testing procedures.

Overview
Technical specifications and procedures for MTCS-C2-DLL and MTCS-ME1-DLL (MTCSApi.dll) software, including functions for reading ADC values, setting parameters, and managing RGB measurements.

1. Function Descriptions

MTCSGetADCAVR: Averages ADC values over measurements, with error codes for issues.
MTCSGetADCBuf: Reads ADC values from a buffer, resetting the red LED, with error codes for issues.
MTCSGetADC: Reads ADC values for various channels.
MTCSSetSwitch: Sets switch for transimpedance amplification, accepting values 0 (off) or 4 (on).
MTCSSetEPoti: Adjusts LED brightness, accepting values from 0x00 to 0xFF.

2. RGB Measurement Functions

MTCSStartRGB: Initiates RGB integration with specified interval time and cycles.
MTCSStopRGB: Stops measurement, reads RGB values and intervals.
MTCSGetRGB: Reads current RGB values and iterations.

3. MTCS-C2 Specific Functions

MTCSGetADCAVR2: Reads amplification and ADC mean values, with amplification settings.
MTCSGetADCSummen: Adds ADC mean values over time, with amplification settings.
MTCSSetParameter: Sets amplification factor and tolerance parameters.
MTCSSearchAmplification: Searches for optimum amplification factor.
MTCSWriteMemToAdr: Writes integrity values to EEPROM, with address and data size constraints.

4. General Notes
Reflects the state of the art at publication, with consistent error codes across functions.

Software Description
MTCS-C2-DLL / MTCS-ME1-DLL (MTCSApi.dll)
MTCSReadMemFromAdr: Reads integrity values from EEPROM, with parameters for device index, buffer pointer, address, and number of values. Returns indicate success or errors.
MTCSGetSerienNummer: Retrieves serial numbers from EEPROM, requiring device index and buffer pointer. Returns indicate success or errors.
EEPROM Structure: Contains system parameters, accessed through specific commands. Mod EVA EEPROM is 1024 bytes, with last 10 bytes reserved. Colorimeter 2 EEPROM is 128 bytes, with top 16 bytes for serial numbers.
Test Interface: "dll_test.dsw" project for Visual Studio 6.0 demonstrates DLL functions, with features like "Abort Loop" and "Clear Window."

Contact Information
Contact MAZeT GmbH in Jena, Germany for further information via phone, fax, or email.