Skip to main content

Kalibracija nulte točke

Što prikazuje ovaj primjer​

Primjer electrochemical-calibrateSensor.py iz biblioteke dodaje fiksni naponski pomak, CUSTOM_CALIBRATION, svakom ADC očitanju prije nego što se ono pretvori u koncentraciju. Na zraku bez ciljanog plina podešavajte tu vrijednost dok očitanje nije tek nešto iznad 0.

Primjer stvara senzor s predloškom ćelije za ozon, SENSOR_O3, na adc_addr=0x49 s config_pin=32. SENSOR_SO2 je predložak biblioteke za SO2 ćeliju ove pločice: promijenite SENSOR_O3 u SENSOR_SO2 u retku import i u retku koji stvara sensor da biste dobili vrijednosti SO2. Skripta stvara I2C sabirnicu na GPIO 22 (SCL) i GPIO 21 (SDA); promijenite te brojeve ako vaša pločica koristi druge pinove.

Na ovoj pločici LMP91000 i ADS1115 nalaze se na vlastitoj sabirnici 2 pločice, a vaš kontroler im pristupa preko adrese pločice na Qwiic sabirnici: 0x30 kako se isporučuje, a 0x30 do 0x37 pomoću prekidača ADDRESS. adc_addr=0x49 iz primjera komunicira izravno s ADS1115. Umjesto toga proslijedite adresu pločice, na primjer sensor = ElectrochemicalGasSensor(SENSOR_SO2, i2c, adc_addr=0x30). Gdje dijagram povezivanja kaže da LMPEN ide na GPIO 32, na ovoj je pločici LMPEN već spojen na GND otpornikom od 10 kΩ i također ide na mikrokontroler na pločici, a na adresama pločice modul ne koristi config_pin (pogledajte Detalji o hardveru).

Popis je datoteka iz biblioteke na zapisanoj (pinned) inačici, osim dvaju redaka koji sadrže samo komentare, a koji upućuju na drugi Soldered proizvod ili imenuju kontrolersku pločicu u dijagramu povezivanja; oni su izostavljeni.

Primjer koda​

# 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

electrochemical-calibrateSensor.py na zapisanoj (pinned) inačici

→

Očekivani rezultat:

ShellMicroPython
Electrochemical Gas Sensor - Calibration Example
Sensor initialized successfully!

Zatim se svakih 2,5 sekunde pojavljuje redak Sensor reading: u ppb.

Korištene funkcije​

ElectrochemicalGasSensor(sensor_type, i2c=None, adc_addr=0x49, config_pin=None)returns ElectrochemicalGasSensor

Stvara objekt senzora iz predloška ćelije, I2C objekta, adrese i neobveznog pina za omogućavanje. Primjer prosljeđuje adc_addr=0x49 i config_pin=32.

ReturnsObjekt senzora.

Parametri

ParametarTipOpis
sensor_typeSensorConfigPredložak ćelije. SENSOR_SO2 je predložak za ćeliju ove pločice.
i2cI2CInicijalizirani objekt machine.I2C.
adc_addrintAdresa na kojoj modul komunicira. Adrese od 0x30 do 0x37 odabiru premosni način rada modula, koji komunicira s mikrokontrolerom na pločici; svaka druga vrijednost komunicira izravno s ADS1115 na toj adresi. Zadano 0x49.
config_pinintGPIO za liniju omogućavanja LMP91000. Ne koristi se na adresama od 0x30 do 0x37. Zadano None.
begin()returns bool

Provjerava odgovara li pločica i šalje joj postavke ADC-a i LMP91000 iz predloška.

ReturnsTrue ako je pločica odgovorila i prihvatila sve postavke, inače False.

setCustomZeroCalibration(calibration)returns None

Postavlja naponski pomak koji se dodaje svakom očitanju prije pretvorbe u koncentraciju. Zamjenjuje vlastitu vrijednost nulte kalibracije iz predloška, koja za SENSOR_SO2 iznosi 0.

ReturnsNišta.

Parametri

ParametarTipOpis
calibrationfloatPomak u voltima.
getPPB()returns float

Pločica izvodi jedno ADC očitanje i vraća koncentraciju u dijelovima na milijardu (ppb), uključujući pomak nulte kalibracije. Rezultat manji od nule vraća se kao 0.

ReturnsKoncentracija plina u ppb.

getPPM()returns float

Isto očitanje u ppm. Primjer ga u komentaru navodi kao alternativu.

ReturnsKoncentracija plina u ppm.

Sve zajedno​

Postavite pločicu na zrak bez SO2 i pokrenite skriptu s CUSTOM_CALIBRATION = 0. Mijenjajte vrijednost dok očitanje nije tek nešto iznad 0, a zatim istu vrijednost upotrijebite s setCustomZeroCalibration() u vlastitoj skripti.