ESP32学习笔记（7）——SmartConfig接口使用(ESP-Touch和AirKiss)
一、概述
SmartConfig是TI开发的一种配置技术，用于将新的Wi-Fi设备连接到Wi-Fi网络。它使用移动应用程序将网络凭据从智能手机或平板电脑广播到未配置的Wi-Fi设备。
该技术的优点是设备不需要直接知道接入点（AP）的SSID或密码。此信息是使用智能手机提供的。
ESP-IDF 编程指南——SmartConfig
二、API说明
以下 SmartConfig 接口位于 esp_wifi/include/esp_smartconfig.h。
2.1 esp_smartconfig_set_type
2.2 esp_smartconfig_start
2.3 esp_smartconfig_stop
三、大致流程
四、ESP-Touch
4.1 例程
/* Esptouch example
This example code is in the Public Domain (or CC0 licensed, at your option.)
Unless required by applicable law or agreed to in writing, this
software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied.
*/
#include 4.2 解析
首先初始化 WIFI，查看 ESP32学习笔记（5）——WiFi接口使用
创建事件组 s_wifi_event_group = xEventGroupCreate();，触发相关事件则置标志位，在任务中循环检测标志位处理相应事件。
如在 smartconfig_example_task 任务中，获取 CONNECTED_BIT 和 ESPTOUCH_DONE_BIT 表示连接上 AP 和 SmartConfig 配置完成。
static void smartconfig_example_task(void * parm)
{
EventBits_t uxBits;
ESP_ERROR_CHECK( esp_smartconfig_set_type(SC_TYPE_ESPTOUCH) );
smartconfig_start_config_t cfg = SMARTCONFIG_START_CONFIG_DEFAULT();
ESP_ERROR_CHECK( esp_smartconfig_start(&cfg) );
while (1) {
uxBits = xEventGroupWaitBits(s_wifi_event_group, CONNECTED_BIT | ESPTOUCH_DONE_BIT, true, false, portMAX_DELAY);
if(uxBits & CONNECTED_BIT) {
ESP_LOGI(TAG, "WiFi Connected to ap");
}
if(uxBits & ESPTOUCH_DONE_BIT) {
ESP_LOGI(TAG, "smartconfig over");
esp_smartconfig_stop();
vTaskDelete(NULL);
}
}
}
在 event_handler 中，获取到 WIFI_EVENT_STA_START 事件则开始 SmartConfig 任务 xTaskCreate(smartconfig_example_task, "smartconfig_example_task", 4096, NULL, 3, NULL);。
4.3 安装ESP-Touch APP
https://www.espressif.com/zh-hans/support/download/apps
手机连接上 WIFI 后，输入密码，开始配置
4.4 查看打印
配置类型为：ESPTOUCH
五、AirKiss
5.1 例程
其实就是上面4.1的内容，通过调用函数 esp_smartconfig_set_type 将类型设为 SC_TYPE_AIRKISS 或 SC_TYPE_ESPTOUCH_AIRKISS
/* Esptouch example
This example code is in the Public Domain (or CC0 licensed, at your option.)
Unless required by applicable law or agreed to in writing, this
software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied.
*/
#include 5.2 一键配网
5.2.1 乐鑫官方公众号传递
关注乐鑫公众号，点击 商铺，选择 AirKiss设备，输入 WIFI 密码，点击连接
5.2.2 扫描一键传递
5.3 查看打印
配置类型为：AIRKISS
• 由 Leung 写于 2021 年 4 月 23 日
• 参考：乐鑫Esp32学习之旅⑥ smartConfig和微信airKiss在esp32的实现，一键配网轻松快捷连接路由器
第十五章 ESP32的SmartConfig一键配置