Benutzerdefinierte Adresse
Was dieses Beispiel zeigt
Das Beispiel customAddress der Bibliothek erzeugt den Sensor mit einer anderen als der Standardadresse und gibt die Gaskonzentration alle 2,5 Sekunden in ppm aus. Es verwendet bereits SENSOR_SO2, das Preset der Bibliothek für die SGX-4SO2-Zelle dieses Boards, mit der Adresse 0x4B und GPIO 5 als Enable-Pin.
Die Jumper-Anweisungen in diesem Beispiel gelten nicht für dieses Board: weder der Satz im Header „Set the custom address using the jumpers on the back of the board“ noch die Kommentare oberhalb des Konstruktors (JP5 für 0x49, JP6 für 0x4A, JP7 für 0x4B). Hier verbinden JP5 und JP6 die I2C-Pull-up-Widerstände, es gibt kein JP7, und JP2 bis JP4 bleiben im Auslieferungszustand. Trennen oder schließen Sie wegen dieser Zeilen keinen Jumper: Die Adresse, mit der der Sketch kommuniziert, ist das zweite Argument des Konstruktors. Den Adressschalter und die Jumper dieses Boards beschreibt Hardware-Details.
Auf diesem Board sitzen der LMP91000 und der ADS1115 am eigenen Bus 2 des Boards, und Ihr Controller erreicht sie über die Adresse des Boards am Qwiic-Bus: 0x30 im Auslieferungszustand, 0x30 bis 0x37 mit dem ADDRESS-Schalter. Die 0x4B des Beispiels spricht einen ADS1115 direkt an. Übergeben Sie stattdessen die Adresse des Boards als zweites Argument des Konstruktors, zum Beispiel ElectrochemicalGasSensor sensor(SENSOR_SO2, 0x30);. Wo der Header angibt, LMPEN mit GND oder einem GPIO-Pin zu verbinden, ist LMPEN auf diesem Board bereits durch einen 10-kΩ-Widerstand auf GND gezogen und führt zusätzlich zum Mikrocontroller auf dem Board; bei den Adressen des Boards ignoriert die Bibliothek das Enable-Pin-Argument, hier GPIO 5.
Das Listing ist die Datei der Bibliothek im festgelegten Commit, abgesehen von einigen reinen Kommentarzeilen in ihrem Header, die den Connector unter einem älteren Namen nennen oder auf andere Soldered-Produkte verweisen und weggelassen wurden.
Der Beispielcode
/**
**************************************************
*
* @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:
Sensor initialized successfully!
Nach dieser Zeile folgt alle 2,5 Sekunden eine neue Zeile Sensor reading: mit der Konzentration in ppm auf fünf Nachkommastellen.
Verwendete Funktionen
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns noneErzeugt das Sensorobjekt aus einem Zellen-Preset, einer Adresse und einem optionalen Enable-Pin. Das Beispiel übergibt SENSOR_SO2, die Adresse 0x4B und GPIO 5.
ReturnsKonstruktor.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
_t | sensorType | Das Zellen-Preset. SENSOR_SO2 ist das Preset für die Zelle dieses Boards. |
_adcAddr | uint8_t | Die Adresse, mit der die Bibliothek kommuniziert. 0x30 bis 0x37 ist der Bridge-Bereich, der über den ADDRESS-Schalter des Boards eingestellt wird; jeder andere Wert spricht einen ADS1115 direkt unter dieser Adresse an. Standard 0x49. |
_configPin | int | GPIO für die Enable-Leitung des Frontends. Wird bei den Adressen 0x30 bis 0x37 ignoriert. Standard -1. |
bool begin()returns boolStartet I2C, prüft, ob das Board antwortet, und sendet die ADC- und LMP91000-Einstellungen aus dem Preset an das Board. Rufen Sie sie einmal vor jeder Messung auf.
Returnstrue, wenn das Board geantwortet und alle Einstellungen übernommen hat, sonst false.
double getPPM()returns doubleLässt das Board eine ADC-Messung durchführen und rechnet sie in eine Gaskonzentration um, anhand der 2,5-V-Referenz, der Verstärkung des Frontends und der Empfindlichkeit der Zelle aus dem Preset. Ein Ergebnis unter null wird als 0 zurückgegeben.
ReturnsGaskonzentration in ppm.
double getPPB()returns doubleDieselbe Messung wie getPPM(), in Parts per Billion. Das Beispiel zeigt sie in einem Kommentar als Alternative.
ReturnsGaskonzentration in ppb (getPPM() x 1000).
Zusammenfassung
Die Adresse ist das zweite Argument des Konstruktors und der Enable-Pin das dritte. Jedes Board am selben Bus braucht eine eigene Adresse.