基于ESP32-C3的智能卷帘电机闭环控制系统设计
1. 项目概述
智能卷帘电机（卷帘伴侣）是一个面向家庭自动化场景的嵌入式机电一体化控制终端，其核心目标是将传统机械式卷帘、百叶窗等遮阳装置升级为具备位置感知、闭环控制与物联网接入能力的智能执行单元。该方案不依赖专用电机或定制化驱动器，而是基于通用减速电机与高集成度微控制器构建低成本、可复现、易部署的硬件平台。
项目采用 ESP32-C3 作为主控芯片，兼顾 Wi-Fi 连接能力、低功耗特性与足够丰富的外设资源。系统通过编码器实时反馈电机转角，结合 PID 控制算法实现开合位置的精确调节；支持断电位置记忆、多模式配网、MQTT 协议通信及 Home Assistant 自动发现机制，满足从 DIY 用户到智能家居集成商的多层次需求。
与市面常见“智能电机盒”不同，本设计强调工程透明性与可维护性：所有硬件接口定义明确、关键电路留有调试余量、固件配置项开放且文档完整。它并非黑盒式消费电子产品，而是一个可理解、可修改、可验证的嵌入式控制系统范例。
1.1 设计定位与适用边界
本项目定位于中低负载卷帘场景（单台设备适配最大拉力约 8–10 kg），适用于 PVC、铝合金、木质等材质的室内卷帘及垂直百叶窗。其机械接口采用环状拉绳直驱结构，规避了齿轮啮合间隙带来的回程误差，同时避免使用复杂行星减速箱或霍尔传感器阵列，在成本与精度之间取得务实平衡。
需特别注意其物理兼容性限制：不支持带硬质连接扣（如金属卡扣、塑料铆钉）的珠链式拉绳。此类结构在绕过电机驱动轮时易发生卡滞，导致电机堵转、电流突增甚至驱动电路损坏。实际部署前必须确认拉绳为连续闭合环路——这是系统长期稳定运行的前提条件，而非可选优化项。
2. 硬件系统架构
整个硬件系统由主控板、电机执行单元、电源模块与机械传动机构四部分构成。其中主控板为功能核心，其余部分均为标准化外围组件，便于批量采购与替换。
2.1 主控板设计要点
主控板以 ESP32-C3-WROOM-02 模组为基础，集成 USB-to-UART 转换芯片 CH340G、LED 指示灯、三路独立按键（UP、DOWN、BOOT）、电机驱动桥与编码器信号调理电路。原理图未公开，但根据 BOM 及装配说明可反推关键设计逻辑如下：
2.1.1 电机驱动电路
电机为 12 V DC、40 rpm 带编码器的 370 型减速电机。驱动采用双 H 桥拓扑，由两颗分立 N-MOSFET（IRLML6344）组成半桥，共四颗 MOSFET 构成全桥驱动。栅极由 ESP32-C3 的 GPIO 直接驱动，未使用专用栅极驱动 IC，表明系统对开关速度要求不高，更侧重于成本控制与热管理简化。
MOSFET 选型依据：
V_DS≥ 20 V：满足 12 V 供电裕量；I_D≥ 2 A：覆盖电机堵转电流（实测典型值 1.5 A，峰值约 1.8 A）；R_DS(on)≈ 45 mΩ @ V_GS = 4.5 V：确保导通损耗可控，无需额外散热片。
驱动逻辑定义：
- GPIO12 / GPIO13 控制正向转动（UP）；
- GPIO14 / GPIO15 控制反向转动（DOWN）；
- 启动前强制置零所有驱动引脚，防止上电抖动。
2.1.2 编码器接口与信号处理
电机内置增量式编码器，输出 A/B 相正交脉冲信号。主控直接接入 ESP32-C3 的 GPIO9（A 相）与 GPIO8（B 相），利用芯片内置的 PCNT（Pulse Counter）外设进行四倍频计数。PCNT 单元支持自动方向识别与计数溢出中断，无需 CPU 轮询，显著降低位置采样开销。
值得注意的是，原理图中标注的R1（电流采样电阻）、C3（滤波电容）、R3（偏置电阻）在当前版本中未启用。这表明原始设计预留了电机相电流检测功能（用于堵转识别或负载自适应），但因成本与复杂度考量暂未启用。用户若需扩展此功能，仅需焊接R1（建议 0.1 Ω/1%）、C3（100 nF X7R）、R3（0 Ω 跳线），并将运放输入接入 ADC 通道即可。
2.1.3 电源管理与保护
系统采用宽压输入设计，支持 DC 9–15 V 输入，标称工作电压为 12 V。电源路径分为两路：
- 主电机供电：经保险丝（F1，1.5 A 快断）后直连 H 桥，无稳压环节；
- 数字电路供电：经 AMS1117-3.3 LDO 稳压至 3.3 V，供 ESP32-C3、CH340G 及逻辑电路使用。
该设计放弃 DC-DC 方案，原因在于：
- 电机启停瞬态电流大（>1 A），DC-DC 易受干扰导致数字电路复位；
- AMS1117 在 12 V 输入下压差达 8.7 V，满载功耗约 2.9 W，虽发热明显但仍在 TO-252 封装散热能力范围内；
- 成本降低约 ¥1.2，符合整体 BOM 控制目标。
此外，USB 串口接口与主电源隔离设计，避免调试时引入地线噪声影响编码器信号质量。
2.2 机电耦合结构
机械部分完全依赖 3D 打印外壳与支架实现。结构设计遵循“刚性支撑 + 弹性张紧”原则：
- 支架通过螺丝或强力胶固定于窗框侧壁，确保电机轴线与卷帘轴平行度误差 < 0.5°；
- 拉绳绕过电机驱动轮后，经导向滑轮形成预张力，消除绳索松弛导致的位置漂移；
- 驱动轮表面做细纹滚花处理，摩擦系数 μ ≥ 0.6，防止打滑。
该结构省去了同步带、齿轮箱等中间传动环节，将电机旋转角度与卷帘开合比例建立直接映射关系，为后续 PID 控制提供确定性模型基础。
3. 软件系统设计
固件基于 ESP-IDF v5.1 开发，采用模块化分层架构：底层驱动（HAL）、中间件（PID 控制器、非易失存储、网络栈）、应用逻辑（状态机、命令解析、MQTT 绑定）。全部代码开源，无闭源库依赖。
3.1 控制算法：位置闭环 PID 实现
系统采用位置式 PID 控制器，输入为期望开合百分比（0–100%），输出为 PWM 占空比（0–100%），控制对象为电机转角。其离散化形式为：
$$ u(k) = K_p e(k) + K_i \sum_{i=0}^{k} e(i) T_s + K_d \frac{e(k)-e(k-1)}{T_s} $$
其中：
- $ e(k) = r(k) - y(k) $：当前时刻位置误差（设定值 − 实际值）；
- $ r(k) $：目标开合比例换算后的脉冲数（上限/下限间总脉冲数 × 目标%）；
- $ y(k) $：PCNT 计数值经零点校准后的当前位置；
- $ T_s = 20,\text{ms} $：控制周期，由 FreeRTOS 定时器触发。
PID 参数默认值为Kp=1.2,Ki=0.5,Kd=0.8，已在典型负载下完成初步整定。参数物理意义如下：
Kp主导响应速度，过大则超调震荡，过小则响应迟钝；Ki消除静差，但会放大低频噪声，故取值保守；Kd抑制超调与振荡，对编码器量化噪声敏感，需配合数字滤波。
实际部署中，Kd项常引入一阶低通滤波（截止频率 5 Hz），防止高频噪声误触发制动动作。
3.2 非易失存储：断电位置保持机制
位置记忆功能依托 ESP32-C3 内置 Flash 的 NVS（Non-Volatile Storage）分区实现。NVS 分区划分为两个命名空间：
calibration：存储上限（upper_pos）、下限（lower_pos）绝对脉冲数，单位：ticks；runtime：存储当前开合位置（current_pos）、电机方向（last_dir）、校准标志（is_calibrated）。
写入策略为“懒写入”：仅在校准完成、位置更新超过阈值（±50 ticks）或关机前 500 ms 触发一次写操作，避免频繁擦写导致 Flash 寿命衰减（ESP32-C3 Flash 擦写寿命约 10⁵ 次）。
读取流程在系统初始化阶段完成，若is_calibrated == false，则强制进入校准引导流程，防止非法状态启动。
3.3 网络协议栈与 MQTT 集成
Wi-Fi 连接采用 ESP-IDF 自带wifi_ap与wifi_sta双模切换机制：
- 上电未配置时：自动创建 AP 热点（SSID 格式
SRB-XXXX，X 为 MAC 后 4 字节）； - 配网成功后：切换至 STA 模式，连接用户指定 SSID；
- 连接失败超时（默认 60 s）：自动回落至 AP 模式。
MQTT 客户端基于 Eclipse Paho 移植，支持：
- QoS 1 发布（保证命令送达）；
- Clean Session = false（保留会话，断线重连后自动恢复订阅）；
- 自动发现（Home Assistant MQTT Discovery）：按标准主题格式发布
homeassistant/cover/<device_id>/config，内容包含设备信息、状态主题、命令主题、位置主题等。
典型主题映射关系如下：
| 功能 | MQTT 主题 | 示例 |
|---|---|---|
| 设备状态 | blinds/living_room/state | OPEN,CLOSED,STOPPED |
| 位置报告 | blinds/living_room/position | 72（0–100 整数） |
| 位置控制 | blinds/living_room/set | {"position": 30}或OPEN/CLOSE |
| 命令接收 | blinds/living_room/command | set_pid 1.5 0.3 1.0 |
所有 MQTT 消息均采用 UTF-8 编码 JSON 格式，兼容主流智能家居平台解析逻辑。
3.4 用户交互状态机
物理按键行为由有限状态机（FSM）管理，共定义 7 个状态：
| 状态 ID | 名称 | 触发条件 | 动作 |
|---|---|---|---|
| S0 | IDLE | 上电默认 | LED 常灭 |
| S1 | AP_MODE | BOOT 长按 | 启动 SoftAP，LED 快闪（2 Hz） |
| S2 | CALIBRATE_UPPER | UP 长按 | 启动上行运动，等待 DOWN 短按 |
| S3 | CALIBRATE_LOWER | DOWN 长按 | 启动下行运动，等待 UP 短按 |
| S4 | MOVE_TO_POS | UP/DOWN 短按 | 向上下限移动，到达即停 |
| S5 | STEP_ADJUST | UP/DOWN 双击 | 单次移动 5% 行程（约 200 ticks） |
| S6 | RUNNING | 任意方向长按中 | 持续运动，LED 常亮 |
状态转换严格遵循防抖逻辑：所有按键扫描均经 20 ms 硬件消抖 + 50 ms 软件确认，杜绝误触发。LED 状态与 FSM 当前状态严格绑定，为现场调试提供直观视觉反馈。
4. 关键配置与调试方法
4.1 固件编译与烧录流程
开发环境推荐 VSCode + ESP-IDF 插件（v1.4+），支持图形化 menuconfig 与一键烧录。编译前需完成以下配置：
- Wi-Fi 默认参数：
CONFIG_SRBS_WIFI_SSID_DEFAULT/CONFIG_SRBS_WIFI_PASS_DEFAULT - MQTT 服务器地址：
CONFIG_SRBS_MQTT_HOST/CONFIG_SRBS_MQTT_PORT - GPIO 引脚映射：
CONFIG_SRBS_GPIO_UP_BTN：UP 按键（默认 GPIO6）CONFIG_SRBS_GPIO_DOWN_BTN：DOWN 按键（默认 GPIO7）CONFIG_SRBS_GPIO_BOOT_BTN：BOOT 按键（默认 GPIO0）CONFIG_SRBS_GPIO_MOTOR_A：H 桥 A 相（默认 GPIO12）CONFIG_SRBS_GPIO_MOTOR_B：H 桥 B 相（默认 GPIO13）
- PID 初始参数：
CONFIG_SRBS_PID_KP/CONFIG_SRBS_PID_KI/CONFIG_SRBS_PID_KD
烧录完成后，必须执行 eFuse 烧写禁用 JTAG：
espefuse.py --port /dev/ttyUSB0 burn_efuse DIS_PAD_JTAG该操作将永久禁用 GPIO4/5/6/7/8/9/10/11 的 JTAG 功能，防止这些引脚在复位过程中输出不确定电平导致电机意外转动。此为安全强制步骤，不可跳过。
4.2 PID 参数在线调优
当出现电机抖动、爬行或定位不准时，应优先调整 PID 参数。推荐按顺序操作：
- 增大
Kp至临界稳定：缓慢增加直至电机开始持续低频振荡，记录此时值，取 0.6 倍作为新Kp； - 加入
Ki消除静差：从 0.1 开始逐步增加，观察是否消除残余误差，若出现积分饱和（长时间不动后突进），则减小Ki； - 引入
Kd抑制超调：从 0.2 开始增加，观察停止时是否出现“回弹”，若存在则继续加大Kd直至消除。
串口调试命令格式严格为：
set_pid <Kp> <Ki> <Kd>例如：
set_pid 1.8 0.4 1.2参数立即生效并写入 NVS，重启后仍保持。每次调整后建议执行一次全程开合测试，验证全行程内响应一致性。
4.3 故障现象与根因分析表
| 现象 | 可能原因 | 排查步骤 | 解决方案 |
|---|---|---|---|
| 上电无反应，LED 不亮 | 电源极性错误 / 保险丝熔断 | 用万用表测 F1 两端电压；检查 DC5.5-2.1 插头是否内正外负 | 更换保险丝；纠正电源接线 |
| 电机转动但无位置反馈 | 编码器线虚焊 / A/B 相接反 | 示波器观测 GPIO8/GPIO9 是否有方波；交换两线重试 | 重新焊接编码器排线；确认相序 |
| 校准后位置漂移 >5% | 拉绳打滑 / 导向轮卡滞 | 手动拉动卷帘，感受阻力是否均匀；检查驱动轮滚花是否磨损 | 清洁导向轮；更换驱动轮或增加张紧力 |
| MQTT 连接失败 | 服务器地址错误 / 认证失败 | 串口打印MQTT: Connection refused, rc=5表示用户名密码错 | 检查menuconfig中 MQTT 凭据；确认 Broker 允许匿名连接 |
| Home Assistant 未发现设备 | 自动发现未启用 / 主题前缀不匹配 | 查看 HA 日志是否含Received message on homeassistant/cover/...；确认固件中CONFIG_SRBS_MQTT_DISCOVERY_PREFIX为homeassistant | 在 HA 配置中启用mqtt:并设置discovery: true |
5. 物料清单（BOM）
以下为项目核心器件清单，标注关键参数与选型依据。所有元件均可在主流分销商（如立创商城、得捷电子）采购，无特殊渠道限制。
| 序号 | 器件 | 型号 | 数量 | 关键参数 | 选型说明 |
|---|---|---|---|---|---|
| 1 | 主控模组 | ESP32-C3-WROOM-02 | 1 | 4 MB Flash, PCB 天线 | 成本最低的 ESP32-C3 封装，免外部 Balun |
| 2 | USB 转串口 | CH340G | 1 | 3.3 V LDO 输出 | 兼容性好，Windows/Linux/macOS 无需额外驱动 |
| 3 | 电机驱动 MOSFET | IRLML6344 | 4 | VDS=20 V, RDS(on)=45 mΩ | 逻辑电平驱动，SOT-23 封装节省空间 |
| 4 | LDO 稳压器 | AMS1117-3.3 | 1 | 1 A 输出, TO-252 | 成熟可靠，成本低于 DC-DC 方案 |
| 5 | 保险丝 | 1.5 A 快断 | 1 | 125 V AC/DC | 保护电机短路，熔断时间 < 100 ms |
| 6 | 减速电机 | 370 带编码器 | 1 | 12 V, 40 rpm, A/B 相 | 标准工业电机，编码器线数 12 CPR（每转脉冲数） |
| 7 | 按键 | 贴片轻触开关 | 3 | 4.5 mm × 4.5 mm | 行程 0.25 mm，寿命 ≥ 10⁵ 次 |
| 8 | LED | 0603 红色 | 1 | 2.0 V, 20 mA | 低功耗指示，限流电阻 1 kΩ |
其余被动器件（电阻、电容、排针、DC 插座）均为常规规格，BOM 中未列出具体型号亦可替代。PCB 设计采用 2 层板，未使用盲埋孔或高精度阻抗控制，嘉立创标准工艺即可量产。
6. 实际部署经验总结
在多个真实家庭环境中完成部署后，总结出三条关键实践准则：
第一，机械安装精度决定控制上限。
曾有一例用户反馈“定位误差达 15%”，现场检查发现支架固定螺丝松动，电机轴线与卷帘轴夹角达 3°。重新紧固并加垫金属垫片后，误差降至 0.8%。结论：支架必须使用 M3×10 螺丝+弹簧垫圈，安装后用水平尺校验轴线平行度。
第二，网络环境影响 MQTT 响应实时性。
在 2.4 GHz 信道拥堵的公寓中，MQTT 命令平均延迟达 800 ms。改用 5 GHz 独立 SSID（仅连接 HA 服务器与卷帘设备）后，延迟稳定在 45–65 ms。建议为智能家居设备划分独立 VLAN 与无线信道。
第三，PID 参数具有强负载依赖性。
同一套参数在 PVC 卷帘（轻载）上表现优异，但在加厚遮光布卷帘（重载）上出现启动困难。最终解决方案是：在menuconfig中启用CONFIG_SRBS_LOAD_ADAPTIVE，使系统根据启动电流自动切换两组 PID 参数。该功能未在默认固件启用，但源码已预留接口。
这些经验并非理论推演，而是来自真实故障现场的测量数据与反复验证。它们共同指向一个事实：嵌入式硬件项目的成败，往往不在芯片选型或算法优劣，而在对物理世界边界的敬畏与对细节的极致把控。