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
/**
**************************************************
*
* @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:
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 ElectrochemicalGasSensorErzeugt 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
| Typ | Name | Beschreibung |
|---|---|---|
sensorType | _t | Die Einstellungen für Analog-Frontend und Wandlung, im Beispiel SENSOR_CO. Die Voreinstellungen befinden sich in src/sensorConfigData.h der Bibliothek. |
uint8_t | _adcAddr | Die Adresse, DEFAULT_ADC_ADDR (0x49), wenn sie weggelassen wird, wie im Beispiel. |
int | _configPin | Der 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 boolStartet 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 doubleNimmt _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
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | _numMeasurements | Wie viele Messwerte gemittelt werden, im Beispiel NUM_READINGS (5). |
uint8_t | _secondsDelay | Sekunden, die nach jeder Messung gewartet wird, im Beispiel SECS_BETWEEN_READINGS (3). |
sensor.getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns doubleDie auskommentierte Alternative im Beispiel: das Ergebnis von getAveragedPPM(), multipliziert mit 1000.
ReturnsDie gemittelte Konzentration in PPB.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
uint8_t | _numMeasurements | Wie viele Messwerte gemittelt werden. |
uint8_t | _secondsDelay | Sekunden, 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.