Kalibracija nulte točke
Što prikazuje ovaj primjer
Primjer electrochemical-calibrateSensor.py dodaje naponski pomak svakom
očitanju pomoću setCustomZeroCalibration(). Modul svaki negativni rezultat
prijavljuje kao 0, pa na zraku bez ciljanog plina podešavate
CUSTOM_CALIBRATION sve dok očitanje nije tek taman 0 ppb, kako opisuje
komentar u primjeru. Zatim svake 2,5 sekunde ispisuje očitanje u ppb (parts per billion, dijelovi na milijardu).
Primjer stvara senzor s adc_addr=0x49 i config_pin=32 za
LMPEN. Otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21; ako se pinovi I2C-a vašeg kontrolera razlikuju, promijenite te brojeve pinova. Na adresi 0x49 modul izravno komunicira s ADS1115 i LMP91000, a ne preko ATtiny404 mosta na pločici. Pogledajte
pregled biblioteke
da vidite kako adresa to određuje.
Primjer koristi SENSOR_O3, unaprijed postavljeni profil modula za ćeliju za ozon. Za
očitanje dušikova oksida koristite SENSOR_NO na oba mjesta (u retku import
i u retku ElectrochemicalGasSensor(...)). SENSOR_NO je unaprijed postavljeni profil za ćeliju SGX-4NO-250 na
ovoj pločici: 400 nA po ppm, pojačanje pojačala od 120 kΩ i
pozitivan pomak od 12 %.
Kôd primjera
Popis je datoteka modula na zadanom commitu. Izostavljeni su samo retci komentara: zaglavni redak koji navodi stranicu trgovine drugog proizvoda i redak sa spojnim dijagramom koji navodi staru pločicu.
# FILE: electrochemical-calibrateSensor.py
# AUTHOR: Fran Fodor @ Soldered
# BRIEF: Sensor zero-point calibration example.
# LAST UPDATED: 2026-05-21
# Connecting diagram:
#
# Qwiic------------------------>Qwiic
# LMPEN------------------------>32 (GPIO pin, required for configuration)
from machine import I2C, Pin
import time
from ElectrochemicalGasSensor import ElectrochemicalGasSensor, SENSOR_O3
# This value is added to the voltage read from the ADC.
# In an environment with 0 of the target gas, the reading after calibration
# should be just barely 0 PPB — adjust this value until that is the case.
CUSTOM_CALIBRATION = 0
# Initialize I2C
i2c = I2C(0, scl=Pin(22), sda=Pin(21))
# Custom ADC address (0x49 default) and GPIO pin for LMPEN
sensor = ElectrochemicalGasSensor(SENSOR_O3, i2c, adc_addr=0x49, config_pin=32)
# -------------------------------------------------------------------------
# Setup
# -------------------------------------------------------------------------
print("Electrochemical Gas Sensor - Calibration Example")
if not sensor.begin():
print("ERROR: Can't init the sensor! Check connections!")
while True:
time.sleep_ms(100)
# Apply the zero-point calibration offset
sensor.setCustomZeroCalibration(CUSTOM_CALIBRATION)
print("Sensor initialized successfully!")
# -------------------------------------------------------------------------
# Main loop
# -------------------------------------------------------------------------
while True:
reading = sensor.getPPB()
# O3 is typically measured in PPB
# Switch to getPPM() if PPM is more relevant for your use case
print("Sensor reading: {:.5f} PPB".format(reading))
time.sleep_ms(2500)
🔗Otvori cijeli primjer
Examples/electrochemical-calibrateSensor.py na commitu 623e1e6
Očekivani rezultat sa SENSOR_NO (očitanja na zraku bez NO; vaša će se razlikovati). Vrijednost CUSTOM_CALIBRATION s kojom su ova očitanja snimljena nije zabilježena, pa se mogu razlikovati od onoga što daje 0 iz popisa: prikazuju oblik izlaza, a vaši brojevi ovise o pomaku koji postavite.
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!
Sensor reading: 6.04131 PPB
Sensor reading: 6.16508 PPB
Sensor reading: 6.27205 PPB
Sensor reading: 5.68221 PPB
Redak Sensor reading: pojavljuje se svake 2,5 sekunde, s
koncentracijom u ppb na pet decimala i PPB na kraju. Ako begin()
ne uspije, primjer ispisuje ERROR: Can't init the sensor! Check connections!
i ostaje u petlji.
Korištene funkcije
I2C(0, scl=Pin(22), sda=Pin(21))returns I2CStvara sklopovsku I2C sabirnicu 0 na zadanim pinovima SCL i SDA. machine.I2C i machine.Pin dolaze s MicroPythonom i nisu dio Soldered modula (pogledajte docs.micropython.org, machine.I2C i machine.Pin).
ReturnsObjekt I2C sabirnice koji prosljeđujete senzoru.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | id | Sklopovska I2C sabirnica, u primjeru 0. |
Pin | scl | Pin takta, u primjeru Pin(22). |
Pin | sda | Pin podataka, u primjeru Pin(21). |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora. Ništa se ne šalje preko I2C-a dok ne pozovete begin(). Uz i2c=None modul sam otvara sabirnicu na pločicama koje prepoznaje, među kojima su ESP32, na kojem otvara I2C(0, scl=Pin(22), sda=Pin(21)), i ESP8266, na kojem otvara I2C(scl=Pin(5), sda=Pin(4)). Na pločici koju ne prepoznaje podiže iznimku.
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Profil ćelije, u primjeru SENSOR_O3. SENSOR_NO je profil za ćeliju ove pločice. Modul ima i SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_H2S, SENSOR_NH3 i SENSOR_CL2. |
I2C | i2c | I2C sabirnica na kojoj se nalazi pločica. |
int | adc_addr | I2C adresa, u primjeru 0x49. Za 0x30 do 0x37 modul komunicira s ATtiny404 mostom na pločici; za svaku drugu adresu komunicira s ADS1115 na toj adresi i izravno s LMP91000. |
int | config_pin | GPIO za LMPEN, u primjeru 32. Modul ga drži visokim i spušta ga samo dok konfigurira LMP91000. Ne koristi se na adresama od 0x30 do 0x37. |
sensor.begin()returns boolZa adresu od 0x30 do 0x37 provjerava odgovara li most na pločici i preko njega šalje postavke ADC-a i ulaznog stupnja, čekajući do 500 ms za svaki korak. Za svaku drugu adresu provjerava u I2C skeniranju odgovara li ADS1115 na adc_addr, postavlja ADC pojačanje profila i najsporiju brzinu podataka, zatim konfigurira LMP91000 na 0x48 (pojačanje, opterećenje, referencu, unutarnju nulu, pomak i način rada), pri čemu config_pin spušta na nisku razinu samo tijekom te konfiguracije, ako je zadan.
ReturnsTrue ako su svi koraci uspjeli, inače False.
sensor.setCustomZeroCalibration(calibration)returns NonePostavlja kalibraciju nule za profil senzora: napon koji getPPM() pribraja svakom očitanju prije pretvorbe. Mijenja sam objekt profila, pa svaki senzor stvoren s istim profilom koristi novu vrijednost.
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
float | calibration | Pomak u voltima, u primjeru CUSTOM_CALIBRATION (0). |
sensor.getPPB()returns floatUzima jedno očitanje pomoću getPPM() i množi ga s 1000. getPPM() čita ADC kanal 0 (na 0x30 do 0x37 pretvorbu izvodi most), oduzima unutarnju nulu (2,5 V puta postotak unutarnje nule profila), pribraja kalibraciju nule, zatim dijeli s pojačanjem pojačala i s nA po ppm profila.
ReturnsKoncentracija plina u ppb. Negativan rezultat vraća se kao 0.0.
sensor.getPPM()returns floatAlternativa koju nudi komentar u primjeru: isto očitanje u ppm.
ReturnsKoncentracija plina u ppm. Negativan rezultat vraća se kao 0.0.
Sve zajedno
begin() jednom konfigurira ulazni stupanj, a zatim setCustomZeroCalibration()
postavlja pomak prije prvog očitanja. Promijenite CUSTOM_CALIBRATION, ponovno pokrenite
primjer na zraku bez ciljanog plina i ponavljajte dok
očitanja nisu tek taman 0 ppb.