SuperAPI AI 工具集

esp32-wifi-provision

通用与其它

查看项目

更新于 10-15 21:48

技能介绍

用途:把 Wi-Fi 凭据安全送入 ESP32 设备,先做配网方式选型,再实现状态机与安全约束,不凭记忆编造传输层细节,基线未抓取的参数标注“运行时核验”。

主要能力:覆盖四种官方方式——Unified Provisioning(基于 protocomm,SoftAP+HTTP 或 BLE GATT,Security 0/1/2 可选,默认 2,有官方 iOS/Android App,推荐量产使用)、SmartConfig(legacy,仅存量兼容,可靠性弱)、Wi-Fi Easy Connect(DPP,基线仅确认存在)、protocomm 直用(自定义协议底座)。提供配网状态机:未配网→配网中→已配网,以及凭据失效后的重配分支,要求持久化“是否已配网”状态。

使用方式:先核验环境,运行 idf.py --version 与 idf.py list-targets 2>/dev/null | head -5 || echo "IDF not in PATH";核对芯片无线能力;按选型表定传输与安全方案;用 idf.py add-dependency <network_provisioning 组件名=版本> 接入组件(准确命名空间与版本以 registry 运行时查询为准);实现状态机并做真机验证。

适用场景:产品量产配网选型、已定方式的实现、配网排障、凭据生命周期管理。

限制与红线:ESP32-H2 无 Wi-Fi,ESP32-P4 无片上射频,ESP32-S2 无蓝牙;不得硬编码 SSID/密码;Production 不得用 Security 0;BLE 传输约需 110KB RAM;NVS 持久化凭据属运行时核验项,须真机重启验证;无真机时结论只能标 Build Verification Only。手机 App 开发与自定义传输协议设计超出本技能范围。