Kalibracija nulte točke
Što ovaj primjer prikazuje
Primjer electrochemical-calibrateSensor.py dodaje pomak nulte točke očitanjima
senzora i svake 2,5 sekunde ispisuje koncentraciju plina u dijelovima na milijardu
(PPB).
Za ovaj primjer povežite kontroler na gornji header, a ne na Qwiic
konektor: SDA kontrolera na SDA2, SCL na SCL2, napajanje od 3,3 V na 3V3, a masu na GND. Na ovoj adresi biblioteka komunicira s ADS1115 i LMP91000 izravno preko SDA2 i SCL2; ATtiny404 most na adresi 0x30
se ne koristi. Preko
Qwiic konektora radi samo primjer s mostom iz poglavlja
Brzi početak.
Kod primjera
CUSTOM_CALIBRATION je napon koji biblioteka dodaje svakom očitanju ADC-a. Kao što stoji u komentaru primjera, na zraku bez ciljnog plina namjestite ga tako da očitanje bude tek malo iznad 0 PPB. Primjer koristi predložak za ozon i otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21, a senzor stvara s adc_addr=0x49 i config_pin=32.
Kao što pokazuje dijagram spajanja u komentarima primjera, pin LMPEN pločice na headeru povežite na GPIO 32, odnosno config_pin iz primjera. Na ovoj pločici LMPEN ide i na ATtiny404 pločice.
# 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 u commitu 623e1e6
Shell prikazuje:
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!
Zatim svake 2,5 sekunde slijedi redak: Sensor reading: , koncentracija s pet decimala i PPB. Ako begin() ne uspije, skripta ispisuje
ERROR: Can't init the sensor! Check connections! i čeka.
Korištene funkcije
I2C i Pin dolaze iz MicroPythonova vlastitog modula machine, a
time.sleep_ms() iz modula time. Funkcije u nastavku pripadaju biblioteci.
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora za jednu pločicu. Biblioteka čita adc_addr kako bi odlučila kako komunicirati: za adresu od 0x30 do 0x37 koristi protokol ATtiny404 mosta; za bilo koju drugu adresu sama komunicira s ADS1115 na toj adresi i s LMP91000 na 0x48.
ReturnsObjekt senzora.
Parametri
| Naziv | Tip | Opis |
|---|---|---|
sensor_type | SensorConfig | Predložak za vašu ćeliju: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 ili vaš vlastiti SensorConfig. |
i2c | machine.I2C | I2C sabirnica. Ako se izostavi, biblioteka otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21 na ESP32 portu, odnosno I2C sa SCL na pinu 5 i SDA na pinu 4 na ESP8266 portu, a na svakoj drugoj pločici baca iznimku. |
adc_addr | int | Adresa koju koristi begin(). Od 0x30 do 0x37 odabire protokol mosta; ova pločica odgovara na 0x30 po tvorničkim postavkama ili na adresi koju postavi njezin prekidač. Svaka druga vrijednost tumači se kao adresa ADS1115. Zadano je 0x49. |
config_pin | int | Broj GPIO pina za liniju omogućavanja LMP91000. Biblioteka je drži na visokoj razini i spušta je na nisku samo dok sama upisuje registre LMP91000; za adresu od 0x30 do 0x37 se ne koristi. Zadano je None. |
begin()returns boolPostavlja vezu za adc_addr i konfigurira LMP91000 odabranim predloškom. Za 0x30 do 0x37 provjerava odgovara li most, šalje pojačanje ADC-a i traži od mosta da upiše registre LMP91000, a svaki korak odustaje nakon 500 ms. Za bilo koju drugu adresu I2C skeniranjem provjerava odgovara li uređaj na adresi adc_addr, a zatim upisuje registre LMP91000 na 0x48 kada njegov status pokazuje spremnost.
ReturnsTrue ako su svi koraci uspjeli, inače False.
setCustomZeroCalibration(calibration)returns NonePostavlja pomak nulte točke, u voltima, koji getPPM() i getPPB() dodaju svakom očitanju nakon uklanjanja unutarnje nule. Vrijednost sprema u objekt predloška koji ste proslijedili konstruktoru, pa je koristi i svaki senzor stvoren s istim predloškom.
ReturnsNišta.
Parametri
| Naziv | Tip | Opis |
|---|---|---|
calibration | float | Pomak u voltima. |
getPPB()returns floatIzvodi jedno očitanje kanala 0 ADS1115 (za 0x30 do 0x37 preko mosta) i pretvara ga u koncentraciju pomoću predloška: uklanja unutarnji pomak nule, dodaje kalibraciju nule, dijeli s pojačanjem pojačala i osjetljivošću ćelije u nA po PPM te množi s 1000. Negativan rezultat vraća se kao 0.
ReturnsKoncentracija plina u PPB, getPPM() x 1000.
getPPM()returns floatIsto očitanje u dijelovima na milijun. Komentar u primjeru navodi ga kao alternativu.
ReturnsKoncentracija plina u PPM.
Sve zajedno
Stvorite senzor i pozovite begin(). Zatim pozovite setCustomZeroCalibration()
sa svojim pomakom prije očitanja. Na zraku bez ciljnog plina namjestite
pomak tako da očitanje bude tek malo iznad 0. getPPM() za svaki
negativan rezultat vraća 0, pa očitanje od točno 0 ne pokazuje koliko je
nekorigirana vrijednost ispod nule.