Zum Hauptinhalt springen

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.

Select Board
customAddress.ino
/**
**************************************************
*
* @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):

Serial MonitorAutoscrollShow timestampNewline115200 baud
Message (Enter to send message to the board)
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 ElectrochemicalGasSensor

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

ReturnsDas Sensorobjekt.

Parameter

TypNameBeschreibung
sensorType_tDie Zellen-Voreinstellung, im Beispiel SENSOR_SO2. SENSOR_NO ist die für die Zelle dieses Boards.
uint8_t_adcAddrDie 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_configPinDer 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 bool

Startet 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 double

Nimmt 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 double

Die 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.