Zum Hauptinhalt springen

Mehrere Messwerte mitteln

Was dieses Beispiel zeigt​

Das Beispiel averagedMeasurement erzeugt einen Sensor mit der Voreinstellung für Kohlenmonoxid, SENSOR_CO, und gibt den Mittelwert aus fünf Messwerten in Parts per Million (PPM) aus, die im Abstand von 3 Sekunden erfasst werden.

Verbinden Sie Ihren Controller für dieses Beispiel mit dem oberen Header und nicht mit einem Qwiic-Connector: SDA des Controllers mit SDA2, SCL mit SCL2, die 3,3-V-Versorgung mit 3V3 und Masse mit GND. Bei dieser Adresse kommuniziert die Bibliothek direkt über SDA2 und SCL2 mit dem ADS1115 und dem LMP91000; die ATtiny404-Bridge des Boards bei 0x30 wird nicht verwendet. Über Qwiic funktioniert nur das Bridge-Beispiel in der Kurzanleitung .

Der Beispielcode​

NUM_READINGS legt fest, wie viele Messwerte in jeden Mittelwert einfließen, und SECS_BETWEEN_READINGS, wie viele Sekunden die Bibliothek nach jedem Messwert wartet. Ändern Sie SENSOR_CO auf die Voreinstellung für Ihre Zelle. Der Sketch erzeugt den Sensor nur mit der Voreinstellung, daher wird die Standardadresse der Bibliothek, 0x49, verwendet.

Der Kommentar im Sketch besagt, dass LMPEN mit GND oder einem GPIO verbunden werden soll. Auf diesem Board führt LMPEN zum Header und zum ATtiny404 des Boards.

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

🔗Vollständiges Beispiel öffnen

examples/averagedMeasurement im Commit c4df54b

→

Öffnen Sie den Serial Monitor mit 115200 Baud. Der Sketch gibt aus:

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

Danach folgt pro Mittelwert eine Zeile Sensor reading: mit fünf Nachkommastellen und PPM. Jeder Mittelwert umfasst fünf Messwerte mit je 3 Sekunden Wartezeit danach, also etwa 15 Sekunden, und der Sketch pausiert 2,5 Sekunden vor dem nächsten. Schlägt begin() fehl, 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 none

Erzeugt das Sensorobjekt für ein Board. Die Adresse bestimmt, wie begin() mit ihm kommuniziert: Bei einer Adresse von 0x30 bis 0x37 verwendet es das Protokoll der ATtiny404-Bridge; bei jeder anderen Adresse kommuniziert es mit einem ADS1115 an dieser Adresse und selbst mit dem LMP91000. Standard ist DEFAULT_ADC_ADDR (0x49).

ReturnsKonstruktor.

Parameter

NameTypBeschreibung
_tsensorTypeDie Voreinstellung für Ihre Zelle: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 oder Ihr eigener sensorType.
_adcAddruint8_tDie Adresse, die begin() verwendet. 0x30 bis 0x37 wählt das Bridge-Protokoll; dieses Board antwortet werkseitig bei 0x30 oder bei der Adresse, die sein Schalter einstellt. Jeder andere Wert wird als ADS1115-Adresse interpretiert. Standardmäßig 0x49.
_configPinintEin GPIO für die Enable-Leitung des LMP91000. Die Bibliothek hält sie auf High und zieht sie nur dann auf Low, während sie selbst die Register des LMP91000 beschreibt; bei einer Adresse von 0x30 bis 0x37 wird sie nicht verwendet. Standardmäßig -1 (keiner).
bool begin()returns bool

Startet I2C mit Wire.begin() und wählt das Protokoll anhand der Adresse. Bei 0x30 bis 0x37 prüft es, ob die Bridge antwortet, sendet die ADC-Verstärkung aus der Voreinstellung und lässt die Bridge die Register des LMP91000 beschreiben, wobei jeder Schritt nach 500 ms aufgegeben wird. Bei jeder anderen Adresse prüft es, ob ein ADS1115 an dieser Adresse antwortet, stellt dessen Verstärkung ein und beschreibt die Register des LMP91000, sobald der LMP91000 Bereitschaft meldet; ist _configPin angegeben, wird er um die Schreibvorgänge herum auf Low gezogen. Rufen Sie es einmal vor dem Lesen auf.

Returnstrue, wenn jeder Schritt erfolgreich war, sonst false.

double 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 sie fertig ist.

ReturnsDie gemittelte Gaskonzentration in PPM.

Parameter

NameTypBeschreibung
_numMeasurementsuint8_tWie viele Messwerte gemittelt werden. Standardmäßig 5.
_secondsDelayuint8_tSekunden Wartezeit nach jedem Messwert. Standardmäßig 2.
double getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns double

Derselbe Mittelwert in Parts per Billion. Das Beispiel zeigt ihn als auskommentierte Alternative.

ReturnsDie gemittelte Gaskonzentration in PPB, getAveragedPPM() x 1000.

Parameter

NameTypBeschreibung
_numMeasurementsuint8_tWie viele Messwerte gemittelt werden. Standardmäßig 5.
_secondsDelayuint8_tSekunden Wartezeit nach jedem Messwert. Standardmäßig 2.

Alles zusammenfügen​

Erzeugen Sie den Sensor mit der Voreinstellung für Ihre Zelle und rufen Sie begin() einmal auf. Rufen Sie danach getAveragedPPM() oder getAveragedPPB() mit der Anzahl der Messwerte und der Wartezeit dazwischen auf. Jeder Aufruf blockiert etwa _numMeasurements x _secondsDelay Sekunden lang, sodass Ihr Sketch in der Zwischenzeit nichts anderes tut.