news 2026/6/15 18:55:36

小智AI蓝牙配网+声波配网:原理+流程拆解

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
小智AI蓝牙配网+声波配网:原理+流程拆解

小智AI 最新版固件更新到2.1.0,相比2.0.5有哪些重大更新?

今天扫了一遍新增commit,发现:

架构更新主要有:

  • 设备状态更新机制:调整为设备状态机
  • 音频编解码器重构:用 ESP-IDF 官方音频组件esp_audio_codecesp_audio_effects替换原来的的78opus编解码器。内存占用更低。

功能更新主要有:

  • WIFI配网新增了两种方式:蓝牙配网和声波配网

相比原先的AP配网,这两种方式的用户体验都更友好。

所以,

今日分享,聊聊蓝牙配网和声波配网的基本原理和通信流程。

1. 蓝牙配网

一句话简介:通过 BLE 低功耗蓝牙将 Wi-Fi 的 SSID 与密码从手机传输至设备。

1.1 整体架构

从设备端代码上看,简单画个流程图:

具体而言,

Step 1: 配网模式的触发

当设备状态不是Starting且未处于说话状态时,调用StartWifiConfigMode()进入配网模式。

Step 2: 停止 Station 模式

设备断开和当前 Wifi 的连接

Step 3: 状态机切换到配网状态

将设备状态机切换到配网状态。

Step 4: 启动蓝牙配网

在 WifiBoard::StartWifiConfigMode() 中,根据 Kconfig 配置选项选择并启动具体的配网方式。

Step 5: 初始化 BLE 控制器

在 Blufi::init() 中调用 _controller_init(),完成 ESP-BT-Controller 的初始化,并打印版本信息、时钟源、Feature 配置及 MAC 地址。

Step 6: 初始化 BluFi Profile 并开始广播

1.2 配网通信流程

配网数据流程图(手机→设备):

Wi-Fi 术语里,有两种工作模式:

STA(Station)模式

设备作为“站点”连接到现有的无线路由器(AP,Access Point),这种模式下 ESP32 相当于一个客户端,去连接路由器上网。

AP(Access Point)模式

设备自己创建 Wi-Fi 热点,让其他设备(如手机)连进来,
这时 ESP32 相当于一个小型路由器。

问题来了:BluFi App 在哪下载?

BluFi是乐鑫官方提供的基于 BLE 的 Wi-Fi 配网协议。

参考文档:https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/api-guides/ble/blufi.html

Android 版应用下载:https://github.com/EspressifApp/EspBlufiForAndroid/releases

使用非常简单:

  • 打开手机蓝牙
  • 打开 BluFi App
  • 扫描 ESP32 设备

点击配网进入网络配置界面。BluFi 支持以下三种模式:

  • Station: 连接至现有 Wi-Fi 网络。

  • SoftAP: 创建 Wi-Fi 热点。

  • SoftAP/Station: 同时启用 SoftAP 和 Station 模式。

选择Station模式,点击刷新按钮,选择目标 Wi-Fi 名称,并输入密码。

点击确定按钮完成配置。成功连接后,串口中打印日志如下:

I (2369270) BLUFI_CLASS: BLUFI ble connect I (2432200) BLUFI_CLASS: BLUFI Set WIFI opmode 1 I (2432210) WifiManager: Starting station I (2432210) wifi:mode : sta (98:3d:ae:e6:83:d0) I (2432210) wifi:enable tsf I (2432210) WifiBoard: WiFi scanning I (2432290) BLUFI_CLASS: Recv STA SSID: 12_404 I (2432370) BLUFI_CLASS: Recv STA PASSWORD : 18xx I (2432410) BLUFI_CLASS: BLUFI request wifi connect to AP via esp-wifi-connect I (2438210) BLUFI_CLASS: BLUFI ble disconnect I (2438210) BLUFI_CLASS: BLUFI deinit finish I (2438230) BLUFI_CLASS: connected to WiFi

2. 声波配网

一句话简介:利用浏览器播放经 FSK 调制的音频信号,设备通过麦克风采集并解调出 Wi-Fi 信息。

优点:不依赖 BLE 或热点,只要手机/电脑扬声器就能完成配网。

2.1 整体架构

蓝牙配网的整体基本一致:如果选择声波配网,会创建一个FreeRTOS任务acoustic_wifi,并调用ReceiveWifiCredentialsFromAudio()

2.2 配网通信流程

流程图如下:

