Funktionen der Library MyMCP3421

MyMCP3421 MyMCP3421

MyMCP3421 MyMCP3421(byte i2cAdd)

Funktion: Erzeugt eine neue Instanz

Parameter: i2cAdd: I2C-Adresse des MCP3421

Bemerkung: Ohne Angabe der I2C-Adresse wird die Default-Adresse 0x68 verwendet.

Beispiel:

MyMCP3421 ADS; //I2C-Adresse ist 0x68

MyMCP3421 ADS(0x69);


bool isReady(void)

Funktion: Überprüft, ob der MCP3421 über die I2C-Schnittstelle ansprechbar ist

Parameter: keine

Rückgabe: TRUE, wenn Sensor ansprechbar ist, sonst FALSE

Bemerkung: Die Funktion prüft nur, ob in einem I2C-Bus der Bauteil ansprechbar bzw. vorhanden ist. Es wird vorausgesetzt, dass der I2C-Bus technisch prinzipiell funktioniert (keine offenen Busleitungen, Pullup-Widerstände richtig, kein Kurzschluss oder Masseschluss, etc.).


void init(void)

Funktion: Initialisierung des MCP3421

Parameter: keine

Rückgabe: keine

Bemerkung: Mit der Funktion werden die Einstellungen für Modus, Datenrate und Verstärkung auf die Defaultwerte zurückgesetzt


void setMode(byte mode)

Funktion: Setzen des Betriebsmodus: Kontinuierliche Messung oder Einzelmessung

Parameter: mode: MCP3421_MODE_CONTINUOUS
                            MCP3421_MODE_SINGLESHOT  (Default-Einstellung)

Rückgabe: keine

Bemerkung: Wird der Modus auf kontinuierliche Messung gestellt, so startet der ADC sofort mit den Messungen. Im Modus Einzelmessung wird die erste Messung erst mit dem Aufruf der Funktion startSingleMeas() gestartet.


void setGain(byte gain)

Funktion: Setzen der Verstärkung des PGA

Parameter: gain: MCP3421_PGA_2P048 (Default-Einstellung)
                          MCP3421_PGA_1P024
                          MCP3421_PGA_0P512
                          MCP3421_PGA_0P256

Rückgabe: keine


byte getMode(void)

Funktion: Abfrage des Betriebsmodus

Parameter: keine

Rückgabe: Byte-Zahl 0 bis 1:

                 0 -> Einzelmesseung (Single-Shot-Mode - Default-Einstellung)

                 1 -> Kontinuierliche Messung (Continuous Mode)


byte getGain(void)

Funktion: Abfrage der Verstärkung

Parameter: keine

Rückgabe: Byte-Zahl 0 bis 3:

                 0 -> ±2,048 V

                 1 -> ±1,024 V

                 2 -> ±0,512 V

                 3 -> ±0,256 V


void startSingleMeas(void)

Funktion: Starten einer Einzelmessung

Parameter: keine

Rückgabe: keine

Bemerkung: Beim erstmaligen Aufruf der Funktion wird - sofern nicht bereits ausgeführt - der Modus in den Single-Shot Modus gesetzt


bool conversionReady(void)

Funktion: Abfrage, ob Umwandlug beendet ist

Parameter: keine

Rückgabe: TRUE, wenn die Umwandlung beendet ist, sonst FALSE

Bemerkung: Nur im Modus Single-Shot einsetzen!


int readConversion(void)

Funktion: Lesen des Messwertes als 18 Bit-Zahl

Parameter: keine

Rückgabe: Vorzeichenbehaftete 18-Bit-Zahl (-131072 >= Zahl >= 131071)


float readVoltage(void)

Funktion: Lesen des Messwertes als Spannungswert

Parameter: keine

Rückgabe: Float-Zahl entsprechend der gemessenen Spannung in Millivolt


void printConfigReg(void)

Funktion: Ausgabe des Inhalts des Configregisters des MCP3421 am Seriellen Monitor

Parameter: keine

Rückgabe: keine

Bemerkung: Nur für Kontrollzwecke! Funktion nicht für Attiny vorgesehen!


Zur Library ADC MCP3421