RTO (Real Time Operation)

The real-time operation command AT@RTO is used to control the terminal to perform some operations in real time, such as restarting the device, clearing unsent reports, and so on. For those subcommands used to query data (such as subcommand 0, 1, 8, etc.), the total time for the terminal to perform a query operation will not exceed 150 seconds.

Broadly speaking, there is more than one AT@RTO command for real-time operation, please see here for more information.

Example:
AT@RTO=gl601###,14,,,,,1718$
+ACK:RTO,123456789012345,C031,10,0,14,1718,20210407101530,1234$

Parts

Fields

Length (Byte)

Range/Format

Default

Head

Header

3

AT@

AT@

Command Word

3

RTO

RTO

Leading Symbol

1

=

=

Password

8-16

gl601###

Body

Sub Command

1 or 2

Please see below

Parameters

Expire UTC Time

0 or 14

YYYYMMDDhhmmss

Commands for Restore

N

CMD1|CMD2|CMD3…

Reserved

0

Tail

Sequence Number

4

0000-FFFF (‘0’-‘9’, ‘A’-‘F’)

Tail

1

$

$

  • Sub Command

    A numeral to indicate the sub command to be executed.

    • 0 - Request the terminal to report the specified information (Record 22H). For this subcommand, the ‘Parameters’ is used to specify Data IDs that will be queried.

    • 1 - Request the terminal to report its current position (Record 12H).

    • 3 - Reboot the terminal remotely.

    • 5 - Power off the terminal remotely.

    • 8 - Request the terminal to report its basic information (Record 11H).

    • 14 - Delete all reports stored in the terminal.

    • 92 - Enter emergency mode (Profile 63) for a period of time indicated by ‘Parameters’. After the time expires, the terminal will automatically return to its current working status.

    • 93 - Immediately expire the time set by the subcommand 92 to enter emergency mode, and make the terminal return to previous profile. And even if no subcommand 92 has been issued before, as long as the terminal is working in Profile 63, this command will still cause it to return to the previous profile.

    • 94 - Restore factory settings, that is, reset all parameters to the factory defaults for all configuration commands except the following:

      Note: After this command is completed, the terminal may restart if necessary.

    • 95 - Force restore factory settings, that is, reset all parameters of all commands contained in the ‘Commands for Restore’ field (can include commands listed in subcommand 94).

      Note

      This subcommand may be dangerous. Please ensure the correctness of the command and be responsible for the execution results of the command. After this command is completed, the terminal may restart if necessary.

    • 98 - UTC time calibration. For this subcommand, the ‘Parameters’ is used to specify a UTC time.

    • 99 - Self-Test. Query the terminal self-test result. The terminal will report the self-test result via Record E0H.

  • Parameters

    The parameters of ‘Sub Command’. Its length and content are determined by ‘Sub Command’. For ‘Sub Command’ that does not need to carry parameters, the length of this field is 0.

    For the following ‘Sub Command’, the meaning of this field is as follows:

    • Sub Command 0

      Length: 1 or N bytes

      Format: ID1|ID2|ID3…

      The Data IDs will be queried and contained in the Record 22H. It is allowed to specify one or more Data IDs. Separate multiple Data IDs with ‘|’.

      For example, “86” means Data 86 (Surrounding Cells), “88|89” means Data 88 (SIM Card) and Data 89 (GSV).

      Note: For subcommand 0, the Data ID must be specified (i.e, it cannot be empty), otherwise the command is invalid.

    • Sub Command 92

      Length: <=4 bytes

      Range: 0 or 3-1440 (minutes)

      During this time (in minutes), the terminal will work in Profile 63 (Emergency).

      In particular, this field is 0 or empty to indicate that the terminal will not automatically exit the emergency mode until it receives a AT@RTO command with ‘Sub Command’ being 93.

    • Sub Command 98

      Length: 14 bytes

      Format: YYYYMMDDhhmmss

      Specify a UTC time for time calibration. This value is only valid when the terminal cannot obtain the UTC time automatically.

      For example, “20191120135807” indicates November 20, 2019, 13: 58:07.

      Note: In the case that the terminal cannot obtain the real UTC time through GNSS or network, the user can issue subcommand 98 of the AT@RTO command to calibrate the UTC time. Once the terminal obtains the real UTC time through GNSS or network, it will automatically calibrate the UTC time.

  • Expire UTC Time

    The deadline for receiving this command, in UTC time, for example, “20191120135807” indicates November 20, 2019, 13: 58:07.

    If this field is not empty, this AT@RTO command will only be valid before the time indicated by this field.

    If the terminal receives a AT@RTO command after this time, the command will not be executed and the terminal will reply a NACK frame to the backend server.

  • Commands for Restore

    Only valid when ‘Sub Command’ is 95. It indicates the commands that need to be restored to the factory default.

    For example, this field is “APN|DOG|QRC”, which indicates that all parameters in the AT@APN, AT@DOG, AT@QRC commands need to be restored.

    Note: The inclusion of “QRC” in this field means restoring the configuration of all reports supported by the terminal to the factory defaults.