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:
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 ElectrochemicalGasSensorStvara 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
| Parametar | Tip | Opis |
|---|---|---|
sensor_type | SensorConfig | Predložak ćelije. SENSOR_SO2 je predložak za ćeliju ove pločice. |
i2c | I2C | Inicijalizirani objekt machine.I2C. |
adc_addr | int | Adresa 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_pin | int | GPIO za liniju omogućavanja LMP91000. Ne koristi se na adresama od 0x30 do 0x37. Zadano None. |
begin()returns boolProvjerava 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 NonePostavlja 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
| Parametar | Tip | Opis |
|---|---|---|
calibration | float | Pomak u voltima. |
getPPB()returns floatPloč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 floatIsto 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.