.. _headlabel-refx-cmd-dog:

DOG (Protocol Watchdog)
=======================

The `AT@DOG` command is used to restart the terminal periodically, which may help prevent the device from staying in malfunctioning state for a long time.

.. code-block:: none

   Example:
   AT@DOG=gl601###,1,,7,0300,,,,,012F$
   +ACK:DOG,123456789012345,C031,10,0,,012F,20210407101530,1234$
   AT@DOG?gl601###,,0C37$
   +QRY:DOG,123456789012345,C031,10,0,1,1,1,,7,0300,0,,,,0C37,20210407101530,1234$

.. tabularcolumns:: |p{2.2em}|p{10.2em}|p{5.8em}|p{16em}|p{4.8em}|

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

   +-------+----------------------------------+---------------+----------------------------------------------+--------------------+
   | Parts |              Fields              | Length (Byte) |                  Range/Format                |    Default         |
   +=======+==================================+===============+==============================================+====================+
   | Head  | Header                           | 3             | AT@                                          | AT@                |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Command Word                     | 3             | DOG                                          | DOG                |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Leading Symbol                   | 1             | =                                            | =                  |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Password                         | 8-16          |                                              | gl601###           |
   +-------+----------------------------------+---------------+----------------------------------------------+--------------------+
   | Body  | `Mode`                           | 1             | 0, 1                                         | 0                  |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                              |                    |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | `Interval`                       | <=2           | 1-30 (days)                                  | 7                  |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | `Time`                           | 4             | HHMM                                         | 0300               |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | `Time Randomness`                | 1             | 0, 1                                         | 0                  |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                              |                    |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                              |                    |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                              |                    |
   +-------+----------------------------------+---------------+----------------------------------------------+--------------------+
   | Tail  | Sequence Number                  | 4             | 0000-FFFF ('0'-'9', 'A'-'F')                 |                    |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Tail                             | 1             | $                                            | $                  |
   +-------+----------------------------------+---------------+----------------------------------------------+--------------------+

- `Mode`

  - **0** - Disable. The terminal does not restart periodically.

  - **1** - Enable. The terminal will automatically restart periodically according to the following parameters.

- `Interval`

  The interval to restart the terminal.

- `Time`

  At what time to perform the restart operation when 'Interval' (unit is day) is met.

  For example, 'Interval' is "7", 'Time' is "0300", which means that every 7 days, and the terminal will restart at 03:00:00 in the morning.

- `Time Randomness`

  Specify whether to enable the randomness of reboot time.

  - **0** - Disable. When this function is disabled, the restart action is allowed to be executed at a random moment within 5 minutes after the scheduled time has been reached.

  - **1** - Enable. When this function is enabled, the restart action is allowed to be executed at a random moment within one hour after the scheduled time has been reached.