stair light control + pther fixes

2025-08-25 23:31:54 +12:00
parent 40e289e99a
commit 8adb0a63ba
9 changed files with 883 additions and 112 deletions
--- a/esphome/esp-occupancystair.yaml
+++ b/esphome/esp-occupancystair.yaml
@@ -1,7 +1,8 @@
-#############################################
-#############################################
+##########################################################################################
+##########################################################################################
 # HiLink LD2410 mmWave sensor, with BME280 Temp/Hum/Pres Sensor and PIR on an ESP32
 # VERSION
+# V2.1 2025-08-25 Added some MQTT to send commands to turn on remote lights
 # V2.0 2025-06-05 YAML Tidyups
 #
 # https://github.com/patrick3399/Hi-Link_mmWave_Radar_ESPHome/tree/main
@@ -11,13 +12,13 @@
 # https://www.simplysmart.house/blog/presence-detection-ld2410-home-assistant
 # 
 # The B and C versions of this device can use Bluetooth, but we are not using it here.
-#############################################
-#############################################
+##########################################################################################
+##########################################################################################

-#############################################
+##########################################################################################
 # SPECIFIC DEVICE VARIABLE SUBSTITUTIONS
 # If NOT using a secrets file, just replace these with the passwords etc (in quotes)
-#############################################
+##########################################################################################
 substitutions:
  # Device Naming
  device_name: "esp-occupancystair"
@@ -27,21 +28,31 @@ substitutions:

  # Project Naming
  project_name: "Generic.ESP32" # Project Details 
-  project_version: "v1.0"  # Project V denotes release of yaml file, allowing checking of deployed vs latest version
+  project_version: "v2.1"  # Project V denotes release of yaml file, allowing checking of deployed vs latest version

-  # Passwords
-  api_key: !secret esp-occupancystair_api_key # unfortunately you can't use substitutions inside secrets names
-  ota_pass: !secret esp-occupancystair_ota_pass # unfortunately you can't use substitutions inside secrets names
+  # Passwords & Secrets (unfortunately you can't use substitutions inside secrets names)
+  api_key: !secret esp-api_key 
+  ota_pass: !secret esp-ota_pass
  static_ip_address: !secret esp-occupancystair_ip
-  
+  mqtt_command_main_topic: !secret mqtt_command_main_topic
+  mqtt_status_main_topic: !secret mqtt_status_main_topic
+
  # Device Settings
+  #relay_icon: "mdi:lightbulb-group"
  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
+  
+  # MQTT REMOTE Controls
+  mqtt_remote_device1_name: "stair-footerlights"
+  mqtt_remote_device1_command_topic: "${mqtt_command_main_topic}/${mqtt_remote_device1_name}/set"
+  #mqtt_remote_device1_status_topic: "${mqtt_status_main_topic}/${mqtt_remote_device1_name}/state"
+  mqtt_remote_device_command_ON: "ON"
+  mqtt_remote_device_command_OFF: "OFF"
 
-#############################################
-# Included Common Packages
-# https://esphome.io/components/esphome.html
-#############################################
+#########################################################################################
+# PACKAGES: Included Common Packages
+# https://esphome.io/components/packages.html
+##########################################################################################
 packages:
  common_wifi: !include
    file: common/network_common.yaml
@@ -67,10 +78,10 @@ packages:
      local_friendly_name: "${friendly_name}"
      local_update_interval: "${update_interval}"

-#############################################
-# ESPHome
+##########################################################################################
+# ESPHome CORE CONFIGURATION
 # https://esphome.io/components/esphome.html
-#############################################
+##########################################################################################
 esphome:
  name: "${device_name}"
  friendly_name: "${friendly_name}"
@@ -81,55 +92,67 @@ esphome:
    #priority: -200
    #then:

-#############################################
-# ESP Platform and Framework
+##########################################################################################
+# ESP PLATFORM AND FRAMEWORK
+# https://esphome.io/components/esp8266.html
 # https://esphome.io/components/esp32.html
-#############################################
+##########################################################################################
 esp32:
  board: esp32dev
  framework:
    type: esp-idf  # "esp-idf" OR "arduino". Suggested ESP-IDF Framework, or Plug Out the UART Cable Might Cause ESP32 Hang. 
    version: recommended # recommended, latest or dev

-#############################################
-# i2s bus
+##########################################################################################
+# GLOBAL VARIABLES
+# https://esphome.io/components/globals.html
+##########################################################################################
+globals:
+  - id: stair_footer_auto_default_s
+    type: int
+    restore_value: yes
+    initial_value: '20'
+
+##########################################################################################
+# i2c BUS COMPONENT
 # https://esphome.io/components/i2c.html
-#############################################
+##########################################################################################
 i2c:
  sda: GPIO19
  scl: GPIO21
  scan: True
  frequency: 100kHz #10, 50, 100, 200, 800 are possible settings, 100kHz was reliable for me

-#############################################    
-# ESPHome Logging Enable
+##########################################################################################    
+# LOGGER COMPONENT
 # https://esphome.io/components/logger.html
