1. 项目缘起为什么是“智能”而非“自动”桌灯几年前我给自己装了一盏桌灯核心逻辑很简单人坐下灯亮人离开灯灭。听起来很智能对吧但实际用起来问题一大堆。最典型的就是“误判”我坐在桌前只是稍微后仰伸个懒腰或者低头在抽屉里找东西传感器可能就认为我“离开”了灯啪一下灭了得挥手或者跺脚才能唤醒体验非常割裂。另一种情况是我只是从桌前经过去书架拿本书灯却亮了白白浪费电。这种“非黑即白”的触发逻辑让所谓的“智能”变成了“智障”。所以当我说要做一个“Smart Desk Light”时我的目标很明确它必须能理解“意图”而不仅仅是检测“存在”。我需要一盏灯它能分辨我是准备伏案工作还是只是短暂停留它能感知我的专注状态并据此调整光线它甚至能在我长时间离开时优雅地、而非突兀地关闭。为了实现这个目标我放弃了传统的红外PIR传感器转向了毫米波雷达mmWave Sensor。同时为了获得更舒适、更均匀、且可灵活造型的照明效果我选择了COB LED灯带作为光源。整个系统的“大脑”则交给了ESPHome并最终接入Home Assistant实现更深度的场景联动。这不是一个简单的“开/关”自动化而是一个关于环境感知、行为预测与舒适光环境塑造的完整项目。2. 核心组件选型毫米波雷达与COB灯带的黄金组合为什么是这两个组件这背后是对“智能”和“舒适”两个维度的深度考量。2.1 毫米波雷达从“有无”到“状态”的感知飞跃传统的PIR被动红外传感器通过检测人体发出的红外热辐射变化来工作。它的缺点是显而易见的对静止或微动目标不敏感所以伸懒腰会误判、探测范围呈扇形且易受温度干扰、无法感知距离和运动轨迹。毫米波雷达则完全不同。它主动发射电磁波波长在1到10毫米之间并分析反射回来的信号。通过多普勒效应它可以精确感知物体的微动如呼吸、心跳引起的胸腔起伏、运动速度和方向。更重要的是通过调频连续波FMCW技术它可以测算出目标的距离。这意味着我的桌灯不再只是知道“房间里有人”而是能知道“有一个人正坐在距离传感器0.8米的位置并且处于相对静止的微动状态可能在阅读”。我选择的是市面上常见的24GHz或60GHz毫米波模块例如LD2410带蓝牙配置或HLK-LD2410C。这类模块通常已经集成了信号处理算法通过UART串口直接输出解析好的数据如存在状态、运动距离、运动能量值、静止距离、静止能量值。ESPHome可以轻松读取这些数据为我们后续的复杂逻辑判断提供了丰富的数据基础。注意毫米波雷达穿透能力较强可能会探测到隔板或玻璃后方的情况。在布置时需要通过软件设置合适的探测距离区间如0.2m - 1.5m聚焦于桌面区域避免侦测到门外的走廊造成误触发。2.2 COB LED灯带告别光斑拥抱“面”光源普通的LED灯珠是“点”光源即使灯带密度再高在近距离照射时尤其是在浅色桌面上仍可能看到一颗颗的灯珠光斑产生眩光视觉上很不舒服也容易导致视觉疲劳。COBChip On BoardLED灯带则将多颗LED芯片直接封装在一条柔性的基板上并覆盖统一的荧光胶层。其发光面是一个连续的、均匀的“光带”。它的优势非常突出出光均匀完全无颗粒感光线柔和是理想的桌面近距离照明光源。高显色性通常Ra显色指数90能更真实地还原物体本来的颜色对于绘图、阅读、模型制作等场景至关重要。灵活可塑基板柔软可以轻松弯曲、粘贴在显示器背部、书架隔板下、桌面边缘等任何需要轮廓照明的地方实现见光不见灯的效果。散热更好相比分立灯珠COB封装散热面积更大光衰更慢寿命更长。我选用的是24V的COB灯带相比12V版本在相同功率下电流更小长距离传输的压降和发热问题更不显著。通过一个支持PWM调光的恒流LED驱动器或MOSFET模块连接到ESP32即可实现亮度和色温的无级调节。3. 硬件搭建与电路连接详解这一部分我们将把想法变成实物。你需要准备以下核心材料主控ESP32开发板如NodeMCU-32S、Wemos D1 Mini ESP32。选择ESP32是因为其双核处理能力和丰富的GPIO能轻松处理传感器数据解析和PWM输出。传感器毫米波雷达模块如LD2410C。光源24V COB LED灯带长度根据你的桌面尺寸决定我用了1.5米、24V电源适配器功率需大于灯带总功率留足余量。驱动LED调光驱动器。这里有两种主流方案方案A集成恒流使用如“PWM转0-10V调光器”模块再接一个0-10V输入的恒流LED驱动器。这是最专业、最稳定的方案适合长灯带。方案B简单直接使用大功率MOSFET模块如IRF520N模块直接驱动灯带。此方案需要你在灯带供电回路中串联一个足够功率的恒流源或者确保你的电源是恒流限压型否则极易烧毁灯带或MOSFET。不推荐新手使用。其他杜邦线、DC5521接头、导线、散热胶带/铝槽用于灯带散热、3D打印或现成的外壳。电路连接图以LD2410C和PWM调光驱动器为例24V电源适配器 --- [LED调光驱动器 (V、V-输入)] | | (调光控制线) | ESP32 GPIO16 (PWM) --------- [调光驱动器 (PWM/DIM引脚)] ESP32 GPIO17 (TX) ---------- [LD2410C Radar (RX)] ESP32 GPIO18 (RX) ---------- [LD2410C Radar (TX)] ESP32 GND ------------------ [LD2410C Radar (GND)] ESP32 5V/VIN -------------- [LD2410C Radar (VCC)] // 注意雷达模块电压通常是5V或3.3V | LED调光驱动器 (V、V-输出) -- [24V COB LED灯带]关键接线说明雷达供电务必确认你的雷达模块工作电压。LD2410C通常是5V直接从ESP32的5V引脚取电即可。如果模块是3.3V逻辑则TX/RX线也需要接ESP32的3.3V逻辑电平引脚并可能需要电平转换。串口连接ESP32的GPIO17、18是硬件串口2UART2我们将用它来与雷达通信。TX接雷达的RXRX接雷达的TX。PWM调光选择一个支持PWM的GPIO如GPIO16连接到调光驱动器的信号输入脚。在ESPHome中我们将配置这个引脚输出PWM信号控制亮度。电源分离强烈建议将LED灯带的24V供电与ESP32/雷达的5V供电在物理上分离仅共地GND连接在一起。可以使用两个独立的电源适配器或者使用一个多路输出的开关电源。这能避免大功率LED开关时对数字电路造成干扰。4. ESPHome固件配置赋予设备“灵魂”硬件是躯体ESPHome的配置就是灵魂。我们的目标是编写一个.yaml文件让ESP32能够读取雷达数据并基于一套复杂的逻辑来控制PWM输出从而驱动灯带。4.1 基础框架与传感器配置首先定义设备的基本信息和雷达传感器。esphome: name: smart-desk-light friendly_name: Smart Desk Light esp32: board: nodemcu-32s framework: type: arduino # 启用日志调试时非常有用 logger: # 连接Wi-Fi和启用OTA方便后续无线更新 wifi: ssid: !secret wifi_ssid password: !secret wifi_password ap: {} # 备用AP模式 api: encryption: key: !secret api_encryption_key ota: password: !secret ota_password # 配置用于连接雷达的UART总线 uart: id: radar_bus tx_pin: GPIO17 rx_pin: GPIO18 baud_rate: 256000 # LD2410C的默认波特率 # 定义毫米波雷达传感器 sensor: - platform: hlw8010 # 注意这里需要替换为实际的毫米波雷达组件 # 由于ESPHome官方可能未直接收录你的雷达型号通常使用‘uart’组件配合自定义解析 # 以下以通用UART解析示例实际需根据雷达协议调整 uart_id: radar_bus id: mmwave_presence type: custom # 假设雷达输出格式为Presence:1,Distance:120,MotionEnergy:50,StillEnergy:10\n # 我们需要一个‘uart’的‘text_sensor’和‘sensor’来解析由于ESPHome原生对某些毫米波雷达支持可能不完善更常见的做法是使用uart组件和lambda解析或者使用社区贡献的定制组件。例如对于LD2410你可以使用esphome的external_components来导入专门的集成。这里我给出一个概念性的配置思路external_components: - source: github://pr#5350 # 示例指向一个包含LD2410集成的PR或仓库 components: [ ld2410 ] # 然后使用该组件 sensor: - platform: ld2410 uart_id: radar_bus has_target: name: MMWave Has Target moving_distance: name: MMWave Moving Distance moving_energy: name: MMWave Moving Energy still_distance: name: MMWave Still Distance still_energy: name: MMWave Still Energy4.2 核心逻辑自动化与灯控实现假设我们已经通过某个组件获得了以下传感器实体binary_sensor.mmwave_presence是否存在目标是/否sensor.mmwave_still_distance静止目标的距离厘米sensor.mmwave_still_energy静止目标的能量值代表置信度现在我们来配置PWM输出和核心的自动化逻辑。# 1. 定义PWM输出控制灯带亮度 output: - platform: ledc id: led_brightness_output pin: GPIO16 frequency: 1000Hz # PWM频率可调 # 2. 定义一个灯实体将输出与调光效果绑定 light: - platform: monochromatic name: Desk Light output: led_brightness_output id: desk_light # 可以定义默认的过渡效果使灯光变化柔和 gamma_correct: 2.0 default_transition_length: 0.5s # 3. 定义一些辅助的“虚拟”传感器用于存储状态 binary_sensor: - platform: template id: user_at_desk name: User at Desk # 这个传感器的状态将由自动化来更新 # 4. 核心自动化判断用户是否在桌前工作 automation: # 自动化1当检测到静止目标在桌面距离范围内且能量值较高时判定为“用户在桌前” - trigger: - platform: state entity_id: sensor.mmwave_still_distance - platform: state entity_id: sensor.mmwave_still_energy condition: - and: # 条件静止目标距离在0.3米到1.2米之间桌面区域 - lambda: return (id(sensor.mmwave_still_distance).state 30) (id(sensor.mmwave_still_distance).state 120); # 条件静止能量值高于阈值确保不是误检的微小动静 - lambda: return id(sensor.mmwave_still_energy).state 50; # 条件同时存在目标双重确认 - binary_sensor.is_on: binary_sensor.mmwave_presence action: - binary_sensor.template.publish: id: user_at_desk state: ON - light.turn_on: id: desk_light brightness: 100% # 或根据环境光传感器动态调整 transition_length: 1s # 自动化2当用户离开无目标或目标不在桌面区域一段时间后关灯 - trigger: - platform: state entity_id: binary_sensor.mmwave_presence to: off - platform: state entity_id: sensor.mmwave_still_distance # 距离超出桌面范围 lambda: return (id(sensor.mmwave_still_distance).state 30) || (id(sensor.mmwave_still_distance).state 120); condition: # 设置一个延时条件避免短暂离开就关灯 - delay: 2min # 离开2分钟后再关灯 action: - binary_sensor.template.publish: id: user_at_desk state: OFF - light.turn_off: id: desk_light transition_length: 30s # 缓慢关灯体验更好 # 自动化3微动检测如打字、移动鼠标保持灯光常亮重置关灯计时器 - trigger: platform: state entity_id: sensor.mmwave_moving_energy above: 10 # 检测到微小运动 action: - component.update: light.desk_light # 重置灯的空闲计时器如果有关灯自动化基于空闲时间 # 或者可以触发一个“活动保持”的脚本延长自动化2中的延迟时间4.3 高级优化环境光补偿与多模式切换一个真正智能的桌灯还应该考虑环境亮度。我们可以添加一个BH1750或TSL2591环境光传感器。i2c: sda: GPIO21 scl: GPIO22 sensor: - platform: bh1750 id: ambient_light name: Ambient Light address: 0x23 update_interval: 10s # 然后修改开灯自动化根据环境光调整亮度 automation: - trigger: # ... 同自动化1的触发条件 ... action: - binary_sensor.template.publish: id: user_at_desk state: ON - light.turn_on: id: desk_light # 使用lambda计算亮度环境越暗桌面灯亮度百分比越高 brightness: |- float ambient id(ambient_light).state; float brightness_pct; if (ambient 300) { // 环境很亮单位lux brightness_pct 0.3; } else if (ambient 100) { brightness_pct 0.6; } else { brightness_pct 1.0; } return brightness_pct; transition_length: 2s你还可以定义不同的“场景模式”比如“专注模式”高色温、高亮度、“休息模式”低色温、低亮度、“夜间模式”仅微光。在Home Assistant中创建输入选择器或按钮通过ESPHome的API或服务调用来切换这些模式对应的就是改变PWM的输出占空比。5. 集成Home Assistant从独立设备到智能生态通过ESPHome的API组件我们的智能桌灯已经自动出现在Home Assistant中。接下来我们可以利用HA强大的自动化能力实现更复杂的场景。状态面板在HA仪表盘上你可以看到桌灯的开关、亮度、以及雷达传感器的所有数据距离、能量值方便监控和调试。语音控制通过Google Assistant或Alexa集成你可以直接说“Hey Google, turn on the desk light”即使它因为自动化关闭了。场景联动与电脑联动通过HA的command_line传感器或ping传感器检测电脑是否开机。当电脑开机且雷达检测到人在桌前自动开灯并切换到“工作模式”。与作息时间联动在晚上11点后触发“夜间模式”将最大亮度限制在30%避免强光刺激。离家模式当HA检测到你已离家可以强制关闭桌灯无论传感器状态如何。高级自动化示例Node-Red或HA原生自动化# 这是一个HA原生自动化示例 alias: Desk Light - Cinema Mode description: 当电视开启且晚上且人在桌前时将桌灯调至低亮度暖色温 trigger: - platform: state entity_id: media_player.living_room_tv to: playing condition: - condition: time after: 18:00:00 before: 23:00:00 - condition: state entity_id: binary_sensor.user_at_desk state: on action: - service: light.turn_on target: entity_id: light.desk_light data: brightness_pct: 15 color_temp: 300 # 低色温暖光6. 安装、调试与避坑指南安装位置 毫米波雷达模块应正对使用者通常就坐的位置水平安装高度建议与坐姿时的人体胸部齐平。避免正对窗户窗外移动物或风扇、空调出风口晃动的植物。可以用一小块纸板制作一个简易的“遮罩”限制其水平探测角度使其更聚焦于桌面区域。调试流程刷入固件后先不连接灯带通过ESPHome的日志或HA的传感器实体观察雷达数据是否正常。挥手、静止坐下查看moving_distance、still_energy等值的变化。确定阈值坐在你的常用位置记录下still_distance的数值范围。这个范围就是你的“桌面区域”。同样记录下你静止时的still_energy典型值将其作为“存在阈值”。调整延迟离开座位观察从触发离开条件到灯熄灭的延迟时间我们设置了2分钟。根据你的习惯调整这个时间。如果你只是起身接水1-2分钟足够如果经常需要短暂离开可以延长到3-5分钟。灯光调试连接灯带测试PWM调光是否平滑。如果灯带有频闪尝试提高ESP32的PWM频率如提高到5000Hz。注意频率太高可能导致某些驱动器不兼容。常见问题与解决灯带发热严重COB灯带虽然散热好但长时间高亮度工作仍需辅助散热。务必将其粘贴在铝制散热槽上并确保空气流通。避免将其缠绕在密闭空间。雷达误触发频繁检查探测区域内是否有悬挂的衣物、晃动的植物。调整雷达的安装角度和方向。在软件端可以增加“能量值阈值”和“持续触发时间”两个条件比如要求静止能量值连续5秒超过阈值才判定为“人在”。Wi-Fi断连后灯状态异常在ESPHome配置中为light组件设置restore_mode: ALWAYS_ON或ALWAYS_OFF。我通常设为RESTORE_DEFAULT_OFF这样断电重启后灯是关闭的等待雷达重新判断更安全。PWM调光有噪音某些LED驱动器或灯带在低亮度PWM调光时可能会产生可闻的电流声啸叫。尝试更换不同品牌的驱动器或者避免使用极低的亮度如低于10%。我个人最实用的一个技巧在ESPHome中创建一个“调试模式”开关。当这个开关打开时灯光的亮灭不再受雷达控制而是固定为一个较低的亮度比如10%。同时将所有雷达传感器的原始数据通过一个文本传感器实时显示出来。这样在调整雷达位置或测试逻辑时你可以一边观察数据变化一边有足够的灯光照明而不会因为自动化误判导致眼前一黑。调试完毕关闭开关即可恢复正常智能逻辑。这个功能通过一个简单的template switch和对应的自动化就能实现极大提升了调试效率。完成所有这些步骤后你将得到一盏真正懂你的桌灯。它不再是一个需要手动开关的电器而是一个能融入你工作流、提升专注力和舒适度的环境伙伴。它安静、精准、无感地工作只在需要的时候提供恰到好处的光明。这种“科技消失体验浮现”的感觉正是智能家居项目最迷人的地方。
1. 项目缘起为什么是“智能”而非“自动”桌灯几年前我给自己装了一盏桌灯核心逻辑很简单人坐下灯亮人离开灯灭。听起来很智能对吧但实际用起来问题一大堆。最典型的就是“误判”我坐在桌前只是稍微后仰伸个懒腰或者低头在抽屉里找东西传感器可能就认为我“离开”了灯啪一下灭了得挥手或者跺脚才能唤醒体验非常割裂。另一种情况是我只是从桌前经过去书架拿本书灯却亮了白白浪费电。这种“非黑即白”的触发逻辑让所谓的“智能”变成了“智障”。所以当我说要做一个“Smart Desk Light”时我的目标很明确它必须能理解“意图”而不仅仅是检测“存在”。我需要一盏灯它能分辨我是准备伏案工作还是只是短暂停留它能感知我的专注状态并据此调整光线它甚至能在我长时间离开时优雅地、而非突兀地关闭。为了实现这个目标我放弃了传统的红外PIR传感器转向了毫米波雷达mmWave Sensor。同时为了获得更舒适、更均匀、且可灵活造型的照明效果我选择了COB LED灯带作为光源。整个系统的“大脑”则交给了ESPHome并最终接入Home Assistant实现更深度的场景联动。这不是一个简单的“开/关”自动化而是一个关于环境感知、行为预测与舒适光环境塑造的完整项目。2. 核心组件选型毫米波雷达与COB灯带的黄金组合为什么是这两个组件这背后是对“智能”和“舒适”两个维度的深度考量。2.1 毫米波雷达从“有无”到“状态”的感知飞跃传统的PIR被动红外传感器通过检测人体发出的红外热辐射变化来工作。它的缺点是显而易见的对静止或微动目标不敏感所以伸懒腰会误判、探测范围呈扇形且易受温度干扰、无法感知距离和运动轨迹。毫米波雷达则完全不同。它主动发射电磁波波长在1到10毫米之间并分析反射回来的信号。通过多普勒效应它可以精确感知物体的微动如呼吸、心跳引起的胸腔起伏、运动速度和方向。更重要的是通过调频连续波FMCW技术它可以测算出目标的距离。这意味着我的桌灯不再只是知道“房间里有人”而是能知道“有一个人正坐在距离传感器0.8米的位置并且处于相对静止的微动状态可能在阅读”。我选择的是市面上常见的24GHz或60GHz毫米波模块例如LD2410带蓝牙配置或HLK-LD2410C。这类模块通常已经集成了信号处理算法通过UART串口直接输出解析好的数据如存在状态、运动距离、运动能量值、静止距离、静止能量值。ESPHome可以轻松读取这些数据为我们后续的复杂逻辑判断提供了丰富的数据基础。注意毫米波雷达穿透能力较强可能会探测到隔板或玻璃后方的情况。在布置时需要通过软件设置合适的探测距离区间如0.2m - 1.5m聚焦于桌面区域避免侦测到门外的走廊造成误触发。2.2 COB LED灯带告别光斑拥抱“面”光源普通的LED灯珠是“点”光源即使灯带密度再高在近距离照射时尤其是在浅色桌面上仍可能看到一颗颗的灯珠光斑产生眩光视觉上很不舒服也容易导致视觉疲劳。COBChip On BoardLED灯带则将多颗LED芯片直接封装在一条柔性的基板上并覆盖统一的荧光胶层。其发光面是一个连续的、均匀的“光带”。它的优势非常突出出光均匀完全无颗粒感光线柔和是理想的桌面近距离照明光源。高显色性通常Ra显色指数90能更真实地还原物体本来的颜色对于绘图、阅读、模型制作等场景至关重要。灵活可塑基板柔软可以轻松弯曲、粘贴在显示器背部、书架隔板下、桌面边缘等任何需要轮廓照明的地方实现见光不见灯的效果。散热更好相比分立灯珠COB封装散热面积更大光衰更慢寿命更长。我选用的是24V的COB灯带相比12V版本在相同功率下电流更小长距离传输的压降和发热问题更不显著。通过一个支持PWM调光的恒流LED驱动器或MOSFET模块连接到ESP32即可实现亮度和色温的无级调节。3. 硬件搭建与电路连接详解这一部分我们将把想法变成实物。你需要准备以下核心材料主控ESP32开发板如NodeMCU-32S、Wemos D1 Mini ESP32。选择ESP32是因为其双核处理能力和丰富的GPIO能轻松处理传感器数据解析和PWM输出。传感器毫米波雷达模块如LD2410C。光源24V COB LED灯带长度根据你的桌面尺寸决定我用了1.5米、24V电源适配器功率需大于灯带总功率留足余量。驱动LED调光驱动器。这里有两种主流方案方案A集成恒流使用如“PWM转0-10V调光器”模块再接一个0-10V输入的恒流LED驱动器。这是最专业、最稳定的方案适合长灯带。方案B简单直接使用大功率MOSFET模块如IRF520N模块直接驱动灯带。此方案需要你在灯带供电回路中串联一个足够功率的恒流源或者确保你的电源是恒流限压型否则极易烧毁灯带或MOSFET。不推荐新手使用。其他杜邦线、DC5521接头、导线、散热胶带/铝槽用于灯带散热、3D打印或现成的外壳。电路连接图以LD2410C和PWM调光驱动器为例24V电源适配器 --- [LED调光驱动器 (V、V-输入)] | | (调光控制线) | ESP32 GPIO16 (PWM) --------- [调光驱动器 (PWM/DIM引脚)] ESP32 GPIO17 (TX) ---------- [LD2410C Radar (RX)] ESP32 GPIO18 (RX) ---------- [LD2410C Radar (TX)] ESP32 GND ------------------ [LD2410C Radar (GND)] ESP32 5V/VIN -------------- [LD2410C Radar (VCC)] // 注意雷达模块电压通常是5V或3.3V | LED调光驱动器 (V、V-输出) -- [24V COB LED灯带]关键接线说明雷达供电务必确认你的雷达模块工作电压。LD2410C通常是5V直接从ESP32的5V引脚取电即可。如果模块是3.3V逻辑则TX/RX线也需要接ESP32的3.3V逻辑电平引脚并可能需要电平转换。串口连接ESP32的GPIO17、18是硬件串口2UART2我们将用它来与雷达通信。TX接雷达的RXRX接雷达的TX。PWM调光选择一个支持PWM的GPIO如GPIO16连接到调光驱动器的信号输入脚。在ESPHome中我们将配置这个引脚输出PWM信号控制亮度。电源分离强烈建议将LED灯带的24V供电与ESP32/雷达的5V供电在物理上分离仅共地GND连接在一起。可以使用两个独立的电源适配器或者使用一个多路输出的开关电源。这能避免大功率LED开关时对数字电路造成干扰。4. ESPHome固件配置赋予设备“灵魂”硬件是躯体ESPHome的配置就是灵魂。我们的目标是编写一个.yaml文件让ESP32能够读取雷达数据并基于一套复杂的逻辑来控制PWM输出从而驱动灯带。4.1 基础框架与传感器配置首先定义设备的基本信息和雷达传感器。esphome: name: smart-desk-light friendly_name: Smart Desk Light esp32: board: nodemcu-32s framework: type: arduino # 启用日志调试时非常有用 logger: # 连接Wi-Fi和启用OTA方便后续无线更新 wifi: ssid: !secret wifi_ssid password: !secret wifi_password ap: {} # 备用AP模式 api: encryption: key: !secret api_encryption_key ota: password: !secret ota_password # 配置用于连接雷达的UART总线 uart: id: radar_bus tx_pin: GPIO17 rx_pin: GPIO18 baud_rate: 256000 # LD2410C的默认波特率 # 定义毫米波雷达传感器 sensor: - platform: hlw8010 # 注意这里需要替换为实际的毫米波雷达组件 # 由于ESPHome官方可能未直接收录你的雷达型号通常使用‘uart’组件配合自定义解析 # 以下以通用UART解析示例实际需根据雷达协议调整 uart_id: radar_bus id: mmwave_presence type: custom # 假设雷达输出格式为Presence:1,Distance:120,MotionEnergy:50,StillEnergy:10\n # 我们需要一个‘uart’的‘text_sensor’和‘sensor’来解析由于ESPHome原生对某些毫米波雷达支持可能不完善更常见的做法是使用uart组件和lambda解析或者使用社区贡献的定制组件。例如对于LD2410你可以使用esphome的external_components来导入专门的集成。这里我给出一个概念性的配置思路external_components: - source: github://pr#5350 # 示例指向一个包含LD2410集成的PR或仓库 components: [ ld2410 ] # 然后使用该组件 sensor: - platform: ld2410 uart_id: radar_bus has_target: name: MMWave Has Target moving_distance: name: MMWave Moving Distance moving_energy: name: MMWave Moving Energy still_distance: name: MMWave Still Distance still_energy: name: MMWave Still Energy4.2 核心逻辑自动化与灯控实现假设我们已经通过某个组件获得了以下传感器实体binary_sensor.mmwave_presence是否存在目标是/否sensor.mmwave_still_distance静止目标的距离厘米sensor.mmwave_still_energy静止目标的能量值代表置信度现在我们来配置PWM输出和核心的自动化逻辑。# 1. 定义PWM输出控制灯带亮度 output: - platform: ledc id: led_brightness_output pin: GPIO16 frequency: 1000Hz # PWM频率可调 # 2. 定义一个灯实体将输出与调光效果绑定 light: - platform: monochromatic name: Desk Light output: led_brightness_output id: desk_light # 可以定义默认的过渡效果使灯光变化柔和 gamma_correct: 2.0 default_transition_length: 0.5s # 3. 定义一些辅助的“虚拟”传感器用于存储状态 binary_sensor: - platform: template id: user_at_desk name: User at Desk # 这个传感器的状态将由自动化来更新 # 4. 核心自动化判断用户是否在桌前工作 automation: # 自动化1当检测到静止目标在桌面距离范围内且能量值较高时判定为“用户在桌前” - trigger: - platform: state entity_id: sensor.mmwave_still_distance - platform: state entity_id: sensor.mmwave_still_energy condition: - and: # 条件静止目标距离在0.3米到1.2米之间桌面区域 - lambda: return (id(sensor.mmwave_still_distance).state 30) (id(sensor.mmwave_still_distance).state 120); # 条件静止能量值高于阈值确保不是误检的微小动静 - lambda: return id(sensor.mmwave_still_energy).state 50; # 条件同时存在目标双重确认 - binary_sensor.is_on: binary_sensor.mmwave_presence action: - binary_sensor.template.publish: id: user_at_desk state: ON - light.turn_on: id: desk_light brightness: 100% # 或根据环境光传感器动态调整 transition_length: 1s # 自动化2当用户离开无目标或目标不在桌面区域一段时间后关灯 - trigger: - platform: state entity_id: binary_sensor.mmwave_presence to: off - platform: state entity_id: sensor.mmwave_still_distance # 距离超出桌面范围 lambda: return (id(sensor.mmwave_still_distance).state 30) || (id(sensor.mmwave_still_distance).state 120); condition: # 设置一个延时条件避免短暂离开就关灯 - delay: 2min # 离开2分钟后再关灯 action: - binary_sensor.template.publish: id: user_at_desk state: OFF - light.turn_off: id: desk_light transition_length: 30s # 缓慢关灯体验更好 # 自动化3微动检测如打字、移动鼠标保持灯光常亮重置关灯计时器 - trigger: platform: state entity_id: sensor.mmwave_moving_energy above: 10 # 检测到微小运动 action: - component.update: light.desk_light # 重置灯的空闲计时器如果有关灯自动化基于空闲时间 # 或者可以触发一个“活动保持”的脚本延长自动化2中的延迟时间4.3 高级优化环境光补偿与多模式切换一个真正智能的桌灯还应该考虑环境亮度。我们可以添加一个BH1750或TSL2591环境光传感器。i2c: sda: GPIO21 scl: GPIO22 sensor: - platform: bh1750 id: ambient_light name: Ambient Light address: 0x23 update_interval: 10s # 然后修改开灯自动化根据环境光调整亮度 automation: - trigger: # ... 同自动化1的触发条件 ... action: - binary_sensor.template.publish: id: user_at_desk state: ON - light.turn_on: id: desk_light # 使用lambda计算亮度环境越暗桌面灯亮度百分比越高 brightness: |- float ambient id(ambient_light).state; float brightness_pct; if (ambient 300) { // 环境很亮单位lux brightness_pct 0.3; } else if (ambient 100) { brightness_pct 0.6; } else { brightness_pct 1.0; } return brightness_pct; transition_length: 2s你还可以定义不同的“场景模式”比如“专注模式”高色温、高亮度、“休息模式”低色温、低亮度、“夜间模式”仅微光。在Home Assistant中创建输入选择器或按钮通过ESPHome的API或服务调用来切换这些模式对应的就是改变PWM的输出占空比。5. 集成Home Assistant从独立设备到智能生态通过ESPHome的API组件我们的智能桌灯已经自动出现在Home Assistant中。接下来我们可以利用HA强大的自动化能力实现更复杂的场景。状态面板在HA仪表盘上你可以看到桌灯的开关、亮度、以及雷达传感器的所有数据距离、能量值方便监控和调试。语音控制通过Google Assistant或Alexa集成你可以直接说“Hey Google, turn on the desk light”即使它因为自动化关闭了。场景联动与电脑联动通过HA的command_line传感器或ping传感器检测电脑是否开机。当电脑开机且雷达检测到人在桌前自动开灯并切换到“工作模式”。与作息时间联动在晚上11点后触发“夜间模式”将最大亮度限制在30%避免强光刺激。离家模式当HA检测到你已离家可以强制关闭桌灯无论传感器状态如何。高级自动化示例Node-Red或HA原生自动化# 这是一个HA原生自动化示例 alias: Desk Light - Cinema Mode description: 当电视开启且晚上且人在桌前时将桌灯调至低亮度暖色温 trigger: - platform: state entity_id: media_player.living_room_tv to: playing condition: - condition: time after: 18:00:00 before: 23:00:00 - condition: state entity_id: binary_sensor.user_at_desk state: on action: - service: light.turn_on target: entity_id: light.desk_light data: brightness_pct: 15 color_temp: 300 # 低色温暖光6. 安装、调试与避坑指南安装位置 毫米波雷达模块应正对使用者通常就坐的位置水平安装高度建议与坐姿时的人体胸部齐平。避免正对窗户窗外移动物或风扇、空调出风口晃动的植物。可以用一小块纸板制作一个简易的“遮罩”限制其水平探测角度使其更聚焦于桌面区域。调试流程刷入固件后先不连接灯带通过ESPHome的日志或HA的传感器实体观察雷达数据是否正常。挥手、静止坐下查看moving_distance、still_energy等值的变化。确定阈值坐在你的常用位置记录下still_distance的数值范围。这个范围就是你的“桌面区域”。同样记录下你静止时的still_energy典型值将其作为“存在阈值”。调整延迟离开座位观察从触发离开条件到灯熄灭的延迟时间我们设置了2分钟。根据你的习惯调整这个时间。如果你只是起身接水1-2分钟足够如果经常需要短暂离开可以延长到3-5分钟。灯光调试连接灯带测试PWM调光是否平滑。如果灯带有频闪尝试提高ESP32的PWM频率如提高到5000Hz。注意频率太高可能导致某些驱动器不兼容。常见问题与解决灯带发热严重COB灯带虽然散热好但长时间高亮度工作仍需辅助散热。务必将其粘贴在铝制散热槽上并确保空气流通。避免将其缠绕在密闭空间。雷达误触发频繁检查探测区域内是否有悬挂的衣物、晃动的植物。调整雷达的安装角度和方向。在软件端可以增加“能量值阈值”和“持续触发时间”两个条件比如要求静止能量值连续5秒超过阈值才判定为“人在”。Wi-Fi断连后灯状态异常在ESPHome配置中为light组件设置restore_mode: ALWAYS_ON或ALWAYS_OFF。我通常设为RESTORE_DEFAULT_OFF这样断电重启后灯是关闭的等待雷达重新判断更安全。PWM调光有噪音某些LED驱动器或灯带在低亮度PWM调光时可能会产生可闻的电流声啸叫。尝试更换不同品牌的驱动器或者避免使用极低的亮度如低于10%。我个人最实用的一个技巧在ESPHome中创建一个“调试模式”开关。当这个开关打开时灯光的亮灭不再受雷达控制而是固定为一个较低的亮度比如10%。同时将所有雷达传感器的原始数据通过一个文本传感器实时显示出来。这样在调整雷达位置或测试逻辑时你可以一边观察数据变化一边有足够的灯光照明而不会因为自动化误判导致眼前一黑。调试完毕关闭开关即可恢复正常智能逻辑。这个功能通过一个简单的template switch和对应的自动化就能实现极大提升了调试效率。完成所有这些步骤后你将得到一盏真正懂你的桌灯。它不再是一个需要手动开关的电器而是一个能融入你工作流、提升专注力和舒适度的环境伙伴。它安静、精准、无感地工作只在需要的时候提供恰到好处的光明。这种“科技消失体验浮现”的感觉正是智能家居项目最迷人的地方。
