Prilagođena konfiguracija
Što ovaj primjer prikazuje
Primjer customConfig iz biblioteke gradi vlastiti sensorType preset: osjetljivost ćelije, nulti pomak, raspon ADC-a i postavke LMP91000 (pojačanje, opteretni otpornik, referenca, interna nula, bias, način rada). begin() šalje te postavke na pločicu.
Vrijednosti u primjeru odnose se na drugu ćeliju, a ne na SO2 ćeliju ove pločice: koristi 100 nA/ppm i BIAS_SIGN_NEGATIVE, dok SO2 ćelija traži 400 nA/ppm i BIAS_SIGN_POSITIVE. Zamijenite ih vrijednostima SENSOR_SO2 navedenima u nastavku prije nego što ga upotrijebite za SO2. Ako ostanu kakve jesu, samo osjetljivost pomiče svaku vrijednost u ppm za faktor četiri. Vlastiti preset SENSOR_SO2 u biblioteci koristi 400 nA/ppm, ADS_GAIN_4_096V, TIA_GAIN_120_KOHM, RLOAD_10_OHM, REF_EXTERNAL, INTERNAL_ZERO_20_PERCENT, BIAS_SIGN_POSITIVE, BIAS_0_PERCENT, FET_SHORT_DISABLED i OP_MODE_3LEAD_AMP_CELL, s nultom kalibracijom 0.
Na ovoj pločici LMP91000 i ADS1115 nalaze se na vlastitoj sabirnici 2 pločice, a vaš kontroler pristupa im preko adrese pločice na Qwiic sabirnici: 0x30 kako se isporučuje, od 0x30 do 0x37 pomoću prekidača ADDRESS. Primjer ne predaje nikakvu adresu, pa koristi zadanu adresu biblioteke, 0x49, koja komunicira izravno s ADS1115. Adresu pločice predajte kao drugi argument konstruktora, na primjer ElectrochemicalGasSensor sensor(SENSOR_CUSTOM, 0x30);. Tamo gdje header kaže da LMPEN treba spojiti na bilo koji GPIO pin, na ovoj je pločici LMPEN već povučen na GND otpornikom od 10 kΩ te vodi i do mikrokontrolera na pločici, a na adresama pločice biblioteka zanemaruje argument pina za omogućavanje (pogledajte Detalji o hardveru).
Popis je datoteka biblioteke na zakucanom commitu, osim nekoliko redaka samo s komentarima u njezinu zaglavlju, koji konektor nazivaju starijim imenom ili vode na druge Soldered proizvode, pa su izostavljeni.
Kôd 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);
}
Očekivani rezultat:
Sensor initialized successfully!
Zatim skica ispisuje Sensor reading: svakih 2,5 sekunde, s vrijednošću u ppm u retku ispod.
Korištene funkcije
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns noneStvara objekt senzora iz preseta, ovdje iz vlastitog SENSOR_CUSTOM skice, adrese i neobveznog pina za omogućavanje. Primjer predaje samo preset, pa je adresa zadana, 0x49.
ReturnsKonstruktor.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
_t | sensorType | Preset: osjetljivost u nA/ppm, nulta kalibracija u voltima, pojačanje ADC-a, zatim postavke LMP91000 redoslijedom kojim ih skica navodi. |
_adcAddr | uint8_t | Adresa s kojom biblioteka komunicira. Od 0x30 do 0x37 je raspon bridgea, postavlja se prekidačem ADDRESS na pločici; svaka druga vrijednost komunicira izravno s ADS1115 na toj adresi. Zadano 0x49. |
_configPin | int | GPIO za liniju omogućavanja ulaznog stupnja. Zanemaruje se na adresama od 0x30 do 0x37. Zadano -1. |
bool begin()returns boolPokreće I2C, provjerava odgovara li pločica te šalje na pločicu pojačanje ADC-a i vrijednosti registara LMP91000 izgrađene iz preseta.
Returnstrue ako je pločica odgovorila i prihvatila sve postavke, inače false.
double getPPM()returns doubleTraži od pločice jedno ADC očitanje i pretvara ga u koncentraciju plina koristeći pojačanje i osjetljivost iz preseta. Rezultat ispod nule vraća se kao 0.
ReturnsKoncentracija plina u ppm.
Sastavljanje cjeline
Osjetljivost u presetu skalira svaki rezultat, pa pogrešna vrijednost daje pogrešnu vrijednost u ppm čak i kad hardver radi. Pojačanje ulaznog stupnja mora biti jedna od fiksnih vrijednosti TIA_GAIN_* da bi izračun radio: TIA_GAIN_EXTERNAL zahtijeva i setCustomTiaGain().