mirror of https://github.com/arendst/Tasmota.git
236 lines
8.4 KiB
C++
236 lines
8.4 KiB
C++
/*
|
|
xsns_10_bh1750.ino - BH1750 ambient light sensor support for Tasmota
|
|
|
|
Copyright (C) 2021 Theo Arends
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifdef USE_I2C
|
|
#ifdef USE_BH1750
|
|
/*********************************************************************************************\
|
|
* BH1750 - Ambient Light Intensity
|
|
*
|
|
* Bh1750Resolution1 0..2 - Set BH1750 1 resolution mode
|
|
* Bh1750Resolution2 0..2 - Set BH1750 2 resolution mode
|
|
* Bh1750MTime1 30..255 - Set BH1750 1 MT register
|
|
* Bh1750MTime2 30..255 - Set BH1750 2 MT register
|
|
*
|
|
* I2C Address: 0x23 or 0x5C
|
|
\*********************************************************************************************/
|
|
|
|
#define XSNS_10 10
|
|
#define XI2C_11 11 // See I2CDEVICES.md
|
|
|
|
#define BH1750_ADDR1 0x23
|
|
#define BH1750_ADDR2 0x5C
|
|
|
|
#define BH1750_CONTINUOUS_HIGH_RES_MODE2 0x11 // Start measurement at 0.5 lx resolution. Measurement time is approx 120ms.
|
|
#define BH1750_CONTINUOUS_HIGH_RES_MODE 0x10 // Start measurement at 1 lx resolution. Measurement time is approx 120ms.
|
|
#define BH1750_CONTINUOUS_LOW_RES_MODE 0x13 // Start measurement at 4 lx resolution. Measurement time is approx 16ms.
|
|
|
|
#define BH1750_MEASUREMENT_TIME_HIGH 0x40 // Measurement Time register high 3 bits
|
|
#define BH1750_MEASUREMENT_TIME_LOW 0x60 // Measurement Time register low 5 bits
|
|
|
|
#define D_PRFX_BH1750 "Bh1750"
|
|
#define D_CMND_RESOLUTION "Resolution"
|
|
#define D_CMND_MTREG "MTime"
|
|
|
|
const char kBh1750Commands[] PROGMEM = D_PRFX_BH1750 "|" // Prefix
|
|
D_CMND_RESOLUTION "|" D_CMND_MTREG ;
|
|
|
|
void (* const Bh1750Command[])(void) PROGMEM = {
|
|
&CmndBh1750Resolution, &CmndBh1750MTime };
|
|
|
|
struct {
|
|
uint8_t addresses[2] = { BH1750_ADDR1, BH1750_ADDR2 };
|
|
uint8_t resolution[3] = { BH1750_CONTINUOUS_HIGH_RES_MODE, BH1750_CONTINUOUS_HIGH_RES_MODE2, BH1750_CONTINUOUS_LOW_RES_MODE };
|
|
uint8_t count = 0;
|
|
char types[7] = "BH1750";
|
|
} Bh1750;
|
|
|
|
struct {
|
|
uint8_t address;
|
|
uint8_t bus;
|
|
uint8_t valid = 0;
|
|
uint8_t mtreg = 69; // Default Measurement Time
|
|
uint16_t illuminance = 0;
|
|
} Bh1750_sensors[2];
|
|
|
|
/*********************************************************************************************/
|
|
|
|
uint8_t Bh1750Resolution(uint32_t sensor_index) {
|
|
uint8_t settings_resolution = Settings->SensorBits1.bh1750_1_resolution;
|
|
if (1 == sensor_index) {
|
|
settings_resolution = Settings->SensorBits1.bh1750_2_resolution;
|
|
}
|
|
return settings_resolution;
|
|
}
|
|
|
|
bool Bh1750SetResolution(uint32_t sensor_index) {
|
|
TwoWire& myWire = I2cGetWire(Bh1750_sensors[sensor_index].bus);
|
|
myWire.beginTransmission(Bh1750_sensors[sensor_index].address);
|
|
myWire.write(Bh1750.resolution[Bh1750Resolution(sensor_index)]);
|
|
return (!myWire.endTransmission());
|
|
}
|
|
|
|
bool Bh1750SetMTreg(uint32_t sensor_index) {
|
|
TwoWire& myWire = I2cGetWire(Bh1750_sensors[sensor_index].bus);
|
|
if (&myWire == nullptr) { return false; } // No valid I2c bus
|
|
myWire.beginTransmission(Bh1750_sensors[sensor_index].address);
|
|
uint8_t data = BH1750_MEASUREMENT_TIME_HIGH | ((Bh1750_sensors[sensor_index].mtreg >> 5) & 0x07);
|
|
myWire.write(data);
|
|
if (myWire.endTransmission()) { return false; }
|
|
myWire.beginTransmission(Bh1750_sensors[sensor_index].address);
|
|
data = BH1750_MEASUREMENT_TIME_LOW | (Bh1750_sensors[sensor_index].mtreg & 0x1F);
|
|
myWire.write(data);
|
|
if (myWire.endTransmission()) { return false; }
|
|
return Bh1750SetResolution(sensor_index);
|
|
}
|
|
|
|
bool Bh1750Read(uint32_t sensor_index) {
|
|
if (Bh1750_sensors[sensor_index].valid) { Bh1750_sensors[sensor_index].valid--; }
|
|
|
|
TwoWire& myWire = I2cGetWire(Bh1750_sensors[sensor_index].bus);
|
|
if (2 != myWire.requestFrom(Bh1750_sensors[sensor_index].address, (uint8_t)2)) { return false; }
|
|
|
|
float illuminance = (myWire.read() << 8) | myWire.read();
|
|
illuminance *= 57.5 / (float)Bh1750_sensors[sensor_index].mtreg; // Fix #16022
|
|
if (1 == Bh1750Resolution(sensor_index)) {
|
|
illuminance /= 2;
|
|
}
|
|
Bh1750_sensors[sensor_index].illuminance = illuminance;
|
|
|
|
Bh1750_sensors[sensor_index].valid = SENSOR_MAX_MISS;
|
|
return true;
|
|
}
|
|
|
|
/********************************************************************************************/
|
|
|
|
void Bh1750Detect(void) {
|
|
for (uint32_t bus = 0; bus < 2; bus++) {
|
|
for (uint32_t i = 0; i < sizeof(Bh1750.addresses); i++) {
|
|
if (!I2cSetDevice(Bh1750.addresses[i], bus)) { continue; }
|
|
|
|
Bh1750_sensors[Bh1750.count].address = Bh1750.addresses[i];
|
|
Bh1750_sensors[Bh1750.count].bus = bus;
|
|
if (Bh1750SetMTreg(Bh1750.count)) {
|
|
I2cSetActiveFound(Bh1750_sensors[Bh1750.count].address, Bh1750.types, Bh1750_sensors[Bh1750.count].bus);
|
|
Bh1750.count++;
|
|
if (2 == Bh1750.count) { return; }
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
void Bh1750EverySecond(void) {
|
|
for (uint32_t i = 0; i < Bh1750.count; i++) {
|
|
// 1mS
|
|
if (!Bh1750Read(i)) {
|
|
// AddLogMissed(Bh1750.types, Bh1750.valid);
|
|
}
|
|
}
|
|
}
|
|
|
|
/*********************************************************************************************\
|
|
* Commands
|
|
\*********************************************************************************************/
|
|
|
|
void CmndBh1750Resolution(void) {
|
|
if ((XdrvMailbox.index > 0) && (XdrvMailbox.index <= Bh1750.count)) {
|
|
if ((XdrvMailbox.payload >= 0) && (XdrvMailbox.payload <= 2)) {
|
|
if (1 == XdrvMailbox.index) {
|
|
Settings->SensorBits1.bh1750_1_resolution = XdrvMailbox.payload;
|
|
} else {
|
|
Settings->SensorBits1.bh1750_2_resolution = XdrvMailbox.payload;
|
|
}
|
|
Bh1750SetResolution(XdrvMailbox.index -1);
|
|
}
|
|
ResponseCmndIdxNumber(Bh1750Resolution(XdrvMailbox.index -1));
|
|
}
|
|
}
|
|
|
|
void CmndBh1750MTime(void) {
|
|
if ((XdrvMailbox.index > 0) && (XdrvMailbox.index <= Bh1750.count)) {
|
|
if ((XdrvMailbox.payload > 30) && (XdrvMailbox.payload < 255)) {
|
|
Bh1750_sensors[XdrvMailbox.index -1].mtreg = XdrvMailbox.payload;
|
|
Bh1750SetMTreg(XdrvMailbox.index -1);
|
|
}
|
|
ResponseCmndIdxNumber(Bh1750_sensors[XdrvMailbox.index -1].mtreg);
|
|
}
|
|
}
|
|
|
|
/********************************************************************************************/
|
|
|
|
void Bh1750Show(bool json) {
|
|
for (uint32_t sensor_index = 0; sensor_index < Bh1750.count; sensor_index++) {
|
|
if (Bh1750_sensors[sensor_index].valid) {
|
|
char sensor_name[10];
|
|
strlcpy(sensor_name, Bh1750.types, sizeof(sensor_name));
|
|
if (Bh1750.count > 1) {
|
|
snprintf_P(sensor_name, sizeof(sensor_name), PSTR("%s%c%02X"), sensor_name, IndexSeparator(), Bh1750_sensors[sensor_index].address); // BH1750-23
|
|
}
|
|
|
|
if (json) {
|
|
ResponseAppend_P(JSON_SNS_ILLUMINANCE, sensor_name, Bh1750_sensors[sensor_index].illuminance);
|
|
#ifdef USE_DOMOTICZ
|
|
if ((0 == TasmotaGlobal.tele_period) && (0 == sensor_index)) {
|
|
DomoticzSensor(DZ_ILLUMINANCE, Bh1750_sensors[sensor_index].illuminance);
|
|
}
|
|
#endif // USE_DOMOTICZ
|
|
#ifdef USE_WEBSERVER
|
|
} else {
|
|
WSContentSend_PD(HTTP_SNS_ILLUMINANCE, sensor_name, Bh1750_sensors[sensor_index].illuminance);
|
|
#endif // USE_WEBSERVER
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/*********************************************************************************************\
|
|
* Interface
|
|
\*********************************************************************************************/
|
|
|
|
bool Xsns10(uint32_t function) {
|
|
if (!I2cEnabled(XI2C_11)) { return false; }
|
|
|
|
bool result = false;
|
|
|
|
if (FUNC_INIT == function) {
|
|
Bh1750Detect();
|
|
}
|
|
else if (Bh1750.count) {
|
|
switch (function) {
|
|
case FUNC_EVERY_SECOND:
|
|
Bh1750EverySecond();
|
|
break;
|
|
case FUNC_COMMAND:
|
|
result = DecodeCommand(kBh1750Commands, Bh1750Command);
|
|
break;
|
|
case FUNC_JSON_APPEND:
|
|
Bh1750Show(1);
|
|
break;
|
|
#ifdef USE_WEBSERVER
|
|
case FUNC_WEB_SENSOR:
|
|
Bh1750Show(0);
|
|
break;
|
|
#endif // USE_WEBSERVER
|
|
}
|
|
}
|
|
return result;
|
|
}
|
|
|
|
#endif // USE_BH1750
|
|
#endif // USE_I2C
|