Zum Hauptinhalt springen

Nullpunktkalibrierung

Was dieses Beispiel zeigt​

Das Beispiel calibrateSensor addiert zu jedem Messwert einen festen Spannungsoffset, customCalibration (0.05), und gibt die Messwerte dann alle 2,5 Sekunden in PPM aus. Es erstellt den Sensor mit der Konfiguration SENSOR_NH3, der Adresse 0x49 und dem Pin 32 für LMPEN.

Sie müssen LMPEN bei diesem Board nicht verdrahten, was auch immer die Kommentare im Sketch sagen: Das Board hält den Pin selbst auf Low.

Der Kommentar im Beispiel selbst beschreibt, wie der Offset verwendet wird: Passen Sie customCalibration an, solange keines des Zielgases vorhanden ist, bis der Messwert nach der Kalibrierung ungefähr 0 beträgt.

Um die Spannungen hinter jedem Messwert zu sehen, entfernen Sie in der Datei Electrochemical-Gas-Sensor-SOLDERED.h der Bibliothek die Kommentarzeichen vor //#define ELECTROCHEMICAL_SENSOR_DEBUG. getPPM() gibt dann zusätzlich die Rohspannung, die Spannung ohne den Referenzwert und die Spannung nach der Kalibrierung aus.

Der Beispielcode​

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);
}

Was dieses Board mit dem Sketch in der vorliegenden Form ausgibt, wurde noch nicht gemessen. Beim Test dieses Boards über Qwiic fand ein I2C-Scan nur eine Adresse, 0x30, und mit der MicroPython-Bibliothek schlug begin() für einen Sensor fehl, der mit 0x49 erstellt wurde, der Adresse, die dieser Sketch übergibt. Schlägt begin() fehl, gibt der Sketch ERROR: Can't init the sensor! Check connections! aus und hält an.

Ist begin() erfolgreich, gibt der Sketch Folgendes aus:

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
Sensor initialized successfully!

Danach erscheint alle 2,5 Sekunden eine Zeile Sensor reading: , gefolgt von einem Wert mit fünf Nachkommastellen und PPM.

Verwendete Funktionen​

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

Erstellt das Sensorobjekt mit einer Sensorkonfiguration, einer Adresse und einem LMPEN-Pin. Es wird nichts gesendet, bis Sie begin() aufrufen. begin() wählt anhand der Adresse, wie mit dem Board kommuniziert wird: Von 0x30 bis 0x37 verwendet es die Befehle der ATtiny404-Bridge und ignoriert das dritte Argument; jede andere Adresse wird als eigene Adresse des ADS1115 aufgefasst, und der LMP91000 wird direkt beschrieben.

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
sensorType_tDie Einstellungen für Eingangsstufe und Wandlung, im Beispiel SENSOR_NH3. Die Voreinstellungen befinden sich in src/sensorConfigData.h der Bibliothek.
uint8_t_adcAddrDie Adresse, im Beispiel 0x49.
int_configPinDer GPIO-Pin, der mit LMPEN verbunden ist, im Beispiel 32. Wird für eine Adresse von 0x30 bis 0x37 nicht verwendet.
sensor.begin()returns bool

Startet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft es, ob die Bridge antwortet, sendet ihr die ADC-Verstärkung und die langsamste ADC-Datenrate und anschließend die Einstellungen des LMP91000; jeder Bridge-Befehl wartet bis zu 500 ms. Bei jeder anderen Adresse startet es den ADS1115 unter dieser Adresse mit derselben Verstärkung und Datenrate, setzt den LMPEN-Pin auf High, falls einer angegeben wurde, und schreibt dann die Einstellungen des LMP91000, wobei es diesen Pin währenddessen auf Low hält.

Returnstrue, wenn jeder Schritt erfolgreich war, sonst false.

sensor.setCustomZeroCalibration(double calibration)returns void

Legt den Nullpunkt-Offset in Volt fest, den getPPM() zur gemessenen Spannung addiert. Er ersetzt internalZeroCalibration in der Kopie der Konfiguration des Sensorobjekts.

ReturnsNichts.

Parameter

TypNameBeschreibung
doublecalibrationDer Offset in Volt, im Beispiel customCalibration (0.05).
sensor.getPPM()returns double

Führt eine ADC-Messung durch und wandelt die Spannung in eine Konzentration um: Es subtrahiert den internen Nullpunkt (ein Anteil der 2,5-V-Referenz), addiert den Nullpunkt-Offset, teilt durch die TIA-Verstärkung, um den Zellenstrom zu erhalten, und teilt dann durch die Nanoampere pro PPM der Konfiguration. Ein negatives Ergebnis wird als 0 zurückgegeben. Ist ELECTROCHEMICAL_SENSOR_DEBUG definiert, gibt es außerdem die drei Spannungen aus.

ReturnsDie Konzentration in PPM.

Zusammenfassung​

SENSOR_NH3 ist die Voreinstellung für eine Ammoniakzelle SGX-4NH3-300. Die Bibliothek hat noch keine Voreinstellung für die Sauerstoffzelle SGX-4OX-ROHS dieses Boards, daher wird der Wert, den das Beispiel ausgibt, mit den Einstellungen der Ammoniak-Voreinstellung (NH3) berechnet. Die Seite Benutzerdefinierte Konfiguration zeigt, wie Sie eine eigene schreiben; ihr Feld internalZeroCalibration legt denselben Offset fest, wenn die Konfiguration erstellt wird.