Einen Sensor auslesen
Was dieses Beispiel zeigt
Das Beispiel singleSensor erstellt einen Sensor mit dem Preset SENSOR_CO, dem Preset der Library für die SGX-4CO-Zelle dieses Boards, und gibt alle 2,5 Sekunden die Kohlenmonoxidkonzentration in ppm aus. Adresse und Config-Pin bleiben auf den Standardwerten des Konstruktors.
Was es auf diesem Board braucht
Die Standardadresse des Konstruktors ist 0x49. Bei einer Adresse außerhalb von 0x30 bis 0x37 läuft die Library nicht über die Bridge des Boards: begin() startet den ADS1115 unter dieser Adresse und schreibt die Konfiguration des LMP91000 selbst, über den I2C des Controllers. Auf diesem Board sitzen diese beiden Chips am internen Bus, den die obere Stiftleiste als SDA2 und SCL2 herausführt. Die Qwiic-Connectors und SDA1/SCL1 erreichen nur die ATtiny404-Bridge, und ein I2C-Scan über Qwiic findet nur die Bridge, im Auslieferungszustand unter 0x30. Das Beispiel übergibt keinen Config-Pin, und LMPEN ist auf dem Board mit GND verbunden; siehe
Hardware-Details.
Verdrahten Sie für dieses Beispiel also die obere Stiftleiste, nicht das Qwiic-Kabel: Verbinden Sie SDA Ihres Controllers mit SDA2, SCL mit SCL2, den 3,3-V-Pin mit 3V3 und GND mit GND. Über Qwiic antwortet nur die Bridge.
Die Adresse der Bridge, 0x30 bis 0x37, ist die, die das Beispiel CO-Konzentration auslesen übergibt.
Der Beispielcode
/**
**************************************************
*
* @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);
}
Die folgenden Zeilen stammen aus einem Lauf dieses Beispiels auf diesem Board, wobei der Controller wie oben beschrieben an die Pins SDA2, SCL2, 3V3 und GND der Stiftleiste angeschlossen war.
Erwartetes Ergebnis im Serial Monitor bei 115200 Baud:
Sensor initialized successfully!
Sensor reading: 0.32536 PPM
Sensor reading: 0.31509 PPM
Sensor reading: 0.32570 PPM
Sensor reading: 0.29218 PPM
Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration in ppm mit fünf Nachkommastellen und PPM. Ein Ergebnis unter null wird als 0.00000 ausgegeben.
Schlägt begin() fehl, gibt der Sketch
ERROR: Can't init the sensor! Check connections! aus und hält an.
Verwendete Funktionen
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns noneErstellt das Sensorobjekt. Das Beispiel übergibt SENSOR_CO und lässt Adresse und Config-Pin auf ihren Standardwerten.
ReturnsKonstruktor.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
_t | sensorType | Das Preset der Zelle. Für die SGX-4CO-Zelle dieses Boards verwenden Sie SENSOR_CO (70 nA/ppm, ADC-Bereich 4,096 V, 14 kΩ Verstärkung, 20 % interner Nullpunkt). |
_adcAddr | uint8_t | Die I2C-Adresse. Standard ist DEFAULT_ADC_ADDR, 0x49. Von 0x30 bis 0x37 kommuniziert die Library mit der ATtiny404-Bridge des Boards. |
_configPin | int | Ein GPIO, den die Library während des Sendens der Konfiguration des Front-Ends auf Low und sonst auf High setzt. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. Standard ist -1, also keiner. |
bool begin()returns boolStartet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft es, ob die Bridge antwortet, und sendet ihr die ADC-Verstärkung und die Datenrate aus dem Preset sowie die Konfiguration des Front-Ends, wobei es für jede Antwort bis zu 500 ms wartet. Bei jeder anderen Adresse startet es den ADC unter dieser Adresse, stellt dessen Verstärkung und seine langsamste Datenrate ein und schreibt dann die Konfiguration des Front-Ends.
Returnstrue, wenn jeder Schritt erfolgreich war, sonst false.
double getPPM()returns doubleFührt eine ADC-Wandlung der Ausgangsspannung des Front-Ends durch, zieht den internen Nullpunkt ab (20 % der 2,5-V-Referenz bei SENSOR_CO), addiert die Nullpunktkalibrierung und rechnet den Zellenstrom mit der Empfindlichkeit des Presets in ppm um.
ReturnsDie Gaskonzentration in ppm. Ein negatives Ergebnis wird als 0 zurückgegeben.
double getPPB()returns doubleDieselbe Messung wie getPPM(), in Parts per Billion. Das Beispiel zeigt sie als auskommentierte Alternative.
ReturnsgetPPM() multipliziert mit 1000.
Zusammengesetzt
Erstellen Sie das Objekt mit SENSOR_CO, rufen Sie begin() einmal in setup() auf und prüfen Sie das Ergebnis. Rufen Sie danach getPPM() (oder getPPB()) auf, wann immer Sie einen Messwert möchten.