############################################# ############################################# # HiLink LD1125H mmWave sensor, with BME280 Temp/Hum/Pres Sensor on an ESP32 # https://zorruno.com/2024/mmwave-occupancy-with-esp32-ld1125h/ # # https://github.com/patrick3399/Hi-Link_mmWave_Radar_ESPHome/tree/main # https://github.com/patrick3399/Hi-Link_mmWave_Radar_ESPHome/blob/main/LD1125H/ESP32-LD1125H-Complete.yaml # # mth1: 0 to 2.8m sensitive # mth2: 2.8 to 8m sensitive # mth3: above 8m sensitive # rmax: max distance # Clearance Time: Mov/Occ to Clearance waiting time # Movement Time: Mov to Occ waiting time # ############################################# ############################################# ############################################# # SPECIFIC DEVICE VARIABLE SUBSTITUTIONS # If NOT using a secrets file, just replace these with the passwords etc (in quotes) ############################################# substitutions: devicename: "esp-occupancyoffice" friendly_name: "Office Occupancy & Environment" description_comment: "D1 Mini ESP32 with LD1125H mmWave and environment sensors for downstairs office" api_key: !secret esp-occupancyoffice_api_key #unfortunately you can't use substitutions inside secrets names ota_pass: !secret esp-occupancyoffice_ota_pass #unfortunately you can't use substitutions inside secrets names static_ip_address: !secret esp-occupancyoffice_ip 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 room: "Office" # Allows ESP device to be automatically linked to an 'Area' in Home Assistant. ############################################# # SPECIFIC PROJECT VARIABLE SUBSTITUTIONS ############################################# # # ############################################# # Included Common Packages # https://esphome.io/components/esphome.html ############################################# packages: common_wifi: !include file: common/network_common.yaml vars: local_static_ip_address: ${static_ip_address} local_ota_pass: ${ota_pass} # common_api: !include # file: common/api_common.yaml # vars: # local_api_key: ${api_key} common_webportal: !include file: common/webportal_common.yaml common_mqtt: !include file: common/mqtt_common.yaml common_sntp: !include file: common/sntp_common.yaml common_general_sensors: !include file: common/sensors_common.yaml vars: local_friendly_name: ${friendly_name} local_update_interval: ${update_interval} ############################################# # ESPHome # https://esphome.io/components/esphome.html ############################################# esphome: name: ${devicename} friendly_name: ${friendly_name} comment: ${description_comment} #appears on the esphome page in HA min_version: 2024.6.0 area: "${room}" on_boot: #LD1125H Initial Setting, will remember previous values (if set) priority: -200 then: - uart.write: id: LD1125H_UART_BUS data: !lambda |- std::string th1st = "mth1=" + str_sprintf("%.0f",id(LD1125H_mth1).state) +"\r\n"; return std::vector(th1st.begin(), th1st.end()); - uart.write: id: LD1125H_UART_BUS data: !lambda |- std::string th2st = "mth2=" + str_sprintf("%.0f",id(LD1125H_mth2).state) +"\r\n"; return std::vector(th2st.begin(), th2st.end()); - uart.write: id: LD1125H_UART_BUS data: !lambda |- std::string th3st = "mth3=" + str_sprintf("%.0f",id(LD1125H_mth3).state) +"\r\n"; return std::vector(th3st.begin(), th3st.end()); - uart.write: id: LD1125H_UART_BUS data: !lambda |- std::string rmaxst = "rmax=" + str_sprintf("%.1f",id(LD1125H_rmax).state) +"\r\n"; return std::vector(rmaxst.begin(), rmaxst.end()); ############################################# # ESP Platform and Framework # https://esphome.io/components/esp32.html ############################################# esp32: board: esp32dev framework: #type: arduino type: esp-idf #Suggest using the ESP-IDF Framework. Changing from arduino to esp-idf needs a cabled download to change partitions version: recommended #recommended, latest or dev ############################################# # ESPHome external or custom components to use # https://esphome.io/components/external_components.html # https://github.com/ssieb/esphome_components/tree/master/components/serial ############################################# external_components: - source: type: git url: https://github.com/ssieb/custom_components #Thanks for @ssieb components. components: [ serial ] #text_sensor that reads lines for a uart. Also, a sensor that reads single binary values from the uart. ############################################# # ESPHome Logging Enable # 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) #esp8266_store_log_strings_in_flash: false #tx_buffer_size: 64 ############################################# # Enable the Home Assistant API # https://esphome.io/components/api.html ############################################# api: encryption: key: ${api_key} on_client_connected: - esp32_ble_tracker.start_scan: continuous: true on_client_disconnected: - esp32_ble_tracker.stop_scan: ############################################# # i2c bus # https://esphome.io/components/i2c.html # 10, 50, 100, 200, 800 are possible settings # for frequency, 50kHz is default ############################################# i2c: sda: GPIO19 scl: GPIO21 scan: True #look for devices on boot up and report frequency: 50kHz ############################################# # UART Serial # hardware on EPS32, but software, and can be glitchy on ESP8266 # https://esphome.io/components/uart.html ############################################# uart: id: LD1125H_UART_BUS 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 tx_pin: GPIO17 #For ESP32, you can use any pin, Recommend Use UART_2, Don't use UART_0, It might Cause Boot Fail or System Hang baud_rate: 115200 data_bits: 8 stop_bits: 1 parity: NONE ############################################# # Bluetooth # https://esphome.io/components/bluetooth_proxy.html # 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: active: true cache_services: true esp32_ble_tracker: scan_parameters: continuous: false ############################################# # Global Variables for use in automations etc # https://esphome.io/guides/automations.html?highlight=globals#global-variables ############################################# globals: - id: LD1125H_Last_Time type: time_t restore_value: no #initial_value: time(NULL) #initial_value: !lambda 'return ::time(nullptr);' initial_value: "0" - id: LD1125H_Last_Mov_Time type: time_t restore_value: no #initial_value: time(NULL) #initial_value: !lambda 'return ::time(nullptr);' initial_value: "0" - id: LD1125H_Clearence_Status type: bool restore_value: no initial_value: "false" ############################################# # General esp status LED # https://esphome.io/components/status_led.html ############################################# status_led: pin: 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 ############################################# # Interval Automations # https://esphome.io/guides/automations.html ############################################# interval: - interval: 1s #Clearance Scan Time setup_priority: -200 then: lambda: |- if ((time(NULL)-id(LD1125H_Last_Time))>id(LD1125H_Clear_Time).state) { if ((id(LD1125H_Clearence_Status) == false) || (id(LD1125H_Occupancy).state != "Clearance")) { id(LD1125H_Occupancy).publish_state("Clearance"); id(LD1125H_Clearence_Status) = true; } if (id(LD1125H_MovOcc_Binary).state == true) { id(LD1125H_MovOcc_Binary).publish_state(false); } if (id(LD1125H_Mov_Binary).state == true) { id(LD1125H_Mov_Binary).publish_state(false); } } ############################################# # Number Sensors (custom component) # refer https://github.com/ssieb/esphome_components/tree/master/components/serial ############################################# number: - platform: template name: ${friendly_name} LD1125H mth1 #mth1 is 0~2.8m Sensitivity. id: LD1125H_mth1 icon: "mdi:cogs" optimistic: true restore_value: true #If you don't want to store the setting at ESP, set it to false. initial_value: "60.0" #Default mth1 Setting min_value: 10.0 max_value: 600.0 step: 5.0 set_action: then: - uart.write: id: LD1125H_UART_BUS data: !lambda |- std::string th1st = "mth1=" + str_sprintf("%.0f",x) +"\r\n"; return std::vector(th1st.begin(), th1st.end()); - platform: template name: ${friendly_name} LD1125H mth2 #mth2 is 2.8~8m Sensitivity. id: LD1125H_mth2 icon: "mdi:cogs" optimistic: true restore_value: true #If you don't want to store the setting at ESP, set it to false. initial_value: "30" #Default mth2 Setting min_value: 5 max_value: 300 step: 5 set_action: then: - uart.write: id: LD1125H_UART_BUS data: !lambda |- std::string th2st = "mth2=" + str_sprintf("%.0f",x) +"\r\n"; return std::vector(th2st.begin(), th2st.end()); - platform: template name: ${friendly_name} LD1125H mth3 #mth3 is above 8m Sensitivity. id: LD1125H_mth3 icon: "mdi:cogs" optimistic: true restore_value: true #If you don't want to store the setting at ESP, set it to false. initial_value: "20" #Default mth3 Setting min_value: 5 max_value: 200 step: 5 set_action: then: - uart.write: id: LD1125H_UART_BUS data: !lambda |- std::string th3st = "mth3=" + str_sprintf("%.0f",x) +"\r\n"; return std::vector(th3st.begin(), th3st.end()); - platform: template name: ${friendly_name} LD1125H rmax #rmax is max detection distance. id: LD1125H_rmax icon: "mdi:cogs" optimistic: true restore_value: true #If you don't want to store the setting at ESP, set it to false. initial_value: "8" #Default rmax Setting min_value: 0.4 max_value: 12 step: 0.1 set_action: then: - uart.write: id: LD1125H_UART_BUS data: !lambda |- std::string rmaxst = "rmax=" + str_sprintf("%.1f",x) +"\r\n"; return std::vector(rmaxst.begin(), rmaxst.end()); - platform: template name: ${friendly_name} LD1125H Clearence Time id: LD1125H_Clear_Time icon: "mdi:cogs" optimistic: true restore_value: true #If you don't want to store the setting at ESP, set it to false. initial_value: "5" #LD1125H Mov/Occ > Clearence Time Here min_value: 0.5 max_value: 20 step: 0.5 - platform: template name: ${friendly_name} LD1125H Movement Time id: LD1125H_Mov_Time icon: "mdi:cogs" optimistic: true restore_value: true #If you don't want to store the setting at ESP, set it to false. initial_value: "1" #LD1125H Mov > Occ Time Here min_value: 0.5 max_value: 10 step: 0.5 ############################################# # General Sensors # https://esphome.io/components/sensor/index.html ############################################# sensor: - platform: bme280_i2c temperature: name: "Temperature" accuracy_decimals: 1 oversampling: 2x pressure: name: "Pressure" oversampling: 2x humidity: name: "Humidity" accuracy_decimals: 1 oversampling: 2x address: 0x76 update_interval: ${update_interval} - platform: template name: "mmWave Distance" id: LD1125H_Distance icon: "mdi:signal-distance-variant" unit_of_measurement: "m" accuracy_decimals: 2 filters: # Use Fliter To Debounce - sliding_window_moving_average: window_size: 8 send_every: 2 - heartbeat: 0.2s ############################################# # Text Sensors # refer https://esphome.io/components/text_sensor/index.html ############################################# text_sensor: - platform: serial uart_id: LD1125H_UART_BUS name: ${friendly_name} LD1125H UART Text id: LD1125H_UART_Text icon: "mdi:format-text" internal: True #If Don't Want to See UART Receive Data, Set To True on_value: lambda: |- if (id(LD1125H_UART_Text).state.substr(0,3) == "occ") { id(LD1125H_Distance).publish_state(atof(id(LD1125H_UART_Text).state.substr(9).c_str())); if ((time(NULL)-id(LD1125H_Last_Mov_Time))>id(LD1125H_Mov_Time).state) { id(LD1125H_Occupancy).publish_state("Occupancy"); if (id(LD1125H_MovOcc_Binary).state == false) { id(LD1125H_MovOcc_Binary).publish_state(true); } if (id(LD1125H_Mov_Binary).state == true) { id(LD1125H_Mov_Binary).publish_state(false); } } if (id(LD1125H_MovOcc_Binary).state == false) { id(LD1125H_MovOcc_Binary).publish_state(true); } id(LD1125H_Last_Time) = time(NULL); if (id(LD1125H_Clearence_Status) == true) { id(LD1125H_Clearence_Status) = false; } } else if (id(LD1125H_UART_Text).state.substr(0,3) == "mov") { id(LD1125H_Distance).publish_state(atof(id(LD1125H_UART_Text).state.substr(9).c_str())); id(LD1125H_Occupancy).publish_state("Movement"); if (id(LD1125H_MovOcc_Binary).state == false) { id(LD1125H_MovOcc_Binary).publish_state(true); } if (id(LD1125H_Mov_Binary).state == false) { id(LD1125H_Mov_Binary).publish_state(true); } id(LD1125H_Last_Mov_Time) = time(NULL); id(LD1125H_Last_Time) = time(NULL); if (id(LD1125H_Clearence_Status) == true) { id(LD1125H_Clearence_Status) = false; } } - platform: template name: "mmWave Occupancy" id: LD1125H_Occupancy icon: "mdi:motion-sensor" ############################################# # Binary Sensors # https://esphome.io/components/binary_sensor/index.html ############################################# binary_sensor: - platform: status name: ${friendly_name} Status - platform: template name: "mmWave Occupancy or Movement" id: LD1125H_MovOcc_Binary device_class: occupancy - platform: template name: "mmWave Movement" id: LD1125H_Mov_Binary device_class: motion