Skip to main content

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.

ShellMicroPython
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 I2C

Stvara 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

TipNazivOpis
intidSklopovska I2C sabirnica, u primjeru 0.
PinsclPin takta, u primjeru Pin(22).
PinsdaPin podataka, u primjeru Pin(21).
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Stvara 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

TipNazivOpis
SensorConfigsensor_typeProfil ć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.
I2Ci2cI2C sabirnica na kojoj se nalazi pločica.
intadc_addrI2C 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.
intconfig_pinGPIO 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 bool

Za 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 None

Postavlja 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

TipNazivOpis
floatcalibrationPomak u voltima, u primjeru CUSTOM_CALIBRATION (0).
sensor.getPPB()returns float

Uzima 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 float

Alternativa 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.