-############################################# 
+# Logs all log messages through the serial port and through MQTT topics.
+########################################################################################## 
 logger:
  level: INFO  # 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)
  #esp8266_store_log_strings_in_flash: false
  #tx_buffer_size: 64

-#############################################    
-# Bluetooth
-# https://esphome.io/components/bluetooth_proxy.html
-# https://esphome.io/components/esp32_ble_tracker.html
+##########################################################################################    
+# BLUETOOTH
+# Proxy https://esphome.io/components/bluetooth_proxy.html
+# BLE https://esphome.io/components/esp32_ble_tracker.html
 # Remember that this takes a LOT of processing. On the 
 # ESP32, enable the  IDF framework, and disable the 
 # Web server component.  Changing to the IDF framework 
 # needs to be via cable not OTA to change the
 # partition setup.
-#############################################  
+##########################################################################################  
 #bluetooth_proxy:

 #esp32_ble_tracker:

-#############################################
-# UART Serial
-# hardware on EPS32, but software, and can be glitchy on ESP8266
-# https://esphome.io/components/uart.html?highlight=uart
-#############################################
+##########################################################################################
+# UART BUS
+# hardware on EPS32, but software (and can be glitchy) on ESP8266
+# https://esphome.io/components/uart.html
+##########################################################################################
 uart:
  id: ld2410_uart
  rx_pin: GPIO16  #For ESP32, you can use any pin, Recommend Use UART_2, Don't use UART_0, It might Cause Boot Fail or System Hang
@@ -139,21 +162,23 @@ uart:
  stop_bits: 1
  parity: NONE

-#############################################
-# General esp status LED
+#########################################################################################
+# STATUS LED
 # https://esphome.io/components/status_led.html
-#############################################
+#########################################################################################
+# ESP32 D1 Mini Board: Onboard Status LED on GPIO2, active-low
+#########################################################################################
 status_led:
  pin:
-    number: GPIO2 #ESP32 Onboard LED
+    number: GPIO2 # ESP32 Onboard LED
    ignore_strapping_warning: True #https://esphome.io/guides/faq.html#why-am-i-getting-a-warning-about-strapping-pins
    inverted: false

-#############################################
+##########################################################################################
 # LD2410 Sensors
 # https://esphome.io/components/sensor/ld2410.html
 # https://www.hlktech.net/index.php?id=988
-#############################################
+##########################################################################################
 ld2410:
  uart_id: ld2410_uart
  #uart_id (Optional, ID): Manually specify the ID of the UART Component if you want to use multiple UART buses.
@@ -171,6 +196,11 @@ ld2410:
  #still_energy (Optional, int): When in engineering mode, the still energy of the gate, otherwise unknown. Value between 0 and 100 inclusive. All options from Sensor.
 #ld2410_id (Optional, ID): Manually specify the ID for the LD2410 Sensor component if you are using multiple components.

+
+##########################################################################################
+# NUMBER COMPONENT
+# https://esphome.io/components/number/
+##########################################################################################
 #The ld2410 number values for setting thresholds
 #  timeout: 5s
 #  max_move_distance: 2.25m
@@ -249,12 +279,34 @@ number:
      still_threshold:
        name: "g8 still threshold"

-#The ld2410 select allows you to control your LD2410 Sensor.
-#distance_resolution (Optional): Control the gates distance resolution. Can be 0.75m or 0.2m. Defaults to 0.75m. All options from Select.
-#baud_rate (Optional): Control the serial port baud rate. Defaults to 256000. Once changed, all sensors will stop working until a fresh install with an updated UART Component configuration. All options from Select.
-#light_function (Optional): If set, will affect the OUT pin value, based on light threshold. Can be off, low or above. Defaults to off. All options from Select.
-#out_pin_level (Optional): Control OUT pin away value. Can be low or high. Defaults to low. All options from Select.
-#ld2410_id (Optional, ID): Manually specify the ID for the LD2410 Sensor component if you are using multiple components.
+  - platform: template
+    id: stair_footer_auto_time_s
+    name: "Stair Footer Lights Auto Time"
+    unit_of_measurement: s
+    min_value: 10
+    max_value: 300
+    step: 1
+    optimistic: true
+    restore_value: true
+    initial_value: 20
+
+#########################################################################################
+# SELECT COMPONENT
+# https://esphome.io/components/select/index.html
+#########################################################################################
+# LD2410 SELECT
+# distance_resolution (Optional): Control the gates distance resolution. Can be 0.75m or 0.2m. 
+#   Defaults to 0.75m. All options from Select.
+# baud_rate (Optional): Control the serial port baud rate. Defaults to 256000. Once changed, 
+#   all sensors will stop working until a fresh install with an updated UART Component 
+#   configuration. All options from Select.
+# light_function (Optional): If set, will affect the OUT pin value, based on light 
+#   threshold. Can be off, low or above. Defaults to off. All options from Select.
+# out_pin_level (Optional): Control OUT pin away value. Can be low or high. Defaults 
+#   to low. All options from Select.
+# ld2410_id (Optional, ID): Manually specify the ID for the LD2410 Sensor component
+#   if you are using multiple components.
+#########################################################################################
 select:
  - platform: ld2410
    distance_resolution: 
