VERSION

Version information

Platform:

OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, CPT7, CPT7700, SMART7, SMART2

This log contains the version information for all components of a system. A component may be hardware (for example, a receiver or data collector) or firmware in the form of applications or data (for example, data blocks for height models or user applications). See Table: Firmware and boot version field formats for details on the format of key fields.

The GPSCARD entry indicates the currently active software model, which determines which receiver features are authorized.

See also the VALIDMODELS log.

Message ID: 37

Log type: Polled

Recommended input:

log versiona once

Abbreviated ASCII example:

<VERSION USB1 0 49.0 FINESTEERING 2209 515707.883 02000020 3681 16809

<    12

<        GPSCARD "FFNRNNCBES1" "BMHR17090005E" "OEM7700-1.00" "OM7CR0810RN0000" "OM7BR0001RBG000" "2021/Dec/06" "11:16:48"

<        OEM7FPGA "" "" "" "OMV070001RN0000" "" "" ""

<        APPLICATION "" "" "" "EP7AR0810RN0000" "" "2021/Dec/06" "11:16:59"

<        DEFAULT_CONFIG "" "" "" "EP7CR0810RN0000" "" "2021/Dec/06" "11:17:11"

<        PACKAGE "" "" "" "EP7PR0810RN0000" "" "2021/Dec/06" "11:17:05"

<        DB_WWWISO "WWWISO" "0" "" "1.8.0" "" "2022/Apr/11" "15:44:16"

<        ENCLOSURE "PWRPAK7-E1" "NMNE17200009B" "" "" "" "" ""

<        WIFI "RS9113" "" "" "1.7.12" "" "2021/Dec/06" "11:17:22"

<        REGULATORY "US" "" "" "" "" "" ""

<        IMUCARD "Epson G320N 125" "00000354" "G320PDGN" "2510" "" "" ""

<        WHEELSENSOR "" "" "" "SWS000201RN0000" "" "" ""

<        SERVICE "PERIOD" "TerraStar-C PRO" "ALIGN" "" "" "" ""

The SERVICE component type is available only on firmware version 7.09.06.

The VERSION log is a useful log as a first communication with your receiver. Once connected, using NovAtel Application Suite or a terminal emulator program, log VERSION and check that the output makes sense. Also, ensure that you have the receiver components you expected.

Field

Field type

Description

Format

Binary bytes

Binary offset

1

Log header

VERSION header

For information about log headers, see ASCII, Abbreviated ASCII or Binary.

 

H

0

2

# comp

Number of components (cards, and so on)

Long

4

H

3

type

Component type (see Table: Component types)

Enum

4

H+4

4

model

When type is GPSCARD: Currently active software model name, e.g., CFNPNNTVN, indicates the receiver’s current model functionality (see Receiver Features: Authorization and Subscriptions).

When type is ENCLOSURE: Name of the enclosure type.

Firmware version 7.09.06.
When type is SERVICE: Source of the currently active software model, see Table: Receiver features source.

Char[16]

16

H+8

5

psn

Product serial number

Firmware version 7.09.06.
When type is SERVICE: Name of the first active service, if any. See the DISPATCHSCHEDULE log Active Service Names field.

Char[16]

16

H+24

6

hw version

When type is GPSCARD: Hardware version in the format: <hardware platform>-<hardware revision> eg. OEM7700-1.0

Firmware version 7.09.06.
When type is SERVICE: Name of the second active service, if any. See the DISPATCHSCHEDULE log Active Service Names field.

Char[16]

16

H+40

7

sw version

Firmware version, see Table: Firmware and boot version field formats

Firmware version 7.09.06.
When type is SERVICE: Name of the third active service, if any. See the DISPATCHSCHEDULE log Active Service Names field.

Char[16]

16

H+56

8

boot version

Boot code version, see Table: Firmware and boot version field formats

Firmware version 7.09.06.
When type is SERVICE: Name of the fourth active service, if any. See the DISPATCHSCHEDULE log Active Service Names field.

Char[16]

16

H+72

9

comp date

Firmware compile date in the format:

YYYY/Mmm/DD

