mirror of
https://github.com/athom-tech/esp32-configs.git
synced 2026-07-27 19:56:13 +00:00
Benjamin Bennett
c3f10b3007
Add explicit id fields to OTA platform entries across all device YAML files so they can be referenced and overridden in device-specific configs, e.g. to set an OTA password on the esphome platform.
387 lines
11 KiB
YAML
387 lines
11 KiB
YAML
substitutions:
|
|
# Default name
|
|
name: "athom-smart-plug-v5"
|
|
# Default friendly name
|
|
friendly_name: "Athom Plug V5"
|
|
# Allows ESP device to be automatically linked to an 'Area' in Home Assistant. Typically used for areas such as 'Lounge Room', 'Kitchen' etc
|
|
room: ""
|
|
# Description as appears in ESPHome & top of webserver page
|
|
device_description: "athom esp32-c5 power monitoring smart plug"
|
|
# Project Name
|
|
project_name: "China Athom Technology.Athom Plug V5"
|
|
# Projection version denotes the release version of the yaml file, allowing checking of deployed vs latest version
|
|
project_version: "v5.0.3"
|
|
# Restore the relay (GPO switch) upon reboot to state:
|
|
relay_restore_mode: RESTORE_DEFAULT_ON
|
|
# Set the update interval for sensors
|
|
sensor_update_interval: 10s
|
|
# Current Limit in Amps. AU Plug = 10. IL, BR, EU, UK, US Plug = 16.
|
|
current_limit : "16"
|
|
# Define a domain for this device to use. i.e. iot.home.lan (so device will appear as athom-smart-plug-v2.iot.home.lan in DNS/DHCP logs)
|
|
dns_domain: ".local"
|
|
# Set timezone of the smart plug. Useful if the plug is in a location different to the HA server. Can be entered in unix Country/Area format (i.e. "Australia/Sydney")
|
|
timezone: ""
|
|
# Set the duration between the sntp service polling ntp.org servers for an update
|
|
sntp_update_interval: 6h
|
|
# Network time servers for your region, enter from lowest to highest priority. To use local servers update as per zones or countries at: https://www.ntppool.org/zone/@
|
|
sntp_server_1: "0.pool.ntp.org"
|
|
sntp_server_2: "1.pool.ntp.org"
|
|
sntp_server_3: "2.pool.ntp.org"
|
|
# Enables faster network connections, with last connected SSID being connected to and no full scan for SSID being undertaken
|
|
wifi_fast_connect: "false"
|
|
# Define logging level: NONE, ERROR, WARN, INFO, DEBUG (Default), VERBOSE, VERY_VERBOSE
|
|
log_level: "DEBUG"
|
|
# Enable or disable the use of IPv6 networking on the device
|
|
ipv6_enable: "false"
|
|
# Power plug icon selection. Change to reflect the type/country of powr plug in use, this will update the power plug icon shown next to the switch
|
|
power_plug_type: "power-socket-eu" # Options: power-socket-au | power-socket-ch | power-socket-de | power-socket-eu | power-socket-fr | power-socket-it | power-socket-jp | power-socket-uk | power-socket-us |
|
|
|
|
########################## End of Substitutions #########################
|
|
|
|
esphome:
|
|
name: "${name}"
|
|
friendly_name: "${friendly_name}"
|
|
comment: "${device_description}"
|
|
area: "${room}"
|
|
name_add_mac_suffix: true
|
|
min_version: 2026.6.0
|
|
project:
|
|
name: "${project_name}"
|
|
version: "${project_version}"
|
|
platformio_options:
|
|
board_build.mcu: esp32c5
|
|
board_build.variant: esp32c5
|
|
board_build.flash_mode: qio
|
|
on_boot:
|
|
- priority: 600
|
|
then:
|
|
- select.set_index:
|
|
id: power_mode
|
|
index: !lambda |-
|
|
return id(restore_mode)-1;
|
|
- lambda: |-
|
|
switch(id(restore_mode))
|
|
{
|
|
case 1:{
|
|
id(relay).turn_off();
|
|
break;
|
|
}
|
|
case 2:{
|
|
id(relay).turn_on();
|
|
break;
|
|
}
|
|
default:{
|
|
break;
|
|
}
|
|
}
|
|
|
|
esp32:
|
|
board: esp32-c5-devkitc1-n4
|
|
flash_size: 4MB
|
|
variant: ESP32C5
|
|
framework:
|
|
type: esp-idf
|
|
version: recommended
|
|
sdkconfig_options:
|
|
# @grigi found in testing that these options resulted in better responsiveness.
|
|
# BLE 4.2 is supported by ALL ESP32 boards that have bluetooth, the original and derivatives.
|
|
CONFIG_BT_BLE_42_FEATURES_SUPPORTED: y
|
|
# Also enable this on any derivative boards (S2, C3 etc) but not the original ESP32.
|
|
CONFIG_BT_BLE_50_FEATURES_SUPPORTED: y
|
|
# Extend the watchdog timeout, so the device reboots if the device appears locked up for over 10 seconds.
|
|
CONFIG_ESP_TASK_WDT_TIMEOUT_S: "10"
|
|
|
|
preferences:
|
|
flash_write_interval: 5min
|
|
|
|
api:
|
|
# reboot_timeout: 0s
|
|
# Only enable BLE tracking when wifi is up and api is connected
|
|
# Gives single-core ESP32-C5 devices time to manage wifi and authenticate with api
|
|
on_client_connected:
|
|
- esp32_ble_tracker.start_scan:
|
|
continuous: true
|
|
# Disable BLE tracking when there are no api connections live
|
|
on_client_disconnected:
|
|
if:
|
|
condition:
|
|
not:
|
|
api.connected:
|
|
then:
|
|
- esp32_ble_tracker.stop_scan:
|
|
|
|
ota:
|
|
- platform: esphome
|
|
id: ota_esphome
|
|
|
|
logger:
|
|
baud_rate: 0 # 0 Enables logging, but disables serial-port logging to free CPU and memory
|
|
level: ${log_level}
|
|
|
|
mdns:
|
|
disabled: false
|
|
|
|
web_server:
|
|
port: 80
|
|
version: 3
|
|
|
|
network:
|
|
enable_ipv6: ${ipv6_enable}
|
|
|
|
wifi:
|
|
# This spawns an AP with the device name and mac address with no password.
|
|
ap: {}
|
|
# Allow rapid re-connection to previously connect WiFi SSID, skipping scan of all SSID
|
|
fast_connect: "${wifi_fast_connect}"
|
|
# Define dns domain / suffix to add to hostname
|
|
domain: "${dns_domain}"
|
|
|
|
captive_portal:
|
|
|
|
esp32_improv:
|
|
authorizer: none
|
|
|
|
esp32_ble_tracker:
|
|
scan_parameters:
|
|
# Don't auto start BLE scanning, we control it in the `api` block's automation.
|
|
continuous: false
|
|
active: true # send scan-request packets to gather more info, like device name for some devices.
|
|
interval: 320ms # default 320ms - how long to spend on each advert channel
|
|
window: 300ms # default 30ms - how long to actually "listen" in each interval. Reduce this if device is unstable.
|
|
# If the device cannot keep up or becomes unstable, reduce the "window" setting. This may be
|
|
# required if your device is controlling other sensors or doing PWM for lights etc.
|
|
|
|
bluetooth_proxy:
|
|
active: true
|
|
|
|
dashboard_import:
|
|
package_import_url: github://athom-tech/esp32-configs/athom-smart-plug-v5.yaml
|
|
|
|
uart:
|
|
rx_pin: GPIO12
|
|
tx_pin: GPIO11
|
|
baud_rate: 4800
|
|
stop_bits: 1
|
|
|
|
|
|
globals:
|
|
- id: total_energy
|
|
type: float
|
|
restore_value: yes
|
|
initial_value: '0.0'
|
|
|
|
- id: restore_mode
|
|
type: int
|
|
restore_value: yes
|
|
initial_value: "2" # 0 = Always_Off. 1 = Restore_Power_Off. 2 = Always_On.
|
|
|
|
select:
|
|
- platform: template
|
|
name: "Power On State"
|
|
id: "power_mode"
|
|
optimistic: true
|
|
icon: mdi:electric-switch
|
|
options:
|
|
- Always Off
|
|
- Always On
|
|
- Restore Power Off State
|
|
on_value:
|
|
then:
|
|
- lambda: |-
|
|
id(restore_mode)=i+1;
|
|
|
|
binary_sensor:
|
|
- platform: status
|
|
name: "Status"
|
|
icon: mdi:check-network-outline
|
|
entity_category: diagnostic
|
|
|
|
- platform: gpio
|
|
pin:
|
|
number: GPIO10
|
|
mode: INPUT_PULLUP
|
|
inverted: true
|
|
name: "Power Button"
|
|
id: power_button
|
|
disabled_by_default: true
|
|
on_multi_click:
|
|
- timing:
|
|
- ON for at most 1s
|
|
- OFF for at least 0.2s
|
|
then:
|
|
- switch.toggle: relay
|
|
- timing:
|
|
- ON for at least 4s
|
|
then:
|
|
- button.press: Reset
|
|
|
|
sensor:
|
|
- platform: uptime
|
|
name: "Uptime Sensor"
|
|
id: uptime_sensor
|
|
type:
|
|
timestamp
|
|
entity_category: "diagnostic"
|
|
|
|
- platform: wifi_signal
|
|
name: "WiFi Signal dB"
|
|
id: wifi_signal_db
|
|
update_interval: 60s
|
|
entity_category: "diagnostic"
|
|
|
|
- platform: copy
|
|
source_id: wifi_signal_db
|
|
name: "WiFi Signal Percent"
|
|
filters:
|
|
- lambda: return min(max(2 * (x + 100.0), 0.0), 100.0);
|
|
unit_of_measurement: "Signal %"
|
|
entity_category: "diagnostic"
|
|
device_class: ""
|
|
|
|
- platform: bl0942
|
|
id: bl0942_sensor
|
|
voltage:
|
|
name: "Voltage"
|
|
icon: mdi:sine-wave
|
|
filters:
|
|
- throttle_average: ${sensor_update_interval}
|
|
|
|
current:
|
|
name: "Current"
|
|
icon: mdi:current-ac
|
|
filters:
|
|
- throttle_average: ${sensor_update_interval}
|
|
on_value_range:
|
|
- above: ${current_limit}
|
|
then:
|
|
- switch.turn_off: relay
|
|
|
|
power:
|
|
name: "Power"
|
|
id: power_sensor
|
|
icon: mdi:power
|
|
filters:
|
|
- throttle_average: ${sensor_update_interval}
|
|
|
|
frequency:
|
|
name: "Frequency"
|
|
|
|
energy:
|
|
name: "Energy"
|
|
id: energy
|
|
icon: mdi:lightning-bolt
|
|
unit_of_measurement: kWh
|
|
filters:
|
|
- throttle: ${sensor_update_interval}
|
|
# Multiplication factor from W to kW is 0.001
|
|
- multiply: 0.001
|
|
on_value:
|
|
then:
|
|
- lambda: |-
|
|
static float previous_energy_value = 0.0;
|
|
float current_energy_value = id(energy).state;
|
|
id(total_energy) += current_energy_value - previous_energy_value;
|
|
previous_energy_value = current_energy_value;
|
|
id(total_energy_sensor).update();
|
|
|
|
- platform: template
|
|
name: "Total Energy"
|
|
id: total_energy_sensor
|
|
unit_of_measurement: kWh
|
|
device_class: "energy"
|
|
state_class: "total_increasing"
|
|
icon: mdi:lightning-bolt
|
|
accuracy_decimals: 3
|
|
lambda: |-
|
|
return id(total_energy);
|
|
update_interval: ${sensor_update_interval}
|
|
|
|
- platform: total_daily_energy
|
|
name: "Total Daily Energy"
|
|
restore: true
|
|
power_id: power_sensor
|
|
unit_of_measurement: kWh
|
|
icon: mdi:hours-24
|
|
accuracy_decimals: 3
|
|
filters:
|
|
- multiply: 0.001
|
|
|
|
button:
|
|
- platform: restart
|
|
name: "Restart"
|
|
entity_category: config
|
|
|
|
- platform: factory_reset
|
|
name: "Factory Reset"
|
|
id: Reset
|
|
entity_category: config
|
|
|
|
- platform: safe_mode
|
|
name: "Safe Mode"
|
|
internal: false
|
|
entity_category: config
|
|
|
|
switch:
|
|
- platform: gpio
|
|
name: "Switch"
|
|
pin: GPIO23
|
|
id: relay
|
|
restore_mode: ${relay_restore_mode}
|
|
icon: mdi:${power_plug_type}
|
|
|
|
light:
|
|
- platform: status_led
|
|
name: "Status LED"
|
|
id: blue_led
|
|
icon: mdi:lightbulb-outline
|
|
disabled_by_default: true
|
|
pin:
|
|
inverted: true
|
|
number: GPIO6
|
|
|
|
text_sensor:
|
|
- platform: wifi_info
|
|
ip_address:
|
|
name: "IP Address"
|
|
icon: mdi:ip-network
|
|
entity_category: diagnostic
|
|
ssid:
|
|
name: "Connected SSID"
|
|
icon: mdi:wifi-strength-2
|
|
entity_category: diagnostic
|
|
mac_address:
|
|
name: "Mac Address"
|
|
icon: mdi:network-pos
|
|
entity_category: diagnostic
|
|
|
|
# Creates a sensor showing when the device was last restarted
|
|
- platform: template
|
|
name: 'Last Restart'
|
|
id: device_last_restart
|
|
icon: mdi:clock
|
|
entity_category: diagnostic
|
|
|
|
time:
|
|
- platform: sntp
|
|
id: sntp_time
|
|
# Define the timezone of the device
|
|
timezone: "${timezone}"
|
|
# Change sync interval from default 5min to 6 hours (or as set in substitutions)
|
|
update_interval: ${sntp_update_interval}
|
|
# Set specific sntp servers to use
|
|
servers:
|
|
- "${sntp_server_1}"
|
|
- "${sntp_server_2}"
|
|
- "${sntp_server_3}"
|
|
# Publish the time the device was last restarted
|
|
on_time_sync:
|
|
then:
|
|
# Update last restart time, but only once.
|
|
- if:
|
|
condition:
|
|
lambda: 'return id(device_last_restart).state == "";'
|
|
then:
|
|
- text_sensor.template.publish:
|
|
id: device_last_restart
|
|
state: !lambda 'return id(sntp_time).now().strftime("%a %d %b %Y - %I:%M:%S %p");'
|