Eine eigene Adresse verwenden
Was dieses Beispiel zeigt
Das Beispiel customAddress erstellt den Sensor unter einer anderen Adresse als der Standardadresse der Bibliothek und gibt die Gaskonzentration in Teilen pro Million (PPM) alle 2,5 Sekunden aus.
Verbinden Sie Ihren Controller für dieses Beispiel mit der oberen Pfostenleiste 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 unter 0x30
wird nicht verwendet. Über
Qwiic funktioniert nur das Bridge-Beispiel in der
Schnellstart
.
Der Beispielcode
Der Sketch verwendet die Voreinstellung für Schwefeldioxid, SENSOR_SO2, und erstellt den
Sensor unter der Adresse 0x4B mit GPIO 5 als _configPin, dem „GPIO pin for
LMPEN“ des Sketches. Verbinden Sie den Pin LMPEN des Boards an der Pfostenleiste mit diesem GPIO. Auf diesem
Board führt LMPEN außerdem zum ATtiny404 des Boards.
Die Jumper-Namen im Kommentar des Sketches (JP5, JP6, JP7) sind nicht die Adress-Jumper dieses Boards. Auf diesem Board verbinden JP5 und JP6 die I2C-Pull-ups, und die Adresse des ADS1115 wird mit JP2 bis JP4 eingestellt. JP2 ist im Auslieferungszustand geschlossen (0x49).
Öffnen Sie JP2, bevor Sie JP3 (0x4A) oder JP4 (0x4B) schließen, und schließen Sie nur einen
davon: Wenn Sie JP3 oder JP4 schließen, während JP2 noch geschlossen ist, wird SDA2 oder SCL2 mit 3V3 verbunden
und der Bus bleibt stehen. Für die 0x4B dieses Sketches öffnen Sie JP2 und schließen JP4.
Hardware-Details
listet alle Jumper und die zu vermeidenden Kombinationen auf.
/**
**************************************************
*
* @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);
}
🔗Vollständiges Beispiel öffnen
examples/customAddress im Commit c4df54b
Öffnen Sie den Serial Monitor mit 115200 Baud. Der Sketch gibt aus:
Sensor initialized successfully!
Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration mit fünf
Nachkommastellen und PPM. 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 noneErstellt 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 kommuniziert es mit einem ADS1115 unter dieser Adresse und selbst mit dem LMP91000. Standard ist DEFAULT_ADC_ADDR (0x49).
ReturnsKonstruktor.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
_t | sensorType | Die 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. |
_adcAddr | uint8_t | Die Adresse, die begin() verwendet; hier 0x4B. 0x30 bis 0x37 wählt das Bridge-Protokoll; dieses Board antwortet werkseitig unter 0x30 oder unter der Adresse, die sein Schalter einstellt. Jeder andere Wert wird als ADS1115-Adresse aufgefasst. Standardmäßig 0x49. |
_configPin | int | Ein GPIO für die Enable-Leitung des LMP91000; hier 5. 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 boolStartet 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 schreiben, wobei jeder Schritt nach 500 ms aufgibt. Bei jeder anderen Adresse prüft es, ob ein ADS1115 unter dieser Adresse antwortet, stellt dessen Verstärkung ein und schreibt die Register des LMP91000, sobald dieser Bereitschaft meldet; ist _configPin angegeben, wird er während des Schreibens auf Low gezogen. Rufen Sie es einmal vor dem Lesen auf.
Returnstrue, wenn jeder Schritt erfolgreich war, sonst false.
double getPPM()returns doubleNimmt 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 Nullpunktversatz, addiert die Nullpunktkalibrierung und teilt durch die Verstärkung des Verstärkers sowie durch die Empfindlichkeit der Zelle in nA pro PPM. Ein negatives Ergebnis wird als 0 zurückgegeben.
ReturnsDie Gaskonzentration in PPM.
double getPPB()returns doubleDerselbe Messwert wie bei getPPM(), in Teilen pro Milliarde. Das Beispiel zeigt ihn als auskommentierte Alternative.
ReturnsDie Gaskonzentration in PPB, getPPM() x 1000.
Alles zusammenfügen
Übergeben Sie die Adresse und, falls Sie einen verwenden, den GPIO für die Enable-Leitung als
zweites und drittes Argument von ElectrochemicalGasSensor. Rufen Sie dann begin()
einmal auf und lesen Sie mit getPPM() oder getPPB().