OTA AT example
====================================

This document mainly introduces running on the device :doc:`../command-set/AT_Basic_Commands` detailed example of the command

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

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

   command：

   .. code-block:: none

      AT+WMODE=1,1

   respond：

   .. code-block:: none

      OK

2. Set the module to be connected to the Internet, and the parameters are filled with the Wi-Fi name and Wi-Fi password of the external network

   command：

   .. code-block:: none

      AT+WJAP="Wi-Fi name","Wi-Fi password"

   respond：

   .. code-block:: none

      +EVENT:WIFI_CONNECT

      OK  

3. set the firmware upgrade method and firmware address

   command：

   .. code-block:: none

      AT+OTA=2,chencongcc.oss-cn-beijing.aliyuncs.com,443,/bl_OTA-ComboV2.0.0.bin.xz

   respond：

   .. code-block:: none

      OK


4. start to upgrade

   command：

   .. code-block:: none

      AT+OTA

   respond：

   .. code-block:: none

      OK

**demo**

.. figure:: ../../_static/ota.png
    :scale: 100 %
    :alt: OTA


OTA upgrade of Bluetooth TB series modules
-----------------------------------------------------
1. APP download：
   
   For mobile phones with IOS system, you can search for TelinkBleOTA in the App Store to obtain

   Android system mobile phone apk installation package download: `Mobile phone apk installation package <https://docs.ai-thinker.com/_media/tbota_app.zip>`_

   OTA upgrade file download: `OTA upgrade file <https://docs.ai-thinker.com/_media/1939_8258_com_at-v205_1_.zip>`_

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

2. Open the TelinkBleOTA software, set in Filter, limit the rssi value within 60dBm, and then click the refresh button on the main interface to find the corresponding BLE Bluetooth
   
  .. figure:: ../../_static/setFilter.png
    :scale: 80 %
    :alt: OTA_APP

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

3. After finding the corresponding Bluetooth, click the CONNECT button to connect, and +BLE_CONNECTED is printed on the module, indicating that the APP and the module are successfully connected

  .. figure:: ../../_static/connect.png
    :scale: 80 %
    :alt: OTA_APP
 
4. Click the OTA Settings option to open the Bin file path area to view the OTA file. For the import tutorial of the OTA file, you can click the exclamation mark in the Choose Bin File interface to view it.

   .. figure:: ../../_static/OTA_setting2.png
    :scale: 80 %
    :alt: OTA_APP
 
5. After setting the OTA file, click the START button below to upgrade. After the progress bar reaches 100%, the module will return to OTA_SUCCESS, then automatically reset and restart, and print a new version, indicating that the OTA upgrade is successful.
   
   .. figure:: ../../_static/OTAsetting.gif
    :scale: 80 %
    :alt: OTA_APP

OTA upgrade of Bluetooth PB series modules
-----------------------------------------------------
1. APP download：
   
  For mobile phones with IOS system, you can search for PHYOTA in the App Store to obtain

   Android system mobile phone apk installation package download: `Mobile phone apk installation package <https://docs.ai-thinker.com/_media/ota_.zip>`_

  OTA upgrade file download: `OTA upgrade file <https://docs.ai-thinker.com/_media/ota_.zip>`_

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

2. In order to facilitate the test, you need to send AT+BLENAME=123456 and AT+RST commands to set the broadcast name of the module to 123456, and open the PHYOTA software to search
   
  .. figure:: ../../_static/PHY_set.png
    :scale: 80 %
    :alt: OTA_APP

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

3. Search for the Bluetooth device named 123456, click the stop button in the upper right corner, select the Bluetooth device named 123456 and click OK to enter the OTA upgrade interface

  .. figure:: ../../_static/PHY_connect.png
    :scale: 80 %
    :alt: OTA_APP
 
4. Click to select the file, if the file column is empty, you can put the OTA file on WeChat or QQ, click the hex file to select other applications, find the PHYOTA software, open it and you can successfully get the HEX file, select the corresponding HEX file and click Start upgrade

   .. figure:: ../../_static/PHY_OTA_SETT.gif
    :scale: 80 %
    :alt: OTA_APP