Prilagođena konfiguracija
Što prikazuje ovaj primjer
Primjer customConfig izrađuje vlastiti sensorType, SENSOR_CUSTOM,
umjesto da koristi unaprijed zadanu postavku, prosljeđuje ga konstruktoru i
svake 2,5 sekunde ispisuje očitanje u PPM. Blok komentara u primjeru navodi
sve postavke i vrijednosti koje svaka od njih prihvaća; to je mjesto na koje
treba upisati postavke vaše ćelije. Senzor se stvara bez adrese, pa konstruktor
koristi zadanu, DEFAULT_ADC_ADDR (0x49).
Na ovoj pločici ne trebate spajati LMPEN, bez obzira na komentare u skici:
pločica ga sama drži na niskoj razini.
Kod primjera
/**
**************************************************
*
* @file customConfig.ino
* @brief Create a custom config for the LMP91000 and upload it to the device.
* This enables you to use this breakout with any electrochemical sensor.
*
* To successfully run the sketch:
* - Edit the custom configuration
* - Connect LMPEN to any GPIO pin
* - Run the sketch and open serial monitor at 115200 baud!
*
*
* @authors Robert @ soldered.com
***************************************************/
// Include the required library
#include "Electrochemical-Gas-Sensor-SOLDERED.h"
/**
* Here are parameters to configure for the custom sensor:
*
* nanoAmperesPerPPM: From the datasheet of the particular electrochemical
* sensor, used in the calculation of PPM/PPB
*
* internalZeroCalibration: A fixed value which is summed to the voltage
* measured by the ADS. The value here should make the reading be
* just barely 0 PPM when the sensor is in a place with none of the target gas
*
* adsGain: The gain of the ADS
* The voltage here represents the max range which it can measure
* ADS_GAIN_6_144V 6.144 V
* ADS_GAIN_4_096V 4.096 V
* ADS_GAIN_2_048V 2.048 V
* ADS_GAIN_1_024V 1.024 V
* ADS_GAIN_0_512V 0.512 V
* ADS_GAIN_0_256V 0.256 V
*
* TIA_GAIN_IN_KOHMS: The gain of the amplifier
* This increases the sensitivity of the measurement
* TIA_GAIN_EXTERNAL External resistance
* TIA_GAIN_2_75_KOHM 2.75 kOhm
* TIA_GAIN_3_5_KOHM 3.5 kOhm
* TIA_GAIN_7_KOHM 7 kOhm
* TIA_GAIN_14_KOHM 14 kOhm
* TIA_GAIN_35_KOHM 35 kOhm
* TIA_GAIN_120_KOHM 120 kOhm
* TIA_GAIN_350_KOHM 350 kOhm
*
* RLOAD: The load resistor in the LMP91000
* Specified in the electrochemical sensor's datasheet
* RLOAD_10_OHM 10 Ohm
* RLOAD_33_OHM 33 Ohm
* RLOAD_50_OHM 50 Ohm
* RLOAD_100_OHM 100 Ohm
*
* REF_SOURCE: Source of the control voltage reference
* For our breakout, use external, there's a 2.5V external
* reference voltage
* REF_INTERNAL Internal
* REF_EXTERNAL External
*
* INTERNAL_ZERO: Internal zero selection
* If the electrochemical sensor has a positive polarity, you
* would usually want to use 20% for the most headroom in the signal
* INTERNAL_ZERO_20_PERCENT 20%
* INTERNAL_ZERO_50_PERCENT 50%
* INTERNAL_ZERO_67_PERCENT 67%
* INTERNAL_ZERO_BYPASSED Internal zero bypassed
*
* BIAS_SIGN: The polarity of the bias voltage
* BIAS_SIGN_NEGATIVE Negative
* BIAS_SIGN_POSITIVE Positive
*
* BIAS: Added bias, percentage of the reference voltage
* Most sensors don't require this, check each sensor's datasheet
* BIAS_0_PERCENT 0%
* BIAS_1_PERCENT 1%
* BIAS_2_PERCENT 2%
* BIAS_4_PERCENT 4%
* BIAS_6_PERCENT 6%
* ...
* BIAS_22_PERCENT 22%
* BIAS_24_PERCENT 24%
*
* FET_SHORT: Short the FET
* Used to perserve the electrochemical sensor
* Has to be disabled for the sensor to be operable
* FET_SHORT_DISABLED Disabled
* FET_SHORT_ENABLED Enabled
*
* OP_MODE: Mode of operation
* OP_MODE_DEEP_SLEEP Deep Sleep (default)
* OP_MODE_2LEAD_GROUND_CELL 2-lead ground referred galvanic cell
* OP_MODE_STANDBY Standby
* OP_MODE_3LEAD_AMP_CELL 3-lead amperometric cell
* OP_MODE_TEMPERATURE_TIA_OFF Temperature measurement (TIA Off)
* OP_MODE_TEMPERATURE_TIA_ON Temperature measurement (TIA On)
*
* For more details, check thge LMP91000 datasheet, chapter 7.6
*/
// Here is an example of a custom configuration:
const sensorType SENSOR_CUSTOM = {
100.0F, // nanoAmperesPerPPM
0, // internalZeroCalibration
ADS_GAIN_4_096V, // adsGain
TIA_GAIN_120_KOHM, // TIA_GAIN_IN_KOHMS
RLOAD_10_OHM, // RLOAD
REF_EXTERNAL, // REF_SOURCE
INTERNAL_ZERO_20_PERCENT, // INTERNAL_ZERO
BIAS_SIGN_NEGATIVE, // BIAS_SIGN
BIAS_0_PERCENT, // BIAS
FET_SHORT_DISABLED, // FET_SHORT
OP_MODE_3LEAD_AMP_CELL, // OP_MODE
};
// Create the sensor object with the custom type
ElectrochemicalGasSensor sensor(SENSOR_CUSTOM);
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 reading
double reading = sensor.getPPM();
// Print the reading with 5 digits of precision
Serial.println("Sensor reading: ");
Serial.print(reading, 5);
Serial.println(" PPM");
// Wait a bit before reading again
delay(2500);
}
Što ova pločica ispisuje s neizmijenjenom skicom još nije izmjereno.
Kad je ova pločica testirana preko Qwiic konektora, I2C pretraživanje pronašlo je samo jednu adresu,
0x30, a s MicroPython bibliotekom begin() nije uspio za senzor stvoren
na adresi 0x49, zadanoj adresi koju koristi ova skica. 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 skica ispisuje redak Sensor reading: , a
zatim u sljedećem retku 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() na temelju adrese odabire način komunikacije s pločicom: od 0x30 do 0x37 koristi naredbe ATtiny404 mosta i zanemaruje treći argument; svaka druga adresa tumači se kao vlastita adresa ADS1115, a LMP91000 se upisuje izravno.
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
sensorType | _t | Konfiguracija koju treba koristiti, u primjeru SENSOR_CUSTOM. |
uint8_t | _adcAddr | Adresa, DEFAULT_ADC_ADDR (0x49) kada se izostavi, kao u primjeru. |
int | _configPin | GPIO pin spojen na LMPEN, -1 (nijedan) kada se izostavi. 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 izgrađene iz sensorType; 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, a zatim upisuje postavke LMP91000, pri čemu taj pin za to vrijeme drži u niskom stanju.
Returnstrue kada su svi koraci uspjeli, inače false.
sensor.getPPM()returns doubleIzvodi jedno očitanje ADC-a i pretvara napon u koncentraciju: oduzima unutarnju nulu (udio referentnog napona od 2,5 V), dodaje internalZeroCalibration, dijeli s TIA pojačanjem da dobije struju ćelije, a zatim dijeli s nanoAmperesPerPPM. Negativan rezultat vraća se kao 0.
ReturnsKoncentracija u PPM.
Sastavljanje cjeline
Vrijednosti u SENSOR_CUSTOM iz ispisa koda vlastiti su
rezervirani primjeri, a ne postavke za kisikovu ćeliju SGX-4OX-ROHS na ovoj pločici. Njegova
vrijednost BIAS_0_PERCENT ne primjenjuje nikakav bias, a ćeliji je on potreban, pa prije
korištenja s ovom pločicom promijenite konfiguraciju:
- Ćeliji je potreban bias od −600 mV. S referentnim naponom pločice od 2,5 V to je
BIAS_SIGN_NEGATIVEsBIAS_24_PERCENT(24 % od 2,5 V je 0,6 V): upišiteBIAS_24_PERCENTumjestoBIAS_0_PERCENTiz ispisa. - Zadržite
REF_EXTERNAL: pločica ima vanjsku referencu od 2,5 V. - Izlaz ćelije na zraku je 0,1 ± 0,03 mA, a izlaz je logaritamski, S = K ln(1/(1-C)), pa ga linearni izračun PPM-a u biblioteci ne pretvara izravno u % vol.
Nakon uključivanja napajanja ćeliji može trebati do 15 minuta da se stabilizira, pa je pustite da radi prije nego što vjerujete očitanju.