从零DIY智能卷帘：ESP32+ESPHome接入Home Assistant全攻略-平芜编程栈

如果你最近在关注智能家居，会发现一个很有意思的现象：整套设备里溢价最高的往往不是音箱，也不是摄像头，而是窗帘。一套成品智能卷帘，动辄几百上千元，还难免被品牌生态绑定——一个牌子一个 App，协议不开放，电机坏了不好修，想接入 Home Assistant 更是要绕不少弯路。这也是为什么 Hacker News 上出现“Show HN: Building My Own Smart Roller Shades”这类 DIY 项目时，总会引发大量讨论：它把一件被商家包装成“高溢价商品”的事情，拉回到了“用几百元物料加开源代码就能搞定”的工程问题。

本文不打算只晒成果，而是把这类 DIY 智能卷帘（Smart Roller Shades）项目的完整技术链路拆开讲清楚：从电机选型、控制器选型，到 ESPHome 固件编写、Home Assistant 自动化联动，再到实际项目中最容易出问题的限位、位置追踪和安全细节。读完这篇文章，你至少能做出一个判断：自己动手做一个智能卷帘，到底值不值，具体怎么做，哪些坑必须提前避开。

1. 为什么要自己动手做智能卷帘

1.1 成品智能卷帘的痛点

先说结论：市面上的成品智能卷帘，真正贵的不是电机和面料，而是品牌溢价和生态成本。

从价格上看，一套支持 App 控制、定时开关的成品电动卷帘，双电机版本动辄上千元，进口品牌甚至更高。从使用上看，很多产品必须使用厂商自己的 App，云端服务和本地网络绑定在一起，一旦厂商停止维护，设备可能变成“半智能”。更麻烦的是，不同的智能家居生态之间存在壁垒：买了 A 品牌的窗帘，想把它接入 Home Assistant 和米家同时控制，往往需要刷机、改装、破解协议，风险和技术门槛都不低。

第二个痛点是维护成本。成品卷帘的电机、控制板、电源通常是高度集成的，坏一个部件，很可能要整个换掉。质保期外维修，价格接近买新的。对于喜欢折腾的开发者来说，这种“坏了只能找厂家”的模式，体验并不好。

1.2 DIY 方案的真正优势

自己动手做智能卷帘，核心优势可以总结为四点。

第一是成本可控。核心物料包括一个 DC 管状电机、一块 ESP32 开发板、一个双路继电器模块、一个电源适配器，以及若干限位开关和接线材料。整套物料成本通常只有成品方案的几分之一，具体价格取决于电机扭矩和品牌，这里不展开。

第二是协议可控。DIY 方案可以选择 ESPHome、Tasmota 或 MQTT 协议，所有固件源码都在本地，不依赖厂商云端。设备接入 Home Assistant 后，所有自动化都走本地局域网，断网也能用。

第三是维护友好。模块化设计意味着电机坏了换电机，控制板坏了刷一块新板子，不用整个系统推倒重来。

第四是学习价值。做一个智能卷帘，会涉及电机控制、继电器逻辑、限位保护、WiFi 固件开发、智能家居协议对接等多个环节。对于嵌入式开发和智能家居爱好者来说，这是一个非常适合练手的完整项目。

1.3 这个项目适合谁，不适合谁

适合的人群很明确：

有基础的接线能力，会用万用表，能分辨正负极。
对智能家居自动化有真实需求，比如希望窗帘按日出日落自动开关。
愿意花一两个周末做机械安装和参数调校。
接受 DIY 设备的外观可能不如成品精致。

不适合的人群也很明确：

完全零硬件基础，对电气安全没有概念，建议先从小型低压项目练手。
追求“买回来就能用”，不想折腾固件和接线。
对静音、颜值、质保要求极高，那成品依然是更合理的选择。

一句话总结：DIY 智能卷帘是用时间和动手能力，交换成本、可维护性和生态自由度。

2. 智能卷帘的核心概念与整体架构

2.1 什么是智能卷帘

智能卷帘，简单说就是能通过遥控器、手机 App、定时任务或环境传感器自动升降的卷帘装置。它和普通卷帘的区别，不在于那块布，而在于驱动的自动化能力。

