Prilagođena adresa
Što ovaj primjer prikazuje
Primjer customAddress stvara senzor na adresi koja nije zadana, pri čemu konstruktoru prosljeđuje adresu i konfiguracijski pin, a koncentraciju plina u ppm ispisuje svakih 2,5 sekunde. Koristi adresu 0x4B i GPIO 5.
Što je potrebno na ovoj pločici
0x4B je adresa čipa ADS1115, a ne adresa mosta (bridge) na pločici. Na adresi izvan raspona od 0x30 do 0x37 biblioteka ne koristi most na pločici: begin() pokreće ADS1115 na toj adresi i sam zapisuje konfiguraciju čipa LMP91000 preko I2C sabirnice kontrolera, pri čemu je GPIO 5 tijekom zapisivanja držan u niskom stanju. Na ovoj pločici ta su dva čipa na unutarnjoj sabirnici, koju gornji header izvodi kao SDA2 i SCL2. Qwiic konektori i SDA1/SCL1 dolaze samo do mosta ATtiny404, a I2C pretraga preko Qwiic konektora pronalazi samo most, na adresi 0x30 kakva je pri isporuci. LMPEN se nalazi na donjem headeru, preko 10 kΩ povezan je na GND, a spojen je i na ATtiny404.
Zato za ovaj primjer povežite gornji header, a ne Qwiic kabel: spojite SDA svojeg kontrolera na SDA2, njegov SCL na SCL2, njegov pin 3,3 V na 3V3 i njegov GND na GND. Preko Qwiic konektora odgovara samo most.
Komentar u ispisu programa navodi JP5 za 0x49, JP6 za 0x4A i JP7 za 0x4B.
Ti nazivi ne odgovaraju jumperima ove pločice. Ovdje JP5 uključuje pull-up otpornike od 10 kΩ na SDA1/SCL1, JP6 pull-up otpornike od 10 kΩ na unutarnjoj
sabirnici SDA2/SCL2, a JP7 ne postoji: nemojte prerezati JP5 ni JP6 radi postavljanja
adrese. Na ovoj pločici JP2 do JP4 postavljaju adresu čipa ADS1115 na unutarnjoj
sabirnici (JP2 zatvoren za 0x49 kakav je pri isporuci, JP3 za 0x4A, JP4 za 0x4B), a
DIP sklopka s tri prekidača ADDRESS postavlja vlastitu adresu pločice na vašoj sabirnici, od
0x30 do 0x37. Sklopka i jumperi opisani su na stranici
Pojedinosti o hardveru.
Prije prijenosa programa promijenite SENSOR_SO2 u SENSOR_CO u retku
koji stvara senzor. SENSOR_SO2 je predložak biblioteke za ćeliju sumporova
dioksida. Ova pločica nosi ćeliju SGX-4CO za ugljikov monoksid, a predložak
biblioteke za nju je SENSOR_CO.
Kôd primjera
/**
**************************************************
*
* @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);
}
Retci u nastavku potječu iz izvođenja ovog primjera na ovoj pločici, s kontrolerom spojenim na pinove SDA2, SCL2, 3V3 i GND headera, kako je opisano gore.
Očekivani rezultat u Serial Monitoru pri 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
Zatim svakih 2,5 sekunde slijedi redak: Sensor reading: , koncentracija u ppm s pet decimala i PPM. Rezultat manji od nule ispisuje se kao 0.00000.
Ako begin() ne uspije, program ispisuje
ERROR: Can't init the sensor! Check connections! i zaustavlja se.
Korištene funkcije
ElectrochemicalGasSensor(sensorType _t, uint8_t _adcAddr = DEFAULT_ADC_ADDR, int _configPin = -1)returns noneStvara objekt senzora. Primjer prosljeđuje predložak, adresu 0x4B i GPIO 5 kao konfiguracijski pin.
ReturnsKonstruktor.
Parametri
| Parametar | Tip | Opis |
|---|---|---|
_t | sensorType | Predložak ćelije. Za ćeliju SGX-4CO na ovoj pločici koristite SENSOR_CO (70 nA/ppm, raspon ADC-a 4,096 V, pojačanje pojačala 14 kΩ, 20 % unutarnja nula). |
_adcAddr | uint8_t | I2C adresa. Zadano DEFAULT_ADC_ADDR, 0x49. Od 0x30 do 0x37 biblioteka komunicira s mostom ATtiny404 na pločici. |
_configPin | int | GPIO koji biblioteka drži u niskom stanju dok šalje konfiguraciju ulaznog stupnja, a inače u visokom. Ne koristi se na adresi od 0x30 do 0x37. Zadano -1, nijedan. |
bool begin()returns boolPokreće I2C pomoću Wire.begin(). Na adresi od 0x30 do 0x37 provjerava odgovara li most, šalje mu pojačanje ADC-a i brzinu podataka iz predloška te konfiguraciju ulaznog stupnja, čekajući do 500 ms na svaki odgovor. Na bilo kojoj drugoj adresi pokreće ADC na toj adresi, postavlja mu pojačanje i najsporiju brzinu podataka, a zatim zapisuje konfiguraciju ulaznog stupnja dok je konfiguracijski pin u niskom stanju.
Returnstrue ako su svi koraci uspjeli, inače false.
double getPPM()returns doubleObavlja jednu ADC konverziju izlaza ulaznog stupnja, oduzima unutarnju nulu, dodaje kalibraciju nule i pretvara struju ćelije u ppm pomoću osjetljivosti iz predloška.
ReturnsKoncentracija plina u ppm. Negativan rezultat vraća se kao 0.
double getPPB()returns doubleIsto mjerenje kao getPPM(), u dijelovima na milijardu (ppb). Primjer ga prikazuje kao alternativu u komentaru.
ReturnsgetPPM() pomnožen s 1000.
Sve zajedno
Proslijedite adresu kao drugi argument konstruktora, s SENSOR_CO kao predloškom, jednom pozovite begin() u setup() i provjerite njegov rezultat, a zatim pozovite getPPM() kad god želite očitanje. Primjer prosljeđuje 0x4B, adresu čipa ADS1115, s GPIO-om 5 kao konfiguracijskim pinom. Preko mosta na pločici adresa je ona postavljena na njegovoj sklopki ADDRESS, od 0x30 do 0x37 (0x30 pri isporuci), a konfiguracijski pin se ne koristi.