在前面网络篇TCP通信中，我们用到了Wi-Fi功能，但是没有细讲，今天我们在这篇文章中仔细探讨一下ESP8266的Wi-Fi联网过程，以及各种方式的配网过程是如何实现的。文章中难免有疏漏或不正确的地方，如遇不正确的表述还请指出，本系列文章现在在知乎和博客园同步更新。
IAMLIUBO-知乎专栏
IAMLIUBO-博客园
开始写之前，我们先来看一下为什么设备需要配网呢？
我们来先看个图片：
![[网络篇]ESP8266-SDK教程(五)之SmartConfig、Airkiss等多种配网方式_第1张图片](http://img.e-com-net.com/image/info10/f9da024d5d1846689c1bb4d0bbf4c0b1.jpg)
假如你买了一个智能插座，想让它连接到家里的Wi-Fi，但是智能插座又没有键盘和触摸屏此时你该怎么操作呢？总不能拆开然后重新给它写个程序吧！此时就需要我们的智能配网模式出马了， SmartConfig最先是TI开始研究的，其实类似的协议有很多，各家也都有各家的称呼，乐鑫这里也还是叫SmartConfig，但是配网模式也不仅仅局限于SmartConfig，还是有很多方式可以做到的，比如看下边~
下面分析一下几种配网方式和优缺点：
- 直接配网 -> SSID(Wi-Fi名称)和PWD(Wi-Fi密码)保存在设备中(每次修改都要重新烧录代码)
- ap配网 -> 设备处于路由模式下等待客户端发送来SSID和PWD(可以随时修改，不易于操作)
- web配置 -> 设备内做了个小web服务器通过网页交换SSID和PWD(界面化操作，流程繁琐)
- SmartConfig -> 手机通过软件发送UDP广播包(包含SSID和PWD，界面化操作，操作简单)
- Airkiss -> 类似与SmartConfig，可以使用微信公众号直接配置(界面化操作，不需要装APP)
- 零配 -> 以配网设备为未配网设备配网，两个设备间数据交互(AliOS-Things中有涉及)
- 蓝牙配网 -> 利用蓝牙设备配网，蓝牙模块跟ESP8266串口数据交互(未使用过，不做评价)
目前应该就这几种吧，据我了解应该就这几种了，每种方式都有一定的优缺点，本篇文章先给大家讲解一下前五种方式，零配方式目前我还没有尝试过，后面实际开发过，再给大家讲解如何使用，至于蓝牙配网手头没有蓝牙模块，这里也不给大家讲了，不过思路是很简单的，大家如果有蓝牙模块，或者有BLE开发经验，相信自己摸索一下就可以做出来了。
- 直接配网
这里叫直接配网应该不是很妥当，其实就是将SSID和PWD直接写在了固件中，设备上电后会去搜索保存的SSID，如果搜索到指定的SSID后就用保存的PWD去连接Wi-Fi，TCP通信那片文章中我们就是用的这种方式，我们先来回顾一下，在user_config.c文件中有如下定义：
![[网络篇]ESP8266-SDK教程(五)之SmartConfig、Airkiss等多种配网方式_第2张图片](http://img.e-com-net.com/image/info10/025de4dc3ca44a5bb814ff95f327e258.jpg)
这就是我们保存的Wi-Fi名称和密码，然后我们在user_init函数中直接调用的是Wi-Fi连接函数：
![[网络篇]ESP8266-SDK教程(五)之SmartConfig、Airkiss等多种配网方式_第3张图片](http://img.e-com-net.com/image/info10/5392c8f87a76487ebdf12a7707f438f7.jpg)
可以看出，我们是直接使用保存的信息去进行Wi-Fi操作的，这种方式比较简单，这里就不再做具体的讲解了。
- ap配网
AP(Access Point)模式，就是我们常说的路由模式，这里的思路是ESP8266上电进入AP模式开启TCP Server，然后手机或者PC连接ESP8266的热点，然后作为TCP Client去连接Server进行数据交互，TCP数据交互我们在前面的文章中给大家讲过，这里我们主要讲一下ESP8266怎么开启AP模式，还有为什么我们让ESP8266作为TCP Server呢？其实主要是ESP8266做Server去监听固定端口更方便Client去连接，加入我们手机或者PC做Server，万一遇到端口不可用，那岂不是没办法去交互数据了？所以我们让ESP8266做Server很显然是更妥当一点。
还有比较重要的一点就是数据格式，数据格式就像我们交流的语言一样，是两者都能够"听懂"，"读懂"的，我们这里使用一种非常常见的数据格式 -> JSON，相信很多人都有听说过，或者使用过，我们选择JSON，是因为它的格式固定，并且易于解析，这里我们使用cJSON库去解析，官方SDK中虽然也有JSON API，但是由于我一直都是使用cJSON，对cJSON库还是比较喜欢的，而且是用标准C写的，跨平台so easy，项目地址戳卡片：
cJSON项目地址
使用cJSON非常简单，只需要添加一个头文件和源文件就好了，但是在ESP8266上使用还是要修改很多东西的，这里就先不细讲了，大家可以先下载我的工程，直接使用，后面我们再单独讲一下JSON。
我们先规定一下数据格式吧，还不了解JSON的话可以先去了解一下，很简单的其实，就是Key-Value型的键值对，就是一个名字对应一个值，这里我们就简单定一个格式吧！
![[网络篇]ESP8266-SDK教程(五)之SmartConfig、Airkiss等多种配网方式_第4张图片](http://img.e-com-net.com/image/info10/4fc425dc71974858a936b76d6b3b70d7.jpg)
其中XXXXXXXX和XXXXXXXX都是需要替换成你的实际Wi-Fi名称和密码，剩下两项没有实际意义，只是防止有人不署名转载，然后帮助读者回到正确的车上~啊哈哈哈！
我们来分析一下代码吧，跟之前的TCP通信差不多，这是这里对收到的数据做了进一步处理，我们只看关键代码好了：
/**
* TCP Server数据接收回调函数，可以在这处理收到Client发来的数据
*/
static void ICACHE_FLASH_ATTR
tcp_server_recv_cb(void *arg,char *pdata,unsigned short len){
os_printf("tcp server receive tcp client data\r\n");
os_printf("length: %d \r\ndata: %s\r\n",len,pdata);
//TO DO
/**
*process the receive data
*/
AP_recv_data_process(pdata);//在TCP Server接收回调函数中，新增了数据处理函数
}
然后我们再看看AP_recv_data_process函数是如何处理的：
/**
* AP配网模式处理TCP client发送来的数据
*/
void ICACHE_FLASH_ATTR
AP_recv_data_process(uint8 *pdata){
cJSON *root = cJSON_Parse(pdata);//将一个JSON数据包，按照cJSON结构体的结构序列化整个数据包，并在堆中开辟一块内存存储cJSON结构体
//成功返回一个指向内存块中的cJSON指针，失败返回NULL，表示JSON格式不正确
if(root != NULL){
uint8 *SSID = cJSON_GetObjectItem(root,"SSID")->valuestring;//解析SSID key对应的Value值，也就是我们发送的Wi-Fi名称
uint8 *PWD = cJSON_GetObjectItem(root,"PWD")->valuestring;//解析PWD key对应的Value值，也就是我们发送的Wi-Fi密码
uint8 *Author = cJSON_GetObjectItem(root,"Author")->valuestring;//
uint8 *zhuanlan = cJSON_GetObjectItem(root,"zhuanlan")->valuestring;//
os_printf("\r\nAuthor: %s\r\nzhuluan: %s",Author,zhuanlan);
os_printf("SSID: %s PWD: %s\r\n",SSID,PWD);//打印我们收到的密码
wifi_set_opmode(STATION_MODE);//设置WiFi模式为STATION模式
WIFI_Connect(SSID, PWD, wifiConnectCb);//连接目标WiFi
}else{
os_printf("json data format error!\r\n");//收到的数据不正确就打印
}
cJSON_Delete(root);//解析完JSON后一定要记得释放！
}
在此函数中，我们只需对收到的数据简单一处理，就得到了我们需要的Wi-Fi名称和密码，然后我们就可以快快乐乐的去连接Wi-Fi了，这里AP配网模式是按键触发的，我们在WIFI_Connect函数中调用了wifi_station_set_config函数，下次上电是会直接连接这次我们配置的Wi-Fi的
- SmartConfig配网
下面我们再来分析一下SmartConfig配网模式，其实SmartConfig模式与Airkiss模式基本是一致的，主要不同就是发数据包方式还是有点不同的：
SmartConfig 组播,通过长度编码
Airkiss 全网广播,通过长度编码
别的区别的话就是代码有些不同了，下面我们来实际分析一下：
/**
* SmartConfig 测试代码
*/
void ICACHE_FLASH_ATTR
SmartConfig_test(void){
smartconfig_set_type(SC_TYPE_ESPTOUCH);//设置快连模式类型，必须在smartconfig_start之前调用
wifi_set_opmode(STATION_MODE);
smartconfig_start(smartconfig_done);
}
/**
* Airkiss 测试代码
*/
void ICACHE_FLASH_ATTR
Airkiss_test(void){
smartconfig_set_type(SC_TYPE_AIRKISS);//设置快连模式类型，必须在smartconfig_start之前调用
wifi_set_opmode(STATION_MODE);
smartconfig_start(smartconfig_done);
}
/**
* SmartConfig Airkiss 测试代码
*/
void ICACHE_FLASH_ATTR
SmartConfig_Airkiss_test(void){
smartconfig_set_type(SC_TYPE_ESPTOUCH_AIRKISS);//设置快连模式类型，必须在smartconfig_start之前调用
wifi_set_opmode(STATION_MODE);
smartconfig_start(smartconfig_done);
}
/*===================================
* Smartconfig Airkiss FUNCTIONS *
====================================*/
/**
*
*/
const airkiss_config_t akconf =
{
(airkiss_memset_fn)&memset,
(airkiss_memcpy_fn)&memcpy,
(airkiss_memcmp_fn)&memcmp,
0,
};
/**
*
*/
LOCAL void ICACHE_FLASH_ATTR
airkiss_wifilan_time_callback(void)
{
uint16 i;
airkiss_lan_ret_t ret;
if ((udp_sent_cnt++) >30) {
udp_sent_cnt = 0;
os_timer_disarm(&ssdp_time_serv);//airkiss_wifilan_time_callback运行三十次后停止运行
//return;
}
//设置本地udp发送端口号，IP地址设置成255.255.255.255是进行广播，UDP有单播，多播和广播三种模式
ssdp_udp.remote_port = DEFAULT_LAN_PORT;
ssdp_udp.remote_ip[0] = 255;
ssdp_udp.remote_ip[1] = 255;
ssdp_udp.remote_ip[2] = 255;
ssdp_udp.remote_ip[3] = 255;
lan_buf_len = sizeof(lan_buf);
ret = airkiss_lan_pack(AIRKISS_LAN_SSDP_NOTIFY_CMD,
DEVICE_TYPE, DEVICE_ID, 0, 0, lan_buf, &lan_buf_len, &akconf);
if (ret != AIRKISS_LAN_PAKE_READY) {
os_printf("Pack lan packet error!");
return;
}
ret = espconn_sendto(&pssdpudpconn, lan_buf, lan_buf_len);
if (ret != 0) {
os_printf("UDP send error!");
}
os_printf("Finish send notify!\n");//UDP发送完成
}
/**
*
*/
LOCAL void ICACHE_FLASH_ATTR
airkiss_wifilan_recv_callbk(void *arg, char *pdata, unsigned short len)
{
uint16 i;
remot_info* pcon_info = NULL;
airkiss_lan_ret_t ret = airkiss_lan_recv(pdata, len, &akconf);
airkiss_lan_ret_t packret;
switch (ret){
case AIRKISS_LAN_SSDP_REQ:
espconn_get_connection_info(&pssdpudpconn, &pcon_info, 0);
os_printf("remote ip: %d.%d.%d.%d \r\n",pcon_info->remote_ip[0],pcon_info->remote_ip[1],
pcon_info->remote_ip[2],pcon_info->remote_ip[3]);
os_printf("remote port: %d \r\n",pcon_info->remote_port);
pssdpudpconn.proto.udp->remote_port = pcon_info->remote_port;
os_memcpy(pssdpudpconn.proto.udp->remote_ip,pcon_info->remote_ip,4);
ssdp_udp.remote_port = DEFAULT_LAN_PORT;
lan_buf_len = sizeof(lan_buf);
packret = airkiss_lan_pack(AIRKISS_LAN_SSDP_RESP_CMD,
DEVICE_TYPE, DEVICE_ID, 0, 0, lan_buf, &lan_buf_len, &akconf);
if (packret != AIRKISS_LAN_PAKE_READY) {
os_printf("Pack lan packet error!");
return;
}
os_printf("\r\n\r\n");
for (i=0; i这里的代码稍微有点多，不过其实是三种模式，SmartConfig模式、Airkiss模式、SmartConfigAirkiss混合模式，这是乐鑫官方给出的例子，某些步骤我按我的理解给注释了一下，大家可以仔细阅读以下看看，其中需要注意的是在调用smartconfig_start函数之前必须先调用smartconfig_set_type函数声明配网模式类型。
Airkiss配网
与SmartConfig类似，代码在上边，大家可以看一下。Web页面配置
Web页面配置也相对不是很难，主要是对表单的处理，但是要把网页写在ESP8266的flash中，最近没什么时间，等改天有时间了再给大家分析一下，不过ESP8266内置网页的Demo在我的Github仓库中有一个，大家感兴趣的可以先去看一下，然后看一下自己是否能实现。
最后上一段小视频，手机录制的，不是很好，大家将就着看，还有些小瑕疵，这里就不剪了。也怪麻烦的，主要看一下流程，可能讲的也不是很详细，有什么建议可以私信我哦~
视频有点大，处理后再上传~(后期可以在B站观看)
附上我的仓库地址：
makingfunxyz-esp8266
欢迎大家Star,您的鼓励是我最大的动力，有问题可以私信我，或者提交issues~
本系列文章在知乎，博客园同步更新，知乎搜索专栏：IAMLIUBO的神奇物联网之旅
视频可以去知乎上的文章查看~
QQ交流群：592587184