Einen Sensor mit einer anderen Adresse starten
Was dieses Beispiel zeigt
Das Beispiel customAddress erstellt den Sensor mit einer Adresse Ihrer Wahl
anstelle der Standardadresse der Bibliothek und gibt dann alle 2,5 Sekunden einen Messwert in ppm aus. Es übergibt die ADC-Adresse 0x4B und LMPEN an GPIO 5. Bei dieser Adresse
kommuniziert die Bibliothek direkt mit dem ADS1115 und dem LMP91000, nicht über die
ATtiny404-Brücke des Boards. Wie die Adresse dies bestimmt, steht in der
Übersicht der Bibliothek.
Der Kommentar im Sketch nennt die Jumper JP5, JP6 und JP7 für die Adressen. Auf
diesem Board wird die ADS1115-Adresse durch JP2 (0x49, ab Werk geschlossen), JP3
(0x4A) und JP4 (0x4B) festgelegt, und JP5 ist der Pull-up-Jumper für SDA1/SCL1. Um
0x4B einzustellen, wie es das Beispiel tut, trennen Sie JP2 auf und überbrücken Sie dann JP4. Für 0x4A trennen Sie JP2 auf und
überbrücken JP3. Lassen Sie genau einen der Jumper JP2, JP3 und JP4 geschlossen. Die Jumper-Tabelle und die Kombinationen, die Sie vermeiden sollten, finden Sie unter
Hardware-Details.
Das Beispiel übergibt SENSOR_SO2, die Voreinstellung der Bibliothek für eine Schwefeldioxid-Zelle. Für eine Stickstoffmonoxid-Messung verwenden Sie SENSOR_NO, die Voreinstellung für die SGX-4NO-250-Zelle dieses Boards: 400 nA pro ppm, 120 kΩ Verstärkung und eine positive Bias-Spannung von 12 %.
Der Beispielcode
Die Auflistung ist die Datei der Bibliothek beim fixierten Commit. Nur Kommentarzeilen sind weggelassen: die Zeile, die den alten Connector nennt, und die Kopfzeilen, die auf die Shopseiten anderer Produkte verweisen.
/**
**************************************************
*
* @file customAddress.ino
* @brief See how to init a sensor on a custom address
*
* To successfully run the sketch:
* - Set the custom address using the jumpers on the back of the board
* - 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"
// Create the sensor object with the according type
// To set a custom address, connect one of the following jumpers:
// JP5 for 0x49
// JP6 for 0x4A
// JP7 for 0x4B
// The final parameter is the GPIO pin for LMPEN
ElectrochemicalGasSensor sensor(SENSOR_SO2, 0x4B, 5);
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!");
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 mit SENSOR_NO (Messwerte in sauberer Luft; Ihre weichen ab):
Sensor initialized successfully!
Sensor reading: 0.00629 PPM
Sensor reading: 0.00597 PPM
Sensor reading: 0.00626 PPM
Sensor reading: 0.00610 PPM
Alle 2,5 Sekunden erscheint eine Zeile Sensor reading: mit
der Konzentration in ppm auf fünf Nachkommastellen und PPM am Ende. Schlägt begin() fehl,
gibt der Sketch ERROR: Can't init the sensor! Check connections! aus
und hält dort an.
Verwendete Funktionen
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns ElectrochemicalGasSensorErstellt das Sensorobjekt für ein Board. Über I2C wird nichts gesendet, bis Sie begin() aufrufen.
ReturnsDas Sensorobjekt.
Parameter
| Typ | Name | Beschreibung |
|---|---|---|
sensorType | _t | Die Zellen-Voreinstellung, im Beispiel SENSOR_SO2. SENSOR_NO ist die für die Zelle dieses Boards. |
uint8_t | _adcAddr | Die I2C-Adresse, im Beispiel 0x4B. Bei einer Adresse von 0x30 bis 0x37 kommuniziert die Bibliothek mit der ATtiny404-Brücke des Boards; bei jeder anderen kommuniziert sie mit dem ADS1115 unter dieser Adresse und direkt mit dem LMP91000. |
int | _configPin | Der GPIO, der mit LMPEN verbunden ist, im Beispiel 5. Die Bibliothek hält ihn nur während der Konfiguration des LMP91000 auf Low. Bei den Adressen 0x30 bis 0x37 wird er ignoriert. |
sensor.begin()returns boolStartet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft es, ob die Brücke des Boards antwortet, und sendet die ADC- und Front-End-Einstellungen darüber, wobei es bei jedem Schritt bis zu 500 ms wartet. Bei jeder anderen Adresse startet es den ADS1115 unter dieser Adresse mit der Verstärkung der Voreinstellung und der langsamsten Datenrate und konfiguriert dann den LMP91000 (Verstärkung, Last, Referenz, interne Null, Bias und Modus). Dabei hält es den GPIO _configPin auf Low, sofern einer angegeben ist.
Returnstrue, wenn alle Schritte erfolgreich waren, sonst false.
sensor.getPPM()returns doubleNimmt einen ADC-Messwert auf und rechnet ihn um: Es subtrahiert die interne Null (2,5 V mal den Prozentwert der internen Null der Voreinstellung), addiert die Nullpunktkalibrierung, teilt durch die Verstärkung, um den Zellenstrom zu erhalten, und teilt diesen durch die nA pro ppm der Voreinstellung.
ReturnsDie Gaskonzentration in ppm. Ein negatives Ergebnis wird als 0 zurückgegeben.
sensor.getPPB()returns doubleDie Alternative, die der Kommentar im Sketch anbietet: Nimmt denselben Messwert wie getPPM() auf und multipliziert ihn mit 1000.
ReturnsDie Gaskonzentration in ppb.
Zusammenfassung
Die Adresse und der LMPEN-GPIO werden dem Konstruktor übergeben, und begin() verwendet
sie, wenn es den Sensor startet. Der Rest entspricht einer einzelnen Messung:
getPPM() in loop(), ausgegeben mit fünf Nachkommastellen alle 2,5 Sekunden.