Skip to main content

Kalibracija nulte točke

Što prikazuje ovaj primjer​

Primjer modula electrochemical-calibrateSensor.py dodaje vaš vlastiti pomak naponu koji senzor mjeri, a zatim svakih 2,5 sekunde ispisuje koncentraciju plina u ppb (dijelovi na milijardu).

CUSTOM_CALIBRATION na vrhu je taj pomak, u voltima. Kako navodi komentar u primjeru, postavite pločicu u zrak bez ciljanog plina i podešavajte vrijednost dok očitanje ne bude tek nešto iznad 0 ppb. Primjer počinje s vrijednošću 0.

Primjer stvara senzor s presetom za ozon, SENSOR_O3. SENSOR_NO2 je preset modula za SGX-4NO2 ćeliju na ovoj pločici; promijenite ga u retku import i u retku koji stvara senzor. Primjer otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21; promijenite ih prema svom kontroleru.

Kod primjera​

# 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)

🔗Otvorite cijeli primjer

Examples/electrochemical-calibrateSensor.py na commitu 623e1e6

→

Očekivani rezultat:

ShellMicroPython
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!

Zatim primjer svakih 2,5 sekunde ispisuje redak koji počinje s Sensor reading:, a nakon njega slijedi koncentracija u ppb s pet decimala. Ako begin() ne uspije, ispisuje ERROR: Can't init the sensor! Check connections! i čeka u petlji.

Korištene funkcije​

ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Stvara objekt senzora. S parametrom config_pin taj pin dodatno postavlja kao izlaz i postavlja ga u visoko stanje. Ništa se ne šalje preko I2C sabirnice dok ne pozovete begin().

ReturnsObjekt senzora.

Parametri

TipNazivOpis
SensorConfigsensor_typePreset ćelije. SENSOR_NO2 je preset za SGX-4NO2 ćeliju na ovoj pločici.
I2Ci2cI2C sabirnica. S vrijednošću None modul bira pinove prema portu koji MicroPython prijavi: I2C sabirnica 0 na pinovima 22 (SCL) i 21 (SDA) na ESP32 portu, scl=Pin(5), sda=Pin(4) na ESP8266 portu. Na portu koji ne prepoznaje javlja grešku Board not recognized, please pass an I2C object manually.
intadc_addrAdresa s kojom begin() komunicira, prema zadanim postavkama 0x49; primjer prosljeđuje 0x49. Od 0x30 do 0x37 modul šalje naredbe ATtiny404 čipu; od 0x48 do 0x4B izravno se obraća ADS1115 čipu na adc_addr i LMP91000 čipu.
intconfig_pinBroj GPIO pina za pin za omogućavanje čipa LMP91000 (LMPEN), koristi se samo na 0x48 do 0x4B. Prema zadanim postavkama None; primjer prosljeđuje 32.
sensor.begin()returns bool

Pokreće senzor i upisuje preset u njega. Na adresama od 0x30 do 0x37 provjerava odgovara li ATtiny404, zatim šalje pojačanje ADC-a, brzinu podataka i konfiguraciju čipa LMP91000, a svaki se korak ponavlja dok pločica ne odgovori ili ne prođe 500 ms. Na adresama od 0x48 do 0x4B provjerava pojavljuje li se ADS1115 u I2C skeniranju na adc_addr, postavlja njegovo pojačanje i najsporiju brzinu podataka te upisuje konfiguraciju u LMP91000 na 0x48, pritom držeći config_pin u niskom stanju. Pozovite je jednom prije čitanja.

ReturnsTrue ako su svi koraci uspjeli, inače False.

sensor.setCustomZeroCalibration(calibration)returns None

Postavlja pomak kalibracije koji getPPM() dodaje izmjerenom naponu prije nego ga pretvori u koncentraciju. Mijenja tu vrijednost u objektu preseta koji ste proslijedili pri stvaranju senzora.

ReturnsNišta.

Parametri

TipNazivOpis
floatcalibrationPomak u voltima. Primjer prosljeđuje CUSTOM_CALIBRATION.
sensor.getPPB()returns float

Čita novu vrijednost i vraća koncentraciju plina u dijelovima na milijardu: getPPM() pomnožen s 1000, uz primijenjen pomak kalibracije.

ReturnsKoncentracija plina u ppb.

Sve zajedno​

Primjer prvo stvara I2C sabirnicu i prosljeđuje je senzoru. Poziva begin() i zaustavlja se u petlji ako to ne uspije, a zatim prije prvog očitanja postavlja pomak funkcijom setCustomZeroCalibration(), pa svaka ispisana vrijednost već sadrži taj pomak. Svaki prolaz glavne petlje poziva getPPB(), ispisuje vrijednost s pet decimala i čeka 2,5 sekunde.