1. Название и модель

ZY-HPS01 и близкий ZY-ZHPS01 — дешёвые датчики присутствия с AliExpress. Внутри CB3S (BK7231N) и Tuya MCU, который считает присутствие и освещённость. Сложность 4/5.

В конфиге карточки UART 9600: передача пин 11, приём пин 10. Присутствие — binary datapoint 101, в карточке с фильтром invert. Освещённость у одной партии точка 103, у другой 11. Карточка говорит поменять только этот номер.

Это не ESP. Прошивает ltchiptool. Распиновка CB3S на фото карточки — схема модуля.

Датчик присутствия ZY-HPS01 — ZY-HPS01 снаружи. Внутри CB3S и MCU присутствия. Фото: esphome/devices.esphome.io, GPL-3.0

2. Что даёт перепрошивка

Присутствие в Home Assistant
Освещённость, дистанция и задержки из числовых точек 104, 105, 107, 109–112 в полном файле
Работа без облака Tuya

3. Что теряется

Приложение Smart Life датчик не видит
Гарантия дешёвого датчика после пайки всё равно формальная

4. Что понадобится

ltchiptool, плата cb3s
Паяльник к площадкам CB3S
Карточка, чтобы выбрать точку освещённости своей партии

5. Разборка и пины

Программатор USB–UART подключают к модулю, который прошивают, крест-накрест:

Земля переходника (GND) — на землю платы. Этот провод обязателен.
TX переходника — на RX модуля. На плате площадка часто подписана RX, RXD или RXD0.
RX переходника — на TX модуля. На плате это TX, TXD или TXD0.
Питание логики — 3,3 В. Пять вольт на эти площадки не подают. Если плату уже кормит её блок, линию 3,3 В с переходника не подключают вторым источником.
Для входа в загрузчик ESP8266 и ESP32 площадку GPIO0 (IO0, BOOT) замыкают на землю и в этот момент подают питание. После старта записи землю с GPIO0 снимают.

Если у этой модели в тексте ниже другие имена площадок, прямой порядок TX–TX или прошивка по USB, делайте как написано там. Общая схема выше — для обычного модульного UART.

Корпус клипсовый. Модуль CB3S на плате. Для загрузчика Beken смотрят распиновку CB3S и CEN. После прошивки линия к MCU остаётся на пинах 11 и 10, её не переносят.

Распиновка модуля CB3S — Схема модуля CB3S, не фото платы датчика. Передача UART — пин 11, приём — пин 10. Схема: esphome/devices.esphome.io, GPL-3.0

6. Прошивка

Готового файла «прошивка именно этой модели» на этом сайте нет. Её собирает ESPHome из текстового конфига YAML: туда входят Wi-Fi, пины и команды второго чипа. Чужой .bin из интернета почти наверняка собран с чужим паролем сети.

Какую программу ставить

ESPHome Dashboard — дополнение в Home Assistant или программа на компьютере. В ней пишут YAML, нажимают Install, и она сама собирает прошивку. Установка: дополнение для Home Assistant или команда pip install esphome.
ESPHome Web, сайт web.esphome.io, — загрузчик в браузере Chrome или Edge. Им записывают уже собранный .bin на ESP8266 и ESP32 через USB–UART. На BK72xx он не рассчитан.
esptool — программа Espressif, чтобы снять заводскую копию флеша и записать .bin, если браузер порт не видит. Репозиторий: espressif/esptool.
ltchiptool — то же самое для чипов Beken BK72xx (модули WB3S, WBR3, CB3S и похожие). ESPHome для них собирается через LibreTiny. Программа: libretiny-eu/ltchiptool, описание платы: компонент bk72xx.

Как собрать конфиг

В Dashboard нажмите New Device и выберите чип, который стоит на плате: ESP8266, ESP32 или BK72xx. Имя — латиницей, без пробелов.
Пароль Wi-Fi уберите в файл secrets.yaml рядом с конфигом. В YAML оставьте ssid: !secret wifi_ssid и password: !secret wifi_password.
Блок UART, модель и скорости из раздела ниже вставьте в этот файл. Полный пример, если он длинный, берите по ссылке в источниках внизу страницы, а не из гайда соседней модели.
Строки api: и ota: оставьте. Без api: Home Assistant устройство не увидит. Ключ шифрования Dashboard предлагает сам, его потом спросит интеграция ESPHome.

Как залить первый раз