Where

YYYY = year
Mmm = month
DD = day (1-31)

Example:  2018/Jul/10

Firmware version 7.09.06.
When type is SERVICE: Name of the fifth active service, if any. See the DISPATCHSCHEDULE log Active Service Names field.

Char[12]

12

H+88

10

comp time

Firmware compile time in the format:

HH:MM:SS

Where:

HH = hours
MM = minutes
SS = seconds

Example: 14:37:01

Firmware version 7.09.06.
When type is SERVICE: Name of the sixth active service, if any. See the DISPATCHSCHEDULE log Active Service Names field.

Char[12]

12

H+100

11...

Next component offset = H + 4 + (#comp x 108)

12

xxxx

32-bit CRC (ASCII and Binary only)

Ulong

4

H+4+
(#comp x 108)

13

[CR][LF]

Sentence terminator (ASCII only)

-

-

-

Component types

Binary

ASCII

Description

0

UNKNOWN

Unknown component

1

GPSCARD

OEM7 family receiver

In an enclosure product this is the
receiver card in the enclosure.

2

CONTROLLER

Reserved

3

ENCLOSURE

OEM card enclosure

4-6

Reserved

7

IMUCARD

IMU integrated in the enclosure

8

USERINFO

Application specific information

12-14

Reserved

15

WIFI

Wi-Fi radio firmware

16-17

Reserved

18

RADIO

UHF radio component

19

WWW_CONTENT

Web Server content

20

Regulatory

Regulatory configuration

21

OEM7FPGA

OEM7 FPGA version

22

APPLICATION

Embedded application

23

Package

Package

24

Reserved

25

DEFAULT_CONFIG

Default configuration data

26

WHEELSENSOR

Wheel sensor in the enclosure

27

EMBEDDED_AUTH

Embedded Auth-Code data

30

SERVICE

This component type is available only on firmware 7.09.06.

Current subscription service period status.

See the DISPATCHSCHEDULE log for details.

981073920 (0x3A7A0000)

DB_HEIGHTMODEL

Height/track model data

981073928 (0x3A7A0008)

DB_WWWISO

Web UI ISO Image

981073930 (0x3A7A000A)

DB_LUA_SCRIPTS

Lua Script ISO Image

Firmware and boot version field formats

Field format (ASCII)

Description

Example

 

NWXYZFFMMRN0000

N = Family Name

The Family Name can be:

O = OEM

Software Version:
OM7CR0500RN0000

Boot Version:
OM7BR0001RB0000

In both examples, the Family Name is O.

 

WX = Product

The Product can be:

M7: OEM7 product

A7: Agriculture optimized OEM7 product

 

In both examples, the Product is M7.

 

Y = Image Type

The Image Type can be:

B: boot code

M: main firmware application

C: combined main firmware application and user application

 

In the Software Version example, the Image Type is C.

In the Boot Version example, the Image Type is B.

 

Z = Signature

The Signature can be:

R: Officially signed

H: High Speed signed

 

In both examples the Signature is R.

 

FF = Feature Release Number

 

In the Software Version example, the Feature Release Number is 05.

In the Boot Version example, the Feature Release Number is 00.

 

MM = Maintenance Release Number

 

In the Software Version example, the Maintenance Release Number is 00.

In the Boot Version example, the Maintenance Release Number is 01.

 

R = Release Type

The Release Type can be:

A: Alpha

B: Beta

R: Release

S: Special

E: Engineering Special

C: Customer Approved Special

 

In both examples, the Release Type is R.

 

N = Distribution Permit

The Distribution Permit can be:

N: No restrictions

B: Boot Code

H: High Speed Build (Requires a permit to use)

 

In the Software Version example, the Distribution Permit is N.

In the Boot Version example, the Distribution Permit is B.

 

0000 = Minor Release Indicator

 

In both examples, the Minor Release Indicator is 0000.

The firmware version of a receiver is also presented in a short version (e.g. 7.05.04). The short version is the product number, feature release number and maintenance release number separated by dots. For example, the firmware version OM7MR0504RN0000 has a short version of 7.05.04.