这次我们来看一个 Hacker News 上的 Show HN 项目作者自己动手做了一套智能卷帘Smart Roller Shades。和直接买成品智能窗帘不同这个项目把普通卷帘、电机、控制器、固件和本地控制接口这一整条链路自己打通最终能通过 Web 页面、App 或 API 控制开合再叠加上限位校准和位置反馈让卷帘能停在任意百分比的位置。这类项目在智能家居 DIY 里很有代表性。技术栈不算复杂但坑很密集电机选型、驱动电路、限位开关、位置估算、WiFi 断线重连、多路卷帘联动每一环都会直接影响最终体验。只看成品智能窗帘很难理解内部怎么工作从零搭一套反而能把“电机控制 状态反馈 本地 API 家庭自动化集成”这条链路彻底跑通。这篇文章按“先看能不能做、再看怎么做、最后怎么验证”的顺序展开。内容包括整套系统的核心能力与架构、常见硬件选型思路、固件和本地控制逻辑、REST/MQTT 接口调用方式、位置校准与批量同步的测试流程、运行状态与资源占用观察以及一份可以直接照着排查的常见问题清单。适合想入门智能家居 DIY、对电机控制和本地 API 集成感兴趣的读者。1. 核心能力速览这个项目属于个人 DIY 智能卷帘方案核心价值不在硬件本身而在于“本地可控、状态可查、接口可扩展”。先看能力速览能力项说明项目类型智能卷帘 / 智能窗帘 DIY 硬件项目核心功能开帘、关帘、停止、任意开合百分比控制控制方式本地 Web / App / API通常保留手动按键位置反馈基于限位开关、编码器或运行时间估算网络接入WiFi 局域网常见控制器为 ESP32 / ESP8266系统集成通过 HTTP / MQTT 接入 Home Assistant 等平台批量能力多路卷帘可并行控制需要处理同步与冲突计算门槛无 GPU / 显存要求纯嵌入式场景主要门槛电机选型、限位校准、断电位置保持、网络稳定性适合场景家庭窗户遮阳、智能家居自动化、嵌入式开发学习这里要说明不同作者的实现差异很大电机额定电压、控制器型号、通信协议、固件写法都不是固定答案。上面表格是这类项目常见的共同点具体参数要以你参考的实际源码和硬件为准。2. 适用场景与使用边界先判断这个项目适不适合你。适合的读者和场景想给家里普通卷帘加自动化、但不想买整套成品系统的人想系统学习电机驱动、位置反馈、嵌入式 Web 服务的开发者已经有 Home Assistant 等智能家居平台、希望把卷帘纳入自动化场景的用户对云端控制有顾虑、希望把控制逻辑放在局域网内的人。它能解决的问题也很明确定时开关帘、按光照或温度联动、离家后远程查看状态、把卷帘和其他设备编成联动场景这些都能通过本地接口做出来。不适合的场景也要说清楚。如果没有电工基础涉及 220V 交流电机的接线不建议直接上手如果窗户尺寸和卷帘重量变化范围很大一颗电机很难通用如果完全不想写代码、不想调试硬件成品智能窗帘依然是更省事的方案。安全与合规边界方面有几点必须注意。第一涉及市电接线时先断电、再操作必要时请专业电工完成。第二卷帘运行时存在夹手或缠绕风险有儿童的家庭要加装防护并在固件里保留急停逻辑。第三如果后续接入摄像头、人体传感器或其他数据采集设备要遵守个人信息保护要求传感器数据不要随意上传公网。第四自己改装的设备建议只在家庭局域网或受控网络内提供服务不要默认暴露到公网。3. 整体架构设计从这类 DIY 方案的常见实现来看整套系统可以拆成四层。机械层负责卷帘本体、卷管、电机和传动结构驱动层负责电机驱动板、限位开关或编码器、电源模块控制层是带 WiFi 的微控制器运行固件完成电机控制和位置估算应用层提供 Web 页面、App、HTTP 接口和 MQTT 服务以及 Home Assistant 这类自动化平台。数据流通常是用户通过 Web 页面或 App 发一条“开到 50%”的指令控制层收到后解析为目标位置通过驱动层启动电机同时根据限位开关或运行时间持续更新当前位置到达目标后停机并更新状态把“当前百分比”推回给页面或 MQTT 主题。这套架构最大的好处是控制逻辑完全在本地。即使外部服务不稳定局域网内的卷帘依然可以正常开关。位置反馈是整套系统的关键点常见实现方式有三种限位开关在完全打开和完全关闭的位置各装一个微动开关简单可靠但只能判断端点中间位置需要估算。旋转编码器加在电机或卷管上持续输出脉冲精度最高但接线和固件处理更复杂。运行时间估算记录电机从一端走到另一端的时间用线性关系近似当前位置实现最简单但精度受电压、负载和机械阻力影响。对大多数 DIY 项目来说“限位开关做端点保护 时间估算做中间位置”是性价比很高的组合。实际选哪种取决于你对“停在指定百分比”的精度要求。4. 硬件选型与环境准备4.1 电机怎么选卷帘对电机的要求不算高但要匹配卷帘的重量和卷管直径。常见选择有三类交流管状电机常见于成品电动卷帘扭矩大但需要继电器或可控硅控制正反转接线涉及市电危险系数高直流减速电机电压低、控制简单、适合 DIY扭矩和速度需要根据卷帘重量实测步进电机位置控制精准便于实现开合百分比但扭矩偏小卷帘较重时需要减速箱待机时还可能要保持力矩。更稳妥的 DIY 方向是低压直流方案先用桌面测试跑通逻辑再考虑是否换成管状电机。4.2 控制器与驱动控制器优先选带 WiFi 的型号ESP32 这类模组在社区很常见资料多、调试方便。驱动板要根据电机类型选择直流电机用 H 桥驱动步进电机用对应的步进驱动板。注意电机启动瞬间电流可能比额定电流高不少电源余量要留足否则会出现“单独转正常、接上负载就重启”的现象。4.3 环境准备清单开始接线前把环境准备好操作系统Windows / Linux / macOS 均可主要用来烧录固件。开发环境Arduino IDE 或 PlatformIO安装对应开发板支持包。硬件工具万用表、螺丝刀、剥线钳、电工胶带、热缩管。网络设备能分配固定 IP 的路由器便于后续配置 API 和 MQTT。测试对象一套能自由升降的卷帘、可靠的电源、限位开关或编码器。这套清单不需要一次买齐先用开发板和电机搭出最小系统跑通开关逻辑再逐步完善。5. 固件开发与本地控制5.1 固件的基本结构固件是整套系统的核心建议按功能拆模块WiFi 连接、Web 服务、电机驱动、位置管理、配置持久化。下面给出一个简化的 Arduino 风格模板说明“控制指令 - 电机动作 - 位置更新”的主流程#define MOTOR_OPEN_PIN 26 #define MOTOR_CLOSE_PIN 27 int currentPosition 0; // 0 表示完全关闭100 表示完全打开 int targetPosition -1; void setup() { pinMode(MOTOR_OPEN_PIN, OUTPUT); pinMode(MOTOR_CLOSE_PIN, OUTPUT); // 初始化 WiFi、Web Server、文件系统 } void loop() { if (targetPosition 0 targetPosition ! currentPosition) { if (targetPosition currentPosition) { digitalWrite(MOTOR_OPEN_PIN, HIGH); digitalWrite(MOTOR_CLOSE_PIN, LOW); } else { digitalWrite(MOTOR_OPEN_PIN, LOW); digitalWrite(MOTOR_CLOSE_PIN, HIGH); } updatePositionByTime(); } else { digitalWrite(MOTOR_OPEN_PIN, LOW); digitalWrite(MOTOR_CLOSE_PIN, LOW); } }这段代码只表达思路引脚号是示例实际项目需要根据你的开发板和驱动板重新定义并处理限位开关中断、电机启动缓冲、网络断线后的状态恢复等细节。5.2 位置校准流程位置校正是这台设备能不能好用的关键。不要一上来就写死运行时间先用下面的流程做一遍把卷帘手动放到完全关闭的机械位置。发送一个“复位”指令把当前位置设为 0%。让电机向打开方向运行直到触碰到打开限位开关。记录这次运行时间作为 0% 到 100% 的基准值。用同样的方式反向校验关闭方向。校准完成后把“总运行时间”“当前百分比”“限位点”保存到非易失存储中这样设备断电重启后还能记住位置不需要每次重新校准。5.3 手动按键与安全逻辑即使有 App 和 API手动按键也必须保留。建议在固件里加这几条安全逻辑运行过程中按下任意按键立即停止电机这是最高优先级。到达两个端点时强制停机避免电机堵转。如果连续运行时间超过正常完成时间的 1.5 倍自动急停并报错防止限位开关失效造成损坏。启动时先读取保存的位置不直接执行未知来源的百分比指令。6. Web/API 接口与 Home Assistant 集成6.1 REST API 设计本地 API 是系统集成的基础。把卷帘动作抽象成几个简单端点逻辑清晰也方便其他程序调用。下面是一组 REST API 调用示例实际路径以你的固件实现为准# 查询当前状态 curl http://192.168.1.100/api/shade/status # 打开、关闭、停止 curl http://192.168.1.100/api/shade/open curl http://192.168.1.100/api/shade/close curl http://192.168.1.100/api/shade/stop # 设置开合百分比 curl -X POST http://192.168.1.100/api/shade/position \ -H Content-Type: application/json \ -d {position: 50}Python 端调用也很简单import requests BASE_URL http://192.168.1.100 def set_position(percent: int) - dict: if not 0 percent 100: raise ValueError(position must be between 0 and 100) resp requests.post( f{BASE_URL}/api/shade/position, json{position: percent}, timeout10, ) resp.raise_for_status() return resp.json() if __name__ __main__: print(set_position(65))调用接口时常见的坑是没有限制访问范围、没有鉴权、没有超时。建议在路由器或固件层面把 API 限制在局域网必要时为写操作加一个简单的 API Key。6.2 MQTT 接入如果家里有 Home AssistantMQTT 是更顺滑的接入方式。卷帘固件订阅一个 set 主题、发布 state 主题平台侧就能实时同步状态。发布控制指令示例mosquitto_pub -h 192.168.1.50 \ -t home/bedroom_shade/set \ -m {command: position, value: 50}订阅状态示例mosquitto_sub -h 192.168.1.50 \ -t home/bedroom_shade/stateHome Assistant 里的 cover 实体可以通过 MQTT discovery 自动发现或者用配置声明。这样你可以把卷帘和光照传感器、日历、离家模式组合成自动化场景比如日落前自动关闭、离家后按预设比例降下。6.3 批量控制设计多路卷帘的批量控制建议设一个“组”的概念。把多个卷帘挂到同一个组对外提供组级 API开、关、同步定位。批量控制要处理两个关键问题一是设备间执行时间不同步需要设定统一的完成时间和偏差阈值二是部分设备离线时组指令是忽略还是保留到设备上线后补发这个要在设计阶段定清楚。最简单的批量指令示例{ group: living_room, command: position, value: 50, timeout: 30 }7. 校准与批量同步验证接口写完了最终要落在实际效果上。下面给出一套可复用的验证流程不需要昂贵设备只看动作是否准确、状态是否一致。7.1 单路校准验证复位到 0%记录限位状态。发送“位置 100%”等电机停止确认卷帘完全打开且没有堵转声。发送“位置 50%”用卷尺测量实际开合比例判断误差范围。连续执行 0% - 100% - 50% - 0% 十个循环观察是否每次停在相同位置。如果中间位置每次偏差都比较大通常是运行时间线性估算不准可以考虑加入编码器或者做多点速度补偿。7.2 批量同步验证准备两路或三路卷帘全部完成校准。同时发送组级“位置 50%”指令。观察各路是否同时启动、同时停止最终位置差异是否在可接受范围。把其中一路手动断网再次发送组指令确认离线设备不会收到执行也不影响其他设备。批量同步的意义在于同一面窗户或同一个房间的多路卷帘如果动作不同步视觉上会非常明显。实际同步精度要以你的机械和网络环境实测为准。7.3 稳定性验证最后做一次长期稳定性测试。连续运行 3 到 7 天每天定时执行开合记录以下信息是否有单次指令丢失或延时断电重启后位置是否恢复长时间运行后电机表面温度是否异常WiFi 是否掉线掉线后能否自动重连限位开关反复触发后是否出现抖动误触发。这些点直接决定这套系统能不能从“调试玩具”变成“日常可用”。8. 资源占用与运行状态观察智能卷帘没有显存、CPU 算力的概念但资源占用依然要关注主要是这几个维度。引脚资源限位开关、电机控制、按键、LED 分别占多少引脚是否够用。网络资源WiFi 连接和 HTTP/MQTT 通信是否稳定局域网内是否有明显延迟。存储资源固件、配置持久化和日志占用的 flash 空间校准数据要规划好。功耗电机运行时电流较大待机时控制器功耗可以做得极低如果打算用电池供电要特别关注待机电流和 WiFi 的连接策略比如休眠轮询。运行状态的观察方法也很直接在固件里定期输出日志记录“当前指令、电机状态、当前位置、WiFi 信号强度”。用串口监视器或局域网日志工具观察能快速定位大部分问题。如果发现电机运行明显变慢或电流异常升高优先检查机械阻力、电源电压和减速箱润滑这通常不是固件问题。9. 常见问题与排查方法下面这份排查清单覆盖 DIY 智能卷帘最常见的故障。问题现象可能原因排查方式解决方案电机不动作电源未接通或驱动板接线错误万用表测电源电压检查驱动板信号线重新接线确认使能引脚状态只能开不能关电机方向控制信号接错查看固件日志确认控制引脚输出交换方向控制引脚或调整固件逻辑到端点仍不停机限位开关未触发或信号抖动用万用表检测限位开关通断查看日志调整开关位置固件加软件去抖中间位置偏差大时间估算不准、机械阻力变化多次校准并记录误差加入编码器或做多点速度补偿断电后位置丢失校准数据未持久化查看 flash 写入逻辑将位置和校准参数保存到 NVS 或文件系统WiFi 频繁掉线天线位置差、路由器信道拥挤或电源不足观察 WiFi 信号强度查电源稳定性调整天线、固定信道、换更大电源API 请求超时IP 变化或服务未启动检查设备 IP 和 Web Server 日志绑定静态 IP启用服务自动重启批量指令部分不执行设备离线或组配置不一致分别查询各设备状态设计离线重试或组内确认机制电机运行有异响或发热机械装配问题或过载拆下负载空载测试调整装配检查减速箱和电源余量断电重启后状态错误位置初始化逻辑缺失断电重启后查询状态接口上电先读持久化位置再做校准确认排查的核心原则是先看电源、再看接线、最后看固件逻辑。不要一上来就改代码先用万用表和串口日志把现象定位到某一层。10. 最佳实践与安全建议最后给出一套可以直接使用的工程化建议。第一先把最小系统跑通再上墙。开发板上用电机空载测开关逻辑比直接把卷帘装上墙再调试省事得多。第二校准参数一定要持久化。位置、总运行时间、限位开关状态这些是设备复位的依据断电丢失会让体验大打折扣。第三所有接口都加超时和错误码。本地 API 看似简单真正接入自动化场景后超时重试和状态确认逻辑迟早要补上。第四网络层面做最小暴露。默认只在局域网内提供 Web / API / MQTT 服务如需外网访问优先用带身份验证的安全隧道方案而不是直接把端口暴露到公网。第五安全逻辑优先于自动化逻辑。手动按键和急停必须是最优先级的操作任何自动化场景都不能阻塞急停。第六涉及市电的接线务必谨慎。没有把握就不要碰 220V 部分找专业人员完成。低压直流方案虽然更安全同样要做好绝缘和过热保护。第七多路卷帘一定设计组管理和离线策略。单路设备跑通只是第一步组内同步和离线补发才是真正影响日常体验的部分。最后如果你要做的是把别人家的成品卷帘改造成智能控制要先确认改造不破坏产品原有安全结构并保留原手动控制能力。涉及家庭成员使用习惯和隐私的也应该提前沟通清楚。总结这个项目最值得尝试的地方是它把硬件、固件、网络和 API 集成完整串在了一起工程量不大但每一环节都有真实的坑。第一次上手建议先做最小系统验证“开关 - 限位 - 位置保存”这一条主链路再逐步加 Web 页面、MQTT 和批量组控制。最容易踩的坑集中在两处限位校准不准导致中间位置漂移以及设备重启后位置状态丢失这两点只要在设计固件时提前处理后续会省掉大量调试时间。后续可以扩展的方向不少增加光照和温湿度传感器做环境联动把多路卷帘组合成场景接入语音助手或者把控制逻辑迁移到 ESPHome 上减少自维护固件的成本。如果你也在做类似的智能家居 DIY建议把这篇文章里的验证流程和排查清单收藏起来等你的电机和控制器到货后直接照着测。