一个完整智能卷帘系统，至少要包含四个能力：

远程控制：通过 WiFi 或蓝牙，从手机或语音助手发起开关指令。
定时控制：按照设定的时间自动开合。
联动控制：根据光照、温度、人员在场状态自动调整。
位置反馈：系统知道卷帘当前是开、关，还是停在中间某个位置。

这四点的实现难度是递增的。远程控制最简单，定时控制次之，联动控制需要额外传感器，位置反馈则对硬件方案有较高要求。

2.2 系统架构分层

从工程角度看，智能卷帘可以拆成五个层次：

层次	组成部分	典型方案
物理层	卷帘面料、卷管、电机、限位开关	12V/24V DC 管状电机
控制层	继电器或 H 桥、微控制器	ESP32 + 双路继电器
网络层	WiFi / BLE / MQTT 通信	ESPHome API / MQTT
应用层	控制面板、语音助手、手机 App	Home Assistant
自动化层	定时、光照、场景联动	Home Assistant Automation

理解这个分层很重要。很多 DIY 项目做失败，不是因为某一层不会做，而是层与层之间的接口没接好。比如电机装好了，但控制层没有做互锁，两个继电器同时吸合导致短路；或者固件写好了，但应用层没有正确调用 cover 服务的 open、close、stop 方法。

2.3 商用方案与 DIY 方案的对比

对比维度	成品智能卷帘	DIY 智能卷帘
初期成本	高	低
生态开放性	封闭，依赖厂商 App	开放，可接入任意平台
可维护性	差，维修成本高	好，模块化替换
外观质感	好	一般
安装调试门槛	低	中高
位置控制精度	高	取决于方案
数据隐私	依赖厂商云端	本地优先

这个对比想表达的是：成品和 DIY 没有绝对优劣，只有适不适合。如果你重视省心和外观，选成品；如果你重视生态自由和长期可维护性，DIY 是更值得投入的方向。

3. 硬件选型：先想清楚再买

3.1 电机：管状电机与普通直流电机

智能卷帘的灵魂是电机。市面上 DIY 项目最常用的有两种。

第一种是 DC 管状电机。它被设计成直接塞进卷帘的卷管里，外观上是圆柱形，输出轴带动卷管旋转，布料随之上升或下降。这类电机常见 12V 或 24V 供电，优点是结构紧凑、安装方便，是 DIY 卷帘的主流选择。选购时需要注意三个参数：扭矩、转速和电压。扭矩不够，带不动厚重面料；转速太快，卷帘收放会显得粗暴。

第二种是普通直流减速电机配合机械结构。这类方案在 3D 打印和 Arduino 项目中很常见，优点是便宜、灵活，缺点是需要自己设计传动结构，安装复杂度高。对于新手，更推荐直接选管状电机，把精力留给控制逻辑。

电机是否自带限位开关，也是一个重要分水岭。自带机械限位的电机，到顶或到底会自动断电，安全性更高；不带限位的电机，必须依赖控制器侧做软件限位，也就是通过行程时间或外接限位开关来截止。本文后面的固件示例，会针对这两种情况分别给出方案。

3.2 控制器：ESP32 还是 ESP8266

控制器方面，主流 DIY 项目基本在 ESP32 和 ESP8266 之间二选一。

ESP32 是更稳妥的选择。它双核运行，主频更高，内置 WiFi 和蓝牙，GPIO 数量充足，ADC 精度也更好。对于智能卷帘这种需要同时处理 WiFi 通信、继电器控制和限位检测的场景，ESP32 的余量明显更大。而且 ESPHome 对 ESP32 的支持非常成熟，固件编译和 OTA 升级体验都很好。

ESP8266 也能做，价格更低，但 GPIO 数量少，单核处理并发任务时更容易出现卡顿。如果只是做一个最简单的“继电器 + WiFi 开关”，ESP8266 够用；一旦要加限位传感器、位置反馈、多路控制，ESP32 更省心。

这里有一个容易踩的坑：不同开发板的 GPIO 编号和默认电平不同，买回来先查清楚板子原理图，再决定使用哪些引脚，避免把默认输出高电平的引脚接到继电器上，导致上电瞬间电机误动作。

