新闻  |   论坛  |   博客  |   在线研讨会
​BLE配网双模式实战手册:STA+SoftAP技术详解+代码示例
13673998452 | 2025-09-26 12:46:09    阅读:96   发布文章

 本手册专为嵌入式开发者打造,系统梳理BLE配网中STA与SoftAP双模式的技术要点,结合常见开发平台(如ESP32、nRF)给出标准化代码实现,步骤清晰、逻辑严谨,助你快速构建高鲁棒性配网功能。

本文特别分享蓝牙配网方案:
 

以Air8000核心板为例,实现“STA+SoftAP双模式BLE配网” 功能——手机通过BLE下发Wi-Fi账号/密码或热点参数,Air8000自动完成Station连接或SoftAP创建,并验证网络可用性。

 

一、蓝牙配网基础知识

简而言之,蓝牙配网是让Air8000工作在蓝牙配网模式下,手机APP通过蓝牙连接Air8000,通过APP界面实现配网功能。


1.1 蓝牙配网是什么

蓝牙配网——是一种利用蓝牙低功耗(BLE)链路,在未联网设备与手机之间建立本地安全通道,把Wi-Fi的SSID、密码及其他网络参数传递给设备,使其独立完成STA或SoftAP联网的技术方案。


1.2 蓝牙配网原理

设备在上电后进入配网模式,作为BLE Peripheral持续广播自定义的配网服务UUID;

手机APP作为Central扫描并建立GATT连接,随后通过加密特征值把网络参数下发给设备。

设备收到参数后,启用Wi-Fi并执行联网流程。


1.3 蓝牙配网流程

设备在上电后进入配网模式,作为BLE Peripheral持续广播自定义的配网服务UUID;

1)广播:

设备以固定间隔广播配网服务,等待手机连接。

2)连接:

手机APP扫描→选择目标设备→建立BLE连接。

3)选择配网方式:

在手机APP界面选择所需模式,两种模式主要区别如下:

Station模式:

设备直接作为Station连接路由器,应用中也常缩写为STA模式。

SoftAP模式:

设备通过4G开AP热点,用于其他设备连接。


 

二、蓝牙配网示例demo

Air8000应用示例持续更新中,此处仅展示部分代码要点,完整demo详见源码仓库最新文件。

最新源码/APP下载:https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/config_wifi_network/ble_config_wifi

实操教程详见:https://docs.openluat.com/air8000/luatos/app/wifi/ble/


2.1 初始化蓝牙等相关功能

使用蓝牙配网,首先需要初始化蓝牙设备并启动espblufi配网功能。


2.2 定义espblufi回调函数

定义espblufi回调函数,用于处理不同类型的事件。

例如:

EVENT_STA_INFO、EVENT_SOFTAP_INFO等。


2.3 定义网络测试功能函数

用于接收: "STA_CONNED"、"STA_DISCONNED"、"AP_CONNED"等消息来进行对应的逻辑处理。


 
三、蓝牙配网实操要点

以下是Station模式和SoftAP模式的配网功能演示,新朋友可查看资料中心详细教程:

https://docs.openluat.com/air8000/luatos/app/wifi/ble/

 

 - Station模式配网 -  

1)首先使用LuaTools将固件和脚本烧录到核心板,开机运行查看日志:


2)此时打开手机APP端,可以看到已经扫描到我们的设备了(如果没有扫描到就重启一下设备,并下拉刷新APP)。



3)点击我们的设备,进入配网界面,点击连接,就可以进行配网的操作了:



4)点击配网,进行Station配网模式,选择需要连接的Wi-Fi,输入对应的密码,即可开始连接。



5)此时查看日志,即可看到STA已经连接成功,并且进行HTTP请求成功。




 - SoftAP模式配网 -  

 

1)首先参照上方Station模式的方式,烧录、开机、打开APP连接、进入配网界面:



2)此时,点击配网,选择SoftAP模式,配置AP热点:



3)在这里可以选择加密方式、信道号、最大连接数,根据自己的需求选填:



4)点击确定后,开始建立AP热点:



5)此时使用设备进行连接,连接成功即可正常使用。



今天的内容就分享到这里了~


*博客内容为网友个人发布,仅代表博主个人观点,如有侵权请联系工作人员删除。

参与讨论
登录后参与讨论
推荐文章
最近访客