Skip to main content

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:

ShellMicroPython
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 I2C

Stvara 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

TipNazivOpis
intidHardverska I2C sabirnica, u primjeru 0.
PinsclPin takta, u primjeru Pin(22).
PinsdaPin podataka, u primjeru Pin(21).
ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Stvara 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

TipNazivOpis
SensorConfigsensor_typePostavke ulaznog sklopa i pretvorbe, na primjer SENSOR_O3. Predlošci su definirani u ElectrochemicalGasSensor.py.
I2Ci2cSabirnica 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.
intadc_addrAdresa 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.
intconfig_pinGPIO 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 bool

Konfigurira 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 None

Postavlja 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

TipNazivOpis
floatcalibrationPomak u voltima, u primjeru CUSTOM_CALIBRATION.
sensor.getPPB()returns float

Obavlja 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.