3.3 驱动电路、电源与其他配件

电机和控制器之间，还需要驱动电路。两种常见选择：

双路继电器模块。便宜、简单，通过两组开关切换电机正负极，实现正反转。缺点是只能开关，不能调速，频繁切换时会有继电器动作声。
双 H 桥驱动模块，比如 L298N 或 DRV8871。支持正反转，也支持 PWM 调速，电机运行更柔顺，还能做电流检测。缺点是接线和配置更复杂。

电源部分要重点关注电流余量。电机的启动电流通常比额定电流大，电源适配器不能只按电机额定功率选，建议预留 30% 以上的余量。控制器和电机如果电压不同，比如电机用 12V，ESP32 需要 5V 或 3.3V，中间需要加 DC-DC 降压模块，不要直接把 12V 接到开发板的 5V 引脚。

限位开关推荐用微动开关或霍尔传感器。微动开关便宜直观，霍尔传感器没有机械触点，寿命更长。两者都需要在固件里配置去抖逻辑，避免开关抖动导致误触发。

3.4 工具与耗材清单

开始动手前，建议准备以下工具和耗材：

万用表，用于确认电压、检查线路通断。
电烙铁或压线钳，配合端子进行连接。
热缩管和电工胶带，保护裸露接头。
接线端子，比如 Wago 端子，比绞线更可靠。
3D 打印机或标准接线盒，用于收纳控制电路。
扎带和魔术贴，用于固定电机线和控制器。

这些工具大多数家庭不一定齐全，但都不贵。接线端子和热缩管属于安全相关的耗材，不建议省。

4. 电机控制原理：方向、限位与位置

4.1 正反转控制与互锁

直流电机要实现卷帘上升和下降，本质上是让电机正转和反转。正反转的实现方式，取决于你选的驱动电路。

如果用双路继电器，原理是：继电器 A 吸合时，电机两端接正向电源；继电器 B 吸合时，电机两端电源极性反转。这里最大风险是 A 和 B 同时吸合，等于直接把电源正负极短路，轻则烧继电器，重则烧电源。所以在固件里必须做“互锁”：打开一个继电器前，先确保另一个继电器已经关闭。

如果用 H 桥驱动，逻辑更简单，通过 IN1 和 IN2 的高低电平组合控制正转、反转和刹车。H 桥天然不会出现两个输出同时导通的问题，但要注意使能引脚的电平状态。

这里真正容易踩坑的地方是：很多继电器模块是低电平触发，也就是 GPIO 输出低电平时继电器才吸合。如果你按高电平触发的逻辑写固件，可能会出现“上电就动作”或者“控制反相”的现象。第一版固件建议把继电器控制方式写进注释，方便排查。

4.2 限位开关与防呆设计

电机如果一直转到机械结构卡死，会进入堵转状态，电流急剧上升，发热严重，长时间会烧毁电机。所以限位设计不是可选项，而是必须项。

限位方案有三种：

机械限位：电机内部自带行程开关，到顶或到底自动断电。
外接微动开关：在窗帘轨道两端安装开关，触发后由控制器切断继电器。
软件限位：控制器记录电机的运行时间，超过设定行程后自动停止。

最稳妥的做法是“机械限位 + 软件限位”双保险。如果电机自带机械限位，固件里依然要设定一个最大运行时间，防止机械限位失效时电机长时间堵转。

外接微动开关时，建议在固件里加 50ms 左右的去抖滤波，因为机械开关在闭合瞬间会产生多个电平跳变，不去抖可能触发多次中断或产生误动作。

4.3 位置追踪的三种思路

卷帘停在中间某位置，是智能家居中很常见的需求。比如夏天午后，希望卷帘只放下 50%，既能遮阳又不完全挡光。实现位置追踪，有三种典型思路。

第一种是时间估算。记录从全开到全关所需时间，根据电机运行时长估算当前位置。优点是零额外成本，缺点是时间会因负载、电压波动产生漂移，需要定期校准。

第二种是限位开关加归位逻辑。每次运行先触底或触顶完成归位，再从零点计算行程。精度有所提高，但每次操作前可能需要先“找零”。

