基于ESP8266与Home Assistant的楼梯灯智能双控方案

1. 项目概述：一个“人来灯亮，人走灯灭”的楼梯灯自动化方案

楼梯灯的控制，尤其是那种需要在楼上楼下都能开关的“双控”场景，一直是个不大不小的痛点。传统做法是布线复杂，而智能开关又往往需要改造原有线路，成本不低。我最近用ESP8266、一个电流传感器和一个继电器模块，配合Home Assistant，折腾出了一个几乎零布线改造、纯无线联动的智能控制方案。这个方案的核心思路非常直接：用非侵入式的电流传感器（STC013）来“感知”楼梯灯是否被手动打开了，然后让Home Assistant这个“大脑”来判断是否该自动关灯。

简单来说，这个系统的工作流程是这样的：当你在楼下或楼上按下墙壁开关，楼梯灯亮起。此时，串联在灯回路中的STC013传感器会检测到电流变化，并将这个“灯已亮”的信号通过ESP8266上报给Home Assistant。Home Assistant启动一个计时器（比如75秒），如果在计时结束前，传感器检测到电流消失（意味着有人手动关灯了），计时器就取消。如果计时器走完，传感器检测到电流依然存在，Home Assistant就判定为“人已离开但灯忘了关”，于是触发继电器模块动作，模拟一次“关灯”操作，实现自动熄灭。

这个方案最大的好处是非侵入性和高兼容性。你不需要更换现有的墙壁开关，也不需要改动复杂的家庭电路，只需要在配电箱的灯路火线上夹上电流传感器，再把继电器模块并联到开关两端即可。整个系统完全基于Wi-Fi和逻辑判断，非常适合已经装修好、不想大动干戈，但又想提升便利性和节能性的家庭。下面，我就来详细拆解这个项目的设计思路、硬件选型、软件配置以及那些只有实际动手才会遇到的“坑”。

2. 核心硬件选型与电路设计解析

2.1 微控制器：为什么是ESP8266？

在这个项目中，我选择了ESP8266，具体型号是NodeMCU或Wemos D1 Mini。原因很实在：成本极低、生态成熟、功耗可控。一块ESP8266开发板不到20元，却集成了Wi-Fi和足够的GPIO引脚，完全满足本项目的需求。相较于更强大的ESP32，ESP8266在只需要Wi-Fi连接和简单IO控制的场景下，性价比是无敌的。

注意：ESP8266有不同的固件开发方式，比如Arduino IDE、MicroPython。这里我强烈推荐使用 ESPHome。ESPHome是Home Assistant生态中的一员，它通过YAML配置文件来定义设备功能，然后一键编译、刷写固件。它抽象了底层网络通信和Home Assistant发现的复杂性，让你能像写配置一样开发固件，极大降低了门槛。你不再需要写复杂的MQTT连接和订阅代码，ESPHome帮你全包了。

2.2 感知核心：STC013非接触式交流电流传感器

STC013是一款基于霍尔效应的开合式电流互感器。它的原理是：当有电流穿过被夹持的导线时，会在传感器内部产生一个与电流成正比的交变磁场，进而感应出微弱的交流电压信号。其最大优势就是“非接触式”，你只需要把它像夹子一样卡在需要监测的那根电线（通常是火线）上，无需切断线路，安全又方便。

关键参数与接线要点： STC013常见规格是0-100A量程，输出是0-1V或0-50mA的交流信号。ESP8266的ADC引脚只能测量0-3.3V的直流电压。因此，我们需要一个简单的信号调理电路，将交流信号转换为ESP8266能读的直流信号。经典电路包括：

1. 负载电阻：在传感器输出端并联一个精密电阻（例如33Ω），将电流信号转换为电压信号。
2. 偏置电路：由于交流信号有正有负，而ADC不能读负电压，所以需要一个1.65V（即3.3V/2）的直流偏置电压，将整个信号“抬升”到0-3.3V范围内。
3. 低通滤波：用一个小电容（如10uF）并联在负载电阻上，滤除高频噪声，使读数更稳定。

然而，原作者提到“There is no need for accuracy... resistors and capacitors are not needed”。这基于一个巧妙的简化：本项目只关心“有电流”和“无电流”这两种状态，而不是精确的电流值。ESP8266的ADC可以直接读取STC013产生的原始交流电压信号（需注意电压峰值不要超过3.3V）。在代码里，我们设置一个阈值（比如ADC值大于某个数），当读数超过阈值就认为灯亮了。这种方法牺牲了精度，但极大简化了硬件，对于开关状态检测完全够用。但务必注意：直接将传感器输出接至GPIO有微小风险，最好串联一个1kΩ左右的限流电阻以保护ESP8266的ADC引脚。

