Nullpunkt kalibrieren
Was dieses Beispiel zeigt
Das Beispiel calibrateSensor der Bibliothek addiert zu jedem ADC-Messwert einen festen Spannungsoffset, bevor der Wert in ppm umgerechnet wird. Stellen Sie diesen Offset in Luft ohne das Zielgas so ein, dass der Messwert gerade eben 0 beträgt.
Das Beispiel erstellt den Sensor mit dem Zellenpreset für NH3, SENSOR_NH3, an der Adresse 0x49 und mit GPIO 32 als Enable-Pin. SENSOR_SO2 ist das Preset der Bibliothek für die Zelle SGX-4SO2 auf diesem Board: Ändern Sie in der Zeile, die sensor erstellt, SENSOR_NH3 in SENSOR_SO2, um SO2-Werte zu erhalten.
Auf diesem Board sitzen der LMP91000 und der ADS1115 am Bus 2 des Boards, und Ihr Controller erreicht sie über die Adresse des Boards am Qwiic-Bus: 0x30 im Auslieferungszustand, 0x30 bis 0x37 mit dem ADDRESS-Schalter. Die 0x49 aus dem Beispiel spricht direkt einen ADS1115 an. Übergeben Sie stattdessen die Adresse des Boards als zweites Argument des Konstruktors, zum Beispiel ElectrochemicalGasSensor sensor(SENSOR_SO2, 0x30);. Wo im Header steht, dass LMPEN mit GND oder einem GPIO-Pin verbunden werden soll: Auf diesem Board ist LMPEN bereits über einen 10-kΩ-Widerstand auf GND gezogen und führt außerdem zum Mikrocontroller auf dem Board. Bei den Adressen des Boards ignoriert die Bibliothek das Argument für den Enable-Pin, hier GPIO 32 (siehe Hardware-Details).
Das Listing ist die Datei der Bibliothek im angehefteten Commit, abgesehen von einigen reinen Kommentarzeilen in ihrem Header, die den Connector mit einem älteren Namen bezeichnen oder auf andere Soldered-Produkte verweisen und weggelassen wurden.
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 folgt alle 2,5 Sekunden eine Zeile Sensor reading: in ppm. Um die Spannungen hinter jedem Messwert zu sehen, entfernen Sie in der Datei Electrochemical-Gas-Sensor-SOLDERED.h der Bibliothek das // vor #define ELECTROCHEMICAL_SENSOR_DEBUG. Jeder Messwert gibt dann zusätzlich die Rohspannung, die Spannung ohne den Referenzwert und die Spannung nach der Kalibrierung aus.
Verwendete Funktionen
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns noneErstellt das Sensorobjekt aus einem Zellenpreset, einer Adresse und einem optionalen Enable-Pin. Das Beispiel übergibt die Adresse 0x49 und GPIO 32.
ReturnsKonstruktor.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
_t | sensorType | Das Zellenpreset. SENSOR_SO2 ist das Preset für die Zelle dieses Boards. |
_adcAddr | uint8_t | Die Adresse, mit der die Bibliothek kommuniziert. 0x30 bis 0x37 ist der Bridge-Bereich, der durch den ADDRESS-Schalter des Boards festgelegt wird; jeder andere Wert spricht direkt einen ADS1115 unter dieser Adresse an. Standard 0x49. |
_configPin | int | GPIO für die Enable-Leitung des Front-Ends. Wird bei den Adressen 0x30 bis 0x37 ignoriert. Standard -1. |
bool begin()returns boolStartet I2C, prüft, ob das Board antwortet, und sendet die ADC- und LMP91000-Einstellungen aus dem Preset an das Board.
Returnstrue, wenn das Board geantwortet und jede Einstellung übernommen hat, sonst false.
void setCustomZeroCalibration(double calibration)returns voidLegt den Spannungsoffset fest, der vor der Umrechnung in ppm zu jedem Messwert addiert wird. Er ersetzt den eigenen Nullpunkt-Kalibrierwert des Presets, der für SENSOR_SO2 0 beträgt.
ReturnsNichts.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
calibration | double | Der Offset in Volt. |
double getPPM()returns doubleLässt das Board eine ADC-Messung durchführen und rechnet sie in eine Gaskonzentration um, einschließlich des Offsets der Nullpunktkalibrierung. Ein Ergebnis unter null wird als 0 zurückgegeben.
ReturnsGaskonzentration in ppm.
Alles zusammenfügen
Das Beispiel beginnt bei 0,05. Bringen Sie das Board in Luft ohne SO2, beobachten Sie die Debug-Spannungen und setzen Sie customCalibration so, dass die Spannung nach der Kalibrierung ungefähr 0 beträgt. Verwenden Sie denselben Wert mit setCustomZeroCalibration() in Ihrem eigenen Sketch.