第三种是霍尔传感器或编码器脉冲计数。在电机轴上安装霍尔传感器或编码器，每转一圈产生固定数量的脉冲，控制器通过累计脉冲精确计算位移。这是精度最高的方案，也是很多成品卷帘采用的方式，但硬件成本和固件复杂度明显上升。

对大多数 DIY 项目，第一阶段的建议是：先用时间估算跑通全流程，再根据实际使用体验决定是否升级到脉冲计数。不要一开始就追求高精度，先把系统跑起来比什么都重要。

5. 固件实现：基于 ESPHome 的完整配置

5.1 为什么选 ESPHome

固件方案有很多选择：Arduino 裸写、MicroPython、Tasmota、ESPHome。这里推荐 ESPHome，原因有三。

第一，声明式配置。ESPHome 用 YAML 描述设备行为，继电器、开关、cover 组件都有现成模块，不用从零写 WiFi 连接、MQTT 发布、OTA 升级这些底层逻辑。

第二，原生接入 Home Assistant。ESPHome 设备只要开启 API 组件，Home Assistant 就能自动发现并生成实体，cover 类型会被识别为窗帘，直接使用开关、停、设位置等标准服务。

第三，本地运行，断网可用。ESPHome 设备通过局域网与 Home Assistant 通信，不依赖云端中转，更符合智能家居的隐私和稳定性要求。

5.2 安装 ESPHome 并创建项目

安装方式很简单，推荐使用 Python 的 pip 安装，或者直接使用 Docker 镜像。这里以命令行方式为例。

pip install esphome esphome version

创建项目可以直接用 wizard 向导：

esphome wizard bedroom-shade.yaml

向导会依次询问设备名称、平台、开发板、WiFi 信息，然后生成一个基础配置。如果你已经有现成配置，也可以直接写 YAML 文件，然后用esphome run编译烧录。

5.3 完整配置示例：时间估算版

下面是一个完整的 ESPHome 配置，采用时间估算方式控制卷帘。请根据实际硬件修改 GPIO 编号、WiFi 信息和行程时间。

# 文件路径：bedroom-shade.yaml esphome: name: bedroom-shade friendly_name: 卧室卷帘 esp32: board: esp32dev framework: type: arduino logger: level: DEBUG api: encryption: key: "YOUR_BASE64_API_KEY" ota: - platform: esphome password: "YOUR_OTA_PASSWORD" wifi: ssid: "YOUR_WIFI_SSID" password: "YOUR_WIFI_PASSWORD" fast_connect: true switch: - platform: gpio pin: GPIO32 id: relay_up name: "上行继电器" - platform: gpio pin: GPIO33 id: relay_down name: "下行继电器" cover: - platform: time_based name: "卧室卷帘" open_action: - switch.turn_on: relay_up - switch.turn_off: relay_down close_action: - switch.turn_on: relay_down - switch.turn_off: relay_up stop_action: - switch.turn_off: relay_up - switch.turn_off: relay_down open_duration: 14s close_duration: 14s

这段配置中有几个关键点需要解释。

open_action和close_action里都包含两个操作：打开一个继电器，同时关闭另一个。这就是前面说的互锁逻辑，防止两个继电器同时吸合造成短路。

open_duration和close_duration是行程时间，表示卷帘从全关到全开大约需要 14 秒，从全开到全关也是 14 秒。这个值必须实测校准，不能随意填写。如果填得比实际短，卷帘到不了位；填得比实际长，电机可能会在到位后继续空转，长期会磨损机械结构。

5.4 完整配置示例：限位开关版

如果你的电机不带机械限位，但安装了外接微动开关，可以使用endstop平台。这个平台会监听上下限位开关，触顶或触底后自动停止。