2.3 执行机构：继电器模块的选择与安全接线

继电器是控制电路的物理开关。我选用的是最普通的单路5V高电平触发继电器模块。选择时要注意：

• 触点容量：必须大于楼梯灯的实际功率。一般家用楼梯灯在几十瓦以内，模块常见的10A/250VAC触点绰绰有余。
• 触发电平：确保与ESP8266的3.3V GPIO输出兼容。大部分模块标注“高电平触发”在3.3V下也能可靠工作，但最好购买前确认，或选择支持3.3V触发的型号。

接线是安全的重中之重！ 继电器模块控制的是220V市电，必须严格操作：

1. 断电操作：在进行任何接线前，务必关闭家庭总闸或相应回路断路器，并用电笔确认无电。
2. 控制端：继电器的VCC接ESP8266的5V或3.3V（视模块而定），GND接GND，IN信号引脚接ESP8266的某个GPIO（如D1）。
3. 受控端（强电部分）：这是实现“自动关灯”逻辑的关键。你需要将继电器的常开（NO）触点，并联在原有楼梯双控开关的其中一个开关的两端。
   • 原理：当继电器不动作时，电路是断开的，不影响手动开关。当Home Assistant决定关灯时，触发继电器吸合，其NO触点闭合，相当于手动把这个开关“短接”了一下，灯就灭了。由于是并联，它不会干扰另一个开关的正常功能。
   • 实操：找到楼梯灯双控线路中的一个开关（比如楼下的），断开其电源，将继电器模块的COM和NO端子，分别接到这个开关的两个接线柱上。这样，继电器闭合就等于按下了这个开关。

致命警告：强电部分如果不懂，请务必咨询或聘请专业电工操作。错误接线可能导致设备损坏、触电或火灾风险。安全永远是第一位的。

2.4 系统架构与供电方案

整个系统需要两个ESP8266节点：

1. 传感器节点：包含ESP8266和STC013，安装在配电箱或灯路附近，负责检测电流。供电可从配电箱内取一个5V/1A的USB电源适配器（注意绝缘），或使用专用的AC-DC降压模块。
2. 执行器节点：包含ESP8266和继电器模块，安装在楼下开关的暗盒附近（需要有空间）。供电可以从开关盒里的零火线引出，接一个小的5V开关电源模块供电，这是最简洁的方式。

两个节点通过家庭Wi-Fi连接到同一个局域网，与Home Assistant服务器通信。Home Assistant作为控制中心，负责逻辑判断和发送指令。

3. 软件配置详解：从固件到自动化

3.1 ESPHome设备配置（传感器节点）

首先，在Home Assistant的ESPHome插件中为传感器节点创建配置。核心是定义一个ADC传感器来读取STC013的数据。

关键点解析：

• filters中的sliding_window_moving_average滤波器至关重要。原始ADC读数跳动很大，通过取最近5个值的平均值，可以得到一个相对稳定的值，避免误触发。
• 阈值100需要实际校准。先用万用表测量灯关闭和开启时，ESP8266 A0引脚对GND的电压。然后在ESPHome日志中观察对应的ADC值（0-1023对应0-1.0V，如果用了分压电路则范围不同）。设置一个介于“关闭值”和“开启值”中间的数值作为阈值。
• 我们最终暴露给Home Assistant的是一个名为Stairway Light Status的二进制传感器，状态为ON或OFF，非常干净。

3.2 ESPHome设备配置（执行器节点）

执行器节点的配置简单很多，主要就是定义一个开关来控制继电器。

关键点解析：

• 这里将继电器定义为一个switch实体。当Home Assistant将其打开时，继电器会吸合。
• turn_off_action里的delay是关键。我们不需要继电器长期吸合，只需要它“点动”一下，模拟人手按开关的动作。500ms是一个经验值，足够继电器可靠动作，又不会过长。
• 这个switch在Home Assistant中会显示为一个可以手动操作的开关，但我们主要通过自动化来操控它。

3.3 Home Assistant自动化配置

这是整个系统的“大脑”。我们需要创建一个自动化，实现“检测到灯亮->等待延时->如果灯还亮则关闭”的逻辑。使用YAML配置模式更清晰。

逻辑深度解读：

