.. _headlabel-refx-data-101:

Data 101 (Upgrade Information)
==============================

The upgrade information is used for reporting upgrade status. Please check :ref:`Record F1H <refx-manage-upd-f1>` for more information.

The frame format of the Data **101** unit is as follows:

.. code-block:: none

   For example (Total 9 bytes):
   65 07 01 00 01 00 00 00 00

   For example (Total 9 bytes):
   65 07 02 00 01 00 00 00 00

   For example (Total 9 bytes):
   65 07 03 00 01 00 00 00 00

.. tabularcolumns:: |p{3.2em}|p{12.2em}|p{5.8em}|p{12em}|p{5.8em}|

.. table::
   :width: 100%
   :widths: auto

   +---------+--------------------------------------------+---------------+---------------------------------------------+--------------+
   | Parts   | Fields                                     | Length (Byte) | Range/Format                                | Default      |
   +=========+============================================+===============+=============================================+==============+
   | ID      | Data ID                                    | 1             | 65H (101)                                   | 65H (101)    |
   +---------+--------------------------------------------+---------------+---------------------------------------------+--------------+
   | Length  | Data Length                                | 1             | 00H or 07H                                  |              |
   +---------+--------------------------------------------+---------------+---------------------------------------------+--------------+
   | Content | `Code`                                     | 1             | 01H-08H                                     |              |
   +         +--------------------------------------------+---------------+---------------------------------------------+--------------+
   |         | `Sub Code`                                 | 1             | 00H-FFH                                     |              |
   +         +--------------------------------------------+---------------+---------------------------------------------+--------------+
   |         | `Update Type`                              | 1             |                                             |              |
   +         +--------------------------------------------+---------------+---------------------------------------------+--------------+
   |         | Reserved                                   | 2             | 0000H-FFFFH                                 | 0000H        |
   +         +--------------------------------------------+---------------+---------------------------------------------+--------------+
   |         | `Sequence Number`                          | 2             | 0000H-FFFFH                                 |              |
   +---------+--------------------------------------------+---------------+---------------------------------------------+--------------+

- `Code`

  Indicates the status of updating.

  - **01H** - Start to download. The terminal successfully connected to the file server and started to download the file.

  - **02H** - Start to update. The terminal has successfully downloaded the file from the file server and started to perform the update.

  - **03H** - Success to update.

  - **04H** - Refused. The terminal refuses to execute the update command.

  - **05H** - Canceled. The update command was cancelled by the user.

  - **06H** - Failed to connect. The terminal cannot connect to the file server.

  - **07H** - Failed to download. The terminal cannot download the file from the file server.

  - **08H** - Fail to update.

- `Sub Code`

  Supplementary notes on the status of updating.

  - **00H** - Normal.

  - **10H** - Low battery.

  - **14H** - Failed to communicate with the module.

  - **20H** - No network connection.

  - **21H** - Can't connect to the specific URL.

  - **30H** - File not found. There is no such file on the server.

  - **31H** - File CRC error. The CRC check of the downloaded file failed.

  - **32H** - File type error. The file type does not match.

  - **33H** - File size error. The file size does not match.

  - **34H** - Incompatible version. Update to this version is not allowed.

  - **F0H** - Operation is in progress.

  - **FFH** - Unknown.

- `Update Type`

  Indicates the type of firmware being updated, corresponding to the 'Update Type' in the :ref:`AT@UPD <refx-manage-upd-cmd>` command.

- `Sequence Number`

  Indicates which upgrade command triggered this upgrade. Corresponding to the sequence number in the :ref:`AT@UPD <refx-manage-upd-cmd>` command.