21H (Motion Information)¶
This message is used to report the motion status of the terminal. This message is only generated when the motion state of the terminal is changed. Please see the AT@GSENSOR command for more information.
The frame format of a report that only carries 21H record is as follows:
For example (Total 56 bytes):
2B 00 00 38 00 01 23 45 67 89 01 23 45 C0 31 00 0A 00 00 21 66 8E 47 F7 00 00 21 00 51 0F 09 07 3C 46 FF 01 DB 88 57 5F 17 9D A0 01 7D 5B 05 00 00 02 00 01 01 23 08 24
Parts |
Fields |
Length (Byte) |
Range/Format |
Default |
|
|---|---|---|---|---|---|
Head |
18 or 20 |
||||
Reserved |
1 or 1+N |
||||
Records |
Record Length |
1 or 2 |
00H-7FH or 8080H-FFFFH |
||
Generated Time |
4 |
||||
Record Count Number |
2 |
0000H-FFFFH |
|||
Record ID |
1 |
21H |
21H |
||
Event Code |
1 |
00H |
00H |
||
Data of Record |
Data ID |
1 or 2 |
00H-7FH or 8080H-FFFFH |
||
Data Length |
1 or 2 |
00H-7FH or 8080H-FFFFH |
|||
Data Content |
N |
||||
… |
|||||
… |
|||||
Tail |
4 |
||||
The definitions of parts ‘Head’, ‘Reserved’, and ‘Tail’ are here.
Event Code
The default is 00H.
Data of Record
It consists of one or more Data ID units.
By default, this record contains only the data IDs listed below, which can be changed by the AT@QRC command described below.
Configuration¶
The parameters related to the generation and transmission of 21H record are controlled by the following QRC command:
Example:
AT@QRC=gl601###,21,,1,1,81|91,012F$
+ACK:QRC,123456789012345,C031,10,0,21,012F,20210407101530,1234$
AT@QRC?gl601###,21,0C37$
+QRY:QRC,123456789012345,C031,10,0,1,1,21,,1,1,81|91,0C37,20210407101530,1234$
Parts |
Fields |
Length (Byte) |
Range/Format |
Default |
|---|---|---|---|---|
Head |
Header |
3 |
AT@ |
AT@ |
Command Word |
3 |
QRC |
QRC |
|
Leading Symbol |
1 |
= |
= |
|
Password |
8-16 |
gl601### |
||
Body |
Record ID |
2 |
21 |
21 |
Reserved |
0 |
|||
Mode |
<=2 |
0, 1, 12 |
1 |
|
Action |
1 |
0-2 |
||
Data IDs |
N |
ID1|ID2|ID3… |
||
Tail |
Sequence Number |
4 |
0000-FFFF (‘0’-‘9’, ‘A’-‘F’) |
|
Tail |
1 |
$ |
$ |
Record ID
Which record to configure. Always “21” here.
Mode
0 - Disable. The terminal no longer generates and sends the 21H record.
1 - Enable Report. The terminal generates and sends the 21H record. If the location information needs to be included, the terminal directly uses the currently existing location information (even if the location information has expired).
12 - Enable Report (Event first). In order to report the event in time, the terminal immediately generates and sends a report. If the location information contained in this sent report has expired, the terminal will wait for real-time positioning, then generate and send one more report (Note: To distinguish between the two reports, the highest bit of the event code for the appended report is set to 1, i.e. plus 80H).
Note
For Mode 12, if the report does not need to carry location information, it is equivalent to Mode 1.
Action
Empty - No change the data IDs in the terminal. If this field is empty, the ‘Data IDs’ field will be ignored.
0 - Append the data IDs carried in the ‘Data IDs’ field to the terminal.
1 - Replace the data IDs in the terminal with the data IDs carried by the ‘Data IDs’ field.
2 - Clear the data IDs carried in the ‘Data IDs’ field from the terminal.
Note: In particular, it always will be 1 when reading this field.
Data IDs
The data IDs contained in the 21H record. The characters ‘|’ are used to connect each data ID.
For example, “2|88” means Data 2 (Device Name) and Data 88 (SIM Card).