.. _headlabel-refx-cmd-owh:

OWH (Outside Working Hours)
===========================

The `AT@OWH` command is used to define the working hours for the terminal. When the terminal works at outside the working hours, it will enter the 'off duty' state and enter :ref:`Profile 3 (Off Duty) <refx-features-profiles-supported>` (if enabled).

.. code-block:: none

   Example:
   AT@OWH=gv500cna,,3E,0900,1200,1300,1800,,,012F$
   +ACK:OWH,123456789012345,8203,3,0,,012F,20210407101530,1234$
   AT@OWH?gv500cna,,0C37$
   +QRY:OWH,123456789012345,8203,3,0,1,1,,3E,0900,1200,1300,1800,,,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             | OWH                                 | OWH                |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | Leading Symbol                 | 1             | =                                   | =                  |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | Password                       | 8-16          |                                     | gv500cna           |
   +-------+--------------------------------+---------------+-------------------------------------+--------------------+
   | Body  | `Mode`                         | 1             | 0, 1                                | 0                  |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | `Day of Work`                  | <=2           | 0-7F                                | 3E                 |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | `Working Hours Start 1`        | 4             | HHMM                                | 0900               |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | `Working Hours End 1`          | 4             | HHMM                                | 1200               |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | `Working Hours Start 2`        | 4             | HHMM                                | 1300               |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | `Working Hours End 2`          | 4             | HHMM                                | 1800               |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | Reserved                       | 0             |                                     |                    |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | Reserved                       | 0             |                                     |                    |
   +-------+--------------------------------+---------------+-------------------------------------+--------------------+
   | Tail  | Sequence Number                | 4             | 0000-FFFF ('0'-'9', 'A'-'F')        |                    |
   +       +--------------------------------+---------------+-------------------------------------+--------------------+
   |       | Tail                           | 1             | $                                   | $                  |
   +-------+--------------------------------+---------------+-------------------------------------+--------------------+

- `Mode`

  It specifies the working mode.

  - **0** - Disable.

  - **1** - Automatic. In this mode, location information will be hidden under the following condition: the device works at outside the working hours.

- `Day of Work`

  It specifies the working days in a week in a bitwise manner.

  - **bit0** - Sunday
  - **bit1** - Monday
  - **bit2** - Tuesday
  - **bit3** - Wednesday
  - **bit4** - Thursday
  - **bit5** - Friday
  - **bit6** - Saturday
  - **bit7** - Invalid bit, always set to 0.

  For each bit, 0 means "off day", and 1 means "working day".

- `Working Hours Start 1`

  Specify the start time of the first working period in a day.

- `Working Hours End 1`

  Specify the end time of the first working period in a day.

  For example, 'Working Hours Start 1' is "0900" and 'Working Hours End 1' is "1200", which means the working hours are from 9 to 12 o'clock.

  **Note**: The 'Working Hours Start 1' must not be greater than 'Working Hours End 1'. If the 'Working Hours Start 1' is equal to 'Working Hours End 1', that means the whole day (i.e., 24 hours).

- `Working Hours Start 2`

  Specify the start time of the second working period in a day.

- `Working Hours End 2`

  Specify the end time of the second working period in a day.

  For example, 'Working Hours Start 2' is "1300" and 'Working Hours End 2' is "1800", which means the working hours are from 13 to 18 o'clock.

  **Note**: The 'Working Hours Start 2' can be equal to 'Working Hours Start 1', and 'Working Hours End 2' can be equal to 'Working Hours End 1'.