Zum Hauptinhalt springen

Gemittelte Messung

Was dieses Beispiel zeigt​

Das Beispiel averagedMeasurement mittelt mehrere Messwerte, bevor es einen davon ausgibt. Es nimmt NUM_READINGS (5) Messungen mit SECS_BETWEEN_READINGS (3) Sekunden Abstand auf, gibt den Mittelwert in PPM aus, wartet dann 2,5 Sekunden und beginnt von vorn. Es erzeugt den Sensor mit der Konfiguration SENSOR_CO und ohne Adresse, daher verwendet der Konstruktor seinen Standardwert DEFAULT_ADC_ADDR (0x49).

Sie müssen LMPEN auf diesem Board nicht verdrahten, was auch immer die Kommentare im Sketch sagen: Das Board hält den Pin selbst auf Low.

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);
}

Was dieses Board mit dem Sketch in der vorliegenden Form ausgibt, wurde noch nicht gemessen. Beim Test dieses Boards über Qwiic fand ein I2C-Scan nur eine Adresse, 0x30, und mit der MicroPython-Bibliothek schlug begin() für einen Sensor fehl, der mit 0x49 erzeugt wurde, dem Standardwert, den dieser Sketch verwendet. Schlägt begin() fehl, gibt der Sketch ERROR: Can't init the sensor! Check connections! aus und hält an.

Wenn begin() erfolgreich ist, gibt der Sketch Folgendes aus:

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

Danach erscheint einmal pro Runde von fünf Messungen eine Zeile Sensor reading: , gefolgt von einem Wert mit fünf Nachkommastellen und PPM.

Verwendete Funktionen​

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

Erzeugt das Sensorobjekt mit einer Sensorkonfiguration, einer Adresse und einem LMPEN-Pin. Es wird nichts gesendet, bis Sie begin() aufrufen. begin() wählt anhand der Adresse, wie mit dem Board kommuniziert wird: Von 0x30 bis 0x37 verwendet es die Befehle der ATtiny404-Bridge und ignoriert das dritte Argument; jede andere Adresse wird als eigene Adresse des ADS1115 aufgefasst, und der LMP91000 wird direkt beschrieben.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
sensorType_tDie Einstellungen für Analog-Frontend und Wandlung, im Beispiel SENSOR_CO. Die Voreinstellungen befinden sich in src/sensorConfigData.h der Bibliothek.
uint8_t_adcAddrDie Adresse, DEFAULT_ADC_ADDR (0x49), wenn sie weggelassen wird, wie im Beispiel.
int_configPinDer GPIO-Pin, der mit LMPEN verbunden ist, -1 (keiner), wenn er weggelassen wird. Wird für eine Adresse von 0x30 bis 0x37 nicht verwendet.
sensor.begin()returns bool

Startet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft es, ob die Bridge antwortet, sendet ihr die ADC-Verstärkung und die langsamste ADC-Datenrate und anschließend die LMP91000-Einstellungen; jeder Bridge-Befehl wartet bis zu 500 ms. Bei jeder anderen Adresse startet es den ADS1115 unter dieser Adresse mit derselben Verstärkung und Datenrate, setzt den LMPEN-Pin auf High, falls einer angegeben wurde, und schreibt dann die LMP91000-Einstellungen, wobei es diesen Pin währenddessen auf Low hält.

Returnstrue, wenn jeder Schritt erfolgreich war, sonst false.

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

Nimmt _numMeasurements getPPM()-Messungen auf, wartet nach jeder _secondsDelay Sekunden und gibt deren Mittelwert zurück. Die Funktion blockiert, bis alle Messungen erfolgt sind. getPPM() gibt bei einem negativen Ergebnis 0 zurück, daher zählt eine solche Messung als 0.

ReturnsDie gemittelte Konzentration in PPM.

Parameter

TypNameBeschreibung
uint8_t_numMeasurementsWie viele Messwerte gemittelt werden, im Beispiel NUM_READINGS (5).
uint8_t_secondsDelaySekunden, die nach jeder Messung gewartet wird, im Beispiel SECS_BETWEEN_READINGS (3).
sensor.getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns double

Die auskommentierte Alternative im Beispiel: das Ergebnis von getAveragedPPM(), multipliziert mit 1000.

ReturnsDie gemittelte Konzentration in PPB.

Parameter

TypNameBeschreibung
uint8_t_numMeasurementsWie viele Messwerte gemittelt werden.
uint8_t_secondsDelaySekunden, die nach jeder Messung gewartet wird.

Zusammenfassung​

SENSOR_CO ist die Voreinstellung für eine SGX-4CO-Kohlenmonoxidzelle. Die Bibliothek hat noch keine Voreinstellung für die Sauerstoffzelle SGX-4OX-ROHS dieses Boards, daher wird der vom Beispiel ausgegebene Wert mit den Einstellungen der CO-Zelle berechnet. Die Seite Benutzerdefinierte Konfiguration zeigt, wie Sie eine eigene schreiben.