# wifi配网
wifi配网说明

## demo实例
本DEMO支持blufi和smartconfig配网

```SHELL
cd examples/demo_wifi
idf.py build
idf.py flash #使用工具烧录或者idf.py flash烧录，DEMO可在ZX3D50CE02S-USRC-4832上运行，其他机型请修改sdkconfig，增加CONFIG_BT_BLE_BLUFI_ENABLE=y
```

### BLuFI配网
1.从下面的链接上下载手机app
<https://github.com/EspressifApp/EspBlufiForAndroid/releases/tag/v1.6.3>

(1)点击进去后,显示此画面

<img src="..\..\_static\wifi\1.png" style="zoom:50%;"/> <br>

(2)点击此选项,即可开始下载

<img src="..\..\_static\wifi\2.png" style="zoom:50%;"/> <br>

(3)下载完成后,app为此图像

<img src="..\..\_static\wifi\3.png" style="zoom:50%;"/> <br>

2.UI上点击BLuFi
(1)烧写成功后,会出现如图情况,点击BLuFi
<img src="..\..\_static\wifi\4.png" style="zoom:50%;"/> <br>

(2)打开EspBLuFi,并对BLuFi按钮进行长按,则会出现如图所示画面
<img src="..\..\_static\wifi\5.png" style="zoom:50%;"/> <br>

3.在app上填写SSID和密码
(1)看到有信号出现后,点击BLUFI_DEVICE,进入画面后会出现如下情况
<img src="..\..\_static\wifi\6.png" style="zoom:50%;"/> <br>

(2)点击下方的连接按钮,进入会发生如下情况
<img src="..\..\_static\wifi\7.png" style="zoom:50%;"/> <br>

(3)继续点击配网,进入WIFI配置界面,其中的SSID是你要连接的WIFI名称,输入完成后,点击确定
<img src="..\..\_static\wifi\8.png" style="zoom:50%;"/> <br>

4.UI看到获取到的IP
上面所有的步骤完成后,观看配网完成后的显示屏,会显示IP地址
<img src="..\..\_static\wifi\9.png" style="zoom:50%;"/> <br>


### 2、SMARTCONFIG

1.从下面的链接上下载手机app
<https://github.com/EspressifApp/EsptouchForAndroid/releases/tag/v2.0.0/esptouch-v2.0.0.apk>

(1)点击进去后,显示此画面

<img src="..\..\_static\wifi\10.png" style="zoom:50%;"/> <br>

(2)点击此选项,即可开始下载

<img src="..\..\_static\wifi\11.png" style="zoom:50%;"/> <br>

(3)下载完成后,app为此图像

<img src="..\..\_static\wifi\12.png" style="zoom:50%;"/> <br>

2.UI上点击SMARTCONFIG
(1)烧写成功后,会出现如图情况,点击SMARTCONFIG

<img src="..\..\_static\wifi\13.png" style="zoom:50%;"/> <br>

(2)打开EspTouch则会出现如图所示画面

<img src="..\..\_static\wifi\14.png" style="zoom:50%;"/> <br>

3.在app上进行密码输入,进行配网
(1)点击EspTouch V2,开始配置自己的WIFI,配置成功后,输入WIFI密码

<img src="..\..\_static\wifi\15.png" style="zoom:50%;"/> <br>

(2)配置好WIFI后,长按SMARTCONFIG,则会显示出如下画面,会进行网络的连接

<img src="..\..\_static\wifi\16.png" style="zoom:50%;"/> <br>

4.在UI看到所获取的IP
上面所有的步骤完成后,观看配网完成后的显示屏,会显示IP地址
<img src="..\..\_static\wifi\9.png" style="zoom:50%;"/> <br>

## API说明

1. 初始化wifi 
esp_err_t qmsd_wifi_init(bool auto_connect);

2. 手动设置SSID和密码
esp_err_t qmsd_wifi_sta_config(const char *ssid, const char *password, const char *bssid);

3. 打开blufi 
void qmsd_blufi_start(void);

4. 关闭blufi
void qmsd_blufi_stop(void);

5. 开始smartconfig
void qmsd_wifi_sc_start(smartconfig_type_t type);

6. 关闭smartconfig
void qmsd_wifi_sc_stop(void);