ESPHome Device Configurations

A collection of ESPHome configurations for various smart home devices, with a focus on Home Assistant integration.

ESPHome configuration for Shelly 1 Mini Gen3 smart relay with ESP32-C3. Features configurable overheating protection, manual Bluetooth proxy control, and flexible relay restore modes - all configurable via Home Assistant without reflashing.

ESPHome configuration for Shelly 1PM Mini Gen3 with power metering (BL0942), overheating and overpower protection, configurable switch/restore modes, and BLE scanner select.

ESPHome configuration for ProBreeze 20L PB-D-24-WF dehumidifier with Tuya MCU. Replace the original Tuya WBR3 WiFi board with an ESP32-C6 mini board for local control via Home Assistant.

ESPHome configuration for Athom PS02C3MZ LD2450 presence sensor with per-zone presence binary sensors and a guided zone-learning workflow to auto-fill zone coordinates. Also includes a virtual-zones variant (athom-ps02c3mz-sensor-virtual5-16x16.yaml) with 5 learned zones on a 16x16 grid.

Zone Editor: open athom-ps02c3mz-sensor/zone-editor.html in a browser, enter the device IP, click Connect. The editor shows all 5 zones overlaid on a single 16x16 grid with live target positions. Click or drag to paint/erase cells, then Save.

Add a minimal device YAML in your ESPHome dashboard and pull the package directly from this repo using remote_package.

Example (Shelly 1PM Mini Gen3):

substitutions:
  device_name: shelly-1pm-mini-gen3_living-room
  friendly_name: Shelly 1PM Mini Gen3 Living Room
  area: "Living room"

packages:
  remote_package:
    url: https://github.com/dafal/esphome-configs
    ref: main
    files: [shelly-1pm-mini-gen3/shelly-1pm-mini-gen3.yaml]
    refresh: 0s

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
api:
  encryption:
    key: !secret api_encryption_key
ota:
  - platform: esphome
    password: !secret ota_password

Swap the file path for other devices (e.g., shelly-1-mini-gen3/...). Project name/version are already defined in the packages; no need to override. Keep your secrets.yaml local with wifi_ssid, wifi_password, api_encryption_key, ota_password, fallback_password.

This project is licensed under the MIT License - see the LICENSE file for details.

Modifying devices by replacing WiFi modules may void warranties and carries risk of damage or malfunction. Proceed at your own risk. Always ensure proper electrical safety when working with mains-powered devices.

Author: dafal
Year: 2026