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:
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 ElectrochemicalGasSensorStvara 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
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Preset ćelije. SENSOR_NO2 je preset za SGX-4NO2 ćeliju na ovoj pločici. |
I2C | i2c | I2C 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. |
int | adc_addr | Adresa 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. |
int | config_pin | Broj 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 boolPokreć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 NonePostavlja 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
| Tip | Naziv | Opis |
|---|---|---|
float | calibration | Pomak 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.