Zum Hauptinhalt springen

Gemittelte Messung

Was dieses Beispiel zeigt​

Das Beispiel averagedMeasurement der Bibliothek nimmt fünf Messwerte im Abstand von drei Sekunden auf und gibt deren Mittelwert in ppm aus. Die Mittelung glättet das Rauschen in einem kleinen Signal.

Das Beispiel erstellt den Sensor mit dem Zellen-Preset für CO, SENSOR_CO. SENSOR_SO2 ist das Preset der Bibliothek für die Zelle SGX-4SO2 auf diesem Board: Ändern Sie SENSOR_CO in der Zeile, die sensor erstellt, in SENSOR_SO2, um SO2-Werte zu erhalten.

Auf diesem Board sitzen der LMP91000 und der ADS1115 am eigenen Bus 2 des Boards, und Ihr Controller erreicht sie über die Adresse des Boards am Qwiic-Bus: 0x30 im Auslieferungszustand, 0x30 bis 0x37 mit dem Schalter ADDRESS. Das Beispiel übergibt keine Adresse und verwendet daher die Standardadresse der Bibliothek, 0x49, die direkt einen ADS1115 anspricht. Übergeben Sie die Adresse des Boards als zweites Argument des Konstruktors, zum Beispiel ElectrochemicalGasSensor sensor(SENSOR_SO2, 0x30);. Wo im Header steht, dass LMPEN mit GND oder einem GPIO-Pin verbunden werden soll: Auf diesem Board ist LMPEN bereits über einen 10-kΩ-Widerstand auf GND gezogen und führt außerdem zum Mikrocontroller auf dem Board. Bei den Adressen des Boards ignoriert die Bibliothek das Argument für den Enable-Pin (siehe Hardware-Details).

Das Listing ist die Datei der Bibliothek im festgelegten Commit, abgesehen von einigen reinen Kommentarzeilen in ihrem Header, die den Connector mit einem älteren Namen bezeichnen oder auf andere Soldered-Produkte verweisen und weggelassen wurden.

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 erscheint für jeden Satz von fünf Messwerten eine Zeile Sensor reading: mit der gemittelten Konzentration in ppm. Jeder Satz dauert 15 Sekunden (fünf Messungen mit je 3 Sekunden Wartezeit danach), und der Sketch wartet weitere 2,5 Sekunden bis zum nächsten Satz.

Verwendete Funktionen​

ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns none

Erstellt das Sensorobjekt aus einem Zellen-Preset, einer Adresse und einem optionalen Enable-Pin. Das Beispiel übergibt nur das Preset, daher ist die Adresse die Standardadresse 0x49.

ReturnsKonstruktor.

Parameter

ParameterTypBeschreibung
_tsensorTypeDas Zellen-Preset. SENSOR_SO2 ist das Preset für die Zelle dieses Boards.
_adcAddruint8_tDie Adresse, mit der die Bibliothek kommuniziert. 0x30 bis 0x37 ist der Bridge-Bereich, der über den Schalter ADDRESS des Boards eingestellt wird; jeder andere Wert spricht direkt einen ADS1115 unter dieser Adresse an. Standard 0x49.
_configPinintGPIO für die Enable-Leitung des Front-Ends. Wird bei den Adressen 0x30 bis 0x37 ignoriert. Standard -1.
bool begin()returns bool

Startet I2C, prüft, ob das Board antwortet, und sendet die ADC- und LMP91000-Einstellungen aus dem Preset an das Board.

Returnstrue, wenn das Board geantwortet und alle Einstellungen übernommen hat, sonst false.

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

Nimmt mehrere getPPM()-Messwerte auf und gibt deren Mittelwert zurück. Es wartet nach jeder Messung die angegebene Anzahl von Sekunden und blockiert, bis es fertig ist.

ReturnsDie gemittelte Gaskonzentration in ppm.

Parameter

ParameterTypBeschreibung
_numMeasurementsuint8_tWie viele Messwerte gemittelt werden. Standard 5.
_secondsDelayuint8_tSekunden, die nach jeder Messung gewartet wird. Standard 2.
double getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns double

Derselbe Mittelwert wie bei getAveragedPPM(), in Parts per Billion. Das Beispiel zeigt ihn als Alternative in einem Kommentar.

ReturnsDie gemittelte Gaskonzentration in ppb.

Parameter

ParameterTypBeschreibung
_numMeasurementsuint8_tWie viele Messwerte gemittelt werden. Standard 5.
_secondsDelayuint8_tSekunden, die nach jeder Messung gewartet wird. Standard 2.

Zusammenfügen​

Ändern Sie NUM_READINGS und SECS_BETWEEN_READINGS, um Reaktionsgeschwindigkeit gegen einen stabileren Wert einzutauschen. Der Aufruf blockiert für NUM_READINGS x SECS_BETWEEN_READINGS Sekunden, sodass in dieser Zeit nichts anderes in loop() läuft.