Skip to main content

Usrednjavanje nekoliko očitanja

Što prikazuje ovaj primjer​

Primjer averagedMeasurement uzima pet očitanja u razmaku od tri sekunde i ispisuje njihov prosjek u ppm. Jedna usrednjena vrijednost izglađuje male promjene između pojedinačnih očitanja.

Primjer stvara senzor samo s predloškom ćelije, pa biblioteka koristi zadanu adresu, DEFAULT_ADC_ADDR (0x49). Na toj adresi biblioteka komunicira izravno s ADS1115 i LMP91000, a ne preko ATtiny404 mosta na pločici, a zaglavlje skice traži da je LMPEN spojen na GND ili na GPIO. Pogledajte pregled biblioteke da vidite kako adresa to određuje.

Primjer koristi SENSOR_CO, predložak biblioteke za ćeliju ugljikova monoksida. Za očitanje dušikova oksida koristite SENSOR_NO, predložak za ćeliju SGX-4NO-250 na ovoj pločici: 400 nA po ppm, pojačanje pojačala od 120 kΩ i pozitivan prednapon od 12 %.

Kôd primjera​

Popis je datoteka biblioteke u zakucanoj inačici (commit). Izostavljeni su samo retci s komentarima: onaj koji spominje stari konektor i retci zaglavlja koji povezuju trgovačke stranice drugih proizvoda.

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

Očekivani rezultat sa SENSOR_NO (očitanja u čistom zraku; vaša će se razlikovati):

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
Sensor initialized successfully!
Sensor reading: 0.00584 PPM
Sensor reading: 0.00590 PPM
Sensor reading: 0.00595 PPM

Svaki redak Sensor reading: jedan je prosjek, s koncentracijom u ppm na pet decimala i PPM na kraju. Svaki prosjek uzima pet očitanja s pauzom od 3 sekunde nakon svakog, a skica zatim čeka još 2,5 sekunde, pa se novi redak pojavljuje otprilike svakih 17,5 sekundi. Ako begin() ne uspije, skica ispisuje ERROR: Can't init the sensor! Check connections! i tu staje.

Korištene funkcije​

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

Stvara objekt senzora za jednu pločicu. Ništa se ne šalje preko I2C dok ne pozovete begin().

ReturnsObjekt senzora.

Parametri

TipNazivOpis
sensorType_tPredložak ćelije, u primjeru SENSOR_CO. SENSOR_NO je onaj za ćeliju na ovoj pločici. Biblioteka ima i SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_H2S, SENSOR_NH3 i SENSOR_CL2.
uint8_t_adcAddrI2C adresa. U primjeru je izostavljena, pa iznosi DEFAULT_ADC_ADDR, 0x49. Za adresu od 0x30 do 0x37 biblioteka komunicira s ATtiny404 mostom na pločici; za svaku drugu komunicira s ADS1115 na toj adresi i izravno s LMP91000.
int_configPinGPIO spojen na LMPEN. U primjeru je izostavljen (-1), pa biblioteka ne mijenja stanje nijednog pina.
sensor.begin()returns bool

Pokreće I2C pomoću Wire.begin(). Za adresu od 0x30 do 0x37 provjerava odgovara li most na pločici te preko njega šalje postavke ADC-a i ulaznog stupnja, čekajući do 500 ms za svaki korak. Za svaku drugu adresu pokreće ADS1115 na toj adresi s pojačanjem predloška i najsporijom brzinom podataka, zatim konfigurira LMP91000 (pojačanje, opterećenje, referencu, unutarnju nulu, prednapon i način rada), pritom držeći GPIO _configPin u niskom stanju ako je zadan.

Returnstrue kada su svi koraci uspjeli, inače false.

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

Uzima _numMeasurements očitanja pomoću getPPM(), čekajući _secondsDelay sekundi nakon svakog, i vraća njihov prosjek. Blokira dok se sva očitanja ne završe. Svaki getPPM() uzima jedno očitanje ADC-a, oduzima unutarnju nulu (2,5 V puta postotak unutarnje nule predloška), dodaje kalibraciju nule, dijeli s pojačanjem pojačala i s nA po ppm predloška; negativno očitanje računa se kao 0.

ReturnsUsrednjena koncentracija plina u ppm.

Parametri

TipNazivOpis
uint8_t_numMeasurementsKoliko očitanja treba usrednjiti, u primjeru NUM_READINGS (5).
uint8_t_secondsDelaySekunde čekanja nakon svakog očitanja, u primjeru SECS_BETWEEN_READINGS (3).
sensor.getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns double

Alternativa koju nudi komentar u skici: isti prosjek kao getAveragedPPM(), pomnožen s 1000.

ReturnsUsrednjena koncentracija plina u ppb.

Parametri

TipNazivOpis
uint8_t_numMeasurementsKoliko očitanja treba usrednjiti.
uint8_t_secondsDelaySekunde čekanja nakon svakog očitanja.

Sastavljanje cjeline​

begin() se izvršava jednom u setup(). Ako vrati false, skica ispisuje pogrešku i ostaje u beskonačnoj petlji. U loop() funkcija getAveragedPPM() blokira dok prikuplja pet očitanja, zatim skica ispisuje prosjek s pet decimala i čeka 2,5 sekunde prije sljedećeg.