@@ -266,10 +318,10 @@ select:
    out_pin_level:
      name: "${friendly_name} LD2140 Out Pin Level"

-#############################################
-# General Sensors 
-# https://esphome.io/components/sensor/index.html
-#############################################
+##########################################################################################
+# SENSOR COMPONENT
+# https://esphome.io/components/sensor/
+##########################################################################################
 sensor:
  - platform: bme280_i2c
    temperature:
@@ -286,7 +338,8 @@ sensor:
    address: 0x76
    update_interval: "${update_interval}"   

-#The ld2410 sensor values
+  # The ld2410 sensor values
+  # https://esphome.io/components/sensor/ld2410/#sensor
  - platform: ld2410
    light:
      name: "Light"
@@ -346,29 +399,59 @@ sensor:
      still_energy:
        name: "g8 still energy"

+##########################################################################################
+# SWITCH COMPONENT
+# https://esphome.io/components/switch/
+##########################################################################################
 # The ld2410 switch allows you to control your LD2410 Sensor.
-#Bluetooth switch is only useful of you have a B or C model
+# Bluetooth switch is only useful of you have a B or C model
+##########################################################################################
 switch:
+  # https://esphome.io/components/sensor/ld2410/#switch
  - platform: ld2410
    engineering_mode:
      name: "${friendly_name} LD2140 Engineering Mode"
    #bluetooth:
      #name: "${friendly_name} LD2140 Control Bluetooth"

-#The ld2410 binary sensors to get presence notification
+  - platform: template
+    id: stair_footer_auto_enabled
+    name: "Stair Footer Lights Auto"
+    optimistic: true
+    restore_mode: RESTORE_DEFAULT_ON
+
+#########################################################################################
+# BINARY SENSORS
+# https://esphome.io/components/binary_sensor/
+#########################################################################################
 binary_sensor:
+  # The ld2410 binary sensors to get presence notification
+  # https://esphome.io/components/sensor/ld2410/#binary-sensor
  - platform: ld2410
    has_target:
      name: "mmWave Presence"
+      on_press:
+        - if:
+            condition:
+              switch.is_on: stair_footer_auto_enabled
+            then:
+              - script.execute: stair_footer_auto_script
    has_moving_target:
      name: "mmWave Moving Target"
+      on_press:
+        - if:
+            condition:
+              switch.is_on: stair_footer_auto_enabled
+            then:
+              - script.execute: stair_footer_auto_script
    has_still_target:
      name: "mmWave Still Target"
    out_pin_presence_status:
      name: "LD2140 Out Pin Presence Status"
      entity_category: diagnostic

-#Standard PIR Sensor
+# Generic PIR Sensor
+# https://devices.esphome.io/devices/Generic-PIR
  - platform: gpio
    pin:
      number: GPIO13
@@ -378,8 +461,21 @@ binary_sensor:
      inverted: true
    name: "PIR Sensor"
    device_class: motion
+    filters:
+      - delayed_on: 50ms
+    on_press:
+      - if:
+          condition:
+            switch.is_on: stair_footer_auto_enabled
+          then:
+            - script.execute: stair_footer_auto_script

-#The ld2410 button allows resetting
+#################################################################################################
+# BUTTON COMPONENT
+# https://esphome.io/components/button/index.html
+#################################################################################################
+# The ld2410 button allows resetting
+#################################################################################################
 button:
  - platform: ld2410
    factory_reset:
@@ -389,13 +485,41 @@ button:
    query_params:
      name: "Query Parameters"

-#The ld2410 text sensor allows you to get information about your LD2410 Sensor.
-#Bluetooth sensor is only useful of you have a B or C model
+#################################################################################################
+# TEXT SENSOR COMPONENT
+# https://esphome.io/components/text_sensor/
+#################################################################################################
 text_sensor:
+  # The ld2410 text sensor allows you to get information about your LD2410 Sensor.
+  # Bluetooth sensor is only useful of you have a B or C model
+  # https://esphome.io/components/sensor/ld2410/#text-sensor
  - platform: ld2410
    version:
      name: "${friendly_name} LD2140 Firmware Version"
    #mac_address:
      #name: "${friendly_name} LD2140 BT MAC Address"

+##########################################################################################
+# SCRIPT COMPONENT
+# https://esphome.io/components/script.html
+# Scripts can be executed nearly anywhere in your device configuration with a single call.
+##########################################################################################
+script:
+  # Sends commands to turn on and off a remote light
+  - id: stair_footer_auto_script
+    mode: restart
+    then:
+      # Turn lights on (command the Top switch's footer relay)
+      - mqtt.publish:
+          topic: "${mqtt_remote_device1_command_topic}"
+          payload: "${mqtt_remote_device_command_ON}"
+          retain: false

+      # Wait for the HA-adjustable timeout
+      - delay: !lambda 'return (uint32_t)(id(stair_footer_auto_time_s).state) * 1000;'
+
+      # Turn lights back off
+      - mqtt.publish:
+          topic: "${mqtt_remote_device1_command_topic}"
+          payload: "${mqtt_remote_device_command_OFF}"
+          retain: false