/* xsns_16_tsl2561.ino - TSL2561 light sensor support for Tasmota Copyright (C) 2021 Theo Arends and Joachim Banzhaf 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 . */ #ifdef USE_I2C #ifdef USE_TSL2561 /*********************************************************************************************\ * TSL2561 - Light Intensity * * Using library https://github.com/joba-1/Joba_Tsl2561 * * I2C Addresses: 0x29 (low), 0x39 (float) or 0x49 (high) \*********************************************************************************************/ #define XSNS_16 16 #define XI2C_16 16 // See I2CDEVICES.md #include Tsl2561 Tsl(Wire); uint8_t tsl2561_type = 0; uint8_t tsl2561_valid = 0; uint32_t tsl2561_milliLux = 0; uint32_t tsl2561_full = 0; uint32_t tsl2561_ir = 0; char tsl2561_types[] = "TSL2561"; bool Tsl2561Read(void) { if (tsl2561_valid) { tsl2561_valid--; } uint8_t id; bool gain; Tsl2561::exposure_t exposure; uint16_t scaledFull, scaledIr; if (Tsl.on()) { if (Tsl.id(id) && Tsl2561Util::autoGain(Tsl, gain, exposure, scaledFull, scaledIr) && Tsl2561Util::normalizedLuminosity(gain, exposure, tsl2561_full = scaledFull, tsl2561_ir = scaledIr)) { if (! Tsl2561Util::milliLux(tsl2561_full, tsl2561_ir, tsl2561_milliLux, Tsl2561::packageCS(id))) { tsl2561_milliLux = 0; } } else{ tsl2561_milliLux = 0; tsl2561_full = 0; tsl2561_ir = 0; } } tsl2561_valid = SENSOR_MAX_MISS; return true; } void Tsl2561Detect(void) { if (I2cSetDevice(0x29) || I2cSetDevice(0x39) || I2cSetDevice(0x49)) { uint8_t id; Tsl.begin(); if (!Tsl.id(id)) return; if (Tsl.on()) { tsl2561_type = 1; I2cSetActiveFound(Tsl.address(), tsl2561_types); } } } void Tsl2561EverySecond(void) { if (!(TasmotaGlobal.uptime %2)) { // Every 2 seconds // ?mS - 4Sec if (!Tsl2561Read()) { AddLogMissed(tsl2561_types, tsl2561_valid); } } } #ifdef USE_WEBSERVER const char HTTP_SNS_TSL2561[] PROGMEM = "{s}TSL2561 " D_ILLUMINANCE "{m}%u.%03u " D_UNIT_LUX "{e}"; // {s} = , {m} = , {e} = #endif // USE_WEBSERVER void Tsl2561Show(bool json) { if (tsl2561_valid) { if (json) { ResponseAppend_P(PSTR(",\"TSL2561\":{\"" D_JSON_ILLUMINANCE "\":%u.%03u,\"IR\":%u,\"Broadband\":%u}"), tsl2561_milliLux / 1000, tsl2561_milliLux % 1000, tsl2561_ir, tsl2561_full); #ifdef USE_DOMOTICZ if (0 == TasmotaGlobal.tele_period) { DomoticzSensor(DZ_ILLUMINANCE, (tsl2561_milliLux + 500) / 1000); } #endif // USE_DOMOTICZ #ifdef USE_WEBSERVER } else { WSContentSend_PD(HTTP_SNS_TSL2561, tsl2561_milliLux / 1000, tsl2561_milliLux % 1000); #endif // USE_WEBSERVER } } } /*********************************************************************************************\ * Interface \*********************************************************************************************/ bool Xsns16(uint32_t function) { if (!I2cEnabled(XI2C_16)) { return false; } bool result = false; if (FUNC_INIT == function) { Tsl2561Detect(); } else if (tsl2561_type) { switch (function) { case FUNC_EVERY_SECOND: Tsl2561EverySecond(); break; case FUNC_JSON_APPEND: Tsl2561Show(1); break; #ifdef USE_WEBSERVER case FUNC_WEB_SENSOR: Tsl2561Show(0); break; #endif // USE_WEBSERVER } } return result; } #endif // USE_TSL2561 #endif // USE_I2C