You need to enable JavaScript to run this app. 如何从Ionic安卓应用向ESP32正确传输WiFi蓝牙配网凭证?
优惠活动
大模型
产品
解决方案
定价
更多

如何从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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.07 21:54:03