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!