Mehrere Messwerte mitteln
Was dieses Beispiel zeigt
Das Beispiel averagedMeasurement nimmt fünf Messwerte im Abstand von drei Sekunden auf und gibt deren Mittelwert in ppm aus. Ein gemittelter Wert glättet die kleinen Schwankungen zwischen einzelnen Messwerten.
Das Beispiel erstellt den Sensor nur mit dem Zellen-Preset, daher verwendet die Bibliothek
ihre Standardadresse DEFAULT_ADC_ADDR (0x49). Bei 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. Siehe
die Bibliotheksübersicht,
um zu erfahren, wie die Adresse dies bestimmt.
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
Das Listing ist die Datei der Bibliothek beim angegebenen Commit. Nur Kommentarzeilen wurden weggelassen: die, die den alten Connector nennt, und die Header-Zeilen, die auf die Shop-Seiten anderer Produkte verlinken.
/**
**************************************************
*
* @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);
}
Erwartetes Ergebnis mit SENSOR_NO (Messwerte in sauberer Luft; Ihre werden abweichen):
Sensor initialized successfully!
Sensor reading: 0.00584 PPM
Sensor reading: 0.00590 PPM
Sensor reading: 0.00595 PPM
Jede Sensor reading: -Zeile ist ein Mittelwert, mit der
Konzentration in ppm auf fünf Nachkommastellen und PPM am Ende. Jeder Mittelwert umfasst
fünf Messwerte mit 3 Sekunden Pause nach jedem, und der Sketch wartet danach
weitere 2,5 Sekunden, sodass etwa alle 17,5 Sekunden eine neue Zeile erscheint. Schlägt
begin() fehl, gibt der Sketch
ERROR: Can't init the sensor! Check connections! aus und hält dort an.
Verwendete Funktionen
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns ElectrochemicalGasSensorErstellt 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 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 ist sie 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 verdrahtet 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 es, ob die Bridge des Boards antwortet, und sendet die ADC- und Front-End-Einstellungen darüber, wobei es bei jedem Schritt bis zu 500 ms wartet. Bei jeder anderen Adresse startet es 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 es den GPIO _configPin auf Low, sofern einer angegeben ist.
Returnstrue, wenn jeder Schritt erfolgreich war, andernfalls false.
sensor.getAveragedPPM(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns doubleNimmt _numMeasurements Messwerte mit getPPM() auf, wartet nach jedem _secondsDelay Sekunden und gibt deren Mittelwert zurück. Die Funktion blockiert, bis alle Messwerte erfasst sind. Jedes getPPM() nimmt einen ADC-Messwert auf, subtrahiert den internen Nullpunkt (2,5 V mal den prozentualen internen Nullpunkt des Presets), addiert die Nullpunktkalibrierung, teilt durch die Verstärkung des Verstärkers und durch die nA pro ppm des Presets; ein negativer Messwert zählt als 0.
ReturnsDie gemittelte Gaskonzentration in ppm.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | _numMeasurements | Wie viele Messwerte gemittelt werden, im Beispiel NUM_READINGS (5). |
uint8_t | _secondsDelay | Sekunden Wartezeit nach jedem Messwert, im Beispiel SECS_BETWEEN_READINGS (3). |
sensor.getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns doubleDie Alternative, die der Kommentar des Sketches anbietet: derselbe Mittelwert wie bei getAveragedPPM(), multipliziert mit 1000.
ReturnsDie gemittelte Gaskonzentration in ppb.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | _numMeasurements | Wie viele Messwerte gemittelt werden. |
uint8_t | _secondsDelay | Sekunden Wartezeit nach jedem Messwert. |
Zusammenspiel
begin() läuft einmal in setup(). Gibt es false zurück, gibt der Sketch die
Fehlermeldung aus und bleibt in einer Endlosschleife. In loop() blockiert getAveragedPPM(),
während es fünf Messwerte sammelt; danach gibt der Sketch den Mittelwert mit fünf
Nachkommastellen aus und wartet 2,5 Sekunden bis zum nächsten.