Zum Hauptinhalt springen

Mehrere Messwerte mitteln

Was dieses Beispiel zeigt​

Das Beispiel averagedMeasurement der Bibliothek nimmt fünf Messwerte im Abstand von drei Sekunden auf, bildet den Mittelwert und gibt das Ergebnis in ppm aus.

Das Beispiel erstellt den Sensor mit der Voreinstellung für Kohlenmonoxid, SENSOR_CO. SENSOR_NO2 ist die Voreinstellung der Bibliothek für die SGX-4NO2-Zelle dieses Boards; ändern Sie sie in der Zeile, die den Sensor erstellt. NUM_READINGS und SECS_BETWEEN_READINGS am Anfang legen fest, wie viele Messwerte in jeden Mittelwert einfließen und wie viele Sekunden zwischen ihnen gewartet wird.

Der Beispielcode​

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:

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
Sensor initialized successfully!

Danach gibt der Sketch eine Zeile aus, die mit Sensor reading: beginnt, gefolgt von der gemittelten Konzentration in ppm mit fünf Dezimalstellen. Jeder Mittelwert wartet drei Sekunden nach jedem seiner fünf Messwerte, und die Schleife wartet dann weitere 2,5 Sekunden, sodass mindestens alle 17,5 Sekunden eine neue Zeile erscheint. Wenn begin() fehlschlägt, 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 ElectrochemicalGasSensor

Erstellt das Sensorobjekt. Es wird nichts an das Board gesendet, bis Sie begin() aufrufen. Die Adresse bestimmt, wie begin() mit dem Board kommuniziert: Von 0x30 bis 0x37 sendet es seine Befehle an den ATtiny404, und von 0x48 bis 0x4B (DEFAULT_ADC_ADDR ist 0x49) spricht es den ADS1115 unter dieser Adresse und den LMP91000 direkt an.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
sensorType_tDie Voreinstellung der Zelle. SENSOR_NO2 ist die Voreinstellung für die SGX-4NO2-Zelle dieses Boards; das Beispiel übergibt SENSOR_CO.
uint8_t_adcAddrDie Adresse, mit der begin() kommuniziert, standardmäßig 0x49; das Beispiel belässt den Standardwert.
int_configPinGPIO für den Enable-Pin des LMP91000 (LMPEN), nur bei 0x48 bis 0x4B verwendet. Standardmäßig -1 (keiner); das Beispiel übergibt keinen.
sensor.begin()returns bool

Startet Wire und schreibt die Voreinstellung auf das Board. Von 0x30 bis 0x37 prüft es, ob der ATtiny404 antwortet, und sendet ihm dann die ADC-Verstärkung und die Datenrate sowie die Konfiguration des LMP91000, wobei jeder Schritt bis zu 500 ms auf die Antwort wartet. Von 0x48 bis 0x4B startet es den ADS1115 unter dieser Adresse, stellt die Verstärkung der Voreinstellung und die langsamste Datenrate ein und schreibt die Konfiguration des LMP91000; ist _configPin angegeben, zieht es ihn dabei auf Low. Rufen Sie es einmal in setup() auf.

Returnstrue, wenn alle Schritte erfolgreich waren, andernfalls false.

sensor.getAveragedPPM(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns double

Ruft getPPM() _numMeasurements-mal auf, wartet nach jedem Messwert _secondsDelay Sekunden und gibt den Mittelwert zurück. Die Funktion blockiert, bis alle Messwerte aufgenommen sind.

ReturnsDie gemittelte Gaskonzentration in ppm.

Parameter

TypNameBeschreibung
uint8_t_numMeasurementsWie viele Messwerte gemittelt werden. Standardmäßig 5; das Beispiel übergibt NUM_READINGS (5).
uint8_t_secondsDelaySekunden, die nach jedem Messwert gewartet wird. Standardmäßig 2; das Beispiel übergibt SECS_BETWEEN_READINGS (3).
sensor.getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns double

Derselbe Mittelwert wie bei getAveragedPPM(), multipliziert mit 1000. Die Funktion blockiert, bis alle Messwerte aufgenommen sind. Das Beispiel nennt sie in einem Kommentar als die Zeile, die Sie verwenden, wenn ppb für Ihren Sensor besser geeignet ist.

ReturnsDie gemittelte Gaskonzentration in ppb.

Parameter

TypNameBeschreibung
uint8_t_numMeasurementsWie viele Messwerte gemittelt werden. Standardmäßig 5.
uint8_t_secondsDelaySekunden, die nach jedem Messwert gewartet wird. Standardmäßig 2.

Zusammenspiel​

begin() läuft einmal in setup(). Schlägt es fehl, gibt der Sketch den Fehler aus und bleibt in einer Endlosschleife. In loop() nimmt jeder Aufruf von getAveragedPPM() alle fünf Messwerte auf, bevor er zurückkehrt; der Sketch gibt den Mittelwert mit fünf Dezimalstellen aus und wartet 2,5 Sekunden.