Nullpunktkalibrierung
Was dieses Beispiel zeigt
Das Beispiel calibrateSensor wendet mit setCustomZeroCalibration() einen Offset zur Nullpunktkalibrierung an und gibt anschließend alle 2,5 Sekunden die Gaskonzentration in ppm aus.
Der Offset ist customCalibration am Anfang des Sketches, im Beispiel 0,05. Der Kommentar des Beispiels erklärt die Verwendung: Der Wert wird zur vom ADC gelesenen Spannung addiert, und an einem Ort ohne das Zielgas stellen Sie ihn so ein, bis die Spannung nach der Kalibrierung ungefähr 0 beträgt.
Ändern Sie vor dem Hochladen in der Zeile, die den Sensor erzeugt, SENSOR_NH3 in SENSOR_CO. SENSOR_NH3 ist das Preset der Bibliothek für die Ammoniak-Zelle. Dieses Board trägt die Kohlenmonoxid-Zelle SGX-4CO, und das Preset der Bibliothek dafür ist SENSOR_CO. Der Offset wird addiert, bevor die Bibliothek mit der Empfindlichkeit und dem Nullpunkt des Presets umrechnet. Stellen Sie ihn daher mit SENSOR_CO ein.
Um die Spannungen beim Einstellen zu sehen, entfernen Sie in der Datei Electrochemical-Gas-Sensor-SOLDERED.h der Bibliothek das Kommentarzeichen vor #define ELECTROCHEMICAL_SENSOR_DEBUG, wie es im Header des Beispiels steht. Jeder Aufruf von getPPM() gibt dann zusätzlich die rohe Spannungsmessung, die Spannung ohne den Referenzwert und die Spannung nach der Kalibrierung aus.
Was dieses Board dafür braucht
Das Beispiel erzeugt den Sensor unter 0x49 mit GPIO 32 als Config-Pin. Bei einer Adresse außerhalb von 0x30 bis 0x37 geht die Bibliothek nicht über die Bridge des Boards: begin() startet den ADS1115 unter dieser Adresse und schreibt die Konfiguration des LMP91000 selbst, über den I2C-Bus des Controllers. Auf diesem Board liegen diese beiden Chips am internen Bus, den die obere Stiftleiste als SDA2 und SCL2 herausführt. Die Qwiic-Connectors und SDA1/SCL1 erreichen nur die ATtiny404-Bridge, und ein I2C-Scan über Qwiic findet nur die Bridge, im Auslieferungszustand unter 0x30.
Verdrahten Sie für dieses Beispiel also die obere Stiftleiste und nicht das Qwiic-Kabel: Verbinden Sie SDA Ihres Controllers mit SDA2, SCL mit SCL2, den 3,3-V-Pin mit 3V3 und GND mit GND. Über Qwiic antwortet nur die Bridge.
Die Bibliothek legt GPIO 32 auf Low, während sie die Konfiguration des Frontends schreibt, und sonst auf High. Der Header des Beispiels verlangt, dass LMPEN mit GND oder einem GPIO-Pin verbunden wird. Auf dem Board liegt LMPEN an der unteren Stiftleiste, ist über 10 kΩ auf GND gezogen und zusätzlich mit dem ATtiny404 verbunden; siehe Hardware-Details.
Die Adresse der Bridge, 0x30 bis 0x37, ist diejenige, die das Beispiel CO-Konzentration auslesen übergibt.
Der Beispielcode
/**
**************************************************
*
* @file calibrateSensor.ino
* @brief See how to calibrate an electrochemical sensor
*
* To successfully run the sketch:
* - Uncomment the #define in the library header file
* - Connect LMPEN pin to GND or a GPIO pin so the breakout can be configured
* - Run the sketch and open serial monitor at 115200 baud!
*
* @authors Robert @ soldered.com
***************************************************/
// Include the required library
#include "Electrochemical-Gas-Sensor-SOLDERED.h"
// This is the custom value we set for the calibration voltage
// This value is added to the voltage read from the ADC
// In an environment with 0 of the target gas, the voltage after calibration should be
// roughly 0, adjust customCalibration to get it to that value.
const double customCalibration = 0.05;
// Create the sensor object with the according type
ElectrochemicalGasSensor sensor(SENSOR_NH3, 0x49, 32);
void setup()
{
Serial.begin(115200); // For debugging
// Initialize the breakout
if (!sensor.begin())
{
// Can't init? Notify the user and go to infinite loop
Serial.println("ERROR: Can't init the sensor! Check connections!");
while (true)
delay(100);
}
//Set the custom calibration value
sensor.setCustomZeroCalibration(customCalibration);
Serial.println("Sensor initialized successfully!");
}
void loop()
{
// Make the reading
double reading = sensor.getPPM();
// This function will also print debug messages if the #define in
// the header file of the library is uncommented
// It will print:
// - The raw voltage measurement
// - Voltage without reference value
// - Voltage after calibration
// These values can help you adjust the internal zero calibration
// Print the reading with 5 digits of precision
Serial.print("Sensor reading: ");
Serial.print(reading, 5);
Serial.println(" PPM");
// Wait a bit before reading again
delay(2500);
}
Die folgenden Zeilen stammen aus einem Lauf dieses Beispiels auf diesem Board, wobei der Controller wie oben beschrieben mit den Pins SDA2, SCL2, 3V3 und GND der Stiftleiste verbunden war.
Erwartetes Ergebnis im Serial Monitor bei 115200 Baud:
Sensor initialized successfully!
Sensor reading: 0.31243 PPM
Sensor reading: 0.31667 PPM
Sensor reading: 0.30131 PPM
Sensor reading: 0.29969 PPM
Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration in ppm mit fünf Nachkommastellen und PPM. Ein Ergebnis unter null wird als 0.00000 ausgegeben.
Schlägt begin() fehl, gibt der Sketch ERROR: Can't init the sensor! Check connections! aus und hält an.
Verwendete Funktionen
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns noneErzeugt das Sensorobjekt. Das Beispiel übergibt ein Preset, die Adresse 0x49 und GPIO 32 als Config-Pin.
ReturnsKonstruktor.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
_t | sensorType | Das Preset der Zelle. Für die SGX-4CO-Zelle dieses Boards verwenden Sie SENSOR_CO (70 nA/ppm, ADC-Bereich 4,096 V, Verstärkung 14 kΩ, 20 % interner Nullpunkt). |
_adcAddr | uint8_t | Die I2C-Adresse. Standard DEFAULT_ADC_ADDR, 0x49. Von 0x30 bis 0x37 spricht die Bibliothek mit der ATtiny404-Bridge des Boards. |
_configPin | int | Ein GPIO, den die Bibliothek auf Low legt, während sie die Konfiguration des Frontends sendet, und sonst auf High. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. Standard -1, keiner. |
bool begin()returns boolStartet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft die Funktion, ob die Bridge antwortet, und sendet ihr die ADC-Verstärkung und die Datenrate aus dem Preset sowie die Konfiguration des Frontends, wobei sie auf jede Antwort bis zu 500 ms wartet. Bei jeder anderen Adresse startet sie den ADC unter dieser Adresse, stellt dessen Verstärkung und seine langsamste Datenrate ein und schreibt dann die Konfiguration des Frontends, während der Config-Pin auf Low gehalten wird.
Returnstrue, wenn jeder Schritt erfolgreich war, sonst false.
void setCustomZeroCalibration(double calibration)returns voidSetzt den Nullpunktkalibrierwert, den der Header der Bibliothek als Spannungspegel bei 0 ppm beschreibt. getPPM() addiert ihn in Volt zur gemessenen Spannung, nachdem der interne Nullpunkt abgezogen wurde und bevor in ppm umgerechnet wird.
ReturnsNichts.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
calibration | double | Der Offset in Volt. Das Beispiel übergibt customCalibration, 0,05. |
double getPPM()returns doubleFührt eine ADC-Wandlung des Ausgangs des Frontends durch, zieht den internen Nullpunkt ab, addiert die Nullpunktkalibrierung und rechnet den Zellenstrom mit der Empfindlichkeit des Presets in ppm um. Ist ELECTROCHEMICAL_SENSOR_DEBUG definiert, gibt sie zusätzlich die drei Spannungen aus.
ReturnsDie Gaskonzentration in ppm. Ein negatives Ergebnis wird als 0 zurückgegeben.
Zusammenfassung
Erzeugen Sie das Objekt mit SENSOR_CO, rufen Sie begin() einmal in setup() auf und prüfen Sie dessen Ergebnis. Rufen Sie dann setCustomZeroCalibration() mit Ihrem Offset auf, bevor Sie mit dem Lesen beginnen. An einem Ort ohne das Zielgas ändern Sie customCalibration und laden erneut hoch, bis die Spannung nach der Kalibrierung ungefähr 0 beträgt, wie der Kommentar des Beispiels sagt.