Benutzerdefinierte Adresse
Was dieses Beispiel zeigt
Das Beispiel customAddress erstellt den Sensor mit einer frei gewählten Adresse statt der Standardadresse, startet ihn und gibt alle 2,5 Sekunden einen Messwert in PPM aus. Es übergibt die Konfiguration SENSOR_SO2, die Adresse 0x4B und den Pin 5 für LMPEN.
Der Kommentar des Beispiels nennt für seine Adressen die Jumper JP5 bis JP7. Auf diesem Board sind die Adress-Jumper des ADS1115 JP2 bis JP4, und JP5 und JP6 verbinden die I2C-Pull-ups; siehe
Hardware-Details.
Die eigene Adresse des Boards, von 0x30 bis 0x37, wird mit dem dreistufigen ADDRESS-Schalter auf der Oberseite eingestellt, nicht mit Jumpern auf der Rückseite, wie es die Kommentare des Sketches angeben.
Sie müssen LMPEN auf diesem Board nicht verdrahten, was auch immer die Kommentare des Sketches sagen: Das Board hält den Pin selbst auf Low.
Der Beispielcode
/**
**************************************************
*
* @file customAddress.ino
* @brief See how to init a sensor on a custom address
*
* To successfully run the sketch:
* - Set the custom address using the jumpers on the back of the board
* - Connect LMPEN pin to GND or a GPIO pin so the breakout can be configured
* - Run the sketch and open serial monitor at 115200 baud!
*
*
* @authors Robert @ soldered.com
***************************************************/
// Include the required library
#include "Electrochemical-Gas-Sensor-SOLDERED.h"
// Create the sensor object with the according type
// To set a custom address, connect one of the following jumpers:
// JP5 for 0x49
// JP6 for 0x4A
// JP7 for 0x4B
// The final parameter is the GPIO pin for LMPEN
ElectrochemicalGasSensor sensor(SENSOR_SO2, 0x4B, 5);
void setup()
{
Serial.begin(115200); // For debugging
// Init the breakout
if (!sensor.begin())
{
// Can't init? Notify the user and go to infinite loop
Serial.println("ERROR: Can't init the sensor! Check connections!");
while (true)
delay(100);
}
Serial.println("Sensor initialized successfully!");
}
void loop()
{
// Make the reading
double reading = sensor.getPPM();
// If PPB is more relevant for your sensor, you can use:
// double reading = sensor.getPPB();
// Print the reading with 5 digits of precision
Serial.print("Sensor reading: ");
Serial.print(reading, 5);
Serial.println(" PPM");
// Wait a bit before reading again
delay(2500);
}
Was dieses Board mit dem Sketch in der vorliegenden Form ausgibt, wurde noch nicht gemessen.
Beim Test dieses Boards über Qwiic fand ein I2C-Scan nur eine Adresse, 0x30; unter 0x4B, der Adresse, die dieser Sketch übergibt, antwortete also nichts. Schlägt begin() fehl, gibt der Sketch
ERROR: Can't init the sensor! Check connections! aus und hält an.
Wenn begin() erfolgreich ist, gibt der Sketch Folgendes aus:
Sensor initialized successfully!
Danach erscheint alle 2,5 Sekunden eine Zeile Sensor reading: gefolgt von einem Wert mit fünf Nachkommastellen und
PPM.
Verwendete Funktionen
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns ElectrochemicalGasSensorErstellt das Sensorobjekt mit einer Sensorkonfiguration, einer Adresse und einem LMPEN-Pin. Es wird nichts gesendet, bis Sie begin() aufrufen. begin() wählt anhand der Adresse, wie mit dem Board kommuniziert wird: Bei einer Adresse von 0x30 bis 0x37 verwendet es die Befehle der ATtiny404-Bridge und ignoriert das dritte Argument; jede andere Adresse wird als eigene Adresse des ADS1115 aufgefasst, und der LMP91000 wird direkt beschrieben.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
sensorType | _t | Die Einstellungen für Analog-Frontend und Wandlung, im Beispiel SENSOR_SO2. Die Voreinstellungen stehen in der Datei src/sensorConfigData.h der Bibliothek. |
uint8_t | _adcAddr | Die Adresse, im Beispiel 0x4B. |
int | _configPin | Der GPIO-Pin, der mit LMPEN verbunden ist, im Beispiel 5. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. |
sensor.begin()returns boolStartet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft es, ob die Bridge antwortet, sendet ihr die ADC-Verstärkung und die langsamste ADC-Datenrate und anschließend die Einstellungen des LMP91000; jeder Bridge-Befehl wartet bis zu 500 ms. Bei jeder anderen Adresse startet es den ADS1115 unter dieser Adresse mit derselben Verstärkung und Datenrate, setzt den LMPEN-Pin auf High, sofern einer angegeben wurde, und schreibt dann die Einstellungen des LMP91000, wobei es diesen Pin währenddessen auf Low hält.
Returnstrue, wenn jeder Schritt erfolgreich war, andernfalls false.
sensor.getPPM()returns doubleFührt eine ADC-Messung durch und wandelt die Spannung in eine Konzentration um: Es subtrahiert den internen Nullpunkt (ein Anteil der 2,5-V-Referenz), addiert die Nullpunktkalibrierung der Konfiguration, teilt durch die TIA-Verstärkung, um den Zellenstrom zu erhalten, und teilt dann durch die Nanoampere pro PPM der Konfiguration. Ein negatives Ergebnis wird als 0 zurückgegeben.
ReturnsDie Konzentration in PPM.
sensor.getPPB()returns doubleDie im Beispiel auskommentierte Alternative: derselbe Messwert wie bei getPPM(), multipliziert mit 1000.
ReturnsDie Konzentration in PPB.
Zusammenfassung
SENSOR_SO2 ist die Voreinstellung für eine Schwefeldioxid-Zelle SGX-4SO2. Die Bibliothek hat noch keine Voreinstellung für die Sauerstoffzelle SGX-4OX-ROHS dieses Boards, daher wird der vom Beispiel ausgegebene Wert mit den Einstellungen der Schwefeldioxid-Voreinstellung (SO2) berechnet. Die Seite
Benutzerdefinierte Konfiguration
zeigt, wie Sie eine eigene schreiben.