如何从Ionic安卓应用向ESP32正确传输WiFi蓝牙配网凭证?
问题核心原因
你当前直接发送纯文本拼接的WiFi凭证,不符合ESP32 wifi_prov_mgr 组件的接收要求:ESP32侧需要的是符合给定proto结构、经过Protobuf序列化后的二进制数据,而不是明文串,这也是你看到unpack报错、日志打印乱码的核心原因。
解决方案步骤
1. 编译proto文件生成前端序列化工具
你需要将乐鑫提供的配网相关proto文件(至少包含你给出的wifi_config.proto、以及定义了WiFiConfigMsgType枚举的依赖proto)编译为Ionic项目可用的TS/JS工具,推荐用protobufjs完成:
- 先安装依赖:
npm install protobufjs protobufjs-cli --save - 执行编译命令生成JS工具和TS类型声明:
# 生成JS模块 npx pbjs -t static-module -w es6 -o src/utils/wifi_prov.js 你的proto文件路径/wifi_config.proto # 生成TS类型定义 npx pbts -o src/utils/wifi_prov.d.ts src/utils/wifi_prov.js
2. 构造符合要求的Protobuf数据结构
按照proto定义,配网数据需要封装到WiFiConfigPayload结构中,示例代码如下:
// 导入编译好的配网proto工具 import { WiFiConfigPayload, CmdSetConfig, WiFiConfigMsgType } from 'src/utils/wifi_prov'; // 填入你的WiFi凭证 const wifiSSID = '你的WiFi名称'; const wifiPassword = '你的WiFi密码'; // 构造SetConfig命令 const cmdSetConfig = CmdSetConfig.create({ ssid: new TextEncoder().encode(wifiSSID), passphrase: new TextEncoder().encode(wifiPassword), // bssid和channel非必填,留空即可 }); // 封装为顶层Payload结构 const provPayload = WiFiConfigPayload.create({ // 注意这个枚举值要和你proto中`TypeCmdSetConfig`对应的数值一致,通常为12 msg: WiFiConfigMsgType.TypeCmdSetConfig, cmdSetConfig: cmdSetConfig });
3. 序列化后传入BleClient.write
将构造好的Protobuf对象序列化为二进制,再转成DataView传入write方法即可,插件会自动处理非web平台的hex转换逻辑:
// 序列化Protobuf为Uint8Array const encodedPayload = WiFiConfigPayload.encode(provPayload).finish(); // 转换为插件要求的DataView格式 const dataView = new DataView(encodedPayload.buffer, encodedPayload.byteOffset, encodedPayload.byteLength); // 调用蓝牙写接口 await BleClient.write(device.deviceId, '你的GATT服务UUID', '你的特征值UUID', dataView);
注意事项
- 乐鑫WiFi配网是完整的会话流程:你需要先完成版本协商、会话建立(如果开启了配网加密还要先完成密钥交换),再发送SetConfig、ApplyConfig命令,最后等待配网结果回调,跳过前置步骤直接发配置数据会被ESP32拒绝。
- 你之前看到的inbuf乱码是正常现象:Protobuf序列化后的数据本身就是二进制非明文,用
%s格式打印二进制数据自然会显示乱码,只要wi_fi_config_payload__unpack函数不报错就是数据传输正确。 - 如果不想自行实现全流程,可以直接使用npm上已有的适配Capacitor的ESP32配网封装库,减少自研成本。
内容的提问来源于stack exchange,提问作者coder101
相关产品推荐
相关产品推荐

