.. _headlabel-refx-cmd-hbm:

HBM (Harsh Behavior Monitoring)
===============================

The `AT@HBM` command is used to monitor the harsh behavior of the driver. This function works while driving.
The terminal will generate and send the report carrying :ref:`Record 72H <headlabel-refx-record-72>` to backend server when the harsh behavior event is detected.

The terminal supports the following harsh behavior event detection:

- Harsh acceleration.

- Harsh deceleration.

- Harsh cornering.

- Harsh acceleration and corerning.

- Harsh deceleration and cornering.

.. note:: If terminal detected 2 or more than 2 times of the same harsh driving behavior within 10 seconds, except the first one, the others will be ignored.

.. code-block:: none

   Example:
   AT@HBM=gv500cna,,1,30,50,35,50,40,50,,,012F$
   +ACK:HBM,123456789012345,8203,3,0,,012F,20210407101530,1234$
   AT@HBM?gv500cna,,0C37$
   +QRY:HBM,123456789012345,8203,3,0,1,1,,1,30,50,30,50,40,50,,,0C37,20210407101530,1234$

.. tabularcolumns:: |p{2.2em}|p{14.2em}|p{5.8em}|p{12em}|p{4.8em}|

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

   +-------+----------------------------------+---------------+---------------------------------------+--------------------+
   | Parts | Fields                           | Length (Byte) | Range/Format                          | Default            |
   +=======+==================================+===============+=======================================+====================+
   | Head  | Header                           | 3             | AT@                                   | AT@                |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | Command Word                     | 3             | HBM                                   | HBM                |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | Leading Symbol                   | 1             | =                                     | =                  |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | Password                         | 8-16          |                                       | gv500cna           |
   +-------+----------------------------------+---------------+---------------------------------------+--------------------+
   | Body  | Reserved                         | 0             |                                       |                    |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | `Mode`                           | 1             | 0-1                                   | 0                  |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | `Acceleration Threshold`         | <=3           | 10-150 (\*10 mg)                      | 30                 |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | `Acceleration Duration`          | <=2           | 10-50 (\*10 ms)                       | 50                 |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | `Deceleration Threshold`         | <=3           | 10-150 (\*10 mg)                      | 35                 |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | `Deceleration Duration`          | <=2           | 10-50 (\*10 ms)                       | 50                 |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | `Cornering Threshold`            | <=3           | 10 - 150 (\*10 mg)                    | 40                 |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | `Cornering Duration`             | <=2           | 10-50 (\*10 ms)                       | 50                 |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                       |                    |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                       |                    |
   +-------+----------------------------------+---------------+---------------------------------------+--------------------+
   | Tail  | Sequence Number                  | 4             | 0000-FFFF ('0'-'9', 'A'-'F')          |                    |
   +       +----------------------------------+---------------+---------------------------------------+--------------------+
   |       | Tail                             | 1             | $                                     | $                  |
   +-------+----------------------------------+---------------+---------------------------------------+--------------------+

- `Mode`

  - **0** - Disable this function.

  - **1** - Enable this function.

- `Acceleration Threshold`

  The threshold for harsh acceleration.

- `Acceleration Duration`

  The duration used to confirm a harsh acceleration event. The acceleration of the driving direction is greater than or equal to the 'Acceleration Threshold' and keeps the duration up to this value, a harsh acceleration is detected.

- `Deceleration Threshold`

  The threshold for harsh deceleration.

- `Deceleration Duration`

  The duration is used to confirm a harsh deceleration event. The deceleration of the driving direction is greater than or equal to the 'Deceleration Threshold' and keeps the duration up to this value, a harsh deceleration is detected.

- `Cornering Threshold`

  The threshold for harsh cornering.

- `Cornering Duration`

  The duration is used to confirm a harsh cornering event. The acceleration for cornering is greater than or equal to the 'Cornering Threshold' and keeps the duration up to this value, a harsh cornering is detected.