Kalibracija nulte točke
Što ovaj primjer prikazuje
Primjer electrochemical-calibrateSensor.py dodaje fiksni naponski pomak,
CUSTOM_CALIBRATION, svakom očitanju, a zatim ispisuje očitanja u PPB svakih 2,5
sekunde. Senzor stvara s adc_addr=0x49 i config_pin=32.
Komentar u samom primjeru objašnjava kako koristiti pomak: bez prisutnosti ciljanog
plina podešavajte CUSTOM_CALIBRATION dok očitanje ne bude tek iznad 0
PPB. Početna vrijednost je 0, što ne dodaje ništa.
Primjer otvara I2C sabirnicu 0 sa SCL na pinu 22 i SDA na pinu 21. Promijenite
ih na pinove koje koristi Qwiic konektor vašeg kontrolera ili vaše ožičenje.
Na ovoj pločici nije potrebno spajati LMPEN na pin 32, bez obzira na to što piše u
komentarima primjera: pločica ga sama drži na niskoj razini.
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)
🔗Otvorite cijeli primjer
Examples/electrochemical-calibrateSensor.py u commitu 623e1e6
Što ova pločica ispisuje s primjerom u izvornom obliku, još nije izmjereno.
Pri testiranju ove pločice preko Qwiic konektora I2C skeniranje pronašlo je samo jednu adresu,
0x30, a begin() nije uspio za senzor stvoren na 0x49, adresi koju
ovaj primjer prosljeđuje. Ako begin() ne uspije, primjer nakon naslovne retke ispisuje
ERROR: Can't init the sensor! Check connections! i tu staje.
Kada begin() uspije, u shellu se prikazuje:
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!
Nakon toga svakih 2,5 sekunde stiže redak Sensor reading: iza kojeg slijedi vrijednost s pet decimala
i PPB.
Korištene funkcije
I2C(id, scl, sda)returns I2CStvara objekt I2C sabirnice iz MicroPythonova modula machine, koji koristi objekt senzora. Primjer koristi sabirnicu 0 sa SCL na Pin(22) i SDA na Pin(21). I2C i Pin dolaze s MicroPythonom i nisu dio ove biblioteke.
ReturnsObjekt I2C sabirnice.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
int | id | Hardverska I2C sabirnica, u primjeru 0. |
Pin | scl | Pin takta, u primjeru Pin(22). |
Pin | sda | Pin podataka, u primjeru Pin(21). |
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensorStvara objekt senzora. Ništa se ne šalje pločici dok ne pozovete begin(). Primjer prosljeđuje konfiguraciju senzora, sabirnicu, adc_addr=0x49 i config_pin=32.
ReturnsObjekt senzora.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
SensorConfig | sensor_type | Postavke ulaznog sklopa i pretvorbe, na primjer SENSOR_O3. Predlošci su definirani u ElectrochemicalGasSensor.py. |
I2C | i2c | Sabirnica koja se koristi. Ako je izostavljena, modul odabire pinove samo na pločicama koje prepoznaje (ESP32: sabirnica 0, SCL 22, SDA 21; ESP8266: SCL 5, SDA 4), a inače izaziva iznimku. |
int | adc_addr | Adresa s kojom modul komunicira, prema zadanim postavkama i u ovom primjeru 0x49. Adresa od 0x30 do 0x37 uzrokuje da begin() koristi naredbe mosta; svaka druga adresa tumači se kao vlastita adresa ADS1115. |
int | config_pin | GPIO pin koji modul drži na visokoj razini i spušta na nisku dok upisuje postavke LMP91000, u ovom primjeru 32. Prema zadanim postavkama None; ne koristi se za adresu od 0x30 do 0x37. |
sensor.begin()returns boolKonfigurira ADC i LMP91000 prema konfiguraciji senzora. Za adc_addr od 0x30 do 0x37 provjerava odgovara li most pločice i šalje mu pojačanje ADC-a, najsporiju brzinu podataka ADC-a i postavke LMP91000, ponavljajući svaku naredbu do 500 ms. Za bilo koju drugu adresu postavlja ADS1115 na toj adresi s istim pojačanjem i brzinom podataka te izravno upisuje postavke LMP91000, pri čemu, ako je zadan, spušta config_pin na nisku razinu.
ReturnsTrue ako su svi koraci uspjeli, inače False.
sensor.setCustomZeroCalibration(calibration)returns NonePostavlja pomak nulte točke, u voltima, koji getPPM() dodaje izmjerenom naponu. Vrijednost upisuje u objekt konfiguracije senzora koji ste proslijedili konstruktoru, u primjeru SENSOR_O3.
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
float | calibration | Pomak u voltima, u primjeru CUSTOM_CALIBRATION. |
sensor.getPPB()returns floatObavlja jedno očitanje i vraća ga u dijelovima na milijardu: vrijednost getPPM() pomnožena s 1000. getPPM() oduzima unutarnju nulu (dio referentnih 2,5 V pločice), dodaje pomak nulte točke, dijeli s TIA pojačanjem i s nanoamperima po PPM iz konfiguracije te za negativan rezultat vraća 0.0.
ReturnsKoncentracija u PPB.
Sve zajedno
SENSOR_O3 je predložak za ćeliju za ozon SGX-403-20. Modul još nema
predložak za kisikovu ćeliju SGX-4OX-ROHS na ovoj pločici, pa se vrijednost koju primjer
ispisuje izračunava s postavkama ćelije za ozon.
Stranica prilagođena konfiguracija
pokazuje kako napisati vlastitu; njezino polje internal_zero_calibration postavlja
isti pomak pri stvaranju konfiguracije.