# 文件路径：bedroom-shade-endstop.yaml esphome: name: bedroom-shade friendly_name: 卧室卷帘 esp32: board: esp32dev framework: type: arduino logger: level: DEBUG api: encryption: key: "YOUR_BASE64_API_KEY" ota: - platform: esphome password: "YOUR_OTA_PASSWORD" wifi: ssid: "YOUR_WIFI_SSID" password: "YOUR_WIFI_PASSWORD" switch: - platform: gpio pin: GPIO32 id: relay_up name: "上行继电器" - platform: gpio pin: GPIO33 id: relay_down name: "下行继电器" binary_sensor: - platform: gpio pin: number: GPIO25 mode: INPUT_PULLUP id: limit_top filters: - delayed_on: 50ms - platform: gpio pin: number: GPIO26 mode: INPUT_PULLUP id: limit_bottom filters: - delayed_on: 50ms cover: - platform: endstop name: "卧室卷帘" open_action: - switch.turn_on: relay_up - switch.turn_off: relay_down open_endstop: limit_top close_action: - switch.turn_on: relay_down - switch.turn_off: relay_up close_endstop: limit_bottom

这里使用了INPUT_PULLUP，意味着微动开关的另一端接 GND，开关按下时 GPIO 读到低电平。如果你的开关接线方式是接 VCC，需要改用INPUT_PULLDOWN，否则限位信号会一直无效。

delayed_on: 50ms是去抖滤波，防止开关抖动导致误触发。如果你的微动开关质量一般，可以适当加大到 100ms，但不要太大，否则快速操作时可能丢失限位信号。

5.5 编译、烧录与日志查看

配置写完后，运行以下命令编译并烧录到开发板：

esphome run bedroom-shade.yaml

第一次运行会下载依赖和编译工具链，耗时较长。烧录时开发板需要通过 USB 连接到电脑。烧录完成后，esphome run默认会打开日志窗口，可以看到设备启动、连接 WiFi、注册 API 的日志信息。

在日志中看到类似[I][app:033]: App started和[I][wifi:354]: WiFi connected!的输出，说明固件已经正常运行。如果日志里出现反复重启，多半是配置里引用了不存在的组件或引脚冲突，先检查 YAML 中是否有拼写错误。

6. 接入 Home Assistant 与自动化联动

6.1 设备自动发现与实体接入

ESPHome 设备接入 Home Assistant 非常简单。前提是你已经安装了 Home Assistant 的 ESPHome 集成。在 Home Assistant 集成页面添加 ESPHome，填入设备的 IP 地址和 API 加密密钥，设备会自动被识别。

接入成功后，Home Assistant 中会出现一个cover.bedroom_shade实体。如果你的设备名称是bedroom-shade，实体 ID 就是cover.bedroom_shade。这个实体支持以下标准服务：

cover.open_cover：打开卷帘。
cover.close_cover：关闭卷帘。
cover.stop_cover：停止卷帘。
cover.set_cover_position：设置目标位置。

使用默认的time_based平台时，set_cover_position会根据设定的行程时间估算运行时长，自动计算需要运行多久才能到达目标位置。

6.2 定时与光照联动示例

接入 Home Assistant 之后，真正的智能体验来自自动化。下面是一个完整的自动化配置，包含工作日早晨打开卧室卷帘和日落前关闭客厅卷帘两个场景。

automation: - alias: "工作日早晨打开卧室卷帘" trigger: - platform: time at: "07:00:00" condition: - condition: time weekday: - mon - tue - wed - thu - fri action: - service: cover.open_cover target: entity_id: cover.bedroom_shade - alias: "日落前关闭客厅卷帘" trigger: - platform: sun event: sunset offset: "-00:10:00" action: - service: cover.close_cover target: entity_id: cover.living_room_shade

这里值得说明的是sun触发器。Home Assistant 内置了太阳追踪能力，event: sunset会在本地日落时间触发，offset可以是正数或负数，表示提前或延后触发。如果你的客厅下午西晒严重，可以在落日前 10 分钟关帘，效果比固定时间点更好。

6.3 手动控制与其他联动

自动化之外，手动控制方式也可以做得很丰富：

在 Home Assistant 的 Lovelace 卡片中添加实体，用按钮或滑杆控制。
接入语音助手，对小爱同学、HomePod 或本地语音助手说“打开卧室窗帘”。
在门口安装无线按钮，通过 Zigbee 或 WiFi 按钮直接调用 cover 服务。

这些联动方式本质上都是调用 Home Assistant 的cover.*服务，核心的电机控制逻辑已经由 ESPHome 固件完成，应用层只需要做事件绑定。

