Prilagođena konfiguracija
Što prikazuje ovaj primjer
Primjer electrochemical-customConfig.py iz biblioteke izrađuje vlastiti SensorConfig: osjetljivost ćelije, nulti pomak, raspon ADC-a i postavke čipa LMP91000 (pojačanje, otpornik opterećenja, referenca, interna nula, prednapon, način rada). Funkcija begin() šalje te postavke na pločicu. Skripta stvara I2C sabirnicu na GPIO 22 (SCL) i GPIO 21 (SDA).
Predložak modula SENSOR_SO2 koristi nano_amperes_per_ppm=400.0, internal_zero_calibration=0, 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. Vrijednosti u primjeru odnose se na drugu ćeliju, stoga uvezite potrebna imena i za SO2 ćeliju krenite od ovih vrijednosti.
Na ovoj pločici LMP91000 i ADS1115 nalaze se na vlastitoj sabirnici 2 pločice, a vaš kontroler im pristupa preko adrese pločice na Qwiic sabirnici: 0x30 u isporučenom stanju, od 0x30 do 0x37 pomoću prekidača ADDRESS. Primjer ne prosljeđuje adc_addr, pa koristi zadanu adresu modula, 0x49, koja komunicira izravno s čipom ADS1115. Adresu pločice proslijedite kao adc_addr, na primjer sensor = ElectrochemicalGasSensor(SENSOR_CUSTOM, i2c, adc_addr=0x30). Gdje shema povezivanja kaže da LMPEN ide na GPIO pin, na ovoj je pločici LMPEN već spojen na GND preko otpornika od 10 kΩ te vodi i do mikrokontrolera na pločici, a na adresama pločice modul ne koristi config_pin (pogledajte Detalji o hardveru).
Ispis je datoteka iz biblioteke na zapisanom commitu, osim dvaju redaka koji sadrže samo komentare, a povezuju na drugi Soldered proizvod ili u shemi povezivanja imenuju kontrolersku pločicu; oni su izostavljeni.
Kod primjera
# FILE: electrochemical-customConfig.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Custom LMP91000 configuration example for any electrochemical sensor.
# LAST UPDATED: 2026-05-21
# Connecting diagram:
#
# Qwiic------------------------>Qwiic
# LMPEN------------------------>GPIO pin (see config_pin parameter below)
from machine import I2C, Pin
import time
from ElectrochemicalGasSensor import (
ElectrochemicalGasSensor, SensorConfig,
TIA_GAIN_35_KOHM, RLOAD_10_OHM, REF_EXTERNAL,
INTERNAL_ZERO_67_PERCENT, BIAS_SIGN_NEGATIVE, BIAS_0_PERCENT,
FET_SHORT_DISABLED, OP_MODE_3LEAD_AMP_CELL,
)
from ads1115 import ADS_GAIN_2_048V
# Custom sensor configuration — edit these values to match your sensor's datasheet.
#
# nanoAmperesPerPPM: Sensitivity from the sensor datasheet (nA/PPM)
# internalZeroCalibration: Voltage offset added to zero the reading in clean air
# adsGain: ADS1115 full-scale range (ADS_GAIN_6_144V .. ADS_GAIN_0_256V)
# tia_gain: TIA feedback resistor (TIA_GAIN_2_75_KOHM .. TIA_GAIN_350_KOHM)
# rload: Load resistor (RLOAD_10_OHM .. RLOAD_100_OHM)
# ref_source: Reference voltage source (REF_INTERNAL / REF_EXTERNAL)
# internal_zero: Internal zero percentage (INTERNAL_ZERO_20/50/67_PERCENT or _BYPASSED)
# bias_sign: Bias polarity (BIAS_SIGN_NEGATIVE / BIAS_SIGN_POSITIVE)
# bias: Bias percentage of Vref (BIAS_0_PERCENT .. BIAS_24_PERCENT)
# fet_short: FET short (FET_SHORT_DISABLED / FET_SHORT_ENABLED)
# op_mode: Operating mode (OP_MODE_3LEAD_AMP_CELL for normal operation)
SENSOR_CUSTOM = SensorConfig(
nano_amperes_per_ppm=-1000.0,
internal_zero_calibration=-0.0012,
ads_gain=ADS_GAIN_2_048V,
tia_gain=TIA_GAIN_35_KOHM,
rload=RLOAD_10_OHM,
ref_source=REF_EXTERNAL,
internal_zero=INTERNAL_ZERO_67_PERCENT,
bias_sign=BIAS_SIGN_NEGATIVE,
bias=BIAS_0_PERCENT,
fet_short=FET_SHORT_DISABLED,
op_mode=OP_MODE_3LEAD_AMP_CELL,
)
# Initialize I2C
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
sensor = ElectrochemicalGasSensor(SENSOR_CUSTOM, i2c)
# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Custom Config Example")
if not sensor.begin():
print("ERROR: Can't init the sensor! Check connections!")
while True:
time.sleep_ms(100)
print("Sensor initialized successfully!")
# -------------------------------------------------------------------------
# Main loop
# -------------------------------------------------------------------------
while True:
reading = sensor.getPPB()
print("Sensor reading: {:.5f} PPB".format(reading))
time.sleep_ms(2500)
🔗Otvorite cijeli primjer
electrochemical-customConfig.py na zapisanom commitu
Očekivani rezultat:
Electrochemical Gas Sensor - Custom Config Example
Sensor initialized successfully!
Zatim se svake 2,5 sekunde ispisuje redak Sensor reading: u ppb.
Korištene funkcije
SensorConfig(nano_amperes_per_ppm, internal_zero_calibration, ads_gain, tia_gain, rload, ref_source, internal_zero, bias_sign, bias, fet_short, op_mode)returns SensorConfigSadrži postavke za jednu elektrokemijsku ćeliju. Predlošci modula, poput SENSOR_SO2, također su objekti SensorConfig.
ReturnsObjekt konfiguracije.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
nano_amperes_per_ppm | float | Osjetljivost ćelije u nA po ppm, iz njezina tehničkog lista. |
internal_zero_calibration | float | Naponski pomak dodan radi postavljanja nule očitanja u čistom zraku. |
ads_gain | int | Puni raspon ADC-a, od ADS_GAIN_6_144V do ADS_GAIN_0_256V (iz ads1115). |
tia_gain | int | Otpornik pojačanja ulaznog stupnja, od TIA_GAIN_2_75_KOHM do TIA_GAIN_350_KOHM, ili TIA_GAIN_EXTERNAL. |
rload | int | Otpornik opterećenja, od RLOAD_10_OHM do RLOAD_100_OHM. |
ref_source | int | REF_INTERNAL ili REF_EXTERNAL. |
internal_zero | int | INTERNAL_ZERO_20_PERCENT, _50_PERCENT, _67_PERCENT ili INTERNAL_ZERO_BYPASSED. |
bias_sign | int | BIAS_SIGN_NEGATIVE ili BIAS_SIGN_POSITIVE. |
bias | int | Prednapon kao udio reference, od BIAS_0_PERCENT do BIAS_24_PERCENT. |
fet_short | int | FET_SHORT_DISABLED ili FET_SHORT_ENABLED. |
op_mode | int | Način rada, OP_MODE_3LEAD_AMP_CELL za normalan rad. |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora iz konfiguracije, I2C objekta, adrese i neobveznog pina za omogućavanje. Primjer prosljeđuje samo konfiguraciju i I2C objekt, pa je adresa zadana, 0x49.
ReturnsObjekt senzora.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
sensor_type | SensorConfig | Konfiguracija, ovdje SENSOR_CUSTOM. |
i2c | I2C | Inicijalizirani objekt machine.I2C. |
adc_addr | int | Adresa s kojom modul komunicira. Adrese od 0x30 do 0x37 odabiru premosni način modula, koji komunicira s mikrokontrolerom na pločici; svaka druga vrijednost komunicira s čipom ADS1115 izravno na toj adresi. Zadano 0x49. |
config_pin | int | GPIO za liniju omogućavanja čipa LMP91000. Ne koristi se na adresama od 0x30 do 0x37. Zadano None. |
begin()returns boolProvjerava odgovara li pločica te joj šalje pojačanje ADC-a i vrijednosti registara čipa LMP91000 izrađene iz konfiguracije.
ReturnsTrue kada je pločica odgovorila i prihvatila sve postavke, inače False.
getPPB()returns floatTraži od pločice jedno očitanje ADC-a i vraća koncentraciju u dijelovima na milijardu (ppb), koristeći pojačanje i osjetljivost iz konfiguracije. Rezultat manji od nule vraća se kao 0.
ReturnsKoncentracija plina u ppb.
Sastavljanje cjeline
Osjetljivost skalira svaki rezultat, pa pogrešna vrijednost daje pogrešan iznos čak i kada hardver radi ispravno. Kod TIA_GAIN_EXTERNAL pozovite i setCustomTiaGain() kako bi modul znao vrijednost otpornika pojačanja.