Den Nullpunkt kalibrieren
Was dieses Beispiel zeigt
Das Beispiel calibrateSensor der Bibliothek addiert Ihren eigenen Offset zur vom Sensor gemessenen Spannung und gibt dann alle 2,5 Sekunden die Gaskonzentration in ppm aus.
customCalibration am Anfang ist dieser Offset in Volt; das Beispiel setzt ihn auf 0.05. Wie der Kommentar im Beispiel sagt, sollte die Spannung nach der Kalibrierung in Luft ohne das Zielgas ungefähr 0 betragen. Passen Sie customCalibration daher so lange an, bis dies der Fall ist.
Um diese Spannung zu sehen, entfernen Sie in Electrochemical-Gas-Sensor-SOLDERED.h der Bibliothek das Kommentarzeichen vor #define ELECTROCHEMICAL_SENSOR_DEBUG, wie es der Kopfkommentar des Beispiels verlangt.
Jeder Aufruf von getPPM() gibt dann zusätzlich die Rohspannung, die Spannung ohne den Referenzwert und die Spannung nach der Kalibrierung aus.
Das Beispiel erstellt den Sensor mit der Ammoniak-Voreinstellung SENSOR_NH3 an der Adresse 0x49, mit LMPEN an GPIO 32. SENSOR_NO2 ist die Voreinstellung der Bibliothek für die SGX-4NO2-Zelle dieses Boards; ändern Sie sie in der Zeile, die den Sensor erstellt.
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);
}
Erwartetes Ergebnis:
Sensor initialized successfully!
Danach gibt der Sketch alle 2,5 Sekunden eine Zeile aus, die mit Sensor reading: beginnt, gefolgt von der Konzentration in ppm mit fünf Nachkommastellen.
Ist das Debug-#define aktiviert, stehen vor jedem Messwert
die Zeilen Electrochemical gas sensor readings:, Raw voltage measurement:,
Voltage without reference value: und Voltage after calibration:, jeweils mit der Spannung in Volt mit zehn Nachkommastellen. 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 ElectrochemicalGasSensorErstellt das Sensorobjekt. Es wird nichts an das Board gesendet, bis Sie begin() aufrufen. Die Adresse bestimmt, wie begin() mit dem Board kommuniziert: Von 0x30 bis 0x37 sendet es seine Befehle an den ATtiny404, und von 0x48 bis 0x4B (DEFAULT_ADC_ADDR ist 0x49) spricht es den ADS1115 und den LMP91000 an dieser Adresse direkt an.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
sensorType | _t | Die Voreinstellung der Zelle. SENSOR_NO2 ist die Voreinstellung für die SGX-4NO2-Zelle dieses Boards; das Beispiel übergibt SENSOR_NH3. |
uint8_t | _adcAddr | Die Adresse, mit der begin() kommuniziert, standardmäßig 0x49; das Beispiel übergibt 0x49. |
int | _configPin | GPIO für den Enable-Pin des LMP91000 (LMPEN), nur bei 0x48 bis 0x4B verwendet. Standardmäßig -1 (keiner); das Beispiel übergibt 32. |
sensor.begin()returns boolStartet Wire und schreibt die Voreinstellung auf das Board. Von 0x30 bis 0x37 prüft es, ob der ATtiny404 antwortet, und sendet ihm dann die ADC-Verstärkung, die Datenrate und die LMP91000-Konfiguration, wobei jeder Schritt bis zu 500 ms auf die Antwort wartet. Von 0x48 bis 0x4B startet es den ADS1115 an dieser Adresse, stellt die Verstärkung der Voreinstellung und die langsamste Datenrate ein und schreibt die LMP91000-Konfiguration; dabei zieht es _configPin auf Low, sofern einer angegeben ist. Rufen Sie es einmal in setup() auf.
Returnstrue, wenn alle Schritte erfolgreich waren, sonst false.
sensor.setCustomZeroCalibration(double calibration)returns voidLegt den Kalibrierungs-Offset fest, den getPPM() zur gemessenen Spannung addiert, bevor es sie in eine Konzentration umrechnet. Er ersetzt den Wert internalZeroCalibration in der Kopie der Voreinstellung des Sensors.
ReturnsNichts.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
double | calibration | Der Offset in Volt. Das Beispiel übergibt customCalibration (0.05). |
sensor.getPPM()returns doubleNimmt eine neue ADC-Messung vor und rechnet sie in eine Gaskonzentration um: die Spannung minus den internen Nullpunkt, plus den Kalibrierungs-Offset, geteilt durch die TIA-Verstärkung und durch die Empfindlichkeit der Zelle in der Voreinstellung. Ein negatives Ergebnis wird als 0 zurückgegeben. Ist ELECTROCHEMICAL_SENSOR_DEBUG definiert, gibt es außerdem die Spannungen aus, mit denen es arbeitet.
ReturnsDie Gaskonzentration in ppm.
Zusammenspiel
Der Sketch ruft begin() auf und bleibt in einer Schleife hängen, wenn das fehlschlägt. Dann setzt er den Offset mit setCustomZeroCalibration() vor der ersten Messung, sodass jeder ausgegebene Wert ihn bereits enthält. In loop() liest jeder Aufruf von getPPM() die Zelle erneut aus, und der Sketch gibt den Wert mit fünf Nachkommastellen aus und wartet 2,5 Sekunden.