AUTH
Authorization code for different model
|
Platform: |
OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, CPT7, CPT7700, SMART7, SMART2 |
Software models
-
an auth-code is installed with the AUTH command
-
an auth-code is embedded in a firmware upgrade
The AUTH command manages the list of auth codes that have been installed on the receiver.
The AUTHCODES log lists all authorization codes stored on the receiver and the VALIDMODELS log lists the currently available models, including those delivered by dispatch. The MODEL command can be used to switch between authorized models.
When the selected auth-code expires or is removed, the first valid model in the auth-code table is selected, if present.
Message ID: 49
Abbreviated ASCII syntax:
AUTH [state] part1 part2 part3 part4 part5 model [date]
Input example:
AUTH add T48JF2,W25DBM,JH46BJ,2WGHMJ,8JW5TW,G2SR0RCCR,101114
AUTH erase_table PW5W2B,WW5TM9,WW2PCZ,WW3M4H,WW4HPG,ERASE_AUTH
When you are ready to upgrade from one model to another, call 1-800-NOVATEL to speak with our Customer Support/Sales Personnel, who can provide the authorization code that unlocks the additional features of your GNSS receiver. This procedure can be performed at your work site and takes only a few minutes.
Receiver models can also be downgraded. This is a two step handshaking process and is best performed in a location with e-mail access.
|
Field |
Field type |
ASCII value |
Binary value |
Description |
Format |
Binary bytes |
Binary offset |
|
1 |
Command header |
- |
- |
AUTH header This field contains the command name for abbreviated ASCII or the message header for ASCII or Binary. |
- |
H |
0 |
|
2 |
state |
Authorization code function to perform |
Enum |
4 |
H |
||
|
3 |
part1 |
6 character ASCII string |
Authorization code section 1 |
String [max. 16] |
Variable1 |
H+4 |
|
|
4 |
part2 |
6 character ASCII string |
Authorization code section 2 |
String [max. 16] |
Variable1 |
H+20 |
|
|
5 |
part3 |
6 character ASCII string |
Authorization code section 3 |
String [max. 16] |
Variable1 |
H+36 |
|
|
6 |
part4 |
6 character ASCII string |
Authorization code section 4 |
String [max. 16] |
Variable1 |
H+52 |
|
|
7 |
part5 |
6 character ASCII string |
Authorization code section 5 |
String [max. 16] |
Variable1 |
H+68 |
|
|
8 |
model |
Alpha numeric |
Null terminated |
Model name of the receiver |
String [max. 16] |
Variable1 |
H+84 |
|
9 |
date |
Numeric |
Null terminated |
Expiry date entered as yymmdd in decimal For binary, if the authorization code does not have an expiry date, enter 4 null characters. |
String [max 7] |
Variable1 |
Variable |
|
ASCII |
Binary |
Description |
|---|---|---|
|
REMOVE |
0 |
Marks the auth-code invalid so it cannot be used and the auth-code is not shown in the AUTHCODES log. AUTH REMOVE does not reboot the receiver and no immediate change to capability (or the VALIDMODELS log) occurs until the next receiver reset. The auth-code remains in the table until AUTH CLEAN_TABLE or AUTH ERASE_TABLE is used, however it cannot be made valid again (unless the full-auth code is added again). If the selected permanent model is removed, the selection reverts to another model in the table. For this parameter, the Part1-Part5 fields can be entered as 0 0 0 0 0, and only the model name entered. |
|
ADD |
1 |
Installs an auth-code in a table in flash memory, selects that model as the one to use as the selected permanent model, and immediately reboots the receiver so it is applied. This is the default option. An auth-code entered incorrectly will be rejected. An auth-code for a different receiver will be installed, but the receiver will report an invalid auth-code with no tracking until a correct model is installed. The auth-codes table can hold up to 24 entries, including invalid, expired and removed codes. If AUTH ADD fails you may need to use AUTH CLEAN_TABLE. |
|
ADD_DOWNLOAD |
4 |
Add the auth-code to the system (Deprecated: Use ADD instead) |
|
ERASE_TABLE |
7 |
Removes all auth-codes from the table. A receiver with no model available performs no GNSS functions and is only capable of user interface commands so that a new model can be entered. Requires a special auth-code to prevent against accidental erasing. The special auth-code required for this option is: PW5W2B,WW5TM9,WW2PCZ,WW3M4H,WW4HPG,ERASE_AUTH |
|
CLEAN_TABLE |
8 |
Removes all expired and removed auth-codes from the table making space for new auth-codes. Requires a special auth-code to prevent against accidental erasing. The special auth-code required for this option is: |