Zum Hauptinhalt springen

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.

Select Board
averagedMeasurement.ino
/**
**************************************************
*
* @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):

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
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 ElectrochemicalGasSensor

Erstellt das Sensorobjekt für ein Board. Über I2C wird nichts gesendet, bis Sie begin() aufrufen.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
sensorType_tDas 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_adcAddrDie 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_configPinDer GPIO, der mit LMPEN verdrahtet ist. Im Beispiel weggelassen (-1), daher schaltet die Bibliothek keinen Pin.
sensor.begin()returns bool

Startet 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 double

Nimmt _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

TypNameBeschreibung
uint8_t_numMeasurementsWie viele Messwerte gemittelt werden, im Beispiel NUM_READINGS (5).
uint8_t_secondsDelaySekunden Wartezeit nach jedem Messwert, im Beispiel SECS_BETWEEN_READINGS (3).
sensor.getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns double

Die Alternative, die der Kommentar des Sketches anbietet: derselbe Mittelwert wie bei getAveragedPPM(), multipliziert mit 1000.

ReturnsDie gemittelte Gaskonzentration in ppb.

Parameter

TypNameBeschreibung
uint8_t_numMeasurementsWie viele Messwerte gemittelt werden.
uint8_t_secondsDelaySekunden 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.