Zum Hauptinhalt springen

Den Nullpunkt kalibrieren

Was dieses Beispiel zeigt​

Das Beispiel calibrateSensor addiert einen Nullpunkt-Offset zu den Messwerten des Sensors und gibt die Gaskonzentration alle 2,5 Sekunden in Parts per Million (PPM) aus.

Verbinden Sie für dieses Beispiel Ihren Controller mit dem oberen Header und nicht mit einem Qwiic-Connector: SDA des Controllers mit SDA2, SCL mit SCL2, die 3,3-V-Versorgung mit 3V3 und Masse mit GND. Bei dieser Adresse kommuniziert die Bibliothek direkt über SDA2 und SCL2 mit dem ADS1115 und dem LMP91000; die ATtiny404-Bridge des Boards bei 0x30 wird nicht verwendet. Über Qwiic funktioniert nur das Bridge-Beispiel in der Kurzanleitung.

Der Beispielcode​

customCalibration ist eine Spannung, die die Bibliothek zu jedem ADC-Messwert addiert. Wie der Kommentar im Sketch sagt, stellen Sie sie in einer Umgebung ohne das Zielgas so ein, dass die Spannung nach der Kalibrierung ungefähr 0 beträgt. Der Sketch verwendet die Ammoniak-Voreinstellung SENSOR_NH3 und erstellt den Sensor an der Adresse 0x49 mit GPIO 32 als _configPin.

Um die Spannungen während der Einstellung zu sehen, entfernen Sie, wie es der Kopf des Sketches verlangt, das Kommentarzeichen vor #define ELECTROCHEMICAL_SENSOR_DEBUG am Anfang der Datei Electrochemical-Gas-Sensor-SOLDERED.h der Bibliothek. Jeder Aufruf von getPPM() gibt dann zusätzlich die rohe Spannungsmessung, die Spannung ohne Referenzwert und die Spannung nach der Kalibrierung aus.

Verbinden Sie den Pin LMPEN des Boards am Header mit GPIO 32, dem _configPin des Sketches. Auf diesem Board ist LMPEN außerdem mit dem ATtiny404 des Boards verbunden.

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

🔗Vollständiges Beispiel öffnen

examples/calibrateSensor beim Commit c4df54b

→

Öffnen Sie den Serial Monitor mit 115200 Baud. Der Sketch gibt aus:

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

Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration mit fünf Nachkommastellen und PPM. Ist das Debug-Define aktiviert, wird jedem Messwert Electrochemical gas sensor readings: und die drei Spannungszeilen vorangestellt (Raw voltage measurement: , Voltage without reference value: , Voltage after calibration: , jeweils 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 none

Erstellt das Sensorobjekt für ein Board. Die Adresse bestimmt, wie begin() mit ihm kommuniziert: Bei einer Adresse von 0x30 bis 0x37 wird das Protokoll der ATtiny404-Bridge verwendet; bei jeder anderen Adresse kommuniziert es mit einem ADS1115 unter dieser Adresse und selbst mit dem LMP91000. Der Standardwert ist DEFAULT_ADC_ADDR (0x49).

ReturnsKonstruktor.

Parameter

NameTypBeschreibung
_tsensorTypeDie Voreinstellung für Ihre Zelle: SENSOR_CO, SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3, SENSOR_CL2 oder Ihr eigener sensorType.
_adcAddruint8_tDie Adresse, die begin() verwendet. 0x30 bis 0x37 wählt das Bridge-Protokoll; dieses Board antwortet werkseitig bei 0x30 oder unter der Adresse, die sein Schalter einstellt. Jeder andere Wert wird als ADS1115-Adresse verstanden. Standardmäßig 0x49.
_configPinintEin GPIO für die Enable-Leitung des LMP91000. Die Bibliothek hält ihn auf High und zieht ihn nur dann auf Low, während sie selbst die Register des LMP91000 beschreibt; bei einer Adresse von 0x30 bis 0x37 wird er nicht verwendet. Standardmäßig -1 (keiner).
bool begin()returns bool

Startet I2C mit Wire.begin() und wählt das Protokoll anhand der Adresse. Bei 0x30 bis 0x37 prüft es, ob die Bridge antwortet, sendet die ADC-Verstärkung aus der Voreinstellung und lässt die Bridge die Register des LMP91000 beschreiben, wobei jeder Schritt nach 500 ms aufgegeben wird. Bei jeder anderen Adresse prüft es, ob ein ADS1115 unter dieser Adresse antwortet, stellt dessen Verstärkung ein und beschreibt die Register des LMP91000, sobald dieser Bereitschaft meldet; ist _configPin angegeben, zieht es ihn während der Schreibvorgänge auf Low. Rufen Sie es einmal vor dem Lesen auf.

Returnstrue, wenn jeder Schritt erfolgreich war, andernfalls false.

void setCustomZeroCalibration(double calibration)returns void

Legt den Nullpunkt-Offset in Volt fest, den getPPM() zu der Spannung addiert, nachdem der interne Nullpunkt entfernt wurde. Dadurch ändert sich die Kopie der Voreinstellung dieses Sensorobjekts.

ReturnsNichts.

Parameter

NameTypBeschreibung
calibrationdoubleDer Offset in Volt.
double getPPM()returns double

Nimmt einen Messwert von Kanal 0 des ADS1115 auf (bei 0x30 bis 0x37 über die Bridge) und rechnet ihn mit der Voreinstellung in eine Konzentration um: Es entfernt den internen Nullpunkt-Offset, addiert die Nullpunktkalibrierung, teilt durch die Verstärkung des Verstärkers und durch die Empfindlichkeit der Zelle in nA pro PPM. Ein negatives Ergebnis wird als 0 zurückgegeben.

ReturnsDie Gaskonzentration in PPM.

Zusammenfassung​

Erstellen Sie den Sensor und rufen Sie begin() auf. Rufen Sie dann vor dem Lesen setCustomZeroCalibration() mit Ihrem Offset auf. Stellen Sie den Offset in Luft ohne das Zielgas so ein, dass die Spannung nach der Kalibrierung ungefähr 0 beträgt. getPPM() gibt für jedes negative Ergebnis 0 zurück, deshalb zeigen die Debug-Spannungen beim Einstellen mehr als der Messwert.