Gemittelte Messung
Was dieses Beispiel zeigt
Das Beispiel averagedMeasurement erstellt den Sensor mit dem Preset SENSOR_CO, dem Preset der Bibliothek für die SGX-4CO-Zelle dieses Boards, und gibt den Mittelwert von fünf Messwerten im Abstand von drei Sekunden in ppm aus. NUM_READINGS und
SECS_BETWEEN_READINGS am Anfang legen fest, über wie viele Messwerte gemittelt wird und wie lange zwischen ihnen gewartet wird.
Was dieses Board dafür braucht
Das Beispiel erstellt den Sensor mit der Standardadresse des Konstruktors, 0x49. Bei einer Adresse außerhalb von 0x30 bis 0x37 läuft die Bibliothek nicht über die Bridge des Boards: begin() startet den ADS1115 an dieser Adresse und schreibt die Konfiguration des LMP91000 selbst, über den I2C des Controllers. Auf diesem Board liegen 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 bei 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 averagedMeasurement.ino
* @brief See how to use a built-in function to make an averaged measurement
*
* 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"
// How many readings to average from and how long to wait between them
#define NUM_READINGS 5
#define SECS_BETWEEN_READINGS 3
// 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_CO, 0x4A, 25);
// 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 averaged reading
// This is a blocking function, so it will take a while before code continues
double reading = sensor.getAveragedPPM(NUM_READINGS, SECS_BETWEEN_READINGS);
// If PPB is more relevant for your sensor, you can use:
// double reading = sensor.getAveragedPPB(NUM_READINGS, SECS_BETWEEN_READINGS);
// 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.
Erwartete Ausgabe im Serial Monitor bei 115200 Baud:
Sensor initialized successfully!
Sensor reading: 0.32488 PPM
Sensor reading: 0.29840 PPM
Sensor reading: 0.32744 PPM
Jeder Mittelwert besteht aus fünf Messwerten mit je 3 Sekunden Wartezeit danach, und die Schleife wartet anschließend weitere 2,5 Sekunden, sodass etwa alle 17,5 Sekunden eine neue Zeile erscheint: Sensor reading: , die gemittelte Konzentration in ppm mit fünf Nachkommastellen und PPM. 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 belässt die Adresse und den Config-Pin bei 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 Bibliothek mit der ATtiny404-Bridge des Boards. |
_configPin | int | Ein GPIO, den die Bibliothek auf Low legt, während sie die Konfiguration des Frontends sendet, und sonst auf High. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. Standard ist -1, keiner. |
bool begin()returns boolStartet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft die Funktion, ob die Bridge antwortet, und sendet ihr die ADC-Verstärkung und die Datenrate aus dem Preset sowie die Konfiguration des Frontends, wobei sie auf jede Antwort bis zu 500 ms wartet. Bei jeder anderen Adresse startet sie den ADC an dieser Adresse, stellt dessen Verstärkung und seine langsamste Datenrate ein und schreibt dann die Konfiguration des Frontends.
Returnstrue, wenn jeder Schritt erfolgreich war, sonst false.
double getAveragedPPM(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns doubleAddiert _numMeasurements Ergebnisse von getPPM(), wartet nach jedem _secondsDelay Sekunden und teilt durch _numMeasurements. Die Funktion blockiert, bis alle Messwerte vorliegen.
ReturnsDie gemittelte Konzentration in ppm.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
_numMeasurements | uint8_t | Über wie viele Messwerte gemittelt wird. Standard ist 5. |
_secondsDelay | uint8_t | Sekunden Wartezeit nach jedem Messwert. Standard ist 2. |
double getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns doubleDerselbe Mittelwert in Parts per Billion. Das Beispiel zeigt ihn als auskommentierte Alternative.
ReturnsgetAveragedPPM() mit denselben Argumenten, multipliziert mit 1000.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
_numMeasurements | uint8_t | Über wie viele Messwerte gemittelt wird. Standard ist 5. |
_secondsDelay | uint8_t | Sekunden Wartezeit nach jedem Messwert. Standard ist 2. |
Zusammenfügen
Erstellen Sie das Objekt mit SENSOR_CO, rufen Sie begin() einmal in setup() auf und prüfen Sie das Ergebnis, rufen Sie dann in Ihrer Schleife getAveragedPPM() oder getAveragedPPB() auf.
Jeder Aufruf dauert _numMeasurements mal _secondsDelay Sekunden.