Подключение датчика освещенности TSL2561 к ESP8266

Подключение датчика освещенности TSL2561 к esp8266 или esp32 с прошивкой ESPHome.

Пришел ко мне для опытов вот такой датчик освещенности TSL2561:

Приобретал тут, доставка быстрая:

Ссылка на датчик TSL2561: https://aliexpress.ru/item/4000357817926.html

Подключается датчик по I²C шине. Для этого в ESPHome ее нужно активировать. Добавляем в конфиг:

i2c:
  sda: D1 # gpio5
  scl: D2 # gpio4
  scan: true
  id: i2c_bus_1

Припаиваем колодку и подключаем датчик по следующей схеме:

Далее прошиваем esp8266 любым удобным способом и ищем определившийся i2c адрес:

Стандартный i2c адрес датчика TSL2561: 0x39

ESPHome видит датчик, замечательно. Самое время добавить в конфиг раздел для TSL2561:

sensor:
  - platform: tsl2561
    name: "TSL2561 Ambient Light"
    address: 0x39
    update_interval: 10s

Сохраняем и загружаем прошивку. В логе появятся первые значения в lx с датчика:

Теперь можно добавить нашу есп в Home Assistant через Настройки > Интеграции >  ESPHome:

Помимо интервала обновления update_interval можно добавить пару других интересных параметров:

• integration_time : Время интеграции, в течении которого датчик будет производить измерения для вывода среднего значения. Значение должно быть одно из следующих: 14ms, 101ms, 402ms. По умолчанию 402ms.
• gain : Усиление. Чем выше значение, тем лучше в условиях низкой освещенности. Значение должно быть одно из следующих: 1x and 16x. По умолчанию без усиления, 1x.

Остальные значения смотрите на странице интеграции датчика.

Так же можно изменить i2c адрес датчика. Для этого предусмотрены 3 луженых контакта на модуле датчика:

Нужно спаять центральный контакт с любым боковым. Таким образом можно подключить три датчика на одну i2c шину.

Полный конфиг для моей тестовой nodemcu следующий:

esphome:
  name: nodemcu
  platform: ESP8266
  board: nodemcuv2

wifi:
  ssid: "ssid"
  password: "password"

captive_portal:

logger:

api:
  password: "nodemcu"

ota:
  password: "nodemcu"

i2c:
  sda: D1 # gpio5
  scl: D2 # gpio4
  scan: true
  id: i2c_bus_1

sensor:
  - platform: tsl2561
    name: "TSL2561 Ambient Light"
    address: 0x39
    update_interval: 1s