zorruno/zorruno-homeassistant
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

esphome devices & scripts

Browse Source
This commit is contained in:
root
2026-05-07 23:18:01 +12:00
parent ae00e821ba
commit 5e941eea06
448 changed files with 1407 additions and 204 deletions
Download Patch File Download Diff File Expand all files Collapse all files
esphome/esp-mainhallwaynorthlightswitch.yaml
+143 -38
View File
@@ -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}"