Netconfig AT example
====================================

This document mainly describes the operation on the device :doc:`../command-set/Wi-Fi_AT_Commands` Detailed examples of commands.

.. Important::
  - This network distribution example will have different adaptations for different modules. For specific differences, please check the support of the module instructions in your hand: :doc:`../instruction/other/firmware_differences`。

.. contents::
   :local:
   :depth: 1

Easy WiFi Config Bluetooth distribution network
-----------------------------------------------------
1. APP download /
   
   On the IOS phone,You can get it by searching for Easy WiFi Config in the App Store
   
   Android phone apk installation package download:`Mobile phone apk installation package <https://docs.ai-thinker.com/_media/rtl8710/docs/wificonfig_v2.1.6_20190529.apk.zip>`_

   .. figure:: ../../_static/Easy.png
      :alt: OTA_APP

2. Set the Wi-Fi working mode of the module and save it to Flash

  command：

   .. code-block:: none

      AT+WMODE=1,1

   Response：

   .. code-block:: none

      OK

3. Turn on the bluetooth distribution network

     command：

   .. code-block:: none

      AT+WCONFIG=2

   Response：

   .. code-block:: none

      OK  

4. APP operation
   
   .. figure:: ../../_static/BW16config.gif
      :scale: 50 %
      :alt: OTA_APP

SmartConfig One-click network configuration
-----------------------------------------------------
1. APP download：
   
   For IOS phones, search for Esptouch in the App Store
   
Android phone apk installation package download:`Mobile phone apk installation package <https://docs.ai-thinker.com/_media/rtl8710/docs/wificonfig_v2.1.6_20190529.apk.zip>`_

2. Set the Wi-Fi working mode of the module and save it to Flash

   Command：

   .. code-block:: none

      AT+WMODE=1,1

   Response：

   .. code-block:: none

      OK

3. Start SmartConfig once

   Command：

   .. code-block:: none

      AT+WCONFIG=1

   Response：

   .. code-block:: none

      OK  

4. APP operation
   
   .. figure:: ../../_static/BL602Smartconfig.gif
      :scale: 50 %
      :alt: OTA_APP

5. After the network configuration is complete, disable the network configuration mode. Otherwise, a large amount of memory is occupied

  Command：
   .. code-block:: none

      AT+WCONFIG=0

  Response：

   .. code-block:: none

      OK

Wechat Airkiss one button network
-----------------------------------------------------
Airkiss network can be configured using the wechat official account or wechat mini program, without the need to download the App

1. Set the Wi-Fi working mode of the module and save it to Flash

   Command：

   .. code-block:: none

      AT+WMODE=1,1

   Response：

   .. code-block:: none

      OK

2. Open Airkiss distribution network once

   Command：

   .. code-block:: none

      AT+WCONFIG=3

    Response：

   .. code-block:: none

      OK  

3. Wechat public account distribution network: 
pay attention to Anxinke Technology wechat public account, Airkiss distribution network interface is located in Application Development > wechat distribution network

   .. figure:: ../../_static/Airkiss.gif
     :scale: 50 %
     :alt: OTA_APP

4. Wechat mini program distribution network: search Anxinke IOT mini program:
   
   .. figure:: ../../_static/Airkiss_xiaochengxu.gif
     :scale: 50 %
     :alt: OTA_APP

5. After the network configuration is complete, disable the network configuration mode. Otherwise, a large amount of memory is occupied

  Command：

   .. code-block:: none

      AT+WCONFIG=0

   Response：

   .. code-block:: none

      OK
   
Blufi Bluetooth network
-----------------------------------------------------
blufi can be connected with an app or a small program

1. APP download ：
   
   For IOS phones, you can search EspBlufi in the App Store
   
Android phone apk installation package download:`Mobile phone apk installation package <https://github.com/EspressifApp/EspBlufiForAndroid/releases/download/v1.5.3/EspBluFi-1.5.3-24.apk>`_

  Mini program: WeChat search Ai-Thinker IOT small program

2. Set the Wi-Fi working mode of the module and save it to Flash

   Command：

   .. code-block:: none

      AT+WMODE=1,1
   
   Response：

   .. code-block:: none

      OK

3. Open a blufi distribution network

    Command：

   .. code-block:: none

      AT+WCONFIG=2

  Response：

   .. code-block:: none

      OK  

4. app network distribution mode:
      
   .. figure:: ../../_static/app_blufi.gif
     :scale: 60 %
     :alt: OTA_APP

5. Mini program distribution network mode:
      
   .. figure:: ../../_static/xiaochengxu_blufi.gif
     :scale: 60 %
     :alt: OTA_APP

6. After the network configuration is complete, disable the network configuration mode. Otherwise, a large amount of memory is occupied

    Command：

   .. code-block:: none

      AT+WCONFIG=0

   Response：

   .. code-block:: none

      OK
 
Command distribution network
-----------------------------------------------------
Target router ssid: AIOT@FAE, password: fae12345678

1. Set the Wi-Fi working mode of the module and save it to Flash

   Command：

   .. code-block:: none

      AT+WMODE=1,1

   Response：

   .. code-block:: none

      OK

2. Connect to the target router

   Command：

   .. code-block:: none

      AT+WJAP="AIOT@FAE","fae12345678"

  Response：

   .. code-block:: none

      OK  

3. Set automatic reconnection to WiFi after power-on

   Command：

   .. code-block:: none

      AT+WAUTOCONN=1

   Response：

   .. code-block:: none

      OK  

If multiple SSIDs and passwords are the same in the same environment, how do I connect to the router with the strongest signal
------------------------------------------------------------------
Target router ssid: AIOT@FAE Password: fae12345678

Scan the target ssid by the command AT+WSCAN=< ssid >

   .. figure:: ../../_static/SCAN.png
     :scale: 100 %
     :alt: OTA_APP

By scanning, we can know that the strongest signal intensity is -16dBm and bssid is 9c:9d:7e:59:3e:84. AT+WJAP can connect to the router with the 
strongest signal with the bssid parameter

1. Set the Wi-Fi working mode of the module and save it to Flash

   Command：

   .. code-block:: none

      AT+WMODE=1,1

   Response：

   .. code-block:: none

      OK

2. Connect to the target router

   Command：

   .. code-block:: none

      AT+WJAP="AIOT@FAE","fae12345678","9c:9d:7e:59:3e:84"

 Response：

   .. code-block:: none

      OK  

3. Set automatic reconnection to WiFi after power-on

   Command：

   .. code-block:: none

      AT+WAUTOCONN=1

   Response：

   .. code-block:: none

      OK