Zum Hauptinhalt springen

Den Nullpunkt kalibrieren

Was dieses Beispiel zeigt​

Das Beispiel calibrateSensor addiert mit setCustomZeroCalibration() einen Spannungs-Offset zu jedem Messwert. Die Bibliothek meldet jedes negative Ergebnis als 0. Passen Sie daher an der Luft ohne das Zielgas customCalibration an, bis der Messwert ungefähr 0 beträgt, wie der Kommentar im Sketch beschreibt. Anschließend gibt das Beispiel alle 2,5 Sekunden einen Messwert in ppm aus.

Das Beispiel erzeugt den Sensor mit der Adresse 0x49 und LMPEN an GPIO 32. Bei dieser Adresse kommuniziert die Bibliothek direkt mit dem ADS1115 und dem LMP91000, nicht über die ATtiny404-Bridge des Boards. Wie die Adresse darüber entscheidet, steht in der Bibliotheksübersicht.

Der Kopf des Sketches fordert Sie auf, das #define in der Header-Datei der Bibliothek zu aktivieren. Diese Zeile lautet //#define ELECTROCHEMICAL_SENSOR_DEBUG und steht in Electrochemical-Gas-Sensor-SOLDERED.h. Ist sie definiert, gibt jedes getPPM() zusätzlich die Rohspannung, die Spannung ohne den Referenzwert und die Spannung nach der Kalibrierung aus. Das hilft Ihnen, den Offset zu wählen.

Das Beispiel übergibt SENSOR_NH3, das Preset der Bibliothek für eine Ammoniak-Zelle. Für eine Stickstoffmonoxid-Messung verwenden Sie SENSOR_NO, das Preset für die SGX-4NO-250-Zelle dieses Boards: 400 nA pro ppm, eine Verstärkung von 120 kΩ und eine positive Vorspannung von 12 %.

Der Beispielcode​

Die Auflistung ist die Datei der Bibliothek im festgelegten Commit. Nur Kommentarzeilen wurden weggelassen: die Zeile, die den alten Connector nennt, und die Kopfzeilen, die auf die Shop-Seiten anderer Produkte verweisen.

Select Board
calibrateSensor.ino
/**
**************************************************
*
* @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 mit SENSOR_NO (Messwerte an der Luft ohne NO; Ihre werden abweichen). Der Wert von customCalibration, mit dem diese Messwerte aufgenommen wurden, ist nicht festgehalten, daher können sie von dem abweichen, was das 0.05 der Auflistung ergibt: Sie zeigen die Form der Ausgabe, und Ihre Zahlen hängen vom gewählten Offset ab.

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
Sensor initialized successfully!
Sensor reading: 0.00588 PPM
Sensor reading: 0.00602 PPM
Sensor reading: 0.00608 PPM
Sensor reading: 0.00581 PPM

Alle 2,5 Sekunden erscheint eine Zeile Sensor reading: mit der Konzentration in ppm mit fünf Nachkommastellen und PPM am Ende. Schlägt begin() fehl, gibt der Sketch ERROR: Can't init the sensor! Check connections! aus und bleibt dort stehen.

Verwendete Funktionen​

ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns ElectrochemicalGasSensor

Erzeugt das Sensorobjekt für ein Board. Über I2C wird nichts gesendet, bis Sie begin() aufrufen.

ReturnsDas Sensorobjekt.

Parameter

TypeNameDescription
sensorType_tDas Zellen-Preset, im Beispiel SENSOR_NH3. SENSOR_NO ist das Preset für die Zelle dieses Boards.
uint8_t_adcAddrDie I2C-Adresse, im Beispiel 0x49. Bei einer Adresse von 0x30 bis 0x37 kommuniziert die Bibliothek mit der ATtiny404-Bridge des Boards; bei jeder anderen kommuniziert sie mit dem ADS1115 unter dieser Adresse und direkt mit dem LMP91000.
int_configPinDer GPIO, der mit LMPEN verbunden ist, im Beispiel 32. Die Bibliothek hält ihn nur während der Konfiguration des LMP91000 auf Low. Wird bei den Adressen 0x30 bis 0x37 ignoriert.
sensor.begin()returns bool

Startet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft sie, ob die Bridge des Boards antwortet, und sendet die ADC- und Frontend-Einstellungen darüber, wobei sie bei jedem Schritt bis zu 500 ms wartet. Bei jeder anderen Adresse startet sie den ADS1115 unter dieser Adresse mit der Verstärkung des Presets und der niedrigsten Datenrate und konfiguriert dann den LMP91000 (Verstärkung, Last, Referenz, interner Nullpunkt, Vorspannung und Modus). Ist ein GPIO _configPin angegeben, hält sie ihn dabei auf Low.

Returnstrue, wenn alle Schritte erfolgreich waren, sonst false.

sensor.setCustomZeroCalibration(double calibration)returns void

Legt die Nullpunktkalibrierung für das Preset dieses Sensors fest: eine Spannung, die getPPM() vor der Umrechnung zu jedem Messwert addiert.

ReturnsNichts.

Parameter

TypeNameDescription
doublecalibrationDer Offset in Volt, im Beispiel customCalibration (0,05).
sensor.getPPM()returns double

Nimmt einen ADC-Messwert auf und rechnet ihn um: Sie subtrahiert den internen Nullpunkt (2,5 V mal dem Prozentwert des internen Nullpunkts im Preset), addiert die Nullpunktkalibrierung, teilt durch die Verstärkung, um den Zellenstrom zu erhalten, und teilt diesen durch die nA pro ppm des Presets. 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​

begin() konfiguriert das Frontend einmalig, dann legt setCustomZeroCalibration() den Offset vor dem ersten Messwert fest. Ändern Sie customCalibration, laden Sie den Sketch erneut an der Luft ohne das Zielgas hoch und wiederholen Sie das, bis die Messwerte knapp bei 0 liegen.