7. 运行验证与效果检查

7.1 上电前的检查清单

固件烧录完成后，先别急着接电机。建议按以下顺序检查：

用万用表确认电源适配器输出电压正确，极性无误。
不连接电机，先给控制器通电，观察开发板指示灯是否正常。
在 Home Assistant 或 ESPHome 日志中手动触发switch.turn_on，听继电器是否吸合、再释放。
确认两个继电器不会同时吸合。
确认限位开关引脚状态能在 Home Assistant 或日志里正确变化。

这个阶段最容易发现的问题，是继电器高低电平触发方式写反。如果发现在没有命令的情况下继电器自己吸合，先检查switch配置是否需要加inverted: true。

7.2 首次运行测试流程

检查无误后，再连接电机。首次测试建议在空载状态下进行，也就是先不挂卷帘面料，只让电机带动卷管空转。

测试步骤如下：

调用cover.open_cover，观察电机转向是否对应“上升”。
如果转向反了，交换电机两根电源线，或者在固件里交换open_action和close_action的继电器逻辑。
调用cover.stop_cover，确认电机立即停止。
调用cover.close_cover，观察电机是否反向运行。
用秒表实测从全关到全开的时间，更新open_duration和close_duration。
如果有外接限位开关，手动拨动开关，确认限位可以终止运行。
挂上面料后进行带载测试，确认电机的扭矩足以拖动实际负载。

7.3 判断成功的关键指标

一个基本合格的智能卷帘，应该满足以下表现：

全开和全关能准确到位，不会中途停止或到位后继续空转。
运行过程中按停止能立即停止。
连续多次开关后，位置误差在可接受范围内。
断电重启后，Home Assistant 中设备的在线状态能自动恢复。
局域网内控制响应很快，不会出现明显延迟。

如果出现位置越来越不准，优先怀疑行程时间校准不准确，或者卷帘负载变化导致电机转速不一致。这个问题在时间估算方案中比较常见，解决办法是考虑升级到带脉冲计数的硬件方案，或者利用限位开关定期做归位校准。

8. 常见问题与排查方法

DIY 智能卷帘的问题，大多集中在电气接线、继电器逻辑和位置校准这几个环节。下面用表格整理常见问题。

问题现象	可能原因	排查方式	解决方案
电机完全不转	电源未接通或电压不足	用万用表测电机两端电压	检查电源适配器极性和输出电压
上电瞬间继电器自动吸合	继电器为低电平触发，配置写反	查看日志中 GPIO 初始状态	在 switch 配置中加入`inverted: true`
两个继电器同时吸合	固件未做互锁	查看运行日志中的操作序列	在 open/close action 中先关闭另一个继电器
电机转向反了	电机电源线极性接反	观察空载转向	交换电机两端接线或交换 open/close 逻辑
到了顶部/底部电机不停	限位未生效或行程时间没校准	检查限位开关状态和行程时间配置	参考限位开关版配置，增加去抖和截止逻辑
卷帘位置越来越不准	时间估算漂移或负载变化	连续开关后对比实际位置	定期校准行程时间，或升级脉冲计数方案
卷帘运行到一半停住	继电器误触发或电源压降	查看日志中是否有异常停止	检查电源余量，确认互锁逻辑，分析限位传感器抖动
WiFi 频繁掉线	信号弱或电源纹波大	查看 ESPHome 日志中的 WiFi 信号强度	调整天线位置，或在电源两端并联滤波电容
OTA 升级失败	电源供电不足导致重启	查看烧录日志	使用稳定电源，烧录时避免电机运行
重启后位置状态丢失	依赖内存中的位置值	观察 Home Assistant 实体状态	配置 position 恢复组件或增加归位逻辑

遇到问题时，第一个动作永远是看日志。ESPHome 日志会显示组件初始化、WiFi 连接、服务调用等关键信息。在logger中把级别设为DEBUG，能获得更多排查细节。排查完记得恢复为INFO或WARN，避免日志刷屏影响稳定性。

9. 最佳实践与安全建议

9.1 电气安全

智能卷帘虽然是低压系统，但短路风险和大电流发热依然存在。以下是必须遵守的底线：

