Для разработки используются:
Плата NodeMCU ESP32
AP3216 (датчик света и приближения)
Резистор 330 Ом
Базовая настройка
Для разработки я использую Home Assistant с плагином ESPHome Device Builder, но можно использовать командную строку и ESPHome Device Builder отдельно от Home Assistant.
Для начала подключим ESP32 по usb к компьютеру и установим базовую прошивку через сайт web.esphome.io. После установки прошивки и ввода логина/пароля от wifi, устройство должно отобразиться в Home Assistant.
Теперь подключим датчик AP3216 к ESP32 по следующей схеме:
В реальности выглядит так
В корневой папке создаем следующие файлы:
main.yaml (основной файл),
папка components (здесь будут наши компоненты),
папка ap3216 (название компонента, внутри папки components),
файлы __init__.py, ap3216.h, ap3216.cpp, automation.h и sensor.py. Все файлы внутри папки ap3216. Название главного cpp и h файла должны совпадать с названием папки в которой они находятся.
Структура созданных папок и файлов:
<CONFIG_DIR> ├── main.yaml // основной yaml-файл └── components // папка с внешними компонентами └── ap3216 // папка с компонентом ap3216 ├── __init__.py ├── ap3216.cpp ├── ap3216.h ├── automation.h └── sensor.py
В yaml-файле (main.yaml) укажем внешний компонент ap3216:
esphome: name: esphome-web-ebe1f0 friendly_name: ESPHome32 min_version: 2025.4.0 external_components: - source: type: local path: components components: [ap3216] esp32: board: esp32dev framework: type: arduino # Enable Home Assistant API api: ota: - platform: esphome wifi: ssid: !secret wifi_ssid password: !secret wifi_password power_save_mode: HIGH web_server: port: 80 logger: level: VERBOSE logs: mqtt.component: DEBUG mqtt.client: ERROR
Теперь можно приступить, непосредственно, к разработке компонента.
Создание простого компонента (MVP)
Простой компонент содержит сенсоры (датчики), которые считывают данные раз в n секунд и отображают их в GUI-версии.
В файле ap3216.h создадим класс компонента AP3216Component:
#pragma once #include "esphome/core/component.h" #include "esphome/components/sensor/sensor.h" #include "esphome/components/binary_sensor/binary_sensor.h" #include "esphome/components/text_sensor/text_sensor.h" #include "esphome/components/i2c/i2c.h" #include "AP3216_WE.h" #include "esphome/core/gpio.h" namespace esphome { namespace ap3216 { class AP3216Component : public PollingComponent, public i2c::I2CDevice { public: void setup() override; //вызывается 1 раз при конфигурации компонента void dump_config() override; //вызывается 1 раз после конфигурации компонента, в функции выводится информация о конфигурации компонента void update() override; //вызывается раз в n времени, которое задается в yaml файле (update_interval) void set_mode(AP3216Mode _ap3216_mode) { this->_ap3216_mode = _ap3216_mode; } protected: sensor::Sensor *ambient_light_sensor_{nullptr}; //обычный сенсор, поддерживает данные: int/float/double sensor::Sensor *proximity_counts_sensor_{nullptr}; sensor::Sensor *infrared_counts_sensor_{nullptr}; binary_sensor::BinarySensor *is_near_sensor_{nullptr}; // бинарный сенсор: true/false text_sensor::TextSensor *interrupt_status_sensor_{nullptr}; //текстовый сенсор, поддерживает текст sensor::Sensor *ir_data_sensor_{nullptr}; AP3216Mode _ap3216_mode; // режим работы, есть три: считывание датчика приближения, считывание датчика освещения, считывания датчиков приближения и освещения }; } // namespace ap3216 } // namespace esphome
В файле ap3216.cpp реализуем функции:
#include "ap3216.h" #include "Wire.h" #include "esphome/core/log.h" namespace esphome { namespace ap3216 { static const char *const TAG = "ap3216.sensor"; AP3216_WE _AP3216 = AP3216_WE(); void AP3216Component::setup(){ _AP3216.setMode(_ap3216_mode); delay(1000); } void AP3216Component::dump_config() { ESP_LOGCONFIG(TAG, "_AP3216 init"); ESP_LOGCONFIG(TAG, "mode: %d ", this->_ap3216_mode); } void AP3216Component::update() { float als = _AP3216.getAmbientLight(); unsigned int prox = _AP3216.getProximity(); unsigned int intStatus = _AP3216.getIntStatus(); unsigned int ir = _AP3216.getIRData(); // Ambient IR light bool isNear = _AP3216.objectIsNear(); bool irIsValid = !_AP3216.irDataIsOverflowed(); if (this->ambient_light_sensor_ != nullptr) { //если параметр не указан в yaml-файле, то он будет иметь значения nullptr this->ambient_light_sensor_->publish_state(als); } if (this->proximity_counts_sensor_ != nullptr) { this->proximity_counts_sensor_->publish_state(prox); } if (this->infrared_counts_sensor_ != nullptr) { this->infrared_counts_sensor_->publish_state(ir); } if (this->is_near_sensor_ != nullptr){ this->is_near_sensor_->publish_state(isNear); } if (this->ir_data_sensor_ != nullptr){ this->ir_data_sensor_->publish_state(_AP3216.getIRData()); } if (this->interrupt_status_sensor_ != nullptr){ switch (intStatus) { case 0: this->interrupt_status_sensor_->publish_state("NO_INT"); break; case 1: this->interrupt_status_sensor_->publish_state("ALS_INT"); break; case 2: this->interrupt_status_sensor_->publish_state("PS_INT"); break; case 3: this->interrupt_status_sensor_->publish_state("ALS_PS_INT"); break; } } } } }
В файле sensor.py опишем конфигурацию:
from esphome import automation, pins import esphome.codegen as cg from esphome.components import i2c, sensor, binary_sensor, text_sensor import esphome.config_validation as cv from esphome.const import ( CONF_AMBIENT_LIGHT, CONF_ID, CONF_NAME, CONF_TRIGGER_ID, DEVICE_CLASS_DISTANCE, DEVICE_CLASS_ILLUMINANCE, DEVICE_CLASS_PRESENCE, ICON_BRIGHTNESS_5, ICON_BRIGHTNESS_6, ICON_MOTION_SENSOR, ICON_SCREEN_ROTATION, STATE_CLASS_MEASUREMENT, UNIT_LUX, ) DEPENDENCIES = ["i2c"] '''зависимость от i2c, в yaml-файле надо будет создать компонент i2c и указать пины для него (sda/scl)''' AUTO_LOAD = ["sensor", "binary_sensor", "text_sensor"] '''список автоматически загружаемых компонентов (сенсоров), можно загружать кнопки, дисплеи или любые другие компоненты''' REQUIRED_LIBRARIES = [ "Wire", ] '''Необходимые библиотеки, esphome загрузит автоматически во время сборки''' CONF_INFRARED_COUNTS = "infrared_counts" CONF_PS_COUNTS = "ps_counts" CONF_IS_NEAR = "is_near" UNIT_COUNTS = "#" ICON_PROXIMITY = "mdi:hand-wave-outline" CONF_MODE="mode" CONF_OPERATING_MODE = "operating_mode" CONF_INT_STATUS="interrupt_status" CONF_IR_DATA="ir_data" CONF_LUX_RANGE="lux_range" ap3216_ns = cg.esphome_ns.namespace("ap3216") AP3216Component = ap3216_ns.class_( "AP3216Component", cg.PollingComponent, i2c.I2CDevice ) AP3216MODE = cg.global_ns.enum("AP3216Mode") MODE_OPTIONS = { "ALS": AP3216MODE.AP3216_ALS, "PS": AP3216MODE.AP3216_PS, "ALS_PS": AP3216MODE.AP3216_ALS_PS, "RESET": AP3216MODE.AP3216_RESET, } CONFIG_SCHEMA = cv.All( cv.Schema( { cv.GenerateID(): cv.declare_id(AP3216Component), cv.Optional(CONF_INT_STATUS): cv.maybe_simple_value( text_sensor.text_sensor_schema(icon=ICON_SCREEN_ROTATION), key=CONF_NAME, ), cv.Optional(CONF_IR_DATA): cv.maybe_simple_value( sensor.sensor_schema( icon=ICON_BRIGHTNESS_6, accuracy_decimals=1, device_class=DEVICE_CLASS_ILLUMINANCE, ), key=CONF_NAME, ), cv.Optional(CONF_PS_COUNTS): cv.maybe_simple_value( sensor.sensor_schema( unit_of_measurement=UNIT_COUNTS, icon=ICON_PROXIMITY, accuracy_decimals=0, device_class=DEVICE_CLASS_DISTANCE, state_class=STATE_CLASS_MEASUREMENT, ), key=CONF_NAME, ), cv.Optional(CONF_INFRARED_COUNTS): cv.maybe_simple_value( sensor.sensor_schema( unit_of_measurement=UNIT_COUNTS, icon=ICON_BRIGHTNESS_5, accuracy_decimals=0, device_class=DEVICE_CLASS_ILLUMINANCE, state_class=STATE_CLASS_MEASUREMENT, ), key=CONF_NAME, ), cv.Optional(CONF_AMBIENT_LIGHT): cv.maybe_simple_value( sensor.sensor_schema( unit_of_measurement=UNIT_LUX, icon=ICON_BRIGHTNESS_6, accuracy_decimals=1, device_class=DEVICE_CLASS_ILLUMINANCE, state_class=STATE_CLASS_MEASUREMENT, ), key=CONF_NAME, ), cv.Optional(CONF_IS_NEAR): cv.maybe_simple_value( binary_sensor.binary_sensor_schema( device_class=DEVICE_CLASS_PRESENCE, icon=ICON_MOTION_SENSOR, ), key=CONF_NAME, ), cv.Optional(CONF_MODE, default="ALS_PS"): cv.enum(MODE_OPTIONS), } ) .extend(cv.polling_component_schema("60s")) .extend(i2c.i2c_device_schema(0x23)), ) '''основная схема компонента, тут описываются параметры, триггеры, ограничения''' async def to_code(config): var = cg.new_Pvariable(config[CONF_ID]) cg.add_library("AP3216_WE", None, "https://github.com/wollewald/AP3216_WE.git") '''загрузка сторонней библиотеки''' await cg.register_component(var, config) await i2c.register_i2c_device(var, config) if int_status_config := config.get(CONF_INT_STATUS): sens = await text_sensor.new_text_sensor(int_status_config) cg.add(var.set_interrupt_status_sensor(sens)) if ir_data_config := config.get(CONF_IR_DATA): sens = await sensor.new_sensor(ir_data_config) cg.add(var.set_ir_data_sensor(sens)) if als_config := config.get(CONF_AMBIENT_LIGHT): sens = await sensor.new_sensor(als_config) cg.add(var.set_ambient_light_sensor(sens)) if prox_cnt_config := config.get(CONF_PS_COUNTS): sens = await sensor.new_sensor(prox_cnt_config) cg.add(var.set_proximity_counts_sensor(sens)) if infrared_cnt_config := config.get(CONF_INFRARED_COUNTS): sens = await sensor.new_sensor(infrared_cnt_config) cg.add(var.set_infrared_counts_sensor(sens)) if is_near_config := config.get(CONF_IS_NEAR): sens = await binary_sensor.new_binary_sensor(is_near_config) cg.add(var.set_is_near_sensor(sens)) cg.add(var.set_mode(config[CONF_MODE]))
Теперь можно добавить наш сенсор, в созданный ранее yaml файл (main.yaml):
... i2c: sda: GPIO21 scl: GPIO22 sensor: - platform: ap3216 ambient_light: "Ambient light" ps_counts: "Proximity" infrared_counts: "Infrared" ir_data: "Ir data" is_near: "is_near" address: 0x23 update_interval: 60s ...
После установки прошивки, при открытии адреса датчика, будет отображаться таблица с данными (которые будут обновляться раз в 60 секунд):
Вместе с логами так
Триггеры
Триггеры позволяют создавать дополнительную логику в yaml-файлах, которая будет срабатывать при наступлении определенных событий. Например, можно отслеживать находится ли какой-то объект в непосредственной близости от датчика приближения или нет.
Создадим два триггера: on_ps_low_threshold и on_ps_high_threshold. Первый триггер будет срабатывать, когда какой-то предмет находится в непосредственной близости от датчика, второй - когда предмета не обнаружено.
В файл ap3216.h добавим Callback'и:
CallbackManager<void()> on_ps_high_trigger_callback_; CallbackManager<void()> on_ps_low_trigger_callback_; void add_on_ps_high_trigger_callback_(std::function<void()> callback) { this->on_ps_high_trigger_callback_.add(std::move(callback)); } void add_on_ps_low_trigger_callback_(std::function<void()> callback) { this->on_ps_low_trigger_callback_.add(std::move(callback)); }
В файле с автоматизацией automation.h создадим классы AP3216PsHighTrigger и AP3216PsLowTrigger, унаследованные от Trigger<>:
#pragma once #include "esphome/core/automation.h" #include "ap3216.h" namespace esphome { namespace ap3216 { class AP3216PsHighTrigger : public Trigger<> { friend class AP3216Component; public: explicit AP3216PsHighTrigger(AP3216Component *parent) { parent->add_on_ps_high_trigger_callback_([this]() { this->trigger(); }); } }; class AP3216PsLowTrigger : public Trigger<> { public: explicit AP3216PsLowTrigger(AP3216Component *parent) { parent->add_on_ps_low_trigger_callback_([this]() { this->trigger(); }); } };
В файле ap3216.cpp вызовем триггер при обновлении данных с датчиков:
void AP3216Component::update() { ... bool isNear = _AP3216.objectIsNear(); ... if (isNear){ this->on_ps_high_trigger_callback_.call(); }else{ this->on_ps_low_trigger_callback_.call(); } ... }
В файл sensor.py добавим триггеры:
... from esphome.const import ( ... CONF_TRIGGER_ID, ... ) CONF_ON_PS_HIGH_THRESHOLD = "on_ps_high_threshold" CONF_ON_PS_LOW_THRESHOLD = "on_ps_low_threshold" CONFIG_SCHEMA = cv.All( cv.Schema( { ... cv.Optional(CONF_ON_PS_HIGH_THRESHOLD): automation.validate_automation( { cv.GenerateID(CONF_TRIGGER_ID): cv.declare_id(AP3216PsHighTrigger), } ), cv.Optional(CONF_ON_PS_LOW_THRESHOLD): automation.validate_automation( { cv.GenerateID(CONF_TRIGGER_ID): cv.declare_id(AP3216PsLowTrigger), } ), ... } ) ... ) ... async def to_code(config): ... for prox_high_tr in config.get(CONF_ON_PS_HIGH_THRESHOLD, []): trigger = cg.new_Pvariable(prox_high_tr[CONF_TRIGGER_ID], var) await automation.build_automation(trigger, [], prox_high_tr) for prox_low_tr in config.get(CONF_ON_PS_LOW_THRESHOLD, []): trigger = cg.new_Pvariable(prox_low_tr[CONF_TRIGGER_ID], var) await automation.build_automation(trigger, [], prox_low_tr) ...
Теперь в yaml файл можно добавить триггеры on_ps_low_threshold и on_ps_high_threshold:
sensor: - platform: ap3216 mode: ALS_PS ps_counts: "Proximity" infrared_counts: "Infrared" ir_data: "Ir data" is_near: "is_near" on_ps_low_threshold: then: - logger.log: "Object is not near" on_ps_high_threshold: then: - logger.log: "Object is near"
Пример срабатывания триггера:
Проверка дополнительных условий
В файле sensor.py (при конфигурировании схемы - CONFIG_SCHEMA) можно осуществить проверку дополнительных условий, например, задать интервал валидных значений:
cv.Optional(CONF_PS_CALIBRATION, default=0): cv.int_range(min=0, max=511),
или выбор из диапазона значений:
cv.Optional(CONF_PS_INT_AFTER_N_CONVERSIONS): cv.one_of(1, 2, 4, 8, int=True),
или выбор из перечисления:
cv.Optional(CONF_MODE, default="ALS_PS"): cv.enum(MODE_OPTIONS),
Для более сложных проверок можно использовать отдельные функции, например, для проверки, что два взаимосвязанных параметра либо оба заданы, либо оба не заданы.
def validate_thresholds(config): has_als_lower_thresh = CONF_ALS_THRESHOLDS_LOWER in config has_als_upper_thresh = CONF_ALS_THRESHOLDS_UPPER in config if has_als_lower_thresh != has_als_upper_thresh: raise cv.Invalid("als_lower_thresh and als_upper_thresh must be both set or both not set") return config
Проверку отдельной функцией необходимо включить в схему:
CONFIG_SCHEMA = cv.All( cv.Schema( { ... } ) validate_thresholds )
Теперь, на этапе компиляции, будут произведены дополнительные проверки yaml файла. Если значения параметров не соответствуют критериям - будет выведена ошибка.
Пример ошибки, при неверном задании mode в yaml-файле:
Прерывания
Прерывания позволяют получать уведомления от внешних компонентов, непосредственно, при наступлении тех или иных событий, не дожидаясь обновления данных по таймеру. В нашем случае такими событиями могут быть: срабатывания датчика освещения или приближения, в том случае, если значения этих датчиков попадают в заданный интервал (интервалы задаются в yaml-файле).
Для начала создадим триггер on_interrupt_trigger аналогично, созданным ранее триггерам, но добавив передачу данных через него (текущие значения датчиков и тип прерывания). Данные будут доступны в yaml-файле при срабатывании триггера.
В файл ap3216.h добавим callback для триггера и pin, через который будет срабатывать прерывание :
namespace esphome { namespace ap3216 { struct AP3216Data{ float als; unsigned int prox; unsigned int ir; uint8_t interruptType; std::string interruptTypeString; }; class AP3216Component : public PollingComponent, public i2c::I2CDevice { public: CallbackManager<void(AP3216Data &)> on_interrupt_callback_; void add_on_interrupt_callback_(std::function<void(AP3216Data &)> &&callback){ this->on_interrupt_callback_.add(std::move(callback)); } void set_interrupt_pin(InternalGPIOPin *pin) { interrupt_pin_ = pin; } protected: InternalGPIOPin *interrupt_pin_{nullptr}; }; } // namespace ap3216 } // namespace esphome
В файл automation.h добавим триггер с указанием на класс компонента AP3216Data:
#pragma once #include "esphome/core/automation.h" #include "ap3216.h" namespace esphome { namespace ap3216 { ... class AP3216InterruptTrigger : public Trigger<AP3216Data&> { friend class AP3216Component; public: explicit AP3216InterruptTrigger(AP3216Component *parent) { parent->add_on_interrupt_callback_([this](AP3216Data &x) { this->trigger(x); }); } }; } // namespace ap3216 } // namespace esphome
В файле ap3216.cpp подключим прерывания:
void AP3216Component::setup(){ ... if (operating_mode == 1 || operating_mode == 2){ int pin = interrupt_pin_->get_pin(); pinMode(pin, INPUT); //подключения pin для отслеживания прерываний attachInterrupt(digitalPinToInterrupt(pin), blink, CHANGE); //создание прерывания /*настройка дополнительных параметров: */ _AP3216.setALSThresholds(als_lower_thresh, als_upper_thresh); _AP3216.setPSThresholds(ps_lower_thresh, ps_upper_thresh); _AP3216.setPSInterruptMode(ps_interrupt_mode); _AP3216.setPSIntAfterNConversions(ps_int_after_n_conversions); _AP3216.setALSIntAfterNConversions(als_int_after_n_conversions); _AP3216.setIntClearManner(int_clear_manner); } void AP3216Component::interruptAction(){ ESP_LOGI(TAG, "interruptAction ... OK!"); uint8_t intType = NO_INT; intType = _AP3216.getIntStatus(); AP3216Data data; data.interruptType = intType; switch(intType){ case(ALS_INT): ESP_LOGI(TAG, "Ambient Light Interrupt!"); data.interruptTypeString = "ALS_INT"; data.als = _AP3216.getAmbientLight(); data.prox = _AP3216.getProximity(); data.ir = _AP3216.getIRData(); this->on_interrupt_callback_.call(data); break; case(PS_INT): data.interruptTypeString = "PS_INT"; ESP_LOGI(TAG, "Proximity Interrupt!"); data.als = _AP3216.getAmbientLight(); data.prox = _AP3216.getProximity(); data.ir = _AP3216.getIRData(); this->on_interrupt_callback_.call(data); break; case(ALS_PS_INT): ESP_LOGI(TAG, "Ambient Light and Proximity Interrupt!"); data.interruptTypeString = "ALS_PS_INT"; data.als = _AP3216.getAmbientLight(); data.prox = _AP3216.getProximity(); data.ir = _AP3216.getIRData(); this->on_interrupt_callback_.call(data); break; default: ESP_LOGI(TAG, "Something went wrong..."); break; } intType = _AP3216.getIntStatus(); _AP3216.clearInterrupt(intType); event = false; } void AP3216Component::loop(){ if(event){ interruptAction(); } /* * without the following delay you will not detect ALS and PS interrupts together. */ delay(1000); } void AP3216Component::blink(){ event = true; } }
Добавим триггер в файл sensor.py:
from esphome import automation, pins ... CONF_INTERRUPT_PIN = "interrupt_pin" AP3216InterruptTrigger = ap3216_ns.class_('AP3216InterruptTrigger', automation.Trigger.template()) CONF_ON_INTERRUPT_TRIGGER = "on_interrupt_trigger" ... CONFIG_SCHEMA = cv.All( cv.Schema( { cv.Optional(CONF_ON_INTERRUPT_TRIGGER): automation.validate_automation( { cv.GenerateID(CONF_TRIGGER_ID): cv.declare_id(AP3216InterruptTrigger), }, ), cv.Optional(CONF_INTERRUPT_PIN): pins.internal_gpio_input_pin_schema, } ) ... ) async def to_code(config): var = cg.new_Pvariable(config[CONF_ID]) ... if CONF_INTERRUPT_PIN in config: interrupt_pin = await cg.gpio_pin_expression(config[CONF_INTERRUPT_PIN]) cg.add(var.set_interrupt_pin(interrupt_pin)) for conf in config.get(CONF_ON_INTERRUPT_TRIGGER, []): trigger = cg.new_Pvariable(conf[CONF_TRIGGER_ID], var) await automation.build_automation( trigger, [(AP3216Data.operator("ref"), "x")], conf, )
Теперь триггер можно подключить в yaml-файле:
sensor: - platform: ap3216 mode: ALS_PS operating_mode: VALUE_AND_INTERRUPT interrupt_pin: GPIO13 int_clear_manner: CLR_INT_MANUALLY interrupt_status: "status" ambient_light: "Ambient light" ps_counts: "Proximity" infrared_counts: "Infrared" ir_data: "Ir data" is_near: "is_near" on_interrupt_trigger: - if: condition: lambda: return x.interruptTypeString == "ALS_PS_INT"; then: - logger.log: level: INFO format: "als: %f, prox: %d, ir: %d, interruptTypeString: %s" args: - x.als - x.prox - x.ir - x.interruptTypeString.c_str() address: 0x23 update_interval: 60s
При срабатывании прерывания будет выведена информация в лог:
Выводы
После публикации компонента в интернете (github, gitlab и т.д.), его можно подключать в любых yaml файлах.
Для подключения достаточно указать ссылку на внешний компонент:
external_components: - source: github://10-thousand/esphome-AP3216@main components: [ap3216]
А затем подключить сам компонент:
sensor: - platform: ap3216 mode: ALS_PS operating_mode: VALUE ambient_light: "Ambient light" ps_counts: "Proximity" infrared_counts: "Infrared" ir_data: "Ir data" is_near: "is_near" address: 0x23 update_interval: 60s
Пример yaml файла после подключения внешнего компонента:
esphome: name: esphome-web-ebe1f0 friendly_name: ESPHome32 min_version: 2025.4.0 external_components: - source: github://10-thousand/esphome-AP3216@main components: [ap3216] esp32: board: esp32dev framework: type: arduino # Enable Home Assistant API api: ota: - platform: esphome wifi: ssid: !secret wifi_ssid password: !secret wifi_password power_save_mode: HIGH web_server: port: 80 i2c: sda: GPIO21 scl: GPIO22 sensor: - platform: ap3216 mode: ALS_PS operating_mode: VALUE ambient_light: "Ambient light" ps_counts: "Proximity" infrared_counts: "Infrared" ir_data: "Ir data" is_near: "is_near" address: 0x23 update_interval: 60s logger: level: VERBOSE
Тут yaml-файл со всеми возможными опциями
esphome: name: esphome-web-ebe1f0 friendly_name: ESPHome32 min_version: 2025.4.0 external_components: #- source: # type: local # path: components #components: [ap3216] - source: github://10-thousand/esphome-AP3216@main components: [ap3216] esp32: board: esp32dev framework: type: arduino # Enable Home Assistant API api: ota: - platform: esphome wifi: ssid: !secret wifi_ssid password: !secret wifi_password power_save_mode: HIGH web_server: port: 80 i2c: sda: GPIO21 scl: GPIO22 sensor: - platform: ap3216 mode: ALS_PS operating_mode: VALUE_AND_INTERRUPT interrupt_pin: GPIO13 int_clear_manner: CLR_INT_MANUALLY interrupt_status: "status" ambient_light: "Ambient light" ps_counts: "Proximity" infrared_counts: "Infrared" ir_data: "Ir data" is_near: "is_near" lux_range: RANGE_20661 als_int_after_n_conversions: 6 ps_int_after_n_conversions: 2 als_calibration_factor: 1.0 ps_integration_time: 8 ps_gain: 2 ps_interrupt_mode: INT_MODE_ZONE ps_mean_time: PS_MEAN_TIME_12_5 number_of_led_pulses: 1 led_current: LED_66_7 led_waiting_time: 0 ps_calibration: 0 als_thresholds_lower: 0 als_thresholds_upper: 500 ps_thresholds_lower: 0 ps_thresholds_upper: 200 on_interrupt_trigger: - if: condition: lambda: return x.interruptTypeString == "ALS_PS_INT"; then: - logger.log: level: INFO format: "als: %f, prox: %d, ir: %d, interruptTypeString: %s" args: - x.als - x.prox - x.ir - x.interruptTypeString.c_str() on_ps_low_threshold: then: - logger.log: "Object is not near" on_ps_high_threshold: then: - logger.log: "Object is near" on_ir_data_overflow: then: - logger.log: "ir data is overflowed" address: 0x23 update_interval: 60s logger: level: VERBOSE logs: mqtt.component: DEBUG mqtt.client: ERROR
Теперь веб-страница устройства выглядит так:
Полезные ссылки
ESPHome custom component for СJMCU-3216 (AP3216)
ESP Home
Home Assistant
Исходный код стандартных компонентов esphome
Библиотека AP3216
Документация для модуля AP3216
