Kalibracija nule
Što prikazuje ovaj primjer
Primjer electrochemical-calibrateSensor.py primjenjuje kalibracijski pomak nulte točke funkcijom setCustomZeroCalibration(), a zatim svakih 2,5 sekundi ispisuje koncentraciju plina u dijelovima na milijardu (ppb).
Pomak je CUSTOM_CALIBRATION na vrhu skripte, a u primjeru iznosi 0. Komentar u primjeru objašnjava kako ga koristiti: vrijednost se dodaje naponu očitanom s ADC-a, a u zraku bez ciljanog plina podešavate je dok očitanje ne bude tek nešto iznad 0 ppb.
Prije pokretanja u retku import i u retku koji stvara senzor promijenite SENSOR_O3 u SENSOR_CO. SENSOR_O3 je predložak modula za ćeliju za ozon. Ova pločica nosi ćeliju za ugljikov monoksid SGX-4CO, a predložak modula za nju je SENSOR_CO. Pomak se dodaje prije nego što modul pretvori vrijednost pomoću osjetljivosti i nule iz predloška, stoga ga podešavajte sa SENSOR_CO: pomak pronađen s predloškom za ozon ne postavlja ovu ćeliju na nulu.
Primjer otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21. Promijenite ih u I2C pinove svojeg kontrolera ako se razlikuju.
Što je potrebno na ovoj pločici
Primjer stvara senzor s adc_addr=0x49 i config_pin=32. Na adresi izvan raspona od 0x30 do 0x37 modul ne ide preko mosta na pločici: begin() I2C skeniranjem traži ADS1115 na toj adresi, a zatim na adresi 0x48 upisuje konfiguraciju čipa LMP91000, oboje na sabirnici koju mu proslijedite. Na ovoj pločici ta dva čipa nalaze se na internoj sabirnici, koju gornji header izvodi kao SDA2 i SCL2. Qwiic konektori i SDA1/SCL1 dolaze samo do mosta ATtiny404, a I2C skeniranje preko Qwiic konektora pronalazi samo most, na adresi 0x30 kakva je postavljena pri isporuci.
Stoga za ovaj primjer povežite gornji header, a ne Qwiic kabel: spojite SDA svojeg kontrolera na SDA2, njegov SCL na SCL2, njegov pin 3,3 V na 3V3, a njegov GND na GND. Dijagram spajanja u listingu prikazuje Qwiic liniju, ali preko Qwiic konektora odgovara samo most.
Modul postavlja pin 32 u nisko stanje dok upisuje konfiguraciju prednjeg stupnja, a inače ga drži u visokom stanju, a komentar o spajanju u primjeru povezuje taj pin na LMPEN. Na pločici je LMPEN na donjem headeru, preko 10 kΩ povučen na GND i spojen i na ATtiny404; pogledajte
Hardverski detalji.
Adresa mosta, od 0x30 do 0x37, ona je koju prosljeđuje primjer Očitavanje koncentracije CO.
Kôd 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)
Retci u nastavku potječu iz pokretanja ovog primjera na ovoj pločici, s kontrolerom spojenim na pinove SDA2, SCL2, 3V3 i GND headera kako je gore opisano.
Očekivani rezultat u Thonny konzoli:
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!
Sensor reading: 291.45891 PPB
Sensor reading: 314.34645 PPB
Sensor reading: 300.00720 PPB
Sensor reading: 318.97074 PPB
Zatim svake 2,5 sekunde jedan redak: Sensor reading: , koncentracija u ppb s pet decimala i PPB. Rezultat manji od nule ispisuje se kao 0.00000. Ako begin() ne uspije, konzola prikazuje ERROR: Can't init the sensor! Check connections! i skripta se ondje zaustavlja.
Korištene funkcije
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora. Primjer prosljeđuje predložak, I2C sabirnicu, adc_addr=0x49 i config_pin=32.
ReturnsObjekt senzora.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
sensor_type | SensorConfig | Predložak ćelije. Za ćeliju SGX-4CO na ovoj pločici predložak modula je SENSOR_CO. |
i2c | machine.I2C | Inicijalizirana I2C sabirnica. S None modul otvara I2C 0 na pinovima 22 i 21 na ESP32, odnosno na pinovima 5 i 4 na ESP8266, a na bilo kojoj drugoj pločici javlja Board not recognized, please pass an I2C object manually. |
adc_addr | int | I2C adresa. Zadano 0x49. Od 0x30 do 0x37 modul komunicira s mostom ATtiny404 na pločici. |
config_pin | int ili None | GPIO koji modul drži u niskom stanju dok šalje konfiguraciju prednjeg stupnja, a inače u visokom. Ne koristi se na adresi od 0x30 do 0x37. Zadano None. |
begin()returns boolPokreće senzor. Na adresi adc_addr od 0x30 do 0x37 provjerava odgovara li most, šalje mu pojačanje ADC-a i brzinu podataka iz predloška, zatim konfiguraciju prednjeg stupnja, pri čemu za svaki korak ponavlja pokušaj nakon greške sabirnice do isteka od 500 ms. Na bilo kojoj drugoj adresi adc_addr provjerava odgovara li ADC na toj adresi, postavlja mu pojačanje i brzinu podataka, a zatim upisuje konfiguraciju prednjeg stupnja dok je config_pin držan u niskom stanju.
ReturnsTrue ako je svaki korak uspio, inače False.
setCustomZeroCalibration(calibration)returns NonePostavlja pomak kalibracije nule. getPPM() i getPPB() dodaju ga, u voltima, izmjerenom naponu nakon oduzimanja unutarnje nule, a prije pretvorbe u koncentraciju. Pohranjuje se u objektu predloška proslijeđenom konstruktoru.
ReturnsNišta.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
calibration | float | Pomak u voltima. Primjer prosljeđuje CUSTOM_CALIBRATION, koji iznosi 0. |
getPPB()returns floatIzvodi jedno mjerenje i vraća ga u dijelovima na milijardu. Komentar u primjeru kaže da prijeđete na getPPM() ako vam više odgovara ppm.
ReturnsgetPPM() pomnožen s 1000.
Sve zajedno
Stvorite objekt sa SENSOR_CO, predloškom za ćeliju na ovoj pločici, jednom pozovite begin() i provjerite rezultat, a zatim prije početka očitavanja pozovite setCustomZeroCalibration() sa svojim pomakom. U zraku bez ciljanog plina mijenjajte CUSTOM_CALIBRATION i ponovno pokrećite skriptu dok očitanje ne bude tek nešto iznad 0 ppb, kako kaže komentar u primjeru.