Zum Hauptinhalt springen

Gaskonzentration auslesen

Was dieses Beispiel zeigt​

Das Beispiel bridgeBoard startet das Board mit seiner Standardadresse 0x30, richtet das analoge Frontend für eine Gaszelle ein und gibt die Gaskonzentration alle 2,5 Sekunden in Parts per Million (PPM) aus.

Hinter der Adresse 0x30 sitzt der ATtiny404 des Boards. Er konfiguriert den LMP91000 und liest den ADS1115 über den internen Bus des Boards aus, sodass Ihr Sketch immer nur mit einem I2C-Gerät kommuniziert.

Der Beispielcode​

Der Sketch verwendet die Voreinstellung für Kohlenmonoxid, SENSOR_CO. Ändern Sie sie auf die Voreinstellung für Ihre Zelle: SENSOR_NO2, SENSOR_SO2, SENSOR_O3, SENSOR_NO, SENSOR_H2S, SENSOR_NH3 oder SENSOR_CL2. Die Kommentare im Sketch nennen die Adresseinstellung „Jumper auf der Rückseite des Boards“; auf diesem Board ist es der ADDRESS-Schalter auf der Oberseite. Wenn Sie eine andere Adresse einstellen, ändern Sie 0x30 entsprechend. Die Kommentare besagen außerdem, dass LMPEN mit GND verbunden ist; auf diesem Board führt es zur Stiftleiste und zum ATtiny404, und die Library steuert es nicht an. Der Kommentar, der „legacy boards with 0x49/0x4A/0x4B“ erwähnt, meint Boards, die unter diesen Adressen angesprochen werden, wobei die Library direkt mit einem ADS1115 statt mit der Bridge kommuniziert. Dieses Board antwortet auf den Adressen 0x30 bis 0x37.

Select Board
bridgeBoard.ino
/**
**************************************************
*
* @file bridgeBoard.ino
* @brief See how to init a sensor on the new ATtiny404 bridge board revision,
*
* To successfully run the sketch:
* - Set the desired address using the jumpers on the back of the board
* (address = 0x30 + jumper offset, giving a range of 0x30-0x37)
* - Run the sketch and open serial monitor at 115200 baud!
*
* Note: on this board revision, LMPEN is hardwired to GND, so there's
* no configPin argument to pass - the constructor's third argument
* is ignored whenever the address falls in the bridge range (0x30-0x37).
*
*
* @authors @ soldered.com
***************************************************/

// Include the required library
#include "Electrochemical-Gas-Sensor-SOLDERED.h"

// Any additional boards on the same bus just need a different jumper setting
// (0x30-0x37), same as twoSensors.ino does for legacy boards with 0x49/0x4A/0x4B.
ElectrochemicalGasSensor sensor(SENSOR_CO, 0x30);

void setup()
{
Serial.begin(115200); // For debugging

// Init 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 and jumper address!");
while (true)
delay(100);
}

Serial.println("Sensor initialized successfully!");
}

void loop()
{
// Make the reading
double reading = sensor.getPPM();

// If PPB is more relevant for your sensor, you can use:
// double reading = sensor.getPPB();

// 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 im Serial Monitor bei 115200 Baud:

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. Wenn das Board nicht antwortet, gibt der Sketch ERROR: Can't init the sensor! Check connections and jumper address! 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 verwendet es das Protokoll der ATtiny404-Bridge; bei jeder anderen Adresse spricht es unter dieser Adresse einen ADS1115 und selbst den LMP91000 an. 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 ab Werk auf 0x30 oder auf die Adresse, die sein Schalter einstellt. Das Beispiel übergibt 0x30.
_configPinintEin GPIO für die Enable-Leitung des LMP91000. Die Library 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(), prüft, ob die Bridge antwortet, sendet die ADC-Verstärkung aus der Voreinstellung und konfiguriert den LMP91000 mit Verstärkung, Last, Referenz, Bias und Modus der Voreinstellung. Rufen Sie die Funktion einmal vor dem Auslesen auf.

Returnstrue, wenn die Bridge geantwortet hat und beide Konfigurationen erfolgreich waren, andernfalls false. Jeder Schritt gibt nach 500 ms ohne Antwort auf.

double getPPM()returns double

Führt über die Bridge eine ADC-Messung durch und rechnet sie mit der Voreinstellung in eine Konzentration um: Sie entfernt den internen Nullpunkt-Offset, addiert die Nullpunktkalibrierung und dividiert 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.

double getPPB()returns double

Dieselbe Messung wie getPPM(), in Parts per Billion. Das Beispiel zeigt sie als auskommentierte Alternative zu getPPM().

ReturnsDie Gaskonzentration in PPB, getPPM() x 1000.

Zusammenfassung​

Erstellen Sie pro Board ein ElectrochemicalGasSensor mit der Voreinstellung für die jeweilige Zelle und der zugehörigen Adresse. Rufen Sie begin() einmal in setup() auf und brechen Sie ab, wenn es false zurückgibt. Rufen Sie danach getPPM() oder getPPB() so oft auf, wie Sie einen Messwert benötigen.

Um mehrere Boards am selben Bus zu betreiben, geben Sie jedem mit dem Adressschalter eine eigene Adresse (0x30 bis 0x37) und erstellen Sie ein Objekt pro Adresse.