Funktionen der Library MyADS1115
MyADS1115 MyADS1115
MyADS1115 MyADS1115(byte i2cAdd)
Funktion: Erzeugt eine neue Instanz
Parameter: i2cAdd: I2C-Adresse des ADS1115
Bemerkung: Ohne Angabe der I2C-Adresse wird die Default-Adresse 0x48 verwendet.
Beispiel:
MyADS1115 ADS; //I2C-Adresse ist 0x48
MyADS1115 ADS(0x49);
bool isReady(void)
Funktion: Überprüft, ob der ADS1115 ü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 ADS1115
Parameter: keine
Rückgabe: keine
Bemerkung: Mit der Funktion werden die Einstellungen für Modus, Datenrate, Eingangsmultiplexer und Verstärkung auf die Defaultwerte zurückgesetzt
void setMode(byte mode)
Funktion: Setzen des Betriebsmodus: Kontinuierliche Messung oder Einzelmessung
Parameter: mode: ADS1115_MODE_CONTINUOUS
ADS1115_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 setRate(byte rate)
Funktion: Setzen der Datenrate in Samples Per Second (8 SPS bis 860 SPS)
Parameter: rate: ADS1115_RATE_8
ADS1115_RATE_16
ADS1115_RATE_32
ADS1115_RATE_64
ADS1115_RATE_128 (Default-Einstellung)
ADS1115_RATE_250
ADS1115_RATE_475
ADS1115_RATE_860
Rückgabe: keine
void setMux(byte mux)
Funktion: Setzen des Eingang-Multiplexers
Parameter: mux: ADS1115_MUX_AIN0_AIN1 (Default-Einstellung)
ADS1115_MUX_AIN0_AIN3
ADS1115_MUX_AIN1_AIN3
ADS1115_MUX_AIN2_AIN3
ADS1115_MUX_AIN0_GND
ADS1115_MUX_AIN1_GND
ADS1115_MUX_AIN2_GND
ADS1115_MUX_AIN3_GND
Rückgabe: keine
void setGain(byte gain)
Funktion: Setzen der Verstärkung des PGA
Parameter: gain: ADS1115_PGA_6P144
ADS1115_PGA_4P096
ADS1115_PGA_2P048 (Default-Einstellung)
ADS1115_PGA_1P024
ADS1115_PGA_0P512
ADS1115_PGA_0P256
Rückgabe: keine
byte getMode(void)
Funktion: Abfrage des Betriebsmodus
Parameter: keine
Rückgabe: Byte-Zahl 0 bis 1:
0 -> Kontinuierliche Messung (Continuous Mode)
1 -> Einzelmesseung (Single-Shot-Mode)
byte getRate(void)
Funktion: Abfrage der Datenrate
Parameter: keine
Rückgabe: Byte-Zahl 0 bis 7:
0 -> 8 SPS
1 -> 16 SPS
2 -> 32 SPS
3 -> 64 SPS
4 -> 128 SPS
5 -> 250 PS
6 -> 475 SPS
7 -> 860 SPS
byte getMux(void)
Funktion: Abfrage des Eingangs-Multiplexers
Parameter: keine
Rückgabe: Byte-Zahl 0 bis 7:
0 -> A0 - A1
1 -> A0 - A3
2 -> A1 - A3
3 -> A2 - A3
4 -> A0 - GND
5 -> A1 - GND
6 -> A2 - GND
7 -> A3 - GND
byte getGain(void)
Funktion: Abfrage der Verstärkung
Parameter: keine
Rückgabe: Byte-Zahl 0 bis 5:
0 -> ±6,144 V
1 -> ±4,096 V
2 -> ±2,048 V
3 -> ±1,024 V
4 -> ±0,512 V
5 -> ±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 16 Bit-Zahl
Parameter: keine
Rückgabe: Vorzeichenbehaftete 16-Bit-Zahl (-32768 >= Zahl >= 32767)
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 ADS1115 am Seriellen Monitor
Parameter: keine
Rückgabe: keine
Bemerkung: Nur für Kontrollzwecke! Funktion nicht für Attiny vorgesehen!