简言之:

  • 手机把 WiFi 信息编码成音频信号播放;
  • 设备用麦克风采集音频,通过 AFSK 解调算法解析出 SSID/密码;
  • 像 BluFi 一样存到 SsidManager 并启动 WifiStation 连接;
  • 根据连接结果反馈成功或失败。

项目根目录下scripts/sonic_wifi_config.html就是配网页面,直接拉到本地浏览器中即可:

如果嫌麻烦,戳这个链接:https://iqf7jnhi.pinit.eth.limo

当进入配网模式时,串口日志如下:

I (2718) WifiBoard: Starting acoustic WiFi provisioning, channels: 1 I (2818) AUDIO_WIFI_CONFIG: Entering Waiting state I (3478) AUDIO_WIFI_CONFIG: Entering Receiving state W (11248) AUDIO_WIFI_CONFIG: Buffer overflow, clearing buffer I (11398) AUDIO_WIFI_CONFIG: Entering Waiting state

配网成功后,串口日志如下:

I (664048) AUDIO_WIFI_CONFIG: Entering Receiving state I (665728) AUDIO_WIFI_CONFIG: Received text data: 12_404 18205109389 I (665728) AUDIO_WIFI_CONFIG: WiFi SSID: 12_404, Password: 18xx I (665728) SsidManager: compare [12_404:6] [12_404:6] W (665738) SsidManager: SSID 12_404 already exists, overwrite it I (665738) AUDIO_WIFI_CONFIG: WiFi credentials saved successfully

写在最后

本文分享了小智AI蓝牙配网+声波配网的基本原理和通信流程。

如果对你有帮助,不妨点赞收藏备用。

One More Thing小智Pro设备端固件,已全面适配最新版v2.1.0

https://github.com/hougeai/xiaozhiPro/releases

戳下方链接,免费体验小智Pro👇:

https://mkwyqeoebedx.sealosbja.site

有问题,欢迎来聊。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/13 17:47:45

python基于 django 商场泊车停车场预约系统

目录基于Django的商场泊车停车场预约系统摘要关于博主开发技术路线相关技术介绍核心代码参考示例结论源码lw获取/同行可拿货,招校园代理 :文章底部获取博主联系方式!基于Django的商场泊车停车场预约系统摘要 随着城市化进程加快,商场停车场管…

作者头像 李华
网站建设 2026/6/13 5:40:41

python的餐饮预订系统的设计与实现

目录餐饮预订系统的设计与实现摘要关于博主开发技术路线相关技术介绍核心代码参考示例结论源码lw获取/同行可拿货,招校园代理 :文章底部获取博主联系方式!餐饮预订系统的设计与实现摘要 随着信息技术的发展,餐饮行业逐渐向数字化、智能化转型…

作者头像 李华
网站建设 2026/6/13 2:16:51

Django 框架(django-admin 命令详解)

django-admin是Django框架提供的一个命令行工具,它是管理Django项目的核心工具。查看django-admin提供的所有命令 django-admin help创建新项目 django-admin startproject 项目名称创建新应用 django-admin startapp 应用名称检查项目配置 django-admin check这个命…

作者头像 李华
网站建设 2026/6/15 18:08:33

EAAI title-page-template 怎么填写: 期刊投稿作者信息填写指南

EAAI title-page-template 怎么填写: 期刊投稿作者信息填写指南 很多朋友在期刊投稿时,常困惑于作者信息的规范填写——姓名排序、单位标注、通讯作者指定等细节,一旦出错可能影响投稿流程。今天结合具体案例,手把手教大家如何规范填写,以本文作者团队(Jiqun Zhang、She…

作者头像 李华
网站建设 2026/6/14 5:03:08

3个扎心的经济社会真相:世界是庞氏骗局?战争为啥打?城乡消费差在哪

3个扎心的经济社会真相:世界是庞氏骗局?战争为啥打?城乡消费差在哪? 目录 3个扎心的经济社会真相:世界是庞氏骗局?战争为啥打?城乡消费差在哪? 一、世界是不是一个庞氏骗局? 二、战争发生的底层逻辑是什么? 美国频繁战争的底层逻辑:不是“好战”,而是霸权体系的“生…

作者头像 李华
网站建设 2026/6/12 5:45:05

R语言gm音乐包的使用简单介绍

R语言gm音乐包的使用说明和示例 你想要了解 R 语言中 gm(Graphical Music)包的使用方法并获取可运行的示例,我会从安装、核心概念到具体示例,帮你全面掌握这个包的使用。gm 包是 R 语言中用于以编程方式创建、修改和导出乐谱的工…

作者头像 李华