.. _headlabel-refx-cmd-pps:

PPS (Profile Priority Settings)
===============================

The `AT@PPS` command is specially used to adjust the priority of the profiles.

By default, the lower the value of the profile ID, the lower the priority, that is, Profile 0 (Default) has the lowest priority and Profile 63 (Emergency) has the highest priority. And in particular, the priority of Profile 0 and Profile 63 cannot be changed, while the priority of other profiles can be changed through this command.

.. code-block:: none

   Example:
   AT@PPS=gv500cna,0<1<3<10<12<16<13<63,,,012F$
   +ACK:PPS,123456789012345,8203,3,0,,012F,20210407101530,1234$
   AT@PPS?gv500cna,,0C37$
   +QRY:PPS,123456789012345,8203,3,0,1,1,0<1<3<10<12<16<13<63,,,0C37,20210407101530,1234$

.. tabularcolumns:: |p{2.2em}|p{7.2em}|p{5.8em}|p{19em}|p{4.8em}|

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

   +-------+----------------------------------+---------------+--------------------------------------------------+--------------------+
   | Parts |              Fields              | Length (Byte) |                  Range/Format                    |    Default         |
   +=======+==================================+===============+==================================================+====================+
   | Head  | Header                           | 3             | AT@                                              | AT@                |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Command Word                     | 3             | PPS                                              | PPS                |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Leading Symbol                   | 1             | =                                                | =                  |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Password                         | 8-16          |                                                  | gv500cna           |
   +-------+----------------------------------+---------------+--------------------------------------------------+--------------------+
   | Body  | `Profile IDs`                    | 1 or N        | 0 < X1 < X2 < X3 …                               |                    |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                                  |                    |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                                  |                    |
   +-------+----------------------------------+---------------+--------------------------------------------------+--------------------+
   | Tail  | Sequence Number                  | 4             | 0000-FFFF ('0'-'9', 'A'-'F')                     |                    |
   +       +----------------------------------+---------------+--------------------------------------------------+--------------------+
   |       | Tail                             | 1             | $                                                | $                  |
   +-------+----------------------------------+---------------+--------------------------------------------------+--------------------+

- `Profile IDs`

  Configure the priority of the specified profile IDs.

  Use the '<' symbol to connect specified profile IDs, the priority of the profile ID on the right side of the symbol is higher than the one on the left.

  Since Profile 0 is always the lowest priority, 0 can only appear on the far left.

  In particular, if you want to set the priority of one certain profile ID to be greater than 0 but less than other IDs, you can omit "0<" and just fill in its ID.

  For example, if this field is set to "0<10<1<3<6", it means that the priority is sorted from low to high, in order 0, 10, 1, 3, 6, and then other IDs.

  For example, if this field is set to "12", it means that the priority is sorted from low to high, in order is 0, 12, and then other IDs.

  For another example, assuming that the current priority order is 0,1,3,10,7,6,63 in the terminal, and if "10<1<6" is set, then the priority order will become 0,3,10,1,6,7,63.

  Please check the table below to known the changing process:

  +----------+-----------------------------+------------------------------------------------------+
  | Step     | Step Description            | Process                                              |
  +==========+=============================+======================================================+
  | 1        | Current priority order      | 0 , **1** , 3 , **10** , 7 , **6** , 63              |
  +----------+-----------------------------+------------------------------------------------------+
  | 2        | Received a specific order   | 10 < 1 < 6                                           |
  +----------+-----------------------------+------------------------------------------------------+
  | 3        | Split into two sorts        | "0 , 3 , **10** , 7 , 63" and "**10** , 1 , 6"       |
  +----------+-----------------------------+------------------------------------------------------+
  | 4        | Merge into a final new sort | 0 , 3 , **10** , **1** , **6** , 7 , 63              |
  +----------+-----------------------------+------------------------------------------------------+

  **Note**: The focus of all the above examples is to describe the usage of this parameter, please do not care whether the profile IDs used in the examples exist in the document.