39: GPS Control
Read the GPS service state, control correction data, or request a GPS start mode. Use Position (message 15) for location data.
Documented Method (5) values SET, GET
Applies to Viper devices only
Shared optional header · Message ID (1) can identify a request, response or publication. A response's own ID is separate from Response To (3). Message ID and reply rules apply unless an interaction states an exception.
Message fields
Fields specific to GPS Control. Operation sections below explain when each field is used.
| Field | Type | Description |
|---|---|---|
| GPS is onField 1 | bool | Whether the GPS service is on. |
| Corrections EnabledField 2 | uint8 | Whether GPS correction data is enabled.
|
| Start ModeField 3 | uint8 | Start mode of the GPS module.
|
Configure corrections and start mode
Enable correction data and/or restart the GPS in the requested boot mode.
Request
Sending the read-only GPS status (field 1) in SET is rejected with Invalid Parameter (4).
Shared optional Message ID and reply rules
Request headers
- MethodHeader 5
uint8requiredValue
1· SETRequest a service to be perform an action
Request data fields
- Corrections EnabledField 2
uint8optionalRequest and apply correction data to the GPS, such as RTK; this automatically controls the GPS module. Omitting this field sets API-enabled corrections to disabled, so a start-mode-only SET does not preserve the previous correction setting. Include 1 to keep API-enabled corrections on.
0· Disabled1· Full RTCM stream
- Start ModeField 3
uint8optionalIf GPS is enabled, reboot it in this mode. If it is disabled, enable it with the requested state.
1· Normal2· Cold3· Warm4· Hot
Expected response (MT5 - ACK)
Successful SET returns an ACK, not GPS state. Use GET to read the current state afterward.
Correlation, status and acknowledgment rules · MT5 packet format
Unsuccessful replies
Applicable errors and operation-specific causes. Codes are values of Status header 4, not payload fields.
4Invalid Parameter- A read-only GPS status field or an unsupported start mode was supplied.
5Invalid State- The correction service cannot be enabled in the current device state.
7Not Supported- If the receiver does not support the requested action or method
Read GPS state
Return the current GPS and correction-service state, not a position fix. No payload fields are needed.
Request
Shared optional Message ID and reply rules
Request headers
- MethodHeader 5
uint8requiredValue
2· GETRequest a service to be perform an action
Expected response (MT39)
GPS state
A successful GET returns GPS Control directly, with no separate success ACK. An unsuccessful request returns MT5 (ACK) with Status, not this payload.
Correlation, status and acknowledgment rules
Response data fields
- GPS is onField 1
boolrequiredWhether the GPS service is on.
- Corrections EnabledField 2
uint8requiredWhether GPS correction data is enabled.
0· Disabled1· Full RTCM stream
- Start ModeField 3
uint8omittedStart mode is a SET input, not returned state.
1· Normal2· Cold3· Warm4· Hot
Unsuccessful replies
Applicable errors and operation-specific causes. Codes are values of Status header 4, not payload fields.
7Not Supported- If the receiver does not support the requested action or method
Message and field constants
Identifiers for this message type and its fields. See the operation sections above for rules and limits.