.. _headlabel-refx-cmd-mag:

MAG (Magnetic Function Settings)
================================

The `AT@MAG` command is used to configure the magnetic function of the terminal.

.. code-block:: none

   Example:
   AT@MAG=gl601###,,1,,,,,012F$
   +ACK:MAG,123456789012345,C031,10,0,,012F,20210407101530,1234$
   AT@MAG?gl601###,,0C37$
   +QRY:MAG,123456789012345,C031,10,0,1,1,,1,,,,,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             | MAG                                          | MAG                |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Leading Symbol                   | 1             | =                                            | =                  |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Password                         | 8-16          |                                              | gl601###           |
   +-------+----------------------------------+---------------+----------------------------------------------+--------------------+
   | Body  | Reserved                         | 0             |                                              |                    |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | `Magnetic Shutdown`              | 1             | 0, 1                                         | 1                  |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                              |                    |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                              |                    |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                              |                    |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Reserved                         | 0             |                                              |                    |
   +-------+----------------------------------+---------------+----------------------------------------------+--------------------+
   | Tail  | Sequence Number                  | 4             | 0000-FFFF ('0'-'9', 'A'-'F')                 |                    |
   +       +----------------------------------+---------------+----------------------------------------------+--------------------+
   |       | Tail                             | 1             | $                                            | $                  |
   +-------+----------------------------------+---------------+----------------------------------------------+--------------------+

- `Magnetic Shutdown`

  Specify whether to enable the magnetic shutdown feature.

  - **0** - Disable.

  - **1** - Enable. When the terminal detects that the magnet is attached for 2 minutes, the terminal will automatically power off. When the magnet is removed, the terminal will automatically power on again.