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.
/**
**************************************************
*
* @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):
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 ElectrochemicalGasSensorStvara objekt senzora za jednu pločicu. Ništa se ne šalje preko I2C dok ne pozovete begin().
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
sensorType | _t | Predlož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 | _adcAddr | I2C 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 | _configPin | GPIO spojen na LMPEN. U primjeru je izostavljen (-1), pa biblioteka ne mijenja stanje nijednog pina. |
sensor.begin()returns boolPokreć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 doubleUzima _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
| Tip | Naziv | Opis |
|---|---|---|
uint8_t | _numMeasurements | Koliko očitanja treba usrednjiti, u primjeru NUM_READINGS (5). |
uint8_t | _secondsDelay | Sekunde čekanja nakon svakog očitanja, u primjeru SECS_BETWEEN_READINGS (3). |
sensor.getAveragedPPB(uint8_t _numMeasurements = 5, uint8_t _secondsDelay = 2)returns doubleAlternativa koju nudi komentar u skici: isti prosjek kao getAveragedPPM(), pomnožen s 1000.
ReturnsUsrednjena koncentracija plina u ppb.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint8_t | _numMeasurements | Koliko očitanja treba usrednjiti. |
uint8_t | _secondsDelay | Sekunde č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.