esphome devices & scripts
This commit is contained in:
root
@@ -351,6 +351,8 @@ sensor:
|
||||
device_class: temperature
|
||||
state_class: measurement
|
||||
accuracy_decimals: 2
|
||||
filters:
|
||||
- offset: -2.9
|
||||
on_value:
|
||||
then:
|
||||
# Publish current temperature to local MQTT status topic
|
||||
|
||||
@@ -6,6 +6,9 @@
|
||||
# https://home.fox.co.nz/gitea/zorruno/zorruno-homeassistant/src/branch/master/esphome/esp-mainhallwaylights.yaml
|
||||
#:########################################################################################:#
|
||||
# VERSIONS:
|
||||
# V1.3 2026-05-07 Refactored MQTT sync to use template HA switch actions; physical button and
|
||||
# HA control now publish command topics; relay callbacks publish status only
|
||||
# to prevent command ping-pong/chattering.
|
||||
# V1.2 2026-04-03 Fixed local button logic so physical press toggles relay; moved custom MQTT
|
||||
# status publish to relay state changes; corrected ESP8266 notes and wording
|
||||
# V1.1 2026-04-03 Updated yaml to zorruno layout V1.1; corrected KS-811 single naming and
|
||||
@@ -14,27 +17,38 @@
|
||||
#:########################################################################################:#
|
||||
# HARDWARE:
|
||||
# - Zemismart KS-811 Single push button
|
||||
# - ESP8266 variant
|
||||
# - Button 1: GPIO0
|
||||
# - Relay 1: GPIO12
|
||||
# - Status LED: GPIO2 (inverted)
|
||||
#:########################################################################################:#
|
||||
# OPERATION NOTES:
|
||||
# - Main hallway switch with 1 output:
|
||||
# 1) Main Hallway Lights
|
||||
# - A single press of the physical button toggles Relay 1 ON/OFF locally
|
||||
# - Relay state is published to the custom MQTT status topic for remote sync
|
||||
# - Status LED uses GPIO2
|
||||
# - A single press of the physical button toggles the Main Hallway Lights group.
|
||||
# - Home Assistant control of the exposed template switch also toggles the same group.
|
||||
# - MQTT command topic requests On/Off changes.
|
||||
# - Relay state changes publish retained status only.
|
||||
# - Relays never publish command topics directly. This prevents command ping-pong/chattering.
|
||||
#:########################################################################################:#
|
||||
# MQTT COMMANDS:
|
||||
# - None
|
||||
# - ${mqtt_this_device_command_topic1}
|
||||
# Payloads: ${mqtt_command_on}, ${mqtt_command_off}
|
||||
# - Status topic:
|
||||
# - ${mqtt_this_device_status_topic1}
|
||||
# Payloads mirror the actual relay state and are published retained.
|
||||
#:########################################################################################:#
|
||||
# OFFLINE NOTES:
|
||||
# - a) Home Assistant offline (network and MQTT online):
|
||||
# - Device remains on WiFi and MQTT
|
||||
# - Physical button still toggles relay locally
|
||||
# - Local button control continues.
|
||||
# - MQTT command/status operation continues.
|
||||
# - b) MQTT offline (or Home Assistant and MQTT offline):
|
||||
# - Physical button still toggles relay locally
|
||||
# - Remote control/state sync is unavailable until MQTT returns
|
||||
# - Local button control continues.
|
||||
# - If Home Assistant is online and connected by native ESPHome API, HA control can still
|
||||
# change the local relay but remote MQTT sync is unavailable until MQTT returns.
|
||||
# - c) Entire WiFi/network offline:
|
||||
# - Physical button still toggles relay locally
|
||||
# - Accurate time is not needed; SNTP is not used
|
||||
# - Local wall-switch button control continues.
|
||||
# - Accurate time is not needed. SNTP is not used for this device.
|
||||
#:########################################################################################:#
|
||||
|
||||
#:########################################################################################:#
|
||||
@@ -50,7 +64,7 @@ substitutions:
|
||||
|
||||
# Project Naming
|
||||
project_name: "Zemismart Technologies.KS-811 Single" # Project Details
|
||||
project_version: "v1.1" # Project V denotes release of yaml file, allowing checking of deployed vs latest version
|
||||
project_version: "v1.3" # Project V denotes release of yaml file, allowing checking of deployed vs latest version
|
||||
|
||||
# Passwords
|
||||
api_key: !secret esp-api_key # unfortunately you can't use substitutions inside secrets names
|
||||
@@ -64,17 +78,21 @@ substitutions:
|
||||
current_ip_address: ${static_ip_address}
|
||||
|
||||
# Device Settings
|
||||
log_level: "INFO" # Define logging level: NONE, ERROR, WARN, INFO, DEBUG (Default), VERBOSE, VERY_VERBOSE
|
||||
update_interval: "60s" # update time for for general sensors etc
|
||||
log_level: "INFO" # NONE, ERROR, WARN, INFO, DEBUG, VERBOSE, VERY_VERBOSE
|
||||
update_interval: "60s" # General sensor update interval
|
||||
|
||||
# MQTT REMOTE Controls
|
||||
# Default relay restore mode
|
||||
# Options: RESTORE_DEFAULT_OFF, RESTORE_DEFAULT_ON, ALWAYS_ON, ALWAYS_OFF
|
||||
relay_restore_mode: "RESTORE_DEFAULT_OFF"
|
||||
|
||||
# MQTT Remote Controls
|
||||
mqtt_this_device_function1: "mainhallway-mainlights"
|
||||
mqtt_this_device_command_topic1: "${mqtt_command_main_topic}/${mqtt_this_device_function1}"
|
||||
mqtt_this_device_status_topic1: "${mqtt_status_main_topic}/${mqtt_this_device_function1}"
|
||||
mqtt_command_on: "On"
|
||||
mqtt_command_off: "Off"
|
||||
|
||||
# Switch/Relay/Button Naming & Icons
|
||||
# Switch/Relay/Button Naming
|
||||
switch_1_name: "Main Hallway Lights"
|
||||
|
||||
#:########################################################################################:#
|
||||
@@ -123,7 +141,7 @@ packages:
|
||||
esphome:
|
||||
name: "${device_name}"
|
||||
friendly_name: "${friendly_name}"
|
||||
comment: "${description_comment}" # Appears on the esphome page in HA
|
||||
comment: "${description_comment}" # Appears on the ESPHome page in HA
|
||||
area: "${device_area}"
|
||||
project:
|
||||
name: "${project_name}"
|
||||
@@ -135,8 +153,8 @@ esphome:
|
||||
#:########################################################################################:#
|
||||
esp8266:
|
||||
board: esp01_1m
|
||||
early_pin_init: false # Initialise pins early to known values. Recommended false where switches are involved. Defaults to true.
|
||||
board_flash_mode: dout # Default is dout
|
||||
early_pin_init: false # Recommended false where relays/switches are involved
|
||||
board_flash_mode: dout
|
||||
|
||||
#:########################################################################################:#
|
||||
# LOGGING
|
||||
@@ -144,15 +162,17 @@ esp8266:
|
||||
#:########################################################################################:#
|
||||
logger:
|
||||
level: "${log_level}"
|
||||
#baud_rate: 0 # set to 0 for no logging via UART, needed if you are using it for other serial things (eg PZEM)
|
||||
#baud_rate: 0 # Set to 0 for no logging via UART if UART is needed elsewhere
|
||||
#esp8266_store_log_strings_in_flash: false
|
||||
#tx_buffer_size: 64
|
||||
|
||||
#:########################################################################################:#
|
||||
# MQTT: Device-specific MQTT command triggers
|
||||
# This adds device-specific MQTT command triggers to the common MQTT configuration.
|
||||
# This extends the common MQTT package with local custom command/status topics.
|
||||
#:########################################################################################:#
|
||||
mqtt:
|
||||
# Republish current relay state whenever MQTT reconnects so retained status stays accurate
|
||||
# for subscribers that reconnect later.
|
||||
on_connect:
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_status_topic1}"
|
||||
@@ -161,23 +181,23 @@ mqtt:
|
||||
retain: true
|
||||
|
||||
on_message:
|
||||
# Mirror remote command onto Relay_1, but only if a real state change is needed.
|
||||
# Do not republish the command from here. Relay status is published by the relay callback.
|
||||
- topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_on}"
|
||||
then:
|
||||
- delay: 50ms
|
||||
- if:
|
||||
condition:
|
||||
lambda: 'return !id(Relay_1).state;'
|
||||
lambda: "return !id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_on: Relay_1
|
||||
|
||||
- topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_off}"
|
||||
then:
|
||||
- delay: 50ms
|
||||
- if:
|
||||
condition:
|
||||
lambda: 'return id(Relay_1).state;'
|
||||
lambda: "return id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_off: Relay_1
|
||||
|
||||
@@ -187,8 +207,55 @@ mqtt:
|
||||
#:########################################################################################:#
|
||||
status_led:
|
||||
pin:
|
||||
number: GPIO02
|
||||
inverted: yes
|
||||
number: GPIO2
|
||||
inverted: true
|
||||
|
||||
#:########################################################################################:#
|
||||
# SCRIPTS
|
||||
# https://esphome.io/components/script.html
|
||||
#:########################################################################################:#
|
||||
script:
|
||||
# Local/HA requested ON. Change the local relay immediately, then publish a non-retained
|
||||
# command so any other linked switch follows.
|
||||
- id: mainhallway_mainlights_on
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return !id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_on: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_on}"
|
||||
retain: false
|
||||
|
||||
# Local/HA requested OFF. Change the local relay immediately, then publish a non-retained
|
||||
# command so any other linked switch follows.
|
||||
- id: mainhallway_mainlights_off
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_off: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_off}"
|
||||
retain: false
|
||||
|
||||
# Physical button toggle logic. This is the only place that decides ON vs OFF.
|
||||
- id: mainhallway_mainlights_toggle
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return id(Relay_1).state;"
|
||||
then:
|
||||
- script.execute: mainhallway_mainlights_off
|
||||
else:
|
||||
- script.execute: mainhallway_mainlights_on
|
||||
|
||||
#:########################################################################################:#
|
||||
# BINARY SENSORS
|
||||
@@ -205,29 +272,32 @@ binary_sensor:
|
||||
- delayed_on: 10ms
|
||||
- delayed_off: 10ms
|
||||
on_press:
|
||||
- if:
|
||||
condition:
|
||||
switch.is_on: Relay_1
|
||||
then:
|
||||
- switch.turn_off: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_off}"
|
||||
else:
|
||||
- switch.turn_on: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_on}"
|
||||
- script.execute: mainhallway_mainlights_toggle
|
||||
|
||||
#:########################################################################################:#
|
||||
# SWITCH
|
||||
# https://esphome.io/components/switch/
|
||||
#:########################################################################################:#
|
||||
switch:
|
||||
- platform: gpio
|
||||
# Exposed Home Assistant control. This is the switch to use in HA.
|
||||
- platform: template
|
||||
name: "Relay 1: ${switch_1_name}"
|
||||
id: Relay_1_HA
|
||||
lambda: |-
|
||||
return id(Relay_1).state;
|
||||
turn_on_action:
|
||||
- script.execute: mainhallway_mainlights_on
|
||||
turn_off_action:
|
||||
- script.execute: mainhallway_mainlights_off
|
||||
|
||||
# Physical relay. Kept internal so HA uses the template switch above.
|
||||
# Relay callbacks publish retained status only, not commands.
|
||||
- platform: gpio
|
||||
name: "Internal Relay 1: ${switch_1_name}"
|
||||
internal: true
|
||||
pin: GPIO12
|
||||
id: Relay_1
|
||||
restore_mode: ${relay_restore_mode}
|
||||
on_turn_on:
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_status_topic1}"
|
||||
|
||||
@@ -1,39 +1,56 @@
|
||||
#:########################################################################################:#
|
||||
# TITLE: MAIN HALLWAY LIGHTSWITCH 2 (BK7231N)
|
||||
# TITLE: MAIN HALLWAY NIGHTLIGHTS SWITCH (BK7231N)
|
||||
# zorruno.com layout v1.1 2026
|
||||
#:########################################################################################:#
|
||||
# REPO:
|
||||
# https://home.fox.co.nz/gitea/zorruno/zorruno-homeassistant/src/branch/master/esphome/esp-mainhallwaylights2.yaml
|
||||
# https://home.fox.co.nz/gitea/zorruno/zorruno-homeassistant/src/branch/master/esphome/esp-mainhallwaynightlights.yaml
|
||||
#:########################################################################################:#
|
||||
# VERSIONS:
|
||||
# V1.1 2026-04-03 Updated yaml to zorruno layout V1.1; corrected KS-811 single naming and operation notes; updated BK7231N single-switch pin mapping
|
||||
# V1.2 2026-05-07 Refactored MQTT sync to use template HA switch actions; physical button and
|
||||
# HA control now publish command topics; relay callbacks publish status only
|
||||
# to prevent command ping-pong/chattering.
|
||||
# V1.1 2026-04-03 Updated yaml to zorruno layout V1.1; corrected KS-811 single naming and
|
||||
# operation notes; updated BK7231N single-switch pin mapping
|
||||
# V1.0 2026-04-03 Initial
|
||||
#:########################################################################################:#
|
||||
# HARDWARE:
|
||||
# - Zemismart KS-811 Single push button
|
||||
# - BK7231N based switch
|
||||
# - BK72XX board: generic-bk7231n-qfn32-tuya
|
||||
# - BK7231N single-switch pin mapping checked against KS-811 BK references
|
||||
# - BK7231N single-switch pin mapping:
|
||||
# - Button 1: P24
|
||||
# - Relay 1: P16
|
||||
# - Status LED: P22 inverted
|
||||
#:########################################################################################:#
|
||||
# OPERATION NOTES:
|
||||
# - Main hallway nightlight switch with 1 output:
|
||||
# - Main hallway nightlights switch with 1 output:
|
||||
# 1) Main Hallway Nightlights
|
||||
# - A single press of the physical button toggles Relay 1 ON/OFF
|
||||
# - Status LED uses P22
|
||||
# - A single press of the physical button toggles the Main Hallway Nightlights group.
|
||||
# - Home Assistant control of the exposed template switch also toggles the same group.
|
||||
# - MQTT command topic requests On/Off changes.
|
||||
# - Relay state changes publish retained status only.
|
||||
# - Relays never publish command topics directly. This prevents command ping-pong/chattering.
|
||||
# - This switch shares the mainhallway-nightlights command topic with Relay 2 on the
|
||||
# Main Hallway North Lightswitch.
|
||||
#:########################################################################################:#
|
||||
# MQTT COMMANDS:
|
||||
# - None
|
||||
# - ${mqtt_this_device_command_topic1}
|
||||
# Payloads: ${mqtt_command_on}, ${mqtt_command_off}
|
||||
# - Status topic:
|
||||
# - ${mqtt_this_device_status_topic1}
|
||||
# Payloads mirror the actual relay state and are published retained.
|
||||
#:########################################################################################:#
|
||||
# OFFLINE NOTES:
|
||||
# - a) Home Assistant offline (network and MQTT online):
|
||||
# - Device remains on WiFi and MQTT
|
||||
# - Physical button still toggles relay locally
|
||||
# - Local button control continues.
|
||||
# - MQTT command/status operation continues.
|
||||
# - b) MQTT offline (or Home Assistant and MQTT offline):
|
||||
# - Physical button still toggles relay locally
|
||||
# - Remote control/state sync is unavailable until MQTT returns
|
||||
# - Local button control continues.
|
||||
# - If Home Assistant is online and connected by native ESPHome API, HA control can still
|
||||
# change the local relay but remote MQTT sync is unavailable until MQTT returns.
|
||||
# - c) Entire WiFi/network offline:
|
||||
# - Physical button still toggles relay locally
|
||||
# - Accurate time is not needed; SNTP is not used
|
||||
# - Local wall-switch button control continues.
|
||||
# - Accurate time is not needed. SNTP is not used for this device.
|
||||
#:########################################################################################:#
|
||||
|
||||
#:########################################################################################:#
|
||||
@@ -49,7 +66,7 @@ substitutions:
|
||||
|
||||
# Project Naming
|
||||
project_name: "Zemismart Technologies.KS-811 Single BK7231N" # Project Details
|
||||
project_version: "v1.1" # Project V denotes release of yaml file, allowing checking of deployed vs latest version
|
||||
project_version: "v1.2" # Project V denotes release of yaml file, allowing checking of deployed vs latest version
|
||||
|
||||
# Passwords
|
||||
api_key: !secret esp-api_key # unfortunately you can't use substitutions inside secrets names
|
||||
@@ -63,21 +80,21 @@ substitutions:
|
||||
current_ip_address: ${static_ip_address}
|
||||
|
||||
# Device Settings
|
||||
log_level: "INFO" # Define logging level: NONE, ERROR, WARN, INFO, DEBUG (Default), VERBOSE, VERY_VERBOSE
|
||||
update_interval: "60s" # update time for for general sensors etc
|
||||
log_level: "INFO" # NONE, ERROR, WARN, INFO, DEBUG, VERBOSE, VERY_VERBOSE
|
||||
update_interval: "60s" # General sensor update interval
|
||||
|
||||
# MQTT REMOTE Controls
|
||||
# Default relay restore mode
|
||||
# Options: RESTORE_DEFAULT_OFF, RESTORE_DEFAULT_ON, ALWAYS_ON, ALWAYS_OFF
|
||||
relay_restore_mode: "RESTORE_DEFAULT_OFF"
|
||||
|
||||
# MQTT Remote Controls
|
||||
mqtt_this_device_function1: "mainhallway-nightlights"
|
||||
mqtt_this_device_command_topic1: "${mqtt_command_main_topic}/${mqtt_this_device_function1}"
|
||||
mqtt_this_device_status_topic1: "${mqtt_status_main_topic}/${mqtt_this_device_function1}"
|
||||
mqtt_command_on: "On"
|
||||
mqtt_command_off: "Off"
|
||||
|
||||
# Default relay restore mode
|
||||
# Options: RESTORE_DEFAULT_OFF, RESTORE_DEFAULT_ON, ALWAYS_ON, ALWAYS_OFF
|
||||
relay_restore_mode: "RESTORE_DEFAULT_OFF"
|
||||
|
||||
# Switch/Relay/Button Naming & Icons
|
||||
# Switch/Relay/Button Naming
|
||||
switch_1_name: "Main Hallway Nightlights"
|
||||
|
||||
#:########################################################################################:#
|
||||
@@ -137,7 +154,7 @@ wifi:
|
||||
esphome:
|
||||
name: "${device_name}"
|
||||
friendly_name: "${friendly_name}"
|
||||
comment: "${description_comment}" # Appears on the esphome page in HA
|
||||
comment: "${description_comment}" # Appears on the ESPHome page in HA
|
||||
area: "${device_area}"
|
||||
project:
|
||||
name: "${project_name}"
|
||||
@@ -156,15 +173,17 @@ bk72xx:
|
||||
# https://esphome.io/components/logger.html
|
||||
#:########################################################################################:#
|
||||
logger:
|
||||
level: "${log_level}" # INFO Level suggested, or DEBUG for testing
|
||||
baud_rate: 0 # set to 0 for no logging via UART, needed if you are using it for other serial things (eg PZEM)
|
||||
level: "${log_level}" # INFO Level suggested, or DEBUG for testing
|
||||
baud_rate: 0 # set to 0 for no logging via UART, needed if you are using it for other serial things
|
||||
id: logger_id
|
||||
|
||||
#:########################################################################################:#
|
||||
# MQTT: Device-specific MQTT command triggers
|
||||
# This adds device-specific MQTT command triggers to the common MQTT configuration.
|
||||
# This extends the common MQTT package with local custom command/status topics.
|
||||
#:########################################################################################:#
|
||||
mqtt:
|
||||
# Republish current relay state whenever MQTT reconnects so retained status stays accurate
|
||||
# for subscribers that reconnect later.
|
||||
on_connect:
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_status_topic1}"
|
||||
@@ -173,23 +192,23 @@ mqtt:
|
||||
retain: true
|
||||
|
||||
on_message:
|
||||
# Mirror remote command onto Relay_1, but only if a real state change is needed.
|
||||
# Do not republish the command from here. Relay status is published by the relay callback.
|
||||
- topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_on}"
|
||||
then:
|
||||
- delay: 50ms
|
||||
- if:
|
||||
condition:
|
||||
lambda: 'return !id(Relay_1).state;'
|
||||
lambda: "return !id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_on: Relay_1
|
||||
|
||||
- topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_off}"
|
||||
then:
|
||||
- delay: 50ms
|
||||
- if:
|
||||
condition:
|
||||
lambda: 'return id(Relay_1).state;'
|
||||
lambda: "return id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_off: Relay_1
|
||||
|
||||
@@ -202,6 +221,53 @@ status_led:
|
||||
number: P22 # GPIO22
|
||||
inverted: true
|
||||
|
||||
#:########################################################################################:#
|
||||
# SCRIPTS
|
||||
# https://esphome.io/components/script.html
|
||||
#:########################################################################################:#
|
||||
script:
|
||||
# Local/HA requested ON. Change the local relay immediately, then publish a non-retained
|
||||
# command so the matching relay on the north switch follows.
|
||||
- id: mainhallway_nightlights_on
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return !id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_on: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_on}"
|
||||
retain: false
|
||||
|
||||
# Local/HA requested OFF. Change the local relay immediately, then publish a non-retained
|
||||
# command so the matching relay on the north switch follows.
|
||||
- id: mainhallway_nightlights_off
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_off: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_off}"
|
||||
retain: false
|
||||
|
||||
# Physical button toggle logic. This is the only place that decides ON vs OFF.
|
||||
- id: mainhallway_nightlights_toggle
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return id(Relay_1).state;"
|
||||
then:
|
||||
- script.execute: mainhallway_nightlights_off
|
||||
else:
|
||||
- script.execute: mainhallway_nightlights_on
|
||||
|
||||
#:########################################################################################:#
|
||||
# BINARY SENSORS:
|
||||
# https://esphome.io/components/binary_sensor/
|
||||
@@ -211,7 +277,7 @@ binary_sensor:
|
||||
id: button_1
|
||||
internal: true
|
||||
pin:
|
||||
number: P24
|
||||
number: P24 # GPIO24
|
||||
mode:
|
||||
input: true
|
||||
pullup: true
|
||||
@@ -221,28 +287,31 @@ binary_sensor:
|
||||
- delayed_on: 10ms
|
||||
- delayed_off: 10ms
|
||||
on_press:
|
||||
- if:
|
||||
condition:
|
||||
switch.is_on: Relay_1
|
||||
then:
|
||||
- switch.turn_off: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_off}"
|
||||
else:
|
||||
- switch.turn_on: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_on}"
|
||||
- script.execute: mainhallway_nightlights_toggle
|
||||
|
||||
#:########################################################################################:#
|
||||
# SWITCH COMPONENT:
|
||||
# https://esphome.io/components/switch/
|
||||
#:########################################################################################:#
|
||||
switch:
|
||||
- platform: gpio
|
||||
# Exposed Home Assistant control. This controls the local relay and publishes the matching
|
||||
# command so the Main Hallway North Lightswitch nightlights relay follows.
|
||||
- platform: template
|
||||
name: "Relay 1: ${switch_1_name}"
|
||||
pin: P16
|
||||
id: Relay_1_HA
|
||||
lambda: |-
|
||||
return id(Relay_1).state;
|
||||
turn_on_action:
|
||||
- script.execute: mainhallway_nightlights_on
|
||||
turn_off_action:
|
||||
- script.execute: mainhallway_nightlights_off
|
||||
|
||||
# Physical relay. Kept internal so HA uses the template switch above.
|
||||
# Relay callbacks publish retained status only, not commands.
|
||||
- platform: gpio
|
||||
name: "Internal Relay 1: ${switch_1_name}"
|
||||
internal: true
|
||||
pin: P16 # GPIO16
|
||||
id: Relay_1
|
||||
restore_mode: ${relay_restore_mode}
|
||||
on_turn_on:
|
||||
|
||||
@@ -6,6 +6,9 @@
|
||||
# https://home.fox.co.nz/gitea/zorruno/zorruno-homeassistant/src/branch/master/esphome/esp-mainhallwaynorthlightswitch.yaml
|
||||
#:########################################################################################:#
|
||||
# VERSIONS:
|
||||
# V1.2 2026-05-07 Refactored MQTT sync to use template HA switch actions; physical buttons and
|
||||
# HA controls now publish command topics; relay callbacks publish status only
|
||||
# to prevent command ping-pong/chattering.
|
||||
# V1.1 2026-04-04 Updated yaml to zorruno layout V1.1; checked KS-811 dual ESP8266 GPIO mapping;
|
||||
# corrected Relay 2 naming; added MQTT state republish on reconnect; added
|
||||
# GPIO16 polling for Button 1 compatibility; expanded notes/comments
|
||||
@@ -22,11 +25,12 @@
|
||||
# - Status LED: GPIO2 (inverted)
|
||||
#:########################################################################################:#
|
||||
# OPERATION NOTES:
|
||||
# - Button 1 toggles Relay 1 locally.
|
||||
# - Button 2 toggles Relay 2 locally.
|
||||
# - MQTT command topics can also turn each relay On or Off.
|
||||
# - Custom MQTT status topics publish the actual relay state after local or MQTT changes.
|
||||
# - Current relay states are also republished whenever MQTT reconnects, helping late subscribers.
|
||||
# - Button 1 toggles the Main Hallway Lights group.
|
||||
# - Button 2 toggles the Main Hallway Nightlights group.
|
||||
# - Home Assistant control of the exposed template switches also toggles the matching groups.
|
||||
# - MQTT command topics request On/Off changes.
|
||||
# - Relay state changes publish retained status only.
|
||||
# - Relays never publish command topics directly. This prevents command ping-pong/chattering.
|
||||
# - GPIO16 on ESP8266 does not support normal GPIO interrupts, so Button 1 uses polling mode.
|
||||
#:########################################################################################:#
|
||||
# MQTT COMMANDS:
|
||||
@@ -46,8 +50,8 @@
|
||||
#
|
||||
# b) MQTT offline (or HA and MQTT offline)
|
||||
# - Local button control continues.
|
||||
# - If Home Assistant is online and connected by native ESPHome API, HA control can still work.
|
||||
# - Custom MQTT commands/status are unavailable until MQTT returns.
|
||||
# - If Home Assistant is online and connected by native ESPHome API, HA control can still
|
||||
# change the local relays but remote MQTT sync is unavailable until MQTT returns.
|
||||
#
|
||||
# c) Entire WiFi/network offline
|
||||
# - Local wall-switch button control continues for both relays.
|
||||
@@ -67,7 +71,7 @@ substitutions:
|
||||
|
||||
# Project Naming
|
||||
project_name: "Zemismart Technologies.KS-811 Double"
|
||||
project_version: "v1.1" # Project V denotes release of yaml file, allowing checking of deployed vs latest version
|
||||
project_version: "v1.2" # Project V denotes release of yaml file, allowing checking of deployed vs latest version
|
||||
|
||||
# Passwords
|
||||
api_key: !secret esp-api_key # unfortunately you can't use substitutions inside secrets names
|
||||
@@ -84,6 +88,10 @@ substitutions:
|
||||
log_level: "INFO" # NONE, ERROR, WARN, INFO, DEBUG, VERBOSE, VERY_VERBOSE
|
||||
update_interval: "60s" # General sensor update interval
|
||||
|
||||
# Default relay restore mode
|
||||
# Options: RESTORE_DEFAULT_OFF, RESTORE_DEFAULT_ON, ALWAYS_ON, ALWAYS_OFF
|
||||
relay_restore_mode: "RESTORE_DEFAULT_OFF"
|
||||
|
||||
# MQTT Remote Controls
|
||||
mqtt_this_device_function1: "mainhallway-mainlights"
|
||||
mqtt_this_device_command_topic1: "${mqtt_command_main_topic}/${mqtt_this_device_function1}"
|
||||
@@ -190,7 +198,8 @@ mqtt:
|
||||
retain: true
|
||||
|
||||
on_message:
|
||||
# Mirror remote state onto Relay_1, but only if a real state change is needed.
|
||||
# Mirror remote command onto Relay_1, but only if a real state change is needed.
|
||||
# Do not republish the command from here. Relay status is published by the relay callback.
|
||||
- topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_on}"
|
||||
then:
|
||||
@@ -209,7 +218,8 @@ mqtt:
|
||||
then:
|
||||
- switch.turn_off: Relay_1
|
||||
|
||||
# Mirror remote state onto Relay_2, but only if a real state change is needed.
|
||||
# Mirror remote command onto Relay_2, but only if a real state change is needed.
|
||||
# Do not republish the command from here. Relay status is published by the relay callback.
|
||||
- topic: "${mqtt_this_device_command_topic2}"
|
||||
payload: "${mqtt_command_on}"
|
||||
then:
|
||||
@@ -237,6 +247,93 @@ status_led:
|
||||
number: GPIO2
|
||||
inverted: true
|
||||
|
||||
#:########################################################################################:#
|
||||
# SCRIPTS
|
||||
# https://esphome.io/components/script.html
|
||||
#:########################################################################################:#
|
||||
script:
|
||||
# Local/HA requested ON for Main Hallway Lights. Change the local relay immediately, then
|
||||
# publish a non-retained command so any other linked switch follows.
|
||||
- id: mainhallway_mainlights_on
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return !id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_on: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_on}"
|
||||
retain: false
|
||||
|
||||
# Local/HA requested OFF for Main Hallway Lights.
|
||||
- id: mainhallway_mainlights_off
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return id(Relay_1).state;"
|
||||
then:
|
||||
- switch.turn_off: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_off}"
|
||||
retain: false
|
||||
|
||||
# Physical Button 1 toggle logic.
|
||||
- id: mainhallway_mainlights_toggle
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return id(Relay_1).state;"
|
||||
then:
|
||||
- script.execute: mainhallway_mainlights_off
|
||||
else:
|
||||
- script.execute: mainhallway_mainlights_on
|
||||
|
||||
# Local/HA requested ON for Main Hallway Nightlights. Change the local relay immediately,
|
||||
# then publish a non-retained command so any other linked switch follows.
|
||||
- id: mainhallway_nightlights_on
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return !id(Relay_2).state;"
|
||||
then:
|
||||
- switch.turn_on: Relay_2
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic2}"
|
||||
payload: "${mqtt_command_on}"
|
||||
retain: false
|
||||
|
||||
# Local/HA requested OFF for Main Hallway Nightlights.
|
||||
- id: mainhallway_nightlights_off
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return id(Relay_2).state;"
|
||||
then:
|
||||
- switch.turn_off: Relay_2
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic2}"
|
||||
payload: "${mqtt_command_off}"
|
||||
retain: false
|
||||
|
||||
# Physical Button 2 toggle logic.
|
||||
- id: mainhallway_nightlights_toggle
|
||||
mode: restart
|
||||
then:
|
||||
- if:
|
||||
condition:
|
||||
lambda: "return id(Relay_2).state;"
|
||||
then:
|
||||
- script.execute: mainhallway_nightlights_off
|
||||
else:
|
||||
- script.execute: mainhallway_nightlights_on
|
||||
|
||||
#:########################################################################################:#
|
||||
# BINARY SENSORS
|
||||
# https://esphome.io/components/binary_sensor/
|
||||
@@ -254,19 +351,7 @@ binary_sensor:
|
||||
- delayed_on: 10ms
|
||||
- delayed_off: 10ms
|
||||
on_press:
|
||||
- if:
|
||||
condition:
|
||||
switch.is_on: Relay_1
|
||||
then:
|
||||
- switch.turn_off: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_off}"
|
||||
else:
|
||||
- switch.turn_on: Relay_1
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic1}"
|
||||
payload: "${mqtt_command_on}"
|
||||
- script.execute: mainhallway_mainlights_toggle
|
||||
|
||||
- platform: gpio
|
||||
pin:
|
||||
@@ -279,29 +364,45 @@ binary_sensor:
|
||||
- delayed_on: 10ms
|
||||
- delayed_off: 10ms
|
||||
on_press:
|
||||
- if:
|
||||
condition:
|
||||
switch.is_on: Relay_2
|
||||
then:
|
||||
- switch.turn_off: Relay_2
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic2}"
|
||||
payload: "${mqtt_command_off}"
|
||||
else:
|
||||
- switch.turn_on: Relay_2
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_command_topic2}"
|
||||
payload: "${mqtt_command_on}"
|
||||
- script.execute: mainhallway_nightlights_toggle
|
||||
|
||||
#:########################################################################################:#
|
||||
# SWITCH
|
||||
# https://esphome.io/components/switch/
|
||||
#:########################################################################################:#
|
||||
switch:
|
||||
- platform: gpio
|
||||
# Exposed Home Assistant control for Main Hallway Lights. This controls the local relay and
|
||||
# publishes the matching command so linked switches follow.
|
||||
- platform: template
|
||||
name: "Relay 1: ${switch_1_name}"
|
||||
id: Relay_1_HA
|
||||
lambda: |-
|
||||
return id(Relay_1).state;
|
||||
turn_on_action:
|
||||
- script.execute: mainhallway_mainlights_on
|
||||
turn_off_action:
|
||||
- script.execute: mainhallway_mainlights_off
|
||||
|
||||
# Exposed Home Assistant control for Main Hallway Nightlights. Use this as the single HA
|
||||
# control for the nightlights group, provided other devices subscribe to the same command topic.
|
||||
- platform: template
|
||||
name: "Relay 2: ${switch_2_name}"
|
||||
id: Relay_2_HA
|
||||
lambda: |-
|
||||
return id(Relay_2).state;
|
||||
turn_on_action:
|
||||
- script.execute: mainhallway_nightlights_on
|
||||
turn_off_action:
|
||||
- script.execute: mainhallway_nightlights_off
|
||||
|
||||
# Physical Relay 1. Kept internal so HA uses the template switch above.
|
||||
# Relay callbacks publish retained status only, not commands.
|
||||
- platform: gpio
|
||||
name: "Internal Relay 1: ${switch_1_name}"
|
||||
internal: true
|
||||
pin: GPIO13
|
||||
id: Relay_1
|
||||
restore_mode: ${relay_restore_mode}
|
||||
on_turn_on:
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_status_topic1}"
|
||||
@@ -313,10 +414,14 @@ switch:
|
||||
payload: "${mqtt_command_off}"
|
||||
retain: true
|
||||
|
||||
# Physical Relay 2. Kept internal so HA uses the template switch above.
|
||||
# Relay callbacks publish retained status only, not commands.
|
||||
- platform: gpio
|
||||
name: "Relay 2: ${switch_2_name}"
|
||||
name: "Internal Relay 2: ${switch_2_name}"
|
||||
internal: true
|
||||
pin: GPIO12
|
||||
id: Relay_2
|
||||
restore_mode: ${relay_restore_mode}
|
||||
on_turn_on:
|
||||
- mqtt.publish:
|
||||
topic: "${mqtt_this_device_status_topic2}"
|
||||
|
||||
Reference in New Issue
Block a user