Message Responses

By default, if you input a message you get back a response. If desired, the INTERFACEMODE command can be used to disable response messages. The response will be in the exact format you entered the message (that is, binary input = binary response).

Abbreviated ASCII Response

The response is just the leading '<' followed by the response string, for example: <OK.

ASCII Response

The response is the full header with the message name being identical except ending in an 'R' (for response). The body of the message consists of a string of characters for the response. For example:

#FRESETR,COM1,0,73.0,UNKNOWN,0,0.000,00000000,06e5,0;OK*55c70910

The prefix "ERROR:" is added to the response message (see Table: Response Messages) except when the command is accepted. When the command is accepted, the message response is "OK".

Binary Response

The response is similar to an ASCII response except that it follows the binary protocols, see Table: Binary Message Response Structure.

Table: Binary Message Sequence is an example of the sequence for requesting and then receiving BESTPOSB. The example is in hex format. When you enter a hex command, you may need to add a ‘\x’ or ‘0x’ before each hex pair, depending on your code. For example:

0xAA0x440x120x1C0x010x000x02 and so on.

Binary Message Response Structure

 

Field

Field Name

Field Type

Description

Binary Bytes

Binary Offset

B
I
N
A
R
Y

 

H
E
A
D
E
R

1

Sync

Char

Hexadecimal 0xAA

1

0

2

Sync

Char

Hexadecimal 0x44

1

1

3

Sync

Char

Hexadecimal 0x12

1

2

4

Header Length

Uchar

Length of the header

1

3

5

Message ID

Ushort

Message ID number

2

4

6

Message Type

Char

Response Bit

1 = Response Message

1

6

7

Port Address

Uchar

See Table: Detailed Port Identifier

1

7

8

Message Length

Ushort

The length in bytes of the body of the message (not including the CRC)

2

8

9

Sequence

Ushort

Normally 0

2

10

10

Idle Time

Uchar

Idle time

1

12

11

Time Status

Enum

Table: GPS Reference Time Status

1 1

13

12

Week

Ushort

GPS reference week number

2

14

13

ms

GPSec

Milliseconds into GPS reference week

4

16

14

Receiver Status

Ulong

Table: Receiver Status

4

20

15

Reserved

Ushort

Reserved

2

24

16

Receiver
S/W Version

Ushort

Receiver software build number

2

26

I
D

17

Response ID

Enum

The enumeration value corresponding to the response message (Table: Response Messages)

4

28

H
E
X

18

Response

Hex

String containing the ASCII response in hex coding to match the ID above (for example, 0x4F4B = OK)

The prefix "ERROR:" is added to the response message (see Table: Response Messages) except when the command is accepted. When the command is accepted, the message response is "OK".

variable

32
Binary Message Sequence

Direction

Sequence

Data

To
Receiver

LOG Command Header

AA44121C 01000240 20000000 1D1D0000 29160000 00004C00 55525A80

LOG Parameters

20000000 2A000000 02000000 00000000 0000F03F 00000000 00000000 00000000

Checksum

2304B3F1

From Receiver

LOG Response Header

AA44121C 01008220 06000000 FFB4EE04 605A0513 00004C00 FFFF5A80

LOG Response Data

01000000 4F4B

Checksum

DA8688EC

From Receiver

BESTPOSB Header

AA44121C 2A000220 48000000 90B49305 B0ABB912 00000000 4561BC0A

BESTPOSB Data

00000000 10000000 1B0450B3 F28E4940 16FA6BBE 7C825CC0 0060769F 449F9040 A62A82C1 3D000000 125ACB3F CD9E983F DB664040 00303030 00000000 00000000 0B0B0000 00060003

Checksum

42DC4C48