.. _headlabel-refx-cmd-rps:

RPS (Report Priority Settings)
==============================

The `AT@RPS` command is used to set the priority of report.

.. code-block:: none

   Example:
   AT@RPS=gl601###,,0,100,,,012F$
   +ACK:RPS,123456789012345,C031,10,0,,012F,20210407101530,1234$
   AT@RPS?gl601###,,0C37$
   +QRY:RPS,123456789012345,C031,10,0,1,1,,0,100,,,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             | RPS                                              | RPS                |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Leading Symbol                   | 1             | =                                                | =                  |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Password                         | 8-16          |                                                  | gl601###           |
   +-------+----------------------------------+---------------+--------------------------------------------------+--------------------+
   | Body  | Reserved                         | 0             |                                                  |                    |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | `Report Priority`                | 1             | 0-2                                              | 0                  |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | `Number of BUFFER Reports`       | <=3           | 9 - 999                                          | 100                |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                                  |                    |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                                  |                    |
   +-------+----------------------------------+---------------+--------------------------------------------------+--------------------+
   | Tail  | Sequence Number                  | 4             | 0000-FFFF ('0'-'9', 'A'-'F')                     |                    |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Tail                             | 1             | $                                                | $                  |
   +-------+----------------------------------+---------------+--------------------------------------------------+--------------------+

- `Report Priority`

  - **0** - BUFFER report first. The terminal device always sends reports according to the order in which they were generated. Reports generated earlier are sent first.

  - **1** - Real-time reports first. The terminal will send the real-time reports first, and then send the history reports.

  - **2** - Automatic. When the number of BUFFER reports reaches the value set by 'Number of BUFFER Reports', the terminal will work in the mode 1 (Real-time reports first), otherwise it will work in the mode 0 (BUFFER reports first).

  About the BUFFER report and real-time report, please see BUFFER Report for more information.

  **Note**: In emergency mode (Profile 63), the terminal always sends real-time reports first (equivalent to setting 'Report Priority' to 1).

- `Number of BUFFER Reports`

  The threshold of the number of BUFFER reports. This field is valid only when 'Report Priority' is 2 (Automatic).