Подключите USB–UART, как в разделе «Разборка и пины»: земля переходника на землю платы, TX переходника на RX модуля, RX переходника на TX модуля. Логика 3,3 В. Имена площадок на конкретной плате — там же.
Для ESP8266 и ESP32 замкните GPIO0 (IO0, BOOT) на землю и в этот момент подайте питание. Для BK72xx ltchiptool сам просит перезапустить чип, обычно кратким отключением земли.
В Dashboard: Install → Plug into this computer, выберите порт переходника. Либо Install → Manual download, сохраните .bin и откройте его на web.esphome.io. Из терминала то же самое делает esphome run имя-устройства.yaml.
Когда в логе появится IP-адрес, GPIO0 от земли отпустите, провода можно отпаять. Следующие обновления идут по Wi-Fi, пункт OTA, паяльник больше не нужен.

Дальше — только то, чем эта модель отличается от общей схемы.

В карточке пины записаны числами 11 и 10 без префикса GPIO. Если сборка ругается, оставьте запись как в исходнике. Присутствие:

Базовый конфиг этой модели с карточки или из репозитория компонента. Wi-Fi, пароль и OTA задайте как в общем разделе выше. Пароли из исходника сюда не перенесены.

esphome:
  name: ZY-HPS01 Human presence sensor
  friendly_name: Human presence sensor

bk72xx:
  board: cb3s

uart:
  - baud_rate: 9600
    tx_pin: 11
    rx_pin: 10
tuya:

sensor:
  - platform: tuya
    name: "Light Intensity"
    id: light_intensity
    sensor_datapoint: 103
    unit_of_measurement: "lux"
    icon: "mdi:brightness-5"
    state_class: "measurement"

number:
  - platform: "tuya"
    name: "Far Detection"
    number_datapoint: 109
    min_value: 0
    max_value: 600
    step: 1
    mode: slider
    unit_of_measurement: "cm"
    icon: "mdi:signal-distance-variant"
  - platform: "tuya"
    name: "Presence Delay"
    number_datapoint: 104
    min_value: 1
    max_value: 255
    step: 1
    mode: slider
    unit_of_measurement: "s"
    icon: "mdi:timer"
  - platform: "tuya"
    name: "Sensitivity"
    number_datapoint: 105
    min_value: 0
    max_value: 10
    step: 1
    mode: slider
    icon: "mdi:ray-vertex"
  - platform: "tuya"
    name: "Micro Sensitivity"
    number_datapoint: 107
    min_value: 0
    max_value: 10
    step: 1
    mode: slider
    icon: "mdi:ray-vertex"
  - platform: "tuya"
    name: "Min Range"
    number_datapoint: 110
    min_value: 0
    max_value: 600
    step: 1
    mode: slider
    unit_of_measurement: "cm"
    icon: "mdi:signal-distance-variant"
  - platform: "tuya"
    name: "Micro Max Range"
    number_datapoint: 111
    min_value: 0
    max_value: 600
    step: 1
    mode: slider
    unit_of_measurement: "cm"
    icon: "mdi:signal-distance-variant"
  - platform: "tuya"
    name: "Micro Min Range"
    number_datapoint: 112
    min_value: 0
    max_value: 600
    step: 1
    mode: slider
    unit_of_measurement: "cm"
    icon: "mdi:signal-distance-variant"
binary_sensor:
  - platform: "tuya"
    name: "Presence State"
    sensor_datapoint: 101
    device_class: occupancy
    filters:
      - invert:

sensor:
  - platform: tuya
    name: "Light Intensity"
    id: light_intensity
    sensor_datapoint: 11 # Used to be 103
    unit_of_measurement: "lux"
    icon: "mdi:brightness-5"
    device_class: "illuminance"
    state_class: "measurement"

7. Настройка в Home Assistant

Инвертированное присутствие легко перепутать: свет включается, когда комната пустая. Первые сутки сверьте сущность с тем, стоите вы перед датчиком или нет.

8. Известные баги и как их обойти

Освещённость 103 на партии, где она живёт в точке 11, даёт ноль
Фильтр invert снимают «для простоты» и получают обратную логику
esptool этот модуль не пишет

9. Источники

Каталог ZY-HPS01 на devices.esphome.io https://devices.esphome.io/devices/Tuya-ZY-HPS01-Human-Presence-Sensor/
GitHub Исходник карточки https://github.com/esphome/esphome-devices/blob/main/src/docs/devices/Tuya-ZY-HPS01-Human-Presence-Sensor/index.md
Документация Распиновка CB3S https://docs.libretiny.eu/boards/cb3s/
Документация Прижим с pogo-пинами под CB3S https://www.printables.com/model/1190569-esp-12ef-cb3s-programmer-jig-pogo-pins