456 lines
16 KiB
YAML
456 lines
16 KiB
YAML
#############################################
|
|
#############################################
|
|
# 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:
|
|
device_name: "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
|
|
device_area: "Office" # Allows ESP device to be automatically linked to an 'Area' in Home Assistant.
|
|
|
|
#############################################
|
|
# SPECIFIC PROJECT VARIABLE SUBSTITUTIONS
|
|
#############################################
|
|
#
|
|
#
|
|
|
|
##########################################################################################
|
|
# PACKAGES: Included Common Packages
|
|
# https://esphome.io/components/packages.html
|
|
##########################################################################################
|
|
packages:
|
|
common_wifi: !include
|
|
file: common/network_common.yaml
|
|
vars:
|
|
local_device_name: "${device_name}"
|
|
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
|
|
vars:
|
|
local_device_name: "${device_name}"
|
|
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: ${device_name}
|
|
friendly_name: ${friendly_name}
|
|
comment: ${description_comment} #appears on the esphome page in HA
|
|
min_version: 2024.6.0
|
|
area: "${device_area}"
|
|
platformio_options:
|
|
build_flags:
|
|
- "-Os" # optimize for size
|
|
- "-Wl,--gc-sections" # drop unused code/data
|
|
- "-fno-exceptions" # strip C++ exceptions
|
|
#- "-fno-rtti" # strip C++ RTTI
|
|
on_boot:
|
|
- 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<uint8_t>(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<uint8_t>(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<uint8_t>(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<uint8_t>(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}
|
|
#key: "puCd6EGmFp3hU56N8dOo5u17bXwDr0aVRWiDoNdPDoE="
|
|
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: |-
|
|
// Use the global C time() function (::time(nullptr))
|
|
if ((::time(nullptr) - 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);
|
|
}
|
|
// Update the last-seen timestamp
|
|
id(LD1125H_Last_Time) = ::time(nullptr);
|
|
}
|
|
|
|
#############################################
|
|
# 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<uint8_t>(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<uint8_t>(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<uint8_t>(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<uint8_t>(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
|
|
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(nullptr) - 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);
|
|
}
|
|
// Update both last-movement and last-anything timestamps
|
|
id(LD1125H_Last_Time) = ::time(nullptr);
|
|
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);
|
|
}
|
|
// Update both movement-specific and general timestamps
|
|
id(LD1125H_Last_Mov_Time) = ::time(nullptr);
|
|
id(LD1125H_Last_Time) = ::time(nullptr);
|
|
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: 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 |