############################################# ############################################# # 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 # ############################################# ############################################# ############################################# # VARIABLE SUBSTITUTIONS # Give the device a useful name & description here # and change values accordingly. ############################################# substitutions: devicename: "esp-occupancyoffice" friendly_name: "Office Occupancy & Environment" description_comment: "D1 Mini ESP32 with LD1125H mmWave and environment sensors for downstairs office" #if NOT using a secrets file, just replace these with the passwords etc (in quotes) 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 wifi_ssid: !secret wifi_ssid wifi_password: !secret wifi_password fallback_ap_password: !secret fallback_ap_password #Add these if we are giving it a static ip, or remove them in the Wifi section #static_ip_address: !secret esp-occupancyoffice_static_ip #static_ip_gateway: !secret esp-occupancyoffice_gateway #static_ip_subnet: !secret esp-occupancyoffice_subnet mqtt_server: !secret mqtt_server mqtt_username: !secret mqtt_username mqtt_password: !secret mqtt_password mqtt_topic: "esphome" #main topic for the mqtt server, call it what you like #web_server_username: !secret web_server_username #web_server_password: !secret web_server_password update_time: 30s #update time for for general temp sensors etc ############################################# # 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 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: 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 ############################################# # 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: ############################################# # Enable Over the Air Update Capability # https://esphome.io/components/ota.html?highlight=ota ############################################# ota: - platform: esphome password: ${ota_pass} ############################################# # Safe Mode # Safe mode will detect boot loops # https://esphome.io/components/safe_mode ############################################# safe_mode: ############################################# # Wifi Settings # https://esphome.io/components/wifi.html # # Power Save mode (can reduce wifi reliability) # NONE (least power saving, Default for ESP8266) # LIGHT (Default for ESP32) # HIGH (most power saving) ############################################# wifi: ssid: ${wifi_ssid} password: ${wifi_password} #power_save_mode: LIGHT #https://esphome.io/components/wifi.html#wifi-power-save-mode #manual_ip: #optional static IP address #static_ip: ${static_ip_address} #gateway: ${static_ip_gateway} #subnet: ${static_ip_subnet} ap: #Details for fallback hotspot in case wifi connection fails https://esphome.io/components/wifi.html#access-point-mode ssid: ${devicename} fallback AP password: ${fallback_ap_password} ap_timeout: 30min #Time until it brings up fallback AP. default is 1min ############################################# # Web Portal for display and monitoring # Turning this off is probably a good idea to save resources. # https://esphome.io/components/web_server.html ############################################# #web_server: # port: 80 # auth: # username: ${web_server_username} #probably a good idea to secure it # password: ${web_server_password} ############################################# # MQTT Monitoring # https://esphome.io/components/mqtt.html?highlight=mqtt # MUST also have api enabled if you enable MQTT ############################################# mqtt: broker: ${mqtt_server} topic_prefix: ${mqtt_topic}/${devicename} username: ${mqtt_username} password: ${mqtt_password} discovery: True # enable entity discovery (true is default) discover_ip: True # enable device discovery (true is default) ############################################# # 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) - id: LD1125H_Last_Mov_Time type: time_t restore_value: no initial_value: time(NULL) - 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: ${friendly_name} BME280 Temp accuracy_decimals: 1 oversampling: 2x pressure: name: ${friendly_name} BME280 Pressure oversampling: 2x humidity: name: ${friendly_name} BME280 Humidity accuracy_decimals: 1 oversampling: 2x address: 0x76 update_interval: ${update_time} - platform: uptime name: ${friendly_name} Uptime - platform: template name: ${friendly_name} LD1125H 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: ${friendly_name} LD1125H Occupancy Status 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: ${friendly_name} LD1125H Occupancy or Movement id: LD1125H_MovOcc_Binary device_class: occupancy - platform: template name: ${friendly_name} LD1125H Movement id: LD1125H_Mov_Binary device_class: motion