.. _headlabel-refx-data-97:

Data 97 (Internal Battery Status)
=================================

The current status of the internal battery.

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

.. code-block:: none

   For example (Total 7 bytes):
   61 05 01 0D 20 00 00

.. tabularcolumns:: |p{3.2em}|p{8.2em}|p{5.8em}|p{16em}|p{5.8em}|

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

   +---------+--------------------------------------------+---------------+---------------------------------------------+--------------+
   | Parts   | Fields                                     | Length (Byte) | Range/Format                                | Default      |
   +=========+============================================+===============+=============================================+==============+
   | ID      | Data ID                                    | 1             | 61H (97)                                    | 61H (97)     |
   +---------+--------------------------------------------+---------------+---------------------------------------------+--------------+
   | Length  | Data Length                                | 1             | 00H or 05H                                  |              |
   +---------+--------------------------------------------+---------------+---------------------------------------------+--------------+
   | Content | `Basic Status`                             | 1             | 00H-FFH                                     |              |
   +         +--------------------------------------------+---------------+---------------------------------------------+--------------+
   |         | `Voltage`                                  | 2             | 0000H-FFFFH (mV)                            |              |
   +         +--------------------------------------------+---------------+---------------------------------------------+--------------+
   |         | Reserved                                   | 1             | 00H-FFH                                     | 00H          |
   +         +--------------------------------------------+---------------+---------------------------------------------+--------------+
   |         | `Charging`                                 | 1             | 00H-FFH                                     |              |
   +---------+--------------------------------------------+---------------+---------------------------------------------+--------------+

- `Basic Status`

  The lowest two bits are used to indicate the connection status and disabled state, while the other bits are reserved and default to 0.

  - **Connection Status** (Bit0)

    Indicates whether the internal battery is connected.

    - **0b0** - Not connected.
    - **0b1** - Connected.

  - **Disabled Status** (Bit1)

    Indicates whether the internal battery is disabled.

    - **0b0** - No.
    - **0b1** - Yes.

- `Voltage`

  The internal battery voltage of the terminal device. Expressed as a 16-bit unsigned integer and the unit is mV. This field is only valid when Connection Status is 01H (Connected).

- `Charging`

  Whether the internal battery is being charged. For non-rechargeable battery, the value of this field is 02H.

  - **00H** - Not charging.

  - **01H** - Charging.

  - **02H** - Not support.