Einen Sensor an der Standardadresse auslesen
Was dieses Beispiel zeigt
Das Beispiel singleSensor startet einen Sensor und gibt alle 2,5 Sekunden einen Messwert in ppm aus. Es erzeugt den Sensor nur mit dem Zellen-Preset, daher verwendet die Bibliothek ihre Standardadresse DEFAULT_ADC_ADDR (0x49). Unter dieser Adresse kommuniziert die Bibliothek direkt mit dem ADS1115 und dem LMP91000, nicht über die ATtiny404-Bridge des Boards, und der Header des Sketches verlangt, dass LMPEN mit GND oder einem GPIO verbunden ist. Wie die Adresse darüber entscheidet, steht in der
Bibliotheksübersicht.
Das Beispiel übergibt SENSOR_CO, das Preset der Bibliothek für eine Kohlenmonoxid-Zelle. Für eine Stickstoffmonoxid-Messung verwenden Sie SENSOR_NO, das Preset für die SGX-4NO-250-Zelle dieses Boards: 400 nA pro ppm, eine Verstärkung von 120 kΩ und eine positive Bias-Spannung von 12 %.
Der Beispielcode
Die Auflistung ist die Datei der Bibliothek im angegebenen Commit. Nur Kommentarzeilen wurden weggelassen: die Zeile, die den alten Connector nennt, und die Header-Zeilen, die auf Shopseiten anderer Produkte verlinken.
/**
**************************************************
*
* @file singleSensor.ino
* @brief See how to init one sensor and make a simple reading of PPM of gas.
*
* To successfully run the sketch:
* - 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"
// Configurations for each of the sensor types are in sensorConfigData.h in the library's 'src' folder
// Create the sensor object with the according type
ElectrochemicalGasSensor sensor(SENSOR_CO);
// If you are using a custom I2C address (for multiple sensors) use:
// ElectrochemicalGasSensor sensor(SENSOR_SO2, 0x4B, 5);
// For more details on this, see customAddress.ino
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);
}
Erwartetes Ergebnis mit SENSOR_NO (Messwerte in sauberer Luft; Ihre werden abweichen):
Sensor initialized successfully!
Sensor reading: 0.00632 PPM
Sensor reading: 0.00593 PPM
Sensor reading: 0.00615 PPM
Sensor reading: 0.00582 PPM
Alle 2,5 Sekunden folgt eine Zeile Sensor reading: mit der Konzentration in ppm mit fünf Nachkommastellen und PPM am Ende. Schlägt begin() fehl, gibt der Sketch ERROR: Can't init the sensor! Check connections! aus und bleibt dort stehen.
Verwendete Funktionen
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns ElectrochemicalGasSensorErzeugt das Sensorobjekt für ein Board. Über I2C wird nichts gesendet, bis Sie begin() aufrufen.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
sensorType | _t | Das Zellen-Preset, im Beispiel SENSOR_CO. SENSOR_NO ist das Preset für die Zelle dieses Boards. Die Bibliothek enthält außerdem SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_H2S, SENSOR_NH3 und SENSOR_CL2. |
uint8_t | _adcAddr | Die I2C-Adresse. Im Beispiel weggelassen, daher gilt DEFAULT_ADC_ADDR, 0x49. Bei einer Adresse von 0x30 bis 0x37 kommuniziert die Bibliothek mit der ATtiny404-Bridge des Boards; bei jeder anderen kommuniziert sie mit dem ADS1115 an dieser Adresse und direkt mit dem LMP91000. |
int | _configPin | Der GPIO, der mit LMPEN verbunden ist. Im Beispiel weggelassen (-1), daher schaltet die Bibliothek keinen Pin. |
sensor.begin()returns boolStartet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft die Funktion, ob die Bridge des Boards antwortet, und sendet die ADC- und Front-End-Einstellungen darüber, wobei sie pro Schritt bis zu 500 ms wartet. Bei jeder anderen Adresse startet sie den ADS1115 an dieser Adresse mit der Verstärkung des Presets und der langsamsten Datenrate und konfiguriert dann den LMP91000 (Verstärkung, Last, Referenz, interner Nullpunkt, Bias und Modus). Dabei hält sie den GPIO _configPin auf LOW, sofern einer angegeben ist.
Returnstrue, wenn jeder Schritt erfolgreich war, andernfalls false.
sensor.getPPM()returns doubleFührt eine ADC-Messung durch und rechnet sie um: Sie zieht den internen Nullpunkt ab (2,5 V mal den Prozentwert des internen Nullpunkts des Presets), addiert die Nullpunktkalibrierung, teilt durch die Verstärkung, um den Zellenstrom zu erhalten, und teilt diesen durch die nA pro ppm des Presets.
ReturnsDie Gaskonzentration in ppm. Ein negatives Ergebnis wird als 0 zurückgegeben.
sensor.getPPB()returns doubleDie Alternative, die der Kommentar im Sketch anbietet: Sie führt dieselbe Messung wie getPPM() durch und multipliziert sie mit 1000.
ReturnsDie Gaskonzentration in ppb.
Zusammenspiel
begin() läuft einmal in setup(). Gibt die Funktion false zurück, gibt der Sketch den Fehler aus und bleibt in einer Endlosschleife. In loop() führt jedes getPPM() eine neue Messung durch, und der Sketch gibt sie mit fünf Nachkommastellen aus und wartet dann 2,5 Sekunden.