使用 12V 或 24V 的直流低压系统，不要直接用 220V 交流电控制电机。
电源输入端加保险丝，保险丝额定电流按电机峰值电流的 1.2 到 1.5 倍选择。
所有接线使用接线端子或焊接，不要用裸露的绞线。
控制电路板放入绝缘外壳，避免金属部件触碰。
接线前断开电源，带电操作时绝不能触碰裸露焊点。

9.2 机械与安装安全

卷帘的拉绳和卷管存在潜在安全隐患，尤其是有儿童的家庭，必须特别注意：

卷帘的绳索不要形成可以套在脖子上的环形结构。
电机和卷管的连接必须牢固，防止高速旋转时脱落。
限位保护是防止电机堵转烧毁的关键，必须配置。
安装位置要避开儿童可接触区域，或使用无绳卷帘结构。

安装完成后，手动拉动卷帘，确认面料、卷管和电机之间的连接顺畅，没有卡涩。

9.3 软件与运维建议

固件和自动化层面的最佳实践，可以从五个角度总结。

第一，配置分离。把 WiFi、API 密钥、OTA 密码这些环境相关配置，通过 ESPHome 的 substitutions 或 secrets.yaml 拆分出来，方便多设备复用，也能避免把密钥提交到公开仓库。

第二，密钥管理。ESPHome 的 API 加密密钥和 OTA 密码，建议使用密码生成器生成，不要使用弱口令。API 密钥泄露意味着局域网内的设备可能被未授权控制。

第三，版本控制。YAML 配置建议纳入 Git 管理，每次改动后提交，方便回滚。

第四，日志留痕。Home Assistant 中为卷帘实体添加自动化日志，方便回溯卷帘被自动操作的原因。尤其是多设备联动时，一个 Bug 可能导致窗帘在错误时间开关，日志是定位问题的关键。

第五，OTA 更新要谨慎。在电机运行过程中进行 OTA 烧录，可能出现供电不稳导致升级失败。建议在电机静止、电源稳定的情况下执行 OTA。

9.4 生产环境中的考虑

如果你的目标不只是做一个样板，而是希望整个房间的卷帘都能稳定运行，有几个额外的工程化建议：

多设备统一命名规范，比如bedroom-shade、living-room-shade，避免实体 ID 混乱。
统一电机型号和行程时间，减少日常维护的认知负担。
预留手动开关，保证自动化系统故障时，依然能手动拉起或放下卷帘。
在 Home Assistant 中建立场景，比如“电影模式”同时关闭客厅卷帘和调暗灯光。

10. 总结与后续延伸

这篇关于 DIY 智能卷帘（Smart Roller Shades）的文章，重点讲清楚了四件事：第一，为什么成品智能卷帘的痛点值得用 DIY 方案解决；第二，智能卷帘系统的完整架构是物理层、控制层、网络层、应用层和自动化层的组合；第三，从电机选型、驱动电路到 ESPHome 固件、Home Assistant 自动化，每一步的关键决策都有明确依据；第四，限位保护和互锁逻辑是电气安全的最底线，不能省略。

如果你准备动手实践，建议按这个顺序推进：先不买硬件，用本文的架构图把系统分层梳理清楚；然后确定电机型号和控制板，花一个晚上搭建控制电路；再用 ESPHome 的time_based配置把全开、全关跑通；最后接入 Home Assistant，配置一个最基础的定时自动化。整个流程跑通后，再考虑限位开关、位置精度和多设备联动。

后续值得深入的技术方向包括：用霍尔传感器或编码器实现脉冲计数位置反馈，让卷帘能精确停留在任意位置；把多个卷帘设备通过 MQTT 统一管理，形成客厅、卧室、书房的场景联动；在 ESPHome 中加入光照传感器，让卷帘根据室内亮度自适应调节；以及探索 Zigbee 或 Thread 协议，降低多设备场景下的 WiFi 网络压力。

做智能家居的核心原则，不是买最贵的设备，而是让系统真正服务于生活。自己动手做一个智能卷帘，既省了预算，也把设备的命运握在自己手里。建议收藏备用，下次周末动手时，照着这份清单一步步来。