1. 触发器：当light_status传感器变为“on”状态，并持续保持75秒时，触发自动化。这里的for是关键，它直接集成了延时判断，比在action里用delay更优雅，能避免在延时期间重复触发自动化。
2. 条件与选择：使用choose动作代替简单的if。第一个分支检查75秒后灯是否还亮着，如果是，则执行关灯动作并发送通知。第二个分支是“否则”，即灯在75秒内被手动关了，则发送另一条通知（可选）。这完美实现了“aller-retour”（双控）场景下的精准判断：只有真的无人关灯，系统才介入。
3. 动作细节：先打开继电器开关（turn_on），短暂延迟后关闭它（turn_off）。这是因为我们在ESPHome里已经定义了turn_off_action，所以这里直接操作开关实体即可，Home Assistant发送turn_on命令后，ESPHome设备会自动执行500ms的脉冲动作。

3.4 仪表盘与用户交互

最后，为了便于手动控制和状态监控，可以在Home Assistant的Lovelace仪表盘上添加一个卡片。

这里我做了个优化：没有直接绑定继电器开关，而是创建了一个script（脚本）来触发它，这样可以确保每次触发都是标准的“点动”操作。

这样，在仪表盘上点击“手动触发自动关灯”，就会运行这个脚本，安全地让继电器动作一次。

4. 部署、调试与避坑指南

4.1 硬件安装与安全复核

1. 传感器安装：在断电情况下，将STC013传感器夹在控制楼梯灯的火线上。最好单独夹一根线，避免多根线穿过导致磁场抵消。传感器信号线连接至ESP8266的A0引脚和GND，建议中间串联一个1kΩ电阻。
2. 继电器安装：同样在断电下操作。将继电器模块的COM和NO端子，用导线并联到楼下双控开关的两个接线端。确保接线牢固，用绝缘胶带包好。
3. 供电：为两个ESP8266节点提供稳定的5V电源。执行器节点可考虑使用小型220V转5V的开关电源模块，藏在开关暗盒或天花板内。
4. 通电测试：先只给ESP8266上电，确认它们能连上Wi-Fi并被Home Assistant发现。然后再合上家庭总闸，测试手动开关灯是否正常，以及继电器动作时是否能正确关灯。

4.2 软件调试与参数校准

1. ESPHome日志：这是你最好的朋友。在Home Assistant的ESPHome插件中，打开传感器节点的日志。观察灯开和关时，ADC传感器的原始值变化。根据这个变化范围，调整YAML配置中的阈值（上文代码中的100）。
2. 校准阈值：一个更稳健的方法是，在ESPHome配置中先不设阈值，将原始ADC值作为一个普通传感器暴露出来。在Home Assistant的“开发者工具->状态”中观察其数值。记录灯亮和灯灭时的典型值，然后选择一个中间值，更新到ESPHome配置的lambda判断条件中，重新刷写固件。
3. 自动化调试：打开Home Assistant“配置->自动化与场景->自动化”，找到你创建的自动化，点击“执行一次”或“运行动作”进行测试。同时打开“日志”查看自动化的触发和执行记录。

4.3 常见问题与解决方案

4.4 进阶优化与扩展思路

1. 功耗优化：ESP8266传感器节点如果使用电池供电，需要深度优化。启用ESPHome的deep_sleep模式，让芯片大部分时间休眠，每隔10-15秒唤醒一次检测电流，可以极大延长续航。
2. 状态反馈与容错：当前系统是开环控制。可以增加一个电压传感器（如ZMPT101B）监测灯两端电压，或直接用一个通断传感器监测灯的实际亮灭状态，实现闭环反馈，确保执行动作后灯确实灭了，否则可报警或重试。
3. 多场景联动：将楼梯灯状态与家庭其他传感器联动。例如，结合人体传感器，如果检测到有人移动，则临时禁用自动关灯功能；或者与家庭安防模式联动，夜间模式下延长关灯时间。
4. 本地化与可靠性提升：使用ESPHome的lambda编写更复杂的本地逻辑。例如，可以在ESP8266本地实现“检测到电流后延时关继电器”的功能，这样即使Home Assistant服务器或网络临时中断，基础自动化仍能工作，提升系统可靠性。

这个项目从构思到实现，最深的体会是：智能家居不一定要追求最炫酷的功能，而是用最简单的技术和最巧妙的逻辑，实实在在地解决一个具体的生活痛点。 整个系统硬件成本不到百元，软件全部开源，但带来的便利性是实实在在的。它让我再也不用在睡前纠结要不要下楼关灯，也避免了电能的浪费。更重要的是，通过亲手搭建这套系统，你对家庭电路、微控制器、无线通信和自动化逻辑会有更透彻的理解，这种成就感是购买成品智能设备无法比拟的。如果遇到问题，耐心查看日志，从信号源头一步步排查，每一个坑踩过去，都是宝贵的经验。