Kalibracija nulte točke
Što ovaj primjer prikazuje
Primjer calibrateSensor dodaje svakom očitanju fiksni naponski pomak,
customCalibration (0.05), a zatim ispisuje očitanja u PPM svakih 2,5 sekunde.
Senzor stvara s konfiguracijom SENSOR_NH3,
adresom 0x49 i pinom 32 za LMPEN.
Na ovoj pločici ne trebate spajati LMPEN, što god pisalo u komentarima skice:
pločica ga sama drži na niskoj razini.
Komentar u samom primjeru kaže kako se koristi pomak: kada nema nimalo ciljanog
plina, prilagođavajte customCalibration dok očitanje nakon kalibracije ne bude
otprilike 0.
Da biste vidjeli napone iza svakog očitanja, maknite komentar s retka
//#define ELECTROCHEMICAL_SENSOR_DEBUG u datoteci
Electrochemical-Gas-Sensor-SOLDERED.h iz biblioteke. getPPM() tada ispisuje i sirovi
napon, napon bez referentne vrijednosti i napon nakon kalibracije.
Kôd primjera
/**
**************************************************
*
* @file calibrateSensor.ino
* @brief See how to calibrate an electrochemical sensor
*
* To successfully run the sketch:
* - Uncomment the #define in the library header file
* - 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"
// This is the custom value we set for the calibration voltage
// This value is added to the voltage read from the ADC
// In an environment with 0 of the target gas, the voltage after calibration should be
// roughly 0, adjust customCalibration to get it to that value.
const double customCalibration = 0.05;
// Create the sensor object with the according type
ElectrochemicalGasSensor sensor(SENSOR_NH3, 0x49, 32);
void setup()
{
Serial.begin(115200); // For debugging
// Initialize 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);
}
//Set the custom calibration value
sensor.setCustomZeroCalibration(customCalibration);
Serial.println("Sensor initialized successfully!");
}
void loop()
{
// Make the reading
double reading = sensor.getPPM();
// This function will also print debug messages if the #define in
// the header file of the library is uncommented
// It will print:
// - The raw voltage measurement
// - Voltage without reference value
// - Voltage after calibration
// These values can help you adjust the internal zero calibration
// 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);
}
Što ova pločica ispisuje s skicom u izvornom obliku, još nije izmjereno.
Kada je ova pločica testirana preko Qwiic konektora, I2C skeniranje pronašlo je samo jednu adresu,
0x30, a s MicroPython bibliotekom begin() nije uspio za senzor stvoren na
0x49, adresi koju ova skica prosljeđuje. Ako begin() ne uspije, skica
ispisuje ERROR: Can't init the sensor! Check connections! i zaustavlja se.
Kada begin() uspije, skica ispisuje:
Sensor initialized successfully!
Nakon toga svake 2,5 sekunde stiže redak Sensor reading: iza kojeg slijedi vrijednost s pet decimala i
PPM.
Korištene funkcije
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns ElectrochemicalGasSensorStvara objekt senzora s konfiguracijom senzora, adresom i pinom LMPEN. Ništa se ne šalje dok ne pozovete begin(). begin() prema adresi bira kako komunicirati s pločicom: od 0x30 do 0x37 koristi naredbe ATtiny404 mosta i ignorira treći argument; svaka druga adresa uzima se kao vlastita adresa ADS1115, a LMP91000 se programira izravno.
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
sensorType | _t | Postavke ulaznog stupnja i konverzije, u primjeru SENSOR_NH3. Predlošci se nalaze u datoteci src/sensorConfigData.h iz biblioteke. |
uint8_t | _adcAddr | Adresa, u primjeru 0x49. |
int | _configPin | GPIO pin spojen na LMPEN, u primjeru 32. Ne koristi se za adresu od 0x30 do 0x37. |
sensor.begin()returns boolPokreće I2C pomoću Wire.begin(). Za adresu od 0x30 do 0x37 provjerava odgovara li most, šalje mu pojačanje ADC-a i najsporiju brzinu podataka ADC-a, zatim postavke LMP91000; svaka naredba mosta čeka do 500 ms. Za svaku drugu adresu pokreće ADS1115 na toj adresi s istim pojačanjem i brzinom podataka, postavlja pin LMPEN u visoko stanje ako je zadan, zatim zapisuje postavke LMP91000, pri čemu taj pin drži u niskom stanju.
Returnstrue ako su svi koraci uspjeli, inače false.
sensor.setCustomZeroCalibration(double calibration)returns voidPostavlja pomak nulte točke, u voltima, koji getPPM() dodaje izmjerenom naponu. Zamjenjuje internalZeroCalibration u kopiji konfiguracije unutar objekta senzora.
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
double | calibration | Pomak u voltima, u primjeru customCalibration (0.05). |
sensor.getPPM()returns doubleIzvodi jedno očitanje ADC-a i pretvara napon u koncentraciju: oduzima unutarnju nulu (dio referentnih 2,5 V), dodaje pomak nulte točke, dijeli s TIA pojačanjem kako bi dobio struju ćelije, a zatim dijeli s nanoamperima po PPM iz konfiguracije. Negativan rezultat vraća se kao 0. Ako je definiran ELECTROCHEMICAL_SENSOR_DEBUG, ispisuje i tri napona.
ReturnsKoncentracija u PPM.
Sve zajedno
SENSOR_NH3 je predložak za amonijačnu ćeliju SGX-4NH3-300. Biblioteka za
oksigensku ćeliju SGX-4OX-ROHS ove pločice još nema predložak, pa se vrijednost koju primjer ispisuje
izračunava s postavkama predloška za amonijak (NH3). Stranica
prilagođena konfiguracija
pokazuje kako napisati vlastitu; njezino polje internalZeroCalibration postavlja
isti pomak pri stvaranju konfiguracije.