Zum Hauptinhalt springen

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​

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);
}

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:

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

Erzeugt das Sensorobjekt. Das Beispiel übergibt eine Voreinstellung, die Adresse 0x4B und GPIO 5 als Konfigurationspin.

ReturnsKonstruktor.

Parameter

ParameterTypBeschreibung
_tsensorTypeDie 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).
_adcAddruint8_tDie I2C-Adresse. Standard DEFAULT_ADC_ADDR, 0x49. Von 0x30 bis 0x37 kommuniziert die Bibliothek mit der ATtiny404-Bridge des Boards.
_configPinintEin 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 bool

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

Fü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 double

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