Benutzerdefinierte Adresse
Was dieses Beispiel zeigt
Das Beispiel customAddress erzeugt den Sensor mit einer anderen als der
Standardadresse, übergibt dem Konstruktor die Adresse und einen Konfigurationspin und gibt
alle 2,5 Sekunden die Gaskonzentration in ppm aus. Es verwendet die Adresse 0x4B und
GPIO 5.
Was es auf diesem Board braucht
0x4B ist eine ADS1115-Adresse, nicht die Bridge-Adresse des Boards. Bei einer Adresse
außerhalb von 0x30 bis 0x37 läuft die Bibliothek nicht über die Bridge des Boards:
begin() startet den ADS1115 unter dieser Adresse und schreibt die Konfiguration des LMP91000
selbst, über den I2C-Bus des Controllers, während GPIO 5 auf Low gehalten wird.
Auf diesem Board liegen diese beiden Chips am internen Bus, den die obere
Header-Leiste als SDA2 und SCL2 herausführt. Die Qwiic-Connectors und
SDA1/SCL1 erreichen nur die ATtiny404-Bridge, und ein I2C-Scan über Qwiic findet
nur die Bridge, im Auslieferungszustand unter 0x30. LMPEN liegt an der unteren Header-Leiste, ist über 10 kΩ
auf GND gezogen und zusätzlich mit dem ATtiny404 verbunden.
Verdrahten Sie für dieses Beispiel also die obere Header-Leiste und nicht das Qwiic-Kabel: Verbinden Sie
die SDA-Leitung Ihres Controllers mit SDA2, die SCL-Leitung mit SCL2, den 3,3-V-Pin mit 3V3 und GND mit GND. Über Qwiic antwortet nur die Bridge.
Der Kommentar im Listing nennt JP5 für 0x49, JP6 für 0x4A und JP7 für 0x4B.
Diese Bezeichnungen passen nicht zu den Jumpern dieses Boards. Hier legt JP5 die 10-kΩ-Pull-ups
an SDA1/SCL1 fest, JP6 die 10-kΩ-Pull-ups am internen
Bus SDA2/SCL2, und es gibt kein JP7: Trennen Sie JP5 oder JP6 nicht auf, um eine
Adresse einzustellen. Auf diesem Board legen JP2 bis JP4 die Adresse des ADS1115 am internen
Bus fest (JP2 geschlossen für 0x49 im Auslieferungszustand, JP3 für 0x4A, JP4 für 0x4B), und der
dreipolige DIP-Schalter ADDRESS legt die eigene Adresse des Boards an Ihrem Bus fest, von
0x30 bis 0x37. Der Schalter und die Jumper sind unter
Hardware-Details beschrieben.
Ändern Sie vor dem Hochladen in der Zeile, die den Sensor erzeugt, SENSOR_SO2 in SENSOR_CO.
SENSOR_SO2 ist die Voreinstellung der Bibliothek für die Schwefeldioxid-Zelle.
Dieses Board trägt die Kohlenmonoxid-Zelle SGX-4CO, und die
Voreinstellung der Bibliothek dafür ist SENSOR_CO.
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);
}
Die folgenden Zeilen stammen aus einem Lauf dieses Beispiels auf diesem Board, wobei der
Controller wie oben beschrieben mit den Pins SDA2, SCL2, 3V3 und GND der Header-Leiste verbunden war.
Erwartetes Ergebnis im Serial Monitor bei 115200 Baud:
Sensor initialized successfully!
Sensor reading: 0.29917 PPM
Sensor reading: 0.31240 PPM
Sensor reading: 0.29335 PPM
Sensor reading: 0.32002 PPM
Danach folgt alle 2,5 Sekunden eine Zeile: Sensor reading: , die Konzentration in ppm
mit fünf Nachkommastellen und PPM. Ein Ergebnis unter null wird als 0.00000 ausgegeben.
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 noneErzeugt das Sensorobjekt. Das Beispiel übergibt eine Voreinstellung, die Adresse 0x4B und GPIO 5 als Konfigurationspin.
ReturnsKonstruktor.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
_t | sensorType | Die Voreinstellung der Zelle. Verwenden Sie für die SGX-4CO-Zelle dieses Boards SENSOR_CO (70 nA/ppm, ADC-Bereich 4,096 V, 14 kΩ Verstärkung, 20 % interner Nullpunkt). |
_adcAddr | uint8_t | Die I2C-Adresse. Standard DEFAULT_ADC_ADDR, 0x49. Von 0x30 bis 0x37 kommuniziert die Bibliothek mit der ATtiny404-Bridge des Boards. |
_configPin | int | Ein GPIO, den die Bibliothek auf Low zieht, während sie die Konfiguration des Frontends sendet, und sonst auf High hält. Wird bei einer Adresse von 0x30 bis 0x37 nicht verwendet. Standard -1, keiner. |
bool begin()returns boolStartet I2C mit Wire.begin(). Bei einer Adresse von 0x30 bis 0x37 prüft sie, ob die Bridge antwortet, und sendet ihr die ADC-Verstärkung und die Datenrate aus der Voreinstellung sowie die Konfiguration des Frontends, wobei sie auf jede Antwort bis zu 500 ms wartet. Bei jeder anderen Adresse startet sie den ADC unter dieser Adresse, stellt dessen Verstärkung und seine langsamste Datenrate ein und schreibt dann die Konfiguration des Frontends, während der Konfigurationspin auf Low gehalten wird.
Returnstrue, wenn jeder Schritt erfolgreich war, sonst false.
double getPPM()returns doubleFührt eine ADC-Wandlung des Frontend-Ausgangs durch, zieht den internen Nullpunkt ab, addiert die Nullpunktkalibrierung und rechnet den Zellenstrom mit der Empfindlichkeit der Voreinstellung in ppm um.
ReturnsDie Gaskonzentration in ppm. Ein negatives Ergebnis wird als 0 zurückgegeben.
double getPPB()returns doubleDieselbe Messung wie getPPM(), in Parts per Billion. Das Beispiel zeigt sie als auskommentierte Alternative.
ReturnsgetPPM() multipliziert mit 1000.
Zusammenfassung
Übergeben Sie die Adresse als zweites Argument des Konstruktors und als
Voreinstellung SENSOR_CO, rufen Sie begin() einmal in setup() auf und prüfen Sie das Ergebnis, rufen Sie dann
getPPM() auf, wann immer Sie einen Messwert möchten. Das Beispiel übergibt 0x4B, eine ADS1115-Adresse,
mit GPIO 5 als Konfigurationspin. Über die Bridge des Boards ist die Adresse
die am ADDRESS-Schalter eingestellte, von 0x30 bis 0x37 (im Auslieferungszustand 0x30), und der
Konfigurationspin wird nicht verwendet.