OEM7 Commands and Logs Reference Manual
OEM7 Commands and Logs Reference Manual
PDF OEM7 Commands and Logs Reference Manual | Type
Proprietary Notice. Information in this document is subject to change without notice and does not represent a com-mitment on the part of NovAtel Inc. The information contained within this manual is...
OEM7 CommandsandLogs ReferenceManual
OEM7CommandsandLogsReferenceManualv10 5 2.73 J1939CONFIG 221 2.74 LOCKOUT 223 2.75 LOCKOUTSYSTEM 224 2.76 LOG 225 2.76.1 Binary 227 2.76.2 ASCII 230
Proprietary Notice. Information in this document is subject to change without notice and does not represent a com-mitment on the part of NovAtel Inc. The information contained.. View
Full PDF Document
If the inline viewer fails, it will open the original document in compatibility mode automatically. You can also open the file directly.
Extracted Text
OEM7 Commands and Logs
Reference Manual
OM-20000169 v10
January 2019
OEM7 Commands and Logs Reference Manual
Publication Number: OM-20000169 Revision Level: v10 Revision Date: January 2019 Firmware Versions:
l 7.05.04 / OM7MR0504RN0000 l PP7 07.05.04 / EP7PR0504RN0000
Proprietary Notice
Information in this document is subject to change without notice and does not represent a commitment on the part of NovAtel Inc. The information contained within this manual is believed to be true and correct at the time of publication. NovAtel, ALIGN, GLIDE, GrafNav/GrafNet, Inertial Explorer, NovAtel CORRECT, OEM7, PwrPak7, RELAY, SPAN, STEADYLINE, VEXXIS and Waypoint are registered trademarks of NovAtel Inc. NovAtel Connect, OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, SMART7, RELAY7 and RTK ASSIST are trademarks of NovAtel Inc. All other brand names are trademarks of their respective holders.
� Copyright 2019 NovAtel Inc. All rights reserved. Unpublished rights reserved under International copyright laws.
OEM7 Commands and Logs Reference Manual v10
2
Table of Contents
Figures
Tables
Customer Support
Foreword
Chapter 1 Messages
1.1 ASCII 1.2 Abbreviated ASCII 1.3 Binary 1.4 Description of ASCII and Binary Logs with Short Headers 1.5 Message Responses
1.5.1 Abbreviated ASCII Response 1.5.2 ASCII Response 1.5.3 Binary Response 1.6 GLONASS Slot and Frequency Numbers 1.6.1 PRN Numbers 1.7 GPS Reference Time Status 1.8 Message Time Stamps 1.9 Decoding of the GPS Reference Week Number 1.10 32-Bit CRC
Chapter 2 GNSS Commands
2.1 Command Formats 2.1.1 Optional Parameters
2.2 Command Settings 2.3 Factory Defaults 2.4 Command Reference 2.5 ADJUST1PPS 2.6 ALIGNAUTOMATION 2.7 ANTENNAPOWER 2.8 ANTENNATYPE 2.9 ASSIGN 2.10 ASSIGNALL 2.11 ASSIGNLBANDBEAM 2.12 AUTH 2.13 AUTOSURVEY 2.14 BASEANTENNAPCO 2.15 BASEANTENNAPCV 2.16 BASEANTENNATYPE 2.17 BDSECUTOFF 2.18 BESTVELTYPE 2.19 CANCONFIG 2.20 CCOMCONFIG 2.21 CLOCKADJUST 2.22 CLOCKCALIBRATE 2.23 CLOCKOFFSET
OEM7 Commands and Logs Reference Manual v10
27 29 29 40 41 41 41 41 43 44 45 46 47 47
51 51 51 52 52 53 61 63 65 68 71 74 76 79 82 84 85 97 99 100 102 105 107 110
3
2.24 CNOUPDATE 2.25 COMCONTROL 2.26 DATADECODESIGNAL 2.27 DATUM 2.28 DGPSTXID 2.29 DIFFCODEBIASCONTROL 2.30 DLLTIMECONST 2.31 DNSCONFIG 2.32 DUALANTENNAPORTCONFIG 2.33 DYNAMICS 2.34 ECHO 2.35 ECUTOFF 2.36 ELEVATIONCUTOFF 2.37 ETHCONFIG 2.38 EVENTINCONTROL 2.39 EVENTOUTCONTROL 2.40 EXTERNALCLOCK 2.41 FILEAUTOTRANSFER 2.42 FILECONFIG 2.43 FILEDELETE 2.44 FILEMEDIACONFIG 2.45 FILEROTATECONFIG 2.46 FILETRANSFER 2.47 FIX 2.48 FIXPOSDATUM 2.49 FORCEGALE6CODE 2.50 FORCEGLOL2CODE 2.51 FORCEGPSL2CODE 2.52 FREQUENCYOUT 2.53 FRESET 2.54 GALECUTOFF 2.55 GENERATEALIGNCORRECTIONS 2.56 GENERATEDIFFCORRECTIONS 2.57 GENERATERTKCORRECTIONS 2.58 GGAQUALITY 2.59 GLIDEINITIALIZATIONPERIOD 2.60 GLOECUTOFF 2.61 HDTOUTTHRESHOLD 2.62 HEADINGOFFSET 2.63 ICOMCONFIG 2.64 INTERFACEMODE
2.64.1 SPAN Systems 2.65 IONOCONDITION 2.66 IPCONFIG 2.67 IPSERVICE 2.68 ITBANDPASSCONFIG 2.69 ITDETECTCONFIG 2.70 ITFRONTENDMODE 2.71 ITPROGFILTCONFIG 2.72 ITSPECTRALANALYSIS
OEM7 Commands and Logs Reference Manual v10
111 112 115 119 127 128 129 132 133 134 136 139 141 144 146 148 151 154 156 158 159 160 164 166 170 171 172 174 176 179 182 184 186 187 189 191 192 194 195 196 198 198 204 205 207 209 211 213 215 217
4
2.73 J1939CONFIG 2.74 LOCKOUT 2.75 LOCKOUTSYSTEM 2.76 LOG
2.76.1 Binary 2.76.2 ASCII 2.77 LOGIN 2.78 LOGOUT 2.79 LUA 2.80 MAGVAR 2.81 MARKCONTROL 2.82 MEDIAFORMAT 2.83 MODEL 2.84 MOVINGBASESTATION 2.85 NAVICECUTOFF 2.86 NMEAFORMAT 2.87 NMEATALKER 2.88 NMEAVERSION 2.89 NTRIPCONFIG 2.90 NTRIPSOURCETABLE 2.91 NVMRESTORE 2.92 NVMUSERDATA 2.93 PDPFILTER 2.93.1 GLIDE Position Filter 2.94 PDPMODE 2.95 PGNCONFIG 2.96 POSAVE 2.97 POSTIMEOUT 2.98 PPPBASICCONVERGEDCRITERIA 2.99 PPPCONVERGEDCRITERIA 2.100 PPPDYNAMICS 2.101 PPPDYNAMICSEED 2.102 PPPRESET 2.103 PPPSEED 2.104 PPPSOURCE 2.105 PPPTIMEOUT 2.106 PPSCONTROL 2.107 PPSCONTROL2 2.108 PROFILE 2.109 PSRDIFFSOURCE 2.110 PSRDIFFSOURCETIMEOUT 2.111 PSRDIFFTIMEOUT 2.112 QZSSECUTOFF 2.113 RADARCONFIG 2.114 RAIMMODE 2.114.1 Detection strategy 2.114.2 Isolation strategy 2.115 REFERENCESTATIONTIMEOUT 2.116 RESET 2.117 RFINPUTGAIN
OEM7 Commands and Logs Reference Manual v10
221 223 224 225 227 230 231 233 234 236 239 242 243 244 246 248 251 253 254 256 257 258 259 259 261 262 263 265 266 267 268 269 271 272 274 276 277 280 283 285 288 289 290 292 294 294 294 296 297 298
5
2.118 RTKANTENNA 2.119 RTKASSIST 2.120 RTKASSISTTIMEOUT 2.121 RTKDYNAMICS 2.122 RTKINTEGERCRITERIA 2.123 RTKMATCHEDTIMEOUT 2.124 RTKNETWORK 2.125 RTKPORTMODE 2.126 RTKQUALITYLEVEL 2.127 RTKRESET 2.128 RTKSOURCE 2.129 RTKSOURCETIMEOUT 2.130 RTKSVENTRIES 2.131 RTKTIMEOUT 2.132 SAVECONFIG 2.133 SAVEETHERNETDATA 2.134 SBASCONTROL 2.135 SBASECUTOFF 2.136 SBASTIMEOUT 2.137 SELECTCHANCONFIG 2.138 SEND 2.139 SENDHEX 2.140 SERIALCONFIG 2.141 SERIALPROTOCOL 2.142 SETADMINPASSWORD 2.143 SETAPPROXPOS 2.144 SETAPPROXTIME 2.145 SETBASERECEIVERTYPE 2.146 SETBESTPOSCRITERIA 2.147 SETDIFFCODEBIASES 2.148 SETIONOTYPE 2.149 SETNAV 2.150 SETROVERID 2.151 SETTIMEBASE 2.152 SETTROPOMODEL 2.153 SETUTCLEAPSECONDS 2.154 SOFTLOADCOMMIT 2.155 SOFTLOADDATA 2.156 SOFTLOADRESET 2.157 SOFTLOADSETUP 2.158 SOFTLOADSREC 2.159 STATUSCONFIG 2.160 STEADYLINE 2.161 STEADYLINEDIFFERENTIALTIMEOUT 2.162 SURVEYPOSITION 2.163 THISANTENNAPCO 2.164 THISANTENNAPCV 2.165 THISANTENNATYPE 2.166 TRACKSV 2.167 TUNNELESCAPE
OEM7 Commands and Logs Reference Manual v10
300 302 303 305 306 308 309 312 314 315 316 318 319 320 321 322 324 327 328 329 333 335 336 339 341 342 343 345 346 347 349 350 352 353 355 356 357 358 359 360 362 363 365 367 368 371 372 373 374 376
6
2.168 UALCONTROL 2.169 UNASSIGN 2.170 UNASSIGNALL 2.171 UNDULATION 2.172 UNLOCKOUT 2.173 UNLOCKOUTALL 2.174 UNLOCKOUTSYSTEM 2.175 UNLOG
2.175.1 Binary 2.175.2 ASCII 2.176 UNLOGALL 2.177 USBSTICKEJECT 2.178 USERDATUM 2.179 USEREXPDATUM 2.180 USERI2CREAD 2.181 USERI2CWRITE 2.182 UTMZONE 2.183 WIFIAPCHANNEL 2.184 WIFIAPIPCONFIG 2.185 WIFIAPPASSKEY 2.186 WIFIMODE
Chapter 3 Logs
3.1 Log Types 3.1.1 Log Type Examples
3.2 Log Reference 3.3 ALIGNBSLNENU 3.4 ALIGNBSLNXYZ 3.5 ALIGNDOP 3.6 ALMANAC 3.7 AUTHCODES 3.8 AVEPOS 3.9 BDSALMANAC 3.10 BDSCLOCK 3.11 BDSEPHEMERIS 3.12 BDSIONO 3.13 BDSRAWNAVSUBFRAME 3.14 BESTPOS 3.15 BESTSATS 3.16 BESTUTM 3.17 BESTVEL 3.18 BESTXYZ 3.19 BSLNXYZ 3.20 CHANCONFIGLIST 3.21 CLOCKMODEL 3.22 CLOCKSTEERING 3.23 DUALANTENNAHEADING 3.24 ETHSTATUS 3.25 FILELIST 3.26 FILESTATUS
OEM7 Commands and Logs Reference Manual v10
378 380 382 383 385 386 387 388 388 389 390 391 392 394 397 399 402 404 405 406 407
409 409 410 411 413 415 416 419 421 423 425 427 430 432 433 442 446 449 452 455 457 461 463 466 468 469 471
7
3.27 FILESYSTEMCAPACITY 3.28 FILESYSTEMSTATUS 3.29 FILETRANSFERSTATUS 3.30 GALALMANAC 3.31 GALCLOCK 3.32 GALCNAVRAWPAGE 3.33 GALFNAVEPHEMERIS 3.34 GALFNAVRAWPAGE 3.35 GALINAVEPHEMERIS 3.36 GALINAVRAWWORD 3.37 GALIONO 3.38 GLMLA 3.39 GLOALMANAC 3.40 GLOCLOCK 3.41 GLOEPHEMERIS 3.42 GLORAWALM 3.43 GLORAWEPHEM 3.44 GLORAWFRAME 3.45 GLORAWSTRING 3.46 GPALM 3.47 GPGGA 3.48 GPGGALONG 3.49 GPGLL 3.50 GPGRS 3.51 GPGSA 3.52 GPGST 3.53 GPGSV 3.54 GPHDT 3.55 GPHDTDUALANTENNA 3.56 GPRMB 3.57 GPRMC 3.58 GPSCNAVRAWMESSAGE 3.59 GPSEPHEM 3.60 GPVTG 3.61 GPZDA 3.62 HEADING2 3.63 HEADINGRATE 3.64 HEADINGSATS 3.65 HWMONITOR 3.66 IONUTC 3.67 IPSTATS 3.68 IPSTATUS 3.69 ITBANDPASSBANK 3.70 ITDETECTSTATUS 3.71 ITFILTTABLE 3.72 ITPROGFILTBANK 3.73 ITPSDFINAL 3.74 J1939STATUS 3.75 LBANDBEAMTABLE 3.76 LBANDTRACKSTAT
OEM7 Commands and Logs Reference Manual v10
473 475 477 479 481 483 484 486 487 490 492 493 496 499 501 505 507 509 511 512 515 518 520 522 524 526 528 530 531 532 535 537 540 544 546 547 550 552 555 558 560 561 563 565 567 571 573 577 579 581
8
3.77 LOGLIST 3.77.1 Binary 3.77.2 ASCII
3.78 LUAFILELIST 3.79 LUAFILESYSTEMSTATUS 3.80 LUAOUTPUT 3.81 LUASTATUS 3.82 MARKPOS, MARK2POS, MARK3POS and MARK4POS 3.83 MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME 3.84 MASTERPOS 3.85 MATCHEDPOS 3.86 MATCHEDSATS 3.87 MATCHEDXYZ 3.88 MODELFEATURES 3.89 NAVICALMANAC 3.90 NAVICEPHEMERIS 3.91 NAVICIONO 3.92 NAVICRAWSUBFRAME 3.93 NAVICSYSCLOCK 3.94 NAVIGATE 3.95 NMEA Standard Logs 3.96 NOVATELXOBS 3.97 NOVATELXREF 3.98 OCEANIXINFO 3.99 OCEANIXSTATUS 3.100 PASSCOM, PASSAUX, PASSUSB, PASSETH1, PASSICOM, PASSNCOM 3.101 PASSTHROUGH 3.102 PDPDOP 3.103 PDPDOP2 3.104 PDPPOS 3.105 PDPSATS 3.106 PDPVEL 3.107 PDPXYZ 3.108 PORTSTATS 3.109 PPPPOS 3.110 PPPSATS 3.111 PROFILEINFO 3.112 PSRDOP 3.113 PSRDOP2 3.114 PSRPOS 3.115 PSRSATS 3.116 PSRVEL 3.117 PSRXYZ 3.118 QZSSALMANAC 3.119 QZSSCNAVRAWMESSAGE 3.120 QZSSEPHEMERIS 3.121 QZSSIONUTC 3.122 QZSSRAWALMANAC 3.123 QZSSRAWCNAVMESSAGE 3.124 QZSSRAWEPHEM
OEM7 Commands and Logs Reference Manual v10
584 584 585 587 589 590 592 593 596 599 601 604 606 608 611 613 616 618 619 621 624 627 628 629 631 633 638 639 641 643 645 647 648 650 652 654 656 658 660 662 664 666 668 671 673 676 679 681 683 684
9
3.125 QZSSRAWSUBFRAME 3.126 RAIMSTATUS 3.127 RANGE 3.128 RANGECMP 3.129 RANGECMP2 3.130 RANGECMP4 3.131 RANGEGPSL1 3.132 RAWALM 3.133 RAWCNAVFRAME 3.134 RAWEPHEM 3.135 RAWGPSSUBFRAME 3.136 RAWGPSWORD 3.137 RAWSBASFRAME 3.138 RAWSBASFRAME2 3.139 REFSTATION 3.140 REFSTATIONINFO 3.141 ROVERPOS 3.142 RTCMV3 Standard Logs
3.142.1 Legacy Observable Messages 3.142.2 MSM Observable Messages 3.142.3 Station and Antenna Messages 3.142.4 Ephemeris Messages 3.143 RTKASSISTSTATUS 3.144 RTKDOP 3.145 RTKDOP2 3.146 RTKPOS 3.147 RTKSATS 3.148 RTKVEL 3.149 RTKXYZ 3.150 RXCONFIG 3.151 RXSTATUS 3.152 RXSTATUSEVENT 3.153 SAFEMODESTATUS 3.154 SATVIS2 3.155 SATXYZ2 3.156 SAVEDSURVEYPOSITIONS 3.157 SBAS0 3.158 SBAS1 3.159 SBAS2 3.160 SBAS3 3.161 SBAS4 3.162 SBAS5 3.163 SBAS6 3.164 SBAS7 3.165 SBAS9 3.166 SBAS10 3.167 SBAS12 3.168 SBAS17 3.169 SBAS18 3.170 SBAS24
OEM7 Commands and Logs Reference Manual v10
685 686 689 697 702 710 723 725 727 728 730 732 733 735 737 739 741 743 743 743 745 746 748 750 752 754 757 759 761 764 766 780 782 785 788 791 793 794 795 798 800 802 804 807 810 812 814 816 818 820
10
3.171 3.172 3.173 3.174 3.175 3.176 3.177 3.178 3.179 3.180 3.181 3.182 3.183 3.184 3.185 3.186 3.187 3.188 3.189 3.190 3.191 3.192 3.193 3.194 3.195
SBAS25 SBAS26 SBAS27 SBAS32 SBAS33 SBAS34 SBAS35 SBAS45 SBASALMANAC SOFTLOADSTATUS SOURCETABLE TERRASTARINFO TERRASTARSTATUS TIME TIMESYNC TRACKSTAT TRANSFERPORTSTATUS UPTIME USERANTENNA USERI2CRESPONSE VALIDMODELS VERIPOSINFO VERIPOSSTATUS VERSION WIFIAPSETTINGS
Chapter 4 SPAN Commands
4.1 ALIGNMENTMODE 4.2 ASYNCHINSLOGGING 4.3 CONNECTIMU 4.4 EXTERNALPVAS 4.5 HEAVEFILTER 4.6 INPUTGIMBALANGLE 4.7 INSALIGNCONFIG 4.8 INSCALIBRATE 4.9 INSCOMMAND 4.10 INSSEED 4.11 INSTHRESHOLDS 4.12 INSZUPT 4.13 RELINSAUTOMATION 4.14 RELINSCONFIG 4.15 SETALIGNMENTVEL 4.16 SETHEAVEWINDOW 4.17 SETIMUPORTPROTOCOL 4.18 SETIMUSPECS 4.19 SETINITAZIMUTH 4.20 SETINSPROFILE 4.21 SETINSROTATION 4.22 SETINSTRANSLATION 4.23 SETINSUPDATE
OEM7 Commands and Logs Reference Manual v10
823 827 829 831 834 836 838 840 842 844 847 850 853 855 858 859 861 863 864 866 869 871 873 874 879
883 885 886 888 892 893 895 898 901 903 905 906 907 909 911 912 913 914 916 917 919 922 925
11
4.24 4.25 4.26 4.27 4.28 4.29 4.30
SETMAXALIGNMENTTIME SETRELINSOUTPUTFRAME SETUPSENSOR SETWHEELPARAMETERS TAGNEXTMARK TIMEDEVENTPULSE WHEELVELOCITY
Chapter 5 SPAN Logs
5.1 Logs with INS or GNSS Data 5.2 BESTGNSSPOS 5.3 BESTGNSSVEL 5.4 CORRIMUDATA 5.5 CORRIMUDATAS 5.6 DELAYEDHEAVE 5.7 GIMBALLEDPVA 5.8 HEAVE 5.9 IMURATECORRIMUS 5.10 IMURATEPVA 5.11 IMURATEPVAS 5.12 INSATT 5.13 INSATTQS 5.14 INSATTS 5.15 INSATTX 5.16 INSCALSTATUS 5.17 INSCONFIG 5.18 INSPOS 5.19 INSPOSS 5.20 INSPOSX 5.21 INSPVA 5.22 INSPVAS 5.23 INSPVAX 5.24 INSSEEDSTATUS 5.25 INSSPD 5.26 INSSPDS 5.27 INSSTDEV 5.28 INSSTDEVS 5.29 INSUPDATESTATUS 5.30 INSVEL 5.31 INSVELS 5.32 INSVELX 5.33 MARK1PVA, MARK2PVA, MARK3PVA and MARK4PVA 5.34 PASHR 5.35 RAWIMU 5.36 RAWIMUS 5.37 RAWIMUSX 5.38 RAWIMUX 5.39 RELINSPVA 5.40 SYNCHEAVE 5.41 SYNCRELINSPVA
OEM7 Commands and Logs Reference Manual v10
926 927 929 931 932 933 935
938 939 942 944 946 948 949 951 952 954 956 958 960 962 963 968 970 974 975 976 978 980 982 985 987 989 991 993 995 999 1000 1001 1003 1005 1007 1027 1031 1035 1039 1042 1043
12
5.42 TAGGEDMARK1PVA, TAGGEDMARK2PVA, TAGGEDMARK3PVA and TAGGEDMARK4PVA 5.43 TIMEDWHEELDATA 5.44 TSS1 5.45 VARIABLELEVERARM 5.46 WHEELSIZE
1046 1048 1050 1052 1053
Chapter 6 Responses
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
A.1 Reference Log Decoding A.1.1 Reference Header A.1.2 Reference Satellite and Signal Block: GPS A.1.3 Reference Measurement Block Header: GPS A.1.4 Reference Measurement Block: GPS A.1.5 Reference Primary Signal Measurement Block: GPS PRN 10 � L1CA A.1.6 Reference Secondary Signals Measurement Block: GPS PRN 10 � L2Y A.1.7 Reference Third Signals Measurement Block: GPS PRN 10 � L5Q A.1.8 Reference Satellite and Signal Block: GLONASS A.1.9 Reference Measurement Block Header: GLONASS PRN 38 A.1.10 Reference Primary Signal Measurement Block: GLONASS PRN 38 � L1CA
A.2 Differential Log Decoding A.2.1 Differential Header A.2.2 Differential Satellite and Signal Block A.2.3 Differential Measurement Block Header A.2.4 Differential Measurement Block A.2.5 Differential Primary Signal Measurement Block GPS PRN 10 � L1CA A.2.6 Differential Secondary Signals Measurement Block GPS PRN 10 � L2Y A.2.7 Differential Third Signals Measurement Block GPS PRN 10 � L5Q
1064 1065 1065 1066 1067 1068 1070 1072 1074 1076 1077
1079 1079 1080 1081 1082 1083 1085 1087
OEM7 Commands and Logs Reference Manual v10
13
Figures
Figure 1: Byte Arrangements
26
Figure 2: 1PPS Alignment
54
Figure 3: ADJUST1PPS Connections
57
Figure 4: Pulse Width and 1PPS Coherency
177
Figure 5: Illustration of Magnetic Variation and Correction
237
Figure 6: TTL Pulse Polarity
239
Figure 7: Moving Base Station `Daisy Chain' Effect
245
Figure 8: Using the SEND Command
334
Figure 9: Illustration of SETNAV Parameters
350
Figure 10: Illustration of Undulation
383
Figure 11: The WGS84 ECEF Coordinate System
454
Figure 12: Navigation Parameters
621
Figure 13: Pass Through Log Data
636
Figure 14: Channel Tracking Example
692
OEM7 Commands and Logs Reference Manual v10
14
Tables
Table 1: Field Type
25
Table 2: ASCII Message Header Structure
28
Table 3: Binary Message Header Structure
30
Table 4: Detailed Port Identifier
31
Table 5: Available Port Types
40
Table 6: Short ASCII Message Header Structure
40
Table 7: Short Binary Message Header Structure
40
Table 8: Binary Message Response Structure
42
Table 9: Binary Message Sequence
43
Table 10: PRN Numbers for Commands and Logs
44
Table 11: GPS Reference Time Status
45
Table 12: COM Port Signals Available for 1PPS
54
Table 13: ADJUST1PPS Mode
59
Table 14: User-Defined Antenna Type
66
Table 15: Channel State
70
Table 16: Channel System
72
Table 17: L-Band Assignment Option
75
Table 18: AUTH Command State
77
Table 19: Frequency Type
83
Table 20: Antenna Type
86
Table 21: Radome Type
95
Table 22: Velocity Types
99
Table 23: CAN Port Speed
100
Table 24: CAN Protocol
104
Table 25: Tx, DTR and RTS Availability
114
Table 26: GNSS Signal Default and Configurability
115
Table 27: Signal Type (DATADECODESIGNAL)
117
Table 28: Reference Ellipsoid Constants
120
Table 29: Datum Transformation Parameters
121
Table 30: Signal Type
130
Table 31: User Dynamics
135
Table 32: Communications Port Identifiers
137
Table 33: Clock Type
153
Table 34: Pre-Defined Values for Oscillators
153
Table 35: FIX Parameters
167
Table 36: Fix Types
168
Table 37: GLONASS L2 Code Type
172
Table 38: Signals Tracked � Channel Configuration and L2type Option
173
OEM7 Commands and Logs Reference Manual v10
15
Tables
Table 39: GPS L2 Code Type
174
Table 40: Signals Tracked � Channel Configuration and L2type Option
175
Table 41: FRESET Target
180
Table 42: Serial Port Interface Modes
201
Table 43: RF Path Selection
211
Table 44: Frequency Bands
214
Table 45: Mode
214
Table 46: Programmable Filter ID
216
Table 47: Programmable Filter Mode
216
Table 48: Data Sources for PSD Samples
218
Table 49: Frequency Types
219
Table 50: FFT Sizes
220
Table 51: NMEA Talkers
252
Table 52: Profile Option
284
Table 53: DGPS Type
286
Table 54: Response Modes
293
Table 55: RAIM Mode Types
295
Table 56: Network RTK Mode
309
Table 57: System Types
325
Table 58: SBAS Time Out Mode
328
Table 59: COM Port Identifiers
338
Table 60: Parity
338
Table 61: Handshaking
338
Table 62: Ports Supporting RS-422
340
Table 63: Selection Type
346
Table 64: Ionospheric Correction Models
349
Table 65: System Used for Timing
354
Table 66: Available Set Up Commands
361
Table 67: STEADYLINE Mode
366
Table 68: TRACKSV Command Condition
375
Table 69: User Accuracy Level Supplemental Position Types and NMEA Equivalents
378
Table 70: UTM Zone Commands
403
Table 71: Log Type Triggers
409
Table 72: Position Averaging Status
422
Table 73: Data Source
432
Table 74: Solution Status
436
Table 75: Position or Velocity Type
437
Table 76: GPS and GLONASS Signal-Used Mask
439
Table 77: Galileo and BeiDou Signal-Used Mask
440
Table 78: Extended Solution Status
440
OEM7 Commands and Logs Reference Manual v10
16
Tables
Table 79: Supplemental Position Types and NMEA Equivalents
441
Table 80: Observation Statuses
443
Table 81: BESTSATS GPS Signal Mask
444
Table 82: BESTSATS GLONASS Signal Mask
445
Table 83: BESTSATS Galileo Signal Mask
445
Table 84: BESTSATS BeiDou Signal Mask
445
Table 85: Definitions
454
Table 86: CHANCONFIGLIST Signal Type
458
Table 87: Clock Model Status
462
Table 88: Clock Source
464
Table 89: Steering State
465
Table 90: File Type
470
Table 91: Mass Storage Device
472
Table 92: File Status
472
Table 93: Mass Storage Status
476
Table 94: File Transfer Status
478
Table 95: Signal Type
490
Table 96: Kp UTC Leap Second Descriptions
500
Table 97: GLONASS Ephemeris Flags Coding
504
Table 98: P1 Flag Range Values
504
Table 99: GPS Quality Indicators
517
Table 100: Position Precision of NMEA Logs
521
Table 101: NMEA Positioning System Mode Indicator
534
Table 102: Signal Type
538
Table 103: URA Variance
543
Table 104: Solution Source
549
Table 105: Satellite System
553
Table 106: HWMONITOR Status Table
556
Table 107: DDC Filter Type
569
Table 108: ITFILTTable Status Word
569
Table 109: Filter Switches
570
Table 110: Spectral Analysis Status Word
575
Table 111: Node Status
578
Table 112: L-Band Signal Tracking Status
582
Table 113: File System Status
589
Table 114: Lua Data Source
591
Table 115: Script Status
592
Table 116: Feature Status
609
Table 117: Feature Type
610
Table 118: GNSS Time Scales
620
OEM7 Commands and Logs Reference Manual v10
17
Tables
Table 119: Navigation Data Type
623
Table 120: Oceanix Subscription Type
630
Table 121: Oceanix Subscription Details Mask
630
Table 122: Oceanix Region Restriction
630
Table 123: Decoder Data Synchronization State
631
Table 124: Region Restriction Status
632
Table 125: System Used for Timing
642
Table 126: Position Type
653
Table 127: Status Word
657
Table 128: System Used for Timing
661
Table 129: Signal Type
674
Table 130: RAIM Mode Types
687
Table 131: Integrity Status
688
Table 132: Protection Level Status
688
Table 133: Channel Tracking Status
692
Table 134: Tracking State
694
Table 135: Correlator Type
695
Table 136: RINEX Mappings
695
Table 137: Range Record Format (RANGECMP only)
698
Table 138: StdDev-PSR Values
700
Table 139: Satellite Block of the Range Record Format (RANGECMP2 only)
703
Table 140: Signal Block of the Range Record Format (RANGECMP2 only)
704
Table 141: Std Dev PSR Scaling
705
Table 142: Std Dev ADR Scaling
706
Table 143: L1/E1/B1 Scaling
707
Table 144: Signal Type (only in RANGECMP2)
708
Table 145: Header
712
Table 146: Satellite and Signal Block
713
Table 147: Measurement Block Header
714
Table 148: Primary Reference Signal Measurement Block
715
Table 149: Secondary Reference Signals Measurement Block
716
Table 150: Primary Differential Signal Measurement Block
717
Table 151: Secondary Differential Signals Measurement Block
718
Table 152: Signal Bit Mask
719
Table 153: Lock Time
720
Table 154: ADR Std Dev
721
Table 155: Pseudorange Std Dev
722
Table 156: Base Station Status
738
Table 157: Station Type
738
Table 158: Legacy Observable Messages
743
OEM7 Commands and Logs Reference Manual v10
18
Tables
Table 159: MSM Type Descriptions
744
Table 160: MSM Log Names
744
Table 161: MSM Message IDs
745
Table 162: Station and Antenna Messages
746
Table 163: Ephemeris Messages
746
Table 164: System Used for Timing
753
Table 165: Receiver Error
769
Table 166: Receiver Status
771
Table 167: Version Bits
773
Table 168: Auxiliary 1 Status
773
Table 169: Auxiliary 2 Status
775
Table 170: Auxiliary 3 Status
776
Table 171: Antenna Gain State
777
Table 172: Auxiliary 4 Status
778
Table 173: Status Word
781
Table 174: Event Type
781
Table 175: Safe Mode States
783
Table 176: Evaluation of UDREI
797
Table 177: Evaluation of UDREI
832
Table 178: SBAS Subsystem Types
843
Table 179: SoftLoad Status Type
844
Table 180: TerraStar Subscription Type
851
Table 181: TerraStar Subscription Details Mask
851
Table 182: TerraStar Region Restriction
852
Table 183: Decoder Data Synchronization State
854
Table 184: TerraStar Local Area Status
854
Table 185: TerraStar Geogating Status
854
Table 186: USB Detection Type
861
Table 187: USB Mode
862
Table 188: User-Defined Antenna Type
865
Table 189: Error Code
867
Table 190: Operation Mode Code
868
Table 191: Veripos Operating Mode
871
Table 192: Veripos Subscription Details Mask
872
Table 193: Decoder Data Synchronization State
873
Table 194: Component Types
876
Table 195: Firmware and Boot Version Field Formats
877
Table 196: Wi-Fi Band
880
Table 197: Wi-Fi Security Protocol
880
Table 198: Wi-Fi Encryption Type
880
OEM7 Commands and Logs Reference Manual v10
19
Tables
Table 199: Regulatory Region Table 200: IMU Type Table 201: EXTERNALPVAS Updates Mask Table 202: EXTERNALPVAS Options Mask Table 203: COM Ports Table 204: Rotational Offset Types Table 205: Translation Offset Types Table 206: Translation Input Frame Table 207: Inertial Solution Status Table 208: Extended Solution Status Table 209: Alignment Indication Table 210: NVM Seed Indication Table 211: Offset Type Table 212: Source Status Table 213: Injection Status Table 214: Validity Status Table 215: Heading Update Values Table 216: INS Update Status Table 217: iIMU-FSAS IMU Status Table 218: HG1700 IMU Status Table 219: LN200 IMU Status Table 220: ISA-100C IMU Status Table 221: IMU-CPT IMU Status Table 222: IMU-KVH1750 IMU Status Table 223: HG1900 and HG1930 IMU Status Table 224: HG4930 IMU Status Table 225: ADIS16488 and IMU-IGM-A1 IMU Status Table 226: STIM300 and IMU-IGM-S1 IMU Status Table 227: �IMU IMU Status Table 228: G320N IMU Status Table 229: Raw IMU Scale Factors Table 230: Response Messages
881 887 890 891 910 920 923 924 959 964 966 967 969 969 986 986 996 997 1009 1010 1012 1013 1014 1016 1017 1019 1020 1022 1023 1025 1029 1054
OEM7 Commands and Logs Reference Manual v10
20
Customer Support
NovAtel Knowledge Base
If you have a technical issue, visit the NovAtel Support page at www.novatel.com/support. Through the Support page, you can contact Customer Support, find papers and tutorials or download current manuals and the latest firmware.
Before Contacting Customer Support
Before contacting NovAtel Customer Support about a software problem, perform the following steps:
If logging data over an RS-232 serial cable, ensure that the configured baud rate can support the data bandwidth (see SERIALCONFIG command). NovAtel recommends a minimum suggested baud rate of 230400 bps.
1. Log the following data to a file on your computer for 15 minutes: RXSTATUSB onchanged RAWEPHEMB onchanged GLORAWEPHEMB onchanged BESTPOSB ontime 1 RANGEB ontime 1 RXCONFIGA once VERSIONA once PORTSTATS ontime 10
For SPAN systems, add the following logs to the above list in the file created on your computer:
RAWIMUSXB onnew INSUPDATESTATUSB onnew INSPVAXB ontime 1 INSCONFIGA once 2. Send the data file to NovAtel Customer Support: support@novatel.com 3. You can also issue a FRESET command to the receiver to clear any unknown settings.
The FRESET command will erase all user settings. You should know your configuration (by requesting the RXCONFIGA log) and be able to reconfigure the receiver before you send the FRESET command.
If you are having a hardware problem, send a list of the troubleshooting steps taken and the results.
Contact Information
Log a support request with NovAtel Customer Support using one of the following methods:
OEM7 Commands and Logs Reference Manual v10
21
Customer Support
Log a Case and Search Knowledge: Website: www.novatel.com/support
Log a Case, Search Knowledge and View Your Case History: (login access required) Web Portal: https://novatelsupport.force.com/community/login
E-mail: support@novatel.com
Telephone: U.S. and Canada: 1-800-NOVATEL (1-800-668-2835) International: +1-403-295-4900
OEM7 Commands and Logs Reference Manual v10
22
Foreword
This manual describes each command and log the OEM7 family of receivers are capable of accepting or generating. Sufficient detail is provided so you can understand the purpose, syntax and structure of each command or log. You will also be able to communicate with the receiver, enabling you to effectively use and write custom interfacing software for specific applications.
Related Documents and Information
OEM7 products include the following:
l Satellite Based Augmentation System (SBAS) signal functionality l Support for all current and upcoming GNSS constellations l L-Band capability including TerraStar licensed based corrections l National Marine Electronics Association (NMEA) standards, a protocol used by GNSS receiv-
ers to transmit data l Differential Global Positioning System (DGPS) l Real-Time Kinematic (RTK)
For more information on these components, refer the Support page on our website at www.novatel.com/support. For introductory information on GNSS technology, refer to our An Introduction to GNSS book found at www.novatel.com/an-introduction-to-gnss/.
This manual does not address any of the receiver hardware attributes or installation information. Consult the OEM7 Installation and Operation User Manual for information about these topics. Furthermore, should you encounter any functional, operational or interfacing difficulties with the receiver, refer to the NovAtel web site for warranty and support information.
Prerequisites
As this reference manual is focused on the OEM7 family commands and logging protocol, it is necessary to ensure the receiver has been properly installed and powered up according to the instructions outlined in the companion OEM7 Installation and Operation User Manual or OEM7 receivers.
Logs and Commands Defaults and Structure
l The factory defaults for commands and logs are shown after the syntax but before the example in the command or log description.
l The letter H in the Binary Byte or Binary Offset columns of the commands and logs tables represents the header length for that command or log, see Binary on page 29.
l The number following 0x is a hexadecimal number. l Default values shown in command tables indicate the assumed values when optional para-
meters have been omitted. Default values do not imply the factory default settings. l Parameters surrounded by [ and ] are optional in a command or are required for only some
instances of the command depending on the values of other parameters. l Text displayed between < and > indicates the entry of a keystroke in the case of the com-
mand or an automatic entry in the case of carriage return <CR> and line feed <LF> in data output. l In tables where no values are given they are assumed to be reserved for future use. l Status words in ASCII logs are output as hexadecimal numbers and must be converted to binary format (and in some cases then also to decimal) to parse the fields because they are not
OEM7 Commands and Logs Reference Manual v10
23
Foreword
fixed in 4-bits boundary. For an example of this type of conversion, see the RANGE log, Table 133: Channel Tracking Status on page 692. l Conversions and their binary or decimal results are always read from right to left. For a complete list of hexadecimal, binary and decimal equivalents, refer to the Unit Conversion information available on our website at www.novatel.com/support/search/. l ASCII log examples may be split over several lines for readability. In reality, only a single [CR][LF] pair is transmitted at the end of an ASCII log.
You can download the most up-to-date version of this manual along with any addenda from the Support section of the NovAtel website.
OEM7 Commands and Logs Reference Manual v10
24
Chapter 1 Messages
The receiver handles incoming and outgoing NovAtel data in three different message formats: Abbreviated ASCII, ASCII and Binary. This allows for a great deal of versatility in the way the OEM7 family of receivers can be used. All NovAtel commands and logs can be entered, transmitted, output or received in any of the three formats. The receiver also supports RTCMV3, NOVATELX and NMEA format messaging.
When entering an ASCII or abbreviated ASCII command to request an output log, the message type is indicated by the character appended to the end of the message name. `A' indicates the message is ASCII and `B' indicates binary. No character means the message is Abbreviated ASCII. When issuing binary commands, the output message type is dependent on the bit format in the message's binary header (refer to Binary on page 29).
Table 1: Field Type below below, describes the field types used in the description of messages.
Table 1: Field Type
Type
Binary Size
(bytes)
Description
Char
The char type is an 8-bit integer in the range -128 to +127. As a binary value,
1
a two's compliment format is used. This integer value may be the ASCII code corresponding to the specified character. In ASCII or Abbreviated ASCII this
comes out as an actual character
UChar
1
The uchar type is an 8-bit unsigned integer. Values are in the range from +0 to +255. In ASCII or Abbreviated ASCII this comes out as a number
Short
2
The short type is 16-bit integer in the range -32768 to +32767. As a binary value, a two's compliment format is used.
UShort
2
The same as short except it is not signed. Values are in the range from +0 to +65535
Long
4
The long type is 32-bit integer in the range -2147483648 to +2147483647. As a binary value, a two's compliment format is used.
ULong
4
The same as long except it is not signed. Values are in the range from +0 to +4294967295
The double type contains 64-bits: 1 for sign, 11 for the exponent and 52 for the
Double
8
mantissa. Its range is �1.7E308 with at least 15 digits of precision. This is IEEE
754
Float
The float type contains 32-bits: 1 for the sign, 8 for the exponent and 23 for
4
the mantissa. Its range is �3.4E38 with at least 7 digits of precision. This is
IEEE 754
Enum
A 4-byte enumerated type beginning at zero (an unsigned long). In binary, the
4
enumerated value is output. In ASCII or Abbreviated ASCII, the enumeration
label is spelled out
OEM7 Commands and Logs Reference Manual v10
25
Chapter 1 Messages
Type
Binary Size
(bytes)
Description
GPSec
This type has two separate formats dependent on whether you requested a
4
binary or an ASCII format output. For binary, the output is in milliseconds and
is a long type. For ASCII, the output is in seconds and is a float type
Hex
n
Hex is a packed, fixed length (n) array of bytes in binary but in ASCII or Abbreviated ASCII is converted into 2 character hexadecimal pairs
Hex Ulong
4
An unsigned, 32-bit integer in hexadecimal format. Values are in the range from +0 to +4294967295
String
String is a variable length array of bytes that is null-terminated in the binary
n
case and additional bytes of padding are added to maintain 4-byte alignment. The maximum byte length for each String field is shown in the row in the log or
command tables
Figure 1: Byte Arrangements
Byte Arrangements above shows the arrangement of bytes, within each field type, when used by IBM PC computers. All data sent to or from the OEM7 family of receivers is ordered least significant bit (LSB) first (little-endian). This is opposite to the most significant bit first (big-endian) ordering that is shown in Byte Arrangements above. Data is then stored in the receiver LSB first. For example, in char type data, the LSB is bit 0 and the most significant bit (MSB) is bit 7. See Table 133: Channel Tracking Status on page 692 for a more detailed example.
OEM7 Commands and Logs Reference Manual v10
26
Chapter 1 Messages
1.1 ASCII
ASCII messages are readable by both the user and a computer. The structures of all ASCII messages follow the general conventions as noted here: 1. The lead code identifier for each record is '#'. 2. Each log or command is of variable length depending on amount of data and formats. 3. All data fields are delimited by a comma ',' with two exceptions:
l The first exception is the last header field which is followed by a `;' to denote the start of the data message.
l The second exception is the last data field, which is followed by a * to indicate end of message data.
4. Each log ends with a hexadecimal number preceded by an asterisk and followed by a line termination using the carriage return and line feed characters. For example: *1234ABCD[CR][LF]. This value is a 32-bit CRC of all bytes in the log, excluding the '#' identifier and the asterisk preceding the eight CRC digits. See 32-Bit CRC on page 47 for the algorithm used to generate the CRC.
5. The receiver only accepts the following ASCII characters. l characters between space (ASCII value 32) and '~' (ASCII value 126) inclusive, l vertical tab (ASCII value 9) l line feed (ASCII value 10) l horizontal tab (ASCII value 11) l carriage return (ASCII value 13)
Other values are discarded and can lead to unexpected results. 6. An ASCII string is one field and is surrounded by double quotation marks.
For example: "ASCII string". If separators are surrounded by quotation marks then the string is still one field and the separator will be ignored (example, "xxx,xxx" is one field). Double quotation marks within a string are not allowed. 7. If the receiver detects an error parsing an input message, it returns an error response message. See Responses on page 1054 for a list of response messages from the receiver.
Message Structure:
header; data field..., data field..., data field... *xxxxxxxx [CR][LF]
The ASCII message header structure is described in Table 2: ASCII Message Header Structure on the next page.
OEM7 Commands and Logs Reference Manual v10
27
Chapter 1 Messages
Table 2: ASCII Message Header Structure
Field
Field Name
Field Type
Description
Ignored on
Input
1 Sync
Char
Sync character. The ASCII message is always preceded by a single `#' symbol
N
2 Message Char The ASCII name of the log or command
N
The name of the port from which the log was generated.
The string is made up of the port name followed by an _x
3 Port
Char where x is a number from 1 to 31 denoting the virtual
Y
address of the port. If no virtual address is indicated, it is
assumed to be address 0
Used for multiple related logs. It is a number that counts
4
Sequence #
Long
down from N-1 to 0, where 0 means it is the last one of the set. Most logs only come out one at a time in which case
N
this number is 0
5
% Idle Time
Float
The minimum percentage of time the processor is idle, calculated once per second
Y
6
Time Status
Enum
The value indicates the quality of the GPS reference time (see Table 11: GPS Reference Time Status on page 45)
Y
7 Week
Ulong GPS reference week number
Y
8
Seconds
GPSec
Seconds from the beginning of the GPS reference week; accurate to the millisecond level
Y
9
Receiver Status
Ulong
An eight digit hexadecimal number representing the status of various hardware and software components of the receiver (see Table 166: Receiver Status on page 771)
Y
10 Reserved Ulong Reserved for internal use.
Y
11
Receiver S/W Version
Ulong
A value (0 - 65535) representing the receiver software build number
Y
12 ;
Char The character indicates the end of the header
N
Example Log:
#RAWEPHEMA,COM1,0,35.0,SATTIME,1364,496230.000,02100000,97b7,2310;30,1364, 496800,8b0550a1892755100275e6a09382232523a9dc04ee6f794a0000090394ee, 8b0550a189aa6ff925386228f97eabf9c8047e34a70ec5a10e486e794a7a, 8b0550a18a2effc2f80061c2fffc267cd09f1d5034d3537affa28b6ff0eb*7a22f279
OEM7 Commands and Logs Reference Manual v10
28
Chapter 1 Messages
1.2 Abbreviated ASCII
This message format is designed to make entering and viewing commands and logs simple. The data is represented as simple ASCII characters, separated by spaces or commas and arranged in an easy to understand format. There is no 32-bit CRC for error detection because it is meant for viewing by the user.
Example Command: log com1 loglist
Resultant Log: <LOGLIST COM1 0 69.0 FINE 0 0.000 00240000 206d 0 <4 < COM1 RXSTATUSEVENTA ONNEW 0.000000 0.000000 NOHOLD < COM2 RXSTATUSEVENTA ONNEW 0.000000 0.000000 NOHOLD < COM3 RXSTATUSEVENTA ONNEW 0.000000 0.000000 NOHOLD < COM1 LOGLIST ONCE 0.000000 0.000000 NOHOLD
The array of 4 entries are offset from the left hand side and start with `<'.
1.3 Binary
Binary messages are strictly machine readable format. They are ideal for applications where the amount of data transmitted is fairly high. Due to the inherent compactness of binary as opposed to ASCII data, messages are much smaller. The smaller message size allows a larger amount of data to be transmitted and received by the receiver's communication ports. The structure of all binary messages follows the general conventions as noted here: 1. Basic format of:
l Header: 3 Sync bytes plus 25-bytes of header information. The header length is variable as fields may be appended in the future. Always check the header length.
l CRC: 4 bytes l Data: variable 2. The 3 Sync bytes will always be:
Byte Hex Decimal
First AA 170
Second 44 68
Third 12 18
3. The CRC is a 32-bit CRC (see 32-Bit CRC on page 47 for the CRC algorithm) performed on all data including the header.
4. The header is in the format shown in Table 3: Binary Message Header Structure on the next page.
OEM7 Commands and Logs Reference Manual v10
29
Chapter 1 Messages
Field
Field Name
1 Sync
2 Sync
3 Sync
4
Header Lgth
5
Message ID
6
Message Type
7
Port Address
8
Message Length
Table 3: Binary Message Header Structure
Field Type
Description
Binary Bytes
Binary Offset
Ignored on
Input
Char Hexadecimal 0xAA
1
0
N
Char Hexadecimal 0x44
1
1
N
Char Hexadecimal 0x12
1
2
N
Uchar Length of the header
1
3
N
This is the Message ID number of the
Ushort
log (see the command or log descriptions for the Message ID values
2
4
N
of individual commands or logs)
Bits 0-4 = Measurement source1
Bits 5-6 = Format
00 = Binary
01 = ASCII
Char
10 = Abbreviated ASCII, NMEA
1
6
N
11 = Reserved
Bit 7 = Response bit (see Message Responses on page 41)
0 = Original Message
1 = Response Message
See Table 4: Detailed Port Identifier on
Uchar the next page (decimal values >=32
1
7
N3
may be used) (lower 8-bits only) 2
The length in bytes of the body of the
Ushort message, not including the header nor
2
8
N
the CRC
1Bits 0-4 are used to indicate the measurement source. For dual antenna receivers, if bit 0 is set, the log is from
the secondary antenna. 2The 8-bit size means you will only see 0xA0 to 0xBF when the top bits are dropped from a port value greater than
8-bits. For example, ASCII port USB1 will be seen as 0xA0 in the binary output. 3Recommended value is THISPORT (decimal 192).
OEM7 Commands and Logs Reference Manual v10
30
Chapter 1 Messages
Field
Field Name
Field Type
Description
Binary Bytes
Binary Offset
Ignored on
Input
Used for multiple related logs. It is a
number that counts down from N-1 to 0
9
Sequence
Ushort
where N is the number of related logs and 0 means it is the last one of the set.
2
10
N
Most logs only come out one at a time
in which case this number is 0
Time the processor is idle, calculated
once per second. This value is a
percentage, ranging from 0 to 100. 0%
10 Idle Time Uchar indicates the processor is fully
1
12
Y
occupied. Other values indicate the
availability of the processor to take on
tasks.
11
Time Status
Enum
Indicates the quality of the GPS reference time (see Table 11: GPS Reference Time Status on page 45).
11
13
N2
12 Week
Ushort GPS reference week number
2
14
N
13 ms
GPSec
Milliseconds from the beginning of the GPS reference week
4
16
N
32-bits representing the status of
14
Receiver Status
Ulong
various hardware and software components of the receiver (see Table
4
20
Y
166: Receiver Status on page 771)
15 Reserved Ushort Reserved for internal use
2
24
Y
16
Receiver S/W Version
Ushort
A value (0 - 65535) representing the receiver software build number
2
26
Y
ASCII Port Name
NO_PORTS
COM1_ALL
Table 4: Detailed Port Identifier
Hex Port Value
Decimal Port Value
Description
0
0
No ports specified
1
1
All virtual ports for COM1
1This ENUM is not 4-bytes long but, as indicated in the table, is only 1-byte. 2Fields 12 and 13 (Week and ms) are ignored if Field 11 (Time Status) is invalid. In this case, the current receiver time is used. The recommended values for the three time fields are 0, 0, 0.
OEM7 Commands and Logs Reference Manual v10
31
Chapter 1 Messages
ASCII Port Name
COM2_ALL COM3_ALL THISPORT_ALL FILE_ALL ALL_PORTS USB1_ALL USB2_ALL USB3_ALL AUX_ALL COM4_ALL ETH1_ALL IMU_ALL ICOM1_ALL ICOM2_ALL ICOM3_ALL NCOM1_ALL NCOM2_ALL NCOM3_ALL ICOM4_ALL WCOM1_ALL COM1 COM1_1 ... COM1_31 COM2 COM2_1 ...
Hex Port Value 2 3 6 7 8 d e f 10 13 14 15 17 18 19 1a 1b 1c 1d 1e 20 21
3f 40 41
Decimal Port Value 2 3 6 7 8 13 14 15 16 19 20 21 23 24 25 26 27 28 29 30 32 33
Description
All virtual ports for COM2 All virtual ports for COM3 All virtual ports for the current port All virtual ports for logging to file All virtual ports for all ports All virtual ports for USB1 All virtual ports for USB2 All virtual ports for USB3 All virtual ports for the AUX All virtual ports for COM4 All virtual ports for ETH1 All virtual ports for IMU All virtual ports for ICOM1 All virtual ports for ICOM2 All virtual ports for ICOM3 All virtual ports for NCOM1 All virtual ports for NCOM2 All virtual ports for NCOM3 All virtual ports for ICOM4 All virtual ports for WCOM1 COM1, virtual port 0 COM1, virtual port 1
63
COM1, virtual port 31
64
COM2, virtual port 0
65
COM1, virtual port 1
OEM7 Commands and Logs Reference Manual v10
32
Chapter 1 Messages
ASCII Port Name
COM2_31 COM3 COM3_1 ... COM3_31 SPECIAL SPECIAL_1 ... SPECIAL_31 THISPORT THISPORT_1 ... THISPORT_31 FILE FILE_1 ... FILE_31 USB1 USB1_1 ... USB1_31 USB2 USB2_1 ... USB2_31 USB3 USB3_1
Hex Port Value 5f 60 61
7f a0 a1
bf c0 c1
df e0 e1
ff 5a0 5a1
5bf 6a0 6a1
6bf 7a0 7a1
Decimal Port Value 95 96 97
Description
COM2, virtual port 31 COM3, virtual port 0 COM3, virtual port 1
127
COM3, virtual port 31
160
Unknown port, virtual port 0
161
Unknown port, virtual port1
191
Unknown port, virtual port 31
192
Current COM port, virtual port 0
193
Current COM port, virtual port 1
223
Current COM port, virtual port 31
224
Virtual port 0 for logging to file
225
Virtual port 1 for logging to file
255 1440 1441
Virtual port 31 for logging to file USB1, virtual port 0 USB1, virtual port 1
1471 1696 1967
USB1, virtual port 31 USB2, virtual port 0 USB2, virtual port 1
1727 1952 1953
USB2, virtual port 31 USB3, virtual port 0 USB3, virtual port 1
OEM7 Commands and Logs Reference Manual v10
33
Chapter 1 Messages
ASCII Port Name
... USB3_31 AUX AUX_1 ... AUX_31 COM4 COM4_1 ... COM4_31 ETH1 ETH1_1 ... ETH1_31 IMU IMU_1 ... IMU_31 ICOM1 ICOM1_1 ... ICOM1_31 ICOM2 ICOM2_1 ... ICOM2_31 ICOM3
Hex Port Value
7bf 8a0 8a1
8bf ba0 ba1
bbf ca0 ca1
cbf da0 da1
dbf fa0 fa1
fbf 10a0 10a1
10bf 11a0
Decimal Port Value
Description
1983 2208 2209
USB port 3, virtual port 31 AUX port, virtual port 0 AUX port, virtual port 1
2239 2976 2977
AUX port, virtual port 31 COM4, virtual port 0 COM4, virtual port 1
3007 3232 3233
COM4, virtual port 31 ETH1, virtual port 0 ETH1, virtual port 1
3263 3488 3489
ETH1, virtual port 31 IMU, virtual port 0 IMU, virtual port 1
3519 4000 4001
IMU, virtual port 31 ICOM1, virtual port 0 ICOM1, virtual port 1
4031 4256 4257
ICOM1, virtual port 31 ICOM2, virtual port 0 ICOM2, virtual port 1
4287 4512
ICOM2, virtual port 31 ICOM3, virtual port 0
OEM7 Commands and Logs Reference Manual v10
34
Chapter 1 Messages
ASCII Port Name
ICOM3_1 ... ICOM3_31 NCOM1 NCOM1_1 ... NCOM1_31 NCOM2 NCOM2_1 ... NCOM2_31 NCOM3 NCOM3_1 ... NCOM3_31 ICOM4 ICOM4_1 ... ICOM4_31 WCOM1 WCOM1_1 ... WCOM1_31 COM5_ALL COM6_ALL
BT1_ALL
Hex Port Value 11a1
11bf 12a0 12a1
12bf 13a0 13a1
13bf 14a0 14a1
14bf 15a0 15a1
15bf 16a0 16a1
16bf 16c0 16c1 16c2
Decimal Port Value
4513
Description ICOM3, virtual port 1
4543 4768 4769
ICOM3, virtual port 31 NCOM1, virtual port 0 NCOM1, virtual port 1
4799 5024 5025
NCOM1, virtual port 31 NCOM2, virtual port 0 NCOM2, virtual port 1
5055 5280 5281
NCOM2, virtual port 31 NCOM3, virtual port 0 NCOM3, virtual port 1
5311 5536 5537
NCOM3, virtual port 31 ICOM4, virtual port 0 ICOM4, virtual port 1
5567 5792 5793
ICOM4, virtual port 31 WCOM1, virtual port 0 WCOM1, virtual port 1
5823 5824 5825
5826
WCOM1, virtual port 31 All virtual ports for COM5 All virtual ports for COM6 All virtual ports for the Bluetooth device
OEM7 Commands and Logs Reference Manual v10
35
Chapter 1 Messages
ASCII Port Name
COM7_ALL COM8_ALL COM9_ALL COM10_ALL CCOM1_ALL CCOM2_ALL CCOM3_ALL CCOM4_ALL CCOM5_ALL CCOM6_ALL ICOM5_ALL ICOM6_ALL ICOM7_ALL SCOM1_ALL SCOM2_ALL SCOM3_ALL SCOM4_ALL COM5 COM5_1 ... COM5_31 COM6 COM6_1 ... COM6_31 BT1 BT1_1
Hex Port Value 16c3 16c4 16c5 16c6 16c7 16c8 16c9 16ca 16cb 16cc 16cf 16d0 16d1 16d2 16d3 16d4 16d5 17a0 17a1
17bf 18a0 18a1
18bf 19a0 19a1
Decimal Port Value 5827 5828 5829 5830 5831 5832 5833 5834 5835 5836 5839 5840 5841 5842 5843 5844 5845 6048 6049
Description
All virtual ports for COM7 All virtual ports for COM8 All virtual ports for COM9 All virtual ports for COM10 All virtual ports for CCOM1 All virtual ports for CCOM2 All virtual ports for CCOM3 All virtual ports for CCOM4 All virtual ports for CCOM5 All virtual ports for CCOM6 All virtual ports for ICOM5 All virtual ports for ICOM6 All virtual ports for ICOM7 All virtual ports for SCOM1 All virtual ports for SCOM2 All virtual ports for SCOM3 All virtual ports for SCOM4 COM5, virtual port 0 COM5, virtual port 1
6079 6304 6305
COM5, virtual port 31 COM6, virtual port 0 COM6, virtual port 1
6335 6560 6561
COM6, virtual port 31 Bluetooth device, virtual port 0 Bluetooth device, virtual port 1
OEM7 Commands and Logs Reference Manual v10
36
Chapter 1 Messages
ASCII Port Name
... BT1_31 COM7 COM7_1 ... COM7_31 COM8 COM8_1 ... COM8_31 COM9 COM9_1 ... COM9_31 COM10 COM10_1 ... COM10_31 CCOM1 CCOM1_1 ... CCOM1_31 CCOM2 CCOM2_1 ... CCOM2_31 CCOM3
Hex Port Value
19bf 1aa0 1aa1
1abf 1ba0 1ba1
1bbf 1ca0 1ca1
1cbf 1da0 1da1
1dbf 1ea0 1ea1
1ebf 1fa0 1fa1
1fbf 20a0
Decimal Port Value
Description
6591 6816 6817
Bluetooth device, virtual port 31 COM7, virtual port 0 COM7, virtual port 1
6847 7072 7073
COM7, virtual port 31 COM8, virtual port 0 COM8, virtual port 1
7103 7328 7329
COM8, virtual port 31 COM9, virtual port 0 COM9, virtual port 1
7359 7584 7585
COM9, virtual port 31 COM10, virtual port 0 COM10, virtual port 1
7615 7840 7841
COM10, virtual port 31 CAN COM1, virtual port 0 CAN COM1, virtual port 1
7871 8096 8097
CAN COM1, virtual port 31 CAN COM2, virtual port 0 CAN COM2, virtual port 1
8127 8352
CAN COM2, virtual port 31 CAN COM3, virtual port 0
OEM7 Commands and Logs Reference Manual v10
37
Chapter 1 Messages
ASCII Port Name
CCOM3_1 ... CCOM3_31 CCOM4 CCOM4_1 ... CCOM4_31 CCOM5 CCOM5_1 ... CCOM5_31 CCOM6 CCOM6_1 ... CCOM6_31 ICOM5 ICOM5_1 ... ICOM5_31 ICOM6 ICOM6_1 ... ICOM6_31 ICOM7 ICOM7_1 ... ICOM7_31
Hex Port Value 20a1
20bf 21a0 21a1
21bf 22a0 22a1
22bf 23a0 23a1
23bf 26a0 26a1
26bf 27a0 27a1
27bf 28a0 28a1
28bf
Decimal Port Value
8353
Description CAN COM3, virtual port 1
8383 8608 8609
CAN COM3, virtual port 31 CAN COM4, virtual port 0 CAN COM4, virtual port 1
8639 8864 8865
CAN COM4, virtual port 31 CAN COM5, virtual port 0 CAN COM5, virtual port 1
8895 9120 9121
CAN COM5, virtual port 31 CAN COM6, virtual port 0 CAN COM6, virtual port 1
9151 9888 9889
CAN COM6, virtual port 31 ICOM5, virtual port 0 ICOM5, virtual port 1
9919 10144 10145
ICOM5, virtual port 31 ICOM6, virtual port 0 ICOM6, virtual port 1
10175 10400 10401
ICOM6, virtual port 31 ICOM7, virtual port 0 ICOM7, virtual port 1
10431
ICOM7, virtual port 31
OEM7 Commands and Logs Reference Manual v10
38
Chapter 1 Messages
ASCII Port Name
SCOM1 SCOM1_1 ... SCOM1-31 SCOM2 SCOM2_1 ... SCOM2_31 SCOM3 SCOM3_1 ... SCOM3_31 SCOM4 SCOM4_1 ... SCOM4_31
Hex Port Value 29a0 29a1
29bf 2aa0 2aa1
2abf 2ba0 2ba1
2bbf 2ca0 2ca1
2cbf
Decimal Port Value
10656
10657
Description SCOM1, virtual port 0 SCOM1, virtual port 1
10687 10912 10913
SCOM1, virtual port 31 SCOM2, virtual port 0 SCOM2, virtual port 1
10943 11168 11169
SCOM2, virtual port 31 SCOM3, virtual port 0 SCOM3, virtual port 1
11199 11424 11425
SCOM3, virtual port 31 SCOM4, virtual port 0 SCOM4, virtual port 1
11455
SCOM4, virtual port 31
COM1_ALL, COM2_ALL, COM3_ALL, COM4_ALL, COM5_ALL, THISPORT_ALL, FILE_ALL, ALL_PORTS, USB1_ALL, USB2_ALL, USB3_ALL, AUX_ALL, ETH1_ALL, ICOM1_ALL, ICOM2_ALL, ICOM3_ALL, ICOM4_ALL, ICOM5_ALL, ICOM6_ALL, ICOM7_ALL, CCOM1_ALL, CCOM2_ALL, CCOM3_ALL, CCOM4_ALL, CCOM5_ALL, CCOM6_ALL, NCOM1_ALL, NCOM2_ ALL, NCOM3_ALL, SCOM1_ALL, SCOM2_ALL, SCOM3_ALL, SCOM4_ALL and WCOM1_ALL are only valid for the UNLOGALL command.
The ports available vary based on the receiver.
Table 5: Available Port Types on the next page provides examples of where each port type might be used.
OEM7 Commands and Logs Reference Manual v10
39
Chapter 1 Messages
Table 5: Available Port Types
Port Type
Description
Example of where it might be used
AUX
Auxiliary "serial" ports
An additional UART serial port available only on certain platforms
BTx
Bluetooth ports
These ports are used to connect over Bluetooth devices, when the receiver is equipped with a BT device
COMx Serial Port
UART serial ports. Used when there is a physical RS-232 or RS-422 connection to the receiver
ICOMx
Internet ports
These ports are used when establishing TCP or UDP connections to the receiver over a network
NCOMx NTRIP ports
These ports are used when establishing NTRIP connections to the receiver over a network
SCOMx Script ports
Ports used by the Scripted User Interface (i.e. Lua)
USBx
USB "serial" ports
When the receiver is connected to an external host through USB, these ports are available
WCOMx
Web Server port
Ports used by Web Server applications, for receivers equipped with a web server
1.4 Description of ASCII and Binary Logs with Short Headers
These logs are set up in the same way as normal ASCII or binary logs except a normal ASCII or binary header is replaced with a short header (see Table 6: Short ASCII Message Header Structure below and Table 7: Short Binary Message Header Structure below).
Table 6: Short ASCII Message Header Structure
Field Field Name
Field Type
Description
1
%
Char
% symbol
2
Message
Char
This is the name of the log
3
Week Number Ushort
GNSS week number
4
Seconds
GPSec
Seconds from the beginning of the GNSS week (Same byte arrangement as a Float type)
Field
Field Name
1
Synch
Table 7: Short Binary Message Header Structure
Field Type
Description
Binary Bytes
Char
Hex 0xAA
1
Binary Offset
0
OEM7 Commands and Logs Reference Manual v10
40
Chapter 1 Messages
Field
Field Name
Field Type
2
Synch
Char
3
Synch
Char
4
Message Length
Uchar
5
Message ID Ushort
6
Week Number
Ushort
7
Milliseconds GPSec
Description
Hex 0x44 Hex 0x13 Message length, not including header or CRC Message ID number
Binary Bytes 1 1
1
2
GNSS week number
2
Milliseconds from the beginning of the
GNSS week (Same byte arrangement as a Long
4
type)
Binary Offset 1 2 3 4 6
8
1.5 Message Responses
By default, if you input a message you get back a response. If desired, the INTERFACEMODE command (see page 198) 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).
1.5.1 Abbreviated ASCII Response
Just the leading '<' followed by the response string, for example: <OK.
1.5.2 ASCII Response
Full header with the message name being identical except ending in an 'R' (for response). The body of the message consists of a 40 character string for the response string. For example:
#BESTPOSR,COM1,0,67.0,FINE,1028,422060.400,02000000,a31b,0;"OK" *b867caad
1.5.3 Binary Response
Similar to an ASCII response except that it follows the binary protocols, see Table 8: Binary Message Response Structure on the next page. Table 9: Binary Message Sequence on page 43 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.
OEM7 Commands and Logs Reference Manual v10
41
Chapter 1 Messages
Table 8: Binary Message Response Structure
Field
Field Name
Field Type
Description
Binary Binary Bytes Offset
1 Sync
Char Hexadecimal 0xAA
1
0
2 Sync
Char Hexadecimal 0x44
1
1
3 Sync
Char Hexadecimal 0x12
1
2
4
Header Lgth
Uchar Length of the header
1
3
5
Message ID
Ushort Message ID number
2
4
B I
6
Message Type
Char
Bit 7 = Response Bit 1 = Response Message
1
6
N
A R
7
Port Address
Uchar
See Table 4: Detailed Port Identifier on page 31
1
7
Y
8
Message Length
Ushort
The length in bytes of the body of the message (not including the CRC)
2
8
H 9 Sequence Ushort Normally 0 E A 10 Idle Time Uchar Idle time
D E R
11
Time Status
Enum
Table 11: GPS Reference Time Status on page 45
12 Week
Ushort GPS reference week number
2
10
1
12
11
13
2
14
13 ms
GPSec Milliseconds into GPS reference week
4
16
14
Receiver Status
Ulong
Table 166: Receiver Status on page 771
4
20
15 Reserved Ushort Reserved
2
24
Receiver
16 S/W
Ushort Receiver software build number
Version
2
26
I D
17
Response ID
Enum
The enumeration value corresponding to the message response (Table 230: Response Messages on page 1054)
4
28
H E 18 Response Hex X
String containing the ASCII response in hex coding to match the ID above (for example, 0x4F4B = OK)
variable 32
1This ENUM is not 4-bytes long but as indicated in the table is only 1 byte.
OEM7 Commands and Logs Reference Manual v10
42
Chapter 1 Messages
Table 9: Binary Message Sequence
Direction Sequence
Data
To Receiver
LOG Command Header
AA44121C 01000240 20000000 1D1D0000 29160000 00004C00 55525A80
LOG
20000000 2A000000 02000000 00000000 0000F03F 00000000 00000000
Parameters 00000000
Checksum 2304B3F1
From Receiver
LOG Response Header
LOG Response Data
AA44121C 01008220 06000000 FFB4EE04 605A0513 00004C00 FFFF5A80 01000000 4F4B
Checksum DA8688EC
BESTPOSB AA44121C 2A000220 48000000 90B49305 B0ABB912 00000000
Header
4561BC0A
From Receiver
BESTPOSB Data
00000000 10000000 1B0450B3 F28E4940 16FA6BBE 7C825CC0 0060769F 449F9040 A62A82C1 3D000000 125ACB3F CD9E983F DB664040 00303030 00000000 00000000 0B0B0000 00060003
Checksum 42DC4C48
1.6 GLONASS Slot and Frequency Numbers
When a PRN in a log is in the range 38 to 61, then that PRN represents a GLONASS Slot Number where the Slot Number shown is the actual GLONASS Slot Number plus 37.
Similarly, the GLONASS Frequency shown in logs is the actual GLONASS Frequency plus 7.
For example:
<RANGE COM1 0 82.0 FINESTEERING 1729 155076.000 02004000 5103 11465 46 31 0 24514687.250 0.064 -128825561.494675 0.010 3877.473 45.0 563.310 18109c04 ... 46 5 24097664.754 0.213 -128680178.570435 0.014 -3740.543 40.6 10098.600 08119e44 ''' 8 0 39844800.076 0.043 -160438471.200694 0.013 -392.547 42.5 12038.660 00349c84
when 31 is a GPS satellite, 8 is a BeiDou satellite and 46 is a GLONASS satellite. Its actual GLONASS Slot Number is 9 and its frequency is -2.
OEM7 Commands and Logs Reference Manual v10
43
Chapter 1 Messages
Refer to PRN Numbers below for more information about GLONASS PRN numbers. Also, refer to An Introduction to GNSS available on our website for more information.
1.6.1 PRN Numbers
The PRN and SVID ranges for the logs and commands that use them are shown in the following table.
Table 10: PRN Numbers for Commands and Logs
Command/Log
GPS PRN
SBAS PRN
SBAS QZSS L1-SAIF PRN
GLONASS Slot
Galileo SVID
QZSS PRN
ASSIGN
1-32
120158
183-192 38-61
1-36
193202
ASSIGNALL
1-32
120158
183-192 38-61
1-36
193202
LOCKOUT
1-32
120158
183-192 38-61
-
193202
SBASCONTROL -
120158
183-192 -
-
-
TRACKSV
1-32
120158
183-192 38-61
1-36
193202
UNLOCKOUT
1-32
120158
183-192 38-61
-
193202
RANGE
1-32
120158
183-192 38-61
1-36
193202
RANGECMP
1-32
120158
183-192 38-61
1-36
193202
RANGECMP2
1-32
120158
183-192 1-24
1-36
193202
RANGECMP4
1-32
120158
183-192 1-24
1-36
193202
RANGEGPSL1 1-32 -
-
-
-
-
SATVIS2
1-32
120158
183-192 1-24
1-36
193202
TRACKSTAT
1-32
120158
183-192 38-61
1-36
193202
BDS PRN
1-30 1-30 1-30 1-30 1-30 1-30 1-30 1-30 1-30
NavIC PRN
1-7 1-7 1-7 1-7 1-7 1-7 1-7 1-7 1-7 1-7 1-7
OEM7 Commands and Logs Reference Manual v10
44
Chapter 1 Messages
1.7 GPS Reference Time Status
All reported receiver times are subject to a qualifying time status. The status indicates how well a time is known (see Table 11: GPS Reference Time Status below).
Table 11: GPS Reference Time Status
GPS Reference Time Status (Decimal)
GPS Reference Time Status (ASCII)
Description
20
UNKNOWN
Time validity is unknown
60
APPROXIMATE
Time is set approximately
80
COARSEADJUSTING
Time is approaching coarse precision
100
COARSE
This time is valid to coarse precision
120
COARSESTEERING
Time is coarse set and is being steered
130
FREEWHEELING
Position is lost and the range bias cannot be calculated
140
FINEADJUSTING
Time is adjusting to fine precision
160
FINE
Time has fine precision
170
FINEBACKUPSTEERING
Time is fine set and is being steered by the backup system
180
FINESTEERING
Time is fine set and is being steered
200
SATTIME
Time from satellite. Only used in logs containing satellite data such as ephemeris and almanac
There are several distinct states the receiver goes through.
When the CLOCKADJUST command (see page 105) is enabled: l UNKNOWN (initial state) l COARSESTEERING (initial coarse time set) l FINESTEERING (normal operating state) l FINEBACKUPSTEERING (when the backup system is used for a time) l FREEWHEELING (when range bias becomes unknown)
When the CLOCKADJUST command (see page 105) is disabled: l UNKNOWN (initial state) l COARSE (initial coarse time set) l FINE (normal operating state)
On startup and before any satellites are tracked, the receiver can not possibly know the current time. As such, the receiver time starts counting at GPS reference week 0 and second 0.0. The time status flag is set to UNKNOWN.
OEM7 Commands and Logs Reference Manual v10
45
Chapter 1 Messages
If time is input to the receiver using the SETAPPROXTIME command (see page 343), the time status will be APPROXIMATE.
After the first ephemeris is decoded, the receiver time is set to a resolution of �10 milliseconds. This state is qualified by the COARSE or COARSESTEERING time status flag depending on the state of the CLOCKADJUST switch (for more information, refer to the CLOCKADJUST command on page 105).
Once a position is known and range biases are being calculated, the internal clock model will begin modeling the range biases also known as the receiver clock offset.
Modeling will continue until the model is a good estimation of the actual receiver clock behavior. At this time, the receiver time will again be adjusted, this time to an accuracy of �1 microsecond. This state is qualified by the FINE time status flag.
The final logical time status flag depends on whether CLOCKADJUST is enabled or not. If CLOCKADJUST is disabled, the time status flag will never improve on FINE. The time will only be adjusted again to within �1 microsecond if the range bias gets larger than �250 milliseconds. If CLOCKADJUST is enabled, the time status flag is set to FINESTEERING and the receiver time is continuously updated (steered) to minimize the receiver range bias.
If a solution cannot be computed with the primary satellite system, it will attempt to use a backup system (if available). When the backup system is used and time is computed, the time status is set to FINEBACKUPSTEERING. If the position is lost and the range bias cannot be calculated, the time status is degraded to FREEWHEELING.
See also Message Time Stamps below and the SETTIMEBASE command on page 353.
1.8 Message Time Stamps
All NovAtel format messages generated by the OEM7 family of receivers have a GPS reference time stamp in their header. GPS reference time is referenced to UTC with zero point defined as midnight on the night of January 5, 1980. The time stamp consists of the number of weeks since that zero point and the number of seconds since the last week number change (0 to 604,799). GPS reference time differs from UTC time since leap seconds are occasionally inserted into UTC and GPS reference time is continuous. In addition, a small error (less than 1 microsecond) can exist in synchronization between UTC and GPS reference time. The TIME log reports both GNSS and UTC time and the offset between the two.
The data in synchronous logs (for example, RANGE, BESTPOS, TIME) are based on a periodic measurement of satellite pseudoranges. The time stamp on these logs is the receiver estimate of GPS reference time at the time of the measurement. A synchronous log with trigger ONTIME 1 can be used in conjunction with the 1PPS signal to provide relative accuracy better than 250 ns.
Other log types (asynchronous and polled) are triggered by an external event and the time in the header may not be synchronized to the current GPS reference time. Logs that contain satellite broadcast data (for example, ALMANAC, GPSEPHEM) have the transmit time of their last subframe in the header. In the header of differential time matched logs (for example, MATCHEDPOS) is the time of the matched reference and local observation that they are based on. Logs triggered by a mark event (for example, MARKEDPOS, MARKTIME) have the estimated GPS reference time of the mark event in their header. In the header of polled logs (for example, LOGLIST, PORTSTATS, VERSION) is the approximate GPS reference time when their data was
OEM7 Commands and Logs Reference Manual v10
46
Chapter 1 Messages
generated. However, when asynchronous logs are triggered ONTIME, the time stamp will represent the time the log was generated and not the time given in the data.
For more information about log types, see Log Types on page 409.
1.9 Decoding of the GPS Reference Week Number
The GPS reference week number provided in the raw satellite data is the 10 least significant bits (or 8 least significant bits in the case of the almanac data) of the full week number. When the receiver processes the satellite data, the week number is decoded in the context of the current era and therefore is computed as the full week number starting from week 0 or January 6, 1980. Therefore, in all log headers and decoded week number fields, the full week number is given. Only in raw data, such as the data field of the RAWALM log (see page 725) or the subframe field of the RAWEPHEM log (see page 728), will the week number remain as the 10 (or 8) least significant bits.
1.10 32-Bit CRC
The ASCII and Binary OEM7 family message formats all contain a 32-bit CRC for data verification. This allows the user to ensure the data received (or transmitted) is valid with a high level of certainty.
The C functions below may be implemented to generate the CRC of a block of data.
#define CRC32_POLYNOMIAL 0xEDB88320L /* -------------------------------------------------------------------------Calculate a CRC value to be used by CRC calculation functions. -------------------------------------------------------------------------- */ unsigned long CRC32Value(int i) {
int j; unsigned long ulCRC; ulCRC = i; for ( j = 8 ; j > 0; j-- ) {
if ( ulCRC & 1 ) ulCRC = ( ulCRC >> 1 ) ^ CRC32_POLYNOMIAL;
else ulCRC >>= 1;
} return ulCRC; }
/* -------------------------------------------------------------------------Calculates the CRC-32 of a block of data all at once ulCount - Number of bytes in the data block ucBuffer - Data block -------------------------------------------------------------------------- */ unsigned long CalculateBlockCRC32( unsigned long ulCount, unsigned char *ucBuffer ) {
unsigned long ulTemp1; unsigned long ulTemp2; unsigned long ulCRC = 0; while ( ulCount-- != 0 ) {
ulTemp1 = ( ulCRC >> 8 ) & 0x00FFFFFFL; ulTemp2 = CRC32Value( ((int) ulCRC ^ *ucBuffer++ ) & 0xFF );
OEM7 Commands and Logs Reference Manual v10
47
Chapter 1 Messages
ulCRC = ulTemp1 ^ ulTemp2; } return( ulCRC ); }
The NMEA checksum is an XOR of all the bytes (including delimiters such as ',' but excluding the * and $) in the message output. It is therefore an 8-bit and not a 32-bit checksum.
Not all logs may be available. Every effort is made to ensure examples are correct, however, a checksum may be created for promptness in publication. In this case it will appear as `9999'.
Example: BESTPOSB and BESTPOSA from an OEM7 family receiver.
Binary Log Message: 0xAA, 0x44, 0x12, 0x1C, 0x2A, 0x00, 0x02, 0x20, 0x48, 0x00, 0x00, 0x00, 0x90, 0xB4, 0x93, 0x05, 0xB0, 0xAB, 0xB9, 0x12, 0x00, 0x00, 0x00, 0x00, 0x45, 0x61, 0xBC, 0x0A, 0x00, 0x00, 0x00, 0x00, 0x10, 0x00, 0x00, 0x00, 0x1B, 0x04, 0x50, 0xB3, 0xF2, 0x8E, 0x49, 0x40, 0x16, 0xFA, 0x6B, 0xBE, 0x7C, 0x82, 0x5C, 0xC0, 0x00, 0x60, 0x76, 0x9F, 0x44, 0x9F, 0x90, 0x40, 0xA6, 0x2A, 0x82, 0xC1, 0x3D, 0x00, 0x00, 0x00, 0x12, 0x5A, 0xCB, 0x3F, 0xCD, 0x9E, 0x98, 0x3F, 0xDB, 0x66, 0x40, 0x40, 0x00, 0x30, 0x30, 0x30, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x0B, 0x0B, 0x00, 0x00, 0x00, 0x06, 0x00, 0x03, 0x42, 0xdc, 0x4c,0x48
Below is a demonstration of how to generate the CRC from both ASCII and BINARY messages using the function described above.
When you pass the data into the code that follows, exclude the checksum shown in bold italics above. It is 42dc4c48.
Binary Checksum Calculation: #include <stdio.h> #include <string.h> #include <inttypes.h>
void main() { // Expect checksum 0x42, 0xDC, 0x4C, 0x48 (42dc4c48) unsigned char buffer[] = {0xAA, 0x44, 0x12, 0x1C, 0x2A, 0x00, 0x02, 0x20,
0x48, 0x00, 0x00, 0x00, 0x90, 0xB4, 0x93, 0x05, 0xB0, 0xAB,
0xB9, 0x12, 0x00, 0x00, 0x00, 0x00, 0x45, 0x61, 0xBC, 0x0A,
0x00, 0x00, 0x00, 0x00, 0x10, 0x00, 0x00, 0x00, 0x1B, 0x04,
0x50, 0xB3,
OEM7 Commands and Logs Reference Manual v10
48
Chapter 1 Messages
0x7C, 0x82, 0x90, 0x40, 0x12, 0x5A, 0x40, 0x40, 0x00, 0x00, 0x00, 0x03};
0xF2, 0x8E, 0x49, 0x40, 0x16, 0xFA, 0x6B, 0xBE, 0x5C, 0xC0, 0x00, 0x60, 0x76, 0x9F, 0x44, 0x9F, 0xA6, 0x2A, 0x82, 0xC1, 0x3D, 0x00, 0x00, 0x00, 0xCB, 0x3F, 0xCD, 0x9E, 0x98, 0x3F, 0xDB, 0x66, 0x00, 0x30, 0x30, 0x30, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x0B, 0x0B, 0x00, 0x00, 0x00, 0x06,
//Note that the CRC on the binary data will be little-endian ordered. unsigned long CRCle = CalculateBlockCRC32(sizeof(buffer), buffer);
//big-endian users (such as x86 users) may swap endianness as follows unsigned long CRCbe = __builtin_bswap32(CRCle);
printf("\n\n%s %lx \n", "Computed binary checksum (little-endian): ", CRCle);
printf("%s %" PRIx64 "\n", "Computed binary checksum (big-endian): ", CRCbe);
}
Note that the above checksum function (CalculateBlockCRC32) must also be included to execute this code.
ASCII Log Message: #BESTPOSA,COM1,0,78.0,FINESTEERING,1427,325298.000,00000000,6145,2748; SOL_COMPUTED,SINGLE,51.11678928753,-114.03886216575,1064.3470,-16.2708, WGS84,2.3434,1.3043,4.7300,"",0.000,0.000,7,7,0,0,0,06,0,03*9c9a92bb
The checksum for this log is given above, it is 9c9a92bb.
ASCII: #include <stdio.h> #include <string.h>
void main() { //Remember to escape " characters as \" char *msgBlock =
"BESTPOSA,COM1,0,78.0,FINESTEERING,1427,325298.000,00000000,\ 6145,2748;SOL_COMPUTED,SINGLE,51.11678928753,-114.03886216575,\ 1064.3470,16.2708,WGS84,2.3434,1.3043,4.7300,\"\",0.000,0.000,7,7,0,0,0,06,0,03";
unsigned long CRC = CalculateBlockCRC32(strlen(msgBlock), (unsigned char*)msgBlock);
OEM7 Commands and Logs Reference Manual v10
49
Chapter 1 Messages
printf("\n%s %s\n", "Demonstrating CRC computed for the block:", msgBlock);
printf("\n\n%s %lu\n", "CRC32 in Decimal is: ", CRC); printf("%s %lx\n", "CRC32 in Hex is: ", CRC); }
Note that the above checksum function (CalculateBlockCRC32) must also be included to execute this code.
OEM7 Commands and Logs Reference Manual v10
50
Chapter 2 GNSS Commands
The commands used to configure the OEM7 receiver and GNSS functions are described in the following sections. For information about SPAN specific commands, refer to the SPAN Commands on page 882.
2.1 Command Formats
The receiver accepts commands in 3 formats as described in Messages on page 25: l Abbreviated ASCII l ASCII l Binary
Abbreviated ASCII is the easiest to use for your input. The other two formats include a CRC for error checking and are intended for use when interfacing with other electronic equipment. The following are examples of the same command in each format:
Abbreviated ASCII Example: LOG COM1 BESTPOSB ONTIME 1[CR]
ASCII Example: #LOGA,THISPORT,0,0,UNKNOWN,0,0.0,0,0,0;COM1,BESTPOSB,ONTIME,1.000000,0.000000,N OHOLD*ec9ce601[CR]
Binary Example: AA44121C 010000C0 20000000 00FF0000 00000000 00000000 00000000 20000000 2A000000 02000000 00000000 0000F03F 00000000 00000000 00000000 34D32DC1
2.1.1 Optional Parameters
Many commands have nested optional parameters where an optional parameter requires the optional parameter before it to be present. This is noted in the Abbreviated ASCII Syntax as:
Command [OPT_1 [OPT_2 [OPT_3]]] In this syntax example, OPT_1 and OPT_2 must be provided if you want to provide a value for OPT_3. These leading two options are required even if you want to use the defaults for OPT_1 and OPT_2.
2.2 Command Settings
There are several ways to determine the current command settings of the receiver: 1. Request an RXCONFIG log (see page 764). This log provides a listing of all commands
issued to the receiver and their parameter settings. It also provides the most complete information. 2. For some specific commands, logs are available to indicate all their parameter settings. The LOGLIST log (see page 584) shows all active logs in the receiver beginning with the LOG
OEM7 Commands and Logs Reference Manual v10
51
Chapter 2 GNSS Commands
command (see page 225).
3. Request a log of the specific command of interest to show the parameters last entered for that command. The format of the log produced is exactly the same as the format of the specific command with updated header information.
Requesting a log for specific command is useful for most commands. For commands repeated with different parameters (for example, SERIALCONFIG and LOG), only the most recent set of parameters used is shown. To view all sets of parameters, try method 1 or 2 above.
Abbreviated ASCII Example:
log fix
<FIX COM1 0 45.0 FINE 1114 151898.288 00200000 dbfd 33123
<
NONE -10000.00000000000 -10000.00000000000 -10000.0000
2.3 Factory Defaults
When the receiver is first powered up or after a FRESET command (see page 179), all commands revert to their factory default settings. When you use a command without specifying its optional parameters, it may have a different command default than the factory default. The SAVECONFIG command (see page 321) can be used to save these defaults. Use the RXCONFIG log (see page 764) to reference any default command and log settings.
Ensure that all windows, other than the Console window, are closed in NovAtel's Connect user interface application before you issue the SAVECONFIG command (see page 321).
FRESET STANDARD causes all previously stored user configurations saved to non-volatile memory to be erased (including Saved Config, Saved Almanac, Saved Ephemeris and L-Band-related data, excluding subscription information).
2.4 Command Reference
When a command is used without specifying its optional parameters, it may have a different command default than the factory default. Factory default settings for individual commands are stated in the following commands, organized alphabetically by command name.
OEM7 Commands and Logs Reference Manual v10
52
Chapter 2 GNSS Commands
2.5 ADJUST1PPS
Adjusts the receiver clock
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to adjust the receiver clock or as part of the procedure to transfer time between receivers. The number of pulses per second (PPS) is always set to 1 Hz with this command. It is typically used when the receiver is not adjusting its own clock and is using an external reference frequency. To disable the automatic clock adjustment, refer to the CLOCKADJUST command on page 105. To configure the receiver to use an external reference oscillator, see the EXTERNALCLOCK command on page 151. The ADJUST1PPS command can be used to:
l Manually shift the phase of the clock l Adjust the phase of the clock so the output 1PPS signal matches an external signal l Set the receiver clock close to that of another GNSS receiver l Set the receiver clock exactly in phase of another GNSS receiver
1. The resolution of the clock synchronization is 20 ns. 2. To adjust the 1PPS output, when the receiver's internal clock is being used and the
CLOCKADJUST command is enabled, use the CLOCKOFFSET command on page 110. 3. If the 1PPS rate is adjusted, the new rate does not start until the next second begins.
Figure 2: 1PPS Alignment on the next page shows the 1PPS alignment between a Fine and a Warm Clock receiver. See also the TIMESYNC log on page 858 and the Transfer Time Between Receivers section in the OEM7 Installation and Operation User Manual.
OEM7 Commands and Logs Reference Manual v10
53
Chapter 2 GNSS Commands
Figure 2: 1PPS Alignment
The 1PPS is obtained from different receivers in different ways.
In Figure 2: 1PPS Alignment above, the examples are for the transfer of time. If you need position, you must be tracking satellites and your receiver must have a valid almanac.
Alternatively, the 1PPS signal can be set up to be output on a COM port using the COMCONTROL command (see page 112). The accuracy of the 1PPS is less using this method, but may be more convenient in some circumstances.
Table 12: COM Port Signals Available for 1PPS OEM719 OEM729 OEM7600 OEM7700 OEM7720 PwrPak7 SPAN CPT7 COM1 Tx COM1 Tx COM1 Tx COM1 Tx COM1 Tx COM1 Tx COM1 Tx COM2 Tx COM2 Tx COM2 Tx COM2 Tx COM2 Tx COM2 Tx COM2 Tx
COM2 RTS COM2 RTS COM2 RTS COM2 RTS COM3 Tx COM3 Tx COM3 Tx COM3 Tx COM3 Tx
COM4 Tx COM4 Tx COM4 Tx COM5 Tx COM5 Tx COM5 Tx
To find out the time of the last 1PPS output signal, use the TIMESYNCA/B output message (see the TIMESYNC log on page 858) which can be output serially on any available COM port, for example:
LOG COM1 TIMESYNCA ONTIME 1
Message ID: 429
OEM7 Commands and Logs Reference Manual v10
54
Chapter 2 GNSS Commands
Abbreviated ASCII Syntax: ADJUST1PPS mode [period] [offset]
Factory Default: ADJUST1PPS OFF
ASCII Example: ADJUST1PPS MARK CONTINUOUS 250
Use the ADJUST1PPS command to synchronize two OEM7 cards in a primary/secondary relationship to a common external clock. At the Primary Receiver:
LOG COM2 TIMESYNCa ONTIME 1 interfacemode com2 novatel novatel none clockadjust DISABLE EXTERNALCLOCK OCXO 10mhz (choose rubidium, cesium or user instead and choose 5MHz instead if necessary) At the Secondary Receiver: interfacemode com2 novatel novatel none CLOCKADJUST DISABLE adjust1pps mark (or markwithtime or time depending on your connection (see Figure 3: ADJUST1PPS Connections on page 57) EXTERNALCLOCK OCXO 10mhz (you can choose rubidium, cesium or user instead and choose 5MHz instead if necessary) Connections: Null modem cable connected from Primary COM2 to Secondary COM2 OCXO signal sent through a splitter to feed both the Primary and Secondary external clock inputs Primary 1PPS connected to Secondary MKI Connect everything before applying power. If power is applied and the OEM7 receivers have acquired satellites before the OCXO and/or 1PPS = MKI is set up, the times reported by the TIMESYNC logs still diverge. Note that after the clock model was stabilized at state 0, the time difference between the Primary and Secondary reported by the TIMESYNC log was less than 10 ns.
When connecting two receivers to transfer time, disable responses on the COM port used to connect the receivers by issuing the following command on both receivers:
interfacemode com2 novatel novatel none
OEM7 Commands and Logs Reference Manual v10
55
Chapter 2 GNSS Commands
The following examples are for the transfer of time. If you need position, you must be tracking satellites and your receiver must have a valid almanac.
OEM7 Commands and Logs Reference Manual v10
56
Chapter 2 GNSS Commands Figure 3: ADJUST1PPS Connections
adjust1pps mark (if Receiver 2 is not in coarsetime, the input is ignored)
adjust1pps markwithtime (will get to finetime)
OEM7 Commands and Logs Reference Manual v10
57
Chapter 2 GNSS Commands
adjust1pps time (will only get to coarsetime)
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
ADUST
1
1PPS -
header
Command header. See
-
Messages on page 25 for -
more information.
H
0
2
mode
See Table 13: ADJUST1PPS Mode on the next page
Sets the ADJUST1PPS mode.
Enum 4
H
ONCE
0
3
period
CONTINUOUS 1
The time is synchronized
only once (default). The
ADJUST1PPS command
must be reissued if
another synchronization is
required
Enum 4
The time is continuously monitored and the receiver clock is corrected if an offset of more than 50 ns is detected
H+4
OEM7 Commands and Logs Reference Manual v10
58
Chapter 2 GNSS Commands
Field
Field Type
4
offset
ASCII Value
Binary Value
-2147483648 to +2147483647 (ns)
Description
Format
Binary Bytes
Binary Offset
Allows the operator to
shift the Secondary clock
in 20 ns increments. In
MANUAL mode, this
command applies an
immediate shift of this
offset in ns to the receiver
clock. In MARK and
MARKWITHTIME mode,
this offset shifts the
receiver clock with
respect to the time of
arrival of the MK1I event.
If this offset is zero, the
Secondary aligns its 1PPS Long
4
to that of the signal
received in its MK1I port.
For example, if this value
was set to 50, then the
Secondary would set its
1PPS 50 ns ahead of the
input signal and if this
value was set to -100 then
the would set its clock to
100 ns behind the input
signal. Typically, this
offset is used to correct
for cable delay of the
1PPS signal (default=0)
H+8
ASCII Value OFF MANUAL
Table 13: ADJUST1PPS Mode
Binary Value
Description
0
Disables ADJUST1PPS
Immediately shifts the receivers time by the offset field in ns. The
1
period field has no effect in this mode. This command does not affect
the clock state
OEM7 Commands and Logs Reference Manual v10
59
Chapter 2 GNSS Commands
ASCII Value
Binary Value
Description
MARK1
Shifts the receiver time to align its 1PPS with the signal received in the
2
MK1I port adjusted by the offset field in ns. The effective shift range is
� 0.5 s
MARKWITHTIME
2
3
Shifts the receiver time to align its 1PPS with the signal received in the MK1I port adjusted by the offset field in ns, and sets the receiver TOW and week number, to that embedded in a received TIMESYNC log (see page 858). Also sets the receiver Time Status to that embedded in the TIMESYNC log (see page 858), which must have arrived between 800 and 1000 ms prior to the MK1I event (presumably the 1PPS from the Primary), or it is rejected as an invalid message
TIME
If the receiver clock is not at least COARSEADJUSTED, this command
enables the receiver to COARSE adjust its time upon receiving a valid
4
TIMESYNC log (see page 858) in any of the ports. The clock state embedded in the TIMESYNC log (see page 858) must be at least FINE
or FINESTEERING before it is considered. The receiver does not use
the MK1I event in this mode
1Only the MK1I input can be used to synchronize the 1PPS signal. Synchronization cannot be done using the MK2I input offered on some receivers. 2It is presumed that the TIMESYNC log (see page 858) was issued by a Primary GNSS receiver within 1000 ms
but not less than 800 ms, of the last 1PPS event, see Figure 2: 1PPS Alignment on page 54 and TIMESYNC on
page 858. Also refer to the Transfer Time Between Receivers section in the OEM7 Installation and Operation User
Manual.
OEM7 Commands and Logs Reference Manual v10
60
Chapter 2 GNSS Commands
2.6 ALIGNAUTOMATION
Configures ALIGN plug-and-play feature
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command configures the ALIGN plug and play feature. Use this command to enable/disable the plug and play feature, to set the rover COM port to which master is connected, to set the baud rate for communication, to set the intended operation rate using this command and to enable/disable sending the HEADINGEXTB/HEADINGEXT2B back to the Master receiver. Refer to the NovAtel application note APN-048 for details on HEADINGEXT (available on our website at www.novatel.com/support/).
On issuing this command at the ALIGN Rover, the Rover will automatically sync with the Master and configure it to send corrections at the specified baud rate and specified data rate.
This command should only be issued at ALIGN Rover.
Message ID: 1323
Abbreviated ASCII Syntax: ALIGNAUTOMATION option [comport] [baudrate] [datarate] [headingextboption] [interfacemode]
Factory Default: ALIGNAUTOMATION disable
Example: ALIGNAUTOMATION enable com2 230400 10 ON
Field Field Type
ALIGN
1
AUTOMATION
header
2
option
3
comport
ASCII Binary Value Value
-
-
ENABLE 1 DISABLE 0
COM1, COM2 or COM3
Description
Format
Binary Bytes
Binary Offset
Command header. See Messages on page 25 for more information.
H
0
Enable or disable the plug-and-play feature
Enum
4
H
Rover COM port to
which master is
connected (Table 59: COM Port Identifiers
Enum
4
on page 338)
(default=COM2)
H+4
OEM7 Commands and Logs Reference Manual v10
61
Chapter 2 GNSS Commands
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
4
baudrate
9600, 19200, 38400, 57600, 115200, 230400 or 460800
Intended baud rate for data transmission (default=230400)
Ulong
4
H+8
5
datarate
1, 2, 4, 5, 10 or 20
Rate (in Hz) at which
heading output is required (default=10
Ulong
4
Hz)
H+12
OFF
0
6
headingextb option
ON
1
Enable or disable
sending
HEADINGEXTB/ HEADINGEXT2B back
Enum
4
to the Master
(default=ON)
H+16
7
interfacemode
See Table 42: Serial Port Interface Modes on page 201
Serial port interface mode (default=None)
Enum 4
H+20
OEM7 Commands and Logs Reference Manual v10
62
Chapter 2 GNSS Commands
2.7 ANTENNAPOWER
Controls power to the antenna
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command enables or disables the supply of electrical power from the internal power source of the receiver to the Low Noise Amplifier (LNA) of an active antenna. Refer to the OEM7 Installation and Operation User Manual for further information about supplying power to the antenna. There are several bits in the receiver status that pertain to the antenna (see Table 166: Receiver Status on page 771). These bits indicate whether the antenna is powered and whether it is open circuited or short circuited.
Message ID: 98
Abbreviated ASCII Syntax: ANTENNAPOWER switch
Factory Default: ANTENNAPOWER ON
ASCII Examples: ANTENNAPOWER ON ANTENNAPOWER OFF
If a short circuit or other problem causes an overload of the current supplied to the antenna, the receiver hardware shuts down the power supplied to the antenna. To restore power, power cycle the receiver. The Receiver Status word, available in the RXSTATUS log (see page 766), provides more information about the cause of the problem.
Field
Field Type
ASCII Value
Binary Value
Description
1
ANTENNAPOWER header
-
Command
header. See
-
Messages on page 25 for
more
information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
63
Chapter 2 GNSS Commands
Field Field Type
2
switch
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Disables antenna power
On dual antenna
OFF
0
receivers,
disables antenna
power for both
antennas
Enables antenna power
On dual antenna
ON
1
receivers,
enables antenna
power for both
antennas
Enables primary
antenna power Enum
4
H
PRIMARY_
ON_ SECONDARY_
3
and disables secondary antenna power
OFF
Note: Dual
antenna
receivers only
PRIMARY_
OFF_ SECONDARY_
4
ON
Disables primary antenna power and enables secondary antenna power
Note: Dual antenna receivers only
The OEM7 dual antenna receivers are: OEM7720, PwrPak7D, PwrPak7D-E1 and SPAN CPT7.
OEM7 Commands and Logs Reference Manual v10
64
Chapter 2 GNSS Commands
2.8 ANTENNATYPE
Store the user defined antenna type
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use the ANTENNATYPE command to control the storage of up to five user-defined antennas. Values are entered and interpreted according to the conventions in the IGS ANTEX format. The current list of user-defined antennas stored by the receiver can be viewed using the USERANTENNA log on page 864. The THISANTENNATYPE command (see page 373) and BASEANTENNATYPE command (see page 85) control the use of the antennas in RTK.
Message ID: 2281
Abbreviated ASCII Syntax: ANTENNATYPE Action AntennaType [AntennaName] [NumberOfFrequencies] [Frequency] [NorthOffset] [EastOffset] [UpOffset] [PCVArray] ...
The "Number of frequencies" determines the number of frequencies for which Phase Center Offsets (PCOs) and Phase Center Variations (PCVs) are stored. For simplicity, the syntax above shows a single frequency. The ASCII Example 1 below shows two frequencies being added. PCOs and PCVs can be defined for up to 24 frequencies.
ASCII Example 1: ANTENNATYPE ADD USER_ANTENNA_1 NOVCUSTOM 2 GPSL1 0.09 0.0 51.74 0 -0.03 -0.11 -0.20 0.23 -0.17 -0.04 0.14 0.26 0.25 0.07 -0.24 -0.54 -0.67 -0.49 -0.02 0.55 0.84 0.47 GPSL2 -1.54 1.66 52.00 0.00 0.0 0.0 -0.03 -0.13 -0.28 -0.48 -0.61 -0.56 -0.28 0.23 0.84 1.29 1.31 0.77 -0.16 -0.95 -0.81 0.97
ASCII Example 2: ANTENNATYPE REMOVE USER_ANTENNA_1
Field Field Type
ASCII Binary Value Value
Description
1
ANTENNATYPE header
�
Command header. See
�
Messages on page 25
for more information.
2
Action
ADD
0
REMOVE 1
Add a user antenna Delete a user antenna
3
AntennaType
Table 14: UserDefined Antenna Type below
User defined antenna type
Format
Binary Bytes
Binary Offset
�
H
0
Enum 4
H
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
65
Chapter 2 GNSS Commands
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
4
AntennaName
Name of the user defined antenna
Char [16]
16
H+8
5
NumberOf Frequencies
Number of frequencies
for which corrections
Ulong 8
are stored
H+24
See Table 19:
The frequency for which
6
Frequency
Frequency Type the phase center
Enum 4
on page 83
corrections are valid.
H+32
7
NorthOffset
North phase center
offset (millimetres)
Float
4
Valid range: -326.66 to
326.66
H+36
8
EastOffset
East phase center offset
(millimetres)
Float
4
Valid range: -326.66 to
326.66
H+40
9
UpOffset
Up phase center offset
(millimetres)
Float
4
Valid range: -326.66 to
326.66
H+44
10
PCVArray
19 element array of
Phase Center Variations
in 5-degree elevation
increments from 90 degrees elevation to 0
Float [19]
76
degrees (millimetres)
Valid range: -326.66 to 326.66
H+48
11
Next Frequency = H + 32 + (Number of frequencies x 92)
Table 14: User-Defined Antenna Type
Binary
ASCII
1001
USER_ANTENNA_1
1002
USER_ANTENNA_2
1003
USER_ANTENNA_3
1004
USER_ANTENNA_4
1005
USER_ANTENNA_5
OEM7 Commands and Logs Reference Manual v10
66
Chapter 2 GNSS Commands
2.9 ASSIGN
Assigns a channel to a PRN
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
1. The ASSIGN command should only be used by advanced users. 2. Assigning SV channel sets the forced assignment bit in the channel tracking
status field which is reported in the RANGE and TRACKSTAT logs. 3. Assigning a PRN to a SV channel does not remove the PRN from the search space
of the automatic searcher; only the SV channel is removed (that is, the searcher may search and lock onto the same PRN on another channel). See Table 10: PRN Numbers for Commands and Logs on page 44 for the PRN available for the ASSIGN command. 4. GLONASS SVs cannot be assigned if there is no information on GLONASS frequencies and matching slot numbers.
This command may be used to aid in the initial acquisition of a satellite by manually overriding the automatic satellite/channel assignment and reacquisition processes. The command specifies that the indicated tracking channel search for a specified satellite, at a specified Doppler frequency, within a specified Doppler window. The instruction remains in effect for the specified SV channel and PRN, even if the assigned satellite subsequently sets. If the satellite Doppler offset of the assigned SV channel exceeds that specified by the window parameter of the ASSIGN command, the satellite may never be acquired or reacquired. If a PRN has been assigned to a channel and the channel is currently tracking that satellite, when the channel is set to AUTO tracking, the channel immediately idles and returns to automatic mode. To cancel the effects of ASSIGN, issue one of the following:
l The ASSIGN command with the state set to AUTO l The UNASSIGN command (see page 380) l The UNASSIGNALL command (see page 382) These immediately return SV channel control to the automatic search engine
Message ID: 27
Abbreviated ASCII Syntax: ASSIGN channel [state] [prn [Doppler [Doppler window]]]
ASCII Example 1: ASSIGN 0 ACTIVE 29 0 2000
In example 1, the first SV channel is searching for satellite PRN 29 in a range from -2000 Hz to 2000 Hz until the satellite signal is detected.
ASCII Example 2: ASSIGN 11 28 -250 0
OEM7 Commands and Logs Reference Manual v10
67
Chapter 2 GNSS Commands
SV channel 11 is searching for satellite PRN 28 at an offset of -250 Hz only. ASCII Example 3:
ASSIGN 11 IDLE SV channel 11 is idled and does not attempt to search for satellites.
OEM7 cards have 4 channels available for SBAS. They automatically use the healthy GEO satellites with the highest elevations. Use the ASSIGN command to enter a GEO PRN manually.
For dual antenna receivers, when using the ASSIGN command for SV channels on the primary antenna, the SV channel count goes from 0 to N-1, where N is the number of channels in the primary antenna channel configuration. When using the ASSIGN command for channels on the secondary antenna, the SV channel count begins at N and goes to N+(M-1), where M is the number of channels in the secondary antenna SV channel configuration.
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
ASSIGN header
-
-
Command header. See
Messages on page 25 for
-
more information.
H
0
2
channel
0 to n-1, where n is the maximum number of channels in the current channel configuration
Desired SV channel number where channel 0 is the first SV channel. The last channel depends on the model configuration
Ulong
4
H
Set the SV channel state. If a
Refer to Table 15: value is not given, the
3
state
Channel State on default of ACTIVE is used
Enum 4
the next page
when the additional optional
parameters are entered
H+4
Refer to PRN
4
prn
Numbers on
page 44
Optional satellite PRN
number. A value must be entered unless the state
Ulong 4
parameter is IDLE or AUTO
H+8
OEM7 Commands and Logs Reference Manual v10
68
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
-100 000 to
5
Doppler
100 000 Hz
6
Doppler window
0 to 10 000 Hz
Description
Format
Binary Bytes
Binary Offset
Current Doppler offset of the satellite (default=0)
Note: Satellite motion,
receiver antenna motion and Long
4
receiver clock frequency
error must be included in the
calculation of Doppler
frequency
H+12
Error or uncertainty in the Doppler estimate above. (default=4500)
Ulong 4
Note: This is a � value. Example: 500 for � 500 Hz
H+16
Binary ASCII
0
IDLE
1
ACTIVE1
2
AUTO
Table 15: Channel State Description
Set the SV channel to not track any satellites Set the SV channel active (default) Tell the receiver to automatically assign PRN numbers to channels
1A PRN number is required when using the ACTIVE channel state in this command.
OEM7 Commands and Logs Reference Manual v10
69
Chapter 2 GNSS Commands
2.10 ASSIGNALL
Assigns all channels to a PRN
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The ASSIGNALL command should only be used by advanced users.
This command is used to override the automatic satellite/channel assignment and reacquisition processes for all receiver channels with manual instructions. Message ID: 28 Abbreviated ASCII Syntax:
ASSIGNALL [system][state][prn [Doppler [Doppler window]]]
ASCII Example 1: ASSIGNALL GLONASS IDLE
In example 1, all GLONASS channels are idled, essentially stopping the receiver from tracking GLONASS. ASCII Example 2:
ASSIGNALL GLONASS AUTO In example 2, all GLONASS channels are enabled in auto mode. This enables the receiver to automatically assign channels to track the available GLONASS satellites.
This command is the same as ASSIGN except that it affects all SV channels of the specified system.
These command examples are only applicable to specific receiver models.
If the system field is used with this command and the receiver has no channels configured with that channel system, the command is rejected.
Field
Field Type
ASCII Binary Value Value
Description
ASSIGN-
1
ALL
-
-
header
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
70
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
2
system
See Table 16: Channel System below
System that SV channel is tracking. If no value is specified, the value defaults to ALL
Enum
4
H
Refer to Table
3
state
15: Channel State on
Set the SV channel state
page 70)
Enum 4
H+4
4
prn
Refer to PRN Numbers on page 44
Optional satellite PRN code. A
value must be entered if the state parameter is neither IDLE
Ulong
4
or AUTO
H+8
-100 000 to
5
Doppler
100 000 Hz
Current Doppler offset of the satellite (default=0)
Note: Satellite motion,
receiver antenna motion and
Long
4
receiver clock frequency error
must be included in the
calculation of Doppler
frequency.
H+12
Error or uncertainty in the
Doppler estimate above.
6
Doppler window
0 to 10 000 Hz
(default=4500)
Note: This is a � value
Example, 500 for � 500 Hz
Ulong 4
H+16
Table 16: Channel System
Binary ASCII
Description
3
ALL
All systems
99
GPS GPS system
100
SBAS SBAS system
101 GLONASS GLONASS system
102 GALILEO GALILEO system
103
BeiDou BeiDou system
104
QZSS QZSS system
105
NAVIC NavIC system
OEM7 Commands and Logs Reference Manual v10
71
Chapter 2 GNSS Commands
GLONASS SVs cannot be assigned if there is no information on GLONASS frequencies and matching slot numbers.
OEM7 Commands and Logs Reference Manual v10
72
Chapter 2 GNSS Commands
2.11 ASSIGNLBANDBEAM
Configure L-Band tracking
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command assigns TerraStar or Veripos beams to the L-Band channels based on the defined L-Band assignment option.
Logging the ASSIGNLBANDBEAM command may not display the correct values. To access the actual beam name, frequency and baud rate values, log the LBANDTRACKSTAT log (see page 581) or if the beam name is known, log the LBANDBEAMTABLE log (see page 579) and find the associated frequency and baud rate.
Message ID: 1733 Abbreviated ASCII Syntax:
ASSIGNLBANDBEAM [option] [name] [frequency] [baudrate] [Dopplerwindow]
Factory Default: ASSIGNLBANDBEAM idle
ASCII Examples: ASSIGNLBANDBEAM auto ASSIGNLBANDBEAM 98W ASSIGNLBANDBEAM manual 98w 1545865000 1200
Field Field Type
Description
1
ASSIGNLBAND Command header. See Messages on BEAM header page 25 for more information.
2
Option
Assignment option (see Table 17: L-Band Assignment Option on the next page) (manual=default)
3
Name
Beam name (empty string=default)
4
Frequency
Beam frequency in Hz (0=default)
5
Baud rate
Data baud rate (0=default)
6
Doppler window
Doppler window to search (6000=default)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
Char[8] 8 Ulong 4 Ulong 4 Ulong 4
H
H+4 H+12 H+16 H+20
OEM7 Commands and Logs Reference Manual v10
73
Chapter 2 GNSS Commands
Table 17: L-Band Assignment Option
ASCII Binary
Description
IDLE
0
Idle all L-Band channels
AUTO
The receiver searches for multiple L-Band beams on the L-Band channels based on AUTO selection criteria.
If the receiver position is known, the AUTO selection criteria is a ranking of
1
granted access L-Band beams by descending elevation angle.
If the receiver position is not known, the AUTO selection criteria is a ranking of granted access L-Band beams in the order they appear in the stored beam table (see the LBANDBEAMTABLE log on page 579).
MANUAL
2
The receiver assigns the specified beam on the first L-BAND channel and makes the other L-BAND channels IDLE.
OEM7 Commands and Logs Reference Manual v10
74
Chapter 2 GNSS Commands
2.12 AUTH
Authorization code for different model
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to add or remove authorization codes from the receiver. Authorization codes are used to authorize models of software for a receiver. Models control the functionality the receiver provides. The RECEIVER is capable of keeping track of 24 authorization codes at one time. The MODEL command (see page 243) can then be used to switch between authorized models. The VALIDMODELS command (see page 869) lists the current available models in the receiver. The AUTHCODES log (see page 419) lists all Authorization codes entered into the receiver. This simplifies the use of multiple software models on the same receiver. If there is more than one valid model in the receiver, the receiver either uses the model of the last auth code entered via the AUTH command or the model that was selected by the MODEL command, whichever was done last. Adding an Authorization Code or using the MODEL command causes an automatic reset of the receiver. Removing an Authorization Code does not cause a reset.
Removing an authorization code will cause the receiver to permanently lose this information.
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
1
AUTH header
-
-
Description
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
-
H
Binary Offset
0
OEM7 Commands and Logs Reference Manual v10
75
Chapter 2 GNSS Commands
Field
Field Type
2
state
3
part1
4
part2
5
part3
6
part4
7
part5
8
model
9
date
ASCII Value
Binary Value
Description
See Table 18: AUTH Command State below
Auth code function to perform
6 character ASCII string
Authorization code section 1
6 character ASCII string
Authorization code section 2
6 character ASCII string
Authorization code section 3
6 character ASCII string
Authorization code section 4
6 character ASCII string
Authorization code section 5
Alpha Null
Model name of the
numeric terminated receiver
Numeric
Null terminated
Expiry date entered as yymmdd in decimal
Format
Binary Bytes
Enum
4
String [max. 16]
Variable1
String
Variable1
[max. 16]
String
Variable1
[max. 16]
String
Variable1
[max. 16]
String
Variable1
[max. 16]
String
Variable1
[max. 16]
String [max 7]
Variable1
Binary Offset H
H+4 H+20 H+36 H+52 H+68 H+84
Variable
ASCII REMOVE
Table 18: AUTH Command State
Binary
Description
Remove the authcode from the system
0
For this parameter, the Part1-Part5 fields can be entered as 0
0 0 0 0, and only the model name entered.
ADD
1
ADD_ DOWNLOAD
4
Add the authcode to the system (default) Add the authcode to the system (Deprecated: Use ADD instead)
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
76
Chapter 2 GNSS Commands
ASCII
ERASE_ TABLE
Binary
Description
Erase all auth codes from the system. Requires a special auth code to prevent against accidental erasing.
7
The special auth code required for this option is:
PW5W2B,WW5TM9,WW2PCZ,WW3M4H,WW4HPG,ERASE_
AUTH
CLEAN_ TABLE
8
Remove all invalidated auth codes from the system. When an auth code is removed, it is simply invalidated and so it still uses one of the 24 spaces reserved for auth codes in the receiver. Use the CLEAN_TABLE option to free up the spaces from removed auth codes.
The special auth code required for this option is: 4DR69H,G369W8,34MNJJ,5NHXCJ,GW7C75,CLEAN_AUTH
OEM7 Commands and Logs Reference Manual v10
77
Chapter 2 GNSS Commands
2.13 AUTOSURVEY
Survey for accurate position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The AUTOSURVEY command uses position averaging to automatically determine the position for a base station. When the AUTOSURVEY command is sent, the receiver starts position averaging. The position averaging continues until a specified accuracy level is met or until the specified survey time expires. When position averaging is complete, the calculated position is saved as the fix position for the base station. This calculated position is then used when transmitting differential corrections to the rover.
If the FIX command is entered by a user, the SAVECONFIG command must then be issued to save to NVM. If the FIX command is issued by the AUTOSURVEY feature, the SAVECONFIG command does not need to be issued, because it is automatically saved to NVM.
On subsequent power ups or resets, an AUTOSURVEY runs to determine if the base station has moved. As the AUTOSURVEY runs, the average position calculated is compared to the saved fix position. If the average position is within the AUTOSURVEY tolerance setting, the receiver assumes it has not moved and uses the previously saved fix position. If the average position is outside of the AUTOSURVEY tolerance setting, the receiver assumes it has moved and will continue calculating a position average until the accuracy level is met or until the specified survey time expires. The surveyed positions saved using the AUTOSURVEY command can be viewed using the SAVEDSURVEYPOSITIONS log on page 791. Surveyed positions can be added or deleted using the SURVEYPOSITION command on page 368.
Message ID: 1795
Abbreviated ASCII Syntax: AUTOSURVEY control [time] [accuracy] [tolerance] [save_nvm] [position_id]
Input Example: In the following example, the receiver is set up to survey its position for up to 24 hours or until the averaged position accuracy is 10 cm. On subsequent power ups at the same location, the survey will terminate as soon as the receiver determines the position is within 4 m of its surveyed position. Once the receiver has fixed its position, it will transmit RTCMV3 corrections over COM2.
SERIALCONFIG COM2 115200 N 8 1 N ON
INTERFACEMODE COM2 NONE RTCMV3 OFF
LOG COM2 RTCM1004 ONTIME 1
LOG COM2 RTCM1012 ONTIME 1
LOG COM2 RTCM1006 ONTIME 10
OEM7 Commands and Logs Reference Manual v10
78
Chapter 2 GNSS Commands
LOG COM2 RTCM1033 ONTIME 10 LOG COM2 RTCM1019 ONTIME 120 AUTOSURVEY ENABLE 1440 .1 4 SAVECONFIG
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
AUTOSURVEY header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
control
Disables the self-survey
disable 0
feature and halts any selfsurvey related activity
(default = disable)
Enum 4
H
enable 1
Enables the self-survey feature
3
time
Maximum amount of time
1 - 6000 minutes to perform self-survey
Ulong 4
(default = 1440 minutes)
H+4
Desired horizontal
4
accuracy
0 - 100 metres standard deviation
Float
4
(default = 0.1 metres)
H+8
Maximum distance
between calculated
position and saved
position. During the self-
survey, if the distance
5
tolerance
3 - 100 metres
between the calculated position and the
Float
4
previously surveyed
position is less than this
value, the previous
position is used.
(default = 10 metres)
H+12
OFF
0
6
save_nvm
ON
1
Do not save position in NVM
Save position in NVM (default = ON)
Enum 4
H+16
OEM7 Commands and Logs Reference Manual v10
79
Chapter 2 GNSS Commands
Field Field Type
7
position_id
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
4 character string
ID for the saved position.
If the ID is not specified
or if the ID is entered as
"AUTO", receiver
automatically generates a
unique ID for the position String [5]
51
Note: This ID is the ID for
the surveyed position, not
the station ID set using
the DGPSTXID command
on page 127.
H+20
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
80
Chapter 2 GNSS Commands
2.14 BASEANTENNAPCO
Sets the PCO model of the base receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use the BASEANTENNAPCO command to set the Phase Center Offsets (PCO) for a given frequency on the remote base receiver from which this receiver is receiving corrections. The Offsets are defined as North, East and Up from the Antenna Reference Point to the Frequency Phase Center in millimetres.
Message ID: 1415
Abbreviated ASCII Syntax: BASEANTENNAPCO Frequency NorthOffset EastOffset UpOffset [CorrectionType [StationId]]
ASCII Example: BASEANTENNAPCO GPSL1 0.61 1.99 65.64
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
Command header.
1
BASEANTENNAPCO header
-
-
See Messages on page 25 for more
-
information.
H
0
2
Frequency
See Table 19:
The frequency that
Frequency Type the phase center
Enum 4
H
on the next page offsets are valid for.
3
NorthOffset
NGS standard Phase Center North Offset Double 8 in millimetres.
H+4
4
EastOffset
NGS standard Phase Center East Offset in Double 8 millimetres.
H+12
5
UpOffset
NGS standard Phase Center Up Offset in Double 8 millimetres.
H+20
See Table 53:
Correction type
6
CorrectionType
DGPS Type on
Enum 4
page 286
(default = AUTO)
H+28
7
StationID
Char [8] or ANY
ID string for the base station
(default = ANY)
Char
8
H+32
OEM7 Commands and Logs Reference Manual v10
81
Chapter 2 GNSS Commands
Table 19: Frequency Type
Value
Name
Description
0 GPSL1
GPS L1 frequency
1 GPSL2
GPS L2 frequency
2 GLONASSL1
GLONASS L1 frequency
3 GLONASSL2
GLONASS L2 frequency
5 GPSL5
GPS L5 frequency
7 GALILEOE1
Galileo E1 frequency
8 GALILEOE5A
Galileo E5a frequency
9 GALILEOE5B
Galileo E5b frequency
10 GALILEOALTBOC Galileo AltBOC frequency
11 BEIDOUB1
BeiDou B1 frequency
12 BEIDOUB2
BeiDou B2 frequency
13 QZSSL1
QZSS L1 frequency
14 QZSSL2
QZSS L2 frequency
15 QZSSL5
QZSS L5 frequency
16 QZSSL6
QZSS L6 frequency
17 GALILEOE6
Galileo E6 frequency
18 BEIDOUB3
BeiDou B3 frequency
OEM7 Commands and Logs Reference Manual v10
82
Chapter 2 GNSS Commands
2.15 BASEANTENNAPCV
Sets the PCV model of the base receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use the BASEANTENNAPCV command to set the Phase Center Variation (PCV) for a given frequency on the remote base receiver from which this receiver is receiving corrections. The Phase Center Variation entries follow the NGS standard and correspond to the phase elevation at 5 degree increments starting at 90 degrees and decreasing to 0.
Message ID: 1416
Abbreviated ASCII Syntax: BASEANTENNAPCV Frequency [PCVArray [CorrectionType [StationId]]]
ASCII Example: BASEANTENNAPCV GPSL1 0.00 -0.020 -0.07 -0.15 -0.24 -0.34 -0.43 -0.51 -0.56 0.61 -0.65 -0.69 -0.69 -0.62 -0.44 -0.13 0.28 0.70 1.02
Field
Field Type
ASCII Binary Value Value
Description
1
BASEANTENNAPCV header
-
-
Command header. See Messages on page 25 for more information.
2
Frequency
See Table 19: Frequency Type on the previous page
The frequency for which the phase center variations are valid.
3
PCVArray
NGS standard 19 element array of phase center variations, in millimetres, in 5 degree elevation increments from 90 to 0. Defaults to zero for all elevation increments.
4
CorrectionType
See Table 53: DGPS Type on page 286
Correction type (default = AUTO)
5
StationID
Char [8] or ANY
ID string (default = ANY)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Double [19]
152
H+4
Enum 4
Char
8
H+156 H+160
OEM7 Commands and Logs Reference Manual v10
83
Chapter 2 GNSS Commands
2.16 BASEANTENNATYPE
Sets the antenna type of the base receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use the BASEANTENNATYPE command to set the type of antenna type connected to the base receiver from which this receiver is receiving RTK corrections. There are two sources of antenna information:
l An internal table The firmware contains a set of predefined antenna and radome types taken from the IGS ANTEX file. Refer to Table 20: Antenna Type on the next page and Table 21: Radome Type on page 95 for the antennas currently supported.
l User-defined antennas User-defined antenna types can be entered using the ANTENNATYPE command (see page 65).
The THISANTENNATYPE command (see page 373) is used to set the type of antenna being used with this receiver.
Message ID: 1419
Abbreviated ASCII Syntax:
BASEANTENNATYPE AntennaType [RadomeType] [CorrectionType] [StationId]
ASCII Examples:
BASEANTENNATYPE NOV702
BASEANTENNATYPE USER_ANTENNA_1
Field
Field Type
ASCII Value
Binary Value
1
BASEANTENNATYPE header
-
-
2
AntennaType
3
RadomeType
See Table 20: Antenna Type on the next page or Table 14: User-Defined Antenna Type on page 66
See Table 21: Radome Type on page 95
Description
Command header. See Messages on page 25 for more information.
Antenna type
Radome type (default = NONE)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
84
Chapter 2 GNSS Commands
Field
Field Type
4
CorrectionType
5
StationID
ASCII Value
Binary Value
See Table 53: DGPS Type on page 286
Char [8] or ANY
Description
Format
Binary Bytes
Binary Offset
Correction type (default = AUTO)
Enum 4
H+8
Base station ID
(default =
Char
8
ANY)
H+12
The latest information can be obtained from the National Geodetic Survey (NGS) site www.ngs.noaa.gov/ANTCAL.
Table 20: Antenna Type
Value
Name
Description
0 NONE
No antenna model
2 AUTO
Determine the antenna model from the RTK corrections (Not valid for THISANTENNATYPE)
3 AERAT2775_43
4 AOAD_M_B
5 AOAD_M_T
AOAD/M_T
6 AOAD_M_TA_NGS AOAD/M_TA_NGS
7 APSAPS-3
8 ASH700228A
9 ASH700228B
10 ASH700228C
11 ASH700228D
12 ASH700228E
13 ASH700699.L1
14 ASH700700.A
15 ASH700700.B
16 ASH700700.C
17 ASH700718A
OEM7 Commands and Logs Reference Manual v10
85
Chapter 2 GNSS Commands
Value
Name
18 ASH700718B
19 ASH700829.2
20 ASH700829.3
21 ASH700829.A
22 ASH700829.A1
23 ASH700936A_M
24 ASH700936B_M
25 ASH700936C_M
26 ASH700936D_M
27 ASH700936E
28 ASH700936E_C
29 ASH700936F_C
30 ASH701008.01B
31 ASH701073.1
32 ASH701073.3
33 ASH701933A_M
34 ASH701933B_M
35 ASH701933C_M
36 ASH701941.1
37 ASH701941.2
38 ASH701941.A
39 ASH701941.B
40 ASH701945B_M
41 ASH701945C_M
42 ASH701945D_M
43 ASH701945E_M
44 ASH701945G_M
45 ASH701946.2
Description
OEM7 Commands and Logs Reference Manual v10
86
Chapter 2 GNSS Commands
Value
Name
46 ASH701946.3
47 ASH701975.01A
48 ASH701975.01AGP
49 JAV_GRANT-G3T
50 JAV_RINGANT_G3T
51 JAVRINGANT_DM
52 JNSMARANT_GGD
53 JPLD/M_R
54 JPLD/M_RA_SOP
55 JPSLEGANT_E
56 JPSODYSSEY_I
57 JPSREGANT_DD_E
58 JPSREGANT_SD_E
59 LEIAR10
60 LEIAR25
61 LEIAR25.R3
62 LEIAR25.R4
63 LEIAS05
64 LEIAX1202GG
65 LEIAS10
66 LEIAX1203+GNSS
67 LEIAT202+GP
68 LEIAT202-GP
69 LEIAT302+GP
70 LEIAT302-GP
71 LEIAT303
72 LEIAT502
73 LEIAT503
Description
OEM7 Commands and Logs Reference Manual v10
87
Chapter 2 GNSS Commands
Value
Name
74 LEIAT504
75 LEIAT504GG
76 LEIATX1230
77 LEIATX1230+GNSS
78 LEIATX1230GG
79 LEIAX1202
80 LEIGG02PLUS
81 LEIGS08
82 LEIGS09
83 LEIGS12
84 3S-02-TSADM
85 3S-02-TSATE
86 LEIGS15
87 LEIMNA950GG
88 LEISR299_INT
89 LEISR399_INT
90 LEISR399_INTA
91 MAC4647942
92 MPL_WAAS_2224NW
93 MPL_WAAS_2225NW
94 MPLL1_L2_SURV
95 NAVAN2004T
96 NAVAN2008T
97 NAX3G+C
98 NOV_WAAS_600
99 NOV501
100 NOV501+CR
101 NOV502
Description
OEM7 Commands and Logs Reference Manual v10
88
Chapter 2 GNSS Commands
Value
Name
102 NOV502+CR
103 NOV503+CR
104 NOV531
105 NOV531+CR
106 NOV600
107 NOV702
108 NOV702GG
109 NOV750.R4
110 SEN67157596+CR
111 SOK_RADIAN_IS
112 SOK502
113 SOK600
114 SOK702
115 SPP571212238+GP
116 STXS9SA7224V3.0
117 TOP700779A
118 TOP72110
119 TPSCR.G3
120 TPSCR3_GGD
121 TPSCR4
122 TPSG3_A1
123 TPSHIPER_GD
124 TPSHIPER_GGD
125 TPSHIPER_LITE
126 TPSHIPER_PLUS
127 TPSLEGANT_G
128 TPSLEGANT2
129 TPSLEGANT3_UHF
Description
OEM7 Commands and Logs Reference Manual v10
89
Chapter 2 GNSS Commands
Value
Name
130 TPSODYSSEY_I
131 TPSPG_A1
132 TPSPG_A1+GP
133 TRM14177.00
134 TRM14532.00
135 TRM14532.10
136 TRM22020.00+GP
137 TRM22020.00-GP
138 TRM23903.00
139 TRM27947.00+GP
140 TRM27947.00-GP
141 TRM29659.00
142 TRM33429.00+GP
143 TRM33429.00-GP
144 TRM33429.20+GP
145 TRM39105.00
146 TRM41249.00
147 TRM41249USCG
148 TRM4800
149 TRM55971.00
150 TRM57970.00
151 TRM57971.00
152 TRM5800
153 TRM59800.00
154 TRM59800.80
155 TRM59900.00
156 TRMR8_GNSS
157 TRMR8_GNSS3
Description
OEM7 Commands and Logs Reference Manual v10
90
Chapter 2 GNSS Commands
Value
Name
158 ASH701023.A
159 CHCC220GR
160 CHCC220GR2
161 CHCX91+S
162 GMXZENITH10
163 GMXZENITH20
164 GMXZENITH25
165 GMXZENITH25PRO
166 GMXZENITH35
167 JAVRINGANT_G5T
168 JAVTRIUMPH_1M
169 JAVTRIUMPH_1MR
170 JAVTRIUMPH_2A
171 JAVTRIUMPH_LSA
172 JNSCR_C146-22-1
173 JPSREGANT_DD_E1
174 JPSREGANT_DD_E2
175 JPSREGANT_SD_E1
176 JPSREGANT_SD_E2
177 LEIAR20
178 LEIGG03
179 LEIGS08PLUS
180 LEIGS14
181 LEIICG60
182 NOV533+CR
183 NOV703GGG.R2
184 NOV750.R5
185 RNG80971.00
Description
OEM7 Commands and Logs Reference Manual v10
91
Chapter 2 GNSS Commands
Value
Name
186 SEPCHOKE_B3E6
187 SEPCHOKE_MC
188 STXS10SX017A
189 STXS8PX003A
190 STXS9PX001A
191 TIAPENG2100B
192 TIAPENG2100R
193 TIAPENG3100R1
194 TIAPENG3100R2
195 TPSCR.G5
196 TPSG5_A1
197 TPSPN.A5
198 TRM55970.00
199 TRMR10
200 TRMR4-3
201 TRMR6-4
202 TRMR8-4
203 TRMR8S
204 TRMSPS985
205 AERAT1675_120
206 ITT3750323
207 NOV702GGL
208 NOV704WB
209 ARFAS1FS
210 CHAPS9017
211 CHCI80
212 GMXZENITH15
213 HXCCGX601A
Description
OEM7 Commands and Logs Reference Manual v10
92
Chapter 2 GNSS Commands
Value
Name
214 IGAIG8
215 LEICGA60
216 LEIGS15.R2
217 LEIGS16
218 MVEGA152GNSSA
219 SEPALTUS_NR3
220 SJTTL111
221 SOKGCX3
222 SOKSA500
223 STHCR3-G3
224 STXS9I
225 TPSCR.G5C
226 TPSHIPER_HR
227 TPSHIPER_HR+PS
228 TRM105000.10
229 TRM115000.00
230 TRM115000.10
231 TRMR2
232 TWIVP6000
233 TWIVP6050_CONE
234 JAVTRIUMPH_2A+G
235 JAVTRIUMPH_2A+P
236 LEIGS18
237 LEIGG04PLUS
238 STXS800
239 STXS800A
240 NOV850
241 TRM159800.00
Description
OEM7 Commands and Logs Reference Manual v10
93
Chapter 2 GNSS Commands
Value
Name
242 TRM159900.00
1001 USER_ANTENNA_1
1002 USER_ANTENNA_2
1003 USER_ANTENNA_3
1004 USER_ANTENNA_4
1005 USER_ANTENNA_5
Description
User defined antenna type 1 User defined antenna type 2 User defined antenna type 3 User defined antenna type 4 User defined antenna type 5
Table 21: Radome Type
Value
Name
0
NONE
1
SPKE
2
SNOW
3
SCIS
4
SCIT
5
OLGA
6
PFAN
7
JVDM
8
LEIT
9
LEIC
10
LEIS
11
MMAC
12
NOVS
13
TPSH
14
CONE
15
TPSD
16
TCWD
17
UNAV
18
TZGD
19
CHCD
OEM7 Commands and Logs Reference Manual v10
94
Chapter 2 GNSS Commands
Value 20 21 22 23 24 25 26 27
Name JAVC LEIM NOVC ARFC HXCS JVGR STHC DUTD
OEM7 Commands and Logs Reference Manual v10
95
Chapter 2 GNSS Commands
2.17 BDSECUTOFF
Sets elevation cut-off angle for BeiDou satellites
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the elevation cut-off angle for tracked BeiDou satellites. The receiver does not start automatically searching for a BeiDou satellite until it rises above the cutoff angle (when satellite position is known). Tracked satellites that fall below the cut-off angle are no longer tracked unless they are manually assigned (see the ASSIGN command on page 68). In either case, satellites below the BDSECUTOFF angle are eliminated from the internal position and clock offset solution computations. This command permits a negative cut-off angle; it could be used in these situations:
l The antenna is at a high altitude, and thus can look below the local horizon l Satellites are visible below the horizon due to atmospheric refraction
Care must be taken when using BDSECUTOFF command because the signals from lower elevation satellites are traveling through more atmosphere and are therefore degraded. Use of satellites below 5 degrees is not recommended.
Use the ELEVATIONCUTOFF command on page 141 to set the cut-off angle for all other systems.
For dual antenna receivers, this command applies to both the primary and secondary antennas.
Message ID: 1582
Abbreviated ASCII Syntax: BDSECUTOFF angle
Factory Default: BDSECUTOFF 5.0
ASCII Example: BDSECUTOFF 10.0
OEM7 Commands and Logs Reference Manual v10
96
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
1
BDSECUTOFF header
-
-
Command header. See Messages on page 25 for more information.
2
angle
�90.0 degrees
Elevation cut-off angle relative to horizon
Format
Binary Bytes
Binary Offset
-
H
0
Float
4
H
OEM7 Commands and Logs Reference Manual v10
97
Chapter 2 GNSS Commands
2.18 BESTVELTYPE
Sets the velocity used in the BESTVEL and GPVTG logs
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command configures the source of the velocity that is output in the BESTVEL and GPVTG logs. Set the type to something other than BESTPOS when an unchanging velocity source with specific characteristics is needed. The Doppler velocity is the highest-availability, lowest-latency velocity available from the receiver. Due to its low latency, it is also the noisiest velocity.
Message ID: 1678
Abbreviated ASCII Syntax: BESTVELTYPE mode
Factory Default: BESTVELTYPE bestpos
ASCII Example: BESTVELTYPE doppler
Field Field Type
Description
1
BESTVELTYPE Command header. See Messages on
header
page 25 for more information.
2
mode
Velocity type (see Table 22: Velocity Types below)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Table 22: Velocity Types
ASCII Binary
Description
BESTPOS
1
Use the velocity from the same positioning filter that is being used to fill BESTPOS and GPGGA
DOPPLER
2
Always fill BESTVEL using Doppler-derived velocities
OEM7 Commands and Logs Reference Manual v10
98
Chapter 2 GNSS Commands
2.19 CANCONFIG
Configure CAN ports
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use the CANCONFIG command to configure the hardware parameters of the CAN ports.
Message ID: 884
Abbreviated ASCII Syntax: CANCONFIG port switch [speed]
Factory Default: CANCONFIG CAN1 OFF 250K CANCONFIG CAN2 OFF 250K
ASCII Example: CANCONFIG CAN1 OFF 500K
Field
Field Type
ASCII Value
Binary Value
Description
1
CANCONFIG header
-
-
Command header. See Messages on page 25 for more information.
2
port
CAN1 1 CAN2 2
Physical CAN port ID
3
switch
ON
1
OFF
0
Sets the port to be On or Off the CAN bus
4
speed
See Table 23: CAN Port Speed below
Physical CAN port speed (bits per second) (default = 250K
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4 Enum 4
H H+4
Enum 4
H+8
The CAN port must be set to OFF (using CANCONFIG <port> OFF) before the port speed can be changed.
Table 23: CAN Port Speed
ASCII Value Binary Value
10K
0
20K
1
OEM7 Commands and Logs Reference Manual v10
99
Chapter 2 GNSS Commands
ASCII Value Binary Value
50K
2
100K
3
125K
4
250K
5
500K
6
1M
7
OEM7 Commands and Logs Reference Manual v10
100
Chapter 2 GNSS Commands
2.20 CCOMCONFIG
Configure the CAN COM port
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Bind a CAN communication port to a J1939 node (see J1939CONFIG command on page 221) and specify the CAN protocol, PGN, priority and address for messages transmitted and received over the CCOM port.
Message ID: 1902
Abbreviated ASCII Syntax: CCOMCONFIG port node protocol [pgn [priority [address]]]
Factory Default: CCOMCONFIG ccom1 node1 J1939 61184 7 fe CCOMCONFIG ccom2 node2 J1939 61184 7 fe CCOMCONFIG ccom3 node1 J1939 126720 7 fe CCOMCONFIG ccom4 none none 0 0 0 CCOMCONFIG ccom5 none none 0 0 0 CCOMCONFIG ccom6 none none 0 0 0
ASCII Example : ccomconfig ccom1 node1 j1939 1792 6 1b
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
CCOMCONFIG Header
-
-
Command header. See Messages on page 25 for more information.
H
0
CCOM1 38
CCOM2 39
2
port
CCOM3 40 CCOM4 41
Name of CCOM port
Enum 4
H
CCOM5 42
CCOM6 43
3
node
NODE1 1 NODE2 2
The J1939 node to use.
This binds a CCOM port to the CAN NAME/address
Enum
4
associated with the node.
H+4
OEM7 Commands and Logs Reference Manual v10
101
Chapter 2 GNSS Commands
Field Field Type
4
protocol
5
pgn
6
priority
7
address
ASCII Binary Value Value
Description
See Table 24: CAN Protocol on the next page
CAN transport protocol to use
0 - 131071
Any valid PGN as defined by the J1939 protocol.
All messages transmitted over this CCOM port will contain this PGN value.
Only messages with this PGN will be received on this CCOM port
Note: This value is ignored if the protocol is NMEA2000.
Default CAN message
priority for transmitted
messages. (Priority 0 is
0-7
the highest priority)
Note: This value is ignored if the protocol is NMEA2000.
00 � FF
00 � FD: Transmit and receive messages to/from this address only
FE: Transmit and receive message to/from the address of the first message received
FF: Broadcast messages and receive messages from all addresses.
Note: This value is ignored if the protocol is NMEA2000.
Format
Binary Bytes
Binary Offset
Enum 4
H+8
Ulong 4
H+12
Uchar 1
H+16
Hex
1
H+17
OEM7 Commands and Logs Reference Manual v10
102
Chapter 2 GNSS Commands
Table 24: CAN Protocol
Binary ASCII
Description
2
J1939
J1939 single packet
3
NMEA2000 NMEA2000 (single packet, multi-packet, fast packet)
5
ISO11783 ISO 11783 transport protocol
OEM7 Commands and Logs Reference Manual v10
103
Chapter 2 GNSS Commands
2.21 CLOCKADJUST
Enables clock adjustments
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
All oscillators have some inherent drift. By default, the receiver attempts to steer the receiver's clock to accurately match GPS reference time. Use the CLOCKADJUST command to disable this function. The TIME log can then be used to monitor clock drift.
1. The CLOCKADJUST command should only be used by advanced users. 2. If the CLOCKADJUST command is ENABLED and the receiver is configured to use an
external reference frequency (set in the EXTERNALCLOCK command (see page 151) for an external clock - TCXO, OCXO, RUBIDIUM, CESIUM, or USER), then the clock steering process takes over the VARF output pins and may conflict with a previously entered FREQUENCYOUT command (see page 176). 3. When using the EXTERNALCLOCK and CLOCKADJUST commands together, issue the EXTERNALCLOCK command (see page 151) first to avoid losing satellites. 4. When disabled, the range measurement bias errors continue to accumulate with clock drift. 5. Pseudorange, carrier phase and Doppler measurements may jump if the CLOCKADJUST mode is altered while the receiver is tracking. 6. When disabled, the time reported on all logs may be offset from GPS reference time. The 1PPS output may also be offset. The amount of this offset may be determined from the TIME log (see page 855). 7. A discussion on GPS reference time may be found in GPS Reference Time Status on page 45.
Message ID: 15
Abbreviated ASCII Syntax: CLOCKADJUST switch
Factory Default: CLOCKADJUST ENABLE
ASCII Example: CLOCKADJUST DISABLE
The CLOCKADJUST command can be used to calibrate an internal oscillator. Disable the CLOCKADJUST mode in order to find out what the actual drift is from the internal oscillator. Watch the CLOCKMODEL log to see the drift rate and adjust the oscillator until the drift stops.
OEM7 Commands and Logs Reference Manual v10
104
Chapter 2 GNSS Commands
Field Field Type
ASCII Binary Value Value
Description
1
CLOCKADJUST header
-
Command header. See
-
Messages on page 25
for more information.
2
switch
DISABLE 0 ENABLE 1
Disallow adjustment of internal clock
Allow adjustment of internal clock
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
105
Chapter 2 GNSS Commands
2.22 CLOCKCALIBRATE
Adjusts clock steering parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to adjust the control parameters of the clock steering loop. The receiver must be enabled for clock steering before these values can take effect. Refer to the CLOCKADJUST command on page 105 to enable or disable clock steering. To disable the clock steering process, issue the CLOCKADJUST DISABLE command. The current values used by the clock steering process are listed in the CLOCKSTEERING command (see page 463).
The values entered using the CLOCKCALIBRATE command are saved to non-volatile memory (NVM). To restore the values to their defaults, the FRESET CLKCALIBRATION command must be used. Issuing FRESET without the CLKCALIBRATION parameter will not clear the values (see FRESET command on page 179 for more details).
Message ID: 430
Abbreviated ASCII Syntax: CLOCKCALIBRATE [mode] [period] [pulsewidth] [slope] [bandwidth]
ASCII Example: CLOCKCALIBRATE AUTO
The receiver by default steers its INTERNAL VCTCXO but can be commanded to control an EXTERNAL reference oscillator. Use the EXTERNALCLOCK command (see page 151) to configure the receiver to use an external reference oscillator. If the receiver is configured for an external reference oscillator and configured to adjust its clock, then the clock steering loop attempts to steer the external reference oscillator through the use of the VARF signal. Note that the clock steering control process conflicts with the manual FREQUENCYOUT command (see page 176). It is expected that the VARF signal is used to provide a stable reference voltage by the use of a filtered charge pump type circuit (not supplied).
Field
Field Type
ASCII Binary Value Value
Description
CLOCK
1
CALIBRATE -
-
header
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
106
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
SET 0
Sets the period, pulsewidth, slope and bandwidth values into NVM for the currently selected steered oscillator (INTERNAL or EXTERNAL)
Forces the receiver to do a
clock steering calibration to
measure the slope (change in
clock drift rate with a 1 bit
change in pulse width) and
2
mode
required pulsewidth to zero Enum 4
H
AUTO 1
the clock drift rate. After the
calibration, these values
along with the period and
bandwidth are entered into
NVM and are then used from
this point forward on the
selected oscillator
OFF 2
Terminates a calibration process currently underway (default)
3
period
0 to 262144
Signal period in 10 ns steps.
Frequency Output = 100,000,000 / Period (default=11000)
Ulong 4
H+4
Sets the initial pulse width
that should provide a near
zero drift rate from the
selected oscillator being
4
pulsewidth
The valid range for this parameter is 10% to 90% of the period
steered. The valid range for this parameter is 10% to 90% of the period. If this value is not known, (in the case of a new external oscillator) then it should be
Ulong
4
set to � the period and the
mode should be set to AUTO
to force a calibration
(default=6600)
H+8
OEM7 Commands and Logs Reference Manual v10
107
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
5
slope
This value should correspond
to how much the clock drift
changes with a 1 bit change
in the pulsewidth m/s/bit.
The default values for the
slope used for the INTERNAL
and EXTERNAL clocks is -2.0
and -0.01 respectively. If this
value is not known, then its
value should be set to 1.0
and the mode should be set
to AUTO to force a
calibration. Once the calibration process is
Float
4
complete and using a slope
value of 1.0, the receiver
should be recalibrated using
the measured slope and
pulsewidth values (see the
CLOCKSTEERING log on
page 463). This process
should be repeated until the
measured slope value
remains constant (less than a
5% change)
(default=0.774)
H+12
6
bandwidth
This is the value used to
control the smoothness of the
clock steering process.
Smaller values result in
slower and smoother
changes to the receiver
clock. Larger values result in
faster responses to changes Float
4
in oscillator frequency and
faster start up clock pull in.
The default values are 0.03
and 0.001 Hz respectively for
the INTERNAL and EXTERNAL
clocks
(default=0.03)
H+16
OEM7 Commands and Logs Reference Manual v10
108
Chapter 2 GNSS Commands
2.23 CLOCKOFFSET
Adjusts for delay in 1PPS output
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to remove a delay in the PPS output. The PPS signal is delayed from the actual measurement time due to two major factors:
l A delay in the signal path from the antenna to the receiver l An intrinsic delay through the RF and digital sections of the receiver The second delay is automatically accounted for by the receiver using a nominal value determined for each receiver type. However, since the delay from the antenna to the receiver cannot be determined by the receiver, an adjustment cannot automatically be made. The CLOCKOFFSET command can be used to adjust for this delay.
Message ID: 596
Abbreviated ASCII Syntax: CLOCKOFFSET offset
Factory Default: CLOCKOFFSET 0
ASCII Example: CLOCKOFFSET -15
There may be small variances in the delays for each cable or card. The CLOCKOFFSET command can be used to characterize each setup. For example, for a cable with a delay of 10 ns, the offset can be set to -10 to remove the delay from the PPS output.
Field
Field Type
ASCII Binary Value Value
Description
1
CLOCKOFFSET header
-
-
Command header. See Messages on page 25 for more information.
2
offset
�200
Specifies the offset in nanoseconds
Format
Binary Bytes
Binary Offset
-
H
0
Long
4
H
OEM7 Commands and Logs Reference Manual v10
109
Chapter 2 GNSS Commands
2.24 CNOUPDATE
Sets the C/No update rate
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to set the C/No update rate.
Message ID: 849
Abbreviated ASCII Syntax: CNOUPDATE rate
Factory Default: CNOUPDATE default
ASCII Example: CNOUPDATE 20Hz
Use the CNOUPDATE command for higher resolution update rate of the C/No measurements of the incoming GNSS signals. By default, the C/No values are calculated at approximately 4 Hz but this command allows you to increase that rate to 20 Hz.
Field Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
1
CNOUPDATE header
-
Command header. See
-
Messages on page 25 for -
more information.
H
0
2
rate
DEFAULT 0
C/No update rate: 0 = Turn off C/No
enhancement
Enum 4
H
20HZ
1
default = 4 Hz 1 = 20 Hz C/No updates
OEM7 Commands and Logs Reference Manual v10
110
Chapter 2 GNSS Commands
2.25 COMCONTROL
Controls the serial port hardware control lines
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to control the hardware control lines of the serial communication (COM) ports. The TOGGLEPPS mode of this command is typically used to supply a timing signal to a host PC computer by using the RTS and DTR lines. The accuracy of controlling the COM control signals is better than 900 �s. The other modes are typically used to control custom peripheral devices.
1. If handshaking is disabled, any of these modes can be used without affecting regular serial communications through the selected COM port. However, if handshaking is enabled, it may conflict with handshaking of the selected COM port, causing unexpected results.
2. The PULSEPPSLOW control type cannot be issued for a TX signal. 3. Only PULSEPPSHIGH, FORCEHIGH and FORCELOW control types can be used for a TX
signal. 4. To use the COM2 flow control signals, COM5 must be disabled. See OEM7600, OEM7700
and OEM7720 Multiplexed Port in the OEM7 Installation and Operation User Manual for more information.
Message ID: 431
Abbreviated ASCII Syntax: COMCONTROL [port] [signal] [control]
Factory Default: COMCONTROL COM1 RTS DEFAULT COMCONTROL COM2 RTS DEFAULT COMCONTROL COM3 RTS DEFAULT COMCONTROL COM4 RTS DEFAULT COMCONTROL COM5 RTS DEFAULT
ASCII Example 1: SERIALCONFIG COM1 9600 N 8 1 N (to disable handshaking) COMCONTROL COM1 RTS FORCELOW
ASCII Example 2: COMCONTROL COM1 RTS TOGGLEPPS COMCONTROL COM2 RTS TOGGLEPPS
ASCII Example 3: To set a break condition on COM1:
COMCONTROL COM1 TX FORCELOW A break condition remains in effect until it is cleared. To clear a break condition on COM1:
OEM7 Commands and Logs Reference Manual v10
111
Chapter 2 GNSS Commands
COMCONTROL COM1 TX DEFAULT or
COMCONTROL COM1 TX FORCEHIGH
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
COM
1
CONTROL -
header
Command header.
-
See Messages on page 25 for more
-
information.
H
0
COM1
1
COM2
2
2
port
COM3
3
Serial port to control. Enum 4
H
COM4
19
COM5
31
RTS
3
signal
DTR
TX
COM signal to control.
0
The controllable COM
signals are RTS, DTR
and TX. (Default =
1
RTS)
Enum 4
H+4
See also Table 25:
Tx, DTR and RTS
2
Availability on the
next page
OEM7 Commands and Logs Reference Manual v10
112
Chapter 2 GNSS Commands
Field
Field Type
4
control
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Disables this
DEFAULT
0
command and returns the COM signal to its
default state (Default)
FORCEHIGH
1
Immediately forces the signal high
FORCELOW
2
Immediately forces the signal low
TOGGLE
Immediately toggles
3
the current state of
the signal
TOGGLEPPS
4
Toggles the state of the selected signal within 900 s after each 1PPS event. The Enum 4 state change of the signal lags the 1PPS by an average value of 450 s. The delay of each pulse varies by a uniformly random amount less than 900 s
H+8
PULSEPPSLOW 5
Pulses the line low at a 1PPS event and to high 1 ms after it. Not for TX
PULSEPPSHIGH 6
Pulses the line high for 1 ms at the time of a 1PPS event
OEM719 OEM729 OEM7600 OEM7700 OEM7720
Table 25: Tx, DTR and RTS Availability
Tx Available On
DTR Available On
COM1, COM2, COM3
N/A
COM1, COM2, COM3
N/A
COM1, COM2, COM3, COM4, COM5
N/A
COM1, COM2, COM3, COM4, COM5
N/A
COM1, COM2, COM3, COM4, COM5
N/A
RTS Available On N/A
COM1 and COM2 COM1 and COM2 COM1 and COM2 COM1 and COM2
OEM7 Commands and Logs Reference Manual v10
113
Chapter 2 GNSS Commands
2.26 DATADECODESIGNAL
Enable/Disable navigation data decoding for GNSS signal
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to enable or disable framing and decoding of the navigation message for each GNSS signal. When disabled, the receiver will no longer output raw frame data, ephemeris or almanac data from that signal. Signals which do not yet have the built in capability to output raw frame data are not configurable. Note that if a primary signal such as GPSL1CA is disabled, it may cause the receiver to no longer function normally because this signal's data is essential for setting receiver time and computing positions.
The default setting for each GNSS signal, and which signals can be configured, is available in Table 26: GNSS Signal Default and Configurability below. The table also lists if the signal's navigation message is used to compute the satellite position. For the binary value and a longer description for each signal, see Table 27: Signal Type (DATADECODESIGNAL) on page 117.
Table 26: GNSS Signal Default and Configurability
Signal
Primary Signal
Default
Configurable
Used for satellite positioning
GPSL1C
No
Disabled No
No
GPSL1CA
Yes
Enabled Yes
Yes
GPSL2Y
No
Disabled No
No
GPSL2C
No
Disabled Yes
No
GPSL2P
No
Disabled No
No
GPSL5
No
Disabled Yes
No
GLOL1CA
Yes
Enabled Yes
Yes
GLOL2CA
No
Disabled No
No
GLOL2P
No
Disabled No
No
GLOL3
No
Disabled No
No
SBASL1
No
Enabled Yes
Yes
SBASL5
No
Enabled Yes
Yes
GALE1
Yes
Enabled Yes
Yes
GALE5A
No
Enabled Yes
No
GALE5B
No
Enabled Yes
Yes
GALALTBOC No
Disabled No
No
OEM7 Commands and Logs Reference Manual v10
114
Chapter 2 GNSS Commands
Signal
Primary Signal
Default
Configurable
Used for satellite positioning
GALE6B
No
Enabled Yes
No
GALE6C
No
Enabled Yes
No
BDSB1C
No
Disabled No
No
BDSB1D1
Yes
Enabled Yes
Yes
BDSB1D2
Yes
Enabled Yes
Yes
BDSB2A
No
Disabled No
No
BDSB2D1
No
Disabled No
No
BDSB2D2
No
Disabled No
No
BDSB3D1
No
Disabled No
No
BDSB3D2
No
Disabled No
No
QZSSL1C
No
Disabled No
No
QZSSL1CA Yes
Enabled Yes
Yes
QZSSL2CM No
Disabled Yes
No
QZSSL5
No
Disabled Yes
No
QZSSL6
No
Disabled No
No
NAVICL5SPS Yes
Enabled Yes
Yes
Message ID: 1532 Abbreviated ASCII Syntax:
DATADECODESIGNAL signaltype switch
Abbreviated ASCII Example: DATADECODESIGNAL GPSL2C enable
Field Field Type
ASCII Value
DATADECODE
1
SIGNAL
-
header
Binary Value
-
Description
Format
Binary Bytes
Binary Offset
Command
header. See
Messages on
-
page 25 for more
information.
H
0
OEM7 Commands and Logs Reference Manual v10
115
Chapter 2 GNSS Commands
Field Field Type
2
signal type
3
switch
ASCII Value
Binary Value
See Table 27: Signal Type (DATADECODESIGNAL) below
Disable
0
Enable
1
Description
Format
Binary Bytes
Binary Offset
GNSS Signal Type
Enum 4
H
Enable or disable the data decoding
Enum
4
H+4
Table 27: Signal Type (DATADECODESIGNAL)
Value (Binary) Signal (ASCII)
Description
33
GPSL1CA
GPS L1 C/A-code
69
GPSL2C
GPS L2 C/A-code
70
GPSL2P
GPS L2 P-code
103
GPSL5
GPS L5
2177
GLOL1CA
GLONASS L1 C/A-code
2211
GLOL2CA
GLONASS L2 C/A-code
2212
GLOL2P
GLONASS L2 P-code
2662
GLOL3
GLONASS L3
4129
SBASL1
SBAS L1
4194
SBASL5
SBAS L5
16737
LBAND
LBAND
10433
GALE1
Galileo E1
10466
GALE5A
Galileo E5A
10499
GALE5B
Galileo E5B
10565
GALE6C
Galileo E6C
10572
GALE6B
Galileo E6B
12673
BDSB1D1
BeiDou B1 with D1 navigation data
12674
BDSB1D2
BeiDou B1 with D2 navigation data
12803
BDSB2D1
BeiDou B2 with D1 navigation data
12804
BDSB2D2
BeiDou B2 with D2 navigation data
OEM7 Commands and Logs Reference Manual v10
116
Chapter 2 GNSS Commands
Value (Binary) Signal (ASCII)
Description
12877
BDSB3D1
BeiDou B3 with D1 navigation data
12880
BDSB3D2
BeiDou B3 with D2 navigation data
12979
BDSB1C
BeiDou B1C
13012
BDSB2A
BeiDou B2a
14753
QZSSL1CA
QZSS L1 C/A-code
14787
QZSSL2CM
QZSS L2 C/A-code
14820
QZSSL5
QZSS L5
19073
NAVICL5SPS
NavIC L5 SPS
OEM7 Commands and Logs Reference Manual v10
117
Chapter 2 GNSS Commands
2.27 DATUM
Chooses a datum name type
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to select the geodetic datum for operation of the receiver. If not set, the factory default value is wgs84. See the USERDATUM command (see page 392) for user definable datums. The datum you select causes all position solutions to be based on that datum.
This command is not suitable for use with RTK.
The transformation for the WGS84 to Local used in the OEM7 family is the Bursa-Wolf transformation or reverse Helmert transformation. In the Helmert transformation, the rotation of a point is counter clockwise around the axes. In the Bursa-Wolf transformation, the rotation of a point is clockwise. Therefore, the reverse Helmert transformation is the same as the BursaWolf. See Table 29: Datum Transformation Parameters on page 121 for a complete listing of all available predefined datums. The offsets in the table are from the local datum to WGS84.
Message ID: 160
Abbreviated ASCII Syntax: DATUM datum
Factory Default: DATUM wgs84
ASCII Example: DATUM CSRS
Also, as an example, you can achieve spatial integrity with Government of Canada maps and surveys if the coordinates are output using the CSRS datum (Datum ID# 64). Table 28: Reference Ellipsoid Constants on the next page contains the internal ellipsoid and transformation parameters used in the receiver. The values contained in these tables were derived from the following dma reports: 1 TR 8350.2 Department of Defense World Geodetic System 1984 and Relationships
with Local Geodetic Systems - Revised March 1, 1988 2 TR 8350.2B Supplement to Department of Defense World Geodetic System 1984
Technical Report - Part II - Parameters, Formulas, and Graphics for the Practical Application of WGS84 - December 1, 1987 3 TR 8350.2 Department of Defense World Geodetic System 1984 National Imagery and Mapping Agency Technical Report, Third Addition, Amendment 1 January 3, 2000
OEM7 Commands and Logs Reference Manual v10
118
Chapter 2 GNSS Commands
By default, NovAtel receivers output positions in WGS84, with the following exceptions:
EGNOS, TerraStar and Veripos use ITRF2008, which is coincident with WGS84 at about the decimetre level.
Field
Field Type
ASCII Value
Binary Value
1
DATUM header
-
-
See Table 29: Datum
2
Datum Transformation Type Parameters on the next
page
Description
Command header. See Messages on page 25 for more information.
The datum to use
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Table 28: Reference Ellipsoid Constants
ELLIPSOID
ID CODE
a (metres)
1/f
f
Airy 1830
AW
6377563.396 299.3249646 0.00334085064038
Modified Airy
AM
6377340.189 299.3249646 0.00334085064038
Australian National
AN
6378160.0 298.25
0.00335289186924
Bessel 1841
BR
6377397.155 299.1528128 0.00334277318217
Clarke 1866
CC
6378206.4 294.9786982 0.00339007530409
Clarke 1880
CD
6378249.145 293.465
0.00340756137870
Everest (India 1830)
EA
6377276.345 300.8017
0.00332444929666
Everest (Brunei & E.Malaysia)
EB
6377298.556 300.8017
0.00332444929666
Everest (W.Malaysia & Singapore)
EE
6377304.063 300.8017
0.00332444929666
Geodetic Reference System 1980 RF
6378137.0 298.257222101 0.00335281068118
Helmert 1906
HE
6378200.0 298.30
0.00335232986926
Hough 1960
HO
6378270.0 297.00
0.00336700336700
International 1924
IN
6378388.0 297.00
0.00336700336700
Parameters of the Earth
PZ-90.02 6378136.0 298.26
0.00335280374302
South American 1969
SA
6378160.0 298.25
0.00335289186924
OEM7 Commands and Logs Reference Manual v10
119
Chapter 2 GNSS Commands
ELLIPSOID World Geodetic System 1972 World Geodetic System 1984
ID CODE
WD
WE
a (metres)
1/f
f
6378135.0 6378137.0
298.26
0.00335277945417
298.257223563 0.00335281066475
The default user datum is WGS84. See also the USERDATUM command (see page 392) and USEREXPDATUM command (see page 394). The following logs report the datum used according to the Datum ID column:
l BESTPOS log (see page 433) l BESTUTM log (see page 446) l MATCHEDPOS log (see page 601) l PSRPOS log (see page 662)
Datum ID#
NAME
1
ADIND
2
ARC50
3
ARC60
Table 29: Datum Transformation Parameters
DX1 DY1 DZ1
DATUM DESCRIPTION
-162 -12 -143 -90 -160 -8
206
This datum has been updated, see ID# 652
-294 ARC 1950 (SW & SE Africa)
-300
This datum has been updated, see ID# 662
4
AGD66 -133 -48 148 Australian Geodetic Datum 1966
5
AGD84 -134 -48 149 Australian Geodetic Datum 1984
6
BUKIT -384 664 -48 Bukit Rimpah (Indonesia)
7
ASTRO -104 -129 239 Camp Area Astro (Antarctica)
8
CHATM 175 -38 113 Chatham 1971 (New Zealand)
9
CARTH -263 6
431 Carthage (Tunisia)
ELLIPSOID
Clarke 1880
Clarke 1880
Clarke 1880
Australian National Australian National Bessel 1841 International 1924 International 1924 Clarke 1880
1The DX, DY and DZ offsets are from your local datum to WGS84. 2The updated datum have the new x, y and z translation values updated to the latest numbers. The old datum values can still be used for backwards compatibility.
OEM7 Commands and Logs Reference Manual v10
120
Chapter 2 GNSS Commands
Datum ID#
NAME
10 CAPE
11 DJAKA
12 EGYPT
DX1 DY1 DZ1
DATUM DESCRIPTION
-136 -108 -292 CAPE (South Africa) -377 681 -50 Djakarta (Indonesia) -130 110 -13 Old Egyptian
13 ED50
-87 -98 -121 European 1950
14 ED79
-86 -98 -119 European 1979
15 GUNSG -403 684 41 G. Segara (Kalimantan - Indonesia)
16 GEO49 84 -22 209 Geodetic Datum 1949 (New Zealand)
17 GRB36 375 -111 431 Do not use. Use ID# 76 instead2
18 GUAM -100 -248 259 Guam 1963 (Guam Island)
19
HAWAII 89
-279
-183
Do not use. Use ID# 77 or ID# 81 instead3
20
KAUAI 45
-290
-172
Do not use. Use ID# 78 or ID# 82 instead3
21 MAUI
65
-290
-190
Do not use. Use ID# 79 or ID# 83 instead3
22
OAHU
56
-284
-181
Do not use. Use ID# 80 or ID# 84 instead3
23 HERAT -333 -222 114 Herat North (Afghanistan)
24 HJORS -73 46 -86 Hjorsey 1955 (Iceland)
25 HONGK -156 -271 -189 Hong Kong 1963
26
HUTZU
-634
-549
-201
This datum has been updated, see ID# 682
27
INDIA
289
734
257
Do not use. Use ID# 69 or ID# 70 instead3
ELLIPSOID
Clarke 1880 Bessel 1841 Helmert 1906 International 1924 International 1924 Bessel 1841 International 1924 Airy 1830 Clarke 1866
Clarke 1866
Clarke 1866
Clarke 1866
Clarke 1866
International 1924 International 1924 International 1924 International 1924
Everest (EA)
1The DX, DY and DZ offsets are from your local datum to WGS84. 2Use the corrected datum only (with the higher ID#) as the old datum is incorrect.
OEM7 Commands and Logs Reference Manual v10
121
Chapter 2 GNSS Commands
Datum ID#
NAME
28 IRE65
DX1 DY1 DZ1
DATUM DESCRIPTION
506 -122 611 Do not use. Use ID# 71 instead3
ELLIPSOID Modified Airy
29 KERTA -11 851 5
Kertau 1948 (West Malaysia and Singapore)
Everest (EE)
30 KANDA -97 787 86 Kandawala (Sri Lanka)
Everest (EA)
31 LIBER -90 40 88 Liberia 1964 32 LUZON -133 -77 -51 Do not use. Use ID# 72 instead3
Clarke 1880 Clarke 1866
33
MINDA -133 -70
-72
This datum has been updated, see ID# 732
Clarke 1866
34 MERCH 31 146 47 Merchich (Morocco)
Clarke 1880
35
NAHR
-231 -196 482
This datum has been updated, see ID# 742
Clarke 1880
36 NAD83 0
0
0
N. American 1983 (Includes Areas 3742)
GRS-80
37 CANADA -10 158 187 N. American Canada 1927
Clarke 1866
38 ALASKA -5
135 172 N. American Alaska 1927
Clarke 1866
39 NAD27 -8
160 176 N. American Conus 1927
Clarke 1866
40 CARIBB -7
152
178
This datum has been updated, see ID# 752
Clarke 1866
41 MEXICO -12 130 190 N. American Mexico
Clarke 1866
42 CAMER 0
125 194 N. American Central America
Clarke 1866
43 MINNA -92 -93 122 Nigeria (Minna)
Clarke 1880
44 OMAN -346 -1
224 Oman
Clarke 1880
45 PUERTO 11 72 -101 Puerto Rica and Virgin Islands
Clarke 1866
46 QORNO 164 138 -189 Qornoq (South Greenland)
International 1924
47 ROME -255 -65 9
Rome 1940 Sardinia Island
International 1924
1The DX, DY and DZ offsets are from your local datum to WGS84. OEM7 Commands and Logs Reference Manual v10
122
Chapter 2 GNSS Commands
Datum ID#
NAME
48 CHUA
49 SAM56
50 SAM69
51 CAMPO
52 SACOR
53 YACAR
54 TANAN
55 TIMBA
56 TOKYO
57 TRIST 58 VITI 59 WAK60 60 WGS72 61 WGS84 62 ZANDE 63 USER 64 CSRS 65 ADIM
DX1 DY1 DZ1
DATUM DESCRIPTION
-134 229
-29
South American Chua Astro (Paraguay)
-288 175 -376 South American (Provisional 1956)
-57 1
-41 South American 1969
-148 136 90 -206 172 -6
S. American Campo Inchauspe (Argentina)
South American Corrego Alegre (Brazil)
-155 171 37 South American Yacare (Uruguay)
-189 -242 -91 -689 691 -46 -128 481 664
Tananarive Observatory 1925 (Madagascar)
This datum has been updated, see ID# 852
This datum has been updated, see ID# 862
-632 438 -609 Tristan Astro 1968 (Tristan du Cunha)
51 391 -36 Viti Levu 1916 (Fiji Islands)
101 52
-39
This datum has been updated, see ID# 672
0
0
4.5 World Geodetic System - 72
0
0
0
World Geodetic System - 84
-265 120 -358 Zanderidj (Surinam)
0
0
0
User Defined Datum Defaults
Time-variable 7 parameter transformation
-166 -15
204
Adindan (Ethiopia, Mali, Senegal & Sudan)2
ELLIPSOID
International 1924 International 1924 S. American 1969 International 1924 International 1924 International 1924 International 1924
Everest (EB)
Bessel 1841
International 1924 Clarke 1880
Hough 1960
WGS72 WGS84 International 1924 User
Clarke 1880
1The DX, DY and DZ offsets are from your local datum to WGS84. OEM7 Commands and Logs Reference Manual v10
123
Chapter 2 GNSS Commands
Datum ID#
NAME
66 ARSM
67 ENW
DX1 DY1 DZ1
DATUM DESCRIPTION
-160 -6 102 52
-302 -38
ARC 1960 (Kenya, Tanzania)2 Wake-Eniwetok (Marshall Islands)2
68 HTN
-637 -549 -203 Hu-Tzu-Shan (Taiwan)2
69 INDB 70 INDI 71 IRL
282 726 254 Indian (Bangladesh)3 295 736 257 Indian (India, Nepal)3 506 -122 611 Ireland 1965 3
72 LUZA
-133 -77
-51
Luzon (Philippines excluding Mindanoa Is.)3, 2
73 LUZB
-133 -79 -72 Mindanoa Island2
74
NAHC
-243 -192 477 Nahrwan (Saudi Arabia)2
75 NASP
-3
142 183 N. American Caribbean2
76
OGBM
375
-111 431
Great Britain 1936 (Ordinance Survey)3
77
OHAA
89
-279 -183 Hawaiian Hawaii3
78
OHAB
45
-290 -172 Hawaiian Kauaii3
79
OHAC
65
-290 -190 Hawaiian Maui3
80
OHAD
58
-283 -182 Hawaiian Oahu3
81 OHIA
229 -222 -348 Hawaiian Hawaii3
82 OHIB
185 -233 -337 Hawaiian Kauai3
83 OHIC
205 -233 -355 Hawaiian Maui3
84 OHID
198 -226 -347 Hawaiian Oahu3
ELLIPSOID
Clarke 1880 Hough 1960 International 1924 Everest (EA) Everest (EA) Modified Airy
Clarke 1866
Clarke 1866 Clarke 1880 Clarke 1866
Airy 1830
Clarke 1866 Clarke 1866 Clarke 1866 Clarke 1866 International 1924 International 1924 International 1924 International 1924
1The DX, DY and DZ offsets are from your local datum to WGS84. 2The original LUZON values are the same as for LUZA but the original has an error in the code.
OEM7 Commands and Logs Reference Manual v10
124
Chapter 2 GNSS Commands
Datum ID#
NAME
85 TIL
86 TOYM
DX1 DY1 DZ1
DATUM DESCRIPTION
-679 669
-48
Timbalai (Brunei and East Malaysia) 19482
-148 507 685 Tokyo (Japan, Korea and Okinawa)2
ELLIPSOID Everest (EB) Bessel 1841
1The DX, DY and DZ offsets are from your local datum to WGS84. OEM7 Commands and Logs Reference Manual v10
125
Chapter 2 GNSS Commands
2.28 DGPSTXID
Sets DGPS station ID
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to set the station ID value for the receiver when it is transmitting corrections. This allows for the easy identification of which base station was the source of the data. For example, if you want to compare RTCM and RTCMV3 corrections, you would be easily able to identify their base stations by first setting their respective DGPSTXID values.
Message ID: 144
Abbreviated ASCII Syntax: DGPSTXID type ID
Factory Default: DGPSTXID auto ANY
ASCII Examples: DGPSTXID RTCM 2 - using an RTCM type and ID DGPSTXID CMR 30 - using a CMR type and ID DGPSTXID CMR ANY - using the default CMR ID DGPSTXID RTCA d36d - using an RTCA type and ID DGPSTXID RTCMV3 2050 - using an RTCMV3 type and ID
Field
Field Type
ASCII Binary Value Value
Description
1
DGPSTXID header
-
Command header. See
-
Messages on page 25 for
more information.
RTCM 0
2
type
RTCA 1
CMR
2
AUTO 10
See Table 53: DGPS Type on page 286
RTCMV3 13
3
ID
Char[5]
Base Station ID String
See Table 53: DGPS Type on page 286
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Char[5] 8
H+4
OEM7 Commands and Logs Reference Manual v10
126
Chapter 2 GNSS Commands
2.29 DIFFCODEBIASCONTROL
Enables /disables satellite differential code biases
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
The purpose of the differential code biases is to correct pseudorange errors that affect the L1/L2 ionospheric corrections. This command enables or disables the biases. A set of biases is included in the firmware and use of the biases is enabled by default. See also the SETDIFFCODEBIASES command on page 347.
Message ID: 913
Abbreviated ASCII Syntax: DIFFCODEBIASCONTROL switch
Factory Default: DIFFCODEBIASCONTROL enable
Example: DIFFCODEBIASCONTROL disable
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
DIFFCODEBIAS
1
CONTROL
-
header
Command header. See
-
Messages on page 25 -
for more information.
H
0
2
switch
DISABLE 0
Disable the differential code bias
Enum 4
H
ENABLE 1
Enable the differential code bias
OEM7 Commands and Logs Reference Manual v10
127
Chapter 2 GNSS Commands
2.30 DLLTIMECONST
Sets carrier smoothing
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command sets the amount of carrier smoothing performed on the code measurements. An input value of 100 corresponds to approximately 100 seconds of smoothing. Upon issuing the command, the locktime (amount of continuous tracking in seconds) for all tracking satellites is reset to zero and each code smoothing filter is restarted. You must wait for at least the length of smoothing time for the new smoothing constant to take full effect. The optimum setting for this command depends on the application.
1. This command may not be suitable for every GNSS application.
2. When using DLLTIMECONST in differential mode with the same receivers, the same setting should be used at both the base and rover station. If the base and rover stations use different types of receivers, it is recommended that you use the command default value at each receiver (DLLTIMECONST <signaltype> 100).
3. There are several considerations when using the DLLTIMECONST command:
l The attenuation of low frequency noise (multipath) in pseudorange measurements
l The effect of time constants on the correlation of phase and code observations
l The rate of "pulling-in" of the code tracking loop (step response)
l The effect of ionospheric divergence on carrier smoothed pseudorange (ramp response)
4. To get unsmoothed psuedorange measurements, choose 0 as the time constant.
The primary reason for applying carrier smoothing to the measured pseudoranges is to mitigate the high frequency noise inherent in all code measurements. Adding more carrier smoothing by increasing the DLLTIMECONST value filters out lower frequency noise, including some multipath frequencies.
There are also some adverse effects of higher DLLTIMECONST values on some performance aspects of the receiver. Specifically, the time constant of the tracking loop is directly proportional to the DLLTIMECONST value and affects the degree of dependence between the carrier phase and pseudorange information. Carrier phase smoothing of the code measurements (pseudoranges) is accomplished by introducing data from the carrier tracking loops into the code tracking system. Phase and code data, collected at a sampling rate greater than about 3 time constants of the loop, are correlated (the greater the sampling rate, the greater the correlation). This correlation is not relevant if only positions are logged from the receiver, but is an important consideration if the data is combined in some other process such as post-mission carrier smoothing. Also, a narrow bandwidth in a feedback loop impedes the ability of the loop to track step functions. Steps in the pseudorange are encountered during initial lock-on of the satellite and when working in an environment conductive to multipath. A low DLLTIMECONST value allows the receiver to effectively adapt to these situations.
OEM7 Commands and Logs Reference Manual v10
128
Chapter 2 GNSS Commands
Also, increased carrier smoothing may cause problems when satellite signals are strongly affected by the ionosphere. The rate of divergence between the pseudoranges and phase-derived ranges is greatest when a satellite is low in the sky since the GPS signal must travel through a much "thicker" ionosphere. The tracking error of the receiver is greatest at these times when a lot of carrier smoothing is implemented. In addition, changing periods of ionospheric activity (diurnal changes and the 11-year cycle) influences the impact of large DLLTIMECONST values. It is important to realize that the advantages of carrier smoothing do not come without some trade off in receiver performance. The factory default DLLTIMECONST value of 100 was selected as an optimal compromise of the above considerations. For the majority of applications, this default value should be appropriate. However, the flexibility exists to adjust the parameter for specific applications by users who are familiar with the consequences.
Message ID: 1011 Abbreviated ASCII Syntax:
DLLTIMECONST signaltype timeconst
Factory Defaults: DLLTIMECONST <signaltype> 100
Example: DLLTIMECONST GPSL2C 100
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
DLLTIMECONST header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
signal type
See Table 30: Signal Type below
Signal type
Enum 4
H
3
time const
Time constant (seconds) Ulong 4
H+4
Table 30: Signal Type
Value (Binary) Signal (ASCII)
Description
33
GPSL1CA
GPS L1 C/A-code
47
GPSL1CP
GPS L1C P-code
68
GPSL2Y
GPS L2 P(Y)-code
69
GPSL2C
GPS L2 C/A-code
OEM7 Commands and Logs Reference Manual v10
129
Chapter 2 GNSS Commands
Value (Binary) Signal (ASCII)
Description
70
GPSL2P
GPS L2 P-code
103
GPSL5
GPS L5
2177
GLOL1CA
GLONASS L1 C/A-code
2211
GLOL2CA
GLONASS L2 C/A-code
2212
GLOL2P
GLONASS L2 P-code
2662
GLOL3
GLONASS L3
4129
SBASL1
SBAS L1
4194
SBASL5
SBAS L5
10433
GALE1
Galileo E1
10466
GALE5A
Galileo E5A
10499
GALE5B
Galileo E5B
10532
GALALTBOC
Galileo ALT-BOC
10565
GALE6C
Galileo E6C
10572
GALE6B
Galileo E6B
12673
BDSB1D1
BeiDou B1 with D1 navigation data
12674
BDSB1D2
BeiDou B1 with D2 navigation data
12803
BDSB2D1
BeiDou B2 with D1 navigation data
12804
BDSB2D2
BeiDou B2 with D2 navigation data
12877
BDSB3D1
BeiDou B3 with D1 navigation data
12880
BDSB3D2
BeiDou B3 with D2 navigation data
12979
BDSB1C
BeiDou B1C
13012
BDSB2A
BeiDou B2a
14753
QZSSL1CA
QZSS L1 C/A-code
14760
QZSSL1CP
QZSS L1C P-code
14787
QZSSL2CM
QZSS L2 C/A-code
14820
QZSSL5
QZSS L5
14891
QZSSL6P
QZSS L6P
19073
NAVICL5SPS
NavIC L5 SPS
OEM7 Commands and Logs Reference Manual v10
130
Chapter 2 GNSS Commands
2.31 DNSCONFIG
Manually configures Ethernet DNS servers
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This command is part of the Ethernet set up. It is used to configure the Domain Name Servers (DNS) so that host names can be used instead of IP addresses.
The DNSCONFIG command configures a DNS server for the Ethernet interface, ETHA.
The DNSCONFIG command will fail if the IP address for the Ethernet interface, ETHA, is configured to use DHCP. Ensure the IP address for the Ethernet interface is configured to use a static IP address before entering the DNSCONFIG command.
When using DHCP, the DNS server received using DHCP is used and the DNS server configured by DNSCONFIG is ignored.
Message ID: 1244 Abbreviated ASCII Syntax:
DNSCONFIG NumDNSSservers IP
Factory Default: DNSCONFIG 0
ASCII Example: DNSCONFIG 1 192.168.1.5
Field Field Type
ASCII Binary Value Value
1
DNSCONFIG Header
-
-
0
0
2
NumDNSServers
1
1
3
IP
ddd.ddd. ddd.ddd
Data Description
Command header. See Messages on page 25 for more information.
Number of DNS servers
If this field is set to 0, an IP address is not required.
IP address of primary DNS server
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
String [16]
variable
1
H+4
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
131
Chapter 2 GNSS Commands
2.32 DUALANTENNAPORTCONFIG
Select Dual Antenna Source Port
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command was replaced in OEM7 firmware version 7.04 (OM7MR0400RN0000). If the receiver is using OEM 7.04 or later, use the INSALIGNCONFIG command on page 895.
When the SPAN system is configured for dual antenna, it automatically attempts to connect to an ALIGN capable rover to establish dual antenna corrections. It also attempts to re-establish these corrections should they stop. The default port for connecting to the ALIGN rover is COM2. If an IMU is connected to COM2, COM1 is used instead. This command is used to designate a different serial port to be used for dual antenna positioning, or to disable this automatic configuration altogether. If automatic configuration is disabled, dual antenna corrections can still be used, but ALIGN corrections must be manually configured.
Message ID: 1356
Abbreviated ASCII Syntax: DUALANTENNAPORTCONFIG Port_Selection
Abbreviated ASCII Example: DUALANTENNAPORTCONFIG COM3
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
DUALANTENNA
1
PORTCONFIG -
-
header
Command header. See Messages on page 25 for more information.
h
0
0
NOPORT Specify which serial port
1
COM1 should be used to
communicate with an
2
COM2 external ALIGN capable
2
Port_Selection
3
COM3
receiver.
Enum 4
H
Selecting NOPORT
19
COM4 disables automatic dual
31
COM5
antenna configuration.
OEM7 Commands and Logs Reference Manual v10
132
Chapter 2 GNSS Commands
2.33 DYNAMICS
Tunes receiver parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to adjust the receiver dynamics to that of an application. It is used to optimally tune receiver parameters.
The DYNAMICS command adjusts the Tracking State transition time out value of the receiver, see Table 134: Tracking State on page 694. When the receiver loses the position solution, see Table 74: Solution Status on page 436, it attempts to steer the tracking loops for fast reacquisition (5 s time-out by default). The DYNAMICS command adjusts this time-out value, effectively increasing the steering time. The three states AIR, LAND or FOOT set the time-out to 5, 10 or 20 seconds respectively.
The DYNAMICS command should only be used by advanced users. The default of AUTO should not be changed except under very specific conditions.
Message ID: 258 Abbreviated ASCII Syntax:
DYNAMICS settings
Factory Default: DYNAMICS auto
Example: DYNAMICS FOOT
Field
Field Type
ASCII Binary Value Value
1
DYNAMICS header
-
-
See Table 31:
2
settings
User Dynamics on
the next page
Description
Command header. See Messages on page 25 for more information.
Receiver dynamics based on the current environment
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
133
Chapter 2 GNSS Commands
Table 31: User Dynamics
Binary ASCII
Description
Receiver is in an aircraft or a land vehicle, for example a high speed train, with
0
AIR
velocity greater than 110 km/h (30 m/s). This is also the most suitable dynamic
for a jittery vehicle at any speed.
1
LAND Receiver is in a stable land vehicle with velocity less than 110 km/h (30 m/s).
2
FOOT Receiver is being carried by a person with velocity less than 11 km/h (3 m/s).
3
AUTO Receiver monitors dynamics and adapts behavior accordingly
Qualifying North American Solar Challenge cars annually weave their way through 1000's of miles between the US and Canada. GNSS keeps them on track through many intersections on secondary highways and gives the Calgary team constant intelligence on the competition's every move. In this case, with average speeds of 46 miles/hour and at times a jittery vehicle, AIR is the most suitable dynamic.
OEM7 Commands and Logs Reference Manual v10
134
Chapter 2 GNSS Commands
2.34 ECHO
Sets port echo
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set a port to echo.
Message ID: 1247
Abbreviated ASCII Syntax: ECHO [port] echo
Factory Default: ECHO COM1 OFF ECHO COM2 OFF ECHO COM3 OFF (not supported on OEM719) ECHO COM4 OFF (OEM7600, OEM7700 and OEM7720 only) ECHO COM5 OFF (OEM7600, OEM7700 and OEM7720 only) ECHO USB1 OFF ECHO USB2 OFF ECHO USB3 OFF ECHO ICOM1 OFF (not supported on OEM719) ECHO ICOM2 OFF (not supported on OEM719) ECHO ICOM3 OFF (not supported on OEM719) ECHO ICOM4 OFF (not supported on OEM719) ECHO ICOM5 OFF (not supported on OEM719) ECHO ICOM6 OFF (not supported on OEM719) ECHO ICOM7 OFF (not supported on OEM719) ECHO SCOM1 OFF ECHO SCOM2 OFF ECHO SCOM3 OFF ECHO SCOM4 OFF
ASCII Example: ECHO COM1 ON ECHO ON
OEM7 Commands and Logs Reference Manual v10
135
Chapter 2 GNSS Commands
Field
Field Type
ASCII Value
Binary Value
1
ECHO Header
-
-
See Table 32:
2
port
Communications Port
Identifiers below
OFF
0
3
echo
ON
1
Description
Command header. See Messages on page 25 for more information.
Port to configure (default = THISPORT)
Sets port echo to off Sets port echo to on
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4 Enum 4
H H+4
Table 32: Communications Port Identifiers
ASCII Port Name Binary Value
ALL
8
BT1
33
CCOM1
38
CCOM2
39
CCOM3
40
CCOM4
41
CCOM5
42
CCOM6
43
COM1
1
COM2
2
COM3
3
COM4
19
COM5
31
COM6
32
COM7
34
COM8
35
COM9
36
OEM7 Commands and Logs Reference Manual v10
136
Chapter 2 GNSS Commands
ASCII Port Name Binary Value
COM10
37
ETH1
20
FILE
7
ICOM1
23
ICOM2
24
ICOM3
25
ICOM4
29
ICOM5
46
ICOM6
47
ICOM7
48
IMU
21
NCOM1
26
NCOM2
27
NCOM3
28
NOPORT
0
SCOM1
49
SCOM2
50
SCOM3
51
SCOM4
52
THISPORT
6
USB1
13
USB2
14
USB3
15
WCOM1
30
OEM7 Commands and Logs Reference Manual v10
137
Chapter 2 GNSS Commands
2.35 ECUTOFF
Sets satellite elevation cut-off for GPS Satellites
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the elevation cut-off angle for tracked GPS satellites. The receiver does not start automatically searching for a GPS satellite until it rises above the cut-off angle (when satellite position is known). Tracked satellites that fall below the cut-off angle are no longer tracked unless they are manually assigned (see the ASSIGN command on page 68). In either case, satellites below the ECUTOFF angle are eliminated from the internal position and clock offset solution computations. This command permits a negative cut-off angle; it could be used in these situations:
l The antenna is at a high altitude, and thus can look below the local horizon l Satellites are visible below the horizon due to atmospheric refraction
Care must be taken when using ECUTOFF command because the signals from lower elevation satellites are traveling through more atmosphere and are therefore degraded. Use of satellites below 5 degrees is not recommended.
Use the ELEVATIONCUTOFF command (see page 141) to set the cut-off angle for any system.
For dual antenna receivers, this command applies to both the primary and secondary antennas.
Message ID: 50 Abbreviated ASCII Syntax:
ECUTOFF angle
Factory Default: ECUTOFF 5.0
ASCII Example: ECUTOFF 10.0
OEM7 Commands and Logs Reference Manual v10
138
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
ECUTOFF header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
angle
�90.0 degrees
Elevation cut-off angle relative to horizon
Float
4
H
A low elevation satellite is a satellite the receiver tracks just above the horizon. Generally, a satellite is considered low elevation if it is between 0 and 15 degrees above the horizon.
There is no difference between the data transmitted from a low elevation satellite and that transmitted from a higher elevation satellite. However, differences in the signal path of a low elevation satellite make their use less desirable. Low elevation satellite signals have more error due to the increased amount of atmosphere they must travel through. In addition, signals from low elevation satellites don't fit the assumption that a signal travels in air nearly the same as in a vacuum. As such, using low elevation satellites in the solution results in greater position inaccuracies.
The elevation cut-off angle is specified with ECUTOFF to ensure that noisy, low elevation satellite data below the cut-off is not used in computing a position. If post-processing data, it is still best to collect all data (even that below the cut-off angle). Experimenting with different cut-off angles can then be done to provide the best results. In cases where there are not enough satellites visible, a low elevation satellite may actually help in providing a useful solution.
OEM7 Commands and Logs Reference Manual v10
139
Chapter 2 GNSS Commands
2.36 ELEVATIONCUTOFF
Sets the elevation cut-off angle for tracked satellites
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The ELEVATIONCUTOFF command is used to set the elevation cut-off angle for tracked satellites. The receiver does not start automatically searching for a satellite until it rises above the cut-off angle (when the satellite position is known). Tracked satellites that fall below the cut-off angle are no longer tracked unless they are manually assigned (refer to the ASSIGN command on page 68). In either case, satellites below the elevation cut-off angle are eliminated from the internal position and clock offset solution computations. This command permits a negative cut-off angle and can be used in the following situations:
l The antenna is at a high altitude and thus can look below the local horizon l Satellites are visible below the horizon due to atmospheric refraction
Care must be taken when using ELEVATIONCUTOFF command because the signals from lower elevation satellites are traveling through more atmosphere and are therefore degraded. Use of satellites below 5 degrees is not recommended.
This command combines the following commands into one convenient command: ECUTOFF, GLOECUTOFF, GALECUTOFF, QZSSECUTOFF, SBASECUTOFF, BDSECUTOFF and NAVICECUTOFF.
For dual antenna receivers, this command applies to both the primary and secondary antennas.
A low elevation satellite is a satellite the receiver tracks just above the horizon. Generally, a satellite is considered low elevation if it is between 0 and 15 degrees above the horizon. There is no difference between the data transmitted from a low elevation satellite and that transmitted from a higher elevation satellite. However, differences in the signal path of a low elevation satellite make their use less desirable. Low elevation satellite signals have more error due to the increased amount of atmosphere they must travel through. In addition, signals from low elevation satellites don't fit the assumption that a signal travels in air nearly the same as in a vacuum. As such, using low elevation satellites in the solution results in greater position inaccuracies. The elevation cut-off angle is specified with the ELEVATIONCUTOFF command to ensure that noisy, low elevation satellite data below the cut-off is not used in computing a position. If post-processing data, it is still best to collect all data (even that below the cutoff angle). Experimenting with different cut-off angles can then be done to provide the best results. In cases where there are not enough satellites visible, a low elevation satellite may actually help in providing a useful solution.
OEM7 Commands and Logs Reference Manual v10
140
Chapter 2 GNSS Commands
Message ID: 1735 Abbreviated ASCII Syntax:
ELEVATIONCUTOFF Constellation Angle [Reserved]
Factory default: ELEVATIONCUTOFF ALL 5.0 0
ASCII Example: ELEVATIONCUTOFF GPS 5 ELEVATIONCUTOFF ALL 5
Field Field Type
ASCII Value
ELEVATION
1
CUTOFF
-
header
Binary Value
Description
Format
Binary Bytes
Binary Offset
Command header. See
-
Messages on page 25 for -
more information.
H
0
OEM7 Commands and Logs Reference Manual v10
141
Chapter 2 GNSS Commands
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
GPS
0
Sets the cut-off angle for GPS Constellation satellites only.
GLONASS 1
Sets the cut-off angle for GLONASS constellation satellites only.
SBAS
2
Sets the cut-off angle for SBAS constellation satellites only.
Sets the cut-off angle
GALILEO 5
for Galileo constellation
2
Constellation
satellites only.
Enum 4
H
Sets the cut-off angle
BEIDOU 6
for BeiDou constellation
satellites only.
QZSS
7
Sets the cut-off angle for QZSS constellation satellites only.
NAVIC
9
Sets the cut-off angle for NavIC constellation satellites only.
Sets the cut-off angle
ALL
32
for all satellites regardless of the
constellation.
3
Angle
�90.0 degrees
Elevation cut-off angle relative to the horizon.
Float
4
H+4
4
Reserved
0
Reserved Field (optional)
Ulong 4
H+8
OEM7 Commands and Logs Reference Manual v10
142
Chapter 2 GNSS Commands
2.37 ETHCONFIG
Configures Ethernet physical layer
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This command is used to configure the Ethernet physical layer.
Message ID: 1245
Abbreviated ASCII Syntax: ETHCONFIG interface_name [speed] [duplex] [crossover] [power_mode]
Factory Default: ETHCONFIG etha auto auto auto powerdown (OEM7 receiver cards) ETHCONFIG etha auto auto auto auto (PwrPak7)
ASCII Example: ETHCONFIG etha 100 full mdix normal
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
1
ETHCONFIG Header
-
Command header.
-
See Messages on page 25 for more
-
information.
H
0
2
interface_ name
ETHA
2
Name of the Ethernet interface
Enum
4
H
3
speed
AUTO
Auto-negotiate speed (default)
AUTO is the
recommended value
for the speed
1
parameter.
If setting speed to AUTO, duplex must Enum 4
H+4
be set to AUTO at the
same time otherwise
a "parameter 3 out of
range" error occurs.
10
2
Force 10BaseT
100
3
Force 100BaseT
OEM7 Commands and Logs Reference Manual v10
143
Chapter 2 GNSS Commands
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
4
duplex
AUTO
Auto-negotiate duplex (default)
If setting duplex to
1
AUTO, speed must be
set to AUTO at the
same time otherwise Enum 4
H+8
a "parameter 3 out of
range" error occurs.
HALF
2
Force half duplex
FULL
3
Force full duplex
AUTO
1
Auto-detect crossover (default)
5
crossover MDI
2
Force MDI (straight through)
Enum
4
H+12
MDIX
3
Force MDIX (crossover)
AUTO
1
6
power_ mode
POWERDOWN 2
Energy detect mode (default for PwrPak7)
Soft power down mode (default for
Enum 4
OEM7 receiver cards)
H+16
NORMAL
3
Normal mode
The crossover parameter is ignored on OEM7 receivers, as the hardware automatically detects the cable connection and configures the interface for proper communication. For backwards compatibility, the crossover options are still accepted, but have no functional impact.
OEM7 Commands and Logs Reference Manual v10
144
Chapter 2 GNSS Commands
2.38 EVENTINCONTROL
Controls Event-In input triggers
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command controls up to four Event-In input triggers. Each input can be used as an event strobe. When used as an event strobe, an accurate GPS time or position is applied to the rising or falling edge of the input event pulse (refer to the MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME log on page 596, MARKPOS, MARK2POS, MARK3POS and MARK4POS log on page 593 or MARK1PVA, MARK2PVA, MARK3PVA and MARK4PVA log on page 1003). Each input strobe is usually associated with a separate device, therefore different solution output lever arm offsets can be applied to each strobe. When used as an Event Input Trigger, it is possible to overwhelm the receiver with a very high rate of input events that impacts the performance of the receiver. For this reason, the receiver internally throttles the rate at which it responds to input events. The limit is 200 Hz.
Message ID: 1637
Abbreviated ASCII Syntax:
EVENTINCONTROL mark switch [polarity] [t_bias] [t_guard]
ASCII Example:
EVENTINCONTROL MARK1 ENABLE
Field
Field Type
ASCII Value
EVENTIN
1
CONTROL -
header
MARK1
MARK2
2
mark
MARK3
MARK4
DISABLE
EVENT
3
switch
ENABLE
Binary Value
Description
Command header. See
-
Messages on page 25 for
more information.
0
Choose which Event-In
Mark to change. This value
1
must be specified.
Note: MARK3 and MARK4
2
are available only on
OEM7600, OEM7700 and
3
OEM7720 receivers.
0
Disables Event Input
1
Enables Event Input
A synonym for the EVENT
3
option (for compatibility
with previous releases)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
145
Chapter 2 GNSS Commands
Field
Field Type
4
polarity
5
t_bias
6
t_guard
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
NEGATIVE 0 POSITIVE 1
Negative polarity (default) Enum 4
Positive polarity
H+8
default: 0 minimum: 999,999,999 maximum: 999,999,999
A constant time bias in
nanoseconds can be
applied to each event
pulse. Typically this is used
to account for a transmission delay.
Long
4
This field is not used if the switch field is set to COUNT.
H+12
default: 4 minimum: 2 maximum: 3,599,999
The time guard specifies the minimum number of milliseconds between pulses. This is used to coarsely filter the input pulses.
If Field 3 is COUNT, this field is not used.
Ulong 4
H+16
OEM7 Commands and Logs Reference Manual v10
146
Chapter 2 GNSS Commands
2.39 EVENTOUTCONTROL
Control Event-Out properties
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command configures up to seven Event-Out output strobes. The event strobes toggle between 3.3 V and 0 V. The pulse consists of two periods: one active period followed by a not active period. The start of the active period is synchronized with the top of the GNSS time second and the signal polarity determines whether the active level is 3.3 V or 0 V. The not active period immediately follows the active period and has the alternate voltage.
The outputs that are available vary according to the platform.
A 100 MHz clock is used internally to create these output signals. As a result, all period values are limited to 10 ns steps.
The EVENTOUT outputs cannot synchronize with GPS time until the receiver reaches FINESTEERING time status. As the receiver transitions to GPS time, there may be additional, unexpected pulses on the EVENTOUT signals.
Message ID: 1636 Abbreviated ASCII Syntax:
EVENTOUTCONTROL mark switch [polarity] [active_period] [non_active_period]
ASCII Example: EVENTOUTCONTROL MARK3 ENABLE
Field
Field Type
ASCII Value
EVENTOUT
1
CONTROL -
header
Binary Value
Description
Command header. See
-
Messages on page 25 for
more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
147
Chapter 2 GNSS Commands
Field
Field Type
2
mark
3
switch
4
polarity
5
active_ period
non_
6
active_
period
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
MARK1
0
MARK2
1
Choose which Event-Out Mark to change. This value must be specified.
MARK3
2
Note: On OEM719 and OEM729 receivers, only
MARK4
3
MARK1 is available.
Enum 4
H
MARK5
4
MARK6
5
MARK7
6
Note: On OEM7600, OEM7700 and OEM7720 receivers, only MARK1 through MARK4 are available.
DISABLE 0 ENABLE 1
Disables the Event output Enum 4
Enables the Event output
H+4
NEGATIVE 0 POSITIVE 1
Negative polarity (active
= 0V)
(default)
Enum 4
Positive polarity (active = 3.3V)
H+8
default: 500,000,000 minimum: 10 maximum: 999,999,990
Active period of the Event Out signal in nanoseconds.
10ns steps must be used.
Note: If the value
Ulong 4
entered is not a multiple
of 10, it will be rounded
down to the nearest 10
ns.
H+12
default: 500,000,000 minimum: 10 maximum: 999,999,990
Non-active period of the Event Out signal in nanoseconds.
10 ns steps must be used.
Note: If the value
Ulong 4
entered is not a multiple
of 10, it will be rounded
down to the nearest 10
ns.
H+16
OEM7 Commands and Logs Reference Manual v10
148
Chapter 2 GNSS Commands
The sum of the active period and inactive period should total 1,000,000,000 ns. If the total exceeds one full second, the active period duration will be as given and the inactive period will be the remainder of the second. Alternately, the sum of the active and inactive periods may be less than 1,000,000,000 ns, but should divide evenly into 1,000,000,000 ns. For example, if the active period is 150,000,000 and the inactive period is 50,000,000, the sum of the periods is 200,000,000 ns which divides evenly into one full second. If the sum is less than one full second and not an even multiple, the last active or inactive period is stretched or truncated to equal one full second. A 100 MHz clock is used internally to create these output signals. As a result, all period values are limited to 10 ns steps.
OEM7 Commands and Logs Reference Manual v10
149
Chapter 2 GNSS Commands
2.40 EXTERNALCLOCK
Sets external clock parameters
Platform: OEM729 The EXTERNALCLOCK command is used to enable the OEM7 card to operate with an optional external oscillator. You are able to optimally adjust the clock model parameters of these receivers for various types of external clocks.
1. This command affects the interpretation of the CLOCKMODEL log. 2. If the EXTERNALCLOCK command is enabled and set for an external clock (TCXO,
OCXO, RUBIDIUM, CESIUM or USER) and the CLOCKADJUST command (see page 105) is ENABLED, then the clock steering process takes over the VARF output pins and may conflict with a previously entered FREQUENCYOUT command (see page 176). If clocksteering is not used with the external oscillator, the clocksteering process must be disabled by using the CLOCKADJUST disable command. 3. When using the EXTERNALCLOCK command and CLOCKADJUST command together, issue the EXTERNALCLOCK command first to avoid losing satellites.
There are three steps involved in using an external oscillator: 1. Follow the procedure outlined in the OEM7 Installation and Operation User Manual to connect
an external oscillator to the OEM7. 2. Using the EXTERNALCLOCK command, select a standard oscillator and its operating fre-
quency. 3. Using the CLOCKADJUST command, disable the clocksteering process if external clock-
steering is not used. An unsteered oscillator can be approximated by a three-state clock model, with two states representing the range bias and range bias rate, and a third state assumed to be a Gauss-Markov (GM) process representing the range bias error generated from satellite clock dither. The third state is included because the Kalman filter assumes an (unmodeled) white input error. The significant correlated errors produced by satellite clock dither are obviously not white and the Markov process is an attempt to handle this kind of short term variation. The internal units of the new clock model's three states (offset, drift and GM state) are metres, metres per second and metres. When scaled to time units for the output log, these become seconds, seconds per second and seconds, respectively. The user has control over 3 process noise elements of the linear portion of the clock model. These are the h0, h-1 and h-2 elements of the power law spectral density model used to describe the frequency noise characteristics of oscillators:
where f is the sampling frequency and Sy(f) is the clock's power spectrum. Typically only h0, h1, and h-2 affect the clock's Allan variance and the clock model's process noise elements. Before using an optional external oscillator, several clock model parameters must be set. There are default settings for a Voltage-Controlled Temperature-Compensated Crystal Oscillator (VCTCXO), Ovenized Crystal Oscillator (OCXO), Rubidium and Cesium standard, which are given
OEM7 Commands and Logs Reference Manual v10
150
Chapter 2 GNSS Commands
in Table 33: Clock Type on the next page. You may alternatively choose to supply customized settings.
The EXTERNALCLOCK command determines whether the receiver uses its own internal temperature-compensated crystal oscillator or that of an external oscillator as a frequency reference. It also sets which clock model is used for an external oscillator.
To force the OEM7 to use the internal oscillator, use the EXTERNALCLOCK disable command and physically disconnect the external oscillator input. Do not use the EXTERNALCLOCK OCXO, CESIUM, RUBIDIUM or USER parameters if there is no external oscillator connected to the OEM7.
Message ID: 230 Abbreviated ASCII Syntax:
EXTERNALCLOCK clocktype [freq] [h0[h-1[h-2]]]
Factory Default: EXTERNALCLOCK disable
ASCII Examples: EXTERNALCLOCK USER 10MHZ 1.0167e-23 6.87621e-25 8.1762e-26 EXTERNALCLOCK TCXO 5MHZ
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
EXTERNAL
1
CLOCK
-
-
header
Command header. See
Messages on page 25 for
-
more information.
H
0
See Table 33:
2
clocktype Clock Type on Clock type
the next page
Enum 4
H
3
freq
5MHz 1 10MHz 2
Optional frequency. If a value is not specified, the default is Enum 4 5 MHz
H+4
4
h0
5
h-1
6
h-2
1.0 e-35 to 1.0 e-18
1.0 e-35 to 1.0 e-18
1.0 e-35 to 1.0 e-18
Optional timing standards.
These fields are only valid when the USER clocktype is
Double 8
selected. Do not use h values
with VCTCXO, OCXO, CESIUM
or RUBIDIUM clock types. The Double 8
h values for these options are
fixed, see Table 34: Pre-
Defined Values for Oscillators
on the next page
Double 8
(default=0.0)
H+8 H+16 H+24
OEM7 Commands and Logs Reference Manual v10
151
Chapter 2 GNSS Commands
Table 33: Clock Type
ASCII Binary
Description
DISABLE TCXO
Turns the external clock input off, reverts back to the on-board VCTCXO.
0
When used in a binary command, use the parameter defaults (i.e. freq=1,
h0=0, h-1=0, h-2=0).
1
Sets the predefined values for a VCTCXO
OCXO
2
Sets the predefined values for an OCXO
RUBIDIUM
3
Sets the predefined values for a rubidium oscillator
CESIUM
4
Sets the predefined values for a cesium oscillator
USER
5
Defines custom process noise elements
Table 34: Pre-Defined Values for Oscillators
Clock Type VCTCXO
h0 1.0 e-21
h -1 1.0 e-20
h -2 1.0 e-20
OCXO
2.51 e-26
2.51 e-23
2.51 e-22
Rubidium
1.0 e-23
1.0 e-22
1.3 e-26
Cesium
2.0 e-20
7.0 e-23
4.0 e-29
OEM7 Commands and Logs Reference Manual v10
152
Chapter 2 GNSS Commands
2.41 FILEAUTOTRANSFER
Enables/Disables automatic file transfer
Platform: PwrPak7 Use this command to configure the automatic transfer function from internal memory to an external USB stick. If the mode is set to COPY or MOVE, all log files, except the file currently being logged to, will be automatically transferred to a USB stick when the USB stick is inserted. This command will transfer all recorded log files to the USB stick provided the USB stick has enough free space to hold all the data. Files too large to fit in the remaining space on the USB stick are skipped. The command must be issued before the USB stick is inserted. If the command is not issued first, the USB stick must be removed and reinserted to trigger the auto transfer. The status of the transfer can be viewed by logging the FILETRANSFERSTATUS log (see page 477). A transfer in progress can be canceled by issuing the FILETRANSFER CANCEL command. The settings for this command can be saved using the SAVECONFIG command (see page 321).
Message ID: 2135
Abbreviated ASCII Syntax: FILEAUTOTRANSFER [FileAutoTransferMode]
ASCII Example: FILEAUTOTRANSFER COPY
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
FILEAUTOTRANSFER header
-
-
Command header.
See Messages on page 25 for more
-
information.
H
0
Automatic
1
OFF
copy/move is
disabled (default)
2
COPY
Automatically copies all files
2
FileAutoTransferMode
Ulong 4
H
Automatically
copies all files and
3
MOVE
then deletes them from internal
memory after a
successful copy
OEM7 Commands and Logs Reference Manual v10
153
Chapter 2 GNSS Commands
For the fastest transfer of files to an external memory stick, it is recommended that logging to a file be stopped.
OEM7 Commands and Logs Reference Manual v10
154
Chapter 2 GNSS Commands
2.42 FILECONFIG
Open or close a log file
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
To record logs, log requests are sent to the FILE port. Before the logs sent to the FILE port can be saved in a file, the file must be opened using the FILECONFIG command. When configured to be open, a log file will be opened when the active file media is ready and has sufficient space. Once a log file is opened, any logs requested for the FILE port are recorded to the file. Use the FILESTATUS log (see page 471) to determine the state of the log file.
The file media is separately configured: l On core cards, this is always USBSTICK, which is the only media available. l On Enclosure products, the active file media is configured using a product-specific command, such as FILEMEDIACONFIG command on page 159.
When a file is opened, the file name is automatically generated based on the following format: <PSN>_<INDEX>.LOG where:
l <PSN> is the PSN of the receiver l <INDEX> is a number from 1 to 511.
The lowest number that produces an unused file name is selected. If there is no such number available, the FILESTATUS log (see page 471) will report an error. The number is not zero-padded (i.e. the sequence is as follows: 1,2, ... ,9,10,11,12, ... ,99,100, ... , 510,511). When a file is closed and the receiver has a valid time, the file is renamed based on the following format: <PSN>_<UTC Date>_<UTC Time>.LOG where: l <PSN> is the PSN of the receiver l <UTC_Date> is the UTC date in the format YYYY-MM-DD l <UTC_Time> is the UTC time in the format HH-MM-SS Example file name: NOV12001200A_2017-01-10_12-14-34.LOG When a file is closed, but the receiver does not have a valid time, the file is left with its automatically generated name. Other Notes: l The FILE port represents the internal logging to flash memory. It has a NOVATEL Interface Mode - output only, no input is possible. l Only logs that are published after the log file is open are recorded.
OEM7 Commands and Logs Reference Manual v10
155
Chapter 2 GNSS Commands
l Only one log file can be open at a time. l Logs requested to the FILE port are still produced even if the log file is closed; however the
logs are not recorded. (This is similar to requesting logs to COM4 when there's no cable on COM4.) If a new log file is opened, recording of the previously requested logs continues with the new file. l When a file is closed, the log file is renamed to the format <PSN>_<UTC Date>_<UTC Time>.LOG, where the UTC time is the time when the file is closed. If the time is not available, the file is not renamed. If there is already a file with the intended name, the file is not renamed. l After closing a file, the file system will be flushed to ensure that all data is written to the media. l A disk is considered "full" when is has <= 10 MB of free space. This buffer is left in place to allow the system time and space to open up a new file if required.
Message ID: 2116
Abbreviated ASCII Syntax: FILECONFIG FileOperation
Factory Default: FILECONFIG CLOSE
Example: FILECONFIG OPEN
Field
Field Type
ASCII Binary Value Value
Description
1
FILECONFIG header
-
-
Command header. See Messages on page 25 for more information.
1
2
FileOperation
2
OPEN CLOSE
Open (create) a new logging file
Close the logging file
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
156
Chapter 2 GNSS Commands
2.43 FILEDELETE
Deletes files from the currently selected mass storage device
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to delete a single file, or use the wild card symbol (*) to delete all files, from the logging directory of the currently selected file media. This command will not delete a file if it is currently open for logging. Use the FILESTATUS log (see page 471) to determine the state of the log file.
The wild card symbol deletes all files in the directory. It cannot be used to delete a subset of the files in the directory. For example, the command FILEDELETE *.LOG will be rejected by the receiver.
The file media is separately configured:
l On receiver cards, the file media is always USBSTICK, which is the only media available.
l On enclosure products, the active file media is configured using a product-specific command, such as FILEMEDIACONFIG command (see page 159).
The list of files stored on the currently selected file media can be retrieved using the FILELIST log on page 469.
Message ID: 2190
Abbreviated ASCII Syntax: FILEDELETE FileName
Example:
FILEDELETE NMNE17130016A_2017-12-11_18-17-06.LOG NMNE17130016A_2017-12-11_18-17-06.LOG
� Delete the file
Field Field Type
Description
1
FILEDELETE Command header. See Messages on
header
page 25 for more information.
2
FileName
Name of file to delete, or the wild card symbol (*)
Format
Binary Bytes
Binary Offset
H
0
String (Max 128)
variable
1
H
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
157
Chapter 2 GNSS Commands
2.44 FILEMEDIACONFIG
Specify the file media
Platform: PwrPak7 Use this command to specify which storage media is used for File operations. To determine what storage device is currently being used for File operations, log this command. For example:
LOG FILEMEDIACONFIG
On OEM7 receiver cards, the file media is always USBSTICK, which is the only media available. On PwrPak7 products, the active file media is configured using the FILEMEDIACONFIG command.
Message ID: 2117 Abbreviated ASCII Syntax:
FILEMEDIACONFIG MassStorage
ASCII Example: FILEMEDIACONFIG INTERNAL_FLASH FILEMEDIACONFIG USBSTICK
� Use internal flash as the media � Use a USB stick as the media
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
1
FILEMEDIACONFIG header
-
-
Command
header. See
Messages on
-
page 25 for more
information.
H
0
Use a USB stick
1
USBSTICK as the mass
storage device
2
MassStorageDevice
Use Internal
Enum 4
H
2
INTERNAL_ storage as the
FLASH
mass storage
device
OEM7 Commands and Logs Reference Manual v10
158
Chapter 2 GNSS Commands
2.45 FILEROTATECONFIG
Set the maximum size and duration of a log file
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to configure the maximum size and duration for a log file. This command also configures the action taken when the log file media is full. A file rotation is when a new file is opened, the currently opened file is closed and logging on the FILE port is rerouted to this new file. There is no data loss during this process and individual logs within the file are not spread between log files.
Message ID: 2133
Abbreviated ASCII Syntax: FILEROTATECONFIG [MaxFileTime] [MaxFileSize] [DiskFullAction]
Factory Default: FILEROTATECONFIG 0 4096 STOP
Example: FILEROTATECONFIG 2 4096 STOP The file is left open for 2 hours or until the file size reaches 4096 MB. When the log file media is full, the file is closed. FILEROTATECONFIG 4 4096 OVERWRITE The file is left open for 4 hours or until the file size reaches 4096 MB. When the log media file is full, the oldest file on the log media file will be deleted.
Field
Field Type
ASCII Value
Binary Value
FILEROTATE
1
CONFIG
-
-
header
2
MaxFileTime 0 to 24
Description
Format
Binary Bytes
Binary Offset
Command header.
See Messages on page 25 for more
-
information.
H
0
Maximum number of
hours to leave a file
open before
triggering a file
rotation. Set to 0 for no
Ushort 2
H
maximum time.
Maximum value is 24.
Default is 0.
OEM7 Commands and Logs Reference Manual v10
159
Chapter 2 GNSS Commands
Field
Field Type
ASCII Value
Binary Value
3
MaxFileSize 1 to 4096
Description
Format
Binary Bytes
Binary Offset
Maximum number of
mega bytes (MB) for
the file size. A file
rotation is triggered
when the file is within
1 MB of this size.
Ushort 2
Maximum value is 4096 MB
Default is 4096 MB (4 GB).
H+2
OEM7 Commands and Logs Reference Manual v10
160
Chapter 2 GNSS Commands
Field
Field Type
ASCII Value
Binary Value
4
DiskFullAction 0
STOP
Description
Stops logging when the file media has 1 MB of free space or less. Default is STOP.
Format
Binary Bytes
Binary Offset
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
161
Chapter 2 GNSS Commands
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Deletes the oldest log file when the file media has 10 MB of free space or less.
To be selected for deletion a file must satisfy these requirements:
l The file must use the FILECONFIG command (see page 156) file name format.
l The <PSN> value must match the current receiver.
File age is
1
OVERWRITE determined using the
FILECONFIG
command (see page
156) file name
format.
l Temporary files (i.e. those with an <INDEX> value) are considered oldest. Such files will be sorted by their <INDEX> value with lower values considered older.
l Non-temporary files will be sorted by the date reported in the file format.
OEM7 Commands and Logs Reference Manual v10
162
Chapter 2 GNSS Commands
2.46 FILETRANSFER
Copy files from internal memory
Platform: PwrPak7 Use this command to copy files from internal memory to a USB stick. This command can also be used to cancel the file transfer in progress.
This command returns a response immediately to show that the copy/move operation started. However, the actual transfer of files will take some time. Use the FILETRANSFERSTATUS log (see page 477) to monitor the status of the file transfer.
To view the names of the files in memory, log the FILELIST log (see page 469).
Message ID: 2109
Abbreviated ASCII Syntax: FILETRANSFER FileTransferOperation <FileName>
ASCII Examples:
FILETRANSFER COPY ALL
� Copies all files on internal memory
FILETRANSFER MOVE BMHR16460033T_2017-3-16_21-18-48.log
FILETRANSFER CANCEL
� Cancels file transfer operation
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
FILETRANSFER header
-
-
Command
header. See
Messages on
-
page 25 for more
information.
H
0
1
COPY Copy the file
Copy the file and
2
MOVE
then delete file from internal
2
FileTransferOperation
memory
Enum 4
H
Cancels the file
3
CANCEL
transfer currently in
progress
OEM7 Commands and Logs Reference Manual v10
163
Chapter 2 GNSS Commands
Field
Field Type
3
FileName
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
The name of the file to be moved or copied.
To move or copy all of the files on internal memory, use ALL.
String
Variable H+4
When a FILETRANSFER CANCEL ALL command is issued, the file currently being transferred, and any pending files, are not transferred to the destination media. Any files already transferred are unaffected.
OEM7 Commands and Logs Reference Manual v10
164
Chapter 2 GNSS Commands
2.47 FIX
Constrains to fixed height or position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to fix height or position to the input values. For various applications, fixing these values can assist in improving acquisition times and accuracy of position or corrections. For example, fixing the position is a requirement for differential base stations as it provides the reference position to base the differential corrections from. If you enter a FIXPOSDATUM command (see page 170), the FIX command is then issued internally with the FIXPOSDATUM command (see page 170) values translated to WGS84. It is the FIX command that appears in the RXCONFIG log. If the FIX command or the FIXPOSDATUM command (see page 170) are used, their newest values overwrite the internal FIX values.
1. It is strongly recommended that the FIX POSITION entered be accurate to within a few metres. This level of accuracy can be obtained from a receiver using single point positioning once 5 or 6 satellites are being tracked.
2. FIX POSITION should only be used for base station receivers. Applying FIX POSITION to a rover switches it from RTK mode to a fixed position mode. Applying FIX POSITION to the rover does not speed up ambiguity resolution.
3. Any setting other than FIX POSITION disables output of differential corrections unless the MOVINGBASESTATION command (see page 244) is set to ENABLE.
4. You can fix the position of the receiver using latitude, longitude and height in Mean Sea Level (MSL) or ellipsoidal parameters depending on the UNDULATION setting. The factory default for the UNDULATION command (see page 383) setting is EGM96, where the height entered in the FIX command is set as MSL height. If you change the UNDULATION setting to USER 0, the height entered in the FIX command is set as ellipsoidal height (refer to Table 35: FIX Parameters on the next page).
Error checking is performed on the entered fixed position by the integrity monitor. Depending on the result of this check, the position can be flagged with the following statuses.
l SOL_COMPUTED: The entered position has been confirmed by measurement. l PENDING: Insufficient measurements are available to confirm the entered position. l INTEGRITY_WARNING: First level of error when an incorrect position has been entered. The
fixed position is off by approximately 25-50 meters. l INVALID_FIX: Second level of error when an inaccurate position has been entered. The fixed
position is off by a gross amount.
An incorrectly entered fixed position will be flagged either INTEGRITY_WARNING or INVALID_FIX. This will stop output of differential corrections or RTK measurements and can affect the clock steering and satellite signal search. Checks on the entered fixed position can be disabled using the RAIMMODE command (see page 294).
Message ID: 44
OEM7 Commands and Logs Reference Manual v10
165
Chapter 2 GNSS Commands
Abbreviated ASCII Syntax: FIX type [param1 [param2 [param3]]]
Factory Default: FIX none
ASCII Example: FIX none FIX HEIGHT 4.567 FIX position 51.116 -114.038 1065.0
In order to maximize the absolute accuracy of RTK rover positions, the base station coordinates must be fixed to their known position using the FIX POSITION [lat][lon] [hgt] command.
Field
Field Type
ASCII Binary Value Value
Description
1
FIX header
-
-
Command header. See Messages on page 25 for more information.
See Table 36: Fix
2
type
Types on the next Fix type
page
3
param1
Parameter 1
4
param2
See Table 35: FIX Parameters below
Parameter 2
5
param3
Parameter 3
ASCII Type Name AUTO
HEIGHT
NONE
Table 35: FIX Parameters
Parameter 1
Parameter 2
Not used Default MSL height 1 (-1000 to 20000000 m) Not used
Not used Not used Not used
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
Double 8 Double 8 Double 8
H
H+4 H + 12 H + 20
Parameter 3 Not used Not used Not used
1See also Note #4 above. OEM7 Commands and Logs Reference Manual v10
166
Chapter 2 GNSS Commands
ASCII Type Name
Parameter 1
POSITION
Lat (-90 to 90 degrees) where a `-' sign denotes south and a `+' sign denotes north
Parameter 2
Parameter 3
Lon (-360 to 360 degrees) where a `-' sign denotes west and a `+' sign denotes east
Default MSL height 1 (-1000 to 20000000 m)
For a discussion on height, refer to An Introduction to GNSS available on our website.
ASCII Name NONE AUTO
HEIGHT
Table 36: Fix Types
Binary Value
Description
0
Unfix. Clears any previous FIX commands
Configures the receiver to fix the height at the last calculated value if the
1
number of satellites available is insufficient for a 3-D solution. This provides a 2-D solution. Height calculation resumes when the number of satellites
available allows a 3-D solution
Configures the receiver in 2-D mode with its height constrained to a given
value. This command is used mainly in marine applications where height in
relation to mean sea level may be considered to be approximately constant.
The height entered using this command is referenced to the mean sea level,
2
see the BESTPOS log on page 433 (is in metres). The receiver is capable of
receiving and applying differential corrections from a base station while fix
height is in effect. The fix height command overrides any previous FIX
HEIGHT or FIX POSITION command.
Note: This command only affects pseudorange corrections and solutions.
OEM7 Commands and Logs Reference Manual v10
167
Chapter 2 GNSS Commands
ASCII Binary Name Value
Description
Configures the receiver with its position fixed. This command is used when it is necessary to generate differential corrections.
For both pseudorange and differential corrections, this command must be properly initialized before the receiver can operate as a GNSS base station. Once initialized, the receiver computes differential corrections for each satellite being tracked. The computed differential corrections can then be output to rover stations using the RTCMV3 differential corrections data log format. See the OEM7 Installation and Operation User Manual for information about using the receiver for differential applications.
POSITION
3
The values entered into the fix position command should reflect the precise position of the base station antenna phase center. Any errors in the fix
position coordinates directly bias the corrections calculated by the base
receiver.
The receiver performs all internal computations based on WGS84 and the DATUM command (see page 119) is defaulted as such. The datum in which you choose to operate (by changing the DATUM command (see page 119)) is internally converted to and from WGS84. Therefore, all differential corrections are based on WGS84, regardless of your operating datum.
The FIX POSITION command overrides any previous FIX HEIGHT or FIX POSITION command settings.
OEM7 Commands and Logs Reference Manual v10
168
Chapter 2 GNSS Commands
2.48 FIXPOSDATUM
Sets position in a specified datum
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the FIX position in a specific datum. The input position is transformed into the same datum as that in the receiver's current setting. The FIX command (see page 166) is then issued internally with the FIXPOSDATUM command values. It is the FIX command (see page 166) that appears in the RXCONFIG log (see page 764). If the FIX command (see page 166) or the FIXPOSDATUM command are used, their newest values overwrite the internal FIX values.
Message ID: 761
Abbreviated ASCII Syntax: FIXPOSDATUM datum lat lon height
Factory Default: fix none
ASCII Example: FIXPOSDATUM USER 51.11633810554 -114.03839550586 1048.2343
Use the FIXPOSDATUM command in a survey to fix the position with values from another known datum, rather than manually transforming them into WGS84.
Field
Field Type
ASCII Value
Binary Value
FIXPOS
1
DATUM -
-
header
See Table 29: Datum
2
datum
Transformation Parameters on
page 121
3
lat
�90
4
lon
�360
5
height -1000 to 20000000
Description
Format
Binary Bytes
Binary Offset
Command header. See Messages on page 25 for more information.
H
0
Datum ID
Enum 4
H
Latitude (degrees)
Longitude (degrees)
Mean sea level (MSL) height (m)
Double 8 Double 8 Double 8
H+4 H+12 H+20
For a discussion on height, refer to An Introduction to GNSS available on our website.
OEM7 Commands and Logs Reference Manual v10
169
Chapter 2 GNSS Commands
2.49 FORCEGALE6CODE
Force receiver to track Galileo E6C or E6B signal
Platform: OEM719, OEM729, OEM7700, PwrPak7 Use this command to force Galileo E6 channels to track E6B or E6C.
Message ID: 2222
Abbreviated ASCII Syntax: FORCEGALE6CODE E6codetype
Factory Default: FORCEGALE6CODE E6B
Field
Field Type
ASCII Binary Value Value
Description
1
FORCEGALE6CODE -
-
Command header. See Messages on page 25 for more information.
2
E6codetype
E6B 0 E6C 1
Galileo E6 code type (default = E6B)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
170
Chapter 2 GNSS Commands
2.50 FORCEGLOL2CODE
Forces receiver to track GLONASS satellite L2 P or L2 C/A code
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to force the receiver to track GLONASS satellite L2 P-code or L2 C/A code. This command has no effect if the channel configuration contains both GLONASS L2 P and L2 C/A channels.
Message ID: 1217
Abbreviated ASCII Syntax: FORCEGLOL2CODE L2type
Factory Default: FORCEGLOL2CODE default
ASCII Example: FORCEGLOL2CODE p
Field
Field Type
ASCII Binary Value Value
FORCEGLO
1
L2CODE -
-
header
See Table 37:
2
L2type
GLONASS L2 Code
Type below
Description
Command header. See Messages on page 25 for more information.
GLONASS L2 code type
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Table 37: GLONASS L2 Code Type
Binary ASCII
Description
1
P
L2 P-code or L2 Precise code
2
C
L2 C/A code or L2 Coarse/Acquisition code
3
DEFAULT Set to channel default
The following table lists which L2 signal is tracked based on the channel configuration and the setting used for the L2type parameter.
OEM7 Commands and Logs Reference Manual v10
171
Chapter 2 GNSS Commands
Table 38: Signals Tracked � Channel Configuration and L2type Option
Channel Configuration for L2 Signal
L2type Setting
P
C DEFAULT
L2
P
C
P
L2C
P
C
C
L2PL2C
Both Both Both
OEM7 Commands and Logs Reference Manual v10
172
Chapter 2 GNSS Commands
2.51 FORCEGPSL2CODE
Forces receiver to track GPS satellite L2 P or L2C code
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to force the receiver to track GPS L2 P-code or L2C code. AUTO tells the receiver to use L2C code type if available and L2 P-code if L2C code is not available. This command has no effect if the channel configuration contains both GPS L2 P and L2 C channels.
Message ID: 796
Abbreviated ASCII Syntax: FORCEGPSL2CODE L2type
Factory Default: FORCEGPSL2CODE default
ASCII Example: FORCEGPSL2CODE p
Field
Field Type
ASCII Binary Value Value
Description
FORCEGPS
Command header. See
1
L2CODE -
-
Messages on page 25 for
header
more information.
See Table 39:
2
L2type
GPS L2 Code
GPS L2 code type
Type below
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Table 39: GPS L2 Code Type
Binary ASCII
Description
Receiver uses the L2C if available and L2 P otherwise. An exception is when
the receiver is doing RTK positioning. In that case, AUTO changes the L2 code
0
AUTO type being tracked to match the L2 code type found in the base station
corrections, which ensures the greatest number of satellites are used in the
solution.
1
P
L2 P-code or L2 Precise code
2
C
L2C code or L2 Civilian code
3
DEFAULT Set to channel default
The following table lists which L2 signal is tracked based on the channel configuration and the setting used for the L2type parameter.
OEM7 Commands and Logs Reference Manual v10
173
Chapter 2 GNSS Commands
Table 40: Signals Tracked � Channel Configuration and L2type Option
Channel Configuration for L2 Signal L2
L2C
L2P
L2AUTO
L2PL2C
Auto
C if available, P(Y) otherwise C if available, P(Y) otherwise C if available, P(Y) otherwise C if available, P(Y) otherwise Both
L2type Setting
P
C
DEFAULT
P(Y) C
P(Y)
P(Y) C
C
P(Y) C
P(Y)
P(Y) C
C if available, P(Y) otherwise
Both Both Both
OEM7 Commands and Logs Reference Manual v10
174
Chapter 2 GNSS Commands
2.52 FREQUENCYOUT
Sets output pulse train available on VARF
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to set the output pulse train available on the Variable Frequency (VARF) or EVENT_OUT1 pin. The output waveform is coherent with the 1PPS output, see the usage note and Figure 4: Pulse Width and 1PPS Coherency on the next page.
If the CLOCKADJUST command (see page 105) command is ENABLED and the receiver is configured to use an external reference frequency (set in the EXTERNALCLOCK command (see page 151) for an external clock - TCXO, OCXO, RUBIDIUM, CESIUM, or USER), then the clock steering process takes over the VARF output pins and may conflict with a previously entered FREQUENCYOUT command.
Figure 4: Pulse Width and 1PPS Coherency on the next page shows how the chosen pulse width is frequency locked but not necessarily phase locked when using ENABLE option. To synchronize the phase, use ENABLESYNC option.
The EVENTOUT outputs cannot synchronize with GPS time until the receiver reaches FINESTEERING time status. As the receiver transitions to GPS time, there may be additional, unexpected pulses on the EVENTOUT signals.
Message ID: 232
Abbreviated ASCII Syntax: FREQUENCYOUT [switch] [pulsewidth] [period]
Factory Default: FREQUENCYOUT disable
ASCII Example: FREQUENCYOUT ENABLE 2 4
This example generates a 50% duty cycle 25 MHz square wave.
OEM7 Commands and Logs Reference Manual v10
175
Chapter 2 GNSS Commands Figure 4: Pulse Width and 1PPS Coherency
When using ENABLE option, the VARF and 1PPS are not necessarily in phase as described in Figure 4: Pulse Width and 1PPS Coherency above. To align the phase of the VARF with the 1PPS, use the ENABLESYNC option and the VARF phase will be synchronized to the leading edge of the 1PPS pulse. Note that if the VARF and 1PPS frequencies are not even multiples of each other, this may cause the VARF to have a shorter cycle pulse prior to each 1PPS pulse. 1PPS is not affected.
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
FREQUENCYOUT header
-
Command header.
-
See Messages on page 25 for more
-
information.
H
0
DISABLE 0
Disable causes the output to be fixed low (if NONE specified, defaults to DISABLE)
2
switch
ENABLE 1
Enables customized Enum 4 frequency output
H
ENABLE SYNC
2
Enable customized frequency output synchronized to PPS
OEM7 Commands and Logs Reference Manual v10
176
Chapter 2 GNSS Commands
Field Field Type
3
pulsewidth
4
period
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
Number of 10 ns steps for which the output is high.
Duty cycle =
pulsewidth / period. If
pulsewidth is greater
(0 to 1073741823) than or equal to the
Ulong 4
period, the output is a
high DC signal. If
pulsewidth is 1/2 the
period, then the
output is a square
wave (default = 0)
H+4
Signal period in 10 ns steps.
(0 to 1073741823) Frequency Output = Ulong 4 100,000,000 / Period
(default = 0)
H+8
OEM7 Commands and Logs Reference Manual v10
177
Chapter 2 GNSS Commands
2.53 FRESET
Clears selected data from NVM and reset
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to clear data which is stored in non-volatile memory. Such data includes the almanac, ephemeris, and any user specific configurations. The commands, ephemeris, almanac, and L-Band related data, excluding the subscription information, can be cleared by using the STANDARD target. The receiver is forced to reset.
FRESET STANDARD (which is also the default) causes most commands, ephemeris, GNSS and almanac data previously saved to NVM to be erased.
The FRESET STANDARD command will erase all user settings. You should know your configuration (by requesting the RXCONFIG log on page 764) and be able to reconfigure the receiver before you send the FRESET command.
Message ID: 20 Abbreviated ASCII Syntax:
FRESET [target]
Input Example: FRESET COMMAND
Field
Field Type
ASCII Value
Binary Value
1
FRESET header
-
-
See Table 41:
2
target FRESET Target on
the next page
Description
Command header. See Messages on page 25 for more information.
What data is to be reset by the receiver (default = STANDARD)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
178
Chapter 2 GNSS Commands
If you are receiving no data or random data from your receiver, try the following before contacting NovAtel:
l Verify that the receiver is tracking satellites by logging the TRACKSTAT log (see page 859) and checking that the receiver is tracking at least four satellites.
l Check the integrity and connectivity of power and data cables
l Verify the baud rate settings of the receiver and terminal device (your PC, data logger or laptop)
l Switch COM ports
l Issue the FRESET command.
Table 41: FRESET Target
Binary
ASCII
Description
0
STANDARD
Resets commands (except CLOCKCALIBRATION and MODEL), ephemeris and almanac (default).
Also resets all L-Band related data except for the subscription information.
Does not reset the Ethernet settings or stored Profile configurations.
1
COMMAND
Resets the stored commands (saved configuration)
2
GPSALMANAC
Resets the stored GPS almanac
3
GPSEPHEM
Resets the stored GPS ephemeris
4
GLOEPHEM
Resets the stored GLONASS ephemeris
5
MODEL
Resets the currently selected model
10 USERDATA
Resets the user data saved using the NVMUSERDATA command (see page 258)
11
CLKCALIBRATION
Resets the parameters entered using the CLOCKCALIBRATE command (see page 107)
20 SBASALMANAC
Resets the stored SBAS almanac
21 LAST_POSITION Resets the position using the last stored position
31 GLOALMANAC
Resets the stored GLONASS almanac
39 GALFNAV_EPH
Resets the stored GALFNAV ephemeris
40 GALINAV_EPH
Resets the stored GALINAV ephemeris
45 GALFNAV_ALM
Resets the stored GALFNAV almanac
46 GALINAV_ALM
Resets the stored GALINAV almanac
OEM7 Commands and Logs Reference Manual v10
179
Chapter 2 GNSS Commands
Binary
ASCII
Description
52 PROFILEINFO
Resets the stored profile configurations
54 QZSSALMANAC Resets the QZSS almanac
55 QZSSEPHEMERIS Resets the QZSS ephemeris
57 BDSALMANAC
Resets the BeiDou almanac
58 BDSEPHEMERIS Resets the BeiDou ephemeris
60 USER_ACCOUNTS Resets the admin password to the default (the receiver PSN)
64 ETHERNET
Resets the stored Ethernet settings
85
SRTK_ SUBSCRIPTIONS
Resets the Secure RTK Subscription data stored on the rover receiver
87 NAVICEPHEMERIS Resets the NavIC ephemeris
88 NAVICALMANAC Resets the NavIC almanac
OEM7 Commands and Logs Reference Manual v10
180
Chapter 2 GNSS Commands
2.54 GALECUTOFF
Sets elevation cut-off angle for Galileo satellites
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the elevation cut-off angle for tracked Galileo satellites. The receiver does not start automatically searching for a satellite until it rises above the cut-off angle (when satellite position is known). Tracked satellites that fall below the cut-off angle are no longer tracked unless they were manually assigned (see the ASSIGN command on page 68). In either case, satellites below the GALECUTOFF angle are eliminated from the internal position and clock offset solution computations. This command permits a negative cut-off angle and can be used in the following situations:
l The antenna is at a high altitude and thus look below the local horizon l Satellites are visible below the horizon due to atmospheric refraction
Care must be taken when using GALECUTOFF because the signals from lower elevation satellites are traveling through more atmosphere and are therefore degraded. Use of satellites below 5 degrees is not recommended.
Use the ELEVATIONCUTOFF command (see page 141) to set the cut-off angle for any system.
For dual antenna receivers, this command applies to both the primary and secondary antennas.
Message ID: 1114 Abbreviated ASCII Syntax:
GALECUTOFF angle
Factory Default: GALECUTOFF 5.0
ASCII Example: GALECUTOFF 10.0
OEM7 Commands and Logs Reference Manual v10
181
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
1
GALECUTOFF header
-
-
Command header. See Messages on page 25 for more information.
2
angle
�90.0 degrees
Elevation cut-off angle relative to horizon
Format
Binary Bytes
Binary Offset
-
H
0
Float
4
H
OEM7 Commands and Logs Reference Manual v10
182
Chapter 2 GNSS Commands
2.55 GENERATEALIGNCORRECTIONS
Configure ALIGN Master
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to configure the ALIGN Master and starts sending out ALIGN corrections through the specified port. This command is like sending the following commands to the Master, assuming the use of a serial port and default ALIGN corrections:
unlogall [port] fix none movingbasestation enable interfacemode [port] novatel rtca serialconfig [port] [baud] N 8 1 N ON log [port] rtcaobs3 ontime [rate = 1/ obsreqrate] log [port] rtcarefext ontime [rate = 1/ refextreqrate]
Message ID: 1349
Abbreviated ASCII Syntax: GENERATEALIGNCORRECTIONS port [baud] [obsreqrate] [refextreqrate] [interfacemode]
ASCII Example: GENERATEALIGNCORRECTIONS COM2 230400 10 10
Field Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
GENERATEALIGN
1
CORRECTIONS -
header
Command header.
-
See Messages on page 25 for more
-
H
0
information.
2
port
See Table 32: Communications Port Identifiers on page 137
Port identifier (default = THISPORT)
Enum 4
H
3
baud
9600, 19200, 38400, Communication
57600, 115200,
baud rate (bps)
Ulong 4
230400 or 460800
(default = 9600)
H+4
4
obsreqrate
1, 2, 4, 5, 10, 20, 50 or 100
RTCAOBS3 data rate in Hz (default = 1)
Ulong 4
H+8
5
refextreqrate
0, 1, 2, 4, 5, 10, 20, 50 or 100
RTCAREFEXT data rate in Hz (default = 1)
Ulong
4
H+12
OEM7 Commands and Logs Reference Manual v10
183
Chapter 2 GNSS Commands
Field Field Type
6
interfacemode
ASCII Value
Binary Value
RTCA
3
NOVATELX 35
Description
Correction interface mode (default = RTCA)
Format
Binary Bytes
Binary Offset
Enum 4
H+16
OEM7 Commands and Logs Reference Manual v10
184
Chapter 2 GNSS Commands
2.56 GENERATEDIFFCORRECTIONS
Sends a preconfigured set of differential corrections
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to configure the receiver to send a preconfigured set of differential pseudorange corrections.
Message ID: 1296
Abbreviated ASCII Syntax: GENERATEDIFFCORRECTIONS mode port
ASCII Example: GENERATEDIFFCORRECTIONS rtcm com2
Preconfigured set of differential corrections sent when RTCM: RTCM1 ontime 1 RTCM31 ontime 1 RTCM3 ontime 10
Preconfigured set of differential corrections sent when RTCA: RTCA1 ontime 1 RTCAREF ontime 10
Field
Field Type
ASCII Binary Value Value
Description
GENERATEDIFF
Command header. See
1
CORRECTIONS -
-
Messages on page 25
header
for more information.
2
mode
RTCM 2 RTCA 3
Serial port interface mode identifier. See Table 42: Serial Port Interface Modes on page 201
3
port
See Table 59: COM Port Identifiers on page 338
Port to configure
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
185
Chapter 2 GNSS Commands
2.57 GENERATERTKCORRECTIONS
Sends a preconfigured set of RTK corrections
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to configure the receiver to send a preconfigured set of RTK (carrier phase) corrections.
Message ID: 1260
Abbreviated ASCII Syntax: GENERATERTKCORRECTIONS mode port
ASCII Example: GENERATERTKCORRECTIONS rtcmv3 com2
Preconfigured set of differential corrections sent when RTCM: RTCM1819 ontime 1 RTCM3 ontime 10 RTCM22 ontime 10 RTCM23 ontime 60 RTCM24 ontime 60
Preconfigured set of differential corrections sent when RTCMV3: RTCM1004 ontime 1 RTCM1012 ontime 1 RTCM1006 ontime 10 RTCM1008 ontime 10 RTCM1033 ontime 10
Preconfigured set of differential corrections sent when RTCA: RTCAOBS2 ontime 1 RTCAREF ontime 10
Preconfigured set of differential corrections sent when CMR: CMROBS ontime 1 CMRGLOOBS ontime 1 CMRREF ontime 10
Preconfigured set of differential corrections sent when NOVATELX COM2: NOVATELXOBS ontime 1
OEM7 Commands and Logs Reference Manual v10
186
Chapter 2 GNSS Commands
Field Field Type
ASCII Value
Binary Value
Description
GENERATERTK
1
CORRECTIONS -
header
Command header.
-
See Messages on page 25 for more
information.
2
mode
RTCM
2
RTCA
3
CMR
4
RTCMV3 14
NOVATELX 35
Serial port interface mode identifier. For more information, see Table 42: Serial Port Interface Modes on page 201
3
port
See Table 59: COM Port Identifiers on page 338
Port to configure
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
For information about the RTCM, RTCA and CMR messages, refer to the official standards document for those messages.
OEM7 Commands and Logs Reference Manual v10
187
Chapter 2 GNSS Commands
2.58 GGAQUALITY
Customizes the GPGGA GPS quality indicator
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to customize the NMEA GPGGA GPS quality indicator. See also the GPGGA log on page 515.
Message ID: 691
Abbreviated ASCII Syntax: GGAQUALITY #entries pos_type quality
Input Example 1: GGAQUALITY 1 waas 2
Makes the WAAS solution type show 2 as the quality indicator.
Input Example 2: GGAQUALITY 2 waas 2 NARROW_FLOAT 3
Makes the WAAS solution type show 2 and the NARROW_FLOAT solution type show 3, as their quality indicators.
Input Example 3: GGAQUALITY 0
Sets all the quality indicators back to the default.
Some solution types, see Table 75: Position or Velocity Type on page 437, share a quality indicator. For example, converged PPP and NARROW_FLOAT all share an indicator of 5. This command can be used to customize an application to have unique indicators for each solution type. Sets all the quality indicators back to the default. Refer to Table 99: GPS Quality Indicators on page 517.
Field
Field Type
ASCII Value
Binary Value
1
GGAQUALITY header
-
-
2
#entries
0-20
Description
Command header. See Messages on page 25 for more information.
The number of position types that are being remapped (20 max)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
188
Chapter 2 GNSS Commands
Field Field Type
3
pos_type
ASCII Binary Value Value
See Table 75: Position or Velocity Type on page 437
Description
The position type that is being remapped
4
quality
See Table 99: GPS Quality Indicators on page 517
The remapped quality indicator value that will appear in the GPGGA log for this position type
...
Next solution type and quality indicator set, if applicable
Format
Binary Bytes
Binary Offset
Enum 4
H+4
Ulong 4 Variable
H+8
OEM7 Commands and Logs Reference Manual v10
189
Chapter 2 GNSS Commands
2.59 GLIDEINITIALIZATIONPERIOD
Configures the GLIDE initialization period
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command sets the initialization period for Relative PDP (GLIDE) when pseudorange measurements are used more heavily. During the initialization period, the PDP output position is not as smooth as during full GLIDE operation, but it helps to get better absolute accuracy at the start. The longer this period is, the better the absolute accuracy that can be attained. The maximum period that can be set through GLIDEINITIALIZATIONPERIOD is 1200 seconds.
Message ID: 1760
Abbreviated ASCII Syntax: GLIDEINITIALIZATIONPERIOD initialization
Factory Default: GLIDEINITIALIZATIONPERIOD 300
ASCII Example: GLIDEINITIALIZATIONPERIOD 100
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
GLIDEINITIALIZATION PERIOD header
-
-
Command
header. See
Messages on
-
page 25 for more
information.
H
0
2
initialization
0 -1200 s
Initialization
period for GLIDE Double 8
H
in seconds
OEM7 Commands and Logs Reference Manual v10
190
Chapter 2 GNSS Commands
2.60 GLOECUTOFF
Sets GLONASS satellite elevation cut-off
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the elevation cut-off angle for tracked GLONASS satellites. The receiver does not start automatically searching for a satellite until it rises above the cut-off angle (when satellite position is known). Tracked satellites that fall below the cut-off angle are no longer tracked unless they were manually assigned (see the ASSIGN command on page 68). In either case, satellites below the GLOECUTOFF angle are eliminated from the internal position and clock offset solution computations. This command permits a negative cut-off angle and can be used in the following situations:
l The antenna is at a high altitude and can look below the local horizon l Satellites are visible below the horizon due to atmospheric refraction
Care must be taken when using GLOECUTOFF because the signals from lower elevation satellites are traveling through more atmosphere and are therefore degraded. Use of satellites below 5 degrees is not recommended.
Use the ELEVATIONCUTOFF command (see page 141) to set the cut-off angle for any system.
For dual antenna receivers, this command applies to both the primary and secondary antennas.
Message ID: 735 Abbreviated ASCII Syntax:
GLOECUTOFF angle
Factory Default: GLOECUTOFF 5.0
ASCII Example: GLOECUTOFF 0
OEM7 Commands and Logs Reference Manual v10
191
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
1
GLOECUTOFF header
-
-
Command header. See Messages on page 25 for more information.
2
angle
�90.0 degrees
Elevation cut-off angle relative to horizon
Format
Binary Bytes
Binary Offset
-
H
0
Float
4
H
OEM7 Commands and Logs Reference Manual v10
192
Chapter 2 GNSS Commands
2.61 HDTOUTTHRESHOLD
Controls GPHDT log output
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to control the output of the NMEA GPHDT log (see page 530). It sets a heading standard deviation threshold. Only heading information with a standard deviation less than this threshold can be output into a GPHDT message.
Message ID: 1062
Abbreviated ASCII Syntax: HDTOUTTHRESHOLD thresh
Factory Default: HDTOUTTHRESHOLD 2.0
ASCII Example: HDTOUTTHRESHOLD 12.0
Field
Field Type
ASCII Binary Value Value
Description
1
HDTOUTTHRESHOLD header
-
-
Command header. See Messages on page 25 for more information.
2
thresh
0.0 - 180.0
Heading standard deviation threshold (degrees)
Format
Binary Bytes
Binary Offset
-
H
0
Float
4
H
OEM7 Commands and Logs Reference Manual v10
193
Chapter 2 GNSS Commands
2.62 HEADINGOFFSET
Adds heading and pitch offset values
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to add an offset in the heading and pitch values of the HEADING2 log (see page 547) and GPHDT log (see page 530).
Message ID: 1082
Abbreviated ASCII Syntax: HEADINGOFFSET headingoffsetindeg [pitchoffsetindeg]
Factory Default: HEADINGOFFSET 0 0
ASCII Example: HEADINGOFFSET 2 -1
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
HEADINGOFFSET header
-
-
Command header.
See Messages on page 25 for more
-
information.
H
0
Offset added to
2
headingoffsetindeg -180.0 - 180.0 heading output
Float
4
H
(degrees). Default=0
Offset added to pitch
3
pitchoffsetindeg
-90.0 - 90.0
output (degrees).
Float
4
Default=0
H+4
OEM7 Commands and Logs Reference Manual v10
194
Chapter 2 GNSS Commands
2.63 ICOMCONFIG
Configures IP virtual COM port
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This command is used for Ethernet set up and to configure the transport/application layer of the configuration.
Access to the ICOM ports can be restricted by turning on ICOM security using the IPSERVICE command (see page 207).
Message ID: 1248
Abbreviated ASCII Syntax: ICOMCONFIG [port] protocol [endpoint[bindinterface]]
Factory Default: ICOMCONFIG ICOM1 TCP :3001 ICOMCONFIG ICOM2 TCP :3002 ICOMCONFIG ICOM3 TCP :3003 ICOMCONFIG ICOM4 TCP :3004 ICOMCONFIG ICOM5 TCP :3005 ICOMCONFIG ICOM6 TCP :3006 ICOMCONFIG ICOM7 TCP :3007
ASCII Example: ICOMCONFIG ICOM1 TCP :2000 All
Due to security concerns, configuring and enabling ICOM ports should only be done to receivers on a closed system, that is, board-to-board. NovAtel is not liable for any security breaches that may occur if not used on a closed system.
Field Field Type
ASCII Value
1
ICOMCONFIG Header
-
Binary Value
-
Data Description
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
195
Chapter 2 GNSS Commands
Field Field Type
2
port
ASCII Value
Binary Value
THISPORT 6
ICOM1
23
ICOM2
24
ICOM3
25
ICOM4
29
ICOM5
46
ICOM6
47
ICOM7
48
3
protocol
DISABLED 1
TCP
2
UDP
3
4
endpoint
Host:Port
For example: 10.0.3.1:8000
mybase.com:3000
5
bindInterface
ALL (default)
1
Data Description
Format
Binary Bytes
Binary Offset
Name of the port
(default =
Enum 4
H
THISPORT).
Will disable the service
Use Raw TCP
Use Raw UDP
Endpoint to wait on, or to connect to where host is a host name or IP address and port is the TCP/UDP port number. If host is blank, act as a server
Not supported. Set to ALL for future compatibility.
Enum
String [80]
Enum
4
H+4
variable
1
H+8
4
H+88
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
196
Chapter 2 GNSS Commands
2.64 INTERFACEMODE
Sets receive or transmit modes for ports
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to specify what type of data a particular port on the receiver can transmit and receive. The receive type tells the receiver what type of data to accept on the specified port. The transmit type tells the receiver what kind of data it can generate. For example, to accept RTCMV3 differential corrections, set the receive type on the port to RTCMV3.
It is also possible to disable or enable the generation or transmission of command responses for a particular port. Disabling of responses is important for applications where data is required in a specific form and the introduction of extra bytes may cause problems, i.e., RTCA, RTCM, RTCMV3 or CMR. Disabling a port prompt is also useful when the port is connected to a modem or other device that responds with data the RECEIVER does not recognize.
For applications running in specific interface modes, see Table 42: Serial Port Interface Modes on page 201, please set the appropriate interface modes before sending or receiving corrections. It is important that the port interface mode matches the data being received on that port. Mismatches between the interface mode and received data can result in CPU overloads.
When INTERFACEMODE port NONE NONE OFF is set, the specified port is disabled from interpreting any input or output data. Therefore, no commands or differential corrections are decoded by the specified port. When GENERIC is set for a port, it is also disabled but data can be passed through the disabled port and be output from an alternative port using the pass-through logs PASSCOM, PASSAUX and PASSUSB. See PASSCOM, PASSAUX, PASSUSB, PASSETH1, PASSICOM, PASSNCOM on page 633 for details on these logs along with the Operation chapter in the OEM7 Installation and Operation User Manual for information about pass-through logging. See also the SERIALCONFIG command on page 336.If you intend to use the SERIALCONFIG command (see page 336), ensure you do so before the INTERFACEMODE command on each port. The SERIALCONFIG command (see page 336) can remove the INTERFACEMODE command setting if the baud rate is changed after the interface mode is set. You should also turn break detection off using the SERIALCONFIG command (see page 336) to stop the port from resetting because it is interpreting incoming bits as a break command. If such a reset happens, the Interface mode will be set back to the default NOVATEL mode for both input and output.
2.64.1 SPAN Systems
The INTERFACEMODE of the receiver is also configured for the serial port dedicated to the IMU. This mode changes automatically upon sending a CONNECTIMU command (see page 886) and the change is reflected when logging this command. This is normal operation.
When the CONNECTIMU command (see page 886) is used to configure the IMU connected to the receiver, the correct interface mode for the IMU port is automatically set. The IMU port should not be altered using the INTERFACEMODE command in normal operation. Doing so may result in the loss of IMU communication.
OEM7 Commands and Logs Reference Manual v10
197
Chapter 2 GNSS Commands
Message ID: 3
Abbreviated ASCII Syntax: INTERFACEMODE [port] rxtype txtype [responses]
Factory Default: INTERFACEMODE COM1 NOVATEL NOVATEL ON INTERFACEMODE COM2 NOVATEL NOVATEL ON INTERFACEMODE COM3 NOVATEL NOVATEL ON INTERFACEMODE AUX NOVATEL NOVATEL ON INTERFACEMODE USB1 NOVATEL NOVATEL ON INTERFACEMODE USB2 NOVATEL NOVATEL ON INTERFACEMODE USB3 NOVATEL NOVATEL ON INTERFACEMODE ICOM1 NOVATEL NOVATEL ON INTERFACEMODE ICOM2 NOVATEL NOVATEL ON INTERFACEMODE ICOM3 NOVATEL NOVATEL ON INTERFACEMODE ICOM4 NOVATEL NOVATEL ON INTERFACEMODE ICOM5 NOVATEL NOVATEL ON INTERFACEMODE ICOM6 NOVATEL NOVATEL ON INTERFACEMODE ICOM7 NOVATEL NOVATEL ON INTERFACEMODE NCOM1 RTCMV3 NONE OFF INTERFACEMODE NCOM2 RTCMV3 NONE OFF INTERFACEMODE NCOM3 RTCMV3 NONE OFF INTERFACEMODE CCOM1 NOVATELBINARY NOVATELBINARY ON INTERFACEMODE CCOM2 NOVATELBINARY NOVATELBINARY ON INTERFACEMODE CCOM3 AUTO NOVATEL OFF INTERFACEMODE CCOM4 AUTO NOVATEL OFF INTERFACEMODE CCOM5 AUTO NOVATEL OFF INTERFACEMODE CCOM6 AUTO NOVATEL OFF INTERFACEMODE SCOM1 NOVATEL NOVATEL ON INTERFACEMODE SCOM2 NOVATEL NOVATEL ON INTERFACEMODE SCOM3 NOVATEL NOVATEL ON INTERFACEMODE SCOM4 NOVATEL NOVATEL ON
ASCII Example 1: INTERFACEMODE COM1 RTCMV3 NOVATEL ON
ASCII Example 2: INTERFACEMODE COM2 MRTCA NONE
OEM7 Commands and Logs Reference Manual v10
198
Chapter 2 GNSS Commands
Are NovAtel receivers compatible with others on the market?
All GNSS receivers output two solutions: position and time. The manner in which they output them makes each receiver unique. Most geodetic and survey grade receivers output the position in electronic form (typically RS-232), which makes them compatible with most computers and data loggers. All NovAtel receivers have this ability. However, each manufacturer has a unique way of formatting the messages. A NovAtel receiver is not directly compatible with a Trimble or Ashtech receiver (which are also incompatible with each other) unless everyone uses a standard data format.
However, there are several standard data formats available. For position and navigation output there is the NMEA format. Real-time differential corrections use RTCM or RTCA format. For receiver code and phase data RINEX format is often used. NovAtel and all other major manufacturers support these formats and can work together using them. The NovAtel format measurement logs can be converted to RINEX using the utilities provided in NovAtel Connect.
Field Field Type
ASCII Value
Binary Value
1
INTERFACEMODE header
-
-
2
port
3
rxtype
4
txtype
5
responses
See Table 32: Communications Port Identifiers on page 137
See Table 42: Serial Port Interface Modes on the next page
See Table 42: Serial Port Interface Modes on the next page
OFF
0
ON
1
Description
Command header. See Messages on page 25 for more information. Serial port identifier (default = THISPORT)
Receive interface mode
Transmit interface mode
Turn response generation off Turn response generation on (default)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
Enum 4
H+8
Enum 4
H+12
OEM7 Commands and Logs Reference Manual v10
199
Chapter 2 GNSS Commands
Table 42: Serial Port Interface Modes
Binary Value
ASCII Value
Description
0
NONE
The port accepts/generates nothing. The port is disabled
1
NOVATEL
The port accepts/generates NovAtel commands and logs
2
RTCM
The port accepts/generates RTCM corrections
3
RTCA
The port accepts/generates RTCA corrections
4
CMR
The port accepts/generates CMR corrections
5
Reserved
6
Reserved
7
IMU
This port supports communication with a NovAtel supported IMU.
8
RTCMNOCR
When RTCMNOCR is used as the txtype, the port generates RTCM corrections without the CR/LF appended.
When RTCMNOCR is used as the rxtype, the port accepts RTCM corrections with or without the CR/LF appended.
9
Reserved
10 TCOM1 11 TCOM2 12 TCOM3 13 TAUX 1
INTERFACEMODE tunnel modes. To configure a full duplex tunnel, configure the baud rate on each port. Once a tunnel is established, the baud rate does not change. Special characters, such as a BREAK condition, do not route across the tunnel transparently and the serial port is altered, see the SERIALCONFIG command on page 336. Only serial ports may be in a tunnel configuration: COM1, COM2, COM3 or AUX may be used.
For example, configure a tunnel at 115200 bps between COM1 and AUX:
SERIALCONFIG AUX 115200
SERIALCONFIG COM1 115200
INTERFACEMODE AUX TCOM1 NONE OFF
INTERFACEMODE COM1 TAUX NONE OFF
The tunnel is fully configured to receive/transmit at a baud rate of 115200 bps
14 RTCMV3
The port accepts/generates RTCM Version 3.0 corrections
1Only available on specific models. OEM7 Commands and Logs Reference Manual v10
200
Chapter 2 GNSS Commands
Binary Value
ASCII Value
Description
15 NOVATELBINARY
The port only accepts/generates binary messages. If an ASCII command is entered when the mode is set to binary only, the command is ignored. Only properly formatted binary messages are responded to and the response is a binary message
16-17 Reserved
18 GENERIC
The port accepts/generates nothing. The SEND command (see page 333) or SENDHEX command (see page 335) from another port generate data on this port. Any incoming data on this port can be seen with PASSCOM logs on another port, see PASSCOM, PASSAUX, PASSUSB, PASSETH1, PASSICOM, PASSNCOM log on page 633
19 IMARIMU
This port supports communication with an iMAR IMU.
20 MRTCA
The port accepts/generates Modified Radio Technical Commission for Aeronautics (MRTCA) corrections
21-22 Reserved
23 KVHIMU
This port supports communication with a KVH CG5100 IMU.
24-26 Reserved
27 AUTO
For auto-detecting different RTK correction formats and incoming baud rate (over serial ports).
The change of baud rate will not appear when SERIALCONFIG is logged as this shows the saved baud rate for that port.
28-34 Reserved
35 NOVATELX
The port accepts/generates NOVATELX corrections
36-40 Reserved
41 KVH1750IMU
This port supports communication with a KVH 17xx series IMU.
42-45 Reserved
46 TCCOM1
CCOM1 Tunnel
47 TCCOM2
CCOM2 Tunnel
48 TCCOM3
CCOM3 Tunnel
49
NOVATELMINBINARY
NovAtel binary message with a minimal header. Only available for CCOM ports.
50 TCCOM4
CCOM4 Tunnel
OEM7 Commands and Logs Reference Manual v10
201
Chapter 2 GNSS Commands
Binary Value
ASCII Value
51 TCCOM5
52 TCCOM6
53-57 Reserved
60
TSCOM1
61
TSCOM2
62
TSCOM3
63
TSCOM4
64
LUA
CCOM5 Tunnel CCOM6 Tunnel
Description
SCOM1 Tunnel SCOM2 Tunnel SCOM3 Tunnel SCOM4 Tunnel Lua stdin/stdout/stderr. Use the LUA PROMPT command to set this Interface Mode.
OEM7 Commands and Logs Reference Manual v10
202
Chapter 2 GNSS Commands
2.65 IONOCONDITION
Sets ionospheric condition
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to change the level of ionosphere activity that is assumed by the RTK positioning algorithms.
Only advanced users should use this command.
Message ID: 1215 Abbreviated ASCII Syntax:
IONOCONDITION mode
Factory Default: IONOCONDITION AUTO
ASCII Example: IONOCONDITION normal
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
Command header.
1
IONOCONDITION header
-
-
See Messages on page 25 for more
H
information.
quiet
0
Receiver assumes a low level of ionosphere activity
normal 1
Receiver assumes a medium level of ionosphere activity
2
mode
Receiver assumes a Enum 4
H
disturbed 2
high level of
ionosphere activity
AUTO
10
Receiver monitors the ionosphere activity and adapts behavior accordingly
OEM7 Commands and Logs Reference Manual v10
203
Chapter 2 GNSS Commands
2.66 IPCONFIG
Configures network IP settings
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This command is used to configure static/dynamic TCP/IP properties for the Ethernet connection.
In addition to configuring an IP address and netmask for the interface, this command also includes a gateway address.
Message ID: 1243 Abbreviated ASCII Syntax:
IPCONFIG [interface_name] address_mode [IP_address [netmask [gateway]]]
Factory Default: IPCONFIG ETHA DHCP
ASCII Examples: IPCONFIG ETHA STATIC 192.168.74.10 255.255.255.0 192.168.74.1
Field
Field Type
ASCII Binary Value Value
1
IPCONFIG Header
-
-
2
interface name
ETHA
2
3
address mode
DHCP 1 STATIC 2
4
IP address
ddd.ddd.ddd.ddd (For example: 10.0.0.2)
Description
Command header. See Messages on page 25 for more information.
Name of the Ethernet interface (default = ETHA)
Use Dynamic IP address
Use Static IP address
IP Address-decimal dot notation
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
String [16]
variable
1
H+8
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
204
Chapter 2 GNSS Commands
Field
Field Type
5
netmask
6
gateway
ASCII Binary Value Value
ddd.ddd.ddd.ddd (For example: 255.255.255.0)
ddd.ddd.ddd.ddd (For example: 10.0.0.1)
Description
Netmask-decimal dot notation
Gateway-decimal dot notation
Format
Binary Bytes
Binary Offset
String [16]
variable
1
H+24
String [16]
variable
1
H+40
OEM7 Commands and Logs Reference Manual v10
205
Chapter 2 GNSS Commands
2.67 IPSERVICE
Configure availability of networks ports/services
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
Use the IPSERVICE command to configure the availability of specific network ports/services. When disabled, the service does not accept incoming connections.
On most OEM7 receivers, the FTP Server is disabled by default. The exception is the PwrPak7 which has FTP enabled by default.
We have found two problems in the Microsoft� FTP clients contained within the Internet Explorer� and Edge browsers which make them unsuitable for retrieving files from a NovAtel receiver. When using a Windows� computer to transfer files off a NovAtel
receiver, we suggest using a 3rd party FTP client.
Message ID: 1575
Abbreviated ASCII Syntax: IPSERVICE IPService switch
Factory Default: IPSERVICE WEB_SERVER DISABLE (OEM719 and OEM7500) IPSERVICE WEB_SERVER ENABLE (OEM729, OEM7600 OEM7700 and OEM7720) IPSERVICE SECURE_ICOM DISABLE
ASCII Example: IPSERVICE FTP_SERVER ENABLE
Field
Field Type
ASCII Value
1
IPSERVICE header
-
Binary Value
Description
Command header. See
-
Messages on page 25 for
more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
206
Chapter 2 GNSS Commands
Field
Field Type
2
ipservice
3
switch
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
NO_ PORT
0
No port
FTP_ SERVER
1
FTP server port. For most OEM7 receivers the default = DISABLE. For the PwrPak7 the default = ENABLE.
WEB_ SERVER
2
Web server port For most OEM7 receivers the default = ENABLE. For the OEM7500 and OEM719 the default = DISABLE.
Enables or disables
security on ICOM ports.
Enum 4
H
SECURE_ ICOM
3
When security is enabled, a login is required as part of the connection process (see the LOGIN command on page 231).
Default = DISABLE
Note: Security in this sense means users must supply a name and password before being allowed to enter commands on the ICOM ports. It does not mean there is data encryption
DISABLE 0 ENABLE 1
Disable the IP service specified.
Enable the IP service specified.
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
207
Chapter 2 GNSS Commands
2.68 ITBANDPASSCONFIG
Enable and configure bandpass filter on receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to apply a bandpass filter at a certain frequency to mitigate interference in the pass band of GNSS signals. The ITBANDPASSBANK log (see page 563) provides information on the allowable configuration settings for each frequency band. The bandpass filter is symmetrical in nature, which means that specifying one cutoff frequency will apply a cutoff on both the low side and high side of the spectrum center frequency. Only one filter can be applied for each signal.
On OEM7720, PwrPak7D, PwrPak7D-E1 and SPAN CPT7receivers, any filter enabled for GPS L2 or GLONASS L2 on the secondary antenna will be applied to both GPS L2 and GLONASS L2. For this reason, care must be taken to avoid attenuating the signals with a bandpass filter that is too narrow in bandwidth. The recommended maximum lower cutoff frequency is 1221 MHz. The recommended minimum upper cutoff frequency is 1254 MHz.
Message ID: 1999 Abbreviated ASCII Syntax:
ITBANDPASSCONFIG frequency switch [cutofffrequency]
ASCII Example: ITBANDPASSCONFIG gpsl5 enable 1165.975
Field Field Type
ASCII Binary Value Value
Description
1
ITBANDPASS CONFIG header
-
Command header.
-
See Messages on page 25 for more
information.
2
frequency
See Table 49: Frequency Types on page 219
Set the frequency band on which to apply the filter
3
switch
DISABLE 0 ENABLE 1
Disable filter Enable filter
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4 Enum 4
H H+4
OEM7 Commands and Logs Reference Manual v10
208
Chapter 2 GNSS Commands
Field Field Type
4
cutofffrequency
ASCII Value
Binary Value
Description
Cut off frequency for band pass filter (MHz). (default = 0)
Refer to ITBANDPASSBANK log (see page 563) for the allowable values.
Format
Binary Bytes
Binary Offset
Float
4
H+8
OEM7 Commands and Logs Reference Manual v10
209
Chapter 2 GNSS Commands
2.69 ITDETECTCONFIG
Enable interference detection on receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to enable or disable interference detection on the receiver. It is applicable to both Spectral Analysis Detection and Statistical Analysis Detection at the same time. Detection can be enabled on all RF paths, only one RF path (L1, L2, or L5), or no RF paths. By default, only the RF paths connecting to the first antenna are enabled.
Message ID: 2143
Abbreviated ASCII Syntax: ITDETECTCONFIG RFPath [reserved1] [reserved2] [reserved3]
Factory Default: ITDETECTCONFIG all
ASCII Example: ITDETECTCONFIG L1 ITDETECTCONFIG none
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
ITDETECTCONFIG header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
RFPath
RF path selected for
See Table 43: RF Path Selection below
detection. By default, all paths are turned on. The receiver will cycle through all
Enum
4
H
active paths.
3
reserved1
0
Reserved parameter Ulong 4
H+4
4
reserved2
0
Reserved parameter Ulong 4
H+8
5
reserved3
0
Reserved parameter Ulong 4
H+12
Table 43: RF Path Selection
ASCII Value Binary Value
Description
NONE
0
Turn off detection on all paths
ALL
1
Turn on detection on all paths (cycle through all active paths)
OEM7 Commands and Logs Reference Manual v10
210
Chapter 2 GNSS Commands
ASCII Value Binary Value
Description
L1
2
Turn on detection only on L1 path
L2
3
Turn on detection only on L2 path
L5
4
Turn on detection only on L5 path
OEM7 Commands and Logs Reference Manual v10
211
Chapter 2 GNSS Commands
2.70 ITFRONTENDMODE
Configure the front end mode settings
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to configure the front end mode for the L1, L2 and L5 RF paths to use the default third-order CIC mode or HDR (High Dynamic Range) mode. The HDR mode is used in an interference environment to obtain best interference rejection in general. However, the power consumption will increase in this mode.
Message ID: 2039
Abbreviated ASCII Syntax: ITFRONTENDMODE frequency mode
Factory Default ITFRONTENDMODE L1 cic3 ITFRONTENDMODE L2 cic3 ITFRONTENDMODE LBAND cic3 ITFRONTENDMODE L5 cic3
ASCII Example: ITFRONTENDMODE L1 hdr
On the OEM7500, the default mode for all frequency bands is HDR.
Field
Field Type
ASCII Binary Value Value
1
ITFRONTENDMODE header
-
-
2
frequency
3
mode
See Table 44: Frequency Bands on the next page
See Table 45: Mode on the next page
Description
Command header. See Messages on page 25 for more information.
Set the frequency band for adjustment
Select the desired mode
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4 Enum 4
H H+4
OEM7 Commands and Logs Reference Manual v10
212
Chapter 2 GNSS Commands
Table 44: Frequency Bands
Binary Value ASCII Value
Description
2
L1
Selects the L1 frequency
3
L2
Selects the L2 frequency
4
LBAND
Selects the L-Band frequency
5
L5
Selects the L5 frequency
Table 45: Mode
Binary Value ASCII Value
Description
0
CIC3
3rd order CIC (CIC3) mode (default)
1
HDR
High Dynamic Range (HDR) mode
OEM7 Commands and Logs Reference Manual v10
213
Chapter 2 GNSS Commands
2.71 ITPROGFILTCONFIG
Enable and configure filtering on the receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to set the programmable filter to be either a notch filter or a bandpass filter to mitigate interference in the pass band of GNSS signals. The notch filter is used to attenuate a very narrow band of frequencies (specified by the notch width) around the center frequency. The bandpass filter is symmetrical in nature, which means that specifying one cutoff frequency will apply a cutoff on both the low side and high side of the spectrum center frequency. The ITPROGFILTBANK log (see page 571) provides information on the allowable configuration settings for the programmable filter (i.e. the allowable settings for the notch filter and bandpass filter) for each frequency band. Only one filter can be applied for each frequency.
Message ID: 2000
Abbreviated ASCII Syntax: ITPROGFILTCONFIG frequency filterid switch [filtermode] [cutofffreq] [notchwidth]
ASCII Example: ITPROGFILTCONFIG gpsl1 pf0 enable notchfilter 1580 1
Field Field Type
ASCII Value
Binary Value
Description
ITPROGFILT
1
CONFIG
-
header
Command header. See
-
Messages on page 25
for more information.
See Table 49:
Set the frequency band
2
frequency Frequency Types on on which to apply the
page 219
filter
3
filterid
See Table 46: Programmable Filter ID on the next page
Select the filter ID to use
4
switch
DISABLE 0 ENABLE 1
Disable the filter Enable the filter
5
filtermode
See Table 47: Programmable Filter Mode on the next page
Configure the type of filter to use (default = NONE)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
Enum 4
H+8
Enum 4
H+12
OEM7 Commands and Logs Reference Manual v10
214
Chapter 2 GNSS Commands
Field Field Type
ASCII Value
6
cutofffreq
7
notchwidth
Binary Value
Description
Center frequency for notch filter or cut off frequency for bandpass filter (MHz).
Refer to ITPROGFILTBANK log (see page 571) for the allowable values.
(default = 0)
Notch width (MHz).
Refer to ITPROGFILTBANK log (see page 571) for the allowable values.
(default = 0)
Format
Binary Bytes
Binary Offset
Float
4
H+16
Float
4
H+20
Table 46: Programmable Filter ID
Binary Value ASCII Value
Description
0
PF0
Programmable Filter 0
1
PF1
Programmable Filter 1
Table 47: Programmable Filter Mode
Binary Value
ASCII Value
Description
0
NOTCHFILTER
Configure the filter as a notch filter
1
BANDPASSFILTER Configure the filter as a bandpass filter
2
NONE
Turn off filter
If the switch parameter is set to ENABLED while the filtermode parameter is set to NONE, the system will return a parameter out of range message.
OEM7 Commands and Logs Reference Manual v10
215
Chapter 2 GNSS Commands
2.72 ITSPECTRALANALYSIS
Enable and configure spectral analysis on receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to view the spectrum in a range of frequencies. The ITSPECTRALANALYSIS command enables and configures the spectral analysis. The spectrum is viewed by plotting the PSD samples in the ITPSDFINAL log (see page 573).
Decreasing the update period or increasing the FFT size will impact receiver idle time. The idle time should be monitored to prevent adverse effects on receiver performance.
Message ID: 1967
Abbreviated ASCII Syntax: ITSPECTRALANALYSIS mode [frequency] [updateperiod] [FFTsize] [timeavg] [integration_window]
Factory Default: ITSPECTRALANALYSIS off
ASCII Example: ITSPECTRALANALYSIS predecimation gpsl1 100 16k 0 1
Field
Field Type
ASCII Binary Value Value
Description
ITSPECTRAL
1
ANALYSIS
-
-
header
Command header. See Messages on page 25 for more information.
2
mode
See Table 48: Data Sources for PSD Samples on the next page
Set the view mode
See Table 49:
3
frequency
Frequency Types on
Set the frequency band to view
page 219
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
216
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
The spectrum update rate in milliseconds
The update period is
limited by the FFT size
4
updateperiod 50 to 100000
chosen. For 32k the minimum update period is
100 ms and for 64k the
minimum update period is
200 ms.
(default = 1000)
5
FFTsize
See Table 50: FFT Sizes on page 220
The frequency resolution of the spectrum
(default = 1k)
6
timeavg
0 to 50
Time averaging window in seconds. 0 means no time average
(default = 10)
7
integration window
1 to 1024
The integration window size of FFT samples. 1 means no integration.
(default = 5)
Format
Binary Bytes
Binary Offset
Ulong 4
H+8
Enum 4
H+12
Ulong 4
H+16
Ulong 4
H+20
Binary Value 0 1
2
3
Table 48: Data Sources for PSD Samples
ASCII Value
Description
OFF
Disable spectral analysis
PREDECIMATION
Perform spectrum analysis on the pre-decimated spectrum.
This can be used to see a wide view of the spectrum for an RF path (L1, L2 or L5).
POSTDECIMATION
Perform spectrum analysis on the post-decimated spectrum.
This is narrower than predecimation and is used to see the spectrum for a given signal.
POSTFILTER
Perform spectrum analysis on the post-filtered spectrum.
This can be used when either bandpass or notch filters have been enabled to see the spectrum after the filters are applied.
OEM7 Commands and Logs Reference Manual v10
217
Chapter 2 GNSS Commands
The post-filter spectrum is not available for the Galileo AltBOC frequency. Only the predecimation and post-decimation spectrums are available for Galileo AltBOC.
Table 49: Frequency Types
Binary Value ASCII Value
Description
0
GPSL1
GPS L1 frequency
1
GPSL2
GPS L2 frequency
2
GLONASSL1
GLONASS L1 frequency
3
GLONASSL2
GLONASS L2 frequency
4
Reserved
5
GPSL5
GPS L5 frequency
61
LBAND
Inmarsat L-Band frequency
7
GALILEOE1
Galileo E1 frequency
8
GALILEOE5A
Galileo E5A frequency
9
GALILEOE5B
Galileo E5B frequency
10
GALILEOALTBOC Galileo AltBOC frequency
11
BEIDOUB1
BeiDou B1 frequency
12
BEIDOUB2
BeiDou B2 frequency
13
QZSSL1
QZSS L1 frequency
14
QZSSL2
QZSS L2 frequency
15
QZSSL5
QZSS L5 frequency
16
QZSSL6
QZSS L6 frequency
17
GALILEOE6
Galileo E6 frequency
18
BEIDOUB3
BeiDou B3 frequency
19
GLONASSL3
GLONASS L3 frequency
20
NAVICL5
NavIC L5 frequency
21
BEIDOUB1C
BeiDou B1C frequency
22
BEIDOUB2A
BeiDou B2a frequency
1Must first enable L-Band using the ASSIGNLBANDBEAM command. OEM7 Commands and Logs Reference Manual v10
218
Chapter 2 GNSS Commands
Table 50: FFT Sizes
Binary Value ASCII Value
Description
0
1K
1K FFT, 1024 samples
1
2K
2K FFT, 2048 samples
2
4K
4K FFT, 4096 samples
3
8K
8K FFT, 8192 samples
4
16K
16K FFT, 16384 samples
5
32K
32K FFT, 32768 samples
6
64K
64K FFT, 65536 samples
The 64k FFT is not available in post-decimation or post-filter modes.
OEM7 Commands and Logs Reference Manual v10
219
Chapter 2 GNSS Commands
2.73 J1939CONFIG
Configure CAN network-level parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to configure the CAN J1939 network-level parameters (NAME, etc). Issuing this command may initiate a CAN 'Address Claim' procedure. The status of the node and address claim are reported in the J1939STATUS log (see page 577). Once a "node" is configured using J1939CONFIG, and the "port" is configured to ON using CANCONFIG "port" ON, J1939CONFIG "node" cannot be entered again until the "port" is configured to "OFF" using CANCONFIG "port" OFF. (See the CANCONFIG command on page 100
Message ID: 1903
Abbreviated ASCII Syntax: J1939CONFIG node port [pref_addr [alt_addr_range_start] [alt_addr_range_end] [mfgcode] [industry] [devclass] [devinstance] [func] [funcinstance] [ECUinstance]]
Factory Default: J1939CONFIG NODE1 CAN1 1C 0 FD 305 2 0 0 23 0 0 J1939CONFIG NODE2 CAN2 1C 0 FD 305 2 0 0 23 0 0
ASCII Example : J1939CONFIG NODE1 CAN1 AA 0 FD 305 2 0 0 23 0 0
Field
Field Type
ASCII Binary Value Value
Description
1
J1939CONFIG header
-
-
Command header. See Messages on page 25 for more information.
2
node
NODE1 1 NODE2 2
Identifies the J1939 Node (i.e. CAN NAME)
3
port
CAN1 1 CAN2 2
Physical CAN port to use
4
pref_addr
0x0 - 0xFD
Preferred CAN address. The receiver attempts to claim this address
(default = 0x0)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4 Enum 4
H H+4
Ulong 4
H+8
OEM7 Commands and Logs Reference Manual v10
220
Chapter 2 GNSS Commands
Field Field Type
5
alt_addr_ range_start
6
alt_addr_ range_end
7
mfgcode
8
industry
9
devclass
10
devinstance
11
func
12
funcinstance
13
ECUinstance
ASCII Binary Value Value
0x0 - 0xFD
0x0 - 0xFD
0-2047 0-7 0 - 127 0 - 15 0 - 255 0 - 31 0-7
Description
Format
Binary Bytes
Binary Offset
When the pref_addr
cannot be claimed, the
receiver attempts to claim
an address from this
Ulong 4
range.
(default: 0x0)
H+12
End of alternative address
range.
Ulong 4
(default: 0xFD)
H+16
NAME: Manufacturer
Code. Refer to ISO 11783-
5.
Ulong 4
(default: 0)
H+20
NAME: Industry Group (default: 2)
Ulong 4
H+24
NAME: Device Class (default: 0)
Ulong 4
H+28
NAME: Device Class Instance
(default: 0)
Ulong 4
H+32
NAME: Function (default: 23)
Ulong 4
H+36
NAME: Function instance Ulong 4
(default: 0)
H+40
NAME: ECU Instance (default: 0)
Ulong 4
H+44
Due to current limitations in the CAN stack, NODE1 can only be associated with CAN1 and NODE2 can only be associated with CAN2. A mismatch combination results in an 'invalid parameter' error.
Node statistics are reported in the J1939STATUS log (see page 577).
OEM7 Commands and Logs Reference Manual v10
221
Chapter 2 GNSS Commands
2.74 LOCKOUT
Prevents the receiver from using a satellite
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to prevent the receiver from using a satellite in the solution computations.
The LOCKOUT command does not prevent the receiver from tracking an undesirable satellite. LOCKOUT command and UNLOCKOUT command (see page 385) can be used with GPS, GLONASS, SBAS and QZSS PRNs.
This command must be repeated for each satellite to be locked out. See also the UNLOCKOUT command on page 385 and UNLOCKOUTALL command on page 386.
Message ID: 137
Abbreviated ASCII Syntax: LOCKOUT prn
Input Example: LOCKOUT 8
The LOCKOUT command removes one or more satellites from the solution while leaving other satellites available.
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
LOCKOUT header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
prn
Refer to PRN Numbers on page 44
Unique identifier for the satellite being locked out
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
222
Chapter 2 GNSS Commands
2.75 LOCKOUTSYSTEM
Prevents the receiver from using a system
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to prevent the receiver from using satellites in a system in the solution computations.
The LOCKOUTSYSTEM command does not prevent the receiver from tracking an undesirable satellite.
This command must be repeated for each system to be locked out. See also the UNLOCKOUTSYSTEM command on page 387 and UNLOCKOUTALL command on page 386.
Message ID: 871
Abbreviated ASCII Syntax: LOCKOUTSYSTEM system
Factory Defaults: LOCKOUTSYSTEM sbas LOCKOUTSYSTEM navic
The LOCKOUTSYSTEM command removes one or more systems from the solution while leaving other systems available.
Field
Field Type
ASCII Binary Value Value
Description
Command header.
1
LOCKOUTSYSTEM header
-
-
See Messages on page 25 for more
information.
2
system
See Table 105: Satellite System on page 553
A single satellite system to be locked out
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
223
Chapter 2 GNSS Commands
2.76 LOG
Requests logs from the receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Many different types of data can be logged using different methods of triggering the log events. Every log element can be directed to any combination of the receiver's ports. The ontime trigger option requires the addition of the period parameter. See Logs on page 409 for further information and a complete list of data log structures. The LOG command tables in this section show the binary format followed by the ASCII command format.
The optional parameter [hold] prevents a log from being removed when the UNLOGALL command (see page 390), with its defaults, is issued. To remove a log which was invoked using the [hold] parameter requires the specific use of the UNLOG command (see page 388). To remove all logs that have the [hold] parameter, use the UNLOGALL command (see page 390) with the held field set to 1.
The [port] parameter is optional. If [port] is not specified, [port] is defaulted to the port that the command was received on.
1. The OEM7 family of receivers can handle 80 simultaneous log requests. If an attempt is made to log more than 80 logs at a time, the receiver responds with an Insufficient Resources error. Note that RXSTATUSEVENTA logs are requested on most ports by default and these logs count against the 80.
2. The user is cautioned that each log requested requires additional CPU time and memory buffer space. Too many logs may result in lost data and low CPU idle time. Receiver overload can be monitored using the idle-time field and buffer overload bits of the Receiver Status in any log header.
3. Only the MARKPOS, MARK2POS, MARK3POS and MARK4POS log (see page 593), MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME log (see page 596) and `polled' log types are generated, on the fly, at the exact time of the mark. Synchronous and asynchronous logs output the most recently available data.
4. Use the ONNEW trigger with the MARKPOS, MARK2POS, MARK3POS and MARK4POS log (see page 593) and MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME log (see page 596).
5. Polled log types do not all allow fractional offsets.
6. If ONTIME trigger is used with asynchronous logs, the time stamp in the log does not necessarily represent the time the data was generated but rather the time when the log is transmitted.
7. Published logs are not placed in a queue if there is no physical or virtual connection when the log is generated. Thus, a log requested ONNEW or ONCHANGED that is in SAVECONFIG may not be received if it is published before connections are made. This can happen if there's no cable connected or if the communication protocol has not been established yet (e.g. CAN, Ethernet, USB, etc).
Message ID: 1
Abbreviated ASCII Syntax:
OEM7 Commands and Logs Reference Manual v10
224
Chapter 2 GNSS Commands
LOG [port] message ONNEW LOG [port] message ONCHANGED LOG [port] message ONTIME period [offset [hold]] LOG [port] message ONNEXT LOG [port] message ONCE LOG [port] message ONMARK
Factory Default: LOG COM1 RXSTATUSEVENTA ONNEW LOG COM2 RXSTATUSEVENTA ONNEW LOG COM3 RXSTATUSEVENTA ONNEW LOG AUX RXSTATUSEVENTA ONNEW LOG USB1 RXSTATUSEVENTA ONNEW LOG USB2 RXSTATUSEVENTA ONNEW LOG USB3 RXSTATUSEVENTA ONNEW LOG ICOM1 RXSTATUSEVENTA ONNEW LOG ICOM2 RXSTATUSEVENTA ONNEW LOG ICOM3 RXSTATUSEVENTA ONNEW LOG ICOM4 RXSTATUSEVENTA ONNEW LOG ICOM5 RXSTATUSEVENTA ONNEW LOG ICOM6 RXSTATUSEVENTA ONNEW LOG ICOM7 RXSTATUSEVENTA ONNEW
Abbreviated ASCII Example 1: LOG COM1 BESTPOS ONTIME 7 0.5 HOLD
The above example shows BESTPOS logging to com port 1 at 7 second intervals and offset by 0.5 seconds (output at 0.5, 7.5, 14.5 seconds and so on). The [hold] parameter is set so that logging is not disrupted by the UNLOGALL command (see page 390). To send a log once, the trigger option can be omitted.
Abbreviated ASCII Example 2: LOG COM1 BESTPOS ONCE
Using the NovAtel Connect utility there are two ways to initiate data logging from the receiver's serial ports. Either enter the LOG command in the Console window or use the interface provided in the Logging Control window. Ensure the Power Settings on the computer are not set to go into Hibernate or Standby modes. Data is lost if one of these modes occurs during a logging session.
OEM7 Commands and Logs Reference Manual v10
225
Chapter 2 GNSS Commands
2.76.1 Binary
Field
Field Type
Binary Value
Description
1
LOG (binary) header
See Table 3: Binary Message Header Structure on page 30
This field contains the message header
2
port
See Table 4:
Detailed Port
Output port
Identifier on page 31
3
message
Any valid message ID
Message ID of the log to output
Bits 0-4 =
Measurement source1
Bits 5-6 = Format
00 = Binary
01 = ASCII
10 = Abbreviated
4
message ASCII, NMEA
type
11 = Reserved
Message type of log
Bit 7 = Response Bit (Binary Response on page 41)
0 = Original Message
1 = Response Message
5
Reserved
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4 Ushort 2
H H+4
Char
1
H+6
Char
1
H+7
1Bits 0-4 are used to indicate the measurement source. For dual antenna receivers, if bit 0 is set, the log is from the secondary antenna.
OEM7 Commands and Logs Reference Manual v10
226
Chapter 2 GNSS Commands
Field
Field Type
Binary Value
0 = ONNEW
1 = ONCHANGED
2 = ONTIME
6
trigger
3 = ONNEXT
4 = ONCE
5 = ONMARK
Description
Format
Binary Bytes
Binary Offset
Does not output current message but outputs when the message is updated (not necessarily changed)
Outputs the current message and then continues to output when the message is changed
Output on a time interval
Output only the next message
Enum 4
H+8
Output only the current message (default). If no message is currently present, the next message is output when available.
Output when a pulse is
detected on the mark 1 input, MK1I 1 2
1Refer to the Technical Specifications appendix in the OEM7 Installation and Operation User Manual for more details on the MK1I pin. ONMARK only applies to MK1I. Events on MK2I (if available) do not trigger logs when ONMARK is used. Use the ONNEW trigger with the MARKTIME, MARK2TIME, MARKPOS or MARK2POS logs. 2Once the 1PPS signal has hit a rising edge, for both MARKPOS and MARKTIME logs, a resolution of both measurements is 10 ns. As for the ONMARK trigger for other logs that measure latency, for example RANGE and POSITION logs such as BESTPOS, it takes typically 20-30 ms (50 ms maximum) for the logs to output information from the 1PPS signal. Latency is the time between the reception of the 1PPS pulse and the first byte of the
associated log. See also the MARKPOS, MARK2POS, MARK3POS and MARK4POS log on page 593 and the
MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME log on page 596.
OEM7 Commands and Logs Reference Manual v10
227
Chapter 2 GNSS Commands
Field
Field Type
7
period
8
offset
9
hold
Binary Value
Description
Format
Binary Bytes
Binary Offset
Log period (for ONTIME trigger) in seconds
If the value entered is
Valid values for the lower than the minimum
high rate logging are measurement period, the
0.05, 0.1, 0.2, 0.25 command will be rejected.
and 0.5. For logging See Appendix A in the
Double 8
slower than 1 Hz any OEM7 Installation and
integer value is
Operation User Manual for
accepted
the maximum raw
measurement rate to
calculate the minimum
period.
H+12
A valid value is any integer (whole number) smaller than the period.
Offset for period
These decimal values, on
(ONTIME trigger) in their own, are also valid:
seconds. To log data 0.1, 0.2, 0.25 or 0.5, as
at 1 second, after
well as any multiple of the Double 8
every minute, set
maximum logging rate
the period to 60 and defined by the receiver
the offset to 1
model. The offset cannot
be smaller than the
minimum measurement
period supported by the
model.
H+20
0 = NOHOLD 1 = HOLD
Allow log to be removed by the UNLOGALL command (see page 390)
Prevent log from being
Enum 4
removed by the default
UNLOGALL command (see
page 390)
H+28
OEM7 Commands and Logs Reference Manual v10
228
Chapter 2 GNSS Commands
2.76.2 ASCII
Field
Field Name
ASCII Value
LOG
1
(ASCII) -
header
2
port
Table 4: Detailed Port Identifier on page 31
Any valid
3
message
message name, with an optional
A or B suffix
ONNEW
ONCHANGED
ONTIME
4
trigger
ONNEXT
ONCE
ONMARK
Any positive
double value
larger than the
5
period receiver's
minimum raw
measurement
period
Any positive
6
offset
double value smaller than the
period
NOHOLD
7
hold
HOLD
Description
This field contains the command name or the message header depending on whether the command is abbreviated ASCII or ASCII respectively
Output port (default = THISPORT)
Message name of log to output
Output when the message is updated (not necessarily changed)
Output when the message is changed
Output on a time interval
Output only the next message
Output only the current message (default)
Output when a pulse is detected on the mark 1 input, MK1I 2, 3
Log period (for ONTIME trigger) in seconds (default = 0) If the value entered is lower than the minimum measurement period, the command will be rejected. See Appendix A in the OEM7 Installation and Operation User Manual for the maximum raw measurement rate to calculate the minimum period.
Offset for period (ONTIME trigger) in seconds. If you want to log data, at 1 second after every minute, set the period to 60 and the offset to 1 (default = 0)
To be removed by the UNLOGALL command (see page 390) (default)
Prevent log from being removed by the default UNLOGALL command (see page 390)
Format Enum Char [ ]
Enum
Double Double Enum
OEM7 Commands and Logs Reference Manual v10
229
Chapter 2 GNSS Commands
2.77 LOGIN
Start a secure ICOM/SCOM connection to the receiver
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
When ICOM/SCOM ports have security enabled (see the IPSERVICE command on page 207), a session to the ICOM/SCOM port can be established but commands are refused until a valid LOGIN command is issued. Both the UserName and Password are required. The LOGIN command checks the supplied credentials against known UserNames/Passwords and determines if the login is successful or not. A successful login permits the secured ICOM/SCOM command interpreter to accept further commands and returns OK. An unsuccessful login does not release the secured ICOM/SCOM command interpreter and returns Login Failed.
Entering a LOGIN command on any command port other than the ICOM/SCOM port has no effect, regardless of whether the UserName/Password is correct. In this case, the appropriate response (OK or Login Failed) is returned, but there is no effect on the command interpreter.
When security is enabled, access to the port is restricted unless a valid name and password are supplied. It does not mean there is data encryption enabled. Username is case-insensitive and password is case-sensitive.
Message ID: 1671 Abbreviated ASCII Syntax:
LOGIN [commport] UserName Password
ASCII Example: LOGIN ADMIN ADMINPASSWORD
Field
Field Type
1
LOGIN header
ASCII Binary Value Value
Description
Command header. See
-
-
Messages on page 25 for
more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
230
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
ICOM1 23
ICOM2 24
ICOM3 25
ICOM4 29
ICOM5 46
2
commport ICOM6 47
ICOM7 48
SCOM1 49
SCOM2 50
The ICOM or SCOM port to log into.
This is an optional parameter.
If no value is entered, logs in to the ICOM port currently being used. (default=THISPORT)
SCOM3 51
SCOM4 52
3
username
Provide the user name for the login command.
The user name is not case sensitive.
4
password
Provide the password for the user name. The password is case sensitive
Format
Binary Bytes
Binary Offset
Enum 4
H
String [32]
variable
1
H+4
String [28]
variable
1
variable
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
231
Chapter 2 GNSS Commands
2.78 LOGOUT
End a secure ICOM/SCOM session started using the LOGIN command
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
Use the LOGOUT command to sign out of an ICOM/SCOM connection after a user has successfully logged in using the LOGIN command. After the sending the LOGOUT command, the ICOM/SCOM connection will not accept further commands, other than a new LOGIN command. The session itself is not ended. This only applies to ICOM/SCOM ports that have had security enabled (see the IPSERVICE command on page 207).
Message ID: 1672
Abbreviated ASCII Syntax: LOGOUT [commport]
ASCII Example: LOGOUT
Field
Field Type
ASCII Binary Value Value
Description
1
LOGOUT header
-
-
Command header. See Messages on page 25 for more information.
ICOM1 23
ICOM2 24
ICOM3 25
ICOM4 29
ICOM5 46
2
commport ICOM6 47
ICOM7 48
SCOM1 49
The ICOM or SCOM port from which to log out. This is an optional parameter. If no value is entered, logs out from the ICOM/SCOM port currently being used.
SCOM2 50
SCOM3 51
SCOM4 52
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
232
Chapter 2 GNSS Commands
2.79 LUA
Configure Lua Interpreter
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to configure the execution of the Lua interpreter on the receiver. Scripts that appear within the LUAFILELIST log (see page 587) can be executed by the Lua interpreter.
Message ID: 2049
Abbreviated ASCII Syntax: LUA option [LuaInterpreterArguments]
Abbreviated ASCII Example: lua start "printarguments.lua 1 2 3 4 5"
Field Field Type
1
Lua header
2
option
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
Command header. See
-
-
Messages for more
-
H
0
information.
START 1
Start the Lua interpreter in the background. The file descriptors stdout, stdin and stderr will not be accessible outside the receiver.
Start the Lua
interpreter in
Enum 4
H
interactive mode and
connect stdout, stdio
and stderr to the port
PROMPT 2
on which the command
was entered. The
INTERFACEMODE of
that port will be
changed to LUA for
both RX and TX.
OEM7 Commands and Logs Reference Manual v10
233
Chapter 2 GNSS Commands
Field Field Type
ASCII Binary Value Value
Description
3
LuaInterpreter Arguments
STRING
String containing Lua interpreter options including the name of the script file to run and arguments to pass to the script.
This string must be enclosed in quotes if it contains any spaces.
String arguments within the field must be enclosed by single quotes.
Format
Binary Bytes
Binary Offset
String [400]
Variable H+4
The format of the Lua Interpreter Arguments is as follows as adapted from the standard Lua 5.3 interpreter:
[options] [script [args]]
Available options are:
-e stat execute string 'stat'
-i
enter interactive mode after executing 'script'.
(This is added to the arguments when using the PROMPT option of the
LUA command)
-l name require library 'name'
OEM7 Commands and Logs Reference Manual v10
234
Chapter 2 GNSS Commands
2.80 MAGVAR
Sets a magnetic variation correction
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The receiver computes directions referenced to True North (also known as geodetic north). The Magnetic Variation Correction command (MAGVAR) is used to navigate in agreement with magnetic compass bearings. The correction value entered here causes the "bearing" field of the navigate log to report bearing in degrees Magnetic. The receiver computes the magnetic variation correction when using the auto option. See Figure 5: Illustration of Magnetic Variation and Correction on the next page. The receiver calculates values of magnetic variation for given values of latitude, longitude and time using the International Geomagnetic Reference Field (IGRF) 2015 spherical harmonic coefficients and IGRF time corrections to the harmonic coefficients. (IGRF-2015 is also referred to as IGRF-12.) The model is intended for use up to the year 2020, however due to accelerated drift of the earth's magnetic north pole starting in 2018, the accuracy of the model will degrade sooner than the intended date. Furthermore, the receiver will compute for years beyond 2020, but accuracy may be further reduced depending on the behavior of the magnetic pole.
Message ID: 180
Abbreviated ASCII Syntax: MAGVAR type [correction [std dev]]
Factory Default: MAGVAR correction 0 0
ASCII Example 1: MAGVAR AUTO
ASCII Example 2: MAGVAR CORRECTION 15 0
OEM7 Commands and Logs Reference Manual v10
235
Chapter 2 GNSS Commands Figure 5: Illustration of Magnetic Variation and Correction
How does GNSS determine what Magnetic North is? Do the satellites transmit a database or some kind of look up chart to determine the declination for your given latitude and longitude? How accurate is it?
Magnetic North refers to the location of the Earth's Magnetic North Pole. Its position is constantly changing in various cycles over centuries, years and days. These rates of change vary and are not well understood. However, we are able to monitor the changes.
True North refers to the earth's spin axis, that is, at 90� north latitude or the location where the lines of longitude converge. The position of the spin axis does not vary with respect to the Earth.
The locations of these two poles do not coincide. Thus, a relationship is required between these two values for users to relate GNSS bearings to their compass bearings. This value is called the magnetic variation correction or declination.
GNSS does not determine where Magnetic North is nor do the satellites provide magnetic correction or declination values. However, OEM7 receivers store this information internally in look up tables so that when you specify that you want to navigate with respect to Magnetic North, this internal information is used. These values are also available from various information sources such as the United States Geological Survey (USGS). The USGS produces maps and has software which enables the determination of these correction values. By identifying your location (latitude and longitude), you can obtain the correction value. Refer to An Introduction to GNSS available on our website.
OEM7 Commands and Logs Reference Manual v10
236
Chapter 2 GNSS Commands
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
1
MAGVAR header
-
Command header. See
-
Messages on page 25 -
for more information.
H
0
AUTO
0
Use IGRF corrections
2
type
CORRECTION 1
Use the correction supplied
Enum 4
H
3
correction � 180.0 degrees
Magnitude of correction
(Required field if type Float
4
= Correction)
H+4
4
std_dev � 180.0 degrees
Standard deviation of
correction
Float
4
(default = 0)
H+8
OEM7 Commands and Logs Reference Manual v10
237
Chapter 2 GNSS Commands
2.81 MARKCONTROL
Controls processing of mark inputs
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to control the processing of the mark inputs. Using this command, the mark inputs can be enabled or disabled, polarity can be changed and a time offset and guard against extraneous pulses can be added. The MARKPOS and MARKTIME logs have their outputs (and extrapolated time tags) pushed into the future (relative to the mark input (MKI) event) by the amount entered into the time bias field. In almost all cases, this value is set to 0, which is also the default setting (see MARKPOS, MARK2POS, MARK3POS and MARK4POS on page 593 and MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME on page 596).
Message ID: 614
Abbreviated ASCII Syntax: MARKCONTROL signal [switch [polarity [timebias [timeguard]]]]
Factory Default: MARKCONTROL MARK1 ENABLE MARKCONTROL MARK2 ENABLE
ASCII Example: MARKCONTROL MARK1 ENABLE NEGATIVE 50 100
Figure 6: TTL Pulse Polarity
OEM7 Commands and Logs Reference Manual v10
238
Chapter 2 GNSS Commands
If using an external device, such as a camera, connect the device to the receiver's I/O port. Use a cable that is compatible to both the receiver and the device. A MARKIN pulse can be a trigger from the device to the receiver. See also the MARKPOS, MARK2POS, MARK3POS and MARK4POS command on page 593 and the MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME command on page 596.
Field Field Type
ASCII Value
1
MARKCONTROL header
-
MARK1
2
signal
MARK2 MARK3
3
switch
MARK4 DISABLE ENABLE
Binary Value
Description
Format
Binary Bytes
Binary Offset
Command header.
-
See Messages on page 25 for more
-
information.
H
0
Specifies which mark
input the command
0
should be applied to.
Set to MARK1 for the
Event1 input, MARK2
for Event2, MARK3
1
for Event3 and
MARK4 for Event4. All
of the mark inputs
have 10 K pull-up
Enum 4
H
resistors to 3.3 V and
2
are leading edge
triggered
MARK3 and MARK4
are available only on
3
the OEM7600,
OEM7700 and
OEM7720
Disables or enables
0
processing of the
mark input signal for
the input specified. If DISABLE is selected,
Enum
4
H+4
the mark input signal
1
is ignored (default =
ENABLE)
OEM7 Commands and Logs Reference Manual v10
239
Chapter 2 GNSS Commands
Field Field Type
4
polarity
5
timebias
6
timeguard
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
NEGATIVE 0 POSITIVE 1
Optional field to specify the polarity of the pulse to be received on the mark input. See Figure 6: Enum 4 TTL Pulse Polarity on page 239 for more information (default= NEGATIVE)
H+8
Any valid long value
Optional value to
specify an offset, in
nanoseconds, to be applied to the time
Long
4
the mark input pulse
occurs (default =0)
H+12
default: 4 minimum: 2
Any valid Ulong value larger than the receiver's minimum raw measurement period 1
Optional field to
specify a time period,
in milliseconds,
during which
Ulong 4
subsequent pulses
after an initial pulse
are ignored
H+16
1See the Receiver Technical Specification appendices in the OEM7 Installation and Operation User Manual for the maximum raw measurement rate to determine the minimum period. If the value entered is lower than the minimum measurement period, the value is ignored and the minimum period is used.
OEM7 Commands and Logs Reference Manual v10
240
Chapter 2 GNSS Commands
2.82 MEDIAFORMAT
Format the media for PwrPak7
Platform: PwrPak7 Formats the specified media as FAT32, using PwrPak7 specific cluster size and other parameters.
Only the internal flash memory can be formatted.
Entering this command results in complete loss of all data stored on the media.
Entering this command initiates the format operation. An error is reported if formatting could not be initiated, for example due to the media being disconnected.
Formatting progress can be observed using the FILESYSTEMSTATUS log on page 475, which will report BUSY, followed by MOUNTED.
The receiver may reboot in the process.
Message ID: 2128 Abbreviated ASCII Syntax:
MEDIAFORMAT MassStorage
Example: MEDIAFORMAT INTERNAL_FLASH
Field Field Type
ASCII Value
Binary Value
Description
1
MEDIAFORMAT header
-
Command header.
-
See Messages on page 25 for more
information.
2
MassStorage
INTERNAL_ FLASH
4
Format the internal memory in the PwrPak7.
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
241
Chapter 2 GNSS Commands
2.83 MODEL
Switches to a previously authorized model
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to switch the receiver between models previously added with the AUTH command (see page 76). When the MODEL command is issued, the receiver saves the specified model as the active model. The active model is now used on every subsequent start up. The MODEL command causes an automatic reset. Use the VALIDMODELS log (see page 869) to output a list of available models on the receiver. Use the VERSION log (see page 874) to output the active model. Use the AUTHCODES log (see page 419) to output a list of the auth codes present on the receiver.
If the MODEL command is used to switch to an expired model, the receiver will reset and enter into an error state. Switch to a valid model to continue.
Message ID: 22
Abbreviated ASCII Syntax: MODEL model
Input Example: MODEL D2LR0RCCR
NovAtel uses the term models to refer to and control different levels of functionality in the receiver firmware. For example, a receiver may be purchased with an L1 only capability and be easily upgraded at a later time to a more feature intensive model, like L1/L2 dual-frequency. All that is required to upgrade is an authorization code for the higher model and the AUTH command (see page 76). Reloading the firmware or returning the receiver for service to upgrade the model is not required. Upgrades are available from NovAtel Customer Support.
Field
Field Type
ASCII Value
1
MODEL header
-
Binary Value
-
Description
Command header. See Messages on page 25 for more information.
Max 16 character null-
2
model terminated string
Model name
(including the null)
Format
Binary Bytes
Binary Offset
-
H
0
String
[max 16]
Variable
1
H
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
242
Chapter 2 GNSS Commands
2.84 MOVINGBASESTATION
Enables the use of a moving base station
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to enable or disable a receiver from transmitting corrections without a fixed position. The moving base function allows you to obtain a centimeter level xyz baseline estimate when the base station and possibly the rover are moving. It is very similar to normal RTK, with one stationary base station and a moving rover (refer to Transmitting and Receiving Corrections section of the Operation chapter in the OEM7 Installation and Operation User Manual). The BSLNXYZ log is an asynchronous `matched' log that can be logged with the onchanged trigger to provide an accurate baseline between the base and rover. Due to the latency of the reference station position messages, the following logs are not recommended to be used when in moving baseline mode: BESTXYZ, GPGST, MARKPOS, MARK2POS, MATCHEDPOS, MATCHEDEYZ, RTKPOS and RTKXYZ. The position error of these logs could exceed 100 m, depending on the latency of the reference station position message. If a rover position is required during moving basestation mode, then PSRPOS is recommended. The MOVINGBASESTATION command must be used to allow the base to transmit messages without a fixed position.
1. Use the PSRPOS position log at the rover. It provides the best accuracy and standard deviations when the MOVINGBASESTATION mode is enabled.
2. This command supports RTCM V3 operation. 3. RTCM V3 support includes GPS + GLONASS operation.
Message ID: 763
Abbreviated ASCII Syntax: MOVINGBASESTATION switch
Factory Default: MOVINGBASESTATION disable
ASCII Example: MOVINGBASESTATION ENABLE
OEM7 Commands and Logs Reference Manual v10
243
Chapter 2 GNSS Commands
Consider the case where there is a fixed base, an airplane flying with a moving base station near its front and a rover station at its tail end. Corrections can be sent between the receivers in a `daisy chain' effect, where the fixed base station sends corrections to the moving base station, which in turn can send corrections to the rover.
Figure 7: Moving Base Station `Daisy Chain' Effect
When using this method, the position type is only checked at the fixed base station. Moving base stations will continue to operate under any conditions.
This command is useful for moving base stations doing RTK positioning at sea. A rover station is used to map out local areas (for marking shipping lanes, hydrographic surveying and so on), while the base station resides on the control ship. The control ship may not move much (parked at sea), but there is a certain amount of movement due to the fact that it is floating in the ocean. By using the MOVINGBASESTATION command, the control ship is able to use RTK positioning and move to new survey sites.
Field Field Type
ASCII Binary Value Value
Description
MOVING
1
BASESTATION -
header
Command header. See
-
Messages on page 25
for more information.
2
switch
DISABLE 0 ENABLE 1
Do not transmit corrections without a fixed position
Transmit corrections without a fixed position
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
244
Chapter 2 GNSS Commands
2.85 NAVICECUTOFF
Sets elevation cut-off angle for NavIC satellites
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the elevation cut-off angle for tracked NavIC satellites. The receiver does not start automatically searching for a NavIC satellite until it rises above the cutoff angle (when satellite position is known). Tracked satellites that fall below the cut-off angle are no longer tracked unless they are manually assigned (see the ASSIGN command on page 68). In either case, satellites below the NAVICECUTOFF angle are eliminated from the internal position and clock offset solution computations. This command permits a negative cut-off angle; it could be used in these situations:
l The antenna is at a high altitude, and thus can look below the local horizon l Satellites are visible below the horizon due to atmospheric refraction
Care must be taken when using NAVICECUTOFF command because the signals from lower elevation satellites are traveling through more atmosphere and are therefore degraded. Use of satellites below 5 degrees is not recommended.
Use the ELEVATIONCUTOFF command on page 141 to set the cut-off angle for all other systems.
For dual antenna receivers, this command applies to both the primary and secondary antennas.
Message ID: 2134
Abbreviated ASCII Syntax: NAVICECUTOFF angle
Factory Default: NAVICECUTOFF 5.0
ASCII Example: NAVICECUTOFF 10.0
OEM7 Commands and Logs Reference Manual v10
245
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
NAVICECUTOFF header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
angle
�90.0 degrees
Elevation cut-off angle relative to horizon
Float
4
H
OEM7 Commands and Logs Reference Manual v10
246
Chapter 2 GNSS Commands
2.86 NMEAFORMAT
Customize NMEA output
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use the NMEAFORMAT command to customize the NMEA GPGGA and GPGGALONG output.
Modifying the NMEA output will make it not compliant with the NMEA standard.
Message ID: 1861
Abbreviated ASCII Syntax: NMEAFORMAT field format
Factory Default: NMEAFORMAT GGA_LATITUDE 9.4 NMEAFORMAT GGA_LONGITUDE 10.4 NMEAFORMAT GGA_ALTITUDE .2 NMEAFORMAT GGALONG_LATITUDE 12.7 NMEAFORMAT GGALONG_LONGITUDE 13.7 NMEAFORMAT GGALONG_ALTITUDE .3
Example: The following settings increase the precision of the GPGGA latitude and longitude fields:
NMEAFORMAT GGA_LATITUDE 11.6 NMEAFORMAT GGA_LONGITUDE 12.6 The following settings decrease the precision of the GPGGALONG latitude and longitude fields: NMEAFORMAT GGALONG_LATITUDE 11.6 NMEAFORMAT GGALONG_LONGITUDE 12.6 The following setting stops the undulation fields of the GPGGALONG log being filled, making a log like the GPGGARTK log that was in NovAtel's OEM6 firmware: NMEAFORMAT GGALONG_UNDULATION !0
Field
Field Type
ASCII Value
Binary Value
Description
NMEA
1
FORMAT -
Header
Command header. See
-
Messages on page 25 for
more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
247
Chapter 2 GNSS Commands
Field
Field Type
2
Field
ASCII Value
Binary Value
Description
GGA_ LATITUDE
0
GPGGA latitude field
GGA_ LONGITUDE
1
GPGGA longitude field
GGA_ ALTITUDE
2
GPGGA altitude (height) field
GGA_ UNDULATION
3
GPGGA undulation field
GGALONG_ LATITUDE
10
GPGGALONG latitude field
GGALONG_ LONGITUDE
11
GPGGALONG longitude field
GGALONG_ ALTITUDE
12
GPGGALONG altitude (height) field
GGALONG_ UNDULATION
13
GPGGALONG undulation field
Format
Binary Bytes
Binary Offset
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
248
Chapter 2 GNSS Commands
Field
Field Type
3
Format
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Char[8]
The Format field has a syntax similar to the printf function commonly found in programming languages. The format is:
!x.y
Where:
y is the number of digits to display after the decimal point
x sets the minimum field width including the decimal point. X is optional if ! is not used. If the value requires fewer digits than x, leading zeros are added to the out- Char[8] 8 put.
! forces the field width to x. ! is optional. If a value exceeds the permitted width, the value will be saturated. If ! is used, y must be less than x.
Examples (GGA_ LATITUDE):
.5 = 5106.98120
2.3 = 5106.981
7.1 = 05107.0
!7.2 = 5106.98
!7.3 = 999.999
H+4
OEM7 Commands and Logs Reference Manual v10
249
Chapter 2 GNSS Commands
2.87 NMEATALKER
Sets the NMEA talker ID
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to alter the behavior of the NMEA talker ID. The talker is the first 2 characters after the $ sign in the log header of the GPGLL, GPGRS, GPGSA, GPGST, GPGSV, GPRMB, GPRMC, GPVTG and GPZDA log outputs. The other NMEA logs are not affected by the NMEATALKER command.
On SPAN systems, the GPGGA position is always based on the position solution from the BESTPOS log which incorporate GNSS + INS solutions as well.
The default GPS NMEA messages (NMEATALKER GP) include specific information about only the GPS satellites that have a 'GP' talker solution, even when GLONASS satellites are present. As well, the default GPS NMEA message outputs GP as the talker ID regardless of the position type given in position logs such as BESTPOS. The NMEATALKER AUTO command changes this behavior so that the NMEA messages include all satellites in the solution and the talker ID changes according to those satellites. If NMEATALKER is set to auto and there are both GPS and GLONASS satellites in the solution, two sentences with the GN talker ID are output. The first sentence contains information about the GPS and the second sentence on the GLONASS satellites in the solution. If NMEATALKER is set to auto and there are only GLONASS satellites in the solution, the talker ID of this message is GL.
If the solution comes from SPAN, the talker ID is IN.
Message ID: 861
Abbreviated ASCII Syntax: NMEATALKER id
Factory Default: NMEATALKER gp
ASCII Example: NMEATALKER auto
OEM7 Commands and Logs Reference Manual v10
250
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
1
NMEATALKER header
-
-
Command header. See Messages on page 25 for more information.
2
ID
GP
0
AUTO 1
GPS (GP) only
GPS, Inertial (IN) and/or GLONASS
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
The NMEATALKER command only affects NMEA logs that are capable of a GPS output. For example, GLMLA is a GLONASS-only log and the output will always use the GL talker. Table 51: NMEA Talkers below shows the NMEA logs and whether they use GPS (GP), GLONASS (GL), Galileo (GA) or combined (GN) talkers with NMEATALKER AUTO.
Table 51: NMEA Talkers
Log
Talker IDs
GLMLA GL
GPALM GP
GPGGA GP
GPGLL GP or GL or GA or GN
GPGRS GP or GL or GA or GN
GPGSA GP or GL or GA or GN
GPGST GP or GL or GA or GN
GPGSV GP and GL and GA
GPRMB GP or GL or GA or GN
GPRMC GP or GL or GA or GN
GPVTG GP or GL or GA or GN
GPZDA GP
OEM7 Commands and Logs Reference Manual v10
251
Chapter 2 GNSS Commands
2.88 NMEAVERSION
Sets the NMEA Version for Output
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to set the output version of NMEA messages.
Message ID: 1574
Abbreviated ASCII Syntax: NMEAVERSION Version
Factory Defaults: NMEAVERSION V31
ASCII Example: NMEAVERSION V41
Field
Field Type
ASCII Binary Value Value
Description
1
NMEAVERSION header
-
-
Command header. See Messages on page 25 for more information.
2
Version
V31 0 V41 1
NMEA messages will be output in NMEA version 3.10 format.
NMEA messages will be output in NMEA version 4.10 format.
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
252
Chapter 2 GNSS Commands
2.89 NTRIPCONFIG
Configures NTRIP
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This command sets up and configures NTRIP communication.
Message ID: 1249
Abbreviated ASCII Syntax: NTRIPCONFIG port type [protocol [endpoint [mountpoint [username [password [bindinterface]]]]]]
Mountpoint, username and password are all set up on the caster.
Factory Default: NTRIPCONFIG ncom1 disabled NTRIPCONFIG ncom2 disabled NTRIPCONFIG ncom3 disabled NTRIPCONFIG ncomX disabled
ASCII Example: NTRIPCONFIG ncom1 client v1 :2000 calg0
ASCII example (NTRIP client): NTRIPCONFIG ncom1 client v2 192.168.1.100:2101 RTCM3 calgaryuser calgarypwd
ASCII example (NTRIP server): NTRIPCONFIG ncom1 server v1 192.168.1.100:2101 RTCM3 "" casterpwd
Field Field Type
ASCII Value
1
NTRIPCONFIG Header
-
2
port
NCOM1 NCOM2 NCOM3
Binary Value
Description
Format
Binary Bytes
Command header.
-
See Messages on page 25 for more
-
H
information.
26
Name of the port see
Table 32:
27
Communications Port Enum 4
Identifiers on
28
page 137
Binary Offset 0
H
OEM7 Commands and Logs Reference Manual v10
253
Chapter 2 GNSS Commands
Field Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
DISABLED 1
3
type
CLIENT
2
NTRIP type
Enum 4
H+4
SERVER 3
V1
4
protocol
V2
1 Protocol (default V1) Enum 4
2
H+8
5
endpoint
Max 80 character string
Endpoint to wait on or to connect to where host is a hostname or IP address and port is the TCP/UDP port number (default = 80)
String [80]
variable
1
H+12
6
mountpoint
Max 80 character string
Which mount point to String
use
[80]
variable
1
variable
7
user name
Max 30 character string
Login user name
String [30]
variable
1
variable
8
password
Max 30 character string
Password
String [30]
variable
1
variable
9
bindInterface
ALL (default)
1
Not supported. Set to
ALL for future
Enum 4
compatibility.
variable
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
254
Chapter 2 GNSS Commands
2.90 NTRIPSOURCETABLE
Set NTRIPCASTER ENDPONTS
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This command is used to set the NTRIPCASTER ENDPOINTS to be used for the SOURCETABLE log (see page 847).
Message ID: 1343
Abbreviated ASCII Syntax: NTRIPSOURCETABLE endpoint [reserved1] [reserved2]
Factory Default: NTRIPSOURCETABLE none
ASCII Example: NTRIPSOURCETABLE base.station.novatel.ca:1001 NTRIPSOURCETABLE 192.168.1.100:1001
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
NTRIP
1
SOURCETABLE -
header
Command header. See Messages on page 25 for more information.
H
0
2
Endpoint
Max 80 character string
Endpoint, in format of host:port, to connect to where the host is a hostname or IP address and port is the TCP/IP port number
String [80]
variable
1
H
3
Reserved1
Reserved
Reserved
Ulong 4
variable
4
Reserved2
Reserved
Reserved
Ulong 4
variable
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
255
Chapter 2 GNSS Commands
2.91 NVMRESTORE
Restores NVM data after an NVM failure
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to restore Non-Volatile Memory (NVM) data after a NVM Fail error. This failure is indicated by bit 15 of the receiver error word being set (see also RXSTATUS command on page 766 and RXSTATUSEVENT command on page 780). If corrupt NVM data is detected, the receiver remains in the error state and continues to flash an error code on the Status LED until the NVMRESTORE command is issued (refer to the chapter on Built-In Status Tests in the OEM7 Installation and Operation User Manual for further explanation). If you have more than one auth code and the saved model is lost, then the model may need to be entered using the MODEL command or it is automatically saved in NVM on the next start up. If the almanac was lost, a new almanac is automatically saved when the next complete almanac is received (after approximately 15 minutes of continuous tracking). If the user configuration was lost, it has to be reentered by the user. This could include communication port settings.
The factory default for the COM ports is 9600, n, 8, 1.
After entering the NVMRESTORE command and resetting the receiver, the communications link may have to be reestablished at a different baud rate from the previous connection.
Message ID: 197
Abbreviated ASCII Syntax: NVMRESTORE
The possibility of NVM failure is extremely remote, however, if it should occur it is likely that only a small part of the data is corrupt. This command is used to remove the corrupt data and restore the receiver to an operational state. The data lost could be the user configuration, almanac, model or other reserved information.
OEM7 Commands and Logs Reference Manual v10
256
Chapter 2 GNSS Commands
2.92 NVMUSERDATA
Write User Data to NVM
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command writes the data provided in the data array to NVM. This data can be retrieved by issuing the command LOG NVMUSERDATA.
The user data is maintained through power cycles and a standard FRESET command (see page 179). To clear the user data, use the FRESET USERDATA command.
The user data may be deleted if the NVMRESTORE command (see page 257) is sent. NVMRESTORE should be used with caution and is meant for use only in the event of a NVM receiver error.
Message ID: 1970 Abbreviated ASCII Syntax:
NVMUSERDATA N DATA
Field
Field Type
Binary Value
Description
Binary Binary Binary Format Bytes Offset
1
NVMUSERDATA header
-
Command header. See Messages on page 25 for more information.
-
H
0
2
N
-
Number of bytes of data to follow Ulong 4
H
3
DATA
User input data up to a maximum of 2000 bytes.
-
Data is entered in hexadecimal
Uchar 2000 H+4
values with no separators
between the values. For example,
1a2b3c4e
OEM7 Commands and Logs Reference Manual v10
257
Chapter 2 GNSS Commands
2.93 PDPFILTER
Enables, disables or resets the PDP filter
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to enable, disable or reset the Pseudorange/Delta-Phase (PDP) filter. The main advantages of the PDP implementation are:
l Smooths a jumpy position l Bridges outages in satellite coverage (the solution is degraded from normal but there is at
least a reasonable solution without gaps)
Enable the PDP filter to output the PDP solution in the BESTPOS log (see page 433), BESTVEL log (see page 449) and NMEA Standard Logs on page 624. Refer to the Operation chapter of the OEM7 Installation and Operation User Manual for information on configuring your receiver for PDP or GLIDE� operation.
2.93.1 GLIDE Position Filter
GLIDE is a mode of the PDP1 filter that optimizes the position for consistency over time rather than absolute accuracy. This is ideal in clear sky conditions where the user needs a tight, smooth and consistent output. The GLIDE filter works best with SBAS. The PDP filter is smoother than a least squares solution but is still noisy in places. The GLIDE filter produces a very smooth solution with relative rather than absolute position accuracy. There should typically be less than 1 centimeter difference in error from epoch to epoch. GLIDE also works in single point and DGPS VBS modes. See also the PDPMODE command on page 261 and the PDPPOS log on page 643, PDPVEL log on page 647 and PDPXYZ log on page 648.
Message ID: 424
Abbreviated ASCII Syntax: PDPFILTER switch
Factory Default: PDPFILTER disable
ASCII Example: PDPFILTER enable
1Refer also to our application note APN038 on Pseudorange/Delta-Phase (PDP), available on our website a www.novatel.com/support/search.
OEM7 Commands and Logs Reference Manual v10
258
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
1
PDPFILTER header
-
Command header. See
-
Messages on page 25 for
more information.
DISABLE 0
Disable the PDP filter.
ENABLE 1
Enable the PDP filter.
2
switch
RESET 2
Reset the PDP filter. A reset clears the filter memory so that the PDP filter can start over
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
259
Chapter 2 GNSS Commands
2.94 PDPMODE
Selects the PDP mode and dynamics
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to select the mode and dynamics of the PDP filter.
The PDPFILTER ENABLE command (see the PDPFILTER command on page 259) must be entered before the PDPMODE command.
It is recommended that the ionotype be left at AUTO when using either normal mode PDP or GLIDE. See also the SETIONOTYPE command on page 349.
Message ID: 970 Abbreviated ASCII Syntax:
PDPMODE mode dynamics
Factory Default: PDPMODE normal auto
ASCII Example: PDPMODE relative dynamic
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
PDPMODE header
-
Command header. See
-
Messages on page 25 for
-
more information.
H
0
In relative mode, GLIDE
NORMAL 0
performance is optimized to obtain a consistent error
in latitude and longitude
over time periods of 15
2
mode
RELATIVE 1
minutes or less, rather than to obtain the smallest
Enum
4
H
absolute position error. See
also GLIDE Position Filter
GLIDE
3
on page 259 for GLIDE mode additional
information
AUTO
0
Auto detect dynamics mode
3
dynamics STATIC 1
Static mode
Enum 4
H+4
DYNAMIC 2
Dynamic mode
OEM7 Commands and Logs Reference Manual v10
260
Chapter 2 GNSS Commands
2.95 PGNCONFIG
Configure NMEA2000 PGNs.
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to configure the PGNs of the proprietary NMEA 2000 fast-packet messages the OEM7 receivers produce. The receiver must be reset after issuing a SAVECONFIG command (see page 321) for all the configuration changes to take affect.
Message ID: 1892
Abbreviated ASCII Syntax: PGNCONFIG message_id pgn priority
Factory Default: PGNCONFIG INSPVACMP 130816 7 PGNCONFIG INSPVASDCMP 130817 7
ASCII Example: PGNCONFIG INSPVACMP 129500 3
This example sets the INSPVACMP message to PGN 129500 with priority 3.
Field Field Type
ASCII Value
Binary Value
Description
1
PGNCONFIG Header
-
Command header.
-
See Messages on page 25 for more
information.
2
INSPVACMP 1889 message_id
INSPVASDCMP 1890
NovAtel message ID
3
pgn
0 to 4294967295
PGN to use for message_id
4
priority
0-7
CAN priority to use
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4 Ulong 4 Uchar 1
H H+4 H+8
OEM7 Commands and Logs Reference Manual v10
261
Chapter 2 GNSS Commands
2.96 POSAVE
Implements base station position averaging
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command implements position averaging for base stations. Position averaging continues for a specified number of hours or until the estimated averaged position error is within specified accuracy limits. Averaging stops when the time limit or the horizontal standard deviation limit or the vertical standard deviation limit is achieved. When averaging is complete, the FIX POSITION command is automatically invoked. See the FIX command on page 166. If differential logging is initiated, then issue the POSAVE command followed by the SAVECONFIG command (see page 321). The receiver averages positions after every power on or reset. It then invokes the FIX POSITION command to enable it to send differential corrections.
Message ID: 173
Abbreviated ASCII Syntax: POSAVE state [maxtime [maxhstd [maxvstd]]]
Factory Default: POSAVE off
ASCII Example 1: POSAVE on 24 1 2
ASCII Example 2: POSAVE OFF
Field
Field Type
ASCII Binary Value Value
Description
1
POSAVE header
-
-
Command header. See Messages on page 25 for more information.
ON
1
2
state
OFF 0
Enable position averaging Disable position averaging
3
maxtime
0.01 - 100 hours
Maximum amount of time that positions are to be averaged (default=0.01)
4
maxhstd 0 - 100 m
Desired horizontal standard deviation (default = 0.0)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Float
4
H+4
Float
4
H+8
OEM7 Commands and Logs Reference Manual v10
262
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
5
maxvstd 0 - 100 m
Desired vertical standard deviation (default = 0.0)
Format
Binary Bytes
Binary Offset
Float
4
H+12
The POSAVE command can be used to establish a new base station, in any form of survey or RTK data collection, by occupying a site and averaging the position until either a certain amount of time has passed or position accuracy has reached a user specified level. User specified requirements can be based on time or horizontal or vertical quality of precision.
OEM7 Commands and Logs Reference Manual v10
263
Chapter 2 GNSS Commands
2.97 POSTIMEOUT
Sets the position time out
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This commands is used to set the time out value for the position calculation in seconds. In position logs, for example BESTPOS log (see page 433) or PSRPOS log (see page 662), when the position time out expires, the Position Type field is set to NONE. Other field values in these logs remain populated with the last available position data. Also, the position is no longer used in conjunction with the almanac to determine what satellites are visible.
Message ID: 612
Abbreviated ASCII Syntax: POSTIMEOUT sec
Factory Default: POSTIMEOUT 600
ASCII Example: POSTIMEOUT 1200
When performing data collection in a highly dynamic environment (for example, urban canyons or in high speed operations), you can use POSTIMEOUT to prevent the receiver from outputting calculated positions that are too old. Use POSTIMEOUT to force the receiver position type to NONE. This ensures that the position information being used in the BESTPOS log (see page 433) or PSRPOS log (see page 662) is based on a recent calculation. All position calculations are then recalculated using the most recent satellite information.
Field
Field Type
ASCII Binary Value Value
Description
1
POSTIMEOUT header
-
-
Command header. See Messages on page 25 for more information.
2
sec
0-86400
Time out in seconds
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
264
Chapter 2 GNSS Commands
2.98 PPPBASICCONVERGEDCRITERIA
Configures decision for PPP Basic convergence
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PPPBASICCONVERGEDCRITERIA command sets the threshold that determines if the solution has converged for lower accuracy PPP solutions. These are the PPP solutions reported with the PPP_BASIC and PPP_BASIC_CONVERGING position types.
The convergence threshold for high-accuracy PPP solutions (reported with PPP and PPP_ CONVERGING position types) is set using the PPPCONVERGEDCRITERIA command (see page 267).
Relaxing the convergence threshold shortens the time before a PPP solution is reported as converged. However, it does not alter solution behavior. During the initial PPP solution period, the positions can have decimeter error variation. Only relax the convergence threshold if the application can tolerate higher solution variability.
Message ID: 1949 Abbreviated ASCII Syntax:
PPPBASICCONVERGEDCRITERIA criteria tolerance
Factory Default: PPPBASICCONVERGEDCRITERIA horizontal_stddev 0.60
ASCII Example: PPPBASICCONVERGEDCRITERIA total_stddev 0.45
Field Field Type
ASCII Value
Binary Value
Description
PPPBASIC
1
CONVERGED CRITERIA
-
header
Command header.
-
See Messages on page 25 for more
information.
2
Criteria
TOTAL_ STDDEV
1
HORIZONTAL_ STDDEV
2
Use the total, 3D, standard deviation
Use the horizontal, 2D, standard deviation
3
Tolerance
Tolerance (m)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Float
4
H+4
OEM7 Commands and Logs Reference Manual v10
265
Chapter 2 GNSS Commands
2.99 PPPCONVERGEDCRITERIA
Configures decision for PPP convergence
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PPPCONVERGEDCRITERIA command sets the threshold that determines if the solution has converged for high-accuracy PPP solutions. These are the PPP solutions reported with the PPP and PPP_CONVERGING position types.
The convergence threshold for lower accuracy PPP solutions (reported with PPP_BASIC and PPP_BASIC_CONVERGING position types) is set using the PPPBASICCONVERGEDCRITERIA command (see page 266).
Relaxing the convergence threshold shortens the time before a PPP solution is reported as converged. However, it does not alter solution behavior. During the initial PPP solution period, the positions can have decimeter error variation. Only relax the convergence threshold if the application can tolerate higher solution variability.
Message ID: 1566 Abbreviated ASCII Syntax:
PPPCONVERGEDCRITERIA criteria tolerance
Factory Default: PPPCONVERGEDCRITERIA horizontal_stddev 0.32
ASCII Example: PPPCONVERGEDCRITERIA total_stddev 0.15
Field Field Type
ASCII Value
Binary Value
Description
PPP
1
CONVERGED CRITERIA
-
header
Command header.
-
See Messages on page 25 for more
information.
2
Criteria
TOTAL_ STDDEV
1
HORIZONTAL_ STDDEV
2
Use the total, 3D, standard deviation
Use the horizontal, 2D, standard deviation
3
Tolerance
Tolerance (m)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Float
4
H+4
OEM7 Commands and Logs Reference Manual v10
266
Chapter 2 GNSS Commands
2.100 PPPDYNAMICS
Sets the PPP dynamics mode
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command configures the dynamics assumed by the PPP filter. AUTO detects the antenna dynamics and adapts filter operation accordingly.
The automatic dynamics detection may be fooled by very slow, "creeping" motion, where the antenna consistently moves less than 2 cm/s. In such cases, the mode should explicitly be set to DYNAMIC.
Message ID: 1551 Abbreviated ASCII Syntax:
PPPDYNAMICS mode
Factory Default: PPPDYNAMICS dynamic
ASCII Example: PPPDYNAMICS auto
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
PPPDYNAMICS header
-
Command header. See
-
Messages on page 25 -
for more information.
H
0
2
Mode
Automatically
AUTO
0
determines dynamics
mode
Enum 4
H
STATIC 1
Static mode
DYNAMIC 2
Dynamic mode
OEM7 Commands and Logs Reference Manual v10
267
Chapter 2 GNSS Commands
2.101 PPPDYNAMICSEED
Seed the PPP filter in any platform motion state
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command enables seeding of the PPP engine regardless of the receiver motion state. Accurate seeds can be used to improve initial PPP convergence and re-convergence following signal outages. The seed position given by the PPPDYNAMICSEED command must be in a datum consistent with the PPP corrections that are in use. For NovAtel CORRECT with PPP, the datum is ITRF2008. The dynamic seed's time must refer to receiver time and cannot be more than 15 seconds in the past. A valid PPP solution (the PPPPOS log (see page 652) solution status is SOL_COMPUTED) must have been computed for the same epoch as the seed in order for the seed to be used. See the PPPSEED command on page 272 for stationary-only seeding and for other control over seeding.
Message ID: 2071
Abbreviated ASCII Syntax:
PPPDYNAMICSEED week seconds latitude longitude height northing_std_dev easting_std_dev height_std_dev [northing_easting_covariance] [northing_ height_covariance] [easting_height_covariance]
Example :
PPPDYNAMICSEED 1817 247603 51.2086442297 -113.9810263055 1071.859 0.02 0.02 0.04
Field
Field Type
ASCII Binary Value Value
Description
1
PPPDYNAMICSEED header
-
-
Command header. See Messages on page 25 for more information.
2
week
0-9999
GPS Week number
3
seconds
0-604800
Number of seconds into GPS week
4
latitude
�90
Latitude (degrees)
5
longitude
�180
Longitude (degrees)
6
height
> -2000.0
Ellipsoidal height (metres)
7
northing_std_dev
Northing standard deviation (metres)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Ulong 4 Double 8 Double 8 Double 8
Float
4
H H+4 H+8 H+16 H+24
H+32
OEM7 Commands and Logs Reference Manual v10
268
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
8
easting_std_dev
Easting standard deviation (metres)
Float
4
H+36
9
height_std_dev
Ellipsoidal height standard deviation (metres)
Float
4
H+40
10
northing_easting_ covariance
Covariance between
northing and easting Float
4
components (metres)
H+44
11
northing_height_ covariance
Covariance between
northing and height
Float
4
components (metres)
H+48
12
easting_height_ covariance
Covariance between
easting and height
Float
4
components (metres)
H+52
OEM7 Commands and Logs Reference Manual v10
269
Chapter 2 GNSS Commands
2.102 PPPRESET
Reset the PPP filter
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command resets the PPP filter. After a reset, the PPP filter is restored to its initial state and PPP convergence will start over.
If deletion of the NVM-saved PPP seed information is also required, then a PPPSEED CLEAR command must be applied before the PPPRESET command. See the PPPSEED command on the next page.
Message ID: 1542 Abbreviated ASCII Syntax:
PPPRESET [Option]
ASCII Example : PPPRESET
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Bytes Format Offset
1
PPPRESET header
-
-
Command header. See
Messages on page 25 for
-
more information.
H
0
2
Option
FILTER 1
Reset the PPP filter.
This is an optional parameter. 4 (default = FILTER)
Enum H
OEM7 Commands and Logs Reference Manual v10
270
Chapter 2 GNSS Commands
2.103 PPPSEED
Control the seeding of the PPP filter
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PPPSEED command controls the seeding of the PPP filter. Accurate position seeding can accelerate PPP convergence. PPPSEED SET is used to explicitly specify a seed position. The seed position must be in a datum consistent with the PPP corrections that will be used. For NovAtel CORRECT with PPP, this is ITRF2008. The PPPSEED SET command can only be used to give seed positions for stationary platforms. If the platform is moving, use the PPPDYNAMICSEED command (see page 269).
Caution must be exercised when using PPPSEED SET. While a good seed position can accelerate convergence, a bad seed position hurts performance. In some cases, a bad seed can prevent a solution from ever converging to a correct position. In other cases, a bad seed might be rejected immediately. In still other cases, the filter might operate with it for a time period only to reject it later. In this case, the filter position is partially reset, with a corresponding discontinuity in the PPP position.
PPPSEED STORE and RESTORE are intended to simplify seeding in operations where the antenna does not move between power-down and power-up. For example, in agricultural operations a tractor might be stopped in a field at the end of a day and then re-started the next day in the same position. Before the receiver is powered-down, the current PPP position could be saved to NVM using the PPPSEED STORE command, and then that position applied as a seed after power-up using PPPSEED RESTORE. PPPSEED AUTO automates the STORE and RESTORE process. When this option is used, the PPP filter automatically starts using the stopping position of the previous day. For this command to work, the PPPDYNAMICS command (see page 268) setting must be AUTO so that the receiver can determine when it is static, or the filter must explicitly be told it is static using PPPDYNAMIC STATIC. Additionally, in order for the receiver to recall the saved seed, the PPPSEED AUTO command should be saved to NVM using the SAVECONFIG command (see page 321).
Message ID: 1544
Abbreviated ASCII Syntax: PPPSEED option [latitude] [longitude] [height] [northing_std._dev.] [easting_std._dev.] [height_std._dev.]
ASCII Example: PPPSEED set 51.11635322441 -114.03819311672 1064.5458 0.05 0.05 0.05
OEM7 Commands and Logs Reference Manual v10
271
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
PPPSEED header
-
Command header. See
-
Messages on page 25 for
-
more information.
H
0
CLEAR 0
Resets the stored seed, and prevents any auto seeding from occurring.
SET
1
Immediately apply the specified co-ordinates as a seed position.
Store the current PPP
2
option
STORE
2
position in NVM for use as a Enum 4
H
future seed.
RESTORE 3
Retrieve and apply a seed position that was previously saved in NVM via the STORE or AUTO options.
AUTO
4
Automatically store and restore PPP seed positions.
3
latitude �90
Latitude (degrees)
Double 8
H+4
4
longitude �180
Longitude (degrees)
Double 8
H+12
5
height
> -2000.0
Ellipsoidal height (metres) Double 8
H+20
6
northing std. dev.
Northing standard deviation (metres)
Float
4
H+28
7
easting std. dev.
Easting standard deviation (metres)
Float
4
H+32
8
height std. dev.
Ellipsoidal height standard deviation (metres)
Float
4
H+36
9
Reserved
Float
4
H+40
OEM7 Commands and Logs Reference Manual v10
272
Chapter 2 GNSS Commands
2.104 PPPSOURCE
Specifies the PPP correction source
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command determines what corrections the PPP filter will use. When transitioning between explicitly specified sources, there can be some delay between this command being accepted and the source specified in the PPP solution changing.
The AUTO source behavior is subject to change.
Message ID: 1707 Abbreviated ASCII Syntax:
PPPSOURCE source
Factory Default: PPPSOURCE auto
ASCII Example: PPPSOURCE none
Field Field Type
ASCII Value
1
PPPSOURCE header
-
Binary Value
Description
Command header.
-
See Messages on page 25 for more
information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
273
Chapter 2 GNSS Commands
Field Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
NONE
Reject all
0
PPP corrections.
Disable the PPP filter
TERRASTAR 1
Only accept TerraStar PPP corrections
VERIPOS
2
Only accept Veripos PPP corrections
2
source
TERRASTAR_ L
8
Only accept TerraStar-L PPP corrections
Enum 4
H
TERRASTAR_ C
10
Only accept TerraStar-C PPP corrections
AUTO
Automatically select
100
and use the best
corrections
OEM7 Commands and Logs Reference Manual v10
274
Chapter 2 GNSS Commands
2.105 PPPTIMEOUT
Sets the maximum age of the PPP corrections
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command sets the maximum age of the corrections used in the PPP filter. Corrections older than the specified duration are not applied to the receiver observations and uncorrected observations are not used in the filter.
Message ID: 1560
Abbreviated ASCII Syntax: PPPTIMEOUT delay
Factory Default: PPPTIMEOUT 360
ASCII Example: PPPTIMEOUT 120
Field
Field Type
ASCII Binary Value Value
Description
1
PPPTIMEOUT header
-
-
Command header. See Messages on page 25 for more information.
2
delay
5 to 900 s
Maximum corrections age
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
275
Chapter 2 GNSS Commands
2.106 PPSCONTROL
Controls the PPS output
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command provides a method for controlling the polarity, period and pulse width of the PPS output on the OEM7. The PPS output can also be disabled using this command.
This command is used to setup the PPS signal coming from the receiver. For example, to take measurements such as temperature or pressure, in synch with your GNSS data, the PPS signal can be used to trigger measurements in other devices.
The leading edge of the 1 PPS pulse is always the trigger/reference. For example: PPSCONTROL ENABLE NEGATIVE
generates a normally high, active low pulse with the falling edge as the reference, while: PPSCONTROL ENABLE POSITIVE
generates a normally low, active high pulse with the rising edge as the reference. The pulse width is user-adjustable. The adjustable pulse width feature supports triggers/systems that need longer, or shorter, pulse widths than the default to register the pulse enabling a type of GPIO line for manipulation of external hardware control lines. The switch states allow more control over disabling/enabling the PPS. The ENABLE_FINETIME switch prevents the PPS from being enabled until FINE or FINESTEERING time status has been reached. The ENABLE_FINETIME_MINUTEALIGN switch is similar to ENABLE_FINETIME with caveat that the PPS will still not be enabled until the start of the next 60 seconds (a 1 minute modulus) after FINE or FINESTEERING time status has been reached.
If the value of a field shared with PPSCONTROL2 is changed in PPSCONTROL, the value of that field is also changed in PPSCONTROL2. For example, if the polarity is changed using the PPSCONTROL command, the polarity is also changed in PPSCONTROL2 command.
Message ID: 613
Abbreviated ASCII Syntax: PPSCONTROL [switch [polarity [period [pulsewidth]]]]
Factory Default: PPSCONTROL enable negative 1.0 1000
ASCII Example: PPSCONTROL enable positive 0.5 2000
OEM7 Commands and Logs Reference Manual v10
276
Chapter 2 GNSS Commands
Field Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
1
PPSCONTROL header
-
Command header.
-
See Messages on page 25 for more
-
information.
H
0
DISABLE
0
Disable the PPS
ENABLE
1
Enable the PPS (default)
2
switch
Enable the PPS only
ENABLE_ FINETIME
2
when FINE or FINESTEERING time status has
been reached
Enum 4
H
Enable the PPS only
when FINE or
FINESTEERING
ENABLE_
time status has
FINETIME_
3
been reached AND
MINUTEALIGN
the start of the
next 60 seconds (1
minute modulus)
has occurred
3
polarity
NEGATIVE
0
POSITIVE
1
Optional field to specify the polarity of the pulse to be generated on the PPS output. See Figure 6: TTL Pulse Enum 4 Polarity on page 239 for more information (default= NEGATIVE)
H+4
4
period
0.05, 0.1, 0.2, 0.25, 0.5, 1.0, 2.0, 3.0,...20.0
Optional field to specify the period of the pulse, in seconds (default=1.0)
Double 8
H+8
OEM7 Commands and Logs Reference Manual v10
277
Chapter 2 GNSS Commands
Field Field Type
5
pulsewidth
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Optional field to
specify the pulse
width of the PPS
Any positive value less than or equal to half the period
signal in microseconds. This value should always be less than
Ulong
4
or equal to half the
period
(default=1000)
H+16
OEM7 Commands and Logs Reference Manual v10
278
Chapter 2 GNSS Commands
2.107 PPSCONTROL2
Controls polarity, period, pulse width and estimated error limit of the PPS output
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
The PPSCONTROL2 command provides a method for controlling the polarity, period, pulse width, and estimated error limit of the PPS output on the OEM7. The PPS output can also be disabled using this command.
This command is identical to the PPSCONTROL command (see page 277) with the addition of a new parameter that represents the Estimated Error Limit.
If the value of a field shared with PPSCONTROL is changed in PPSCONTROL2, the value of that field is also changed in PPSCONTROL. For example, if the polarity is changed using the PPSCONTROL2 command, the polarity is also changed in PPSCONTROL command.
The estimated error limit sets an allowable � range for the clock offset. The PPS output is only enabled when the clock offset is within this range.
Message ID: 1740
Abbreviated ASCII Syntax: PPSCONTROL2 [switch [polarity [period [pulsewidth [estimatederrorlimit]]]]]
Factory default: PPSCONTROL2 enable negative 1.0 1000 0
ASCII Example: PPSCONTROL2 enable_finetime positive 0.5 2000 10
Field Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
1
PPSCONTROL2 header
-
Command header.
-
See Messages on page 25 for more
-
information.
H
0
OEM7 Commands and Logs Reference Manual v10
279
Chapter 2 GNSS Commands
Field Field Type
2
switch
3
polarity
4
period
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
DISABLE
0
Disable the PPS
ENABLE
1
Enable the PPS (default)
ENABLE_ FINETIME
2
Enable the PPS only when FINE or FINESTEERING time status has been reached
Enable the PPS
Enum 4
H
only when FINE or
FINESTEERING
ENABLE_
FINETIME_
3
MINUTEALIGN
time status has been reached AND the start of the next 60 seconds
(1 minute
modulus) has
occurred
NEGATIVE
0
POSITIVE
1
Optional field to
specify the
polarity of the
pulse to be
generated on the
PPS output. See Figure 6: TTL
Enum
4
Pulse Polarity on
page 239 for more
information
(default =
NEGATIVE).
H+4
0.05, 0.1, 0.2, 0.25, 0.5, 1.0, 2.0, 3.0,...20.0
Optional field to
specify the period
of the pulse in
Double 8
seconds (default
= 1.0).
H+8
OEM7 Commands and Logs Reference Manual v10
280
Chapter 2 GNSS Commands
Field Field Type
5
pulse width
6
estimated error limit
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Optional field to
specify the pulse
width of the PPS
Any value less than or signal in
equal to half the pulse microseconds.
Ulong 4
period in microseconds. This value should
always be equal
to half the period
(default = 1000).
H+16
0 to 2147483647 in nanoseconds
Optional field to
specify the �
estimated error
limit (in
nanoseconds) for
the clock offset
(default = 0). The
PPS output is only
enabled when the Long
4
clock offset is
within this limit.
An estimated error limit of 0 removes the estimated error limit restraint on the PPS.
H+20
OEM7 Commands and Logs Reference Manual v10
281
Chapter 2 GNSS Commands
2.108 PROFILE
Profile in Non-Volatile Memory (NVM)
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to configure multiple profiles in the NVM at receiver startup. The output is in the PROFILEINFO log (see page 656).
Message ID: 1411
Abbreviated ASCII Syntax: PROFILE Option Name [command]
ASCII Examples: PROFILE create Base PROFILE createelement Base "log com1 versiona" PROFILE createelement Base "serialconfig com2 115200" PROFILE createelement Base "log com2 rtcm1004 ontime 1" PROFILE activate Base
Field
Field Type
1
PROFILE header
2
Option
ASCII Binary Value Value
-
-
Refer to Table 52: Profile Option on the next page
Description
Command header. See Messages on page 25 for more information.
Profile options
3
Name
Profile name
4
Command
Profile command
Format
Binary Bytes
Binary Offset
-
H
0
Enum
4
H
String [Max 20]
variable
1
H+4
String [Max 200]
variable
1
variable
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
282
Chapter 2 GNSS Commands
Restrictions: 1. Only supports up to a maximum of 9 profiles. 2. Only supports up to a maximum of 20 commands per profile. 3. Only supports up to a maximum of 200 characters long for each command. 4. Only supports up to a maximum of 1500 characters for all commands in one profile. 5. If one of the profiles is activated, the SAVECONFIG functionality is disabled. 6. All profiles are deleted by a FRESET PROFILEINFO command (see the FRESET com-
mand on page 179). 7. The receiver resets after a profile is activated. 8. Some commands optionally accept a port parameter and will default to THISPORT if no
port is provided (e.g.LOG command). Since the commands in a profile are not sent from a port THISPORT is undefined in this case. When adding such commands to a profile, be sure to specify the port for the command rather than letting the command use the default, which may result in incorrect behavior. 9. Commands that lead to a reset of the receiver are rejected by the PROFILE command (see page 283).
Table 52: Profile Option
Binary
ASCII
Description
0
Reserved
1
CREATE
Create a profile
2
DELETE
Delete an existing profile
3
CREATEELEMENT Create an element in an existing profile
4
DELETEELEMENT Delete an existing element in an existing profile
5
ACTIVATE
Activate an existing profile
6
DEACTIVATE
Deactivate a running profile
OEM7 Commands and Logs Reference Manual v10
283
Chapter 2 GNSS Commands
2.109 PSRDIFFSOURCE
Sets the pseudorange differential correction source
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to identify which base station to accept differential corrections from. This is useful when the receiver is receiving corrections from multiple base stations. See also the RTKSOURCE command on page 316.
1. When a valid PSRDIFFSOURCE command is received, the current correction is removed immediately rather than in the time specified in the (PSRDIFFSOURCETIMEOUT command (see page 288)).
2. To use L-Band differential corrections, an L-Band receiver and NovAtel Correct with PPP service or use of a DGPS service is required. Contact NovAtel for details.
3. For ALIGN users: the ALIGN rover will not use RTK corrections automatically to do PSRDIFF positioning, as ALIGN is commonly used with a moving base. If you have a static base and want a PSRDIFF position, at the ALIGN rover, set the PSRDIFFSOURCE to RTK.
Message ID: 493
Abbreviated ASCII Syntax: PSRDIFFSOURCE type [id]
Factory Default: PSRDIFFSOURCE auto ANY
ASCII Examples: 1. Enable only SBAS:
RTKSOURCE NONE PSRDIFFSOURCE SBAS SBASCONTROL ENABLE AUTO 2. Enable RTK and PSRDIFF from RTCM, with a fall-back to SBAS: RTKSOURCE RTCM ANY PSRDIFFSOURCE RTCM ANY SBASCONTROL ENABLE AUTO 3. Disable all corrections: RTKSOURCE NONE PSRDIFFSOURCE none
OEM7 Commands and Logs Reference Manual v10
284
Chapter 2 GNSS Commands
Since several errors affecting signal transmission are nearly the same for two receivers near each other on the ground, a base at a known location can monitor the errors and generate corrections for the rover to use. This method is called Differential GPS and is used by surveyors to obtain submetre accuracy.
Major factors degrading GPS signals, which can be removed or reduced with differential methods, are atmospheric, satellite orbit errors and satellite clock errors. Errors not removed include receiver noise and multipath.
Field
Field Type
ASCII Binary Value Value
Description
1
PSRDIFFSOURCE header
-
-
Command header. See Messages on page 25 for more information.
2
type
See Table 53: DGPS Type below
ID Type. All types (except NONE) may revert to SBAS (if enabled) or SINGLE position types. See Table 75: Position or Velocity Type on page 437 1
3
Base station ID Char [5] or ANY ID string
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Char[5] 8 2
H+4
Binary ASCII
0
RTCM
1
RTCA
2
CMR3
3
Reserved
4
Reserved
Table 53: DGPS Type Description
RTCM ID: 0 RTCM ID 1023 or ANY RTCA ID: A four character string containing only alpha (a-z) or numeric characters (0-9) or ANY CMR ID: 0 CMR ID 31 or ANY
1If ANY is chosen, the receiver ignores the ID string. Specify a Type when using base station IDs. 2In the binary log case, an additional 3 bytes of padding are added to maintain 4-byte alignment. 3This cannot be used in the PSRDIFFSOURCE command.
OEM7 Commands and Logs Reference Manual v10
285
Chapter 2 GNSS Commands
Binary ASCII
5
SBAS1
6
RTK4
10 AUTO4 11 NONE4
Description
In the PSRDIFFSOURCE command, when enabled, SBAS such as WAAS, EGNOS and MSAS, forces the use of SBAS as the pseudorange differential source. SBAS is able to simultaneously track two SBAS satellites and incorporate the SBAS corrections into the position to generate differential quality position solutions. An SBAS-capable receiver permits anyone within the area of coverage to take advantage of its benefits.
If SBAS is set in the RTKSOURCE command (see page 316), it can not provide carrier phase positioning and returns an error
In the PSRDIFFSOURCE command, RTK enables using RTK correction types for PSRDIFF positioning. The correction type used is determined by the setting of the RTKSOURCE command (see page 316)
In the PSRDIFFSOURCE command, AUTO means that if any correction format is received then it will be used. If multiple correction formats are available, then RTCMV3 and RTK will be preferred over SBAS messages. If RTCMV3 and RTK are all available then the type of the first received message will be used.
In the RTKSOURCE command (see page 316), AUTO means that both the NovAtel RTK filter is enabled. The NovAtel RTK filter selects the first received RTCMV3 message.
Disables all differential correction types
12 Reserved
13
RTCMV3 3,
2
RTCM Version 3.0 ID: 0 RTCMV3 ID 4095 or ANY
14
NOVATELX
NovAtel proprietary message format ID: A four character string containing alpha (a-z) or numeric characters (0-9) or ANY
All PSRDIFFSOURCE entries fall back to SBAS (except NONE).
1Available only with the PSRDIFFSOURCE command. 2Base station ID parameter is ignored.
OEM7 Commands and Logs Reference Manual v10
286
Chapter 2 GNSS Commands
2.110 PSRDIFFSOURCETIMEOUT
Sets pseudorange differential correction source timeout
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
When multiple differential correction sources are available, this command allows the user to set a time in seconds, that the receiver will wait before switching to another differential source, if corrections from the original source are lost.
Message ID: 1449
Abbreviated ASCII Syntax: PSRDIFFSOURCETIMEOUT option [timeout]
Factory Default: PSRDIFFSOURCETIMEOUT AUTO
ASCII Example: PSRDIFFSOURCETIMEOUT auto PSRDIFFSOURCETIMEOUT set 180
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
PSRDIFFSOURCE TIMEOUT header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
option
AUTO 1 SET 2
Use AUTO or SET to set the time
Enum
4
H
3
timeout
0 to 3600 sec
Specify the timeout (default=0)
Ulong 4
H+4
OEM7 Commands and Logs Reference Manual v10
287
Chapter 2 GNSS Commands
2.111 PSRDIFFTIMEOUT
Sets maximum age of pseudorange differential data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the maximum age of pseudorange differential correction data to use when operating as a rover station. Received pseudorange differential correction data, older than the specified time, is ignored. This time out period also applies to differential corrections generated from RTK corrections.
The RTCA Standard for scat-i stipulates that the maximum age of differential correction messages cannot be greater than 22 seconds. Therefore, for RTCA rover users, the recommended PSRDIFF delay setting is 22.
Message ID: 1450 Abbreviated ASCII Syntax:
PSRDIFFTIMEOUT delay
Factory Default: PSRDIFFTIMEOUT 300
ASCII Example: PSRDIFFTIMEOUT 60
Field
Field Type
ASCII Binary Value Value
Description
PRSDIFF
1
TIMEOUT -
-
header
Command header. See Messages on page 25 for more information.
2
delay
2 to 1000 s
Maximum pseudorange differential age
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
288
Chapter 2 GNSS Commands
2.112 QZSSECUTOFF
Sets QZSS satellite elevation cutoff
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the elevation cut-off angle for tracked QZSS satellites. The receiver does not start automatically searching for a QZSS satellite until it rises above the cut-off angle (when satellite position is known). Tracked satellites that fall below the cut-off angle are no longer tracked unless they are manually assigned (see the ASSIGN command on page 68). In either case, satellites below the QZSSECUTOFF angle are eliminated from the internal position and clock offset solution computations. This command permits a negative cut-off angle; it could be used in these situations:
l The antenna is at a high altitude, and thus can look below the local horizon l Satellites are visible below the horizon due to atmospheric refraction
Care must be taken when using QZSSECUTOFF command because the signals from lower elevation satellites are traveling through more atmosphere and are therefore degraded. Use of satellites below 5 degrees is not recommended.
Use the ELEVATIONCUTOFF command (see page 141) to set the cut-off angle for any system.
For dual antenna receivers, this command applies to both the primary and secondary antennas.
Message ID: 1350 Abbreviated ASCII Syntax:
QZSSECUTOFF angle
Factory Default: QZSSECUTOFF 5.0
ASCII Example QZSSECUTOFF 10.0
OEM7 Commands and Logs Reference Manual v10
289
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
1
QZSSECUTOFF header
-
-
Command header. See Messages on page 25 for more information.
2
angle
�90 degrees
Elevation cutoff angle relative to the horizon
Format
Binary Bytes
Binary Offset
-
H
0
Float
4
H
OEM7 Commands and Logs Reference Manual v10
290
Chapter 2 GNSS Commands
2.113 RADARCONFIG
Configure the Emulated Radar Output
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to configure the Emulated Radar (ER) output.
The ER signal is output on the VARF or EVENT_OUT1 pin of the receiver.
Message ID: 1878
Abbreviated ASCII Syntax: RADARCONFIG switch [frequency_step [update_rate [response_mode [threshold]]]]
Factory Default: radarconfig disable
ASCII Example: radarconfig enable 26.11 5hz 2 3.5
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
RADARCONFIG header
-
Command header. See
-
Messages on page 25 -
for more information.
H
0
2
switch
DISABLE 0 ENABLE 1
Disables radar emulation
Enables radar emulation
Enum 4
H
3
freq_step
10.06 16.32 26.11 28.12 34.80 36.11
Frequency step per kilometer per hour.
(default = 36.11 Hz/kph)
Double 8
H+4
OEM7 Commands and Logs Reference Manual v10
291
Chapter 2 GNSS Commands
Field Field Type
4
update_rate
5
resp_mode
6
threshold
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1HZ
1
2HZ
2
5HZ
5
10HZ
10
Rate at which the output frequency is adjusted
(default = 10HZ)1
Enum 4
H+12
20HZ
20
See Table 54: Response Modes below
Specify how responsive
radar emulation is to changes in velocity
Integer 4
(Default = 500)1
H+16
2 to 50 kph
The speed threshold at
which to switch
between response
mode 1000 and
response mode 500.
The threshold is only
Double 8
applicable when the
response mode is set
to 2.
(default = 5 kph)
H+20
Table 54: Response Modes
Mode
Description
1
Immediate. This results in the lowest latency at the cost of higher noise
2
Automatically switch between 1000 and 500 depending on speed. When speed is below the Threshold parameter, use Response Mode 500. Otherwise, use Response Mode 1000.
500 Signal is minimally smoothed resulting in low latency but increased noise.
1000
Output signal is smoothed over a smaller window resulting in less latency than 2000 and less noise than 500.
2000 Output signal is smoothed to reduce noise at the cost of higher latency
1The number of samples used for smoothing depends on both the update_rate and resp_mode parameters. For instance, if the update_rate is 5 Hz and the resp_mode is 2000 ms, the number of samples used will be 10.
OEM7 Commands and Logs Reference Manual v10
292
Chapter 2 GNSS Commands
2.114 RAIMMODE
Configures RAIM mode
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to configure Receiver Autonomous Integrity Monitoring (RAIM) operation. This command uses RTCA MOPS characteristics which defines the positioning accuracy requirements for airborne lateral navigation (LNAV) and vertical navigation (VNAV) at 3 stages of flight:
1. En route travel
2. Terminal (within range of air terminal)
3. Non-precision approach
In order to ensure that the required level of accuracy is available in these phases of flight, MOPS requires the computation of protection levels (HPL and VPL). MOPS has the following definitions that apply to NovAtel's RAIM feature:
Horizontal Protection Level (HPL) is a radius of the circle in the horizontal plane. Its center is at the true position, that describes the region, assured to contain the indicated horizontal position. It is the horizontal region where the missed alert and false alert requirements are met using autonomous fault detection.
Vertical Protection Level (VPL) is half the length of the segment on the vertical axis. Its center is at the true position, that describes the region, assured to contain the indicated vertical position when autonomous fault detection is used.
Horizontal Alert Limit (HAL) is a radius of the circle in the horizontal plane. Its center is at the true position, that describes the region, required to contain the indicated horizontal position with the required probability.
Vertical Alert Limit (VAL) is half the length of the segment on the vertical axis. Its center is at the true position, that describes the region, required to contain the indicated vertical position with certain probability.
Probability of False Alert (Pfa) is a false alert defined as the indication of a positioning failure, when a positioning failure has not occurred (as a result of false detection). A false alert would cause a navigation alert.
2.114.1 Detection strategy
NovAtel's RAIM detection strategy uses the weighted Least-Squares Detection (LSA) method. This method computes a solution using a LSA and is based on the sum of squares of weighted residuals. It is a comparison between a root sum of squares of residuals and a decision threshold to determine a pass/fail decision.
2.114.2 Isolation strategy
NovAtel RAIM uses the maximum residual method. Logically it is implemented as a second part of Fault Detection and Exclusion (FDE) algorithm for LSA detection method. Weighted LSA residuals are standardized individually and the largest residual is compared to a decision threshold. If it is more than the threshold, the observation corresponding to this residual is declared faulty.
Message ID: 1285
OEM7 Commands and Logs Reference Manual v10
293
Chapter 2 GNSS Commands
Abbreviated ASCII Syntax: RAIMMODE mode [hal [val [pfa]]]
Factory Default: RAIMMODE default
Input Example: RAIMMODE user 100 100 0.01 RAIMMODE terminal
Field
Field Type
ASCII Binary Value Value
Description
1
RAIMMODE Header
-
-
Command header. See Messages on page 25 for more information.
2
MODE
See Table 55: RAIM Mode Types below
3
HAL
5 HAL 9999.99
Horizontal alert limit (m) (Default = 0.0)
4
VAL
5 VAL 9999.99
Vertical alert limit (m) (Default = 0.0)
5
PFA
(Pfa) = 1e-7 Pfa 0.25
Probability of false alert (Default = 0.0)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4 Double 8
H H+4
Double 8
H+12
Double 8
H+20
Table 55: RAIM Mode Types
Binary ASCII
Description
0
DISABLE Do not do integrity monitoring of least squares solution
1
USER
User will specify alert limits and probability of false alert
2
DEFAULT Use NovAtel RAIM (default)
3
APPROACH
Default numbers for non-precision approach navigation modes are used HAL = 556 m (0.3 nm), VAL = 50 m for LNAV/VNAV
4
TERMINAL
Default numbers for terminal navigation mode are used - HAL = 1855 m (1 nm), no VAL requirement
5
ENROUTE
Default numbers for enroute navigation mode are used - HAL = 3710 m (2 nm), no VAL requirement
OEM7 Commands and Logs Reference Manual v10
294
Chapter 2 GNSS Commands
2.115 REFERENCESTATIONTIMEOUT
Sets timeout for removing previously stored base stations
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command sets how long the receiver will retain RTK base station co-ordinates. Shorter durations might be required if the receiver is operating in a VRS RTK network that recycles base station IDs quickly.
Message ID: 2033
Abbreviated ASCII Syntax: REFERENCESTATIONTIMEOUT option [timeout]
Factory Default: REFERENCESTATIONTIMEOUT AUTO
ASCII Example: REFERENCESTATIONTIMEOUT SET 90
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
REFERENCESTATION TIMEOUT header
-
-
Command header.
See Messages on page 25 for more
-
information.
H
0
2
option
Sets the Timeout to 90 seconds1
AUTO 1
The Timeout field is optional for AUTO and has no effect
Must set the
Enum 4
H
timeout value using
SET 2
the Timeout field 0 is not accepted
when using the SET
option
3
timeout
1 to 3600 s
Specify the time
Ulong 4
H+4
1This behavior is subject to change. OEM7 Commands and Logs Reference Manual v10
295
Chapter 2 GNSS Commands
2.116 RESET
Performs a hardware reset
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command performs a hardware reset. The receiver configuration reverts either to the factory default, if no user configuration was saved or the last SAVECONFIG settings. Refer to the FRESET command on page 179 and SAVECONFIG command on page 321. The optional delay field is used to set the number of seconds the receiver is to wait before resetting.
Message ID: 18
Abbreviated ASCII Syntax: RESET [delay]
Input Example RESET 30
The RESET command can be used to erase any unsaved changes to the receiver configuration. Unlike the FRESET command on page 179, the RESET command does not erase data stored in the NVM, such as Almanac and Ephemeris data.
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
RESET header
-
-
Command header. See Messages on page 25 for more information.
-
H
0
2
delay (0-60)
Seconds to wait before resetting (default = 0)
Ulong
4
H
OEM7 Commands and Logs Reference Manual v10
296
Chapter 2 GNSS Commands
2.117 RFINPUTGAIN
Configure the Calibrated Antenna Gain (CAG)
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to select the mode (AUTO or MANUAL) of setting the CAG for the purpose of interference detection. If auto mode is used, the receiver will automatically compute the CAG at start up. In this case it is assumed that the receiver is powered up with its antenna connected and no interference is present.
If the antenna is changed, either reset the receiver or reissue this command to allow receiver to re-compute the CAG.
If manual mode is used, the CAG input by the user is used by the receiver to detect interference. The CAG is defined to be the cascaded RF gain before receiver input plus LNA noise figure (NF), counting active antenna LNA gain, in-line amplifier, RF cable or distribution loss prior to receiver input connector. A typical GNSS active antenna (of reasonable quality) has a noise figure of ~2dB (dominated by the LNA in an active antenna). RFINPUTGAIN = Cascaded Gain before receiver + LNA NF
For advanced users. If using this command in manual mode, the antenna gain must be accurately measured when the system is not experiencing any interference. If an erroneous CAG is injected, the interference detection performance can be degraded.
Message ID: 1658
Abbreviated ASCII Syntax: RFINPUTGAIN RFPath [mode] [CAG]
Factory Default: RFINPUTGAIN L1 AUTO RFINPUTGAIN L2 AUTO RFINPUTGAIN L5 AUTO
ASCII Example: RFINPUTGAIN L1 MANUAL 30 RFINPUTGAIN L2 30
OEM7 Commands and Logs Reference Manual v10
297
Chapter 2 GNSS Commands
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
RFINPUTGAIN header
-
Command header. See
-
Messages on page 25 for -
more information.
H
0
L1
2
2
RFPath
L2
3
RF path selection
Enum 4
H
L5
5
3
mode
AUTO 0 MANUAL 1
Calibrated Antenna Gain
(CAG) mode.
Enum 4
Default = MANUAL
H+4
4
CAG
0.0-100.0
Calibrated Antenna Gain value
If the mode is MANUAL, Float
4
a value for CAG must be
entered.
H+8
OEM7 Commands and Logs Reference Manual v10
298
Chapter 2 GNSS Commands
2.118 RTKANTENNA
Specifies L1 phase center (PC) or ARP and enables/disables PC modeling
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to specify whether to use L1 phase center or Antenna Reference Point (ARP) positioning. There is also an option to apply phase center variation modeling. If there are any conditions that make a selected mode impossible, the solution status in the position log will indicate an error or warning. L1 ARP offsets and L2 ARP offsets can be entered using the BASEANTENNAPCO command on page 82 and THISANTENNAPCO command on page 371. Phase center variation parameters can be entered using the BASEANTENNAPCV command on page 84 and THISANTENNAPCV command on page 372. Error states occur if either the rover does not have the necessary antenna information entered or the base is not sending sufficient information to work in the requested mode. An example of these error conditions is:
l Position reference to the ARP is requested but no rover antenna model is available
Message ID: 858
Abbreviated ASCII Syntax: RTKANTENNA posref pcv
Factory Default: RTKANTENNA unknown disable
ASCII Example: RTKANTENNA arp enable
This command is used for high precision RTK positioning allowing application of antenna offset and phase center variation parameters.
Field Field Type
ASCII Value
1
RTKANTENNA header
-
Binary Value
Description
Format
Binary Bytes
Binary Offset
Command header. See
-
Messages on page 25 -
for more information.
H
0
OEM7 Commands and Logs Reference Manual v10
299
Chapter 2 GNSS Commands
Field Field Type
2
posref
3
pcv
4
Reserved
5
Reserved
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
L1PC
0
L1 phase center position reference
ARP
1
ARP position reference Enum 4
H
UNKNOWN 2
Unknown position reference
DISABLE 0
ENABLE
1
Disable PCV modeling Enum 4
Enable PCV modeling
H+4
Bool
4
H+8
Bool
4
H+12
OEM7 Commands and Logs Reference Manual v10
300
Chapter 2 GNSS Commands
2.119 RTKASSIST
Enable or disable RTK ASSIST
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command enables or disables RTK ASSIST.
RTK ASSIST uses L-Band-delivered corrections to enable RTK operation to continue for extended durations if RTK corrections are lost. In order to use RTK ASSIST, a receiver with L-Band tracking capability and RTK ASSIST capability is needed. The duration of RTK ASSIST operation can be limited using the RTKASSISTTIMEOUT command (see page 303).
When active, RTK ASSIST is shown in the RTKPOS and BESTPOS extended solution status field (see Table 78: Extended Solution Status on page 440). The active status and further details on the RTK ASSIST status are available through the RTKASSISTSTATUS log on page 748.
For reliable RTK ASSIST performance, the RTK base station position must be within 1 metre of its true WGS84 position.
Message ID: 1985 Abbreviated ASCII Syntax:
RTKASSIST switch
Factory Default: RTKASSIST enable
ASCII Example: RTKASSIST disable
Field
Field Type
ASCII Binary Value Value
Description
1
RTKASSIST header
-
Command header. See
-
Messages on page 25 for
more information.
2
switch
DISABLE 0 ENABLE 1
Disable RTK ASSIST Enable RTK ASSIST
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
301
Chapter 2 GNSS Commands
2.120 RTKASSISTTIMEOUT
Set the maximum RTK ASSIST duration
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command sets how long the receiver will report an RTK solution when RTK is being maintained by RTK ASSIST. The maximum permitted duration of RTK ASSIST operation is determined by the subscription and receiver model. Values less than the subscription limit can be set using the RTKASSISTTIMEOUT command.
When RTK ASSIST is active, the RTKTIMEOUT command is disregarded. The maximum time that RTK will continue past an RTK corrections outage is controlled by RTKASSISTTIMEOUT.
Message ID: 2003 Abbreviated ASCII Syntax:
RTKASSISTTIMEOUT limit_type [limit_value]
Factory Default: RTKASSISTTIMEOUT SUBSCRIPTION_LIMIT
ASCII Example: RTKASSISTTIMEOUT USER_LIMIT 900
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
RTKASSIST
1
TIMEOUT -
header
Command header.
-
See Messages on page 25 for more
-
information.
H
0
SUBSCRIPTION _LIMIT
0
Use maximum permitted duration limit.
2
limit_type
The maximum RTK
ASSIST duration is Enum
4
H
USER_LIMIT
1
user set, up to the limit permitted by
the subscription and
model.
OEM7 Commands and Logs Reference Manual v10
302
Chapter 2 GNSS Commands
Field
Field Type
3
limit_value
ASCII Value
Binary Value
Description
Time out value in seconds.
Only valid for the USER_LIMIT Limit Type.
Format
Binary Bytes
Binary Offset
Ulong 4
H+4
OEM7 Commands and Logs Reference Manual v10
303
Chapter 2 GNSS Commands
2.121 RTKDYNAMICS
Sets the RTK dynamics mode
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to specify how the receiver looks at the data. There are three modes: STATIC, DYNAMIC and AUTO. The STATIC mode forces the RTK software to treat the rover station as though it were stationary. DYNAMIC mode forces the software to treat the rover as though it were in motion. If the receiver is undergoing very slow, steady motion (<2.5 cm/s for more than 5 seconds), use DYNAMIC mode (as opposed to AUTO) to prevent inaccurate results and possible resets.
For reliable performance, the antenna should not move more than 1-2 cm when in STATIC mode.
Message ID: 183
Abbreviated ASCII Syntax: RTKDYNAMICS mode
Factory Default: RTKDYNAMICS dynamic
ASCII Example: RTKDYNAMICS static
Use the STATIC option to decrease the time required to fix ambiguities and reduce the amount of noise in the position solution. If STATIC mode is used when the antenna is not static, the receiver will have erroneous solutions and unnecessary RTK resets.
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
RTKDYNAMICS header
-
Command header. See
-
Messages on page 25 -
for more information.
H
0
2
mode
Automatically
AUTO
0
determines dynamics
mode
Enum 4
H
STATIC 1
Static mode
DYNAMIC 2
Dynamic mode
OEM7 Commands and Logs Reference Manual v10
304
Chapter 2 GNSS Commands
2.122 RTKINTEGERCRITERIA
Report inaccurate fixed-integer RTK positions with float solution type
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command forces a fixed-integer RTK position to be reported as float if the estimated solution standard deviation exceeds a threshold. Normally, a fixed-integer solution is very accurate. However, in some rarely-occurring situations, even a fixed-integer solution can become inaccurate; for example, if the DOP is high due to satellites not being visible. In such cases, the accuracy of the RTK solution might be worse than what is customarily expected from a fixed-integer solution. The RTKINTEGERCRITERIA command changes the solution type of these high standard deviation integer solutions to their float equivalent. NARROW_INT, for instance, becomes NARROW_FLOAT. Depending on the GGAQUALITY command setting, this will also impact the NMEA GGA quality flag.
Message ID: 2070
Abbreviated ASCII Syntax: RTKINTEGERCRITERIA criteria threshold
Factory Default: RTKINTEGERCRITERIA TOTAL_STDDEV 1.0
ASCII Example: RTKINTEGERCRITERIA HORIZONTAL_STDDEV 0.25
Field Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
RTKINTEGER
1
CRITERIA
-
header
Command header.
-
See Messages on page 25 for more
-
information.
H
0
Test the threshold
TOTAL_ STDDEV
1
against the estimated total, 3D,
standard deviation
2
criteria
Test the threshold Enum
4
H
HORIZONTAL_ STDDEV
2
against the estimated horizontal standard
deviation
OEM7 Commands and Logs Reference Manual v10
305
Chapter 2 GNSS Commands
Field Field Type
3
threshold
ASCII Value
Binary Value
Description
0.01 m and higher
Estimated solution standard deviation (m) required for solution to be reported as integer
Format
Binary Bytes
Binary Offset
Float
4
H+4
OEM7 Commands and Logs Reference Manual v10
306
Chapter 2 GNSS Commands
2.123 RTKMATCHEDTIMEOUT
Sets RTK filter reset time after corrections are lost
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command sets the length of time the receiver continues to use the last RTK correction data once the corrections stop. Once this time is reached, the RTK filter is reset.
Message ID: 1447
Abbreviated ASCII Syntax: RTKMATCHEDTIMEOUT timeout
ASCII Example: RTKMATCHEDTIMEOUT 180
Factory Default RTKMATCHEDTIMEOUT 300
Field
Field Type
ASCII Binary Value Value
Description
RTKMATCHED
1
TIMEOUT
-
-
header
Command header. See Messages on page 25 for more information.
2
timeout
1 to 3600 s
Time out period
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
307
Chapter 2 GNSS Commands
2.124 RTKNETWORK
Specifies the RTK network mode
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Network RTK uses permanent base station installations, allowing kinematic GNSS users to achieve centimetre accuracies, without the need of setting up a GNSS base station, at a known site. This command sets the RTK network mode for a specific network. For more details on Network RTK, refer to the application note APN-041 Network RTK, available on our website a www.novatel.com/support/search.
Message ID: 951
Abbreviated ASCII Syntax: RTKNETWORK mode [network#]
Factory Default: RTKNETWORK AUTO
Input Example: RTKNETWORK imax
Field
Field Type
ASCII Binary Value Value
Description
1
RTKNETWORK header
-
-
Command header. See Messages on page 25 for more information.
2
mode
Table 56: Network RTK Mode below
RTK network mode. The factory default is auto where the receiver switches to the first available network RTK source
Specify a number for the
3
network#
0 to 4294967295
network
(default = 0)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Ulong 4
H+4
Table 56: Network RTK Mode
Binary ASCII
Description
0
DISABLE
Single reference station RTK mode. All received network RTK corrections are ignored.
1-4 Reserved
OEM7 Commands and Logs Reference Manual v10
308
Chapter 2 GNSS Commands
Binary ASCII
5
VRS
6
IMAX
7
FKP
8
MAX
Description
The Virtual Reference Station (VRS) or Virtual Base Station (VBS) idea introduced by Trimble, is that a base station is artificially created in the vicinity of a rover receiver. All baseline length dependent errors, such as abnormal troposphere variation, ionospheric disturbances and orbital errors, are reduced for this VRS. The rover receiving VRS information has a lower level of these errors than a distant base station. The VRS is calculated for a position, supplied by the rover during communication start up, with networking software. The VRS position can change if the rover is far away from the initial point. The format for sending the rover's position is standard NMEA format. Most rovers receive VRS data, for a calculated base station, within a couple of metres away.
The VRS approach requires bi-directional communication for supplying the rover's position to the networking software.
The iMAX idea, introduced by Leica Geosystems, is that networking software corrections, based on the rover's position, are calculated as with VRS. However, instead of calculating the base station observations for the provided position or another position closer to the base station, original observation information is corrected with the calculated corrections and broadcast. VRS works so that although the rover is unaware of the errors the VRS is taking care of, there still might be ionospheric remains in the base station observations. iMAX provides actual base station position information. The rover may assume the base station is at a distance and open its settings for estimation of the remaining ionospheric residuals. The iMAX method may trigger the rover to open its settings further than required, since the networking software removes at least part of the ionospheric disturbances. However, compared to VRS above, this approach is safer since it notifies the rover when there might be baseline length dependent errors in the observation information. iMAX requires bi-directional communication to the networking software for supplying the base station observation information.
The FKP method delivers the information from a base station network to the rover. No precise knowledge of the rover's position is required for providing the correct information. The corrections are deployed as gradients to be used for interpolating to the rover's actual position.
The basic principle of the master-auxiliary concept is to provide, in compact form, as much of the information from the network and the errors it is observing to the rover as possible. With more information about the state and distribution of the dispersive and non-dispersive errors across the network, the rover is able to use more intelligent algorithms in the determination of its position solution. Each supplier of reference station software will have their own proprietary algorithms for modeling or estimating these error sources. The rover system can decide to use or to neglect the network RTK information, depending on its own firmware algorithm performance.
OEM7 Commands and Logs Reference Manual v10
309
Chapter 2 GNSS Commands
Binary ASCII
Description
9
Reserved
10 AUTO
Default value, assume single base. If network RTK corrections are detected then the receiver will switch to the appropriate mode. iMAX and VRS can only be detected using RTCMV3, however, it is not possible to distinguish between iMAX or VRS. If iMAX or VRS is detected, then iMAX will be assumed.
OEM7 Commands and Logs Reference Manual v10
310
Chapter 2 GNSS Commands
2.125 RTKPORTMODE
Assigns the port for RTK and ALIGN messages
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command only applies to receivers with both RTK and ALIGN enabled.
A rover receiver with RTK and ALIGN enabled can receive RTK and ALIGN corrections at the same time. However, the two different sources (RTK and ALIGN) must be sent to different ports. Use the RTKPORTMODE command to route correction feeds to different ports. RTK and ALIGN can be routed to any user specified ports. Failing to specify the mode for the incoming source could cause unexpected behavior of RTK or ALIGN.
Ports configured using the RTKPORTMODE command must also be configured using the INTERFACEMODE command (see page 198).
Message ID: 1936 Abbreviated ASCII Syntax:
RTKPORTMODE [port] mode
Factory Default: RTKPORTMODE COM1 RTK RTKPORTMODE COM2 RTK RTKPORTMODE COM3 RTK RTKPORTMODE COM4 RTK RTKPORTMODE COM5 RTK RTKPORTMODE COM6 RTK RTKPORTMODE ICOM1 RTK RTKPORTMODE ICOM2 RTK RTKPORTMODE ICOM3 RTK RTKPORTMODE ICOM4 RTK RTKPORTMODE ICOM5 RTK RTKPORTMODE ICOM6 RTK RTKPORTMODE ICOM7 RTK RTKPORTMODE NCOM1 RTK RTKPORTMODE NCOM2 RTK RTKPORTMODE NCOM3 RTK
OEM7 Commands and Logs Reference Manual v10
311
Chapter 2 GNSS Commands
RTKPORTMODE USB1 RTK RTKPORTMODE USB2 RTK RTKPORTMODE USB3 RTK RTKPORTMODE WCOM1 RTK RTKPORTMODE BT1 RTK RTKPORTMODE AUX RTK RTKPORTMODE CCOM1 RTK RTKPORTMODE CCOM2 RTK RTKPORTMODE CCOM3 RTK RTKPORTMODE CCOM4 RTK RTKPORTMODE CCOM5 ALIGN RTKPORTMODE CCOM6 RTK
ASCII Example: RTKPORTMODE COM2 RTK RTKPORTMODE COM3 ALIGN
Field Field Type
ASCII Value
Binary Value
1
RTKPORTMODE header
-
-
2
Port
3
Mode
See Table 32: Communications Port Identifiers on page 137
RTK
0
ALIGN
1
Description
Command header. See Messages on page 25 for more information.
Port identifier (default = THISPORT)
Mode for this port
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
312
Chapter 2 GNSS Commands
2.126 RTKQUALITYLEVEL
Sets an RTK quality mode
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to select an RTK quality mode.
Message ID: 844
Abbreviated ASCII Syntax: RTKQUALITYLEVEL mode
Factory Default: RTKQUALITYLEVEL normal
ASCII Example: RTKQUALITYLEVEL extra_safe
The EXTRA_SAFE mode is needed in areas where the signal is partially blocked and the position solution in NORMAL mode shows NARROW_INT even though the real position solution is out by several metres. Using EXTRA_SAFE in these environments means the solution will be slower getting to NARROW_INT but it is less likely to be erroneous.
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
RTKQUALITYLEVEL header
-
Command header. See
-
Messages on page 25 for -
more information.
H
0
2
mode
NORMAL 1
Set the RTK quality level mode to Normal RTK
Enum 4
H
EXTRA_ SAFE
4
Set the RTK quality level mode to Extra Safe RTK
OEM7 Commands and Logs Reference Manual v10
313
Chapter 2 GNSS Commands
2.127 RTKRESET
Reset the RTK filter
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command resets the RTK filter and causes the AdVanceRTK filter to undergo a complete reset, forcing the system to restart the ambiguity resolution calculations.
Message ID: 2082
Abbreviated ASCII Syntax: RTKRESET [Switch]
Example : RTKRESET
Field
Field Type
ASCII Binary Value Value
Description
1
RTKRESET header
-
-
Command header. See Messages on page 25 for more information.
2
Switch
FILTER 1
Reset the RTK filter. This is an optional parameter
Format
Binary Byte
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
314
Chapter 2 GNSS Commands
2.128 RTKSOURCE
Sets the RTK correction source
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to identify from which base station to accept RTK (RTCMV3) differential corrections. This is useful when the receiver is receiving corrections from multiple base stations. See also the PSRDIFFSOURCE command on page 285.
Message ID: 494
Abbreviated ASCII Syntax: RTKSOURCE type [id]
Factory Default: RTKSOURCE auto ANY
ASCII Examples: 1. Specify the format before specifying the base station IDs:
RTKSOURCE RTCM3 5 RTKSOURCE RTCMV3 6 2. Select only SBAS: RTKSOURCE NONE PSRDIFFSOURCE SBAS SBASCONTROL ENABLE AUTO 3. Enable RTK and PSRDIFF from RTCM, with a fall-back to SBAS: RTKSOURCE RTCMV3 ANY PSRDIFFSOURCE RTCMV3 ANY SBASCONTROL ENABLE AUTO
Consider an agricultural example where a farmer has their own RTCM base station set up but due to either obstructions or radio problems, occasionally experiences loss of corrections. By specifying a fall back to SBAS, the farmer could set up their receiver to use transmitted RTCM corrections when available but fall back to SBAS.
Field
Field Type
ASCII Value
Binary Value
Description
1
RTKSOURCE header
-
-
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
315
Chapter 2 GNSS Commands
Field
Field Type
ASCII Value
Binary Value
Description
2
type
See Table 53: DGPS Type on page 286
ID Type 1
3
Base station ID
Char [4] or ANY
ID string
Format
Binary Bytes
Binary Offset
Enum 4
H
Char[5] 8 2
H+4
1If ANY chosen, the receiver ignores the ID string. Specify a type when using base station IDs. 2In the binary log case, an additional 3 bytes of padding are added to maintain 4-byte alignment.
OEM7 Commands and Logs Reference Manual v10
316
Chapter 2 GNSS Commands
2.129 RTKSOURCETIMEOUT
Sets RTK correction source timeout
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
When multiple RTK correction sources are available, this command allows the user to set a time, in seconds, that the receiver will wait before switching to another RTK correction source if corrections from the original source are lost.
Message ID: 1445
Abbreviated ASCII Syntax: RTKSOURCETIMEOUT option [timeout]
Factory Default: RTKSOURCETIMEOUT AUTO
ASCII Example: RTKSOURCETIMEOUT auto RTKSOURCETIMEOUT set 180
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
RTKSOURCE
1
TIMEOUT
-
-
header
Command header. See
Messages on page 25 for
-
more information.
H
0
AUTO 1
Sets the timeout according to network type or other self-detected conditions.
2
option
Timeout field is optional for
AUTO and has no effect
Enum 4
H
SET 2
Sets the timeout to the value entered in the timeout field.
Specify the time
3
timeout
1 to 3600 s (maximum)
0 is not accepted if SET is entered in the option field
Ulong 4
(default=0 for the AUTO
option)
H+4
OEM7 Commands and Logs Reference Manual v10
317
Chapter 2 GNSS Commands
2.130 RTKSVENTRIES
Sets number of satellites in corrections
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command sets the number of satellites (at the highest elevation) that are transmitted in the RTK corrections from a base station receiver. This is useful when the amount of bandwidth available for transmitting corrections is limited.
Message ID: 92
Abbreviated ASCII Syntax: RTKSVENTRIES number
Factory Default: RTKSVENTRIES 24
ASCII Example: RTKSVENTRIES 7
GPS devices have enabled many transit and fleet authorities to provide Automatic Vehicle Location (AVL). AVL systems track the position of individual vehicles and relay that data back to a remote dispatch location that can store or better utilize the information. Consider the implementation of an AVL system within a police department, to automatically log and keep track of the location of each cruiser. Typically a fleet uses a 9600 bps connection where AVL data is relayed back to headquarters. The limited bandwidth of the radio must be shared amongst the AVL and other systems in multiple cruisers. When operating with a low baud rate radio transmitter (9600 or lower), especially over a long distance, the AVL system could limit the number of satellites for which corrections are sent using the RTKSVENTRIES command.
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
RTKSVENTRIES header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
number
4-24
The number of SVs to be
transmitted in correction Ulong 4
H
messages
OEM7 Commands and Logs Reference Manual v10
318
Chapter 2 GNSS Commands
2.131 RTKTIMEOUT
Sets maximum age of RTK data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the maximum age of RTK data to use when operating as a rover station. RTK data received that is older than the specified time is ignored.
When RTK ASSIST is active, the RTKTIMEOUT command is disregarded. The maximum time that RTK will continue past an RTK corrections outage is controlled by the settings in the RTKASSISTTIMEOUT command (see page 303).
Message ID: 910 Abbreviated ASCII Syntax:
RTKTIMEOUT delay
Factory Default: RTKTIMEOUT 60
ASCII Example (rover): RTKTIMEOUT 20
Field
Field Type
ASCII Binary Value Value
Description
1
RTKTIMEOUT header
-
-
Command header. See Messages on page 25 for more information.
2
delay
5 to 60 s
Maximum RTK data age
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
319
Chapter 2 GNSS Commands
2.132 SAVECONFIG
Save current configuration in NVM
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command saves the present configuration in Non-Volatile Memory (NVM). The configuration includes the current log settings, FIX settings, port configurations and so on. The output is in the RXCONFIG log (see page 764). See also the FRESET command on page 179.
If using the SAVECONFIG command in NovAtel Connect, ensure that you have all windows other than the Console window closed. Otherwise, log requests used for the various windows are saved as well. This will result in unnecessary data being logged.
Message ID: 19 Abbreviated ASCII Syntax:
SAVECONFIG
Field
Field Type
ASCII Binary Value Value
Description
1
SAVECONFIG header
-
-
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
320
Chapter 2 GNSS Commands
2.133 SAVEETHERNETDATA
Save the configuration data associated with an Ethernet interface
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
Saving the configuration data for an Ethernet interface allows the interface to start automatically at boot time and be configured with either a static IP address or to obtain an address using DHCP. The SAVEETHERNETDATA command saves the configuration for the interface previously entered using the ETHCONFIG command (see page 144), IPCONFIG command (see page 205) and DNSCONFIG command (see page 132). The configuration data that is saved will survive a RESET command (see page 297) and FRESET command (see page 179). To clear the Ethernet interface configuration data, the FRESET ETHERNET command is used. It is not necessary to issue the SAVECONFIG command (see page 321) to save the Ethernet interface configuration data. In fact, if SAVECONFIG is used to save the ETHCONFIG, IPCONFIG and DNSCONFIG commands, the configuration saved by SAVEETHERNETDATA will take precedence over the SAVECONFIG configuration.
Message ID: 1679
Abbreviated ASCII Syntax: SAVEETHERNETDATA [Interface]
ASCII Example: ETHCONFIG ETHA AUTO AUTO AUTO AUTO
IPCONFIG ETHA STATIC 192.168.8.11 255.255.255.0 192.168.8.1
DNSCONFIG 1 192.168.4.200
SAVEETHERNETDATA ETHA
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
SAVEETHERNET DATA header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
Interface
The Ethernet interface to
ETHA 2
save the configuration data for. The default is
Enum
4
H
ETHA.
Note that the configurations set using the ICOMCONFIG command (see page 196) and NTRIPCONFIG command (see page 254) are not saved by the SAVEETHERDATA command. The following factory default ICOM configurations can be used if Ethernet access to the receiver is required immediately after the receiver is RESET or FRESET.
ICOMCONFIG ICOM1 TCP :3001 ICOMCONFIG ICOM2 TCP :3002 ICOMCONFIG ICOM3 TCP :3003 ICOMCONFIG ICOM4 TCP :3004
OEM7 Commands and Logs Reference Manual v10
321
Chapter 2 GNSS Commands
ICOMCONFIG ICOM5 TCP :3005 ICOMCONFIG ICOM6 TCP :3006 ICOMCONFIG ICOM7 TCP :3007 See also the following commands: l ETHCONFIG command on page 144 l IPCONFIG command on page 205 l DNSCONFIG command on page 132 l FRESET command on page 179
OEM7 Commands and Logs Reference Manual v10
322
Chapter 2 GNSS Commands
2.134 SBASCONTROL
Sets SBAS test mode and PRN
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to dictate how the receiver tracks and uses correction data from Satellite Based Augmentation Systems (SBAS). To enable the position solution corrections, issue the SBASCONTROL ENABLE command. The receiver does not, by default, attempt to track or use any SBAS signals satellites unless told to do so by the SBASCONTROL command. When in AUTO mode, if the receiver is outside the defined satellite system's corrections grid, it reverts to ANY mode and chooses a system based on other criteria. The "testmode" parameter in the example provides a method to use a particular satellite even if it is currently operating in test mode. The recommended setting for tracking satellites operating in test mode is ZEROTOTWO. On a simulator, you may want to leave this parameter off or specify NONE explicitly. When using the SBASCONTROL command to direct the receiver to use a specific correction type, the receiver begins to search for and track the relevant GEO PRNs for that correction type only. The receiver can be forced to track a specific PRN using the ASSIGN command (see page 68). The receiver can also be forced to use the corrections from a specific SBAS PRN using the SBASCONTROL command. Disable stops the corrections from being used.
Message ID: 652
Abbreviated ASCII Syntax: SBASCONTROL switch [system] [prn] [testmode]
Factory Default: SBASCONTROL disable
ASCII Example: SBASCONTROL enable waas
Field Field Type
ASCII Value
1
SBASCONTROL header
-
Binary Value
Description
Format
Binary Bytes
Binary Offset
Command header.
-
See Messages on page 25 for more
-
information.
H
0
OEM7 Commands and Logs Reference Manual v10
323
Chapter 2 GNSS Commands
Field Field Type
2
switch
3
system
4
prn
5
testmode
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Receiver does not
DISABLE
0
use the SBAS corrections it
receives (default) Enum
4
H
ENABLE
1
Receiver uses the SBAS corrections it receives
See Table 57: System Types below
Choose the SBAS the receiver will use
Enum
4
H+4
0
Receiver uses any PRN (default)
Receiver uses
Ulong 4
120-158 and 183-187 SBAS corrections
only from this PRN
H+8
NONE
Receiver
interprets Type 0
0
messages as they are intended (as
do not use)
(default)
ZEROTOTWO 1
Receiver
interprets Type 0 messages as Type
Enum
4
2 messages
H+12
IGNOREZERO 2
Receiver ignores the usual interpretation of Type 0 messages (as do not use) and continues
Table 57: System Types
ASCII Binary
Description
NONE
Does not use any SBAS satellites 0
(Default for SBASCONTROL DISABLE)
OEM7 Commands and Logs Reference Manual v10
324
Chapter 2 GNSS Commands
ASCII Binary
Description
AUTO
Automatically determines satellite system to use and prevents the receiver
1
from using satellites outside of the service area
(Default for SBASCONTROL ENABLE)
ANY
2
Uses any and all SBAS satellites found
WAAS
3
Uses only WAAS satellites
EGNOS
4
Uses only EGNOS satellites
MSAS
5
Uses only MSAS satellites
GAGAN
6
Uses only GAGAN satellites
QZSS
7
Uses only QZSS SAIF signals
OEM7 Commands and Logs Reference Manual v10
325
Chapter 2 GNSS Commands
2.135 SBASECUTOFF
Sets SBAS satellite elevation cut-off
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command sets the elevation cut-off angle for tracked SBAS satellites. The receiver does not start automatically searching for an SBAS satellite until it rises above the cut-off angle (when satellite position is known). Tracked SBAS satellites that fall below the cut-off angle are no longer tracked unless they are manually assigned (see the ASSIGN command on page 68).
This command permits a negative cut-off angle and can be used in the following situations:
l The antenna is at a high altitude and can look below the local horizon
l Satellites are visible below the horizon due to atmospheric refraction
Use the ELEVATIONCUTOFF command (see page 141) to set the cut-off angle for any system.
Message ID: 1000 Abbreviated ASCII Syntax:
SBASECUTOFF angle
Factory Default: SBASECUTOFF -5.0
ASCII Example: SBASECUTOFF 10.0
Field
Field Type
ASCII Binary Value Value
Description
1
SBASECUTOFF header
-
-
Command header. See Messages on page 25 for more information.
2
angle
�90.0 degrees
Elevation cut-off angle relative to horizon
Format
Binary Bytes
Binary Offset
-
H
0
Float
4
H
OEM7 Commands and Logs Reference Manual v10
326
Chapter 2 GNSS Commands
2.136 SBASTIMEOUT
Sets the SBAS position time out
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to set the amount of time the receiver remains in an SBAS position if it stops receiving SBAS corrections.
Message ID: 1001
Abbreviated ASCII Syntax: SBASTIMEOUT mode [delay]
Factory Default: SBASTIMEOUT auto
ASCII Example: SBASTIMEOUT set 100
When the time out mode is AUTO, the time out delay is 180 s.
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
SBASTIMEOUT header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
mode
See Table 58: SBAS Time Out Mode below
Time out mode
Enum 4
H
3
delay
2 to 1000 s
Maximum SBAS position age (default=180)
Double
8
H+4
4
Reserved
Double 8
H+12
Table 58: SBAS Time Out Mode
Binary ASCII
Description
0
Reserved
1
AUTO Set the default value (180 s)
2
SET
Set the delay in seconds
OEM7 Commands and Logs Reference Manual v10
327
Chapter 2 GNSS Commands
2.137 SELECTCHANCONFIG
Sets the channel configuration
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Some software models come with support for more than one channel configuration, which can be verified by logging CHANCONFIGLIST log (see page 457). The SELECTCHANCONFIG command is used to pick a different channel configuration. If a different channel configuration is selected via the SELECTCHANCONFIG command, the receiver resets and starts up with the new configuration. The Set in Use number in the CHANCONFIGLIST log (see page 457) changes as a result.
After a FRESET, the channel configuration is reset to 1.
Message ID: 1149 Abbreviated ASCII Syntax:
SELECTCHANCONFIG chanconfigsetting
Factory Default: SELECTCHANCONFIG 1
ASCII Example: SELECTCHANCONFIG 2
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Command
header. See
1
SELECTCHANCONFIG header
-
-
Messages on page 25 for
-
H
0
more
information.
1 to n
where n is the number Channel
2
chanconfigsetting
of channel
configuration Ulong 4
H
configurations in the to use
CHANCONFIGLIST
log (see page 457)
OEM7 Commands and Logs Reference Manual v10
328
Chapter 2 GNSS Commands
Below is a use case example of the SELECTCHANCONFIG command. Abbreviated ASCII commands and logs are used to better illustrate the example.
1. LOG CHANCONFIGLIST to show what the channel configuration options are and which channel configuration set is being used.
CHANCONFIGLIST COM1 0 69.5 FINESTEERING 2005 317450.284 02000000 d1c0 14860 15
7 16 GPSL1L2PL5 4 QZSSL1CAL2CL5 4 SBASL1 14 GLOL1L2 16 GALE1E5B 22 BEIDOUB1B2 3 LBAND 7 16 GPSL1L2 4 QZSSL1CAL2C 4 SBASL1 14 GLOL1L2 16 GALE1E5B 22 BEIDOUB1B2 3 LBAND 7 16 GPSL1L2PL2CL5 4 QZSSL1CAL2CL5 4 SBASL1 14 GLOL1L2PL2C 16 GALE1E5AE5BALTBOC 22 BEIDOUB1B2 3 LBAND 8 16 GPSL1L2PL2CL5 4 QZSSL1CAL2CL5 4 SBASL1L5 14 GLOL1L2PL2C 16 GALE1E5AE5BALTBOC 22 BEIDOUB1B2B3 7 NAVICL5 3 LBAND 8 16 GPSL1L2PL2CL5L1C 4 QZSSL1CAL2CL5L1CL6 4 SBASL1L5 14 GLOL1L2PL2CL3 11 GALE1E5AE5BALTBOCE6 16 BEIDOUB1B1CB2B3 7 NAVICL5 3 LBAND
OEM7 Commands and Logs Reference Manual v10
329
Chapter 2 GNSS Commands
2. There are two options given for the model and the first channel configuration set is currently being used.
3. If the user would like to use the third channel configuration set enter, SELECTCHANCONFIG 3 command.
4. The receiver receives the command and resets. At startup, the third channel configuration set is configured.
5. To verify that setting has changed, enter LOG CHANCONFIGLIST.
CHANCONFIGLIST COM1 0 69.5 FINESTEERING 2005 317450.284 02000000 d1c0 14860 15
7 16 GPSL1L2PL5 4 QZSSL1CAL2CL5 4 SBASL1 14 GLOL1L2 16 GALE1E5B 22 BEIDOUB1B2 3 LBAND 7 16 GPSL1L2 4 QZSSL1CAL2C 4 SBASL1 14 GLOL1L2 16 GALE1E5B 22 BEIDOUB1B2 3 LBAND 7 16 GPSL1L2PL2CL5 4 QZSSL1CAL2CL5 4 SBASL1 14 GLOL1L2PL2C 16 GALE1E5AE5BALTBOC 22 BEIDOUB1B2 3 LBAND 8 16 GPSL1L2PL2CL5 4 QZSSL1CAL2CL5 4 SBASL1L5 14 GLOL1L2PL2C 16 GALE1E5AE5BALTBOC 22 BEIDOUB1B2B3 7 NAVICL5 3 LBAND 8 16 GPSL1L2PL2CL5L1C 4 QZSSL1CAL2CL5L1CL6 4 SBASL1L5 14 GLOL1L2PL2CL3 11 GALE1E5AE5BALTBOCE6
OEM7 Commands and Logs Reference Manual v10
330
Chapter 2 GNSS Commands
16 BEIDOUB1B1CB2B3 7 NAVICL5 3 LBAND 6. This log shows that the third set is selected. To further verify, enter LOG TRACKSTAT to show all the configured channels.
OEM7 Commands and Logs Reference Manual v10
331
Chapter 2 GNSS Commands
2.138 SEND
Sends an ASCII message to a COM port
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to send ASCII printable data from any of the COM or USB ports to a specified communications port. This is a one time command, therefore the data message must be preceded by the SEND command and followed by <CR> each time data is sent. If the data string contains delimiters (that is, spaces, commas, tabs and so on), the entire string must be contained within double quotation marks. Carriage return and line feed characters (for example, 0x0D, 0x0A) are appended to the sent ASCII data.
Message ID: 177
Abbreviated ASCII Syntax: SEND [port] data
ASCII Example SEND com1 "log com1 rtcaobs ontime 5"
Scenario: Assume you are operating receivers as base and rover stations. It could also be assumed that the base station is unattended but operational and you wish to control it from the rover station. From the rover station, you could establish the data link and command the base station receiver to send differential corrections.
OEM7 Commands and Logs Reference Manual v10
332
Chapter 2 GNSS Commands Figure 8: Using the SEND Command
Field
Field Type
ASCII Value
Binary Value
Description
Command header.
1
SEND header
-
-
See Messages on page 25 for more
information.
2
port
See Table 4: Detailed Port Identifier on page 31
Output port (default=THISPORT)
Max 100 character string
(99 typed visible chars
3
message and a null char added by ASCII data to send
the firmware
automatically)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
String [max 100]
Variable
1
H+4
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
333
Chapter 2 GNSS Commands
2.139 SENDHEX
Send non-printable characters in hex pairs
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is like the SEND command (see page 333) except it is used to send non-printable characters expressed as hexadecimal pairs. Carriage return and line feed characters (for example, 0x0D, 0x0A) will not be appended to the sent data and so must be explicitly added to the data if needed.
Message ID: 178
Abbreviated ASCII Syntax: SENDHEX [port] length data
Input Example: SENDHEX COM1 6 143Ab5910D0A
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
1
SENDHEX header
-
-
Command header.
See Messages on page 25 for more
-
information.
H
0
2
port
See Table 4: Detailed Port Identifier on page 31
Output port (default=THISPORT)
Enum
4
H
3
length
0 - 700
Number of hex pairs Ulong 4
H+4
limited to a 700
maximum string (1400
pair hex). Even number
4
message
of ASCII characters from set of 0-9, A-F. No
Data
spaces are allowed
between pairs of
characters
String [max 700]
Variable
a
H+8
aIn the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
334
Chapter 2 GNSS Commands
2.140 SERIALCONFIG
Configures serial port settings
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to configure the receiver's asynchronous serial port communications drivers.
1. Also refer to the ECHO command on page 136. 2. The SERIALCONFIG command can be used as a log to confirm settings. 3. The entire content of the current log is sent before pausing due to the receipt of the
XOFF character.
The current SERIALCONFIG port configuration can be reset to its default state by sending it two hardware break signals of 250 milliseconds each, spaced by fifteen hundred milliseconds (1.5 seconds) with a pause of at least 250 milliseconds following the second break. This will:
l Stop the logging of data on the current port (see the UNLOGALL command on page 390) l Clear the transmit and receive buffers on the current port l Return the current port to its default settings (see Factory Defaults on page 52 for details) l Set the interface mode to NovAtel for both input and output (see the INTERFACEMODE com-
mand on page 198) This break detection can be disabled using the SERIALCONFIG command.
1. The COMCONTROL command (see page 112) may conflict with handshaking of the selected COM port. If handshaking is enabled, then unexpected results may occur.
2. Baud rates higher than 115,200 bps are not supported by standard PC hardware. Special PC hardware may be required for higher rates, including 230400 bps and 460800 bps. Avoid having COM ports of two receivers connected together using baud rates that do not match. Data transmitted through a port operating at a slower baud rate may be misinterpreted as break signals by the receiving port if it is operating at a higher baud rate because data transmitted at the lower baud rate is stretched relative to the higher baud rate. In this case, configure the receiving port to break detection disabled using the SERIALCONFIG command.
Use the SERIALCONFIG command before using the INTERFACEMODE command on each port. Turn break detection off using the SERIALCONFIG command to stop the port from resetting because it is interpreting incoming bits as a break command.
Message ID: 1246
Abbreviated ASCII Syntax: SERIALCONFIG [port] baud [parity[databits[stopbits[handshaking[break]]]]]
OEM7 Commands and Logs Reference Manual v10
335
Chapter 2 GNSS Commands
Factory Defaults: SERIALCONFIG COM1 9600 N 8 1 N ON SERIALCONFIG COM2 9600 N 8 1 N ON SERIALCONFIG COM3 9600 N 8 1 N ON SERIALCONFIG COM4 9600 N 8 1 N ON SERIALCONFIG COM5 9600 N 8 1 N ON
ASCII Example: SERIALCONFIG com1 9600 n 8 1 n off
Field Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Command header.
1
SERIALCONFIG Header
-
-
See Messages on page 25 for more
-
H
0
information.
2
port
See Table 59: COM Port to configure
Port Identifiers on
(default =
Enum 4
H
the next page
THISPORT)
3
bps/baud
2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400 and 460800
Communication baud rate (bps).
Ulong 4
H+4
4
parity
See Table 60: Parity on the next page
Parity
Enum 4
H+8
5
databits
7 or 8
Number of data bits (default = 8)
Ulong
4
H+12
6
stopbits
1 or 2
Number of stop bits (default = 1)
Ulong
4
H+16
See Table 61:
7
handshake1
Handshaking on the Handshaking
next page
Enum 4
H+20
8
break
OFF
0
ON
1
Disable break
detection Enable break
Enum 4
detection (default)
H+24
1The OEM719, SPAN CPT7 and SMART7 do not support hardware handshaking. Only transmit and receive lines exist for the OEM719, SPAN CPT7 and SMART7 ports.
OEM7 Commands and Logs Reference Manual v10
336
Chapter 2 GNSS Commands
Table 59: COM Port Identifiers
Binary ASCII
Description
Applicable Receiver
1
COM1
COM port 1
OEM719, OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7
2
COM2
COM port 2
OEM719, OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7
3
COM3
COM port 3
OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SMART7
6
THISPORT
The current COM port
OEM719, OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
19 COM4
COM port 4
OEM7700, OEM7600, OEM7720
21 IMU
IMU COM port dependent on hardware configuration
31 COM5
COM port 5
OEM7700, OEM7600, OEM7720
32 COM6
COM port 6
33 BT1
Bluetooth COM port
dependent on hardware configuration
34 COM7
COM port 7
35 COM8
COM port 8
36 COM9
COM port 9
37 COM10
COM port 10
Table 60: Parity
Binary ASCII Description
0
N No parity (default)
1
E Even parity
2
O Odd parity
Table 61: Handshaking
Binary ASCII
Description
0
N No handshaking (default)
1
XON XON/XOFF software handshaking
2
CTS CTS/RTS hardware handshaking
OEM7 Commands and Logs Reference Manual v10
337
Chapter 2 GNSS Commands
2.141 SERIALPROTOCOL
Sets the protocol to be used by a serial port
Platform: OEM729, PwrPak7 On some OEM7 receiver cards, selected ports can support either RS-232 or RS-422 signaling protocol. The default protocol is RS-232. The SERIALPROTOCOL command is used to select the protocol (RS-232 or RS-422) supported on the port.
RS-422/RS-232 selection is available only on COM1 of the OEM729 or COM1 and COM2 on the PwrPak7.
Message ID: 1444 Abbreviated ASCII Syntax:
SERIALPROTOCOL port protocol
ASCII Example: SERIALPROTOCOL COM1 RS422
Field
Field Type
ASCII Value
Binary Value
Description
SERIAL
Command header. See
1
PROTOCOL -
-
Messages on page 25 for
header
more information.
2
port
See Table 62: Ports Supporting RS-422 on the next page
Select the COM port on which the protocol is being set.
The port that can be entered depends on the hardware platform being used.
RS232 0
3
protocol
RS422 1
Set the port to use RS232 protocol
Set the port to use RS422 protocol
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
After switching a COM port from RS-232 to RS-422, send a carriage return (CR) on the newly configured port to flush the buffer prior to sending new commands on the port.
OEM7 Commands and Logs Reference Manual v10
338
Chapter 2 GNSS Commands
Table 62: Ports Supporting RS-422
OEM7 Receiver Type Allowable Ports Binary Value
OEM719
None
OEM729
COM1
1
OEM7600
None
OEM7700
None
OEM7720
None
PwrPak7
COM1
1
COM2
2
OEM7 Commands and Logs Reference Manual v10
339
Chapter 2 GNSS Commands
2.142 SETADMINPASSWORD
Sets the administration password
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This command sets the administration password used to log into various web services. l The administration password is required for Secure ICOM access.
The default admin password is the receiver`s PSN. For OEM7 enclosures, such as the PwrPak7, the default password is the enclosure PSN. The enclosure PSN is shown on the label on the bottom of the enclosure and in the ENCLOSURE line in the VERSION log (see page 874). The default password should be changed before connecting the receiver to a network.
Message ID: 1579
Abbreviated ASCII Syntax: SETADMINPASSWORD oldpassword newpassword
Input example SETADMINPASSWORD ABC123 XYZ789
Field
Field Type
ASCII Binary Value Value
Description
SETADMIN
1
PASSWORD -
-
header
Command header. See Messages on page 25 for more information.
2
OldPassword
Maximum 28 character string
Previous password.
3
NewPassword
Maximum 28 character string
New password.
Format
Binary Bytes
-
H
String [28]
String [28]
variable1 variable1
Binary Offset
0
H variable
This password can be restored to default (the receiver`s PSN) by issuing the FRESET USER_ACCOUNTS command (see FRESET on page 179).
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
340
Chapter 2 GNSS Commands
2.143 SETAPPROXPOS
Sets an approximate position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command sets an approximate latitude, longitude and height in the receiver. Estimating these parameters, when used in conjunction with an approximate time (see the SETAPPROXTIME command on the next page), can improve satellite acquisition times and Time To First Fix (TTFF). For more information about TTFF and Satellite Acquisition, refer to An Introduction to GNSS available on our website. The horizontal position entered should be within 200 km of the actual receiver position. The approximate height is not critical and can normally be entered as zero. If the receiver cannot calculate a valid position within 2.5 minutes of entering an approximate position, the approximate position is ignored. The approximate position is not visible in any position logs. It can be seen by issuing a SETAPPROXPOS log.
Message ID: 377
Abbreviated ASCII Syntax: SETAPPROXPOS lat lon height
Input Example: SETAPPROXPOS 51.116 -114.038 0
For an example on the use of this command, refer to the SETAPPROXTIME command on the next page.
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
SETAPPROXPOS header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
Lat
� 90 degrees Approximate latitude
Double 8
H
3
Lon
� 180 degrees Approximate longitude Double 8
H+8
4
Height
-1000 to +20000000 m
Approximate height
Double 8
H+16
OEM7 Commands and Logs Reference Manual v10
341
Chapter 2 GNSS Commands
2.144 SETAPPROXTIME
Sets an approximate GPS reference time
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command sets an approximate time in the receiver. The receiver uses this time as system time until a coarse time can be acquired. This can be used in conjunction with an approximate position (see the SETAPPROXPOS command on the previous page) to improve Time To First Fix (TTFF). For more information TTFF and Satellite Acquisition, refer to An Introduction to GNSS available on our website.
The time entered should be within 10 minutes of the actual GPS reference time. If the week number entered does not match the broadcast week number, the receiver resets once it is tracking.
Message ID: 102 Abbreviated ASCII Syntax:
SETAPPROXTIME week sec
Input Example: SETAPPROXTIME 1930 501232
Upon power up, the receiver does not know its position or time and therefore cannot use almanac information to aid satellite acquisition. You can set an approximate GPS reference time using the SETAPPROXPOS command (see page 342).
Approximate time and position may be used in conjunction with a current almanac to aid satellite acquisition. See the table below for a summary of the OEM7 family commands used to inject an approximated time or position into the receiver:
Approximate
Command
Time
SETAPPROXTIME
Position
SETAPPROXPOS
Base station aiding can help in these environments. A set of ephemerides can be injected into a rover station by broadcasting the RTCAEPHEM message from a base station. This is also useful in environments where there is frequent loss of lock. GPS ephemeris is three frames long within a sequence of five frames. Each frame requires 6 s of continuous lock to collect the ephemeris data. This gives a minimum of 18 s and a maximum of 36 s continuous lock time or when no recent ephemerides (new or stored) are available.
OEM7 Commands and Logs Reference Manual v10
342
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
SETAPPROXTIME header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
week
0-9999
GPS reference week number
Ulong 4
H
3
sec
0-604800
Number of seconds into GPS reference week
Double
8
H+4
OEM7 Commands and Logs Reference Manual v10
343
Chapter 2 GNSS Commands
2.145 SETBASERECEIVERTYPE
Sets base receiver type
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command allows the user to specify the base receiver type to aid GLONASS ambiguity fixing in RTK. It can be used as a substitute for RTCM1033 messages that contains the information on the base receiver type. This command should be issued to the Rover.
An incorrect base type setting can significantly impair ambiguity resolution.
Message ID: 1374 Abbreviated ASCII Syntax:
SETBASERECEIVERTYPE base_type
Factory Default: SETBASERECEIVERTYPE unknown
ASCII Example: SETBASERECEIVERTYPE novatel
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
SETBASERECEIVER TYPE header
-
Command header.
-
See Messages on page 25 for more
-
information.
H
0
unknown 0
Unknown Base
novatel 1
NovAtel Base
2
base_type
trimble 2
Trimble Base
Enum 4
H
topcon 3
Topcon Base
magellan 4
Magellan Base
leica
5
Leica Base
OEM7 Commands and Logs Reference Manual v10
344
Chapter 2 GNSS Commands
2.146 SETBESTPOSCRITERIA
Sets selection criteria for BESTPOS
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to set the criteria for the BESTPOS log (see page 433) and choose between 2D and 3D standard deviation to obtain the best position from the BESTPOS log (see page 433). It also allows you to specify the number of seconds to wait before changing the position type. This delay provides a single transition that ensures position types do not skip back and forth.
The SETBESTPOSCRITERIA command is also used as the basis for the UALCONTROL command (see page 378) standard deviations.
Message ID: 839 Abbreviated ASCII Syntax:
SETBESTPOSCRITERIA type [delay]
Factory Default: SETBESTPOSCRITERIA pos3d 0
Input Example: SETBESTPOSCRITERIA pos2d 5
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
SETBESTPOS
1
CRITERIA
-
-
header
Command header. See
Messages on page 25 for
-
more information.
H
0
2
type
See Table 63: Selection Type below
Select a 2D or 3D standard deviation type to obtain the best position from the BESTPOS log
Enum
4
H
3
delay
0 to 100 s
Set the number of seconds to wait before changing the Ulong 4 position type. Default=0
H+4
Table 63: Selection Type
ASCII Binary
Description
POS3D
0
3D standard deviation
POS2D
1
2D standard deviation
OEM7 Commands and Logs Reference Manual v10
345
Chapter 2 GNSS Commands
2.147 SETDIFFCODEBIASES
Sets satellite differential code biases
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Changing the biases may negatively affect positioning accuracy. NovAtel recommends that only advanced users modify the biases.
Use this command to set the differential code biases that correct pseudorange errors affecting the L1/L2 ionospheric corrections. Bias values are restricted to between -10 ns and +10 ns. A set of biases is included in the firmware and use of the biases is enabled by default. See also the DIFFCODEBIASCONTROL command on page 128. The receiver uses the C/A code on L1 and the P code on L2 to calculate a dual-frequency ionospheric correction. However, the GNSS clock corrections are broadcast as if the P codes on both L1 and L2 are used to calculate this correction. The biases account for the differences between the P and C/A codes on L1 and improve the estimate of the ionospheric correction. The biases are calculated by the International GNSS Service (IGS). Calculation details, analysis and results are available at http://aiuws.unibe.ch/spec/dcb.php. The most recent 30 day average bias values can be downloaded from ftp://ftp.unibe.ch/aiub/CODE/CODE_FULL.DCB.
Message ID: 687
Abbreviated ASCII Syntax: SETDIFFCODEBIASES bias_type biases
ASCII Example: <SETDIFFCODEBIASES COM1 2 91.0 UNKNOWN 0 0.470 02440020 365b 32768 < GPS_C1P1 1.302 -1.326 1.360 1.649 1.357 1.586 0.776 -0.079 -0.123 0.888 0.321 0.718 0.527 -0.720 1.193 -1.331 0.828 -1.061 -2.497 -2.106 -1.979 -2.747 -0.254 1.202 -0.716 0.077 -0.180 -1.059 1.269 -0.481 0.734 1.516 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 <SETDIFFCODEBIASES COM1 1 91.0 UNKNOWN 0 0.471 02440020 365b 32768 < GLONASS_C1P1 -0.092 0.381 0.581 1.033 0.642 -0.561 0.794 0.899 0.380 -0.832 -0.358 -0.606 -2.181 0.023 1.135 0.346 0.009 0.384 -1.394 0.224 -0.022 -0.824 0.133 -0.437 0.000 0.608 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 0.000 <SETDIFFCODEBIASES COM1 0 91.0 UNKNOWN 0 0.473 02440020 365b 32768 < GPS_C2P2 1.358 0.000 -0.381 0.000 -0.344 -0.707 0.306 -1.068 0.624 1.480 0.000 -0.401 0.000 0.000 -0.169 0.0 00 0.236 0.000 0.000 0.000 0.000 0.000 0.000 0.051 -0.711 1.082 -0.128 0.000 -0.101 -0.483 -0.630 -0.015 0.000 0.0 00 0.000 0.000 0.000 0.000 0.000 0.000
OEM7 Commands and Logs Reference Manual v10
346
Chapter 2 GNSS Commands
Field Field Type
ASCII Value
Binary Value
Description
SETDIFFCODE
1
BIASES
-
header
Command header.
-
See Messages on page 25 for more
information.
GPS_C1P1 0
2
bias_type
GPS_C2P2 1
GLONASS_ C1P1
2
Code pair to which biases refer
3
biases
-10 to +10 ns
Array of 40 biases (ns)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Float [40]
160
H+4
OEM7 Commands and Logs Reference Manual v10
347
Chapter 2 GNSS Commands
2.148 SETIONOTYPE
Enables ionospheric models
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to set which ionospheric corrections model the receiver should use. If the selected model is not available, the receiver reverts to AUTO.
L1 only models automatically use SBAS ionospheric grid corrections, if available.
Message ID: 711 Abbreviated ASCII Syntax:
SETIONOTYPE model Factory Default:
SETIONOTYPE auto ASCII Example:
SETIONOTYPE Klobuchar
An ionotype of AUTO is recommended for PDP and GLIDE.
Field
Field Type
ASCII Value
Binary Value
SETIONO-
1
TYPE
-
-
header
See Table 64:
2
model
Ionospheric Correction Models
below
Description
Command header. See Messages on page 25 for more information.
Choose an ionospheric corrections model
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Table 64: Ionospheric Correction Models
ASCII
Binary
Description
NONE
0
Don't use ionosphere modeling
KLOBUCHAR 1
Use the Klobuchar model broadcast by GPS
GRID
2
Use the SBAS grid model
L1L2
3
Use the L1/L2 model
AUTO
4
Automatically determine the ionospheric model to use
OEM7 Commands and Logs Reference Manual v10
348
Chapter 2 GNSS Commands
2.149 SETNAV
Sets start and destination waypoints
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command permits entry of one set of navigation waypoints (see Figure 9: Illustration of SETNAV Parameters below). The origin (from) and destination (to) waypoint coordinates entered are considered on the ellipsoidal surface of the current datum (default wgs84). Once SETNAV has been set, monitor the navigation calculations and progress by observing messages in the NAVIGATE log (see page 621). Track offset is the perpendicular distance from the great circle line drawn between the from latlon and to lat-lon waypoints. It establishes the desired navigation path or track, that runs parallel to the great circle line, which now becomes the offset track, and is set by entering the track offset value in metres. A negative track offset value indicates that the offset track is to the left of the great circle line track. A positive track offset value (no sign required) indicates the offset track is to the right of the great circle line track (looking from origin to destination). See Figure 9: Illustration of SETNAV Parameters below for clarification.
Message ID: 162
Abbreviated ASCII Syntax: SETNAV fromlat fromlon tolat tolon trackoffset from-point to-point
Factory Default: SETNAV 90.0 0.0 90.0 0.0 0.0 from to
ASCII Example: SETNAV 51.1516 -114.16263 51.16263 -114.1516 -125.23 FROM TO
Figure 9: Illustration of SETNAV Parameters
Consider the case of setting waypoints in a deformation survey along a dam. The surveyor enters the From and To point locations, on either side of the dam using the SETNAV command. They then use the NAVIGATE log messages to record progress and show where they are in relation to the From and To points.
OEM7 Commands and Logs Reference Manual v10
349
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
SETNAV header
-
-
Command header. See
Messages on page 25 for
-
more information.
H
0
Origin latitude in units of
degrees/decimal degrees.
2
fromlat
� 90 degrees
A negative sign for South
Double 8
H
latitude. No sign for North
latitude
Origin longitude in units of
degrees/decimal degrees.
3
fromlon
� 180 degrees A negative sign for West
Double 8
longitude. No sign for East
longitude
H+8
4
tolat
� 90 degrees
Destination latitude in units of degrees/decimal degrees
Double
8
H+16
5
tolon
� 180 degrees
Destination longitude in units of degrees/decimal degrees
Double 8
H+24
6
trackoffset � 1000 km
Waypoint great circle line offset (in metres) establishes offset track. Positive indicates right of great circle line and negative indicates left of great circle line
Double 8
H+32
7
from-point
5 characters maximum
ASCII origin station name
String [max 5]
Variable
1
H+40
8
to-point
5 characters maximum
ASCII destination station name
String [max 5]
Variable
1
Variable
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
350
Chapter 2 GNSS Commands
2.150 SETROVERID
Set ID for ALIGN rovers
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command sets the Rover ID output in the ROVERPOS log (see page 741), HEADING2 log (see page 547), ALIGNBSLNXYZ log (see page 413) and ALIGNBSLNENU log (see page 411).
The default value for the ID is set using the last six characters of the receiver PSN Number. For example, if the receiver PSN number is DAB07170027, ID is set as R027, i.e., 17 is represented as R and last three characters are filled in as is. The fourth last character is ignored.
It is not guaranteed that each receiver will have a unique auto-generated ID. Use this command to set the ID in case the auto-generated ID overlaps with other rovers. It is the user's responsibility to ensure each receiver ID is unique (if they own multiple receivers). If the ID overlaps, use this command to set the ID.
Message ID: 1135 Abbreviated ASCII Syntax:
SETROVERID rovid
Factory Default: If the receiver PSN is: DAB07170027 SETROVERID R027
Input Example SETROVERID rov1
Field
Field Type
ASCII Binary Value Value
Description
1
SETROVERID header
-
-
Command header. See Messages on page 25 for more information.
2
ID
4 Character String e.g., ROV1
ID String (maximum 4 characters plus NULL)
Format
Binary Bytes
Binary Offset
-
H
0
String [5]
51
H
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
351
Chapter 2 GNSS Commands
2.151 SETTIMEBASE
Sets primary and backup systems for time base
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command configures the primary and backup steering system(s) for timing. The primary system is the system that the receiver steers the clock to. Upon startup, the primary system must be present long enough to steer the clock to be valid once, otherwise, the backup system cannot be used. The backup system is used whenever the primary system is not present.
Message ID: 1237
Abbreviated ASCII Syntax: SETTIMEBASE primarysystem numbackups[system[timeout]]
Factory Default: For GLONASS only receiver:
SETTIMEBASE glonass 0 For GPS capable receiver:
SETTIMEBASE gps 1 auto 0 For BeiDou only receiver:
SETTIMEBASE beidou 0
Input Example: SETTIMEBASE gps 1 glonass 30
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
SETTIMEBASE header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
primarysystem
Table 65: System Used for Timing on the next page
The primary system for steering the receiver clock
Enum
4
H
OEM7 Commands and Logs Reference Manual v10
352
Chapter 2 GNSS Commands
Field Field Type
3
numbackups
4
system1
5
timeout1
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
0 or 4
The number of records to follow.
Note: When more than
one backup system is specified, the backup
Ulong 4
systems are selected
according to numeric
order.
H+4
Table 65: System Used for Timing below
The system to be used for backup
Enum
4
H+8
0 to +4294967295 (seconds)
Duration that the backup
system is used to steer the clock. 0 means
Ulong
4
ongoing
H+12
Table 65: System Used for Timing
Binary
ASCII
0
GPS
1
GLONASS
2
GALILEO
3
BEIDOU
4
NAVIC
99
AUTO2
1The system and timeout fields can repeat. 2AUTO is used only as a backup system (not available for primary system field).
OEM7 Commands and Logs Reference Manual v10
353
Chapter 2 GNSS Commands
2.152 SETTROPOMODEL
Sets Troposphere model
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command sets the troposphere model used to correct ranges used in the PSRPOS and PDPPOS solutions.
Message ID: 1434
Abbreviated ASCII Syntax: SETTROPOMODEL model
Factory Default: SETTROPOMODEL auto
Input Example: SETTROPOMODEL none
Disabling the troposphere model may negatively affect positioning accuracy. NovAtel recommends that only advanced users modify this setting.
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
SETTROPOMODEL header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
model
NONE 1
Do not apply any troposphere corrections
Enum 4
H
AUTO 2
Automatically use an appropriate model
OEM7 Commands and Logs Reference Manual v10
354
Chapter 2 GNSS Commands
2.153 SETUTCLEAPSECONDS
Sets future leap seconds
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command allows the user to force the UTC offset to be updated according to the input date. Leap seconds will occur at the end of the UTC day specified. The receiver will use the leap second set by this command until a leap second can be obtained over the air.
Message ID: 1150
Abbreviated ASCII Syntax: SETUTCLEAPSECONDS seconds [futureweeknumber [futuredaynumber [futureseconds]]]
Input Example: SETUTCLEAPSECONDS 18 1929 7 18
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
SETUTCLEAP
1
SECONDS
-
-
header
2
Seconds1
0-
Command header. See Messages on page 25 for more information.
H
0
Current UTC leap second Ulong 4
H
3
Futureweek number
0-10000
GPS Week when future leap seconds will take effect
Ulong 4
H+4
4
Futureday number
1-7
Day of the week when future leap seconds will take effect
Ulong 4
H+8
5
Futureseconds 0-
Future leap second offset
that will take effect at the
end of the
Ulong 4
futuredaynumber of the
futureweeknumber
H+12
1This value will only be applied if the UTC status in the TIME log is not Valid. OEM7 Commands and Logs Reference Manual v10
355
Chapter 2 GNSS Commands
2.154 SOFTLOADCOMMIT
Completes the SoftLoad process
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command completes the SoftLoad process by verifying the downloaded image and activating it. Refer to the OEM7 Installation and Operation User Manual for more information about the SoftLoad process. This command can only be sent to the receiver when the SOFTLOADSTATUS log (see page 844) reports READY_FOR_DATA. After issuing the SOFTLOADCOMMIT command the user must wait for the OK or ERROR command response before proceeding. This response is guaranteed to be output from the receiver within 300 seconds from the time the command was received by the receiver. If an error response is returned, consult the SOFTLOADSTATUS log on page 844 for more detail.
Message ID: 475
Abbreviated ASCII Syntax: SOFTLOADCOMMIT
Input Example: SOFTLOADCOMMIT
Field
Field Type
ASCII Binary Value Value
Description
1
SOFTLOADCOMMIT header
-
-
Command header. See Messages on page 25 for more information.
2
Reserved
-
Reserved. Set to 1 in the binary case
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
356
Chapter 2 GNSS Commands
2.155 SOFTLOADDATA
Sends firmware image data to the receiver for the SoftLoad process
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is only valid in binary mode. This command is used to upload data to the receiver for the SoftLoad process. Refer to the OEM7 Installation and Operation User Manual for more information about the SoftLoad process. After each SOFTLOADDATA command, the user must wait for the OK or ERROR command response before proceeding. This response is guaranteed to be output from the receiver within 15 seconds from the time the command was received by the receiver. If an error response is returned, consult the SOFTLOADSTATUS log on page 844 for more detail. This command can only be sent to the receiver after the SOFTLOADSREC command (see page 362) or SOFTLOADSETUP command (see page 360) have sent the content of the S0 records from the start of a firmware *.shex file. In these cases, the SOFTLOADSTATUS log (see page 844) reports READY_FOR_SETUP or READY_FOR_DATA.
Message ID: 1218
Abbreviated ASCII Syntax: Not applicable
Field
Field Type
Binary Value
Description
1
SOFTLOADDATA header
-
NovAtel binary message header
2
offset
-
Offset of the data within the downloaded image
3
data length
-
Number of bytes of data. This must match the number of bytes contained within the "data" field
4
data
-
Incoming data up to a maximum of 4096 bytes
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Ulong 4
H+4
Uchar 4096 H+8
OEM7 Commands and Logs Reference Manual v10
357
Chapter 2 GNSS Commands
2.156 SOFTLOADRESET
Initiates a new SoftLoad process
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command restarts the SoftLoad process. Refer to the OEM7 Installation and Operation User Manual for more information about the SoftLoad process. The command does not affect the flash and does not reset the receiver. The SOFTLOADRESET command can be issued at any time. If it is issued while a SoftLoad process is currently in progress then that process is terminated and a new one is started. After the SOFTLOADRESET command is processed the SOFTLOADSTATUS log will report a status of READY_FOR_SETUP. After issuing the SOFTLOADRESET command the user must wait for the OK or ERROR command response before proceeding. This response is guaranteed to be output from the receiver within 300 seconds from the time the command was received by the receiver. If an error response is returned, consult the SOFTLOADSTATUS log on page 844 for more detail.
Message ID: 476
Abbreviated ASCII Syntax: SOFTLOADRESET
Input Example: SOFTLOADRESET
Field
Field Type
ASCII Binary Value Value
Description
1
SOFTLOADRESET header
-
-
Command header. See Messages on page 25 for more information.
2
Reserved
-
-
Reserved. Set to 1 in the binary case
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
358
Chapter 2 GNSS Commands
2.157 SOFTLOADSETUP
Sends configuration information to the receiver for the SoftLoad process
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The SOFTLOADSETUP command can be used in place of the SOFTLOADSREC command when sending S0 Records. This command is meant to be used if the user requires that the entire SoftLoad process be performed in binary, but can also be used in ASCII or abbreviated ASCII. The examples below are given in abbreviated ASCII for simplicity.
Refer to the OEM7 Installation and Operation User Manual for more information about the SoftLoad process.
This command can only be sent to the receiver when the SOFTLOADSTATUS log reports READY_ FOR_SETUP.
After each SOFTLOADSETUP command, the user must wait for the OK or ERROR command response before proceeding. This response is guaranteed to be output from the receiver within 15 seconds from the time the command was received by the receiver. If an error response is returned, consult the SOFTLOADSTATUS log on page 844 for more detail.
NovAtel S0 records use the following format: S0~X~<<DATA>>, where X is the Setup Type and <<DATA>> is a NULL terminated string. To convert from S0 record to the SOFTLOADSETUP command, convert the Setup Type to the appropriate Setup type enumeration, as described in Table 66: Available Set Up Commands on the next page, and copy the <<DATA>> string in to the Setup data string.
Message ID: 1219
Abbreviated ASCII Syntax:
SOFTLOADSETUP setuptype setupdata
Input Example:
SOFTLOADSETUP datatype "APP"
Field
Field Type
ASCII Binary Value Value
Description
SOFTLOAD
1
SETUP
-
-
header
Command header. See Messages on page 25 for more information.
See Table 66:
Available Set
2
Setup type Up Commands The type of setup command
on the next
page
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
359
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
3
Setup data -
-
ASCII setup data string. See Table 66: Available Set Up Commands below for details on this data. This data can be pulled from the S0 records of the hex file being loaded onto the receiver. If the ASCII form of this command is used, this string must be enclosed in double quotes (" ")
String [512]
variable
1
H+4
Table 66: Available Set Up Commands
Binary ASCII
Description
Comma separated list of platforms supported by the data to be uploaded. This
1
Platform
corresponds to S0~P~. For example, the S-Record S0~P~OEM729,OEM7700,OEM719, translates to SOFTLOADSETUP PLATFORM
"OEM729,OEM7700,OEM719"
Version of the data to be uploaded. This corresponds to S0~V~. For example,
2
Version the S-Record S0~V~OMP070400RN0000, translates to SOFTLOADSETUP
VERSION "OMP070400RN0000"
Intended data block for the data to be uploaded. This corresponds to S0~T~.
3
Datatype For example, the S-Record S0~T~APP, translates to SOFTLOADSETUP
DATATYPE "APP"
PSN and AUTH code for the data to be uploaded. The format is:
PSN:AuthCode.Note that since there are commas within the AuthCode, double
4
Authcode quotes must surround the PSN:AuthCode string. For example:
SOFTLOADSETUP AUTHCODE "BFN10260115: T48JF2,W25DBM,JH46BJ,2WGHMJ,8JW5TW,G2SR0RCCR,101114"
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
360
Chapter 2 GNSS Commands
2.158 SOFTLOADSREC
Sends an S-Record to the receiver for the SoftLoad process
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to send S-Records to the receiver for the SoftLoad process. Refer to the OEM7 Installation and Operation User Manual for more information about the SoftLoad process. After each SOFTLOADDATA command, the user must wait for the OK or ERROR command response before proceeding. This response is guaranteed to be output from the receiver within 15 seconds from the time the command was received by the receiver. If an error response is returned, consult the SOFTLOADSTATUS log on page 844 for more detail. This command can only be sent to the receiver when the SOFTLOADSTATUS log reports READY_ FOR_SETUP or READY_FOR_DATA.
Message ID: 477
Abbreviated ASCII Syntax: SOFTLOADSREC s-record
Input Example: SOFTLOADSREC "S30900283C10FAA9F000EF"
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
SOFTLOADSREC header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
SREC
-
ASCII S-Record string copites from firmware *.shex file
String [515]
variable
1
H
3
Reserved
-
1
Reserved. Set to 1 in the binary case
Ulong
4
variable
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
361
Chapter 2 GNSS Commands
2.159 STATUSCONFIG
Configures RXSTATUSEVENT mask fields
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command is used to configure the various status mask fields in the RXSTATUSEVENT log (see page 780). These masks can modify whether various status fields generate errors or event messages when they are set or cleared. Receiver Errors automatically generate event messages. These event messages are output in RXSTATUSEVENT log (see page 780). It is also possible to have status conditions trigger event messages to be generated by the receiver. This is done by setting/clearing the appropriate bits in the event set/clear masks. The set mask tells the receiver to generate an event message when the bit becomes set. Likewise, the clear mask causes messages to be generated when a bit is cleared. To disable all these messages without changing the bits, simply UNLOG the RXSTATUSEVENT log (see page 780) on the appropriate ports. Refer also to the Built in Status Tests chapter in the OEM7 Installation and Operation User Manual.
Message ID: 95
Abbreviated ASCII Syntax: STATUSCONFIG type word mask
Factory Default: STATUSCONFIG PRIORITY STATUS 0 STATUSCONFIG PRIORITY AUX1 0x00000008 STATUSCONFIG PRIORITY AUX2 0 STATUSCONFIG SET STATUS 0x00000000 STATUSCONFIG SET AUX1 0 STATUSCONFIG SET AUX2 0 STATUSCONFIG CLEAR STATUS 0x00000000 STATUSCONFIG CLEAR AUX1 0 STATUSCONFIG CLEAR AUX2 0
ASCII Example: STATUSCONFIG SET STATUS 0028A51D
The receiver gives the user the ability to determine the importance of the status bits. In the case of the Receiver Status, setting a bit in the priority mask causes the condition to trigger an error. This causes the receiver to idle all channels, set the ERROR strobe line, flash an error code on the status LED, turn off the antenna (LNA power) and disable the RF hardware, the same as if a bit in the Receiver Error word is set. Setting a bit in an Auxiliary Status priority mask causes that condition to set the bit in the Receiver Status word corresponding to that Auxiliary Status.
OEM7 Commands and Logs Reference Manual v10
362
Chapter 2 GNSS Commands
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
STATUSCONFIG header
-
Command header.
-
See Messages on page 25 for more
-
information.
H
0
PRIORITY 0
Replace the Priority mask
2
type
SET
1
Replace the Set mask Enum 4
H
CLEAR
2
Replace the Clear mask
STATUS 1
Receiver Status word
AUX1
2
Auxiliary 1 Status word
3
word
AUX2
3
Auxiliary 2 Status word
Enum 4
H+4
AUX3
4
Auxiliary 3 Status word
AUX4
5
Auxiliary 4 Status word
4
mask
8 digit hexadecimal
The hexadecimal bit mask
Ulong
4
H+8
OEM7 Commands and Logs Reference Manual v10
363
Chapter 2 GNSS Commands
2.160 STEADYLINE
Configures position mode matching
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The STEADYLINE� functionality helps mitigate the discontinuities that often occur when a GNSS receiver changes positioning modes. The effect is especially evident when a receiver transitions from an RTK position mode solution to a lower accuracy "fall back" solution, such as DGPS, WAAS+GLIDE or even autonomous GLIDE. Smooth transitions are particularly important for agricultural steering applications where sudden jumps may be problematic.
The STEADYLINE internally monitors the position offsets between all the positioning modes present in the receiver. When the receiver experiences a position transition, the corresponding offset is applied to the output position to limit a potential real position jump. When the original accurate position type returns, the STEADYLINE algorithm will slowly transition back to the new accurate position at a default rate of 0.005 m/s. This creates a smoother pass-to-pass relative accuracy at the expense of a possible degradation of absolute accuracy.
For example, a receiver can be configured to do both RTK and GLIDE. If this receiver has a fixed RTK position and experiences a loss of correction data causing the loss of the RTK solution it will immediately apply the offset between the two position modes and uses the GLIDE position stability to maintain the previous trajectory. Over time the GLIDE (or non-RTK) position will experience some drift. Once the RTK position is achieved again the receiver will start using the RTK positions for position stability and will slowly transition back to the RTK positions at a default rate of 0.005 m/s.
If the position type is OUT_OF_BOUNDS (see the UALCONTROL command on page 378) then STEADYLINE is reset.
Message ID: 1452
Abbreviated ASCII Syntax:
STEADYLINE mode [transition_time]
Factory Default:
STEADYLINE disable
ASCII Example:
STEADYLINE prefer_accuracy 100
Field
Field Type
ASCII Binary Value Value
Description
1
STEADYLINE header
-
-
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
364
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
2
mode
See Table 67: STEADYLINE Mode below
STEADYLINE mode
3
Transition time
Time over which solutions will transition in seconds. The minimum rate of change is 0.005 m/s regardless of this parameter.
Format
Binary Bytes
Binary Offset
Enum 4
H
Ulong 4
H+4
Table 67: STEADYLINE Mode
ASCII
Binary
Description
DISABLE
0
Disable STEADYLINE (default)
MAINTAIN
Maintain the relative offset of the solution. There is no discontinuity in the
1
position solution when the reference position type changes. Any offset in
the position is maintained.
Transition, at a user-configurable rate. There is no discontinuity in the
TRANSITION
2
position solution when the reference position type changes. The position will slowly transition to the new reference position type over the time
period specified by the Transition time parameter.
RESET
3
Reset the saved offsets
PREFER_ ACCURACY
TRANSITION when changing from less accurate reference positioning type
4
to more accurate reference positioning type. MAINTAIN when changing from more accurate reference positioning type to a less accurate
reference positioning type.
UAL
For use with the UALCONTROL command (see page 378):
5
TRANSITION when the position type is in WARNING MAINTAIN when the position type is in OPERATIONAL DISABLE when the position type is OUT_
OF_BOUNDS
OEM7 Commands and Logs Reference Manual v10
365
Chapter 2 GNSS Commands
2.161 STEADYLINEDIFFERENTIALTIMEOUT
Sets how long the receiver will report RTK/PPP after corrections are lost
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to set how long STEADYLINE will report RTK or PPP solutions after a loss of corrections. If able, STEADYLINE will report an RTK or PPP solution until this timeout expires or until the RTK/PPP timeout expires, whichever is higher. For example:
l If the RTKTIMEOUT is 60 seconds and the STEADYLINEDIFFERENTIALTIMEOUT is 300 seconds, STEADYLINE will report an RTK solution for 300 seconds.
l If the RTKTIMEOUT is 60 seconds and the STEADYLINEDIFFERENTIALTIMEOUT is 30 seconds, STEADYLINE will report an RTK solution for 60 seconds.
Message ID: 2002
Abbreviated ASCII Syntax: STEADYLINEDIFFERENTIALTIMEOUT timeout
Factory Default: STEADYLINEDIFFERENTIALTIMEOUT 60
ASCII Example: STEADYLINEDIFFERENTIALTIMEOUT 300
Field
Field Type
ASCII Binary Value Value
Description
STEADYLINE
1
DIFFERENTIALTIMEOUT -
-
header
Command header. See Messages on page 25 for more information.
2
timeout
5 to 1200
Timeout period in seconds
Format
Binary Bytes
Binary Offset
-
H
0
Float
4
H
OEM7 Commands and Logs Reference Manual v10
366
Chapter 2 GNSS Commands
2.162 SURVEYPOSITION
Saves or deletes a surveyed position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this command to add or delete a surveyed position saved in the receiver NVM. The surveyed positions added or deleted with this command are used in conjunction with the AUTOSURVEY command on page 79.
Message ID: 1952
Abbreviated ASCII Syntax: SURVEYPOSITION option id [latitude] [longitude] [height] [tolerance]
ASCII Examples: SURVEYPOSITION save auto 51.116 -114.038 1065.0 10.0 SURVEYPOSITION delete cal2
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
SURVEY
Command header. See
1
POSITION -
-
Messages on page 25 for
-
header
more information.
H
0
SAVE 1
Save the surveyed position in the receiver NVM
2
option
Enum 4
H
DELETE 2
Delete the surveyed position from the receiver NVM
OEM7 Commands and Logs Reference Manual v10
367
Chapter 2 GNSS Commands
Field
Field Type
3
id
4
latitude
5
longitude
6
height
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
4 character string
ID for the saved position
When saving a position, "AUTO" can be entered and the receiver will automatically generate a unique ID for the position. "AUTO" cannot be used when deleting a position.
To determine the ID for a saved position, use the
String [5]
8
SAVEDSURVEYPOSITIONS
log on page 791.
Note: In the Binary case, the ID string must be null terminated and additional bytes of padding must be added to make the total length of the field 8 bytes.
H+4
-90 to 90
Latitude of the position in degrees (default=0.0)
A "-" sign denotes south and a "+" sign denotes north
Double 8
H+12
-360 to 360
Longitude of the position in degrees (default=0)
Double 8
A "-" sign denotes west and a "+" sign denotes east
H+20
-1000 to 20000000
Mean Sea Level height of the
position in metres
Double 8
(default=0.0)
H+28
OEM7 Commands and Logs Reference Manual v10
368
Chapter 2 GNSS Commands
Field
Field Type
7
tolerance
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
3 - 100
Position tolerance in metres (default=10.0)
The maximum distance
between the position
calculated during an self-
survey and the saved position. During the self-
Double 8
survey, if the distance
between the calculated
position and the previously
surveyed position is less than
this value, the previous
position is used.
H+36
OEM7 Commands and Logs Reference Manual v10
369
Chapter 2 GNSS Commands
2.163 THISANTENNAPCO
Sets the PCO model of this receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use the THISANTENNAPCO command to set the Phase Center Offsets (PCO) for the given frequency of this receiver. The Offsets are defined as North, East and Up from the Antenna Reference Point to the Frequency Phase Center in mm.
Message ID: 1417
Abbreviated ASCII Syntax: THISANTENNAPCO Frequency[NorthOffset][EastOffset][UpOffset]
ASCII Example: THISANTENNAPCO GPSL1 0.61 1.99 65.64
Field
Field Type
ASCII Binary Value Value
Description
1
THISANTENNAPCO header
-
-
Command header. See Messages on page 25 for more information.
2
Frequency
See Table 19: Frequency Type on page 83
The frequency for which the phase center offsets are valid.
3
North Offset
NGS standard Phase
Center North Offset (millimetres).1
4
East Offset
NGS standard Phase
Center East Offset (millimetres).1
5
Up Offset
NGS standard Phase
Center Up Offset (millimetres).1
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Double 8 Double 8 Double 8
H+4 H+12 H+20
1Enter values as per the NGS standards and tables to define which direction is plus or minus. OEM7 Commands and Logs Reference Manual v10
370
Chapter 2 GNSS Commands
2.164 THISANTENNAPCV
Sets the PCV model of this receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use the THISANTENNAPCV command to set the Phase Center Variation (PVC) for the given frequency of this receiver. The Phase Center Variation entries follow the NGS standard and correspond to the phase elevation at 5 degree increments starting at 90 degrees and decreasing to 0.
Message ID: 1418
Abbreviated ASCII Syntax: THISANTENNAPCV Frequency[PCVArray]
ASCII Example: THISANTENNAPCV GPSL1 0.00 -0.020 -0.07 -0.15 -0.24 -0.34 -0.43 -0.51 -0.56 0.61 -0.65 -0.69 -0.69 -0.62 -0.44 -0.13 0.28 0.70 1.02
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
THISANTENNAPCV header
-
-
Command header.
See Messages on page 25 for more
-
information.
H
0
2
Frequency
See Table 19: Frequency Type on page 83
The frequency for which the phase center variations is valid.
Enum 4
H
3
PCV Array
NGS standard 19
Element array of
Phase Center
Variations for phase variation for 5 degree Double elevation increments Array 152
starting at 90 degrees [19] and decreasing to 0.
The variances are
entered in
millimetres.
H+4
OEM7 Commands and Logs Reference Manual v10
371
Chapter 2 GNSS Commands
2.165 THISANTENNATYPE
Sets the antenna type of this receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use the THISANTENNATYPE command to set the type of antenna being used with the receiver. There are two sources of antenna information:
l An internal table The firmware contains a set of predefined antenna and radome types taken from the IGS ANTEX file. Refer to Table 20: Antenna Type on page 86 and Table 21: Radome Type on page 95 for the antennas currently supported.
l User-defined antennas User-defined antenna types can be entered using the ANTENNATYPE command (see page 65).
The BASEANTENNATYPE command (see page 85) is used to set the RTK base antenna type.
Message ID: 1420
Abbreviated ASCII Syntax:
THISANTENNATYPE AntennaType [RadomeType]
ASCII Examples:
THISANTENNATYPE NOV702
THISANTENNATYPE USER_ANTENNA_1
Field
Field Type
ASCII Value
Binary Value
1
THISANTENNATYPE header
-
-
2
AntennaType
3
RadomeType
See Table 20: Antenna Type on page 86 or Table 14: User-Defined Antenna Type on page 66
See Table 21: Radome Type on page 95
Description
Command header. See Messages on page 25 for more information.
Antenna type
Radome type (default = NONE)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
372
Chapter 2 GNSS Commands
2.166 TRACKSV
Overrides automatic satellite assignment criteria
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to override the automatic satellite/channel assignment for all satellites with manual instructions.
Message ID: 1326
Abbreviated ASCII Syntax: TRACKSV system SVID condition
Factory Default: GPS, GLONASS, GALILEO, QZSS, BeiDou and NavIC default = GOODHEALTH SBAS default = ANYHEALTH TRACKSV QZSS 198 NEVER TRACKSV QZSS 202 NEVER
QZSS 198 and QZSS 202 are excluded because they are defined as test PRNs in the QZSS ICD.
Input Example: TRACKSV GALILEO 0 ANYHEALTH
For dual antenna receivers, this command applies to both the primary and secondary antennas.
Field
Field Type
ASCII Value
Binary Value
Description
1
TRACKSV header
-
-
Command header. See Messages on page 25 for more information.
2
System
See Table 105: Satellite System on page 553
System that the SVID belongs to
Satellite SVID number
3
SVID
Refer to PRN
"0" is allowed and applies
Numbers on page 44 to all SVIDs for the
specified system type
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Ulong 4
H+4
OEM7 Commands and Logs Reference Manual v10
373
Chapter 2 GNSS Commands
Field
Field Type
ASCII Value
Binary Value
See Table 68:
4
Condition TRACKSV Command
Condition below
Description Tracking condition
Format
Binary Bytes
Binary Offset
Enum 4
H+8
Table 68: TRACKSV Command Condition
Binary
ASCII
Description
1
NEVER
Never track this satellite
2
GOODHEALTH
Track this satellite if the health is indicated as healthy in both the almanac and ephemeris
3
ANYHEALTH Track this satellite regardless of health status
4
ALWAYS
Always track this satellite
OEM7 Commands and Logs Reference Manual v10
374
Chapter 2 GNSS Commands
2.167 TUNNELESCAPE
Breaks out of an established tunnel
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The tunnel escape sequence feature allows you to break out of a tunnel between two ports by sending a predefined sequence of bytes through the tunnel in-line with the data stream. Use the TUNNELESCAPE command to specify the tunnel escape sequence. The escape sequence is applied independently to all active tunnels. Use the SAVECONFIG command (see page 321) to save the escape sequence in case of a power cycle. This command is used to define an escape sequence that, when detected in a byte stream between any two COM (or AUX) ports, resets the interface mode to NOVATEL NOVATEL on those ports. The baud rate and other port parameters remain unaffected. The TUNNELESCAPE command accepts three parameters. The first is the switch parameter with ENABLE or DISABLE options. The second is the length parameter. It is a number from 1 to 8 and must be present if the switch parameter is set to ENABLE. The third parameter, esc seq, consists of a series of pairs of digits representing hexadecimal numbers, where the number of pairs are equal to the value entered for the second parameter. The series of hexadecimal pairs of digits represent the escape sequence. The receiver detects a sequence in a tunnel exactly as it was entered. For example, the command TUNNELESCAPE ENABLE 4 61626364 searches for the bytes representing "abcd" in a tunnel stream. TUNNELESCAPE ENABLE 3 AA4412 searches for the NovAtel binary log sync bytes. You must first set up a tunnel. For example, create a tunnel between COM1 and COM2 by entering INTERFACEMODE COM1 TCOM2 NONE OFF. The commands can be entered in any order.
1. All bytes, leading up to and including the escape sequence, pass through the tunnel before it is reset. Therefore, the escape sequence is the last sequence of bytes that passes through the tunnel. Configure the receiver to detect and interpret the escape sequence. For example, use this information to reset equipment or perform a shutdown process.
2. The receiver detects the escape sequence in all active tunnels in any direction. 3. Create tunnels using the INTERFACEMODE command (see page 198).
Message ID: 962
Abbreviated ASCII Syntax: TUNNELESCAPE switch length escseq
Factory Default: TUNNELESCAPE disable 0
ASCII Example: TUNNELESCAPE enable 1 aa
OEM7 Commands and Logs Reference Manual v10
375
Chapter 2 GNSS Commands
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
TUNNELESCAPE header
-
Command header. See
-
Messages on page 25 H
0
-
for more information.
2
switch
DISABLE 0 ENABLE 1
Enable or disable the tunnel escape mode
Enum
4
H
3
length
1 to 8
Specifies the number of hex bytes to follow
Ulong
4
H+4
4
escseq
Escape sequence
where Hex pairs are entered without spaces, for example,
Uchar [8]
8
AA4412
H+8
If using the SAVECONFIG command (see page 321) in NovAtel Connect, ensure all windows other than the Console window are closed. If open, NovAtel Connect also saves log commands used for its various windows. This results in unnecessary data being logged.
OEM7 Commands and Logs Reference Manual v10
376
Chapter 2 GNSS Commands
2.168 UALCONTROL
Setup User Accuracy levels
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The UALCONTROL command is used to define User Accuracy Levels. User accuracy levels are user defined standard deviations thresholds, used to determine solution acceptability. Issuing the UALCONTROL command causes the BESTPOS and GPGGA solution types to be controlled via the specified thresholds, rather than by the solution source or mode. The new solution types are described in the table below.
Table 69: User Accuracy Level Supplemental Position Types and NMEA Equivalents
Value BESTPOS Position Type1 NMEA Equivalent2
70 OPERATIONAL
4
71 WARNING
5
72 OUT_OF_BOUNDS
1
The SETBESTPOSCRITERIA command (see page 346) determines which standard deviations are compared against the provided thresholds. When using the STEADYLINE command (see page 365) together with the UALCONTROL command, the UAL setting is recommended. Refer to Table 67: STEADYLINE Mode on page 366 for mode details.
UAL is useful for applications that rely upon specific solutions types being present in the BESTPOS or GPGGA logs. For example, if an agricultural steering system commonly requires an RTK fixed GPGGA solution type (4) to operate, and interruptions in RTK conventionally cause the GPGGA to switch to another solution type. This causes the steering system to disengage. However, while using STEADYLINE, solutions with fixed RTK accuracy can be maintained by GLIDE even if RTK is interrupted. UALCONTROL can be used to ensure that the required solution type is maintained through such interruptions, permitting the steering system to function continuously.
Message ID: 1627 Abbreviated ASCII Syntax:
UALCONTROL Action [Operational_limit] [Warning_limit] Factory Default:
UALCONTROL disable ASCII Example:
1As reported in the BESTPOS log (see page 433). 2Refers to the GPGGA quality indicator (see GPGGA on page 515 for details).
OEM7 Commands and Logs Reference Manual v10
377
Chapter 2 GNSS Commands
UALCONTROL enable 0.10 0.20
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
UALCONTROL header
-
Command header. See
-
Messages on page 25 for -
more information.
H
0
DISABLE 0
Disables this feature
2
Action
Replace BESTPOS and
GPGGA position types
with OPERATIONAL,
WARNING or OUT_OF_
BOUNDS based on the
ENABLE 1
entered standard
deviations (refer to Table 69: User Accuracy
Enum
4
H
Level Supplemental
Position Types and NMEA
Equivalents on the
previous page)
CLEAR 2
Disable this feature and reset the entered standard deviations.
3
Operational Limit
Standard deviation in metres to report OPERATIONAL
Double 8
H+4
4
Warning Limit
Standard deviation in metres to report WARNING
Note: OUT_OF_BOUND Double 8 reports when the standard deviation exceeds this value
H+12
OEM7 Commands and Logs Reference Manual v10
378
Chapter 2 GNSS Commands
2.169 UNASSIGN
Unassigns a previously assigned channel
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command cancels a previously issued ASSIGN command (see page 68) and the SV channel reverts to automatic control (the same as ASSIGN AUTO). Message ID: 29 Abbreviated ASCII Syntax:
UNASSIGN channel [state]
Input Example: UNASSIGN 11
Issuing the UNASSIGN command to a channel that was not previously assigned by the ASSIGN command (see page 68) has no effect.
For dual antenna receivers, when using the UNASSIGN command for SV channels on the primary antenna, the SV channel count goes from 0 to N-1, where N is the number of channels in the primary antenna channel configuration. When using the UNASSIGN command for channels on the secondary antenna, the SV channel count begins at N and goes to N+(M-1), where M is the number of channels in the secondary antenna SV channel configuration.
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Command
header. See
1
UNASSIGN header
-
-
Messages on page 25 for
-
H
0
more
information.
Channel number
0 to n, where n is the
reset to
2
channel
number of the last channel in automatic
the current channel
search and
Ulong 4
H
configuration
acquisition
mode
OEM7 Commands and Logs Reference Manual v10
379
Chapter 2 GNSS Commands
Field
Field Type
3
state
ASCII Value
Binary Value
These return SV channel control to the automatic search engine immediately (see Table 15: Channel State on page 70)
Description
Set the SV channel state (currently ignored)
Format
Binary Bytes
Binary Offset
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
380
Chapter 2 GNSS Commands
2.170 UNASSIGNALL
Unassigns all previously assigned channels
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command cancels all previously issued ASSIGN commands for all SV channels (same as ASSIGNALL AUTO). Tracking and control for each SV channel reverts to automatic mode.
Message ID: 30
Abbreviated ASCII Syntax: UNASSIGNALL [system]
Input Example: UNASSIGNALL GPS
Issuing the UNASSIGNALL command has no effect on channels that were not previously assigned using the ASSIGN command (see page 68).
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
UNASSIGNALL header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
system
See Table 16: Channel System on page 72
System that will be affected by the UNASSIGNALL command (default = ALL)
Enum
4
H
OEM7 Commands and Logs Reference Manual v10
381
Chapter 2 GNSS Commands
2.171 UNDULATION
Chooses undulation
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command permits you to enter a specific geoidal undulation value. In the option field, the EGM96 table provides ellipsoid heights at a 0.5� by 0.5� spacing while the OSU89B is implemented at a 2� by 3� spacing. In areas of rapidly changing elevation, you could be operating somewhere within the 2� by 3� grid with an erroneous height. EGM96 provides a more accurate model of the ellipsoid which results in a denser grid of heights. It is also more accurate because the accuracy of the grid points themselves has also improved from OSU89B to EGM96. For example, the default grid (EGM96) is useful where there are underwater canyons, steep dropoffs or mountains. The undulation values reported in the position logs are in reference to the ellipsoid of the chosen datum. Refer to the application note APN-006 Geoid Issue, available on our website www.novatel.com/support/search/ for a description of the relationships in Figure 10: Illustration of Undulation below.
Figure 10: Illustration of Undulation
Message ID: 214 Abbreviated ASCII Syntax:
UNDULATION option [separation]
Factory Default: UNDULATION egm96 0.0000
ASCII Example 1: UNDULATION osu89b
ASCII Example 2: UNDULATION USER -5.599999905
OEM7 Commands and Logs Reference Manual v10
382
Chapter 2 GNSS Commands
Field Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
UNDULATION header
-
Command header. See
-
Messages on page 25 for -
more information.
H
0
USER 1
Use the user specified undulation value
2
option
OSU89B 2
Use the OSU89B undulation table
Enum 4
H
EGM96 3
Use global geoidal height model EGM96 table
3
separation
�1000.0 m
The undulation value
(required for the USER
Float
4
option) (default = 0.000)
H+4
OEM7 Commands and Logs Reference Manual v10
383
Chapter 2 GNSS Commands
2.172 UNLOCKOUT
Reinstates a satellite in the solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command allows a satellite which has been previously locked out (LOCKOUT command on page 223) to be reinstated in the solution computation. If more than one satellite is to be reinstated, this command must be reissued for each satellite reinstatement.
Message ID: 138
Abbreviated ASCII Syntax: UNLOCKOUT prn
Input Example: UNLOCKOUT 8
The UNLOCKOUT command is used to reinstate a satellite while leaving other locked out satellites unchanged. This command can be used for GPS, GLONASS, SBAS and QZSS.
Field
Field Type
ASCII Binary Value Value
Description
1
UNLOCKOUT header
-
-
Command header. See Messages on page 25 for more information.
2
prn
Refer to PRN Numbers on page 44
A single satellite PRN number to be reinstated
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
384
Chapter 2 GNSS Commands
2.173 UNLOCKOUTALL
Reinstates all previously locked out satellites
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command allows all satellites which have been previously locked out (LOCKOUT command on page 223 or LOCKOUTSYSTEM command on page 224) to be reinstated in the solution computation.
Message ID: 139
Abbreviated ASCII Syntax: UNLOCKOUTALL
Input Example: UNLOCKOUTALL
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
UNLOCKOUTALL header
-
-
Command header. See Messages on page 25 for more information.
H
0
OEM7 Commands and Logs Reference Manual v10
385
Chapter 2 GNSS Commands
2.174 UNLOCKOUTSYSTEM
Reinstates previously locked out system
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command allows a system which has been previously locked out (refer to the LOCKOUTSYSTEM command on page 224) to be reinstated in the solution computation.
If more than one system is to be reinstated, this command must be reissued for each system reinstatement.
Message ID: 908 Abbreviated ASCII Syntax:
UNLOCKOUTSYSTEM system
Input Example: UNLOCKOUTSYSTEM glonass
The UNLOCKOUTSYSTEM command is used to reinstate a system while leaving other locked out systems unchanged.
Field Field Type
ASCII Value
Binary Value
UNLOCKOUT
1
SYSTEM
-
-
header
2
system
See Table 105: Satellite System on page 553
Description
Command header. See Messages on page 25 for more information.
A single satellite system to be reinstated
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
386
Chapter 2 GNSS Commands
2.175 UNLOG
Removes a log from logging control
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is used to remove a specific log request from the system.
Message ID: 36
Abbreviated ASCII Syntax: UNLOG [port] message
Input Example: UNLOG com1 bestposa UNLOG bestposa
The UNLOG command is used to remove one or more logs while leaving other logs unchanged.
2.175.1 Binary
Field
Field Name
Binary Value
1
UNLOG (binary) header
(See Table 3: Binary Message Header Structure on page 30)
2
port
See Table 4: Detailed Port Identifier on page 31 (decimal port values greater than 16 may be used)
3
message Any valid message ID
Description
Format
Binary Bytes
Binary Offset
This field
contains the message
-
header
H
0
Port to which
log is being Enum 4
H
sent
Message ID of log to output
Ushort 2
H+4
OEM7 Commands and Logs Reference Manual v10
387
Chapter 2 GNSS Commands
Field
Field Name
Binary Value
Bits 0-4 = Reserved
Bits 5-6 = Format
00 = Binary
01 = ASCII
4
message type
10 = Abbreviated ASCII, NMEA
11 = Reserved
Bit 7 = Response Bit (Message Responses on page 41)
0 = Original Message
1 = Response Message
5
Reserved
Description
Format
Binary Bytes
Binary Offset
Message type of log
Char
1
H+6
Char
1
H+7
2.175.2 ASCII
Field
Field Type
ASCII Value
Binary Value
UNLOG
1
(ASCII) -
-
header
2
port
See Table 4: Detailed Port Identifier on page 31 (decimal port values greater than 16 may be used)
3
message
Message Name
N/A
Description
Format
Binary Bytes
Binary Offset
This field contains the
command name or the
message header depending on whether the command
-
is abbreviated ASCII or
ASCII, respectively
H
0
Port to which log is being
sent
Enum 4
H
(default = THISPORT)
Message Name of log to be disabled
Ulong
4
H+4
OEM7 Commands and Logs Reference Manual v10
388
Chapter 2 GNSS Commands
2.176 UNLOGALL
Removes all logs from logging control
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
If [port] is specified, this command disables all logs on the specified port only. All other ports are unaffected. If [port] is not specified this command defaults to the ALL_PORTS setting.
Message ID: 38
Abbreviated ASCII Syntax: UNLOGALL [port] [held]
Input Example: UNLOGALL com2_15 UNLOGALL true
The UNLOGALL command is used to remove all log requests currently in use.
Field
Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
Command header.
1
UNLOGALL header
-
-
See Messages on page 25 for more
-
H
0
information.
2
port
See Table 4: Detailed Port Port to clear
Identifier on page 31 (decimal values greater
(default = ALL_
Enum 4
H
than 16 may be used)
PORTS)
FALSE
0
3
held
TRUE
1
Does not remove logs with the HOLD parameter (default)
Removes
Bool
4
previously held
logs, even those
with the HOLD
parameter
H+4
OEM7 Commands and Logs Reference Manual v10
389
Chapter 2 GNSS Commands
2.177 USBSTICKEJECT
Prepare a USB stick for removal
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to unmount the USB stick and prepare it for safe physical removal. This command may fail with a Busy error if there is an ongoing USB stick mounting or unmounting operation. The FILETRANSFERSTATUS log (see page 477) indicates the USBSTICK UNMOUNTED status when it is safe to physically remove the stick. This may take up to 10 seconds.
Message ID: 2115
Abbreviated ASCII Syntax: USBSTICKEJECT
Example: USBSTICKEJECT
Field Field Type
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
1
USBSTICKEJECT header
-
Command
header. See
-
Messages on
-
page 25 for more
information.
H
0
OEM7 Commands and Logs Reference Manual v10
390
Chapter 2 GNSS Commands
2.178 USERDATUM
Sets user customized datum
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command permits entry of customized ellipsoidal datum parameters. This command is used in conjunction with the DATUM command (see page 119). If used, the command default setting for USERDATUM is WGS84.
This command is not suitable for use with RTK.
When the USERDATUM command is entered, the USEREXPDATUM command on page 394 is then issued internally with the USERDATUM command values. It is the USEREXPDATUM command that appears in the RXCONFIG log (see page 764). If the USEREXPDATUM command or USERDATUM command are used, their newest values overwrite the internal USEREXPDATUM values. The transformation for the WGS84 to Local used in the OEM7 family is the Bursa-Wolf transformation or reverse Helmert transformation. In the Helmert transformation, the rotation of a point is counter clockwise around the axes. In the Bursa-Wolf transformation, the rotation of a point is clockwise. Therefore, the reverse Helmert transformation is the same as the BursaWolf.
Message ID: 78
Abbreviated ASCII Syntax: USERDATUM semimajor flattening dx dy dz rx ry rz scale
Factory Default: USERDATUM 6378137.0 298.2572235628 0.0 0.0 0.0 0.0 0.0 0.0 0.0
ASCII Example: USERDATUM 6378206.400 294.97869820000 -12.0000 147.0000 192.0000 0.0000 0.0000 0.0000 0.000000000
Use the USERDATUM command in a survey to fix the position with values from another known datum so that the GNSS calculated positions are reported in the known datum rather than WGS84.
Field
Field Type
ASCII Binary Value Value
Description
1
USERDATUM header
-
-
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
391
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
2
semimajor
6300000.0 6400000.0
Datum Semi-major Axis (a) (metres)
Double
8
H
Reciprocal Flattening,
3
flattening
290.0 - 305.0
1/f = a/(a-b)
Double 8
H+8
4
dx
5
dy
6
dz
� 2000.0 � 2000.0 � 2000.0
Datum offsets from local to Double 8 WGS84. These are the
translation values between the user datum and WGS84
Double
8
(internal reference) (metres)
Double 8
H+16 H+24 H+32
7
rx
8
ry
9
rz
Datum rotation angle about
� 10.0 radians X, Y and Z. These values
Double 8
are the rotation from your
� 10.0 radians
local datum to WGS84. A positive sign is for counter
Double 8
clockwise rotation and a
� 10.0 radians negative sign is for clockwise rotation
Double 8
H+40 H+48 H+56
10
scale
� 10.0 ppm
Scale value is the difference in ppm between Double 8 the user datum and WGS84
H+64
OEM7 Commands and Logs Reference Manual v10
392
Chapter 2 GNSS Commands
2.179 USEREXPDATUM
Set custom expanded datum
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Like the USERDATUM command, this command allows you to enter customized ellipsoidal datum parameters. However, USEREXPDATUM literally means user expanded datum which allows additional datum information such as velocity offsets and time constraints. The 7 expanded parameters are rates of change of the initial 7 parameters. These rates of change affect the initial 7 parameters over time relative to the Reference Date provided by the user.
This command is not suitable for use with RTK.
This command is used in conjunction with the DATUM command (see page 119). If this command is used without specifying any parameters, the command defaults to WGS84. If a USERDATUM command is entered, the USEREXPDATUM command is then issued internally with the USERDATUM command values (USERDATUM command on page 392). It is the USEREXPDATUM command that appears in the RXCONFIG log. If the USEREXPDATUM or the USERDATUM command are used, their newest values overwrite the internal USEREXPDATUM values.
Message ID: 783
Abbreviated ASCII Syntax: USEREXPDATUM semimajor flattening dx dy dz rx ry rz scale xvel yvel zvel xrvel yrvel zrvel scalev refdate
Factory Default: USEREXPDATUM 6378137.0 298.25722356280 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0
ASCII Example: USEREXPDATUM 6378137.000 298.25722356280 0.000000000 0.000000000 0.000000000 0.00000000 0.000000000 0.000000000 0.000000000 0.000000000 0.000000000 0.000000000 0.0000 0.000000000 0.000000000 0.000000000 0.000000000
Use the USEREXPDATUM command in a survey to fix the position with values from another known datum so that the GPS calculated positions are reported in the known datum rather than WGS84. For example, it is useful for places like Australia, where the continent is moving several centimetres a year relative to WGS84. With USEREXPDATUM you can also input the velocity of the movement to account for drift over the years.
OEM7 Commands and Logs Reference Manual v10
393
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1
USEREXPDATUM header
-
-
Command header. See
Messages on page 25
-
for more information.
H
0
2
semimajor
6300000.0 6400000.0 m
Datum semi-major axis (a) in metres
Double
8
H
3
flattening
290.0 - 305.0
Reciprocal Flattening, 1/f = a/(a-b)
Double 8
H+8
4
dx
5
dy
6
dz
� 2000.0 m � 2000.0 m � 2000.0 m
Datum offsets from local to WGS84. These
Double 8
are the translation values between the user
Double
8
datum and WGS84 (internal reference)
Double 8
H+16 H+24 H+32
7
rx
8
ry
9
rz
� 10.0 radians � 10.0 radians � 10.0 radians
Datum rotation angle about X, Y and Z. These Double 8
values are the rotation
from your local datum
to WGS84. A positive
Double 8
sign is for counter
clockwise rotation and a
negative sign is for clockwise rotation
Double 8
H+40 H+48 H+56
10
scale
� 10.0 ppm
Scale value is the
difference in ppm between the user datum
Double
8
and WGS84
H+64
11
xvel
� 2000.0 m/yr
Velocity vector along Xaxis
Double
8
H+72
12
yvel
� 2000.0 m/yr
Velocity vector along Yaxis
Double
8
H+80
13
zvel
� 2000.0 m/yr
Velocity vector along Zaxis
Double
8
H+88
14
xrvel
� 10.0 radians/yr
Change in the rotation about X over time
Double 8
H+96
15
yrvel
� 10.0 radians/yr
Change in the rotation about Y over time
Double 8
H+104
16
zrvel
� 10.0 radians/yr
Change in the rotation about Z over time
Double 8
H+112
OEM7 Commands and Logs Reference Manual v10
394
Chapter 2 GNSS Commands
Field Field Type
17
scalev
18
refdate
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
� 10.0 ppm/yr
Change in scale from WGS84 over time
Double 8
H+120
0.0 year
Reference date of parameters
Example: 2011.00 = Jan 1, 2011
Double 8
2011.19 = Mar 11, 2011
H+128
OEM7 Commands and Logs Reference Manual v10
395
Chapter 2 GNSS Commands
2.180 USERI2CREAD
Read data from devices on the I2C bus
Platform: OEM7600, OEM7700, OEM7720 Use this command to read data from devices on the I2C bus.
This command only applies to OEM7 receivers that have I2C signals available on the interface connector. The compatible receivers are listed in the Platform section above.
The USERI2CRESPONSE log (see page 866) can be used to check the completion or status of the read operation. An optional user defined Transaction ID can be provided to help synchronize requests with responses in the USERI2CRESPONSE log (see page 866). This command is primarily intended to be used by Lua applications that need to interact with external devices. Reading from an I2C device requires a device address, to distinguish which physical device is to be accessed, a register within the device, and the expected number of bytes to be read. Depending on the type of I2C device, register addresses can be 1 to 4 bytes in length, so the actual number of bytes for the register address must be specified. For some I2C devices there are no registers within the device. In this case, the Register Address Length is 0 and no bytes are supplied for the Register Address. The USERI2CREAD command is flexible to handle all of these situations.
Message ID: 2232
Abbreviated ASCII Syntax: USERI2CREAD DeviceAddress RegisterAddressLen RegisterAddress RequestReadLen [TransactionID]
Examples: USERI2CREAD 70 1 AB 12 1234
USERI2CREAD 74 3 ABCDEF 234 5678
USERI2CREAD 74 0 234 5678
Field
Field Type
1
USERI2CREAD header
Description
Command header. See Messages for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
396
Chapter 2 GNSS Commands
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
The 7 bit address of the I2C device. Valid values are 0 through 127.
2
DeviceAddress
For ASCII and Abbreviated commands, Uchar 11
H
this field is a hexadecimal string of two
digits. There is no 0x prefix and spaces
are not allowed in the string.
3
RegisterAddressLen
The length of the register address that follows. Valid values are 0 through 4.
Ulong
4
H+4
The actual address of the register to be
read. The number of bytes here must
match the RegisterAddressLen. In
particular, when RegisterAddressLen is
0, this field is empty (even for a binary
4
RegisterAddress
command)
Uchar
X1
Array
For ASCII and Abbreviated commands,
this field is a hexadecimal string of two
digits for each byte in the register
address. There is no 0x prefix and
spaces are not allowed in the string.
H+8
The length of data expected to be
5
RequestReadLen
retrieved from the device. Valid values Ulong 4
are 1 through 256.
H+122
6
TransactionID
An optional user provided ID for this transaction. Default = 0.
This transaction ID will be copied to the Ulong 4 USERI2CRESPONSE log (see page 866) created for this read operation.
H+163
1In the binary case, additional bytes of padding are added after this field to maintain 4-byte alignment for the fields that follow. 2H+8 if X=0
3H+12 if X=0
OEM7 Commands and Logs Reference Manual v10
397
Chapter 2 GNSS Commands
2.181 USERI2CWRITE
Write data to device on I2C bus
Platform: OEM7600, OEM7700, OEM7720 Use this command to write data to devices on the I2C bus.
This command only applies to OEM7 receivers that have I2C signals available on the interface connector. The compatible receivers are listed in the Platform section above.
The USERI2CRESPONSE log (see page 866) can be used to check the completion or status of the write operation. An optional user defined Transaction ID can be provided to help synchronize requests with responses in the USERI2CRESPONSE log (see page 866). This command is primarily intended to be used by Lua applications that need to interact with external devices. Writing to an I2C device requires a device address, to distinguish which physical device is to be accessed, a register within the device and the data. Depending on the type of I2C device, register addresses can be 1 to 4 bytes in length, and so the actual number of bytes for the register address must be specified. For some I2C devices there are no registers within the device. In this case, the Register Address Length is 0, and no bytes are supplied for the Register Address. For some other I2C devices, write operations are done in two stages: 1. The first stage sends a write command with a register address, but no data. This is a dummy
write to set the register within the device for write operations that follow. 2. The second stage sends a write command with no register address, but does send a stream
of data. The USERI2CWRITE command is flexible to handle all of these situations.
Message ID: 2233
Abbreviated ASCII Syntax: USERI2CWRITE DeviceAddress RegisterAddressLen RegisterAddress WriteDataLength WriteData [TransactionID]
Examples: USERI2CWRITE 70 1 AB 12 3132333435363738393A3B3C 1234 USERI2CWRITE 74 3 ABCDED 5 1234567890 1234 USERI2CWRITE 40 0 5 1234567890 1234 USERI2CWRITE 40 2 AABB 0 1234 (a dummy write)
OEM7 Commands and Logs Reference Manual v10
398
Chapter 2 GNSS Commands
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
USERI2CWRITE header
Command header. See Messages for more information.
-
H
0
The 7 bit address of the I2C device. Valid values 0 through 127.
2
DeviceAddress
For ASCII and Abbreviated commands, this field is a
Uchar 11
H
hexadecimal string of two digits.
There is no 0x prefix and spaces
are not allowed in the string.
The length of the register
3
RegisterAddressLen address that follows. Valid values Ulong 4
are 0 through 4.
H+4
The actual address of the register
to be written. The number of
bytes here must match the
RegisterAddressLen. In
particular, when
RegisterAddressLen is 0, this
field is empty (even for a binary
4
RegisterAddress
command)
Uchar
X1
Array
For ASCII and Abbreviated
commands, this field is a
hexadecimal string of two digits
for each byte in the register
address. There is no 0x prefix
and spaces are not allowed in the
string.
H+8
The length of data to be written
5
WriteDataLength
in bytes. Valid values are 0
Ulong 4
through 256.
H+122
1In the binary case, additional bytes of padding are added after this field to maintain 4-byte alignment for the fields
that follow. 2H+8 if X=0
OEM7 Commands and Logs Reference Manual v10
399
Chapter 2 GNSS Commands
Field
Field Type
6
WriteData
7
TransactionID
Description
Format
Binary Bytes
Binary Offset
The data to be written. The number of bytes in this data block must match the WriteDataLength. In particular, when WriteDataLength is 0, this field is empty.
For ASCII and Abbreviated commands, this field is a hexadecimal string of two digits
Uchar Array
Y1
for each byte in the data block.
There is no 0x prefix and spaces
are not allowed in the string.
Data is streamed to the device as a series of bytes in the order provided.
H+162
An optional user provided ID for this transaction. Default = 0.
This transaction ID will be copied Ulong 4 to the USERI2CRESPONSE log (see page 866) created for this write operation.
H+16+4*INT ((Y+3)/4)3
1In the binary case, additional bytes of padding are added after this field to maintain 4-byte alignment for the fields that follow. 2H+12 if X=0
3H+12+4*INT((Y+3)/4) if X=0
OEM7 Commands and Logs Reference Manual v10
400
Chapter 2 GNSS Commands
2.182 UTMZONE
Sets UTM parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command sets the UTM persistence, zone number or meridian. Refer to earth-info.nga.mil/GandG/coordsys/grids/referencesys.html for more information and a world map of UTM zone numbers.
1. The latitude limits of the UTM System are 80�S to 84�N, so if your position is outside this range, the BESTUTM log (see page 446) outputs a northing, easting and height of 0.0, along with a zone letter of "*" and a zone number of 0, so that it is obvious that the data in the log is dummy data.
2. If the latitude band is X, then the Zone number should not be set to 32, 34 or 36. These zones were incorporated into other zone numbers and do not exist.
Message ID: 749
Abbreviated ASCII Syntax: UTMZONE command [parameter]
Factory Default: UTMZONE auto 0
ASCII Example 1: UTMZONE SET 10
ASCII Example 2: UTMZONE CURRENT
The UTM grid system is displayed on all National Topographic Series (NTS) of Canada maps and United States Geological Survey (USGS) maps. On USGS 7.5-minute quadrangle maps (1:24,000 scale), 15-minute quadrangle maps (1:50,000, 1:62,500, and standard-edition 1:63,360 scales) and Canadian 1:50,000 maps the UTM grid lines are drawn at intervals of 1,000 metres and are shown either with blue ticks at the edge of the map or by full blue grid lines. On USGS maps at 1:100,000 and 1:250,000 scale and Canadian 1:250,000 scale maps a full UTM grid is shown at intervals of 10,000 metres.
Field
Field Type
ASCII Binary Value Value
Description
1
UTMZONE header
-
-
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
401
Chapter 2 GNSS Commands
Field
Field Type
ASCII Binary Value Value
Description
2
command See Table 70: UTM Zone Commands below
3
parameter See Table 70: UTM Zone Commands below
Format
Binary Bytes
Binary Offset
Enum
4
H
Long
4
H+4
Table 70: UTM Zone Commands
Binary ASCII
Description
0
AUTO
UTM zone default that automatically sets the central meridian and does not switch zones until it overlaps by the set persistence. This a spherical approximation to the earth unless you are at the equator (default = 0) (m)
1
CURRENT
Same as UTMZONE AUTO with infinite persistence of the current zone. The parameter field is not used
2
SET
Sets the central meridian based on the specified UTM zone. A zone includes its western boundary, but not its eastern boundary, Meridian. For example, zone 12 includes (108�W, 114�W) where 108� < longitude < 114�
Sets the central meridian as specified in the parameter field. In the
3
MERIDIAN
BESTUTM log (see page 446), the zone number is output as 61 to indicate the manual setting (zones are set by pre-defined central meridians not user-
set ones)
OEM7 Commands and Logs Reference Manual v10
402
Chapter 2 GNSS Commands
2.183 WIFIAPCHANNEL
Set the channel for the Wi-Fi access point
Platform: PwrPak7, SMART7-I, SMART7-W Use this command to set the operating channel for the Wi-Fi module when operating as an access point. The new channel will be used the next time the WIFIMODE AP or WIFIMODE CONCURRENT command is received.
Client mode and Concurrent mode available on the SMART7-I and SMART7-W only.
Message ID: 2091 Abbreviated ASCII Syntax:
WIFIAPCHANNEL channel
Factory Default: WIFIAPCHANNEL 11
Example: WIFIAPCHANNEL 6
Field
Field Type
ASCII Binary Value Value
Description
1
WIFIAPCHANNEL header
-
-
Command header. See Messages on page 25 for more information.
2
channel
1-14
802.11 channel
Format
Binary Value
Binary Offset
-
H
0
Long
4
H
For best performance, choose one of the non-overlapping channels: 1, 6, or 11.
OEM7 Commands and Logs Reference Manual v10
403
Chapter 2 GNSS Commands
2.184 WIFIAPIPCONFIG
Set the IP address and netmask for the Wi-Fi access point
Platform: PwrPak7, SMART7-I, SMART7-W Use this command to set the Wi-Fi IP address and netmask for Wi-Fi module when operating as an access point. The new network configuration takes effect the next time the WIFIMODE AP or WIFIMODE CONCURRENT command is received.
Client mode and Concurrent mode available on the SMART7-I and SMART7-W only.
Message ID: 2096 Abbreviated ASCII Syntax:
WIFIAPIPCONFIG ip_address ip_netmask
Factory Default: WIFIAPIPCONFIG 192.168.19.1 255.255.255.0
Example: WIFIAPIPCONFIG 192.162.55.20 255.255.0.0
Field
Field Type
ASCII Binary Value Value
Description
1
WIFIAPIPCONFIG header
-
-
Command header. See Messages on page 25 for more information.
2
ip_address
Null-terminated IP address, dot
ASCII string
decimal format
3
ip_netmask
Null-terminated ASCII string
IP netmask, dot decimal format (optional)
Default =255.255.255.0
Format
Binary Bytes
Binary Offset
-
H
0
String [16]
Variable H
String [16]
Variable Variable
OEM7 Commands and Logs Reference Manual v10
404
Chapter 2 GNSS Commands
2.185 WIFIAPPASSKEY
Set Wi-Fi access point passkey
Platform: PwrPak7, SMART7-I, SMART7-W Use this command to set the WPA2 PSK ASCII passkey for the Wi-Fi module when the receiver is operating as an Access Point. The default passkey is printed on the receiver label. The new passkey takes effect the next time the WIFIMODE AP or WIFIMODE CONCURRENT command is received.
The term passkey and password are the same.
Client mode and Concurrent mode available on the SMART7-I and SMART7-W only.
Message ID: 2090 Abbreviated ASCII Syntax:
WIFIAPPASSKEY passkey
Factory Default: The default passkey/password is printed on the receiver label.
Example: WIFIAPPASSKEY "bysP3zE6SZmFQeyd"
Field Field Type
ASCII Binary Value Value
1
WIFIAPPASSKEY header
-
-
2
passkey
Null-terminated ASCII string, 8 to 64 characters
Description
Command header. See Messages on page 25 for more information.
WPA2 PSK ASCII passkey
Format
Binary Bytes
Binary Offset
-
H
0
String [65]
Variable H
OEM7 Commands and Logs Reference Manual v10
405
Chapter 2 GNSS Commands
2.186 WIFIMODE
Configure the receiver Wi-Fi mode
Platform: PwrPak7, SMART7-I, SMART7-W Use this command to enable, disable or set the operating mode of Wi-Fi on the receiver. This command is also applies any Wi-Fi configuration changes specified by other Wi-Fi commands such as WIFIAPCHANNEL.
Client mode and Concurrent mode available on the SMART7-I and SMART7-W only.
Message ID: 2144 Abbreviated ASCII Syntax:
WIFIMODE mode
Factory Default: WIFIMODE AP
Example: WIFIMODE CLIENT WIFIMODE OFF
Field
Field Type
ASCII Value
Binary Value
Description
1
WIFIMODE header
-
Command header.
-
See Messages on page 25 for more
information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
406
Chapter 2 GNSS Commands
Field
Field Type
2
mode
ASCII Value
Binary Value
Description
Format
Binary Bytes
Binary Offset
OFF
0
Power off the Wi-Fi module
Configure the Wi-Fi
AP
1
module as an Access
Point (AP)
CLIENT
Configure the Wi-Fi
2
module as a
Client/Station
Supply power to the
ON
3
Wi-Fi module, but do
not configure it.
Enum 4
H
Configure the Wi-Fi
module as both an
access point and
client/station
simultaneously. When
configured in this
CONCURRENT 4
mode it is possible to
connect the receiver
to an access point and
for Clients/Stations to
connect to the
receiver
simultaneously.
OEM7 Commands and Logs Reference Manual v10
407
Chapter 3 Logs
3.1 Log Types
See the LOG command on page 225, for details about requesting logs.
The receiver is capable of generating three type of logs: synchronous, asynchronous and polled. The data for synchronous logs is generated on a regular schedule. In order to output the most current data as soon as it is available, asynchronous data is generated at irregular intervals. The data in polled logs is generated on demand. The following table outlines the log types and the valid triggers to use:
Table 71: Log Type Triggers
Type Recommended Trigger Illegal Trigger
Synch ONTIME
ONNEW, ONCHANGED
Asynch ONCHANGED or ONCE Polled ONCE or ONTIME a
ONNEW, ONCHANGED
See Message Time Stamps on page 46 for information about how the message time stamp is set for each type of log.
1. The OEM7 family of receivers can handle 80 logs at a time. If an attempt is made to log more than 80 logs at a time, the receiver responds with an Insufficient Resources error.
2. Asynchronous logs, such as MATCHEDPOS, should only be logged ONCHANGED. Otherwise, the most current data is not output when it is available. This is especially true of the ONTIME trigger, which may result in inaccurate time tags.
3. Use the ONNEW trigger with the MARKTIME or MARKPOS logs. 4. Before the output of fields for ASCII and binary logs, there is an ASCII or binary
header respectively. See Table 2: ASCII Message Header Structure on page 28 and Table 3: Binary Message Header Structure on page 30. There is no header information before Abbreviated ASCII output, see Abbreviated ASCII on page 29.
3.1.1 Log Type Examples
For polled logs, the receiver only supports an offset that is: l smaller than the logging period l decimal values that are a multiple of the maximum logging rate defined by the receiver model. For more information see the LOG command on page 225.
The following are valid examples for a polled log: log portstats ontime 4 2
aPolled log types do not allow fractional offsets and cannot do ontime rates faster than 1 Hz.
OEM7 Commands and Logs Reference Manual v10
409
Chapter 3 Logs
log version once
For polled logs, the following examples are invalid:
log serialconfig ontime 1 2
[offset is larger than the logging period]
log serialconfig ontime 4 1.5 [offset is not an integer]
For synchronous and asynchronous logs, the receiver supports any offset that is:
l smaller than the logging period
l a multiple of the minimum logging period
For example, if the receiver supports 20 Hz logging, the minimum logging period is 1/20 Hz or 0.05 s. The following are valid examples for a synchronous or asynchronous log, on a receiver that can log at rates up to 20 Hz:
log bestpos ontime 1
[1 Hz]
log bestpos ontime 1 0.1
log bestpos ontime 1 0.90
log avepos ontime 1 0.95
log avepos ontime 2
[0.5 Hz]
log avepos ontime 2 1.35
log avepos ontime 2 1.75
For synchronous and asynchronous logs, the following examples are invalid:
log bestpos ontime 1 0.08 [offset is not a multiple of the minimum logging period]
log bestpos ontime 1 1.05 [offset is larger than the logging period]
3.2 Log Reference
Logs are the mechanism used to extract information from the receiver.
OEM7 Commands and Logs Reference Manual v10
410
Chapter 3 Logs
3.3 ALIGNBSLNENU
ENU baselines using ALIGN
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log outputs the RTK quality ENU baselines from ALIGN. The XYZ baselines (output in ALIGNBSLNXYZ log) are rotated relative to master position (output in MASTERPOS) to compute ENU baselines.
On dual antenna receivers, the ALIGNBSLNENU log is not available for the secondary antenna input.
Message ID: 1315
Log Type: Asynch
Recommended Input: log alignbslnenua onnew
ASCII Example: #ALIGNBSLNENUA,COM1,0,29.0,FINESTEERING,1629,259250.000,02040000,100b,39448;SO L_COMPUTED,NARROW_INT,4.1586,-1.9197,0.0037,0.0047,0.0050,0.0062,"0092","AAAA",22,16,16,16,0,01,0,33*11e1d4c0
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
ALIGNBSLNENU
Log header. See Messages on page 25 for more information.
H
0
2
sol stat
Solution status, see Table 74: Solution
Enum 4
H
Status on page 436
3
pos type
Position type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+4
4
East
East Baseline (relative to master position) in metres
Double
8
H+8
5
North
North Baseline (relative to master position) in metres
Double 8
H+16
6
Up
Up Baseline (relative to master position) in metres
Double
8
H+24
7
East
East Baseline standard deviation in metres Float
4
H+32
8
North
North Baseline standard deviation in metres
Float
4
H+36
OEM7 Commands and Logs Reference Manual v10
411
Chapter 3 Logs
Field Field type
9
Up
10
Rover id
11
Master id
12
#SVs
13
#solnSVs
14
#obs
15
#multi
16
Reserved
17
ext sol stat
Galileo and
18
BeiDou sig
mask
GPS and
19
GLONASS sig
mask
20
xxxx
21
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Up Baseline standard deviation in metres Float
4
H+40
Rover Receiver ID
Set using the SETROVERID command (see
page 352) on the Rover
Char[4] 4
e.g., setroverid RRRR
H+44
Master Receiver ID Set using the DGPSTXID command (see page 127) on the Master
Default: AAAA
Char[4] 4
H+48
Number of satellites tracked
Uchar 1
H+52
Number of satellites in solution
Uchar 1
H+53
Number of satellites above elevation mask angle
Uchar
1
H+54
Number of satellites above elevation mask angle with L2, B2
Uchar
1
H+55
Hex
1
H+56
Extended solution status, see Table 78: Extended Solution Status on page 440
Hex
1
H+57
Galileo and BeiDou signals used mask (see
Table 77: Galileo and BeiDou Signal-Used Hex
1
Mask on page 440)
H+58
GPS and GLONASS signals used mask (see
Table 76: GPS and GLONASS Signal-Used Hex
1
Mask on page 439)
H+59
32-bit CRC (ASCII and Binary only)
Hex
4
H+60
Sentence Terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
412
Chapter 3 Logs
3.4 ALIGNBSLNXYZ
XYZ baselines using ALIGN
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log outputs the RTK quality XYZ baselines from ALIGN.
On dual antenna receivers, the ALIGNBSLNXYZ log is not available for the secondary antenna input.
Message ID: 1314
Log Type: Asynch
Recommended Input: log alignbslnxyza onnew
ASCII Example: #ALIGNBSLNXYZA,COM1,0,29.0,FINESTEERING,1629,259250.000,02040000,9d28,39448;SO L_COMPUTED,NARROW_INT,3.1901,3.0566,1.2079,0.0050,0.0054,0.0056,"0092","AAAA",22,16,16,16,0,01,0,33*ac372198
Field Field type
Description
1
ALIGNBSLNXYZ
Log header. See Messages on page 25 for more information.
2
sol stat
Solution status, see Table 74: Solution Status on page 436
3
pos type
Position type, see Table 75: Position or Velocity Type on page 437
4
dX
X Baseline in metres
5
dY
Y Baseline in metres
6
dZ
Z Baseline in metres
7
dX
X Baseline standard deviation in metres
8
dY
Y Baseline standard deviation in metres
9
dZ
Z Baseline standard deviation in metres
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
Double 8
Double 8
Double 8
Float
4
Float
4
Float
4
H+4
H+8 H+16 H+24 H+32 H+36 H+40
OEM7 Commands and Logs Reference Manual v10
413
Chapter 3 Logs
Field Field type
10
Rover id
11
Master id
12
#SVs
13
#solnSVs
14
#obs
15
#multi
16
Reserved
17
ext sol stat
Galileo and
18
BeiDou sig
mask
GPS and
19
GLONASS sig
mask
20
xxxx
21
[CR][LF]
Description
Rover Receiver ID Set using SETROVERID command (see page 352) on the Rover e.g. SETROVERID RRRR
Master Receiver Id Set using the DGPSTXID command (see page 127) on the Master Default: AAAA
Number of satellites tracked
Number of satellites in solution
Number of satellites above elevation mask angle
Number of satellites above elevation mask angle with L2, B2
Extended solution status, see Table 78: Extended Solution Status on page 440
Galileo and BeiDou signals used mask (see Table 77: Galileo and BeiDou Signal-Used Mask on page 440)
GPS and GLONASS signals used mask (see Table 76: GPS and GLONASS Signal-Used Mask on page 439)
32-bit CRC (ASCII and Binary only)
Sentence Terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Uchar [4]
4
H+44
Uchar [4]
4
Uchar 1 Uchar 1 Uchar 1
Uchar 1
Hex
1
Hex
1
Hex
1
Hex
1
Hex
4
-
-
H+48
H+52 H+53 H+54 H+55 H+56 H+57
H+58
H+59 H+60 -
OEM7 Commands and Logs Reference Manual v10
414
Chapter 3 Logs
3.5 ALIGNDOP
Calculated DOP values
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log outputs the DOP computed using the satellites used in the heading solution. This log comes out at a default 1 Hz rate. Additional logs may be output not on the even second if the DOP changes and ALIGN is operating at greater than 1 Hz.
Message ID: 1332
Log Type: Asynch
Recommended Input: log aligndopa onnew
ASCII Example: #ALIGNDOPA,COM1,0,22.5,FINESTEERING,1629,259250.000,02040000,de2d,39448;1.6160, 1.2400,0.6900,0.9920,0.7130,10.0,16,4,32,23,10,7,20,13,30,16,47,43,46,53,54,44, 45*90a72971
Field
Field type
Description
1
ALIGNDOP
Log header. See Messages on page 25 for more information.
2
GDOP
Geometric DOP
3
PDOP
Position DOP
4
HDOP
Horizontal DOP
5
HTDOP
Horizontal and time DOP
6
TDOP
Time DOP
7
Elev mask Elevation mask angle
8
#sats
Number of satellites to follow
9
sats
Satellites in use at time of calculation
10
Next sat offset = H+28+(#sats * 4)
11
xxxx
32-bit CRC (ASCII and Binary only)
12
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
H
0
Float
4
Float
4
Float
4
Float
4
Float
4
Float
4
Ulong 4
Ulong 4
H H+4 H+8 H+12 H+16 H+20 H+24 H+28
Hex
4
-
-
H+28+ (#sats * 4)
-
OEM7 Commands and Logs Reference Manual v10
415
Chapter 3 Logs
3.6 ALMANAC
Decoded GPS Almanac
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the decoded GPS almanac parameters from subframes four and five, as received from the satellite, with the parity information removed and appropriate scaling applied. For more information about almanac data, refer to the GPS SPS Signal Specification. The OEM7 family of receivers automatically save almanacs in their Non-Volatile Memory (NVM), so creating an almanac boot file is not necessary.
Message ID: 73
Log Type: Asynch
Recommended Input: log almanaca onchanged
ASCII Example: #ALMANACA,COM1,0,54.0,SATTIME,1364,409278.000,02000000,06de,2310; 29, 1,1364,589824.0,6.289482e-03,-7.55460039e-09,-2.2193421e+00,-1.7064776e+00,7.94268362e-01,4.00543213e-05,3.63797881e-12,1.45856541e04,2.6560037e+07,4.45154034e-02,1,0,0,FALSE, 2,1364,589824.0,9.173393e-03,-8.16033991e09,1.9308788e+00,1.9904300e+00,6.60915023e-01,-1.62124634e05,0.00000000,1.45860023e-04,2.6559614e+07,8.38895743e-03,1,0,0,FALSE, 3,1364,589824.0,7.894993e-03,-8.04604944e-09,7.95206128e-01,6.63875501e-01,2.00526792e-01,7.91549683e-05,3.63797881e-12,1.45858655e-04,2.6559780e+07,1.59210428e-02,1,0,0,TRUE, ... 28,1364,589824.0,1.113367e-02,-7.87461372e-09,-1.44364969e-01,2.2781989e+00,1.6546425e+00,3.24249268e-05,0.00000000,1.45859775e04,2.6559644e+07,1.80122900e-02,1,0,0,FALSE, 29,1364,589824.0,9.435177e-03,-7.57745849e-09,-2.2673888e+00,-9.56729511e01,1.1791713e+00,5.51223755e-04,1.09139364e-11,1.45855297e04,2.6560188e+07,4.36225787e-02,1,0,0,FALSE, 30,1364,589824.0,8.776665e-03,-8.09176563e-09,-1.97082451e01,1.2960786e+00,2.0072936e+00,2.76565552e-05,0.00000000,1.45849410e04,2.6560903e+07,2.14517626e-03,1,0,0,FALSE*de7a4e45
The speed at which the receiver locates and locks onto new satellites is improved if the receiver has approximate time and position, as well as an almanac. This allows the receiver to compute the elevation of each satellite so it can tell which satellites are visible and their Doppler offsets, improving Time to First Fix (TTFF).
OEM7 Commands and Logs Reference Manual v10
416
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
ALMANAC
Log header. See Messages on page 25 for more information.
H
0
The number of satellite PRN almanac
2
#messages messages to follow. Set to zero until
Long
4
H
almanac data is available
3
PRN
Satellite PRN number for current message (dimensionless)
Ulong
4
H+4
4
week
Almanac reference week (GPS reference week number)
Ulong
4
H+8
5
seconds
Almanac reference time (seconds into the week)
Double
8
H+12
6
ecc
Eccentricity (dimensionless)
Double 8
H+20
7
Rate of right ascension (radians/second) Double 8
H+28
8
o
9
Right ascension (radians) Argument of perigee (radians)
Double 8 Double 8
H+36 H+44
10
Mo
Mean anomaly of reference time (radians) Double 8
11
afo
Clock aging parameter (seconds)
Double 8
12
af1
Clock aging parameter (seconds/second) Double 8
13
N0
Computed mean motion (radians/second) Double 8
14
A
Semi-major axis (metres)
Double 8
Angle of inclination relative to 0.3
15
incl-angle (radians)
Double 8
H+52 H+60 H+68 H+76 H+84
H+92
16
SV config Satellite configuration
Ulong 4
H+100
SV health from Page 25 of subframe 4 or 5
17
health-prn
Ulong 4
(6 bits)
H+104
18
health-alm SV health from almanac (8 bits)
Ulong 4
H+108
Anti-spoofing on?
19
antispoof
0 = FALSE
1 = TRUE
Bool
4
H+112
20... Next PRN offset = H + 4 + (#messages x 112)
OEM7 Commands and Logs Reference Manual v10
417
Chapter 3 Logs
Field Field type
Description
21
xxxx
32-bit CRC (ASCII and Binary only)
22
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Hex
4
H+4+ (112 x #messages)
-
-
-
OEM7 Commands and Logs Reference Manual v10
418
Chapter 3 Logs
3.7 AUTHCODES
List of authorization codes
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains all authorization codes (auth codes) entered into the system since the last complete firmware reload. Signature authorization codes will be maintained through a SoftLoad. The log also indicates the status of the firmware signature. For more information about firmware signatures see the "Upgrading Using the AUTH Command" section of the OEM7 Installation and Operation User Manual.
The following situations will cause an authorization code to be marked invalid: l Authorization Code is for a different receiver l Authorization Code has expired l Authorization Code was entered incorrectly
If you require new authorization codes, contact NovAtel Customer Service.
Message ID: 1348
Log Type: Polled
Recommended Input: log authcodesa once
ASCII Example: #AUTHCODESA,COM1,0,80.5,UNKNOWN,0,10.775,024c0000,2ad2,12143;VALID,2,SIGNATURE, TRUE,"63F3K8,MX43GD,T4BJ2X,924RRB,BZRWBT,D2SB0G550",STANDARD,TRUE,"CJ43M9,2RNDB H,F3PDK8,N88F44,8JMKK9,D2SB0G550"*6f778e32
Field Field type
Description
1
AUTHCODES header
Log header. See Messages on page 25 for more information.
Status of the Firmware Signature
1 = NONE
2
AUTHCODES
2 = INVALID
Signature Status 3 = VALID
4 = RESERVED
5 = HIGH_SPEED
3
Number of Auth # of Auth Codes to follow
Codes
(max is 24)
Format
Binary Bytes
Binary Offset
H
0
Enum
4
H
Ulong 4
H+4
OEM7 Commands and Logs Reference Manual v10
419
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
1=STANDARD
4
Auth code type 2=SIGNATURE
3=EMBEDDED
Enum
4
H+8
5
Valid
TRUE if the Auth Code has been verified
Bool
4
H+12
6
Auth Code String
ASCII String of the Auth Code
String [max 80]
variable
1
H+16
7... Next AuthCode = H+8+ (#AuthCodes*variable)
8
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+8+ (#AuthCodes* variable)
9
[CR][LF]
Sentence terminator (ASCII only) -
-
-
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
420
Chapter 3 Logs
3.8 AVEPOS
Position averaging
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
When position averaging is underway, the various fields in the AVEPOS log contain the parameters being used in the position averaging process. Table 72: Position Averaging Status on the next page shows the possible position averaging status values seen in field #8 of the AVEPOS log table. See the description of the POSAVE command on page 263. For general positioning information, refer to An Introduction to GNSS available on our website.
Asynchronous logs should only be logged ONCHANGED. Otherwise, the most current data is not output when it is available. This is especially true of the ONTIME trigger, which may cause inaccurate time tags to result.
Message ID: 172
Log Type: Asynch
Recommended Input: log aveposa onchanged
ASCII Example: #AVEPOSA,COM1,0,48.5,FINESTEERING,1364,492100.000,82000000,e3b4,2310;51.1163558 9900,114.03833558937,1062.216134356,1.7561,0.7856,1.7236,INPROGRESS,2400,2*72a550c1
When a GNSS position is computed, there are four unknowns being solved: latitude, longitude, height and receiver clock offset (often just called time). The solutions for each of the four unknowns are correlated to satellite positions in a complex way. Since satellites are above the antenna (none are below) there is a geometric bias. Therefore, geometric biases are present in the solutions and affect the computation of height. These biases are called DOPs (Dilution Of Precision). Smaller biases are indicated by low DOP values. VDOP (Vertical DOP) pertains to height. Most of the time, VDOP is higher than HDOP (Horizontal DOP) and TDOP (Time DOP). Therefore, of the four unknowns, height is the most difficult to solve. Many GNSS receivers output the Standard Deviations (SD) of the latitude, longitude and height. Height often has a larger value than the other two. Accuracy is based on statistics and reliability is measured in percent. When a receiver states it can measure height to one metre, this is an accuracy. Usually this is a one sigma value (one SD). A one sigma value for height has a reliability of 68%. In other words, the error is less than one metre 68% of the time. For a more realistic accuracy, double the one sigma value (one metre) and the result is 95% reliability (error is less than two metres 95% of the time). Generally, GNSS heights are 1.5 times poorer than horizontal positions. See also GPGST log on page 526 for CEP and RMS definitions.
OEM7 Commands and Logs Reference Manual v10
421
Chapter 3 Logs
Field
Field type
Description
1
AVEPOS header
Log header. See Messages on page 25 for more information.
2
lat
Average WGS84 latitude (degrees)
3
lon
Average WGS84 longitude (degrees)
4
hgt
Average height above sea level (m)
5
lat
Estimated average standard deviation of latitude solution element (m)
6
lon
Estimated average standard deviation of longitude solution element (m)
7
hgt
Estimated average standard deviation of height solution element (m)
8
posave
Position averaging status (see Table 72: Position Averaging Status below)
9
ave time Elapsed time of averaging (s)
10
#samples Number of samples in the average
11
xxxx
32-bit CRC (ASCII and Binary only)
12
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
H
0
Double 8 Double 8 Double 8
H H+8 H+16
Float
4
H+24
Float
4
H+28
Float
4
H+32
Enum 4
Ulong 4
Ulong 4
Hex
4
-
-
H+36
H+40 H+44 H+48 -
Table 72: Position Averaging Status
Binary
ASCII
Description
0
OFF
Receiver is not averaging
1
INPROGRESS Averaging is in progress
2
COMPLETE
Averaging is complete
OEM7 Commands and Logs Reference Manual v10
422
Chapter 3 Logs
3.9 BDSALMANAC
Decoded BDS Almanac
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the decoded BeiDou almanac parameters, with the parity information removed and appropriate scaling applied. Multiple messages are transmitted, one for each SV almanac collected. For more information about almanac data, refer to the BDS Signal Specification. The OEM7 family of receivers automatically save almanacs in their Non-Volatile Memory (NVM), so creating an almanac boot file is not necessary.
Message ID: 1584
Log Type: Asynch
Recommended Input: log bdsalmanaca onchanged
ASCII Example: #BDSALMANACA,COM1,13,88.5,SATTIME,1727,518438.000,02000000,24ad,44226;1,371,245 760,6493.394531,2.9134750366e-04,-2.289514637,-0.021819903,2.456844003,1.30291141e-09,2.7785425443e-02,-1.096725e-04,2.18279e11,0*77017e1b
...
#BDSALMANACA,COM1,0,88.5,SATTIME,1727,518108.000,02000000,24ad,44226;14,371,217 088,5282.558105,1.4486312866e-03,-2.970093901,2.846651891,1.512957087,6.91457373e-09,1.7820542434e-02,7.438660e-05,0.00000,d8*ce944672
The speed at which the receiver locates and locks onto new satellites is improved if the receiver has approximate time and position, as well as an almanac. This allows the receiver to compute the elevation of each satellite so it can tell which satellites are visible and their Doppler offsets, improving Time to First Fix (TTFF).
Field Field Type
Description
1
BDSALMANAC Log header. See Messages on page 25 for
header
more information.
2
satellite ID Satellite ID/ranging code
3
week
Week number
4
toa
Time of almanac (seconds)
5
RootA
Square root of semi-major axis (sqrt (metres))
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Ulong 4 Ulong 4
H H+4 H+8
Double 8
H+12
OEM7 Commands and Logs Reference Manual v10
423
Chapter 3 Logs
Field Field Type
6
ecc
7
8
M0
9
10
11
i
12
a0
13
a1
14
health
15
xxxx
16
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Eccentricity (dimensionless)
Double 8
H+20
Argument of perigee (radians)
Double 8
H+28
Mean anomaly at reference time (radians)
Double 8
H+36
Longitude of ascending node of orbital of plane computed according to reference time Double 8 (radians)
H+44
Rate of right ascension (radians/second)
Double 8
H+52
Correction of orbit reference inclination at reference time (radians)
Double 8
H+60
Constant term of clock correction polynomial (seconds)
Double
8
H+68
Linear term of clock correction polynomial (seconds/seconds)
Double 8
H+76
Satellite health information
Ulong 4
H+84
32-bit CRC (ASCII and Binary only)
Hex
4
H+88
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
424
Chapter 3 Logs
3.10 BDSCLOCK
BeiDou time parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains time parameters transmitted by the BeiDou satellites. These parameters can be used to calculated the offset between BeiDou time (BDT) and other time frames.
Message ID: 1607
Log Type: Asynch
Recommended Input: log bdsclocka onchanged
ASCII Example: #BDSCLOCKA,COM1,0,80.0,SATTIME,1730,193994.000,02000000,3b16,44290; -9.313225746154785e-010,-8.881784197001252e-016,2,6,0,2, 0.000000000000000e+000,0.000000000000000e+000,0.000000000000000e+000, 0.000000000000000e+000,0.000000000000000e+000,0.000000000000000e+000 *84820676
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
BDSCLOCK Log header. See Messages on page 25 for more
header
information.
H
0
2
A0UTC
BDT clock bias relative to UTC (seconds)
Double 8
H
3
A1UTC
BDT clock rate relative to UTC (seconds/second)
Double 8
H+8
4
TLS
Delta time due to leap seconds before the new leap second is effective (seconds)
Short
2
H+16
5
WNLSF
Week number of the new leap second
Ushort 2
H+18
6
DN
Day number of week of the new leap second
Ushort 2
H+20
7
TLSF
Delta time due to leap seconds after the new leap second effective
Short
2
H+22
8
A0GPS
BDT clock bias relative to GPS time (seconds) Double 8
H+24
9
A1GPS
BDT clock rate relative to GPS time (seconds/second)
Double 8
H+32
10
A0Gal
BDT clock bias relative to Galileo time (seconds)
Double 8
H+40
OEM7 Commands and Logs Reference Manual v10
425
Chapter 3 Logs
Field
Field Type
11
A1Gal
12
A0GLO
13
A1GLO
14
xxxx
15
[CR][LF]
Description
BDT clock rate relative to Galileo time (seconds/second) BDT clock bias relative to GLONASS time (seconds) BDT clock rate relative to GLONASS time (seconds/second) 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+48
Double 8
H+56
Double 8
Ulong 4
-
-
H+64 H+72 -
OEM7 Commands and Logs Reference Manual v10
426
Chapter 3 Logs
3.11 BDSEPHEMERIS
Decoded BDS ephemeris
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains a single set of BDS ephemeris parameters with appropriate scaling applied. Multiple messages are transmitted, one for each SV ephemeris collected.
Message ID: 1696
Log Type: Asynch
Recommended Input: log bdsephemerisa onchanged
ASCII Example: #BDSEPHEMERISA,COM1,0,82.5,SATTIME,1774,162464.000,02000000,2626,45436;13,418,2 .00,1,8.20e-09,3.10e-09,11,162000,2.33372441e-04,5.73052716e-12,8.53809211e19,12,162000,5282.609060,2.3558507673e-03,3.122599126,4.1744595973e-09,0.654635278,1.950232658e+00,-6.98564812e-09,9.5674299203e-01,3.164417525e10,4.325527698e-06,8.850824088e-06,179.3593750,87.5312500,7.171183825e08,1.024454832e-08*d8b97536
Field Field Type
Description
1
BDSEPHEMERIS Log header. See Messages on page 25 for
header
more information.
2
satellite ID
ID/ranging code
3
Week
Week number
4
URA
User range accuracy (metres). This is the evaluated URAI/URA lookup-table value.
5
health 1
Autonomous satellite health flag. 0 means broadcasting satellite is good and 1 means not.
6
tgd1
Equipment group delay differential for the B1 signal (seconds)
7
tgd2
Equipment group delay differential for the B2 signal (seconds)
8
AODC
Age of data, clock
9
toc
Reference time of clock parameters (seconds)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Ulong 4
H H+4
Double 8
H+8
Ulong 4
H+16
Double 8 Double 8 Ulong 4 Ulong 4
H+20 H+28 H+36 H+40
OEM7 Commands and Logs Reference Manual v10
427
Chapter 3 Logs
Field Field Type
10
a0
11
a1
12
a2
13
AODE
14
toe
15
RootA
16
ecc
17
18
N
19
M0
20
0
21
22
i0
23
IDOT
24
cuc
25
cus
26
crc
27
crs
28
cic
Description
Constant term of clock correction polynomial (seconds)
Linear term of clock correction polynomial (seconds/seconds)
Quadratic term of clock correction polynomial (seconds/seconds^2)
Age of data, ephemeris
Reference time of ephemeris parameters (seconds)
Square root of semi-major axis (sqrt (metres))
Eccentricity (dimensionless)
Argument of perigee (radians)
Mean motion difference from computed value (radians/second)
Mean anomaly at reference time (radians)
Longitude of ascending node of orbital of plane computed according to reference time (radians)
Rate of right ascension (radians/second)
Inclination angle at reference time (radians)
Rate of inclination angle (radians/second)
Amplitude of cosine harmonic correction term to the argument of latitude (radians)
Amplitude of sine harmonic correction term to the argument of latitude (radians)
Amplitude of cosine harmonic correction term to the orbit radius (metres)
Amplitude of sine harmonic correction term to the orbit radius (metres)
Amplitude of cosine harmonic correction term to the angle of inclination (radians)
Format
Binary Bytes
Binary Offset
Double 8
H+44
Double 8
H+52
Double 8 Ulong 4 Ulong 4
H+60 H+68 H+72
Double 8 Double 8 Double 8 Double 8 Double 8
H+76 H+84 H+92 H+100 H+108
Double 8
H+116
Double 8 Double 8 Double 8 Double 8
H+124 H+132 H+140 H+148
Double 8
H+156
Double 8
H+164
Double 8
H+172
Double 8
H+180
OEM7 Commands and Logs Reference Manual v10
428
Chapter 3 Logs
Field Field Type
Description
29
cis
30
xxxx
31
[CR][LF]
Amplitude of sine harmonic correction term to the angle of inclination (radians)
32-bit CRC (ASCII and Binary only)
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+188
Ulong 4
-
-
H+196 -
OEM7 Commands and Logs Reference Manual v10
429
Chapter 3 Logs
3.12 BDSIONO
BeiDou Klobuchar ionosphere delay model
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the Klobuchar ionosphere model parameters transmitted by the BeiDou satellites.
Message ID: 1590
Log Type: Asynch
Recommended Input: log bdsionoa onchanged
ASCII Example: #BDSIONOA,COM1,0,80.0,SATTIME,1734,58094.000,02080000,1956,44836;6, 2.607703208923340e-008,4.097819328308105e-007,-3.695487976074218e-006, 7.212162017822263e-006,69632.0,360448.0,-524288.0,-327680.0*69c2a6c6
Field
Field Type
1
BDSIONO Header
2
ID
3
0
4
1
5
2
6
3
7
0
8
1
9
2
10
3
Description
Format
Binary Bytes
Binary Offset
Log header. See Messages on page 25 for more information.
H
0
Transmitting satellite ID
Ulong 4
H
Klobuchar cosine curve amplitude constant term (seconds)
Double 8
H+4
Klobuchar cosine curve amplitude first-order
term (seconds/)
Double
8
H+12
Klobuchar cosine curve amplitude second-
order term (seconds/2)
Double 8
H+20
Klobuchar cosine curve amplitude third-
order term (seconds/3)
Double 8
H+28
Klobuchar cosine curve period constant term (seconds)
Double
8
H+36
Klobuchar cosine curve period first-order
term (seconds/)
Double 8
H+44
Klobuchar cosine curve period second-order
term (seconds/2)
Double
8
H+52
Klobuchar cosine curve period third-order
term (seconds/3)
Double 8
H+60
OEM7 Commands and Logs Reference Manual v10
430
Chapter 3 Logs
Field
Field Type
11
xxxx
12
[CR][LF]
Description 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+68
-
-
-
OEM7 Commands and Logs Reference Manual v10
431
Chapter 3 Logs
3.13 BDSRAWNAVSUBFRAME
Raw BeiDou subframe data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw BeiDou subframe data with parity bits removed. Only subframes that have passed the parity check are output.
Message ID: 1695
Log Type: Asynch
Recommended Input: log bdsrawnavsubframea onchanged
ASCII Example: #BDSRAWNAVSUBFRAMEA,COM1,0,85.5,SATTIME,1774,162554.000,02000000,88f3,45436;84, 13,B1D1,1,e24049ebb2b00d113c685207c4d0ee9fd1bf364e41f8f4b57003268c*6b1f478b
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
BDSRAWNAVSUBFRAME Log header. See Messages on
header
page 25 for more information.
H
0
2
signal channel
Signal channel number
Ulong 4
H
3
satellite ID
Satellite ID
Ulong 4
H+4
4
data source
Source of data (refer to Table 73: Data Source below)
Enum
4
H+8
5
subframe ID
Subframe identifier
Ulong 4
H+12
6
raw subframe data
Framed raw navigation bits
Hex[28] 28
H+16
7
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+44
8
[CR][LF]
Sentence terminator (ASCII only) -
-
-
Table 73: Data Source
ASCII Binary
Description
B1D1
0
Data is from a B1/D1 signal
B1D2
1
Data is from a B1/D2 signal
B2D1 65536 Data is from a B2/D1 signal
B2D2 65537 Data is from a B2/D2 signal
OEM7 Commands and Logs Reference Manual v10
432
Chapter 3 Logs
3.14 BESTPOS
Best position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
When positioning with GNSS, there are four parameters being solved for: latitude, longitude, height and receiver clock offset from GPS time. The quality of the solution for all four parameters depends on the geometry of where the satellites are with respect to the antenna (and receiver). The strength of the positioning geometry is indicated by Dilution of Precision (DOP) values, with lower DOP numbers indicating better geometry. Because all the GNSS satellites are above terrestrial receivers, the VDOP (vertical DOP) is the largest DOP value. This is why the reported standard deviation for height is usually larger than for latitude or longitude.
Accuracy is based on statistics and reliability is measured in percentages. When a receiver states it can measure height to one metre, this is an accuracy measure. Usually this is a one sigma value (one SD). A one sigma value for height has a reliability of 68%. In other words, the error is less than one metre 68% of the time. For a more realistic accuracy, double the one sigma value (one metre) and the result is 95% reliability (error is less than two metres 95% of the time). Generally, GNSS heights are 1.5 times poorer than horizontal positions. See also the note in the GPGST log on page 526 for CEP and RMS definitions.
This log contains the best position computed by the receiver. In addition, it reports several status indicators, including differential age, which is useful in predicting anomalous behavior brought about by outages in differential corrections. A differential age of 0 indicates that no differential correction was used.
SPAN Systems On systems with SPAN enabled, this log contains the best available combined GNSS and Inertial Navigation System (INS - if available) position (in metres) computed by the receiver.
With the system operating in an RTK mode, BESTPOS reflects the latest low-latency solution for up to 60 seconds after reception of the last base station observation. After this 60 second period, the position reverts to the best solution available and the degradation in accuracy is reflected in the standard deviation fields. If the system is not operating in RTK mode, pseudorange differential solutions continue for the time specified in the PSRDIFFTIMEOUT command (see page 289). If the receiver is SPAN enabled, the GNSS+INS combined solution is also a candidate for BESTPOS output.
OEM7 Commands and Logs Reference Manual v10
433
Chapter 3 Logs
The RTK system in the receiver provides two kinds of position solutions. The Matched RTK position is computed with buffered observations, so there is no error due to the extrapolation of base station measurements. This provides the highest accuracy solution possible at the expense of some latency which is affected primarily by the speed of the differential data link. The MATCHEDPOS log (see page 601) contains the matched RTK solution and can be generated for each processed set of base station observations. The Low-Latency RTK position is computed from the latest local observations and extrapolated base station observations. This supplies a valid RTK position with the lowest latency possible at the expense of some accuracy. The degradation in accuracy is reflected in the standard deviation and is summarized in An Introduction to GNSS available on our website. The amount of time that the base station observations are extrapolated is in the "differential age" field of the position log. The Low-Latency RTK system extrapolates for 60 seconds. The RTKPOS log (see page 754) contains the LowLatency RTK position when valid, and an "invalid" status when a Low-Latency RTK solution could not be computed. The BESTPOS log contains either the low-latency RTK, PPP or pseudorange-based position, whichever has the smallest standard deviation.
Multi-frequency GNSS receivers offer two major advantages over single-frequency equipment:
l Ionospheric errors, inherent in all GNSS observations, can be modeled and significantly reduced by combining satellite observations made on two different frequencies.
l Observations on two frequencies allow for faster ambiguity resolution times. In general, multi-frequency GNSS receivers provide a faster, more accurate and more reliable solution than single-frequency equipment. They do, however, cost significantly more and so it is important for potential GNSS buyers to carefully consider their current and future needs.
Different positioning modes have different maximum logging rates, which are also controlled by model option. The maximum rates are: 100 Hz for RTK, 100 Hz for pseudorange based positioning, 20 Hz for GLIDE (PDP) and 20 Hz for PPP.
BESTPOS always outputs positions at the antenna phase center.
Message ID: 42
Log Type: Synch
Recommended Input: log bestposa ontime 1
ASCII Example 1:
OEM7 Commands and Logs Reference Manual v10
434
Chapter 3 Logs
#BESTPOSA,COM1,0,90.5,FINESTEERING,1949,403742.000,02000000,b1f6,32768;SOL_ COMPUTED,SINGLE,51.11636937989,-114.03825348307,1064.533,16.9000,WGS84,1.3610,1.0236,2.4745,"",0.000,0.000,19,19,19,19,00,06,00,33*6e08f a22
ASCII Example 2:
#BESTPOSA,COM1,0,78.5,FINESTEERING,1419,336208.000,02000040,6145,2724;SOL_ COMPUTED,NARROW_INT,51.11635910984,-114.03833105168,1063.8416,16.2712,WGS84,0.0135,0.0084,0.0172,"AAAA",1.000,0.000,8,8,8,8,0,01,0,03*3d9fbd4 8
Field Field type
Description
1
BESTPOS header
2
sol stat
3
pos type
4
lat
5
lon
6
hgt
Log header. See Messages on page 25 for more information.
Solution status, see Table 74: Solution Status on the next page
Position type, see Table 75: Position or Velocity Type on page 437
Latitude (degrees)
Longitude (degrees)
Height above mean sea level (metres)
Undulation - the relationship between the geoid and the ellipsoid (m) of the chosen datum
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
Double 8 Double 8 Double 8
H+4
H+8 H+16 H+24
7
undulation
8
datum id#
9
lat
10
lon
11
hgt
12
stn id
13
diff_age
When using a datum other than WGS84, the undulation value also includes the vertical shift due to differences between the datum in use and WGS84.
Datum ID number (see Table 29: Datum Transformation Parameters on page 121)
Latitude standard deviation (m)
Longitude standard deviation (m)
Height standard deviation (m)
Base station ID
Differential age in seconds
Float
4
Enum 4
Float
4
Float
4
Float
4
Char[4] 4
Float
4
H+32
H+36 H+40 H+44 H+48 H+52 H+56
OEM7 Commands and Logs Reference Manual v10
435
Chapter 3 Logs
Field Field type
Description
14
sol_age
Solution age in seconds
15
#SVs
Number of satellites tracked
16
#solnSVs
Number of satellites used in solution
17
#solnL1SVs
Number of satellites with L1/E1/B1 signals used in solution
18
#solnMultiSVs
Number of satellites with multi-frequency signals used in solution
19
Reserved
20
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Galileo and
Galileo and BeiDou signals used mask (see
21
BeiDou sig
Table 77: Galileo and BeiDou Signal-Used
mask
Mask on page 440)
GPS and
GPS and GLONASS signals used mask (see
22
GLONASS sig Table 76: GPS and GLONASS Signal-Used
mask
Mask on page 439)
23
xxxx
32-bit CRC (ASCII and Binary only)
24
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Float
4
H+60
Uchar 1
H+64
Uchar 1
H+65
Uchar 1
H+66
Uchar 1
Hex
1
Hex
1
H+67 H+68 H+69
Hex
1
H+70
Hex
1
Hex
4
-
-
H+71
H+72 -
Table 74: Solution Status
Binary
ASCII
Description
0
SOL_COMPUTED Solution computed
1
INSUFFICIENT_ OBS
Insufficient observations
2
NO_ CONVERGENCE
No convergence
3
SINGULARITY Singularity at parameters matrix
4
COV_TRACE
Covariance trace exceeds maximum (trace > 1000 m)
5
TEST_DIST
Test distance exceeded (maximum of 3 rejections if distance >10 km)
6
COLD_START
Not yet converged from cold start
7
V_H_LIMIT
Height or velocity limits exceeded (in accordance with export licensing restrictions)
OEM7 Commands and Logs Reference Manual v10
436
Chapter 3 Logs
Binary
ASCII
8
VARIANCE
9
RESIDUALS
10-12 Reserved
13
INTEGRITY_ WARNING
14-17 Reserved
Variance exceeds limits Residuals are too large
Description
Large residuals make position unreliable
When a FIX position command is entered, the receiver computes its own position and determines if the fixed position is valid
18 PENDING
PENDING implies there are not enough satellites currently tracked to verify if the FIX POSITION entered into the receiver is valid. Under normal conditions, you should only see PENDING for a few seconds on power up before the GNSS receiver has locked onto its first few satellites. If your antenna is obstructed (or not plugged in) and you have entered a FIX POSITION command, then you may see PENDING indefinitely.
19 INVALID_FIX
The fixed position, entered using the FIX position command, is not valid
20 UNAUTHORIZED Position type is unauthorized
21 Reserved
22 INVALID_RATE The selected logging rate is not supported for this solution type.
Binary
ASCII
0
NONE
1
FIXEDPOS
2
FIXEDHEIGHT
3
Reserved
4
FLOATCONV
5
WIDELANE
Table 75: Position or Velocity Type Description
No solution Position has been fixed by the FIX position command or by position averaging. Position has been fixed by the FIX height or FIX auto command or by position averaging
Solution from floating point carrier phase ambiguities Solution from wide-lane ambiguities
OEM7 Commands and Logs Reference Manual v10
437
Chapter 3 Logs
Binary
ASCII
Description
6
NARROWLANE
Solution from narrow-lane ambiguities
7
Reserved
8
DOPPLER_ VELOCITY
Velocity computed using instantaneous Doppler
9-15 Reserved
16 SINGLE
Single point position
17 PSRDIFF
Pseudorange differential solution
18 WAAS
Solution calculated using corrections from an SBAS
19 PROPAGATED
Propagated by a Kalman filter without new observations
20-31 Reserved
32 L1_FLOAT
Floating L1 ambiguity solution
33 IONOFREE_FLOAT Floating ionospheric-free ambiguity solution
34 NARROW_FLOAT Floating narrow-lane ambiguity solution
35-47 Reserved
48 L1_INT
Integer L1 ambiguity solution
49 WIDE_INT
Integer wide-lane ambiguity solution
50 NARROW_INT
Integer narrow-lane ambiguity solution
51
RTK_DIRECT_INS
RTK status where the RTK filter is directly initialized from the INS filter
52 INS_SBAS
INS calculated position corrected for the antenna
53 INS_PSRSP
INS pseudorange single point solution � no DGPS corrections
54 INS_PSRDIFF
INS pseudorange differential solution
55 INS_RTKFLOAT
INS RTK floating point ambiguities solution
56 INS_RTKFIXED
INS RTK fixed ambiguities solution
57-67 Reserved
68 PPP_CONVERGING Converging TerraStar-C solution
69 PPP
Converged TerraStar-C solution
70 OPERATIONAL
Solution accuracy is within UAL operational limit
OEM7 Commands and Logs Reference Manual v10
438
Chapter 3 Logs
Binary
ASCII
71 WARNING
72 OUT_OF_BOUNDS
73
INS_PPP_ CONVERGING
74 INS_PPP
77
PPP_BASIC_ CONVERGING
78 PPP_BASIC
79
INS_PPP_BASIC _CONVERGING
80 INS_PPP_BASIC
Description Solution accuracy is outside UAL operational limit but within warning limit Solution accuracy is outside UAL limits INS NovAtel CORRECT Precise Point Positioning (PPP) solution converging INS NovAtel CORRECT PPP solution
Converging TerraStar-L solution
Converged TerraStar-L solution
INS NovAtel CORRECT PPP basic solution converging
INS NovAtel CORRECT PPP basic solution
NovAtel CORRECT� with PPP requires access to a suitable correction stream, delivered either through L-Band or the Internet. For L-Band delivered TerraStar or Veripos service, an L-Band capable receiver and software model is required, along with a subscription to the desired service. Contact NovAtel for TerraStar and Veripos subscription details.
Table 76: GPS and GLONASS SignalUsed Mask
Bit Mask
Description
0 0x01 GPS L1 used in Solution
1 0x02 GPS L2 used in Solution
2 0x04 GPS L5 used in Solution
3 0x08 Reserved
4 0x10 GLONASS L1 used in Solution
5 0x20 GLONASS L2 used in Solution
6 0x40 GLONASS L3 used in Solution
7 0x80 Reserved
OEM7 Commands and Logs Reference Manual v10
439
Chapter 3 Logs
Table 77: Galileo and BeiDou Signal-Used Mask
Bit Mask
Description
0 0x01 Galileo E1 used in Solution
1 0x02 Galileo E5A used in Solution
2 0x04 Galileo E5B used in Solution
3 0x08 Galileo ALTBOC used in Solution
4 0x10 BeiDou B1 used in Solution
5 0x20 BeiDou B2 used in Solution
6 0x40 BeiDou B3 used in Solution
7 0x80 Reserved
Table 78: Extended Solution Status
Bit Mask
Description
If an RTK solution: NovAtel CORRECT solution has been verified 0 0x01 If a PDP solution: solution is GLIDE
Otherwise: Reserved
Pseudorange Iono Correction 0 = Unknown or default Klobuchar model 1 = Klobuchar Broadcast 1-3 0x0E 2 = SBAS Broadcast 3 = Multi-frequency Computed 4 = PSRDiff Correction 5 = NovAtel Blended Iono Value
4 0x10 RTK ASSIST active
0 - No antenna warning 5 0x20 1 - Antenna information is missing
See the RTKANTENNA command on page 300
6-7 0xC0 Reserved
OEM7 Commands and Logs Reference Manual v10
440
Chapter 3 Logs
Table 79: Supplemental Position Types and NMEA Equivalents
Value Documented Enum Name NMEA Equivalent
68 PPP_CONVERGING
2
69 PPP
5
70 OPERATIONAL
4
71 WARNING
5
72 OUT_OF_BOUNDS
1
77 PPP_BASIC_CONVERGING
1
78 PPP_BASIC
2
OEM7 Commands and Logs Reference Manual v10
441
Chapter 3 Logs
3.15 BESTSATS
Satellites used in BESTPOS
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists the used and unused satellites for the corresponding BESTPOS solution. It also describes the signals of the used satellites or reasons for exclusions.
Message ID: 1194
Log Type: Synch
Recommended Input: log bestsats ontime 1
Abbreviated ASCII Example:
<BESTSATS COM1 0 57.5 FINESTEERING 1729 12132.000 02000000 95e7 11487
<
26
<
GPS 3 GOOD 00000003
<
GPS 5 GOOD 00000003
...
<
GPS 26 GOOD 00000003
<
GPS 28 GOOD 00000003
<
GLONASS 3+5 GOOD 00000003
<
GLONASS 4+6 GOOD 00000003
...
<
GLONASS 23+3 GOOD 00000003
<
GLONASS 24+2 GOOD 00000003
<
BEIDOU 6 GOOD 00000003
<
BEIDOU 9 GOOD 00000003
...
<
BEIDOU 12 GOOD 00000003
<
BEIDOU 13 GOOD 00000003
Field
Field type
Description
1
BESTSATS Log header. See Messages on page 25 for
header
more information.
2
#entries Number of records to follow
3
System
See Table 105: Satellite System on page 553
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Enum 4
H H+4
OEM7 Commands and Logs Reference Manual v10
442
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
In binary logs, the satellite ID field is 4 bytes.
The 2 lowest-order bytes, interpreted as a
USHORT, are the system identifier: for
instance, the PRN for GPS, or the slot for
GLONASS. The 2 highest-order bytes are the
frequency channel for GLONASS, interpreted
4
Satellite ID
as a SHORT and zero for all other systems. In ASCII and abbreviated ASCII logs, the
Ulong 4
satellite ID field is the system identifier. If the
system is GLONASS and the frequency channel
is not zero, then the signed channel is
appended to the system identifier. For
example, slot 13, frequency channel -2 is
output as 13-2.
H+8
5
Status
Satellite status. See Table 80: Observation Statuses below
Enum 4
H+12
See Table 81: BESTSATS GPS Signal Mask on
the next page, Table 82: BESTSATS GLONASS
6
Signal mask
Signal Mask on page 445, Table 83: BESTSATS Galileo Signal Mask on page 445
Hex
4
and Table 84: BESTSATS BeiDou Signal Mask
on page 445
H+16
7
Next satellite offset = H + 4 + (#entries x 16)
8
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+4 (#entries x 16)
9
[CR][LF] Sentence terminator (ASCII only)
-
-
-
Value
Name
0 GOOD
1 BADHEALTH
2 OLDEPHEMERIS
6 ELEVATIONERROR
7 MISCLOSURE
8 NODIFFCORR
Table 80: Observation Statuses Description
Observation is good Satellite is flagged as bad health in ephemeris or almanac Ephemeris >3 hours old Satellite was below the elevation cutoff Observation was too far from predicted value No differential correction available
OEM7 Commands and Logs Reference Manual v10
443
Chapter 3 Logs
Value
Name
9 NOEPHEMERIS
10 INVALIDIODE
11 LOCKEDOUT
12 LOWPOWER
13 OBSL2
15 UNKNOWN
16 NOIONOCORR
17 NOTUSED
18 OBSL1
19 OBSE1
20 OBSL5
21 OBSE5
22 OBSB2
23 OBSB1
24 OBSB3
25 NOSIGNALMATCH
26 SUPPLEMENTARY
99 NA
100 BAD_INTEGRITY
101 LOSSOFLOCK
102 NOAMBIGUITY
Description No ephemeris available IODE used is invalid Satellite has been locked out Satellite has low signal power An L2 observation not directly used in the solution Observation was not used because it was of an unknown type No ionosphere delay correction was available Observation was not used in the solution An L1 observation not directly used in the solution An E1 observation not directly used in the solution An L5 observation not directly used in the solution An E5 observation not directly used in the solution A B2 observation not directly used in the solution A B1 observation not directly used in the solution A B3 observation not directly used in the solution Signal type does not match Observation contributes supplemental information to the solution No observation available Observation was an outlier and was eliminated from the solution Lock was broken on this signal No RTK ambiguity type resolved
Table 81: BESTSATS GPS Signal Mask
Bit
Mask
Description
0
0x01 GPS L1 used in Solution
1
0x02 GPS L2 used in Solution
2
0x04 GPS L5 used in Solution
OEM7 Commands and Logs Reference Manual v10
444
Chapter 3 Logs
Table 82: BESTSATS GLONASS Signal Mask
Bit Mask
Description
0
0x01 GLONASS L1 used in Solution
1
0x02 GLONASS L2 used in Solution
2
0x04 GLONASS L3 used in Solution
Table 83: BESTSATS Galileo Signal Mask
Bit Mask
Description
0
0x01 Galileo E1 used in Solution
1
0x02 Galileo E5A used in Solution
2
0x04 Galileo E5B used in Solution
3
0x08 Galileo ALTBOC used in Solution
Table 84: BESTSATS BeiDou Signal Mask
Bit Mask
Description
0
0x01 BeiDou B1 used in Solution
1
0x02 BeiDou B2 used in Solution
2
0X04 BeiDou B3 used in Solution
OEM7 Commands and Logs Reference Manual v10
445
Chapter 3 Logs
3.16 BESTUTM
Best available UTM data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the best available position computed by the receiver in UTM coordinates. See also the UTMZONE command on page 402 and the BESTPOS log on page 433.
The latitude limits of the UTM System are 80�S to 84�N. If your position is outside this range, the BESTUTM log outputs a northing, easting and height of 0.0, along with a zone letter of `*'and a zone number of 0, to indicate that the data in the log is unusable.
Refer to http://earth-info.nga.mil/GandG/coordsys/grids/referencesys.html for more information and a world map of UTM zone numbers.
Message ID: 726
Log Type: Synch
Recommended Input: log bestutma ontime 1
ASCII Example: #BESTUTMA,COM1,0,73.0,FINESTEERING,1419,336209.000,02000040,eb16,2724;SOL_ COMPUTED,NARROW_INT,11,U,5666936.4417,707279.3875,1063.8401,16.2712,WGS84,0.0135,0.0084,0.0173,"AAAA",1.000,0.000,8,8,8,8,0,01,0,03*a6d0632 1
Field Field type
1
BESTUTM header
2
sol status
3
pos type
4
z#
5
zletter
Description
Format
Binary Bytes
Binary Offset
Log header. See Messages on page 25 for more information.
H
0
Solution status, see Table 74: Solution Status on page 436
Enum
4
H
Position type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+4
Longitudinal zone number
Ulong 4
H+8
Latitudinal zone letter
Ulong 4
H+12
OEM7 Commands and Logs Reference Manual v10
446
Chapter 3 Logs
Field Field type
6
northing
7
easting
8
hgt
Description
Format
Binary Bytes
Binary Offset
Northing (m) where the origin is defined as
the equator in the northern hemisphere and
as a point 10000000 metres south of the
Double 8
equator in the southern hemisphere (that is, a
`false northing' of 10000000 m)
H+16
Easting (m) where the origin is 500000 m west of the central meridian of each longitudinal zone (that is, a `false easting' of 500000 m)
Double 8
H+24
Height above mean sea level (m)
Double 8
H+32
Undulation - the relationship between the geoid and the ellipsoid (m) of the chosen datum
9
undulation
When using a datum other than WGS84, the undulation value also includes the vertical shift due to differences between the datum in use and WGS84.
Float
4
10
datum id#
Datum ID number (see Table 29: Datum Transformation Parameters on page 121)
Enum 4
11
N
Northing standard deviation (m)
Float
4
12
E
Easting standard deviation (m)
Float
4
13
hgt
Height standard deviation (m)
Float
4
14
stn id
Base station ID
Char[4] 4
15
diff_age
Differential age in seconds
Float
4
16
sol_age
Solution age in seconds
Float
4
17
#SVs
Number of satellites tracked
Uchar 1
18
#solnSVs
Number of satellite vehicles used in solution Uchar 1
19
#ggL1
Number of GPS plus GLONASS plus BDS L1/B1 used in solution
Uchar 1
20
#solnMultiSV
Number of satellites with L1/E1/B1 signals used in solution
Uchar 1
21
Reserved
Uchar 1
H+40
H+44 H+48 H+52 H+56 H+60 H+64 H+68 H+72 H+73 H+74 H+75 H+76
OEM7 Commands and Logs Reference Manual v10
447
Chapter 3 Logs
Field Field type
Description
22
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Galileo and Galileo and BeiDou signals used mask (see
23
BeiDou sig Table 77: Galileo and BeiDou Signal-Used
mask
Mask on page 440)
GPS and
GPS and GLONASS signals used mask (see
24
GLONASS sig Table 76: GPS and GLONASS Signal-Used
mask
Mask on page 439)
25
xxxx
32-bit CRC (ASCII and Binary only)
26
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Hex
1
H+77
Hex
1
H+78
Hex
1
Hex
4
-
-
H+79
H+80 -
OEM7 Commands and Logs Reference Manual v10
448
Chapter 3 Logs
3.17 BESTVEL
Best available velocity data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the best available velocity information computed by the receiver. In addition, it reports a velocity status indicator, which is needed to determine whether or not the corresponding data is valid. The velocities calculated by the receiver can have a latency associated with them. When present, the velocity time of validity is the time tag in the log minus the latency value.
The velocity is typically from the same source used in the BESTPOS solution. For example, if the BESTPOS is from the pseudorange filter, then the BESTVEL velocity type is the same as for PSRVEL. However, a specific velocity source can be chosen. See the BESTVELTYPE command on page 99.
In a BESTVEL log, the actual speed and direction of the receiver antenna over ground is provided. The receiver does not determine the direction a vessel, craft or vehicle is pointed (heading) but rather the direction of motion of the GNSS antenna relative to ground.
The RTK, PDP and PPP velocities are computed from the average change in position over the time interval between consecutive solutions. As such, they are an average velocity based on the time difference between successive position computations and not an instantaneous velocity at the BESTVEL time tag. The velocity latency to be subtracted from the time tag is normally half the time between filter updates. Under default operation, the positioning filters are updated at a rate of 2 Hz. This average velocity translates into a velocity latency of 0.25 seconds. To reduce the latency, increase the update rate of the positioning filter being used by requesting the BESTVEL or BESTPOS messages at a rate higher than 2 Hz. For example, a logging rate of 10 Hz would reduce the velocity latency to 0.05 seconds. If the velocity in the BESTVEL log comes from the pseudorange filter, it has been computed from instantaneous Doppler measurements. You know that you have an instantaneous Doppler derived velocity solution when the velocity type is PSRDIFF, WAAS or DOPPLER_VELOCITY. The instantaneous Doppler derived velocity has low latency and is not position change dependent. If you change your velocity quickly, you can see this in the DOPPLER_VELOCITY solution. Under typically seen dynamics with minimal jerk, the velocity latency is zero. Under extreme, high-jerk dynamics, the latency cannot be well represented: it will still be reported as being zero, but may be as high as 0.15 seconds. Such dynamics are typically only seen in simulated trajectories.
Message ID: 99
Log Type: Synch
Recommended Input: log bestvela ontime 1
ASCII Example:
OEM7 Commands and Logs Reference Manual v10
449
Chapter 3 Logs
#BESTVELA,COM1,0,61.0,FINESTEERING,1337,334167.000,02000000,827b,1984; SOL_COMPUTED,PSRDIFF,0.250,4.000,0.0206,227.712486,0.0493,0.0*0e68bf05
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
BESTVEL Log header. See Messages on page 25 for more header information.
H
0
2
sol status
Solution status, see Table 74: Solution Status on page 436
Enum
4
H
3
vel type
Velocity type, see Table 75: Position or Velocity Type on page 437
Enum
4
H+4
A measure of the latency in the velocity time tag
4
latency in seconds. It should be subtracted from the time Float
4
to give improved results (s)
H+8
5
age
Differential age in seconds
Float
4
H+12
6
hor spd
Horizontal speed over ground, in metres per second
Double 8
H+16
7
trk gnd
Actual direction of motion over ground (track over ground) with respect to True North, in degrees
Double
8
H+24
Vertical speed, in metres per second, where
8
vert spd
positive values indicate increasing altitude (up) and negative values indicate decreasing altitude
Double 8
(down)
H+32
9
Reserved
Float
4
H+40
10
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+44
11
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
450
Chapter 3 Logs
Velocity (speed and direction) calculations are computed from either Doppler or carrier phase measurements rather than from pseudorange measurements. Typical speed accuracies are around 0.03m/s (0.07 mph, 0.06 knots).
Direction accuracy is derived as a function of the vehicle speed. A simple approach would be to assume a worst case 0.03 m/s cross-track velocity that would yield a direction error function something like:
d (speed) = tan-1(0.03/speed)
For example, if you are flying in an airplane at a speed of 120 knots or 62 m/s, the approximate directional error will be:
tan-1 (0.03/62) = 0.03 degrees
Consider another example applicable to hiking at an average walking speed of 3 knots or 1.5 m/s. Using the same error function yields a direction error of about 1.15 degrees.
You can see from both examples that a faster vehicle speed allows for a more accurate heading indication. As the vehicle slows down, the velocity information becomes less and less accurate. If the vehicle is stopped, a GNSS receiver still outputs some kind of movement at speeds between 0 and 0.5 m/s in random and changing directions. This represents the noise and error of the static position.
In a navigation capacity, the velocity information provided by your GNSS receiver is as, or more, accurate than that indicated by conventional instruments as long as the vehicle is moving at a reasonable rate of speed. It is important to set the GNSS measurement rate fast enough to keep up with all major changes of the vehicle's speed and direction. It is important to keep in mind that although the velocity vector is quite accurate in terms of heading and speed, the actual track of the vehicle might be skewed or offset from the true track by plus or minus 0 to 1.8 metres as per the standard positional errors.
OEM7 Commands and Logs Reference Manual v10
451
Chapter 3 Logs
3.18 BESTXYZ
Best available cartesian position and velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the receiver's best available position and velocity in ECEF coordinates. The position and velocity status fields indicate whether or not the corresponding data is valid. See Figure 11: The WGS84 ECEF Coordinate System on page 454, for a definition of the ECEF coordinates.
See also the BESTPOS log on page 433 and BESTVEL log on page 449.
These quantities are always referenced to the WGS84 ellipsoid, regardless of the use of the DATUM command (see page 119) or USERDATUM command (see page 392).
Message ID: 241
Log Type: Synch
Recommended Input: log bestxyza ontime 1
ASCII Example: #BESTXYZA,COM1,0,55.0,FINESTEERING,1419,340033.000,02000040,d821,2724; SOL_COMPUTED,NARROW_INT,-1634531.5683,-3664618.0326,4942496.3270,0.0099, 0.0219,0.0115,SOL_COMPUTED,NARROW_INT,0.0011,-0.0049,-0.0001,0.0199,0.0439, 0.0230,"AAAA",0.250,1.000,0.000,12,11,11,11,0,01,0,33*e9eafeca
Field Field type
Description
1
BESTXYZ header
Log header. See Messages on page 25 for more information.
2
P-sol status
Solution status, see Table 74: Solution Status on page 436
3
pos type
Position type, see Table 75: Position or Velocity Type on page 437
4
P-X
Position X-coordinate (m)
5
P-Y
Position Y-coordinate (m)
6
P-Z
Position Z-coordinate (m)
7
P-X
Standard deviation of P-X (m)
8
P-Y
Standard deviation of P-Y (m)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
Double 8
Double 8
Double 8
Float
4
Float
4
H+4
H+8 H+16 H+24 H+32 H+36
OEM7 Commands and Logs Reference Manual v10
452
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
9
P-Z
Standard deviation of P-Z (m)
Float
4
H+40
10
V-sol status
Solution status, see Table 74: Solution Status on page 436
Enum 4
H+44
11
vel type
Velocity type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+48
12
V-X
Velocity vector along X-axis (m/s)
Double 8
H+52
13
V-Y
Velocity vector along Y-axis (m/s)
Double 8
H+60
14
V-Z
Velocity vector along Z-axis (m/s)
Double 8
H+68
15
V-X
Standard deviation of V-X (m/s)
Float
4
H+76
16
V-Y
Standard deviation of V-Y (m/s)
Float
4
H+80
17
V-Z
Standard deviation of V-Z (m/s)
Float
4
H+84
18
stn ID
Base station identification
Char[4] 4
H+88
19
V-latency
A measure of the latency in the velocity time
tag in seconds. It should be subtracted from Float
4
the time to give improved results
H+92
20
diff_age
Differential age in seconds
Float
4
H+96
21
sol_age
Solution age in seconds
Float
4
H+100
22
#SVs
Number of satellites tracked
Uchar 1
H+104
23
#solnSVs
Number of satellite vehicles used in solution Uchar 1
H+105
24
#ggL1
Number of GPS plus GLONASS plus BDS L1/B1 used in solution
Uchar 1
H+106
25
#solnMultiSVs
Number of satellites with L1/E1/B1 signals used in solution
Uchar
1
H+107
26
Reserved
Char
1
H+108
27
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Hex
1
H+109
Galileo and
Galileo and BeiDou signals used mask (see
28
BeiDou sig
Table 77: Galileo and BeiDou Signal-Used Hex
1
mask
Mask on page 440)
H+110
GPS and
GPS and GLONASS signals used mask (see
29
GLONASS sig Table 76: GPS and GLONASS Signal-Used
Hex
1
mask
Mask on page 439)
H+111
OEM7 Commands and Logs Reference Manual v10
453
Chapter 3 Logs
Field Field type
Description
30
xxxx
31
[CR][LF]
32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Hex
4
H+112
-
-
-
Figure 11: The WGS84 ECEF Coordinate System
Table 85: Definitions Origin = Earth's center of mass Z-Axis = Parallel to the direction of the Conventional Terrestrial Pole (CTP) for polar motion, as
defined by the Bureau International de l'Heure (BIH) on the basis of the coordinates adopted for the BIH stations. X-Axis = Intersection of the WGS 84 Reference Meridian Plane and the plane of the CTP's Equator, the Reference Meridian being parallel to the Zero Meridian defined by the BIH on the basis of the coordinates adopted for the BIH stations. Y-Axis = Completes a right-handed, earth-centered, earth-fixed (ECEF) orthogonal coordinate system, measured in the plane of the CTP Equator, 90� East of the X-Axis.
These definitions are analogous to the BIH Defined Conventional Terrestrial System (CTS), or BTS, 1984.0.
OEM7 Commands and Logs Reference Manual v10
454
Chapter 3 Logs
3.19 BSLNXYZ
RTK XYZ baseline
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the receiver's RTK baseline in ECEF coordinates. The position status field indicates whether or not the corresponding data is valid. See Figure 11: The WGS84 ECEF Coordinate System on the previous page for a definition of the ECEF coordinates.
The BSLNXYZ log comes from time-matched base and rover observations such as in the MATCHEDXYZ log on page 606.
Asynchronous logs, such as BSLNXYZ, should only be logged ONCHANGED. Otherwise, the most current data is not output when it is available. This is especially true of the ONTIME trigger, which may cause inaccurate time tags to result.
Message ID: 686
Log Type: Asynch
Recommended Input: log bslnxyza onchanged
ASCII Example: #BSLNXYZA,COM1,0,59.5,FINESTEERING,1419,340033.000,02000040,5b48,2724;SOL_ COMPUTED,NARROW_INT,0.0012,0.0002,0.0004,0.0080,0.0160,0.0153,"AAAA",12,12,12,12,0,01,0,33*1a8a1b65
Field Field type
Data Description
1
BSLNXYZ header
2
sol status
3
bsln type
4
B-X
5
B-Y
6
B-Z
7
B-X
8
B-Y
Log header. See Messages on page 25 for more information.
Solution status, see Table 74: Solution Status on page 436
Baseline type, see Table 75: Position or Velocity Type on page 437
X-axis offset (m)
Y-axis offset (m)
Z-axis offset (m)
Standard deviation of B-X (m)
Standard deviation of B-Y (m)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
Double 8
Double 8
Double 8
Float
4
Float
4
H+4
H+8 H+16 H+24 H+32 H+36
OEM7 Commands and Logs Reference Manual v10
455
Chapter 3 Logs
Field Field type
Data Description
Format
Binary Bytes
Binary Offset
9
B-Z
Standard deviation of B-Z (m)
Float
4
H+40
10
stn ID
Base station identification
Char[4] 4
H+44
11
#SVs
Number of satellites tracked
Uchar 1
H+48
12
#solnSVs
Number of satellite vehicles used in solution Uchar 1
H+49
13
#ggL1
Number of GPS plus GLONASS plus BDS L1/B1 used in solution
Uchar 1
H+50
14
#solnMultiSVs
Number of satellites with L1/E1/B1 signals used in solution
Uchar
1
H+51
15
Reserved
Uchar 1
H+52
16
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Hex
1
H+53
Galileo and
Galileo and BeiDou signals used mask (see
17
BeiDou sig
Table 77: Galileo and BeiDou Signal-Used Hex
1
mask
Mask on page 440)
H+54
GPS and
GPS and GLONASS signals used mask (see
18
GLONASS sig Table 76: GPS and GLONASS Signal-Used
Hex
1
mask
Mask on page 439)
H+55
19
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+56
20
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
456
Chapter 3 Logs
3.20 CHANCONFIGLIST
Channel configuration list
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides the channel configuration list including the number of channels and signal types. If more than one channel configuration is available, then it can be switched using the SELECTCHANCONFIG command (see page 329).
Message ID: 1148
Log Type: Polled
Recommended Input:
log chanconfiglista once
Abbreviated ASCII Example:
CHANCONFIGLIST COM1 2 73.5 FINESTEERING 1783 585128.718 02000040 d1c0 12793 44 6 12 GPSL1L2PL5 2 QZSSL1CAL2CL5 2 SBASL1 10 GLOL1L2 9 GALE1E5AE5BALTBOC 10 BEIDOUB1B2 6 10 GPSL1L2PL2CL5 2 QZSSL1CAL2CL5 2 SBASL1 8 GLOL1L2PL2C 8 GALE1E5AE5BALTBOC 8 BEIDOUB1B2 6 12 GPSL1L2PL5 2 QZSSL1CAL2CL5 2 SBASL1L5 10 GLOL1L2 9 GALE1E5AE5BALTBOC 9 BEIDOUB1B2 6 9 GPSL1L2PL2CL5 2 QZSSL1CAL2CL5 2 SBASL1L5 8 GLOL1L2PL2C 8 GALE1E5AE5BALTBOC 9 BEIDOUB1B2
OEM7 Commands and Logs Reference Manual v10
457
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
CHANCONFIGLIST Log header. See Messages on page 25
header
for more information.
H
0
2
SetInUse
Current channel configuration being
used. For example, if SetInUse is 2 then
the second channel configuration listed Ulong 4
H
in this log is the current channel
configuration
3
#chanconfigs
Number of channel configurations to follow
Ulong 4
H+4
4
#signaltypes
Total number of signal types in this channel configuration
Ulong 4
H+8
5
NumChans
Number of channels for individual signal type
Ulong
4
H+12
6
SignalType
See Table 86: CHANCONFIGLIST Signal Type below
Ulong
4
H+16
7
Next chanconfig offset = H + 8+ (#chanconfigs * (4 + (#signaltypes * 8)))
8
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
variable
9
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
Table 86: CHANCONFIGLIST Signal Type
Value
Name
Description
0 GPSL1
GPS L1 C/A signal
1 GPSL1L2
GPS L1 C/A and L2P(Y) signal
4 SBASL1
SBAS L1 C/A signal
5 GPSL5
GPS L5 signal
6 GPSL1L2C
GPS L1 C/A and L2C signal
7 GPSL1L2AUTO
GPS L1 C/A and L2 P(Y) or L2C signal
8 GLOL1L2
GLONASS L1 C/A and L2P signal
9 LBAND
L-Band signal
10 GLOL1
GLONASS L1 C/A signal
11 GALE1
Galileo E1 signal
12 GALE5A
Galileo E5a signal
OEM7 Commands and Logs Reference Manual v10
458
Chapter 3 Logs
Value
Name
Description
13 GALE5B
Galileo E5b signal
14 GALALTBOC
Galileo E5 AltBOC signal
15 BEIDOUB1
BeiDou B1 signal
16 GPSL1L2PL2C
GPS L1 C/A, L2 P(Y), and L2C signal
17 GPSL1L5
GPS L1 C/A and L5 signal
18 SBASL1L5
SBAS L1 C/A and L5 signal
19 GPSL1L2PL2CL5
GPS L1 C/A, L2 P(Y), L2C, and L5 signal
20 GPSL1L2PL5
GPS L1 C/A, L2 P(Y), and L5 signal
21 GALE1E5AE5B
Galileo E1, E5a, and E5b signal
22 GALE1E5AE5BALTBOC Galileo E1, E5a, E5b, and E5 AltBOC signal
23 GALE1E5A
Galileo E1 and E5a signal
24 GLOL1L2C
GLONASS L1 C/A and L2C signal
25 GLOL1L2PL2C
GLONASS L1 C/A, L2 P, and L2C signal
26 QZSSL1CA
QZSS L1 C/A signal
27 QZSSL1CAL2C
QZSS L1 C/A and L2C signal
28 QZSSL1CAL2CL5
QZSS L1 C/A, L2C, and L5 signal
29 QZSSL1CAL5
QZSS L1 C/A and L5 signal
30 BEIDOUB1B2
BeiDou B1 and B2I/B2a signal
31 GALE1E5B
Galileo E1 and E5b signal
32 BEIDOUB1B3
BeidDou B1, B3
33 BEIDOUB3
BeiDou B3
34 BEIDOUB1B2B3
BeiDou B1, B2I/B2a and B3 signal
35 GALE1E5AE5BALTBOCE6 Galileo E1, E5A, E5B, AltBOC, E6
36 GPSL1L2PL2CL5L1C
GPS L1CA, L2P, L2C, L5, L1C
37 QZSSL1CAL2CL5L1C
QZSS L1CA, L2C, L5, L1C
38 QZSSL1CAL2CL5L1CL6 QZSS L1CA, L2C, L5, L1C, L6
39 GLOL1L3
GLONASS L1CA, L3
40 GLOL3
GLONASS L3
OEM7 Commands and Logs Reference Manual v10
459
Chapter 3 Logs
Value
Name
41 GLOL1L2PL2CL3
42 GPSL1L2PL2CL1C
43 QZSSL1CAL2CL1C
44 NAVICL5
45 BEIDOUB1C
46 BEIDOUB1B1C
47 BEIDOUB1B1CB2B3
48 BEIDOUB1B1CB2
Description GLONASS L1CA, L2P, L2CA, L3 GPS L1CA, L2P, L2C, L1C QZSS L1CA, L2C, L1C NavIC L5 BeiDou B1C BeiDou B1I, B1C BeiDou B1I, B1C, B2I/B2a, B3 BeiDou B1I, B1C, B2I/B2a
Configurations with BeiDou B2 will automatically track either the B2I or B2a signal provided that the receiver RF supports both frequencies. Phase 2 BDS satellites transmit B2I but not B2a, while phase 3 satellites transmit B2a but not B2I.
OEM7 Commands and Logs Reference Manual v10
460
Chapter 3 Logs
3.21 CLOCKMODEL
Current clock model status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The CLOCKMODEL log contains a filtered representation of the receiver's clock bias relative to GPS system time.
Message ID: 16
Log Type: Synch
Recommended Input: log clockmodela ontime 1
ASCII Example: #CLOCKMODELA,USB1,0,76.5,FINESTEERING,2032,240222.000,02000020,98f9,32768; VALID,0,240222.000,240222.000,-9.477561087e-02,-4.830560778e-02,0.000000000, 4.862723266e-02,1.117247043e-03,0.000000000,1.117247043e-03,4.002808929e-03, 0.000000000,0.000000000,0.000000000,0.000000000,-0.030,-5.532940561e-02,FALSE *71e347cc
The CLOCKMODEL log can be used to monitor the clock drift of an internal oscillator once the CLOCKADJUST mode has been disabled. Watch the CLOCKMODEL log to see the drift rate and adjust the oscillator until the drift stops.
Field Field type
1
CLOCKMODEL header
2
status
3
reject_count
4
propagation_ time
5
update_time
6
bias
7
rate
8
Reserved
Description
Log header. See Messages on page 25 for more information.
Clock model status. See Table 87: Clock Model Status on the next page
Number of rejected instantaneous clock errors
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Ulong 4
H+4
Time of last propagation
GPSec 4
H+8
Time of last update Receiver clock bias (metres) Receiver clock bias rate (metres)
GPSec 4 Double 8 Double 8 Double 8
H+12 H+16 H+24 H+32
OEM7 Commands and Logs Reference Manual v10
461
Chapter 3 Logs
Field Field type
Description
9
bias_variance Receiver clock bias variance (metres2)
Format
Binary Bytes
Binary Offset
Double 8
H+40
10
covariance
Receiver clock bias/bias rate covariance (metres2/second)
Double 8
H+48
11
Reserved
Double 8
H+56
12
Reserved
Double 8
H+64
13
rate_variance
Receiver clock bias rate variance (metres2/second2)
Double 8
H+72
14
Reserved
Double 8
H+80
15
Reserved
Double 8
H+88
16
Reserved
Double 8
H+96
17
Reserved
Double 8
H+104
18
instantaneous_ Last instantaneous receiver clock bias
bias
(metres)
Double 8
H+112
19
instantaneous_ rate
Last instantaneous receiver clock bias rate (metre/second)
Double
8
H+120
20
Reserved
Bool
4
H+128
21
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+132
22
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
Table 87: Clock Model Status
Clock Status (Binary) Clock Status (ASCII)
Description
0
VALID
The clock model is valid
1
CONVERGING
The clock model is near validity
2
ITERATING
The clock model is iterating towards validity
3
INVALID
The clock model is not valid
OEM7 Commands and Logs Reference Manual v10
462
Chapter 3 Logs
3.22 CLOCKSTEERING
Clock steering status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The CLOCKSTEERING log is used to monitor the current state of the clock steering process. All oscillators have some inherent drift. By default the receiver attempts to steer the receiver clock to accurately match GPS reference time. If for some reason this is not desired, this behavior can be disabled using the CLOCKADJUST command (see page 105).
If the CLOCKADJUST command (see page 105) is ENABLED and the receiver is configured to use an external reference frequency (set in the EXTERNALCLOCK command (see page 151)), then the clock steering process takes over the VARF output pins and may conflict with a previously entered FREQUENCYOUT command (see page 176).
Message ID: 26
Log Type: Asynch
Recommended Input: log clocksteeringa onchanged
ASCII Example: #CLOCKSTEERINGA,COM1,0,56.5,FINESTEERING,1337,394857.051,02000000,0f61,1984; INTERNAL,SECOND_ORDER,4400,1707.554687500,0.029999999,-2.000000000,-0.224, 0.060*0e218bbc
To configure the receiver to use an external reference oscillator, see the EXTERNALCLOCK command on page 151.
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
CLOCKSTEERING Log header. See Messages on page 25 for
header
more information.
H
0
2
source
Clock source, see Table 88: Clock Source on the next page
Enum
4
H
3
steering state
Steering state, see Table 89: Steering State on page 465
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
463
Chapter 3 Logs
Field
Field type
4
period
5
pulse width
6
bandwidth
7
slope
8
offset
9
drift rate
10
xxxx
11
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Period of the FREQUENCYOUT signal used
to control the oscillator, refer to the
FREQUENCYOUT command on page 176. This value is set using the
Ulong
4
CLOCKCALIBRATE command (see page
107)
H+8
Current pulse width of the
FREQUENCYOUT signal. The starting point
for this value is set using the
CLOCKCALIBRATE command (see page 107). The clock steering loop continuously
Double
8
adjusts this value in an attempt to drive
the receiver clock offset and drift terms to
zero
H+12
The current band width of the clock
steering tracking loop in Hz. This value is set using the CLOCKCALIBRATE
Double
8
command (see page 107)
H+20
The current clock drift change in m/s/bit
for a 1 LSB pulse width. This value is set using the CLOCKCALIBRATE command
Float
4
(see page 107)
H+28
The last valid receiver clock offset computed (m). It is the same as Field # Double 8 18 of the CLOCKMODEL log on page 461
H+32
The last valid receiver clock drift rate received (m/s). It is the same as Field # 19 of the CLOCKMODEL log (see page 461)
Double 8
H+40
32-bit CRC (ASCII and Binary only)
Hex
4
H+48
Sentence terminator (ASCII only)
-
-
-
Table 88: Clock Source
Binary ASCII
Description
0
INTERNAL
The receiver is currently steering its internal VCTCXO using an internal VARF signal
1
EXTERNAL
The receiver is currently steering an external oscillator using the external VARF signal
OEM7 Commands and Logs Reference Manual v10
464
Chapter 3 Logs
Table 89: Steering State
Binary
ASCII
Description
0
FIRST_ ORDER
Upon start-up, the clock steering task adjusts the VARF pulse width to reduce the receiver clock drift rate to below 1 ms using a 1st order control loop. This is the normal start-up state of the clock steering loop.
1
SECOND_ ORDER
Once the receiver has reduced the clock drift to below 1 m/s, it enters a second order control loop and attempts to reduce the receiver clock offset to zero. This is the normal runtime state of the clock steering process.
This state corresponds to when the calibration process is measuring at the "High" pulse width setting.
The CALIBRATE_HIGH state is only seen if you force the receiver to do a
2
CALIBRATE_ clock steering calibration using the CLOCKCALIBRATE command (see
HIGH
page 107). With the CLOCKCALIBRATE command (see page 107), you
can force the receiver to calibrate the slope and center pulse width of the
currently selected oscillator, to steer. The receiver measures the drift rate
at several "High" and "Low" pulse width settings.
This state corresponds to when the calibration process is measuring at the "Low" pulse width setting.
The CALIBRATE_LOW state is only seen if you force the receiver to do a
3
CALIBRATE_ clock steering calibration using the CLOCKCALIBRATE command (see
LOW
page 107). With the CLOCKCALIBRATE command (see page 107), you
can force the receiver to calibrate the slope and center pulse width of the
currently selected oscillator, to steer. The receiver measures the drift rate
at several "High" and "Low" pulse width settings.
This state corresponds to the "Center" calibration process. Once the center
has been found, the modulus pulse width, center pulse width, loop
bandwidth and measured slope values are saved in NVM and are used from
4
CALIBRATE_ now on for the currently selected oscillator (INTERNAL or EXTERNAL). CENTER
After the receiver has measured the "High" and "Low" pulse width setting,
the calibration process enters a "Center calibration" process where it
attempts to find the pulse width required to zero the clock drift rate.
OEM7 Commands and Logs Reference Manual v10
465
Chapter 3 Logs
3.23 DUALANTENNAHEADING
Synchronous heading information for dual antenna product
Platform: OEM7720, PwrPak7D, PwrPak7D-E1, PwrPak7D-E2, SPAN CPT7 The heading is the angle from True North of the primary antenna to secondary antenna vector in a clockwise direction.
You must have an ALIGN capable, dual antenna receiver to use this log.
Message ID: 2042
Log Type: Synch
Recommended Input: log dualantennaheadinga ontime 1
ASCII Example: #DUALANTENNAHEADINGA,UNKNOWN,0,66.5,FINESTEERING,1949,575614.000,02000000,d426, 32768;SOL_COMPUTED,NARROW_INT,1.000000000,255.538528442,0.006041416,0.0,0.043859947,0.052394450,"J56X",24,18, 18,17,04,01,00,33*1f082ec5
Field Field type
Description
Binary Binary Binary Format Bytes Offset
1
DUALANTENNA HEADING header
Log header. See Messages on page 25 for more information.
-
H
0
2
sol stat
Solution status, see Table 74: Solution Status on page 436
Enum 4
H
3
pos type
Position type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+4
4
length
Baseline length in metres
For ALIGN Heading models, this field is -1.
For ALIGN Relative Positioning models with
a fixed position, this field is -1.
Float
4
For ALIGN Relative Positioning models, this field is the baseline length in metres, unless the position is fixed.
H+8
5
heading
Heading in degrees (0� to 359.999�)
Float
4
H+12
6
pitch
Pitch (�90 degrees)
Float
4
H+16
OEM7 Commands and Logs Reference Manual v10
466
Chapter 3 Logs
Field Field type
7
Reserved
8
hdg std dev
9
ptch std dev
10
stn ID
11
#SVs
12
#solnSVs
13
#obs
14
#multi
15
sol source
16
ext sol stat
Galileo and
17
BeiDou sig
mask
GPS and
18
GLONASS sig
mask
19
xxxx
20
[CR][LF]
Description
Heading standard deviation in degrees Pitch standard deviation in degrees Station ID string Number of satellites tracked Number of satellites in solution Number of satellites above the elevation mask angle Number of satellites above the mask angle with L2 Solution source (see Table 104: Solution Source on page 549) Extended solution status (see Table 78: Extended Solution Status on page 440) Galileo and BeiDou signals used mask (see Table 77: Galileo and BeiDou Signal-Used Mask on page 440) GPS and GLONASS signals used mask (see Table 76: GPS and GLONASS Signal-Used Mask on page 439) 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Binary Binary Binary Format Bytes Offset
Float
4
H+20
Float
4
H+24
Float
4
H+28
Char[4] 4
H+32
Uchar 1
H+36
Uchar 1
H+37
Uchar 1
H+38
Uchar 1
H+39
Hex
1
H+40
Hex
1
H+41
Hex
1
H+42
Hex
1
Hex
4
-
-
H+43
H+44 -
OEM7 Commands and Logs Reference Manual v10
467
Chapter 3 Logs
3.24 ETHSTATUS
Current Ethernet status
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This log provides the current status of the Ethernet ports.
Message ID: 1288
Log Type: Polled
Recommended Input: log ethstatusa once
ASCII Example: #ETHSTATUSA,COM1,0,89.5,FINESTEERING,1609,500138.174,02000000,e89d,6259;1,ETHA, "00-21-66-00-05-A2",100_FULL*98d86b04
Field Field Type
1
ETHSTATUS header
Description
Log header. See Messages on page 25 for more information.
Format
Binary Bytes
-
H
Binary Offset
0
2
#of interfaces
Number of records to follow
Ulong 4
H
3
interface
Name of the Ethernet interface (e.g., ETHA)
Enum
4
H+4
4
MAC address
An identifier assigned to the network adapters or network interface card
String [18]
variable
a
H+8
5
interface configuration
Current connectivity, speed and duplex settings of the Ethernet interface
Enum
4
H+26
6... Next interface = H+4+(# of interfaces * 26)
7
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+4+(# of interfaces * 26)
8
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
Refer to the ETHCONFIG command (see page 144) for enum values.
aIn the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
468
Chapter 3 Logs
3.25 FILELIST
Display the storage media contents
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this log to display the root directory of the active media. A log is produced for each file and directory in the root directory. The active media is set with the FILEMEDIACONFIG command on page 159.
Message ID: 2100
Log Type: Asynch
Recommended Input: log filelista
ASCII Example: #FILELISTA,COM1,0,95.0,UNKNOWN,0,77428.011,024c4009,e8c9,32768;USBSTICK,0,20161 117,104430,"blah.txt"*a212a600 #FILELISTA,COM1,1,94.5,UNKNOWN,0,77428.011,024c4009,e8c9,32768;USBSTICK,0,19700 101,0,"BMHR15470145U_1930_501232.LOG"*d12f9c46
Field
Field Type
Description
1
FILELIST header
Log header. See Messages on page 25 for more information.
Mass Storage Device
2
MassStorageDevice See Table 91: Mass Storage Device
on page 472
3
FileType
The type of entry for this log. See Table 90: File Type on the next page
4
FileSize
File Size (in Bytes)
5
ChangeDate
Date of the last change
6
ChangeTime
Time of last change
7
FileName
Name of the file or directory File Name STRING Variable H + 20
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
Ulong 4 Ulong 4 Ulong 4
H+8 H+12 H+16
String Variable H+20
Hex
4
-
-
Variable -
OEM7 Commands and Logs Reference Manual v10
469
Chapter 3 Logs
Table 90: File Type
Binary ASCII
Description
0
NONE Indicates there are no entries in the selected media
1
FILE File
2
DIR Directory
When there no files or directories on the specified media, a single FILELIST log is output with FileType set to NONE and file information set to 0 and empty strings.
OEM7 Commands and Logs Reference Manual v10
470
Chapter 3 Logs
3.26 FILESTATUS
Displays the state of the data log file
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this log to display the current state of the data log file. Typically the FILESTATUS log is used to determine if the log file is open for writing or closed. However, it also shows any error that has occurred.
Message ID: 2127
Log Type: Asynch
Recommended Input: log filestatusa
ASCII Example #FILESTATUSA,USB3,0,75.0,FINESTEERING,1983,171080.615,02104020,4dbd,14434;INTER NAL_FLASH,CLOSED,"",0,14039057,15754462,""*7de99c77
Field
Field Type
1
FILESTATUS Header
2
MassStorageDevice
3
FileStatus
Description
Log header. See Messages on page 25 for more information.
The type of recording device
See Table 91: Mass Storage Device on the next page.
File status
See Table 92: File Status on the next page.
4
FileName
Filename of the log file
5
FileSize
File Size (bytes)
6
MediaRemainingCapacity
Remaining capacity on the storage media (kb)
7
MediaTotalCapacity
Total capacity of the storage media (kb)
Format
Binary Bytes
-
H
Enum 4
Enum 4
Fixed UCHAR Array
Ulong
MAX_ FILENAME_ LENGTH (MFL)
4
Ulong 4
Ulong 4
Binary Offset 0
H
H+4
H+8 H+MFL+8 H+MFL+12 H+MFL+16
OEM7 Commands and Logs Reference Manual v10
471
Chapter 3 Logs
Field
Field Type
8
ErrorMsg
9
xxxx
10
[CR][LF]
Description
Error Message 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
String Variable
Hex
4
-
-
Table 91: Mass Storage Device
Binary
ASCII
Description
1
USBSTICK
USB mass storage device
2
RAMDRIVE
-
3
NO_STORAGE
No mass storage
4
INTERNAL_FLASH Internal eMMC flash
Table 92: File Status
Binary ASCII
Description
0
OPEN
Log file is open
1
CLOSED Log file is closed
3
ERROR An error has occurred
5
PENDING Operation during initialization state
Binary Offset H+MFL+20
Variable
-
OEM7 Commands and Logs Reference Manual v10
472
Chapter 3 Logs
3.27 FILESYSTEMCAPACITY
Displays storage capacity available
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this log to check the amount of storage capacity available in both the internal and external storage.
Message ID: 2137
Log Type: Polled
Recommended Input: log filesystemcapacity
Abbreviated ASCII Example:
<FILESYSTEMCAPACITY COM1 0 92.0 UNKNOWN 0 2736.008 0244c009 fded 32768
<
2
<
USBSTICK 31546671104 688128
<
INTERNAL_FLASH 14735147008 12288
ASCII Example:
#FILESYSTEMCAPACITYA,COM1,0,92.0,UNKNOWN,0,2767.008,0244c009,fded,32768;2,USBST ICK,31546671104,688128,INTERNAL_FLASH,14735147008,12288*8a8d384b
The INTERNAL_FLASH is only present on the PwrPak7.
Field
Field Type
Description
1
FILESYSTEMCAPACITY Log header. See Messages on
header
page 25 for more information.
2
#Dev
Number of device with data to follow
File system type (recording
device)
3
MassStorageDevice
See Table 91: Mass Storage
Device on the previous page
4
TotalStorage
Total storage on device in bytes
5
UsedStorage
Amount of storage used on the device in bytes
6
Next device offset = H+4+(#Dev x 20)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Enum 4
Ulong 8 Ulong 8
H+4
H+8 H+16
OEM7 Commands and Logs Reference Manual v10
473
Chapter 3 Logs
Field
Field Type
7
xxxx
8
[CR][LF]
Description
Format
Binary Bytes
32-bit CRC (ASCII and Binary only)
Hex
4
Sentence terminator (ASCII only) -
-
Binary Offset
H+4+ (#Dev x 20)
-
OEM7 Commands and Logs Reference Manual v10
474
Chapter 3 Logs
3.28 FILESYSTEMSTATUS
Display state of recording media
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log displays the current state of the recording media. It can be used to determine the state of the file system, such as any mounting errors.
When logging the FILESYSTEMSTATUS log, use the ONNEW or ONCHANGED log trigger.
Message ID: 2104
Log Type: Asynch
Recommended Input: log filesystemstatusa onchanged
Abbreviated ASCII Example:
<FILESYSTEMSTATUS COM1 1 91.5 UNKNOWN 0 5.387 02000020 143c 32768
<
USBSTICK MOUNTED 3862430 ""
<FILESYSTEMSTATUS COM1 0 91.5 COARSESTEERING 1953 153609.680 02000020 143c
32768
<
INTERNAL_FLASH MOUNTED 14756709 ""
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
FILESYSTEMSTATUS Log header. See Messages on
header
page 25 for more information.
-
H
0
Recording Device
2
MassStorageDevice See Table 91: Mass Storage Device Enum 4
H
on page 472
Media Status
3
MassStorageStatus See Table 93: Mass Storage Status Enum 4
on the next page
H+4
4
TotalCapacity
Media total capacity (in kB)
Ulong 4
H+8
5
ErrorMsg
Error Message
String Variable H+12
6
xxxx
32-bit CRC (ASCII and Binary only) Hex
4
Variable
7
[CR][LF]
Sentence Terminator (ASCII only) -
-
-
OEM7 Commands and Logs Reference Manual v10
475
Chapter 3 Logs
Table 93: Mass Storage Status
Binary
ASCII
Description
0
UNMOUNTED Mass storage unmounted
1
MOUNTED
Mass storage mounted
2
BUSY
Mass storage busy. i.e. formatting
3
ERROR
Mounting error
4
MOUNTING
Mass storage is being mounted
5
UNMOUNTING Mass storage is being unmounted
OEM7 Commands and Logs Reference Manual v10
476
Chapter 3 Logs
3.29 FILETRANSFERSTATUS
Display the current state of a file transfer
Platform: PwrPak7 This log contains the current state of a file transfer from the internal memory to a USB stick. This logs also indicates any file transfer errors that may have occurred.
Message ID: 2101
Log Type: Asynch
Recommended Input: log filetransferstatusa onchanged
ASCII Example: <FILETRANSFERSTATUS COM1 0 38.0 FINESTEERING 1953 248960.848 02440020 ce81 32768 TRANSFERRING 0 4096035 "NPP714520001W_2017-06-10_01-16-20.LOG" "" <FILETRANSFERSTATUS COM1 0 88.5 FINESTEERING 1953 248961.853 02000020 ce81 32768 TRANSFERRING 1138 4096035 "NPP714520001W_2017-06-10_01-16-20.LOG" "" <FILETRANSFERSTATUS COM1 0 17.5 FINESTEERING 1953 248962.853 02000020 ce81 32768 TRANSFERRING 2277 4096035 "NPP714520001W_2017-06-10_01-16-20.LOG" "" ...
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
FILETRANSFERSTATUS Log header. See Messages on
header
page 25 for more information.
-
H
0
The status of the file transfer. See
2
File Transfer Status
Table 94: File Transfer Status on Enum 4
H
the next page.
3
Total Transferred
Total amount of data transferred. (kbytes)
Ulong
4
H+4
4
Total Transfer Size
Total size of the data to transfer. (kbytes)
Ulong
4
H+8
5
Filename
Name of the file that is currently transferring.
String
Variable H+12
6
Error Msg
Error message (if an error occurred)
String Variable Variable
7
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
Variable
8
[CR][LF]
Sentence terminator (ASCII only) -
-
-
OEM7 Commands and Logs Reference Manual v10
477
Chapter 3 Logs
Table 94: File Transfer Status
Binary Value ASCII Value
Description
1
NONE
There is no file transfer in progress
2
TRANSFERRING There is an active file transfer
3
FINISHED
The transfer has been successfully completed
4
ERROR
An error occurred during the transfer
5
CANCELLED
A user cancelled the active file transfer
OEM7 Commands and Logs Reference Manual v10
478
Chapter 3 Logs
3.30 GALALMANAC
Decoded Galileo Almanac
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the decoded Galileo almanac parameters from Galileo navigation messages. Multiple messages are transmitted, one for each satellite ID with data. The OEM7 family of receivers automatically save almanacs in their Non-Volatile Memory (NVM), so creating an almanac boot file is not necessary.
Message ID: 1120
Log Type: Asynch
Recommended Input: log galalmanaca onchanged
ASCII Example: #GALALMANACA,COM1,3,83.5,SATTIME,1769,333371.000,02000020,131f,45362; 19,FALSE,TRUE,0,0,0,0,10,745,332400.000,1.221e-04,-5.486e-09, 2.757e+00,2.038e+00,-1.226e+00,-1.1444e-05,0.000,2.539e-02,-1.457e-02 *5c77f44b
#GALALMANACA,COM1,2,83.5,SATTIME,1769,333399.000,02000020,131f,45362; 20,FALSE,TRUE,0,0,0,0,10,745,332400.000,1.831e-04,-5.486e-09, 2.757e+00,1.542e+00,-3.1734e-02,4.8084e-03,9.495e-10,2.539e-02, -1.457e-02*3530e391
#GALALMANACA,COM1,1,83.5,SATTIME,1769,333939.000,02000020,131f,45362; 11,FALSE,TRUE,0,0,0,0,11,745,333000.000,6.104e-05,-5.120e-09, 6.6412e-01,2.396e+00,-1.032e+00,5.1498e-05,1.091e-11,3.125e-02, -1.764e-02*afa0f631
#GALALMANACA,COM1,0,83.5,SATTIME,1769,333941.000,02000020,131f,45362; 12,FALSE,TRUE,0,0,0,0,11,745,333000.000,1.526e-04,-5.120e-09, 6.6412e-01,-2.392e+00,-1.818e+00,6.4850e-05,1.091e-11,3.516e-02, -1.764e-02*ef41e1b2
The speed at which the receiver locates and locks onto new satellites is improved if the receiver has approximate time and position, as well as an almanac. This allows the receiver to compute the elevation of each satellite so it can tell which satellites are visible and their Doppler offsets, improving Time to First Fix (TTFF).
Field Field Type
Description
1
GALALMANAC Log header. See Messages on page 25 for
header
more information.
Format
Binary Bytes
Binary Offset
H
0
OEM7 Commands and Logs Reference Manual v10
479
Chapter 3 Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
2
SatId
Satellite ID
Ulong 4
H
3
FNAVReceived Indicates FNAV almanac data received
Bool
4
H+4
4
INAVReceived Indicates INAV almanac data received
Bool
4
H+8
5
E1BHealth
E1B health status bits (only valid if INAVReceived is TRUE)
Uchar 1
H+12
6
E5aHealth
E5a health status bits (only valid if FNAVReceived is TRUE)
Uchar 1
H+13
7
E5bHealth
E5b health status bits (only valid if INAVReceived is TRUE)
Uchar 1
H+14
8
Reserved
Uchar 1
H+15
9
IODa
Almanac issue of data
Ulong 4
H+16
10
Weeks
Almanac reference week
Ulong 4
H+20
11
Seconds
Almanac reference time of week (seconds for ASCII, milliseconds for binary)
GPSec 4
H+24
12
Ecc
Eccentricity (dimensionless)
Double 8
H+28
13
OmegaDot
Rate of right ascension (radians/second)
Double 8
H+36
14
Omega0
Right ascension (radians)
Double 8
H+44
15
Omega
Argument of perigee (radians)
Double 8
H+52
16
M0
Mean anomaly at ref time (radians)
Double 8
H+60
17
Af0
Satellite clock correction bias (seconds)
Double 8
H+68
18
Af1
Satellite clock correction linear (seconds/second)
Double 8
H+76
19
DeltaRootA
Difference with respect to the square root of the nominal semi-major axis (sqrt(metres))
Double
8
H+84
20
DeltaI
Inclination at reference time relative to I0 = 56 deg
Double
8
H+92
21
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+100
22
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
480
Chapter 3 Logs
3.31 GALCLOCK
Galileo clock information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the Galileo time information.
This log is populated from both the INAV and FNAV messages. Depending on the data source, it is possible that the time in the header of the log is earlier than the time in a previous log. This is expected behavior.
Message ID: 1121
Log Type: Asynch
Recommended Input: log galclocka onchanged
ASCII Example: #GALCLOCKA,COM1,0,84.5,SATTIME,1769,336845.000,02000020,c6cf,45362; 8.381903172e-09,-3.5527137e-15,16,259200,233,28,7,16,-3.5216e-09, -1.776e-14,345600,41*186e9085
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
GALCLOCK Log header. See Messages on page 25 for more
header
information.
H
0
2
A0
Constant term of polynomial
Double 8
H
3
A1
1st order term of polynomial
Double 8
H+8
4
DeltaTls
Leap second count before leap second adjustment
Long
4
H+16
5
Tot
UTC data reference time of week (seconds)
Ulong 4
H+20
6
WNt
UTC data reference week number
Ulong 4
H+24
7
WNlsf
Week number of leap second adjustment
Ulong 4
H+28
8
DN
Day number at the end of which a leap second adjustment becomes effective
Ulong
4
H+32
9
DeltaTlsf Leap second count after leap second adjustment Long
4
H+36
10
A0g
Constant term of the polynomial describing the difference between Galileo and GPS time
Double 8
H+40
OEM7 Commands and Logs Reference Manual v10
481
Chapter 3 Logs
Field
Field Type
11
A1g
12
T0g
13
WN0g
14
xxxx
15
[CR][LF]
Description
Rate of change of offset the offset between Galileo and GPS time Reference time for GGTO data Week number of GGTO reference 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+48
Ulong 4
Ulong 4
Hex
4
-
-
H+56 H+60 H+64 -
OEM7 Commands and Logs Reference Manual v10
482
Chapter 3 Logs
3.32 GALCNAVRAWPAGE
Galileo raw CNAV page
Platform: OEM719, OEM729, OEM7500, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides Galileo raw C-NAV page data from Galileo E6 signals.
The GALCNAVRAWPAGE log is not output by default. To receive this log, data decoding for E6B/E6C must be enabled using the DATADECODESIGNAL command (see page 115) the specific signal.
Message ID: 2239 Log Type: Asynch
Recommended Input: log galcnavrawpage onnew
Abbreviated ASCII Example:
<GALCNAVRAWPAGE USB1 0 49.5 SATTIME 1997 145162.000 02040020 ab53 32768
<
319 30 2761
2b26bcef0c04f6711bf86137086a12c14f87c07b4c6aa4de04bceb8612c34c691bfabceceb86bce
d4f851bfb0c074c68613604bff48448d33487
Field
Field Type
Description
1
GALCNAVRAWPAGE Log header. See Messages on
header
page 25 for more information.
2
signal channel
Signal channel providing the bits
3
PRN
Satellite PRN number
4
Page ID
The page ID
5
data
Raw CNAV page data
6
xxxx
7
[CR][LF]
32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
Ulong 4
Ulong 4
HEX [58]
58
Hex
4
-
-
H H+4 H+8
H+12
h+70 -
OEM7 Commands and Logs Reference Manual v10
483
Chapter 3 Logs
3.33 GALFNAVEPHEMERIS
Decoded Galileo FNAV Ephemeris
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The GALFNAVEPHEMERIS log contains the Galileo FNAV ephemeris information. Multiple messages are transmitted, one for each satellite ID with date.
Message ID: 1310
Log Type: Asynch
Recommended Input: log galfnavephemerisa onchanged
ASCII Example: #GALFNAVEPHEMERISA,COM2,0,82.5,SATTIME,1874,148850.000,02400000,02cd, 32768;22,0,0,0,0,118,122,0,147600,147600,-6.101167919e-01,3.1687e-09, 4.478077171e-04,5.44059147e+03,9.639218456e-01,6.4610e-10, 2.329679501e-01,2.55827293e+00,-5.5577315e-09,1.0207e-06,8.2552e-06, 1.611e+02,2.313e+01,4.0978e-08,-1.8626e-09,1.335504232e-03, 1.768257e-10,0.0,2.561e-09*d02e28ca
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
GALFNAV EPHEMERIS header
Log header. See Messages on page 25 for more information.
H
0
2
SatId
Satellite identifier
Ulong 4
H
3
E5aHealth E5a health status bits
Uchar 1
H+4
4
E5aDVS
E5a data validity status
Uchar 1
H+5
5
Reserved
Uchar 1
H+6
6
Reserved
Uchar 1
H+7
7
IODnav
Issue of data ephemeris
Ushort 2
H+8
8
SISA Index Signal in space accuracy (unitless)
Uchar 1
H+10
9
Reserved
Uchar 1
H+11
10
T0e
Ephemeris reference time (s)
Ulong 4
H+12
11
T0c
Clock correction data reference time of week from the F/NAV message (s)
Ulong
4
H+16
12
M0
Mean anomaly at ref time (radians)
Double 8
H+20
OEM7 Commands and Logs Reference Manual v10
484
Chapter 3 Logs
Field
Field Type
13
DeltaN
14
Ecc
15
RootA
16
I0
17
IDot
18
Omega0
19
Omega
20
OmegaDot
21
Cuc
22
Cus
23
Crc
24
Crs
25
Cic
26
Cis
27
Af0
28
Af1
29
Af2
30
E1E5aBGD
31
xxxx
32
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Mean motion difference (radians/s)
Double 8
H+28
Eccentricity (unitless)
Double 8
H+36
Square root of semi-major axis
Double 8
H+44
Inclination angle at ref time (radians)
Double 8
H+52
Rate of inclination angle (radians/s)
Double 8
H+60
Longitude of ascending node of orbital plane at weekly epoch (radians)
Double
8
H+68
Argument of perigee (radians)
Double 8
H+76
Rate of right ascension (radians/s)
Double 8
H+84
Amplitude of the cosine harmonic correction term to the argument of latitude (radians)
Double 8
H+92
Amplitude of the sine harmonic correction term to the argument of latitude (radians)
Double
8
H+100
Amplitude of the cosine harmonic correction term to the orbit radius (m)
Double 8
H+108
Amplitude of the sine harmonic correction term to the orbit radius (m)
Double
8
H+116
Amplitude of the cosine harmonic correction term to the angle of inclination (radians)
Double 8
H+124
Amplitude of the sine harmonic correction term to the angle of inclination (radians)
Double
8
H+132
SV clock bias correction coefficient from the F/NAV message (s)
Double 8
H+140
SV clock drift correction coefficient from the F/NAV message (s/s)
Double 8
H+148
SV clock drift rate correction coefficient from the F/NAV message (s/s^2)
Double 8
H+156
E1, E5a broadcast group delay
Double 8
H+164
32-bit CRC (ASCII and Binary only)
Hex
4
H+172
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
485
Chapter 3 Logs
3.34 GALFNAVRAWPAGE
Raw Galileo FNAV page data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw Galileo FNAV page data.
Message ID: 1413
Log Type: Asynch
Recommended Input: log galfnavrawpagea onchanged
ASCII Example: #GALFNAVRAWPAGEA,USB3,0,85.0,SATTIME,1680,434410.000,02000008,d4fb, 43274;56,11,0b818df50ad5ffc151001baffdaa04d5dae655e17affc8a41a83aa *5955b14d
Field
Field Type
Description
1
GALFNAVRAWPAGE Log header. See Messages on
header
page 25 for more information.
2
signal channel
Signal channel providing the data
3
SVID
SVID of transmitting satellite
4
raw frame data
Raw F/NAV page (214 bits). Does not include CRC or Tail bits
5
xxxx
32-bit CRC (ASCII and Binary only)
6
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
H
Ulong 4 Ulong 4
Hex[27] 27
Hex
4
-
-
Binary Offset
0
H H+4
H+8
H+35 -
OEM7 Commands and Logs Reference Manual v10
486
Chapter 3 Logs
3.35 GALINAVEPHEMERIS
Decoded Galileo INAV Ephemeris
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The GALINAVEPHEMERIS log contains the Galileo INAV ephemeris information. Multiple messages are transmitted, one for each SVID with date.
Message ID: 1309
Log Type: Asynch
Recommended Input: log galinavephemerisa onchanged
ASCII Example: #GALINAVEPHEMERISA,COM1,10,82.0,SATTIME,1930,494134.000,02000020,dbe9, 32768;1,0,0,0,0,0,0,0,0,54,107,1,493200,493200,2.98962614e+00, 2.7990e-09,1.763084438e-04,5.44061901e+03,9.996620695e-01,-2.8608e-10, -2.52251354e+00,-1.37786826e+00,-5.7041662e-09,-3.7253e-09,3.8184e-06, 2.773e+02,4.6875e-01,-7.0781e-08,4.6566e-08,3.960891627e-05, -9.904966e-12,0.0,-6.752e-09,-7.683e-09*b575a8b9
#GALINAVEPHEMERISA,COM1,9,82.0,SATTIME,1930,511405.000,02000020,dbe9, 32768;2,0,0,0,0,0,0,0,0,81,107,3,509400,509400,1.23345967e+00, 2.9637e-09,2.852674806e-04,5.44061650e+03,9.996659901e-01,-2.3537e-10, -2.52264339e+00,-7.551901559e-01,-5.8113135e-09,5.2713e-07,2.4810e-06, 3.021e+02,1.034e+01,-1.3039e-08,1.8626e-09,-2.745073289e-07, 1.705303e-13,0.0,-8.149e-09,-9.546e-09*6df98c07
#GALINAVEPHEMERISA,COM1,8,82.0,SATTIME,1930,511384.000,02000020,dbe9, 32768;8,0,0,0,0,0,0,0,0,83,107,3,510600,510600,1.19121266e+00, 3.0755e-09,1.157049555e-04,5.44062434e+03,9.581430032e-01,-2.9858e-10, 1.66547803e+00,7.075104782e-01,-5.5223729e-09,-1.5851e-06,1.2502e-05, 6.706e+01,-3.447e+01,5.5879e-09,-5.7742e-08,4.641003208e-03, 3.982876e-10,0.0,-1.048e-08,-1.211e-08*99c692a8
...
#GALINAVEPHEMERISA,COM1,1,82.0,SATTIME,1930,511405.000,02000020,dbe9, 32768;26,0,0,0,0,0,0,0,0,83,107,1,510600,510600,-1.25500637e+00,2.9951 e-09,2.602027962e-04,5.44060480e+03,9.688215634e-01,3.7894e-10,-4.2237 68063e-01,-2.61686286e+00,-5.6309488e-09,-4.0233e-07,8.1658e-06,1.711e +02,-8.500e+00,-1.3039e-08,-3.1665e-08,5.767530005e-03,4.148148e-10, 0.0,-6.985e-10,-9.313e-10*0e6670f3
#GALINAVEPHEMERISA,COM1,0,82.0,SATTIME,1930,511405.000,02000020,dbe9, 32768;30,0,0,0,0,0,0,0,0,83,107,1,510600,510600,-2.836817871e-01, 2.9558e-09,2.358634956e-04,5.44061465e+03,9.972253278e-01,-1.9894e-10, -2.51793093e+00,1.101770916e-01,-5.7991701e-09,7.0594e-07,2.4680e-06, 3.045e+02,1.675e+01,-1.8626e-08,5.0291e-08,4.957979254e-03, 3.988703e-10,0.0,-4.889e-09,-5.821e-09*4513b897
OEM7 Commands and Logs Reference Manual v10
487
Chapter 3 Logs
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
GALINAV
1
EPHEMERIS Log Header
header
H
0
2
SatId
Satellite identifier
Ulong 4
H
3
E5bHealth E5b health status bits
Uchar 1
H+4
4
E5bDVS
E5b data validity status
Uchar 1
H+5
5
Reserved
Uchar 1
H+6
6
Reserved
Uchar 1
H+7
7
E1bHealth E1b health status bits
Uchar 1
H+8
8
E1bDVS
E1b data validity status
Uchar 1
H+9
9
Reserved
Uchar 1
H+10
10
Reserved
Uchar 1
H+11
11
IODnav
Issue of data ephemeris
Ushort 2
H+12
12
SISA Index Signal in space accuracy (unitless)
Uchar 1
H+14
13
INAV Source
Identifies the source signal: 0 = Unknown 1 = E1b 2 = E5b 3 = E1b and E5b
Uchar 1
H+15
14
T0e
Ephemeris reference time (s)
Ulong 4
H+16
15
T0c
Clock correction data reference time of week from the I/NAV message (s)
Ulong
4
H+20
16
M0
Mean anomaly at ref time (radians)
Double 8
H+24
17
DeltaN
Mean motion difference (radians/s)
Double 8
H+32
18
Ecc
Eccentricity (unitless)
Double 8
H+40
19
RootA
Square root of semi-major axis
Double 8
H+48
20
I0
Inclination angle at ref time (radians)
Double 8
H+56
21
IDot
Rate of inclination angle (radians/s)
Double 8
H+64
22
Omega0
Longitude of ascending node of orbital plane at weekly epoch (radians)
Double
8
H+72
OEM7 Commands and Logs Reference Manual v10
488
Chapter 3 Logs
Field
Field Type
23
Omega
24
OmegaDot
25
Cuc
26
Cus
27
Crc
28
Crs
29
Cic
30
Cis
31
Af0
32
Af1
33
Af2
34
E1E5aBGD
35
E1E5bBGD
36
xxxx
37
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Argument of perigee (radians)
Double 8
H+80
Rate of right ascension (radians/s)
Double 8
H+88
Amplitude of the cosine harmonic correction term to the argument of latitude (radians)
Double 8
H+96
Amplitude of the sine harmonic correction term to the argument of latitude (radians)
Double
8
H+104
Amplitude of the cosine harmonic correction term to the orbit radius (m)
Double 8
H+112
Amplitude of the sine harmonic correction term to the orbit radius (m)
Double
8
H+120
Amplitude of the cosine harmonic correction term to the angle of inclination (radians)
Double 8
H+128
Amplitude of the sine harmonic correction term to the angle of inclination (radians)
Double
8
H+136
SV clock bias correction coefficient from the I/NAV message (s)
Double 8
H+144
SV clock drift correction coefficient from the I/NAV message (s/s)
Double 8
H+152
SV clock drift rate correction coefficient from the I/NAV message (s/s^2)
Double 8
H+160
E1, E5a broadcast group delay
Double 8
H+168
E1, E5b broadcast group delay
Double 8
H+176
32-bit CRC (ASCII and Binary only)
Hex
4
H+184
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
489
Chapter 3 Logs
3.36 GALINAVRAWWORD
Raw Galileo INAV word data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw Galileo INAV word data.
Message ID: 1414
Log Type: Asynch
Recommended Input: log galinavrawworda onchanged
ASCII Example: #GALINAVRAWWORDA,USB3,0,84.5,SATTIME,1680,434401.000,02000008,884b, 43274;55,11,GALE1,0b81e655e17a26eb5237d7d20088ffc9*dcb4bedb
Field
Field Type
Description
1
GALINAVRAWWORD Log header. See Messages on
header
page 25 for more information.
2
signal channel
Signal channel providing data
3
SVID
Space Vehicle ID (SVID) of transmitting satellite
4
signal type
Signal Type as defined in Table 95: Signal Type below
5
raw frame data
Raw I/NAV word (128 bits)
6
xxxx
32-bit CRC (ASCII and binary only)
7
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
Ulong 4
H+4
Enum 4
Hex[16] 16
Hex
4
-
-
H+8
H+12 H+28 -
Table 95: Signal Type
Value (Binary) Signal (ASCII)
Description
33
GPSL1CA
GPS L1 C/A-code
47
GPSL1CP
GPS L1C P-code
68
GPSL2Y
GPS L2 P(Y)-code
69
GPSL2C
GPS L2 C/A-code
70
GPSL2P
GPS L2 P-code
OEM7 Commands and Logs Reference Manual v10
490
Chapter 3 Logs
Value (Binary) Signal (ASCII)
Description
103
GPSL5
GPS L5
2177
GLOL1CA
GLONASS L1 C/A-code
2211
GLOL2CA
GLONASS L2 C/A-code
2212
GLOL2P
GLONASS L2 P-code
2662
GLOL3
GLONASS L3
4129
SBASL1
SBAS L1
4194
SBASL5
SBAS L5
10433
GALE1
Galileo E1
10466
GALE5A
Galileo E5A
10499
GALE5B
Galileo E5B
10532
GALALTBOC
Galileo ALT-BOC
10565
GALE6C
Galileo E6C
10572
GALE6B
Galileo E6B
12673
BDSB1D1
BeiDou B1 with D1 navigation data
12674
BDSB1D2
BeiDou B1 with D2 navigation data
12803
BDSB2D1
BeiDou B2 with D1 navigation data
12804
BDSB2D2
BeiDou B2 with D2 navigation data
12877
BDSB3D1
BeiDou B3 with D1 navigation data
12880
BDSB3D2
BeiDou B3 with D2 navigation data
12979
BDSB1C
BeiDou B1C
13012
BDSB2A
BeiDou B2a
14753
QZSSL1CA
QZSS L1 C/A-code
14760
QZSSL1CP
QZSS L1C P-code
14787
QZSSL2CM
QZSS L2 C/A-code
14820
QZSSL5
QZSS L5
14891
QZSSL6P
QZSS L6P
19073
NAVICL5SPS
NavIC L5 SPS
OEM7 Commands and Logs Reference Manual v10
491
Chapter 3 Logs
3.37 GALIONO
Decoded Galileo ionospheric corrections
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the decoded Galileo ionospheric corrections.
Message ID: 1127
Log Type: Asynch
Recommended Input: log galionoa onchanged
ASCII Example: #GALIONOA,COM1,0,81.5,SATTIME,1930,512134.000,02000020,d22e,32768; 6.03e+01,-2.344e-02,-3.9368e-03,0,0,0,0,0*f50fae69
Field
Field Type
1
GALIONO header
2
Ai0
3
Ai1
4
Ai2
5
SF1
6
SF2
7
SF3
8
SF4
9
SF5
10
xxxx
11
[CR][LF]
Description
Log header. See Messages on page 25 for more information. Effective ionization level 1st order parameter (sfu) Effective ionization level 2st order parameter (sfu/degree) Effective ionization level 3st order parameter (sfu/degree2) Ionospheric disturbance flag for region 1 Ionospheric disturbance flag for region 2 Ionospheric disturbance flag for region 3 Ionospheric disturbance for flag region 4 Ionospheric disturbance for flag region 5 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
H
Double 8
Double 8
Double 8
Uchar 1
Uchar 1
Uchar 1
Uchar 1
Uchar 1
Hex
4
-
-
Binary Offset 0
H
H+8
H+16 H+24 H+25 H+26 H+27 H+28 H+29 -
OEM7 Commands and Logs Reference Manual v10
492
Chapter 3 Logs
3.38 GLMLA
NMEA GLONASS Almanac data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log outputs almanac data for GLONASS satellites. Multiple sentences are transmitted, one for each satellite.
The following relationships enable translation between the NMEA GLONASS satellite IDs, the NovAtel GLONASS PRN IDs, and the GLONASS slot numbers:
NMEA GLONASS satellite ID NovAtel GLONASS PRN ID
= GLONASS slot number + 64 = GLONASS slot number + 37
= NMEA GLONASS satellite ID - 27
Message ID: 859
Log Type: Asynch
Recommended Input: log glmlaa onchanged
ASCII Example: $GLMLA,16,01,65,1176,07,0496,4c,5ff2,8000,34c05e,0e93e8,04b029,001fa2,099,213*6 8 $GLMLA,16,02,66,1176,01,12e3,4c,42cc,8000,34c08e,10fae9,02f48c,00224e,099,003*6 4 $GLMLA,16,03,67,1176,8c,08f6,4a,ef4d,8000,34c051,13897b,00d063,001b09,099,000*6 3 $GLMLA,16,04,68,1176,06,116b,48,3a00,8000,34c09d,02151f,0e49e8,00226e,099,222*6 3 $GLMLA,16,05,70,1176,01,140f,49,45c4,8000,34c0bc,076637,0a3e40,002214,099,036*3 7 $GLMLA,16,06,71,1176,05,0306,4c,5133,8000,34c025,09bda7,085d84,001f83,099,21d*6 E $GLMLA,16,07,72,1176,06,01b1,4c,4c19,8000,34c021,0c35a0,067db8,001fca,099,047*3 D $GLMLA,16,08,74,1176,84,076b,45,7995,8000,34c07b,104b6d,0e1557,002a38,099,040*3 5 $GLMLA,16,09,78,1176,84,066c,46,78cf,8000,34c07b,0663f0,1a6239,0029df,099,030*3 8 $GLMLA,16,10,79,1176,80,0afc,45,8506,8000,34c057,08de48,1c44ca,0029d7,099,000*6 B
OEM7 Commands and Logs Reference Manual v10
493
Chapter 3 Logs
$GLMLA,16,11,82,1176,8a,12d3,0f,e75d,8000,34be85,10aea6,1781b7,00235a,099,207*6 E $GLMLA,16,12,83,1176,03,0866,0f,6c08,8000,34c009,11f32e,18839d,002b22,099,214*3 6 $GLMLA,16,13,85,1176,88,01a6,0d,9dc9,8000,34bff8,031887,02da1e,002838,099,242*6 D $GLMLA,16,14,86,1176,8a,00e1,0e,4b15,8000,34c016,058181,010433,0027f0,099,227*6 F $GLMLA,16,15,87,1176,03,0383,0f,824c,8000,34bfda,081864,1104ea,002b04,099,00c*6 0 $GLMLA,16,16,88,1176,02,0821,0f,8ac8,8000,34c05b,0a8510,12dcb6,002b6f,099,020*3 F
Refer to the GLONASS section of An Introduction to GNSS available on our website.
Field Structure
Description
Symbol Example
1
$GLMLA
Log header. See Messages on page 25 for more information.
$GLMLA
2
#alm
Number of NMEA almanac messages in the set
x.x
16
3
alm#
Current message number
x.x
13
4
slot
Slot number for satellite (65-96)
The NMEA GLONASS PRN numbers are 64 plus the
GLONASS slot number. Current slot numbers are 1 to
xx
85
24 which give the range 65 to 88. PRN numbers 89 to 96
are available if slot numbers above 24 are allocated to
on-orbit spares.
5
N
Calendar day count within the four year period from the last leap year
x.x
1176
Health and frequency for satellite
Health and carrier frequency numbers are represented
in this 2-character Hex field as:
6
hlth & freq
hh
88
7
ecc
Eccentricity 1
hhhh
01a6
1The LSB of the Hex data field corresponds to the LSB of the word indicated in the Table 4.3 of the GLONASS Interface Control Document, 1995. If the number of available bits in the Hex field is greater than the word, the MSB (upper bits) are unused and filled with zeroes.
OEM7 Commands and Logs Reference Manual v10
494
Chapter 3 Logs
Field Structure
Description
8
Tdot
Rate of change of orbital period (s/orbital period2) 1
9
w
Argument of perigee (PZ-90.02), in radians 1
10
t16MSB
11
T
Clock offset, in seconds 1
Correction to the mean value of the Draconian period (s/orbital period) 1
12
t
GLONASS Time of ascending node equator crossing, in seconds 1
13
l
14
i
Longitude of ascending node equator crossing (PZ90.02), in radians 1
Correction to nominal inclination, in radians 1
15
t12LSB
16
t
Clock offset, in seconds 1 Coarse value of the time scale shift 1
17
xxxx
32-bit CRC (ASCII and Binary only)
18
[CR][LF] Sentence terminator (ASCII only)
Symbol Example
hh
0d
hhhh
9dc9
hhhh
8000
hhhhhh 34bff8
hhhhhhh 031887
hhhhhhh 02da1e
hhhhhhh 002838
hhh
099
hhh
242
Hex
*6D
-
[CR][LF]
OEM7 Commands and Logs Reference Manual v10
495
Chapter 3 Logs
3.39 GLOALMANAC
Decoded GLONASS Almanac
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The GLONASS almanac reference time and week are in GPS reference time coordinates. GLONASS ephemeris information is available through the GLOEPHEMERIS command (see page 501). Nominal orbit parameters of the GLONASS satellites are as follows:
l Draconian period - 11 hours 15 minutes 44 seconds (see fields 14 and 15 in the following table)
l Orbit altitude - 19100 km l Inclination - 64.8 (see field 11) l Eccentricity - 0 (see field 12) The OEM7 family of receivers automatically save almanacs in their Non-Volatile Memory (NVM), so creating an almanac boot file is not necessary.
The speed at which the receiver locates and locks onto new satellites is improved if the receiver has approximate time and position, as well as an almanac. This allows the receiver to compute the elevation of each satellite so it can tell which satellites are visible and their Doppler offsets, improving Time to First Fix (TTFF).
Message ID: 718
Log Type: Asynch
Recommended Input: log gloalmanaca onchanged
ASCII Example: #GLOALMANACA,COM1,0,52.5,SATTIME,1364,410744.000,02000000,ba83,2310; 24, 1364,336832.625,1,2,0,0,2018.625000000,-2.775537500,0.028834045, 0.001000404,2.355427500,-2656.076171875,0.000000000,0.000091553, 1364,341828.437,2,1,0,0,7014.437500000,-3.122226146,0.030814438, 0.004598618,1.650371580,-2656.160156250,0.000061035,0.000095367, 1364,347002.500,3,12,0,0,12188.500000000,2.747629236,0.025376596, 0.002099991,-2.659059822,-2656.076171875,-0.000061035,-0.000198364, 1364,351887.125,4,6,0,0,17073.125000000,2.427596502,0.030895332, 0.004215240,1.438586358,-2656.167968750,-0.000061035,0.000007629, . . .
OEM7 Commands and Logs Reference Manual v10
496
Chapter 3 Logs
1364,364031.187,23,11,0,1,29217.187500000,0.564055522,0.030242192, 0.001178741,2.505278248,-2655.957031250,0.000366211,0.000019073,
1364,334814.000,24,3,0,1,0.000000000,0.000000000,0.000000000, 0.000000000,0.000000000,0.000000000,0.000000000,0.000000000 *4dc981c7
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
GLOALMANAC Log header. See Messages on page 25 for
header
more information.
H
0
2
#recs
The number of GLONASS almanac records to
follow. Set to zero until almanac data is
Long
4
H
available
3
week
GPS reference week, in weeks
Ulong 4
H+4
4
time
GPS reference time, in milliseconds (binary data) or seconds (ASCII data)
GPSec
4
H+8
5
slot
Slot number for satellite, ordinal
Uchar 1
H+12
6
frequency
Frequency for satellite, ordinal (frequency channels are in the range -7 to +6)
Char
1
H+13
7
sat type
Satellite type where 0 = GLO_SAT 1 = GLO_SAT_M (M type) 2 = GLO_SAT_K (K type)
Uchar 1
H+14
8
health
Satellite status where 0 = OPERATIONAL 1 = MALFUNCTION
Uchar 1
H+15
9
TlambdaN
GLONASS Time of ascending node equator crossing, in seconds
Double 8
H+16
10
lambdaN
Longitude of ascending node equator crossing (PZ-90.02), in radians
Double
8
H+24
11
deltaI
Correction to nominal inclination, in radians Double 8
H+32
12
ecc
Eccentricity
Double 8
H+40
13
ArgPerig
Argument of perigee (PZ-90.02), in radians Double 8
H+48
14
deltaT
Correction to the mean value of the Draconian period (s/orbital period)
Double 8
H+56
OEM7 Commands and Logs Reference Manual v10
497
Chapter 3 Logs
Field Field type
Description
15
deltaTD
Rate of change of orbital period (s/orbital period2)
16
tau
Clock offset, in seconds
17
Next message offset = H + 4 + (#recs x 76)
18
xxxx
32-bit CRC (ASCII and Binary only)
19
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+64
Double 8
H+72
Ulong 4
-
-
H+4+ (76 x #recs)
-
OEM7 Commands and Logs Reference Manual v10
498
Chapter 3 Logs
3.40 GLOCLOCK
GLONASS clock information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the time difference information between GPS and GLONASS time as well as status flags. The status flags are used to indicate the type of time processing used in the least squares adjustment. GPS and GLONASS time are both based on the Universal Time Coordinated (UTC) time scale with some adjustments. GPS reference time is continuous and does not include any of the leap second adjustments to UTC applied since 1980. The result is that GPS reference time currently leads UTC time by 15 seconds. GLONASS time applies leap seconds but is also three hours ahead to represent Moscow time. The nominal offset between GPS and GLONASS time is therefore due to the three hour offset minus the leap second offset. As well as the nominal offset, there is a residual offset on the order of nanoseconds which must be estimated in the least squares adjustment. The GLONASSM satellites broadcasts this difference in the navigation message. This log also contains information from the GLONASS navigation data relating GLONASS time to UTC.
Message ID: 719
Log Type: Asynch
Recommended Input:
log gloclocka onchanged
ASCII Example:
#GLOCLOCKA,COM1,0,54.5,SATTIME,1364,411884.000,02000000,1d44,2310; 0,0.000000000,0.000000000,0,0,-0.000000275,792,-0.000001207, 0.000000000,0.000000000,0*437e9afaf
Field
Field type
Description
1
GLOCLOCK Log header. See Messages on page 25 for more
header
information.
2
3
Reserved
4
Satellite type where
0 = GLO_SAT
5
sat type
1 = GLO_SAT_M (M type)
2 = GLO_SAT_K (K type)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Double 8 Double 8
H H+4 H+12
Uchar 1
H+20
OEM7 Commands and Logs Reference Manual v10
499
Chapter 3 Logs
Field
Field type
6
N4
7
GPS
8
NA
9
C
10
b1
11
b2
12
Kp
13
xxxx
14
[CR][LF]
Description
Four-year interval number starting from 1996
Correction to GPS time relative to GLONASS time
GLONASS calendar day number within a four year period beginning since the leap year, in days
GLONASS time scale correction to UTC(SU) given at beginning of day N4, in seconds
Beta parameter 1st order term
Beta parameter 2nd order term
Kp provides notification of the next expected leap second. For more information, see Table 96: Kp UTC Leap Second Descriptions below
32-bit CRC (ASCII and Binary only)
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Uchar 1 1
H+21
Double 8
H+24
Ushort 2 1
H+32
Double 8 Double 8 Double 8
Uchar 1
Ulong 4
-
-
H+36 H+44 H+52
H+60
H+61 -
Table 96: Kp UTC Leap Second Descriptions
Kp
Information on UTC Leap Second2
00 No UTC update for this quarter
01 UTC update of plus 1 second at the end of current quarter
11 UTC update of minus 1 second at end of current quarter
1In the binary log case, additional bytes of padding are added to maintain 4-byte alignment. 2Based on GLONASS ICD version 5.1, 2008.
OEM7 Commands and Logs Reference Manual v10
500
Chapter 3 Logs
3.41 GLOEPHEMERIS
Decoded GLONASS ephemeris
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains GLONASS ephemeris information. GLONASS ephemerides are referenced to the PZ90.02 geodetic datum. No adjustment between the GPS and GLONASS reference frames are made for positioning. Multiple messages are transmitted, one for each SVID with data.
Message ID: 723
Log Type: Asynch
Recommended Input: log gloephemerisa onchanged
Example: #GLOEPHEMERISA,COM1,3,49.0,SATTIME,1364,413624.000,02000000,6b64,2310; 43,8,1,0,1364,413114000,10786,792,0,0,87,0,9.0260864257812500e+06, -6.1145468750000000e+06,2.2926090820312500e+07,1.4208841323852539e+03, 2.8421249389648438e+03,1.9398689270019531e+02,0.00000000000000000, -2.79396772384643555e-06,-2.79396772384643555e-06,2.12404876947402954e -04,-1.396983862e-08,-3.63797880709171295e-12,78810,3,15,0,12*a02ce18b
#GLOEPHEMERISA,COM1,2,49.0,SATTIME,1364,413626.000,02000000,6b64,2310; 44,11,1,0,1364,413116000,10784,792,0,0,87,13,-1.2882617187500000e+06, -1.9318657714843750e+07,1.6598909179687500e+07,9.5813846588134766e+02, 2.0675134658813477e+03,2.4769935607910156e+03,2.79396772384643555e-06, -3.72529029846191406e-06,-1.86264514923095703e-06,6.48368149995803833e -05,-4.656612873e-09,3.63797880709171295e-12,78810,3,15,3,28*e2d5ef15
#GLOEPHEMERISA,COM1,1,49.0,SATTIME,1364,413624.000,02000000,6b64,2310; 45,13,0,0,1364,413114000,10786,0,0,0,87,0,-1.1672664062500000e+07, -2.2678505371093750e+07,4.8702343750000000e+05,-1.1733341217041016e+02, 1.3844585418701172e+02,3.5714883804321289e+03,2.79396772384643555e-06, -2.79396772384643555e-06,0.00000000000000000,-4.53162938356399536e-05, 5.587935448e-09,-2.36468622460961342e-11,78810,0,0,0,8*c15abfeb
#GLOEPHEMERISA,COM1,0,49.0,SATTIME,1364,413624.000,02000000,6b64,2310; 59,17,0,0,1364,413114000,10786,0,0,0,87,0,-2.3824853515625000e+05, -1.6590188964843750e+07,1.9363733398437500e+07,1.3517074584960938e+03, -2.2859592437744141e+03,-1.9414072036743164e+03,1.86264514923095703e-0 6,-3.72529029846191406e-06,-1.86264514923095703e-06,7.9257413744926452 6e-05,4.656612873e-09,2.72848410531878471e-12,78810,0,0,0,12*ed7675f5
OEM7 Commands and Logs Reference Manual v10
501
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
GLOEPHEMERIS Log header. See Messages on page 25 for
header
more information.
H
0
2
sloto
Slot information offset - PRN identification
(Slot + 37). This is also called SLOTO in
Ushort 2
H
Connect
3
freqo
Frequency channel offset for satellite in the range 0 to 20
Ushort
2
H+2
4
sat type
Satellite type where 0 = GLO_SAT 1 = GLO_SAT_M (M type) 2 = GLO_SAT_K (K type)
Uchar 1
H+4
5
Reserved
1
H+5
6
e week
Reference week of ephemeris (GPS reference time)
Ushort 2
H+6
7
e time
Reference time of ephemeris (GPS reference time) (ms)
Ulong 4
H+8
8
t offset
Integer seconds between GPS and
GLONASS time. A positive value implies
Ulong 4
GLONASS is ahead of GPS reference time.
H+12
9
Nt
Calendar number of day within 4 year interval starting at Jan 1 of a leap year
Ushort 2
H+16
10 Reserved
11
1
H+18
1
H+19
12
issue
15 minute interval number corresponding to ephemeris reference time
Ulong
4
H+20
13
healtha
Ephemeris health where 0-3 = GOOD 4-15 = BAD
Ulong 4
H+24
aThe last four bits of this field are used to describe the health. Bit 0-2: Bn Bit 3: In All other bits are reserved and set to 0.
OEM7 Commands and Logs Reference Manual v10
502
Chapter 3 Logs
Field Field type
14
pos x
15
pos y
16
pos z
17
vel x
18
vel y
19
vel z
20
LS acc x
21
LS acc y
22
LS acc z
23
tau_n
24
delta_tau_n
25
gamma
26
Tk
27
P
28
Ft
29
age
30
Flags
31
xxxx
32
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
X coordinate for satellite at reference time (PZ-90.02) (metres)
Double
8
H+28
Y coordinate for satellite at reference time (PZ-90.02) (metres)
Double
8
H+36
Z coordinate for satellite at reference time (PZ-90.02) (metres)
Double
8
H+44
X coordinate for satellite velocity at reference time (PZ-90.02) (metres/s)
Double 8
H+52
Y coordinate for satellite velocity at reference time (PZ-90.02) (metres/s)
Double 8
H+60
Z coordinate for satellite velocity at reference time (PZ-90.02), (metres/s)
Double 8
H+68
X coordinate for lunisolar acceleration at reference time (PZ-90.02), (metres/s/s)
Double 8
H+76
Y coordinate for lunisolar acceleration at reference time (PZ-90.02) (metres/s/s)
Double 8
H+84
Z coordinate for lunisolar acceleration at reference time (PZ-90.02) (metres/s/s)
Double 8
H+92
Correction to the nth satellite time t_n relative to GLONASS time t_c (seconds)
Double 8
H+100
Time difference between navigation RF
signal transmitted in L2 sub-band and navigation RF signal transmitted in L1 sub-
Double
8
band by nth satellite (seconds)
H+108
Frequency correction (seconds/second)
Double 8
H+116
Time of frame start (since start of GLONASS day) (seconds)
Ulong 4
H+124
Technological parameter
Ulong 4
H+128
User range
Ulong 4
H+132
Age of data (days)
Ulong 4
H+136
Information flags, see Table 97: GLONASS Ephemeris Flags Coding on the next page
Ulong
4
H+140
32-bit CRC (ASCII and Binary only)
Ulong 4
H+144
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
503
Chapter 3 Logs
Table 97: GLONASS Ephemeris Flags Coding
Nibble Number
Bit
Description
Range Values
0 P1 Flag - Time interval between adjacent 1 iISSUE (fb) values
See Table 98: P1 Flag Range Values below
N0
2
P2 Flag - Oddness or Evenness of iISSUE (fb) value
0 = even 1 = odd
3
P3 Flag - Number of satellites with almanac information within current subframe
0 = four 1 = five
N-1 through
N-7
4 ... Reserved 31
Hex Value 00000001 00000002
00000004
00000008
Table 98: P1 Flag Range Values
State Description
00
0 minutes
01 30 minutes
10 45 minutes
11 60 minutes
OEM7 Commands and Logs Reference Manual v10
504
Chapter 3 Logs
3.42 GLORAWALM
Raw GLONASS Almanac data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw almanac subframes as received from the GLONASS satellite.
Message ID: 720
Log Type: Asynch
Recommended Input:
log glorawalma onchanged
Example:
#GLORAWALMA,COM1,0,44.5,SATTIME,1364,419924.000,02000000,77bb,2310; 1364,419954.069,54, 0563100000a4000000006f,0, 0681063c457a12cc0419be,0, 075ff807e2a69804e0040b,0, 0882067fcd80141692d6f2,0, 09433e1b6676980a40429b,0, 0a838d1bfcb4108b089a8c,0, 0bec572f9c869804f05882,0, ... 06950201e02e13d3819564,0, 07939a4a16fe97fe814ad0,0, 08960561cecc13b0014613,0, 09469a5d70c69802819466,0, 0a170165bed413b704d416,0, 0b661372213697fd41965a,0, 0c18000000000000000006,0, 0d00000000000000000652,0, 0e000000000000000000d0,0*b516623b
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
GLORAWALM Log header. See Messages on page 25 for
header
more information.
H
0
2
week
GPS reference week, in weeks
Ulong 4
H
3
time
GPS reference time, in milliseconds (binary data) or seconds (ASCII data)
GPSec 4
H+4
4
#recs
Number of records to follow
Ulong 4
H+8
5
string
GLONASS data string
String [11]
11
H+12
OEM7 Commands and Logs Reference Manual v10
505
Chapter 3 Logs
Field Field type
Description
6
Reserved
7
Next record offset = H+8+(#recs x 12)
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Uchar 1
H+23
Ulong 4
-
-
H+12+ (#recsx12)
-
OEM7 Commands and Logs Reference Manual v10
506
Chapter 3 Logs
3.43 GLORAWEPHEM
Raw GLONASS Ephemeris data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw ephemeris frame data as received from the GLONASS satellite.
Message ID: 792
Log Type: Asynch
Recommended Input: log glorawephema onchanged
Example: #GLORAWEPHEMA,COM1,3,47.0,SATTIME,1340,398653.000,02000000,332d,2020; 38,9,0,1340,398653.080,4,0148d88460fc115dbdaf78,0,0218e0033667aec83af 2a5,0,038000b9031e14439c75ee,0,0404f22660000000000065,0*17f3dd17 ... #GLORAWEPHEMA,COM1,0,47.0,SATTIME,1340,398653.000,02000000,332d,2020; 41,13,0,1340,398653.078,4,0108d812532805bfa1cd2c,0,0208e0a36e8e0952b1 11da,0,03c02023b68c9a32410958,0,0401fda44000000000002a,0*0b237405
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
GLORAWEPHEM Log header. See Messages on page 25
header
for more information.
H
0
2
sloto
Slot information offset - PRN
identification (Slot + 37). Ephemeris relates to this slot and is also called
Ushort 2
H
SLOTO in NovAtel Connect
3
freqo
Frequency channel offset in the range 0 to 20
Ushort
2
H+2
4
sigchan
Signal channel number
Ulong 4
H+4
5
week
GPS reference week, in weeks
Ulong 4
H+8
6
time
GPS reference time, in milliseconds (binary data) or seconds (ASCII data)
GPSec
4
H+12
7
#recs
Number of records to follow
Ulong 4
H+16
8
string
GLONASS data string
String [11]
11
H+20
OEM7 Commands and Logs Reference Manual v10
507
Chapter 3 Logs
Field Field type
Description
9
Reserved
10
Next record offset = H+20+(#recs x 12)
11
xxxx
32-bit CRC (ASCII and Binary only)
12
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Uchar 1
H+31
Ulong 4
-
-
H+20+ (#recsx12)
-
OEM7 Commands and Logs Reference Manual v10
508
Chapter 3 Logs
3.44 GLORAWFRAME
Raw GLONASS frame data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw GLONASS frame data as received from the GLONASS satellite. Multiple messages are transmitted, one for each SVID with data.
Message ID: 721
Log Type: Asynch
Recommended Input: log glorawframea onchanged
Example: #GLORAWFRAMEA,COM1,19,53.0,SATTIME,1340,398773.000,02000000,8792,2020; 3,39,8,1340,398773.067,44,44,15,0148dc0b67e9184664cb35,0, 0218e09dc8a3ae8c6ba18d,0, ... 0f00000000000000000000,0*11169f9e ... #GLORAWFRAMEA,COM1,0,53.0,SATTIME,1340,398713.000,02000000,8792,2020; 1,41,13,1340,398713.077,36,36,15,0108da12532805bfa1cded,0, 0208e0a36e8e0952b111da,0,03c02023b68c9a32410958,0, ... 0f6efb59474697fd72c4e2,0*0a6267c8
Field Field type
Description
1
GLORAWFRAME Log header. See Messages on page 25 for
header
more information.
2
frame#
Frame number
3
sloto
Slot information offset - PRN identification (Slot + 37). Ephemeris relates to this slot and is also called SLOTO in NovAtel Connect.
4
freqo
Frequency channel offset in the range 0 to 20
5
week
GPS Week, in weeks
6
time
GPS Time, in milliseconds (binary data) or seconds (ASCII data)
7
frame decode Frame decoder number
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
Ushort 2
H+4
Ushort 2 Ulong 4 GPSec 4 Ulong 4
H+6 H+8 H+12 H+16
OEM7 Commands and Logs Reference Manual v10
509
Chapter 3 Logs
Field Field type
Description
8
sigchan
9
#recs
Signal channel number Number of records to follow
10
string
GLONASS data string
11
Reserved
12
Next record offset = H+28+ (#recs x 12)
13
xxxx
32-bit CRC (ASCII and Binary only)
14
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+20
Ulong 4
H+24
String [11]
11
H+28
Uchar 1
H+39
Ulong 4
-
-
H +28+ (#recs x 12)
-
OEM7 Commands and Logs Reference Manual v10
510
Chapter 3 Logs
3.45 GLORAWSTRING
Raw GLONASS string
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw string data as received from the GLONASS satellite.
Message ID: 722
Log Type: Asynch
Recommended Input: log glorawstringa onchanged
Example: #GLORAWSTRINGA,COM1,0,51.0,SATTIME,1340,399113.000,02000000,50ac,2020; 4,6,061000000000000000004f,0*5b215fb2
Field Field type
Description
1
GLORAWSTRING Log header. See Messages on page 25
header
for more information.
2
slot
Slot identification
3
freq
Frequency channel (frequency channels are in the range -7 to +13)
4
string
GLONASS data string
5
Reserved
6
xxxx
32-bit CRC (ASCII and Binary only)
7
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
H
0
Uchar 1
H
Char
1
H+1
Hex[11] 11
Uchar 1
Ulong 4
-
-
H+2 H+13 H+14 -
OEM7 Commands and Logs Reference Manual v10
511
Chapter 3 Logs
3.46 GPALM
Almanac data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log outputs raw almanac data for each GPS satellite PRN contained in the broadcast message. A separate record is logged for each PRN, up to a maximum of 32 records. GPALM outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. UTC time is then set to VALID. It takes a minimum of 12.5 minutes to collect a complete almanac following receiver boot-up. In the case of a GLONASS capable receiver, the UTC offset can be determined once the GLONASS ephemeris is decoded, which takes about 50 seconds. If an almanac was stored in NVM, the stored values are reported in the GPALM log once time is set on the receiver.
To obtain copies of ICD-GPS-200, refer to ARINC on our website at www.novatel.com/support/knowledge-and-learning/published-papers-and-documents/standardsand-references/. NMEA contact information is also located there.
Message ID: 217
Log Type: Asynch
Recommended Input: log gpalm onchanged
Example: $GPALM,28,01,01,1337,00,305a,90,1b9d,fd5b,a10ce9,ba0a5e,2f48f1,cccb76,006,001*2 7 $GPALM,28,02,02,1337,00,4aa6,90,0720,fd50,a10c5a,4dc146,d89bab,0790b6,fe4,000*7 0 . . . $GPALM,28,24,26,1337,00,878c,90,1d32,fd5c,a10c90,1db6b6,2eb7f5,ce95c8,00d,000*2 3 $GPALM,28,25,27,1337,00,9cde,90,07f2,fd54,a10da5,adc097,562da3,6488dd,00e,000*2 F $GPALM,28,26,28,1337,00,5509,90,0b7c,fd59,a10cc4,a1d262,83e2c0,3003bd,02d,000*7 8 $GPALM,28,27,29,1337,00,47f7,90,1b20,fd58,a10ce0,d40a0b,2d570e,221641,122,006*7 D
OEM7 Commands and Logs Reference Manual v10
512
Chapter 3 Logs
$GPALM,28,28,30,1337,00,4490,90,0112,fd4a,a10cc1,33d10a,81dfc5,3bdb0f,178,004*2 8
See the The NMEA (National Marine Electronics Association) has defined standards that specify how electronic equipment for marine users communicate. GNSS receivers are part of this standard and the NMEA has defined the format for several GNSS data logs otherwise known as 'sentences'. on page 515 that applies to all NMEA logs.
Field Structure
Description
1
$GPALM
Log header. See Messages on page 25 for more information.
2
# msg
Total number of messages logged. Set to zero until almanac data is available
3
msg #
Current message number1
4
PRN
Satellite PRN number: GPS = 1 to 32
5
GPS wk
GPS reference week number
6
SV hlth
SV health, bits 17-24 of each almanac page2
e, eccentricity3
7
ecc
A quantity defined for a conic section where e=0 is a circle, e=1 is an ellipse, 0<e<1 is a parabola and e>1 is a hyperbola.
8
alm ref time
to a almanac reference time 3
9
incl angle (sigma)i, inclination angle 3
10
omegadot OMEGADOT, rate of right ascension 3
11
rt axis
(A)1/2, root of semi-major axis 3
Symbol Example $GPALM
x.x
17
x.x
17
xx
28
x.x
653
hh
00
hhhh
3EAF
hh
87
hhhh
OD68
hhhh
FD30
hhhhhh A10CAB
1Variable length integer, 4-digits maximum from (2) most significant binary bits of Subframe 1, Word 3 reference Table 20-I, ICD-GPS-200, Rev. B, and (8) least significant bits from subframe 5, page 25, word 3 reference Table 20-I, ICD-GPS-200. 2Reference paragraph 20.3.3.5.1.3, Table 20-VII and Table 20-VIII, ICD-GPS-200, Rev. B.
3Reference Table 20-VI, ICD-GPS-200, Rev. B for scaling factors and units.
OEM7 Commands and Logs Reference Manual v10
513
Chapter 3 Logs
Field Structure
Description
omega, argument of perigee 3
12
omega
A measurement along the orbital path from the ascending node to the point where the SV is closest to the Earth, in the direction of the SV's motion.
13
long asc node
(OMEGA)�, longitude of ascension node 3
14
Mo
Mo, mean anomaly 3
15
af0
af0, clock parameter 3
16
af1
af1, clock parameter 3
17
*xx
Check sum
18
[CR][LF] Sentence terminator
Symbol Example hhhhhh 6EE732
hhhhhh 525880
hhhhhh 6DC5A8
hhh
009
hhh
005
*hh
*37
[CR][LF]
OEM7 Commands and Logs Reference Manual v10
514
Chapter 3 Logs
3.47 GPGGA
GPS fix data and undulation
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains time, position and fix related data of the GNSS receiver. See also Table 100: Position Precision of NMEA Logs on page 521. The GPGGA log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
The GPGGA log can be customized using the NMEAFORMAT command (see page 248).
Message ID: 218
Log Type Synch
Recommended Input: log gpgga ontime 1
Example: $GPGGA,134658.00,5106.9792,N,11402.3003,W,2,09,1.0,1048.47,M,16.27,M,08,AAAA*60
The NMEA (National Marine Electronics Association) has defined standards that specify how electronic equipment for marine users communicate. GNSS receivers are part of this standard and the NMEA has defined the format for several GNSS data logs otherwise known as 'sentences'. Each NMEA sentence begins with a '$' followed by a two-letter prefix identifying the type of sending device (for example 'GP', 'GL' or `GN'), followed by a sequence of letters that define the type of information contained in the sentence. Data contained within the sentence is separated by commas and the sentence is terminated with a two digit checksum followed by a carriage return/line feed. Here is an example of a NMEA sentence describing time, position and fix related data:
$GPGGA,134658.00,5106.9792,N,11402.3003,W,2,09,1.0,1048.47,M, -16.27,M,08,AAAA*60 The GPGGA sentence shown above and other NMEA logs are output the same no matter what GNSS receiver is used, providing a standard way to communicate and process GNSS information. For more information about NMEA, see the NMEATALKER command on page 251.
OEM7 Commands and Logs Reference Manual v10
515
Chapter 3 Logs
Field Structure
Description
Symbol
Example
1
$GPGGA
Log header. See Messages on page 25 for more information.
$GPGGA
2
utc
UTC time status of position (hours/minutes/seconds/ decimal seconds)
hhmmss.ss 202134.00
3
lat
Latitude (DDmm.mm)
llll.ll
5106.9847
4
lat dir
Latitude direction (N = North, S = South)
a
N
5
lon
Longitude (DDDmm.mm)
yyyyy.yy 11402.2986
6
lon dir
Longitude direction (E = East, W = West)
a
W
7
quality
refer to Table 99: GPS Quality Indicators on the next page
x
1
8
# sats
Number of satellites in use. May be different to the number in view
xx
10
9
hdop
Horizontal dilution of precision
x.x
1.0
10
alt
Antenna altitude above/below mean sea level
x.x
1062.22
11
a-units
Units of antenna altitude (M = metres) M
M
12
undulation
Undulation - the relationship between the geoid and the WGS84 ellipsoid
x.x
-16.271
13
u-units
Units of undulation (M = metres)
M
M
14
age
Age of correction data (in seconds)
The maximum age reported here is
xx
limited to 99 seconds.
(empty when no differential data is present)
15
stn ID
Differential base station ID
xxxx
(empty when no differential data is present)
16
*xx
Check sum
*hh
*48
17
[CR][LF] Sentence terminator
[CR][LF]
OEM7 Commands and Logs Reference Manual v10
516
Chapter 3 Logs
Table 99: GPS Quality Indicators
Indicator
Description
0
Fix not available or invalid
Single point 1
Converging PPP (TerraStar-L)
Pseudorange differential
2
Converged PPP (TerraStar-L)
Converging PPP (TerraStar-C)
4
RTK fixed ambiguity solution
RTK floating ambiguity solution 5
Converged PPP (TerraStar-C)
6
Dead reckoning mode
7
Manual input mode (fixed position)
8
Simulator mode
9
WAAS (SBAS)1
Refer to the BESTPOS log (see page 433) and Table 79: Supplemental Position Types and NMEA Equivalents on page 441.
1An indicator of 9 has been temporarily set for SBAS (NMEA standard for SBAS not decided yet). This indicator can be customized using the GGAQUALITY command.
OEM7 Commands and Logs Reference Manual v10
517
Chapter 3 Logs
3.48 GPGGALONG
Fix data, extra precision and undulation
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains, time, position, undulation and fix related data of the GNSS receiver. This is output as a GPGGA log but the GPGGALONG log differs from the normal GPGGA log by its extra precision. See also Table 100: Position Precision of NMEA Logs on page 521. The GPGGALONG log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
The GPGGALONG log can be customized using the NMEAFORMAT command (see page 248).
Message ID: 521
Log Type: Synch
Recommended Input: log gpggalong ontime 1
Example 1: $GPGGA,181126.00,5106.9802863,N,11402.3037304,W,7,11,0.9,1048.234,M,16.27,M,,*51
Example 2: $GPGGA,134658.00,5106.9802863,N,11402.3037304,W,2,09,1.0,1048.234,M,16.27,M,08,AAAA
See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
Field Structure
Description
1
$GPGGALONG Log header
2
utc
UTC time status of position (hours/minutes/seconds/ decimal seconds)
3
lat
Latitude (DDmm.mm)
4
lat dir
Latitude direction (N = North, S = South)
Symbol
Example $GPGGA
hhmmss.ss 202126.00
llll.ll a
5106.9847029 N
OEM7 Commands and Logs Reference Manual v10
518
Chapter 3 Logs
Field Structure
5
lon
6
lon dir
7
GPS qual
8
# sats
9
hdop
10
alt
11
units
12
undulation
13
u-units
14
age
15
stn ID
16
*xx
17
[CR][LF]
Description
Symbol
Longitude (DDDmm.mm)
yyyyy.yy
Longitude direction (E = East, W = West)
a
Refer to Table 99: GPS Quality Indicators on page 517
x
Number of satellites in use (00-12).
May be different to the number in
xx
view
Horizontal dilution of precision
x.x
Antenna altitude above/below msl
x.x
Units of antenna altitude (M = metres)
M
Undulation - the relationship between the geoid and the WGS84 ellipsoid
x.x
Units of undulation (M = metres)
M
Age of Differential GPS data (in seconds)
xx The maximum age reported here is limited to 99 seconds.
Differential base station ID, 00001023
xxxx
Check sum
*hh
Sentence terminator
Example 11402.2986286
W
1
10
1.0 1062.376
M
-16.271
M 10 (empty when no differential data is present) AAAA (empty when no differential data is present) *48 [CR][LF]
Refer to the BESTPOS log (see page 433) and Table 79: Supplemental Position Types and NMEA Equivalents on page 441.
OEM7 Commands and Logs Reference Manual v10
519
Chapter 3 Logs
3.49 GPGLL
Geographic position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains latitude and longitude of present vessel position, time of position fix and status. Table 100: Position Precision of NMEA Logs on the next page compares the position precision of selected NMEA logs. The GPGLL log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only), GL (GLONASS satellites only) or GN (satellites from both systems) or GA (Galileo satellites only).
Message ID: 219
Log Type: Synch
Recommended Input: log gpgll ontime 1
Example 1 (GPS only): $GPGLL,5107.0013414,N,11402.3279144,W,205412.00,A,A*73
Example 2 (Combined GPS and GLONASS): $GNGLL,5107.0014143,N,11402.3278489,W,205122.00,A,A*6E
See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
Field Structure
Description
Example
1
$GPGLL
Log header. See Messages on page 25 for more information. $GPGLL
2
lat
Latitude (DDmm.mm)
5106.7198674
3
lat dir
Latitude direction (N = North, S = South)
N
4
lon
Longitude (DDDmm.mm)
11402.3587526
OEM7 Commands and Logs Reference Manual v10
520
Chapter 3 Logs
Field Structure
Description
Example
5
lon dir
Longitude direction (E = East, W = West)
W
6
utc
UTC time status of position (hours/minutes/seconds/decimal seconds)
220152.50
7
data status
Data status: A = Data valid, V = Data invalid
A
8
mode ind
Positioning system mode indicator, see Table 101: NMEA Positioning System Mode Indicator on page 534
A
9
*xx
Check sum
*1B
10
[CR][LF] Sentence terminator
[CR][LF]
Table 100: Position Precision of NMEA Logs
NMEA Log
Latitude
Longitude
Altitude
(# of decimal places) (# of decimal places) (# of decimal places)
GPGGA
4
4
2
GPGGALONG
7
7
3
GPGLL
7
7
N/A
GPRMC
7
7
N/A
OEM7 Commands and Logs Reference Manual v10
521
Chapter 3 Logs
3.50 GPGRS
GPS range residuals for each satellite
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Range residuals can be computed in two ways, and this log reports those residuals. Under mode 0, residuals output in this log are used to update the position solution output in the GPGGA message. Under mode 1, the residuals are recomputed after the position solution in the GPGGA message is computed. The receiver computes range residuals in mode 1. An integrity process using GPGRS would also require GPGGA (for position fix data), GPGSA (for DOP figures) and GPGSV (for PRN numbers) for comparative purposes. The GPGRS log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
1. If the range residual exceeds � 99.9, then the decimal part is dropped. Maximum value for this field is � 999. The sign of the range residual is determined by the order of parameters used in the calculation as follows: range residual = calculated range - measured range
2. If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only), GL (GLONASS satellites only) or GN (satellites from both systems) or GA (Galileo satellites only).
Message ID: 220
Log Type: Synch
Recommended Input: log gpgrs ontime 1
Example 1 (GPS only): $GPGRS,142406.00,1,-1.1,-0.1,1.7,1.2,-2.0,-0.5,1.2,-1.2,-0.1,,,*67
Example 2 (Combined GPS and GLONASS): $GNGRS,143209.00,1,-0.2,-0.5,2.2,1.3,-2.0,-1.3,1.3,-0.4,-1.2,-0.2,,*72 $GNGRS,143209.00,1,1.3,-6.7,,,,,,,,,,*73
See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
OEM7 Commands and Logs Reference Manual v10
522
Chapter 3 Logs
Field Structure
Description
1
$GPGRS
Log header. See Messages on page 25 for more information.
2
utc
UTC time status of position (hours/minutes/seconds/decimal seconds)
3
mode
Mode 0= residuals were used to calculate the position given in the matching GGA line (apriori) (not used by OEM7 receivers)
Mode 1= residuals were recomputed after the GGA position was computed (preferred mode)
415
res
Range residuals for satellites used in the navigation solution. Order matches order of PRN numbers in GPGSA
16
*xx
Check sum
17
[CR][LF] Sentence terminator
Symbol
Example
$GPGRS
hhmmss.ss 192911.0
x
1
x.x,x.x,.....
-13.8,1.9,11.4,33.6,0.9, 6.9,12.6,0.3,0.6, -22.3
*hh
*65
[CR][LF]
OEM7 Commands and Logs Reference Manual v10
523
Chapter 3 Logs
3.51 GPGSA
GPS DOP and active satellites
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains GNSS receiver operating mode, satellites used for navigation and DOP values. The GPGSA log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only), GL (GLONASS satellites only), or GN (satellites from both systems) or GA (Galileo satellites only).
Message ID: 221
Log Type: Synch
Recommended Input: log gpgsa ontime 1
Example 1 (GPS only): $GPGSA,M,3,17,02,30,04,05,10,09,06,31,12,,,1.2,0.8,0.9*35
Example 2 (Combined GPS and GLONASS): $GNGSA,M,3,17,02,30,04,05,10,09,06,31,12,,,1.2,0.8,0.9*2B $GNGSA,M,3,87,70,,,,,,,,,,,1.2,0.8,0.9*2A
The DOPs provide a simple characterization of the user satellite geometry. DOP is related to the volume formed by the intersection points of the user satellite vectors, with the unit sphere centered on the user. Larger volumes give smaller DOPs. Lower DOP values generally represent better position accuracy. The role of DOP in GNSS positioning is often misunderstood. A lower DOP value does not automatically mean a low position error. The quality of a GNSS derived position estimate depends upon both the measurement geometry as represented by DOP values and range errors caused by signal strength, ionospheric effects, multipath and so on.
See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
OEM7 Commands and Logs Reference Manual v10
524
Chapter 3 Logs
Field Structure
Description
1
$GPGSA
Log header. See Messages on page 25 for more information.
A = Automatic 2D/3D
2
mode MA
M = Manual, forced to operate in 2D or 3D
3
mode 123 Mode: 1 = Fix not available; 2 = 2D; 3 = 3D
415
prn
PRN numbers of satellites used in solution (null for unused fields), total of 12 fields
GPS = 1 to 32
SBAS = 33 to 64 (add 87 for PRN number) GLO = 65 to 96 1
16
pdop
Position dilution of precision
17
hdop
Horizontal dilution of precision
18
vdop
Vertical dilution of precision
19
*xx
Check sum
20
[CR][LF] Sentence terminator
Symbol Example $GPGSA
M
M
x
3
18,03,13, 25,16, xx,xx,..... 24,12, 20,,,,
x.x
1.5
x.x
0.9
x.x
1.2
*hh
*3F
[CR][LF]
1The NMEA GLONASS PRN numbers are 64 plus the GLONASS slot number. Current slot numbers are 1 to 24 which give the range 65 to 88. PRN numbers 89 to 96 are available if slot numbers above 24 are allocated to onorbit spares.
OEM7 Commands and Logs Reference Manual v10
525
Chapter 3 Logs
3.52 GPGST
Pseudorange measurement noise statistics
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains pseudorange measurement noise statistics are translated in the position domain in order to give statistical measures of the quality of the position solution. This log reflects the accuracy of the solution type used in the BESTPOS log (see page 433) and GPGGA log (see page 515), except for the RMS field. The RMS field, since it specifically relates to pseudorange inputs, does not represent carrier-phase based positions. Instead it reflects the accuracy of the pseudorange position which is given in the PSRPOS log (see page 662). The GPGST log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only), GL (GLONASS satellites only) or GN (satellites from both systems) or GA (Galileo satellites only).
Message ID: 222
Log Type: Synch
Recommended Input: log gpgst ontime 1
Example 1 (GPS only): $GPGST,141451.00,1.18,0.00,0.00,0.0000,0.00,0.00,0.00*6B
Example 2 (Combined GPS and GLONASS): $GNGST,143333.00,7.38,1.49,1.30,68.1409,1.47,1.33,2.07*4A
OEM7 Commands and Logs Reference Manual v10
526
Chapter 3 Logs
1. See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
2. Accuracy is based on statistics, reliability is measured in percent. When a receiver can measure height to one metre, this is an accuracy. Usually this is a one sigma value (one SD). A one sigma value for height has a reliability of 68%, that is, the error is less than one metre 68% of the time. For a more realistic accuracy, double the one sigma value (1 m) and the result is 95% reliability (error is less than 2 m 95% of the time). Generally, GNSS heights are 1.5 times poorer than horizontal positions.
As examples of statistics, the GPGST message and NovAtel performance specifications use Root Mean Square (RMS). Specifications may be quoted in CEP:
l RMS - root mean square (a probability level of 68%)
l CEP - circular error probable (the radius of a circle such that 50% of a set of events occur inside the boundary)
Field Structure
Description
1
$GPGST
Log header. See Messages on page 25 for more information.
2
utc
UTC time status of position (hours/minutes/seconds/ decimal seconds)
3
rms
RMS value of the standard deviation of the range inputs to the navigation process. Range inputs include pseudoranges and DGPS corrections
4
smjr std
Standard deviation of semi-major axis of error ellipse (m)
5
smnr std
Standard deviation of semi-minor axis of error ellipse (m)
6
orient
Orientation of semi-major axis of error ellipse (degrees from true north)
7
lat std
Standard deviation of latitude error (m)
8
lon std
Standard deviation of longitude error (m)
9
alt std
Standard deviation of altitude error (m)
10
*xx
Check sum
11
[CR][LF] Sentence terminator
Symbol Example $GPGST
hhmmss.ss 173653.00
x.x
2.73
x.x
2.55
x.x
1.88
x.x
15.2525
x.x
2.51
x.x
1.94
x.x
4.30
*hh
*6E
[CR][LF]
OEM7 Commands and Logs Reference Manual v10
527
Chapter 3 Logs
3.53 GPGSV
GPS satellites in view
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the number of GPS SVs in view, PRN numbers, elevation, azimuth and SNR value. Four satellites maximum per message. When required, additional satellite data sent in 2 or more messages (a maximum of 9). The total number of messages being transmitted and the current message being transmitted are indicated in the first two fields. The GPGSV log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
1. Satellite information may require the transmission of multiple messages. The first field specifies the total number of messages, minimum value 1. The second field identifies the order of this message (message number), minimum value 1.
2. If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only) or GL (GLONASS satellites only) or GN (satellites from both systems) or GA (Galileo satellites only). Each system is output in a separate message.
3. The ID setting in the NMEATALKER command (see page 251) controls the satellites reported in this log. If the NMEATALKER ID is set to GP, only GPS satellites are reported in this log. If the NMEATALKER ID is set to AUTO, all satellites in view are reported.
4. A variable number of 'PRN-Elevation-Azimuth-SNR' sets are allowed up to a maximum of four sets per message. Null fields are not required for unused sets when less than four sets are transmitted.
Message ID: 223
Log Type: Synch
Recommended Input: log gpgsv ontime 1
Example (Including GPS and GLONASS sentences): $GPGSV,3,1,11,18,87,050,48,22,56,250,49,21,55,122,49,03,40,284,47*78
$GPGSV,3,2,11,19,25,314,42,26,24,044,42,24,16,118,43,29,15,039,42*7E
$GPGSV,3,3,11,09,15,107,44,14,11,196,41,07,03,173,*4D
$GLGSV,2,1,06,65,64,037,41,66,53,269,43,88,39,200,44,74,25,051,*64
$GLGSV,2,2,06,72,16,063,35,67,01,253,*66
OEM7 Commands and Logs Reference Manual v10
528
Chapter 3 Logs
The GPGSV log can be used to determine which GPS satellites are currently available to the receiver. Comparing the information from this log to that in the GPGSA log shows if the receiver is tracking all available satellites.
See also the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
Field Structure
Description
1
$GPGSV
Log header. See Messages on page 25 for more information.
2
# msgs
Total number of messages (1-9)
3
msg #
Message number (1-9)
Total number of satellites in view. May be different
4
# sats
than the number of satellites in use (see also the
GPGGA log on page 515)
Satellite PRN number
GPS = 1 to 32
5
prn
SBAS = 33 to 64 (add 87 for PRN#s)
GLO = 65 to 96 1
6
elev
Elevation, degrees, 90 maximum
7
azimuth Azimuth, degrees True, 000 to 359
8
SNR
SNR (C/No) 00-99 dB, null when not tracking
...
...
...
...
...
...
Next satellite PRN number, elev, azimuth, SNR, ... Last satellite PRN number, elev, azimuth, SNR,
variable *xx
Check sum
variable [CR][LF] Sentence terminator
Symbol Example
$GPGSV
x
3
x
1
xx
09
xx
03
xx
51
xxx
140
xx
42
*hh
*72
[CR][LF]
1The NMEA GLONASS PRN numbers are 64 plus the GLONASS slot number. Current slot numbers are 1 to 24 which give the range 65 to 88. PRN numbers 89 to 96 are available if slot numbers above 24 are allocated to onorbit spares.
OEM7 Commands and Logs Reference Manual v10
529
Chapter 3 Logs
3.54 GPHDT
NMEA heading log
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains actual vessel heading in degrees True (from True North). See also a description of heading in the HEADING2 log on page 547. You can also set a standard deviation threshold for this log, see the HDTOUTTHRESHOLD command on page 194.
You must have an ALIGN capable receiver to use this log.
The GPHDT log can only be logged using the ONCHANGED trigger. Other triggers, such as ONTIME are not accepted.
If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only), GL (GLONASS satellites only) or GN (satellites from both systems) or GA (Galileo satellites only).
Message ID: 1045 Log Type: Asynch Recommended Input:
log gphdt onchanged
Example 1 (GPS only): $GPHDT,75.5664,T*36
Example 2 (Combined GPS and GLONASS): $GNHDT,75.5554,T*45
Field Structure
Description
1
$GPHDT
Log header. See Messages on page 25 for more information.
2
heading Heading in degrees
3
True
Degrees True
4
*xx
Check sum
5
[CR][LF] Sentence terminator
Symbol Example
$GPHDT
x.x
75.5554
T
T
*hh
*36
[CR][LF]
OEM7 Commands and Logs Reference Manual v10
530
Chapter 3 Logs
3.55 GPHDTDUALANTENNA
Synchronous NMEA heading log
Platform: OEM7720, PwrPak7D, PwrPak7D-E1, PwrPak7D-E2, SPAN CPT7 This log contains actual vessel heading in degrees True (from True North). It provide the same information as the GPHDT log (see page 530), but with synchronous output.
You must have an ALIGN capable, dual antenna receiver to use this log.
If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only), GL (GLONASS satellites only) or GN (satellites from both systems) or GA (Galileo satellites only).
Message ID: 2045 Log Type: Synch Recommended Input:
log gphdtdualantenna ontime 1
Example 1 (GPS only): $GPHDT,75.5664,T*36
Example 2 (Combined GPS and GLONASS): $GNHDT,75.5554,T*45
Field Structure
Description
1
$GPHDT
Log header. See Messages on page 25 for more information.
2
heading Heading in degrees
3
True
Degrees True
4
*xx
Check sum
5
[CR][LF] Sentence terminator
Symbol Example
$GPHDT
x.x
75.5554
T
T
*hh
*36
[CR][LF]
OEM7 Commands and Logs Reference Manual v10
531
Chapter 3 Logs
3.56 GPRMB
Navigation information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains navigation data from present position to a destination waypoint. The destination is set active by the receiver SETNAV command (see page 350). The GPRMB log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
Message ID: 224
Log Type: Synch
Recommended Input: log gprmb ontime 1
Example 1 (GPS only): $GPRMB,A,5.14,L,FROM,TO,5109.7578000,N,11409.0960000,W,5.1,303.0,-0.0,V,A*6F
Example 2 (Combined GPS and GLONASS): $GNRMB,A,5.14,L,FROM,TO,5109.7578000,N,11409.0960000,W,5.1,303.0,-0.0,V,A*71
If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only), GL (GLONASS satellites only) or GN (satellites from both systems) or GA (Galileo satellites only).
See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
Field Structure
Field Description
1
$GPRMB
Log header. See Messages on page 25 for more information.
2
data status
Data status: A = data valid; V = navigation receiver warning
Symbol
Example
$GPRMB
A
A
OEM7 Commands and Logs Reference Manual v10
532
Chapter 3 Logs
Field Structure
Field Description
Cross track error
Represents the track error from the intended course
Symbol
Example
3
xtrack
If the cross track error exceeds 9.99
NM, displays 9.99.
x.x
5.14
One nautical mile (NM) = 1,852 metres.
Direction to steer to get back on track (L/R)
Direction to steer is based on the sign of the
4
dir
crosstrack error, that is,
a
L
L = xtrack error (+)
R = xtrack error (-)
5
origin ID Origin waypoint ID 1
c--c
FROM
6
dest ID
Destination waypoint ID 1
c--c
TO
7
dest lat
Destination waypoint latitude (DDmm.mm) 1
llll.ll
5109.7578000
8
lat dir
Latitude direction (N = North, S = South) 1
a
N
9
dest lon
Destination waypoint longitude (DDDmm.mm) 1 yyyyy.yy 11409.0960000
10
lon dir
Longitude direction (E = East, W = West) 1
a
W
Range to destination, nautical miles
11
range
If the range to destination exceeds
x.x
5.1
999.9 NM, displays 999.9.
12
bearing
Bearing to destination, degrees True
13
vel
Destination closing velocity, knots
Arrival status:
14
arr status A = perpendicular passed
V = destination not reached or passed
x.x
303.0
x.x
-0.0
A
V
1Fields 5, 6, 7, 8, 9, and 10 are tagged from the SETNAV command (see page 350). OEM7 Commands and Logs Reference Manual v10
533
Chapter 3 Logs
Field Structure
Field Description
Positioning system mode indicator, see Table
15
mode ind 101: NMEA Positioning System Mode Indicator
below
16
*xx
Check sum
17
[CR][LF] Sentence terminator
Symbol
Example
a
A
*hh
*6F
[CR][LF]
Table 101: NMEA Positioning System Mode Indicator
Mode
Indicator
A Autonomous
D Differential
E Estimated (dead reckoning) mode
M Manual input
N Data not valid
OEM7 Commands and Logs Reference Manual v10
534
Chapter 3 Logs
3.57 GPRMC
GPS specific information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains time, date, position, track made good and speed data provided by the GPS navigation receiver. RMC and RMB are the recommended minimum navigation data to be provided by a GNSS receiver. A comparison of the position precision between this log and other selected NMEA logs can be seen in Table 100: Position Precision of NMEA Logs on page 521. The GPRMC log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only), GL (GLONASS satellites only) or GN (satellites from both systems) or GA (Galileo satellites only).
Message ID: 225
Log Type: Synch
Recommended Input: log gprmc ontime 1
Example 1 (GPS): $GPRMC,144326.00,A,5107.0017737,N,11402.3291611,W,0.080,323.3,210307,0.0,E,A*20
Example 2 (Combined GPS and GLONASS): $GNRMC,143909.00,A,5107.0020216,N,11402.3294835,W,0.036,348.3,210307,0.0,E,A*31
See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
Field Structure
Field Description
Symbol
Example
1
$GPRMC
Log header. See Messages on page 25 for more information.
$GPRMC
2
utc
UTC of position
hhmmss.ss 144326.00
OEM7 Commands and Logs Reference Manual v10
535
Chapter 3 Logs
Field Structure
Field Description
Symbol
3
pos status
Position status (A = data valid, V = data invalid)
A
4
lat
Latitude (DDmm.mm)
llll.ll
5
lat dir
Latitude direction: (N = North, S = South)
a
6
lon
Longitude (DDDmm.mm)
yyyyy.yy
7
lon dir
Longitude direction: (E = East, W = West)
a
8
speed Kn Speed over ground, knots
x.x
9
track true Track made good, degrees True
x.x
10
date
Date: dd/mm/yy
xxxxxx
Magnetic variation, degrees
Note that this field is the actual magnetic
11
mag var variation and will always be positive. The
x.x
direction of the magnetic variation is always
positive.
12
var dir
Magnetic variation direction E/W
Easterly variation (E) subtracts from True
a
course.
Westerly variation (W) adds to True course.
Positioning system mode indicator, see Table
13
mode ind 101: NMEA Positioning System Mode Indicator a
on page 534
14
*xx
Check sum
*hh
15
[CR][LF] Sentence terminator
Example A 5107.0017737 N 11402.3291611 W 0.080 323.3 210307
0.0
E
A *20 [CR][LF]
OEM7 Commands and Logs Reference Manual v10
536
Chapter 3 Logs
3.58 GPSCNAVRAWMESSAGE
GPS CNAV Raw Message
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This log provides the raw CNAV message from signals which contain the CNAV message (L2C, L5). It also indicates whether the raw message is generated from an L2C signal or L5 signal. The GPSCNAVRAWMESSAGE log is not output by default. To receive this log, data decoding for L2C or L5 must be enabled using the DATADECODESIGNAL command (see page 115) for the specific signal.
Message ID: 2262
Log Type: Asynch
Recommended Input: log gpscnavrawmessagea onnew
ASCII Example: #GPSCNAVRAWMESSAGEA,COM1,0,82.5,SATTIME,2020,252582.000,02000020,06c3,32768; 185,8,GPSL5,11,8b20b52391ac86ea3ac949e16706c0b2e089dff9600320045e2013a780317 1003c2f11485870*35aaa6c3 #GPSCNAVRAWMESSAGEA,COM1,0,81.5,SATTIME,2020,252576.000,02000020,06c3,32768; 178,10,GPSL2C,10,8b28a52390fc85777dad008893a00013232e8fffeb5c6df0cd300fa631c 636ac8b5c643a7ce0*1db60694
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
GPSCNAVRAWMESSAGE Log header. See Messages on
header
page 25 for more information.
H
0
2
signal channel
Signal channel providing the bits Ulong 4
H
3
PRN
Satellite PRN number
Ulong 4
H+4
4
signal type
Signal type (L2C or L5)
See Table 102: Signal Type on the next page
Enum 4
H+8
5
message ID
Message ID
Ulong 4
H+12
6
data
Raw message data
Hex[38] 38
H+16
7
xxxx
32-bit CRC (ASCII and binary only)
Hex
4
H+54
8
[CR][LF]
Sentence terminator (ASCII only) �
�
�
OEM7 Commands and Logs Reference Manual v10
537
Chapter 3 Logs
Table 102: Signal Type
Value (Binary) Signal (ASCII)
Description
33
GPSL1CA
GPS L1 C/A-code
47
GPSL1CP
GPS L1C P-code
68
GPSL2Y
GPS L2 P(Y)-code
69
GPSL2C
GPS L2 C/A-code
70
GPSL2P
GPS L2 P-code
103
GPSL5
GPS L5
2177
GLOL1CA
GLONASS L1 C/A-code
2211
GLOL2CA
GLONASS L2 C/A-code
2212
GLOL2P
GLONASS L2 P-code
2662
GLOL3
GLONASS L3
4129
SBASL1
SBAS L1
4194
SBASL5
SBAS L5
10433
GALE1
Galileo E1
10466
GALE5A
Galileo E5A
10499
GALE5B
Galileo E5B
10532
GALALTBOC
Galileo ALT-BOC
10565
GALE6C
Galileo E6C
10572
GALE6B
Galileo E6B
12673
BDSB1D1
BeiDou B1 with D1 navigation data
12674
BDSB1D2
BeiDou B1 with D2 navigation data
12803
BDSB2D1
BeiDou B2 with D1 navigation data
12804
BDSB2D2
BeiDou B2 with D2 navigation data
12877
BDSB3D1
BeiDou B3 with D1 navigation data
12880
BDSB3D2
BeiDou B3 with D2 navigation data
12979
BDSB1C
BeiDou B1C
13012
BDSB2A
BeiDou B2a
14753
QZSSL1CA
QZSS L1 C/A-code
OEM7 Commands and Logs Reference Manual v10
538
Chapter 3 Logs
Value (Binary) Signal (ASCII)
Description
14760
QZSSL1CP
QZSS L1C P-code
14787
QZSSL2CM
QZSS L2 C/A-code
14820
QZSSL5
QZSS L5
14891
QZSSL6P
QZSS L6P
19073
NAVICL5SPS
NavIC L5 SPS
OEM7 Commands and Logs Reference Manual v10
539
Chapter 3 Logs
3.59 GPSEPHEM
Decoded GPS ephemerides
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains a single set of GPS ephemeris parameters.
Message ID: 7
Log Type: Asynch
Recommended Input: log gpsephema onchanged
ASCII Example: #GPSEPHEMA,COM1,12,59.0,SATTIME,1337,397560.000,02000000,9145,1984;3,397560.0,0 ,99,99,1337,1337,403184.0,2.656004220e+07,4.971635660e-09,2.752651501e+00,7.1111434372e-03,6.0071892571e-01,2.428889275e-06,1.024827361e05,1.64250000e+02,4.81562500e+01,1.117587090e-08,-7.078051567e08,9.2668266314e-01,-1.385772009e-10,-2.098534041e+00,-8.08319384e09,99,403184.0,-4.190951586e-09,2.88095e-05,3.06954e12,0.00000,TRUE,1.458614684e-04,4.00000000e+00*0f875b12 #GPSEPHEMA,COM1,11,59.0,SATTIME,1337,397560.000,02000000,9145,1984;25,397560.0, 0,184,184,1337,1337,403200.0,2.656128681e+07,4.897346851e09,1.905797220e+00,1.1981436634e-02,-1.440195331e+00,-1.084059477e06,6.748363376e-06,2.37812500e+02,-1.74687500e+01,1.825392246e-07,1.210719347e-07,9.5008501632e-01,2.171519024e-10,2.086083072e+00,-8.06140722e09,184,403200.0,-7.450580597e-09,1.01652e-04,9.09495e13,0.00000,TRUE,1.458511425e-04,4.00000000e+00*18080b24 ... #GPSEPHEMA,COM1,0,59.0,SATTIME,1337,397560.000,02000000,9145,1984;1,397560.0,0, 224,224,1337,1337,403200.0,2.656022490e+07,3.881233098e09,2.938005195e+00,5.8911956148e-03,-1.716723741e+00,-2.723187208e06,9.417533875e-06,2.08687500e+02,-5.25625000e+01,9.126961231e-08,7.636845112e-08,9.8482911735e-01,1.325055194e-10,1.162012787e+00,-7.64138972e09,480,403200.0,-3.259629011e-09,5.06872e-06,2.04636e12,0.00000,TRUE,1.458588731e-04,4.00000000e+00*97058299
The GPSEPHEM log can be used to monitor changes in the orbits of GPS satellites.
To obtain copies of ICD-GPS-200, refer to the GPS website (www.gps.gov) .
OEM7 Commands and Logs Reference Manual v10
540
Chapter 3 Logs
Field
Field type
Description
1
GPSEPHEM Log header. See Messages on page 25 for more
header
information.
2
PRN
Satellite PRN number
3
tow
Time stamp of subframe 1 (seconds)
4
health
Health status - a 6-bit health code as defined in ICD-GPS-200
5
IODE1
Issue of ephemeris data 1
6
IODE2
Issue of ephemeris data 2
7
week
toe week number (computed from Z count week)
Z count week number. This is the week number
8
z week
from subframe 1 of the ephemeris. The `toe week' (field #7) is derived from this to account
for rollover
9
toe
Reference time for ephemeris (seconds)
10
A
Semi-major axis (metres)
11
N
Mean motion difference (radians/second)
12
M0
Mean anomaly of reference time (radians)
13
ecc
Eccentricity, dimensionless - quantity defined for a conic section where e= 0 is a circle, e = 1 is a parabola, 0<e<1 is an ellipse and e>1 is a hyperbola
14
Argument of perigee (radians) - measurement along the orbital path from the ascending node to the point where the SV is closest to the Earth, in the direction of the SV's motion
15
cuc
Argument of latitude (amplitude of cosine, radians)
16
cus
Argument of latitude (amplitude of sine, radians)
17
crc
Orbit radius (amplitude of cosine, metres)
18
crs
Orbit radius (amplitude of sine, metres)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Double 8
H H+4
Ulong 4
H+12
Ulong 4 Ulong 4
H+16 H+20
Ulong 4
H+24
Ulong 4
Double 8 Double 8 Double 8 Double 8
Double 8
H+28
H+32 H+40 H+48 H+56
H+64
Double 8
H+72
Double 8
Double 8 Double 8 Double 8
H+80
H+88 H+96 H+104
OEM7 Commands and Logs Reference Manual v10
541
Chapter 3 Logs
Field
Field type
19
cic
20
cis
21
I0
22
I0
23
o
24
25
iodc
26
toc
27
tgd
28
af0
29
af1
30
af2
31
AS
Description
Inclination (amplitude of cosine, radians) Inclination (amplitude of sine, radians) Inclination angle at reference time, radians Rate of inclination angle, radians/second Right ascension, radians Rate of right ascension, radians/second Issue of data clock SV clock correction term, seconds Estimated group delay difference, seconds Clock aging parameter (seconds) Clock aging parameter, (seconds/second) Clock aging parameter, (seconds/second/second) Anti-spoofing on: 0 = FALSE 1 = TRUE Corrected mean motion (radians/second)
Format
Binary Bytes
Binary Offset
Double 8
H+112
Double 8
H+120
Double 8
H+128
Double 8
H+136
Double 8
H+144
Double 8 Ulong 4 Double 8 Double 8
H+152 H+160 H+164 H+172
Double 8
H+180
Double 8
H+188
Double 8
H+196
Bool
4
H+204
32
N
This field is computed by the receiver.
Double 8
H+208
User Range Accuracy variance (metres2)
33
URA
The ICD specifies that the URA index transmitted in the ephemerides can be converted to a nominal standard deviation value using an algorithm listed there. We publish the Double 8 square of the nominal value (variance). The correspondence between the original URA index and the value output is shown in Table 103: URA Variance on the next page
34
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
35
[CR][LF] Sentence terminator (ASCII only)
-
-
H+216
H+224 -
OEM7 Commands and Logs Reference Manual v10
542
Chapter 3 Logs
Table 103: URA Variance Index Value (m) A: Standard Deviations (m) Variance: A2 (m2)
0
2.0
4
1
2.8
7.84
2
4.0
16
3
5.7
32.49
4
8
64
5
11.3
127.69
6
16.0
256
7
32.0
1024
8
64.0
4096
9
128.0
16384
10
256.0
65536
11
512.0
262144
12
1024.0
1048576
13
2048.0
4194304
14
4096.0
16777216
15
8192.0
67108864
OEM7 Commands and Logs Reference Manual v10
543
Chapter 3 Logs
3.60 GPVTG
Track made good and ground speed
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the track made good and speed relative to the ground. The GPVTG log outputs these messages without waiting for a valid almanac. Instead, it uses a UTC time, calculated with default parameters. In this case, the UTC time status (see the TIME log on page 855) is set to WARNING since it may not be one hundred percent accurate. When a valid almanac is available, the receiver uses the real parameters. Then the UTC time status is set to VALID.
Message ID: 226
Log Type: Synch
Recommended Input: log gpvtg ontime 1
Example 1 (GPS only): $GPVTG,172.516,T,155.295,M,0.049,N,0.090,K,D*2B
Example 2 (Combined GPS and GLONASS): $GNVTG,134.395,T,134.395,M,0.019,N,0.035,K,A*33
If the NMEATALKER command (see page 251) is set to AUTO, the talker (the first 2 characters after the $ sign in the log header) is set to GP (GPS satellites only), GL (GLONASS satellites only) or GN (satellites from both systems).
See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
Field Structure
Description
1
$GPVTG
Log header. See Messages on page 25 for more information.
2
track true Track made good, degrees True
3
T
True track indicator
Track made good, degrees Magnetic;
4
track mag Track mag = Track true + (MAGVAR correction)
See the MAGVAR command on page 236
Symbol Example
$GPVTG
x.x
24.168
T
T
x.x
24.168
OEM7 Commands and Logs Reference Manual v10
544
Chapter 3 Logs
Field Structure
Description
5
M
Magnetic track indicator
6
speed Kn Speed over ground, knots
7
N
Nautical speed indicator (N = Knots)
8
speed Km Speed, kilometres/hour
9
K
Speed indicator (K = km/hr)
10
mode ind
Positioning system mode indicator, see Table 101: NMEA Positioning System Mode Indicator on page 534
11
*xx
Check sum
12
[CR][LF] Sentence terminator
Symbol Example
M
M
x.x
0.4220347
N
N
x.x
0.781608
K
K
a
A
*hh
*7A
[CR][LF]
OEM7 Commands and Logs Reference Manual v10
545
Chapter 3 Logs
3.61 GPZDA
UTC time and date
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The GPSZDA log outputs the UTC date and time. If no valid almanac is stored in the receiver, a default UTC offset is used to generate the time until a new almanac is downloaded. If the offset is not up-to-date, this initial UTC time may be incorrect until the new almanac is present.
Message ID: 227
Log Type: Synch
Recommended Input: log gpzda ontime 1
Example: $GPZDA,143042.00,25,08,2005,,*6E
See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
Field Structure
Description
Symbol
Example
1
$GPZDA
Log header. See Messages on page 25 for more information.
$GPZDA
2
utc
UTC time status
hhmmss.ss 220238.00
3
day
Day, 01 to 31
xx
15
4
month
Month, 01 to 12
xx
07
5
year
Year
xxxx
1992
Local zone description--not available
6
null
Local time zones are not sup-
ported by OEM7 family
xx
receivers.
Fields 6 and 7 are always
null.
7
null
Local zone minutes description--not available
xx
8
*xx
Check sum
*hh
9
[CR][LF] Sentence terminator
(empty when no data is present)
(empty when no data is present) *6F [CR][LF]
OEM7 Commands and Logs Reference Manual v10
546
Chapter 3 Logs
3.62 HEADING2
Heading information with multiple rovers
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The heading is the angle from True North of the base to rover vector in a clockwise direction. This log can be output at both Master and Rover ends.
An ALIGN capable receiver is required to use this log.
Asynchronous logs, such as HEADING2, should only be logged ONCHANGED or ONNEW otherwise the most current data is not available or included in the output. An example of this occurrence is in the ONTIME trigger. If this trigger is not logged ONNEW or ONCHANGED, it may cause inaccurate time tags.
The HEADING2 log is dictated by the output frequency of the master receiver sending out RTCAOBS2, RTCAOBS3 or NovAtelXObs messages. HEADING2 supports 20 Hz output rate. Ensure sufficient radio bandwidth is available between the ALIGN Master and the ALIGN Rover.
Message ID: 1335
Log Type: Asynch
Recommended Input: log heading2a onnew
ASCII Example: #HEADING2A,COM1,0,39.5,FINESTEERING,1622,422892.200,02040000,f9bf,6521;SOL_ COMPUTED,NARROW_INT,0.927607417,178.347869873,1.3037414550.0,0.261901051,0.391376048,"R222","AAAA",18,17,17,16,0,01,0,33*7be8 36f6
Field
Field type
Description
Binary Binary Binary Format Bytes Offset
1
HEADING2 Log header. See Messages on page 25 for more
header
information.
H
0
2
sol stat
Solution status, see Table 74: Solution Status on page 436
Enum
4
H
3
pos type
Position type, see Table 75: Position or Velocity Type on page 437
Enum
4
H+4
OEM7 Commands and Logs Reference Manual v10
547
Chapter 3 Logs
Field
Field type
Description
Binary Binary Binary Format Bytes Offset
Baseline length in metres
For ALIGN Heading models with position access, this field is -1.
For ALIGN Heading models without position
access, this field is only the decimal portion of
the baseline in metres.
4
length
For ALIGN Relative Positioning models receiving Float
4
corrections from a master with a fixed position,
this field is -1.
For ALIGN Relative Positioning models receiving corrections from a master in moving baseline mode, this field is the complete baseline length in metres.
H+8
5
heading Heading in degrees (0� to 359.999�)
Float
4
H+12
6
pitch
Pitch (�90 degrees)
Float
4
H+16
7
Reserved
Float
4
H+20
8
hdg std dev
Heading standard deviation in degrees
Float
4
H+24
9
ptch std dev
Pitch standard deviation in degrees
Float
4
H+28
Rover Receiver ID
10
rover stn ID
Set using the SETROVERID command (see page 352) on the Rover
e.g. setroverid RRRR
Char[4] 4
H+32
Master Receiver ID
11
Master stn Set using the DGPSTXID command (see page
ID
127) on the Master
Char[4] 4
Default: AAAA
H+36
12
#SVs
Number of satellites tracked
Uchar 1
H+40
13
#solnSVs Number of satellites in solution
Uchar 1
H+41
14
#obs
Number of satellites above the elevation mask angle
Uchar
1
H+42
15
#multi
Number of satellites above the mask angle with L2
Uchar
1
H+43
OEM7 Commands and Logs Reference Manual v10
548
Chapter 3 Logs
Field
Field type
Description
Binary Binary Binary Format Bytes Offset
16
sol source
Solution source (see Table 104: Solution Source below)
Hex
1
H+44
17
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Uchar 1
H+45
18
Galileo and BeiDou sig mask
Galileo and BeiDou signals used mask (see Table 77: Galileo and BeiDou Signal-Used Mask on page 440)
Hex
1
H+46
GPS and GPS and GLONASS signals used mask (see Table
19
GLONASS 76: GPS and GLONASS Signal-Used Mask on
Hex
1
sig mask page 439)
H+47
20
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+48
21
[CR][LF] Sentence terminator (ASCII only)
-
-
-
Table 104: Solution Source
Bit Mask
Description
0-1 0x03 Reserved
2-3 0x0C
Source antenna 0 = Primary antenna 1 = Secondary antenna
4-7 0xF0 Reserved
OEM7 Commands and Logs Reference Manual v10
549
Chapter 3 Logs
3.63 HEADINGRATE
Heading rate information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides rate of change for the heading parameters. The heading is the angle from True North of the base to rover vector in a clockwise direction.
You must have an ALIGN capable receiver to use this log.
Message ID: 1698
Log Type: Asynch
Recommended Input: log headingratea onchanged
ASCII Example: #HEADINGRATEA,UNKNOWN,0,60.0,FINESTEERING,1873,411044.700,02040008,c53a,32768;S OL_COMPUTED,NARROW_INT,0.025000000,0.000000000,0.308837891,0.575313330,0.000000000,1.264251590,1.663657904,0.0,"748M","725U",0 0,0,0,0*66f97b96
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
HEADINGRATE Log header. See Messages on page 25 for
header
more information.
H
0
2
sol stat
Solution status, see Table 74: Solution Status on page 436
Enum 4
H
3
pos type
Position type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+4
4
latency
A measure of the latency in the velocity
time tag in seconds. It should be subtracted Float
4
from the time to give improved results.
H+8
Rate of change of the baseline length in m/s.
5
length rate
For Z ALIGN rovers, this field outputs the
Float
4
decimal portion of the baseline rate.
H+12
6
heading rate Rate of change of the heading in degrees/s Float
4
H+16
7
pitch rate
Rate of change of the pitch in degrees/s
Float
4
H+20
OEM7 Commands and Logs Reference Manual v10
550
Chapter 3 Logs
Field Field type
Description
8
length rate std dev
Baseline rate standard deviation in m/s
9
heading rate std dev
Heading rate standard deviation in degrees/s
10
pitch rate std dev
Pitch rate standard deviation in degrees/s
11
Reserved
Rover Receiver ID
12
rover stn ID
Set using the SETROVERID command (see
page 352) on the Rover receiver. For
example, setroverid RRRR.
Master Receiver ID
13
master stn ID Set using the DGPSTXID command (see
page 127) on the Master receiver. Default:
AAAA
14
sol source
Solution source (see Table 104: Solution Source on page 549)
15
Reserved
16
Reserved
17
Reserved
18
xxxx
32-bit CRC (ASCII and Binary only)
19
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Float
4
H+24
Float
4
H+28
Float
4
Float
4
H+32 H+36
Uchar 4
H+40
Uchar 4
H+44
Hex
1
Uchar 1
Uchar 1
Uchar 1
Hex
4
-
-
H+48
H+49 H+50 H+51 H+52 -
OEM7 Commands and Logs Reference Manual v10
551
Chapter 3 Logs
3.64 HEADINGSATS
Satellite used in heading solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides information on the satellites that are used in a heading solution.
The HEADINGSATS log can only be used from the ALIGN rover.
Message ID: 1316
Log Type: Asynch
Recommended Input: log headingsatsa onnew
ASCII Example: #HEADINGSATSA,COM1,0,26.0,FINESTEERING,1625,344654.600,02000008,f5b0,6569;17,GP S,31,GOOD,00000003,GPS,23,GOOD,00000003,GPS,30,GOOD,00000003,GPS,16,GOOD,000000 03,GPS,20,GOOD,00000003,GPS,25,GOOD,00000003,GPS,4,GOOD,00000003,GPS,24,GOOD,00 000003,GPS,11,GOOD,00000003,GPS,32,GOOD,00000003,GPS,14,GOOD,00000003,GLONASS,2 0+2,GOOD,00000003,GLONASS,14-7,GOOD,00000001,GLONASS,24,GOOD,00000003,GLONASS,13-2,GOOD,00000003,GLONASS,121,GOOD,00000003,GLONASS,19+3,GOOD,00000001*15ec53a6
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
HEADINGSATS
Log header. See Messages on page 25 for more information.
H
0
2
#entries
Number of records to follow
Ulong 4
H
3
System
Refer to Table 105: Satellite System on the next page.
Enum
4
H+4
OEM7 Commands and Logs Reference Manual v10
552
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
In binary logs, the satellite ID field is 4
bytes. The 2 lowest-order bytes,
interpreted as a USHORT, are the system
identifier: for instance, the PRN for GPS,
or the slot for GLONASS. The 2 highest-
order bytes are the frequency channel for
GLONASS, interpreted as a SHORT and
4
Satellite ID
zero for all other systems.
Ulong 4
In ASCII and abbreviated ASCII logs, the satellite ID field is the system identifier. If the system is GLONASS and the frequency channel is not zero, then the signed channel is appended to the system identifier. For example, slot 13, frequency channel -2 is output as 13-2
H+8
5
Status
see Table 80: Observation Statuses on page 443
Enum
4
H+12
see
Table 81: BESTSATS GPS Signal Mask on
page 444,
Table 82: BESTSATS GLONASS Signal
6
Signal Mask Mask on page 445,
Hex
4
Table 83: BESTSATS Galileo Signal Mask
on page 445,
Table 84: BESTSATS BeiDou Signal Mask
on page 445
H+16
7
Next satellite offset = H + 4 + (#sat x 16)
8
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+4+ (#satx16)
9
[CR][LF]
Sentence Terminator (ASCII only)
-
-
-
Table 105: Satellite System
Binary Value ASCII Mode Name
0
GPS
1
GLONASS
2
SBAS
5
Galileo
OEM7 Commands and Logs Reference Manual v10
553
Chapter 3 Logs
Binary Value ASCII Mode Name
6
BeiDou
7
QZSS
9
NAVIC
OEM7 Commands and Logs Reference Manual v10
554
Chapter 3 Logs
3.65 HWMONITOR
Monitor hardware levels
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log allows the user to monitor temperature, antenna current and voltages.
Message ID: 963
Log Type: Polled
Recommended Input: log hwmonitora ontime 10
ASCII Example: #HWMONITORA,COM1,0,90.5,FINESTEERING,1928,153778.000,02000020,52db,32768;7,43.2 84492493,100,0.000000000,200,5.094994068,700,1.195970654,800,3.279609442,f00,1. 811965823,1100,44.017093658,1600*52beac4b
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
HWMONITOR header
Log header. See Messages on page 25 for more information.
H
0
2
#
Number of measurements to
measurements follow
Ulong
4
H
3
reading
4
status
Temperature, antenna current or voltage reading Units:
l Degree Celsius for Temperature
l Amps for Antenna Current l Volts for Voltage
See Table 106: HWMONITOR Status Table on the next page
Float
4
HexUlong 4
H+4 H+8
5... Next reading offset = H + 4 + (# measurements x 8)
6
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+4+ (# measurements x 8)
7
[CR][LF]
Sentence Terminator (ASCII only) -
-
-
OEM7 Commands and Logs Reference Manual v10
555
Chapter 3 Logs
Table 106: HWMONITOR Status Table
Bits
Description
Boundary Limit Status (Hex): 0x00 = Value falls within acceptable bounds 0x01 = Value is under the lower warning limit
0-7 0x02 = Value is under the lower error limit 0x03 = Value is over the upper warning limit 0x04 = Value is over the upper error limit
8- Reading Type (Hex): 15
0x00 = Reserved
0x01 = Temperature A temperature sensor is located on the receiver and provides the approximate temperature of the PCB surface near critical components (for example, CPU, TCXO) (degrees Celsius)
0x02 = Antenna Current The amount of current being drawn by the active antenna (mA)
0x06 = Digital Core 3V3 Voltage Internal regulator output voltage supplying a key component on the receivers (Volts) 0x06 = 3.3V Supply Voltage (Volts)
0x07 = Antenna Voltage
0x08 = Digital 1V2 Core Voltage Internal regulator output voltage supplying a key component on the receiver (Volts)
0x0F = Regulated Supply Voltage Internal regulator output voltage supplying a key component on the receiver (Volts)
0x0F = Supply Voltage Voltage applied to Pins 1 and 2 of the main connector
0x11 = 1V8
Applicable Platforms
All All except OEM7500 All except OEM7720 OEM7720 All except OEM7500 All All except OEM7720 OEM7720 All
OEM7 Commands and Logs Reference Manual v10
556
Chapter 3 Logs
Bits
Description
0x16 = Secondary Temperature A second temperature sensor is located on the receiver PCB (degrees Celsius)
0x17 = Peripheral Core Voltage
0x18 = Secondary Antenna Current
0x19 = Secondary Antenna Voltage
Applicable Platforms
All except OEM7500
All except OEM7500
OEM7720, PwrPak7D, PwrPak7D-E1, SPAN CPT7
OEM7720, PwrPak7D, PwrPak7D-E1, SPAN CPT7
OEM7 Commands and Logs Reference Manual v10
557
Chapter 3 Logs
3.66 IONUTC
Ionospheric and UTC data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the Ionospheric Model parameters (ION) and the Universal Time Coordinated parameters (UTC).
Message ID: 8
Log Type: Asynch
Recommended Input: log ionutca onchanged
ASCII Example: #IONUTCA,COM1,0,58.5,FINESTEERING,1337,397740.107,02000000,ec21,1984;1.21071934 7000122e-08,2.235174179077148e-08,-5.960464477539062e-08,-1.192092895507812e07,1.003520000000000e+05,1.146880000000000e+05,-6.553600000000000e+04,3.276800000000000e+05,1337,589824,-1.2107193470001221e-08,-3.907985047e14,1355,7,13,14,0*c1dfd456
The Receiver-Independent Exchange (RINEX1a) format is a broadly accepted, receiver independent format for storing GPS data. It features a non-proprietary ASCII file format that can be used to combine or process data generated by receivers made by different manufacturers. Use the NovAtel's Convert utility to produce RINEX files from NovAtel receiver data files. For the best results, the NovAtel receiver input data file should contain the logs as specified in the NovAtel Firmware and Software chapter of the OEM7 Installation and Operation User Manual including IONUTC.
Field
Field type
1
IONUTC header
2
a0
3
a1
4
a2
5
a3
Description
Log header. See Messages on page 25 for more information. Alpha parameter constant term Alpha parameter 1st order term Alpha parameter 2nd order term Alpha parameter 3rd order term
Format
Binary Bytes
Binary Offset
H
0
Double 8 Double 8 Double 8 Double 8
H H+8 H+16 H+24
aRefer to the U.S. National Geodetic Survey website at: www.ngs.noaa.gov/CORS/data.shtml. OEM7 Commands and Logs Reference Manual v10
558
Chapter 3 Logs
Field
Field type
Description
6
b0
Beta parameter constant term
7
b1
Beta parameter 1st order term
8
b2
Beta parameter 2nd order term
9
b3
Beta parameter 3rd order term
10
utc wn
UTC reference week number
11
tot
Reference time of UTC parameters
12
A0
UTC constant term of polynomial
13
A1
UTC 1st order term of polynomial
14
wn lsf
Future week number
15
dn
Day number (the range is 1 to 7 where Sunday = 1 and Saturday = 7)
16
deltat ls Delta time due to leap seconds
17
deltat lsf Future delta time due to leap seconds
18
Reserved
19
xxxx
32-bit CRC (ASCII and Binary only)
20
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Double 8
Double 8
Double 8
Double 8
Ulong 4
Ulong 4
Double 8
Double 8
Ulong 4
Binary Offset H+32 H+40 H+48 H+56 H+64 H+68 H+72 H+80 H+88
Ulong 4
H+92
Long
4
Long
4
4
Hex
4
-
-
H+96 H+100 H+104 H+108 -
OEM7 Commands and Logs Reference Manual v10
559
Chapter 3 Logs
3.67 IPSTATS
IP statistics
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This log contains the current IP interface statistics.
Message ID: 1669
Log Type: Polled
Recommended Input: log ipstatsa
ASCII Example: #IPSTATSA,COM1,0,70.5,FINESTEERING,1749,328376.337,02000020,0d94,45068;1,CELL,0 ,526,526*01c4847c
Field
Field Type
Description
1
IPSTATS header
Log header. See Messages on page 25 for more information.
2
#Interface Number of records to follow.
IP Interface Type
3
Physical Interface
1 = ALL
2 = ETHA
4
Reserved
5
Receive Bytes
Total number of bytes received
6
Transmit Bytes
Total number of bytes transmitted
7
Next reading offset = H+4+(#Interface * 16)
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
Enum 4
H+4
Ulong 4 Ulong 4 Ulong 4
H+8 H+12 H+16
Hex
4
-
-
H+4+ (#Interface * 16)
-
OEM7 Commands and Logs Reference Manual v10
560
Chapter 3 Logs
3.68 IPSTATUS
Current network configuration status
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This log provides the configuration of IP address, netmask, gateway and a list of DNS servers currently in use.
Message ID: 1289
Log Type: Polled
Recommended Input: log ipstatusa once
ASCII Example: #IPSTATUSA,COM1,0,90.5,FINESTEERING,1609,500464.121,02000000,7fe2,6259;1,ETHA," 10.4.44.131","255.255.255.0","10.4.44.1",1,"198.161.72.85"*ec22236c
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
IPSTATUS Header
Log header. See Messages on page 25 for more information.
-
H
0
2
#IPrec
Number of records to follow
Ulong 4
H
Name of the network interface
3
interface
2 = ETHA
Enum 4
H+4
4
IP address IP Address-decimal dot notation
5
netmask
Netmask-decimal dot notation
String [16]
String [16]
variable
1
H+8
variable
1
H+24
Gateway-decimal dot notation
6
gateway
This is the default gateway that is
currently in use by the receiver.
String [16]
variable
1
H+40
7... Next reading offset = H+4+(#IPrec * 52)
8
#dnsserver Number of DNS Servers to follow
Ulong 4
H+4+ (#IPrec x 52)
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
561
Chapter 3 Logs
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
9
server IP address
IP address-decimal dot notation
String [16]
variable
1
H+4+ (#IPrec x 52)+4
10... Next reading offset = H+4+(#IPrec * 52)+4+(#dnsserver * 16)
11
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+4+ (#IPrec x 52)+4+ (#dnsserver x 16)
12
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
562
Chapter 3 Logs
3.69 ITBANDPASSBANK
Allowable band pass filter configurations
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The ITBANDPASSBANK log provides information on the allowable configurations for each frequency when applying a bandpass filter. The current filters in use can be seen with the ITFILTTABLE log on page 567.
Message ID: 2022
Log Type: Asynch
Recommended Input: log itbandpassbanka once
Abbreviated ASCII Example: <ITBANDPASSBANK USB1 0 87.5 FINESTEERING 1933 346809.694 12000020 fb2e 14137 5 GPSL5 1164.3750 1173.1250 1178.1250 1186.8750 0.05 GALILEOE5B 1195.6250 1204.3750 1209.3750 1218.1250 0.05 BEIDOUB1 1551.2500 1560.0000 1565.0000 1573.7500 0.05 BEIDOUB2 1195.6250 1204.3750 1209.3750 1218.1250 0.05 QZSSL5 1164.3750 1173.1250 1178.1250 1186.8750 0.05
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
ITBANDPASSBANK Log header. See Messages on
header
page 25 for more information.
-
H
0
2
# of entries
Number of entries to follow
Ulong 4
H
3
frequency
See Table 49: Frequency Types on page 219
Enum
4
H+4
4
min lower frequency cutoff
The minimum frequency cutoff at the lower end (MHz)
Float
4
H+8
5
max lower frequency cutoff
The maximum frequency cutoff at the lower end (MHz)
Float
4
H+12
6
min upper frequency cutoff
The minimum frequency cutoff at the upper end (MHz)
Float
4
H+16
7
max upper frequency cutoff
The maximum frequency cutoff at the upper end (MHz)
Float
4
H+20
8
frequency step
The minimum cut off frequency resolution (MHz)
Float
4
H+24
OEM7 Commands and Logs Reference Manual v10
563
Chapter 3 Logs
Field
Field Type
Description
9
Next entry offset = H + 4 + (#entries * 24)
10
xxxx
32-bit CRC (ASCII and Binary only)
11
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
-
-
H+4+ (#entries * 24)
-
OEM7 Commands and Logs Reference Manual v10
564
Chapter 3 Logs
3.70 ITDETECTSTATUS
Interference detection status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists all of the detected interferences from all active paths where interference detection is enabled.
This log should be used with the onchanged trigger only.
Message ID: 2065
Log Type: Asynch
Recommended Input: log itdetectstatusa onchanged
ASCII Example #ITDETECTSTATUSA,USB2,0,74.0,FINESTEERING,1982,430605.267,0200c000,7fdb,32768; 3, L1,STATISTICANALYSIS,-0.718,29.167,0.126,12.797,00000000,00000000,00000000, L2,SPECTRUMANALYSIS,1249.961,71.191,-56.769,132.907,00000000,00000000,00000000, L2,SPECTRUMANALYSIS,1289.512,1.978,-75.967,138.493,00000000,00000000,00000000*5e83b175
Field
Field Type
Description
1
ITDETECTSTATUS Log header. See Messages on page 25
header
for more information.
2
# of entries
Number of interferences to follow
3
RF Path
RF path for this entry. 2 = L1 3 = L2 5 = L5
Interference detection type for this
4
Interference detection type
entry. 0 = SPECTRALANALYSIS
1 = STATISTICALANALYSIS
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Enum 4
H+4
Enum 4
H+8
OEM7 Commands and Logs Reference Manual v10
565
Chapter 3 Logs
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
5
Parameter 1
The first parameter of the interference.
For SPECTRALANALYSIS type, this is the center frequency in MHz.
Float
4
For STATISTICALANALYSIS type, this is reserved.
H+12
6
Parameter 2
The second parameter of the interference.
For SPECTRALANALYSIS type, this is the bandwidth in MHz.
Float
4
For STATISTICALANALYSIS type, this is reserved.
H+16
7
Parameter 3
The third parameter of the interference.
For SPECTRALANALYSIS type, this is
the estimated power in dBm of the
Float
4
interference.
For STATISTICALANALYSIS type, this is reserved.
H+20
8
Parameter 4
The fourth parameter of the interference.
For SPECTRALANALYSIS type, this is
the highest estimated power spectrum Float
4
density in dBmHz of the interference.
For STATISTICALANALYSIS type this is reserved.
H+24
9
Reserved 1
Reserved
Ulong 4
H+28
10
Reserved 2
Reserved
Ulong 4
H+32
11
Reserved 3
Reserved
Ulong 4
H+36
12
Next interference signal offset = H + 4 + (#entries * 36)
13
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H=4+ (#entries * 36)
14
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
566
Chapter 3 Logs
3.71 ITFILTTABLE
Filter configuration for each frequency
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The ITFILTTABLE log contains the filter configuration summary for each frequency. It lists which bandpass or notch filters are enabled and how each is configured.
Message ID: 1991
Log Type: Asynch
Recommended Input: log itfilttablea once
ASCII Example: #ITFILTTABLEA,USB2,0,80.5,FINESTEERING,1923,232588.825,12000000,35d0,32768; 13, GPSL1,8,CIC3,00000001,DISABLE,0.0000,0.0000,1, ENABLE,PF0,NOTCHFILTER,1572.2500,1577.7500,1.000, GPSL2,4,CIC3,00000000,DISABLE,0.0000,0.0000,0, GLONASSL1,9,CIC3,00000000,DISABLE,0.0000,0.0000,0, GLONASSL2,5,CIC3,00000000,DISABLE,0.0000,0.0000,0, GPSL5,0,CIC3,00000000,DISABLE,0.0000,0.0000,0, ... QZSSL1,8,CIC3,00000001,DISABLE,0.0000,0.0000,1, ENABLE,PF0,NOTCHFILTER,1572.2500,1577.7500,1.000, QZSSL2,4,CIC3,00000000,DISABLE,0.0000,0.0000,0, QZSSL5,0,CIC3,00000000,DISABLE,0.0000,0.0000,0*3ca84167
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
ITFILTTABLE Log header. See Messages on page 25 for
header
more information.
-
H
0
2
# entries
Number of records with information to follow Ulong 4
H
3
frequency
The frequency at which the filter is applied. See Table 49: Frequency Types on page 219
Enum
4
H+4
4
Encoder ID ID of the digital path used by this frequency Ulong 4
H+8
5
DDC filter type
The DDC filter type (see Table 107: DDC Filter Type on page 569)
Enum 4
H+12
OEM7 Commands and Logs Reference Manual v10
567
Chapter 3 Logs
Field Field Type
Description
Filter warning limit status. Raise a warning
flag if the filter is placed too close to the
6
status word center frequency of the GNSS signal (see
Table 108: ITFILTTable Status Word on the
next page)
7
switch
Filter is enabled or disabled (see Table 109: Filter Switches on page 570)
8
lower cut off frequency
Cut off frequency at the lower end (MHz)
9
upper cut off frequency
Cut off frequency at the upper end (MHz)
10
# prog filters
Number of programmable filters applied
11
switch
Filter is enabled or disabled (see Table 109: Filter Switches on page 570)
12
prog filter ID
The programmable filter ID (see Table 46: Programmable Filter ID on page 216)
13
mode
Programmable filter mode (notch filter or bandpass) (see Table 47: Programmable Filter Mode on page 216)
14
lower cut off frequency
Cut off frequency at the lower end (MHz)
15
upper cut off frequency
Cut off frequency at the upper end (MHz)
16
notch width Width of notch filter (MHz)
17
Next programmable filter � variable binary offset
18
Next frequency � variable binary offset
19
xxxx
32-bit CRC (ASCII and Binary only)
20
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+16
Enum 4
Float
4
Float
4
Ulong 4
Enum 4
Enum 4
Enum 4
Float
4
Float
4
Float
4
H+20 H+24 H+28 H+32 H+36 H+40 H+44 H+48 H+52 H+56
Ulong 4
-
-
variable -
OEM7 Commands and Logs Reference Manual v10
568
Chapter 3 Logs
Table 107: DDC Filter Type
Binary
ASCII
0
PASSTHROUGH
1
CIC1
2
CIC2
3
CIC3
4
HALFBAND
Table 108: ITFILTTable Status Word
Nibble Bit
Mask
Description
Range Value
0 0x00000001
1 0x00000002 N0
2 0x00000004
3 0x00000008 First enabled filter
4 0x00000010
0 = Within acceptable limit 1 = Warning
5 0x00000020 N1
6 0x00000040
7 0x00000080
8 0x00000100
9 0x00000200 N2
10 0x00000400
11 0x00000800
0 = Within acceptable limit
Second enabled filter
12 0x00001000
1 = Warning
13 0x00002000 N3
14 0x00004000
15 0x00008000
OEM7 Commands and Logs Reference Manual v10
569
Chapter 3 Logs
Nibble Bit
Mask
Description
Range Value
16 0x00010000
17 0x00020000 N4
18 0x00040000
19 0x00080000 Third enabled filter
20 0x00100000
0 = Within acceptable limit 1 = Warning
21 0x00200000 N5
22 0x00400000
23 0x00800000
24 0x01000000
25 0x02000000 N6
26 0x04000000
27 0x08000000
0 = Within acceptable limit
Fourth enabled filter
28 0x10000000
1 = Warning
29 0x20000000 N7
30 0x40000000
31 0x80000000
Table 109: Filter Switches
Binary Value ASCII Value Description
0
DISABLE
Filter disabled
1
ENABLE
Filter enabled
OEM7 Commands and Logs Reference Manual v10
570
Chapter 3 Logs
3.72 ITPROGFILTBANK
Allowable filter configurations
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The ITPROGFILTBANK log provides information on the allowable configurations for the programmable filter for each frequency when applying either a notch filter or bandpass filter. The current filters in use can be seen with the ITFILTTABLE log on page 567.
Message ID: 2023
Log Type: Asynch
Recommended Input: log itprogfiltbanka once
Abbreviated ASCII Example: <ITPROGFILTBANK USB1 0 88.0 FINESTEERING 1933 346362.985 12000020 3696 14137 12
GPSL1 5 NOTCHFILTER 1563.0000 1574.0000 1576.0000 1587.0000 0.05 0.15 NOTCHFILTER 1563.7500 1573.6000 1576.4000 1586.2500 0.05 0.50 NOTCHFILTER 1564.0500 1573.3000 1576.7000 1585.9500 0.05 1.00 NOTCHFILTER 1565.7500 1571.7000 1578.3000 1584.2500 0.05 2.50 BANDPASSFILTER 1563.7500 1572.5000 1577.5000 1586.2500 0.05 0.00
GPSL2 5 NOTCHFILTER 1215.5000 1226.5000 1228.5000 1239.5000 0.05 0.15 NOTCHFILTER 1216.2500 1226.1000 1228.9000 1238.7500 0.05 0.50 NOTCHFILTER 1216.5500 1225.8000 1229.2000 1238.4500 0.05 1.00 NOTCHFILTER 1218.2500 1224.2000 1230.8000 1236.7500 0.05 2.50 BANDPASSFILTER 1216.2500 1225.0000 1230.0000 1238.7500 0.05 0.00
GLONASSL1 5 NOTCHFILTER 1589.5625 1600.5625 1602.5625 1613.5625 0.05 0.15 NOTCHFILTER 1590.3125 1600.1625 1602.9625 1612.8125 0.05 0.50 NOTCHFILTER 1590.6125 1599.8625 1603.2625 1612.5125 0.05 1.00 NOTCHFILTER 1592.3125 1598.2625 1604.8625 1610.8125 0.05 2.50 BANDPASSFILTER 1590.3125 1599.0625 1604.0625 1612.8125 0.05 0.00
...
Field Field Type
Description
1
ITPROGFILTBANK Log header. See Messages on page 25
header
for more information.
2
# entries
Number of entries to follow
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
571
Chapter 3 Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
3
frequency
See Table 49: Frequency Types on page 219
Enum 4
H+4
4
# prog filters
Number of programmable filters applied with information to follow
Ulong 4
H+8
5
mode
Programmable filter mode (notch filter
or bandpass) (see Table 47: Programmable Filter
Enum 4
Mode on page 216)
H+12
6
min lower
The minimum frequency cutoff at the
frequency cutoff lower end (MHz)
Float
4
H+16
7
max lower
The maximum frequency cutoff at the
frequency cutoff lower end (MHz)
Float
4
H+20
8
min upper
The minimum frequency cutoff at the
frequency cutoff upper end (MHz)
Float
4
H+24
9
max upper
The maximum frequency cutoff at the
frequency cutoff upper end (MHz)
Float
4
H+28
10
frequency step
The minimum cut off frequency resolution (MHz)
Float
4
H+32
11
notch width
Width of notch filter (MHz)
Float
4
H+36
12
Next programmable filter � variable binary offset
13
Next frequency � variable binary offset
14
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
variable
15
[CR][LF]
Sentence terminator (ASCII only)
OEM7 Commands and Logs Reference Manual v10
572
Chapter 3 Logs
3.73 ITPSDFINAL
Processed power spectral density
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The ITPSDFINAL log contains the samples for the spectral analysis. The rate and size is set by the update period and the FFT size respectively when issuing the ITSPECTRALANALYSIS command (see page 217).
PSD samples are compressed into 2 byte samples to reduce log sizes. The range of values that can be displayed is -200 dBm to +56 dBm with a 1/256 resolution. The following steps should be performed on the PSD samples in this log to convert them back into dBm units for display purposes:
1. Divide the sample by 256.0
2. Subtract 200
The number of samples are calculated according to the following table. The maximum number of samples in one ITPSDFINAL log is 1024. That means if the number of samples is less than 1024, one log is enough to output them. However, if the number of samples is larger than 1024, more than one ITPSDFINAL log is needed. For example, in postdecimation mode with the FFT size of 8K and subcarrier integration of 5, there is one log with 1024 samples and another log with 614 samples. The output logs can be grouped together through the sequence number of the log header.
Data Source
Number of Samples
PREDECIMATION FFTsize/(2*subcarrier_integration )
POSTDECIMATION FFTsize/subcarrier_integration
POSTFILTER
FFTsize/subcarrier_integration
As the data rate for the ITPSDFINAL log is dictated by the updateperiod parameter in the ITSPECTRALANALYSIS command (see page 217), do not use ONTIME to log this message. Instead use ONNEW to log ITPSDFINAL.
The pre-decimation spectrum shows the absolute power in dBm. The post-decimation and post-filter spectrum shows the signal magnitude in relative power (dB).
The reported spectrum level can be interpreted in an unit of dBm / RBW (resolution bandwidth) referred to the receiver input. For the L1/L2/L5 path, RBW in Hz = 2e8 / FFT size.
Message ID: 1968
Log Type: Asynch
OEM7 Commands and Logs Reference Manual v10
573
Chapter 3 Logs
Recommended Input: log itpsdfinala onnew
ASCII Example #ITPSDFINALA,UNKNOWN,0,66.0,FINESTEERING,1891,166978.221,02040000,b79a,32768;13 10752,1531.250,195312.500,512,28033,30370,30225,29190,27254,29521,32694,33025,2 8553,28902,29060,26663,30267,30054, ... 34027,38038,31082,29418,28805,27373,27869,28847,28331,31901,30251,33625,33625*0 00b928d
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
ITPSDFINAL Log header. See Messages on page 25 for
header
more information.
-
H
0
Status word containing information about the
2
status word
configuration of the spectral analysis (see Table 110: Spectral Analysis Status Word on
Ulong
4
H
the next page)
3
frequency start
Frequency represented by first data sample (MHz)
Float
4
H+4
4
step size
Frequency step for each subsequent data sample (Hz)
Float
4
H+8
5
# samples Number of spectral density samples
Ulong 4
H+12
6
sample
Power spectral density sample
Ushort 2
H+16
7
Next sample = H+16+(2*#samples)
8
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+16+ (2*# samples)
9
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
574
Chapter 3 Logs
Table 110: Spectral Analysis Status Word
Nibble Bit
Mask
Description
Range Value
0 0x00000001
1 0x00000002 N0
2 0x00000004 Frequency
3 0x00000008
0 � 20 See Table 49: Frequency Types on page 219
4 0x00000010
5 0x00000020 N1
6 0x00000040 Data Source
7 0x00000080
0�3
See Table 48: Data Sources for PSD Samples on page 218
8 0x00000100
9 0x00000200 FFT Size N2
10 0x00000400
0�6 See Table 50: FFT Sizes on page 220
11 0x00000800
12 0x00001000
N3
13 0x00002000 Integration
14 0x00004000 Window
1 � 1024 samples
15 0x00008000
16 0x00010000
17 0x00020000 N4
18 0x00040000
19 0x00080000
20
0x00100000
Time Average Window
0 � 100 seconds
21 0x00200000 N5
22 0x00400000
23 0x00800000
OEM7 Commands and Logs Reference Manual v10
575
Chapter 3 Logs
Nibble Bit
Mask
Description
24 0x01000000
25 0x02000000 N6
26 0x04000000
27 0x08000000
28 0x10000000 Reserved
29 0x20000000 N7
30 0x40000000
31 0x80000000
Range Value
OEM7 Commands and Logs Reference Manual v10
576
Chapter 3 Logs
3.74 J1939STATUS
Status of CAN J1939 Node
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This logs reports the status of J1939 node, specifically J1939 Address Claim function (initiated using the J1939CONFIG command (see page 221)). This log displays the status only for nodes that have been set.
Message ID: 1907
Log Type: Asynch
Recommended Input: LOG J1939STATUSA ONCHANGED
ASCII Examples: #J1939STATUSA,COM1,1,81.0,UNKNOWN,0,0.000,02004020,e9ce,32768;NODE1,DISABLED,0, FE*637c7f #J1939STATUSA,COM1,0,81.0,UNKNOWN,0,0.000,02004020,e9ce,32768;NODE2,DISABLED,0, FE*c41af5ee
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
J1939STATUS Log header. See Messages on page 25 for
header
more information.
-
H
0
2
node
J1939 Node. The node can be either NODE1 or NODE2.
Enum
4
H
3
status
Node status. See Table 111: Node Status on the next page
Enum
4
H+4
4
count
Number of attempts that were made to claim address.
This will be 1 when the preferred address is Ulong 4 used and may be more if the alternate range is used.
H+8
5
address
Claimed CAN Address.
0xFE (NULL address) if the address could not Uchar 1 be negotiated.
H+12
6
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+13
7
[CR][LF]
Sentence Terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
577
Chapter 3 Logs
Table 111: Node Status
Value ASCII
Description
1
DISABLED
Address claim activity is not taking place. The node does not have J1939 enabled.
2
CLAIMING Address claim procedure is in progress.
3
CLAIMED Address claimed successfully. Ready for data transfer.
4
FAILED
Address claim was not successful. No further activity is taking place.
OEM7 Commands and Logs Reference Manual v10
578
Chapter 3 Logs
3.75 LBANDBEAMTABLE
List of L-Band beams
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists the TerraStar and Veripos L-Band beams known to the receiver.
Message ID: 1718
Log Type: Asynch
Recommended Input: log lbandbeamtablea onchanged
Abbreviated ASCII Example:
<LBANDBEAMTABLE COM1 0 51.5 UNKNOWN 0 1.031 02000008 19b8 14968
<
7
<
"AORE" "A" 1545855000 1200 -15.50 1
<
"AORW" "B" 1545845000 1200 -54.00 1
<
"IOR" "C" 1545865000 1200 64.50 1
<
"POR" "D" 1545905000 1200 178.00 1
<
"25E" "E" 1545825000 1200 25.00 1
<
"143.5E" "F" 1545835000 1200 143.50 1
<
"98W" "G" 1545865000 1200 -98.00 1
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
LBANDBEAMTABLE Log header. See Messages on page 25
header
for more information.
H
0
2
#entries
Number of records to follow
Ulong 4
H
3
Name
Beam/transmitting satellite name
Char[8] 8
H+4
4
Reserved
Char[8] 8
H+12
5
Frequency
Frequency (Hz)
Ulong 4
H+20
6
Baud
Baud rate (bps)
Ulong 4
H+24
7
Longitude
Transmitting satellite longitude (degrees)
Float
4
H+28
8
Access
Beam service availability flag 0 = Denied 1 = Granted
Ulong 4
H+32
9
Next beam offset = H + 4 + (#entries * 32)
OEM7 Commands and Logs Reference Manual v10
579
Chapter 3 Logs
Field
Field type
10
xxxx
11
[CR][LF]
Description 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+4+ (#entries * 32)
-
-
-
OEM7 Commands and Logs Reference Manual v10
580
Chapter 3 Logs
3.76 LBANDTRACKSTAT
L-Band Beams status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log reports the L-Band tracking and Viterbi decoding status for the tracked L-Band beams.
The maximum logging rate for LBANDTRACKSTAT is 2 Hz.
Message ID: 1201
Log Type: Synch
Recommended Input: log lbandtrackstata ontime 1
ASCII Example: #LBANDTRACKSTATA,COM1,0,39.0,FINESTEERING,2017,242093.000,02000008, 29e3,14968;3, "98W",1545865000,1200,974c,00c2,0,-317.605,38.755,2.7162,186.335, 3520,14,13,450560,1711,0.0038, "AORW",1545845000,1200,974c,00c2,0,-392.937,41.963,3.6840,182.385, 3392,1,1,434176,66,0.0001, "POR",1545905000,1200,974c,00c2,0,-42.481,39.084,2.5597,195.944, 3648,13,13,466944,2524,0.0046*491b53d6
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
LBANDTRACKSTAT Log header. See Messages on page 25
header
for more information.
H
0
2
#entries
Number of records to follow
Ulong 4
H
3
Name
Beam/transmitting satellite name
Char[8] 8
H+4
4
Frequency
Frequency assigned to this L-Band beam (Hz)
Ulong 4
H+12
5
Baud rate
Baud rate of assigned beam
Ushort 2
H+16
6
ID
Service ID of the assigned beam
Ushort 2
H+18
7
Status
Tracking status word. See Table 112: L-Band Signal Tracking Status on the Ushort 2 next page
H+20
8
Reserved
Reserved
Ushort 2
H+22
OEM7 Commands and Logs Reference Manual v10
581
Chapter 3 Logs
Field
Field type
Description
9
Doppler
Signal Doppler (Hz)
10
C/No
Carrier to noise density ratio (dB-Hz)
11
Phase std. dev.
Phase error standard deviation (cycles)
12
Lock time
Lock time (seconds)
13
Unique word bits Total unique word bits
14
Bad unique word bits
Bad unique word bits
15
Bad unique words Bad unique words
16
Viterbi symbols
Total Viterbi symbols
17
Corrected Viterbi Corrected Viterbi symbols
18
Bit error rate
Estimated pre-Viterbi Bit Error Rate (BER)
19
Next entry offset = H + 4 + (#entries x 60)
20
xxxx
32-bit CRC (ASCII and Binary only)
21
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Float
4
H+24
Float
4
H+28
Float
4
H+32
Float
4
Ulong 4
H+36 H+40
Ulong 4
H+44
Ulong 4 Ulong 4 Ulong 4
H+48 H+52 H+56
Float
4
H+60
Hex
4
-
-
H+4+ (#entries x 60)
-
Table 112: L-Band Signal Tracking Status
Nibble Bit Mask
Description
Range Value
0 0x0001
Tracking State
N0
1 0x0002
0 = Searching, 1 = Pull-in, 2 = Tracking, 3 = Idle
2 0x0004 Reserved
3 0x0008
OEM7 Commands and Logs Reference Manual v10
582
Chapter 3 Logs
Nibble Bit Mask
Description
Range Value
4 0x0010
5 0x0020
N1
6 0x0040 Bit Timing Lock
0 = Not Locked, 1 = Locked
7 0x0080 Phase Locked
0 = Not Locked, 1 = Locked
8
0x0100
DC Offset Unlocked
0 = Good, 1 = Warning
N2
9 0x0200 AGC Unlocked
0 = Good, 1 = Warning
10 0x0400
11 0x0800
12 0x1000 Reserved
13 0x2000
N3
14 0x4000
15 0x8000 Error
0 = Good, 1 = Error
OEM7 Commands and Logs Reference Manual v10
583
Chapter 3 Logs
3.77 LOGLIST
List of system logs
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists which messages are currently being logged to each port and when. The following tables show the binary and ASCII output. See also the RXCONFIG log on page 764 for a list of current command settings.
Message ID: 5
Log Type: Polled
Recommended Input: log loglista once
ASCII Example: #LOGLISTA,COM1,0,60.5,FINESTEERING,1337,398279.996,02000000,c00c,1984; 8, COM1,RXSTATUSEVENTA,ONNEW,0.000000,0.000000,HOLD, COM2,RXSTATUSEVENTA,ONNEW,0.000000,0.000000,HOLD, COM3,RXSTATUSEVENTA,ONNEW,0.000000,0.000000,HOLD, USB1,RXSTATUSEVENTA,ONNEW,0.000000,0.000000,HOLD, USB2,RXSTATUSEVENTA,ONNEW,0.000000,0.000000,HOLD, USB3,RXSTATUSEVENTA,ONNEW,0.000000,0.000000,HOLD, COM1,BESTPOSA,ONTIME,10.000000,0.000000,NOHOLD, COM1,LOGLISTA,ONCE,0.000000,0.000000,NOHOLD*5b29eed3
Do not use undocumented logs or commands. Doing so may produce errors and void your warranty.
3.77.1 Binary
Field
Field type
Description
1
LOGLIST (binary) header
Log header. See Messages on page 25 for more information.
2
#logs
Number of messages to follow, maximum = 80
3
port
Output port, see Table 4: Detailed Port Identifier on page 31
4
message
Message ID of the log
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Enum 4 Ushort 2
H H+4 H+8
OEM7 Commands and Logs Reference Manual v10
584
Chapter 3 Logs
Field
Field type
Description
5
6 7 8 9 10 11...
message type
Bits 0-4 = Reserved
Bits 5-6 = Format 00 = Binary 01 = ASCII 10 = Abbreviated ASCII, NMEA 11 = Reserved
Bit 7 = Response Bit (see Message Responses on page 41)
0 = Original Message 1 = Response Message
Reserved
trigger
0 = ONNEW 1 = ONCHANGED 2 = ONTIME 3 = ONNEXT 4 = ONCE 5 = ONMARK
period
Log period for ONTIME
offset
Offset for period (ONTIME trigger)
hold
0 = NOHOLD 1 = HOLD
Next log offset = H + 4 + (#logs x 32)
variable xxxx
32-bit CRC
Format
Binary Bytes
Binary Offset
Char
1
H+10
Char
1
H+11
Enum 4
H+12
Double 8 Double 8 Enum 4
H+16 H+24 H+32
Hex
4
H+4+ (#logs x 32)
3.77.2 ASCII
Field 1 2 3 4
Field type LOGLIST (ASCII) header #port
port
message
Description
Format
Log header. See Messages on page 25 for more information.
Number of messages to follow, maximum = 80
Long
Output port, see Table 4: Detailed Port Identifier on page 31 Enum
Message name of log with no suffix for abbreviated ASCII, an A suffix for ASCII and a B suffix for binary
Char [ ]
OEM7 Commands and Logs Reference Manual v10
585
Chapter 3 Logs
Field Field type
5
trigger
6
period
7
offset
8
hold
9...
Next port
variable xxxx
variable [CR][LF]
Description ONNEW ONCHANGED ONTIME ONNEXT ONCE ONMARK Log period for ONTIME Offset for period (ONTIME trigger) NOHOLD HOLD
32-bit CRC Sentence terminator
Format
Enum
Double Double Enum
Hex -
OEM7 Commands and Logs Reference Manual v10
586
Chapter 3 Logs
3.78 LUAFILELIST
List available Lua scripts
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This sequenced log informs the user of the available scripts, obtained from the ISO loaded onto the receiver. The size of the file, last change date in yyyymmdd format, last change time in hhmmss format, and path to the files are printed as well.
Message ID: 2151
Log Type: Polled
Recommended Input: LOG LUAFILELIST
Abbreviated ASCII Example:
[COM1]<LUAFILELIST COM1 6 89.5 UNKNOWN 0 4.000 02444020 b447 14635
<
0 20180202 151403 "/lua/uppercase.lua"
<LUAFILELIST COM1 5 90.5 UNKNOWN 0 4.000 02444020 b447 14635
<
2706 20180129 152042 "/lua/debugloop.lua"
<LUAFILELIST COM1 4 90.5 UNKNOWN 0 4.000 02444020 b447 14635
<
4692 20180202 110107 "/lua/parsetime.lua"
<LUAFILELIST COM1 3 90.5 UNKNOWN 0 4.000 02444020 b447 14635
<
4764 20180205 105415 "/lua/scom_rx.lua"
<LUAFILELIST COM1 2 90.5 UNKNOWN 0 4.000 02444020 b447 14635
<
3728 20180202 104830 "/lua/scomtunnel.lua"
<LUAFILELIST COM1 1 90.5 UNKNOWN 0 4.000 02444020 b447 14635
<
3044 20180201 144849 "/lua/scriptargs.lua"
<LUAFILELIST COM1 0 90.5 UNKNOWN 0 4.000 02444020 b447 14635
<
2337 20180129 155140 "/lua/sendtocom2.lua"
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
LUAFILELIST Log header. See Messages for more
header
information.
-
H
0
2
Size
File size (in Bytes)
Ulong 4
H
3
Date
Last change date
When viewed as a string, the date is of the
Ulong 4
form YYYYMMDD. So, numerically, the date is
(Year * 10000) + (Month * 100) + (Day).
H+4
4
Time
Last change time
When viewed as a string, the time is
Ulong 4
HHMMSS. So, numerically, the time is (Hour
* 10000) + (Minute * 100) + (Second).
H+8
OEM7 Commands and Logs Reference Manual v10
587
Chapter 3 Logs
Field Field Type
Description
5
Path
The path to the Lua script
The maximum length of this string is 256 bytes.
Format
Binary Bytes
Binary Offset
String Variable H+12
OEM7 Commands and Logs Reference Manual v10
588
Chapter 3 Logs
3.79 LUAFILESYSTEMSTATUS
Query mount status of Lua scripts
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this log to query the mount status of the ISO image that contains the Lua scripts loaded on to the receiver.
Message ID: 2150
Log Type: Asynch
Recommended Input: LOG LUAFILESYSTEMSTATUS
Abbreviated ASCII Example:
<LUAFILESYSTEMSTATUS COM1 0 90.0 UNKNOWN 0 0.204 02444020 b8f8 14635
<
MOUNTED ""
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
LUAFILESYSTEMSTATUS Log header. See Messages for
header
more information.
H
0
2
Status
The status of the file system. See
Table 113: File System Status
Enum 4
H
below.
3
Error
String that indicates the error message if mounting fails
The maximum length of this string is 52 bytes.
String Variable H+4
Table 113: File System Status
Value Description
1
UNMOUNTED
2
MOUNTED
3
BUSY
4
ERROR
5
UNMOUNTING
6
MOUNTING
OEM7 Commands and Logs Reference Manual v10
589
Chapter 3 Logs
3.80 LUAOUTPUT
Output stderr and stdout from the Lua interpreter
Platform: OEM719, OEM729, OEM7500, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this log to output stderr and stdout messages from the Lua interpreter.
Message ID: 2240
Log Type: Asynch
Recommended Input: LOG LUAOUTPUT ONNEW
Abbreviated ASCII Example:
<LUAOUTPUT 0 346044.929
<
1 0 STDOUT "Lua 5.3.4
<LUAOUTPUT 0 346044.987
<
2 0 STDOUT "> "
Copyright (C) 1994-2017 Lua.org, PUC-Rio"
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
LUAOUTPUT Log header. See Messages for more
header
information.
-
H
0
2
Sequence Number
Running number of each LUAOUTPUT log produced by the system
Ulong 4
H
3
Executor Number
Lua Executor Number that produced the data Ulong 4
H+4
4
Data Source
See Table 114: Lua Data Source on the next page
Enum
4
H+8
5
Data
NULL-terminated string containing a single line of data from stderr or stdout. This string is not terminated with a carriage return or line feed.
This string contains only printable characters.
The maximum length of this string is 128 bytes.
String
Variable H+12
OEM7 Commands and Logs Reference Manual v10
590
Chapter 3 Logs
Table 114: Lua Data Source
Binary ASCII
Description
0
STDOUT Data is from stdout
1
STDERR Data is from stderr
OEM7 Commands and Logs Reference Manual v10
591
Chapter 3 Logs
3.81 LUASTATUS
Display status of Lua scripts
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Use this log to determine which scripts are running on the receiver and whether the scripts have exited or encountered errors.
Message ID: 2181
Log Type: Collection
Recommended Input: LOG LUASTATUS
Abbreviated ASCII Example:
[COM1]<LUASTATUS COM1 1 84.5 FINESTEERING 1963 402110.866 02400000 2e18 32768
<
0 "icom_rx.lua 127.0.0.1 3001" EXECUTING
<LUASTATUS COM1 0 84.5 FINESTEERING 1963 402110.866 02400000 2e18 32768
<
1 "" NOT_STARTED
The example above is for the projected log output for two executors.
Field Field Type
1
LUASTATUS header
2
Number
3
Script
4
Status
Description
Log header. See Messages for more information. Executor number
Script and arguments
Script status. See Table 115: Script Status below.
Format
Binary Bytes
H
Ulong
String [256]
4 Variable
Enum 4
Binary Format 0 H H+4
Variable
Binary
ASCII
0
NOT_STARTED
1
EXECUTING
2
COMPLETED
3
SCRIPT_ERROR
4
EXECUTOR_ ERROR
Table 115: Script Status Description
There is no script running on the executor The script is running The script completed successfully The script exited with an error The script executor encountered an error while attempting to run the script
OEM7 Commands and Logs Reference Manual v10
592
Chapter 3 Logs
3.82 MARKPOS, MARK2POS, MARK3POS and MARK4POS
Position at time of mark input event
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the estimated position of the antenna when a pulse is detected at a mark input. MARKPOS is generated when a pulse occurs on the MK1I input. MARK2POS is generated when a pulse occurs on the MK2I input. MARK3POS is generated when a pulse occurs on the MK3I input (OEM7600, OEM7700 and OEM7720 only). MARK4POS is generated when a pulse occurs on the MK4I input (OEM7600, OEM7700 and OEM7720 only). Refer to the product specific Technical Specifications appendices in the OEM7 Installation and Operation User Manual for mark input pulse specifications and the location of the mark input pins.
The position at the mark input pulse is extrapolated using the last valid position and velocities. The latched time of mark impulse is in GPS reference weeks and seconds into the week. The resolution of the latched time is 10 ns. See also the notes on MARKPOS in the MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME log on page 596.
Message ID:
181 (MARKPOS) 615 (MARK2POS) 1738 (MARK3POS) 1739 (MARK4POS)
Log Type: Asynch
Recommended Input: log markposa onnew
1. Use the ONNEW trigger with the MARKTIME or MARKPOS logs.
2. Refer to the Technical Specifications appendix in the OEM7 Installation and Operation User Manual for more details on the MK1I pin. ONMARK only applies to MK1I. Events on MK2I (if available) do not trigger logs when ONMARK is used. Use the ONNEW trigger with the MARKTIME, MARK2TIME, MARKPOS or MARK2POS logs.
3. Once the 1PPS signal has hit a rising edge, for both MARKPOS and MARKTIME logs, a resolution of both measurements is 10 ns. As for the ONMARK trigger for other logs that measure latency, for example RANGE and POSITION logs such as BESTPOS, it takes typically 20-30 ms (50 ms maximum) for the logs to output information from the 1PPS signal. Latency is the time between the reception of the 1PPS pulse and the first byte of the associated log. See also the MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME log on page 596.
Abbreviated ASCII Example:
<MARKPOS COM1 0 89.0 FINESTEERING 1670 413138.000 02000020 c223 42770 SOL_ COMPUTED SINGLE 51.11289233689 -114.02932170726 1018.9653 1049.4915 BUKIT 1.9372 1.1981 4.0909 "" 0.000 0.000 19 18 18 18 0 06 0 33
OEM7 Commands and Logs Reference Manual v10
593
Chapter 3 Logs
Consider the case where you have a user point device such as video equipment. Connect the device to the receiver's I/O port using a cable that is compatible to both the receiver and the device. Refer to your device's documentation for information about connectors and cables. The arrow along the cable in the figure below indicates a MARKIN pulse, from the user device on the right to the receiver I/O port.
Field Field type
Description
MARKPOS/
1
MARK2POS/ MARK3POS/ MARK4POS
Log header. See Messages on page 25 for more information.
header
2
sol status
Solution status (see Table 74: Solution Status on page 436)
3
pos type
Position type (see Table 75: Position or Velocity Type on page 437)
4
lat
Latitude (degrees)
5
lon
Longitude (degrees)
6
hgt
Height above mean sea level (m)
Undulation - the relationship between the geoid and the WGS84 ellipsoid (m)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
Enum 4 Double 8 Double 8 Double 8
H
H+4 H+8 H+16 H+24
7
undulation
8
datum id#
9
lat
10
lon
When using a datum other than WGS84, the undulation value also includes the vertical shift due to differences between the datum in use and WGS84.
Float
4
Datum ID number (refer to Table 29: Datum Transformation Parameters on page 121)
Enum
4
Latitude standard deviation (m)
Float
4
Longitude standard deviation (m)
Float
4
H+32
H+36 H+40 H+44
OEM7 Commands and Logs Reference Manual v10
594
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
11
hgt
Height standard deviation (m)
Float
4
H+48
12
stn id
Base station ID
Char[4] 4
H+52
13
diff_age
Differential age in seconds
Float
4
H+56
14
sol_age
Solution age in seconds
Float
4
H+60
15
#SVs
Number of satellites tracked
Uchar 1
H+64
16
#solnSVs
Number of satellite vehicles used in solution Uchar 1
H+65
17
#ggL1
Number of satellites with L1/E1/B1 signals used in solution
Uchar
1
H+66
18
#solnMultiSVs
Number of satellites with multi-frequency signals used in solution
Uchar 1
H+67
19
Reserved
Uchar 1
H+68
20
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Hex
1
H+69
Galileo and
Galileo and BeiDou signals used mask (see
21
BeiDou sig
Table 77: Galileo and BeiDou Signal-Used Hex
1
mask
Mask on page 440)
H+70
GPS and
GPS and GLONASS signals used mask (see
22
GLONASS sig Table 76: GPS and GLONASS Signal-Used
Hex
1
mask
Mask on page 439)
H+71
23
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+72
24
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
595
Chapter 3 Logs
3.83 MARKTIME, MARK2TIME, MARK3TIME and MARK4TIME
Time of mark input event
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the time of the leading edge of the detected mark input pulse.
l MARKTIME is generated when a pulse occurs on a MK1I input
l MARK2TIME is generated when a pulse occurs on a MK2I input
l MARK3TIME is generated when a pulse occurs on a MK3I input (OEM7600, OEM7700 and OEM7720 only)
l MARK4TIME is generated when a pulse occurs on a MK4I input (OEM7600, OEM7700 and OEM7720 only)
Refer to the Technical Specifications appendix in the OEM7 Installation and Operation User Manual for mark input pulse specifications and the location of the mark input pins. The resolution of this measurement is 10 ns.
1. Use the ONNEW trigger with the MARKTIME or the MARKPOS logs.
2. Only the MARKPOS logs, MARKTIME logs and `polled' log types are generated `on the fly' at the exact time of the mark. Synchronous and asynchronous logs output the most recently available data.
3. Refer to the Technical Specifications appendix in the OEM7 Installation and Operation User Manual for more details on the MK1I pin. ONMARK only applies to MK1I. Events on MK2I (if available) do not trigger logs when ONMARK is used. Use the ONNEW trigger with the MARKTIME, MARK2TIME, MARKPOS or MARK2POS logs.
4. Once the 1PPS signal has hit a rising edge, for both MARKPOS and MARKTIME logs, a resolution of both measurements is 10 ns. As for the ONMARK trigger for other logs that measure latency, for example RANGE and POSITION logs such as BESTPOS, it takes typically 20-30 ms (50 ms maximum) for the logs to output information from the 1PPS signal. Latency is the time between the reception of the 1PPS pulse and the first byte of the associated log. See also the MARKPOS, MARK2POS, MARK3POS and MARK4POS log on page 593.
Message ID:
231 (MARKTIME) 616 (MARK2TIME) 1075 (MARK3TIME) 1076 (MARK4TIME)
Log Type: Asynch
Recommended Input: log marktimea onnew
ASCII Example:
#MARKTIMEA,COM1,0,77.5,FINESTEERING,1358,422621.000,02000000,292e,2214;1358,422 621.000000500,-1.398163614e-08,7.812745577e-08,-14.000000002,VALID*d8502226
OEM7 Commands and Logs Reference Manual v10
596
Chapter 3 Logs
These logs allow you to measure the time when events are occurring in other devices (such as a video recorder). See also the MARKCONTROL command on page 239.
GPS reference time is the receiver's estimate of the true GPS system time. GPS reference time can be found in the header of the log. The relationship between GPS reference time and true GPS system time is: GPS system time = GPS reference time - offset
Field Field type
Description
Format
Binary Bytes
Binary Offset
MARKTIME/
1
MARK2TIME/ MARK3TIME/ MARK4TIME
Log header. See Messages on page 25 for more information.
header
H
0
2
week
GPS reference week number
Long
4
H
3
seconds
Seconds into the week as measured from the
receiver clock, coincident with the time of
Double 8
electrical closure on the Mark Input port
H+4
4
offset
Receiver clock offset, in seconds. A positive
offset implies that the receiver clock is ahead
of GPS system time. To derive GPS system
time, use the following formula:
GPS system time = GPS reference time -
Double 8
(offset)
Where GPS reference time can be obtained from the log header
H+12
5
offset std
Standard deviation of receiver clock offset (s) Double 8
H+20
OEM7 Commands and Logs Reference Manual v10
597
Chapter 3 Logs
Field Field type
6
utc offset
Description
This field represents the offset of GPS system time from UTC time (s), computed using almanac parameters. UTC time is GPS reference time plus the current UTC offset minus the receiver clock offset.
UTC time = GPS reference time - offset + UTC offset
Format
Binary Bytes
Binary Offset
Double 8
H+28
0 indicates that UTC time is unknown because there is no almanac available in order to acquire the UTC offset.
7
status
Clock model status, see Table 87: Clock Model Status on page 462
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Enum 4
Ulong 4
-
-
H+36 H+40 -
OEM7 Commands and Logs Reference Manual v10
598
Chapter 3 Logs
3.84 MASTERPOS
Master Position using ALIGN
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
ALIGN generates distance and bearing information between a Master and Rover receiver. This log outputs the position information of the master when using the ALIGN feature. This log can be output from both Y and Z ALIGN models and can be output at both Master and Rover ends.
You must have an ALIGN capable receiver to use this log.
1. ALIGN is useful for obtaining the relative directional heading of a vessel/body, separation heading between two vessels/bodies or heading information with moving base and pointing applications.
2. The log can be output at both Y and Z model Rover if it is receiving the RTCAREFEXT or NovAtelXRef message from the Master. The log can be output at any Master if the Master is receiving HEADINGEXTB or HEADINGEXT2B from the Rover. Refer to the NovAtel application note APN-048 for details on HEADINGEXT (available on our website at www.novatel.com/support/.)
3. MASTERPOS logging is dictated by the output frequency of the RTCAREFEXT or NovAtelXRef output frequency.
Message ID: 1051
Log Type: Asynch
Recommended Input: log masterposa onchanged
ASCII Example: #MASTERPOSA,COM1,0,21.5,FINESTEERING,1544,340322.000,02000008,5009,4655;SOL_ COMPUTED,NARROW_INT,51.11604599076,-114.03855412002,1055.7756, 16.9000,WGS84,0.0090,0.0086,0.0143,"AAAA",0.0,0.0,13,13,13,12,0,0,0,0*a72e8d3f
Asynchronous logs, such as MASTERPOS, should only be logged ONCHANGED or ONNEW otherwise, the most current data is not output when it is available. This is especially true of the ONTIME trigger, which may cause inaccurate time tags to result.
Field Field Type
Description
1
MASTERPOS Log header. See Messages on page 25 for
header
more information.
Format
Binary Bytes
Binary Offset
H
0
OEM7 Commands and Logs Reference Manual v10
599
Chapter 3 Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
2
sol stat
Solution Status, see Table 74: Solution Status on page 436
Enum
4
H
3
pos type
Position Type see Table 75: Position or Velocity Type on page 437
Enum 4
H+4
4
lat
Master WGS84 Latitude in degrees
Double 8
H+8
5
long
Master WGS84 Longitude in degrees
Double 8
H+16
6
hgt
Master MSL Height in metres
Double 8
H+24
7
undulation Undulation in metres
Float
4
H+32
8
datum id#
WGS84 (default) (refer to Table 29: Datum Transformation Parameters on page 121)
Enum 4
H+36
9
lat
Latitude standard deviation in metres
Float
4
H+40
10
long
Longitude standard deviation in metres
Float
4
H+44
11
hgt
Height standard deviation in metres
Float
4
H+48
12
stn id
Receiver ID can be set using the DGPSTXID command (see page 127)
Char[4] 4
H+52
13 Reserved
14
Float
4
Float
4
H+56 H+60
15
#SVs
Number of satellite vehicles tracked
Uchar 1
H+64
16
#solnSVs Number of satellite vehicles used in solution Uchar 1
H+65
17
#obs
Number of satellites with L1/E1/B1 signals used in solution
Uchar 1
H+66
18
#multi
Number of satellites with multi-frequency signals used in solution
Uchar 1
H+67
19
sol source
Solution source (see Table 104: Solution Source on page 549)
Hex
1
H+68
20
Uchar 1
H+69
21
Reserved
Uchar 1
H+70
22
Uchar 1
H+71
23
xxxx
32-bit CRC (ASCII and Binary only)
HEX
1
H+72
24
[CR][LF]
Sentence Terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
600
Chapter 3 Logs
3.85 MATCHEDPOS
Matched RTK position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log represents positions that have been computed from time matched base and rover observations. There is no base extrapolation error on these positions because they are based on buffered measurements, that is, they lag real time by some amount depending on the latency of the data link. If the rover receiver has not been enabled to accept RTK differential data or is not actually receiving data leading to a valid solution, this is shown in fields #2 (sol status) and #3 (pos type). This log provides the best accuracy in static operation. For lower latency in kinematic operation, see the RTKPOS log (see page 754) or BESTPOS log (see page 433). The data in the logs changes only when a base observation (RTCMv3) changes. A good message trigger for this log is onchanged. Then, only positions related to unique base station messages are produced and the existence of this log indicates a successful link to the base.
Asynchronous logs, such as MATCHEDPOS, should only be logged ONCHANGED otherwise the most current data is not output when it is available. This is especially true of the ONTIME trigger, which may cause inaccurate time tags to result.
The RTK system in the receiver provides two kinds of position solutions. The Matched RTK position is computed with buffered observations, so there is no error due to the extrapolation of base station measurements. This provides the highest accuracy solution possible at the expense of some latency which is affected primarily by the speed of the differential data link. The MATCHEDPOS log contains the matched RTK solution and can be generated for each processed set of base station observations. The Low-Latency RTK position is computed from the latest local observations and extrapolated base station observations. This supplies a valid RTK position with the lowest latency possible at the expense of some accuracy. The degradation in accuracy is reflected in the standard deviation and is summarized in An Introduction to GNSS available on our website. The amount of time that the base station observations are extrapolated is in the "differential age" field of the position log. The Low-Latency RTK system extrapolates for 60 seconds. The RTKPOS log (see page 754) contains the LowLatency RTK position when valid, and an "invalid" status when a Low-Latency RTK solution could not be computed. The BESTPOS log (see page 433) contains either the low-latency RTK, PPP or pseudorange-based position, whichever has the smallest standard deviation.
Message ID: 96
Log Type: Asynch
Recommended Input: log matchedposa onchanged
OEM7 Commands and Logs Reference Manual v10
601
Chapter 3 Logs
ASCII Example: #MATCHEDPOSA,COM1,0,63.0,FINESTEERING,1419,340034.000,02000040,2f06,2724;SOL_ COMPUTED,NARROW_INT,51.11635908660,-114.03833102484,1063.8400,16.2712,WGS84,0.0140,0.0075,0.0174,"AAAA",0.000,0.000,12,12,12,12,0,01,0,33*fea c3a3a
Measurement precision is different from the position computation precision. Measurement precision is a value that shows how accurately the actual code or carrier phase is measured by the GNSS receiver. Position precision is a value that shows the accuracy of the position computation made from the code and/or carrier phase measurements. The P-code L2 measurement precision is not as good as the C/A measurement precision because the NovAtel GNSS receiver is a civilian grade GPS device and does not have direct access to the decrypted military L2 P(Y) code. This means that NovAtel's semi-codeless P-code L2 measurements are noisier than the civilian band C/A code measurements. Refer to the OEM7 Installation and Operation User Manual for the technical specification of the OEM7 card.
Field Field type
Description
1
MATCHEDPOS Log header. See Messages on page 25 for
header
more information.
2
sol status
Solution status (see Table 74: Solution Status on page 436)
3
pos type
Position type (see Table 75: Position or Velocity Type on page 437)
4
lat
Latitude (degrees)
5
lon
Longitude (degrees)
6
hgt
Height above mean sea level (m)
Undulation - the relationship between the geoid and the WGS84 ellipsoid (m)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
Double 8 Double 8 Double 8
H+4
H+8 H+16 H+24
7
undulation
When using a datum other than WGS84, the undulation value also includes the vertical shift due to differences between the datum in use and WGS84.
Float
4
8
datum id#
Datum ID number (see Table 29: Datum Transformation Parameters on page 121)
Enum 4
9
lat
Latitude standard deviation (m)
Float
4
H+32
H+36 H+40
OEM7 Commands and Logs Reference Manual v10
602
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
10
lon
Longitude standard deviation (m)
Float
4
H+44
11
hgt
Height standard deviation (m)
Float
4
H+48
12
stn id
Base station ID
Char[4] 4
H+52
13 Reserved
14
Float
4
Float
4
H+56 H+60
15
#SVs
Number of satellites tracked
Uchar 1
H+64
16
#solnSVs
Number of satellite vehicles used in solution Uchar 1
H+65
17
#ggL1
Number of satellites with L1/E1/B1 signals used in solution
Uchar
1
H+66
18
#solnMultiSVs
Number of satellites with multi-frequency signals used in solution
Uchar 1
H+67
19
Reserved
Hex
1
H+68
20
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Hex
1
H+69
Galileo and
Galileo and BeiDou signals used mask (see
21
BeiDou sig
Table 77: Galileo and BeiDou Signal-Used Hex
1
mask
Mask on page 440)
H+70
GPS and
GPS and GLONASS signals used mask (see
22
GLONASS sig Table 76: GPS and GLONASS Signal-Used
Hex
1
mask
Mask on page 439)
H+71
23
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+72
24
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
603
Chapter 3 Logs
3.86 MATCHEDSATS
Satellites used in MATCHEDPOS solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists the used and unused satellites for the corresponding MATCHEDPOS solution. It also describes the signals of the used satellites and reasons for exclusions.
Message ID: 1176
Log Type: Asynch
Recommended Input: log matchedsats onchanged
Abbreviated ASCII Example:
<MATCHEDSATS COM1 0 60.5 FINESTEERING 1728 524924.000 02000000 b555 11487
<
24
<
GPS 3 GOOD 00000003
<
GPS 5 GOOD 00000003
...
<
GPS 23 GOOD 00000003
<
GPS 30 GOOD 00000003
<
GLONASS 1+1 GOOD 00000003
<
GLONASS 2-4 GOOD 00000003
...
<
GLONASS 21+4 GOOD 00000003
<
BEIDOU 6 GOOD 00000003
<
BEIDOU 11 GOOD 00000003
...
<
BEIDOU 12 GOOD 00000003
<
BEIDOU 13 GOOD 00000003
Field Field type
Description
1
MATCHEDSATS Log header. See Messages on page 25 for
header
more information.
2
#entries
Number of records to follow
3
system
See Table 105: Satellite System on page 553
4
Satellite ID
Satellite identifier
5
Status
Satellite status (Table 80: Observation Statuses on page 443)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
Enum 4
H+4
Ulong 4
H+8
Enum 4
H+12
OEM7 Commands and Logs Reference Manual v10
604
Chapter 3 Logs
Field Field type
6
Signal mask
Description
See Table 81: BESTSATS GPS Signal Mask on page 444, Table 82: BESTSATS GLONASS Signal Mask on page 445, Table 83: BESTSATS Galileo Signal Mask on page 445, and Table 84: BESTSATS BeiDou Signal Mask on page 445
Format
Binary Bytes
Binary Offset
Hex
4
H+16
7
Next satellite offset = H + 4 + (#sat x 16)
8
xxxx
32-bit CRC (ASCII and Binary only)
Hex
1
H+4+ (#sat x 16)
9
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
605
Chapter 3 Logs
3.87 MATCHEDXYZ
Matched RTK Cartesian position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the receiver's matched position in ECEF coordinates. It represents positions that have been computed from time matched base and rover observations. There is no base station extrapolation error on these positions because they are based on buffered measurements, that is, they lag real time, by some amount, depending on the latency of the data link. If the rover receiver has not been enabled to accept RTK differential data or is not actually receiving data leading to a valid solution, this is reflected by the code shown in field #2 (solution status) and #3 (position type). See Figure 11: The WGS84 ECEF Coordinate System on page 454 for a definition of the ECEF coordinates.
This log provides the best accuracy in static operation. For lower latency in kinematic operation, see the BESTXYZ log (see page 452) or RTKXYZ log (see page 761). The data in the logs changes only when a base observation (RTCMv3) changes.
The time stamp in the header is the time of the matched observations that the computed position is based on and not the current time.
Message ID: 242
Log Type: Asynch
Recommended Input:
log matchedxyza onchanged
Asynchronous logs, such as MATCHEDXYZ, should only be logged ONCHANGED otherwise the most current data is not output when it is available. This is especially true of the ONTIME trigger, which may cause inaccurate time tags to result.
ASCII Example:
#MATCHEDXYZA,COM1,0,62.5,FINESTEERING,1419,340035.000,02000040,b8ed,2724;SOL_ COMPUTED,NARROW_INT,-1634531.5703,3664618.0321,4942496.3280,0.0080,0.0159,0.0154,"AAAA",12,12,12,12,0,01,0,33*e4b 84015
Field Field type
Description
1
MATCHEDXYZ Log header. See Messages on page 25 for
header
more information.
2
P-sol status
Solution status, see Table 74: Solution Status on page 436
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
606
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
3
pos type
Position type, see Table 75: Position or Velocity Type on page 437
Enum
4
H+4
4
P-X
Position X-coordinate (m)
Double 8
H+8
5
P-Y
Position Y-coordinate (m)
Double 8
H+16
6
P-Z
Position Z-coordinate (m)
Double 8
H+24
7
P-X
Standard deviation of P-X (m)
Float
4
H+32
8
P-Y
Standard deviation of P-Y (m)
Float
4
H+36
9
P-Z
Standard deviation of P-Z (m)
Float
4
H+40
10
stn ID
Base station ID
Char[4] 4
H+44
11
#SVs
Number of satellites tracked
Uchar 1
H+48
12
#solnSVs
Number of satellite vehicles used in solution Uchar 1
H+49
13
#ggL1
Number of satellites with L1/E1/B1 signals used in solution
Uchar
1
H+50
14
#solnMultiSVs
Number of satellites with multi-frequency signals used in solution
Uchar 1
H+51
15
Reserved
Char
1
H+52
16
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Hex
1
H+53
Galileo and
Galileo and BeiDou signals used mask (see
17
BeiDou sig
Table 77: Galileo and BeiDou Signal-Used Hex
1
mask
Mask on page 440)
H+54
GPS and
GPS and GLONASS signals used mask (see
18
GLONASS sig Table 76: GPS and GLONASS Signal-Used
Hex
1
mask
Mask on page 439)
H+55
19
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+56
20
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
607
Chapter 3 Logs
3.88 MODELFEATURES
States features available for current loaded model
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The MODELFEATURES log states the features available for the current loaded model.
To see which satellite systems are available for the current model, use the CHANCONFIGLIST log (see page 457).
Most features have a boolean state: authorized or unauthorized. However, some have more complex licensed states with varying degrees of capability.
This log is best viewed in Abbreviated ASCII.
Message ID: 1329
Log Type: Polled
Recommended Input: log modelfeatures once
Abbreviated ASCII Example:
<MODELFEATURES COM1 0 92.5 COARSESTEERING 2007 237316.648 02400000 141a 14898
<
20
<
1HZ MAX_MSR_RATE
<
0HZ MAX_POS_RATE
<
SINGLE ANTENNA
<
AUTHORIZED NTRIP
<
UNAUTHORIZED IMU
<
UNAUTHORIZED INS
<
UNAUTHORIZED MEAS_OUTPUT
<
UNAUTHORIZED DGPS_TX
<
UNAUTHORIZED RTK_TX
<
UNAUTHORIZED RTK_FLOAT
<
UNAUTHORIZED RTK_FIXED
<
UNAUTHORIZED PPP
<
UNAUTHORIZED LOW_END_POSITIONING
<
UNAUTHORIZED RAIM
<
UNAUTHORIZED ALIGN_HEADING
<
UNAUTHORIZED ALIGN_RELATIVE_POS
<
UNAUTHORIZED API
<
UNAUTHORIZED INTERFERENCE_MITIGATION
<
UNAUTHORIZED RTKASSIST
<
UNAUTHORIZED SCINTILLATION
OEM7 Commands and Logs Reference Manual v10
608
Chapter 3 Logs
Field
Field type
Description
1
MODELFEATURES Log header. See Messages on
header
page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
2
# Feature
Number of features in list
Ulong 4
H
Licensing status of feature
3
Feature Status
See Table 116: Feature Status
below
Enum 4
Type of feature
4
Feature Type
See Table 117: Feature Type on the Enum 4
next page
H+4 H+8
5... Next feature = H+4+(# Feature x 8)
6
xxxx
32-bit CRC (ASCII and Binary only) Ulong 4
H+4+(# Feature x 8)
7
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
Table 116: Feature Status
Value
Name
Description
0
AUTHORIZED
The feature is authorized
1
UNAUTHORIZED
The feature is unauthorized
2
0Hz
Disables output of POS logs
6
20Hz
Maximum logging rate for POS or MSR logs is 20 Hz
8
100Hz
Maximum logging rate for POS or MSR logs is 100 Hz
9
RATE_INVALID
Option bits don't correspond to a valid rate
15
STANDARD
SPAN Standard Model
20
COMMERCIAL_MEMS
IMU Grade-Commercial MEMS
21
TACTICAL
IMU Grade-Tactical
22
HIGH_GRADE_TACTICAL
IMU Grade-High Grade Tactical
23
NAVIGATION
IMU Grade-Navigation
25
SINGLE
Single antenna
26
DUAL
Dual antenna
30
LITE
SPAN Lite Model
33
CONSUMER_MEMS
IMU Grade-Consumer MEMS
OEM7 Commands and Logs Reference Manual v10
609
Chapter 3 Logs
Value
Name
0
MAX_MSR_RATE
1
MAX_POS_RATE
3
MEAS_OUTPUT
4
DGPS_TX
5
RTK_TX
6
RTK_FLOAT
7
RTK_FIXED
8
RAIM
9
LOW_END_ POSITIONING
10
ALIGN_HEADING
11
ALIGN_RELATIVE_POS
12
API
15
NTRIP
19
PPP
20
SCINTILLATION
22
INS
23
IMU
FEATURE_
26
INTERFERENCE_
MITIGATION
28
ANTENNA
29
GENERIC_IMU
30
INS_PLUS_PROFILES
31
HEAVE
32
RELATIVE_INS
999 MODEL_INVALID
Table 117: Feature Type Description
Maximum measurement logging rate Maximum position logging rate Output of raw measurements (phase and pseudorange) Transmission of DGPS (non RTK) corrections Transmission of RTK corrections RTK float positioning RTK fixed positioning Extended RAIM
GLIDE and TerraStar-L positioning
Heading Heading and Relative Positioning Lua Scripted User Interface (formerly User Application API) NTRIP Server/Client TerraStar-C positioning Scintillation Inertial (SPAN) IMU Grade
Interference Mitigation
Number of antenna enabled on the receiver SPAN Generic IMU Interface SPAN Plus Profiles SPAN Heave Option SPAN Relative INS If a bad model is loaded, MODELFEATURES will contain one entry: MODEL_INVALID STATUS_INVALID
OEM7 Commands and Logs Reference Manual v10
610
Chapter 3 Logs
3.89 NAVICALMANAC
Decoded NavIC Almanac
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the decoded NavIC almanac parameters from NavIC navigation messages. Multiple messages are transmitted, one for each satellite ID with data. The OEM7 family of receivers automatically save almanacs in their Non-Volatile Memory (NVM), so creating an almanac boot file is not necessary.
Message ID: 2122
Log Type: Asynch
Recommended Input: log navicalmanaca onchanged
ASCII Example: #NAVICALMANACA,COM1,4,69.5,SATTIME,1943,158160.000,02000020,fb6e,32768 ;919,0.001982212,86400,0.075264303,8.457495146e-10,6493.383789062, 1.327344662,2.996060720,2.542881375,-0.000580788,7.275957614e-12, 6,0,0,5*05cfbc62
#NAVICALMANACA,COM1,3,69.5,SATTIME,1943,156276.000,02000020,fb6e,32768 ;919,0.001962662,0,0.509411950,2.742971399e-10,6493.538574219, 1.844826864,3.107479183,-3.001633760,-0.000161171,-5.093170330e-11, 4,0,0,7*8fbd9e3a
#NAVICALMANACA,COM1,2,69.5,SATTIME,1943,158148.000,02000020,fb6e,32768 ;919,0.001979351,86400,0.499982612,2.400099974e-10,6493.359375000, -1.300198895,-3.061969089,0.047002130,0.000025749,-3.637978807e-12, 5,0,0,5*be12ffa2
#NAVICALMANACA,COM1,1,69.5,SATTIME,1943,157620.000,02000020,fb6e,32768 ;919,0.001854897,86400,0.509561753,1.371485699e-10,6493.388671875, 1.842267109,3.032190537,2.385950946,0.000114441,-5.456968211e-11, 2,0,0,5*b64cf69c
#NAVICALMANACA,COM1,0,69.5,SATTIME,1943,156804.000,02000020,fb6e,32768 ;919,0.000161171,86400,0.076541746,1.142904749e-09,6493.613281250, 1.349937548,0.783248119,0.142653098,0.000204086,-8.003553376e-11, 7,0,0,7*495808b9
The speed at which the receiver locates and locks onto new satellites is improved if the receiver has approximate time and position, as well as an almanac. This allows the receiver to compute the elevation of each satellite so it can tell which satellites are visible and their Doppler offsets, improving Time to First Fix (TTFF).
OEM7 Commands and Logs Reference Manual v10
611
Chapter 3 Logs
Field Field Type
Description
1
NAVICALMANAC Log header. See Messages on page 25 for
header
more information.
2
WNa
Week number for the almanac since the IRNSS system time start epoch (August 22nd 1999)
3
Ecc
Eccentricity (dimensionless)
4
Toa
Time of Almanac (sec)
5
I0
Inclination angel (radians)
6
OmegaDot
Rate of RAAN (radians/sec)
7
RootA
Square root of semi-major axis(sqrt (metres))
8
Omega0
Longitude of ascending node (LAN) (radians)
9
Omega
Argument of perigee (radians)
10
M0
Mean Anomaly (radians)
11
Af0
Clock bias A0 (sec)
12
Af1
Clock Drift A1 (sec/sec)
13
AlmSVID
PRN ID for Almanac
14
InterSigCorr
Inter Signal Correction (sec)
15
Spare
16
PRN
Satellite Identifier
17
xxxx
32-bit CRC (ASCII and Binary only)
18
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
Double 8 Ulong 4 Double 8 Double 8
Double 8
Double 8
Double 8
Double 8
Double 8
Double 8
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Hex
4
-
-
H
H+4 H+12 H+16 H+24
H+32
H+40
H+48 H+56 H+64 H+72 H+80 H+84 H+88 H+92 H+96 -
OEM7 Commands and Logs Reference Manual v10
612
Chapter 3 Logs
3.90 NAVICEPHEMERIS
Decoded NavIC Ephemeris
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains NavIC ephemeris parameters with the appropriate scaling applied. Multiple messages are transmitted, one for each SV ephemeris collected.
Message ID: 2123
Log Type: Asynch
Recommended Input: log navicephemerisa onchanged
ASCII Example: #NAVICEPHEMERISA,COM1,5,74.0,SATTIME,1943,255984.000,02000020,01fa, 32768;2,919,1.05838757e-04,-5.63886715e-11,0.00000000,0,252000, -1.86e-09,3.2829938927e-09,11,0,0,0,1.922249794e-06,1.032650471e-05, 2.011656761e-07,4.097819328e-08,-230.9375000,66.1250000, -5.239503961e-10,0,1.900019163,252000,1.8492219970e-03,6493.385761, 1.842761896e+00,3.027013584,-2.94012247e-09,5.0965660552e-01,0,0,0 *d2f4c9a5
#NAVICEPHEMERISA,COM1,4,74.0,SATTIME,1943,255984.000,02000020,01fa, 32768;6,919,-5.79587650e-04,1.02318154e-11,0.00000000,1,252000, -1.86e-09,8.5817860373e-09,11,0,0,0,-1.282989979e-05,2.417713404e-06, 1.974403858e-07,2.644956112e-07,-83.3125000,-395.3125000, -5.535944880e-10,0,2.050709297,252000,1.9699299010e-03,6493.408867, 1.328589850e+00,2.996532035,-7.66746224e-09,7.5298187077e-02,0,0,0 *50cdb388
...
#NAVICEPHEMERISA,COM1,0,74.0,SATTIME,1943,255984.000,02000020,01fa, 32768;7,919,1.90386083e-04,-8.28777047e-11,0.00000000,1,255024, -1.40e-09,6.3988379659e-09,252,0,0,0,-8.992850780e-06, -1.732259989e-06,-9.313225746e-08,-2.235174179e-08,60.1250000, -266.1875000,-3.928735076e-10,0,-0.445949980,255024,2.4348858278e-04, 6493.269802,1.351327715e+00,1.099632488,-5.54308803e-09, 7.6573741924e-02,0,0,0*01bf330e
Field
Field Type
Description
1
NAVICEPHEMERIS Log header. See Messages on page 25
header
for more information.
2
PRN
Satellite Identifier (1 to 7)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
OEM7 Commands and Logs Reference Manual v10
613
Chapter 3 Logs
Field
Field Type
3
WN
4
Af0
5
Af1
6
Af2
7
URA
8
toc
9
TGD
10
DeltaN
11
IODEC
12
Reserved
13
L5 Health
14
S Health
15
Cuc
16
Cus
17
Cic
18
Cis
19
Crc
Description
Week number since the IRNSS system time start epoch (August 22nd 1999)
Clock bias (sec)
Clock drift (sec/sec) Clock drift rate (sec/sec2)
SV Accuracy
Reference time for the satellite clock corrections (sec)
Total group delay (sec)
Mean motion difference (radian/sec)
Issue of data ephemeris and clock
Health status of navigation data on L5 SPS signal 0=OK; 1=bad
Health status of navigation data on S SPS signal 0=OK; 1=bad
Amplitude of the cosine harmonic correction term to the argument of latitude (radians)
Amplitude of the sine harmonic correction term to the argument of latitude (radians)
Amplitude of the cosine harmonic correction term to the angle of inclination (radians)
Amplitude of the sine harmonic correction term to the angle of inclination (radians)
Amplitude of the cosine harmonic correction term to the orbit radius (metres)
Format
Binary Bytes
Binary Offset
Ulong 4
H+4
Double 8 Double 8 Double 8 Ulong 4
H+8 H+16 H+24 H+32
Ulong 4
H+36
Double 8 Double 8 Ulong 4 Ulong 4
H+40 H+48 H+56 H+60
Ulong 4
H+64
Ulong 4
H+68
Double 8 Double 8 Double 8 Double 8 Double 8
H+72 H+80 H+88 H+96 H+104
OEM7 Commands and Logs Reference Manual v10
614
Chapter 3 Logs
Field
Field Type
20
Crs
21
IDOT
22
Spare
23
M0
24
toe
25
Ecc
26
RootA
27
Omega0
28
Omega
29
OmegaDot
30
I0
31
Spare
32
Alert flag
33
AutoNav flag
34
xxxx
35
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Amplitude of the sine harmonic correction term to the orbit radius (metres)
Double 8
H+112
Rate of inclination angle (radians/sec)
Double 8
H+120
Ulong 4
H+128
Mean anomaly (radians)
Double 8
H+132
Time of ephemeris (sec)
Ulong 4
H+140
Eccentricity (dimensionless)
Double 8
H+144
Square root of semi-major axis (sqrt (metres))
Double 8
H+152
Longitude of ascending node (radians)
Double 8
H+160
Argument of perigee (radians)
Double 8
H+168
Rate of RAAN (radians/sec)
Double 8
H+176
Inclination angle (radians)
Double 8
H+184
Ulong 4
H+192
The utilization of navigation data shall be
at the users' own risk.
Ulong 4
1=Alert; 0=OK )
H+196
When set to 1, satellite is in AutoNav
mode.
Satellite broadcasts primary navigation parameters from AutoNav data sets with
Ulong
4
no uplink from ground for maximum of 7
days
H+200
32-bit CRC (ASCII and Binary only)
Hex
4
H+204
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
615
Chapter 3 Logs
3.91 NAVICIONO
NavIC ionospheric coefficients parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains NavIC ionospheric coefficients parameters. Ionospheric error correction for single frequency (L5) users of the NavIC are provided through a set of eight coefficients. The correction coefficients are:
l 4 Alpha Coefficients (n; n=0,1,2,3) These are the coefficients of the cubic polynomial representing the amplitude of the positive cosine curve in the cosine model approximation of ionospheric delay.
l 4 Beta Coefficients (n; n=0,1,2,3) These are the coefficients of the cubic polynomial representing the period of the positive cosine curve in the cosine model approximation of ionospheric delay.
Message ID: 2124
Log Type: Asynch
Recommended Input: log navicionoa onchanged
ASCII Example: #NAVICIONOA,COM1,0,92.5,SATTIME,1944,166272.000,02000020,56c0,32768; 5,2.980232238769531e-08,3.874301910400390e-07,-2.562999725341796e-06, -7.510185241699216e-06,558.0,168.0,-2286.0,2286.0,0*2b250bbd
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
NAVICIONO header
Log header. See Messages on page 25 for more information.
-
H
0
2
PRN
Satellite Identifier of the transmitting NavIC SV (from 1 to 7)
Ulong 4
H
3
Alpha 0
Coefficient of the amplitude of the vertical delay constant term (sec)
Double 8
H+4
4
Alpha 1
Coefficient of the amplitude of the vertical delay first-order term (sec/semi-circle)
Double 8
H+12
5
Alpha 2
Coefficient of the amplitude of the vertical delay second-order term (sec/(semi-circle)2)
Double 8
H+20
6
Alpha 3
Coefficient of the amplitude of the vertical delay third-order term (sec/(semi-circle)3)
Double 8
H+28
OEM7 Commands and Logs Reference Manual v10
616
Chapter 3 Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
7
Beta 0
The coefficient of a cubic equation representing the period of the model constant term (sec)
Double
8
H+36
8
Beta 1
The coefficient of a cubic equation representing
the period of the model first-order term
Double 8
(sec/semi-circle)
H+44
9
Beta 2
The coefficient of a cubic equation representing
the period of the model second-order term
Double 8
(sec/(semi-circle)2)
H+52
10
Beta 3
The coefficient of a cubic equation representing
the period of the model third-order term (sec/ Double 8 (semi-circle)3)
H+60
11
Spare
Ulong 4
H+68
12
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+72
13
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
617
Chapter 3 Logs
3.92 NAVICRAWSUBFRAME
Raw NavIC subframe data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw NavIC subframe data with parity bits removed. Only subframes that have passed the parity check are output.
Message ID: 2105
Log Type: Asynch
Recommended Input: log navicrawsubframea onchanged
ASCII Example: #NAVICRAWSUBFRAMEA,COM1,0,72.5,SATTIME,1943,159168.000,02000020,76af,32768;182, 7,1,8b19e883971a005bf4880009ab3f400eac0af84f7541befff78018e6d7e1dfacd1*88c2ba19 #NAVICRAWSUBFRAMEA,COM1,0,72.5,SATTIME,1943,159168.000,02000020,76af,32768;177, 2,1,8b19e883970e8fc3f8500009ab3f00087f0af8415e4232800f7fd9eb8650b7b630*c7e27e82 #NAVICRAWSUBFRAMEA,COM1,0,72.5,SATTIME,1943,159168.000,02000020,76af,32768;181, 6,1,8b19e88397b3e73401600009ab3f0012370af84f550327c032800ad1d9da339260*0bb7b256 #NAVICRAWSUBFRAMEA,COM1,0,72.5,SATTIME,1943,159168.000,02000020,76af,32768;180, 5,1,8b19e88397036703ff1c0049ab3fc009b10af84fe7e3773ffd7fd6d8f5fddc4181*f42f59ab
Field
Field Type
Description
Format
Binary Bytes
1
NAVICRAWSUBFRAME Log header. See Messages on
header
page 25 for more information.
-
H
2
Signal channel
Signal channel providing the data Ulong 4
3
PRN
Satellite Identifier of transmitting NavIC SV (from 1 to 7)
Ulong
4
4
Subframe Id
Subframe ID
Ulong 4
Raw subframe data (262 bits).
5
Raw subframe data
Hex[33] 33
Does not include CRC or Tail bits
6
xxxx
32-bit CRC (ASCII and Binary only) Hex
4
7
[CR][LF]
Sentence terminator (ASCII only) -
-
Binary Offset 0 H H+4 H+8
H+12
H+45 -
OEM7 Commands and Logs Reference Manual v10
618
Chapter 3 Logs
3.93 NAVICSYSCLOCK
NavIC clock parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides the NavIC system time offset with respect to UTC, UTC (NPLI) and other GNSS times such as GPS, GALILEO, GLONASS.
Message ID: 2125
Log Type: Asynch
Recommended Input: log navicsysclocka onchanged
ASCII Example: #NAVICSYSCLOCKA,COM1,0,93.0,SATTIME,1944,166320.000,02000020,3dfd, 32768;7,-7.625203579664230e-09,-1.598721155460225e-14, 0.000000000000000e+00,18,32508,920,905,7,18,2,2.149608917534351e-07, -5.151434834260726e-14,-1.998997755520149e-19,32508,920,0*f6617e67
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
NAVICSYSCLOCK Log header. See Messages on page 25 for
header
more information.
H
0
2
PRN
Satellite Identifier of the transmitting NavIC SV (from 1 to 7)
Ulong 4
H
3
A0utc
Bias coefficient of the NavIC time scale relative to the UTC time scale (sec)
Double 8
H+4
4
A1utc
Drift coefficient of the NavIC time scale relative to the UTC time scale (sec/sec)
Double 8
H+12
5
A2utc
Drift rate coefficient of the NavIC time
scale relative to the UTC time scale (sec/sec2)
Double 8
H+20
6
tLS
Current or past leap second count (sec) Long
4
H+28
7
Toutc
Time data reference time of week (sec) Ulong 4
H+32
8
WNoutc
Time data reference week number (week) Ulong 4
H+36
9
WNLSF
Leap second reference week number (week)
Ulong 4
H+40
10
DN
Leap second reference day number (days) Ulong 4
H+44
OEM7 Commands and Logs Reference Manual v10
619
Chapter 3 Logs
Field Field Type
11
tLSF
12
GNSSID
13
A0
14
A1
15
A2
16
Tot
17
WNot
18
Spare
19
xxxx
20
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Current or future leap second count (sec) Long
4
H+48
Timescale for the time offsets with respect to NavIC (Table 118: GNSS Time Ulong 4 Scales below)
H+52
Bias coefficient of the NavIC time scale relative to the GNSS time scale (sec)
Double 8
H+56
Drift coefficient of the NavIC time scale relative to the GNSS time scale (sec/sec)
Double
8
H+64
Drift rate correction coefficient of the
NavIC time scale relative to the GNSS time scale (sec/sec2)
Double 8
H+72
Time data reference time of week (sec) Ulong 4
H+80
Time data reference week number (week) Ulong 4
H+84
Ulong 4
H+88
32-bit CRC (ASCII and Binary only)
Hex
4
H+92
Sentence terminator (ASCII only)
-
-
-
Table 118: GNSS Time Scales
GNSS ID Time Scale
0
GPS
1
GALILEO
2
GLONASS
3-6
Reserved
7
UTC (NPLI)
OEM7 Commands and Logs Reference Manual v10
620
Chapter 3 Logs
3.94 NAVIGATE
User navigation data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log reports the status of the waypoint navigation progress. It is used in conjunction with the SETNAV command (see page 350). See the figure below for an illustration of navigation parameters.
The SETNAV command (see page 350) must be enabled before valid data will be reported from this log.
Figure 12: Navigation Parameters
Reference Description
1
TO lat-lon
2
X-Track perpendicular reference point
3
Current GPS position
4
A-Track perpendicular reference point
5
X-Track (cross track)
6
A-Track (along track)
7
Distance and bearing from 3 to 1
Message ID: 161
Log Type: Sync
Recommended Input: log navigatea ontime 1
ASCII Example:
OEM7 Commands and Logs Reference Manual v10
621
Chapter 3 Logs
#NAVIGATEA,COM1,0,56.0,FINESTEERING,1337,399190.000,02000000,aece,1984;SOL_ COMPUTED,PSRDIFF,SOL_ COMPUTED,GOOD,9453.6278,303.066741,133.7313,9577.9118,1338,349427.562*643cd4e2
Use the NAVIGATE log in conjunction with the SETNAV command (see page 350) to tell you where you currently are with relation to known To and From points. You can find a specific latitude, longitude or height knowing from where you started. For example, a backpacker could use these two commands to program a user supplied graphical display, on a digital GPS compass, to show their progress as they follow a defined route.
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
NAVIGATE Log header. See Messages on page 25 for more
header
information.
H
0
2
sol status
Solution status, see Table 74: Solution Status on page 436
Enum
4
H
3
pos type
Position type, see Table 75: Position or Velocity Type on page 437
Enum
4
H+4
4
vel status
Velocity status, see Table 74: Solution Status on page 436
Enum
4
H+8
5
nav type
Navigation data type (see Table 119: Navigation Data Type on the next page)
Enum
4
H+12
Straight line horizontal distance from current
position to the destination waypoint, in metres
6
distance
(see Figure 12: Navigation Parameters on the previous page). This value is positive when
Double 8
approaching the waypoint and becomes negative
on passing the waypoint
H+16
Direction from the current position to the
destination waypoint, in degrees, with respect to
7
bearing True North (or magnetic if corrected for
Double 8
magnetic variation by the MAGVAR command
on page 236)
H+24
8
along track
Horizontal track distance from the current position to the closest point on the waypoint arrival perpendicular; expressed in metres. This Double 8 value is positive when approaching the waypoint and becomes negative on passing the waypoint
H+32
OEM7 Commands and Logs Reference Manual v10
622
Chapter 3 Logs
Field
Field Type
9
xtrack
10
eta week
11
eta secs
12
xxxx
13
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
The horizontal distance (perpendicular track
error), from the vessel's present position to the
closest point on the great circle line, that joins
the FROM and TO waypoints. If a "track offset"
has been entered in the SETNAV command (see page 350), xtrack is the perpendicular error
Double
8
from the "offset track". Xtrack is expressed in
metres. Positive values indicate the current
position is right of the Track, while negative
offset values indicate left
H+40
Estimated GPS reference week number at time of arrival at the "TO" waypoint, along track arrival perpendicular based on current position and speed, in units of GPS reference weeks. If Ulong 4 the receiving antenna is moving at a speed of less than 0.1 m/s, in the direction of the destination, the value in this field is "9999"
H+48
Estimated GPS seconds into week at time of
arrival at destination waypoint along track
arrival perpendicular, based on current position
and speed, in units of GPS seconds into the
Double 8
week. If the receiving antenna is moving at a
speed of less than 0.1 m/s in the direction of the
destination, the value in this field is "0.000"
H+52
32-bit CRC (ASCII and Binary only)
Ulong 4
H+60
Sentence terminator (ASCII only)
-
-
-
Table 119: Navigation Data Type
Binary
ASCII
Description
0
GOOD
Navigation is good
1
NOVELOCITY
Navigation has no velocity
2
BADNAV
Navigation calculation failed for an unknown reason
3
FROM_TO_SAME
"From" is too close to "To" for computation
4
TOO_CLOSE_TO_TO Position is too close to "To" for computation
5
ANTIPODAL_WAYPTS Waypoints are antipodal on surface
OEM7 Commands and Logs Reference Manual v10
623
Chapter 3 Logs
3.95 NMEA Standard Logs
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains NMEA logs.
GLMLA GPALM GPGGA GPGGALONG GPGLL GPGRS GPGSA GPGST GPGSV GPHDT GPRMB GPRMC GPVTG GPZDA
GLONASS Almanac Data Almanac Data Global Position System Fix Data and Undulation GPS Fix Data, Extra Precision and Undulation Geographic Position GPS Range Residuals for Each Satellite GPS DOP on Active Satellites Pseudorange Measurement Noise Statistics GPS Satellites in View NMEA Heading Log (ALIGN) Navigation Information GPS Specific Information Track Made Good and Ground Speed UTC Time and Date
The NMEA log structures follow format standards as adopted by the National Marine Electronics Association. The reference document used is "Standard For Interfacing Marine Electronic Devices NMEA 0183 Version 3.01". For further information, refer to the Standards and References section of our website www.novatel.com/support/. The following table contains excerpts from Table 6 of the NMEA Standard which defines the variables for the NMEA logs. The actual format for each parameter is indicated after the description.
See the Note in the GPGGA log (see page 515) that applies to all NMEA logs.
1. Spaces may only be used in variable text fields. 2. A negative sign "-" (HEX 2D) is the first character in a Field if the value is negative.
The sign is omitted if the value is positive. 3. All data fields are delimited by a comma (,). 4. Null fields are indicated by no data between two commas (,,). Null fields indicate
invalid data or no data available. 5. The NMEA Standard requires that message length be limited to 82 characters.
Field Type Symbol Special Format Fields
Definition
OEM7 Commands and Logs Reference Manual v10
624
Chapter 3 Logs
Field Type Symbol
Definition
Status
A
Single character field: A = Yes, Data Valid, Warning Flag Clear V = No, Data Invalid, Warning Flag Set
Latitude
llll.ll
Fixed/Variable length field:
degrees|minutes.decimal - 2 fixed digits of degrees, 2 fixed digits of mins and a variable number of digits for decimal-fraction of mins. Leading zeros always included for degrees and mins to maintain fixed length. The decimal point and associated decimal-fraction are optional if full resolution is not required
Longitude
yyyyy.yy
Fixed/Variable length field:
degrees|minutes.decimal - 3 fixed digits of degrees, 2 fixed digits of mins and a variable number of digits for decimal-fraction of mins. Leading zeros always included for degrees and mins to maintain fixed length. The decimal point and associated decimal-fraction are optional if full resolution is not required
Time
Fixed/Variable length field:
hhmmss.ss
hours|minutes|seconds.decimal - 2 fixed digits of hours, 2 fixed digits of mins, 2 fixed digits of seconds and variable number of digits for decimal-fraction of seconds. Leading zeros always included for hours, mins and seconds to maintain fixed length. The decimal point and associated decimal-fraction are optional if full resolution is not required.
Defined field
Some fields are specified to contain predefined constants, most often alpha characters. Such a field is indicated in this standard by the presence of one or more valid characters. Excluded from the list of allowable characters are the following which are used to indicate field types within this standard:
"A", "a", "c", "hh", "hhmmss.ss", "llll.ll", "x", "yyyyy.yy"
Numeric Value Fields
Variable numbers
x.x
Variable length integer or floating numeric field. Optional leading and trailing zeros. The decimal point and associated decimal-fraction are optional if full resolution is not required (example: 73.10 = 73.1 = 073.1 = 73)
Fixed HEX field
hh___
Fixed length HEX numbers only, MSB on the left
Information Fields
Variable text c--c
Variable length valid character field
OEM7 Commands and Logs Reference Manual v10
625
Chapter 3 Logs
Field Type Symbol
Fixed alpha field
aa___
Fixed number field
xx___
Fixed text field
cc___
Definition Fixed length field of uppercase or lowercase alpha characters Fixed length field of numeric characters Fixed length field of valid characters
OEM7 Commands and Logs Reference Manual v10
626
Chapter 3 Logs
3.96 NOVATELXOBS
NovAtel proprietary RTK correction
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
NOVATELX is a combined observation and reference station message used to transmit RTK corrections. This is a proprietary message and supports sending data for all systems.
Message ID: 1618
Log Type: Synch
Recommended Input: log com2 novatelxobs ontime 1
To calculate the size of the NOVATELXOBS messages, use the following formula. Size = 168 + s * (6 + p * (54 + f*33) )
where: s = number of systems (maximum 8) p = number of PRN per system (maximum 64) f = number of signals data per PRN � 1 (maximum 10 signals possible)
Example size calculations: l For 2 systems (GPS and GLONASS), 12 PRN per system, and 2 signals per satellite (L1CA, L2PY) Size = 168 + 2 * (6 + 12 * (54 + 33)) = 2268 bits per second = 284 bytes + NovAtelXHeader (8 bytes)
l For 3 systems (GPS, BEIDOU and GLONASS), 12 PRN per system, and 2 signals per satellite (L1CA, L2PY) Size = 168 + 3 * (6 + 12 * (54 + 33)) = 3318 bits per second = 415 bytes + NovAtelXHeader (8 bytes)
l For 3 systems (GPS, BEIDOU and GLONASS), 12 PRN per system, and 3 signals per satellite (L1CA, L2PY, L2C) Size = 168 + 3 * (6 + 12 * (54 + 2*33)) = 4506 bits per second = 564 bytes + NovAtelXHeader (8 bytes)
OEM7 Commands and Logs Reference Manual v10
627
Chapter 3 Logs
3.97 NOVATELXREF
NovAtel proprietary reference station message for use in ALIGN
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
NOVATELXREF is a proprietary extended reference station message for use in ALIGN configurations only. This message enables the output of the MASTERPOS log (see page 599), ROVERPOS log (see page 741) and ALIGNBSLNENU log (see page 411) on the rover.
Message ID: 1620
Log Type: Synch
Recommended Input: log com2 novatelxref ontime 1
OEM7 Commands and Logs Reference Manual v10
628
Chapter 3 Logs
3.98 OCEANIXINFO
Oceanix subscription information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains details on the Oceanix subscription.
Message ID: 2159
Log Type: Asynch
Recommended Input: log oceanixinfoa onchanged
ASCII Example: #OCEANIXINFOA,COM1,0,83.0,FINESTEERING,1987,253328.270,02040020,9ce8,14635;"QU2 42:3004:3631",TERM,80001803,44,2018,0,NEARSHORE*de2b56e3
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
OCEANIXINFO Log header. See Messages on page 25 for
header
more information.
H
0
2
PAC
Product activation code
Char [16]
16
H
3
Type
Subscription type (see Table 120: Oceanix Subscription Type on the next page)
Enum
4
H+16
Services permitted by the subscription (see
Table 121: Oceanix Subscription Details
4
Subscription permissions
Mask on the next page) Hex
Note: Bits in the Reserved areas of this field
4
may be set, but the Reserved bits should be
ignored.
H+20
The day of the year when the subscription
5
Service End Day
ends.
Ulong 4
Service ends at 00:00 UTC on this day.
H+24
6
Service End Year
Year that the subscription ends.
Ulong 4
H+28
7
Reserved
Ulong 4
H+32
8
Region restriction
For region restricted subscriptions, the type
of region restriction (see Table 122:
Enum 4
Oceanix Region Restriction on the next page)
H+36
OEM7 Commands and Logs Reference Manual v10
629
Chapter 3 Logs
Field Field Type
Description
9
xxxx
10
[CR][LF]
32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+40
-
-
-
ASCII UNASSIGNED TERM MODEL
BUBBLE
INCOMPATIBLE_ SUBSCRIPTION
Table 120: Oceanix Subscription Type
Binary
Description
0
Decoder has not had an assigned operating mode
1
Term subscription
5
Reserved
100
Receiver is operating in an Oceanix-permitted subscriptionfree bubble
104
Subscription is incompatible with this version of firmware
Table 121: Oceanix Subscription Details Mask
Bit
Mask
Description
0
0x00000001 Reserved
1
0x00000002 Oceanix - H service
2-31 0xFFFFFFFC Reserved
Table 122: Oceanix Region Restriction
ASCII
Binary
Description
NONE
0
Oceanix operation has no region restrictions
GEOGATED 1
Oceanix operation is limited to land regions. GEOGATED is also the default value reported if there is no subscription
NEARSHORE 3
Oceanix operation is limited to land and near shore (coastal) regions
OEM7 Commands and Logs Reference Manual v10
630
Chapter 3 Logs
3.99 OCEANIXSTATUS
Oceanix decoder and subscription status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains status information for the Oceanix decoder and subscription.
Message ID: 2160
Log Type: Asynch
Recommended Input: log oceanixstatusa onchanged
ASCII Example: #OCEANIXSTATUSA,COM1,0,89.0,FINESTEERING,1982,315542.430,03000020,049a,32768;EN ABLE,LOCKED,IN_REGION*954083ea
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
OCEANIXSTATUS Log header. See Messages on page 25 for
header
more information.
H
0
2
Access
Access status.
ENABLE (1) if the subscription is valid.
Enum 4
H
DISABLE (0) otherwise
3
Sync state
Decoder data synchronization state (see Table 123: Decoder Data Synchronization Enum 4 State below)
H+4
4
Region restriction status
Region restriction status (see Table 124: Region Restriction Status on the next page)
Enum
4
H+8
5
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+12
6
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
Table 123: Decoder Data Synchronization State
ASCII Binary
Description
NO_SIGNAL
0
None of the decoders have received data in the last 30 seconds
SEARCH
1
At least one decoder is receiving data and is searching for the format
LOCKED
2
At lease one decoder has locked onto the format
OEM7 Commands and Logs Reference Manual v10
631
Chapter 3 Logs
Table 124: Region Restriction Status
ASCII
Binary
Description
UNKNOWN
0
Region restriction status cannot be determined
IN_REGION
1
Receiver is within the permitted region
OUT_OF_REGION
2
Receiver is outside the permitted region
OEM7 Commands and Logs Reference Manual v10
632
Chapter 3 Logs
3.100 PASSCOM, PASSAUX, PASSUSB, PASSETH1, PASSICOM, PASSNCOM
Redirects data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The pass-through logging feature enables the receiver to redirect any ASCII or binary data, input at a specified port, to any specified receiver port. It allows the receiver to perform bi-directional communications with other devices such as a modem, terminal or another receiver. See also the INTERFACEMODE command on page 198. There are many pass through logs: PASSCOM1, PASSCOM2, PASSCOM3, PASSCOM4, PASSCOM5, PASSCOM6, PASSAUX, PASSETH1, PASSICOM1, PASSICOM2, PASSICOM3, PASSICOM4, PASSICOM5, PASSICOM6, PASSICOM7, PASSNCOM1, PASSNCOM2, PASSNCOM3 allow for redirection of data that is arriving at COM1, COM2, COM3, virtual COM1, virtual COM2 or AUX. PASSCOM4 and PASSCOM5 are only available on OEM7600, OEM7700 and OEM7720 receivers. The AUX port is available on some products. PASSUSB1, PASSUSB2, PASSUSB3 are used to redirect data from USB1, USB2 or USB3. PASSETH1 is only available on receivers supporting Ethernet and can be used to redirect data from ETH1. A pass through log is initiated the same as any other log, that is, log [to-port] [data-type] [trigger]. However, pass-through can be more clearly specified as: log [to-port] [from-port-AB] [onchanged]. Now, the [from-port-AB] field designates the port which accepts data (that is, COM1, COM2, COM3, COM4, COM5, COM6, AUX, USB1, USB2 or USB3) as well as the format in which the data is logged by the [to-port] (A for ASCII or B for Binary).
To pass through data arriving on all ports, use the PASSTHROUGH log (see page 638).
When the [from-port-AB] field is suffixed with an [A], all data received by that port is redirected to the [to-port] in ASCII format and logs according to standard NovAtel ASCII format. Therefore, all incoming ASCII data is redirected and output as ASCII data. However, any binary data received is converted to a form of ASCII hexadecimal before it is logged. When the [from-port-AB] field is suffixed with a [B], all data received by that port is redirected to the [to-port] exactly as it is received. The log header and time tag adhere to standard NovAtel Binary format followed by the pass through data as it was received (ASCII or binary). Pass through logs are best utilized by setting the [trigger] field as onchanged or onnew. If the data being injected is ASCII, then the data is grouped together with the following rules:
l blocks of 80 characters l any block of characters ending in a <CR> l any block of characters ending in a <LF> l any block remaining in the receiver code when a timeout occurs (100 ms) If the data being injected is binary or the port INTERFACEMODE mode is set to GENERIC, then the data is grouped as follows: l blocks of 80 bytes l any block remaining in the receiver code when a timeout occurs (100 ms)
OEM7 Commands and Logs Reference Manual v10
633
Chapter 3 Logs
If a binary value is encountered in an ASCII output, then the byte is output as a hexadecimal byte preceded by a backslash and an x. For example 0A is output as \x0A. An actual `\' in the data is output as \\. The output counts as one pass through byte although it is four characters.
The first character of each pass-through record is time tagged in GPS reference weeks and seconds.
PASSAUX PASSCCOM1 PASSCCOM2 PASSCCOM3 PASSCCOM4 PASSCCOM5 PASSCCOM6 PASSCOM1 PASSCOM2 PASSCOM3 PASSCOM4 PASSCOM5 PASSCOM6 PASSCOM7 PASSCOM8 PASSCOM9 PASSCOM10 PASSETH1 PASSICOM1 PASSICOM2 PASSICOM3 PASSICOM4 PASSICOM5 PASSICOM6 PASSICOM7 PASSNCOM1 PASSNCOM2 PASSNCOM3 PASSUSB1 PASSUSB2 PASSUSB3
Message ID: 690 Message ID: 1893 Message ID: 1894 Message ID: 1895 Message ID: 1930 Message ID: 1937 Message ID: 1938 Message ID: 233 Message ID: 234 Message ID: 235 Message ID: 1384 Message ID: 1576 Message ID: 1577 Message ID: 1701 Message ID: 1702 Message ID: 1703 Message ID: 1704 Message ID: 1209 Message ID: 1250 Message ID: 1251 Message ID: 1252 Message ID: 1385 Message ID: 2119 Message ID: 2120 Message ID: 2121 Message ID: 1253 Message ID: 1254 Message ID: 1255 Message ID: 607 Message ID: 608 Message ID: 609
Log Type: Asynch
Recommended Input: log passcom1a onchanged
OEM7 Commands and Logs Reference Manual v10
634
Chapter 3 Logs
Asynchronous logs should only be logged ONCHANGED otherwise the most current data is not output when it is available. This is especially true of the ONTIME trigger, which may cause inaccurate time tags to result.
ASCII Example 1: #PASSCOM2A,COM1,0,59.5,FINESTEERING,1337,400920.135,02000000,2b46,1984;80, #BESTPOSA,COM3,0,80.0,FINESTEERING,1337,400920.000,02000000,4ca6,1899;SOL_ COMPUT*f9dfab46 #PASSCOM2A,COM1,0,64.0,FINESTEERING,1337,400920.201,02000000,2b46,1984;80,ED,SI NGLE,51.11636326036,-114.03824210485,1062.6015,16.2713,WGS84,1.8963,1.0674*807fd3ca #PASSCOM2A,COM1,0,53.5,FINESTEERING,1337,400920.856,02000000,2b46,1984;49,,2.28 62,"",0.000,0.000,9,9,0,0,0,0,0,0*20b24878\x0d\x0a*3eef4220 #PASSCOM1A,COM1,0,53.5,FINESTEERING,1337,400922.463,02000000,13ff,1984;17, unlog passcom2a\x0d\x0a*ef8d2508
ASCII Example 2: #PASSCOM2A,COM1,0,53.0,FINESTEERING,1337,400040.151,02000000,2b46,1984; 80,\x99A\x10\x04\x07yN&\xc6\xea\xf10\x00\x01\xde\x00\x00\x10\xfe\xbf \xfe1\xfe\x9c\xf4\x03\xe2\xef\x9f\x1f\xf3\xff\xd6\xff\xc3_A~z\xaa \xfe\xbf\xf9\xd3\xf8\xd4\xf4-\xe8kHo\xe2\x00>\xe0QOC>\xc3\x9c\x11\xff \x7f\xf4\xa1\xf3t\xf4'\xf4xvo\xe6\x00\x9d*dcd2e989 In the example, note that `~' is a printable character.
For example, you could connect two OEM7 family receivers together via their COM1 ports such as in the Figure 13: Pass Through Log Data on the next page (a rover station to base station scenario). If the rover station is logging BESTPOSA data to the base station, it is possible to use the pass through logs to pass through the received BESTPOSA data to a disk file (let's call it diskfile.log) at the base station host PC hard disk.
OEM7 Commands and Logs Reference Manual v10
635
Chapter 3 Logs
Figure 13: Pass Through Log Data
Under default conditions, the two receivers "chatter" back and forth with the Invalid Command Option message (due to the command interpreter in each receiver not recognizing the command prompts of the other receiver). The chattering in turn causes the accepting receiver to transmit new pass through logs with the response data from the other receiver. To avoid the chattering problem, use the INTERFACEMODE command (see page 198) on the accepting port to disable error reporting from the receiving port command interpreter.
If the accepting port's error reporting is disabled by INTERFACEMODE, the BESTPOSA data record passes through and creates two records.
The reason that two records are logged from the accepting receiver is the first record was initiated by receipt of the BESTPOSA first terminator <CR>. The second record followed in response to the BESTPOSA second terminator <LF>.
Note the time interval between the first character received and the terminating <LF> can be calculated by differencing the two GPS reference time tags. This pass through feature is useful for time tagging the arrival of external messages. These messages can be any user related data. When using this feature for tagging external events, it is recommended that the rover receiver be disabled from interpreting commands so the receiver does not respond to the messages, using the INTERFACEMODE command (see page 198).
If the BESTPOSB binary log data is input to the accepting port (log com2 passcom1a onchanged), the BESTPOSB binary data at the accepting port is converted to a variation of ASCII hexadecimal before it is passed through to com2 port for logging.
OEM7 Commands and Logs Reference Manual v10
636
Chapter 3 Logs
Field Field Type
Description
1
PASSCOM header
Log header. See Messages on page 25 for more information.
2
#bytes
Number of bytes to follow
3
data
Message data
Format
Binary Bytes
H
Ulong 4
Char [80]
80
4
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
5
[CR][LF]
Sentence terminator (ASCII only)
-
-
Binary Offset
0
H
H+4
H+4+ (#bytes) -
OEM7 Commands and Logs Reference Manual v10
637
Chapter 3 Logs
3.101 PASSTHROUGH
Redirected data from all ports
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log outputs pass through data from all receiver ports. The behavior is the same as the port specific pass though logs described in PASSCOM, PASSAUX, PASSUSB, PASSETH1, PASSICOM, PASSNCOM on page 633.
Message ID: 1342
Log Type: Asynch
Recommended Input: log passthrougha onchanged
ASCII Example: #PASSTHROUGHA,COM1,0,73.0,FINESTEERING,1625,165965.067,02040008,5fa3, 39275;USB1,80,i\xd3\x00\x87>\xb0\x00'\x91\xb3"\xa0D?\xaa\xb2\x00\x07op \x18@\x05\xe9\xd4\x08\xe7\x03\x7f\xfd\x18{\x80w\xff\xf2N_cy\x11\x80\ x0bC\xdc\x01@\x00\xdfr\xb1`\x873\xff\x81]\x7f\xe3\xff\xea\x83v\x08M\ xd8?\xfcr\xf7\x01\x18\x00\x17\x1d2\xd1\xd1b\x00*5cb8bd9a
Field Field type
Description
1
PASSTHROUGH Log header. See Messages on
header
page 25 for more information.
2
Port
See Table 59: COM Port Identifiers on page 338
3
#bytes
Number of bytes to follow
4
data
Message data
5
xxxx
6
[CR][LF]
32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
Ulong 4
Char [80]
80
Ulong 4
-
-
H H+4 H+8 H+8+#bytes -
OEM7 Commands and Logs Reference Manual v10
638
Chapter 3 Logs
3.102 PDPDOP
DOP values for the satellites in the PDP solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PDPDOP log contains the Dilution Of Precision (DOP) values for the satellites being used in the PDP solution. The PDP DOPs are updated every 60 seconds or whenever the satellites used in the PDP solution changes.
DOP values are a measure of the solution strength. Essentially, the DOPs reflect the geometry of the satellites used in the solution. Solutions with good counts of well-distributed satellites will have low DOPs and should be accurate and reliable. Solutions with fewer or poorly-distributed satellites will have high DOPs and be less accurate and reliable. As a rough guideline, PDOP values less than 4 imply a solution with reasonable geometry.
There can be many reasons for high DOP values. The most common reason is that there are obstructions limiting satellite visibility. Even if satellites are visible and being tracked they might still not be used in the solution if, for example, they are unhealthy or there are not corrections available for them. The PDPSATS log (see page 645) will inform which satellites are being tracked and explain why a tracked satellite is not used in the solution.
The DOPs do not consider that different satellites or signals will be weighted differently in the solution. Therefore, they do not completely reflect the solution quality. Ultimately, the standard deviations reported in the PDPPOS log (see page 643) are the best reflection of the solution accuracy.
Message ID: 1998
Log Type: Asynch
Recommended Input:
log pdpdopa onchanged
ASCII Example:
#PDPDOPA,USB1,0,82.0,FINESTEERING,2010,149390.500,02000008,3bf3,32768;1.6490,0. 9960,0.5950,0.7950,0.5280,5.0,22,3,28,19,6,2,24,12,22,17,1,50,59,61,52,60,51,1, 30,12,11,6,9*13e052ef
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
PDPDOP Log header. See Messages on page 25 for more header information.
-
H
0
Geometric dilution of precision - assumes 3D
2
gdop
position and receiver clock offset (all 4
Float
4
H
parameters) are unknown
3
pdop
Position dilution of precision - assumes 3D position is unknown and receiver clock offset is known
Float
4
H+4
OEM7 Commands and Logs Reference Manual v10
639
Chapter 3 Logs
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
4
hdop
Horizontal dilution of precision
Float
4
H+8
5
htdop Horizontal position and time dilution of precision Float
4
H+12
Time dilution of precision - assumes 3D position is
6
tdop
known and only the receiver clock offset is
Float
4
unknown
H+16
7
cutoff GPS elevation cut-off angle
Float
4
H+20
8
#PRN Number of satellites PRNs to follow
Long
4
H+24
9
PRN
PRN of a satellite used in the position solution
Ulong 4
H+28
10
Next PRN offset = H+28+(#prn x 4)
11
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+28+ (#prn x 4)
12
[CR] [LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
640
Chapter 3 Logs
3.103 PDPDOP2
DOP values for the satellites used in the PDP solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PDPDOP2 log contains the Dilution Of Precision (DOP) values for the satellites being used in the PDP solution. This log is similar to the PDPDOP log (see page 639) but contains the per-system TDOPs; see the PDPDOP log on page 639 for more information on the DOPs.
Message ID: 1995
Log Type: Asynch
Recommended Input: log pdpdop2a onchanged
ASCII Example: #PDPDOP2A,USB1,0,82.0,FINESTEERING,2010,149390.500,02000008,2488,32768;1.6490,0 .9960,0.5950,0.7990,4,GPS,0.5280,GLONASS,0.6880,GALILEO,0.7200,BEIDOU,0.6750*25 f8324a
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
PDPDOP2 Log header. See Messages on page 25 for
header
more information.
H
0
Geometric dilution of precision - assumes 3D
2
GDOP
position and receiver clock offset (all 4
Float
4
H
parameters) are unknown
Position dilution of precision - assumes 3D
3
PDOP
position is unknown and receiver clock offset Float
4
is known
H+4
4
HDOP
Horizontal dilution of precision
Float
4
H+8
5
VDOP
Vertical dilution of precision
Float
4
H+12
6
#systems Number of systems
Ulong 4
H+16
7
system
See Table 125: System Used for Timing on the next page
Enum
4
H+20
8
TDOP
Time dilution of precision
Float
4
H+24
9
Next system offset = H+20+(#systems x 8)
OEM7 Commands and Logs Reference Manual v10
641
Chapter 3 Logs
Field
Field type
Description
10
xxxx
32-bit CRC (ASCII and Binary only)
11
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Hex
4
H+20+ (#systems x 8)
-
-
-
Table 125: System Used for Timing
Binary
ASCII
0
GPS
1
GLONASS
2
GALILEO
3
BEIDOU
4
NAVIC
99
AUTO1
1AUTO is used only as a backup system (not available for primary system field). OEM7 Commands and Logs Reference Manual v10
642
Chapter 3 Logs
3.104 PDPPOS
PDP filter position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PDPPOS log contains the receiver position computed by the receiver with the PDP filter enabled. See also the PDPFILTER command on page 259.
Message ID: 469
Log Type: Synch
Recommended Input: log pdpposa ontime 1
ASCII Example: #PDPPOSA,COM1,0,75.5,FINESTEERING,1431,494991.000,02040000,a210,35548; SOL_ COMPUTED,SINGLE,51.11635010310,-114.03832575772,1065.5019,16.9000,WGS84,4.7976,2.0897,5.3062,"",0.000,0.000,8,8,0,0,0,0,0,0*3cbfa646
Field
Field type
1
PDPPOS header
2
sol status
3
pos type
4
lat
5
lon
6
hgt
Description
Log header. See Messages on page 25 for more information.
Solution status (refer to Table 74: Solution Status on page 436)
Position type (refer to Table 75: Position or Velocity Type on page 437)
Latitude (degrees)
Longitude (degrees)
Height above mean sea level (m)
Undulation - the relationship between the geoid and the WGS84 ellipsoid (m)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
Double 8 Double 8 Double 8
H+4
H+8 H+16 H+24
7
undulation
When using a datum other than WGS84, the undulation value also includes the vertical shift due to differences between the datum in use and WGS84.
Float
4
8
datum id#
Datum ID number (refer to Table 29: Datum Transformation Parameters on page 121)
Enum 4
H+32 H+36
OEM7 Commands and Logs Reference Manual v10
643
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
9
lat
Latitude standard deviation (m)
Float
4
H+40
10
lon
Longitude standard deviation (m)
Float
4
H+44
11
hgt
Height standard deviation (m)
Float
4
H+48
12
stn id
Base station ID
Char[4] 4
H+52
13
diff_age Differential age in seconds
Float
4
H+56
14
sol_age Solution age in seconds
Float
4
H+60
15
#sats
Number of satellites tracked
Uchar 1
H+64
16
#sats soln Number of satellites in the solution
Uchar 1
H+65
17
Uchar 1
H+66
18
Reserved
Uchar 1
H+67
19
Hex
1
H+68
20
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Hex
1
H+69
21
Galileo and BeiDou sig mask
Galileo and BeiDou signals used mask (see Table
77: Galileo and BeiDou Signal-Used Mask on
Hex
page 440)
1
H+70
GPS and GPS and GLONASS signals used mask (see Table
22
GLONASS 76: GPS and GLONASS Signal-Used Mask on
Hex
1
sig mask page 439)
H+71
23
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+72
24
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
644
Chapter 3 Logs
3.105 PDPSATS
Satellites used in PDPPOS solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists the used and unused satellites for the corresponding PDPPOS solution. It also describes the signals of the used satellites and reasons for exclusions.
Message ID: 1234
Log Type: Synch
Recommended Input: log pdpsatsa ontime 1
Abbreviated ASCII Example: <PDPSATS COM1 0 80.0 FINESTEERING 1690 603073.000 02000008 be33 43488 < 21 < GPS 11 GOOD 00000001 < GPS 27 GOOD 00000001 ... < GPS 1 GOOD 00000001 < GPS 7 GOOD 00000001 < SBAS 133 NOTUSED 00000000 < SBAS 138 NOTUSED 00000000 < SBAS 135 NOTUSED 00000000 < GLONASS 10-7 GOOD 00000001 < GLONASS 21+4 GOOD 00000001 ... < GLONASS 12-1 GOOD 00000001 < GLONASS 11 GOOD 00000001
Field
Field type
Description
1
PDPSATS Log header. See Messages on page 25 for more header information.
2
#entries Number of records to follow
3
system See Table 105: Satellite System on page 553
4
Satellite ID
Satellite identifier
5
Status
Satellite status (see Table 80: Observation Statuses on page 443)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Enum 4
H H+4
Ulong 4
H+8
Enum 4
H+12
OEM7 Commands and Logs Reference Manual v10
645
Chapter 3 Logs
Field
Field type
Description
See Table 81: BESTSATS GPS Signal Mask on
6
Status mask
page 444, Table 82: BESTSATS GLONASS Signal Mask on page 445, Table 83: BESTSATS Galileo Signal Mask on page 445, and Table 84:
BESTSATS BeiDou Signal Mask on page 445
7
Next satellite offset = H+4+(#sat x 16)
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Hex
4
H+16
Ulong 4
-
-
H+4+ (#sat x 16)
-
OEM7 Commands and Logs Reference Manual v10
646
Chapter 3 Logs
3.106 PDPVEL
PDP filter velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PDPVEL log contains the pseudorange velocity computed by the receiver with the PDP filter enabled. See also the PDPFILTER command on page 259.
Message ID: 470
Log Type: Synch
Recommended Input: log pdpvela ontime 1
ASCII Example: #PDPVELA,COM1,0,75.0,FINESTEERING,1430,505990.000,02000000,b886,2859;SOL_ COMPUTED,SINGLE,0.150,0.000,27.4126,179.424617,-0.5521,0.0*7746b0fe
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
PDPVEL Log header. See Messages on page 25 for more header information.
H
0
2
sol status
Solution status (refer to Table 74: Solution Status on page 436)
Enum
4
H
3
vel type
Velocity type (refer to Table 75: Position or Velocity Type on page 437)
Enum 4
H+4
A measure of the latency in the velocity time tag in
4
latency seconds. It should be subtracted from the time to Float
4
give improved results
H+8
5
age
Differential age in seconds
Float
4
H+12
6
hor spd
Horizontal speed over ground, in metres per second
Double 8
H+16
7
trk gnd
Actual direction of motion over ground (track over ground) with respect to True North, in degrees
Double 8
H+24
Height in metres where positive values indicate
8
height increasing altitude (up) and negative values
Double 8
indicate decreasing altitude (down)
H+32
9
Reserved
Float
4
H+40
10
xxxx 32-bit CRC (ASCII and Binary only)
Ulong 4
H+44
11
[CR] [LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
647
Chapter 3 Logs
3.107 PDPXYZ
PDP filter Cartesian position and velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PDPXYZ log contains the Cartesian position in X, Y and Z coordinates as computed by the receiver with the PDP filter enabled. See also the PDPFILTER command on page 259.
Message ID: 471
Log Type: Synch
Recommended Input: log pdpxyza ontime 1
ASCII Example: #PDPXYZA,COM1,0,75.5,FINESTEERING,1431,494991.000,02040000,33ce,35548;SOL_ COMPUTED,SINGLE,-1634531.8128,3664619.4862,4942496.5025,2.9036,6.1657,3.0153,SOL_COMPUTED,SINGLE,-2.5588e308,-3.1719e-308,3.9151e308,0.0100,0.0100,0.0100,"",0.150,0.000,0.000,8,8,0,0,0,0,0,0*a20dbd4f
Field
Field type
1
PDPXYZ header
2
P-sol status
3
pos type
4
P-X
5
P-Y
6
P-Z
7
P-X
8
P- Y
9
P-Z
10
V-sol status
11
vel type
Description
Log header. See Messages on page 25 for more information. Solution status (refer to Table 74: Solution Status on page 436) Position type (refer to Table 75: Position or Velocity Type on page 437) Position X-coordinate (m) Position Y-coordinate (m) Position Z-coordinate (m) Standard deviation of P-X (m) Standard deviation of P-Y (m) Standard deviation of P-Z (m) Solution status (refer to Table 74: Solution Status on page 436) Velocity type (refer to Table 75: Position or Velocity Type on page 437)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
Double 8
Double 8
Double 8
Float
4
Float
4
Float
4
Enum 4
H+4
H+8 H+16 H+24 H+32 H+36 H+40
H+44
Enum 4
H+48
OEM7 Commands and Logs Reference Manual v10
648
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
12
V-X
Velocity vector along X-axis (m)
Double 8
H+52
13
V-Y
Velocity vector along Y-axis (m)
Double 8
H+60
14
V-Z
Velocity vector along Z-axis (m)
Double 8
H+68
15
V-X
Standard deviation of V-X (m)
Float
4
H+76
16
V-Y
Standard deviation of V-Y (m)
Float
4
H+80
17
V-Z
Standard deviation of V-Z (m)
Float
4
H+84
18
stn ID
Base station ID
Char[4] 4
H+88
A measure of the latency in the velocity time tag
19
V-latency in seconds. It should be subtracted from the
Float
4
time to give improved results
H+92
20
diff_age Differential age in seconds
Float
4
H+96
21
sol_age
Solution age in seconds
Float
4
H+100
22
#sats
Number of satellite vehicles tracked
Uchar 1
H+104
23
#sats soln Number of satellite vehicles used in solution
Uchar 1
H+105
24
Uchar 1
H+106
25
Reserved
Uchar 1
H+107
26
Uchar 1
H+108
27
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Hex
1
H+109
28
Galileo and BeiDou sig mask
Galileo and BeiDou signals used mask (see Table 77: Galileo and BeiDou Signal-Used Mask on page 440)
Hex
1
H+110
GPS and GPS and GLONASS signals used mask (see Table
29
GLONASS 76: GPS and GLONASS Signal-Used Mask on
Hex
1
sig mask page 439)
H+111
30
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+112
31
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
649
Chapter 3 Logs
3.108 PORTSTATS
Port statistics
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log conveys various status parameters of the receiver's communication ports. The receiver maintains a running count of a variety of status indicators of the data link. This log outputs a report of those indicators.
Message ID: 72
Log Type: Polled
Recommended Input: log portstatsa once
ASCII example: #PORTSTATSA,USB1,0,69.5,FINESTEERING,1971,489026.000,02004020,a872,14434;29,COM 1,0,3109742555,0,0,435636653,0,0,0,0,COM2,0,207,0,0,32,0,0,0,0,COM3,0,207,0,0,3 2,0,0,0,0,FILE,0,0,0,0,0,0,0,0,0,USB1,175513,21321491,175513,0,0,0,0,0,0,USB2,0 ,0,0,0,0,0,0,0,0,USB3,0,0,0,0,0,0,0,0,0,COM4,139542424,189379232,139542424,0,69 771230,0,0,0,0,ICOM1,0,0,0,0,0,0,0,0,0,ICOM2,0,0,0,0,0,0,0,0,0,ICOM3,0,0,0,0,0, 0,0,0,0,NCOM1,0,0,0,0,0,0,0,0,0,NCOM2,0,0,0,0,0,0,0,0,0,NCOM3,0,0,0,0,0,0,0,0,0 ,ICOM4,0,0,0,0,0,0,0,0,0,WCOM1,0,394864554,0,0,0,0,0,0,0,COM5,0,6,0,0,4,0,0,0,0 ,CCOM1,0,0,0,0,0,0,0,0,0,CCOM2,0,0,0,0,0,0,0,0,0,CCOM3,0,0,0,0,0,0,0,0,0,CCOM4, 0,0,0,0,0,0,0,0,0,CCOM5,0,0,0,0,0,0,0,0,0,CCOM6,0,0,0,0,0,0,0,0,0,ICOM5,0,0,0,0 ,0,0,0,0,0,ICOM6,0,0,0,0,0,0,0,0,0,ICOM7,0,0,0,0,0,0,0,0,0*b9c28761
Parity and framing errors occur for COM ports if poor transmission lines are encountered or if there is an incompatibility in the data protocol. If errors occur, you may need to confirm the bit rate, number of data bits, number of stop bits and parity of both the transmit and receiving ends. Characters may be dropped when the CPU is overloaded.
Field Field type
Description
Format
Binary Bytes
1
PORTSTATS Log header. See Messages on page 25 for
header
more information.
H
2
#port
Number of ports with information to follow Long
4
3
port
Refer to Table 32: Communications Port Identifiers on page 137
Enum
4
4
rx chars
Total number of characters received through this port
Ulong 4
Binary Offset 0 H H+4
H+8
OEM7 Commands and Logs Reference Manual v10
650
Chapter 3 Logs
Field Field type
Description
5
tx chars
Total number of characters transmitted through this port
6
acc rx chars
Total number of accepted characters received through this port
7
dropped rx chars
Number of software overruns in receive
8
interrupts Number of interrupts on this port
9
breaks
Number of breaks (only for serial ports)
10
par err
Number of parity errors (only for serial ports)
11
frame err
Number of framing errors (only for serial ports)
12
rx overruns Number of hardware overruns in receive
13
Next port offset = H+4+(#port x 40)
14
xxxx
32-bit CRC (ASCII and Binary only)
15
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+12
Ulong 4
H+16
Ulong 4 Ulong 4 Ulong 4 Ulong 4
H+20 H+24 H+28 H+32
Ulong 4 Ulong 4
H+36 H+40
Ulong 4
-
-
H+4+ (#port x 40)
-
OEM7 Commands and Logs Reference Manual v10
651
Chapter 3 Logs
3.109 PPPPOS
PPP filter position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the position solution computed by the PPP filter.
Message ID: 1538
Log Type: Synch
Recommended Input: log pppposa ontime 1
ASCII Example: #PPPPOSA,COM1,0,80.0,FINESTEERING,1735,345300.000,02000000,6f47,44027;SOL_ COMPUTED,PPP,51.11635350286,-114.03819287079,1064.5365,16.9000,WGS84,0.0375,0.0460,0.0603,"0",4.000,0.000,12,12,12,12,0,00,00,03*ef17d 668
Field Field type
1
PPPPOS header
2
Status
3
Type
4
lat
5
lon
6
hgt
7
undulation
8
datum id#
9
lat
10
lon
Description
Log header. See Messages on page 25 for more information.
Solution status (see Table 74: Solution Status on page 436)
Position type (see Table 126: Position Type on the next page)
Latitude (degrees)
Longitude (degrees)
Height above mean sea level (m)
Undulation - the relationship between the geoid and the WGS84 ellipsoid (m)a
Datum ID number (see Table 29: Datum Transformation Parameters on page 121)
Latitude standard deviation (m)
Longitude standard deviation (m)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
Double 8 Double 8 Double 8
Float
4
H+4 H+8 H+16 H+24 H+32
Enum 4
Float
4
Float
4
H+36 H+40 H+44
aWhen using a datum other than WGS84, the undulation value also includes the vertical shift due to differences between the datum in use and WGS84.
OEM7 Commands and Logs Reference Manual v10
652
Chapter 3 Logs
Field Field type
Description
11
hgt
Height standard deviation (m)
12
stn id
Base station ID
13
diff_age
Differential age in seconds
14
sol_age
Solution age in seconds
15
#SVs
Number of satellites tracked
16
#solnSVs
Number of satellites vehicles used in solution
17
#ggL1
Number of GPS plus GLONASS plus BDS L1/B1 used in solution
18
#solnMultiSVs
Number of satellites with multi-frequency signals used in solution
19
Reserved
20
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
21
Reserved
22
GPS and GLONASS sig mask
GPS and GLONASS signals used mask (see Table 76: GPS and GLONASS Signal-Used Mask on page 439 or Table 77: Galileo and BeiDou Signal-Used Mask on page 440)
23
xxxx
32-bit CRC (ASCII and Binary only)
24
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Float
4
H+48
Char[4] 4
H+52
Float
4
H+56
Float
4
H+60
Uchar 1
H+64
Uchar 1
H+65
Uchar 1
H+66
Uchar 1
Hex
1
Hex
1
Hex
1
H+67 H+68 H+69 H+70
Hex
1
H+71
Ulong 4
-
-
H+72 -
Table 126: Position Type
ASCII
Binary
Description
NONE
0
No solution
PPP_CONVERGING
68 Converging TerraStar-C solution
PPP
69 Converged TerraStar-C solution
PPP_BASIC_CONVERGING 77 Converging TerraStar-L solution
PPP_BASIC
78 Converged TerraStar-L solution
OEM7 Commands and Logs Reference Manual v10
653
Chapter 3 Logs
3.110 PPPSATS
Satellites used in the PPPPOS solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists the used and unused satellites for the corresponding PPPPOS solution. It also describes the signals of the used satellites and reasons for exclusions.
Message ID: 1541
Log Type: Synch
Recommended Input: log pppsatsa ontime 1
Abbreviated ASCII Example: <PPPSATS COM1 0 80.0 FINESTEERING 1735 345300.000 02000000 ce3f 44027 < 12 < GPS 3 GOOD 00000003 < GPS 5 GOOD 00000003 < GPS 6 GOOD 00000003 < GPS 7 GOOD 00000003 < GPS 8 GOOD 00000003 < GPS 10 GOOD 00000003 < GPS 13 GOOD 00000003 < GPS 16 GOOD 00000003 < GPS 19 GOOD 00000003 < GPS 23 GOOD 00000003 < GPS 26 GOOD 00000003 < GPS 28 GOOD 00000003
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
PPPSATS Log header. See Messages on page 25 for more header information.
H
0
2
#entries Number of records to follow
Ulong 4
H
3
System
Satellite system (see Table 105: Satellite System on page 553)
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
654
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
In binary logs, the satellite ID field is 4 bytes.
The 2 lowest-order bytes, interpreted as a
USHORT, are the system identifier: for
instance, the PRN for GPS, or the slot for
GLONASS. The 2 highest-order bytes are the
frequency channel for GLONASS, interpreted as
4
Satellite a SHORT and zero for all other systems. ID
Ulong 4
In ASCII and abbreviated ASCII logs, the
satellite ID field is the system identifier. If the
system is GLONASS and the frequency channel
is not zero, then the signed channel is appended
to the system identifier. For example, slot 13,
frequency channel -2 is output as 13-2.
H+8
5
Status
Satellite status (see Table 80: Observation Statuses on page 443)
Enum 4
H+12
Signals used in the solution (see Table 81:
BESTSATS GPS Signal Mask on page 444, Table
6
Signal Mask
82: BESTSATS GLONASS Signal Mask on page 445, Table 83: BESTSATS Galileo Signal
Hex
4
Mask on page 445 and Table 84: BESTSATS
BeiDou Signal Mask on page 445)
H+16
7
Next satellite offset = H + 4 + (#entries x 16)
8
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+4+ (#entries x 16)
9
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
655
Chapter 3 Logs
3.111 PROFILEINFO
Profile information in NVM
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log outputs a list of Profiles in the system. Refer also to the PROFILE command on page 283.
A list may consist of a maximum of 20 profiles.
Message ID: 1412
Log Type: Polled
Recommended Input: log profileinfoa onchanged
ASCII Examples: #PROFILEINFOA,COM1,0,84.0,UNKNOWN,0,17539.339,024c0020,ae3a,10526; "BASE",0,2, "LOG VERSION", "SERIALCONFIG COM2 230400"*0ad5cda5
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
PROFILEINFO Log header. See Messages on page 25
header
for more information.
-
H
0
2
Name
Profile Name
String [Max 20]
variable
1
H
3
Status Word
Refer toTable 127: Status Word on the next page
Ulong
4
variable
4
# of Commands
Number of commands assigned to the Profile
Ulong
4
variable
5
Command
Profile command
String
variable
[Max 150] 1
variable
6
Next command offset = variable
7
xxxx
32-bit CRC (ASCII and Binary only)
Ulong
4
variable
8
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
656
Chapter 3 Logs
Table 127: Status Word
Bit #
Mask
Description
0
0x00000001
Activate Flag (0 � Deactivate (default), 1 �Activate)
1 � 3 0x0000000E Reserved
4
0x00000010
Command 1 validation Flag (0 � Valid (default), 1 � Invalid)
5
0x00000020 Command 2 validation Flag
6
0x00000040 Command 3 validation Flag
7
0x00000080 Command 4 validation Flag
8
0x00000100 Command 5 validation Flag
9
0x00000200 Command 6 validation Flag
10
0x00000400 Command 7 validation Flag
11
0x00000800 Command 8 validation Flag
12
0x00001000 Command 9 validation Flag
13
0x00002000 Command 10 validation Flag
14
0x00004000 Command 11 validation Flag
15
0x00008000 Command 12 validation Flag
16
0x00010000 Command 13 validation Flag
17
0x00020000 Command 14 validation Flag
18
0x00040000 Command 15 validation Flag
19
0x00080000 Command 16 validation Flag
20
0x00100000 Command 17 validation Flag
21
0x00200000 Command 18 validation Flag
22
0x00400000 Command 19 validation Flag
23
0x00800000 Command 20 validation Flag
24 - 31 0xFF000000 Reserved
OEM7 Commands and Logs Reference Manual v10
657
Chapter 3 Logs
3.112 PSRDOP
DOP values for the satellites used in the PSR solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PSRDOP log contains the Dilution Of Precision (DOP) values for the satellites being used in the PSR solution. The PSR DOPs are updated every 60 seconds or whenever the satellites used in the PSR solution changes.
DOP values are a measure of the solution strength. Essentially, the DOPs reflect the geometry of the satellites used in the solution. Solutions with good counts of well-distributed satellites will have low DOPs and should be accurate and reliable. Solutions with fewer or poorly-distributed satellites will have high DOPs and be less accurate and reliable. As a rough guideline, PDOP values less than 4 imply a solution with reasonable geometry.
There can be many reasons for high DOP values. The most common reason is that there are obstructions limiting satellite visibility. Even if satellites are visible and being tracked they might still not be used in the solution if, for example, they are unhealthy or there are not corrections available for them. The PSRSATS log (see page 664) will inform which satellites are being tracked and explain why a tracked satellite is not used in the solution.
The DOPs do not consider that different satellites or signals will be weighted differently in the solution. Therefore, they do not completely reflect the solution quality. Ultimately, the standard deviations reported in the PSRPOS log (see page 662) are the best reflection of the solution accuracy.
1. If a satellite is locked out using the LOCKOUT command (see page 223), it will still show in the prn list but it will be significantly deweighted in the dop calculation.
2. The vertical dilution of precision can be calculated by: vdop = pdop2 - hdop2
3. If the DOP is not yet calculated, a default value of 9999.0 is displayed.
Message ID: 174
Log Type: Asynch
Recommended Input: log psrdopa onchanged
ASCII Example: #PSRDOPA,COM1,0,56.5,FINESTEERING,1337,403100.000,02000000,768f,1984;1.9695,1.7 613,1.0630,1.3808,0.8812,5.0,10,14,22,25,1,24,11,5,20,30,7*106de10a
Field
Field type
1
PSRDOP Log header. See Messages on page 25 for more header information.
Format
Binary Bytes
Binary Offset
H
0
OEM7 Commands and Logs Reference Manual v10
658
Chapter 3 Logs
Field
Field type
Format
Binary Bytes
Binary Offset
Geometric dilution of precision - assumes 3D
2
gdop
position and receiver clock offset (all 4
Float
4
H
parameters) are unknown
3
pdop
Position dilution of precision - assumes 3D position is unknown and receiver clock offset is known
Float
4
H+4
4
hdop
Horizontal dilution of precision.
Float
4
H+8
5
htdop Horizontal position and time dilution of precision. Float
4
H+12
Time dilution of precision - assumes 3D position is
6
tdop
known and only the receiver clock offset is
Float
4
unknown
H+16
7
cutoff GPS elevation cut-off angle
Float
4
H+20
8
#PRN Number of satellites PRNs to follow
Long
4
H+24
9
PRN
PRN of SV PRN tracking, null field until position solution available
Ulong 4
H+28
10... Next PRN offset = H+28+(#prn x 4)
11
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+28+ (#prn x 4)
12
[CR] [LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
659
Chapter 3 Logs
3.113 PSRDOP2
DOP values for the satellites used in the PSR solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PSRDOP2 log contains the Dilution Of Precision (DOP) values for the satellites being used in the PSR solution. This log is similar to the PSRDOP log (see page 658) but contains the per-system TDOPs; see the PSRDOP log on page 658 for more information on the DOPs.
Message ID: 1163
Log Type: Asynch
Recommended Input: log psrdop2a onchanged
ASCII Example: #PSRDOP2A,COM1,0,89.5,FINESTEERING,1613,164820.000,02000008,0802,39031;1.6740,1 .3010,0.6900,1.1030,2,GPS,0.6890,GLONASS,0.7980*5dd123d0.
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
PSRDOP2 Log header. See Messages on page 25 for
header
more information.
H
0
Geometric dilution of precision - assumes 3D
2
GDOP
position and receiver clock offset (all 4
Float
4
H
parameters) are unknown
Position dilution of precision - assumes 3D
3
PDOP
position is unknown and receiver clock offset Float
4
is known
H+4
4
HDOP
Horizontal dilution of precision
Float
4
H+8
5
VDOP
Vertical dilution of precision
Float
4
H+12
6
#systems Number of systems
Ulong 4
H+16
7
system
See Table 128: System Used for Timing on the next page
Enum
4
H+20
8
TDOP
Time dilution of precision
Float
4
H+24
9
Next satellite offset = H+20+(#systems x 8)
10
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+20+ (#systems x 8)
11
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
660
Chapter 3 Logs
Table 128: System Used for Timing
Binary
ASCII
0
GPS
1
GLONASS
2
GALILEO
3
BEIDOU
4
NAVIC
99
AUTO1
1AUTO is used only as a backup system (not available for primary system field). OEM7 Commands and Logs Reference Manual v10
661
Chapter 3 Logs
3.114 PSRPOS
Pseudorange position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the position computed by the receiver, along with three status flags. In addition, it reports other status indicators, including differential age, which is useful in predicting anomalous behavior brought about by outages in differential corrections.
Message ID: 47
Log Type: Synch
Recommended Input:
log psrposa ontime 1
ASCII Example:
#PSRPOSA,COM1,0,58.5,FINESTEERING,1419,340037.000,02000040,6326,2724;SOL_ COMPUTED,SINGLE,51.11636177893,-114.03832396506,1062.5470,16.2712,WGS84,1.8532,1.4199,3.3168,"",0.000,0.000,12,12,0,0,0,06,0,33*d200a78c
There are DGPS use cases in which the base receiver is not maintained or controlled by the positioning user. For example, the US Coast Guard operates a differential correction service which broadcasts GPS differential corrections over marine radio beacons. As a user, all you need is a marine beacon receiver and a GNSS receiver to achieve positioning accuracy of less than 1 metre. In this case, the Coast Guard owns and operates the base receiver at known coordinates. Other examples of users appearing to use only one GNSS receiver include FM radio station correction services, privately owned radio transmitters and corrections carried by communication satellites. Some of the radio receivers have built-in GNSS receivers and combined antennas, so they even appear to look as one self contained unit. The major factors degrading GPS signals which can be removed or reduced with differential methods are the atmosphere, ionosphere, satellite orbit errors, and satellite clock errors. Some errors which are not removed include receiver noise and multipath.
Field Field type
Description
1
PSRPOS header
Log header. See Messages on page 25 for more information.
2
sol status
Solution status (see Table 74: Solution Status on page 436)
3
pos type
Position type (see Table 75: Position or Velocity Type on page 437)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
H+4
OEM7 Commands and Logs Reference Manual v10
662
Chapter 3 Logs
Field Field type
Description
4
lat
Latitude (degrees)
5
lon
Longitude (degrees)
6
hgt
Height above mean sea level (m)
7
undulation
Undulation - the relationship between the geoid and the WGS84 ellipsoid (m) a
8
datum id#
Datum ID number (see Table 29: Datum Transformation Parameters on page 121)
9
lat
Latitude standard deviation (m)
10
lon
Longitude standard deviation (m)
11
hgt
Height standard deviation (m)
12
stn id
Base station ID
13
diff_age
Differential age in seconds
14
sol_age
Solution age in seconds
15
#SVs
Number of satellites tracked
16
#solnSVs Number of satellite vehicles used in solution
17
18
Reserved
19
20
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Galileo and Galileo and BeiDou signals used mask (see
21
BeiDou sig Table 77: Galileo and BeiDou Signal-Used
mask
Mask on page 440)
GPS and
GPS and GLONASS signals used mask (see
22
GLONASS Table 76: GPS and GLONASS Signal-Used
sig mask
Mask on page 439)
23
xxxx
32-bit CRC (ASCII and Binary only)
24
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+8
Double 8
H+16
Double 8
H+24
Float
4
H+32
Enum 4
Float
4
Float
4
Float
4
Char[4] 4
Float
4
Float
4
Uchar 1
Uchar 1
Uchar 1
Uchar 1
Hex
1
Hex
1
H+36
H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+65 H+66 H+67 H+68
H+69
Hex
1
H+70
Hex
1
Hex
4
-
-
H+71
H+72 -
aWhen using a datum other than WGS84, the undulation value also includes the vertical shift due to differences between the datum in use and WGS84.
OEM7 Commands and Logs Reference Manual v10
663
Chapter 3 Logs
3.115 PSRSATS
Satellites used in PSRPOS solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists the used and unused satellites for the corresponding PSRPOS solution. It also describes the signals of the used satellites and reasons for exclusions.
Message ID: 1162
Log Type: Synch
Recommended Input:
log psrsats ontime 1
Abbreviated ASCII Example:
<PSRSATS COM1 0 80.0 FINESTEERING 1729 154910.000 02004000 fea4 11465 < 20 < GPS 31 GOOD 00000003 < GPS 14 GOOD 00000003 < GPS 22 GOOD 00000003 < GPS 11 GOOD 00000003 < GPS 1 GOOD 00000003 < GPS 32 GOOD 00000003 < GPS 18 GOOD 00000003 < GPS 24 GOOD 00000003 < GPS 19 GOOD 00000003 < GLONASS 24+2 GOOD 00000003 < GLONASS 10-7 GOOD 00000003 < GLONASS 9-2 GOOD 00000003 < GLONASS 2-4 GOOD 00000003 < GLONASS 1+1 GOOD 00000003 < GLONASS 11 GOOD 00000003 < GLONASS 17+4 GOOD 00000003 < GLONASS 18-3 GOOD 00000003 < GALILEO 12 LOCKEDOUT 00000000 < GALILEO 11 LOCKEDOUT 00000000 < BEIDOU 8 GOOD 00000003
Field
Field type
Description
1
PSRSATS Log header. See Messages on page 25 for more header information.
2
#entries Number of records to follow
3
system See Table 105: Satellite System on page 553
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Enum 4
H H+4
OEM7 Commands and Logs Reference Manual v10
664
Chapter 3 Logs
Field
Field type
4
Satellite ID
Description Satellite identifier
5
Status
Satellite status (see Table 80: Observation Statuses on page 443)
See Table 81: BESTSATS GPS Signal Mask on
6
Signal mask
page 444, Table 82: BESTSATS GLONASS Signal Mask on page 445, Table 83: BESTSATS Galileo Signal Mask on page 445, and Table 84:
BESTSATS BeiDou Signal Mask on page 445
7
Next satellite offset = H+4+(#sat x 16)
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+8
Enum 4
H+12
Hex
4
H+16
Hex
4
-
-
H+4+ (#sat x 16)
-
OEM7 Commands and Logs Reference Manual v10
665
Chapter 3 Logs
3.116 PSRVEL
Pseudorange velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
In the PSRVEL log the actual speed and direction of the receiver antenna over ground is provided. The velocity measurements sometimes have a latency associated with them. The time of validity is the time tag in the log minus the latency value.
In a PSRVEL log, the actual speed and direction of the receiver antenna over ground is provided. The receiver does not determine the direction a vessel, craft or vehicle is pointed (heading) but rather the direction of motion of the GNSS antenna relative to ground.
The velocity in the PSRVEL log is determined by the pseudorange filter. Velocities from the pseudorange filter are calculated from the Doppler. The velocity status indicates varying degrees of velocity quality. To ensure healthy velocity, the velocity sol-status must also be checked. If the sol-status is non-zero, the velocity is likely invalid. It should be noted that the receiver does not determine the direction a vessel, craft, or vehicle is pointed (heading), but rather the direction of the motion of the GPS antenna relative to the ground. The latency of the instantaneous Doppler velocity is always 0.15 seconds. The latency represents an estimate of the delay caused by the tracking loops under acceleration of approximately 1 G. For most users, the latency can be assumed to be zero (instantaneous velocity).
Message ID: 100
Log Type: Synch
Recommended Input: log psrvela ontime 1
ASCII Example: #PSRVELA,COM1,0,52.5,FINESTEERING,1337,403362.000,02000000,658b,1984;SOL_ COMPUTED,PSRDIFF,0.250,9.000,0.0698,26.582692,0.0172,0.0*a94e5d48
Consider the case where vehicles are leaving a control center. The control center's coordinates are known but the vehicles are on the move. Using the control center's position as a reference, the vehicles are able to report where they are with PSRPOS and their speed and direction with PSRVEL at any time.
OEM7 Commands and Logs Reference Manual v10
666
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
PSRVEL Log header. See Messages on page 25 for more header information.
H
0
2
sol
Solution status, see Table 74: Solution Status on
status page 436
Enum
4
H
3
vel type
Velocity type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+4
A measure of the latency in the velocity time tag in
4
latency seconds. It should be subtracted from the time to Float
4
give improved results
H+8
5
age
Differential age in seconds
Float
4
H+12
6
hor spd
Horizontal speed over ground, in metres per second
Double 8
H+16
7
trk gnd
Actual direction of motion over ground (track over ground) with respect to True North, in degrees
Double 8
H+24
8
vert spd
Vertical speed, in metres per second, where positive values indicate increasing altitude (up) and Double 8 negative values indicate decreasing altitude (down)
H+32
9
Reserved
Float
4
H+40
10
xxxx 32-bit CRC (ASCII and Binary only)
Ulong 4
H+44
11
[CR] [LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
667
Chapter 3 Logs
3.117 PSRXYZ
Pseudorange Cartesian position and velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the receiver's pseudorange position and velocity in ECEF coordinates. The position and velocity status field's indicate whether or not the corresponding data is valid. See Figure 11: The WGS84 ECEF Coordinate System on page 454 for a definition of the ECEF coordinates. The velocity status indicates varying degrees of velocity quality. To ensure healthy velocity, the velocity sol-status must also be checked. If the sol-status is non-zero, the velocity is likely invalid. It should be noted that the receiver does not determine the direction a vessel, craft or vehicle is pointed (heading) but rather the direction of the motion of the GNSS antenna relative to the ground. The latency of the instantaneous Doppler velocity is always 0.15 seconds. The latency represents an estimate of the delay caused by the tracking loops under acceleration of approximately 1 G. For most users, the latency can be assumed to be zero (instantaneous velocity).
Message ID: 243
Log Type: Synch
Recommended Input: log psrxyza ontime 1
ASCII Example: #PSRXYZA,COM1,0,58.5,FINESTEERING,1419,340038.000,02000040,4a28,2724;SOL_ COMPUTED,SINGLE,-1634530.7002,3664617.2823,4942495.5175,1.7971,2.3694,2.7582,SOL_COMPUTED,DOPPLER_ VELOCITY,0.0028,0.0231,0.0120,0.2148,0.2832,0.3297,"",0.150,0.000,0.000,12,12,0,0,0,06,0,33*4fdbcdb1
The instantaneous Doppler is the measured Doppler frequency which consists of the satellite's motion relative to the receiver (Satellite Doppler + User Doppler) and the clock (local oscillator) drift.
Field
Field type
1
PSRXYZ header
2
P-sol status
Description
Log header. See Messages on page 25 for more information.
Solution status, see Table 74: Solution Status on page 436
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
668
Chapter 3 Logs
Field
Field type
3
pos type
4
P-X
5
P-Y
6
P-Z
7
P-X
8
P-Y
9
P-Z
10
V-sol status
11
vel type
12
V-X
13
V-Y
14
V-Z
15
V-X
16
V-Y
17
V-Z
18
stn ID
19
V-latency
20
diff_age
21
sol_age
22
#SVs
23
#solnSVs
24
25
Reserved
26
Description
Format
Binary Bytes
Binary Offset
Position type, see Table 75: Position or Velocity Type on page 437
Enum
4
H+4
Position X-coordinate (m)
Double 8
H+8
Position Y-coordinate (m)
Double 8
H+16
Position Z-coordinate (m)
Double 8
H+24
Standard deviation of P-X (m)
Float
4
H+32
Standard deviation of P-Y (m)
Float
4
H+36
Standard deviation of P-Z (m)
Float
4
H+40
Solution status, see Table 74: Solution Status on page 436
Enum
4
H+44
Velocity type, see Table 75: Position or Velocity Type on page 437
Enum
4
H+48
Velocity vector along X-axis (m/s)
Double 8
H+52
Velocity vector along Y-axis (m/s)
Double 8
H+60
Velocity vector along Z-axis (m/s)
Double 8
H+68
Standard deviation of V-X (m/s)
Float
4
H+76
Standard deviation of V-Y (m/s)
Float
4
H+80
Standard deviation of V-Z (m/s)
Float
4
H+84
Base station ID
Char[4] 4
H+88
A measure of the latency in the velocity time tag
in seconds. It should be subtracted from the
Float
4
time to give improved results
H+92
Differential age in seconds
Float
4
H+96
Solution age in seconds
Float
4
H+100
Number of satellites tracked
Uchar 1
H+104
Number of satellite vehicles used in solution
Uchar 1
H+105
Char
1
H+106
Char
1
H+107
Char
1
H+108
OEM7 Commands and Logs Reference Manual v10
669
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
27
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Hex
1
H+109
28
Galileo and BeiDou sig mask
Galileo and BeiDou signals used mask (see Table 77: Galileo and BeiDou Signal-Used Mask on page 440)
Hex
1
H+110
GPS and GPS and GLONASS signals used mask (see Table
29
GLONASS 76: GPS and GLONASS Signal-Used Mask on
Hex
1
sig mask page 439)
H+111
30
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+112
31
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
670
Chapter 3 Logs
3.118 QZSSALMANAC
Decoded QZSS Almanac parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the decoded almanac parameters as received from the satellite with the parity information removed and appropriate scaling applied. The OEM7 family of receivers automatically save almanacs in their Non-Volatile Memory (NVM), so creating an almanac boot file is not necessary.
For more information about QZSS almanac data, refer to the Interface Specifications for QZSS at http://qzss.go.jp/en/technical/ps-is-qzss/ps-is-qzss.html.
Message ID: 1346
Log Type: Asynch
Recommended Input: log qzssalmanaca onchanged
ASCII Example: #QZSSALMANACA,COM1,0,89.5,SATTIME,1642,148584.000,02000008,67d2,39655; 1, 193,1642,208896.0,7.587582e-02,-2.94869425e-09,-1.4441238e+00, -1.5737385e+00,1.7932513e+00,0.00000000,0.00000000,7.29336435e-05, 4.2159360e+07,7.11809030e-01,7,7*fb648921
The speed at which the receiver locates and locks onto new satellites is improved if the receiver has approximate time and position, as well as an almanac. This allows the receiver to compute the elevation of each satellite so it can tell which satellites are visible and their Doppler offsets, improving Time to First Fix (TTFF).
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
QZSSALMANAC Log header. See Messages on page 25
Header
for more information.
H
0
Number of satellite PRN almanac
2
#messages
messages to follow. Set to zero until Ulong 4
H
almanac data is available
3
PRN
Satellite PRN number for current message (dimensionless)
Ulong 4
H+4
4
week
Almanac reference week
Ulong 4
H+8
OEM7 Commands and Logs Reference Manual v10
671
Chapter 3 Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
5
seconds
Almanac reference time (s)
Double 8
H+12
6
ecc
Eccentricity (dimensionless) defined for a conic section where e = 0 is a circle, e = 1 is a parabola, 0 < e < 1 is an ellipse e > 1 is a hyperbola
Double 8
H+20
7
Rate of right ascension (radians/s)
Double 8
H+28
8
0
9
Right, ascension (radians)
Double 8
Argument of perigee (radians) measurement along the orbital path from the ascending node to the point Double 8 where the SV is closest to the Earth, in the direction of the SV's motion
H+36 H+44
10
M0
Mean anomaly of reference time (radians)
Double 8
H+52
11
af0
12
af1
13
N
Clock aging parameter (s) Clock aging parameter (s/s) Corrected mean motion (radians/s)
Double 8 Double 8 Double 8
H+60 H+68 H+76
14
A
Semi-major axis (m)
Double 8
H+84
15
inclination angle
Angle of inclination
Double 8
H+92
16
health-prn
SV health from Page 25 of subframe 4 or 5 (6 bits)
Ulong
4
H+100
17
health-alm
SV health from almanac (8 bits)
Ulong 4
H+104
18
Next PRN offset = H+4+(#messages x 104)
19
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+4+ (#messages x 104)
20
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
672
Chapter 3 Logs
3.119 QZSSCNAVRAWMESSAGE
QZSS CNAV Raw Message
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This log provides the raw CNAV message from signals which contain the CNAV message (L2C, L5). It also indicates whether the raw message is generated from an L2C signal or L5 signal. The QZSSCNAVRAWMESSAGE log is not output by default. To receive this log, data decoding for L2C or L5 must be enabled using the DATADECODESIGNAL command (see page 115)
DATADECODESIGNAL QZSSL2CM ENABLE DATADECODESIGNAL QZSSL5 ENABLE
Message ID: 2261
Log Type: Asynch
Recommended Input: log QZSSCNAVRAWMESSAGEa onnew
ASCII Example: #QZSSCNAVRAWMESSAGEA,COM1,0,79.5,SATTIME,2020,252846.000,02000020,65aa,32768; 194,195,QZSSL5,11,8b0cb524f1aa067dfda0c73af40ca8c680e42003e011a0706fff7189c09 e5b02f1700f19a020*a0cbddf1 #QZSSCNAVRAWMESSAGEA,COM1,0,81.5,SATTIME,2020,252840.000,02000020,65aa,32768; 193,195,QZSSL2CM,33,8b0e1524f1aa7406a80007f18000400001b80000024d8367e43c4b890 0000000000001909db0*01417a78
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
QZSSCNAVRAWMESSAGE Log header. See Messages on
header
page 25 for more information.
H
0
2
signal channel
Signal channel providing the bits Ulong 4
H
3
PRN
Satellite PRN number
Ulong 4
H+4
4
signal type
Signal type (L2C or L5)
See Table 129: Signal Type on Enum 4 the next page
H+8
5
message ID
Message ID
Ulong 4
H+12
6
data
Raw message data
Hex[38] 38
H+16
7
xxxx
32-bit CRC (ASCII and binary only)
Hex
4
H+54
8
[CR][LF]
Sentence terminator (ASCII only)
�
�
�
OEM7 Commands and Logs Reference Manual v10
673
Chapter 3 Logs
Table 129: Signal Type
Value (Binary) Signal (ASCII)
Description
33
GPSL1CA
GPS L1 C/A-code
47
GPSL1CP
GPS L1C P-code
68
GPSL2Y
GPS L2 P(Y)-code
69
GPSL2C
GPS L2 C/A-code
70
GPSL2P
GPS L2 P-code
103
GPSL5
GPS L5
2177
GLOL1CA
GLONASS L1 C/A-code
2211
GLOL2CA
GLONASS L2 C/A-code
2212
GLOL2P
GLONASS L2 P-code
2662
GLOL3
GLONASS L3
4129
SBASL1
SBAS L1
4194
SBASL5
SBAS L5
10433
GALE1
Galileo E1
10466
GALE5A
Galileo E5A
10499
GALE5B
Galileo E5B
10532
GALALTBOC
Galileo ALT-BOC
10565
GALE6C
Galileo E6C
10572
GALE6B
Galileo E6B
12673
BDSB1D1
BeiDou B1 with D1 navigation data
12674
BDSB1D2
BeiDou B1 with D2 navigation data
12803
BDSB2D1
BeiDou B2 with D1 navigation data
12804
BDSB2D2
BeiDou B2 with D2 navigation data
12877
BDSB3D1
BeiDou B3 with D1 navigation data
12880
BDSB3D2
BeiDou B3 with D2 navigation data
12979
BDSB1C
BeiDou B1C
13012
BDSB2A
BeiDou B2a
14753
QZSSL1CA
QZSS L1 C/A-code
OEM7 Commands and Logs Reference Manual v10
674
Chapter 3 Logs
Value (Binary) Signal (ASCII)
Description
14760
QZSSL1CP
QZSS L1C P-code
14787
QZSSL2CM
QZSS L2 C/A-code
14820
QZSSL5
QZSS L5
14891
QZSSL6P
QZSS L6P
19073
NAVICL5SPS
NavIC L5 SPS
OEM7 Commands and Logs Reference Manual v10
675
Chapter 3 Logs
3.120 QZSSEPHEMERIS
Decoded QZSS parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains a single set of QZSS ephemeris parameters.
Message ID: 1336
Log Type: Asynch
Recommended Input: log qzssephemerisa onchanged
ASCII Example: #QZSSEPHEMERISA,COM1,0,93.5,SATTIME,1642,153690.000,02000008,1e9d, 39655;193,153690.000000000,7,201,201,1642,1642,154800.000000000, 4.216030971806980e+07,2.115802417e-09,-2.152109479,0.075863329, -1.573817810,-0.000007546,0.000009645,-177.375000000,-219.875000000, -0.000000797,-0.000002151,0.711859299,-2.978695503e-10,-1.443966112, -1.636139580e-09,713,154800.000000000,-5.122274160e-09,-0.000000163, 1.250555215e-12,0.000000000,FALSE,0.000072933,4.000000000,0,0,0,0 *fbb52c7f
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
QZSSEPHEMERIS Log header. See Messages on page 25 for
header
more information.
H
0
2
PRN
Satellite PRN number
Ulong 4
H
3
tow
Time stamp of subframe 0 (s)
Double 8
H+4
4
health
Health status - a 6-bit health code as defined in QZSS Interface Specification
Ulong
4
H+12
5
IODE1
Issue of ephemeris data 1
Ulong 4
H+16
6
IODE2
Issue of ephemeris data 2
Ulong 4
H+20
7
week
GPS reference week number
Ulong 4
H+24
8
z week
Z count week number. This is the week
number from subframe 1 of the ephemeris. The `toe week' (field #7) is
Ulong 4
derived from this to account for rollover
H+28
9
toe
Reference time for ephemeris (s)
Double 8
H+32
10
A
Semi-major axis (m)
Double 8
H+40
OEM7 Commands and Logs Reference Manual v10
676
Chapter 3 Logs
Field Field Type
11
N
12
M0
13
ecc
14
15
cuc
16
cus
17
crc
18
crs
19
cic
20
cis
21
I0
22
23
0
24
25
iodc
26
toc
27
tgd
28
afo
29
af1
Description
Format
Binary Bytes
Binary Offset
Mean motion difference (radians/s)
Double 8
H+48
Mean anomaly of reference time (radius) Double 8
H+56
Eccentricity (dimensionless) quantity defined for a conic section where
e = 0 is a circle, e = 1 is a parabola, 0<e<1 is an ellipse e>1 is a hyperbola
Double 8
H+64
Argument of perigee (radians) measurement along the orbital path from the ascending node to the point where the Double 8 SV is closest to the Earth, in the direction of the SV's motion
H+72
Argument of latitude (amplitude of cosine, radians)
Double 8
H+80
Argument of latitude (amplitude of sine, radians)
Double 8
H+88
Orbit radius (amplitude of cosine, metres)
Double 8
H+96
Orbit radius (amplitude of sine, metres) Double 8
H+104
Inclination (amplitude of cosine, radians) Double 8
H+112
Inclination (amplitude of sine, radians)
Double 8
H+120
Inclination angle at reference time (radians)
Double 8
H+128
Rate of inclination angle (radians/s)
Double 8
H+136
Right ascension (radians)
Double 8
H+144
Rate of right ascension (radians/s)
Double 8
H+152
Issue of data clock
Ulong 4
H+160
SV clock correction term (s)
Double 8
H+164
Estimated group delay difference (s)
Double 8
H+172
Clock aging parameter (s)
Double 8
H+180
Clock aging parameter (s/s)
Double 8
H+188
OEM7 Commands and Logs Reference Manual v10
677
Chapter 3 Logs
Field Field Type
30
af2
31
AS
32
N
33
URA
34
Fit Interval
35
Reserved
36
Reserved
37
Reserved
38
xxxx
39
[CR][LF]
Description
Clock aging parameter (s/s/s) Anti-spoofing on: 0= FALSE 1=TRUE Corrected mean motion (radians/s) User Range Accuracy variance, m2. The ICD specifies that the URA index transmitted in the ephemerides can be converted to a nominal standard deviation value using an algorithm listed there. We publish the square of the nominal value (variance) Curve fit interval: 0 = Ephemeris data are effective for 2 hours 1 = Ephemeris data are effective for more than 2 hours
32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+196
Enum 4
H+204
Double 8
H+208
Double 8
H+216
Uchar 1
H+224
Uchar 1
Uchar 1
Uchar 1
Ulong 4
-
-
H+225 H+226 H+227 H+228 -
OEM7 Commands and Logs Reference Manual v10
678
Chapter 3 Logs
3.121 QZSSIONUTC
QZSS ionospheric and time information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the Ionospheric Model parameters (ION) and the Universal Time Coordinated parameters (UTC) for QZSS.
Message ID: 1347
Log Type: Asynch
Recommended Input: log qzssionutca onchanged
ASCII Example: #QZSSIONUTCA,COM1,0,94.0,FINESTEERING,1642,153300.565,02480008,158b, 39655;1.396983861923218e-08,-6.705522537231444e-8, 0.000000000000000e+000,1.788139343261719e-07,8.396800000000000e+04, 7.536640000000000e+05,-7.864320000000000e+05,-6.946816000000000e+06, 1642,307200,-5.5879354476928711e-09,5.329070518e-15,1768,4,15,15,0 *0204eec1
Field Field Type
Description
1
QZSSIONUTC Log header. See Messages on page 25
Header
for more information.
2
a0
Alpha parameter constant term
3
a1
Alpha parameter 1st order term
4
a2
Alpha parameter 2nd order term
5
a3
Alpha parameter 3rd order term
6
b0
Beta parameter constant term
7
b1
Beta parameter 1st order term
8
b2
Beta parameter 2nd order term
9
b3
Beta parameter 3rd order term
10
utc wn
UTC reference week number
11
tot
Reference time of UTC parameters
12
A0
UTC constant term of polynomial
13
A1
UTC 1st order term of polynomial
Format
Binary Bytes
Binary Offset
H
0
Double 8 Double 8 Double 8 Double 8 Double 8 Double 8 Double 8 Double 8 Ulong 4 Ulong 4 Double 8 Double 8
H H+8 H+16 H+24 H+32 H+40 H+48 H+56 H+64 H+68 H+72 H+80
OEM7 Commands and Logs Reference Manual v10
679
Chapter 3 Logs
Field Field Type
14
wn lsf
15
dn
16
deltat ls
17
deltat lsf
18
Reserved
19
xxxx
20
[CR][LF]
Description
Format
Binary Bytes
Future week number
Ulong 4
Day number (the range is 1 to 7 where Sunday=1 and Ulong 4 Saturday=7)
Delta time due to leap seconds
Long
4
Future delta time due to leap seconds
Long
4
4
32-bit CRC (ASCII and Binary only)
Ulong 4
Sentence terminator (ASCII only)
-
-
Binary Offset H+88
H+92
H+96 H+100 H+104 H+108 -
OEM7 Commands and Logs Reference Manual v10
680
Chapter 3 Logs
3.122 QZSSRAWALMANAC
Raw QZSS almanac data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the undecoded almanac subframes as received from the QZSS satellite.
Message ID: 1345
Log Type: Asynch
Recommended Input: log qzssrawalmanaca onchanged
ASCII Example: #QZSSRAWALMANACA,COM1,0,93.5,SATTIME,1642,153300.000,02480008,64c4,39655;1642, 208896.000,7, 1,8b000031c390c1820e33d007fefe07cae831c5293ebfe15049104a000001, 51,8b000031c613f3336a1fffffffffffffffffffffffffffffffffff000000, 49,8b000031cd90f14e6a7cf3cf1cf1cf3cf3c73cf1cf1cf3cf3cf3cf000002, 50,8b000031ce14f24e6a0cf3cf1df1cfffffffffffffffffffffffff000002, 56,8b000031d511f80ff70003292ef496000006fffffffa4b6a0fe8040f0002, 52,8b000031e692f4a00a0fff83f060f2080180082082082082082002080381, 53,8b000031e717f58082082082082082082082082082082082082082082080 *ca4596f9
The OEM7 family of receivers automatically saves almanacs in their Non-Volatile Memory (NVM), therefore creating an almanac boot file is not necessary.
Field Field Type
Description
1
QZSSRAW ALMANAC header
Log header. See Messages on page 25 for more information.
2
ref week
Almanac reference week number
3
ref secs
Almanac reference time, in milliseconds (binary data) or seconds (ASCII data)
4
#subframes Number of subframes to follow
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 GPSec 4 Ulong 4
H H+4 H+8
OEM7 Commands and Logs Reference Manual v10
681
Chapter 3 Logs
Field Field Type
Description
5
svid
6
data
SV ID (satellite vehicle ID)
A value between 1 and 32 for the SV ID indicates the PRN of the satellite. Any other values indicate the page ID.
SV ID 1 to 10 corresponds to QZSS PRN 193 to 202. Refer to QZSS Interface Specification for more details.
Subframe page data
7
Next subframe offset = H+12+(#subframe x 32)
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Hex
2
H+12
Hex
30
H+14
Hex
4
-
-
H+12+ (#subframes x 32)
-
OEM7 Commands and Logs Reference Manual v10
682
Chapter 3 Logs
3.123 QZSSRAWCNAVMESSAGE
Raw QZSS L2C and L5 CNAV message
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides the raw QZSS L2C and L5 CNAV message.
The QZSSRAWCNAVMESSAGE log is not output by default. To receive this log, data decoding for QZSSL2C or QZSSL5 must be enabled using the DATADECODESIGNAL command (see page 115) for the specific signal.
Message ID: 1530
Log Type: Collection
Recommended Input: log qzssrawcnavmessage onnew
ASCII Example: #QZSSRAWCNAVMESSAGEA,COM1,0,66.5,SATTIME,1902,405696.000,02000020,20f7,13677;40 ,193,10,8b04a84110edc2a346a97d311c3ff854620220004eba94f1313134f005530056c9da0cc c2300*1f2abac5
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
QZSSRAWCNAVMESSAGE Log header. See Messages on
header
page 25 for more information.
-
H
0
2
signal channel
Signal channel providing the bits Ulong 4
H
3
PRN
QZSS satellite PRN number
Ulong 4
H+4
4
message ID
CNAV message ID
Ulong 4
H+8
5
data
CNAV raw message data
Hex[38] 38
H+12
6
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+50
7
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
683
Chapter 3 Logs
3.124 QZSSRAWEPHEM
QZSS Raw ephemeris information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw binary information for subframes one, two and three from the satellite with the parity information removed. Each subframe is 240 bits long (10 words - 24 bits each) and the log contains a total 720 bits (90 bytes) of information (240 bits x 3 subframes). This information is preceded by the PRN number of the satellite from which it originated. This message is not generated unless all 10 words from all 3 frames have passed parity.
Message ID: 1331
Log Type: Asynch
Recommended Input: log qzssrawephema onnew
ASCII Example: #QZSSRAWEPHEMA,COM1,0,84.5,SATTIME,1642,230580.000,02000008,2f9e,39655; 193,1642,234000,8b00004b0f879aa01c8000000000000000000000f6df3921fe0005 fffdbd,8b00004b1009dfd2bb1ec493a98277e8fd26d924d5062dcae8f5b739210e,8b 00004b108ffe5bc52864ae00591d003b8b02b6bfe13f3affe2afdff1e7*d2bd151e
Field Field Type
Description
1
QZSSRAWEPHEM Log header. See Messages on page 25
header
for more information.
2
prn
Satellite PRN number
3
ref week
Ephemeris reference week number
4
ref secs
Ephemeris reference time (s)
5
subframe1
Subframe 1 data
6
subframe2
Subframe 2 data
7
subframe3
Subframe 3 data
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
H
Ulong 4
Ulong 4
Ulong 4
Hex
30
Hex
30
Hex
30
Ulong 4
-
-
Binary Offset
0
H H+4 H+8 H+12 H+42 H+72 H+102 -
OEM7 Commands and Logs Reference Manual v10
684
Chapter 3 Logs
3.125 QZSSRAWSUBFRAME
Raw QZSS subframe data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw QZSS subframe data. A raw QZSS subframe is 300 bits in total, 10 words of 30 bits each. This includes the parity 6 bits at the end of each word, for a total of 60 parity bits. Note that in Field #4, the `data' field below, the 60 parity bits are stripped out and only the raw subframe data remains, for a total of 240 bits. There are two bytes added onto the end of this 30 byte packed binary array to pad out the entire data structure to 32 bytes in order to maintain 4 byte alignment.
Message ID: 1330
Log Type: Asynch
Recommended Input: log qzssrawsubframea onnew
ASCII Example: #QZSSRAWSUBFRAMEA,COM1,0,85.5,SATTIME,1642,230604.000,02000008,e56b,39655;193,5 ,8b00004b11970637984efbf7fd4d0fa10ca49631ace140740a08fe0dfd43,65*6a7b9123
Field Field Type
Description
1
QZSSRAW SUBFRAME header
Log header. See Messages on page 25 for more information.
2
PRN
Satellite PRN number
3
subframe ID Subframe ID
4
data
Raw subframe data
5
chan
Signal channel number that the frame was decoded on
6
xxxx
32-bit CRC (ASCII and Binary only)
7
[CR][LF]
Sentence terminator
Format
Binary Bytes
H
Ulong 4
Ulong 4
Hex [30]
32a
Ulong 4
Ulong 4
-
-
Binary Offset
0
H H+4 H+8
H+40 H+44 -
aIn the binary log case, an additional 2 bytes of padding are added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
685
Chapter 3 Logs
3.126 RAIMSTATUS
RAIM status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides information on Receiver Autonomous Integrity Monitoring (RAIM) status (refer to the RAIMMODE command on page 294).
Message ID: 1286
Log Type: Synch
Recommended Input: log raimstatusa ontime 1
ASCII Example: #RAIMSTATUSA,COM1,0,88.5,FINESTEERING,1837,268443.500,02040008,bf2d,32768;DEFAU LT,PASS,NOT_AVAILABLE,0.000,NOT_AVAILABLE,0.000,1,GLONASS,10-7*6504be7b
Field Field Type
Description
1
RAIMSTATUS Log header. See Messages on page 25 for
Header
more information.
2
RAIM Mode
RAIM mode (refer to Table 130: RAIM Mode Types on the next page)
3
Integrity status
Integrity Status (see Table 131: Integrity Status on page 688)
4
HPL status
Horizontal protection level status (see Table 132: Protection Level Status on page 688)
5
HPL
Horizontal protection level (m)
6
VPL status
Vertical protection level status (see Table 132: Protection Level Status on page 688)
7
VPL
Vertical protection level (m)
8
#SVs
Number of excluded satellites
9
System
Satellite system (see Table 105: Satellite System on page 553)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4
H+4
Enum 4 Double 8 Enum 4 Double 8 Ulong 4 Enum 4
H+8 H+12 H+20 H+24 H+32 H+36
OEM7 Commands and Logs Reference Manual v10
686
Chapter 3 Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
In binary logs, the satellite ID field is 4 bytes.
The 2 lowest order bytes, interpreted as a
USHORT, are the system identifier. For
instance, the PRN for GPS or the slot for
GLONASS. The 2 highest-order bytes are the
frequency channel for GLONASS, interpreted
as a SHORT and zero for all other systems.
10
Satellite ID
Ulong 4
In ASCII and abbreviated ASCII logs, the
satellite ID field is the system identifier. If
the system is GLONASS and the frequency
channel is not zero, then the signed channel is
appended to the system identifier. For
example, slot 13, frequency channel -2 is
output as 13-2
H+40
11
Next offset field = H+36+(#SVs * 8)
12
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+36 + (#SVs * 8)
13
[CR][LF]
Sentence terminator (ASCII only)
Table 130: RAIM Mode Types
Binary ASCII
Description
0
DISABLE Do not do integrity monitoring of least squares solution
1
USER
User will specify alert limits and probability of false alert
2
DEFAULT Use NovAtel RAIM (default)
3
APPROACH
Default numbers for non-precision approach navigation modes are used HAL = 556 m (0.3 nm), VAL = 50 m for LNAV/VNAV
4
TERMINAL
Default numbers for terminal navigation mode are used - HAL = 1855 m (1 nm), no VAL requirement
5
ENROUTE
Default numbers for enroute navigation mode are used - HAL = 3710 m (2 nm), no VAL requirement
OEM7 Commands and Logs Reference Manual v10
687
Chapter 3 Logs
Table 131: Integrity Status
Binary ASCII
Description
0
NOT_
RAIM is unavailable because either there is no solution or because the
AVAILABLE solution is unique, that is, there is no redundancy
1
PASS
RAIM succeeded. Either there were no bad observations or the bad observations were successfully removed from the solution
2
FAIL
RAIM detected a failure and was unable to isolate the bad observations
Table 132: Protection Level Status
Binary ASCII
Description
0
NOT_ AVAILABLE
When RAIM is not available for example, after issuing a FRESET command (see page 179) or when there are not enough satellites tracked to produce the required redundant observations
1
PASS
Current protection levels are below alert limits, meaning positioning accuracy requirements are fulfilled
HPL < HAL
VPL < VAL
2
ALERT
Current protection levels are above alert limits, meaning required positioning accuracy cannot be guaranteed by RAIM algorithm
HPL HAL
VPL VAL
OEM7 Commands and Logs Reference Manual v10
688
Chapter 3 Logs
3.127 RANGE
Satellite range information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The RANGE log contains the channel measurements for the currently tracked satellites. When using this log, please keep in mind the constraints noted along with the description. It is important to ensure that the receiver clock has been set. This can be monitored by the bits in the Receiver Status field of the log header. Large jumps in pseudorange as well as Accumulated Doppler Range (ADR) occur as the clock is being adjusted. If the ADR measurement is being used in precise phase processing, it is important not to use the ADR if the "parity known" flag, in the ch-tr-status field, is not set as there may exist a half (1/2) cycle ambiguity on the measurement. The tracking error estimate of the pseudorange and carrier phase (ADR) is the thermal noise of the receiver tracking loops only. It does not account for possible multipath errors or atmospheric delays. If multiple signals are being tracked for a given PRN, an entry for each signal, with the same PRN, appears in the RANGE logs. As shown in Table 133: Channel Tracking Status on page 692, these entries can be differentiated by bits 21-25, which indicate the signal type of the observation.
For dual antenna receivers, a RANGE_1 log can be requested to get RANGE data from the second antenna. As described in Table 3: Binary Message Header Structure on page 30, the message type indicates the log is from the second antenna. To request an ASCII log enter RANGEA_1, and for a binary log enter RANGEB_1.
Message ID: 43
Log Type: Synch
Recommended Input: log rangea ontime 30
Abbreviated ASCII Example: <RANGE COM1 0 82.0 FINESTEERING 1729 155076.000 02004000 5103 11465 46 31 0 24514687.250 0.064 -128825561.494675 0.010 3877.473 45.0 563.310 18109c04 31 0 24514688.765 0.096 -100383546.734328 0.010 3021.415 39.8 558.900 02309c0b 14 0 20345286.178 0.047 -106915249.491005 0.008 90.799 47.6 10283.130 08109c24 14 0 20345282.367 0.130 -83310588.842026 0.008 70.753 44.0 10276.900 01303c2b 22 0 20789170.556 0.038 -109247823.573628 0.007 -1421.169 49.4 15829.450 18109c44 22 0 20789164.279 0.138 -85128150.759123 0.007 -1107.404 43.6 15822.400 11303c4b 11 0 21977065.699 0.057 -115490261.964920 0.009 1235.428 46.0 5831.400 18109c64 11 0 21977062.220 0.201 -89992401.903056 0.011 962.671 40.3 5823.900 11303c6b 1 0 23109644.678 0.073 -121441999.794897 0.011 2971.250 43.8 3239.620 18109ca4 1 0 23109646.769 0.073 -94630142.467139 0.011 2315.261 42.1 3233.420 02309cab 1 0 23109647.385 0.009 -90687226.778371 0.009 2218.538 48.9 3237.080 01d03ca4
OEM7 Commands and Logs Reference Manual v10
689
Chapter 3 Logs
32 0 23839782.353 0.133 -125278916.608912 0.022 3033.561 38.7 2193.280 18109cc4 32 0 23839781.295 0.363 -97619939.025504 0.026 2363.815 35.1 2184.900 11303ccb 18 0 22923322.792 0.062 -120462840.747702 0.009 -2710.945 45.3 20493.260 18109d04 18 0 22923320.071 0.350 -93867119.471860 0.012 -2112.426 35.5 20484.400 11303d0b 24 0 23708761.188 0.111 -124590391.778428 0.015 -2376.459 40.2 10643.820 08109d24 24 0 23708763.572 0.065 -97083440.180816 0.015 -1851.788 43.1 10639.420 02309d2b 24 0 23708765.724 0.009 -93038305.697497 0.008 -1774.807 49.1 10641.680 01d03d24 19 0 23739234.067 0.078 -124750470.392697 0.013 -2778.561 43.3 12263.180 08109d64 19 0 23739230.131 0.250 -97208136.646475 0.014 -2165.115 38.4 12255.400 01303d6b 61 9 22189063.544 0.155 -118654856.801346 0.011 -3985.235 43.3 13310.882 08119e04 61 9 22189063.246 0.055 -92287085.024614 0.011 -3099.631 37.6 13303.964 00b13e0b 47 0 21209673.567 0.147 -113059527.680842 0.011 -804.710 43.8 7342.680 08119e24 47 0 21209679.575 0.043 -87935228.320976 0.011 -625.886 39.7 7334.968 00b13e2b 46 5 24097664.754 0.213 -128680178.570435 0.014 -3740.543 40.6 10098.600 08119e44 46 5 24097669.137 0.048 -100084595.729257 0.015 -2909.311 38.8 10082.838 10b13e4b 39 3 21484445.079 0.161 -114645140.076744 0.012 2864.162 43.0 4463.150 18119e64 39 3 21484447.532 0.046 -89168467.325722 0.013 2227.683 39.1 4453.468 10b13e6b 38 8 19445896.471 0.101 -103949483.524466 0.008 -389.973 47.1 11640.260 18119e84 38 8 19445897.101 0.048 -80849619.556577 0.009 -303.312 38.8 11632.974 00b13e8b 48 7 21301665.694 0.166 -113829687.684616 0.011 3143.656 42.8 3778.910 08119ea4 48 7 21301667.294 0.054 -88534230.502244 0.012 2445.068 37.8 3770.968 10b13eab 54 11 20899591.029 0.131 -111837944.708346 0.009 -401.734 44.8 7155.190 18119ec4 54 11 20899589.241 0.024 -86985062.942139 0.009 -312.461 44.8 7146.970 10b13ecb 55 4 23127316.661 0.318 -123455195.443877 0.020 3067.787 37.1 1588.420 18119ee4 55 4 23127321.850 0.032 -96020732.562183 0.021 2386.060 42.3 1580.442 00b13eeb 12 0 26239080.161 0.048 -137887256.553732 0.015 -2696.802 47.6 11527.710 48539c24 12 0 26239085.285 0.012 -102967750.707625 0.013 -2013.883 46.8 11523.770 41933c24 12 0 26239083.219 0.011 -105653860.401460 0.013 -2066.457 47.3 11523.712 42333c24 12 0 26239094.196 0.019 -104310841.607718 0.014 -2040.204 42.7 11522.970 42933c24 11 0 25589806.061 0.045 -134475330.397885 0.013 -729.686 48.0 4974.653 48539c64 11 0 25589809.285 0.010 -100419891.315177 0.012 -545.179 47.8 4969.770 41933c64 11 0 25589806.124 0.010 -103039536.069621 0.011 -559.405 48.0 4969.734 42333c64 11 0 25589818.004 0.017 -101729751.744395 0.013 -552.305 43.7 4967.060 42933c64 8 0 39844800.850 0.077 -207482308.002186 0.018 -507.335 37.4 12048.980 18149c84
OEM7 Commands and Logs Reference Manual v10
690
Chapter 3 Logs
8 0 39844800.076 0.043 -160438471.200694 0.013 -392.547 42.5 12038.660 00349c84
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
RANGE Log header. See Messages on page 25 for more header information.
H
0
2
# obs
Number of observations with information to follow 1
Ulong 4
H
Satellite PRN number of range measurement
3
PRN/slot
Ushort 2
H+4
Refer to PRN Numbers on page 44
4
glofreq
(GLONASS Frequency + 7) (see GLONASS Slot and Frequency Numbers section of this manual)
Ushort
2
H+6
5
psr
Pseudorange measurement (m)
Double 8
H+8
6
psr
Pseudorange measurement standard deviation (m)
Float
4
H+16
7
adr
Carrier phase, in cycles (accumulated Doppler range)
Double 8
H+20
8
adr
Estimated carrier phase standard deviation (cycles)
Float
4
H+28
9
dopp
Instantaneous carrier Doppler frequency (Hz) Float
4
H+32
Carrier to noise density ratio
10
C/No
C/No = 10[log10(S/N0)] (dB-Hz)
Float
4
11
locktime
Number of seconds of continuous tracking (no cycle slipping)
Float
4
H+36 H+40
Tracking status (see Table 133: Channel
12
ch-trstatus
Tracking Status on the next page and the example in Figure 14: Channel Tracking
Example on the next page)
Ulong 4
H+44
13...
Next PRN offset = H + 4 + (#obs x 44)
variable xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+4+ (#obs x 44)
variable [CR][LF] Sentence terminator (ASCII only)
-
-
-
1Satellite PRNs may have multiple lines of observations, one for each signal tracked. OEM7 Commands and Logs Reference Manual v10
691
Chapter 3 Logs
Figure 14: Channel Tracking Example
Table 133: Channel Tracking Status
Nibble Bit
Mask
Description
Range Value
0 0x00000001
1 0x00000002 N0
2 0x00000004 Tracking state
3 0x00000008
0-23,
see Table 134: Tracking State on page 694
4 0x00000010
5 0x00000020 N1
6 0x00000040
7 0x00000080 SV channel number
8 0x00000100
(n-1) (0 = first, n = last) n depends on the receiver
9 0x00000200 N2
10 0x00000400 Phase lock flag
0 = Not locked , 1 = Locked
11 0x00000800 Parity known flag
0 = Not known, 1 = Known
OEM7 Commands and Logs Reference Manual v10
692
Chapter 3 Logs
Nibble Bit
Mask
Description
12 0x00001000 Code locked flag
13 0x00002000 N3
14 0x00004000 Correlator type
15 0x00008000
16 0x00010000
17 0x00020000 Satellite system N4
18 0x00040000
19 0x00080000 Reserved
20 0x00100000 Grouping
21 0x00200000
N5 22 0x00400000 Signal type (Dependent on satellite
23 0x00800000 system above)
24 0x01000000
N6 25 0x02000000 26 0x04000000 Reserved
Range Value 0 = Not locked, 1 = Locked
0-7, see Table 135: Correlator Type on page 695
0 = GPS 1 = GLONASS 2 = SBAS 3 = Galileo
4 = BeiDou 5 = QZSS 6 = NavIC 7 = Other
0 = Not grouped, 1 = Grouped
GPS: 0 = L1C/A 5 = L2P 9 = L2P (Y), semicodeless 14 = L5 (Q) 16 = L1C (P) 17 = L2C (M)
GLONASS: 0 = L1C/A 1 = L2C/A 5 = L2P 6 = L3 (Q)
BeiDou: 0 = B1 (I) with D1 data 1 = B2 (I) with D1 data 2 = B3 (I) with D1 data 4 = B1 (I) with D2 data 5 = B2 (I) with D2 data 6 = B3 (I) with D2 data 7 = B1C (P) 9 = B2a (P)
Galileo: 2 = E1 (C) 6 = E6B 7 = E6C 12 = E5a (Q) 17 = E5b (Q) 20 = E5AltBOC (Q)
QZSS: 0 = L1C/A 14 = L5 (Q) 16 = L1C (P) 17 = L2C (M) 27 = L6P
SBAS: 0 = L1C/A 6 = L5 (I)
NavIC: 0 = L5 SPS
Other: 19 = L-Band
OEM7 Commands and Logs Reference Manual v10
693
Chapter 3 Logs
Nibble Bit
Mask
Description
Range Value
27 0x08000000 Primary L1 channel
0 = Not primary, 1 = Primary
28
0x10000000
Carrier phase measurement 1
0 = Half Cycle Not Added 1 = Half Cycle Added
N7
29
0x20000000 Digital filtering on signal
0 = No digital filter 1 = Digital filter
30 0x40000000 PRN lock flag 2
0 = PRN Not Locked Out 1 = PRN Locked Out
31 0x80000000 Channel assignment
0 = Automatic, 1 = Forced
Table 134: Tracking State
State
Description
0 Idle
1 Sky Search
2 Wide frequency band pull-in
3 Narrow frequency band pull-in
4 Phase lock loop
6 Channel steering
7 Frequency lock loop
9 Channel alignment
10 Code search
11 Aided phase lock loop
23 Side peak detection
1This bit is zero until the parity is known and the parity known flag (bit 11) is set to 1. After a loss of lock, there is a half cycle ambiguity on the ADR (carrier phase) until enough navigation data has been decoded to determine the correct phase of the carrier. At the point this is determined, the "parity known" and "half cycle added" flags will get set. If the half cycle flag is set to 1, it indicates that a half cycle was added to the ADR to correct an inverted phase.
2A PRN can be locked out using the LOCKOUT command.
OEM7 Commands and Logs Reference Manual v10
694
Chapter 3 Logs
Table 135: Correlator Type
State
Description
0 N/A
1 Standard correlator: spacing = 1 chip
2 Narrow Correlator: spacing < 1 chip
3 Reserved
4 Pulse Aperture Correlator (PAC)
5 Narrow PAC
6 Reserved
Table 136: RINEX Mappings
GNSS Frequency
System
Band
Frequency
Signal Type
Observation Codes
Pseudo Range
Carrier Phase
Doppler
Signal Strength
L1CA
C1C
L1C
D1C
S1C
L1
1575.42
L1C(P) C1L
L1L
D1L
S1L
GPS L2
1227.6
L2C(M) C2S
L2S
D2S
S2S
L2P
L2P
C2P
D2P
S2P
L2P(Y) C2W
L2W
D2W
S2W
L5
1176.45
L5(Q)
C5Q
L5Q
D5Q
S5Q
G1
1598.06251609.3125
L1CA
C1C
L1C
D1C
S1C
GLONASS G2
1242.9375- L2CA
C2C
L2C
D2C
S2C
1251.6875
L2P
C2P
L2P
D2P
S2P
G3
1202.025
L3(Q)
C3Q
L3Q
D3Q
S3Q
E1
1575.42
E1C
C1C
L1C
D1C
S1C
E5a
1176.45
E5a(Q) C5Q
L5Q
D5Q
S5Q
Galileo
E5b
E5 (E5a+E5b)
1207.14 1191.795
E5b(Q) C7Q
E5AltBOC (Q)
C8Q
L7Q L8Q
D7Q D8Q
S7Q S8Q
E6
1278.75
E6C
C6C
L6C
D6C
S6C
OEM7 Commands and Logs Reference Manual v10
695
Chapter 3 Logs
GNSS Frequency
System
Band
Frequency
L1 SBAS
L5
1575.42 1176.45
Signal Type
L1CA
L5(I)
L1CA
L1
1575.42
L1C(P)
QZSS
L2
1227.6
L2C(M)
L5
1176.45
L5(Q)
L6
1278.75
L6(P)
B1
1561.098
B1(I)
BeiDou
B1C B2
1575.42 1207.14
B1C(P) B2(I)
B2a
1176.45
B2a(P)
B3
1268.52
B3(I)
NavIC
L5
1176.45
L5SPS
Observation Codes
Pseudo Range
Carrier Phase
Doppler
Signal Strength
C1C
L1C
D1C
S1C
C5I
L5I
D5I
S5I
C1C
L1C
D1C
S1C
C1L
L1L
D1L
S1L
C2S
L2S
D2S
S2S
C5Q
L5Q
D5Q
S5Q
C6L
L6L
D6L
S6L
C2I
L2I
D2I
S2I
C1P
L1P
C7I
L7I
D1P
S1P
D7I
S7I
C5P
L5P
D5P
S5P
C6I
L6I
D6I
S6I
C5A
L5A
D5A
S5A
OEM7 Commands and Logs Reference Manual v10
696
Chapter 3 Logs
3.128 RANGECMP
Compressed version of the RANGE log
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the RANGE data in a compressed format.
For dual antenna receivers, a RANGECMP_1 log can be requested to get RANGECMP data from the second antenna. As described in Table 3: Binary Message Header Structure on page 30, the message type indicates the log is from the second antenna. To request an ASCII log enter RANGECMPA_1, and for a binary log enter RANGECMPB_1.
Message ID: 140
Log Type: Synch
Recommended Input: log rangecmpa ontime 10
ASCII Example: #RANGECMPA,COM1,0,63.5,FINESTEERING, 1429,226780.000,02000000,9691,2748; 26, 049c10081857f2df1f4a130ba2888eb9600603a709030000, 0b9c3001225bf58f334a130bb1e2bed473062fa609020000, 449c1008340400e0aaa9a109a7535bac2015cf71c6030000, 4b9c300145030010a6a9a10959c2f09120151f7166030000, ... 0b9d301113c8ffefc284000c6ea051dbf3089da1a0010000, 249d1018c6b7f67fa228820af2e5e39830180ae1a8030000, 2b9d301165c4f8ffb228820a500a089f31185fe0a8020000, 449d1018be18f41f2aacad0a1a934efc40074ecf88030000, 4b9d301182b9f69f38acad0a3e3ac28841079fcb88020000, 849d101817a1f95f16d7af0a69fbe1fa401d3fd064030000, 8b9d30112909fb2f20d7af0a9f24a687521ddece64020000, 249e1118af4e0470f66d4309a0a631cd642cf5b821320000, 2b9eb110a55903502f6e4309ee28d1ad032c7cb7e1320000, 849e1118b878f54f4ed2aa098c35558a532bde1765220000, 8b9eb110abcff71f5ed2aa09cb6ad0f9032b9d16c5220000*0eeead18
OEM7 Commands and Logs Reference Manual v10
697
Chapter 3 Logs
Consider the case where commercial vehicles are leaving a control center. The control center's coordinates are known but the vehicles are on the move. Using the control center's position as a reference, the vehicles are able to report where they are at any time. Post-processed information gives more accurate comparisons.
Post-processing can provide post mission position and velocity using raw GNSS collected from the vehicles. The logs necessary for post-processing include:
RANGECMPB ONTIME 1
RAWEPHEMB ONCHANGED
This is an example of data collection for post-processing. OEM7 based output is compatible with post-processing software from NovAtel's Waypoint Products. Refer to our website at www.novatel.com/support/ for more details.
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
RANGECMP Log header. See Messages on page 25 for more
header
information.
H
0
2
#obs
Number of satellite observations with information to follow
Ulong 4
H
3
1st range record
Compressed range log in format of Table 137: Range Record Format (RANGECMP only) below
Hex
24
H+4
4
Next rangecmp offset = H+4 (#obs x 24)
5
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+4+ (#obs x 24)
6
[CR][LF] Sentence terminator (ASCII only)
-
-
-
Data
Channel Tracking Status
Doppler Frequency
Table 137: Range Record Format (RANGECMP only)
Description
Bits first to
last
Length (bits)
Scale Factor
Channel tracking status word
0-31
32
see Table 133: Channel Tracking Status on page 692
Units -
Instantaneous carrier Doppler frequency 32-59 28
1/256
Hz
OEM7 Commands and Logs Reference Manual v10
698
Chapter 3 Logs
Data
Description
Bits first to
last
Length (bits)
Scale Factor
Units
Pseudorange (PSR)
Pseudorange measurement
60-95 36
1/128
m
ADR
ADR (Accumulated Doppler Range) is calculated as follows:
ADR_ROLLS = (RANGECMP_PSR / WAVELENGTH + RANGECMP_ADR) / MAX_VALUE
Round to the closest integer
IF (ADR_ROLLS 0) ADR_ROLLS = ADR_ROLLS - 0.5
ELSE ADR_ROLLS = ADR_ROLLS + 0.5
At this point integerise ADR_ROLLS CORRECTED_ADR = RANGECMP_ADR (MAX_VALUE*ADR_ROLLS) where
ADR has units of cycles WAVELENGTH = 0.1902936727984 for GPS L1 WAVELENGTH = 0.2442102134246 for GPS L2 MAX_VALUE = 8388608
96-127 32
Note: GLONASS satellites emit L1 and L2 carrier waves at a satellite-specific frequency, refer to the GLONASS section of An Introduction to GNSS available on our website
1/256
cycles
StdDev-PSR
Pseudorange measurement standard deviation
128-131 4
See Table
138:
StdDevPSR Values
m
on the next
page
StdDev-ADR ADR measurement standard deviation
132-135 4
(n+1)/512 cycles
PRN/Slot
Refer to PRN Numbers on page 44
136-143 8
1
-
OEM7 Commands and Logs Reference Manual v10
699
Chapter 3 Logs
Data
Lock Time
C/No
GLONASS Frequency number Reserved
Description
Bits first to
last
Length (bits)
Scale Factor
Number of seconds of continuous tracking (no cycle slipping)
This field is constrained to a maximum value of 2,097,151 which represents a lock time of 65535.96875 s (2097151 � 32).
144-164 21
1/32
Carrier to noise density ratio
The C/No is constrained to a value
between 20-51 dB-Hz. Thus, if it is reported that C/No = 20 dB-Hz, the
165-169 5
actual value could be less. Likewise, if it
is reported that C/No = 51, the true value
could be greater.
(20+n)
GLONASS Frequency number
170-175 n+7
1
176-191 16
Units s dB-Hz
Table 138: StdDev-PSR Values
Code
StdDev-PSR (m)
0
0.050
1
0.075
2
0.113
3
0.169
4
0.253
5
0.380
6
0.570
7
0.854
8
1.281
9
2.375
10
4.750
11
9.500
OEM7 Commands and Logs Reference Manual v10
700
Chapter 3 Logs
Code 12 13 14 15
StdDev-PSR (m) 19.000 38.000 76.000 152.000
OEM7 Commands and Logs Reference Manual v10
701
Chapter 3 Logs
3.129 RANGECMP2
Compressed version of the RANGE log
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the RANGE data in a compressed format to handle more channels and different channel types than the RANGECMP log.
For dual antenna receivers, a RANGECMP2_1 log can be requested to get RANGECMP2 data from the second antenna. As described in Table 3: Binary Message Header Structure on page 30, the message type indicates the log is from the second antenna. To request an ASCII log enter RANGECMP2A_1, and for a binary log enter RANGECMP2B_1.
Message ID: 1273
Log Type: Synch
Recommended Input: log rangecmp2a ontime 10
Example: #RANGECMP2A,COM1,0,84.5,FINESTEERING,1681,163457.000,02000020,1fe3, 10526;634,000d00f4fddf05920620e1ffff2979e806e81301c8ffe4ffff03106b5a50 a902c8ff01100054f6bd05410720e1ffff2996ea0e90fb01e2ffe4ffff030e0d656816 03e3ff020400acdcd605c40320e1ffff697b080e9859801300e4ffff4310c94fb8c701 14000317002c554685260520e1ffff295f4412b0ad03c4ffe4ffff03d5a60d18c705c4 ff0401008452b08583f92fe1ffff2998ac65302c800000e4ffff03f32edf784b000000 0520000c8500056cfd2fe1ffff295fa40dd04a822300e4ffff03b8242a58f802230006 1f00c0081385effb2fe1ffff295fc408a83884f8ffe4ffff03b8861608c286f8ff081e 008cb25105970520e1ffff295c2604989483ceffe4ffff03f2862f489006cfff091400 3027e204930020e1ffff695e4407188602ddffe4ffff43b8241480c903ddff0a0e0050 e3e305d3f92fe1ffff2979c89c506d800700e4ffff030f4bdd603a8006000b1900d8f3 cc8543fb2fe1ffff297a280950f2002500e4ffff03f1286880e8022500140118341c0f 0581f92fe1ffff299d4404d02401f2ffe4ffff03920c2f900d82faff160d158cfa6b85 400820e1ffff69baa600b83d02d9ffe4ffff03734a4380ea04ceff170b178874ef0409 fa2fe1ffff299d6409d01904e6ffe4ffff0374ea31304d87daff180213c8039884fd00 20e1ffff697fe401007082d4ffe4ffff033b0616688084c4ff19131a5cdc9585f9fe2f e1ffff69b8c80e08e5800200e4ffff0357c830a8d001ebff1b0c16a45ca384c80220e1 ffff697f6401888a04efffe4ffff033a463d605e8802001c031c905434051d0720e1ff ff299cc60b18e881f3ffe4ffff0339462d38e182fbff231050f05e6406b9fd1fe6ffff 6998080f1013801300*61b80516
OEM7 Commands and Logs Reference Manual v10
702
Chapter 3 Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
RANGECMP2 Log header. See Messages on page 25 for
header
more information.
H
0
2
# bytes
Number of bytes in the compressed binary range data1
Uchar 4
H
Compressed binary range data in the format of
Table 139: Satellite Block of the Range Record
3
RangeData Format (RANGECMP2 only) below and Table
Uchar #bytes H+4
140: Signal Block of the Range Record Format (RANGECMP2 only) on the next page 2
4
xxxx
32-bit CRC (ASCII and binary only)
Hex
4
H+4+ (# bytes)
5
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
Table 139: Satellite Block of the Range Record Format (RANGECMP2 only)
Data
Description
Bits first
to last
Length (bits)
Scale Factor
Units
SV Channel Number
Receiver SV channel number
0-7 8
-
-
Satellite identifier specific to the satellite
Satellite Identifier
system
8-15 8
-
-
Refer to PRN Numbers on page 44
GLONASS Frequency Identifier
GLONASS frequency channel offset by +7
16-19 4
(7+Ch#) -
Satellite System Identifier
Defined in Table 105: Satellite System on page 553
20-24 5
-
Enum
Reserved
25
1
-
-
1Maximum is 2880 bytes for 120 channels; maximum 5760 for 240 channels.
2The compressed binary range data is organized into satellite blocks, one for each satellite. Each satellite block is followed by a variable number of signal blocks corresponding to the same satellite. For example, a Satellite Block for GPS PRN 17 may be followed by two Signal Blocks for the L1 C/A and L2C signals.
OEM7 Commands and Logs Reference Manual v10
703
Chapter 3 Logs
Data
Description
Bits first
to last
Length (bits)
Scale Factor
Pseudorange Base
Pseudorange base value to be combined with PSR Diff and Phaserange Diff in each following Signal Block
26-54 29
1
Doppler Base
Doppler base value to be combined with the Scaled Doppler Diff value in each following Signal Block
55-75 21
1
Number of Signal Blocks
The number of Signal Blocks to follow this Satellite Block. See Table 140: Signal Block of the Range Record Format (RANGECMP2 only) below for Signal Block definition
76-79 4
-
Units m Hz -
Table 140: Signal Block of the Range Record Format (RANGECMP2 only)
Data
Description
Bits first to last
Length (bits)
Scale Factor
Units
Signal Type
Defined in Table 144: Signal Type (only in RANGECMP2) on page 708
0-4
5
-
Enum
Phase Lock Phase Lock: 0 = Not locked, 1 = Locked 5
1
-
Bool
Parity Known
Parity Known: 0 = Not known, 1 = Known
6
1
-
Bool
Code Lock
Code Lock: 0 = Not locked, 1 = Locked 7
1
-
Bool
Time of continuous tracking with no
Locktime
cycle slips. The locktime value
8-24 17
1
ms
saturates at a maximum of 131071 ms
Correlator Type
Correlator type: (see Table 135: Correlator Type on page 695)
25-28 4
-
Enum
Primary Signal
Primary signal: 0 = Not primary, 1 = Primary
29
1
-
Bool
Carrier Phase Measurement
Carrier phase measurement: 0 = Half cycle not added, 1 = Half cycle added
30
1
-
Bool
Reserved
31
1
-
-
C/No
Carrier to Noise density ratio
32-36 5
(20 + n) dB-Hz
OEM7 Commands and Logs Reference Manual v10
704
Chapter 3 Logs
Data
Description
StdDev PSR
Pseudorange Standard Deviation (defined Table 141: Std Dev PSR Scaling below)
StdDev ADR
Carrier-Phase Standard Deviation (defined Table 142: Std Dev ADR Scaling on the next page)
PSR Diff
Pseudorange Diff to be combined with Pseudorange base i.e., PSR = PSRBase + PSRDiff/128
Phaserange Diff
Phaserange Diff to be combined with Pseudorange Base i.e., ADR = PSRBase + PhaserangeDiff/2048
Scaled Doppler Diff1
Doppler Diff to be combined with Doppler Base. Note that all Doppler values are scaled to the L1/E1 equivalent value. (refer to Table 143: L1/E1/B1 Scaling on page 707) i.e., Doppler = (DopplerBase + ScaledDopplerDiff/256)/L1ScaleFactor
Bits first to last
Length (bits)
Scale Factor
Units
37-40 4
Bit Field
in Table
141: Std Dev PSR
-
Scaling
below
41-44 4
Bit Field
in Table
142: Std
Dev ADR Scaling
-
on the
next
page
45-58 14
1/128
m (unsigned)
59-78 20
1/2048
m (unsigned)
79-95 17
1/256
Hz (signed)
Table 141: Std Dev PSR Scaling
PSR Std Dev Bit Field Value Represented Std Dev (m)
0
0.02
1
0.03
2
0.045
1The Scaled Doppler Diff field is the only field in the RANGECMP2 that should be parsed as Two's Complement. The most significant byte (MSB) determines whether the number will be positive (< 0x7) or negative (> 0x7). Two's complement should be applied prior to AND, right bit shift computations.
OEM7 Commands and Logs Reference Manual v10
705
Chapter 3 Logs
PSR Std Dev Bit Field Value Represented Std Dev (m)
3
0.066
4
0.099
5
0.148
6
0.22
7
0.329
8
0.491
9
0.732
10
1.092
11
1.629
12
2.43
13
3.625
14
5.409
15
>5.409
Table 142: Std Dev ADR Scaling
ADR Std Dev Bit Field Value Represented Std Dev (cycles)
0
0.00391
1
0.00521
2
0.00696
3
0.00929
4
0.01239
5
0.01654
6
0.02208
7
0.02947
8
0.03933
9
0.05249
10
0.07006
11
0.09350
12
0.12480
OEM7 Commands and Logs Reference Manual v10
706
Chapter 3 Logs
ADR Std Dev Bit Field Value Represented Std Dev (cycles)
13
0.16656
14
0.22230
15
>0.22230
Table 143: L1/E1/B1 Scaling
Satellite System Signal Type L1/E1/B1 Scale Factor
L1CA
1.0
GPS
L2Y
154/120
L2C
154/120
L5Q
154/115
L1CA
1.0
GLONASS
L2CA
9/7
L2P
9/7
SBAS
L1CA L5I
1.0 154/115
E1
1.0
E5A
154/115
Galileo
E5B AltBOC
154/118 154/116.5
E6C
154/125
E6B
154/125
L1CA
1.0
QZSS
L2C
154/120
L5Q
154/115
L6P
154/125
LBAND
LBAND
1.0
OEM7 Commands and Logs Reference Manual v10
707
Chapter 3 Logs
Satellite System Signal Type L1/E1/B1 Scale Factor
B1
1.0
B1C
1526/1540
BDS
B2
1526/1180
B2a
1526/1150
B3
1526/1240
NAVIC
L5SPS
1.0
Table 144: Signal Type (only in RANGECMP2)
Satellite System
Signal Type
Value
L1CA
1
L2Y
4
GPS
L2CM
5
L5Q
7
L1C
15
L1CA
1
L2CA
3
GLONASS
L2P
4
L3Q
6
SBAS
L1CA
1
L5I
2
E1C
1
E5AQ
2
Galileo
E5BQ
3
AltBOCQ
4
E6C
5
E6B
12
OEM7 Commands and Logs Reference Manual v10
708
Chapter 3 Logs
Satellite System
QZSS
LBAND
BDS
NAVIC
Signal Type L1CA L2CM L5Q L1C L6P LBAND B1D1I B1D2I B2D1I B2D2I B3D1I B3D2I B1CP B2AP L5SPS
Value 1 3 4 8 11 1 1 2 3 4 13 14 19 20 1
OEM7 Commands and Logs Reference Manual v10
709
Chapter 3 Logs
3.130 RANGECMP4
Highly compressed version of the RANGE log
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the RANGE data in a more heavily compressed format compared to the RANGECMP2 log.
For dual antenna receivers, a RANGECMP4_1 log can be requested to get RANGECMP4 data from the second antenna. As described in Table 3: Binary Message Header Structure on page 30, the message type indicates the log is from the second antenna. To request an ASCII log enter RANGECMP4A_1, and for a binary log enter RANGECMP4B_1.
Message ID: 2050
Log Type: Synch
Recommended Input: log rangecmp4a ontime 10
Example: #RANGECMP4A,COM1,0,81.5,FINESTEERING,1921,228459.000,00000020,fb0e, 32768;627,630032090851000000009200dbbf7d8306f822d0a3b2bc897f0010d35042 8cf31228ea9f7300040050ff5e641cb7c7463d2a00b6a4644f6e5ee2a0fe530a00fe1f 829dcfe4cf30d52abaf37f94e01621cd8d8c04a0bafcaf00e43b0761690064e7bfe90f 11ce8710a4eb2b573202607403fc28e647c6fe9f550118007a9d839c2680ebfedff687 6be81150411adbc972feef4686c483f30a09f01773ff0b0050d8b8a843f41576b94100 440e1e4f59ace54fffca2700fc1f62e14720f4facba64affbf9c52ff39ce4b3eef9f14 fd0f00244387d00d80fefabfeb0fb3cf456ae97542d410fc9ffab7f601e73580e5efda ff0f00a0b33991fc072ccbaa99ff134efa9fd0dc684bfc61f0fffeff60b02000000000 8004c0ff3fa0b2f724f7e1eee889e9fb9f3977c0437391ab135877fe0b00301edf93f4 bd63c62850fdbf8527e6e5cd438e3a208400e0ff43bb6f5fc2101c75b058daff375c5e a4378f51940022eeffff0fe1c97dcda81887c83a63007c9d5a7ed65ce6f901427bffff 3f9c04f735db1d55294a3bfc5f35ccc66df318c412181400140060eedbd7285feaf6a6 53f9bf9fc7fe27cd653633c0b5fcffff03197b4f8228d4e59d0cfbffa731b2f73b07e9 b68078f47f0000a9be7dcdcc51898da269fe839b6191ab9cc67701f21000fc3f0001a1 000000008002c03fb4362793b9bfeb657dfcffe6badabb9a4375b77f5bff1fed87bce6 4454a98ae16c14ff4fec6f7a48f3206b03e8040138fbd0023d225492cd7679a4ffa562 3b08810e42bf05fce17fa41f9a9ccfc8e2626231edf2ff208a1225ce6150204067febf ef030100000000000028000ca9cc8728bb3306e68af97f921cfce3e632f0d1cf8300c8 f701*6de99eb7
OEM7 Commands and Logs Reference Manual v10
710
Chapter 3 Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
RANGECMP4 Log header. See Messages on page 25 for
header
more information.
-
H
0
2
# bytes
Number of bytes in the compressed binary Range Data.
Uchar 4
H
The compressed binary range data is organized into satellite system blocks which break down into measurement blocks for each active signal within each system. Refer to the following tables for more details about this format:
Table 145: Header on the next page (sent once)
Table 146: Satellite and Signal Block on page 713 (sent once per satellite system bit set to 1 in the GNSS Field found in Table 145: Header on the next page)
Table 147: Measurement Block Header on
page 714 (sent once for each bit set to 1 in the
Satellites Field found in Table 146: Satellite
and Signal Block on page 713)
3
Range Data Table 148: Primary Reference Signal
Uchar
# bytes
H+4
Measurement Block on page 715 and Table
149: Secondary Reference Signals
Measurement Block on page 716, or Table
150: Primary Differential Signal Measurement
Block on page 717 and Table 151: Secondary
Differential Signals Measurement Block on
page 718, Measurement Block (sent for each
bit set to 1 in the Included Signals Field for a
given satellite found in Table 146: Satellite
and Signal Block on page 713)
The byte data is received MSB first so each group of bytes (as defined by the number of needed bits) must be swapped prior to processing.
4
xxxx
32-bit CRC (ASCII only)
5
[CR][LF]
Sentence terminator (ASCII only)
Hex
4
-
-
H+4+ (# bytes)
-
OEM7 Commands and Logs Reference Manual v10
711
Chapter 3 Logs
Table 145: Header
Data Name
Description
GNSS
Indicates which satellite system data is encoded and in what order. When the bit is set the satellite data is included. Data for each system is encoded sequentially: Bit 0 = GPS Bit 1 = GLONASS Bit 2 = SBAS Bit 5 = Galileo Bit 6 = BeiDou Bit 7 = QZSS Bit 9 = NavIC
Bits
Scale Factor
16 1
L-Band channels are not reported. This block is sent once per message
Bit Sum: 16
OEM7 Commands and Logs Reference Manual v10
712
Chapter 3 Logs
Table 146: Satellite and Signal Block
Data Name
Range
Description
Bits
Scale Factor
Indicates which satellites are present for this system and their order in the message. Each PRN is represented by a bit. (Bit 0 = PRN 1, Bit 1 = PRN 2, ...)
Notes:
l Manually assigned channels are not reported.
l GLONASS Satellite: This value represents the Slot
ID of the satellite (range of 1 to 24 where Bit 0 =
Slot ID 1). In the event the Slot ID is between 43
Satellites
0... 1.84467E+19
and 63, the actual GLONASS Slot ID has not yet been determined and has been replaced with a tem-
64
1
porary Slot ID calculated using the GLONASS Fre-
quency Number. See the GLONASS Frequency
Number field in Table 147: Measurement Block
Header on the next page for more details.
l SBAS Satellite PRNs 120 to 158 are offset by 120. (Bit 0 = PRN 120, Bit 1 = 121, ...)
l SBAS Satellite PRNs 183 to 187 are offset by 130
l QZSS Satellite PRNs are offset by 193
Signals 0... 65535
Indicates which signals are present for this system and
their order in the message. Each signal is represented by a bit as defined in Table 152: Signal Bit Mask on
16
1
page 719.
Included Signals
0... mxn
A two dimensional field to tell the decoder which signals are present for each of the satellites.
m = The number of rows equals the number of bits set to 1 found in the Satellites field. (Maximum number of PRNs in the satellite system)
mxn
n = The number of columns equals the number of bits set to 1 found in the Signals field. (Maximum number of Signals in the satellite system)
Bit Sum: 80 + mxn
This block is sent once for each bit set to 1 in the GNSS field found in Table 145: Header on the previous page.
OEM7 Commands and Logs Reference Manual v10
713
Chapter 3 Logs
Table 147: Measurement Block Header
Data Name
Range
Description
Bits
Scale Factor
Identifies what type of Measurement Block will be used:
0 = Reference
(Table 148: Primary Reference Signal Measurement Block
Data
on the next page and Table 149: Secondary Reference
Format
0... 1 Signals Measurement Block on page 716)
1
1
Flag
1 = Differential
(Table 150: Primary Differential Signal Measurement Block
on page 717 and Table 151: Secondary Differential Signals
Measurement Block on page 718)
Ref Data Block ID
0... 7
This ID identifies to which reference data the Differential Data is linked. This value is incremented by 1 each time a new Reference Measurement Block is used.
3
1
These bits are only present for GLONASS satellites in the Reference Data. This represents the GLONASS Frequency Number which identifies the frequency offset of the carrier frequency. The value will appear as a number between 0 and 20 which directly translates into a frequency offset number between -7 to +13.
GLONASS 0... 20 If the GLONASS Slot ID is unknown, a temporary Slot ID for
Frequency (-7 to this satellite will be set between 43 and 63 based on the
5
1
Number +13) GLONASS Frequency Number:
PRN = 63 � GLONASS Frequency Number
The GLONASS Frequency Number used in this calculation is the 0 to 20 value, not the adjusted -7 to +13 value.
Bit Sum:
4 (NonGLONASS)
9 (GLONASS)
This block is sent once for each bit set to 1 in the Satellites field found in Table 146: Satellite and Signal Block on the previous page.
OEM7 Commands and Logs Reference Manual v10
714
Chapter 3 Logs
Table 148: Primary Reference Signal Measurement Block
Data Name
Range
Description
Bits
0 = Parity Unknown
Parity Flag
0... 1
1
1 = Parity Known
0 = Half Cycle Not Added
� Cycle Flag 0... 1
1
1 = Half Cycle Added
C/No
0... 63.95
C/No
11
Lock Time
0... 15
The Lock Time � See Table 153: Lock Time on page 720
4
Pseudorange Std Dev
0... 15
The Pseudorange Standard Deviation (m) � See Table 155: Pseudorange Std Dev on 4 page 722
ADR Std Dev 0... 15
The ADR Standard Deviation (cycles) � See Table 154: ADR Std Dev on page 721
4
Primary Pseudorange
The Pseudo Range of the 1st signal
(Signals field in Table 146: Satellite and
0...
Signal Block on page 713).
68719476.74 If this value equals (237-1) =
37
137438953471, it represents a signal that
is not locked.
PhaseRange � Primary Pseudorange
�419.4303
(2's Complement) If this value equals �(223-1) = -4194304, 23
it represents the signal is not locked.
Primary Doppler
�3355.4431
(2's Complement) If this value equals �(226-1) = -33554432, 26
it represents an invalid Doppler.
Bit Sum: 111
Scale Factor 1 1 0.05 dBHz 1 1 1
0.0005 m
0.0001 m 0.0001 m/s
This block is sent once for the first bit set to 1 in the Included Signals field found in Table 146: Satellite and Signal Block on page 713. For any bits set to 1 after the first bit set to 1, refer to Table 149: Secondary Reference Signals Measurement Block on the next page.
This table is for Reference blocks only, as indicated by the Data Format Flag (see Table 147: Measurement Block Header on the previous page).
OEM7 Commands and Logs Reference Manual v10
715
Chapter 3 Logs
Table 149: Secondary Reference Signals Measurement Block
Data Name
Range
Description
Bits
0 = Parity Unknown
Parity Flag
0... 1
1
1 = Parity Known
0 = Half Cycle Not Added
� Cycle Flag
0... 1
1
1 = Half Cycle Added
C/No Indicator 0... 63.95 C/No
11
Lock Time
0... 15
The Lock Time � See Table 153: Lock Time on page 720
4
Pseudorange Std Dev
0... 15
The Pseudorange Standard Deviation
(m) � See Table 155: Pseudorange
4
Std Dev on page 722
ADR Std Dev
0... 15
The ADR Standard Deviation (cycles) �
See Table 154: ADR Std Dev on
4
page 721
Pseudorange � Primary Signal Pseudorange
�262.1435
(2's Complement) If this value equals �(220-1) = 524288, it indicates the signal is not locked.
20
Phaserange � Pseudorange
(2's Complement)
�419.4303
If this value equals �(223-1) = 4194304, it indicates the signal is not
23
locked.
Doppler � Primary Doppler
�0.8191
(2's Complement) If this value equals �(214-1) = -8192, 14
it indicates an invalid Doppler.
Bit Sum: 82
Scale Factor 1 1 0.05 dBHz 1 1
1
0.0005 m
0.0001 m
0.0001 m/s
This block is sent once for each bit set to 1 after the first bit set to 1 in the Included Signals field found in Table 146: Satellite and Signal Block on page 713.
This table is for Reference blocks only, as indicated by the Data Format Flag (see Table 147: Measurement Block Header on page 714).
OEM7 Commands and Logs Reference Manual v10
716
Chapter 3 Logs
Table 150: Primary Differential Signal Measurement Block
Data Name Range
Description
Bits
Scale Factor
Parity Flag 0... 1
0 = Parity Unknown 1 = Parity Known
1
1
� Cycle Flag 0... 1
0 = Half Cycle Not Added 1 = Half Cycle Added
1
1
C/No
0... 63.95 C/No
11
0.05 dBHz
Lock Time 0... 15
The Lock Time � See Table 153: Lock Time on page 720
4
1
Pseudorange Std Dev
0... 15
The Pseudorange Standard Deviation (m) � See Table 155: Pseudorange Std Dev on page 722
4
1
ADR Std Dev 0... 15
The ADR Standard Deviation (cycles) � See Table 154: ADR Std Dev on page 721
4
1
(2's Complement) If this value equals �(219-1) = -262144, it indicates a
signal that is not locked.
Pseudorange
The Predicted Pseudorange = reference pseudorange
� Predicted �131.0715 plus (the reference doppler x time difference between 19
Pseudorange
the reference log and the differential log). The
Reference log and Differential logs used must contain
matching Ref Data Block ID references (Table 147:
Measurement Block Header on page 714).
0.0005 m
Phaserange � Predicted Phaserange
�3.2767
(2's Complement) If this value equals �(216-1) = -32768, it indicates the signal is not locked.
The Predicted Phaserange = reference phaserange plus (the reference doppler x time difference between 16 the reference log and the differential log). The Reference log and Differential logs used must contain matching Ref Data Block ID references (Table 147: Measurement Block Header on page 714).
0.0001 m
OEM7 Commands and Logs Reference Manual v10
717
Chapter 3 Logs
Data Name Range
Doppler � Reference Doppler
�13.1071
Description
Bits
Scale Factor
(2's Complement) If this value equals �(218-1) = -131072, it indicates an invalid Doppler.
The Reference Doppler is the Doppler for that PRN and 18 for that signal from the Reference log. The Reference log and Differential logs used must contain matching Ref Data Block ID references (Table 147: Measurement Block Header on page 714).
0.0001 m/s
Bit Sum: 78
This block is sent once for each bit set to 1 after the first bit set to 1 in the Included Signals field found in Table 146: Satellite and Signal Block on page 713. For any bits set to 1 after the first bit set to 1, refer to Table 151: Secondary Differential Signals Measurement Block below.
This table is for Differential blocks only, as indicated by the Data Format Flag (see Table 147: Measurement Block Header on page 714).
Table 151: Secondary Differential Signals Measurement Block
Data Name Range
Description
Bits
Scale Factor
Parity Flag 0... 1
0 = Parity Unknown 1 = Parity Known
1
1
� Cycle Flag 0... 1
0 = Half Cycle Not Added 1 = Half Cycle Added
1
1
C/No
0... 63.95 C/No
11
0.05 dBHz
Lock Time 0... 15
The Lock Time � See Table 153: Lock Time on page 720
4
1
Pseudorange Std Dev
0... 15
The Pseudorange Standard Deviation (m) � See Table 155: Pseudorange Std Dev on page 722
4
1
ADR Std Dev 0... 15
The ADR Std Dev (cycles)� See Table 154: ADR Std Dev on page 721
4
1
OEM7 Commands and Logs Reference Manual v10
718
Chapter 3 Logs
Data Name Range
Description
Bits
Scale Factor
(2's Complement) If this value equals �(219-1) = -262144, it indicates
the signal is not locked.
Pseudorange
The Predicted Pseudorange = reference pseudorange
� Predicted �131.0715 plus (the reference doppler x time difference between 19
Pseudorange
the reference log and the differential log). The
Reference log and Differential logs used must contain
matching Ref Data Block ID references (Table 147:
Measurement Block Header on page 714).
0.0005 m
Phaserange � Predicted Phaserange
�3.2767
(2's Complement) If this value equals �(216-1) = -32768, it indicates the signal is not locked.
The Predicted Phaserange = reference phaserange plus (the reference doppler x time difference between 16 the reference log and the differential log). The Reference log and Differential logs used must contain matching Ref Data Block ID references (Table 147: Measurement Block Header on page 714).
0.0001 m
Doppler � Reference Doppler
�13.1071
(2's Complement) If this value equals �(214-1) = -8192, it indicates an invalid Doppler.
The Reference Doppler is the Doppler for that PRN and 14 for that signal from the Reference log. The Reference log and Differential logs used must contain matching Ref Data Block ID references (Table 147: Measurement Block Header on page 714).
0.0001 m/s
Bit Sum: 74
This block is sent once for each bit set to 1 after the first bit set to 1 in the Included Signals field found in Table 146: Satellite and Signal Block on page 713.
This table is for Differential blocks only, as indicated by the Data Format Flag (see Table 147: Measurement Block Header on page 714).
Bit 1
Table 152: Signal Bit Mask
GPS GLONASS SBAS Galileo BeiDou QZSS NavIC
L1CA L1CA
L1CA E1
B1
L1CA L5SPS
OEM7 Commands and Logs Reference Manual v10
719
Chapter 3 Logs
GPS GLONASS SBAS Galileo BeiDou QZSS NavIC
Bit 2
L5I E5A
B1GEO
Bit 3
L2CA
E5B
B2
L2C
Bit 4 L2Y L2P
ALTBOC B2GEO L5Q
Bit 5 L2C
E6C
B3
Bit 6 L2P L3
B3GEO
Bit 7 L5Q
B1CP
Bit 8
L1C
Bit 9
B2AP
Bit 10
Bit 11
L6P
Bit 12
E6B
Bit 13
Bit 14
Bit 15 L1C
Table 153: Lock Time
Indicator (i)
Minimum Lock Time (ms)
Range of Indicated Lock Times (t represents the Lock Time) (ms)
0
0
0 t < 16
1
16
16 t < 32
2
32
32 t < 64
3
64
64 t < 128
4
128
128 t < 256
5
256
256 t < 512
6
512
512 t < 1024
7
1024
1024 t < 2048
8
2048
2048 t < 4096
9
4096
4096 t < 8192
OEM7 Commands and Logs Reference Manual v10
720
Chapter 3 Logs
Indicator (i)
Minimum Lock Time (ms)
Range of Indicated Lock Times (t represents the Lock Time) (ms)
10
8192
8192 t < 16384
11
16384
16384 t < 32768
12
32768
32768 t < 65536
13
65536
65536 t < 131072
14
131072
131072 t < 262144
15
262144
262144 t
Table 154: ADR Std Dev
ADR Std Dev (cycles)
0
0.0039
1
0.0052
2
0.0070
3
0.0093
4
0.0124
5
0.0165
6
0.0221
7
0.0295
8
0.0393
9
0.0525
10
0.0701
11
0.0935
12
0.1248
13
0.1666
14
0.2223
15
> 0.2223
OEM7 Commands and Logs Reference Manual v10
721
Chapter 3 Logs
Table 155: Pseudorange Std Dev
Pseudorange Std Dev (m)
0
0.020
1
0.030
2
0.045
3
0.066
4
0.099
5
0.148
6
0.220
7
0.329
8
0.491
9
0.732
10
1.092
11
1.629
12
2.430
13
3.625
14
5.409
15
> 5.409
For more information about decoding the RANGECMP4 log, refer to Example of Bit Parsing a RANGECMP4 Log on page 1062.
OEM7 Commands and Logs Reference Manual v10
722
Chapter 3 Logs
3.131 RANGEGPSL1
L1 version of the RANGE log
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log is identical to the RANGE log (see page 689) except that it only includes L1 GPS observations.
Message ID: 631
Log Type: Synch
Recommended Input: log rangegpsl1a ontime 30
ASCII Example: #RANGEGPSL1A,COM1,0,57.0,FINESTEERING,1337,404766.000,02000000,5862, 1984; 10, 14,0,21773427.400,0.037,-114420590.433332,0.006,2408.171,49.9, 14963.280,18109c04, 22,0,24822942.668,0.045,-130445851.055756,0.009,-3440.031,48.0, 22312.971,08109c24, 25,0,20831000.299,0.033,-109468139.214586,0.006,1096.876,50.7, 7887.840,08109c44, 1,0,20401022.863,0.032,-107208568.887106,0.006,-429.690,51.1, 10791.500,18109c64, 24,0,23988223.932,0.074,-126058964.619453,0.013,2519.418,43.8, 493.550,18109c84, 11,0,22154466.593,0.043,-116423014.826717,0.007,-1661.273,48.4, 11020.952,08109ca4, 5,0,24322401.516,0.067,-127815012.260616,0.012,-1363.596,44.6, 6360.282,18109cc4, 20,0,22294469.347,0.043,-117158267.467388,0.008,2896.813,48.5, 4635.968,08109ce4, 30,0,23267589.649,0.051,-122271969.418761,0.009,822.194,47.0, 4542.270,08109d04, 23,0,24975654.673,0.058,-131247903.805678,0.009,3395.097,45.9, 406.762,18109d24*be4b7d70
OEM7 Commands and Logs Reference Manual v10
723
Chapter 3 Logs
Since the RANGEGPSL1 log includes only L1 GPS observations, it is smaller in size than the RANGE log which contains entries for multiple systems and signals. Use the RANGEGPSL1 log when data throughput is limited and you are only interested in GPS L1 range data. For GPS L1 only models, RANGE and RANGEGPSL1 logs are identical.
Field Field type
Description
1
RANGEGPSL1 Log header. See Messages on page 25 for
header
more information.
Format
Binary Bytes
Binary Offset
H
0
2
# obs
Number of L1 observations with information to follow
Long
4
H
3
PRN
Satellite PRN number of range measurement (1-32)
Ushort
2
H+4
4
Reserved
Ushort 2
H+6
5
psr
Pseudorange measurement (m)
Double 8
H+8
6
psr std
7
adr
Pseudorange measurement standard deviation (m)
Carrier phase, in cycles (accumulated Doppler range)
Float
4
Double 8
H+16 H+20
8
adr std
Estimated carrier phase standard deviation (cycles)
Float
4
H+28
9
dopp
Instantaneous carrier Doppler frequency (Hz) Float
4
H+32
10
C/No
11
locktime
Carrier to noise density ratio C/No = 10[log10(S/N0)] (dB-Hz)
Float
4
Number of seconds of continuous tracking (no cycle slipping)
Float
4
H+36 H+40
12
ch-tr-status
Tracking status (see Table 133: Channel Tracking Status on page 692)
Ulong 4
H+44
13... Next PRN offset = H + 4 + (#obs x 44)
14
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+4+ (#obs x 44)
15
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
724
Chapter 3 Logs
3.132 RAWALM
Raw GPS Almanac data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the undecoded GPS almanac subframes as received from the satellite. For more information about Almanac data, refer to An Introduction to GNSS available on our website.
Message ID: 74
Log Type: Asynch
Recommended Input:
log rawalma onchanged
ASCII Example:
#RAWALMA,COM1,0,56.0,SATTIME,1337,405078.000,02000000,cc1b,1984;1337,589824.000 ,43, 3,8b04e4839f35433a5590f5aefd3900a10c9aaa6f40187925e50b9f03003f, 27,8b04e483a1325b9cde9007f2fd5300a10da5562da3adc0966488dd01001a, 4,8b04e483a1b44439979006e2fd4f00a10d15d96b3b021e6c6c5f23feff3c, 28,8b04e483a3b05c5509900b7cfd5800a10cc483e2bfa1d2613003bd050017, 5,8b04e483a43745351c90fcb0fd4500a10d8a800f0328067e5df8b6100031, 57,8b04e483a6337964e036d74017509f38e13112df8dd92d040605eeaaaaaa, 6,8b04e483a6b54633e390fa8bfd3f00a10d4facbc80b322528f62146800ba, 29,8b04e483a8b05d47f7901b20fd5700a10ce02d570ed40a0a2216412400cb, 7,8b04e483a935476dee90fb94fd4300a10d93aba327b7794ae853c02700ba, ... 1,8b04e483d8b641305a901b9dfd5a00a10ce92f48f1ba0a5dcccb7500003b, 25,8b04e483dab25962259004fcfd4c00a10dc154eee5c555d7a2a5010d000d, 2,8b04e483db37424aa6900720fd4f00a10c5ad89baa4dc1460790b6fc000f, 26,8b04e483dd305a878c901d32fd5b00a10c902eb7f51db6b6ce95c701fff4*83cae97a
The OEM7 family of receivers automatically saves almanacs in their Non-Volatile Memory (NVM), therefore creating an almanac boot file is not necessary.
Field Field type
Description
1
RAWALM header
Log header. See Messages on page 25 for more information.
2
ref week
Almanac reference week number
3
ref secs
Almanac reference time (ms)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 GPSec 4
H H+4
OEM7 Commands and Logs Reference Manual v10
725
Chapter 3 Logs
Field Field type
Description
4
#subframes Number of subframes to follow
SV ID (satellite vehicle ID)
A value between 1 and 32 for the SV ID indicates the PRN of the satellite. Any other values indicate the page ID.
Format
Binary Bytes
Binary Offset
Ulong 4
H+8
5
svid
See section 20.3.3.5.1.1, Data ID and SV ID, of ICDGPS-200C for more details. To obtain copies of ICDGPS-200, refer to the GPS website (www.gps.gov/).
6
data
Subframe page data
7... Next subframe offset = H+12+(#subframe x 32)
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Ushort 2
Hex
30
Hex
4
-
-
H+12
H+14 H+12+ (#subframes x 32) -
OEM7 Commands and Logs Reference Manual v10
726
Chapter 3 Logs
3.133 RAWCNAVFRAME
Raw GPS CNAV frame data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides raw frame data from signals which contain the CNAV message (L2C, L5).
The RAWCNAVFRAME log is not output by default. To receive this log, data decoding for L2C or L5 must be enabled using the DATADECODESIGNAL command (see page 115) for the specific signal.
Message ID: 1066
Log Type: Asynch
Recommended Input: log rawcnavframea onnew
ASCII Example: #RAWCNAVFRAMEA,COM1,0,63.0,SATTIME,1902,431718.000,02000020,ee56,13677;17,6,11, 8b18b8c892cd499a403d89d3a5bfc05f500a1fff6007dff412e017a3c029ccff5d6001fc9a70*0d ddab32
Field Field type
Description
1
RAWCNAVFRAME Log header. See Messages on page 25
header
for more information.
2
signal channel
Signal channel providing the bits
3
PRN
Satellite PRN number
4
frame ID
frame ID
5
data
Raw frame data
6
xxxx
32-bit CRC (ASCII and Binary only)
7
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
H
Ulong 4
Ulong 4
Ulong 4
Hex[38] 38
Hex
4
-
-
Binary Offset
0
H H+4 H+8 H+12 H+50 -
OEM7 Commands and Logs Reference Manual v10
727
Chapter 3 Logs
3.134 RAWEPHEM
Raw GPS ephemeris
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw binary information for subframes one, two and three from the GPS satellite L1 C/A signal with the parity information removed. Each subframe is 240 bits long (10 words - 24 bits each) and the log contains a total 720 bits (90 bytes) of information (240 bits x 3 subframes). This information is preceded by the PRN number of the satellite from which it originated. This message is not generated unless all 10 words from all 3 frames have passed parity. Ephemeris data whose Time of Ephemeris (TOE) is older than six hours is not shown. Multiple logs are output, one for each GPS satellite with collected ephemeris information.
Message ID: 41
Log Type: Asynch
Recommended Input: log rawephema onnew
ASCII Example: #RAWEPHEMA,COM1,30,48.0,SATTIME,2017,215910.000,02000008,58ba,14968;8, 2017,215984, 8b0f84464926f8500023bc389922867c68cea8010b0d34bb00fff5f10fbe, 8b0f844649ab0dfac632fe6b077ab8fbc101cbf3970702a10cf7c334bb16, 8b0f84464a2fffd51d287903005b2781e24627e6ef75369dffa4920dfe27*e26b8cb9
...
#RAWEPHEMA,COM1,29,48.0,SATTIME,2017,217440.000,02000008,58ba,14968; 10,2017,223200, 8b0f8446c8a7f8500012fcc99922867c68cea801045e367e00ffef1817c6, 8b0f8446c9295efea1313adc677649fe7a01ea37a913e4a10d5206367e7e, 8b0f8446c9af003072eca2d5fff527313d1619108e3984d6ffa8df5e08ba*85ccfe5a
A way to use only one receiver and achieve better than 1 metre accuracy is to use precise orbit and clock files. Three types of GPS ephemeris, clock and earth orientation solutions are compiled by an elaborate network of GNSS receivers around the world all monitoring the satellite characteristics. IGS rapid orbit data is processed to produce files that correct the satellite clock and orbit parameters. Since there is extensive processing involved, these files are available on a delayed schedule from the US National Geodetic Survey at: www.ngs.noaa.gov/orbits Precise ephemeris files are available today to correct GPS data which was collected a few days ago. All you need is one GNSS receiver and a computer to process on. Replace the ephemeris data with the precise ephemeris data and post-process to correct range values.
OEM7 Commands and Logs Reference Manual v10
728
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
1
RAWEPHEM Log header. See Messages on page 25 for
header
more information.
H
2
PRN
Satellite PRN number
Ulong 4
3
ref week
Ephemeris reference week number
Ulong 4
4
ref secs
Ephemeris reference time (s)
Ulong 4
5
subframe1 Subframe 1 data
Hex[30] 30
6
subframe2 Subframe 2 data
Hex[30] 30
7
subframe3 Subframe 3 data
Hex[30] 30
8
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
9
[CR][LF]
Sentence terminator (ASCII only)
-
-
Binary Offset
0
H H+4 H+8 H+12 H+42 H+72 H+102 -
OEM7 Commands and Logs Reference Manual v10
729
Chapter 3 Logs
3.135 RAWGPSSUBFRAME
Raw GPS L1 C/A subframe data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw GPS L1 C/A subframe data. A raw GPS L1 C/A subframe is 300 bits in total. This includes the parity bits which are interspersed with the raw data ten times in six bit chunks, for a total of 60 parity bits. Note Field #5, below, has these 60 parity bits stripped out and only the raw subframe data remains, for a total of 240 bits.
Message ID: 25
Log Type: Asynch
Recommended Input: log rawgpssubframea onnew
ASCII Example: #RAWGPSSUBFRAMEA,COM1,59,62.5,SATTIME,1337,405348.000,02000000,f690,1984;2,22,4 ,8b04e483f3b17ee037a3732fe0fc8ccf074303ebdf2f6505f5aaaaaaaaa9,2*41e768e4 ... #RAWGPSSUBFRAMEA,COM1,35,62.5,SATTIME,1337,405576.000,02000000,f690,1984;4,25,2 ,8b04e48406a8b9fe8b364d786ee827ff2f062258840ea4a10e20b964327e,4*52d460a7 ... #RAWGPSSUBFRAMEA,COM1,0,62.5,SATTIME,1337,400632.000,02000000,f690,1984;20,9,3, 8b04e4826aadff3557257871000a26fc34a31d7a300bede5ffa3de7e06af,20*55d16a4a
The RAWGPSSUBFRAME log can be used to receive the data bits with the parity bits stripped out. Alternately, you can use the RAWGPSWORD log (see page 732) to receive the parity bits in addition to the data bits.
Field
Field type
Description
1
RAWGPSSUBFRAME Log header. See Messages on
header
page 25 for more information.
2
decode #
Frame decoder number
3
PRN
Satellite PRN number
4
subframe id
Subframe ID
5
data
Raw subframe data
Format
Binary Bytes
Binary Offset
H
0
Long
4
Ulong 4
Ulong 4
Hex[30] 321
H H+4 H+8 H+12
1In the binary log case, an additional 2 bytes of padding are added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
730
Chapter 3 Logs
Field
Field type
6
signal channel
7
xxxx
8
[CR][LF]
Description
Signal channel number that the frame was decoded on 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+44
Ulong 4
-
-
H+48 -
OEM7 Commands and Logs Reference Manual v10
731
Chapter 3 Logs
3.136 RAWGPSWORD
Raw GPS navigation word
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This message contains the framed GPS raw navigation words. Each log contains a new 30 bit navigation word (in the least significant 30 bits), plus the last 2 bits of the previous word (in the most significant 2 bits). The 30 bit navigation word contains 24 bits of data plus 6 bits of parity. The GPS reference time stamp in the log header is the time the first bit of the 30 bit navigation word was received. Only navigation data that has passed parity checking appears in this log. One log appears for each PRN being tracked every 0.6 seconds if logged ONNEW or ONCHANGED.
Message ID: 407
Log Type: Asynch
Recommended Input: log rawgpsworda onnew
ASCII Example: #RAWGPSWORDA,COM1,0,58.5,FINESTEERING,1337,405704.473,02000000,9b16,1984;14,7ff 9f5dc*8e7b8721 ... #RAWGPSWORDA,COM1,0,57.0,FINESTEERING,1337,405783.068,02000000,9b16,1984;1,93fe ff8a*6dd62c81 ... #RAWGPSWORDA,COM1,0,55.5,FINESTEERING,1337,405784.882,02000000,9b16,1984;5,ffff f8ce*a948b4de
The RAWGPSWORD log can be used to receive the parity bits in addition to the data bits. Alternately, you can use the RAWGPSSUBFRAME log which already has the parity bits stripped out
Field Field type
Description
1
RAWGPSWORD Log header. See Messages on page 25
header
for more information.
2
PRN
Satellite PRN number
3
nav word
Raw navigation word
4
xxxx
32-bit CRC (ASCII and Binary only)
5
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
Hex[4] 4
Ulong 4
-
-
H H+4 H+8 -
OEM7 Commands and Logs Reference Manual v10
732
Chapter 3 Logs
3.137 RAWSBASFRAME
Raw SBAS frame data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw SBAS frame data of 226 bits (8-bit preamble, 6-bit message type and 212 bits of data but without a 24-bit CRC). Only frame data with a valid preamble and CRC are reported.
Message ID: 973
Log Type: Asynch
Recommended Input: log rawsbasframea onnew
ASCII Example: #RAWSBASFRAMEA,COM1,0,91.0,SATTIME,1610,341534.000,02000000,58e4,38637;32,133,4 ,c6115ffc00000c009ffc07004c089ffdffdffdffdfff957bbb6bffffc0,32*5afc5f95 #RAWSBASFRAMEA,COM1,0,91.0,SATTIME,1610,341535.000,02000000,58e4,38637;32,133,2 ,53084007ff9fffffc03002c0000f0009ffc004005ffd6b961e39b9fb80,32*db5dfa62 #RAWSBASFRAMEA,COM1,0,91.0,SATTIME,1610,341535.000,02000000,58e4,38637;35,135,2 ,53084007ff9fffffc03002c0000f0009ffc004005ffd6b961e39b9fb80,35*b72ff2a0 ... #RAWSBASFRAMEA,COM1,0,90.0,SATTIME,1610,341539.000,02000000,58e4,38637;34,138,3 ,9a0c4000009ffc009ffdffc007fb9ffdffc0000040315b9bb96fb95680,34*cb050361
The RAWSBASFRAME log output contains all the raw data required for an application to compute its own SBAS correction parameters.
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
RAWSBASFRAME Log header. See Messages on page 25 for
header
more information.
H
0
2
decode #
Frame decoder number
Ulong 4
H
3
PRN
SBAS satellite PRN number
Ulong 4
H+4
4
SBAS frame ID SBAS frame ID
Ulong 4
H+8
OEM7 Commands and Logs Reference Manual v10
733
Chapter 3 Logs
Field Field type
5
raw frame data
6
signal channel
7
xxxx
8
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Raw SBAS frame data. There are 226 bits of data and 6 bits of padding
Hex[29]
321
H+12
Signal channel number that the frame was decoded on
Ulong 4
H+44
32-bit CRC (ASCII and Binary only)
Ulong 4
H+48
Sentence terminator (ASCII only)
-
-
-
1In the binary log case, an additional 3 bytes of padding are added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
734
Chapter 3 Logs
3.138 RAWSBASFRAME2
Raw SBAS frame data 2
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the raw SBAS frame data of 226 bits (8-bit preamble, 6-bit message type and 212 bits of data but without a 24-bit CRC). It also contains the transmitted frequency. Only frame data with a valid preamble and CRC are reported.
Message ID: 2185
Log Type: Asynch
Recommended Input: log rawsbasframe2a onnew
ASCII Example: #RAWSBASFRAME2A,COM1,0,77.5,SATTIME,1977,514394.000,02000020,b39f,32768;135,209 ,2,1,0,3,c60d4009ffc018001ffc005ffdfffffbff9ffc00bfed79db9bb95b9540*9a75ce69 #RAWSBASFRAME2A,COM1,0,77.5,SATTIME,1977,514394.000,02000020,b39f,32768;138,207 ,2,1,0,4,c6125ffdffc005ffffffffbfe3fb9ffdffdffdffdfffba3956abffffc0*9324a574 #RAWSBASFRAME2A,COM1,0,77.5,SATTIME,1977,514395.000,02000020,b39f,32768;135,208 ,1,0,0,4,53125ffdffc011ffc000007fe3fb5ffdffdffdffdfffba3956abffffc0*69490ac5 #RAWSBASFRAME2A,COM1,0,78.5,SATTIME,1977,514395.000,02000020,b39f,32768;138,206 ,1,0,0,3,530c7ff9ffc017ff9fffff9ffdfffffbfedffc003fe579db9bb95b9540*c7ca1531
The RAWSBASFRAME2 log output contains all the raw data required for an application to compute its own SBAS correction parameters.
Field
Field Type
Description
1
RAWSBASFRAME2 Log header. See Messages on page 25
header
for more information.
2
PRN
SBAS satellite PRN number
3
signal channel
Signal channel number that the frame was decoded on
4
SBAS Signal Source
Identifies the source of the SBAS signal:
1 � SBASL1CA
2 � SBASL5I
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
Ulong 4
H+4
Uchar 1
H+8
OEM7 Commands and Logs Reference Manual v10
735
Chapter 3 Logs
Field
Field Type
5
SBAS Preamble Type
6
Reserved
7
SBAS frame ID
8
data
9
xxxx
10
[CR][LF]
Description
Identifies what preamble was used when tracking the SBAS signal:
0 � SBASL1CA 8-bit Preamble 1 � SBASL5I 8-bit Preamble
SBAS frame ID Raw SBAS frame data. There are 226 bits of data and 6 bits of padding 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Uchar 1
H+9
Ushort 2 Ulong 4
Hex[29] 321
Ulong 4
-
-
H+10 H+12 H+16 H+48 -
1In the binary log case, an additional 3 bytes of padding are added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
736
Chapter 3 Logs
3.139 REFSTATION
Base station position and health
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the ECEF Cartesian position of the base station as received through the RTCMV3 message. It also features a time tag, the health status of the base station and the station ID. This information is set at the base station using the FIX command (see page 166) and the DGPSTXID command (see page 127). See Figure 11: The WGS84 ECEF Coordinate System on page 454 for a definition of the ECEF coordinates. The base station health, Field #6, may be one of 8 values (0 to 7). Values 0 through 5 indicate the scale factor that is multiplied with the satellite UDRE one-sigma differential error values. Below are values 0 to 5 and their corresponding UDRE scale factors:
0: 1 (Health OK) 0.75 2: 0.5 3: 0.3 4: 0.2 5: 0.1 The base station health field only applies to RTCM base stations. A value of 6 means the base station transmission is not monitored and a value of 7 means that the base station is not working.
Message ID: 175
Log Type: Asynch
Recommended Input: log refstationa onchanged
ASCII Example: #REFSTATIONA,COM1,0,66.5,FINESTEERING,1364,490401.124,82000000,4e46,2310;000000 00,-1634532.443,-3664608.907,4942482.713,0,RTCMV3,"AAAA"*1e2a0508
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
REFSTATION Log header. See Messages on page 25 for
header
more information.
H
0
2
status
Status of the base station information (see
Table 156: Base Station Status on the next
Ulong 4
H
page)
3
x
ECEF X value (m)
Double 8
H+4
4
y
ECEF Y value (m)
Double 8
H+12
5
z
ECEF Z value (m)
Double 8
H+20
6
health
Base station health, see the description at the start of this section
Ulong
4
H+28
7
stn type
Station type (see Table 157: Station Type on the next page)
Enum
4
H+32
OEM7 Commands and Logs Reference Manual v10
737
Chapter 3 Logs
Field Field type
Description
8
stn ID
9
xxxx
10
[CR][LF]
Base station ID 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Char[5] 81
H+36
Ulong 4
H+44
-
-
-
Table 156: Base Station Status
Bit #
Mask
Description
Bit = 0 Bit = 1
0 0x00000001 Validity of the base station Valid Invalid
Table 157: Station Type
Base Station Type Binary ASCII
Description
0
NONE
Base station is not used
1 - 3 Reserved
4
RTCMV3 Base station is RTCMV3
The REFSTATION log can be used for checking the operational status of a remotely located base station. You can verify that the base station is operating properly without traveling to it. This is especially useful for RTK work on long baselines.
1In the binary log case, an additional 3 bytes of padding are added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
738
Chapter 3 Logs
3.140 REFSTATIONINFO
Base Station position information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This is an extended version of the REFSTATION log with latitude, longitude and ellipsoidal height of the base station in WGS84. In addition to the base station position, ARP height, antenna model name and antenna serial number are available if provided by the base station only through RTCMV3.
Message ID: 1325
Log Type: Asynch
Recommended Input: log refstationinfoa onchanged
ASCII Example: #REFSTATIONINFOA,USB1,0,89.5,EXACT,0,0.000,02000040,d38f,6782; 51.116375174,-114.038254922,1048.502830628,WGS84,1.234,0,RTCMV3, "0","702GG","NVH05410007"*bedf8ece
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
REFSTATIONINFO Log header. See Messages on page 25
header
for more information.
H
0
2
latitude
Latitude (degrees)
Double 8
H
3
longitude
Longitude (degrees)
Double 8
H+8
4
height
Ellipsoidal Height (m)
Double 8
H+16
5
datum
Datum ID number (WGS84) (refer to Table 29: Datum Transformation Parameters on page 121)
Enum 4
H+24
6
ARP height
Base Antenna ARP (m)
Float
4
H+28
7
health
Base Station Health, see Table 156: Base Station Status on the previous page
Ulong
4
H+32
8
Ref Stn Type
9
stn ID
Base Station Type, see (Table 157: Station Type on the previous page)
Base Station ID
Enum 4 Char[5] 8a
H+36 H+40
aIn the binary log case, an additional 3 bytes of padding are added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
739
Chapter 3 Logs
Field
Field type
Description
10
Ant Model
Base Antenna Model Name
11
Ant Serial
12
xxxx
13
[CR][LF]
Base Antenna Serial Number 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Char [32]
32
H+48
Char [32]
32
H+80
Ulong 4
H+112
-
-
-
OEM7 Commands and Logs Reference Manual v10
740
Chapter 3 Logs
3.141 ROVERPOS
Position using ALIGN
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
ALIGN generates distance and bearing information between a master and rover receiver. This log outputs the position information of the rover when using the ALIGN feature. This log can only be output from a Y ALIGN model and can be output at both Master and Rover ends.
You must have an ALIGN capable receiver to use this log.
l ALIGN is useful for obtaining the relative directional heading of a vessel/body, separation heading between two vessels/bodies, or heading information with moving base and pointing applications.
l The log can be output at the Y model Rover only if it is receiving the RTCAREFEXT message from the Master. The log can be output at any Master if the Master is receiving HEADINGEXTB from the Rover. Refer to the NovAtel application note APN-048 for details on HEADINGEXT (available at www.novatel.com/support/).
l ROVERPOS is dependent on the output frequency of the RTCAREFEXT message from the master to the rover.
l On dual antenna receivers, the ROVERPOS log outputs the position for the secondary antenna input.
Message ID: 1052
Log Type: Asynch
Recommended Input: log roverposa onchanged
ASCII Example: #ROVERPOSA,COM1,0,21.5,FINESTEERING,1544,340322.000,02000008,7453,4655;SOL_ COMPUTED,NARROW_INT,51.11605565964,-114.03854655975,1055.8559,16.9000,WGS84,0.0130,0.0122,0.0206,"RRRR",0.0,0.0,13,12,12,11,0,0,0,0*635b3a1c
Asynchronous logs, such as ROVERPOS, should only be logged ONCHANGED or ONNEW otherwise the most current data is not output when it is available. This is especially true of the ONTIME trigger, which may cause inaccurate time tags to result.
OEM7 Commands and Logs Reference Manual v10
741
Chapter 3 Logs
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
ROVERPOS Log header. See Messages on page 25 for more
header
information.
H
0
2
sol stat
Solution Status, see Table 74: Solution Status on page 436
Enum
4
H
3
pos type
Position Type see Table 75: Position or Velocity Type on page 437
Enum
4
H+4
4
lat
Rover WGS84 Latitude in degrees
Double 8
H+8
5
long
Rover WGS84 Longitude in degrees
Double 8
H+16
6
hgt
Rover MSL Height in metres
Double 8
H+24
7
undulation Undulation in metres
Float
4
H+32
8
datum id#
WGS84 (default) (refer to Table 29: Datum Transformation Parameters on page 121)
Enum 4
H+36
9
lat
Latitude standard deviation in metres
Float
4
H+40
10
long
Longitude standard deviation in metres
Float
4
H+44
11
hgt
Height standard deviation in metres
Float
4
H+48
12
stn id
Rover ID (default = "RRRR")
Char[4] 4
H+52
13
Reserved
Float
4
H+56
14
Reserved
Float
4
H+60
15
#SVs
Number of satellite tracked
Uchar 1
H+64
16
#solnSVs Number of satellite in solution
Uchar 1
H+65
17
#obs
Number of satellites above elevation mask angle
Uchar 1
H+66
18
#multi
Number of satellites above the mask angle with L2, B2
Uchar
1
H+67
19
Hex
1
H+68
20 Reserved
21
Uchar 1 Uchar 1
H+69 H+70
22
Uchar 1
H+71
23
xxxx
32-bit CRC (ASCII and Binary only)
Hex
1
H+72
24
[CR][LF] Sentence Terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
742
Chapter 3 Logs
3.142 RTCMV3 Standard Logs
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
NovAtel's RTCMv3 logs are implementations of the messages described by the RTCM SC-104 committee's "Differential GNSS (Global Navigation Satellite Systems) Services � Version 3" standard. These messages are primarily intended to support RTK operations. They are also an alternative raw data format to NovAtel's proprietary messages.
The RTCMv3 logs can be divided into several categories that are described below. An RTK base station must minimally transmit one or more observable message, together with one or more station and antenna message. The GENERATERTKCORRECTIONS command on page 187 illustrates an appropriate set of messages and is an easy way to configure logging.
Example Input: interfacemode com2 none RTCMV3 fix position 51.1136 -114.0435 1059.4 thisantennatype NOV702 log com2 rtcm1006 ontime 10 log com2 rtcm1033 ontime 10 2 log com2 rtcm1004 ontime 1 log com2 rtcm1012 ontime 1
3.142.1 Legacy Observable Messages
The legacy observable messages contain GPS and GLONASS code and phase observables. The extended messages additionally contain the C/N0.
Table 158: Legacy Observable Messages
Log Name Message ID
Description
RTCM1001 772
GPS L1-only observables, basic
RTCM1002 774
GPS L1-only observables, extended
RTCM1003 776
GPS L1/L2 basic observables, basic
RTCM1004 770
GPS L1/L2 basic observables, extended
RTCM1009 885
GLONASS L1-only observables, basic
RTCM1010 887
GLONASS L1-only observables, extended
RTCM1011 889
GLONASS L1/L2 basic observables, basic
RTCM1012 891
GLONASS L1/L2 basic observables, extended
3.142.2 MSM Observable Messages
The Multiple Signal Messages (MSM) are observable messages for all current GNSS systems. They provide a standardized framework for message content and are designed to support future
OEM7 Commands and Logs Reference Manual v10
743
Chapter 3 Logs
systems and signals.
Sending legacy (1001-1004 and 1009-1012) and MSM messages in the same stream can cause problems for remote RTK users and is not recommended.
Each GNSS system has a set of seven MSM types numbered from 1 to 7. The MSM type for each GNSS system provides the same generic information. Generally, as the MSM number increases, more information is available in the messages. For example, MSM1 for each GNSS system provides the code measurements for the system, while MSM3 provides both the code and phase.
The information encoded in each MSM variant is described in Table 159: MSM Type Descriptions below for the descriptions of each of the seven MSM types. For RTK operations, MSM3 is minimally recommended.
Table 159: MSM Type Descriptions
Message
Description
MSM1
Provides the code measurements.
MSM2
Provides the phase measurements.
MSM3
Provides the data from MSM1 (code) and MSM2 (phase) in a single message.
MSM4
Provides all the data from MSM3 (code and phase) and adds the CNR measurements.
MSM5
Provides all the data from MSM4 (code, phase and CNR) and adds the doppler measurements.
MSM6
Provides the same information as MSM4, but has extended resolution on the measurements.
MSM7
Provides the same information as MSM5, but has extended resolution on the measurements.
Table 160: MSM Log Names below lists the MSM message name and Table 161: MSM Message IDs on the next page lists the message IDs.
Table 160: MSM Log Names
Message
GPS
GLONASS
Galileo
QZSS
BeiDou
MSM1
RTCM1071
RTCM1081
RTCM1091
RTCM1111
RTCM1121
MSM2
RTCM1072
RTCM1082
RTCM1092
RTCM1112
RTCM1122
MSM3
RTCM1073
RTCM1083
RTCM1093
RTCM1113
RTCM1123
MSM4
RTCM1074
RTCM1084
RTCM1094
RTCM1114
RTCM1124
MSM5
RTCM1075
RTCM1085
RTCM1095
RTCM1115
RTCM1125
MSM6
RTCM1076
RTCM1086
RTCM1096
RTCM1116
RTCM1126
MSM7
RTCM1077
RTCM1087
RTCM1097
RTCM1117
RTCM1127
OEM7 Commands and Logs Reference Manual v10
744
Chapter 3 Logs
Message MSM1 MSM2 MSM3 MSM4 MSM5 MSM6 MSM7
GPS 1472 1473 1474 1475 1476 1477 1478
Table 161: MSM Message IDs
GLONASS
Galileo
1479
1486
1480
1487
1481
1488
1482
1489
1483
1490
1484
1491
1485
1492
QZSS 1648 1649 1650 1651 1652 1653 1654
BeiDou 1592 1593 1594 1595 1596 1597 1598
3.142.3 Station and Antenna Messages
The station and antenna messages listed in Table 162: Station and Antenna Messages on the next page provide the base station's coordinates and hardware. Remote RTK users require this information so that they can position themselves relative to a base station.
l Message Type 1005 provides the Earth-Centered, Earth-Fixed (ECEF) coordinates of the Antenna Reference Point (ARP). The ARP is an explicit physical point on the antenna, typically the center of its base. It is related to the antenna phase center from where the measurements are emitted via the Phase Center Offsets (PCOs). The PCOs can be set using the THISANTENNAPCO command (see page 371) or THISANTENNATYPE command (see page 373). If the PCOs are not set, then the coordinates transmitted by Message types 1005 and 1006 will be those that the receiver is fixed to by the FIX command (see page 166).
l Message Type 1006 is the same as 1005 but additionally provides the antenna height. This value is always set to zero by the receiver firmware.
l Message Type 1007 provides the base station antenna type. Conventionally, the antenna name from the International GNSS Service (IGS) is used. The antenna name can be set using the THISANTENNATYPE command (see page 373).
l Message Type 1008 is the same as 1007 but additionally provides the antenna serial number. The serial number is always set to null by the receiver firmware.
l Message Type 1033, like message types 1007 and 1008, also provides the antenna information. Message type 1033 additionally provides the receiver type and firmware version. The primary use of this information is to more-easily enable RTK rovers to fix their GLONASS ambiguities. This information is filled automatically and appropriately by the receiver firmware.
For a receiver operating as an RTK base station, the recommended messages to transmit are 1006 and 1033. With these messages remote RTK users have all the information describing the base station.
OEM7 Commands and Logs Reference Manual v10
745
Chapter 3 Logs
Table 162: Station and Antenna Messages
Log Name
Message RTCM Message
ID
Type
Description
RTCM1005 765
1005
Stationary RTK Base Station Antenna Reference Point (ARP)
RTCM1006 768
1006
Stationary RTK Base Station ARP with Antenna Height
RTCM1007 852
1007
Extended Antenna Descriptor and Setup Information
RTCM1008 854
1008
Extended Antenna Reference Station Description and Serial Number
RTCM1033 1097
1033
Receiver and antenna descriptors
3.142.4 Ephemeris Messages
The ephemeris messages listed in Table 163: Ephemeris Messages below provide the satellite ephemerides. For RTK operations this information is optional, as RTK rovers will be downloading their own ephemerides directly from the satellites.
There are two messages for each ephemeris type. For the messages logged ONTIME (e.g. LOG RTCM1019 ONTIME 10) a single satellite's ephemeris is output at each ONTIME interval. The ephemerides will be cycled through in numerical order. For the messages logged ONCHANGED (e.g., LOG RTCM1019ASYNC ONCHANGED), new or changed ephemerides will be output as soon as they are available.
Log Name
Table 163: Ephemeris Messages
Message ID
RTCM Message Type
Description
RTCM1019
893
1019
GPS Ephemerides, logged ONTIME
RTCM1019ASYNC 2088
1019
GPS Ephemerides, logged ONCHANGED
RTCM1020
895
1020
GLONASS Ephemerides, logged ONTIME
RTCM1020ASYNC 2089
1020
GLONASS Ephemerides, logged ONCHANGED
RTCM1042
2171
1042
BeiDou Ephemerides, logged ONTIME
RTCM1042ASYNC 2170
1042
BeiDou Ephemerides, logged ONCHANGED
RTCM1044
2177
1044
QZSS Ephemerides, logged ONTIME
RTCM1044ASYNC 2176
1044
QZSS Ephemerides, logged ONCHANGED
RTCM1045
2173
1045
Galileo F/NAV Ephemerides, logged ONTIME
OEM7 Commands and Logs Reference Manual v10
746
Chapter 3 Logs
Log Name
Message ID
RTCM Message Type
RTCM1045ASYNC 2172
1045
RTCM1046
2175
1046
RTCM1046ASYNC 2174
1046
Description
Galileo F/NAV Ephemerides, logged ONCHANGED
Galileo I/NAV Ephemerides, logged ONTIME
Galileo I/NAV Ephemerides, logged ONCHANGED
OEM7 Commands and Logs Reference Manual v10
747
Chapter 3 Logs
3.143 RTKASSISTSTATUS
RTK ASSIST status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides information on the state of RTK ASSIST.
RTK ASSIST operates in two modes: coast and full assist. The RTKASSISTSTATUS log reports which mode is currently available. Coast mode is available as soon as the RTK ASSIST corrections are received from the L-Band satellite, while full assist mode requires a convergence period. In coast mode, position error growth during RTK correction outages is slightly worse than in full assist mode and RTK will not resume following a full signal outage until after RTK corrections are restored. Full assist gives the lowest position error growth during RTK correction outages, and makes it possible for RTK to resume even if there are complete GNSS signal outages during the RTK ASSIST period.
The RTK ASSIST ACTIVE state reported in the RTKASSISTSTATUS log is also reported in the RTKPOS and BESTPOS extended solution status field. See Table 78: Extended Solution Status on page 440.
The RTKASSISTSTATUS log reports the time remaining in the RTK ASSIST ACTIVE state. Once RTK ASSIST becomes active, the remaining time will count down from the time out set by the RTKASSISTTIMEOUT command (see page 303) .
The corrections age reported in the RTKASSISTSTATUS log should typically be below 30 seconds. If the age exceeds this value, then L-Band tracking is likely being degraded. The most likely cause of degraded L-Band tracking are obstructions between the antenna and the L-Band satellite.
Message ID: 2048
Log Type: Synch
Recommended Input:
log rtkassiststatusa ontime 5
ASCII Example:
#RTKASSISTSTATUSA,COM1,0,80.0,FINESTEERING,1932,491359.000,02000020,80fe,46672; ACTIVE,ASSIST,969.0,14.0*26e32616
Field
Field type
Description
1
RTKASSISTSTATUS Log header. See Messages on page 25
header
for more information.
2
State
State: INACTIVE (0) ACTIVE (1)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
748
Chapter 3 Logs
Field
Field type
3
Mode
4
Remaining time
5
Corrections age
6
xxxx
7
[CR][LF]
Description
Mode: UNAVAILABLE (0) COAST (1) ASSIST (2)
Time remaining in seconds Age of the RTK ASSIST corrections in seconds. Maximum value of 120 seconds. 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Enum 4
H+4
Float
4
Float
4
Hex
4
-
-
H+8 H+12 H+16 -
OEM7 Commands and Logs Reference Manual v10
749
Chapter 3 Logs
3.144 RTKDOP
DOP values for the satellites used in the RTK solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The RTKDOP log contains the Dilution Of Precision (DOP) values for the satellites being used in the RTK solution. Note that unlike the PSRDOP log (see page 658), the RTKDOP log is synchronous. DOP values will be calculated at the requested rate, up to a maximum rate of 1 Hz.
DOP values are a measure of the solution strength. Essentially, the DOPs reflect the geometry of the satellites used in the solution. Solutions with good counts of well-distributed satellites will have low DOPs and should be accurate and reliable. Solutions with fewer or poorly-distributed satellites will have high DOPs and be less accurate and reliable. As a rough guideline, PDOP values less than 4 imply a solution with reasonable geometry.
There can be many reasons for high DOP values. The most common reason is that there are obstructions limiting satellite visibility. Even if satellites are visible and being tracked they might still not be used in the solution if, for example, they are unhealthy or there aren't corrections available for them. The RTKSATS log (see page 757) will inform which satellites are being tracked and explain why a tracked satellite is not used in the solution.
The DOPs do not consider that different satellites or signals will be weighted differently in the solution. Therefore, they do not completely reflect the solution quality. Ultimately, the standard deviations reported in the RTKPOS log (see page 754) are the best reflection of the solution accuracy.
Message ID: 952
Log Type: Synch
Recommended Input:
log rtkdopa ontime 10
ASCII Example:
#RTKDOPA,COM1,0,60.0,FINESTEERING,1449,446982.000,02000008,b42b,3044;2.3386,1.9 856,0.9407,1.5528,1.2355,10.0,11,21,58,6,7,10,16,18,24,26,29,41*85f8338b
Field
Field type
1
RTKDOP header
2
GDOP
3
PDOP
4
HDOP
5
HTDOP
Description
Format
Binary Bytes
Log header. See Messages on page 25 for more information.
H
Geometric DOP
Float
4
Position DOP
Float
4
Horizontal DOP
Float
4
Horizontal and Time DOP
Float
4
Binary Offset
0
H H+4 H+8 H+12
OEM7 Commands and Logs Reference Manual v10
750
Chapter 3 Logs
Field
Field type
Description
6
TDOP
Time DOP
7
elev mask GPS elevation mask angle
8
#sats
Number of satellites to follow
9
sats
Satellites in use at time of calculation
10
Next satellite offset = H+28+(#sats * 4)
11
xxxx
32-bit CRC (ASCII and Binary only)
12
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Float
4
Float
4
Ulong 4
Ulong 4
Binary Offset H+16 H+20 H+24
H+28
Ulong 4
-
-
H+28+ (#sats * 4)
-
OEM7 Commands and Logs Reference Manual v10
751
Chapter 3 Logs
3.145 RTKDOP2
DOP values for the satellites used in the RTK solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The RTKDOP2 log contains the Dilution Of Precision (DOP) values for the satellites being used in the RTK solution. This log is similar to the RTKDOP log (see page 750) but contains the per-system TDOPs; see the RTKDOP log on page 750 for more information on the DOPs.
Message ID: 1172
Log Type: Synch
Recommended Input: log rtkdop2a ontime 10
ASCII Example: #RTKDOP2A,COM1,0,80.0,FINESTEERING,1690,601478.000,02000008,ab50,43488;1.5000,1 .1850,0.6580,0.9850,2,GPS,0.6530,GLONASS,0.6490*c5f1a25f
Field Field type
Description
Format
Binary Bytes
1
RTKDOP2 header
Log header. See Messages on page 25 for more information.
H
2
GDOP
Geometric DOP
Float
4
3
PDOP
Position DOP
Float
4
4
HDOP
Horizontal DOP
Float
4
5
VDOP
Vertical DOP
Float
4
6
#systems Number of entries to follow
Ulong 4
7
system
See Table 164: System Used for Timing on the next page
Enum
4
8
TDOP
Time DOP (Dilution of Precision)
Float
4
9
Next satellite offset = H+20+(#systems * 8)
10
xxxx
32-bit CRC (ASCII and Binary only)
11
[CR][LF]
Sentence terminator (ASCII only)
Hex
4
-
-
Binary Offset
0
H H+4 H+8 H+12 H+16
H+20
H+24
H+20+ (#systems * 8) -
OEM7 Commands and Logs Reference Manual v10
752
Chapter 3 Logs
Table 164: System Used for Timing
Binary
ASCII
0
GPS
1
GLONASS
2
GALILEO
3
BEIDOU
4
NAVIC
99
AUTO1
1AUTO is used only as a backup system (not available for primary system field). OEM7 Commands and Logs Reference Manual v10
753
Chapter 3 Logs
3.146 RTKPOS
RTK low latency position data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the low latency RTK position computed by the receiver, along with two status flags. In addition, it reports other status indicators, including differential age, which is useful in predicting anomalous behavior brought about by outages in differential corrections. This log is recommended for kinematic operation. Better accuracy can be obtained in static operation with the MATCHEDPOS log (see page 601). With the system operating in an RTK mode, this log reflects if the solution is a good RTK low latency solution (from extrapolated base station measurements) or invalid. A valid RTK low latency solution is computed for up to 60 seconds after reception of the last base station observation. The degradation in accuracy, due to differential age, is reflected in the standard deviation fields. See also the DGPSTXID command (see page 127).
The RTK system in the receiver provides two kinds of position solutions. The Matched RTK position is computed with buffered observations, so there is no error due to the extrapolation of base station measurements. This provides the highest accuracy solution possible at the expense of some latency which is affected primarily by the speed of the differential data link. The MATCHEDPOS log (see page 601) contains the matched RTK solution and can be generated for each processed set of base station observations. The Low-Latency RTK position is computed from the latest local observations and extrapolated base station observations. This supplies a valid RTK position with the lowest latency possible at the expense of some accuracy. The degradation in accuracy is reflected in the standard deviation. The amount of time that the base station observations are extrapolated is in the "differential age" field of the position log. The Low-Latency RTK system extrapolates for 60 seconds. The RTKPOS log contains the Low-Latency RTK position when valid, and an "invalid" status when a Low-Latency RTK solution could not be computed. The BESTPOS log (see page 433) contains either the low-latency RTK, PPP or pseudorange-based position, whichever has the smallest standard deviation.
Message ID: 141
Log Type: Synch
Recommended Input:
log rtkposa ontime 1
ASCII Example:
#RTKPOSA,COM1,0,54.5,FINESTEERING,1419,340040.000,02000040,176e,2724;SOL_ COMPUTED,NARROW_INT,51.11635911294,-114.03833103654,1063.8336,16.2712,WGS84,0.0179,0.0096,0.0174,"AAAA",1.000,0.000,12,11,11,11,0,01,0,33*0ad b3e47
OEM7 Commands and Logs Reference Manual v10
754
Chapter 3 Logs
Consider the case of a racing car, on a closed circuit, requiring RTK operation. In this situation, you would have to send live data to the pits using a radio link.
RTK operation enables live centimeter level position accuracy. When answers are required in the field, the base station must transmit information to the rover in real-time. For RTK operation, extra equipment such as radios are required to transmit and receive this information. The base station has a corresponding base radio and the rover station has a corresponding rover radio.
Post-processing can provide post-mission position and velocity data using raw GNSS data collected from the car. The logs necessary for post-processing include:
RANGECMPB ONTIME 1 RAWEPHEMB ONNEW
These are examples of data collection for post-processing, and real-time operation. OEM7-based output is compatible with post-processing software from the NovAtel's Waypoint Products Group or refer to our website at www.novatel.com for more details.
Field Field type
Description
1
RTKPOS header
2
sol status
3
pos type
4
lat
5
lon
6
hgt
Log header. See Messages on page 25 for more information.
Solution status (see Table 74: Solution Status on page 436)
Position type (see Table 75: Position or Velocity Type on page 437)
Latitude (degrees)
Longitude (degrees)
Height above mean sea level (m)
Undulation - the relationship between the geoid and the WGS84 ellipsoid (m)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4
Double 8 Double 8 Double 8
H+4
H+8 H+16 H+24
7
undulation
8
datum id#
9
lat
10
lon
When using a datum other than WGS84, the undulation value also includes the vertical shift due to differences between the datum in use and WGS84.
Datum ID number (see Table 29: Datum Transformation Parameters on page 121)
Latitude standard deviation (m)
Longitude standard deviation (m)
Float
4
Enum 4
Float
4
Float
4
H+32
H+36 H+40 H+44
OEM7 Commands and Logs Reference Manual v10
755
Chapter 3 Logs
Field Field type
Description
11
hgt
Height standard deviation (m)
12
stn id
Base station ID
13
diff_age
Differential age in seconds
14
sol_age
Solution age in seconds
15
#SVs
Number of satellites tracked
16
#solnSVs
Number of satellites vehicles used in solution
17
#ggL1
Number of satellites with L1/E1/B1 signals used in solution
18
#solnMultiSVs
Number of satellites with multi-frequency signals used in solution
19
Reserved
20
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Galileo and
Galileo and BeiDou signals used mask (see
21
BeiDou sig
Table 77: Galileo and BeiDou Signal-Used
mask
Mask on page 440)
GPS and
GPS and GLONASS signals used mask (see
22
GLONASS sig Table 76: GPS and GLONASS Signal-Used
mask
Mask on page 439)
23
xxxx
32-bit CRC (ASCII and Binary only)
24
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Float
4
H+48
Char[4] 4
H+52
Float
4
H+56
Float
4
H+60
Uchar 1
H+64
Uchar 1
H+65
Uchar 1
H+66
Uchar 1
Hex
1
Hex
1
H+67 H+68 H+69
Hex
1
H+70
Hex
1
Hex
4
-
-
H+71
H+72 -
OEM7 Commands and Logs Reference Manual v10
756
Chapter 3 Logs
3.147 RTKSATS
Satellites used in RTKPOS solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists the used and unused satellites for the corresponding RTKPOS solution. It also describes the signals of the used satellites and reasons for exclusions.
Message ID: 1174
Log Type: Synch
Recommended Input:
log rtksats ontime 1
Abbreviated ASCII Example:
<RTKSATS COM1 0 60.5 FINESTEERING 1728 524924.000 02000000 95e7 11487 < 24 < GPS 3 GOOD 00000003 < GPS 5 GOOD 00000003 ... < GPS 23 GOOD 00000003 < GPS 30 GOOD 00000003 < GLONASS 1+1 GOOD 00000003 < GLONASS 2-4 GOOD 00000003 ... < GLONASS 20+2 GOOD 00000003 < GLONASS 21+4 GOOD 00000003 < BEIDOU 6 GOOD 00000003 < BEIDOU 11 GOOD 00000003 ... < BEIDOU 12 GOOD 00000003 < BEIDOU 13 GOOD 00000003
Field
Field type
Description
1
RTKSATS Log header. See Messages on page 25 for more header information.
2
#entries Number of records to follow
3
system
Satellite system (refer to Table 105: Satellite System on page 553)
4
Satellite ID
Satellite identifiers
5
Status
Satellite status. See Table 80: Observation Statuses on page 443
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
Enum 4
H+4
Ulong 4
H+8
Enum 4
H+12
OEM7 Commands and Logs Reference Manual v10
757
Chapter 3 Logs
Field
Field type
Description
See Table 81: BESTSATS GPS Signal Mask on
6
Signal mask
page 444, Table 82: BESTSATS GLONASS Signal Mask on page 445, Table 83: BESTSATS Galileo Signal Mask on page 445, and Table 84:
BESTSATS BeiDou Signal Mask on page 445
7
Next satellite offset = H+4+(#sat x 16)
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Hex
4
H+16
Hex
4
-
-
H+4+ (#sat x 16)
-
OEM7 Commands and Logs Reference Manual v10
758
Chapter 3 Logs
3.148 RTKVEL
RTK velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the RTK velocity information computed by the receiver. In addition, it reports a velocity status indicator that is useful in indicating whether or not the corresponding data is valid and differential age is useful in predicting anomalous behavior brought about by outages in differential corrections. The velocity measurements sometimes have a latency associated with them. The time of validity is the time tag in the log minus the latency value.
Velocities from the RTK filter are calculated from the delta-position. In RTKVEL, the velocity type is the same as the position type.
In an RTKVEL log, the actual speed and direction of the receiver antenna over ground is provided. The receiver does not determine the direction a vessel, craft or vehicle is pointed (heading) but rather the direction of motion of the GNSS antenna relative to ground.
With the system operating in an RTK mode, this log reflects if the solution is a good RTK low latency solution (from extrapolated base station measurements) or invalid. A valid RTK low latency solution is computed for up to 60 seconds after reception of the last base station observation. The velocity is computed from consecutive RTK low latency updates. As such, it is an average velocity based on the time difference between successive position computations and not an instantaneous velocity at the RTKVEL time tag. The velocity latency to be subtracted from the time tag is normally half the time between filter updates. Under default operation, the RTK low latency filter is updated at a rate of 2 Hz. This translates into a velocity latency of 0.25 seconds. The latency can be reduced by increasing the update rate of the RTK low latency filter by requesting the BESTVEL, RTKVEL, BESTPOS or RTKPOS messages at a rate higher than 2 Hz. For example, a logging rate of 10 Hz would reduce the velocity latency to 0.05 seconds. For integration purposes, the velocity latency should be applied to the record time tag.
Message ID: 216
Log Type: Synch
Recommended Input: log rtkvela ontime 1
ASCII Example: #RTKVELA,COM1,0,43.5,FINESTEERING,1364,496137.000,02100000,71e2,2310;SOL_ COMPUTED,NARROW_INT,0.250,1.000,0.0027,207.645811,0.0104,0.0*f551cc42
OEM7 Commands and Logs Reference Manual v10
759
Chapter 3 Logs
Consider the case of an unmanned aircraft. A base station must send differential correction data to the remote aircraft. In this type of application, the aircraft's radio may pass the differential solution, for example RTKVEL, to the positioning system so it can process it and generate precise position information for the flight controls.
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
RTKVEL Log header. See Messages on page 25 for more header information.
H
0
2
sol
Solution status, see Table 74: Solution Status on
status page 436
Enum
4
H
3
vel type
Velocity type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+4
A measure of the latency in the velocity time tag in
4
latency seconds. It should be subtracted from the time to Float
4
give improved results
H+8
5
age
Differential age in seconds
Float
4
H+12
6
hor spd
Horizontal speed over ground, in metres per second
Double 8
H+16
7
trk gnd
Actual direction of motion over ground (track over ground) with respect to True North, in degrees
Double 8
H+24
8
vert spd
Vertical speed, in metres per second, where positive values indicate increasing altitude (up) and Double 8 negative values indicate decreasing altitude (down)
H+32
9
Reserved
Float
4
H+40
10
xxxx 32-bit CRC (ASCII and Binary only)
Ulong 4
H+44
11
[CR] [LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
760
Chapter 3 Logs
3.149 RTKXYZ
RTK Cartesian position and velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the receiver's low latency position and velocity in ECEF coordinates. The position and velocity status fields indicate whether or not the corresponding data is valid. See Figure 11: The WGS84 ECEF Coordinate System on page 454 for a definition of the ECEF coordinates. The velocity measurements have a latency associated with them. The time of validity is the time tag in the log minus the latency value. With the system operating in an RTK mode, this log reflects if the solution is a good RTK low latency solution (from extrapolated base station measurements) or invalid. A valid RTK low latency solution is computed for up to 60 seconds after reception of the last base station observation. The degradation in accuracy due to differential age is reflected in the standard deviation fields, and is summarized in the Standards and References section of our website www.novatel.com/support/. See also the DGPSTXID command (see page 127). The velocity is computed from consecutive RTK low latency updates. As such, it is an average velocity based on the time difference between successive position computations and not an instantaneous velocity at the RTKVEL time tag. The velocity latency to be subtracted from the time tag is normally half the time between filter updates. Under default operation, the RTK low latency filter is updated at a rate of 2 Hz. This translates into a velocity latency of 0.25 seconds. The latency can be reduced by increasing the update rate of the RTK low latency filter by requesting the BESTXYZ message at a rate higher than 2 Hz. For example, a logging rate of 10 Hz would reduce the velocity latency to 0.05 seconds. For integration purposes, the velocity latency should be applied to the record time tag. See also the BESTXYZ log on page 452 and MATCHEDXYZ log on page 606.
Message ID: 244
Log Type: Synch
Recommended Input:
log rtkxyza ontime 1
ASCII Example:
#RTKXYZA,COM1,0,56.0,FINESTEERING,1419,340041.000,02000040,3d88,2724;SOL_ COMPUTED,NARROW_INT,-1634531.5666,3664618.0291,4942496.3230,0.0099,0.0219,0.0115,SOL_COMPUTED,NARROW_ INT,0.0030,0.0003,0.0016,0.0198,0.0438,0.0230,"AAAA",0.250,1.000,0.000,12,11,11,11,0,01,0,33*0497 d146
OEM7 Commands and Logs Reference Manual v10
761
Chapter 3 Logs
Field Field type
1
RTKXYZ header
2
P-sol status
3
pos type
4
P-X
5
P-Y
6
P-Z
7
P-X
8
P-Y
9
P-Z
10
V-sol status
11
vel type
12
V-X
13
V-Y
14
V-Z
15
V-X
16
V-Y
17
V-Z
18
stn ID
19
V-latency
20
diff_age
21
sol_age
22
#SVs
23
#solnSVs
Description
Format
Binary Bytes
Binary Offset
Log header. See Messages on page 25 for more information.
H
0
Solution status, see Table 74: Solution Status on page 436
Enum 4
H
Position type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+4
Position X-coordinate (m)
Double 8
H+8
Position Y-coordinate (m)
Double 8
H+16
Position Z-coordinate (m)
Double 8
H+24
Standard deviation of P-X (m)
Float
4
H+32
Standard deviation of P-Y (m)
Float
4
H+36
Standard deviation of P-Z (m)
Float
4
H+40
Solution status, see Table 74: Solution Status on page 436
Enum 4
H+44
Velocity type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+48
Velocity vector along X-axis (m)
Double 8
H+52
Velocity vector along Y-axis (m)
Double 8
H+60
Velocity vector along Z-axis (m)
Double 8
H+68
Standard deviation of V-X (m)
Float
4
H+76
Standard deviation of V-Y (m)
Float
4
H+80
Standard deviation of V-Z (m)
Float
4
H+84
Base station identification
Char[4] 4
H+88
A measure of the latency in the velocity time
tag in seconds. It should be subtracted from Float
4
the time to give improved results
H+92
Differential age in seconds
Float
4
H+96
Solution age in seconds
Float
4
H+100
Number of satellites tracked
Uchar 1
H+104
Number of satellite vehicles used in solution Uchar 1
H+105
OEM7 Commands and Logs Reference Manual v10
762
Chapter 3 Logs
Field Field type
Description
24
#ggL1
Number of satellites with L1/E1/B1 signals used in solution
25
#solnMultiSVs
Number of satellites with multi-frequency signals used in solution
26
Reserved
27
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Galileo and
Galileo and BeiDou signals used mask (see
28
BeiDou sig
Table 77: Galileo and BeiDou Signal-Used
mask
Mask on page 440)
GPS and
GPS and GLONASS signals used mask (see
29
GLONASS sig Table 76: GPS and GLONASS Signal-Used
mask
Mask on page 439)
30
xxxx
32-bit CRC (ASCII and Binary only)
31
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Uchar 1
H+106
Uchar 1
Char
1
Hex
1
H+107 H+108 H+109
Hex
1
H+110
Hex
1
Ulong 4
-
-
H+111
H+112 -
OEM7 Commands and Logs Reference Manual v10
763
Chapter 3 Logs
3.150 RXCONFIG
Receiver configuration
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log is used to output a list of all current command settings. When requested, an RXCONFIG log is output for each setting. See also the LOGLIST log on page 584 for a list of currently active logs. One log is output for each current command.
Message ID: 128
Log Type: Collection
Recommended Input: log rxconfiga once
ASCII Example: #RXCONFIGA,COM1,71,47.5,APPROXIMATE,1337,333963.260,02000000,f702,1984; #ADJUST1PPSA,COM1,71,47.5,APPROXIMATE,1337,333963.260,02000000,f702,1984;OFF,ON CE,0*ba85a20b*91f89b07 #RXCONFIGA,COM1,70,47.5,APPROXIMATE,1337,333963.398,02000000,f702,1984; #ANTENNAPOWERA,COM1,70,47.5,APPROXIMATE,1337,333963.398,02000000,f702,1984;ON*d 12f6135*8f8741be #RXCONFIGA,COM1,69,47.5,APPROXIMATE,1337,333963.455,02000000,f702,1984; #CLOCKADJUSTA,COM1,69,47.5,APPROXIMATE,1337,333963.455,02000000,f702,1984;ENABL E*0af36d92*b13280f2 ... #RXCONFIGA,COM1,7,47.5,APPROXIMATE,1337,333966.781,02000000,f702,1984; #STATUSCONFIGA,COM1,7,47.5,APPROXIMATE,1337,333966.781,02000000,f702,1984;CLEAR ,AUX2,0*a6141e28*d0bba9f2 #RXCONFIGA,COM1,2,47.5,APPROXIMATE,1337,333967.002,02000000,f702,1984; #SBASECUTOFFA,COM1,2,47.5,APPROXIMATE,1337,333967.002,02000000,f702,1984;5.000000000*b9b11096*2e8b77cf #RXCONFIGA,COM1,1,47.5,FINESTEERING,1337,398382.787,02000000,f702,1984; #LOGA,COM1,1,47.5,FINESTEERING,1337,398382.787,02000000,f702,1984;COM1,MARKPOSA ,ONNEW,0.000000,0.000000,NOHOLD*a739272d*6692c084 #RXCONFIGA,COM1,0,47.5,FINESTEERING,1337,400416.370,02000000,f702,1984; #LOGA,COM1,0,47.5,FINESTEERING,1337,400416.370,02000000,f702,1984;COM2,PASSCOM2 A,ONCHANGED,0.000000,0.000000,NOHOLD*55fc0c62*17086d18
OEM7 Commands and Logs Reference Manual v10
764
Chapter 3 Logs
The embedded CRCs are flipped to make the embedded messages recognizable to the receiver. For example, consider the first embedded message above. 91f89b07: 10010001111110001001101100000111
11100000110110010001111110001001:e0d91f89 The CRC is really e0d91f89.
Do not use undocumented commands or logs! Doing so may produce errors and void your warranty.
The RXCONFIG log can be used to ensure your receiver is correctly setup for your application.
Field
Field type
Description
1
RXCONFIG Log header. See Messages on page 25 for
header
more information.
2
e header Embedded header
3
e msg
Embedded message
Embedded (inverted) 32-bit CRC (ASCII and
Binary only). The embedded CRC is inverted
so that the receiver does not recognize the
embedded messages as messages to be
4
e xxxx
output but continues with the RXCONFIG
message. If you wish to use the messages
output from the RXCONFIG log, simply flip
the embedded CRC around for individual
messages
5
xxxx
32-bit CRC (ASCII and Binary only)
6
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
-
h
Varied a
H H+h
Ulong 4
H+h+a
Hex
4
-
-
H+h+a+4 -
OEM7 Commands and Logs Reference Manual v10
765
Chapter 3 Logs
3.151 RXSTATUS
Receiver status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log conveys various status parameters of the GNSS receiver system. These include the Receiver Status and Error words which contain several flags specifying status and error conditions. If an error occurs (shown in the Receiver Error word), the receiver idles all channels, turns off the antenna and disables the RF hardware as these conditions are considered to be fatal errors. The log contains a variable number of status words to allow for maximum flexibility and future expansion. The receiver gives the user the ability to determine the importance of the status bits. In the case of the Receiver Status, setting a bit in the priority mask causes the condition to trigger an error. This causes the receiver to idle all channels, turn off the antenna and disable the RF hardware, the same as if a bit in the Receiver Error word is set. Setting a bit in an Auxiliary Status priority mask causes that condition to set the bit in the Receiver Status word corresponding to that Auxiliary Status. See also the STATUSCONFIG command on page 363.
Field #4, the receiver status word as represented in Table 166: Receiver Status on page 771, is also in Field #8 of the header. See the ASCII Example below and Table 166: Receiver Status on page 771 for clarification. Refer also to the chapter on Built-In Status Tests in the OEM7 Installation and Operation User Manual .
Message ID: 93
Log Type: Asynch
Recommended Input: log rxstatusa onchanged
Abbreviated ASCII Example: #RXSTATUS COM1 0 90.5 FINESTEERING 1740 232531.278 02000020 2AE1 44913 00000000 5 (Receiver Error)
02000020 00000000 00000000 00000000 (Receiver Status) 00040080 00001008 00000000 00000000 (Aux1 Status) 00000000 00000000 00000000 00000000 (Aux2 Status) 02000000 00000000 00000000 00000000 (Aux3 Status) 00000000 00000000 00000000 00000000 (Aux4 Status)
OEM7 Commands and Logs Reference Manual v10
766
Chapter 3 Logs
Receiver errors automatically generate event messages. These event messages are output in RXSTATUSEVENT logs. It is also possible to have status conditions trigger event messages to be generated by the receiver. This is done by setting/clearing the appropriate bits in the event set/clear masks. The set mask tells the receiver to generate an event message when the bit becomes set. Likewise, the clear mask causes messages to be generated when a bit is cleared. See the STATUSCONFIG command on page 363 for details.
If you wish to disable all these messages without changing the bits, simply UNLOG the RXSTATUSEVENT logs on the appropriate ports. See the UNLOG command on page 388.
Field
Field type
Description
1
RXSTATUS Log header. See Messages on page 25 for more
header
information.
2
error
Receiver error (see Table 165: Receiver Error on page 769). A value of zero indicates no errors
Number of status codes (including Receiver
Status). Each status code consists of 4 fields,
the status, priority mask, event set mask and
event clear mask. Each set is repeated for each
3
# stats
status type.
Note that for clarity, the Receiver Status, Auxiliary 1 Status, Auxiliary 2 Status, Auxiliary 3 Status and Auxiliary 4 status are listed separately in this message
4
rxstat
Receiver status word (see Table 166: Receiver Status on page 771)
Receiver status priority mask, which can be set
5
rxstat pri using the STATUSCONFIG command on
page 363
Receiver status event set mask, which can be
6
rxstat set set using the STATUSCONFIG command on
page 363
7
rxstat clear
Receiver status event clear mask, which can be set using the STATUSCONFIG command on page 363
8
aux1stat
Auxiliary 1 status word (see Table 168: Auxiliary 1 Status on page 773)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
Ulong 4
H+4
Ulong 4 Ulong 4 Ulong 4 Ulong 4 Ulong 4
H+8 H+12 H+16 H+20 H+24
OEM7 Commands and Logs Reference Manual v10
767
Chapter 3 Logs
Field
Field type
9
aux1stat pri
10
aux1stat set
11
aux1stat clear
12
aux2stat
13
aux2stat pri
14
aux2stat set
15
aux2stat clear
16
aux3stat
17
aux3stat pri
18
aux3stat set
19
aux3stat clear
20
aux4stat
21
aux4stat pri
Description
Auxiliary 1 status priority mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 1 status event set mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 1 status event clear mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 2 status word (see Table 169: Auxiliary 2 Status on page 775)
Auxiliary 2 status priority mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 2 status event set mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 2 status event clear mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 3 status word (see Table 170: Auxiliary 3 Status on page 776)
Auxiliary 3 status priority mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 3 status event set mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 3 status event clear mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 4 status word (see Table 172: Auxiliary 4 Status on page 778)
Auxiliary 4 status priority mask, which can be set using the STATUSCONFIG command on page 363
Format
Binary Bytes
Binary Offset
Ulong 4
H+28
Ulong 4
H+32
Ulong 4 Ulong 4 Ulong 4
H+36 H+40 H+44
Ulong 4
H+48
Ulong 4 Ulong 4 Ulong 4
H+52 H+56 H+60
Ulong 4
H+64
Ulong 4 Ulong 4 Ulong 4
H+68 H+72 H+76
OEM7 Commands and Logs Reference Manual v10
768
Chapter 3 Logs
Field
Field type
22
aux4stat set
23
aux4stat clear
24
xxxx
25
[CR][LF]
Description
Auxiliary 4 status event set mask, which can be set using the STATUSCONFIG command on page 363
Auxiliary 4 status event clear mask, which can be set using the STATUSCONFIG command on page 363
32-bit CRC (ASCII and Binary only)
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+80
Ulong 4
Ulong 4
-
-
H+84
H+88 -
Table 165: Receiver Error
Nibble Bit
Mask
Description
Bit = 0
Bit =1
Dynamic Random Access Memory (DRAM) status
0 0x00000001 RAM failure on an OEM7 card may also be indicated by a OK Error flashing red LED.
N0
1 0x00000002 Invalid firmware
OK Error
2 0x00000004 ROM status
OK Error
3 0x00000008 Reserved
4 0x00000010 Electronic Serial Number (ESN) access status
OK Error
5 0x00000020 Authorization code status N1
6 0x00000040 Reserved
OK Error
7 0x00000080 Supply voltage status
OK Error
8 0x00000100 Reserved
9
0x00000200
Temperature status (as compared against acceptable limits)
N2
10 0x00000400 MINOS status
OK Error OK Error
PLL RF status. Error with an RF PLL. See AUX2 status bits
11 0x00000800 (Table 169: Auxiliary 2 Status on page 775) for
OK Error
individual PLL status
OEM7 Commands and Logs Reference Manual v10
769
Chapter 3 Logs
Nibble Bit
Mask
Description
12 0x00001000
13 0x00002000 Reserved N3
14 0x00004000
15 0x00008000 NVM status
16 0x00010000 Software resource lim exceeded
17 0x00020000 Model invalid for this receiver N4
18 0x00040000 Reserved
19 0x00080000
20 0x00100000 Remote loading has begun
21 0x00200000 Export restriction N5
22 0x00400000 Safe Mode
23 0x00800000
24 0x01000000
25 0x02000000 N6
26 0x04000000 Reserved
27 0x08000000
28 0x10000000
29 0x20000000 N7
30 0x40000000
31 0x80000000 Component hardware failure
Bit = 0
Bit =1
OK Error OK Error OK Error
No Yes OK Error OK Error
OK Error
OEM7 Commands and Logs Reference Manual v10
770
Chapter 3 Logs
Table 166: Receiver Status
Nibble Bit
Mask
Description
Bit = 0
Bit = 1
0
0x00000001
Error flag, see Table 165: Receiver Error on page 769
No error
Error
1 0x00000002 Temperature status N0
2 0x00000004 Voltage supply status
Within specifications
Warning
OK
Warning
Primary antenna power status
3 0x00000008 See the ANTENNAPOWER command on page 63
Powered
Not powered
4 0x00000010 LNA Failure
OK
Failure
Primary antenna open circuit flag
5 0x00000020 This flag is only available on certain OK products.
Open, antenna disconnected
N1
Primary antenna short circuit flag
6 0x00000040 This flag is only available on certain OK
products.
Short circuit detected
CPU overload flag
7 0x00000080 This flag is only available on certain No overload products.
Overload
COM port transmit buffer overrun.
8
0x00000100
See AUX2 status bits (Table 169: Auxiliary 2 Status on page 775) for
OK
individual COM port status
COM buffer overrun
9 0x00000200 Reserved
10 0x00000400
Link overrun flag N2
This flag indicates if any of the USB,
ICOM, CCOM, NCOM or File ports
are overrun. See AUX1, AUX2 and
11 0x00000800 AUX3 status bits (Table 168: Auxiliary 1 Status on page 773,
No overrun Overrun
Table 169: Auxiliary 2 Status on
page 775 or Table 170: Auxiliary 3
Status on page 776) for the specific
port for which the buffer is overrun.
OEM7 Commands and Logs Reference Manual v10
771
Chapter 3 Logs
Nibble Bit
Mask
Description
Bit = 0
Bit = 1
Input overrun flag
12 0x00001000 This flag is set if any of the receiver ports (COM, USB, ICOM or NCOM) experience an input overrun.
No overrun
Overrun
13 0x00002000 Aux transmit overrun flag
No overrun Overrun
Antenna gain state N3
14 0x00004000 See the AUX3 status bits (Table 170: OK Auxiliary 3 Status on page 776) for
the antenna gain status.
Out of range
Jammer Detected.
15 0x00008000 See the AUX1 status bits (Table 168: OK Auxiliary 1 Status on the next page) for individual RF status
Jammer Detected
16 0x00010000 INS reset flag
No INS reset INS reset
17 0x00020000 IMU communication failure N4
18 0x00040000 GPS almanac flag/UTC known
No error Valid
No IMU communication
Invalid
19 0x00080000 Position solution flag
Valid
Invalid
20
0x00100000
Position fixed flag, see the FIX command on page 166
Not fixed
Fixed
N5
21 0x00200000 Clock steering status
22 0x00400000 Clock model flag
Enabled Valid
Disabled Invalid
23 0x00800000 External oscillator locked flag
Unlocked
Locked
24 0x01000000 Software resource
OK
Warning
25
Version bit 0
N6
0x06000000
26
Version bit 1
See Table 167: Version Bits on the next page
See Table 167: Version Bits on the next page
27 0x08000000 Tracking mode
Normal tracking
HDR tracking
28 0x10000000 Digital Filtering Enabled
Disabled
Enabled
29 0x20000000 Auxiliary 3 status event flag N7
30 0x40000000 Auxiliary 2 status event flag
No event No event
Event Event
31 0x80000000 Auxiliary 1 status event flag
No event
Event
OEM7 Commands and Logs Reference Manual v10
772
Chapter 3 Logs
Bit 25 0 1 0 1
Bit 26 0 0 1 1
Table 167: Version Bits Description
Interpret Status/Error Bits as OEM6 or earlier format Interpret Status/Error Bits as OEM7 format Reserved for a future version Reserved for a future version
Nibble Bit
Mask
Table 168: Auxiliary 1 Status Description
0 0x00000001 Jammer detected on RF1
1 0x00000002 Jammer detected on RF2 N0
2 0x00000004 Jammer detected on RF3
3 0x00000008 Position averaging
4 0x00000010 Jammer detected on RF4
5 0x00000020 Jammer detected on RF5 N1
6 0x00000040 Jammer detected on RF6
7 0x00000080 USB connection status
8 0x00000100 USB1 buffer overrun flag
9 0x00000200 USB2 buffer overrun flag N2
10 0x00000400 USB3 buffer overrun flag
11 0x00000800 Reserved
Bit = 0 Bit = 1
OK
Jammer detected
OK
Jammer detected
OK
Jammer detected
Off
On
OK
Jammer detected
OK
Jammer detected
OK
Jammer detected
Connected
Not connected
No overrun
Overrun
No overrun
Overrun
No overrun
Overrun
OEM7 Commands and Logs Reference Manual v10
773
Chapter 3 Logs
Nibble Bit
Mask
Description
12 0x00001000 Profile Activation Bit
13 0x00002000 Throttled Ethernet Reception N3
14 0x00004000 Reserved
15 0x00008000 Reserved
16 0x00010000 Reserved
17 0x00020000 Reserved
N4
18 0x00040000 Ethernet not connected
19 0x00080000 ICOM1 buffer overrun flag
20 0x00100000 ICOM2 buffer overrun flag
21 0x00200000 ICOM3 buffer overrun flag N5
22 0x00400000 NCOM1 buffer overrun flag
23 0x00800000 NCOM2 buffer overrun flag
24 0x01000000 NCOM3 buffer overrun flag
N6
25 0x02000000 Reserved
26 0x04000000 Reserved
27 0x08000000 Reserved
28 0x10000000 Reserved
29 0x20000000 Reserved
30 0x40000000 Reserved
N7
IMU measurement outlier detected.
Indicates when the SPAN system has
31 0x80000000 detected an outlier in the IMU performance.
May be treated as a notice unless the issue
persists.
Bit = 0 OK OK
Bit = 1 Error Throttled
Connected
Not connected
No overrun
Overrun
No overrun
Overrun
No overrun
Overrun
No overrun
Overrun
No overrun
Overrun
No overrun
Overrun
OK
Outlier detected
OEM7 Commands and Logs Reference Manual v10
774
Chapter 3 Logs
Nibble Bit
Mask
Table 169: Auxiliary 2 Status
Description
Bit = 0
Bit = 1
0 0x00000001 SPI Communication Failure 1 0x00000002 I2C Communication Failure
OK
Error
OK
Error
N0
2 0x00000004 COM4 buffer overrun flag
No overrun
Buffer Overrun
3 0x00000008 COM5 buffer overrun flag
No overrun
Buffer Overrun
4 0x00000010 Reserved
5 0x00000020 Reserved N1
6 0x00000040 Reserved
7 0x00000080 Reserved
8 0x00000100 Reserved
9 0x00000200 COM1 buffer overrun flag N2
10 0x00000400 COM2 buffer overrun flag
OK
Buffer Overrun
OK
Buffer Overrun
11 0x00000800 COM3 buffer overrun flag
OK
Buffer Overrun
12 0x00001000 PLL RF1 unlock flag
OK
PLL Unlock
13 0x00002000 PLL RF2 unlock flag N3
14 0x00004000 PLL RF3 unlock flag
OK
PLL Unlock
OK
PLL Unlock
15 0x00008000 PLL RF4 unlock flag
OK
PLL Unlock
16 0x00010000 PLL RF5 unlock flag
OK
PLL Unlock
17 0x00020000 PLL RF6 unlock flag N4
18 0x00040000 CCOM1 buffer overrun
OK
PLL Unlock
OK
Buffer Overrun
19 0x00080000 CCOM2 buffer overrun
OK
Buffer Overrun
20 0x00100000 CCOM3 buffer overrun
OK
Buffer Overrun
21 0x00200000 CCOM4 buffer overrun N5
22 0x00400000 CCOM5 buffer overrun
OK
Buffer Overrun
OK
Buffer Overrun
23 0x00800000 CCOM6 buffer overrun
OK
Buffer Overrun
OEM7 Commands and Logs Reference Manual v10
775
Chapter 3 Logs
Nibble Bit
Mask
Description
24 0x01000000 ICOM4 buffer overrun
25 0x02000000 ICOM5 buffer overrun N6
26 0x04000000 ICOM6 buffer overrun
27 0x08000000 ICOM7 buffer overrun
Secondary antenna power status 28 0x10000000 See the ANTENNAPOWER
command (see page 63)
Secondary antenna open circuit
29 0x20000000 This flag is only available on certain
N7
products
Secondary antenna short circuit 30 0x40000000 This flag is only available on certain
products
31 0x80000000 Reset loop detected
Bit = 0
Bit = 1
OK
Buffer Overrun
OK
Buffer Overrun
OK
Buffer Overrun
OK
Buffer Overrun
Powered Not Powered
OK
Open, antenna disconnected
OK
Short circuit detected
OK
Reset Detected
Table 170: Auxiliary 3 Status
Nibble Bit
Mask
Description
SCOM buffer overrun flag. 0 0x00000001 This flag is set if any of the SCOM ports
(SCOM1 � SCOM4) experience overrun.
N0
1 0x00000002 WCOM1 buffer overrun flag
2 0x00000004 FILE buffer overrun flag
3 0x00000008 Reserved
4 0x00000010 Antenna 1 Gain State
5 0x00000020 N1
6 0x00000040 Antenna 2 Gain State
7 0x00000080
8 0x00000100
9 0x00000200
N2
Reserved
10 0x00000400
11 0x00000800
Bit = 0
Bit = 1
No overrun
Overrun
No overrun
No overrun
Overrun Overrun
Table 171: Antenna Gain State on the next page
Table 171: Antenna Gain State on the next page
OEM7 Commands and Logs Reference Manual v10
776
Chapter 3 Logs
Nibble Bit
Mask
Description
Bit = 0
Bit = 1
12 0x00001000
13 0x00002000
N3
Reserved
14 0x00004000
15 0x00008000
16 0x00010000
17 0x00020000
N4
Reserved
18 0x00040000
19 0x00080000
20 0x00100000
21 0x00200000
N5
Reserved
22 0x00400000
23 0x00800000
24 0x01000000
25 0x02000000
N6
Reserved
26 0x04000000
27 0x08000000
28 0x10000000 Reserved
29
0x20000000 Web content is corrupt or does not exist
Content is OK
Error with content
N7
30
0x40000000
RF Calibration Data is present and in error
Data is OK
Data has an error
31 0x80000000 RF Calibration Data is present
No data found
Data exists and has no errors
Table 171: Antenna Gain State
Bits 4-5 or
Bits 6-7
Description
00
Antenna Gain in range
OEM7 Commands and Logs Reference Manual v10
777
Chapter 3 Logs
Bits 4-5 or
Bits 6-7
Description
Antenna Gain Low
01
This state indicates that the input signal is very weak (under -160 dBm/Hz). It can
indicate the antenna is not operating correctly, the antenna is not suitable for NovAtel
receivers, or there is no antenna connected.
Antenna Gain High.
10
This state indicates that the input signal is very strong (above -120 dBm/Hz). This can
be caused by a strong in-band interference or by too much signal gain or too many LNAs
cascaded in the path.
Antenna Gain Anomaly.
11
This state indicates that an anomaly has been detected for the input signal. It can be
caused by strong in-band or out-of-band interference, or by the antenna being
disconnected/changed during operation.
Nibble Bit
Mask
Table 172: Auxiliary 4 Status Description
0 0x00000001
GNSS Tracked Status
N0
1 0x00000002
2 0x00000004 Reserved
3 0x00000008
4 0x00000010
5 0x00000020
N1
Reserved
6 0x00000040
7 0x00000080
8 0x00000100
9 0x00000200
N2
Reserved
10 0x00000400
11 0x00000800
Bit = 1
<60% of available satellites are tracked well
<15% of available satellites are tracked well
OEM7 Commands and Logs Reference Manual v10
778
Chapter 3 Logs
Nibble Bit
Mask
Description
Bit = 1
12
0x00001000
Clock freewheeling due to bad position integrity
Clock freewheeling
13 0x00002000 Reserved
N3
14 0x00004000 Usable RTK Corrections
<60% of expected corrections available
Percentage of expected measurements which
have timely RTK corrections (latency <20 15 0x00008000 seconds)
<15% of expected corrections available
16 0x00010000 Bad RTK Geometry
PDOP >5.0
17 0x00020000
N4
Reserved
18 0x00040000
19 0x00080000 Long RTK Baseline
Baseline >50 km
20 0x00100000 Poor RTK COM Link (poor correction quality)
Corrections quality 60%
N5
21
0x00200000 Poor ALIGN COM Link (poor correction quality)
Corrections quality 60%
22 0x00400000 GLIDE Not Active
GLIDE not active
23 0x00800000 Bad PDP Geometry
PDOP >5.0
24 0x01000000 No TerraStar Subscription
No subscription
25 0x02000000 N6
26 0x04000000 Reserved
27 0x08000000
28 0x10000000 Bad PPP Geometry
PDOP >5.0
29 0x20000000 Reserved N7
30 0x40000000 No INS Alignment
No alignment
31 0x80000000 INS not converged
Not converged
Only GPS and GLONASS are considered in the Auxiliary 4 status word states.
For bits relating to RTK, ALIGN or INS, the bits will only be set if the receiver has that type of positioning is enabled via Auth Code.
OEM7 Commands and Logs Reference Manual v10
779
Chapter 3 Logs
3.152 RXSTATUSEVENT
Status event indicator
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log is used to output event messages as indicated in the RXSTATUS log (see page 766). An event message is automatically generated for all receiver errors, which are indicated in the receiver error word. In addition, event messages can be generated when other conditions, which are indicated in the receiver status and auxiliary status words, are met. Whether or not an event message is generated under these conditions is specified using the STATUSCONFIG command (see page 363). On start-up, the receiver is set to log RXSTATUSEVENTA ONNEW HOLD on all ports. You can remove this message using the UNLOG command (see page 388). To remove this log using an UNLOGALL command (see page 390), you must use the True option. Logging RXSTATUSEVENT on all ports is a factory default setting. If it is unlogged, the RXSTATUSEVENT log will not be collected until the next start-up. After a start-up, logging RXSTATUSEVENT on all ports will start again.
See also the chapter on Built-In Status Tests in the OEM7 Installation and Operation User Manual.
Message ID: 94
Log Type: Asynch
Recommended Input: log rxstatuseventa onchanged
ASCII Example 1: #RXSTATUSEVENTA,COM1,0,17.0,FREEWHEELING,1337,408334.510,02480000,b967,1984;STA TUS,19,SET,"No Valid Position Calculated"*6de945ad
ASCII Example 2: #RXSTATUSEVENTA,COM1,0,41.0,FINESTEERING,1337,408832.031,03000400,b967,1984;STA TUS,10,SET,"COM3 Transmit Buffer Overrun"*5b5682a9
When a fatal event occurs (for example, in the event of a receiver hardware failure), a bit is set in the receiver error word, part of the RXSTATUS log (see page 766) to indicate the cause of the problem. Bit 0 is set in the receiver status word to show that an error occurred, the error strobe is driven high and the LED flashes red and yellow showing an error code. An RXSTATUSEVENT log is generated on all ports to show the cause of the error. Receiver tracking is disabled at this point but command and log processing continues to allow you to diagnose the error. Even if the source of the error is corrected at this point, the receiver must be reset to resume normal operation.
OEM7 Commands and Logs Reference Manual v10
780
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
RXSTATUSEVENT Log header. See Messages on page 25 for
header
more information.
H
0
2
word
The status word that generated the event
message (see Table 173: Status Word
Enum 4
H
below)
3
bit position
Location of the bit in the status word (see
Table 166: Receiver Status on page 771,
Table 168: Auxiliary 1 Status on page 773, Table 169: Auxiliary 2 Status
Ulong
4
on page 775 or Table 170: Auxiliary 3
Status on page 776
H+4
4
event
Event type (see Table 174: Event Type below)
Enum 4
H+8
5
description
This is a text description of the event or error
Char [32]
32
H+12
6
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+44
7
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
Table 173: Status Word
Binary ASCII
Description
Receiver Error word,
0
ERROR
see Table 165: Receiver Error on page 769
Receiver Status word,
1
STATUS
see Table 166: Receiver Status on page 771
Auxiliary 1 Status word,
2
AUX1
see Table 168: Auxiliary 1 Status on page 773
Auxiliary 2 Status word
3
AUX2
see Table 169: Auxiliary 2 Status on page 775
Auxiliary 3 Status word
4
AUX3
see Table 170: Auxiliary 3 Status on page 776
Table 174: Event Type
Binary ASCII Description
0
CLEAR Bit was cleared
1
SET
Bit was set
OEM7 Commands and Logs Reference Manual v10
781
Chapter 3 Logs
3.153 SAFEMODESTATUS
Safe Mode Status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides additional information about the state of the receiver in the event that the Safe Mode error bit and/or Reset Loop Detected status bit are set in the RXSTATUS log (see page 766). The data within this log is set at receiver start up and will not change over time.
Message ID: 2060
Log Type: Asynch
Recommended Input: log SAFEMODESTATUSA once
Abbreviated ASCII Example: #SAFEMODESTATUSA,COM1,0,89.0,UNKNOWN,0,0.000,024c0020,8e55,32768;SAFE_MODE_ OK,0,"Normal Operation."*29c7d28a
Field
Field Type
Description
Binary Binary Binary Format Bytes Offset
1
SAFEMODESTATUS Log header. See Messages on page 25
header
for more information.
-
H
0
2
Status
Safe Mode State. See Table 175: Safe Mode States on the next page
Enum
4
H
3
Reset Count
Number of resets since power up or a successful boot
Ulong
4
H+4
4
Description
String for additional information about the Safe Mode State
String
80
H+8
5
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+88
6
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
782
Chapter 3 Logs
Table 175: Safe Mode States
Value
State
Safe Mode Error
Bit
Reset Loop Detected
Bit
Notes
Recovery Steps
0
SAFE_MODE_OK 0
0
Normal Operation. No reset loop detected.
No action required
1
SAFE_MODE_ WARNING
0
1
An unexpected reset was detected. The receiver will operate as normal
No action required
SAFE_MODE_
2
DISABLE_
0
1
SATELLITE_DATA
Satellite Navigation Data previously saved to NVM is ignored in this state. As the receiver continues to track GNSS satellites, new data will be downloaded. There may be some delay in initial satellite acquisition as this will effectively be a Cold Start, but the receiver will otherwise operate as normal.
No action required
SAFE_MODE_
DISABLE_
3
NON_
1
1
COMMUNICATION_
NVM
All data previously saved to NVM that is not related to communication is ignored in this state.
Communication ports (COM, USB, ICOM, etc.) will remain in the configuration previously saved by SAVECONFIG allowing the user to take corrective action.
Depending on what NVM data is causing the problem, a FRESET may resolve the issue.
If a standard FRESET does not resolve the issue, see the FRESET command on page 179 for other NVM targets that may be causing the issue and could be removed.
OEM7 Commands and Logs Reference Manual v10
783
Chapter 3 Logs
Value
State
SAFE_MODE_
4
DISABLE_
ALL_NVM
SAFE_MODE_
5
DISABLE_
AUTH
6
SAFE_MODE_ FAILED
SAFE_MODE_
7
UNEXPECTED_
MAIN_FIRMWARE
Safe Mode Error
Bit
Reset Loop Detected
Bit
Notes
1
1
All data previously saved to NVM is ignored in this state.
1
1
All data previously saved to NVM and all Auth Codes are ignored in this state.
1
1
All data previously saved to NVM and all Auth Codes are ignored in this state.
An error related to main
1
0 or 1
firmware loading
occurred.
Recovery Steps
See recovery steps for SAFE_MODE_ DISABLE_ NON_ COMMUNICATION_ NVM.
Use the AUTH REMOVE command to remove the offending Auth Code. The AUTHCODES log (see page 419) can be used to determine what Auth Codes are currently loaded.
This state is unexpected. The recovery steps for other states may apply.
Reload the main firmware.
OEM7 Commands and Logs Reference Manual v10
784
Chapter 3 Logs
3.154 SATVIS2
Satellite visibility
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains satellite visibility data for all available systems with additional satellite and satellite system information. One log is output for each available satellite system.
1. The SATVIS2 log is meant to provide a brief overview. The satellite positions and velocities used in the computation of this log are based on Almanac orbital parameters, not the higher precision Ephemeris parameters.
2. In the SATVIS2 log output, there may be double satellite number entries. These are GLONASS antipodal satellites in the same orbit plane separated by 180 degrees latitude. Refer to the GLONASS section of An Introduction to GNSS available on our website.
3. The SATVIS2 log is generated every 10 seconds. If the log is requested at a faster rate than ontime 10, it will only be output every 10 seconds.
Message ID: 1043
Log Type: Asynch
Recommended Input: log satvis2a onchanged
Abbreviated ASCII Example: <SATVIS2 COM1 5 70.0 FINESTEERING 1729 166550.000 02000000 a867 44263 < GPS TRUE TRUE 31 < 32 0 71.1 177.8 -1183.650 -1184.441 < 20 0 66.2 265.9 462.684 461.894 ... < 26 0 -78.7 246.3 805.272 804.481 < 9 0 -79.0 7.3 -930.480 -931.271
<SATVIS2 COM1 4 70.0 FINESTEERING 1729 166550.000 0200000 a867 44263 < GLONASS TRUE TRUE 24 < 3+5 0 75.2 326.1 1088.078 1087.272 < 13-2 0 61.4 188.2 2243.727 2242.923 ... < 9-2 0 -72.3 6.3 -1384.534 -1385.337 < 7+5 0 -81.2 146.3 -666.742 -667.548
<SATVIS2 COM1 0 70.0 FINESTEERING 1729 166550.000 02000000 a867 44263 < BEIDOU TRUE TRUE 14 < 11 0 2.6 342.2 -711.023 -711.807 < 12 0 -5.0 297.0 -2407.877 -2408.661 ... < 10 216 -79.3 254.5 122.316 121.532 < 13 216 -81.5 51.2 76.611 75.827
OEM7 Commands and Logs Reference Manual v10
785
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
SATVIS2 Log header. See Messages on page 25 for more header information.
H
0
2
Satellite GNSS satellite system identifier. See Table 105: System Satellite System on page 553
Enum
4
H
Is satellite visibility valid?
3
sat vis
0 = FALSE
1 = TRUE
Enum 4
H+4
Was complete GNSS almanac used?
4
almanac flag
0 = FALSE
1 = TRUE
Enum 4
H+8
5
#sat
Number of satellites with data to follow
Ulong 4
H+12
In binary logs, the satellite ID field is 4 bytes. The
2 lowest order bytes, interpreted as a USHORT,
are the system identifier: for instance, the PRN
for GPS or the slot for GLONASS. The 2 highest-
order bytes are the frequency channel for
GLONASS, interpreted as a SHORT and zero for all
6
Satellite ID
other systems. In ASCII and abbreviated ASCII logs, the satellite ID field is the system identifier.
Ulong
4
If the system is GLONASS and the frequency
channel is not zero, then the signed channel is
appended to the system identifier. For example,
slot 13, frequency channel -2 is output as 13-2
For more information, refer to PRN Numbers on page 44
H+16
Satellite health
7
health
Satellite health values may be found in the applicable Interface Control Document for each system.
Ulong 4
8
elev
9
az
Elevation (degrees) Azimuth (degrees)
Double 8 Double 8
H+20
H+24 H+32
OEM7 Commands and Logs Reference Manual v10
786
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
Theoretical Doppler of satellite - the expected
10
true Doppler
Doppler frequency based on a satellite's motion relative to the receiver. It is computed using the satellite's coordinates and velocity along with the
Double
8
receiver's coordinates and velocity (Hz)
H+40
11
apparent Doppler
Apparent Doppler for this receiver - the same as Theoretical Doppler above but with clock drift correction added (Hz)
Double 8
H+48
12
Next satellite offset = H + 16 + (#sat x 40)
13
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+16+ (#sat x 40)
14
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
787
Chapter 3 Logs
3.155 SATXYZ2
Satellite positions in ECEF Cartesian coordinates
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
When combined with a RANGE log, this data set contains the decoded satellite information necessary to compute the solution: satellite coordinates (ECEF WGS84), satellite clock correction, ionospheric corrections and tropospheric corrections. See the calculation examples in the usage box below. Only those satellites used in the corresponding PSRPOS solution are reported here. See also Figure 11: The WGS84 ECEF Coordinate System on page 454.
Message ID: 1451
Log Type: Synch
Recommended Input: log satxyz2 ontime 1
Abbreviated ASCII Example: <SATXYZ2 COM1 0 83.5 FINESTEERING 1686 489605.000 02000040 7513 43391 < 18 < GPS 1 -15502299.3828 1012325.6443 21538404.8435 76246.262 6.990 3.395 0.0 0.0 < GPS 19 -25806091.5135 -6923139.1454 1709844.1975 -78547.421 5.734 9.238 0.0 0.0 < GPS 12 20368857.0090 -5772890.2153 15912912.0724 20118.104 2.415 12.239 0.0 0.0
...
< GLONASS 23+3 -22246787.0962 -4287240.2873 11721201.0046 -116210.453 6.928 4.205 0.0 0.0 < GLONASS 7+5 4586441.8834 -14896106.2729 20222034.1193 -6061.174 1.636 2.529 0.0 0.0 < GLONASS 8+6 -12121452.4145 -4467306.1322 21995556.9720 -7165.609 0.350 2.586 0.0 0.0
OEM7 Commands and Logs Reference Manual v10
788
Chapter 3 Logs
The OEM7 family defines ionospheric and tropospheric corrections positively which means that ionospheric and tropospheric corrections are added to the geometric ranges or subtracted from the measured pseudoranges. A positive clock offset indicates the clock is running ahead of the reference time. For example:
P = p + pd + c(dT - dt) + d(ion) + d(trop) + Ep
is equivalent to
P - c(dT - dt) - d(ion) - d(trop) = p + pd + Ep
where
P = measured pseudorange p = geometric range pd = orbit error dt = satellite clock offset dT = receiver clock offset d (ion) = ionospheric delay d (trop) = tropospheric delay c = speed of light Ep = noise and multipath
Note that when dual frequency ionosphere corrections are used, the corrections include receiver biases. Consequently, the correction does not provide a measure of the ionosphere delay in an absolute sense.
Field
Field Type
Description
1
SATXYZ2 Log header. See Messages on page 25 for
header
more information.
2
#sat
Number of satellites to follow
3
System
Satellite system (refer to Table 105: Satellite System on page 553)
4
Satellite ID
Satellite ID
5
X
Satellite X co-ordinates (ECEF,m)
6
Y
Satellite Y co-ordinates (ECEF,m)
7
Z
Satellite Z co-ordinates (ECEF,m)
8
clk corr Satellite clock correction (m)
9
iono delay Ionosphere delay (m)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Enum 4
H+4
Ulong 4
Double 8 Double 8 Double 8 Double 8 Double 8
H+8
H+12 H+20 H+28 H+36 H+44
OEM7 Commands and Logs Reference Manual v10
789
Chapter 3 Logs
Field
Field Type
10
tropo delay
Description Troposphere delay (m)
11
Reserved1
12
Reserved2
13
Next satellite offset = H+4+(#sat x 72)
14
xxxx
32-bit CRC (ASCII and Binary only)
15
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+52
Double 8 Double 8
H+60 H+68
Ulong 4
H+4+ (#sat x 72)
OEM7 Commands and Logs Reference Manual v10
790
Chapter 3 Logs
3.156 SAVEDSURVEYPOSITIONS
Saved surveyed positions
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log lists the surveyed positions saved on the receiver. A surveyed position is saved using the AUTOSURVEY command (see page 79) or SURVEYPOSITION command (see page 368).
Message ID: 1951
Log Type: Polled
Recommended Input: log savedsurveypositions once
Abbreviated ASCII Example:
<SAVEDSURVEYPOSITIONS COM1 0 82.5 FINESTEERING 2003 313938.731 02000008 ddf2
32768
<
3
<
"MN01" 51.00000000000 100.00000000000 150.0000
<
"TST1" 90.00000000000 90.00000000000 90.0000
<
"MON1" 45.00000000000 45.00000000000 45.0000
Field Field Type
Description
1
SAVEDSURVEY POSITIONS header
Log header. See Messages on page 25 for more information.
2
#Positions
Number of records to follow.
ID for the saved position.
Note: In the Binary case, the ID string
3
Position ID
must be null terminated and additional
bytes of padding must be added to
make the total length of the field 8
bytes.
4
Latitude
Latitude of the position
(-90 to 90 degrees) where a `-' sign denotes south and a `+' sign denotes north
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
String 8
H+4
Double 8
H+12
OEM7 Commands and Logs Reference Manual v10
791
Chapter 3 Logs
Field Field Type
5
Longitude
6
Height
Description
Format
Binary Bytes
Binary Offset
Longitude of the position
(-360 to 360 degrees) where a `-' sign denotes west and a `+' sign denotes east
Double 8
H+20
Mean Sea Level height of the position in metres
Double
8
H+28
7
Next reading offset = H+4+(#Positions * 32)
8
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+4+ (#Positions * 32)
9
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
792
Chapter 3 Logs
3.157 SBAS0
Do not use for safety applications
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This message specifies the PRN if GEO transmitting SBAS corrections is operating in test mode, and should not be used for safety applications for a period of time outlined in the SBAS signal specification.
The GEO transmitting SBAS corrections is operating in test mode, and should not be used for safety-of-life applications.
See how the SBAS0 message relates to the SBAS testing modes in the SBASCONTROL command on page 324.
Message ID: 976
Log Type: Asynch
Recommended Input: log SBAS0a onchanged
ASCII Example: #SBAS0A,COM1,0,68.5,SATTIME,1093,161299.000,02040020,7d6a,209;122*e9a5ab08
Although the SBAS was designed for aviation users, it supports a wide variety of non-aviation uses including agriculture, surveying, recreation, and surface transportation.
Field
Field type
1
SBAS0 header
2
prn
3
xxxx
4
[CR][LF]
Description
Log header. See Messages on page 25 for more information. Source PRN message - also PRN not to use 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
H
Ulong 4
Ulong 4
-
-
Binary Offset
0
H H+4 -
OEM7 Commands and Logs Reference Manual v10
793
Chapter 3 Logs
3.158 SBAS1
PRN mask assignments
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The PRN mask is given in SBAS1. The transition of the PRN mask to a new one (which will be infrequent) is controlled with the 2-bit IODP, which sequences to a number between 0 and 3. The same IODP appears in the applicable SBAS2, SBAS3, SBAS4, SBAS5, SBAS7, SBAS24 and SBAS25 messages (SBAS32, SBAS33, SBAS34, SBAS35 and SBAS45). This transition would probably only occur when a new satellite is launched or when a satellite fails and is taken out of service permanently. A degraded satellite may be flagged as a "don't use" satellite temporarily.
Message ID: 977
Log Type: Asynch
Recommended Input: log SBAS1a onchanged
ASCII Example: #SBAS1A,COM1,0,24.5,SATTIME,1337,415802.000,02000000,5955,1984;134,ffeffffe0000 000000000000000000400400000000000000000000,2*3633cf7b
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS1 message can be logged to view the data breakdown of SBAS frame 1 which contains information about the PRN mask assignment.
Field
Field type
1
SBAS1 header
2
prn
Description
Log header. See Messages on page 25 for more information. Source PRN of message
3
mask
PRN bit mask
4
iodp
Issue of PRN mask data
5
xxxx
32-bit CRC (ASCII and Binary only)
6
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
H
0
Ulong Uchar [27] Ulong Ulong -
4 28 1
4 4 -
H H+4 H+32 H+36 -
1In the binary log case, an additional 1 byte of padding is added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
794
Chapter 3 Logs
3.159 SBAS2
Fast correction slots 0-12
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS2 are fast corrections for slots 0-12 in the mask of SBAS1. This message may or may not come when SBAS is in testing mode (see the SBASCONTROL command on page 324 for details).
Message ID: 982
Log Type: Asynch
Recommended Input: log SBAS2a onchanged
ASCII Example: #SBAS2A,COM1,0,29.0,SATTIME,1337,415925.000,02000000,e194,1984;134,2,2,3,3,5,1,2047,-2,2047,2047,2047,2047,2047,3,2,5,11,7,8,14,8,14,14,14,14,14,6,12*8d8d2e1c
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS2 message can be logged to view the data breakdown of SBAS frame 2 which contains information about fast correction slots 0-12.
Field
Field type
1
SBAS2 header
2
prn
3
iodf
4
iodp
Description
Log header. See Messages on page 25 for more information. Source PRN of message Issue of fast corrections data Issue of PRN mask data
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Ulong 4 Ulong 4
H H+4 H+8
OEM7 Commands and Logs Reference Manual v10
795
Chapter 3 Logs
Field
Field type
5
prc0
6
prc1
7
prc2
8
prc3
9
prc4
10
prc5
11
prc6
12
prc7
13
prc8
14
prc9
15
prc10
16
prc11
17
prc12
18
udre0
19
udre1
20
udre2
21
udre3
22
udre4
23
udre5
24
udre6
25
udre7
26
udre8
27
udre9
28
udre10
29
udre11
30
udre12
31
xxxx
32
[CR] [LF]
Description
prc(i): Fast corrections (-2048 to +2047) for the PRN in slot i (i = 0-12)
udre(i): User differential range error indicator for the PRN in slot i (i = 0-12) See Table 176: Evaluation of UDREI on the next page for scaling information.
32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Long
4
H+12
Long
4
H+16
Long
4
H+20
Long
4
H+24
Long
4
H+28
Long
4
H+32
Long
4
H+36
Long
4
H+40
Long
4
H+44
Long
4
H+48
Long
4
H+52
Long
4
H+56
Long
4
H+60
Ulong 4
H+64
Ulong 4
H+68
Ulong 4
H+72
Ulong 4
H+76
Ulong 4
H+80
Ulong 4
H+84
Ulong 4
H+88
Ulong 4
H+92
Ulong 4
H+96
Ulong 4
H+100
Ulong 4
H+104
Ulong 4
H+108
Ulong 4
H+112
Ulong 4
H+116
-
-
-
OEM7 Commands and Logs Reference Manual v10
796
Chapter 3 Logs
Table 176: Evaluation of UDREI UDREI 1 UDRE metres 2 i.udre metres2
0
0.75
1
1.0
0.0520 0.0924
2
1.25
3
1.75
0.1444 0.2830
4
2.25
5
3.0
6
3.75
0.4678 0.8315 1.2992
7
4.5
8
5.25
1.8709 2.5465
9
6.0
10
7.5
3.3260 5.1968
11
15.0
12
50.0
20.7870 230.9661
13
150.0
2078.695
14
Not Monitored Not Monitored
15
Do Not Use
Do Not Use
1The s2UDRE broadcast in SBAS2, SBAS3, SBAS4, SBAS5, SBAS6 and SBAS24 applies at a time prior to or at the time of applicability of the associated corrections.
OEM7 Commands and Logs Reference Manual v10
797
Chapter 3 Logs
3.160 SBAS3
Fast corrections slots 13-25
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS3 are fast corrections for slots 13-25 in the mask of SBAS1.
Message ID: 987
Log Type: Asynch
Recommended Input: log SBAS3a onchanged
ASCII Example: #SBAS3A,COM1,0,17.0,SATTIME,1337,415990.000,02000000,bff5,1984;134,1,2,2047,0,2 047,2047,-21,-4,2047,2047,1,0,2,2047,6,14,5,14,14,11,5,14,14,5,7,5,14,8*a25aebc5
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS3 message can be logged to view the data breakdown of SBAS frame 3 which contains information about fast correction slots 13-25.
Field
Field type
1
SBAS3 header
2
prn
3
iodf
4
iodp
Description
Format
Binary Bytes
Log header. See Messages on page 25 for more information.
H
Source PRN of message
Ulong 4
Issue of fast corrections data
Ulong 4
Issue of PRN mask data
Ulong 4
Binary Offset
0
H H+4 H+8
OEM7 Commands and Logs Reference Manual v10
798
Chapter 3 Logs
Field
Field type
Description
5
prc13
6
prc14
7
prc15
8
prc16
9
prc17
10
prc18
prc(i):
11
prc19
Fast corrections (-2048 to +2047) for the PRN
12
prc20
in slot i (i = 13-25)
13
prc21
14
prc22
15
prc23
16
prc24
17
prc25
18
udre13
19
udre14
20
udre15
21
udre16
22
udre17 udre(i):
23
udre18
24
udre19 User differential range error indicator for the
PRN in slot i (i = 13-25)
25
udre20 See Table 176: Evaluation of UDREI on
26
udre21 page 797 for scaling information.
27
udre22
28
udre23
29
udre24
30
udre25
31
xxxx
32-bit CRC (ASCII and Binary only)
32
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
-
-
Binary Offset H+12 H+16 H+20 H+24 H+28 H+32 H+36 H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 H+92 H+96 H+100 H+104 H+108 H+112 H+116 -
OEM7 Commands and Logs Reference Manual v10
799
Chapter 3 Logs
3.161 SBAS4
Fast correction slots 26-38
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS4 are fast corrections for slots 26-38 in the mask of SBAS1.
Message ID: 992
Log Type: Asynch
Recommended Input: log SBAS4a onchanged
ASCII Example: #SBAS4A,COM1,0,58.0,SATTIME,1093,163399.000,02000020,b4b0,209;122,0,3,2047,3,1,2047,2047,2047,-3,-1,5,3,3,2047,2,14,3,3,14,14,14,6,3,4,5,4,14,3*2e0894b1
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS4 message can be logged to view the data breakdown of SBAS frame 4 which contains information about fast correction slots 26-38.
Field
Field type
1
SBAS4 header
2
prn
3
iodf
4
iodp
Description
Format
Binary Bytes
Log header. See Messages on page 25 for more information.
H
Source PRN of message
Ulong 4
Issue of fast corrections data
Ulong 4
Issue of PRN mask data
Ulong 4
Binary Offset
0
H H+4 H+8
OEM7 Commands and Logs Reference Manual v10
800
Chapter 3 Logs
Field
Field type
Description
5
prc26
6
prc27
7
prc28
8
prc29
9
prc30
10
prc31
prc(i):
11
prc32
Fast corrections (-2048 to +2047) for the PRN
12
prc33
in slot i (i = 26-38)
13
prc34
14
prc35
15
prc36
16
prc37
17
prc38
18
udre26
19
udre27
20
udre28
21
udre29
22
udre30 udre(i):
23
udre31
24
udre32 User differential range error indicator for the
PRN in slot i (i = 26-38)
25
udre33 See Table 176: Evaluation of UDREI on
26
udre34 page 797 for scaling information.
27
udre35
28
udre36
29
udre37
30
udre38
31
xxxx
32-bit CRC (ASCII and Binary only)
32
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
-
-
Binary Offset H+12 H+16 H+20 H+24 H+28 H+32 H+36 H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 H+92 H+96 H+100 H+104 H+108 H+112 H+116 -
OEM7 Commands and Logs Reference Manual v10
801
Chapter 3 Logs
3.162 SBAS5
Fast correction slots 39-50
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS5 are fast corrections for slots 39-50 in the mask of SBAS1.
Message ID: 994
Log Type: Asynch
Recommended Input: log SBAS5a onchanged
ASCII Example: #SBAS5A,COM1,0,72.5,SATTIME,1093,161480.000,02040020,31d4,209;122,1,3,7,2047,2047,2047,-4,2047,2047,2047,9,2047,2047,-3,2,11,14,14,14,4,14,14,14,5,14,14,4,2*2bf0109b
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS5 message can be logged to view the data breakdown of SBAS frame 5 which contains information about fast correction slots 39-50.
Field
Field type
1
SBAS5 header
2
prn
3
iodf
4
iodp
Description
Format
Binary Bytes
Log header. See Messages on page 25 for more information.
H
Source PRN of message
Ulong 4
Issue of fast corrections data
Ulong 4
Issue of PRN mask data
Ulong 4
Binary Offset
0
H H+4 H+8
OEM7 Commands and Logs Reference Manual v10
802
Chapter 3 Logs
Field
Field type
Description
5
prc39
6
prc40
7
prc41
8
prc42
9
prc43
prc(i):
10
prc44
11
prc45
Fast corrections (-2048 to +2047) for the PRN
in slot i (i = 39-50)
12
prc46
13
prc47
14
prc48
15
prc49
16
prc50
17
prc51 (Invalid, do not use)
18
udre39
19
udre40
20
udre41
21
udre42
udre(i):
22
udre43
23
udre44 User differential range error indicator for the
24
udre45 PRN in slot i (i = 39-50)
25
udre46 See Table 176: Evaluation of UDREI on
page 797 for scaling information.
26
udre47
27
udre48
28
udre49
29
udre50
30
udre51 (Invalid, do not use)
31
xxxx
32-bit CRC (ASCII and Binary only)
32
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
-
-
Binary Offset H+12 H+16 H+20 H+24 H+28 H+32 H+36 H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 H+92 H+96 H+100 H+104 H+108 H+112 H+116 -
OEM7 Commands and Logs Reference Manual v10
803
Chapter 3 Logs
3.163 SBAS6
Integrity message
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS6 is the integrity information message. Each message includes an IODF for each fast corrections message. The 2UDRE information for each block of satellites applies to the fast corrections with the corresponding IODF.
Message ID: 995
Log Type: Asynch
Recommended Input: log SBAS6a onchanged
ASCII Example: #SBAS6A,COM1,0,57.5,SATTIME,1093,273317.000,02000020,526a,209;122,3,3,3,3,9,14, 14,2,3,10,2,14,14,3,14,14,5,14,14,7,14,14,14,14,14,14,3,3,14,14,14,14,3,15,11,1 1,15,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*925a2a9b
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS6 message can be logged to view the data breakdown of SBAS frame 6 which contains information about the integrity message.
Field
Field type
1
SBAS6 header
2
prn
3
iodf2
4
iodf3
5
iodf4
6
iodf5
7
udre0
8
udre1
Description
Format
Binary Bytes
Log header. See Messages on page 25 for more information.
H
Source PRN of message
Ulong 4
Issue of fast corrections data
Ulong 4
Issue of fast corrections data
Ulong 4
Issue of fast corrections data
Ulong 4
Issue of fast corrections data
Ulong 4
udre(i):
User differential range error indicator for the
PRN in slot i (i = 0-50)
Ulong 4
See Table 176: Evaluation of UDREI on page 797 for scaling information.
Ulong 4
Binary Offset 0 H H+4 H+8 H+12 H+16
H+20
H+24
OEM7 Commands and Logs Reference Manual v10
804
Chapter 3 Logs
Field
Field type
9
udre2
10
udre3
11
udre4
12
udre5
13
udre6
14
udre7
15
udre8
16
udre9
17
udre10
18
udre11
19
udre12
20
udre13
21
udre14
22
udre15
23
udre16
24
udre17
25
udre18
26
udre19
27
udre20
28
udre21
29
udre22
30
udre23
31
udre24
32
udre25
33
udre26
34
udre27
35
udre28
Description
Format
Binary Bytes
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Binary Offset H+28 H+32 H+36 H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 H+92 H+96 H+100 H+104 H+108 H+112 H+116 H+120 H+124 H+128 H+132
OEM7 Commands and Logs Reference Manual v10
805
Chapter 3 Logs
Field
Field type
Description
36
udre29
37
udre30
38
udre31
39
udre32
40
udre33
41
udre34
42
udre35
43
udre36
44
udre37
45
udre38
46
udre39
47
udre40
48
udre41
49
udre42
50
udre43
51
udre44
52
udre45
53
udre46
54
udre47
55
udre48
56
udre49
58
udre50
58
udre51 (Invalid, do not use)
59
xxxx
32-bit CRC (ASCII and Binary only)
60
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
-
-
Binary Offset H+136 H+140 H+144 H+148 H+152 H+156 H+160 H+164 H+168 H+172 H+176 H+180 H+184 H+188 H+192 H+196 H+200 H+204 H+208 H+212 H+216 H+220 H+224 H+228 -
OEM7 Commands and Logs Reference Manual v10
806
Chapter 3 Logs
3.164 SBAS7
Fast correction degradation
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The SBAS7 message specifies the applicable IODP, system latency time and fast degradation factor indicator for computing the degradation of fast and long term corrections.
Message ID: 996
Log Type: Asynch
Recommended Input: log SBAS7a onchanged
ASCII Example: #SBAS7A,COM1,0,36.5,SATTIME,1337,416367.000,02000000,12e3,1984;122,1,2,0,15,15, 15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,15,1 5,15,15,15,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*827a7364
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS7 message can be logged to view the data breakdown of SBAS frame 7 which contains information about fast correction degradation.
Field
Field type
Description
1
SBAS7 header
Log header. See Messages on page 25 for more information.
2
prn
Source PRN of message
3
latency System latency (s)
4
iodp
Issue of PRN mask data
5
spare bits Unused spare bits
6
aI(0)
aI(i):
Degradation factor indicator for the PRN in slot i (i = 0-50)
7
aI(1)
8
aI(2)
9
aI(3)
10
aI(4)
Format
Binary Bytes
H
Ulong 4 Ulong 4 Ulong 4 Ulong 4
Ulong 4
Ulong 4 Ulong 4 Ulong 4 Ulong 4
Binary Offset 0 H H+4 H+8 H+12
H+16
H+20 H+24 H+28 H+32
OEM7 Commands and Logs Reference Manual v10
807
Chapter 3 Logs
Field
Field type
11
aI(5)
12
aI(6)
13
aI(7)
14
aI(8)
15
aI(9)
16
aI(10)
17
aI(11)
18
aI(12)
19
aI(13)
20
aI(14)
21
aI(15)
22
aI(16)
23
aI(17)
24
aI(18)
25
aI(19)
26
aI(20)
27
aI(21)
28
aI(22)
29
aI(23)
30
aI(24)
31
aI(25)
32
aI(26)
33
aI(27)
34
aI(28)
35
aI(29)
36
aI(30)
37
aI(31)
Description
Format
Binary Bytes
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Binary Offset H+36 H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 H+92 H+96 H+100 H+104 H+108 H+112 H+116 H+120 H+124 H+128 H+132 H+136 H+140
OEM7 Commands and Logs Reference Manual v10
808
Chapter 3 Logs
Field
Field type
Description
38
aI(32)
39
aI(33)
40
aI(34)
41
aI(35)
42
aI(36)
43
aI(37)
44
aI(38)
45
aI(39)
46
aI(40)
47
aI(41)
48
aI(42)
49
aI(43)
50
aI(44)
51
aI(45)
52
aI(46)
53
aI(47)
54
aI(48)
55
aI(49)
56
aI(50)
57
aI(51) (Invalid, do not use)
58
xxxx
32-bit CRC (ASCII and Binary only)
59
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
-
-
Binary Offset H+144 H+148 H+152 H+156 H+160 H+164 H+168 H+172 H+176 H+180 H+184 H+188 H+192 H+196 H+200 H+204 H+208 H+212 H+216 H+220 H+224 -
OEM7 Commands and Logs Reference Manual v10
809
Chapter 3 Logs
3.165 SBAS9
GEO navigation message
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS9 provides the GEO navigation message representing the position, velocity and acceleration of the geostationary satellite, in ECEF coordinates and its apparent clock time and frequency offsets. Also included is the time of applicability, an Issue of Data (IOD) and an accuracy exponent (URA) representing the estimated accuracy of the message. The time offset and time drift are with respect to SBAS Network Time. Their combined effect is added to the estimate of the satellite's transmit time.
Message ID: 997
Log Type: Asynch
Recommended Input: log SBAS9a onchanged
ASCII Example: #SBAS9A,COM1,0,38.0,SATTIME,1337,416426.000,02000000,b580,1984;122,175,70848,2, 24802064.1600,-34087313.9200,-33823.2000,1.591250000,0.107500000,0.6080000,0.0000750,-0.0001125,0.000187500,-2.235174179e-08,9.094947018e-12*636051d2
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS9 message can be logged to view the data breakdown of SBAS frame 9 which contains the GEO navigation message.
Field
Field type
1
SBAS9 header
2
prn
3
iodn
4
t0
5
ura
6
x
7
y
8
z
Description
Log header. See Messages on page 25 for more information. Source PRN of message Issue of GEO navigation data Time of applicability URA value ECEF x coordinate (m) ECEF y coordinate (m) ECEF z coordinate (m)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Ulong 4 Ulong 4 Ulong 4 Double 8 Double 8 Double 8
H H+4 H+8 H+12 H+16 H+24 H+32
OEM7 Commands and Logs Reference Manual v10
810
Chapter 3 Logs
Field
Field type
9
xvel
10
yvel
11
zvel
12
xaccel
13
yaccel
14
zaccel
15
af0
16
af1
17
xxxx
18
[CR][LF]
Description
X rate of change (m/s) Y rate of change (m/s) Z rate of change (m/s) X rate of rate change (m/s2) Y rate of rate change (m/s2) Z rate of rate change (m/s2) Time offset (s) Time drift (s) 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Double 8
Double 8
Double 8
Double 8
Double 8
Double 8
Double 8
Double 8
Ulong 4
-
-
Binary Offset H+40 H+48 H+56 H+64 H+72 H+80 H+88 H+96 H+104 -
OEM7 Commands and Logs Reference Manual v10
811
Chapter 3 Logs
3.166 SBAS10
Degradation factor
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The fast corrections, long term corrections and ionospheric corrections are all provided in the SBAS10 message.
Message ID: 978
Log Type: Asynch
Recommended Input: log SBAS10a onchanged
ASCII Example: #SBAS10A,COM1,0,35.5,SATTIME,1337,416469.000,02000000,c305,1984;122,54,38,76,25 6,152,100,311,83,256,6,0,300,292,0,1,0000000000000000000000*8884d248
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS10 message can be logged to view the data breakdown of SBAS frame 10 which contains information about degradation factors.
Field
Field type
Description
Format
Binary Bytes
Binary Offset
Scaling
1
SBAS10 Log header. See Messages on page 25 header for more information.
H
0
-
2
prn
Source PRN of message
Ulong 4
H
-
3
brcc
Estimated noise and round off error parameter
Ulong 4
H+4
0.002
4
cltc_lsb
Maximum round off due to the least significant bit (lsb) of the orbital clock
Ulong
4
H+8
0.002
5
cltc_vl Velocity error bound
Ulong 4
H+12 0.00005
6
iltc_vl
Update interval for v=1 long term
7
cltc_v0 Bound on update delta
Ulong 4 Ulong 4
H+16 H+20
0.002
8
iltc_v1 Minimum update interval v = 0
Ulong 4
9
cgeo_lsb
Maximum round off due to the lsb of the orbital clock
Ulong 4
H+24 H+28
0.0005
10
cgeo_v Velocity error bound
Ulong 4
H+32 0.00005
OEM7 Commands and Logs Reference Manual v10
812
Chapter 3 Logs
Field
Field type
11
igeo
12
cer
13
ciono_
step
14
iiono
15
ciono_
ramp
16
rssudre
17
rssiono
18
spare bits
19
xxxx
20
[CR] [LF]
Description
Update interval for GEO navigation message Degradation parameter Bound on ionospheric grid delay difference Minimum ionospheric update interval
Format
Binary Bytes
Binary Offset
Scaling
Ulong 4
H+36 -
Ulong 4
H+40 0.5
Ulong 4
H+44 0.001
Ulong 4
H+48 -
Rate of ionospheric corrections change Ulong 4
H+52 0.000005
User differential range error flag Root sum square flag
Ulong 4 Ulong 4
H+56 H+60 -
Spare 88 bits, possibly GLONASS
Hex[11] 11
H+64 -
32-bit CRC (ASCII and Binary only)
Ulong 4
H+75 -
Sentence terminator (ASCII only)
-
-
-
-
OEM7 Commands and Logs Reference Manual v10
813
Chapter 3 Logs
3.167 SBAS12
SBAS network time and UTC
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS12 contains information bits for the UTC parameters and UTC time standard from which an offset is determined. The UTC parameters correlate UTC time with the SBAS network time rather than with GPS reference time.
Message ID: 979
Log Type: Asynch
Recommended Input: log SBAS12a onchanged
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS12 message can be logged to view the data breakdown of SBAS frame 12 which contains information about time parameters.
Field Field type
Description
1
SBAS12 header
2
prn
3
A1
4
A0
5
seconds
6
week
7
dtls
8
wnlsf
9
dn
10
dtlsf
11
utc id
12
gpstow
13
gpswn
Log header. See Messages on page 25 for more information. Source PRN of message Time drift (s/s) Time offset (s) Seconds into the week (s) Week number Delta time due to leap seconds Week number, leap second future Day of the week (the range is 1 to 7 where Sunday = 1 and Saturday = 7) Delta time, leap second future UTC type identifier GPS reference time of the week GPS de-modulo week number
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Double 8 Double 8 Ulong 4 Ushort 2 Short 2 Ushort 2
H H+4 H+12 H+20 H+24 H+26 H+28
Ushort 2
H+30
Ushort 2 Ushort 2 Ulong 4 Ulong 4
H+32 H+34 H+36 H+40
OEM7 Commands and Logs Reference Manual v10
814
Chapter 3 Logs
Field Field type
Description
Is GLONASS information present?
14
glo indicator
0 = FALSE
1 = TRUE
15
Reserved array of hexabytes for GLONASS
16
xxxx
32-bit CRC (ASCII and Binary only)
17
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Enum 4
H+44
Char [10]
121
Ulong 4
-
-
H+48 H+60 -
1In the binary log case, an additional 2 bytes of padding are added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
815
Chapter 3 Logs
3.168 SBAS17
GEO Almanac message
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Almanacs for all GEOs are broadcast periodically to alert you of their existence, location, the general service provided, status and health.
Unused almanacs have a PRN number of 0 and should be ignored, see ASCII Example below.
Message ID: 980
Log Type: Asynch
Recommended Input: log SBAS17a onchanged
ASCII Example: #SBAS17A,COM1,0,84.5,SATTIME,1610,514149.000,02000000,896c,39061;135,3,0,135, 0,-11536200,-40536600,-260000,0,0,0,0,138,0,-12521600,-40258400, 0,0,0,0,0,133,0,-5551000,-41774200,-1248000,0,0,120,82112*2be5146f
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS17 message can be logged to view the data breakdown of SBAS frame 17 which contains GEO almanacs.
Field
Field type
Description
Format
Binary Bytes
1
SBAS17 header
Log header. See Messages on page 25 for more information.
H
2
prn
Source PRN of message
Ulong 4
3
#ents
Number of almanac entries with information to follow
Ulong 4
4
data id
Data ID type
Ushort 2
5
entry prn PRN for this entry
6
health
Health bits
Ushort 2 Ushort 41
Binary Offset
0
H
H+4
H+8 H+10 H+12
1In the binary log case, an additional 2 bytes of padding is added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
816
Chapter 3 Logs
Field
Field type
7
x
8
y
9
z
10
x vel
11
y vel
12
z vel
Description
ECEF x coordinate (m) ECEF y coordinate (m) ECEF z coordinate (m) X rate of change (m/s) Y rate of change (m/s) Z rate of change (m/s)
13... Next entry = H+8+(#ents x 32)
14
t0
Time of day in seconds (0 to 86336) Scaling = 64
15
xxxx
32-bit CRC (ASCII and Binary only)
16
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Binary Offset H+16 H+20 H+24 H+28 H+32 H+36
Ulong 4
Ulong 4
-
-
H+8+ (#ents x 32)
H+12+ (#ents x 32)
-
OEM7 Commands and Logs Reference Manual v10
817
Chapter 3 Logs
3.169 SBAS18
IGP mask
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The ionospheric delay corrections are broadcast as vertical delay estimates, at specified ionospheric grid points (IGPs), applicable to a signal on L1. The predefined IGPs are contained in 11 bands (numbered 0 to 10). Bands 0-8 are vertical bands on a Mercator projection map and bands 9-10 are horizontal bands on a Mercator projection map. Since it is impossible to broadcast IGP delays for all possible locations, a mask is broadcast to define the IGP locations providing the most efficient model of the ionosphere at the time.
Message ID: 981
Log Type: Asynch
Recommended Input: log SBAS18a onchanged
ASCII Example: #SBAS18A,COM1,0,33.0,SATTIME,1337,417074.000,02000000,f2c0,1984;122,4,2,2,0000f fc0007fc0003ff0000ff80007fe0007fe0003ff0000ff80,0*b1ed353e
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS18 message can be logged to view the data breakdown of SBAS frame 18 which contains information about ionospheric grid points.
Field
Field type
1
SBAS18 header
2
prn
3
#bands
4
band num
5
iodi
6
igp mask
Description
Log header. See Messages on page 25 for more information. Source PRN of message Number of bands broadcast Specific band number that identifies which of the 11 IGP bands the data belongs to Issue of ionospheric data
IGP mask
Format
Binary Bytes
H
Ulong 4 Ulong 4
Ulong 4
Ulong 4
Uchar [26]
28a
Binary Offset 0 H H+4 H+8 H+12 H+16
aIn the binary log case, an additional 2 bytes of padding are added to maintain 4-byte alignment. OEM7 Commands and Logs Reference Manual v10
818
Chapter 3 Logs
Field
Field type
Description
7
spare bit
One spare bit
8
xxxx
32-bit CRC (ASCII and Binary only)
9
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+44
Ulong 4
-
-
H+48 -
OEM7 Commands and Logs Reference Manual v10
819
Chapter 3 Logs
3.170 SBAS24
Mixed fast/slow corrections
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
If there are 6 or fewer satellites in a block, they may be placed in this mixed correction message. There is a fast data set for each satellite and a UDRE indicator. Each message also contains an IODP indicating the associated PRN mask. The fast correction (PRC) has a valid range of -2048 to +2047. If the range is exceeded, a don't use indication is inserted into the user differential range error indicator (UDREI) field, see Table 176: Evaluation of UDREI on page 797. You should ignore extra data sets not represented in the PRN mask. The time of applicability (T0) of the PRC is the start of the epoch of the WNT second that is coincident with the transmission at the GEO satellite of the first bit of the message block.
Message ID: 983
Log Type: Asynch
Recommended Input: log SBAS24a onchanged
ASCII Example: #SBAS24A,COM1,0,34.0,SATTIME,1337,417108.000,02000000,0a33,1984;134,2047,2047,2 047,2047,-1,2,14,14,14,14,11,14,2,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*76ff954b
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS24 message can be logged to view the data breakdown of SBAS frame 24 which contains mixed fast/slow corrections.
Field
Field type
Description
1
SBAS24 header
Log header. See Messages on page 25 for more information.
2
prn
Source PRN of message
Format
Binary Bytes
Binary Offset
H
0
-
Ulong 4
H
-
Scaling
OEM7 Commands and Logs Reference Manual v10
820
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
Scaling
3
prc0
4
prc1
prc(i):
Long
4
Long
4
H+4
-
H+8
-
5
prc2
Long
4
Fast corrections (-2048 to
6
prc3
+2047) for the PRN in slot i Long
4
7
prc4
(i = 0-5)
Long
4
8
prc5
Long
4
H+12 H+16 H+20 H+24 -
9
udre0
udre(i):
10
udre1
Ulong 4 Ulong 4
11
udre2 User differential range
Ulong 4
12
udre3 error indicator for the PRN Ulong 4
in slot i
13
udre4
(i = 0-5)
Ulong 4
14
udre5
Ulong 4
H+28 H+32 H+36 H+40 H+44 H+48
See Table 176: Evaluation of UDREI on page 797
15
iodp
Issue of PRN mask data
Ulong 4
H+52 -
16
block id Associated message type
Ulong 4
H+56
17
iodf
Issue of fast corrections data
Ulong 4
H+60 -
18
spare Spare value
Ulong 4
H+64 -
19
vel
Velocity code flag
Ulong 4
H+68 -
20
mask1
Index into PRN mask (Type 1)
Ulong
4
H+72 -
21
iode1 Issue of ephemeris data
Ulong 4
H+76 -
22
dx1
Delta x (ECEF)
Long
4
H+80 0.125
23
dy1
Delta y (ECEF)
Long
4
H+84 0.125
24
dz1
25
daf0
Delta z (ECEF) Delta af0 clock offset
Long
4
Long
4
H+88 H+92
0.125 2-31
26
mask2
Second index into PRN mask (Type 1)
Ulong 4
H+96 -
27
iode2
Second issue of ephemeris data
Ulong
4
H+100 -
OEM7 Commands and Logs Reference Manual v10
821
Chapter 3 Logs
Field
Field type
28
ddx
29
ddy
30
ddz
31
daf1
32
t0
33
iodp
34
corr spare
35
xxxx
36
[CR] [LF]
Description
Delta delta x (ECEF) Delta delta y (ECEF) Delta delta z (ECEF) Delta af1 clock offset
Format
Binary Bytes
Binary Offset
Scaling
Long
4
H+104 2-11
Long
4
H+108 2-11
Long
4
H+112 2-11
Long
4
H+116 2-39
Applicable time of day
Ulong 4
H+120 16
Issue of PRN mask data
Ulong 4
Spare value when velocity code is equal to 0
Ulong
4
32-bit CRC (ASCII and Binary only)
Ulong 4
Sentence terminator (ASCII only)
-
-
H+124 H+128 -
H+132 -
-
-
OEM7 Commands and Logs Reference Manual v10
822
Chapter 3 Logs
3.171 SBAS25
Long term slow satellite corrections
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS25 provides error estimates for slow varying satellite ephemeris and clock errors with respect to WGS-84 ECEF coordinates.
Message ID: 984
Log Type: Asynch
Recommended Input: log SBAS25a onchanged
ASCII Example: #SBAS25A,COM1,0,37.5,SATTIME,1337,417193.000,02000000,b8ff,1984;134,1,19,25,1,-3,0,-15,0,0,0,1,-1,-2,4465,2,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0*81685317
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS25 message can be logged to view the data breakdown of SBAS frame 25 which contains long term slow satellite corrections.
Field
Field type
1
SBAS25 header
2
prn
3
1st half vel
4
1st half mask1
5
1st half iode1
6
1st half dx1
7
1st half dy1
8
1st half dz1
Description Log header. See Messages on page 25 for more information. Source PRN of message Velocity code flag (0 or 1)
Index into PRN mask (Type 1)
Issue of ephemeris data
Delta x (ECEF)
Delta y (ECEF)
Delta z (ECEF)
Format
Binary Bytes
Binary Offset
Scaling
H
0
-
Ulong 4
H
-
Ulong 4
H+4
-
Ulong 4
H+8
-
Ulong 4
H+12 -
Long
4
H+16 0.125
Long
4
H+20 0.125
Long
4
H+24 0.125
OEM7 Commands and Logs Reference Manual v10
823
Chapter 3 Logs
Field
Field type
Description
9
1st half af0 Delta af0 clock offset
Format
Binary Bytes
Long
4
Binary Offset
H+28
Scaling 2-31
Second index into PRN mask (Type
10
1st half mask2
1) Dummy value when velocity code =
Ulong
4
1
H+32 -
11
1st half iode2
Second issue of ephemeris data Dummy value when velocity code = Ulong 4 1
H+36 -
12
1st half ddx
Delta delta x (ECEF) when velocity code = 1 Delta x (dx) when velocity code = 0
Long
4
H+40
2-11
13
1st half ddy
Delta delta y (ECEF) when velocity code = 1 Delta y (dy) when velocity code = 0
Long
4
H+44
2-11
14
1st half ddz
Delta delta z (ECEF) when velocity code = 1 Delta z (dz) when velocity code = 0
Long
4
H+48
2-11
Delta af1 clock offset when velocity
15
1st half af1
code = 1 Delta af0 clock offset when velocity
Long
4
code = 0
H+52
2-39
Applicable time of day
16
1st half t0 Dummy value when velocity code = Ulong 4
0
H+56 16
17
1st half iodp
Issue of PRN mask data
Ulong 4
H+60 -
18
1st half corr spare
Spare value when velocity code = 0 Dummy value when velocity code = 1
Ulong
4
H+64 -
19
2nd half vel
Velocity code flag (0 or 1)
Ulong 4
H+68 -
20
2nd half mask1
Index into PRN mask (Type 1)
Ulong 4
H+72 -
21
2nd half iode1
Issue of ephemeris data
Ulong 4
H+76 -
OEM7 Commands and Logs Reference Manual v10
824
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
Scaling
22
2nd half dx1
Delta x (ECEF)
Long
4
H+80 0.125
23
2nd half dy1
Delta y (ECEF)
Long
4
H+84 0.125
24
2nd half dz1
Delta z (ECEF)
Long
4
H+88 0.125
25
2nd half af0
Delta af0 clock offset
Long
4
Second index into PRN mask (Type
26
2nd half mask2
1) Dummy value when velocity code =
Ulong
4
1
H+92
2-31
H+96 -
27
2nd half iode2
Second issue of ephemeris data Dummy value when velocity code = Ulong 4 1
H+100 -
28
2nd half ddx
Delta delta x (ECEF) when velocity code = 1 Delta x (dx) when velocity code = 0
Long
4
H+104 2-11
29
2nd half ddy
Delta delta y (ECEF) when velocity code = 1 Delta y (dy) when velocity code = 0
Long
4
H+108 2-11
30
2nd half ddz
Delta delta z (ECEF) when velocity code = 1 Delta z (dz) when velocity code = 0
Long
4
H+112 2-11
Delta af1 clock offset when velocity
31
2nd half af1
code = 1 Delta af0 clock offset when velocity
Long
4
code = 0
H+116 2-39
Applicable time of day
32
2nd half t0 Dummy value when velocity code = Ulong 4
0
H+120 16
33
2nd half iodp
Issue of PRN mask data
Ulong 4
H+124 -
34
2nd half corr spare
Spare value when velocity code = 0 Dummy value when velocity code = 1
Ulong
4
H+128 -
OEM7 Commands and Logs Reference Manual v10
825
Chapter 3 Logs
Field
Field type
35
xxxx
36
[CR][LF]
Description 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Ulong 4
-
-
Binary Offset
H+132
-
Scaling -
OEM7 Commands and Logs Reference Manual v10
826
Chapter 3 Logs
3.172 SBAS26
Ionospheric delay corrections
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS26 provides vertical delays (relative to an L1 signal) and their accuracy at geographically defined IGPs identified by the BAND NUMBER and IGP number. Each message contains a band number and a block ID, which indicates the location of the IGPs in the respective band mask.
Message ID: 985
Log Type: Asynch
Recommended Input: log SBAS26a onchanged
ASCII Example: #SBAS26A,COM1,0,38.0,SATTIME,1337,417243.000,02000000,ec70,1984;134,1,2,15,27,1 1,25,11,23,11,19,11,16,11,16,12,15,13,16,13,29,14,30,13,27,11,27,11,24,11,19,11 ,16,12,2,0*3b6d6806
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS26 message can be logged to view the data breakdown of SBAS frame 26 which contains ionospheric delay corrections
Field
Field type
Description
Format
Binary Bytes
1
SBAS26 header
Log header. See Messages on page 25 for more information.
H
2
prn
Source PRN of message
Ulong 4
3
band num Band number
Ulong 4
4
block id Block ID
Ulong 4
5
#pts
Number of grid points with information to follow
Ulong
4
IGP vertical delay estimates
6
igpvde
Scaling = 0.125
Ulong 4
7
givei
Grid ionospheric vertical error indicator Ulong 4
8... Next #pts entry = H + 16 + (#pts x 8)
Binary Offset 0 H H+4 H+8 H+12
H+16
H+20
OEM7 Commands and Logs Reference Manual v10
827
Chapter 3 Logs
Field
Field type
9
iodi
Description Issue of data - ionosphere
10
spare
7 spare bits
11
xxxx
32-bit CRC (ASCII and Binary only)
12
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Ulong 4
Ulong 4
Ulong 4
-
-
Binary Offset
H+16+ (#pts x 8)
H+20+ (#pts x 8)
H+24+ (#pts x 8)
-
OEM7 Commands and Logs Reference Manual v10
828
Chapter 3 Logs
3.173 SBAS27
SBAS service message
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS27 messages apply only to the service provider transmitting the message. The number of service messages indicates the total number of unique SBAS27 messages for the current IODS. Each unique message for that IODS includes a sequential message number. The IODS is incremented in all messages, each time that any parameter in any SBAS27 message is changed.
Message ID: 986
Log Type: Asynch
Recommended Input: log SBAS27a onchanged
Each raw SBAS frame gives data for a specific frame decoder number. The SBAS27 message can be logged to view the data breakdown of SBAS frame 27 which contains information about SBAS service messages.
Field Field type
Description
Format
Binary Bytes
1
SBAS27 header
Log header. See Messages on page 25 for more information.
H
2
prn
Source PRN of message
Ulong 4
3
iods
Issue of slow corrections data
Ulong 4
4
#messages Low-by-one count of messages
Ulong 4
5
message num
Low-by-one message number
Ulong 4
6
priority code
Priority code
Ulong 4
7
dudre inside
Delta user differential range error - inside Ulong 4
8
dudre outside
Delta user differential range error -outside Ulong 4
9... #reg
Number of regions with information to follow
Ulong 4
10
lat1
Coordinate 1 latitude
Long
4
Binary Offset 0 H H+4 H+8 H+12
H+16
H+20
H+24
H+28 H+32
OEM7 Commands and Logs Reference Manual v10
829
Chapter 3 Logs
Field Field type
Description
11
lon1
Coordinate 1 longitude
12
lat2
Coordinate 2 latitude
13
lon2
Coordinate 2 longitude
14
shape
Shape where: 0 = triangle, 1 = square
15
Next #reg entry = H+32+(#reg x 20)
16
Reserved
17
xxxx
32-bit CRC (ASCII and Binary only)
18
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Long
4
Long
4
Long
4
Ulong 4
Binary Offset H+36 H+40 H+44 H+48
Ulong 4
Ulong 4
-
-
H+32+ (#reg x 20)
H+36+ (#reg x 20)
-
OEM7 Commands and Logs Reference Manual v10
830
Chapter 3 Logs
3.174 SBAS32
Fast correction slots 0-10
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS32 are fast corrections for slots 0-10 in the mask of SBAS1, see SBAS1 log on page 794.
Message ID: 988
Log Type: Asynch
Recommended Input: log SBAS32a onchanged
ASCII Example: #SBAS32A,COM2,0,70.5,FINE,1295,153284.000,02000240,18e9,34461;209,0,0,8097,0,0,0,0,-947,0,-2128,0,2570,14,0,14,14,14,14,0,14,0,14,0*58778ae5
Field
Field type
1
SBAS32 header
2
prn
3
iodp
4
prc0
5
prc1
6
prc2
7
prc3
8
prc4
9
prc5
10
prc6
11
prc7
12
prc8
13
prc9
14
prc10
Description
Format
Binary Bytes
Log header. See Messages on page 25 for more information.
H
Source PRN of message
Ulong 4
Issue of PRN mask data
Ulong 4
Long
4
Long
4
Long
4
prc(i):
Long
4
Long
4
Long
4
Fast corrections (-2048 to +2047) for the PRN
in slot i (i = 0-10)
Long
4
Long
4
Long
4
Long
4
Long
4
Binary Offset
0
H H+4 H+8 H+12 H+16 H+20 H+24 H+28 H+32 H+36 H+40 H+44 H+48
OEM7 Commands and Logs Reference Manual v10
831
Chapter 3 Logs
Field
Field type
15
udre0
16
udre1
17
udre2
18
udre3
19
udre4
20
udre5
21
udre6
22
udre7
23
udre8
24
udre9
25
udre10
26
xxxx
27
[CR][LF]
Description
Format
Binary Bytes
Ulong 4
Ulong 4
Ulong 4
udre(i):
Ulong 4
Ulong 4
User differential range error indicator for the Ulong 4 PRN in slot i (i = 0-10)
See Table 177: Evaluation of UDREI below
Ulong 4
for scaling information
Ulong 4
Ulong 4
Ulong 4
Ulong 4
32-bit CRC (ASCII and Binary only)
Ulong 4
Sentence terminator (ASCII only)
-
-
Binary Offset H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 H+92 H+96 -
Table 177: Evaluation of UDREI
UDREI UDRE Metres
0
0.01
1
0.02
2
0.03
3
0.05
4
0.10
5
0.15
6
0.20
7
0.25
8
0.30
9
0.35
10
0.40
11
0.45
OEM7 Commands and Logs Reference Manual v10
832
Chapter 3 Logs
UDREI UDRE Metres
12
0.50
13
0.60
14 Not Monitored
15
Do Not Use
OEM7 Commands and Logs Reference Manual v10
833
Chapter 3 Logs
3.175 SBAS33
Fast correction slots 11-21
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS33 are fast corrections for slots 11-21.
Message ID: 989
Log Type: Asynch
Recommended Input: log SBAS33a onchanged
ASCII Example: #SBAS33A,COM2,0,47.5,FINE,1295,158666.000,03000240,b23e,34461;209,0,0,3343,0,0,0,-533,0,0,0,0,0,14,0,14,14,14,0,14,14,14,14,14*6d890f5f
Each raw mask frame gives data for a specific frame decoder number. The SBAS33 message can be logged to view the data breakdown of SBAS frame 33 which contains information about correction slots 11-21.
Field
Field type
1
SBAS33 header
2
prn
3
iodp
Description
Log header. See Messages on page 25 for more information. Source PRN of message Issue of PRN mask data
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Ulong 4
H H+4
OEM7 Commands and Logs Reference Manual v10
834
Chapter 3 Logs
Field
Field type
4
prc11
5
prc12
6
prc13
7
prc14
8
prc15
9
prc16
10
prc17
11
prc18
12
prc19
13
prc20
14
prc21
15
udre11
16
udre12
17
udre13
18
udre14
19
udre15
20
udre16
21
udre17
22
udre18
23
udre19
24
udre20
25
udre21
26
xxxx
27
[CR][LF]
Description
prc(i): Fast corrections (-2048 to +2047) for the PRN in slot i (i = 11-21)
udre(i): User differential range error indicator for the PRN in slot i (i = 11-21) See Table 177: Evaluation of UDREI on page 832 for scaling information
32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
-
-
Binary Offset H+8 H+12 H+16 H+20 H+24 H+28 H+32 H+36 H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 H+92 H+96 -
OEM7 Commands and Logs Reference Manual v10
835
Chapter 3 Logs
3.176 SBAS34
Fast correction slots 22-32
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS34 are fast corrections for slots 22-32 in the mask of SBAS1, see SBAS1 log on page 794.
Message ID: 990
Log Type: Asynch
Recommended Input: log SBAS34a onchanged
ASCII Example: #SBAS34A,COM2,0,73.0,FINE,1295,226542.000,02000040,1be8,34461;209,0,5879,0,0,0, 0,2687,0,10922,10922,10922,10922,0,14,14,14,14,0,14,15,15,15,15*3aeb74be
Each raw mask frame gives data for a specific frame decoder number. The SBAS34 message can be logged to view the data breakdown of SBAS frame 34 which contains information about fast correction slots 22-32.
Field
Field type
1
SBAS34 header
2
prn
3
iodp
Description
Log header. See Messages on page 25 for more information. Source PRN of message Issue of PRN mask data
Format
Binary Bytes
Binary Offset
H
0
Ulong 4 Ulong 4
H H+4
OEM7 Commands and Logs Reference Manual v10
836
Chapter 3 Logs
Field
Field type
4
prc22
5
prc23
6
prc24
7
prc25
8
prc26
9
prc27
10
prc28
11
prc29
12
prc30
13
prc31
14
prc32
15
udre22
16
udre23
17
udre24
18
udre25
19
udre26
20
udre27
21
udre28
22
udre29
23
udre30
24
udre31
25
udre32
26
xxxx
27
[CR][LF]
Description
prc(i): Fast corrections (-2048 to +2047) for the PRN in slot i (i = 22-32)
udre(i): User differential range error indicator for the PRN in slot i (i = 22-32) See Table 177: Evaluation of UDREI on page 832 for scaling information
32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
-
-
Binary Offset H+8 H+12 H+16 H+20 H+24 H+28 H+32 H+36 H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 H+92 H+96 -
OEM7 Commands and Logs Reference Manual v10
837
Chapter 3 Logs
3.177 SBAS35
Fast correction slots 33-43
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
SBAS35 are fast corrections for slots 33-43 in the mask of SBAS1, see SBAS1 log on page 794.
Message ID: 991
Log Type: Asynch
Recommended Input: log SBAS35a onchanged
Each raw mask frame gives data for a specific frame decoder number. The SBAS35 message can be logged to view the data breakdown of SBAS frame 35 which contains information about fast correction slots 33-43.
Field
Field type
1
SBAS35 header
2
prn
3
iodp
4
prc33
5
prc34
6
prc35
7
prc36
8
prc37
9
prc38
10
prc39
11
prc40
12
prc41
13
prc42
14
prc43
Description Log header. See Messages on page 25 for more information. Source PRN of message Issue of PRN mask data
prc(i): Fast corrections (-2048 to +2047) for the PRN in slot i (i = 33-43)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
Ulong 4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
H H+4 H+8 H+12 H+16 H+20 H+24 H+28 H+32 H+36 H+40 H+44 H+48
OEM7 Commands and Logs Reference Manual v10
838
Chapter 3 Logs
Field
Field type
15
udre33
16
udre34
17
udre35
18
udre36
19
udre37
20
udre38
21
udre39
22
udre40
23
udre41
24
udre42
25
udre43
26
xxxx
27
[CR][LF]
Description
udre(i): User differential range error indicator for the PRN in slot i (i = 33-43) See Table 177: Evaluation of UDREI on page 832 for scaling information
32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
Ulong 4
-
-
Binary Offset H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 H+92 H+96 -
OEM7 Commands and Logs Reference Manual v10
839
Chapter 3 Logs
3.178 SBAS45
Slow corrections
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
Each SBAS45 message contains a 2-bit IODP indicating the associated PRN mask. The time of applicability (T0) of the PRC is the start of the epoch of the WNT second that is coincident with the transmission at the satellite of the first bit of the message block.
Message ID: 993
Log Type: Asynch
Recommended Input: log SBAS45a onchanged
ASCII Example: #SBAS45A,COM2,0,73.0,FINE,1295,228498.000,02000040,c730,34461;209,23,32,197,116,206,-1,-6,-3,-5546,3488,25,148,262,-312,867,4,3,0,2513,3488,0*02d6e0d5
Each raw mask frame gives data for a specific frame decoder number. The SBAS45 message can be logged to view the data breakdown of SBAS frame 45 which contains information about slow corrections.
Field
Field type
1
SBAS45 header
2
prn
3
mask1
4
iode1
5
dx1
6
dy1
7
dz1
8
ddx1
9
ddy1
10
ddz1
11
daf01
Description
Log header. See Messages on page 25 for more information. Source PRN of message Index into PRN mask (Type 1) Issue of ephemeris data Delta x (ECEF) Delta y (ECEF) Delta z (ECEF) Delta delta x (ECEF) Delta delta y (ECEF) Delta delta z (ECEF) Delta af0 clock offset
Format
Binary Bytes
Binary Offset
Scaling
H
0
-
Ulong 4
Ulong 4
Ulong 4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
Long
4
H H+4 H+8 H+12 H+16 H+20 H+24 H+28 H+32 H+36
0.125 0.125 0.125 2-11 2-11 2-11 2-31
OEM7 Commands and Logs Reference Manual v10
840
Chapter 3 Logs
Field
Field type
12
t01
13
mask2
14
iode2
15
dx2
16
dy2
17
dz2
Description
Format
Binary Bytes
Applicable time of day
Ulong 4
Second index into PRN mask (Type 1) Ulong 4
Second issue of ephemeris data
Ulong 4
Delta x (ECEF)
Long
4
Delta y (ECEF)
Long
4
Delta z (ECEF)
Long
4
18
ddx2
Delta delta x (ECEF)
Long
4
19
ddy2
Delta delta y (ECEF)
Long
4
20
ddz2
Delta delta z (ECEF)
Long
4
21
daf02
Delta af0 clock offset
Long
4
22
t02
Applicable time of day
Ulong 4
23
iodp
Issue of PRN mask data
Ulong 4
24
xxxx
32-bit CRC (ASCII and Binary only) Ulong 4
25
[CR][LF] Sentence terminator (ASCII only)
-
-
Binary Offset H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+68 H+72 H+76 H+80 H+84 H+88 -
Scaling
16 0.125 0.125 0.125 2-11 2-11 2-11 2-31 16 -
OEM7 Commands and Logs Reference Manual v10
841
Chapter 3 Logs
3.179 SBASALMANAC
SBAS Almanac collection
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains a collection of all current SBAS almanacs that have been decoded by the receiver and may contain almanac data for multiple PRNs. The SBASALMANAC log is populated by the GEO Almanac Message Type 17 which is available in the SBAS17 log (see page 816). These PRNs are broken out into individual SBAS almanac entries for this message and output individually. If multiple SBAS subsystems (e.g., WAAS, EGNOS, GAGAN, MSAS) are tracked, this message will include almanac data collected from each with the subsystem identified in each message entry. The almanac data contains all of the information required to compute the satellite position as well as health and status information. The OEM7 family of receivers automatically save almanacs in their Non-Volatile Memory (NVM), so creating an almanac boot file is not necessary.
Message ID: 1425
Log Type: Asynch
Recommended Input: Log SBASALMANACA onchanged
ASCII Example: #SBASALMANACA,COM1,2,80.0,SATTIME,1672,411186.000,02000020,84d8,43119;133,WAAS, 65600,0,0,-5571800,-41758600,-1456000,0,0,120*22da17e8
#SBASALMANACA,COM1,1,80.0,SATTIME,1672,411186.000,02000020,84d8,43119;135,WAAS, 65600,0,0,-28758600,-30825600,0,0,0,0*dd122ca1
#SBASALMANACA,COM1,0,80.0,SATTIME,1672,411186.000,02000020,84d8,43119;138,WAAS, 65600,0,0,-12547600,-40248000,0,0,0,0*89c6c51c
Field Field Type
Description
1
SBASALMANAC Log header. See Messages on page 25 for
Header
more information.
2
Satellite ID
Satellite ID
3
Variant
System variant (refer to Table 178: SBAS Subsystem Types on the next page)
4
Time
Time of day (s)
5
Data ID
Data identification
6
Health
Satellite health
7
X
ECEF X coordinate (m)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
Enum 4
H+4
Ulong 4
Ushort 2
Ushort 2
Long
4
H+8 H + 12 H + 14 H + 16
OEM7 Commands and Logs Reference Manual v10
842
Chapter 3 Logs
Field Field Type
Description
8
Y
9
Z
10
X Velocity
11
Y Velocity
12
Z Velocity
13
CRC
14
[CR][LF]
ECEF Y coordinate (m) ECEF Z coordinate (m) X rate of change (m/s) Y rate of change (m/s) Z rate of change (m/s) 32-bit CRC (ASCII and binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Long
4
H + 20
Long
4
H + 24
Long
4
H + 28
Long
4
H + 32
Long
4
H + 36
Ulong 4
H + 40
-
-
-
Table 178: SBAS Subsystem Types
ASCII Binary Description
NONE
0
No system
UNKNOWN
1
Unknown system
WAAS
2
WAAS system
EGNOS
3
EGNOS system
MSAS
4
MSAS system
GAGAN
5
GAGAN system
QZSS
7
QZSS System
OEM7 Commands and Logs Reference Manual v10
843
Chapter 3 Logs
3.180 SOFTLOADSTATUS
Describes the status of the SoftLoad process
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log describes the status of the SoftLoad process.
Status values >= 16 (ERROR) indicate that an error has occurred during the loading process. Status < 16 (ERROR) are part of normal SoftLoad operation.
Message ID: 1235
Log Type: Asynch
Recommended Input: log softloadstatusa onchanged
ASCII Example: #SOFTLOADSTATUSA,COM1,0,97.5,UNKNOWN,0,0.113,024c0001,2d64,10481;NOT_ STARTED*827fdc04
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
SOFTLOADSTATUS Log header. See Messages on page 25
header
for more information.
-
H
0
2
status
Status of the SoftLoad process see Table 179: SoftLoad Status Type below
Enum
4
H
3
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+4
4
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
Value
Name
1
NOT_STARTED
2
READY_FOR_ SETUP
Table 179: SoftLoad Status Type
Description
SoftLoad process has not begun
SoftLoad process is ready to receive setup information in the form of the SOFTLOADSETUP command or SOFTLOADSREC command with S0 records. Once sufficient setup data has been sent, the process is also ready for the SOFTLOADDATA command
OEM7 Commands and Logs Reference Manual v10
844
Chapter 3 Logs
Value
Name
Description
SoftLoad process is ready to receive data in the form of the
3
READY_FOR_ DATA
SOFTLOADDATA command or SOFTLOADSREC command with S3 records. Once all data has been sent, send the SOFTLOADCOMMIT
command
4
DATA_VERIFIED
SoftLoad data has passed CRC. This status occurs after a SOFTLOADCOMMIT command
5
WRITING_ FLASH
SoftLoad data is being written to flash. This status occurs after a SOFTLOADCOMMIT command. During a firmware upload, the receiver may remain in this state for 300 seconds or longer
6
WROTE_FLASH SoftLoad data has been written to flash
7
WROTE_ AUTHCODE
The embedded AuthCode was successfully written
8
COMPLETE
SoftLoad process has completed. The next step is to send the RESET command to reset the receiver
9
VERIFYING_ DATA
SoftLoad is verifying the downloaded image
10
COPIED_ SIGNATURE_ AUTH
Signature AuthCodes have been copied from the current firmware to the downloaded firmware.
11
WROTE_ TRANSACTION_ TABLE
The downloaded firmware has been activated and will be executed if the receiver is reset. This status is effectively identical to COMPLETE.
16
ERROR
Indicates an internal error in the SoftLoad process. This error is not expected to occur. Contact NovAtel Customer Support for assistance.
17
RESET_ERROR
Error resetting SoftLoad. Reset the receiver and restart the SoftLoad process.
18
BAD_SRECORD
A bad S Record was received. Ensure that S Records are enclosed in double quotes within the SOFTLOADSREC command (see page 362).
19
BAD_PLATFORM
This data cannot be loaded onto this platform. Ensure that the correct *.shex file for the platform is being used.
20
BAD_MODULE
This module cannot be loaded with SoftLoad. This file must be loaded using WinLoad or a similar loader.
21
BAD_ AUTHCODE
Bad AuthCode received for this PSN
22
NOT_READY_ FOR_SETUP
A SOFTLOADSETUP command was entered before a SOFTLOADRESET command or after a SOFTLOADDATA command
OEM7 Commands and Logs Reference Manual v10
845
Chapter 3 Logs
Value
Name
Description
No data type was entered before a SOFTLOADDATA command was
23
NO_MODULE
received. Set the data type using the SOFTLOADSETUP command or
SOFTLOADSREC command with an "S0~T~" S Record.
No platform was entered before a SOFTLOADDATA command was
24
NO_PLATFORM received. Set the platform using the SOFTLOADSETUP command or
SOFTLOADSREC command with an "S0~P~" S Record.
25
NOT_READY_ FOR_DATA
A SOFTLOADDATA command was received but the receiver was not ready for it
26
MODULE_ MISMATCH
The SoftLoad data module was changed in the middle of loading. Restart the SoftLoad process using the SOFTLOADRESET command (see page 359).
27
OUT_OF_ MEMORY
SoftLoad has run out of RAM to store the incoming data. Reset the receiver and restart the SoftLoad process.
SoftLoad data has overlapped. Ensure that the correct address and
28
DATA_OVERLAP length is set in the SOFTLOADDATA command or SOFTLOADSREC
command.
29
BAD_IMAGE_ CRC
CRC of the downloaded image has failed. Ensure that all content from the *.shex file has been successfully downloaded.
30
IMAGE_ OVERSIZE
The downloaded image is too big for the intended data module
31
AUTHCODE_ WRITE_ERROR
An error occurred when writing the embedded AuthCode to flash
32
BAD_FLASH_ ERASE
Erasing of the flash failed. This could indicate a failure in the flash hardware.
33
BAD_FLASH_ WRITE
Writing to the flash failed. This could indicate a failure in the flash hardware.
34
TIMEOUT
SoftLoad time out has occurred
35
INCOMPATIBLE_ FLASH
Application image that does not support the onboard flash rejected
OEM7 Commands and Logs Reference Manual v10
846
Chapter 3 Logs
3.181 SOURCETABLE
NTRIP source table entries
Platform: OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7I
This log outputs the NTRIP SOURCETABLE entries from the NTRIPCASTER set by the NTRIPSOURCETABLE command (see page 256). The entry data field in the first entry is always the header of the retrieved SOURCETABLE. The entry data field in the last entry is always a string "ENDSOURCETABLE" which indicates the end of the source table. Entries in between these fields are the real SOURCETABLE entries.
Message ID: 1344
Log Type: Polled
Recommended Input: log sourcetablea once
ASCII Example: #SOURCETABLEA,COM1,17,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;" hera.novatel.com:2101",0,0,"HTTP/1.1 200 OK;Ntrip-Version: Ntrip/2.0;NtripFlags: st_filter,st_auth,st_match,st_strict,rtsp,plain_rtp;Server: NTRIP Caster/2.0.15;Date: Fri, 27 Jan 2017 18:12:01 GMT;Connection: close;ContentType: gnss/sourcetable;Content-Length: 2057"*87a7d39d
#SOURCETABLEA,COM1,16,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;" hera.novatel.com:2101",0,0,"CAS;hera.novatel.ca;80,2101;NovAtel;NovAtel;0;CAN;5 1;-115;http://www.novatel.com"*e3ec11a0
#SOURCETABLEA,COM1,15,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;" hera.novatel.com:2101",0,0,"NET;GREF;NovAtel;B;N;http://novatel.com;none;novate l.com;none"*2a6b50eb
#SOURCETABLEA,COM1,14,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;" hera.novatel.com:2101",0,0,"STR;novatel_rtcmv3;Office Roof DL1L2;RTCM 3.0;1033 (10),1005(10),1019(60),1020(60),1003(1),1011(1);2;GPS+GLO;NovAtel;CAN;51;115;0;0;NovAtel OEM628;none;B;N;9600;Test"*8a7c760f
#SOURCETABLEA,COM1,13,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;" hera.novatel.com:2101",0,0,"STR;novatel_rtcm;Office Roof DL1L2;RTCM 2.3;1(1),3 (10),31(1),32(10);0;GPS+GLO;NovAtel;CAN;51;-115;0;0;NovAtel OEM628;none;B;N;9600;Test"*08c57cb7
#SOURCETABLEA,COM1,12,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;" hera.novatel.com:2101",0,0,"STR;novatel_rtca;Office Roof DL1L2;RTCA;RTCAREF (10),RTCA1(1),RTCAEPHEM(60);0;GPS;NovAtel;CAN;51;-115;0;0;NovAtel OEM628;none;B;N;9600;Test"*006997bc
#SOURCETABLEA,COM1,11,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;" hera.novatel.com:2101",0,0,"STR;novatel_cmr;Office Roof DL1L2;CMR;CMRREF (10),CMROBS(1),CMRGLOOBS(1);2;GPS+GLO;NovAtel;CAN;51;-115;0;0;NovAtel OEM628;none;B;N;9600;Test"*0955ccb7
OEM7 Commands and Logs Reference Manual v10
847
Chapter 3 Logs
#SOURCETABLEA,COM1,10,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;" hera.novatel.com:2101",0,0,"STR;novatel_rtcaobs2;Office Roof DL1L2;RTCA;rtcaref (10),rtcaobs2(1),rtcaephem(60);2;GPS+GLO;NovAtel;CAN;51;-115;0;0;NovAtel OEM628;none;B;N;9600;Test"*426e39a5
#SOURCETABLEA,COM1,9,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"STR;novatel_cmrplus;Office Roof DL1L2;CMR+;cmrplus (1),cmrobs(1),cmrgloobs(1);2;GPS+GLO;NovAtel;CAN;51;-115;0;0;NovAtel OEM628;none;B;N;9600;Test"*2d5ba56e
#SOURCETABLEA,COM1,8,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"STR;novatel_rtcm2021;Office Roof DL1L2;RTCM 2.3;3 (10),2021(1);2;GPS+GLO;NovAtel;CAN;51;-115;0;0;NovAtel OEM628;none;B;N;9600;Test"*d82df5de
#SOURCETABLEA,COM1,7,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"STR;novatel_1819;Office Roof DL1L2;RTCM 2.3;3(10),22 (10),23(60),24(60),1819(1);2;GPS+GLO;NovAtel;CAN;51;-115;0;0;NovAtel OEM628;none;B;N;9600;Test"*7aead153
#SOURCETABLEA,COM1,6,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"STR;novatel_rtcaobs;Office Roof DL1L2;RTCA;rtcaref (10),rtcaobs(1),rtcaephem(60);2;GPS+GLO;NovAtel;CAN;51;-115;0;0;NovAtel OEM628;none;B;N;9600;Test"*530a51c4
#SOURCETABLEA,COM1,5,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"STR;novatel_novatelx;Office Roof;NovatelX;novatelobs;2;GPS+GLO;NovAel;CAN;51;-114;0;0;NovAtel OEM628;none;B;N;9600;Test"*4438c2e2
#SOURCETABLEA,COM1,4,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"STR;Hyderabad1;hyderabad test1;unknown;unknown;2;GPS+GLO;NovAtel;INDIA;17;78;0;0;NovAtel OEM628;none;B;N;9600;Test"*de6c19f0
#SOURCETABLEA,COM1,3,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"STR;Hyderabad2;hyderabad test1;unknown;unknown;2;GPS+GLO;NovAtel;INDIA;17;78;0;0;NovAtel OEM628;none;B;N;9600;Test"*27e9eee1
#SOURCETABLEA,COM1,2,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"STR;Hyderabad3;hyderabad test1;unknown;unknown;2;GPS+GLO;NovAtel;INDIA;17;78;0;0;NovAtel OEM628;none;B;N;9600;Test"*3ed5941b
#SOURCETABLEA,COM1,1,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"STR;Hyderabad4;hyderabad test1;unknown;unknown;2;GPS+GLO;NovAtel;INDIA;17;78;0;0;NovAtel OEM628;none;B;N;9600;Test"*a3a188e2
#SOURCETABLEA,COM1,0,84.0,COARSESTEERING,1933,497547.000,02400020,71dd,32768;"h era.novatel.com:2101",0,0,"ENDSOURCETABLE"*7758fba9
OEM7 Commands and Logs Reference Manual v10
848
Chapter 3 Logs
Field Field Type
Description
Format
1
SOURCETABLE Log header. See Messages on
header
page 25 for more information.
2
endpoint
NTRIPCASTER Endpoint
String with varied length up to 80 bytes
3
Reserved1
reserved
Ulong
4
Reserved2
reserved
Ulong
5
Entry data
Source table entry data
String with varied length up to 512 bytes
6
xxxx
32-bit CRC (ASCII and binary only)
Ulong
7
[CR][LF]
Sentence terminator (ASCII only)
-
Binary Binary Bytes Offset
H
0
a1
H
4
H+a
4
H+a+4
b1
H+a+8
4
H+a+b+8
-
-
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
849
Chapter 3 Logs
3.182 TERRASTARINFO
TerraStar subscription information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains details on the TerraStar subscription.
Message ID: 1719
Log Type: Asynch
Recommended Input: log terrastarinfoa onchanged
ASCII Example: #TERRASTARINFOA,COM1,0,65.5,UNKNOWN,0,1.168,02040008,E776,13260;"QR391:3006:617 9",TERM,00000301,167,2015,0,NONE,0.00000,0.00000,0*7E4A9EC0
Field Field type
Description
1
TERRASTAR INFO header
Log header. See Messages on page 25 for more information.
2
PAC
Product activation code
3
Type
Subscription type (see Table 180: TerraStar Subscription Type on the next page)
Services permitted by the subscription (see
Table 181: TerraStar Subscription Details
4
Subscription Mask on the next page) permissions Note: Bits in the Reserved areas of this field
may be set, but the Reserved bits should be
ignored.
Day of the year when the subscription ends. Service ends at 00:00 UTC on this day.
5
Service End For example, if the TerraStar service end
Day
date/time is 2015-06-15 00:01:05 HRS UTC
(DOY = 166), then the Service End DOY will
indicate it as 167 and Service End Year will
indicate it as 2015.
6
Service End Year
Year that subscription ends
7
Reserved
Format
Binary Bytes
Binary Offset
H
0
Char [16]
16
Enum 4
H H+16
Hex
4
H+20
Ulong 4
H+24
Ulong 4 Ulong 4
H+28 H+32
OEM7 Commands and Logs Reference Manual v10
850
Chapter 3 Logs
Field Field type
Description
Format
Binary Bytes
Binary Offset
8
Region restriction
For region restricted subscriptions, the type of region restriction (see Table 182: TerraStar Region Restriction on the next page)
Enum
4
H+36
9
Center point For local area subscriptions, the center point
latitude
latitude (degrees)
Float
4
H+40
10
Center point For local area subscriptions, the center point
longitude
longitude (degrees)
Float
4
H+44
11
Radius
For local area subscriptions, the maximum permitted distance from center point (kilometers)
Ulong 4
H+48
12
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+52
13
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
ASCII UNASSIGNED TERM MODEL
BUBBLE INCOMPATIBLE_ SUBSCRIPTION
Table 180: TerraStar Subscription Type
Binary
Description
0
Decoder has not had an assigned operating mode
1
Term subscription
5
Receiver is operating with an RTK assist enabled model and there is not an active TerraStar subscription installed
100
Receiver is operating in a TerraStar-permitted subscription-free bubble
104 Subscription is incompatible with this version of firmware
Table 181: TerraStar Subscription Details Mask
Bit
Mask
Description
0-8 0x000001FF Reserved
9
0x00000200 TerraStar-C service
10
0x00000400 TerraStar-L service
11
0x00000800 RTK ASSIST service
12
0x00001000 RTK ASSIST PRO service
13
0x00002000 TerraStar-C PRO service
14-31 0xFFFFC000 Reserved
OEM7 Commands and Logs Reference Manual v10
851
Chapter 3 Logs
Table 182: TerraStar Region Restriction
ASCII
Binary
Description
NONE
0
TerraStar operation has no region restrictions.
GEOGATED
TerraStar operation limited to on-land 1
GEOGATED is also the default value reported if there is no subscription
LOCAL_AREA
2
TerraStar operation limited to radius from local area center point
NEARSHORE
3
TerraStar operation limited to on land and near shore (coastal) regions
OEM7 Commands and Logs Reference Manual v10
852
Chapter 3 Logs
3.183 TERRASTARSTATUS
TerraStar decoder and subscription status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains status information for the TerraStar decoder and subscription.
Message ID: 1729
Log Type: Asynch
Recommended Input: log terrastarstatusa onchanged
ASCII Example: #TERRASTARSTATUSA,COM1,0,49.5,FINESTEERING,1769,332336.443,02000000,fdc1,12602; ENABLE,LOCKED,0,DISABLED,ONSHORE*555155a5
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
TERRASTAR STATUS header
Log header. See Messages on page 25 for more information.
H
0
2
Access
Access status. ENABLE (1) if the subscription is valid; DISABLE (0) otherwise
Enum
4
H
Decoder data synchronization state (see Table
3
Sync state 183: Decoder Data Synchronization State on Enum 4
the next page)
H+4
4
Reserved
Ulong 4
H+8
For local-area subscriptions, indicates if the
5
Local area status
receiver is within the permitted area (see Table 184: TerraStar Local Area Status on the
Enum
4
next page)
H+12
6
Geogating Geogating status (see Table 185: TerraStar
status
Geogating Status on the next page)
Enum 4
H+16
7
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+20
8
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
853
Chapter 3 Logs
Table 183: Decoder Data Synchronization State
ASCII Binary
Description
NO_SIGNAL
0
None of the decoders have received data in the last 30 seconds
SEARCH
1
At least one decoder is receiving data and is searching for the format
LOCKED
2
At lease one decoder has locked onto the format
Table 184: TerraStar Local Area Status
ASCII
Binary
Description
DISABLED
The subscription is not restricted to a local area. 0
This is also the value when there is no subscription.
WAITING_FOR_POSITION
1
Waiting for a position
RANGE_CHECK
16 Checking position against local area region restriction
IN_RANGE
129 Receiver is within the permitted local area
OUT_OF_RANGE
130 Receiver is outside the permitted local area
POSITION_TOO_OLD
255 Position is too old
ASCII
DISABLED
WAITING_FOR_ POSITION ONSHORE OFFSHORE POSITION_TOO_OLD PROCESSING
Table 185: TerraStar Geogating Status
Binary
Description
The subscription is restricted to a local area or there is no region
0
restriction.
This is also the value when there is no subscription.
1
Waiting for a position
129 130 255 1000
Receiver is over land Receiver is over water Position is too old Geogater is determining status
OEM7 Commands and Logs Reference Manual v10
854
Chapter 3 Logs
3.184 TIME
Time data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log provides several time related pieces of information including receiver clock offset and UTC time and offset. It can also be used to determine any offset in the PPS signal relative to GPS reference time. To find any offset in the PPS signal, log the TIME log 'ontime' at the same rate as the PPS output. For example, if the PPS output is configured to output at a rate of 0.5 seconds (see the PPSCONTROL command on page 277) log the TIME log 'ontime 0.5' as follows:
log time ontime 0.5 The TIME log offset field can then be used to determine any offset in PPS output relative to GPS reference time.
GPS reference time is the receiver's estimate of the true GPS system time. GPS reference time can be found in the header of the TIME log. The relationship between GPS reference time and true GPS system time is: GPS system time = GPS reference time - offset
Message ID: 101
Log Type: Synch
Recommended Input: log timea ontime 1
ASCII Example: #TIMEA,COM1,0,86.5,FINESTEERING,1930,428348.000,02000020,9924,32768;VALID, 1.667187222e-10,9.641617960e-10,-18.00000000000,2017,1,5,22,58,50000,VALID *2a066e78
OEM7 Commands and Logs Reference Manual v10
855
Chapter 3 Logs
1. Consider the case where you used the ADJUST1PPS command (see page 53) to synchronize two receivers in a primary/secondary relationship to a common external clock. You can use the TIME log after the clock model status is valid to monitor the time difference between the Primary and Secondary receivers.
2. The header of the TIME log gives you the GPS reference time (the week number since January 5th, 1980) and the seconds into that week. The TIME log outputs the UTC offset (offset of GPS system time from UTC time) and the receiver clock offset from GPS system time.
If you want the UTC time in weeks and seconds, take the week number from the header. Then take the seconds into that week, also from the header, and add the correction to the seconds using the 2 offsets. Ensure not to go negative or rollover (go over the total number of seconds, 604800, in a week). In the case of a rollover, add a week and the left over seconds become the seconds into this new week. If negative, subtract a week and the remainder from the seconds of that week become the seconds into this new week.
For example:
TIME COM1 0 73.5 FINESTEERING 1432 235661.000 02000000 9924 2616 VALID -0.000000351 0.000000214 -14.00000000106 2007 6 19 17 27 27000 VALID
From the time information above:
GPS reference time = 1432 (GPS reference week), 235661.000 (GPS seconds) from the header.
From the description in UTC offset row in the following table:
UTC time = GPS reference time - offset + UTC offset UTC time
= week 1432, 235661.000 s � (- 0.000000351 (offset) ) - 14.00000000106 (UTC offset) = week 1432, seconds 235647.00000034994
Field
Field type
1
TIME header
2
clock status
Description
Log header. See Messages on page 25 for more information.
Clock model status (not including current measurement data), see Table 87: Clock Model Status on page 462
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
856
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
Receiver clock offset in seconds from GPS
system time. A positive offset implies that the
receiver clock is ahead of GPS system time. To
derive GPS system time, use the following
3
offset
formula:
Double 8
GPS system time = GPS reference time - offset.
The GPS reference time can be obtained from the log header.
H+4
4
offset std Receiver clock offset standard deviation (s)
Double 8
H+12
The offset of GPS system time from UTC time,
computed using almanac parameters. UTC time
is GPS reference time plus the current UTC offset
5
utc offset minus the receiver clock offset:
Double 8
UTC time = GPS reference time - offset + UTC offset
H+20
6
utc year UTC year
Ulong 4
H+28
UTC month (0-12)
7
utc month
Uchar 1
If UTC time is unknown, the value for month is 0.
H+32
UTC day (0-31)
8
utc day
Uchar 1
If UTC time is unknown, the value for day is 0.
H+33
9
utc hour UTC hour (0-23)
Uchar 1
H+34
10
utc min UTC minute (0-59)
Uchar 1
H+35
UTC millisecond (0-60999)
11
utc ms
Ulong 4
Maximum of 60999 when leap second is applied.
H+36
UTC status
0 = Invalid
12
utc status
1 = Valid
2 = Warning1
Enum 4
H+40
13
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+44
14
[CR][LF] Sentence terminator (ASCII only)
-
-
-
1Indicates that the leap second value is used as a default due to the lack of an almanac. OEM7 Commands and Logs Reference Manual v10
857
Chapter 3 Logs
3.185 TIMESYNC
Synchronize time between GNSS receivers
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The TIMESYNC log is used in conjunction with the ADJUST1PPS command (see page 53) to synchronize the time between GNSS receivers.
Message ID: 492
Log Type: Synch
Recommended Input: log timesynca ontime 1
ASCII Example: #TIMESYNCA,COM1,0,46.0,FINESTEERING,1337,410095.000,02000000,bd3f,1984;1337, 410095000,FINESTEERING*aa2025db
The time data embedded in this log represents the time of the most recent 1PPS signal. The receiver issues this log from a communications port within 200 ms of the last 1PPS event. The 200 ms value is a "worst case scenario." Refer to Figure 2: 1PPS Alignment on page 54 to see the alignment between a Fine and a Cold Clock receiver. Also refer to the Transfer Time Between Receivers section in the OEM7 Installation and Operation User Manual.
Field
Field type
Description
Format
Binary Bytes
Binary Offset
1
TIMESYNC Log header. See Messages on page 25 for more
header
information.
H
0
2
week
GPS reference week number
Ulong 4
H
3
ms
Number of milliseconds into the GPS reference week
Ulong
4
H+4
4
time status
GPS reference time Status, see Table 11: GPS Reference Time Status on page 45
Enum
4
H+8
5
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+12
6
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
858
Chapter 3 Logs
3.186 TRACKSTAT
Tracking status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
The TRACKSTAT log contains an entry for each channel. If there are multiple signal channels for one satellite (for example L1, L2 P(Y), L2C, and L5 for GPS), then there will be multiple entries for that satellite.
As shown in Table 133: Channel Tracking Status on page 692 these entries can be differentiated by bit 20, which is set if there are multiple observables for a given satellite, and bits 21-25, which denote the signal type for the observation.
A zero in the PRN/slot of the TRACKSTAT log indicates the channel should be considered idle with the exception of those for GLONASS. A GLONASS channel should only be considered idle if the tracking state is 0 in the channel tracking status word.
For dual antenna receivers, a TRACKSTAT_1 log can be requested to get TRACKSTAT data from the second antenna. As described in Table 3: Binary Message Header Structure on page 30, the message type indicates the log is from the second antenna. To request an ASCII log enter TRACKSTATA_1 and for a binary log enter TRACKSTATB_1.
Message ID: 83
Log Type: Synch
Recommended Input: log trackstata ontime 1
ASCII Example: #TRACKSTATA,COM1,0,49.5,FINESTEERING,1337,410139.000,02000000,457c,1984; SOL_COMPUTED,PSRDIFF,5.0,30, 1,0,18109c04,21836080.582,-2241.711,50.087,1158.652,0.722,GOOD,0.973, 1,0,11309c0b,21836083.168,-1746.788,42.616,1141.780,0.000,OBSL2,0.000, 30,0,18109c24,24248449.644,-2588.133,45.237,939.380,-0.493,GOOD,0.519, 30,0,11309c2b,24248452.842,-2016.730,38.934,939.370,0.000,OBSL2,0.000, ... 14,0,18109da4,24747286.206,-3236.906,46.650,1121.760,-0.609,GOOD,0.514, 14,0,11309dab,24747288.764,-2522.270,35.557,1116.380,0.000,OBSL2,0.000, 0,0,0c0221c0,0.000,0.000,0.047,0.000,0.000,NA,0.000, 0,0,0c0221e0,0.000,0.000,0.047,0.000,0.000,NA,0.000*255a732e
Field Field Type
Description
1
TRACKSTAT Log header. See Messages on page 25 for
header
more information.
Format
Binary Bytes
Binary Offset
H
0
OEM7 Commands and Logs Reference Manual v10
859
Chapter 3 Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
2
sol status
Solution status (see Table 74: Solution Status on page 436)
Enum
4
H
3
pos type
Position type (see Table 75: Position or Velocity Type on page 437)
4
cutoff
GPS tracking elevation cut-off angle
5
# chans
Number of hardware channels with information to follow
Enum 4
Float
4
Ulong 4
H+4 H+8 H+12
Satellite PRN number of range measurement
6
PRN/slot
Short 2
Refer to PRN Numbers on page 44
H+16
7
glofreq
(GLONASS Frequency + 7), see GLONASS Slot and Frequency Numbers on page 43
Short
2
H+18
8
ch-tr-status
Channel tracking status (see Table 133: Channel Tracking Status on page 692)
Ulong 4
H+20
9
psr
Pseudorange (m) - if this field is zero but the channel tracking status in the previous field indicates that the card is phase locked and code locked, the pseudorange has not been calculated yet
Double 8
H+24
10
Doppler
Doppler frequency (Hz)
Float
4
H+32
11
C/No
Carrier to noise density ratio (dB-Hz)
Float
4
H+36
12
locktime
Number of seconds of continuous tracking (no cycle slips)
Float
4
H+40
13
psr res
Pseudorange residual from pseudorange filter (m)
Float
4
H+44
14
reject
Range reject code from pseudorange filter (see Table 80: Observation Statuses on page 443)
Enum 4
H+48
15
psr weight Pseudorange filter weighting
Float
4
H+52
16... Next PRN offset = H+16+(#chans x 40)
17
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+16 (#chans x 40)
18
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
860
Chapter 3 Logs
3.187 TRANSFERPORTSTATUS
Display the state of the USB transfer port
Platform: PwrPak7 This log displays the current state of the USB transfer port.
Message ID: 2114
Log Type: Asynch
Recommended Input: log transferportstatusa onchanged
ASCII Example: #TRANSFERPORTSTATUSA,COM1,0,86.5,UNKNOWN,0,10.551,02100000,4b3f,32768;USBSTICK, HOST*9f7ad7be
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
TRANSFERPORTSTATUS Log header. See Messages on
header
page 25 for more information.
-
H
0
Type of connection detected
2
USB Detection Type
See Table 186: USB Detection
Enum 4
H
Type below
3
USB Mode
Current USB operation mode See Table 187: USB Mode on the Enum 4 next page
H+4
4
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+8
5
[CR][LF]
Sentence terminator (ASCII only) -
-
-
Table 186: USB Detection Type
Binary ASCII
Description
0
NONE
Nothing is detected
1
USBSTICK A flash drive is detected
2
PC
A computer is detected
3
ERROR
This is an error state
OEM7 Commands and Logs Reference Manual v10
861
Chapter 3 Logs
Table 187: USB Mode
Binary
ASCII
Description
0
DEVICE
The USB port is in device mode
1
HOST
The USB port is in host mode
2
OTG
The USB port is in OTG mode
3
INVALID
The USB port is in an invalid mode
4
NONE
The USB port is not in an operation mode
5
TRANSITION The USB port operation mode is transitioning
OEM7 Commands and Logs Reference Manual v10
862
Chapter 3 Logs
3.188 UPTIME
Report the running time of the receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log reports the number of seconds the receiver's firmware has been running, after the application of power or after the completion of a reset.
Message ID: 1777
Log Type: Polled
Recommended Input: log uptime once
ASCII Example: #UPTIMEA,COM1,0,80.0,FINESTEERING,1928,495123.000,02000020,27d2,32768;151639*01 3e11a7
151639 seconds since power-on = 42.1 hours.
Field
Field Type
1
UPTIME header
2
Uptime
3
xxxx
4
[CR][LF]
Description
Log header. See Messages on page 25 for more information. The number of seconds the receiver has been running after a power up or reset. 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
Hex
4
-
-
H H+4 -
OEM7 Commands and Logs Reference Manual v10
863
Chapter 3 Logs
3.189 USERANTENNA
Display user defined antennas
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This log lists the stored used defined antennas and their parameters.
Message ID: 2282
Recommended input: log userantennaa onchanged
ASCII Example: #USERANTENNAA,COM1,1,80.5,UNKNOWN,0,1.101,02000020,7fac,32768;USER_ANTENNA_1, "NOVCUSTOM",2,GPSL1,0.09,0.00,51.74,0.00,-0.02,-0.10,-0.20,0.23,-0.17,-0.03, 0.14,0.25,0.25,0.07,-0.23,-0.54,-0.67,-0.49,-0.01,0.55,0.83,0.46,GPSL2,-1.53, 1.65,52.00,0.00,0.00,0.00,-0.02,-0.12,-0.28,-0.47,-0.61,-0.56,-0.28,0.23,0.83, 1.28,1.30,0.76,-0.15,-0.94,-0.81,0.97*8b6fb25e
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
USERANTENNA Log header. See Messages on page 25 for
header
more information.
H0
User defined antenna type
2
Antenna type See Table 188: User-Defined Antenna
Type on the next page
Enum
4H
3
Antenna name Name of the user defined antenna
Char [16]
16 H+4
4
Number of frequencies
Number of frequencies for which corrections are stored
Ulong
8 H+20
The frequency for which the phase center
5
Frequency
corrections are valid
Enum
See Table 19: Frequency Type on page 83
4 H+28
6
NorthOffset
North phase center offset in millimetres
Float
4 H+32
7
EastOffset
East phase center offset in millimetres
Float
4 H+36
8
UpOffset
Up phase center offset in millimetres
Float
4 H+40
9
PCVArray
19 element array of Phase Center Variations, in millimetres, in 5-degree elevation increments from 90 to 0
Float [19]
76 H+44
10
Next Frequency = H + 28 + (Number of frequencies x 92)
OEM7 Commands and Logs Reference Manual v10
864
Chapter 3 Logs
Field Field Type
Description
11
xxxx
12
[CR][LF]
32-bit CRC (ASCII and binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Hex
4
Variable
�
�
�
Table 188: User-Defined Antenna Type
Binary
ASCII
1001
USER_ANTENNA_1
1002
USER_ANTENNA_2
1003
USER_ANTENNA_3
1004
USER_ANTENNA_4
1005
USER_ANTENNA_5
OEM7 Commands and Logs Reference Manual v10
865
Chapter 3 Logs
3.190 USERI2CRESPONSE
Status of USERI2CREAD or USERI2CWRITE Command
Platform: OEM7600, OEM7700, OEM7720
This log reports the status of a previously executed USERI2CREAD or USERI2CWRITE command. There is one log emitted for each command that is executed.
For the USERI2CREAD command (see page 397), this log outputs the data read from the device on the I2C bus and the status of the read operation.
For the USERI2CWRITE command (see page 399), the status of the write operation is reported and the data field will always be 0.
Message ID: 2234
Recommended Input: log USERI2CRESPONSE onnew
Abbreviated ASCII Example 1:
USERI2CREAD 70 4 aabbccdd 12 6789
<USERI2CRESPONSE COM1 0 84.0 FINESTEERING 1994 257885.895 02000000 e3f6 32768
<
70 aabbccdd OK READ 6789 12 000102030405060708090a0b
Abbreviated ASCII Example 2:
USERI2CWRITE 70 3 aabbcc 8 0001020304050607 12345
<USERI2CRESPONSE COM1 0 84.0 FINESTEERING 1994 257885.895 02000000 e3f6 32768
<
70 aabbcc OK WRITE 12345 0
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
USERI2CRESPONSE Log header. See Messages for more
header
information.
-
H
0
The 7 bit address of the I2C device. Valid values are 0 through 127.
For ASCII and Abbreviated
2
DeviceAddress
commands, this field is a hexadecimal Uchar
11
H
string of two digits. There is no 0x
prefix and spaces are not allowed in
the string.
1In the binary case, additional bytes of padding are added after this field to maintain 4-byte alignment for the fields that follow.
OEM7 Commands and Logs Reference Manual v10
866
Chapter 3 Logs
Field
Field Type
3
RegisterAddress
4
ErrorCode
5
OperationMode
6
TransactionID
7
ReadDataLength
8
ReadData
Description
Format
Binary Bytes
Binary Offset
The actual register address used for
the operation. This is a ULONG value in hexadecimal format (without 0x
Ulong
4
prefix).
H+4
Error code for the operation. See Table 189: Error Code below.
Enum
4
H+8
Operation mode code. See Table 190:
Operation Mode Code on the next
Enum
4
page.
H+12
This is the copy of Transaction ID provided to the command.
Ulong
4
H+16
For a Read operation, this is the actual
number of bytes read from the I2C
device.
Ulong
4
For a Write operation, this value is always zero.
H+20
For a Read operation, this is the data
read from the device. For ASCII logs
this field is displayed as a string of
hexadecimal digits, with two digits per
byte. The first byte retrieved from the
I2C device is the first byte displayed and so on.
HEXBYTE ARRAY
Y
The maximum size of this field is 256 bytes.
When ReadDataLength is zero, this field will be empty.
H+24
Table 189: Error Code
Binary
ASCII
Description
0
OK
I2C transaction is successful
1
IN_PROGRESS
I2C transaction is currently in progress
2
DATA_TRUNCATION I2C transaction read data was truncated
3
BUS_BUSY
I2C bus is busy
4
NO_DEVICE_REPLY No device replied to the I2C transaction request
5
BUS_ERROR
I2C bus error or bus arbitration lost
OEM7 Commands and Logs Reference Manual v10
867
Chapter 3 Logs
Binary
ASCII
Description
6
TIMEOUT
I2C transaction has timed out
7
UNKNOWN_FAILURE I2C transaction has an unexplained failure
Table 190: Operation Mode Code
Binary ASCII
Description
0
NONE
No Operation
1
READ
Read Operation
2
WRITE
Write Operation
3
SHUTDOWN Shut down Operation
OEM7 Commands and Logs Reference Manual v10
868
Chapter 3 Logs
3.191 VALIDMODELS
Valid model information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log gives a list of valid authorized models available and expiry date information. If a model has no expiry date, it reports the year, month and day fields as 0, 0 and 0 respectively.
Message ID: 206
Log Type: Asynch
Recommended Input: log validmodelsa once
ASCII Example: #VALIDMODELSA,COM1,0,92.0,FINESTEERING,1610,499139.682,02000000,342f,6293;1,"D2 LR0RCCR",0,0,0*d0580c1b
Use the VALIDMODELS log to output a list of available models for the receiver. Use the AUTH command (see page 76), to add a model and the MODEL command (see page 243) to change the currently active model. See the VERSION log on page 874 for the currently active model
Field Field type
Description
1
VALIDMODELS Log header. See Messages on
header
page 25 for more information.
2
#mod
Number of models with information to follow
3
model
Model name
4
expyear
Expiry year
5
expmonth
Expiry month
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
String [Max16]
Variable
1
H+4
Ulong 4
Variable Max: H+20
Ulong 4
Variable Max: H+24
1In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.
OEM7 Commands and Logs Reference Manual v10
869
Chapter 3 Logs
Field Field type
Description
6
expday
Expiry day
Format
Binary Bytes
Ulong 4
Binary Offset
Variable: Max: H+28
7... Next model offset = H+4+(#mod x variable [max:28])
8
xxxx
32-bit CRC (ASCII and Binary only) Ulong 4
H+4+ (#mod x variable [max:28])
9
[CR][LF]
Sentence terminator (ASCII only) -
-
-
OEM7 Commands and Logs Reference Manual v10
870
Chapter 3 Logs
3.192 VERIPOSINFO
Veripos subscription information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains details on the Veripos subscription.
Message ID: 1728
Log Type: Asynch
Recommended Input: log veriposinfoa onchanged
ASCII Example: #VERIPOSINFOA,COM2,0,60.5,FINESTEERING,1779,176287.725,02044008,31fa,12740;3203 25,NCC_CONTROLLED,00000101,"Q"*26a9f04e
Field Field type
Description
1
VERIPOSINFO Log header. See Messages on page 25 for
header
more information.
2
Serial number
Receiver serial number
3
Mode
Operating mode (see Table 191: Veripos Operating Mode below)
4
Details
Subscription details (refer to Table 192: Veripos Subscription Details Mask on the next page)
5
Service code Veripos service code
6
xxxx
32-bit CRC (ASCII and Binary only)
7
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
H
0
Ulong 4
H
Enum 4
H+4
Hex
4
Char[4] 4
Ulong 4
-
-
H+8
H+12 H+16 -
ASCII UNASSIGNED NCC_ CONTROLLED NO_DISABLE
Table 191: Veripos Operating Mode
Binary
Description
0
Decoder has not had an assigned operating mode
7
Decoder operation disabled by a command from the Network Control Center (NCC)
8
Decoder operation not disabled
OEM7 Commands and Logs Reference Manual v10
871
Chapter 3 Logs
ASCII
Binary
Description
BUBBLE
100 Decoder is operating in a Veripos permitted subscription-free bubble
MODEL_DENIED 101 Decoder operation is not permitted on the current firmware model
Table 192: Veripos Subscription Details Mask
Bit Mask
Description
0 0x001 Subscription permits differential positioning
8 0x100 Subscription permits Apex PPP positioning
OEM7 Commands and Logs Reference Manual v10
872
Chapter 3 Logs
3.193 VERIPOSSTATUS
Veripos decoder and subscription status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains status information for the Veripos decoder and subscription.
Message ID: 1730
Log Type: Asynch
Recommended Input: log veriposstatusa onchanged
ASCII Example: #VERIPOSSTATUSA,COM2,0,62.0,FINESTEERING,1779,176955.656,02004008,0719,12740;EN ABLE,LOCKED*7c5f85ae
Field Field type
Description
Format
Binary Bytes
Binary Offset
1
VERIPOSSTATUS Log header. See Messages on page 25 for
header
more information.
H
0
2
Access
Access status. ENABLE (1) if the subscription is valid; DISABLE (0) otherwise
Enum 4
H
3
Sync state
Decoder data synchronization state (see Table 193: Decoder Data Synchronization Enum 4 State below)
H+4
4
xxxx
32-bit CRC (ASCII and Binary only)
Ulong 4
H+8
5
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
Table 193: Decoder Data Synchronization State
ASCII Binary
Description
NO_SIGNAL
0
None of the decoders have received data in the last 30 seconds
SEARCH
1
At least one decoder is receiving data and is searching for the format
LOCKED
2
At lease one decoder has locked onto the format
OEM7 Commands and Logs Reference Manual v10
873
Chapter 3 Logs
3.194 VERSION
Version information
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the version information for all components of a system. When using a standard receiver, there is only one component in the log.
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 195: Firmware and Boot Version Field Formats on page 877 for details on the format of key fields.
See also the VALIDMODELS log on page 869.
Message ID: 37
Log Type: Polled
Recommended Input: log versiona once
ASCII Example:
<VERSION USB1 0 72.0 FINESTEERING 2025 247123.828 02000020 3681 14970
< 11
<
GPSCARD "FFNRNNCBES1" "BMHR17090005E" "OEM7700-1.00" "OM7CR0500RN0000"
"OM7BR0001RB0000" "2018/Jul/10" "14:37:01"
<
OEM7FPGA "" "" "" "OMV070001RN0000" "" "" ""
<
WHEELSENSOR "" "" "" "SWS000101RN0000" "" "2018/Jul/10" "14:37:28"
<
WIFI "RS9113" "" "" "1.6.8" "" "2018/Jul/10" "14:37:32"
<
APPLICATION "" "" "" "EP7AR0500RN0000" "" "2018/Jul/10" "14:37:13"
<
DEFAULT_CONFIG "" "" "" "EP7CR0500RN0000" "" "2018/Jul/10" "14:37:23"
<
PACKAGE "" "" "" "EP7PR0500RN0000" "" "2018/Jul/10" "14:37:18"
<
DB_WWWISO "WWWISO" "0" "" "WMC010201AN0004" "" "2017/Sep/20" "21:00:04"
<
ENCLOSURE "" "NMNE17200009B" "" "" "" "" ""
<
REGULATORY "US" "" "" "" "" "" ""
<
IMUCARD "Epson G320N" "" "" "" "" "" ""
The VERSION log is a useful log as a first communication with your receiver. Once connected, using NovAtel Connect 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
1
VERSION Log header. See Messages on page 25 for more header information.
Format
Binary Bytes
Binary Offset
H
0
OEM7 Commands and Logs Reference Manual v10
874
Chapter 3 Logs
Field
Field type
Description
Format
Binary Bytes
Binary Offset
2
# comp Number of components (cards, and so on)
Long
4
H
3
type
Component type (see Table 194: Component Types on the next page)
Enum 4
H+4
4
model
OEM7 firmware model number e.g., CFNPNNTVN indicates the receiver's current model functionality
Char [16]
16
H+8
5
psn
Product serial number
Char [16]
16
H+24
Hardware version in the format:
P-R
6
hw version
Where P = hardware platform
R = hardware revision
Example: OEM7700-1.00
Char [16]
16
H+40
7
sw version
Firmware version, see Table 195: Firmware and Char
Boot Version Field Formats on page 877
[16]
16
H+56
8
boot version
Boot code version, see Table 195: Firmware and Char
Boot Version Field Formats on page 877
[16]
16
H+72
Firmware compile date in the format:
YYYY/Mmm/DD
9
comp date
Where YYYY = year
Mmm = month
DD = day (1-31)
Example: 2018/Jul/10
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
Char [12]
12
H+100
11... Next component offset = H + 4 + (#comp x 108)
OEM7 Commands and Logs Reference Manual v10
875
Chapter 3 Logs
Field
Field type
Description
12
xxxx
32-bit CRC (ASCII and Binary only)
13
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+4+ (#comp x 108)
-
-
-
Table 194: Component Types
Binary
ASCII
Description
0
UNKNOWN
Unknown component
OEM7 family receiver
1
GPSCARD
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
981073920 (0x3A7A0000) DB_HEIGHTMODEL Height/track model data
OEM7 Commands and Logs Reference Manual v10
876
Chapter 3 Logs
Binary
ASCII
981073928 (0x3A7A0008) DB_WWWISO
981073930 (0x3A7A000A) DB_LUA_SCRIPTS
Description Web UI ISO Image Lua Script ISO Image
Table 195: Firmware and Boot Version Field Formats
Field Format (ASCII)
Description
Example
N = Family Name NWXYZFFMMRN0000 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 both examples, the Maintenance Release Number is 00.
OEM7 Commands and Logs Reference Manual v10
877
Chapter 3 Logs
Field Format (ASCII)
Description
R = Release Type The Release Type can be: A: Alpha B: Beta R: Release S: Special E: Engineering Special C: Customer Approved Special
N = Distribution Permit The Distribution Permit can be: N: No restrictions B: Boot Code H: High Speed Build (Requires a permit to use)
0000 = Minor Release Indicator
Example
In both examples, the Release Type is R.
In the Software Version example, the Distribution Permit is N. In the Boot Version example, the Distribution Permit is B.
In both examples, the Minor Release Indicator is 0000.
OEM7 Commands and Logs Reference Manual v10
878
Chapter 3 Logs
3.195 WIFIAPSETTINGS
Display the Wi-Fi access point configuration
Platform: PwrPak7, SMART7-I, SMART7-W Use this log to display the Wi-Fi access point configuration. If the access point is not currently operational, the log reports the access point configuration to be applied the next time the WIFIMODE AP or WIFIMODE CONCURRENT command is received.
The term passkey and password are the same.
Message ID: 2093
Log Type: Polled
Recommended Input: LOG WIFIAPSETTINGS
ASCII Example: #WIFIAPSETTINGSA,COM1,0,77.5,FINESTEERING,2007,167962.000,02000000,fc0e,14693;" PwrPak7NMNE16470005M","12345678",2P4GHZ,WPA2,CCMP,US,11,"2d:43:5a:63:79:6f"*546c6f08
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
WIFIAPSETTINGS Log header. See Messages on page 25
header
for more information.
-
H
0
2
SSID
SSID of the AP
String [Max 33]
Variable H
3
passkey
Passkey of the AP
String [Max 65]
Variable Variable
4
band
Wi-Fi operating band. See Table 196: Wi-Fi Band on the next page.
Enum
4
Variable
Wireless security protocol. See Table
5
security protocol 197: Wi-Fi Security Protocol on the
Enum 4
next page.
Variable
6
encryption
Wireless encryption type. See Table 198: Wi-Fi Encryption Type on the next Enum 4 page.
Variable
OEM7 Commands and Logs Reference Manual v10
879
Chapter 3 Logs
Field
Field Type
7
region
8
channel
9
BSSID
10
xxxx
11
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Regulatory region. See Table 199: Regulatory Region on the next page.
Enum 4
Variable
Wireless channel used by access point to communicate with connected clients.
Int
4
Variable
BSSID of the AP (MAC of the Wi-Fi interface)
String [Max 18]
Variable Variable
32-bit CRC (ASCII or Binary only)
Hex
4
Variable
Sentence terminator (ASCII only)
-
-
-
Table 196: Wi-Fi Band
Binary ASCII Description
1
2P4GHZ 2.4 GHz
Table 197: Wi-Fi Security Protocol
Binary ASCII
Description
1
OPEN Open network (No security)
2
WPA Wi-Fi Protected Access
3
WPA2 Wi-Fi Protected Access version 2
NovAtel Wi-Fi access points only support the WPA2 security protocol. As a result, the WIFIAPSETTINGS log will only report WPA2.
Novatel Wi-Fi Clients support OPEN, WPA, and WPA2 security protocols (SMART7 only).
Table 198: Wi-Fi Encryption Type
Binary ASCII
Description
1
OPEN Open (no encryption)
2
TKIP Temporal Key Integrity Protocol (used with WPA)
3
CCMP AES-based CCMP (Cipher Chaining Message Authentication) used with WPA2
NovAtel Wi-Fi access points only support the WPA2 security protocol. As a result, the WIFIAPSETTINGS log will only report CCMP.
OEM7 Commands and Logs Reference Manual v10
880
Chapter 3 Logs
Table 199: Regulatory Region
Binary ASCII
Description
Receiver has not been configured to comply with any regional regulatory
0
None requirements. Wireless components (e.g. Wi-Fi) will not operate. Contact
NovAtel Customer Support.
1
US
United States
2
EU
Europe
3
AU
Australia
4
JP
Japan
5
NZ
New Zealand
6
BR
Brazil
OEM7 Commands and Logs Reference Manual v10
881
Chapter 4 SPAN Commands
The commands used to configure GNSS+INS functions are described in the following sections. For information about other available commands, refer to GNSS Commands on page 51.
OEM7 Commands and Logs Reference Manual v10
882
Chapter 4 SPAN Commands
4.1 ALIGNMENTMODE
Set the Alignment Mode
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to set the alignment method used to initialize the SPAN system. The default ALIGNMENTMODE is AUTOMATIC. In this mode, the first available method to align is used. Sending the ALIGNMENTMODE command manually overrides the AUTOMATIC setting and changes the options available to complete an alignment.
Message ID: 1214
Abbreviated ASCII Syntax: ALIGNMENTMODE mode
Abbreviated ASCII Example: ALIGNMENTMODE AIDED_TRANSFER
Field
Field Type
ASCII Value
1
ALIGNMENTMODE header
-
Binary Value
Description
Binary Binary Binary Format Bytes Offset
Command
header. See
-
Messages on
-
page 25 for more
information.
H
0
OEM7 Commands and Logs Reference Manual v10
883
Chapter 4 SPAN Commands
Field
Field Type
2
mode
ASCII Value
Binary Value
Description
Binary Binary Binary Format Bytes Offset
UNAIDED 0
Static coarse alignment or kinematic alignment methods are available.
AIDED_ TRANSFER
2
Seed the initial azimuth estimate from the ALIGN solution.
Seed the full
attitude from the
ALIGN solution,
perform a
Enum 4
H
regular static
AUTOMATIC 3
coarse alignment
or perform a
kinematic
alignment,
whichever is
possible first.
STATIC
4
Static coarse alignment method only.
KINEMATIC 5
Kinematic alignment method only.
If the ALIGNMENTMODE selected can use a kinematic alignment (UNAIDED, KINEMATIC or AUTOMATIC), the SETINSROTATION command on page 919 must be sent to the receiver regardless of system configuration and IMU orientation.
NVM Seed injected (see the INSSEED command on page 903) and commanded (see SETINITAZIMUTH command on page 916) alignments are valid for all alignment modes and will supersede all other options if valid and available.
OEM7 Commands and Logs Reference Manual v10
884
Chapter 4 SPAN Commands
4.2 ASYNCHINSLOGGING
Enable Asynchronous INS Logs
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to enable or disable the asynchronous INS logs (IMURATECORRIMUS and IMURATEPVAS).
The asynchronous INS logs are highly advanced logs for users of SPAN on OEM7. The rate controls that limit the output of logs are not applicable to these logs, allowing the user to drive the idle time to zero.
Users of the IMURATECORRIMUS log (see page 952) or IMURATEPVAS log (see page 956) should be limited to those who must have full rate INS solution data, or full rate corrected IMU data, without possible shifts in log time that are present in the synchronous version of these logs.
The asynchronous INS logs are only available at the full rate of the IMU.
Message ID: 1363 Abbreviated ASCII Syntax:
ASYNCHINSLOGGING switch
Abbreviated ASCII Example: ASYNCHINSLOGGING ENABLE
Field Field Type
ASCII Value
Binary Value
Description
ASYNCHINS
1
LOGGING -
header
Command header. See
-
Messages on page 25 for
more information.
2
Switch
DISABLE 0 ENABLE 1
Enable or disable the asynchronous INS logs.
The default value is DISABLE.
Binary Binary Binary Format Bytes Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
885
Chapter 4 SPAN Commands
4.3 CONNECTIMU
Connects an IMU to a Port
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this command to specify the type of IMU connected to the receiver and the receiver port used by the IMU.
Message ID: 1428
Abbreviated ASCII Syntax: CONNECTIMU IMUPort IMUType
Abbreviated ASCII Example: CONNECTIMU COM2 LN200
Field
Field Type
ASCII Binary Value Value
Description
1
CONNECTIMU header
-
-
Command header. See Messages on page 25 for more information.
COM1 1
IMU Port is COM port 1
COM2 2
IMU Port is COM port 2
COM3 3
2
IMUPort1
SPI
7
IMU Port is COM port 3 IMU Port is the SPI port
COM4 19
IMU Port is COM port 4
COM5 31
IMU Port is COM port 5
3
IMUType
See Table 200: IMU Type on the next page
IMU Type
Binary Binary Binary Format Bytes Offset
-
H
0
Enum 4
H
Enum 4
H+4
SPI is available only on the OEM7500, OEM7600, OEM7700, and OEM7720.
COM4 and COM5 are available only on the OEM7600, OEM7700 and OEM7720.
1The IMU-ISA-100C, IMU-FSAS, IMU-HG1900, IMU-LN200, IMU-�IMU, IMU-CPT and IMU-KVH1750 use RS-422 protocol and must be connected to a receiver port that is configured to use RS-422. Refer to the OEM7 Installation and Operation User Manual for information about which receiver ports support RS-422 and instructions for enabling RS-422.
OEM7 Commands and Logs Reference Manual v10
886
Chapter 4 SPAN Commands
Table 200: IMU Type
Binary
ASCII
Description
0
UNKNOWN
Unknown IMU type (default)
1
HG1700_AG11
Honeywell HG1700 AG11
4
HG1700_AG17
Honeywell HG1700 AG17
5
HG1900_CA29
Honeywell HG1900 CA29
8
LN200
Northrop Grumman LN200/LN200C
11
HG1700_AG58
Honeywell HG1700 AG58
12
HG1700_AG62
Honeywell HG1700 AG62
13
IMAR_FSAS
iMAR iIMU-FSAS
16
KVH_COTS
KVH CPT IMU
20
HG1930_AA99
Honeywell HG1930 AA99
26
ISA100C
Northrop Grumman Litef ISA-100C
27
HG1900_CA50
Honeywell HG1900 CA50
28
HG1930_CA50
Honeywell HG1930 CA50
31
ADIS16488
Analog Devices ADIS16488
32
STIM300
Sensonor STIM300
33
KVH_1750
KVH1750 IMU
41
EPSON_G320
Epson G320N
52
LITEF_MICROIMU Northrop Grumman Litef �IMU-IC
56
STIM300D
Sensonor STIM300, Direct Connection
58
HG4930_AN01
Honeywell HG4930 AN01
The IMU Type field also supports the legacy ASCII values that contain the "IMU_" prefix. For example, LN200 or IMU_LN200. IMUs recently added as SPAN supported devices, such as the LITEF_MICROIMU and STIM300D, do not support the "IMU_" prefix.
Values not shown in this table are reserved.
OEM7 Commands and Logs Reference Manual v10
887
Chapter 4 SPAN Commands
4.4 EXTERNALPVAS
Enter PVA Update
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This command should only be used by advanced users of GNSS/INS.
The standard deviations entered using this command must be representative of actual input error.
The EXTERNALPVAS command uses a short header if the command is entered in ASCII or Binary.
This command allows a user to provide full position, velocity and attitude updates, in any combination, to the INS. The user can also provide height or attitude only updates, along with Zero Velocity Updates (ZUPTs). These position and velocity updates are entered in local level frame or ECEF.
The default input frame is ECEF. Updates are entered in ECEF unless Local Level is specified using the OptionsMask parameter.
Message ID: 1463
Abbreviated ASCII Syntax: EXTERNALPVAS Position1 Position2 Position3 Velocity1 Velocity2 Velocity3 Attitude1 Attitude2 Attitude3 PosStdDev1 PosStdDev2 PosStdDev3 VelStdDev1 VelStdDev2 VelStdDev3 AttStdDev1 AttStdDev2 AttStdDev3 UpdateMask OptionsMask
Abbreviated ASCII Example: EXTERNALPVAS 51.13495816 -114.03232307 1064.5895 -10.4502 0.2485 -0.09598 1.3152366 -3.6474718 179.5885212 0.01 0.01 0.01 0.01 0.01 0.01 0.1 0.1 0.1 C020 1
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
EXTERNALPVAS header
-
-
Command header. See Messages on page 25 for more information.
H
0
OEM7 Commands and Logs Reference Manual v10
888
Chapter 4 SPAN Commands
Field Field Type
2
Position1
3
Position2
4
Position3
5
Velocity1
6
Velocity2
7
Velocity3
8
Attitude1
9
Attitude2
10
Attitude3
11
PosStdDev1
12
PosStdDev2
13
PosStdDev3
14
VelStdDev1
15
VelStdDev2
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
Latitude in degrees or
ECEF X-coordinate in
Double 8
H
metres
Longitude in degrees or ECEF Y-coordinate in metres
Double 8
H+8
Height or ECEF Zcoordinate in metres
Double 8
H+16
North velocity or velocity
along the X-axis in
Float
4
metres/second
H+24
East velocity or velocity
along the Y-axis in
Float
4
metres/second
H+28
Up velocity or velocity
along the Z-axis in
Float
4
metres/second
H+32
Pitch in local level in degrees
Float
4
H+36
Roll in local level in degrees
Float
4
H+40
Azimuth in local level in degrees
Float
4
H+44
Position1 standard deviation in metres
Float
4
H+48
Position2 standard deviation in metres
Float
4
H+52
Position3 standard deviation in metres
Float
4
H+56
Velocity1 standard deviation in metres/second
Float
4
H+60
Velocity2 standard deviation in metres/second
Float
4
H+64
OEM7 Commands and Logs Reference Manual v10
889
Chapter 4 SPAN Commands
Field Field Type
16
VelStdDev3
17
AttStdDev1
18
AttStdDev2
19
AttStdDev3
20
UpdateMask
21
OptionsMask
ASCII Binary Value Value
Description
Velocity3 standard deviation in metres/second
Attitude1 standard deviation in degrees
Attitude2 standard deviation in degrees
Attitude3 standard deviation in degrees
This mask selects which updates are applied. Setting a bit applies the update and more than one update can be applied at one time.
See Table 201: EXTERNALPVAS Updates Mask below.
This mask selects the update options. See Table 202: EXTERNALPVAS Options Mask on the next page.
Binary Binary Binary Format Bytes Offset
Float
4
H+68
Float
4
Float
4
Float
4
H+72 H+76 H+80
HEX Ulong
4
H+84
HEX Ulong
4
H+88
Table 201: EXTERNALPVAS Updates Mask
Bit Mask
Description
0 0x00001 Reserved
1 0x00002 Reserved
2 0x00004 ZUPT Update. No fields required in the EXTERNALPVAS command for this update.
3 0x00008 Reserved
4 0x00010 Reserved
External Position Update. 5 0x00020 This update is entered using Position1 to Position3 in the EXTERNALPVAS
command.
6 0x00040 Reserved
7 0x00080 Reserved
OEM7 Commands and Logs Reference Manual v10
890
Chapter 4 SPAN Commands
Bit Mask
Description
8 0x00100 Reserved
9 0x00200 Reserved
10 0x00400 Reserved
11 0x00800 Reserved
12 0x01000 Reserved
13 0x02000 Reserved
External Velocity Update. 14 0x04000 This update is entered using Velocity1 to Velocity3 in the EXTERNALPVAS
command.
External Attitude Update. 15 0x08000 This update is entered using Attitude1 to Attitude3 in the EXTERNALPVAS
command.
16
0x10000
External Heading Update. This update is entered using Attitude3 in the EXTERNALPVAS command.
17
0x20000
External Height Update. This update is entered using Position3 in the EXTERNALPVAS command.
If both the External Position Update and External Height Update bits are set, only the External Position Update will be applied.
If both the External Attitude Update and External Heading Update bits are set, only the External Attitude Update will be applied.
Table 202: EXTERNALPVAS Options Mask
Bit Mask
Description
0 0x1
If this bit is set, the position and velocity input frame is set to local level. If cleared, the input frame is ECEF.
1 0x2
If this bit is set, the heading update is set relative. If cleared, the heading update is absolute.
OEM7 Commands and Logs Reference Manual v10
891
Chapter 4 SPAN Commands
4.5 HEAVEFILTER
Enables or Disables Heave Filtering
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to enable or disable the filter used for heave processing.
To configure the length of the heave filter, use the SETHEAVEWINDOW command (see page 912).
Message ID: 1427 Abbreviated ASCII Syntax:
HEAVEFILTER switch
Abbreviated ASCII Example: HEAVEFILTER ENABLE
Field Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
HEAVEFILTER header
-
Command header. See
-
Messages on page 25 for -
more information.
H
0
2
switch
DISABLE 0
Disables the Heave filter.
Enum 4
H
ENABLE 1
Enables the Heave filter.
OEM7 Commands and Logs Reference Manual v10
892
Chapter 4 SPAN Commands
4.6 INPUTGIMBALANGLE
Input Gimbal Angles into the Receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to input information about the current mount gimbal angles. Gimbal angles are the angle from the locked mount frame to the current gimbal location. They are input in the mount body frame. See OEM7 SPAN Installation and Operation User Manual for details on frame definitions.
It is very important to follow the order of rotations (Z, X, Y) when determining the rotations from the locked mount frame to the current gimbal location.
Message ID: 1317 Abbreviated ASCII Syntax:
INPUTGIMBALANGLE XAngle YAngle ZAngle [XUncert] [YUncert] [ZUncert]
Abbreviated ASCII Examples: INPUTGIMBALANGLE 0.003 -0.1234 12.837 INPUTGIMBALANGLE 0.003 -0.1234 12.837 0.001 0.001 0.005
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
INPUTGIMBAL ANGLE header
-
-
Command header. See Messages on page 25 for more information.
H
0
2
X Angle
�180
Right hand rotation from
the locked mount frame X axis to the current gimbal
Double
8
H
location in degrees.
3
Y Angle
�180
Right hand rotation from
the locked mount frame Y axis to the current gimbal
Double
8
location in degrees.
H+8
4
Z Angle
�180
Right hand rotation from
the locked mount frame Z axis to the current gimbal
Double
8
location to in degrees.
H+16
4
X Uncertainty 0 � 180
Uncertainty of X rotation in degrees. Default is 0
Double 8
H+24
OEM7 Commands and Logs Reference Manual v10
893
Chapter 4 SPAN Commands
Field
Field Type
ASCII Binary Value Value
Description
5
Y Uncertainty 0 � 180
Uncertainty of Y rotation in degrees. Default is 0
6
Z Uncertainty 0 � 180
Uncertainty of Z rotation in degrees. Default is 0
Binary Binary Binary Format Bytes Offset
Double 8
H+32
Double 8
H+40
OEM7 Commands and Logs Reference Manual v10
894
Chapter 4 SPAN Commands
4.7 INSALIGNCONFIG
Configure ALIGN Parameters for SPAN Receiver
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This command is not available on the systems using firmware 7.03.04 and earlier. On these systems, use the DUALANTENNAPORTCONFIG command on page 133.
When the SPAN system is configured for dual antenna, it automatically attempts to connect to an ALIGN capable rover to establish dual antenna corrections. It also attempts to re-establish these corrections should they stop.
Use the INSALIGNCONFIG command to configure ALIGN for a SPAN master receiver to a secondary rover receiver.
Important
l By default, the receiver is configured to use COM2 for both the master and rover receivers for ALIGN communication.
l When using ICOM ports, the Ethernet settings on the SPAN master and rover receiver must be manually configured.
l The master and rover ports must be the same interface type (i.e. Serial to Serial or Ethernet to Ethernet).
l The INSALIGNCONFIG command can be used to set the output rate for dual antenna receivers (e.g. OEM7720). In these cases, the port configuration fields are ignored.
Message ID: 2163 Abbreviated ASCII Syntax:
INSALIGNCONFIG masterport [roverport] [baudrate] [outputrate]
Abbreviated ASCII Example: INSALIGNCONFIG COM1 COM2 230400 5
Field
Field Type
ASCII Binary Value Value
Description
1
INSALIGNCONFIG header
-
Command header.
-
See Messages on page 25 for more
information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
895
Chapter 4 SPAN Commands
Field
Field Type
2
masterport
3
roverport
4
baudrate
ASCII Binary Value Value
Description
NOPORT 0
COM1 1
COM2 2
COM3 3 COM4 19 COM5 31 ICOM1 23 ICOM2 24 ICOM3 25 ICOM4 29
Specify which COM port on the master receiver to use to communicate with an external ALIGN capable receiver.
Selecting NOPORT disables automatic dual antenna configuration.
ICOM5 46
ICOM6 47
ICOM7 48
COM1 1
COM2 2
COM3 3
COM4 19
COM5 31 ICOM1 23 ICOM2 24 ICOM3 25
Specify which rover COM port is connected to the master receiver
(Default = COM2)
ICOM4 29
ICOM5 46
ICOM6 47
ICOM7 48
57600, 115200, 230400, or 460800
Baud rate for communication
(Default = 230400)
Format
Binary Bytes
Binary Offset
Enum 4
H
Enum 4
H+4
Ulong 4
H+8
OEM7 Commands and Logs Reference Manual v10
896
Chapter 4 SPAN Commands
Field
Field Type
5
outputrate
6
Reserved
ASCII Binary Value Value
Description
Format
Binary Bytes
Binary Offset
1, 2, 4, 5, 10
The data rate, in Hz,
in which ALIGN will
be output
Ulong 4
(Default = 1 Hz)
H+12
�
Reserved
Ulong 4
H+16
The SPAN filter only requires ALIGN updates at 1 Hz. Increasing the output rate (using the outputrate field) does not increase performance, it only provides ALIGN logs at higher rates.
OEM7 Commands and Logs Reference Manual v10
897
Chapter 4 SPAN Commands
4.8 INSCALIBRATE
Initiate calibration of the INS offsets
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this command to initiate the calibration of INS offsets.
The RBV calibration requires a valid RBV estimate to be entered prior to initializing the calibration. See the SETINSROTATION command on page 919 for details on entering a RBV estimate.
For optimal SPAN performance when using Dual Antenna with SPAN, an ALIGN offset calibration is required for each unique installation. This calibration refines the IMU to antenna baseline angular offset from the initial estimate derived from the input lever arms.
Message ID: 1882 Abbreviated ASCII Syntax:
INSCALIBRATE Offset [Trigger] [SDThreshold]
Abbreviated ASCII Example: INSCALIBRATE RBV NEW 1.0
Field
Field Type
ASCII Binary Value Value
Description
1
INSCALIBRATE header
-
-
Command header. See Messages on page 25 for more information.
Binary Binary Binary Format Bytes Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
898
Chapter 4 SPAN Commands
Field Field Type
2
Offset
3
Trigger
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
Use this option to set the INS calibration offset from the IMU to the primary GNSS antenna
ANT1 1
Note: The ANT1 option is available only on IMU
Grade 2 or higher IMUs.
See Models and Features
in the OEM7 SPAN
Installation and
Enum 4
H
Operation User Manual.
ALIGN 8
Use this option to set the INS calibration offset from the IMU Body frame to ALIGN frame rotation.
RBV 11
Use this option to set the INS calibration offset from the IMU Body frame to Vehicle frame rotation.
STOP 0
Ends the INS calibration and uses the current estimate for the RBV offsets
NEW 1
Begins a new single line
calibration, overwriting
any previous input or
cumulative average offset values
Enum 4
H+4
ADD 2
Adds a new path. Only valid for multi-path RBV calibrations
RESET 3
Resets the calibration process and restores the RBV offsets to previous user input values
OEM7 Commands and Logs Reference Manual v10
899
Chapter 4 SPAN Commands
Field Field Type
4
SDThreshold
ASCII Binary Value Value
Description
Standard Deviation Threshold
(default for lever arm calibration = 0.10 m) (default for RBV calibration = 0.5 degrees)
Binary Binary Binary Format Bytes Offset
Float
4
H+8
OEM7 Commands and Logs Reference Manual v10
900
Chapter 4 SPAN Commands
4.9 INSCOMMAND
INS Control Command
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this command to enable or disable INS. When INS is disabled, no INS position, velocity or attitude is output (however IMU data is still available). Also, INS aiding of tracking reacquisition is disabled. If the command is used to disable INS and then re-enable it, the INS system has to go through its alignment procedure (equivalent to issuing a RESET command). See the relevant SPAN User Manual for information about the SPAN alignment procedures.
Message ID: 379
Abbreviated ASCII Syntax: INSCOMMAND action
Abbreviated ASCII Example: INSCOMMAND ENABLE
Field
Field Type
ASCII Value
INS
1
COMMAND -
header
Binary Value
Description
Command header. See
-
Messages on page 25 for
more information.
Binary Binary Binary Format Bytes Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
901
Chapter 4 SPAN Commands
Field
Field Type
2
Action
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
RESET 0
Resets the GNSS/INS alignment without resetting INS biases.
DISABLE 1
Disables INS navigation.
ENABLE 2
Enables INS navigation where alignment initialization starts again if the Action parameter was previously set to DISABLE.
Raw IMU data will begin to
START_
NO_
3
TIME
flow upon system startup. Enum
4
IMU data collection can
begin before the receiver
has a GNSS solution.
H
(default)
START_
FINE_
4
TIME
RAWIMU data will only be output after the system reaches FINESTEERING.
RESTART 5
Resets the GNSS/INS alignment and restarts the alignment initialization.
OEM7 Commands and Logs Reference Manual v10
902
Chapter 4 SPAN Commands
4.10 INSSEED
Enable or disable last known SPAN solution
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This command enables or disables the saving and restoration of the last known SPAN solution from NVM.
Message ID: 1906
Abbreviated ASCII Syntax: INSSEED Command [Validation]
Abbreviated ASCII Example: INSSEED ENABLE
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
INSSEED Header
-
Command header. See
-
Messages on page 25 for -
more information.
H
0
DISABLE 0
Disable the INS seed functionality
2
Command ENABLE 1
Enable the INS seed functionality
Enum 4
H
CLEAR
2
Clear the currently saved seed value so it will not be used until re-saved
OEM7 Commands and Logs Reference Manual v10
903
Chapter 4 SPAN Commands
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
VALIDATE 0
Validate INS Seed data using GNSS solution before injecting (default)
Force an NVM seed value (if available) to be used, without any motion validation.
3
Validation
INJECT 1
4
Reserved
5
Reserved
Using this option to force the seed to be used can result in an unstable INS solution if the vehicle has moved. For advanced users only.
Enum 4
Ulong 4 Ulong 4
H+4
H+8 H+12
OEM7 Commands and Logs Reference Manual v10
904
Chapter 4 SPAN Commands
4.11 INSTHRESHOLDS
Change the INS_HIGH_VARIANCE Threshold
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
The INSTHRESHOLDS command allows you to customize the criteria by which the system reports the inertial solution status. This criteria is used to determine whether the solution status is reported as INS_SOLUTION_GOOD or INS_HIGH_VARIANCE. This command is useful in situations where system dynamics are known to be challenging.
Message ID: 1448
Abbreviated ASCII Syntax: INSTHRESHOLDS ThresholdConfiguration
Abbreviated ASCII Example: INSTHRESHOLDS DEFAULT
Field Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
INSTHRESHOLDS header
-
Command header.
-
See Messages on page 25 for more
-
information.
H
0
DEFAULT 0
Standard INS status threshold settings
2
Threshold Configuration
Low INS status
threshold settings
Enum 4
H
LOW
1
(only checks the
Attitude standard
deviation)
3
Reserved
Double 8
H+4
4
Reserved
Double 8
H+12
5
Reserved
Double 8
H+20
OEM7 Commands and Logs Reference Manual v10
905
Chapter 4 SPAN Commands
4.12 INSZUPT
Request Zero Velocity Update
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to manually perform a Zero Velocity Update (ZUPT). NovAtel's SPAN Technology System does ZUPTs automatically. It is not necessary to use this command under normal circumstances.
This command should only be used by advanced users of GNSS/INS and only when the system is truly stationary. Applying a ZUPT while moving will result in severe instability of the solution.
Message ID: 382 Abbreviated ASCII Syntax:
INSZUPT
Field
Field Type
ASCII Binary Value Value
Description
1
INSZUPT header
-
-
Command header. See Messages on page 25 for more information.
Reserved
2
This parameter is optional when using abbreviated ASCII
syntax.
Binary Binary Binary Format Bytes Offset
-
H
0
BOOL 4
H
OEM7 Commands and Logs Reference Manual v10
906
Chapter 4 SPAN Commands
4.13 RELINSAUTOMATION
Enables Relative INS on the Rover
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this command to configure the Relative INS plug and play feature on the rover receiver. RELINSAUTOMATION enables/disables the plug and play feature, sets the rover COM port to which the master receiver is connected, sets the baud rate for communication, sets the correction transfer rate and enables/disables sending the HEADINGEXTB/HEADINGEXT2B log back to the master receiver. On issuing this command at the rover receiver, the rover will automatically sync with the master receiver and configure it to send corrections at the specified baud rate and specified data rate.
The recommended method for configuring Relative INS is to use the RELINSCONFIG command (see page 909).
This command should only be issued at the rover receiver.
if the rover receiver is not connected to the master receiver using a serial COM port, use the RELINSCONFIG command (see page 909).
Message ID: 1763 Abbreviated ASCII Syntax:
RELINSAUTOMATION option [comport] [baudrate] [datarate] [headingextboption]
Abbreviated ASCII Example: RELINSAUTOMATION enable com2 230400 10 on
Field Field Type
ASCII Binary Value Value
Description
RELINS
1
AUTOMATION -
header
Command header. See
-
Messages on page 25
for more information.
2
option
ENABLE 0 DISABLE 1
Enables or disables the plug and play feature.
Binary Binary Binary Format Bytes Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
907
Chapter 4 SPAN Commands
Field Field Type
3
comport
4
baudrate
5
datarate
6
headingextb option
ASCII Binary Value Value
COM1
1
COM2
2
COM3
3
9600, 19200, 38400, 57600, 115200, 230400, 460800
1, 2, 4, 5, 10 or 20 Hz
ON OFF
Description
Binary Binary Binary Format Bytes Offset
The COM port on the rover receiver to which the master receiver is Enum 4 connected. (default = COM2)
H+4
The baud rate used for
communication between the master and rover
Ulong
4
receivers.
H+8
The rate at which corrections are transferred between the Ulong 4 receivers. (default =10 Hz)
H+12
Enables or disables sending the HEADINGEXTB/ HEADINGEXT2B log back to the master receiver. (default = ON)
Enum 4
H+16
OEM7 Commands and Logs Reference Manual v10
908
Chapter 4 SPAN Commands
4.14 RELINSCONFIG
Configure Relative INS
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this command to configure Relative INS on this receiver.
Message ID: 1797
Abbreviated ASCII Syntax: RELINSCONFIG enable rxtype [port] [baud] [rateinhz]
Abbreviated ASCII Example: RELINSCONFIG ENABLE ROVER COM2 230400 10
Field
Field Type
ASCII Value
Binary Value
RELINS
1
CONFIG -
-
header
DISABLE 0
2
enable
ENABLE 1
ROVER 1
3
rxtype
MASTER 2
See Table 203:
4
port
COM Ports on the
next page
9600, 19200,
5
baud
38400, 57600, 115200, 230400,
460800
6
rateinhz
1, 2, 4, 5, 10 or 20 Hz
Description
Command header. See Messages on page 25 for more information.
Binary Binary Binary Format Bytes Offset
-
H
0
Enables or disables the Relative INS functionality.
Enum
4
H
Defines the receiver as the master or rover in a Relative Enum 4 INS configuration.
Communication port used to communicate with the other Enum 4 receiver. (default = COM2)
The baud rate used for
communication between the master and rover receivers.
Ulong
4
(default = 230400)
The rate at which
corrections are transferred between the receivers.
Ulong
4
(default =10 Hz)
H+4 H+8 H+12 H+16
OEM7 Commands and Logs Reference Manual v10
909
Chapter 4 SPAN Commands
Table 203: COM Ports
Decimal ASCII
Description
1
COM1 COM port 1
2
COM2 COM port 2
3
COM3 COM port 3
13
USB1 USB port 1
14
USB2 USB port 2
15
USB3 USB port 3
19
COM4 COM port 4
23
ICOM1 IP virtual COM port 1
24
ICOM2 IP virtual COM port 2
25
ICOM3 IP virtual COM port 3
29
ICOM4 IP virtual COM port 4
31
COM5 COM port 5
46
ICOM5 IP virtual COM port 5
47
ICOM6 IP virtual COM port 6
48
ICOM7 IP virtual COM port 7
49
SCOM1 Scripted application COM port 1
50
SCOM2 Scripted application COM port 2
51
SCOM3 Scripted application COM port 3
52
SCOM4 Scripted application COM port 4
OEM7 Commands and Logs Reference Manual v10
910
Chapter 4 SPAN Commands
4.15 SETALIGNMENTVEL
Set the Minimum Kinematic Alignment Velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use the SETALIGNMENTVEL command to adjust the minimum required velocity for a kinematic alignment. Useful in cases, such as helicopters, where alignment velocity should be increased to prevent a poor alignment before the vehicle/aircraft is able to flight straight and level.
Message ID: 1397
Abbreviated ASCII Syntax: SETALIGNMENTVEL velocity
Abbreviated ASCII Example SETALIGNMENTVEL 5.0
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
SETALIGNMENTVEL header
-
Command
header. See
-
Messages on
-
page 25 for more
information.
H
0
2
Velocity
Minimum: 0.2 m/s (Default is 5 m/s)
The minimum
velocity, in m/s,
required to
Double 8
H
kinematically
align.
OEM7 Commands and Logs Reference Manual v10
911
Chapter 4 SPAN Commands
4.16 SETHEAVEWINDOW
Set Heave Filter Length
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to control the length of the heave filter. This filter determines the heave (vertical displacement) of the IMU, relative to a long term level surface.
Message ID: 1383
Abbreviated ASCII Syntax: SETHEAVEWINDOW filterlength
Abbreviated ASCII Example: SETHEAVEWINDOW 35
Field
Type
ASCII Binary Value Value
Description
SETHEAVE
1
WINDOW -
header
Command header. See
-
Messages on page 25 for
more information.
Integer
2
Filter Length
(1 � 300 s) (default
= 20 s)
This filter length will be used in the heave filter. Typically, set the filter length to 5 x wave period
Binary Binary Binary Format Bytes Offset
-
H
0
Long
4
H
OEM7 Commands and Logs Reference Manual v10
912
Chapter 4 SPAN Commands
4.17 SETIMUPORTPROTOCOL
Sets the Protocol Used for the IMU Serial Port
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use the SETIMUPORTPROTOCOL command to change the IMU serial port to use either RS-232 or RS-422 protocol. This overrides the default configured internally when the CONNECTIMU command is sent.
Before changing the IMU serial port protocol:
1. Make sure the receiver port connected to the IMU is capable of RS-422 protocol. Refer to the OEM7 Installation and Operation User Manual for information about the receiver serial ports.
2. The IMU data message is input into the receiver at that particular protocol.
Message ID: 1767 Abbreviated ASCII Syntax:
SETIMUPORTPROTOCOL SerialProtocol
Abbreviated ASCII Example: SETIMUPORTPROTOCOL RS422
Field
Field Type
ASCII Binary Value Value
Description
SETIMUPORT
1
PROTOCOL -
-
header
Command header. See Messages on page 25 for more information.
2
Serial Protocol
RS232 RS422
The protocol for the IMU serial port.
Binary Binary Binary Format Bytes Offset
-
H
0
Enum 4
H
OEM7 Commands and Logs Reference Manual v10
913
Chapter 4 SPAN Commands
4.18 SETIMUSPECS
Specify Error Specifications and Data Rate
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
This command should only be used by advanced users of GNSS/INS.
Use the SETIMUSPECS command to specify the error specifications and data rate for the desired IMU. If the default specs for the supported models are different than the unit used then this command can be used to override the default values. This command is only available for the following IMUs:
l Honeywell HG1930 (default specifications are for the AA99/CA50 model) l Honeywell HG1900 (default specifications are for the CA29/CA50 model)
Message ID: 1295
Abbreviated ASCII Syntax: SETIMUSPECS DataRate AccelBias AccelVRW GyroBias GyroARW AccelSFError GyroSFError [DataLatency]
Abbreviated ASCII Example: (iMAR-FSAS Specs) SETIMUSPECS 200 1 .0198 0.75 0.0028 300 300 2.5
Field
Field Type
ASCII Binary Value Value
Description
1
SETIMUSPECS header
-
-
Command header. See Messages on page 25 for more information.
2
Data Rate
100 Hz to 400 Hz
Data rate of the IMU
3
Accel Bias
-
Total accelerometer bias in milli-g
4
Accel VRW
-
Accelerometer velocity random walk in m/s/rt-hr
5
Gyro Bias
-
Total gyroscope bias in deg/hr
6
Gyro ARW
-
Gyroscope angular random walk in deg/rt-hr
Binary Binary Binary Format Bytes Offset
-
H
0
Ushort 2 Double 8 Double 8 Double 8 Double 8
H H+2 H+10 H+18 H+26
OEM7 Commands and Logs Reference Manual v10
914
Chapter 4 SPAN Commands
Field Field Type
7
Accel Scale Factor Error
8
Gyro Scale Factor Error
9
Data Latency
10
Reserved
11
CRC
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
Accelerometer scale
> 0
factor error in parts per million. Optional.
Ulong 4
H+34
Default = 1000 ppm.
Gyroscopic scale factor
> 0
error in parts per million. Optional.
Ulong
4
H+38
Default = 1000 ppm.
Time delay in milliseconds
from the time of validity
of the IMU data to the
time the input pulse is
received by the SPAN
enabled receiver. This
may include filtering
> 0
delays, processing delays Double 8
H+42
and transmission times
depending on the timing
method (TOV, ASYNC,
SYNC) and the internal
IMU handling. Optional.
Default = 0.0.
-
Reserved
Ulong 4
H+50
-
32-bit CRC
Hex
4
H+54
OEM7 Commands and Logs Reference Manual v10
915
Chapter 4 SPAN Commands
4.19 SETINITAZIMUTH
Set Initial Azimuth and Standard Deviation
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this command to start SPAN operation with a previously known azimuth. Azimuth is the weakest component of a coarse alignment and is also the easiest to know from an external source (i.e., like the azimuth of roadway). When using this command, SPAN operation through alignment will appear the same as with a usual coarse alignment. Roll and pitch is determined using averaged gyro and accelerometer measurements. The input azimuth is used rather than what is computed by the normal coarse alignment routine.
l Input azimuth values must be accurate for good system performance.
l Sending SETINITAZIMUTH resets the SPAN filter. Following realignment, vehicle dynamics are required for the filter to re-converge. Bridging performance is poor before filter convergence.
l The entered azimuth angle is with respect to the configured output frame. This is generally the vehicle frame unless a User Frame offset has been configured using the SETINSROTATION command (see page 919). All offsets should be entered before entering the SETINITAZIMUTH command.
l This command is not save configurable and must be re-entered after each start-up. The command can be entered at any time and will be used automatically when the system is ready to begin alignment.
Azimuth is positive in a clockwise direction when looking towards the z-axis origin.
Message ID: 863 Abbreviated ASCII Syntax:
SETINITAZIMUTH azimuth azSTD
Abbreviated ASCII Example: SETINITAZIMUTH 90 5
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
SETINIT
1
AZIMUTH -
-
header
Command header. See Messages on page 25 for more information.
H
0
2
azimuth 0 to 360
Input azimuth angle (degrees) Double 8
H
3
azSTD
1 to 25
Input azimuth standard deviation angle (degrees)
Float
4
H+8
OEM7 Commands and Logs Reference Manual v10
916
Chapter 4 SPAN Commands
4.20 SETINSPROFILE
Sets filter behavior depending on system environment
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This command sets specific filter behavior depending on the environment the system is installed in. The DEFAULT profile is the legacy setting from earlier SPAN products. The other profiles make changes specific to that environment. The BASIC INS Profiles are available to all SPAN software models, but the enhanced configurations, denoted by "PLUS", are restricted by the SPAN model. The enhanced configurations allow for enhanced profile behavior such as Dead Reckoning for land and Heave for marine. See the OEM7 SPAN Installation and Operation User Manual for a detailed description of each profile's effect.
Message ID: 1944
Abbreviated ASCII Syntax: SETINSPROFILE profile
Abbreviated ASCII Example: SETINSPROFILE LAND_BASIC
Field Field Type
ASCII Value
1
SETINSPROFILE Header
-
Binary Value
Description
Binary Binary Binary Format Bytes Offset
Command
header. See
-
Messages on
-
page 25 for more
information.
H
0
OEM7 Commands and Logs Reference Manual v10
917
Chapter 4 SPAN Commands
Field Field Type
2
Profile
ASCII Value
Binary Value
Description
Binary Binary Binary Format Bytes Offset
Default INS
Default
0
profile with standard SPAN
behavior.
LAND_BASIC 1
Basic INS profile for land vehicles
MARINE_ BASIC
2
Basic INS profile for marine vehicles
FIXEDWING_ BASIC
3
Basic INS profile for fixed wing aircraft
Reserved
4
Reserved
Basic INS profile
for vertical
VTOL_BASIC 5
takeoff and landing vehicles Enum 4
H
(UAVs,
helicopters, etc.)
RAIL_BASIC 6
Basic INS profile for trains
LAND_PLUS 33
Enhanced INS profile for land vehicles. Enables Dead Reckoning. Requires INS Enhanced Profile Model.
MARINE_ PLUS
34
Enhanced INS profile for marine vehicles. Enables Heave. Requires INS Enhanced Profile Model.
OEM7 Commands and Logs Reference Manual v10
918
Chapter 4 SPAN Commands
4.21 SETINSROTATION
Specifies rotational offsets between the IMU frame and other reference frames
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use the SETINSROTATION command to specify rotational offsets between the IMU frame and other reference frames, such as the vehicle frame or an ALIGN baseline. Offsets must be entered as the rotation from the IMU body frame, to the frame of interest. The order of rotations is Z, X, Y. All rotations are right handed.
It is very important to follow the order of rotations (Z, X, Y) when determining the rotations from IMU body frame to frame of interest.
To specify translational offsets between frames, see the SETINSTRANSLATION command on page 922.
Message ID: 1921
Abbreviated ASCII Syntax: SETINSROTATION INSRotation XRotation YRotation ZRotation [XRotationSD] [YRotationSD] [ZRotationSD]
Abbreviated ASCII Example: SETINSROTATION RBV 0 0 90 0.0 0.0 0.0
Field
Field Type
ASCII Binary Value Value
Description
Command header.
1
SETINSROTATION Header
-
-
See Messages on page 25 for more
information.
2
INS Rotation
Table 204: Rotational Offset Types on the next page
Rotational offset to be set.
3
XRotation
�180
X rotation offset from IMU origin (degrees)
Binary Binary Binary Format Bytes Offset
-
H
0
Enum 4
H
Float
4
H+4
OEM7 Commands and Logs Reference Manual v10
919
Chapter 4 SPAN Commands
Field
Field Type
4
YRotation
5
ZRotation
6
XRotationSD
7
YRotationSD
8
ZRotationSD
9
Reserved
ASCII Binary Value Value
Description
�180
Y rotation offset from IMU origin (degrees)
�180
Z rotation offset from IMU origin (degrees)
0 to 45
Optional X rotation offset standard deviation (degrees) Default: 0.0
0 to 45
Optional Y translation offset standard deviation (degrees) Default: 0.0
0 to 45
Optional Z translation offset standard deviation (degrees) Default: 0.0
Binary Binary Binary Format Bytes Offset
Float
4
H+8
Float
4
H+12
Float
4
H+16
Float
4
H+20
Float
4
Long
4
H+24 H+28
Table 204: Rotational Offset Types
ASCII Binary Value Value
Description
USER 4
Rotation from the IMU body frame to the user output frame.
This offset shifts the attitude information in the INSPVA, INSPOS, INSVEL, INSATT, and INSSPD logs, along with their short header and extended versions.
MARK1 5
Rotation from the IMU body frame to the desired output for MARK1. This offset rotates the attitude information in the MARK1PVA log.
MARK2 6
Rotation from the IMU body frame to the desired output for MARK2. This offset rotates the attitude information in the MARK2PVA log.
OEM7 Commands and Logs Reference Manual v10
920
Chapter 4 SPAN Commands
ASCII Binary Value Value
Description
Rotation from the IMU body frame to an ALIGN dual antenna solution.
ALIGN 8
MARK3 9 MARK4 10 RBV 11 RBM 12
When using a dual antenna ALIGN solution with SPAN, this offset will be calculated automatically if translational offsets to both the primary and secondary GNSS antennas are provided using the SETINSTRANSLATION command on the next page.
Rotation from the IMU body frame to the desired output for MARK3. This offset rotates the attitude information in the MARK3PVA log.
Rotation from the IMU body frame to the desired output for MARK4. This offset rotates the attitude information in the MARK4PVA log.
Rotation from the IMU body frame to the vehicle frame.
Rotation from the IMU body frame to the gimbal mount body frame.
OEM7 Commands and Logs Reference Manual v10
921
Chapter 4 SPAN Commands
4.22 SETINSTRANSLATION
Specifies translational offsets between the IMU frame and other reference frames
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use the SETINSTRANSLATION command to specify translational offsets between the IMU frame and other reference frames, including GNSS antennas or the desired output frame. Offsets must be entered as the vector from the IMU, to the frame or position of interest. Offsets can be entered either in the IMU body frame, or the vehicle frame; offsets in the vehicle frame will be automatically rotated into the IMU body frame using the best available IMU Body to Vehicle Rotation (RBV). For details on entering the RBV rotation or other angular offsets, see the SETINSROTATION command on page 919.
Message ID: 1920
Abbreviated ASCII Syntax: SETINSTRANSLATION INSTranslation XTranslation YTranslation ZTranslation [XTranslationSD] [YTranslationSD] [ZTranslationSD] [InputFrame]
Abbreviated ASCII Example: SETINSTRANSLATION USER 1.0 2.0 3.0 0.05 0.05 0.05 VEHICLE
Field Field Type
ASCII Binary Value Value
SETINS
1
TRANSLATION -
-
Header
See Table 205:
2
InsTranslation
Translation Offset Types on the next
page
3
XTranslation �100
4
YTranslation
�100
5
ZTranslation �100
6
XTranslationSD 0 to 10
Description
Command header. See Messages on page 25 for more information.
Binary Binary Binary Format Bytes Offset
-
H
0
Translation offset to be set
Enum
4
H
X translation offset from IMU origin (m)
Float
4
Y translation offset from IMU origin (m)
Float
4
Z translation offset from IMU origin (m)
Float
4
Optional X translation
offset standard
Float
4
deviation (m)
H+4 H+8 H+12 H+16
OEM7 Commands and Logs Reference Manual v10
922
Chapter 4 SPAN Commands
Field Field Type
ASCII Binary Value Value
7
YTranslationSD 0 to 10
8
ZTranslationSD 0 to 10
Table 206:
9
InputFrame
Translation Input Frame on the next
page
Description
Binary Binary Binary Format Bytes Offset
Optional Y translation
offset standard
Float
4
deviation (m)
H+20
Optional Z translation
offset standard
Float
4
deviation (m)
H+24
Optional input frame for translation offset Enum 4 values
H+48
For the ANT1, ANT2, EXTERNAL and GIMBAL translations, the standard deviation defaults are set to 10% of the translation value (up to a max of 10 metres).
If you are uncertain of the standard deviation values for an offset, err on the side of a larger standard deviation.
Table 205: Translation Offset Types
ASCII Value
Binary Value
Description
ANT1
1
Offset from the IMU center of navigation to the phase center of the primary GNSS antenna.
ANT2
2
Offset from the IMU center of navigation to the phase center of the secondary GNSS antenna.
EXTERNAL 3
Offset from the IMU center of navigation to the external position source location.
This offset type is for use with the EXTERNALPVAS command (see page 888).
USER
4
Translation from the IMU center of navigation to the user output location.
This offset shifts the position and velocity information in the INSPVA, INSPOS, INSVEL, INSATT, and INSSPD logs, along with their short header and extended versions.
MARK1
5
Translation from the IMU center of navigation to the MARK1 output location. This offset shifts the position and velocity information in the MARK1PVA log.
OEM7 Commands and Logs Reference Manual v10
923
Chapter 4 SPAN Commands
ASCII Value MARK2
GIMBAL
MARK3
MARK4
Binary Value
Description
Translation from the IMU center of navigation to the MARK2 output location. 6
This offset shifts the position and velocity information in the MARK2PVA log.
7
Translation from the IMU center of navigation to the gimbal mount center of rotation.
Translation from the IMU center of navigation to the MARK3 output location. 9
This offset shifts the position and velocity information in the MARK3PVA log.
Translation from the IMU center of navigation to the MARK4 output location. 10
This offset shifts the position and velocity information in the MARK4PVA log.
Table 206: Translation Input Frame
ASCII Binary Value Value
Description
IMUBODY 0
Offset is provided in the IMU enclosure frame. Default: IMUBODY
VEHICLE 1
Offset is provided in the vehicle frame.
Offsets entered in the vehicle frame will be automatically rotated into the IMU frame using the best available RBV (rotation from IMU Body to Vehicle) information when required.
Vehicle frame offsets should only be used if the RBV is known accurately, either though user measurement or calibration.
The order of entry for vehicle frame offsets and the RBV rotation does not matter.
OEM7 Commands and Logs Reference Manual v10
924
Chapter 4 SPAN Commands
4.23 SETINSUPDATE
Enable/Disable INS Filter Updates
This command should only be used by advanced users of GNSS+INS.
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this command to enable or disable the available INS filter updates.
Message ID: 1821
Abbreviated ASCII Syntax: SETINSUPDATE INSUpdate Trigger
Abbreviated ASCII Example: SETINSUPDATE ZUPT DISABLE
Field Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
SETINSUPDATE header
-
Command header.
-
See Messages on page 25 for more
-
information.
H
0
POS
0
Position updates
ZUPT
1
Zero velocity updates
PSR
2
Pseudorange updates
ADR
3
Carrier phase updates
2
INSUpdate
Enum 4
H
DOPPLER 4
Doppler updates
ALIGN 5
Heading updates
DMI
6
Distance measuring instrument (wheel sensor) updates
3
Trigger
DISABLE 0 ENABLE 1
Disable the INS
update specified in the
INSUpdate field. Enum 4
Enable the INS update
specified in the
INSUpdate field.
H+4
OEM7 Commands and Logs Reference Manual v10
925
Chapter 4 SPAN Commands
4.24 SETMAXALIGNMENTTIME
Set a Time Limit for Static Course Alignment
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this command to set a maximum time limit allowed for static coarse alignments. Coarse alignments typically take under 60 seconds, but in heavy vibration conditions they can take much longer trying to compensate for the vibration induced noise. This command is used to cap the time to a specific length.
This command is for advanced users only. Alignment accuracy cannot be guaranteed if the alignment time is capped using this command.
Message ID: 1800 Abbreviated ASCII Syntax:
SETMAXALIGNMENTTIME switch [duration]
Abbreviated ASCII Example: SETMAXALIGNMENTTIME ENABLE 90
Field Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
SETMAX
1
ALIGNMENTTIME -
header
Command header.
-
See Messages on page 25 for more
-
information.
H
0
2
switch
DISABLE 0
Disables the static alignment time limit.
Enum 4
H
ENABLE 1
Enables the static alignment time limit.
3
duration
30 - 300
Maximum static alignment time in seconds. Default is 180.
Ulong 4
H+4
OEM7 Commands and Logs Reference Manual v10
926
Chapter 4 SPAN Commands
4.25 SETRELINSOUTPUTFRAME
Sets the Relative INS Output Frame
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this command to change the frame of the output solution provided in the RELINSPVA and SYNCRELINSPVA logs. See RELINSPVA log on page 1039 and SYNCRELINSPVA log on page 1043 for information about these logs. See OEM7 SPAN Installation and Operation User Manual for information about the Relative INS functionality.
Message ID: 1775
Abbreviated ASCII Syntax: SETRELINSOUTPUTFRAME OutputFrame [DiffCriteria]
Abbreviated ASCII Example: SETRELINSOUTPUTFRAME ECEF TRUE
Field Field Type
ASCII Value
Binary Value
Description
Binary Binary Binary Format Bytes Offset
SETRELINS
1
OUTPUTFRAME -
header
Command header.
-
See Messages on page 25 for more
-
information.
H
0
ROVER
1
Frame of the output solution in the RELINSPVA and SYNCRELINSPVA logs.
MASTER
2
ROVER � the output frame of the rover INS solution
2
OutputFrame
MASTER � the
output frame of the Enum
4
H
master INS solution
ECEF
3
ECEF � Earth
Centered Earth
Fixed
LOCALLEVEL 4
LOCALLEVEL � Local level
The default is the ROVER.
OEM7 Commands and Logs Reference Manual v10
927
Chapter 4 SPAN Commands
Field Field Type
ASCII Value
FALSE
3
DiffCriteria
TRUE
Binary Value
Description
Binary Binary Binary Format Bytes Offset
The delta solution is
0
computed as Rover minus Master.
(default)
Bool
1
H+4
The delta solution is
1
computed as Master
minus Rover.
OEM7 Commands and Logs Reference Manual v10
928
Chapter 4 SPAN Commands
4.26 SETUPSENSOR
Add a new sensor object
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to add a new sensor object to the system. A sensor object consists of an ID, an Event_Out line and an Event_In line. This is intended as a simplified way to set up triggering to and from a sensor rather than configuring all connections independently. It also allows for event pulses to be sent to a sensor at specific GPS times (see the TIMEDEVENTPULSE command on page 933).
Message ID: 1333
Abbreviated ASCII Syntax: SETUPSENSOR SensorID EventOut OPP OAP EventIn EIC IPP ITB MITG
Abbreviated ASCII Example: SETUPSENSOR SENSOR3 MARK1 POSITIVE 2 MARK4 EVENT POSITIVE 0 2
Field
Field Type
ASCII Value
Binary Value
Description
Binary Binary Binary Format Bytes Offset
SETUP
1
SENSOR -
header
Command header. See
-
Messages on page 25 for
-
more information.
H
0
SENSOR1 0
2
Sensor ID
SENSOR2 1
The sensor to configure.
Enum 4
H
SENSOR3 2
MARK1
0
MARK2
1
3
EventOut
MARK3
2
MARK4
3
Associate a specific MARK
Event_Out line to this
Enum 4
sensor configuration.
H+4
4
OPP
NEGATIVE 0 POSITIVE 1
Mark output pulse polarity Enum 4
H+8
5
OAP
2 - 500
Mark output active period in
milliseconds. Value must be divisible by
Ulong
4
2.
H+12
OEM7 Commands and Logs Reference Manual v10
929
Chapter 4 SPAN Commands
Field
Field Type
6
EventIn
7
EIC
8
IPP
9
ITB
10
ITG
ASCII Value
Binary Value
Description
MARK1
0
MARK2
1
MARK3
2
MARK4
3
Associate a specific MARK Event_In line to this sensor configuration.
DISABLE 0
EVENT
1
Event in control
NEGATIVE 0 POSITIVE 1
Mark input pulse polarity
-99999999 to 99999999
Mark input time bias in milliseconds
2 to 3599999
Mark input time guard in milliseconds
Binary Binary Binary Format Bytes Offset
Enum 4
H+16
Enum 4
Enum 4
Long
4
Ulong 4
H+20 H+24 H+28 H+32
The Event_In and Event_Out options available are dependent on the receiver used in the SPAN system. For information about the Event lines supported, see the Strobe Specifications for the receiver in the OEM7 SPAN Installation and Operation User Manual.
MARK3 and MARK4 are available only on SPAN systems with an OEM7600, OEM7700 or OEM7720 receiver.
OEM7 Commands and Logs Reference Manual v10
930
Chapter 4 SPAN Commands
4.27 SETWHEELPARAMETERS
Set Wheel Parameters
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
The SETWHEELPARAMETERS command can be used when wheel sensor data is available. It gives the filter a good starting point for the wheel size scale factor.
Message ID: 847
Abbreviated ASCII Syntax: SETWHEELPARAMETERS ticks circ reserved
Abbreviated ASCII Example: SETWHEELPARAMETERS 58 1.96 1.0
Field
Field Type
ASCII Binary Value Value
Description
SETWHEEL
1
PARAMETERS -
-
header
Command header. See Messages on page 25 for more information.
2
Ticks
1-10000
Number of ticks per revolution
3
Circ
0.1-100
Wheel circumference (m) (default = 1.96 m)
4
Reserved
-
Reserved field. Set to 1.0 on input.
Binary Binary Binary Format Bytes Offset
-
H
0
Ushort 41
H
Double 8 Double 8
H+4 H+12
Fields 2 and 3 are used with an estimated scale factor to determine the distance traveled.
1In the binary log case, an additional 2 bytes of padding are added to maintain 4 byte alignment. OEM7 Commands and Logs Reference Manual v10
931
Chapter 4 SPAN Commands
4.28 TAGNEXTMARK
Tags the Next Incoming Mark Event
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to tag the next incoming mark event on the selected mark with a 32-bit number. This is available in the TAGGEDMARK1PVA, TAGGEDMARK2PVA, TAGGEDMARK3PVA and TAGGEDMARK4PVA log (see page 1046) to easily associate the PVA log with a supplied event.
Message ID: 1257
Abbreviated ASCII Syntax: TAGNEXTMARK Mark Tag
Abbreviated ASCII Example: TAGNEXTMARK MARK1 1234
Field
Field Type
ASCII Binary Value Value
Description
Binary Binary Binary Format Bytes Offset
1
TAGNEXTMARK header
-
-
Command header. See Messages on page 25 for more information.
H
0
MARK1 0
2
Mark
MARK2 1 MARK3 2
Event line
Enum 4
H
MARK4 3
3
Tag
-
-
Tag for next mark event Ulong 4
H+4
The Mark options available are dependent on the receiver used in the SPAN system. For information about the Event lines supported, see the Strobe Specifications for the receiver in the OEM7 SPAN Installation and Operation User Manual.
OEM7 Commands and Logs Reference Manual v10
932
Chapter 4 SPAN Commands
4.29 TIMEDEVENTPULSE
Add a new camera event
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use this command to add a new camera event to the system. TIMEDEVENTPULSE sends a pulse on the sensor MARK output at the selected GPS time and sets the trigger on the sensor MARK input to be tagged with an event ID (see the TAGGEDMARK1PVA, TAGGEDMARK2PVA, TAGGEDMARK3PVA and TAGGEDMARK4PVA log on page 1046). The lines connected to each sensor are configured using the SETUPSENSOR command (see page 929).
A maximum of 10 unprocessed events can be buffered into the system. A TIMEDEVENTPULSE command must be entered at least 1 second prior to the requested event time.
Message ID: 1337 Abbreviated ASCII Syntax:
TIMEDEVENTPULSE SensorID GPSWeek GPSSeconds [Event ID]
Abbreviated ASCII Example: TIMEDEVENTPULSE -1 1617 418838 100
Field
Field Type
TIMED
1
EVENT PULSE
header
2
Sensor ID
3
GPS Week
ASCII Value
Binary Value
Description
Binary Binary Binary Format Bytes Offset
-
-
Command header. See Messages on page 25 for more information.
H
0
The sensor(s) affected
ALL
-1
by the trigger
(0xFFFFFFFF) command.
SENSOR1 0x01 SENSOR2 0x02 SENSOR3 0x04
The decimal
representation of the
combination of bits 0-2 Long
4
can be used to select a
combination of active
sensors (e.g. 5 [101]
will select sensors 1
and 3).
0 - MAX Ulong
The GPS week that triggers the event.
Ulong 4
H H+4
OEM7 Commands and Logs Reference Manual v10
933
Chapter 4 SPAN Commands
Field
Field Type
ASCII Value
Binary Value
4
GPS Seconds
0 - 604800
5
Event ID
0- MAX Ulong
Description
Binary Binary Binary Format Bytes Offset
The GPS week seconds
that triggers the
Double 8
event.
H+8
The event's identifier, used to tag the TAGGEDMARKxPVA logs if a sensor input is Ulong 4 enabled. Optional
Default = 0
H+16
OEM7 Commands and Logs Reference Manual v10
934
Chapter 4 SPAN Commands
4.30 WHEELVELOCITY
Wheel Velocity for INS Augmentation
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7
Use the WHEELVELOCITY command to input wheel sensor data into the OEM7 receiver.
This command should be used only if the wheel sensor cannot be directly connected to a wheel sensor port in the SPAN system.
When wheel sensor data is entered using this command, only the Cumulative Ticks/s value is used by the system. Values entered for Wheel Velocity and Float Wheel Velocity are not used at this time.
This command should be input at 1 Hz and synced to the receiver 1 Hz PPS for optimized performance.
Message ID: 504
Abbreviated ASCII Example: WHEELVELOCITY 123 8 10 0 0 0 0 40 WHEELVELOCITY 123 8 10 0 0 0 0 80 WHEELVELOCITY 123 8 10 0 0 0 0 120
The examples above are for a vehicle traveling at a constant velocity with these wheel sensor characteristics:
l Wheel Circumference = 2 m l Vehicle Velocity (assumed constant for this example) = 10 m/s l Ticks Per Revolution = 8 l Cumulative Ticks Per Second = (10 m/s)*(8 ticks/rev)/(2 m/rev) = 40 l Latency between 1PPS and measurement from wheel sensor hardware = 123 ms
Field
Field Type
ASCII Binary Value Value
Description
1
WHEELVELOCITY header
-
-
Command header. See Messages on page 25 for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
935
Chapter 4 SPAN Commands
Field Field Type
2
Latency
3
Ticks/rev
4
Wheel Velocity
5
Reserved
6
Float Wheel Velocity
7
Reserved
8
Reserved
9
Cumulative Ticks/s
ASCII Binary Value Value
Description
A measure of the latency in the velocity time tag in ms.
Number of ticks per revolution
Short wheel velocity in ticks/s
Float wheel velocity in ticks/s
Cumulative number of ticks/s
Format
Binary Bytes
Binary Offset
Ushort 2
H
Ushort 2
Ushort 2
Ushort 2
Float
4
Ulong 4 Ulong 4
Ulong 4
H+2
H+4 H+6 H+8 H+12 H+16 H+20
OEM7 Commands and Logs Reference Manual v10
936
Chapter 5 SPAN Logs
The SPAN specific logs follow the same general logging scheme as normal OEM7 Family logs. They are available in ASCII or binary formats and are defined as being either synchronous or asynchronous. All the logs in this chapter are used only with the SPAN system.
For information on other available logs and output logging, refer to Logs on page 409.
One difference from the standard OEM7 Family logs is there are two possible headers for the ASCII and binary versions of the logs. Which header is used for a given log is described in the log definitions in this chapter. The reason for the alternate short headers is that the normal OEM7 binary header is quite long at 28 bytes. This is nearly as long as the data portion of many of the INS logs and creates excess storage and baud rate requirements. Note that the INS related logs contain a time tag within the data block in addition to the time tag in the header. The time tag in the data block should be considered the exact time of applicability of the data. All INS Position, Velocity and Attitude logs can be obtained at a rate of up to 200 Hz. The standard deviation and update logs are available once per second.
Each ASCII log ends with a hexadecimal number preceded by an asterisk and followed by a line termination using the carriage return and line feed characters, for example, *1234ABCD[CR][LF]. This value is a 32-bit CRC of all bytes in the log, excluding the '#' or `%' identifier and the asterisk preceding the four checksum digits. See also Description of ASCII and Binary Logs with Short Headers on page 40.
Table 207: Inertial Solution Status on page 959 shows the status values included in the INS position, velocity and attitude output logs. If the IMU is connected properly and a good status value is not being received, check the hardware setup to ensure it is properly connected. This situation can be recognized in the RAWIMU data by observing accelerometer and gyro values which are not changing with time.
OEM7 Commands and Logs Reference Manual v10
937
Chapter 5 SPAN Logs
Logging Restriction Important Notice
Logging excessive amounts of high rate data can overload the system. When configuring the output for SPAN, NovAtel recommends that only one high rate (>50Hz) message be configured for output at a time. It is possible to log more than one message at high rates, but doing so could have negative impacts on the system. Also, if logging 100/125/200Hz data, always use the binary format.
For optimal performance, log only one high rate output at a time. These logs could be:
l Raw data for post processing RAWIMUXSB ONNEW (100, 125 or 200 Hz depending on IMU)
l RAWIMU logs are not valid with the ONTIME trigger. The raw IMU observations contained in these logs are sequential changes in velocity and rotation. As such, you can only use them for navigation if they are logged at their full rate.
l Real time INS solution INSPVASB ONTIME 0.01 or 0.005 (maximum rate equals the IMU rate)
l Other possible INS solution logs available at high rates are: INSPOSSB, INSVELSB, INSATTSB
The periods available when using the ONTIME trigger are 0.005 (200 Hz), 0.01 (100 Hz), 0.02 (50 Hz), 0.05, 0.1, 0.2, 0.25, 0.5, 1, and any integer number of seconds.
5.1 Logs with INS or GNSS Data
There are several logs in the system designed to output the best available solution as well as many logs that output only a specific solution type (PSR, RTK, INS, etc). The table below lists the logs that can provide either a GNSS solution or an INS solution. Most of these derive from the solution the system picks as the best solution. SPAN systems also have a secondary best solution that derives from the GNSS solution only (BESTGNSSPOS log (see page 939) and BESTGNSSVEL log (see page 942)). The position output from these logs is at the phase center of the antenna.
Log Log Format GNSS/INS
BESTPOS NovAtel
YES
BESTVEL NovAtel
YES
BESTUTM NovAtel
YES
BESTXYZ NovAtel
YES
GPGGA NMEA
YES
GPGLL
NMEA
YES
GPVTG NMEA
YES
OEM7 Commands and Logs Reference Manual v10
938
Chapter 5 SPAN Logs
5.2 BESTGNSSPOS
Best GNSS Position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains the best available GNSS position (without INS) computed by the receiver. In addition, it reports several status indicators, including differential age, which is useful in predicting anomalous behavior brought about by outages in differential corrections. A differential age of 0 indicates that no differential correction was used.
With the system operating in an RTK mode, this log reflects the latest low latency solution for up to 60 seconds after reception of the last base station observations. After this 60 second period, the position reverts to the best solution available and the degradation in accuracy is reflected in the standard deviation fields. If the system is not operating in an RTK mode, pseudorange differential solutions continue for the time specified in the PSRDIFFTIMEOUT command (see page 289).
BESTGNSSPOS always outputs positions at the antenna phase center.
Message ID: 1429
Log Type: Synch
Recommended Input: log bestgnssposa ontime 1
ASCII Example: #BESTGNSSPOSA,COM1,0,92.5,FINESTEERING,1692,332119.000,02000000,8505,43521;SOL_ COMPUTED,SINGLE,51.11635530655,-114.03819448382,1064.6283,16.9000,WGS84,1.2612,0.9535,2.7421,"",0.000,0.000,11,11,11,11,0,06,00,03*52d3f7 c0
Field Field type
Data Description
1
BESTGNSSPOS Log header. See Messages on page 25 for
Header
more information.
2
Sol Status
Solution status, see Table 74: Solution Status on page 436
3
Pos Type
Position type, see Table 75: Position or Velocity Type on page 437
4
Lat
Latitude (degrees)
5
Lon
Longitude (degrees)
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Enum 4 Double 8 Double 8
H+4 H+8 H+16
OEM7 Commands and Logs Reference Manual v10
939
Chapter 5 SPAN Logs
Field Field type
Data Description
6
Hgt
Height above mean sea level (metres)
Undulation - the relationship between the geoid and the ellipsoid (m) of the chosen datum
Format
Binary Bytes
Binary Offset
Double 8
H+24
7
Undulation
When using a datum other than WGS84, the undulation value also includes the vertical shift due to differences between the datum in use and WGS84.
Float
4
8
Datum ID
Datum ID (refer Table 29: Datum Transformation Parameters on page 121)
Enum 4
9
Lat
Latitude standard deviation (metres)
Float
4
10
Lon
Longitude standard deviation (metres)
Float
4
11
Hgt
Height standard deviation (metres)
Float
4
12
Stn ID
Base station ID
Char[4] 4
13
Diff_age
Differential age in seconds
Float
4
14
Sol_age
Solution age in seconds
Float
4
15
#SVs
Number of satellites tracked
Uchar 1
16
#solnSVs
Number of satellite solutions used in solution
Uchar 1
17
#solnL1SVs
Number of satellites with L1/E1/B1 signals used in solution
Uchar
1
18
#solnMultiSVs
Number of satellites with multi-frequency signals used in solution
Uchar 1
19
Reserved
Uchar 1
20
ext sol stat
Extended solution status (see Table 78: Extended Solution Status on page 440)
Hex
1
Galileo and
Galileo and BeiDou signals used mask (see
21
BeiDou sig
Table 77: Galileo and BeiDou Signal-Used Hex
1
mask
Mask on page 440)
H+32
H+36 H+40 H+44 H+48 H+52 H+56 H+60 H+64 H+65 H+66 H+67 H+68 H+69
H+70
OEM7 Commands and Logs Reference Manual v10
940
Chapter 5 SPAN Logs
Field Field type
GPS and
22
GLONASS sig
mask
23
xxxx
24
[CR][LF]
Data Description
GPS and GLONASS signals used mask (see Table 76: GPS and GLONASS Signal-Used Mask on page 439) 32-bit CRC (ASCII and Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Hex
1
H+71
Hex
4
-
-
H+72 -
OEM7 Commands and Logs Reference Manual v10
941
Chapter 5 SPAN Logs
5.3 BESTGNSSVEL
Best Available GNSS Velocity Data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains the best available GNSS velocity information (without INS) computed by the receiver. In addition, it reports a velocity status indicator, which is useful to indicate whether or not the corresponding data is valid. The velocity measurements sometimes have a latency associated with them. The time of validity is the time tag in the log minus the latency value.
The velocity is typically computed from the average change in pseudorange over the time interval or the RTK Low Latency filter. As such, it is an average velocity based on the time difference between successive position computations and not an instantaneous velocity at the BESTGNSSVEL time tag. The velocity latency to be subtracted from the time tag is normally half the time between filter updates. Under default operation, the positioning filters are updated at a rate of 2 Hz. This translates into a velocity latency of 0.25 seconds. The latency is reduced by increasing the update rate of the positioning filter used by requesting the BESTGNSSVEL or BESTGNSSPOS messages at a rate higher than 2 Hz. For example, a logging rate of 10 Hz reduces the velocity latency to 0.005 seconds. For integration purposes, the velocity latency should be applied to the record time tag.
A valid solution with a latency of 0.0 indicates the instantaneous Doppler measurement was used to calculate velocity.
Message ID: 1430
Log Type: Synch
Recommended Input:
log bestgnssvela ontime 1
ASCII Example:
#BESTGNSSVELA,COM1,0,91.5,FINESTEERING,1692,332217.000,02000000,00b0,43521;SOL_ COMPUTED,DOPPLER_VELOCITY,0.150,0.000,0.0168,323.193320,0.0232,0.0*159c13ad
Field Field type
Data Description
Format
Binary Bytes
Binary Offset
1
BESTGNSSVEL Log header. See Messages on page 25 for
Header
more information.
-
H
0
2
Sol Status
Solution status, see Table 74: Solution Status on page 436
Enum 4
H
3
Vel Type
Velocity type, see Table 75: Position or Velocity Type on page 437
Enum 4
H+4
4
Latency
A measure of the latency in the velocity time
tag in seconds. It should be subtracted from Float
4
the time to give improved results.
H+8
OEM7 Commands and Logs Reference Manual v10
942
Chapter 5 SPAN Logs
Field Field type
5
Age
6
Hor Spd
7
Trk Gnd
8
Vert Spd
9
Reserved
10
xxxx
11
[CR][LF]
Data Description
Format
Binary Bytes
Binary Offset
Differential age
Float
4
H+12
Horizontal speed over ground, in metres per second
Double
8
H+16
Actual direction of motion over ground (track over ground) with respect to True North, in degrees
Double 8
H+24
Vertical speed, in metres per second, where
positive values indicate increasing altitude (up) and negative values indicate decreasing
Double
8
altitude (down)
H+32
Float
4
H+40
32-bit CRC (ASCII and Binary only)
Hex
4
H+44
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
943
Chapter 5 SPAN Logs
5.4 CORRIMUDATA
Corrected IMU Measurements
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
The CORRIMUDATA log contains the RAWIMU data corrected for gravity, the earth's rotation and estimated sensor errors. The values in this log are incremental values, accumulated over the logging interval of CORRIMUDATA, in units of radians for the attitude rate and m/s for the accelerations. Data output is not in the IMU Body frame, but is automatically rotated into the user configured output frame (configured with the SETINSROTATION command (see page 919), default Vehicle frame).
The short header format, CORRIMUDATAS, is recommended, as it is for all high data rate logs.
CORRIMUDATA can be logged with the ONTIME trigger, up to a rate of 200 Hz.
Since the CORRIMUDATA log is synchronous, if you log at a rate less than full data rate of the IMU, the corrected IMU data is accumulated to match the requested time interval. For asynchronous, full rate data, see the IMURATECORRIMUS log on page 952.
To obtain the instantaneous rates of acceleration (in m/s/s) or rotation (in rad/s) from the output values of measurements per sample rate (m/s/sample and rad/sample), multiply the output values by the CORRIMUDATA logging rate in Hz.
Message ID: 812
Log Type: Synch
Recommended Input: log corrimudatab ontime 0.01
Example log: #CORRIMUDATAA,COM1,0,77.5,FINESTEERING,1769,237601.000,02000020,bdba,12597;1769 ,237601.000000000,0.000003356,0.000002872,0.000001398,0.000151593,0.000038348,0.000078820*1f7eb709
Field Field Type
Description
1
CORRIMUDATA Log header. See Messages on page 25
Header
for more information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
944
Chapter 5 SPAN Logs
Field Field Type
Description
2
Week
GNSS week
3
Seconds
GNSS seconds from week start
4
PitchRate
About x axis rotation (right-handed) (rad/sample)
5
RollRate
About y axis rotation (right-handed) (rad/sample)
6
YawRate
About z axis rotation (right-handed) (rad/sample)
7
LateralAcc
INS Lateral Acceleration (along x axis) (m/s/sample)
8
LongitudinalAcc
INS Longitudinal Acceleration (along y axis) (m/s/sample)
9
VerticalAcc
INS Vertical Acceleration (along z axis) (m/s/sample)
10
xxxx
32-bit CRC
11
[CR][LF]
Sentence Terminator (ASCII only)
Format
Binary Bytes
Ulong 4
Double 8
Double 8
Double 8
Double 8
Double 8
Double 8
Double 8
Hex
4
-
-
Binary Offset H+ H+4 H+12
H+20
H+28
H+36
H+44
H+52 H+56 -
OEM7 Commands and Logs Reference Manual v10
945
Chapter 5 SPAN Logs
5.5 CORRIMUDATAS
Short Corrected IMU Measurements
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is the short header version of the CORRIMUDATA log (see page 944).
To obtain the instantaneous rates of acceleration (in m/s/s) or rotation (in rad/s) from the output values of measurements per sample rate (m/s/sample and rad/sample), multiply the output values by the CORRIMUDATAS logging rate in Hz.
Message ID: 813
Log Type: Synch
Recommended Input: log corrimudatasb ontime 0.01
Example log: %CORRIMUDATASA,1581,341553.000;1581,341552.997500000,-0.000000690,0.000001549,0.000001654,0.000061579,-0.000012645,-0.000029988*770c6232
Field Field Type
Description
Format
Binary Bytes
1
CORRIMUDATAS Log header. See Messages on page 25
Header
for more information.
-
H
2
Week
GNSS week
Ulong 4
3
Seconds
GNSS seconds from week start
Double 8
4
PitchRate
About x-axis rotation (right-handed) (rad/sample)
Double 8
5
RollRate
About y-axis rotation (right-handed) (rad/sample)
Double 8
6
YawRate
About z-axis rotation (right-handed) (rad/sample)
Double 8
7
LateralAcc
INS Lateral Acceleration (along x-axis) (m/s/sample)
Double
8
8
LongitudinalAcc
INS Longitudinal Acceleration (along yaxis) (m/s/sample)
Double
8
9
VerticalAcc
INS Vertical Acceleration (along z-axis) (m/s/sample)
Double
8
Binary Offset 0 H+ H+4 H+12
H+20
H+28
H+36
H+44
H+52
OEM7 Commands and Logs Reference Manual v10
946
Chapter 5 SPAN Logs
Field Field Type
10
xxxx
11
[CR][LF]
Description 32-bit CRC Sentence Terminator (ASCII only)
Format
Binary Bytes
Hex
4
-
-
Binary Offset
H+56
-
OEM7 Commands and Logs Reference Manual v10
947
Chapter 5 SPAN Logs
5.6 DELAYEDHEAVE
Delayed Heave Filter
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains the value of the delayed heave filter. The delayed heave value differs from the heave value in that delayed heave uses forward and backward smoothing, while heave uses backward smoothing only.
The heave filter must be enabled using the HEAVEFILTER command (see page 892) before this log is available.
The DELAYEDHEAVE log is output with default values and the current time stamp when the HEAVEFILTER is DISABLED. When the HEAVEFILTER is ENABLED, the DELAYEDHEAVE log will not be output until the heave window conditions (see the SETHEAVEWINDOW command on page 912) have been met.
Message ID: 1709
Log Type: Synch
Recommended Input: log delayedheavea ontime 0.1
ASCII example: #DELAYEDHEAVEA,COM1,0,72.0,FINESTEERING,1769,237598.000,02000020,27a3,12597;0.0 00080643,0.086274510*85cdb46d
Field Field Type
Description
1
DELAYEDHEAVE Log header. See Messages on page 25
Header
for more information.
2
Delayed Heave Delayed heave value
3
Std. Dev.
Standard deviation of the delayed heave value
4
xxxx
32-bit CRC (ASCII and Binary only)
5
[CR][LF]
Sentence Terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Double 8
H
Double 8
H+8
Hex
4
-
-
H+16 -
OEM7 Commands and Logs Reference Manual v10
948
Chapter 5 SPAN Logs
5.7 GIMBALLEDPVA
Display Gimballed Position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use the GIMBALLEDPVA log to view the re-calculated position, velocity and attitude of the gimbal null position whenever a new INPUTGIMBALANGLE command (see page 893) is received.
Message ID: 1321
Log Type: Asynch
Recommended Input: log gimballedpvaa onnew
ASCII Example: #GIMBALLEDPVAA,COM1,0,93.5,FINESTEERING,1635,320568.514,02000000,0000,407;1635, 320568.514000000,51.116376614,-114.038259915,1046.112025828,-0.000291756,0.000578067,0.030324466,-0.243093917,-0.127718304,19.495023227, INS_ALIGNMENT_ COMPLETE*32fbb61b
Field Field Type
Description
1
GIMBALLEDPVA Log header. See Messages on page 25 for
Header
more information.
2
Week
GPS week
3
Seconds
Seconds from week start
4
Latitude
WGS84 latitude in degrees
5
Longitude
WGS84 longitude in degrees
6
Height
WGS84 ellipsoidal height
7
North Velocity Velocity in a northerly direction
8
East Velocity Velocity in an easterly direction
9
Up Velocity
Velocity in an upward direction
10
Roll
Right-handed rotation from local level around the y-axis in degrees
11
Pitch
Right-handed rotation from local level around the x-axis in degrees
12
Azimuth
Right-handed rotation from local level around the z-axis in degrees
Format
Binary Bytes
-
H
Ulong 4 Double 8 Double 8 Double 8 Double 8 Double 8 Double 8 Double 8
Double 8
Double 8
Double 8
Binary Offset 0 H H+4 H+12 H+20 H+28 H+36 H+44 H+52 H+60
H+68
H+76
OEM7 Commands and Logs Reference Manual v10
949
Chapter 5 SPAN Logs
Field Field Type
Description
13
Status
14
xxxx
15
[CR][LF]
INS status, see Table 207: Inertial Solution Status on page 959
32-bit CRC
Sentence Terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Enum 4
H+84
Hex
4
-
-
H+88 -
OEM7 Commands and Logs Reference Manual v10
950
Chapter 5 SPAN Logs
5.8 HEAVE
Heave Filter Log
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log provides vessel heave computed by the integrated heave filter. Refer also to information in the SETHEAVEWINDOW command on page 912. This log is asynchronous, but is available at approximately 10 Hz.
You must have an inertial solution to use this log.
The heave filter must be enabled using the HEAVEFILTER command (see page 892), before this log is available.
Message ID: 1382
Log Type: Asynch
Recommended Input: log heavea onnew
Example: #HEAVEA,USB1,0,38.5,FINESTEERING,1630,232064.599,02000000,a759,6696;1630,232064 .589885392,0.086825199*93392cb4
Field Field Type
Description
Format
Binary Bytes
1
HEAVE Header
Log header. See Messages on page 25 for more information.
-
H
2
Week
GNSS Week
Ulong 4
3
Seconds into Week
Seconds from week start
Double 8
4
Heave
Instantaneous heave in metres
Double 8
5
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
Hex
4
6
[CR][LF]
Sentence Terminator (ASCII Only)
-
-
Binary Offset 0 H H+4 H+12 H+20 -
OEM7 Commands and Logs Reference Manual v10
951
Chapter 5 SPAN Logs
5.9 IMURATECORRIMUS
Asynchronous Corrected IMU Data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log provides the same information as the CORRIMUDATAS log (see page 946), but is available asynchronously at the full rate of the IMU.
Using this log consumes significant system resources and should only be used by experienced users. However, using this log consumes less resources than logging the synchronous CORRIMUDATAS log at the same rate.
To use this log, asynchronous logging must be enabled. See the ASYNCHINSLOGGING command on page 885.
To obtain the instantaneous rates of acceleration (in m/s/s) or rotation (in rad/s) from the output values of measurements per sample rate (m/s/sample and rad/sample), multiply the output values by the IMU data rate in Hz.
Message ID: 1362
Log Type: Asynch
Recommended Input: log imuratecorrimusb onnew
Example log: %IMURATECORRIMUSA,1581,341553.000;1581,341552.997500000,-0.000000690,0.000001549,0.000001654,0.000061579,-0.000012645,-0.000029988*770c6232
Field
Field Type
Description
1
IMURATECORRIMUS Log header. See Messages on
Header
page 25 for more information.
2
Week
GNSS week
3
Seconds
GNSS seconds from week start
4
PitchRate
About x axis rotation (rad/sample)
5
RollRate
About y axis rotation (rad/sample)
6
YawRate
About z axis rotation (right-handed) (rad/sample)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4 Double 8 Double 8 Double 8
H+ H+4 H+12 H+20
Double 8
H+28
OEM7 Commands and Logs Reference Manual v10
952
Chapter 5 SPAN Logs
Field
Field Type
7
LateralAcc
8
LongitudinalAcc
9
VerticalAcc
10
xxxx
11
[CR][LF]
Description
INS Lateral Acceleration (along xaxis) (m/s/sample) INS Longitudinal Acceleration (along y-axis) (m/s/sample) INS Vertical Acceleration (along zaxis)(m/s/sample) 32-bit CRC Sentence Terminator (ASCII only)
Format
Binary Bytes
Double 8
Double 8
Double 8
Hex
4
-
-
Binary Offset H+36
H+44
H+52 H+56 -
OEM7 Commands and Logs Reference Manual v10
953
Chapter 5 SPAN Logs
5.10 IMURATEPVA
Asynchronous INS Position, Velocity and Attitude
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log provides the same information as the INSPVA log (see page 978), but is available asynchronously at the full rate of the IMU.
Using this log consumes significant system resources and should only be used by experienced users.
However, using this log consumes less resources than logging the synchronous INSPVA log at the same rate.
To use this log, asynchronous logging must be enabled. See the ASYNCHINSLOGGING command on page 885.
Message ID: 1778
Log Type: Asynch
Recommended Input: log imuratepvaa onnew
ASCII Example: #IMURATEPVAA,COM1,0,57.0,FINESTEERING,1802,320345.180,02000000,9b1f,12987;1802, 320345.180000030,51.11695246671,-114.03897779953,1047.6905,0.2284,0.0076,0.2227,0.160588332,-0.039823409,269.988184416,INS_ALIGNMENT_ COMPLETE*f60016a6
Field Field Type
Description
1
IMURATEPVA Log header. See Messages on page 25
Header
for more information.
2
Week
GNSS Week
3
Seconds
Seconds from week start
4
Latitude
Latitude (WGS84) [degrees]
5
Longitude
Longitude (WGS84) [degrees]
6
Height
Ellipsoidal Height (WGS84) [m]
7
North Velocity
Velocity in a northerly direction (a -ve value implies a southerly direction) [m/s]
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4 Double 8 Double 8 Double 8 Double 8
H H+4 H+12 H+20 H+28
Double 8
H+36
OEM7 Commands and Logs Reference Manual v10
954
Chapter 5 SPAN Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
8
East Velocity
Velocity in an easterly direction (a -ve value implies a westerly direction) [m/s]
Double
8
H+44
9
Up Velocity Velocity in an up direction [m/s]
Double 8
H+52
10
Roll
Right-handed rotation from local level around y-axis in degrees
Double 8
H+60
11
Pitch
Right-handed rotation from local level around x-axis in degrees
Double 8
H+68
12
Azimuth
Left-handed rotation around z-axis in
degrees clockwise from North This is the inertial azimuth calculated
Double 8
from the IMU gyros and the SPAN filters.
H+76
13
Status
INS Status, see Table 207: Inertial Solution Status on page 959
Enum 4
H+84
14
xxxx
32-bit CRC
Hex
4
H+88
15
[CR][LF]
Sentence Terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
955
Chapter 5 SPAN Logs
5.11 IMURATEPVAS
Asynchronous INS Position, Velocity and Attitude
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log provides the same information as the INSPVAS log (see page 980), but is available asynchronously at the full rate of the IMU.
Using this log consumes significant system resources and should only be used by experienced users.
However, using this log consumes less resources than logging the synchronous INSPVAS log at the same rate.
To use this log, asynchronous logging must be enabled. See the ASYNCHINSLOGGING command on page 885.
Message ID: 1305
Log Type: Asynch
Recommended Input: log imuratepvas
ASCII Example: %IMURATEPVASA,1264,144059.000;1264,144059.002135700,51.116680071,114.037929194,515.286704183,277.896368884,84.915188605,8.488207941,0.759619515,-2.892414901,6.179554750,INS_ALIGNMENT_ COMPLETE*855d6f76
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
IMURATEPVAS Log header. See Messages on page 25 for
Header
more information.
-
H
0
2
Week
GNSS Week
Ulong 4
H
3
Seconds
Seconds from week start
Double 8
H+4
4
Latitude
Latitude (WGS84)
Double 8
H+12
5
Longitude
Longitude (WGS84)
Double 8
H+20
6
Height
Ellipsoidal Height (WGS84) [m]
Double 8
H+28
7
North Velocity
Velocity in a northerly direction (a -ve value implies a southerly direction) [m/s]
Double
8
H+36
OEM7 Commands and Logs Reference Manual v10
956
Chapter 5 SPAN Logs
Field Field Type
8
East Velocity
9
Up Velocity
10
Roll
11
Pitch
12
Azimuth
13
Status
14
xxxx
15
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Velocity in an easterly direction (a -ve value implies a westerly direction) [m/s]
Double
8
H+44
Velocity in an up direction [m/s]
Double 8
H+52
Right-handed rotation from local level around y-axis in degrees
Double 8
H+60
Right-handed rotation from local level around x-axis in degrees
Double 8
H+68
Left-handed rotation around z-axis in degrees clockwise from North
Double 8
H+76
INS Status, see Table 207: Inertial Solution Status on page 959
Enum
4
H+84
32-bit CRC
Hex
4
H+88
Sentence Terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
957
Chapter 5 SPAN Logs
5.12 INSATT
INS Attitude
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains the most recent attitude measurements computed by the SPAN filter. This attitude definition may not correspond to other definitions of the terms pitch, roll and azimuth. By default, the output attitude is with respect to the vehicle frame. If the attitude output is desired with respect to another frame of reference, use the SETINSROTATION USER command (see the SETINSROTATION command on page 919) to configure the user output frame offset rotation.
Message ID: 263
Log Type: Synch
Recommended Input: log insatta ontime 1
ASCII Example: #INSATTA,USB2,0,14.5,FINESTEERING,1541,487970.000,02040000,5b35,37343;1541,4879 70.000549050,1.876133508,-4.053672765,328.401460897,INS_SOLUTION_GOOD*ce4ac533
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
INSATT Header
Log header. See Messages on page 25 for more information.
-
H
0
2
Week
GNSS Week
Ulong 4
H
3
Seconds into Week
Seconds from week start
Double 8
H+4
4
Roll
Right-handed rotation from local level around y-axis in degrees.
Double 8
H+12
5
Pitch
Right-handed rotation from local level around x-axis in degrees.
Double 8
H+20
Left-handed rotation around z-axis in degrees
clockwise from North.
6
Azimuth
Double 8
This is the inertial azimuth calculated from the
IMU gyros and the SPAN filters.
H+28
7
Status
INS status, see Table 207: Inertial Solution Status on the next page.
Enum
H+36
8
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
Hex
H+40
9
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
958
Chapter 5 SPAN Logs
Table 207: Inertial Solution Status
Binary
ASCII
Description
0
INS_INACTIVE
IMU logs are present, but the alignment routine has not started; INS is inactive.
1
INS_ALIGNING INS is in alignment mode.
The INS solution is in navigation mode but the azimuth solution
uncertainty has exceeded the threshold. The default threshold is 2
degrees for most IMUs. The solution is still valid but you should
monitor the solution uncertainty in the INSSTDEV log (see page 991).
2
INS_HIGH_ VARIANCE
You may encounter this state during times when the GNSS, used to aid the INS, is absent.
The INS solution uncertainty contains outliers and the solution may be outside specifications.1 The solution is still valid but you should monitor the solution uncertainty in the INSSTDEV log (see page 991). It may be encountered during times when GNSS is absent or poor.
INS_
3
SOLUTION_
The INS filter is in navigation mode and the INS solution is good.
GOOD
The INS filter is in navigation mode and the GNSS solution is suspected
INS_
to be in error.
6
SOLUTION_
This may be due to multipath or limited satellite visibility. The inertial
FREE
filter has rejected the GNSS position and is waiting for the solution
quality to improve.
7
INS_ ALIGNMENT_ COMPLETE
The INS filter is in navigation mode, but not enough vehicle dynamics have been experienced for the system to be within specifications.
8
DETERMINING_ ORIENTATION
INS is determining the IMU axis aligned with gravity.
9
WAITING_ INITIALPOS
The INS filter has determined the IMU orientation and is awaiting an initial position estimate to begin the alignment process.
10
WAITING_ AZIMUTH
The INS filer has orientation, initial biases, initial position and valid roll/pitch estimated. Will not proceed until initial azimuth is entered.
11
INITIALIZING_ The INS filter is estimating initial biases during the first 10 seconds of
BIASES
stationary data.
12
MOTION_ DETECT
The INS filter has not completely aligned, but has detected motion.
1The solution uncertainty threshold levels can be adjusted using the INSTHRESHOLDS command on page 905.
OEM7 Commands and Logs Reference Manual v10
959
Chapter 5 SPAN Logs
5.13 INSATTQS
Short INS Quaternion Attitude
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7, SMART7-I, SMART7-S, SMART7-W
This log contains the attitude from the INSATT log, but the rotation from local level is given as a Quaternion rather than Euler Angles. The quaternion takes the form:
The element w is the rotational component, defining the magnitude of the rotation to be performed. The elements x, y, and z are the vector portion of the rotation, which define the axis about which the rotation is to be performed.
If is the rotational angle, and the axis of rotation is defined by the vector the elements of the quaternion can be written as:
, then
Message ID: 2118
Log Type: Synch
Recommended Input: log insattqsa ontime 1
ASCII Example: %INSATTQSA,1943,425090.000;1943,425090.000000000,0.706276782,0.001974400,0.001083571,-0.707932225,INS_ALIGNMENT_COMPLETE*552d93f0
Field Field Type
Description
Format
Binary Bytes
1
INSATTQS Header
Log header. See Messages on page 25 for more information.
-
H
2
Week
GNSS Week
Ulong 4
3
Seconds into Week
Seconds from week start
Double 8
4
Quaternion w
Quaternion rotation from local level, w component
Double 8
Binary Offset 0 H H+4
H+12
OEM7 Commands and Logs Reference Manual v10
960
Chapter 5 SPAN Logs
Field Field Type
Description
5
Quaternion x
Quaternion rotation from local level, x component
6
Quaternion y
Quaternion rotation from local level, y component
7
Quaternion z
Quaternion rotation from local level, z component
8
Status
INS status, see Table 207: Inertial Solution Status on page 959
9
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
10
[CR][LF]
Sentence Terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+20
Double 8
H+28
Double 8
H+36
Enum 4
H+44
Hex
4
-
-
H+48 -
OEM7 Commands and Logs Reference Manual v10
961
Chapter 5 SPAN Logs
5.14 INSATTS
Short INS Attitude
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is the short header version of the INSATT log (see page 958).
Message ID: 319
Log Type: Synch
Recommended Input: log insattsa ontime 1
ASCII Example: %INSATTSA,1541,487975.000;1541,487975.000549050,2.755452422,4.127365126,323.289778434,INS_SOLUTION_GOOD*ba08754f
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
INSATTS Header
Log header. See Messages on page 25 for more information.
-
H
0
2
Week
GNSS Week
Ulong 4
H
3
Seconds into Week
Seconds from week start
Double 8
H+4
4
Roll
Right-handed rotation from local level around y-axis in degrees
Double 8
H+12
5
Pitch
Right-handed rotation from local level around x-axis in degrees
Double 8
H+20
Left-handed rotation around z-axis in degrees
clockwise from North
6
Azimuth
Double 8
This is the inertial azimuth calculated from the
IMU gyros and the SPAN filters.
H+28
7
Status
INS status, see Table 207: Inertial Solution Status on page 959
Enum 4
H+36
8
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
Hex
4
H+40
9
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
962
Chapter 5 SPAN Logs
5.15 INSATTX
Inertial Attitude � Extended
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log includes the information from the INSATT log (see page 958), as well as information about the attitude standard deviation. The position type and solution status fields indicate whether or not the corresponding data is valid.
The INSATTX log is a large log and is not recommend for high rate logging.
If you want to use high rate logging, log the INSATTS log at a high rate and the INSSTDEVS log ontime 1.
Message ID: 1457
Log Type: Synch
Recommended Input: log insattxa ontime 1
ASCII Example: #INSATTXA,COM1,0,81.0,FINESTEERING,1690,494542.000,02000040,5d25,43441;INS_ ALIGNMENT_COMPLETE,INS_PSRSP,1.137798832,0.163068414,135.754208544,0.017797431,0.017861038,3.168394804,4,0*f944b004
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
INSATTX Header
Log header. See Messages on page 25 for more information.
H
0
Solution status
2
INS Status See Table 207: Inertial Solution Status on
Enum 4
H
page 959
Position type
3
Pos Type See Table 75: Position or Velocity Type on
page 437
Enum 4
H+4
4
Roll
Roll in Local Level (degrees)
Double 8
H+8
5
Pitch
Pitch in Local Level (degrees)
Double 8
H+16
Azimuth in Local Level (degrees)
6
Azimuth This is the inertial azimuth calculated from the Double 8
IMU gyros and the SPAN filters.
H+24
7
Roll
Roll standard deviation (degrees)
Float
4
H+32
OEM7 Commands and Logs Reference Manual v10
963
Chapter 5 SPAN Logs
Field
Field Type
Description
8
Pitch
Pitch standard deviation (degrees)
9
Azimuth Azimuth standard deviation (degrees)
10
Ext sol stat
Extended solution status See Table 208: Extended Solution Status below
Time
11
Since
Update
Elapsed time since the last ZUPT or position update (seconds)
11
xxxx
32-bit CRC (ASCII and Binary only)
12
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Float
4
H+36
Float
4
H+40
Hex
4
H+44
Ushort 2
Hex
4
-
-
H+48
H+50 -
Table 208: Extended Solution Status
Nibble Bit
Mask
Description
Range Value
0 0x00000001 Position update
0 = Unused 1 = Used
1 0x00000002 Phase update
0 = Unused 1 = Used
N0
2
0x00000004 Zero velocity update
0 = Unused 1 = Used
3
0x00000008 Wheel sensor update
0 = Unused 1 = Used
4
0x00000010
ALIGN (heading) update
0 = Unused 1 = Used
5
0x00000020
External position update
N1
6
0x00000040
INS solution convergence flag
0 = Unused 1 = Used
0 = Not converged 1 = Converged
7 0x00000080 Doppler update
0 = Unused 1 = Used
OEM7 Commands and Logs Reference Manual v10
964
Chapter 5 SPAN Logs
Nibble Bit
Mask
Description
Range Value
8
0x00000100 Pseudorange update
0 = Unused 1 = Used
9 0x00000200 Velocity update N2
10 0x00000400 Reserved
0 = Unused 1 = Used
11
0x00000800
Dead reckoning update
0 = Unused 1 = Used
12
0x00001000 Phase wind up update
0 = Unused 1 = Used
13
0x00002000
Course over ground update
0 = Unused 1 = Used
N3
14
0x00004000
External velocity update
0 = Unused 1 = Used
15
0x00008000
External attitude update
0 = Unused 1 = Used
16
0x00010000
External heading update
0 = Unused 1 = Used
N4
17
0x00020000
External height update
0 = Unused 1 = Used
18 0x00040000 Reserved
19 0x00080000 Reserved
20
0x00100000 Rover position update
0 = Unused 1 = Used
N5
21
0x00200000
Rover position update type
0 = Non-RTK update 1 = RTK integer update
22 0x00400000 Reserved
23 0x00800000 Reserved
OEM7 Commands and Logs Reference Manual v10
965
Chapter 5 SPAN Logs
Nibble Bit
Mask
Description
24
0x01000000
Turn on biases estimated
25
0x02000000
Alignment direction verified
N6
26
0x04000000
Alignment Indication 1
27
0x08000000
Alignment Indication 2
28
0x10000000
Alignment Indication 3
29
0x20000000
NVM Seed Indication 1
N7
30
0x40000000
NVM Seed Indication 2
31
0x80000000
NVM Seed Indication 3
Range Value
0 = Static turn-on biases not estimated (starting from zero) 1 = Static turn-on biases estimated
0 = Not verified 1 = Verified
0 = Not set, 1 = Set Refer to Table 209: Alignment Indication below
0 = Not set, 1 = Set Refer to Table 209: Alignment Indication below
0 = Not set, 1 = Set Refer to Table 209: Alignment Indication below
0 = Not set, 1 = Set Refer to Table 210: NVM Seed Indication on the next page
0 = Not set, 1 = Set Refer to Table 210: NVM Seed Indication on the next page
0 = Not set, 1 = Set Refer to Table 210: NVM Seed Indication on the next page
Table 209: Alignment Indication
Bits 26-28 Values Hex Value Completed Alignment Type
000
0x00
Incomplete Alignment
001
0x01
Static
010
0x02
Kinematic
011
0x03
Dual Antenna
100
0x04
User Command
101
0x05
NVM Seed
OEM7 Commands and Logs Reference Manual v10
966
Chapter 5 SPAN Logs
Bit 2931
Values
Hex Value
000
0x00
001
0x01
010
0x02
011
0x03
100
0x04
101
0x05
110
0x06
Table 210: NVM Seed Indication
NVM Seed Type
NVM Seed Inactive Seed stored in NVM is invalid NVM Seed failed validation check NVM Seed is pending validation (awaiting GNSS) NVM Seed Injected (includes error model data) NVM Seed data ignored due to a user-commanded filter reset or configuration change NVM Seed error model data injected
OEM7 Commands and Logs Reference Manual v10
967
Chapter 5 SPAN Logs
5.16 INSCALSTATUS
Offset calibration status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log reports the status and estimated values of the currently running offset calibration.
Message ID: 1961
Log Type: Asynch
Abbreviated ASCII Syntax: log inscalstatus onchanged
ASCII Example: #INSCALSTATUSA,COM1,0,80.0,FINESTEERING,1880,317815.012,02000000,a4f2,32768;RBV ,0.0000,-180.0000,-90.0000,45.0000,45.0000,45.0000,INS_CONVERGING,1*e0b3152d
Field Field Type
Description
Binary Binary Binary Format Bytes Offset
1
INSCALSTATUS Log header. See Messages on page 25 for
header
more information.
-
H
0
2
Offset Type
Type of offset (see Table 211: Offset Type on the next page).
Enum
4
H
3
X axis offset
IMU body frame X-axis offset (m/degrees). Float
4
H+4
4
Y axis offset
IMU body frame Y-axis offset (m/degrees). Float
4
H+8
5
Z axis offset
IMU body frame Z-axis offset (m/degrees). Float
4
H+12
6
X uncertainty
IMU body frame X-axis offset uncertainty (m/degrees).
Float
4
H+16
7
Y uncertainty
IMU body frame Y-axis offset uncertainty (m/degrees).
Float
4
H+20
8
Z uncertainty
IMU body frame Z-axis offset uncertainty (m/degrees).
Float
4
H+24
Source from which offset values originate
9
Source Status (see Table 212: Source Status on the next Enum 4
page).
H+28
Multi-line
10
Calibration
Count
Counter for number of completed calibrations cumulatively averaged.
Ulong 4
H+32
11
xxxx
32-bit CRC (ASCII and Binary only).
Hex
4
H+36
12
[CR][LF]
Sentence terminator (ASCII only).
-
-
-
OEM7 Commands and Logs Reference Manual v10
968
Chapter 5 SPAN Logs
Units for the axis offset and uncertainty values (fields 3-8) are in metres for translational offset components and degrees for rotational offset components.
Table 211: Offset Type
Binary ASCII
Description
1
ANT1 Primary IMU to antenna lever arm
8
ALIGN Align offset
11
RBV IMU body to vehicle offset
Table 212: Source Status
Binary
ASCII
Description
1
FROM_NVM
Offset values originate from saved parameters in NVM
2
CALIBRATING Offset values originate from a currently running calibration process
3
CALIBRATED
Offset values originate from a completed calibration process
4
FROM_ COMMAND
Offset values originate from a user command
5
RESET
Offset values originate from a system reset
6
FROM_DUAL_ ANT
Offset values originate from a dual antenna Align solution
7
INS_ CONVERGING
Offset values originate from initial input values. Calibration process on hold until INS solution is converged.
8
INSUFFICIENT_ Offset values originate from a currently running calibration process.
SPEED
Further estimation on hold due to insufficient speed.
9
HIGH_ ROTATION
Offset values originate from a currently running calibration process. Further estimation on hold due to high vehicle rotations.
OEM7 Commands and Logs Reference Manual v10
969
Chapter 5 SPAN Logs
5.17 INSCONFIG
Determine required settings for post-processing or system analysis
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is the single message required to determine all required settings for post-processing or system analysis. This log is asynchronous and published for any change to the included fields. It is intended to be recorded occasionally though it could be updated frequently at system startup.
Message ID: 1945
Log Type: Polled
Recommended Input: log insconfig onchanged
ASCII Example: #INSCONFIGA,COM1,0,71.0,COARSESTEERING,1931,517331.006,02400000,6d7a, 32768;EPSON_G320,6,50,20,DEFAULT,00ffd1bf,AUTOMATIC,ROVER,FALSE, 00000000,0,0,0,0,0,0,0,0,0,1,ANT1,IMUBODY,0.0540,0.0699,-0.0346,0.0200, 0.0200,0.0200,FROM_NVM,1,RBV,IMUBODY,180.0000,0.0000,90.0000,5.0000, 5.0000,5.0000,FROM_COMMAND*b1233ac4
Field 1 2 3
4
5 6 7 8
Field Type
INSCONFIG Header IMU Type Mapping
Initial Alignment Velocity
Heave Window
Profile
Enabled Updates
Alignment Mode
Description
Binary Binary Binary Format Bytes Offset
Command header. See Messages on page 25 for more information.
-
H
0
IMU type
Enum 4
H
Mapping / Orientation
Uchar 1
H+4
Minimum Alignment Velocity entered by the user.
Uchar 1 Note: Velocity (m/s) is scaled by 10 for 10cm/s precision
H+5
Length of the heave window in seconds (if set)
Ushort
2
H+6
Profile setting (see the SETINSPROFILE command on page 917)
Enum
4
H+8
Enabled update types
Hex
4
H+12
Alignment mode configured on the system (see the ALIGNMENTMODE command on Enum 4 page 883)
H+16
OEM7 Commands and Logs Reference Manual v10
970
Chapter 5 SPAN Logs
Field 9
10
11
12 13 14 15 16 17 18 19
Field Type
Description
Binary Binary Binary Format Bytes Offset
The user specified output frame of the
Relative INS Vector (see
Relative INS SETRELINSOUTPUTFRAME command
Output
on page 927)
Enum 4
Frame
If not specified, the default value
appears.
H+20
The User specified Output direction of the
Relative INS Vector (From or To Master-
Rover) (see the
Relative INS SETRELINSOUTPUTFRAME command
Output
on page 927).
Bool
4
Direction
If not specified, the default value
appears. TRUE if From Master, FALSE
(Default) if From Rover
H+24
Lower byte- INS Reset. Corresponds numerically to the INS Reset as described by the INSResetEnum
INS Receiver Status
Second byte= 0x01 if an IMU Communication Error (Receiver status bit 17).
Hex
4
= 0x00 otherwise.
Other values are reserved for future use.
Upper 2 bytes - reserved.
H+28
INS Seed Enabled
INS Seed Enable setting (see the INSSEED command on page 903) Enabled = 1, Disabled = 0
Uchar 1
H+32
INS Seed Validation
INS Seed Validation setting (see the INSSEED command on page 903)
Uchar 1
H+33
Reserved 1
N/A
2
H+34
Reserved 2
N/A
4
H+36
Reserved 3
N/A
4
H+40
Reserved 4
N/A
4
H+44
Reserved 5
N/A
4
H+48
Reserved 6
N/A
4
H+52
OEM7 Commands and Logs Reference Manual v10
971
Chapter 5 SPAN Logs
Field Field Type
20
Reserved 7
Description
Binary Binary Binary Format Bytes Offset
N/A
4
H+56
21
Number of Translations
Number of translation entries to follow
Ulong 4
H+60
22
Translation
Translation to follow (see Table 205: Translation Offset Types on page 923)
Enum 4
23
Frame
Frame of translation (IMUBODY or VEHICLE)
Enum 4
variable variable
24
X Offset
X Offset
Float
4
variable
25
Y Offset
Y Offset
Float
4
variable
26
Z Offset
Z Offset
Float
4
variable
27
X Uncertainty X Uncertainty
Float
4
variable
28
Y Uncertainty Y Uncertainty
Float
4
variable
29
Z Uncertainty Z Uncertainty
Float
4
variable
30
Translation Source
Source of translation (see Table 212: Source Status on page 969)
Enum 4
variable
Next Translation
variable
Number of Rotations
Number of rotation entries to follow
Ulong 4
variable
variable Rotation
Rotation to follow (see Table 204: Rotational Offset Types on page 920)
Enum 4
variable
variable Frame
Frame of rotation (IMUBODY or VEHICLE) Enum 4
variable
variable X Rotation
X Rotation
Float
4
variable
variable Y Rotation
Y Rotation
Float
4
variable
variable Z Rotation
Z Rotation
Float
4
variable
variable
X Rotation Std Dev
X Rotation offset standard deviation (degrees)
Float
4
variable
variable
Y Rotation STD Dev
Y Rotation offset standard deviation (degrees)
Float
4
variable
variable
Z Rotation STD Dev
Z Rotation offset standard deviation (degrees)
Float
4
variable
OEM7 Commands and Logs Reference Manual v10
972
Chapter 5 SPAN Logs
Field Field Type
variable
Rotation Source
Description
Binary Binary Binary Format Bytes Offset
Source of rotation (see Table 212: Source Status on page 969)
Enum
4
variable
Next Rotation
variable xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
variable
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
973
Chapter 5 SPAN Logs
5.18 INSPOS
INS Position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains the most recent position measurements in WGS84 coordinates and includes an INS status indicator. The log reports the position at the IMU center, unless the SETINSTRANSLATION USER command was issued. See the SETINSTRANSLATION command on page 922.
This log provides the position information in WGS84.
Message ID: 265
Log Type: Synch
Recommended Input: log insposa ontime 1
ASCII Example: #INSPOSA,USB2,0,18.0,FINESTEERING,1541,487977.000,02040000,17cd,37343;1541, 487977.000549050,51.121315135,-114.042311349,1038.660737046,INS_SOLUTION_GOOD *2fffd557
Field Field Type
Description
1
INSPOS Header
Log header. See Messages on page 25 for more information.
2
Week
GNSS Week
3
Seconds into Week
Seconds from week start
4
Latitude
Latitude (WGS84)
5
Longitude Longitude (WGS84)
6
Height
Ellipsoidal Height (WGS84) [m]
7
Status
INS status, see Table 207: Inertial Solution Status on page 959
8
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Double 8
H+4
Double 8 Double 8 Double 8
H+12 H+20 H+28
Enum 4
H+36
Hex
4
-
-
H+40 -
OEM7 Commands and Logs Reference Manual v10
974
Chapter 5 SPAN Logs
5.19 INSPOSS
Short INS Position
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is the short header version of the INSPOS log (see page 974).
This log provides the position information in WGS84.
Message ID: 321
Log Type: Synch
Recommended Input: log inspossa ontime 1
ASCII Example: %INSPOSSA,1541,487916.000;1541,487916.000549050,51.115797277,-114.037811065, 1039.030700122,INS_SOLUTION_GOOD*5ca30894
Field Field Type
Description
1
INSPOSS Header
Log header. See Messages on page 25 for more information.
2
Week
GNSS Week
3
Seconds into Week
Seconds from week start
4
Latitude
Latitude (WGS84)
5
Longitude Longitude (WGS84)
6
Height
Ellipsoidal Height (WGS84) [m]
7
Status
INS status, see Table 207: Inertial Solution Status on page 959
8
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Double 8
H+4
Double 8 Double 8 Double 8
H+12 H+20 H+28
Enum 4
H+36
Hex
4
-
-
H+40 -
OEM7 Commands and Logs Reference Manual v10
975
Chapter 5 SPAN Logs
5.20 INSPOSX
Inertial Position � Extended
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log includes the information from the INSPOS log, as well as information about the position standard deviation. The position type and solution status fields indicate whether or not the corresponding data is valid.
The INSPOSX log is a large log and is not recommend for high rate logging. If you want to use high rate logging, log the INSPOSS log at a high rate and the INSSTDEVS log ontime 1.
This log provides the position information in the user datum. To determine the datum being used, log the BESTPOS log.
Message ID: 1459
Log Type: Synch
Recommended Input: log insposxa ontime 1
ASCII example: #INSPOSXA,COM1,0,79.0,FINESTEERING,1690,493465.000,02000040,7211,43441;INS_ SOLUTION_GOOD,INS_PSRSP,51.11637750859,114.03826206294,1049.1191,0.4883,0.4765,0.8853,3,0*dee048ab
Field Field Type
Description
Format
Binary Bytes
1
INSPOSX Header
Log header. See Messages on page 25 for more information.
H
Solution status
2
INS Status See Table 207: Inertial Solution Status on Enum 4
page 959
Position type
3
Pos Type
See Table 75: Position or Velocity Type
Enum
4
on page 437
4
Lat
Latitude
Double 8
5
Long
Longitude
Double 8
6
Height
Height above sea level (m)
Double 8
Binary Offset 0
H
H+4 H+8 H+16 H+24
OEM7 Commands and Logs Reference Manual v10
976
Chapter 5 SPAN Logs
Field Field Type
Description
7
Undulation Undulation (m)
8
Lat
Latitude standard deviation
9
Long
Longitude standard deviation
10
Height
Height standard deviation
Extended solution status
11
Ext sol stat See Table 208: Extended Solution Status
on page 964
11
Time Since Update
Elapsed time since the last ZUPT or position update (seconds)
12
xxxx
32-bit CRC (ASCII and Binary only)
13
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Float
4
Float
4
Float
4
Float
4
Hex
4
Ushort 2
Hex
4
-
-
Binary Offset H+32 H+36 H+34 H+44
H+48
H+52 H+54 -
The INS covariance and standard deviation values reported by the SPAN filter are an estimate of the Inertial filter solution quality. In lower accuracy GNSS position modes, such as SINGLE or WAAS (see Table 75: Position or Velocity Type on page 437), the position covariance and standard deviation values can appear to become optimistic compared with the absolute GNSS accuracy. This is due to the INS filter's ability to smooth short term noise in the GNSS solution, although the overall position error envelope still reflects the GNSS accuracy. Therefore, if the desired application requires absolute GNSS position accuracy, it is recommended to also monitor GNSS position messages such as BESTGNSSPOS (see BESTGNSSPOS log on page 939).
OEM7 Commands and Logs Reference Manual v10
977
Chapter 5 SPAN Logs
5.21 INSPVA
INS Position, Velocity and Attitude
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log allows INS position, velocity and attitude, with respect to the SPAN frame, to be collected in one log, instead of using three separate logs. Refer to the INSATT log (see page 958) for an explanation of how the SPAN frame may differ from the IMU enclosure frame.
This log provides the position information in WGS84.
Message ID: 507
Log Type: Synch
Recommended Input: log inspvaa ontime 1
ASCII Example: #INSPVAA,COM1,0,31.0,FINESTEERING,1264,144088.000,02040000,5615,1541;1264,14408 8.002284950,51.116827527,114.037738908,401.191547167,354.846489850,108.429407241,10.837482850,1.116219952,-3.476059035,7.372686190,INS_ALIGNMENT_ COMPLETE*af719fd9
Field
Field Type
Description
1
INSPVA Header
Log header. See Messages on page 25 for more information.
2
Week
GNSS Week
3
Seconds Seconds from week start
4
Latitude Latitude (WGS84) [degrees]
5
Longitude Longitude (WGS84) [degrees]
6
Height
Ellipsoidal Height (WGS84) [m]
7
North Velocity
Velocity in a northerly direction (a -ve value implies a southerly direction) [m/s]
8
East Velocity
Velocity in an easterly direction (a -ve value implies a westerly direction) [m/s]
9
Up Velocity
Velocity in an up direction [m/s]
Format
Binary Bytes
-
H
Ulong 4 Double 8 Double 8 Double 8 Double 8
Double 8
Double 8
Double 8
Binary Offset 0 H H+4 H+12 H+20 H+28 H+36
H+44
H+52
OEM7 Commands and Logs Reference Manual v10
978
Chapter 5 SPAN Logs
Field
Field Type
10
Roll
11
Pitch
12
Azimuth
13
Status
14
xxxx
15
[CR][LF]
Description
Right-handed rotation from local level around y-axis in degrees
Right-handed rotation from local level around x-axis in degrees
Left-handed rotation around z-axis in degrees clockwise from North This is the inertial azimuth calculated from the IMU gyros and the SPAN filters.
INS Status, see Table 207: Inertial Solution Status on page 959
32-bit CRC
Sentence Terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+60
Double 8
H+68
Double 8
H+76
Enum 4
Hex
4
-
-
H+84 H+88 -
OEM7 Commands and Logs Reference Manual v10
979
Chapter 5 SPAN Logs
5.22 INSPVAS
Short INS Position, Velocity and Attitude
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is the short header version of the INSPVA log (see page 978).
This log provides the position information in WGS84.
Message ID: 508
Log Type: Synch
Recommended Input: log inspvasa ontime 1
ASCII Example: %INSPVASA,1264,144059.000;1264,144059.002135700,51.116680071,114.037929194,515.286704183,277.896368884,84.915188605,8.488207941,0.759619515,-2.892414901,6.179554750,INS_ALIGNMENT_ COMPLETE*855d6f76
Field
Field Type
Description
1
INSPVAS Log header. See Messages on page 25 for more Header information.
2
Week
GNSS Week
3
Seconds Seconds from week start
4
Latitude Latitude (WGS84) [degrees]
5
Longitude Longitude (WGS84) [degrees]
6
Height
Ellipsoidal Height (WGS84) [m]
7
North Velocity
Velocity in a northerly direction (a -ve value implies a southerly direction) [m/s]
8
East Velocity
Velocity in an easterly direction (a -ve value implies a westerly direction) [m/s]
9
Up Velocity
Velocity in an up direction [m/s]
10
Roll
Right-handed rotation from local level around y-axis in degrees
Format
Binary Bytes
-
H
Ulong 4 Double 8 Double 8 Double 8 Double 8
Double 8
Double 8
Double 8
Double 8
Binary Offset 0 H H+4 H+12 H+20 H+28 H+36
H+44
H+52
H+60
OEM7 Commands and Logs Reference Manual v10
980
Chapter 5 SPAN Logs
Field
Field Type
11
Pitch
12
Azimuth
13
Status
14
xxxx
15
[CR][LF]
Description
Right-handed rotation from local level around x-axis in degrees
Left-handed rotation around z-axis in degrees clockwise from north This is the inertial azimuth calculated from the IMU gyros and the SPAN filters.
INS Status, see Table 207: Inertial Solution Status on page 959
32-bit CRC
Sentence Terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+68
Double 8
H+76
Enum 4
Hex
4
-
-
H+84 H+88 -
OEM7 Commands and Logs Reference Manual v10
981
Chapter 5 SPAN Logs
5.23 INSPVAX
Inertial PVA � Extended
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log includes the information from the INSPVA log, as well as information about the position standard deviation. The position type and solution status fields indicate whether or not the corresponding data is valid.
The INSPVAX log is a large log and is not recommend for high rate logging. If you want to use high rate logging, log the INSPVAS log at a high rate and the INSSTDEVS log ontime 1.
This log provides the position information in the user datum. To determine the datum being used, log the BESTPOS log.
Message ID: 1465
Log Type: Synch
Recommended Input: log inspvaxa ontime 1
ASCII example: #INSPVAXA,COM1,0,73.5,FINESTEERING,1695,309428.000,02000040,4e77,43562;INS_ SOLUTION_GOOD,INS_PSRSP,51.11637873403,-114.03825114994,1063.6093,-16.9000,0.0845,-0.0464,0.0127,0.138023492,0.069459386,90.000923268,0.9428,0.6688,1.4746,0.0430,0.0518, 0.0521,0.944295466,0.944567084,1.000131845,3,0*e877c178
Field
Field Type
Data Description
1
INSPVAX Header
Log header. See Messages on page 25 for more information.
Solution status
2
INS Status See Table 207: Inertial Solution Status on
page 959
Position type
3
Pos Type See Table 75: Position or Velocity Type on
page 437
4
Lat
Latitude (degrees)
Format
Binary Bytes
Binary Offset
H
0
Enum 4
H
Enum 4 Double 8
H+4 H+8
OEM7 Commands and Logs Reference Manual v10
982
Chapter 5 SPAN Logs
Field
Field Type
Data Description
Format
Binary Bytes
Binary Offset
5
Long
Longitude (degrees)
Double 8
H+16
6
Height
Height above mean sea level (m)
Double 8
H+24
7
Undulation Undulation (m)
Float
4
H+32
8
North Vel North velocity (m/s)
Double 8
H+36
9
East Vel
East velocity (m/s)
Double 8
H+44
10
Up Vel
Up velocity (m/s)
Double 8
H+52
11
Roll
Roll in Local Level (degrees)
Double 8
H+60
12
Pitch
Pitch in Local Level (degrees)
Double 8
H+68
Azimuth in Local Level (degrees)
13
Azimuth
This is the inertial azimuth calculated from the Double 8
IMU gyros and the SPAN filters.
H+76
14
Lat
Latitude standard deviation (m)
Float
4
H+84
15
Long
Longitude standard deviation (m)
Float
4
H+88
16
Height Height standard deviation (m)
Float
4
H+92
17
North Vel North velocity standard deviation (m/s)
Float
4
H+96
18
East Vel East velocity standard deviation (m/s)
Float
4
H+100
19
Up Vel Up velocity standard deviation (m/s)
Float
4
H+104
20
Roll
Roll standard deviation (degrees)
Float
4
H+108
21
Pitch
Pitch standard deviation (degrees)
Float
4
H+112
22
Azimuth Azimuth standard deviation (degrees)
Float
4
H+116
Extended solution status
23
Ext sol stat See Table 208: Extended Solution Status on Hex
4
page 964
H+120
24
Time Since Elapsed time since the last ZUPT or position
Update
update (seconds)
Ushort 2
H+124
25
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+126
26
[CR][LF] Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
983
Chapter 5 SPAN Logs
The INS covariance and standard deviation values reported by the SPAN filter are an estimate of the Inertial filter solution quality. In lower accuracy GNSS position modes, such as SINGLE or WAAS (see Table 75: Position or Velocity Type on page 437), the position covariance and standard deviation values can appear to become optimistic compared with the absolute GNSS accuracy. This is due to the INS filter's ability to smooth short term noise in the GNSS solution, although the overall position error envelope still reflects the GNSS accuracy. Therefore, if the desired application requires absolute GNSS position accuracy, it is recommended to also monitor GNSS position messages such as BESTGNSSPOS (see BESTGNSSPOS log on page 939).
OEM7 Commands and Logs Reference Manual v10
984
Chapter 5 SPAN Logs
5.24 INSSEEDSTATUS
Status of INS Seed
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log reports the current status of the INS Seed. See the OEM7 SPAN Installation and Operation User Manual for more information about an INS Seed.
Message ID: 2129
Log Type: Asynch
Abbreviated ASCII Syntax: log insseedstatusa onnew
Example: #INSSEEDSTATUSA,COM3,0,66.0,FINESTEERING,1945,315811.009,02040020,9fd0,32768;IN JECTED,ALLVALID,-0.098151498,0.298816800,95.888587952,1634544.0523482216522098,-3664556.8064546003006399,4942534.6315599447116256,16.9000,0,0,0,0*f353470c
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
INSSEEDSTATUS Command header. See Messages on
header
page 25 for more information.
-
H
0
Status of the INS Seed being injected into
2
Injection Status the solution. See Table 213: Injection
Enum 4
H
Status on the next page
Flag to indicate if current seed data in
3
Validity Status NVM is valid. See Table 214: Validity
Bool
4
Status on the next page
H+4
4
Pitch
IMU frame pitch angle (degrees)
Float
4
H+8
5
Roll
IMU frame roll angle (degrees)
Float
4
H+12
6
Azimuth
IMU frame azimuth angle (degrees)
Float
4
H+16
7
PositionX
ECEF-based x-coordinate
Double 8
H+20
8
PositionY
ECEF-based y-coordinate
Double 8
H+28
9
PositionZ
ECEF-based z-coordinate
Double 8
H+36
10
Undulation
Geoid undulation
Float
4
H+44
11
Reserved
Ulong 4
H+48
12
Reserved
Ulong 4
H+52
OEM7 Commands and Logs Reference Manual v10
985
Chapter 5 SPAN Logs
Field Field Type
13
Reserved
14
Reserved
15
xxxx
16
[CR][LF]
Description
32-bit CRC (ASCII and Binary only) Sentence Terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Ulong 4
H+56
Ulong 4
H+60
Hex
4
H+64
-
-
-
Table 213: Injection Status
Binary
ASCII
Description
0
NOT_INITIALIZED
INS Seed has not been injected into the solution
1
INVALID
Valid INS Seed was not found in non-volatile memory
2
FAILED
INS Seed has failed validation and has been discarded
3
PENDING
INS Seed is awaiting validation
4
INJECTED
INS Seed alignment data has successfully been injected (including error model data)
5
IGNORED
INS Seed was pending, but has been ignored due to a user commanded filter reset or configuration change
6
ERRORMODELINJECTED INS Seed error model data has successfully been injected
Table 214: Validity Status
Binary
ASCII
Description
0
INVALID
INS Seed in NVM is not valid
1
ALLVALID
INS Seed in NVM is valid
2
ERRORMODELVALID INS Seed error model in NVM is valid (alignment data is not valid)
OEM7 Commands and Logs Reference Manual v10
986
Chapter 5 SPAN Logs
5.25 INSSPD
INS Speed
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains the most recent speed measurements in the horizontal and vertical directions and includes an INS status indicator.
Message ID: 266
Log Type: Synch
Recommended Input: log insspda ontime 1
ASCII Example: #INSSPDA,USB2,0,20.0,FINESTEERING,1541,487969.000,02040000,7832,37343;1541,4879 69.000549050,329.621116190,14.182070674,-0.126606551,INS_SOLUTION_GOOD *c274fff2
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
INSSPD Header
Log header. See Messages on page 25 for more information.
-
H
0
2
Week
GNSS Week
Ulong 4
H
3
Seconds into Week
Seconds from week start
Double 8
H+4
Actual direction of motion over ground (track over ground) with respect to True North, in degrees
The track over ground is determined by
comparing the current position determined from
4
Trk gnd the GNSS/INS solution with the previously
Double 8
determined position.
Track over ground is best used when the vehicle is moving. When the vehicle is stationary, position error can make the direction of motion appear to change randomly.
H+12
5
Horizontal Speed
Magnitude of horizontal speed in m/s where a positive value indicates forward movement and a negative value indicates reverse movement.
Double
8
H+20
OEM7 Commands and Logs Reference Manual v10
987
Chapter 5 SPAN Logs
Field
Field Type
6
Vertical Speed
7
Status
8
xxxx
9
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Magnitude of vertical speed in m/s where a positive value indicates speed upward and a negative value indicates speed downward.
Double 8
H+28
INS status, see Table 207: Inertial Solution Status on page 959
Enum 4
H+36
32-bit CRC (ASCII, Binary and Short Binary only) Hex
4
H+40
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
988
Chapter 5 SPAN Logs
5.26 INSSPDS
Short INS Speed
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is the short header version of the INSSPD log (see page 987).
Message ID: 323
Log Type: Synch
Recommended Input: log insspdsa ontime 1
ASCII Example: %INSSPDSA,1541,487975.000;1541,487975.000549050,323.101450813,9.787233999,0.038980077,INS_SOLUTION_GOOD*105ba028
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
INSSPDS Log header. See Messages on page 25 for more
Header
information.
-
H
0
2
Week
GNSS Week
Ulong 4
H
3
Seconds into Week
Seconds from week start
Double 8
H+4
Actual direction of motion over ground (track over ground) with respect to True North, in degrees.
The track over ground is determined by
comparing the current position determined from
4
Trk gnd the GNSS/INS solution with the previously
Double 8
determined position.
Track over ground is best used when the vehicle is moving. When the vehicle is stationary, position error can make the direction of motion appear to change randomly.
H+12
5
Horizontal Speed
Magnitude of horizontal speed in m/s where a positive value indicates forward movement and a negative value indicates reverse movement.
Double
8
H+20
6
Vertical Speed
Magnitude of vertical speed in m/s where a positive value indicates speed upward and a negative value indicates speed downward.
Double 8
H+28
OEM7 Commands and Logs Reference Manual v10
989
Chapter 5 SPAN Logs
Field
Field Type
7
Status
8
xxxx
9
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
INS status, see Table 207: Inertial Solution Status on page 959
Enum 4
H+36
32-bit CRC (ASCII, Binary and Short Binary only) Hex
4
H+40
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
990
Chapter 5 SPAN Logs
5.27 INSSTDEV
INS PVA standard deviations
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log displays the INS PVA standard deviations.
Message ID: 2051
Log Type: Synch
Abbreviated ASCII Syntax: log insstdev ontime 1
ASCII Example: #INSSTDEVA,COM1,0,78.0,FINESTEERING,1907,233990.000,02000020,3e6d,32768;0.4372, 0.3139,0.7547,0.0015,0.0015,0.0014,3.7503,3.7534,5.1857,26000005,0,0,01ffd1bf,0 *3deca7d2
Field Field Type
Description
Binary Format
Binary Binary Bytes Offset
1
INSSTDEV Header
Log header. See Messages on page 25 for more information.
-
H
0
2
Latitude Latitude standard deviation (m)
Float
4
H
3
Longitude Longitude standard deviation (m)
Float
4
H+4
4
Height
Height standard deviation (m)
Float
4
H+8
5
North Velocity
North velocity standard deviation (m/s)
Float
4
H+12
6
East Velocity
East velocity standard deviation (m/s) Float
4
H+16
7
Up Velocity
Up velocity standard deviation (m/s)
Float
4
H+20
8
Roll
Roll standard deviation (degrees)
Float
4
H+24
9
Pitch
Pitch standard deviation (degrees)
Float
4
H+28
10
Azimuth Azimuth standard deviation (degrees) Float
4
H+32
Extended solution status
11
Ext sol stat See Table 208: Extended Solution
Ulong
4
Status on page 964
H+36
OEM7 Commands and Logs Reference Manual v10
991
Chapter 5 SPAN Logs
Field Field Type
Description
12
Time Since Elapsed time since the last ZUPT or
Update
position update (seconds)
13
Reserved
14
Reserved
15
Reserved
16
xxxx
32-bit CRC (ASCII and Binary only).
17
[CR][LF]
Sentence terminator (ASCII only).
Binary Format
Binary Binary Bytes Offset
Ushort
2
H+40
Ushort
2
Ulong
4
Ulong
4
Hex
4
-
-
H+42 H+44 H+48 H+52 -
OEM7 Commands and Logs Reference Manual v10
992
Chapter 5 SPAN Logs
5.28 INSSTDEVS
Short INS PVA standard deviations
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is the short header version of the INSSTDEV log (see page 991).
Message ID: 2052
Log Type: Synch
Abbreviated ASCII Syntax: log insstdevs ontime 1
ASCII Example: %INSSTDEVSA,1907,233990.000;0.4372,0.3139,0.7547,0.0015,0.0015,0.0014,3.7503,3. 7534,5.1857,26000005,0,0,01ffd1bf,0*2c967ced
Field Field Type
Description
Binary Format
Binary Binary Bytes Offset
1
INSSTDEV Header
Log header. See Messages on page 25 for more information.
-
H
0
2
Latitude Latitude standard deviation (m)
Float
4
H
3
Longitude Longitude standard deviation (m)
Float
4
H+4
4
Height
Height standard deviation (m)
Float
4
H+8
5
North Velocity
North velocity standard deviation (m/s)
Float
4
H+12
6
East Velocity
East velocity standard deviation (m/s) Float
4
H+16
7
Up Velocity
Up velocity standard deviation (m/s)
Float
4
H+20
8
Roll
Roll standard deviation (degrees)
Float
4
H+24
9
Pitch
Pitch standard deviation (degrees)
Float
4
H+28
10
Azimuth Azimuth standard deviation (degrees) Float
4
H+32
Extended solution status
11
Ext sol stat See Table 208: Extended Solution
Ulong
4
Status on page 964
H+36
12
Time Since Elapsed time since the last ZUPT or
Update
position update (seconds)
Ushort
2
H+40
OEM7 Commands and Logs Reference Manual v10
993
Chapter 5 SPAN Logs
Field Field Type
Description
13
Reserved
14
Reserved
15
Reserved
16
xxxx
32-bit CRC (ASCII and Binary only).
17
[CR][LF]
Sentence terminator (ASCII only).
Binary Format
Binary Binary Bytes Offset
Ushort
2
H+42
Ulong
4
H+44
Ulong
4
H+48
Hex
4
H+52
-
-
-
OEM7 Commands and Logs Reference Manual v10
994
Chapter 5 SPAN Logs
5.29 INSUPDATESTATUS
INS Update Status
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log provides the most recent INS update information. It provides information about what updates were performed in the INS filter at the last update epoch and a wheel sensor status indicator.
Message ID: 1825
Log Type: Asynch
Recommended Input: log insupdatestatus onchanged
ASCII Example: #INSUPDATESTATUSA,COM2,0,76.0,FINESTEERING,1934,149288.000,02000000,78f1,32768; SINGLE,0,0,0,INACTIVE,INACTIVE,00000005,00ffd1bf,0,0*d6b7ee02
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
INSUPDATE STATUS Header
Log header. See Messages on page 25 for more information.
-
H
0
Type of GNSS solution used for the last INS
2
PosType
filter update. See Table 75: Position or Velocity Type on
Enum
4
H
page 437
3
NumPSR
Number of raw pseudorange observations used in the last INS filter update.
Integer 4
H+4
4
NumADR
Number of raw phase observations used in the last INS filter update.
Integer 4
H+8
5
NumDOP
Number of raw doppler observations used in the last INS filter update.
Integer
4
H+12
OEM7 Commands and Logs Reference Manual v10
995
Chapter 5 SPAN Logs
Field Field Type
6
DMI Update Status
Heading
7
Update
Status
8
Ext sol stat
9
INS Update Options
10
Reserved
11
Reserved
12
xxxx
13
[CR][LF]
Description
Distance measurement instrument (wheel sensor) status 0 = INACTIVE 1 = ACTIVE 2 = USED 3 = UNSYNCED 4 = BAD_MISC 5 = HIGH_ROTATION 6 = DISABLED 7 = ZUPT Status of the heading update during the last INS filter update. See Table 215: Heading Update Values below Extended solution status See Table 208: Extended Solution Status on page 964 INS Update Options mask. See Table 216: INS Update Status on the next page
32-bit CRC (ASCII, Binary and Short Binary only) Sentence terminator (ASCII only)
Format
Binary Bytes
Enum 4
Enum 4
Ulong 4
Ulong 4
Ulong 4 Ulong 4
Hex
4
-
-
Binary Offset
H+16
H+20 H+24 H+28 H+32 H+36 H+40 -
Table 215: Heading Update Values
Binary ASCII
Description
0
INACTIVE A heading update was not available.
Heading updates are running, but the epoch is not used as an update. When
1
ACTIVE
all other rejection criteria pass, a heading update will still only be applied
once every 5 seconds (20 seconds when stationary).
2
USED
The update for that epoch was taken.
5
HEADING_ UPDATE_
Heading updates are running, but was not performed this epoch due to a large disagreement with filter estimates.
BAD_MISC
OEM7 Commands and Logs Reference Manual v10
996
Chapter 5 SPAN Logs
Table 216: INS Update Status
Nibble Bit
Mask
Description
Range Value
0 0x00000001 Position update
0 = Disabled 1 = Enabled
1 0x00000002 Phase update N0
2 0x00000004 Zero velocity update
0 = Disabled 1 = Enabled
0 = Disabled 1 = Enabled
3 0x00000008 Wheel sensor update
0 = Disabled 1 = Enabled
4 0x00000010 ALIGN (heading) update
0 = Disabled 1 = Enabled
N1
5 0x00000020 External position update
0 = Disabled 1 = Enabled
6 0x00000040 Reserved
7 0x00000080 Doppler update
0 = Disabled 1 = Enabled
8 0x00000100 Pseudorange update
0 = Disabled 1 = Enabled
9 0x00000200 Velocity update N2
10 0x00000400 Reserved
0 = Disabled 1 = Enabled
11 0x00000800 Dead reckoning update
0 = Disabled 1 = Enabled
12 0x00001000 Phase wind up update
0 = Disabled 1 = Enabled
13
0x00002000
Course over ground update
0 = Disabled 1 = Enabled
N3
14 0x00004000 External velocity update
0 = Disabled 1 = Enabled
15 0x00008000 External attitude update
0 = Disabled 1 = Enabled
OEM7 Commands and Logs Reference Manual v10
997
Chapter 5 SPAN Logs
Nibble Bit
Mask
Description
16 0x00010000 External heading update
N4
17 0x00020000 External height update
18 0x00040000 Reserved 19 0x00080000 Reserved
Range Value
0 = Disabled 1 = Enabled
0 = Disabled 1 = Enabled
OEM7 Commands and Logs Reference Manual v10
998
Chapter 5 SPAN Logs
5.30 INSVEL
INS Velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains the most recent North, East and Up velocity vector values, with respect to the local level frame and also includes an INS status indicator.
Message ID: 267
Log Type: Synch
Recommended Input: log insvela ontime 1
ASCII Example: #INSVELA,USB1,0,19.0,FINESTEERING,1543,236173.000,02000000,9c95,37343;1543,2361 73.002500000,14.139471871,-0.070354464,-0.044204369,INS_SOLUTION_GOOD*3c37c0fc
Field Field Type
Description
1
INSVEL Header
Log header. See Messages on page 25 for more information.
2
Week
GNSS Week
3
Seconds into Week
Seconds from week start
4
North Velocity
Velocity North in m/s
5
East Velocity
Velocity East in m/s
6
Up Velocity Velocity Up in m/s
7
Status
INS status, see Table 207: Inertial Solution Status on page 959
8
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Double 8
H+4
Double 8
H+12
Double 8 Double 8 Enum 4
H+20 H+28 H+36
Hex
4
-
-
H+40 -
OEM7 Commands and Logs Reference Manual v10
999
Chapter 5 SPAN Logs
5.31 INSVELS
Short INS Velocity
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is the short header version of the INSVEL log (see page 999).
Message ID: 324
Log Type: Synch
Recommended Input: log insvelsa ontime 1
ASCII Example: %INSVELSA,1921,152855.200;1921,152855.200000000,0.1077,-9.8326,-0.1504,INS_ SOLUTION_GOOD*efd71f65
Field Field Type
Description
1
INSVELS Header
Log header. See Messages on page 25 for more information.
2
Week
GNSS Week
3
Seconds into Week
Seconds from week start
4
North Velocity
Velocity North m/s
5
East Velocity
Velocity East m/s
6
Up Velocity Velocity Up m/s
7
Status
INS status, see Table 207: Inertial Solution Status on page 959
8
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Double 8
H+4
Double 8
H+12
Double 8 Double 8 Enum 4
H+20 H+28 H+36
Hex
4
-
-
H+40 -
OEM7 Commands and Logs Reference Manual v10
1000
Chapter 5 SPAN Logs
5.32 INSVELX
Inertial Velocity � Extended
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log includes the information from the INSVEL log, as well as information about the velocity standard deviation. The position type and solution status fields indicate whether or not the corresponding data is valid.
The INSVELX log is a large log and is not recommend for high rate logging.
If you want to use high rate logging, log the INSVELS log at a high rate and the INSSTDEVS log ontime 1.
Message ID: 1458
Log Type: Synch
Recommended Input: log insvelxa ontime 1
ASCII example: #INSVELXA,COM1,0,80.0,FINESTEERING,1690,494394.000,02000040,1f8e,43441;INS_ ALIGNMENT_COMPLETE,INS_ PSRSP,0.0086,0.0015,0.0215,0.0549,0.0330,0.0339,3,0*ec33e372
Field Field Type
Description
Format
Binary Bytes
1
INSVELX Header
Log header. See Messages on page 25 for more information.
H
Solution status
2
INS Status See Table 207: Inertial Solution Status on Enum 4
page 959
Position type
3
Pos Type
See Table 75: Position or Velocity Type
Enum
4
on page 437
4
North Vel
North velocity (m/s)
Double 8
5
East Vel
East velocity (m/s)
Double 8
6
Up Vel
Up velocity (m/s)
Double 8
7
North Vel North velocity standard deviation (m/s)
Float
4
8
East Vel East velocity standard deviation (m/s)
Float
4
Binary Offset 0
H
H+4
H+8 H+16 H+24 H+32 H+36
OEM7 Commands and Logs Reference Manual v10
1001
Chapter 5 SPAN Logs
Field Field Type
Description
9
Up Vel
Up velocity standard deviation (m/s)
Extended solution status
10
Ext sol stat See Table 208: Extended Solution Status
on page 964
11
Time Since Update
Elapsed time since the last ZUPT or position update (seconds)
11
xxxx
32-bit CRC (ASCII and Binary only)
12
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Float
4
Hex
4
Ushort 2
Hex
4
-
-
Binary Offset H+40
H+44
H+48 H+50 -
OEM7 Commands and Logs Reference Manual v10
1002
Chapter 5 SPAN Logs
5.33 MARK1PVA, MARK2PVA, MARK3PVA and MARK4PVA
Position, Velocity and Attitude at Mark Input Event
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
These logs output position, velocity and attitude information, with respect to the SPAN frame, when an event is received on the Mark input. If the SETINSTRANSLATION command (see page 922) and SETINSROTATION command (see page 919) has been entered with a MARKx parameter, the MARKxPVA log will contain the solution translated, and then rotated, by the values provided in the commands (e.g. SETINSTRANSLATION MARK1 and SETINSROTATION MARK1 commands for the MARK1PVA log). See the SETINSTRANSLATION command on page 922 and SETINSROTATION command on page 919.
The MARKxPVA logs available are dependent on the receiver used in the SPAN system. For information about the Event lines supported, see the Strobe Specifications for the receiver in the OEM7 SPAN Installation and Operation User Manual.
Message ID:
1067 (MARK1PVA) 1068 (MARK2PVA) 1118 (MARK3PVA) 1119 (MARK4PVA)
Log Type: Synch
Recommended Input: log mark1pva onnew log mark2pva onnew log mark3pva onnew log mark4pva onnew
Abbreviated ASCII Example:
#MARK1PVAA,COM1,0,74.5,FINESTEERING,1732,247231.455,02040020,5790, 12002;1732,247231.454623850,51.11693182283,-114.03885213810,1047.4525, 0.0004,0.0004,-0.0006,0.847121689,1.124640813,278.577037489, INS_SOLUTION_GOOD*5a6b060e
#MARK2PVAA,COM1,0,74.5,FINESTEERING,1732,247232.271,02040020,2425, 12002;1732,247232.271459820,51.11693179023,-114.03885206704,1047.4529, 0.0004,-0.0011,-0.0007,0.837101074,1.134127754,278.346498557, INS_SOLUTION_GOOD*08209ec0
#MARK3PVAA,COM1,0,74.5,FINESTEERING,1732,247232.271,02040020,2425, 12002;1732,247232.271459820,51.11693179023,-114.03885206704,1047.4529, 0.0004,-0.0011,-0.0007,0.837101074,1.134127754,278.346498557, INS_SOLUTION_GOOD*08209ec0
#MARK4PVAA,COM1,0,74.5,FINESTEERING,1732,247232.271,02040020,2425, 12002;1732,247232.271459820,51.11693179023,-114.03885206704,1047.4529,
OEM7 Commands and Logs Reference Manual v10
1003
Chapter 5 SPAN Logs
0.0004,-0.0011,-0.0007,0.837101074,1.134127754,278.346498557, INS_SOLUTION_GOOD*08209ec0
Field
Field Type
Description
1
MARKxPVA Log header. See Messages on page 25 for more
Header
information.
2
Week
GNSS Week at Mark input
3
Seconds Seconds from week at Mark input
4
Latitude Latitude (WGS84) at Mark input
5
Longitude Longitude (WGS84) at Mark input
6
Height
Height (WGS84) at Mark input (m)
7
North Velocity
Velocity in a northerly direction (a -ve value implies a southerly direction) at Mark input (m/s)
8
East Velocity
Velocity in an easterly direction (a -ve value implies a westerly direction) at Mark input (m/s)
9
Up Velocity
Velocity in an up direction at Mark input (m/s)
10
Roll
Right-handed rotation from local level around y-axis in degrees at Mark input
11
Pitch
Right-handed rotation from local level around x-axis in degrees at Mark input
12
Azimuth
Left-handed rotation around z-axis in degrees clockwise from North at Mark input
13
Status
INS Status, see Table 207: Inertial Solution Status on page 959 at Mark input
14
xxxx
32-bit CRC
15
[CR][LF] Sentence Terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4 Double 8 Double 8 Double 8 Double 8
H H+4 H+12 H+20 H+28
Double 8
H+36
Double 8
Double 8
Double 8
Double 8
Double 8
Enum 4
Hex
4
-
-
H+44
H+52 H+60 H+68 H+76 H+84 H+88 -
OEM7 Commands and Logs Reference Manual v10
1004
Chapter 5 SPAN Logs
5.34 PASHR
NMEA, Inertial Attitude Data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
The PASHR log uses a UTC time, calculated with default parameters, to output NMEA messages without waiting for a valid almanac. The UTC time status is set to WARNING since it may not be 100% accurate. When a valid almanac is available, the receiver uses the real parameters and sets the UTC time to VALID. For more information about NMEA, refer to NMEA Standard Logs on page 624. The PASHR log contains only INS derived attitude information and is only filled when an inertial solution is available.
As of firmware version 7.03.00, an INS status flag (field 12) has been added to the PASHR log. This change was made to match the industry accepted form of the message. Previous firmware versions on OEM7 and OEM6 do not output this field.
Message ID: 1177 Log Type: Synch Recommended Input:
log pashr ontime 1
Example: $PASHR,123816.80,312.95,T,-0.83,-0.42,-0.01,0.234,0.224,0.298,2,1*0B
Field Structure
1
$PASHR
2
Time
3
Heading
4
True Heading
5
Roll
6
Pitch
7
Heave
Description
Symbol Example
Log header. See Messages on page 25 for more information.
---
$PASHR
UTC Time
hhmmss.ss 195124.00
Heading value in decimal degrees
The heading is the inertial azimuth calculated from the IMU gyros and the SPAN filters.
HHH.HH
305.30
T displayed if heading is relative to true north.
T
T
Roll in decimal degrees. The � sign will always be displayed.
RRR.RR
Pitch in decimal degrees. The � sign will always be displayed.
PPP.PP
Instantaneous heave in meters. The � will always be displayed
Heave
+0.05 -0.13 +0.01
OEM7 Commands and Logs Reference Manual v10
1005
Chapter 5 SPAN Logs
Field Structure
Description
8
Roll Accuracy
Roll standard deviation in decimal degrees.
9
Pitch Accuracy
Pitch standard deviation in decimal degrees.
10
Heading Accuracy
Heading standard deviation in decimal degrees.
0 = No position
11
GPS Update Quality Flag
1 = All non-RTK fixed integer positions
2 = RTK fixed integer position
0 = All SPAN Pre-Alignment INS Status
1 = All SPAN Post-Alignment INS Status - These
12
INS Status Flag
include: INS_ALIGNMENT_COMPLETE, INS_SOLUTION_
GOOD, INS_HIGH_VARIANCE, INS_SOLUTION_
FREE
13
Checksum Checksum
14
[CR][LF]
Sentence terminator
Symbol Example
rr.rrr
0.180
pp.ppp
0.185
hh.hhh
4.986
1
1
1
1
*XX
*2B
[CR][LF]
OEM7 Commands and Logs Reference Manual v10
1006
Chapter 5 SPAN Logs
5.35 RAWIMU
Raw IMU Data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains an IMU status indicator and the measurements from the accelerometers and gyros with respect to the IMU enclosure frame. If logging this data, consider the RAWIMUS log (see page 1027) to reduce the amount of data.
The change in velocity (acceleration) and angle (rotation rate) scale factors for each IMU type can be found in Table 229: Raw IMU Scale Factors on page 1029. Multiply the appropriate scale factor by the count value for the velocity (field 5-7) and angle (field 810) increments.
To obtain acceleration in m/s/s or rotation rate in rad/s, multiply the velocity/rotation increments by the output rate of the IMU (e.g., 100 Hz for HG1700, HG1900, HG1930 and HG4930; 200 Hz for ISA-100C, iMAR-FSAS, LN200, KVH1750 and ADIS16488; 125 Hz for STIM300 and G320N). The units of acceleration and rotation rate will depend on the IMU Scale Factors.
This log is output in the IMU Body frame.
Message ID: 268
Log Type: Asynch
Recommended Input: log rawimua onnew
ASCII Example: #RAWIMUA,COM1,0,68.5,FINESTEERING,1724,219418.009,024c0040,6125,30019;1724,2194 18.008755000,00000077,64732,56,298,8,28,-3*7378486f
Field
Field Type
Description
1
RAWIMU Log header. See Messages on page 25 for more Header information.
2
Week
GNSS Week
Seconds
3
into
Seconds from week start
Week
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Double 8
H+4
OEM7 Commands and Logs Reference Manual v10
1007
Chapter 5 SPAN Logs
Field
Field Type
4
IMU Status
5
Z Accel Output
- (Y
6
Accel
Output)
7
X Accel Output
Description
Format
Binary Bytes
Binary Offset
The status of the IMU. This field is given in a fixed length (n) array of bytes in binary but in ASCII or Abbreviated ASCII is converted into 2 character hexadecimal pairs.
For the raw IMU status, see one of the following tables:
l Table 217: iIMU-FSAS IMU Status on the next page
l Table 218: HG1700 IMU Status on page 1010
l Table 219: LN200 IMU Status on page 1012
l Table 220: ISA-100C IMU Status on page 1013
l Table 221: IMU-CPT IMU Status on page 1014
l Table 222: IMU-KVH1750 IMU Status on page 1016
Hex Ulong
4
l Table 223: HG1900 and HG1930 IMU Status on page 1017
l Table 224: HG4930 IMU Status on page 1019
l Table 225: ADIS16488 and IMU-IGM-A1 IMU Status on page 1020
l Table 226: STIM300 and IMU-IGM-S1 IMU Status on page 1022
l Table 227: �IMU IMU Status on page 1023
l Table 228: G320N IMU Status on page 1025
Also refer to Interface Control Documentation as provided by Honeywell or Northrop Grumman.
H+12
Change in velocity count along z axis
Long
4
H+16
- (Change in velocity count along y axis)
A negative value implies the output is along the
positive y-axis marked on the IMU. A positive
Long
4
value implies the change is in the direction
opposite to that of the y-axis marked on the IMU.
H+20
Change in velocity count along x axis
Long
4
H+24
OEM7 Commands and Logs Reference Manual v10
1008
Chapter 5 SPAN Logs
Field
Field Type
Description
8
Z Gyro Output
Change in angle count around z axis. Right-handed
- (Change in angle count around y axis).
Right-handed
- (Y
9
Gyro
A negative value implies the output is along the
Output) positive y-axis marked on the IMU. A positive
value implies the change is in the direction
opposite to that of the y-axis marked on the IMU.
10
X Gyro Output
Change in angle count around x axis. Right-handed
11
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
12
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Long
4
H+28
Long
4
H+32
Long
4
Hex
4
-
-
H+36 H+40 -
Table 217: iIMU-FSAS IMU Status
Nibble Bit
Mask
Description
0 0x00000001
1 0x00000002
N0
Reserved
2 0x00000004
3 0x00000008
4 0x00000010 Gyro warm-up
5 0x00000020 Gyro self-test active N1
6 0x00000040 Gyro status bit set
7 0x00000080 Gyro time-out command interface
8 0x00000100 Power-up built-in test (PBIT)
9 0x00000200 Reserved N2
10 0x00000400 Interrupt
11 0x00000800 Reserved
12 0x00001000 Warm-up
13 0x00002000
N3
Reserved
14 0x00004000
15 0x00008000 Initiated built-in test (IBIT)
Range Value
0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed
0 = Passed, 1 = Failed
OEM7 Commands and Logs Reference Manual v10
1009
Chapter 5 SPAN Logs
Nibble Bit
Mask
16 0x00010000
17 0x00020000 N4
18 0x00040000
19 0x00080000
20 0x00100000
21 0x00200000 N5
22 0x00400000
23 0x00800000
24 0x01000000
25 0x02000000 N6
26 0x04000000
27 0x08000000
28 0x10000000
29 0x20000000 N7
30 0x40000000
31 0x80000000
Description
Reserved
Accelerometer Accelerometer time-out Reserved Gyro initiated BIT Gyro self-test Gyro time-out Analog-to-Digital (AD) Test mode Software RAM/ROM Reserved Operational Interface Interface time-out
Range Value
0 = Passed, 1 = Failed 0 = Passed, 1 = Failed
0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed
0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed
Nibble N0
N1
Bit 0 1 2 3 4 5 6 7
Table 218: HG1700 IMU Status
Mask
Description
Range Value
0x00000001
Reserved
0x00000002
Reserved
0x00000004
Reserved
0x00000008
Reserved
0x00000010
IMU Status
0 = Passed, 1 = Failed
0x00000020
IMU Status
0 = Passed, 1 = Failed
0x00000040
IMU Status
0 = Passed, 1 = Failed
0x00000080
IMU Status
0 = Passed, 1 = Failed
OEM7 Commands and Logs Reference Manual v10
1010
Chapter 5 SPAN Logs
Nibble N2 N3 N4 N5 N6 N7
Bit 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
Mask 0x00000100 0x00000200 0x00000400 0x00000800 0x00001000 0x00002000 0x00004000 0x00008000 0x00010000 0x00020000 0x00040000 0x00080000 0x00100000 0x00200000 0x00400000 0x00800000 0x01000000 0x02000000 0x04000000 0x08000000 0x10000000 0x20000000 0x40000000 0x80000000
Description Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved Reserved IMU Status IMU Status IMU Status IMU Status IMU Status
Range Value
0 = Passed, 1= Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed
OEM7 Commands and Logs Reference Manual v10
1011
Chapter 5 SPAN Logs
Nibble N0 N1 N2 N3 N4 N5
Bit 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
Table 219: LN200 IMU Status
Mask
Description
Range Value
0x00000001
IMU Status
0 = Passed, 1 = Failed
0x00000002
IMU Status
0 = Passed, 1 = Failed
0x00000004
IMU Status
0 = Passed, 1 = Failed
0x00000008
IMU Status
0 = Passed, 1 = Failed
0x00000010
IMU Status
0 = Passed, 1 = Failed
0x00000020
IMU Status
0 = Passed, 1 = Failed
0x00000040
IMU Status
0 = Passed, 1 = Failed
0x00000080
IMU Status
0 = Passed, 1 = Failed
0x00000100
IMU Status
0 = Passed, 1 = Failed
0x00000200
IMU Status
0 = Passed, 1 = Failed
0x00000400
IMU Status
0 = Passed, 1 = Failed
0x00000800
IMU Status
0 = Passed, 1 = Failed
0x00001000
IMU Status
0 = Passed, 1 = Failed
0x00002000
IMU Status
0 = Passed, 1 = Failed
0x00004000
IMU Status
0 = Passed, 1 = Failed
0x00008000
Reserved
0x00010000
Reserved
0x00020000
Reserved
0x00040000
Reserved
0x00080000
Reserved
0x00100000
Reserved
0x00200000
Reserved
0x00400000
Reserved
0x00800000
Reserved
OEM7 Commands and Logs Reference Manual v10
1012
Chapter 5 SPAN Logs
Nibble N6
N7
Bit 24 25 26 27 28 29 30 31
Mask 0x01000000 0x02000000 0x04000000 0x08000000 0x10000000 0x20000000 0x40000000 0x80000000
Description IMU Status IMU Status IMU Status IMU Status IMU Status Reserved IMU Status Reserved
Range Value 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed
0 = Passed, 1 = Failed
Table 220: ISA-100C IMU Status
Nibble Bit
Mask
Description
Range Value
0 0x00000001 Maintenance Indication
0 = Normal, 1 = System Maintenance Indicator
N0
1 0x00000002 Accelerometers Invalid
0 = Normal, 1 = Invalid
2 0x00000004 Accelerometer X Warning 0 = Normal, 1 = Warning
3 0x00000008 Accelerometer Y Warning 0 = Normal, 1 = Warning
4 0x00000010 Accelerometer Z Warning 0 = Normal, 1 = Warning
5 0x00000020 Accelerometer X NOGO
0 = Normal, 1 = NOGO
N1
6 0x00000040 Accelerometer Y NOGO
0 = Normal, 1 = NOGO
7 0x00000080 Accelerometer Z NOGO
0 = Normal, 1 = NOGO
8 0x00000100 Reset Occurred
0 = Normal, 1 = First Message after ISA-100C Reset
N2
9 0x00000200 Gyroscopes Invalid
0 = Normal, 1 = Invalid
10 0x00000400 Gyroscope X Warning
0 = Normal, 1 = Warning
11 0x00000800 Gyroscope Y Warning
0 = Normal, 1 = Warning
12 0x00001000 Gyroscope Z Warning
0 = Normal, 1 = Warning
13 0x00002000 Gyroscope X NOGO N3
14 0x00004000 Gyroscope Y NOGO
0 = Normal, 1 = NOGO 0 = Normal, 1 = NOGO
15 0x00008000 Gyroscope Z NOGO
0 = Normal, 1 = NOGO
OEM7 Commands and Logs Reference Manual v10
1013
Chapter 5 SPAN Logs
Nibble Bit
Mask
Description
16 0x00010000
17 0x00020000 N4
18 0x00040000
19 0x00080000
20 0x00100000
21 0x00200000 N5
22 0x00400000 IMU temperature reading as follows:
23 0x00800000 Signed 2-byte value (SHORT)
24 0x01000000 1 LSB = 3.90625e-3 Celsius
25 0x02000000 Temperature Range +/- 128 Celsius N6
26 0x04000000
27 0x08000000
28 0x10000000
29 0x20000000 N7
30 0x40000000
31 0x80000000
Range Value
Table 221: IMU-CPT IMU Status
Nibble Bit
Mask
Description
Range Value
0 0x00000001 Gyro X Status
1 = Valid, 0 = Invalid
1 0x00000002 Gyro Y Status N0
2 0x00000004 Gyro Z Status
1 = Valid, 0 = Invalid 1 = Valid, 0 = Invalid
3 0x00000008 Unused
Set to 0
4 0x00000010 Accelerometer X Status
1 = Valid, 0 = Invalid
5 0x00000020 Accelerometer Y Status N1
6 0x00000040 Accelerometer Z Status
1 = Valid, 0 = Invalid 1 = Valid, 0 = Invalid
7 0x00000080 Unused
Set to 0
OEM7 Commands and Logs Reference Manual v10
1014
Chapter 5 SPAN Logs
Nibble Bit
Mask
8 0x00000100
9 0x00000200 N2
10 0x00000400
11 0x00000800
12 0x00001000
13 0x00002000 N3
14 0x00004000
15 0x00008000
16 0x00010000
17 0x00020000 N4
18 0x00040000
19 0x00080000
20 0x00100000
21 0x00200000 N5
22 0x00400000
23 0x00800000
24 0x01000000
25 0x02000000 N6
26 0x04000000
27 0x08000000
28 0x10000000
29 0x20000000 N7
30 0x40000000
31 0x80000000
Description
Range Value
IMU Data Sequence Counter read in a Ushort. Note: Increments for each message and resets to 0 after 127.
Unused
OEM7 Commands and Logs Reference Manual v10
1015
Chapter 5 SPAN Logs
Table 222: IMU-KVH1750 IMU Status
Nibble Bit
Mask
Description
Range Value
0 0x00000001 Gyro X Status
1 = Valid, 0 = Invalid
1 0x00000002 Gyro Y Status N0
2 0x00000004 Gyro Z Status
1 = Valid, 0 = Invalid 1 = Valid, 0 = Invalid
3 0x00000008 Unused
Set to 0
4 0x00000010 Accelerometer X Status
1 = Valid, 0 = Invalid
5 0x00000020 Accelerometer Y Status N1
6 0x00000040 Accelerometer Z Status
1 = Valid, 0 = Invalid 1 = Valid, 0 = Invalid
7 0x00000080 Unused
Set to 0
8 0x00000100
9 0x00000200 N2
10 0x00000400
11 0x00000800 IMU Data Sequence Counter read in a Ushort. 12 0x00001000 Note: Increments for each message and resets to 0 after 127.
13 0x00002000 N3
14 0x00004000
15 0x00008000
OEM7 Commands and Logs Reference Manual v10
1016
Chapter 5 SPAN Logs
Nibble Bit
Mask
Description
Range Value
16 0x00010000
17 0x00020000 N4
18 0x00040000
IMU temperature reading as follows: 19 0x00080000
Signed 2-byte value (SHORT) 20 0x00100000
Rounded to the nearest degree
21 0x00200000 N5
22 0x00400000 Example:
23 0x00800000 <RAWIMU COM1 0 75.0 FINESTEERING 1813 514207.000 00000020 fa9a 45836 1813 514207.000000000 00260077 32164 -47 -305 1 -10
24 0x01000000 0
25 0x02000000
N6
26 0x04000000 IMU status = 00260077
Temperatures bytes = 0026 27 0x08000000
Decimal value = 38 degrees C
28 0x10000000
29 0x20000000 N7
30 0x40000000
31 0x80000000
Nibble N0
N1
Bit 0 1 2 3 4 5 6 7
Table 223: HG1900 and HG1930 IMU Status
Mask
Description
Range Value
0x00000001
0x00000002 0x00000004
Reserved
0x00000008
0x00000010
IMU Status
0 = Passed, 1 = Failed
0x00000020
IMU Status
0 = Passed, 1 = Failed
0x00000040
IMU Status
0 = Passed, 1 = Failed
0x00000080
IMU Status
0 = Passed, 1 = Failed
OEM7 Commands and Logs Reference Manual v10
1017
Chapter 5 SPAN Logs
Nibble N2 N3 N4 N5 N6 N7
Bit 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
Mask 0x00000100 0x00000200 0x00000400 0x00000800 0x00001000 0x00002000 0x00004000 0x00008000 0x00010000 0x00020000 0x00040000 0x00080000 0x00100000 0x00200000 0x00400000 0x00800000 0x01000000 0x02000000 0x04000000 0x08000000 0x10000000 0x20000000 0x40000000 0x80000000
Description Reserved
Range Value
Reserved
Reserved
Reserved
IMU Status Reserved IMU Status IMU Status IMU Status IMU Status IMU Status Reserved
0 = Passed, 1 = Failed
0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed 0 = Passed, 1 = Failed
OEM7 Commands and Logs Reference Manual v10
1018
Chapter 5 SPAN Logs
Nibble N0 N1 N2 N3 N4 N5
Table 224: HG4930 IMU Status
Bit
Mask
Description
Range Value
0
0x00000001
IMU Status
0 = Passed, 1 = Failed
1
0x00000002
2
0x00000004
Reserved
3
0x00000008
Gyro Status
0 = Passed, 1 = Failed
4
0x00000010
Accelerometer Status
0 = Passed, 1 = Failed
5
0x00000020
Reserved
6
0x00000040
IMU Status
0 = Passed, 1 = Failed
7
0x00000080
Reserved
8
0x00000100
9
0x00000200
10 0x00000400
Reserved
11 0x00000800
12 0x00001000
13 0x00002000 14 0x00004000
Reserved
15 0x00008000
16 0x00010000
17 0x00020000 18 0x00040000
Reserved
19 0x00080000
20 0x00100000
21 0x00200000 22 0x00400000
Reserved
23 0x00800000
OEM7 Commands and Logs Reference Manual v10
1019
Chapter 5 SPAN Logs
Nibble N6
N7
Bit
Mask
24 0x01000000
25 0x02000000
26 0x04000000
27 0x08000000
28 0x10000000
29 0x20000000
30 0x40000000
31 0x80000000
Description Reserved
Reserved
Range Value
Table 225: ADIS16488 and IMU-IGM-A1 IMU Status
Nibble Bit
Mask
Description
Range Value
0 0x00000001 Alarm Status Flag
1 0x00000002
N0
Reserved
2 0x00000004
3 0x00000008 SPI Communication Error
0 = Passed, 1 = Failed
4 0x00000010 Sensor Over-Range
N1
5 0x00000020 Initial Self Test Failure
0 = Passed, 1 = One of more sensors overranged
0 = Passed, 1= Failed
6 0x00000040 Flash Memory Failure
0 = Passed, 1 = Failed
7 0x00000080 Processing Overrun
0 = Passed, 1 = Failed
8 0x00000100 Self Test Failure � X-axis gyro
0 = Passed, 1 = Failed
9 0x00000200 Self Test Failure � Y-axis gyro
0 = Passed, 1 = Failed
N2
10 0x00000400 Self Test Failure � Z-axis gyro
0 = Passed, 1 = Failed
11
0x00000800
Self Test Failure � X-axis accelerometer
0 = Passed, 1 = Failed
OEM7 Commands and Logs Reference Manual v10
1020
Chapter 5 SPAN Logs
Nibble Bit
Mask
Description
Range Value
12
0x00001000
Self Test Failure � Y-axis accelerometer
0 = Passed, 1 = Failed
N3
13 0x00002000 Self Test Failure � Z-axis
14 0x00004000 Reserved
15 0x00008000
0 = Passed, 1 = Failed
16 0x00010000
17 0x00020000 N4
18 0x00040000
19 0x00080000
20 0x00100000
21 0x00200000
N5
22 0x00400000 IMU temperature reading as follows:
Signed 2-byte value (SHORT) 23 0x00800000
25�C = 0x0000
24 0x01000000 1 LSB = 0.00565�C
25 0x02000000 N6
26 0x04000000
27 0x08000000
28 0x10000000
29 0x20000000 N7
30 0x40000000
31 0x80000000
OEM7 Commands and Logs Reference Manual v10
1021
Chapter 5 SPAN Logs
Table 226: STIM300 and IMU-IGM-S1 IMU Status
Nibble Bit
Mask
Description
Range Value
0 0x00000001
0 = OK, 1 = X-channel
1 0x00000002
N0
2 0x00000004
0 = OK, 1 = Y-channel 0 = OK, 1 = Z-channel
3 0x00000008 Gyro status
4 0x00000010
0 = OK, 1 = Error in measurement channel (Bits 0-2 flag the error channels)
0 = OK, 1 = Overload (Bits 0-2 flag the error channels)
N1
5 0x00000020
6 0x00000040
0 = OK, 1 = Outside operating conditions 0 = OK, 1 = Startup
7 0x00000080
0 = OK, 1 = System integrity error
8 0x00000100
0 = OK, 1 = X-channel
9 0x00000200
N2
10 0x00000400
0 = OK, 1 = Y-channel 0 = OK, 1 = Z-channel
11 0x00000800
0 = OK, 1 = Error in measurement channel (Bits 0-2 flag the error channels)
Accelerometer Status
12 0x00001000
0 = OK, 1 = Overload (Bits 0-2 flag the error channels)
N3
13 0x00002000
14 0x00004000
0 = OK, 1 = Outside operating conditions 0 = OK, 1 = Startup
15 0x00008000
0 = OK, 1 = System integrity error
OEM7 Commands and Logs Reference Manual v10
1022
Chapter 5 SPAN Logs
Nibble Bit
Mask
Description
16 0x00010000
17 0x00020000 N4
18 0x00040000
19 0x00080000
20 0x00100000
21 0x00200000 N5
22 0x00400000 Temperature of the X gyro sensor
23 0x00800000 0�C = 0x0000
24 0x01000000 1 LSB = 2-8 �C
25 0x02000000 N6
26 0x04000000
27 0x08000000
28 0x10000000
29 0x20000000 N7
30 0x40000000
31 0x80000000
Range Value
Nibble N0
N1
Bit
Mask
0
0x00000001
1
0x00000002
2
0x00000004
3
0x00000008
4
0x00000010
5
0x00000020
6
0x00000040
7
0x00000080
Table 227: �IMU IMU Status
Description
Range Value
Reset Acknowledged
0 = Normal, 1 = Reset
Gyros Not Initialized
0 = Normal, 1 = Not Initialized
Gyro X Warning
0 = Normal, 1 = Warning
Gyro Y Warning
0 = Normal, 1 = Warning
Gyro Z Warning
0 = Normal, 1 = Warning
Gyro X NOGO
0 = Normal, 1 = NOGO
Gyro Y NOGO
0 = Normal, 1 = NOGO
Gyro Z NOGO
0 = Normal, 1 = NOGO
OEM7 Commands and Logs Reference Manual v10
1023
Chapter 5 SPAN Logs
Nibble N2 N3 N4 N5 N6 N7
Bit
Mask
8
0x00000100
9
0x00000200
10 0x00000400
11 0x00000800
12 0x00001000
13 0x00002000
14 0x00004000
15 0x00008000
16 0x00010000
17 0x00020000
18 0x00040000
19 0x00080000
20 0x00100000
21 0x00200000
22 0x00400000
23 0x00800000
24 0x01000000
25 0x02000000
26 0x04000000
27 0x08000000
28 0x10000000
29 0x20000000
30 0x40000000
31 0x80000000
Description Reserved Accels Not Initialized Accel X Warning Accel Y Warning Accel Z Warning Accel X NOGO Accel Y NOGO Accel Z NOGO
Range Value
0 = Normal, 1 = Not Initialized 0 = Normal, 1 = Warning 0 = Normal, 1 = Warning 0 = Normal, 1 = Warning 0 = Normal, 1 = NOGO 0 = Normal, 1 = NOGO 0 = Normal, 1 = NOGO
IMU temperature reading as follows: Signed 2-byte value (SHORT) 1 LSB = 3.90625e^-3 �C Temperature Range +/- 128 �C
OEM7 Commands and Logs Reference Manual v10
1024
Chapter 5 SPAN Logs
Nibble Bit
Mask
0 0x00000001
1 0x00000002 N0
2 0x00000004
3 0x00000008
4 0x00000010
5 0x00000020 N1
6 0x00000040
7 0x00000080
8 0x00000100
9 0x00000200 N2
10 0x00000400
11 0x00000800
12 0x00001000
13 0x00002000 N3
14 0x00004000
15 0x00008000
Table 228: G320N IMU Status
Description
Range Value
Error All
0 = Normal, 1 = Sensor Failure
Reserved
Accel Z - New Data Accel Y - New Data Accel X - New Data Gyro Z - New Data Gyro Y - New Data Gyro X - New Data Temperature - New Data
New Data = 1, No Data = 0 New Data = 1, No Data = 0 New Data = 1, No Data = 0 New Data = 1, No Data = 0 New Data = 1, No Data = 0 New Data = 1, No Data = 0 New Data = 1, No Data = 0
OEM7 Commands and Logs Reference Manual v10
1025
Chapter 5 SPAN Logs
Nibble Bit
Mask
16 0x00010000
17 0x00020000 N4
18 0x00040000
19 0x00080000
20 0x00100000
21 0x00200000 N5
22 0x00400000
23 0x00800000
24 0x01000000
25 0x02000000 N6
26 0x04000000
27 0x08000000
28 0x10000000
29 0x20000000 N7
30 0x40000000
31 0x80000000
Description
Range Value
IMU Temperature reading as follows: Temperature = [(-0.0037918 * (A - 2634)) + 25] Celsius A: Temperature Sensor output data (decimal)
OEM7 Commands and Logs Reference Manual v10
1026
Chapter 5 SPAN Logs
5.36 RAWIMUS
Short Raw IMU Data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is the short header version of the RAWIMU log (see page 1007).
The change in velocity (acceleration) and angle (rotation rate) scale factors for each IMU type can be found in Table 229: Raw IMU Scale Factors on page 1029. Multiply the appropriate scale factor by the count value for the velocity (field 5-7) and angle (field 810) increments.
To obtain acceleration in m/s/s or rotation rate in rad/s, multiply the velocity/rotation increments by the output rate of the IMU (e.g., 100 Hz for HG1700, HG1900, HG1930 and HG4930; 200 Hz for ISA-100C, iMAR-FSAS, LN200, KVH1750 and ADIS16488; 125 Hz for STIM300 and G320N). The units of acceleration and rotation rate will depend on the IMU Scale Factors.
This log is output in the IMU Body frame.
Message ID: 325
Log Type: Asynch
Recommended Input: log rawimusa onnew
ASCII Example: %RAWIMUSA,1105,425384.180;1105,425384.156166800,111607,43088060,430312,3033352,-132863,186983,823*5aa97065
Field
Field Type
Description
1
RAWIMUS Log header. See Messages on page 25 for more
Header
information.
2
Week
GNSS Week
3
Seconds into Week
Seconds from week start
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4
H
Double 8
H+4
OEM7 Commands and Logs Reference Manual v10
1027
Chapter 5 SPAN Logs
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
The status of the IMU. This field is given in a fixed length (n) array of bytes in binary but in ASCII or Abbreviated ASCII is converted into 2 character hexadecimal pairs.
For the raw IMU status, see one of the following tables:
l Table 217: iIMU-FSAS IMU Status on page 1009
l Table 218: HG1700 IMU Status on page 1010
l Table 219: LN200 IMU Status on page 1012
l Table 220: ISA-100C IMU Status on page 1013
4
IMU Status
l Table 221: IMU-CPT IMU Status on page 1014
l Table 222: IMU-KVH1750 IMU Status on page 1016
Hex Ulong
4
l Table 223: HG1900 and HG1930 IMU Status on page 1017
l Table 224: HG4930 IMU Status on page 1019
l Table 225: ADIS16488 and IMU-IGM-A1 IMU Status on page 1020
l Table 226: STIM300 and IMU-IGM-S1 IMU Status on page 1022
l Table 227: �IMU IMU Status on page 1023
l Table 228: G320N IMU Status on page 1025
Also refer to Interface Control Documentation as provided by Honeywell or Northrop Grumman.
H+12
5
Z Accel Output
Change in velocity count along z axis
Long
4
H+16
- (Change in velocity count along y axis)
A negative value implies the output is along the
6
- (Y Accel positive y-axis marked on the IMU. A positive Output) value implies the change is in the direction
Long
4
opposite to that of the y-axis marked on the
IMU.
H+20
OEM7 Commands and Logs Reference Manual v10
1028
Chapter 5 SPAN Logs
Field
Field Type
7
X Accel Output
8
Z Gyro Output
9
- (Y Gyro Output)
10
X Gyro Output
11
xxxx
12
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
Change in velocity count along x axis
Long
4
H+24
Change in angle count around z axis Right-handed
Long
4
- (Change in angle count around y axis) Right-handed
A negative value implies the output is along the
positive y-axis marked on the IMU. A positive
Long
4
value implies the change is in the direction
opposite to that of the y-axis marked on the
IMU.
Change in angle count around x axis Right-handed
Long
4
32-bit CRC (ASCII, Binary and Short Binary only) Hex
4
Sentence terminator (ASCII only)
-
-
H+28
H+32
H+36 H+40 -
HG1700-AG58 HG1900-CA29/CA50 HG1930-AA99/CA50
HG1700-AG62 HG4930-AN01
IMU-CPT IMU-KVH1750
IMU-FSAS LN-200
ISA-100C �IMU
Table 229: Raw IMU Scale Factors
Gyroscope Scale Factor
Acceleration Scale Factor
2.0-33 rad/LSB1
2.0-27 ft/s/LSB
2.0-33 rad/LSB 2.0-33 rad/LSB
0.1 / (3600.0x256.0) rad/LSB 0.1x 2-8 arcsec/LSB 2-19 rad/LSB
1.0E-9 rad/LSB
2.0-26 ft/s/LSB 2.0-29 ft/s/LSB 0.05/215 m/s/LSB 0.05 x 2-15 m/s/LSB 2-14 m/s/LSB
2.0E-9 m/s/LSB
1Least Significant Bit (LSB) OEM7 Commands and Logs Reference Manual v10
1029
Chapter 5 SPAN Logs
ADIS16488 IMU-IGM-A1
STIM300 IMU-IGM-S1
G320N
Gyroscope Scale Factor 720/231 deg/LSB
Acceleration Scale Factor 200/231 m/s/LSB
2-21 deg/LSB (0.008/65536)/125 deg/LSB
2-22 m/s/LSB (0.200/65536)/125 mG/s/LSB 1
11 g = 9.80665 m/s/s OEM7 Commands and Logs Reference Manual v10
1030
Chapter 5 SPAN Logs
5.37 RAWIMUSX
IMU Data Extended
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This is the short header version of the extended RAWIMUX log intended for use with post-processing. The extended version includes IMU information that is used by the NovAtel Inertial Explorer post-processing software.
The change in velocity (acceleration) and angle (rotation rate) scale factors for each IMU type can be found in Table 229: Raw IMU Scale Factors on page 1029. Multiply the appropriate scale factor by the count value for the velocity (field 7-9) and angle (field 10-12) increments.
To obtain acceleration in m/s/s or rotation rate in rad/s, multiply the velocity/rotation increments by the output rate of the IMU (e.g., 100 Hz for HG1700, HG1900, HG1930 and HG4930; 200 Hz for ISA-100C, iMAR-FSAS, LN200, KVH1750 and ADIS16488; 125 Hz for STIM300 and G320N). The units of acceleration and rotation rate will depend on the IMU Scale Factors.
This log is output in the IMU Body frame.
Message ID: 1462
Log Type: Asynch
Recommended Input: log rawimusxb onnew
ASCII example: %RAWIMUSXA,1692,484620.664;00,11,1692,484620.664389000,00801503,43110635,817242,-202184,-215194,-41188,-9895*a5db8c7b
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
1
RAWIMUSX Log header. See Messages on page 25 for more
Header
information. (short)
-
H
0
OEM7 Commands and Logs Reference Manual v10
1031
Chapter 5 SPAN Logs
Field
Field Type
2
IMU Info
3
IMU Type
4
GNSS Week
GNSS
5
Week
Seconds
Description
IMU Info Bits Bit 0: If set, an IMU error was detected. Check the IMU Status field for details. Bit 1: If set, the IMU data is encrypted and should not be used. Bits 2 to 7: Reserved
IMU Type identifier. See Table 200: IMU Type on page 887.
Format
Binary Bytes
Binary Offset
Hex Uchar
1
H
Uchar 1
H+1
GNSS Week
Ushort 2
H+2
Seconds from week start
Double 8
H+4
OEM7 Commands and Logs Reference Manual v10
1032
Chapter 5 SPAN Logs
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
The status of the IMU. This field is given in a fixed length (n) array of bytes in binary but in ASCII or Abbreviated ASCII is converted into 2 character hexadecimal pairs.
For the raw IMU status, see one of the following tables:
l Table 217: iIMU-FSAS IMU Status on page 1009
l Table 218: HG1700 IMU Status on page 1010
l Table 219: LN200 IMU Status on page 1012
l Table 220: ISA-100C IMU Status on page 1013
l Table 221: IMU-CPT IMU Status on
6
IMU Status
page 1014
Hex
4
l Table 222: IMU-KVH1750 IMU Status on Ulong
page 1016
l Table 223: HG1900 and HG1930 IMU Status on page 1017
l Table 224: HG4930 IMU Status on page 1019
l Table 225: ADIS16488 and IMU-IGM-A1 IMU Status on page 1020
l Table 226: STIM300 and IMU-IGM-S1 IMU Status on page 1022
l Table 227: �IMU IMU Status on page 1023
l Table 228: G320N IMU Status on page 1025
Also refer to Interface Control Documentation as provided by Honeywell or Northrop Grumman.
H+12
7
Z Accel
Change in velocity count along Z-axis.
Long
4
H+16
OEM7 Commands and Logs Reference Manual v10
1033
Chapter 5 SPAN Logs
Field
Field Type
8
-(Y Accel)
9
X Accel
10
Z Gyro
11
-(Y Gyro)
12
X Gyro
13
XXXX
14
[CR][LF]
Description
Format
Binary Bytes
Binary Offset
- (Change in velocity count along y-axis.)
A negative value implies the output is along the
positive y-axis marked on the IMU. A positive Long
4
value implies the change is in the direction
opposite to that of the y-axis marked on the
IMU.
H+20
Change in velocity count along x axis.
Long
4
H+24
Change in angle count around z axis. Right-handed
Long
4
H+28
- (Change in angle count around y axis.) Right-handed
A negative value implies the output is along the
positive y-axis marked on the IMU. A positive Long
4
value implies the change is in the direction
opposite to that of the y-axis marked on the
IMU.
H+32
Change in angle count around x axis. Right-handed
Long
4
H+36
32-bit CRC (ASCII, Binary, and Short Binary only)
Hex
4
H+40
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
1034
Chapter 5 SPAN Logs
5.38 RAWIMUX
IMU Data Extended
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log is an extended version of the RAWIMU log intended for use with post-processing. The extended version includes IMU information that is used by the NovAtel Inertial Explorer post-processing software.
The change in velocity (acceleration) and angle (rotation rate) scale factors for each IMU type can be found in Table 229: Raw IMU Scale Factors on page 1029. Multiply the appropriate scale factor by the count value for the velocity (field 7-9) and angle (field 10-12) increments.
To obtain acceleration in m/s/s or rotation rate in rad/s, multiply the velocity/rotation increments by the output rate of the IMU (e.g., 100 Hz for HG1700, HG1900, HG1930 and HG4930; 200 Hz for ISA-100C, iMAR-FSAS, LN200, KVH1750 and ADIS16488; 125 Hz for STIM300 and G320N). The units of acceleration and rotation rate will depend on the IMU Scale Factors.
This log is output in the IMU Body frame.
Message ID: 1461
Log Type: Asynch
Recommended Input: log rawimuxb onnew
ASCII example: #RAWIMUXA,COM1,0,81.5,FINESTEERING,1691,410338.819,024c0020,3fd1,43495;00,5,169 1,410338.818721000,00170705,-113836,-464281,43146813,89,11346,181*01cd06bf
Field
Field Type
Description
1
RAWIMUX Log header. See Messages on page 25 for more
Header
information.
Format
Binary Bytes
Binary Offset
-
H
0
OEM7 Commands and Logs Reference Manual v10
1035
Chapter 5 SPAN Logs
Field
Field Type
Description
IMU Info Bits
Bit 0: If set, an IMU error was detected. Check
the IMU Status field for details.
2
IMU Info
Bit 1: If set, the IMU data is encrypted and
should not be used.
Bits 2 to 7: Reserved
IMU Type identifier.
3
IMU Type
See Table 200: IMU Type on page 887.
4
GNSS Week
GNSS Week
GNSS
5
Week
Seconds from week start
Seconds
Format
Binary Bytes
Binary Offset
Hex Uchar
1
H
Uchar 1 Ushort 2 Double 8
H+1 H+2 H+4
OEM7 Commands and Logs Reference Manual v10
1036
Chapter 5 SPAN Logs
Field
Field Type
Description
Format
Binary Bytes
Binary Offset
The status of the IMU. This field is given in a fixed length (n) array of bytes in binary but in ASCII or Abbreviated ASCII is converted into 2 character hexadecimal pairs.
For the raw IMU status, see one of the following tables:
l Table 217: iIMU-FSAS IMU Status on page 1009
l Table 218: HG1700 IMU Status on page 1010
l Table 219: LN200 IMU Status on page 1012
l Table 220: ISA-100C IMU Status on page 1013
6
IMU Status
l Table 221: IMU-CPT IMU Status on page 1014
l Table 222: IMU-KVH1750 IMU Status on page 1016
Hex Ulong
4
l Table 223: HG1900 and HG1930 IMU Status on page 1017
l Table 224: HG4930 IMU Status on page 1019
l Table 225: ADIS16488 and IMU-IGM-A1 IMU Status on page 1020
l Table 226: STIM300 and IMU-IGM-S1 IMU Status on page 1022
l Table 227: �IMU IMU Status on page 1023
l Table 228: G320N IMU Status on page 1025
Also refer to Interface Control Documentation as provided by Honeywell or Northrop Grumman.
H+12
7
Z Accel
Change in velocity count along Z-axis.
Long
4
H+16
- (Change in velocity count along y-axis.)
A negative value implies the output is along the
8
-(Y Accel) positive y-axis marked on the IMU. A positive
Long
4
value implies the change is in the direction
opposite to that of the y-axis marked on the
IMU.
H+20
9
X Accel
Change in velocity count along x axis.
Long
4
H+24
OEM7 Commands and Logs Reference Manual v10
1037
Chapter 5 SPAN Logs
Field
Field Type
Description
10
Z Gyro
Change in angle count around z axis. Right-handed
- (Change in angle count around y axis.) Right-handed
A negative value implies the output is along the
11
-(Y Gyro) positive y-axis marked on the IMU. A positive
value implies the change is in the direction
opposite to that of the y-axis marked on the
IMU.
12
X Gyro
Change in angle count around x axis. Right-handed
13
XXXX
32-bit CRC (ASCII, Binary, and Short Binary only)
14
[CR][LF] Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Long
4
H+28
Long
4
H+32
Long
4
Hex
4
-
-
H+36 H+40 -
OEM7 Commands and Logs Reference Manual v10
1038
Chapter 5 SPAN Logs
5.39 RELINSPVA
Relative INSPVA log
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log provides the relative offset between the Master and Rover Inertial Solutions. The output solution provides the offset of where the local station is with respect to the other station.
Message ID: 1446
Log Type: Asynch
Recommended Input: LOG RELINSPVAA ONNEW
ASCII example: #RELINSPVAA,COM1,0,61.0,FINESTEERING,1805,245074.000,02000000,2338,45757;BODY,9 .285958662,-0.755483058,0.079229338,0.001739020,0.000126304,0.001525848,0.321033045,0.669367786,4.466250181,0.000000000,"b81V", INS_ALIGNMENT_COMPLETE,"B20C",INS_ALIGNMENT_COMPLETE,NARROW_ INT,00000000*a114ce3c
Field Field Type
1
RELINSPVA Header
2
Output Frame
3
DeltaPosX
Description
Log header. See Messages on page 25 for more information.
The current output frame (IMU body, ECEF or local level frame).
The output frame is specified using the SETRELINSOUTPUTFRAME command (see page 927)
Difference in the position between the two receivers (m). The position difference is relative to the output frame:
BODY = along the X-axis ECEF = along the X-axis Local level = Northing
Format
Binary Bytes
Binary Offset
-
H
0
Enum 4
H
Double 8
H+4
OEM7 Commands and Logs Reference Manual v10
1039
Chapter 5 SPAN Logs
Field Field Type
4
DeltaPosY
5
DeltaPosZ
6
DeltaVelX
7
DeltaVelY
8
DeltaVelZ
9
DeltaRoll
10
DeltaPitch
Description
Difference in the position between the two receivers (m). The position difference is relative to the output frame:
BODY = along the Y-axis ECEF = along the Y-axis Local level = Easting
Difference in the position between the two receivers (m). The position difference is relative to the output frame:
BODY = along the Z-axis ECEF = along the Z-axis Local level = Up
Difference in velocity between the two receivers (m/s). The position difference is relative to the output frame:
BODY = along the X-axis ECEF = along the X-axis Local level = Northing
Difference in velocity between two receivers (m/s). The position difference is relative to the output frame:
BODY = along the Y-axis ECEF = along the Y-axis Local level = Easting
Difference in velocity between the two receivers (m/s). The position difference is relative to the output frame:
BODY = along the Z-axis ECEF = along the Z-axis Local level = Up
Difference in roll between the two receivers (degrees).
Difference in pitch between the two receivers (degrees).
Format
Binary Bytes
Binary Offset
Double 8
H+12
Double 8
H+20
Double 8
H+28
Double 8
H+36
Double 8
H+44
Double 8 Double 8
H+52 H+60
OEM7 Commands and Logs Reference Manual v10
1040
Chapter 5 SPAN Logs
Field Field Type
Description
11
DeltaHeading
Difference in heading between the two receivers (degrees).
12
Diff Age
Differential age in seconds.
13
Rover ID
Rover receiver ID string.
14
Rover INSStatus
INS status of the rover receiver. See Table 207: Inertial Solution Status on page 959
15
Master ID
Master receiver ID string.
16
Master INSStatus
INS status of the master receiver. See Table 207: Inertial Solution Status on page 959
Status of the current RTK vector between
17
RTK Status
master and rover. See Table 75: Position or Velocity Type on
page 437
18
ExtStatus
Extended solution status. See Table 208: Extended Solution Status on page 964
20
xxxx
32-bit CRC (ASCII and Binary only)
21
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Double 8
H+68
Float
4
Char[4] 4
H+76 H+80
Enum 4
H+84
Char[4] 4
H+88
Enum 4
H+92
Enum 4
Hex
4
Hex
4
-
-
H+96
H+100 H+104 -
OEM7 Commands and Logs Reference Manual v10
1041
Chapter 5 SPAN Logs
5.40 SYNCHEAVE
Synchronous Log Containing the Instantaneous Heave Value
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Synchronous heave is available up to the rate of the IMU. It can also be logged 'on time' at lower rates. This log also includes information about the estimated accuracy of the heave value through the standard deviation of the heave. You must have an inertial solution to use this log. The heave filter must be enabled using the HEAVEFILTER command (see page 892), before this log is available.
Message ID: 1708
Log Type: Synch
Recommended Input: log syncheavea ontime 0.05
ASCII example: #SYNCHEAVEA,COM1,0,50.0,FINESTEERING,1770,245720.925,02000020,552e,12622;0.045410579,0.436800622*b8c14286
Field Field Type
Description
Format
Binary Bytes
1
SYNCHEAVE Header
Log header. See Messages on page 25 for more information.
-
H
2
Heave
Instantaneous heave value (metres)
Double 8
3
Std. Dev.
Standard deviation of the heave value (metres)
Double 8
4
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
5
[CR][LF]
Sentence Terminator (ASCII only)
-
-
Binary Offset 0 H H+8 H+16 -
OEM7 Commands and Logs Reference Manual v10
1042
Chapter 5 SPAN Logs
5.41 SYNCRELINSPVA
Synchronous Relative INSPVA log
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log provides the relative offset between the master and rover inertial solutions. The output solution provides the offset of where the local station is with respect to the other station.
This log is designed to provide synchronous, relative Position, Velocity and Attitude information, propagating the information between matched corrections between the master and remote solutions. It is highly recommended that the highest rate of corrections be used at all times for the most precise and robust performance.
Message ID: 1743
Log Type: Synch
Recommended Input: LOG SYNCRELINSPVAA ONTIME 1
ASCII example: #SYNCRELINSPVAA,COM1,0,72.5,FINESTEERING,1805,247243.000,02000000,e9c7,13005;BO DY,8.141080733,-2.779177478,2.045421773,-0.001464009,0.001038329,0.002323548,0.409467974,0.715633909,6.204731538,0.000000000,"B81V",INS_ALIGNMENT_COMPLETE,"B20C",INS_ALIGNMENT_ COMPLETE,INS_PSRSP,00000000*e270f5c8
Field Field Type
Description
Format
Binary Bytes
Binary Offset
1
SYNCRELINSPVA Log header. See Messages on page 25 for
Header
more information.
-
H
0
The current output frame (IMU body, ECEF or local level frame).
2
Output Frame
The output frame is specified using the
Enum 4
H
SETRELINSOUTPUTFRAME command
(see page 927)
3
DeltaPosX
Difference in the position between the two
receivers (m).
The position difference is relative to the
output frame:
Double 8
BODY = along the X-axis ECEF = along the X-axis Local level = Northing
H+4
OEM7 Commands and Logs Reference Manual v10
1043
Chapter 5 SPAN Logs
Field Field Type
4
DeltaPosY
5
DeltaPosZ
6
DeltaVelX
7
DeltaVelY
8
DeltaVelZ
9
DeltaRoll
10
DeltaPitch
Description
Format
Binary Bytes
Binary Offset
Difference in the position between the two
receivers (m).
The position difference is relative to the
output frame:
Double 8
BODY = along the Y-axis ECEF = along the Y-axis Local level = Easting
H+12
Difference in the position between the two
receivers (m).
The position difference is relative to the
output frame:
Double 8
BODY = along the Z-axis ECEF = along the Z-axis Local level = Up
H+20
Difference in velocity between the two receivers (m/s). The position difference is relative to the output frame:
BODY = along the X-axis ECEF = along the X-axis Local level = Northing
Double 8
H+28
Difference in velocity between two receivers (m/s). The position difference is relative to the output frame:
BODY = along the Y-axis ECEF = along the Y-axis Local level = Easting
Double 8
H+36
Difference in velocity between the two receivers (m/s). The position difference is relative to the output frame:
BODY = along the Z-axis ECEF = along the Z-axis Local level = Up
Double 8
H+44
Difference in roll between the two receivers (degrees).
Double 8
H+52
Difference in pitch between the two receivers (degrees).
Double 8
H+60
OEM7 Commands and Logs Reference Manual v10
1044
Chapter 5 SPAN Logs
Field Field Type
Description
Format
Binary Bytes
Binary Offset
11
DeltaHeading
Difference in heading between the two receivers (degrees).
Double 8
H+68
12
Diff Age
Differential age in seconds.
Float
4
H+76
13
Rover ID
Rover receiver ID string.
Char[4] 4
H+80
INS status of the rover receiver.
14
Rover INSStatus See Table 207: Inertial Solution Status on Enum 4
page 959
H+84
15
Master ID
Master receiver ID string.
Char[4] 4
H+88
16
Master INSStatus
INS status of the master receiver. See Table 207: Inertial Solution Status on Enum 4 page 959
H+92
17
RTK Status
Status of the current RTK vector between
master and rover. See Table 75: Position or Velocity Type
Enum
4
on page 437
H+96
18
ExtStatus
Extended solution status.
See Table 208: Extended Solution Status Hex
4
on page 964
H+100
20
xxxx
32-bit CRC (ASCII and Binary only)
Hex
4
H+104
21
[CR][LF]
Sentence terminator (ASCII only)
-
-
-
OEM7 Commands and Logs Reference Manual v10
1045
Chapter 5 SPAN Logs
5.42 TAGGEDMARK1PVA, TAGGEDMARK2PVA, TAGGEDMARK3PVA and TAGGEDMARK4PVA
Position, Velocity and Attitude at a Tagged Mark Request
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
TAGGEDMARKxPVA contains the same information as MARKxPVA with the addition of a unique identifying number (tag).
The TAGGEDMARKxPVA logs available are dependent on the receiver used in the SPAN system. For information about the Event lines supported, see the Strobe Specifications for the receiver in the OEM7 SPAN Installation and Operation User Manual.
The user specifies a TAG for the upcoming TAGGEDMARKxPVA via the TAGNEXTMARK command (see page 932). That tag shows up at the end of this message, which is otherwise identical to the MARKXPVA message.
Message ID:
1258 (TAGGEDMARK1PVA) 1259 (TAGGEDMARK2PVA) 1327 (TAGGEDMARK3PVA) 1328 (TAGGEDMARK4PVA)
Log Type: Synch
Recommended Input: log taggedmark1pva onnew log taggedmark2pva onnew log taggedmark3pva onnew log taggedmark4pva onnew
Abbreviated ASCII Example:
#TAGGEDMARK1PVAA,COM1,0,63.0,FINESTEERING,1732,247787.965,024c0020,ae1e,12002;1 732,247787.964913500,51.11693231436,114.03884974751,1046.9481,0.0001,0.0007,0.0004,1.090392628,0.766828598,244.4139 50146,INS_SOLUTION_GOOD,1234*34fda4f4
#TAGGEDMARK2PVAA,COM1,0,73.0,FINESTEERING,1732,248347.693,020500a0,2ab3,12002;1 732,248347.692695400,51.11693017508,114.03884746120,1046.3929,0.0009,0.0014,0.0015,0.559580646,1.121028629,255.5411 53133,INS_SOLUTION_GOOD,1234*1e97dd88
#TAGGEDMARK3PVAA,COM1,0,73.0,FINESTEERING,1732,248347.693,020500a0,2ab3,12002;1 732,248347.692695400,51.11693017508,114.03884746120,1046.3929,0.0009,0.0014,0.0015,0.559580646,1.121028629,255.5411 53133,INS_SOLUTION_GOOD,1234*1e97dd88
OEM7 Commands and Logs Reference Manual v10
1046
Chapter 5 SPAN Logs
#TAGGEDMARK4PVAA,COM1,0,73.0,FINESTEERING,1732,248347.693,020500a0,2ab3,12002;1 732,248347.692695400,51.11693017508,114.03884746120,1046.3929,0.0009,0.0014,0.0015,0.559580646,1.121028629,255.5411 53133,INS_SOLUTION_GOOD,1234*1e97dd88
Field
Field Type
Description
1
TAGGEDMARKxPVA Log header. See Messages on page 25
Header
for more information.
2
Week
GNSS Week at Mark request
3
Seconds into Week GNSS Seconds at Mark request
4
Latitude
Latitude at Mark request
5
Longitude
Longitude at Mark request
6
Height
Height at Mark request
7
North Velocity
North Velocity at Mark request
8
East Velocity
East Velocity at Mark request
9
Up Velocity
Up Velocity at Mark request
10
Roll
Roll at Mark request
11
Pitch
Pitch at Mark request
12
Azimuth
Azimuth at Mark request
13
Status
INS Status at Mark request
14
Tag
Tag ID from the TAGNEXTMARK command (see page 932), if any (default = 0)
15
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
16
[CR][LF]
Sentence Terminator (ASCII only)
Format
Binary Bytes
Binary Offset
-
H
0
Ulong 4 Double 8 Double 8 Double 8 Double 8 Double 8 Double 8 Double 8 Double 8 Double 8 Double 8 Enum 4
H H+4 H+12 H+20 H+28 H+36 H+44 H+52 H+60 H+68 H+76 H+84
Ulong 4
H+88
Hex
4
-
-
H+92 -
OEM7 Commands and Logs Reference Manual v10
1047
Chapter 5 SPAN Logs
5.43 TIMEDWHEELDATA
Timed Wheel Data
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains time stamped wheel sensor data. The time stamp in the header is the time of validity for the wheel data and not the time the TIMEDWHEELDATA log was output. See the relevant SPAN User Manual for information about wheel sensor messages.
Depending on the method used to connect the wheel sensor (through an IMU using a UIC, an IMU in an IMU Enclosure (IMU-ISA-100C, IMU-HG1900, IMU-ENC-LN200 or IMU�IMU-IC), an IMU-FSAS or an IMU-CPT, or directly into an IMU-IGM enclosure), either field 3 or field 4 of the log will be filled for wheel velocity. They are equivalent, but are filled differently depending on what data is provided to SPAN. For the PwrPak7, only field 7 (Cumulative Ticks) will be filled. Both fields 3 and 4 will be zero even when the wheel sensor is operating correctly. Note that neither velocity value is used by the SPAN filter. Rather, the SPAN filter uses cumulative ticks per second.
Message ID: 622
Log Type: Asynch
Recommended Input: log timedwheeldataa onnew
ASCII Example: %TIMEDWHEELDATAA,1393,411345.001;58,0,215.814910889,0,0,1942255*3b5fa236
This example is from the iMAR iMWS wheel sensor.
Field
Field Type
Description
1
TIMEDWHEELDATA Log header. See Messages on page 25
Header
for more information. (short header)
2
Ticks Per Rev
Number of ticks per revolution
3
Wheel Vel
Wheel velocity in counts/s
4
fWheel Vel
Float wheel velocity in counts/s
5 Reserved
6
Format
Binary Bytes
Binary Offset
-
H
0
Ushort 2
Ushort 2
Float
4
Ulong 4
Ulong 4
H H+2 H+4 H+8 H+12
OEM7 Commands and Logs Reference Manual v10
1048
Chapter 5 SPAN Logs
Field
Field Type
Description
7
Cumulative Ticks Number of ticks
8
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
Binary Offset
Long
4
H+16
Hex
4
H+20
-
-
-
OEM7 Commands and Logs Reference Manual v10
1049
Chapter 5 SPAN Logs
5.44 TSS1
TSS1 Protocol for Heave, Roll and Pitch
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log provides heave, roll and pitch information in TSS1 protocol.
This message is in a different format than any other log output by the SPAN system.
To use this log, make sure that Heave is enabled (see the HEAVEFILTER command (see page 892)) and the INS status is greater than INS_ALIGNMENT_COMPLETE
Message ID: 1456 Log Type: Synch Recommended Input:
log tss1a ontime 1
Message Format: :XXAAAASMHHHHQMRRRRSMPPPP<CR><LF>
ASCII Example: :00FFCA -0003F-0325 0319
Field Field Type
Description
Symbol
1
TSS1 Header
Log header. See Messages on page 25 for more information.
-
Horizontal acceleration from 0 to 9.81m/s2.
2
Horizontal Acceleration
Shown as a one byte unsigned hex number where
XX
the least significant bit = 3.83 cm/s2.
Vertical acceleration from -20.48 to +20.48 m/s2.
3
Vertical Acceleration
Shown as a two byte hex number where the least
AAAA
significant bit = 0.0625 cm/s2.
4
Space Character
A space delimiter.
S
5
Heave Polarity
Space if positive. Minus sign (-) if negative.
M
Example 0 00 FFCA
-
OEM7 Commands and Logs Reference Manual v10
1050
Chapter 5 SPAN Logs
Field Field Type
Description
6
Heave
Heave value from -99.99 to +99.99 m.
Shown as a four digit integer where the least significant bit = 0.01 m.
F if INS Active.
7
Status Flag
H if INS has not completed an alignment.
Space if positive.
8
Roll Polarity
Minus sign (-) if negative.
9
Roll
Roll value from -99.99 to +99.99 degrees.
Shown as a four digit integer where the least significant bit = 0.01 degrees.
10
Space Character
A space delimiter.
Space if positive.
11
Pitch Polarity
Minus sign (-) if negative.
12
Pitch
Pitch value from -99.99 to +99.99 degrees.
Shown as a four digit integer where the least significant bit = 0.01 degrees.
13
[CR][LF]
Sentence terminator
Symbol Example
HHHH
0003
Q
F
M
-
RRRR S M
0325
PPPP
0319
<CR><LF>
OEM7 Commands and Logs Reference Manual v10
1051
Chapter 5 SPAN Logs
5.45 VARIABLELEVERARM
Display Variable Lever Arm Details
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
Use this log to redisplay the re-calculated variable lever arm whenever a new INPUTGIMBALANGLE command is received. This message is output in the IMU body frame.
Message ID: 1320
Log Type: Asynch
Recommended Input: log variableleverarma onnew
ASCII Example: #VARIABLELEVERARMA,SPECIAL,0,81.5,FINESTEERING,1614,495820.512,42040000,0000,32 0;-0.0959421909646755,0.1226971902356540,1.1319295452903300, 0.0100057787272846,0.0122604827412661,0.1131929545290330*9611d3c6
Field
Field Type
Description
1
VARIABLELEVERARM Log header. See Messages on
Header
page 25 for more information.
2
XOffset
IMU body frame x-axis offset
3
YOffset
IMU body frame y-axis offset
4
ZOffset
IMU body frame z-axis offset
5
XUncert
X-axis uncertainty in metres
6
YUncert
Y-axis uncertainty in metres
7
ZUncert
Z-axis uncertainty in metres
8
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
9
[CR][LF]
Sentence terminator (ASCII only)
Format
Binary Bytes
-
H
Double 8 Double 8 Double 8 Double 8 Double 8 Double 8
Hex
4
-
-
Binary Offset
0
H H+8 H+16 H+24 H+32 H+40
H+48
-
OEM7 Commands and Logs Reference Manual v10
1052
Chapter 5 SPAN Logs
5.46 WHEELSIZE
Wheel Size
Platform: OEM719, OEM729, OEM7500, OEM7600, OEM7700, OEM7720, PwrPak7, SPAN CPT7, SMART7-S
This log contains wheel sensor information. The inertial filter models the size of the wheel to compensate for changes in wheel circumference due to hardware or environmental changes. The default wheel size is 1.96 m. A scale factor to this default size is modeled in the filter and this log contains the current estimate of the wheel size.
Message ID: 646
Log Type: Asynch
Recommended Input: log wheelsizea onnew
ASCII Example: #WHEELSIZEA,COM3,0,44.0,FINESTEERING,0,0.000,02000000,85f8,33738;1.025108123,2. 009211922,0.000453791*b65d28e6
Field Field Type
Description
Format
Binary Bytes
1
WHEELSIZE Header
Log header. See Messages on page 25 for more information.
-
H
2
Scale
Wheel sensor scale factor
Double 8
3
Circum
4
Var
Wheel circumference (m) Variance of circumference (m2)
Double 8 Double 8
5
xxxx
32-bit CRC (ASCII, Binary and Short Binary only)
Hex
4
6
[CR][LF]
Sentence terminator (ASCII only)
-
-
Binary Offset 0 H H+8 H+16
H+24 -
OEM7 Commands and Logs Reference Manual v10
1053
Chapter 6 Responses
The receiver is capable of outputting several responses for various conditions. Most responses are error messages to indicate when something is not correct.
The output format of the messages is dependent on the format of the input command. If the command is input as abbreviated ASCII, the output will be abbreviated ASCII. The same rule applies for both ASCII and binary formats.
Table 230: Response Messages
ASCII Message
Binary Message
ID
Meaning
OK
1
Command was received correctly
Requested log does not exist
2
The log requested does not exist
Not enough resources in system
3
The request has exceeded a limit (for example, the maximum number of logs are being generated)
Data packet doesn't verify
4
Data packet is not verified
Command failed on receiver
5
Command did not succeed in accomplishing requested task
Invalid Message ID
6
The input message ID is not valid
Invalid Message. Field =x
7
Field x of the input message is not correct
Invalid Checksum
8
The checksum of the input message is not correct. Only applies to ASCII and binary format messages.
Message missing field
9
A field is missing from the input message
Array size for field x exceeds max
10
Field x contains more array elements than allowed
parameter x is out of range
11
Field x of the input message is outside the acceptable limits
Message Id already exists in system
12
Message Id already exists in system
Debug token unknown
13
Debug token unknown
Trigger x not valid for this log
14
Trigger type x is not valid for this type of log
Authcode table full Reload Software
15
Too many authcodes are stored in the receiver. The receiver firmware must be reloaded
OEM7 Commands and Logs Reference Manual v10
1054
Chapter 6 Responses
ASCII Message
Binary Message
ID
Meaning
Invalid date format
16
This error is related to the inputting of authcodes. Indicates the date attached to the code is not valid
Invalid Authcode entered
17
The authcode entered is not valid
No matching model to remove
18
The model requested for removal does not exist
Not valid Auth code for
that Model
19
The model attached to the authcode is not valid
Channel is invalid
20
The selected channel is invalid
Requested rate is invalid
21
The requested rate is invalid
Word has no mask for this type
22
The word has no mask for this type of log
Channels locked due to error
23
Channels are locked due to error
Injected time invalid
24
Injected time is invalid
Com port not supported
25
The COM or USB port is not supported
Message is incorrect
26
The message is invalid
Invalid PRN
27
The PRN is invalid
PRN not locked out
28
The PRN is not locked out
PRN lockout list is full
29
PRN lockout list is full
PRN already locked out
30
The PRN is already locked out
Message timed out
31
Message timed out
Unknown COM port requested
33
Unknown COM or USB port requested
Hex string not formatted correctly
34
Hex string not formatted correctly
Invalid baud rate
35
The baud rate is invalid
Message is invalid for this model
36
Message is invalid for this model of receiver
OEM7 Commands and Logs Reference Manual v10
1055
Chapter 6 Responses
ASCII Message
Binary Message
ID
Meaning
Could Not Save Configuration
38
Could Not Save Configuration
Too Many Configuration Items
39
Too Many Configuration Items
Command only valid if in NVM Fail mode
40
Command is only valid if NVM is in fail mode
Invalid offset
41
The offset is invalid
File conflict
43
File conflict
File not found
44
File not found
File open
45
File open
File not open
46
File not open
Invalid DOS FileName
47
Invalid DOS File name
File channel in use
48
File channel in use
File close fail
50
File close fail
Disk not present
51
Disk not present
Disk error
52
Disk error
Disk full
53
Disk full
NVM Write Fail
74
NVM Write Fail
NVM Read Fail
75
NVM Read Fail
Not allowed for input
77
Not allowed for input
Maximum number of user messages reached
78
Maximum number of user messages has been reached
User message decryption
failed
79
User message decryption failed
GPS precise time is already known
84
GPS precise time is already known
The message could not be created
87
The message could not be created
Not enough memory to start application
113
Not enough memory to start application
OEM7 Commands and Logs Reference Manual v10
1056
Chapter 6 Responses
ASCII Message No data available
Binary Message
ID
114
No data available
Meaning
Invalid handshaking
117
Invalid handshaking
Message name already exists
118
Message name already exists
Invalid message name
119
Invalid message name
The datatype is invalid
120
The data type is invalid
Message ID is reserved
121
Message ID is reserved
Message size too large
122
Message size too large
Invalid Security Key
126
Invalid security key
Hardware not available
127
Hardware not available
Requested pulse width is invalid
131
Requested pulse width is invalid
Coarse time is not achieved yet
133
Coarse time is not achieved yet
Invalid Config Code
134
Invalid Config Code
ConfigCode table full -
Reload Software
135
Config Code table is full. Reload the software.
Unknown Object Type
136
Unknown object type
This operation is not valid at this time
137
This operation is not valid at this time
User VARF in use
140
User VARF in use
Must enable CLOCKADJUST
141
Must enable CLOCKADJUST. See the CLOCKADJUST command on page 105 for information about enabling.
Disk busy
142
Disk busy
Invalid Word Input Argument
143
Invalid Word Input Argument
Parameter %d is not valid for this model
148
The parameter specified is not valid for this model
ZUPT DISABLED BY USER
An INSZUPT command (see page 906) was sent after a
149
SETINSUPDATE ZUPT command was used to disable
the use of ZUPTs.
OEM7 Commands and Logs Reference Manual v10
1057
Chapter 6 Responses
ASCII Message
IMU SPECS LOCKED FOR THIS IMU TYPE
Binary Message
ID
Meaning
SPAN allows the default specifications for a select few
150
IMUs to be modified to support different variants. However, most IMU specifications are not allowed to
change.
Invalid interface mode.
Parameter %d
151
The specified Interface mode parameter is not valid.
COMMAND INVALID FOR THIS IMU
The entered command cannot be used with the
154
configured IMU. For example, the INSCALIBRATE ANT1 command is
not valid for lower quality IMUs.
IMU protocol is locked for this IMU type
155
IMU protocol is locked for this IMU type
IMU TYPE IS NOT SUPPORTED WITH CURRENT MODEL
157
A firmware model upgrade is required to use the requested IMU (CONNECTIMU command on page 886).
Trigger start time is invalid
159
Trigger start time is invalid
Sensor is not initialized
160
Sensor is not initialized
TRIGGER BUFFER IS FULL
The TIMEDEVENTPULSE command (see page 933) limit
161
of 10 events has been reached, and a new event cannot
be set until an event is cleared.
Board has not achieved finesteering
162
The receiver has not achieved finesteering
SETUPSENSOR COMMAND IS LOCKED
The SETUPSENSOR command (see page 929) cannot be
163
modified because there are remaining trigger events
queued.
Invalid Profile Name
165
Invalid Profile Name
Maximum Number Profiles
Exceeded
166
The maximum number of profiles is exceeded
Failed To Delete Profile
167
Failed to delete the profile
Profile Name Already Exists
168
Profile name already exists
OEM7 Commands and Logs Reference Manual v10
1058
Chapter 6 Responses
ASCII Message
Total Profile Commands Size Over Limit
Binary Message
ID
Meaning
169
Total Profile commands size over limit
Cannot Change Profile When Activated
170
Cannot change a Profile when it is activated
Signature Authcode Copy
Fail
171
Signature Authcode copy fail
Maximum Number of Profile Commands Exceeded
172
The maximum number of PROFILE commands exceeded
Profile Active, Could Not Save Configuration
173
Profile active, could not save configuration
Current PPP position has bad status and cannot be used for seeding
178
Current PPP position has bad status and cannot be used for seeding
PPP seed position failed integrity check
179
PPP seed position failed integrity check
Invalid password
180
Invalid password
Too many files
181
Too many files
Encryption key output is not allowed
186
Encryption key output is not allowed
Secure port requires login
187
Secure port requires login
NMEA2000/J1939 stack is
already running on the CAN port
188
NMEA2000/J1939 stack is already running on the CAN port
No saved PPP seed position
191
No saved PPP seed position
System type is invalid for this model
192
System type is invalid for this model
Command is not supported for this model
193
Command is not supported for this model
Position Averaging Not Started
194
Position averaging not started
OEM7 Commands and Logs Reference Manual v10
1059
Chapter 6 Responses
ASCII Message
Binary Message
ID
Meaning
Not in GLIDE mode
200
Not in GLIDE mode
PPP seeding invalid in forced dynamics mode
201
PPP seeding invalid in forced dynamics mode
Wrong combination of parameters
202
Wrong combination of parameters
Invalid Calibration Request
203
Invalid calibration request
Active Gimbal Detected
204
Active gimbal detected
Authcode table full Use auth erase_table
Authcode table full. An authcode must be removed before another authcode can be added.
205
Refer to the AUTH command (see page 76) for
instructions on removing authcodes and cleaning up the
authcode table.
Profile Not Running Profile should be activated
206
Profile not running - Profile should be activated
ID provided is already in use
208
ID provided is already in use
ID provided does not exist
209
ID provided does not exist
Calibration already in progress
210
Calibration already in progress
Filter cannot be enabled due to channel speed settings
211
Filter cannot be enabled due to channel speed settings
Notch Filter and Frequency are mismatching
212
Notch filter and frequency are mismatching
Filter can not cascade
213
Filter can not cascade
There is no RF filter applied
214
There is no RF filter applied
ID provided should be 4 character long
215
ID provided should be 4 characters long
OEM7 Commands and Logs Reference Manual v10
1060
Chapter 6 Responses
ASCII Message
Binary Message
ID
Meaning
Invalid subscription code
216
Invalid subscription code
Subscription table full
217
Subscription table full
Network id does not
match subscription code
218
Network ID does not match the subscription code
Subscription not found
219
Subscription not found
Subscription not active
220
Subscription not active
Cannot activate expired
subscription
221
Cannot activate expired subscription
Maximum number of logs exceeded. No new log added.
222
Maximum number of logs exceeded. No new log added.
Seed is too far in the past
223
Seed is too far in the past
Final log request must use the ONCE trigger
224
Final log request must use the ONCE trigger
Channel invalid for region x
225
Channel invalid for region x
Region not set
226
Region not set
Estimated RBV must be entered first
227
Initial RBV estimate is required before RBV calibration
Command failed because WIFIALIGNAUTOMATION is enabled
240
Command failed because WIFIALIGNAUTOMATION is enabled. See the WIFIALIGNAUTOMATION command.
Specified network not enabled with WIFINETCONFIG command
241
Specified network not enabled with WIFINETCONFIG command. See the WIFINETCONFIG command.
OEM7 Commands and Logs Reference Manual v10
1061
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
The following takes a sample RANGECMP4 log and breaks it down into its raw components.
Data was captured in both RANGE and in RANGECMP4 logs which are shown here for reference. These logs were captured at a rate of 4 Hz such that the Reference and Differential parts of the RANGECMP4 could be explained.
Some of the RANGECMP4 values will have some very slight differences (at the millicycle level) compared to the equivalent RANGE log data due to truncating the double values into integers.
Here are two RANGE logs to reference against once the RANGECMP4 logs have been determined:
RANGE COM1 0 88.5 FINESTEERING 1919 507977.000 02000020 5103 32768 22 27 0 21761200.335 0.036 -114355879.993103 0.006 1121.758 50.0 876.785
18109c04 27 0 21761202.795 0.128 -89108485.029683 0.007 874.097 44.2 862.386
11303c0b 27 0 21761200.306 0.007 -85395622.838987 0.004 837.685 51.7 865.845
01d03c04 21 0 21214757.684 0.027 -111484302.588995 0.005 -1107.624 52.6 888.968
08109c24 21 0 21214757.049 0.122 -86870882.607297 0.006 -863.084 44.6 874.389
01303c2b 10 0 21540290.811 0.027 -113194996.162910 0.005 2288.688 52.6 889.905
08109c44 10 0 21540293.632 0.110 -88203904.731314 0.006 1783.394 45.6 868.725
01303c4b 10 0 21540289.869 0.006 -84528728.138216 0.004 1709.022 53.0 872.386
01d03c44 15 0 21776375.653 0.032 -114435625.391762 0.007 -1814.485 50.9 879.586
18109c64 15 0 21776376.038 0.129 -89170616.457446 0.007 -1413.886 44.1 862.706
11303c6b 18 0 20493192.703 0.031 -107692454.149639 0.007 212.747 51.1 891.550
08109c84 18 0 20493191.933 0.105 -83916195.494946 0.007 165.777 45.9 874.710
01303c8b 61 9 20375330.794 0.104 -108956045.737322 0.006 -3039.481 46.8 891.931
08119ca4 61 9 20375332.806 0.083 -84743599.055547 0.007 -2364.042 34.0 876.813
00b13cab 55 4 22748433.080 0.146 -121432681.638722 0.009 4061.119 43.9 416.032
18119cc4 55 4 22748438.602 0.021 -94447660.068923 0.009 3158.651 46.0 415.562
00b13ccb
OEM7 Commands and Logs Reference Manual v10
1062
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
38 8 19781617.845 0.058 -105744080.698106 0.004 -2024.611 51.8 893.563 18119ce4
38 8 19781623.453 0.032 -82245418.313339 0.005 -1574.698 42.2 878.833 00b13ceb
39 3 19968976.955 0.055 -106558290.405759 0.004 2248.713 52.3 875.210 08119d04
39 3 19968980.676 0.019 -82878686.553631 0.005 1749.000 46.9 870.890 00b13d0b
54 11 19507573.213 0.059 -104388964.028915 0.005 1289.410 51.8 894.613 08119d24
54 11 19507576.477 0.017 -81191427.275619 0.004 1002.874 48.0 878.832 10b13d2b
RANGE COM1 0 88.5 FINESTEERING 1919 507977.250 02000020 5103 32768 22 27 0 21761146.982 0.036 -114355599.642256 0.006 1121.140 49.9 877.035
18109c04 27 0 21761149.447 0.122 -89108266.573995 0.007 873.616 44.6 862.636
11303c0b 27 0 21761146.957 0.007 -85395413.484293 0.004 837.294 51.8 866.095
01d03c04 21 0 21214810.390 0.027 -111484579.560955 0.005 -1108.100 52.6 889.218
08109c24 21 0 21214809.754 0.120 -86871098.429369 0.005 -863.454 44.8 874.639
01303c2b 10 0 21540181.949 0.027 -113194424.080322 0.005 2288.176 52.6 890.155
08109c44 10 0 21540184.767 0.111 -88203458.952394 0.006 1782.995 45.4 868.975
01303c4b 10 0 21540181.003 0.006 -84528300.928648 0.004 1708.751 53.0 872.636
01d03c44 15 0 21776461.990 0.032 -114436079.084785 0.006 -1814.956 50.9 879.836
18109c64 15 0 21776462.375 0.129 -89170969.984233 0.007 -1414.253 44.1 862.956
11303c6b 18 0 20493182.598 0.031 -107692401.054068 0.007 212.183 51.2 891.800
08109c84 18 0 20493181.833 0.110 -83916154.122137 0.007 165.338 45.6 874.960
01303c8b 61 9 20375472.914 0.104 -108956805.696703 0.006 -3040.142 46.9 892.181
08119ca4 61 9 20375474.924 0.084 -84744190.134355 0.007 -2364.555 33.9 877.063
00b13cab 55 4 22748242.897 0.150 -121431666.427728 0.009 4060.804 43.7 416.282
18119cc4 55 4 22748248.421 0.021 -94446870.460803 0.009 3158.405 46.0 415.812
00b13ccb 38 8 19781712.549 0.059 -105744586.938646 0.004 -2025.149 51.8 893.813
18119ce4 38 8 19781718.158 0.032 -82245812.055601 0.005 -1575.117 42.3 879.083
00b13ceb
OEM7 Commands and Logs Reference Manual v10
1063
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
39 3 19968871.615 0.055 -106557728.318448 0.004 2248.162 52.3 875.460 08119d04
39 3 19968875.343 0.019 -82878249.374953 0.005 1748.571 46.8 871.140 00b13d0b
54 11 19507512.994 0.059 -104388641.780659 0.005 1288.778 51.7 894.863 08119d24
54 11 19507516.256 0.016 -81191176.637999 0.005 1002.383 48.1 879.082 10b13d2b
Here are the equivalent RANGECMP4 logs which will be broken down into their individual components:
#RANGECMP4A,COM1,0,88.5,FINESTEERING,1919,507977.000,02000020,fb0e, 32768;295,030000421204000000009200df7688831f611fd87ca0b03a00638bbdf7b8 2f49b080fd0ec0ff1f091f8214ff4d4d00a1009cbf1751f6911f5141f87fd9571a96db d7040c8090f87f0080fcf722fe9bfa8a49a8ff4f299d7f96fb9afefc771800fcffd006 3f02cde01f3c7dd3ffb75240886f5fa2b0ff91f57f00003edf8b78868c882878014065 dbf7d3ed6b722680d5fc0f00a4c08730fe7fecf8bffa3f003008000000002001f03fa0 19f8136a11273649b8fcefab9c434c7b89e71560dbfe070030b2e04fd841f33125320b 80b0ecefa5ee21243ac0bb03e0ffc36a813fb13bbe5791a0f5ff9e3bdbffbb87f0cb80 64f03f0000e4b67dd15bc5f4a50a3a006ca72fdee53ec86405b2c0fffa3fa450f725d5 bfed7c49b1fb0fb16b45a87a9adb0740cbfe0700*7DD8F893
#RANGECMP4A,COM1,0,88.5,FINESTEERING,1919,507977.250,02000020,fb0e, 32768;239,030000421204000000009200dff688831f6102005500e70162dc977c0040 15c07988840f6101803a805921cedf8b80002011207080e5f6351f003804081c2200be 0808005c01620808725f93028057801822dae0476000a00f207180fef6251700e80340 1c62f3bdc8060052013009986f5f22020054004ca2053ec408005401ca870180410000 0000000980ff6306fec408004801de07c8692f5102805180f721b2e04f600040152081 804ef7102500600540202205fe040a0086013a0938780f61020061804e224edbdb6800 2010c0498030f7411d0018047812a2d47d090a004c01a609c8544f62028052006a02 *48E189A2
A.1 Reference Log Decoding
The RANGECMP4 log at time 507977.0 will be decoded first:
#RANGECMP4A,COM1,0,88.5,FINESTEERING,1919,507977.000,02000020,fb0e, 32768;295,030000421204000000009200df7688831f611fd87ca0b03a00638bbdf7b8 2f49b080fd0ec0ff1f091f8214ff4d4d00a1009cbf1751f6911f5141f87fd9571a96db d7040c8090f87f0080fcf722fe9bfa8a49a8ff4f299d7f96fb9afefc771800fcffd006 3f02cde01f3c7dd3ffb75240886f5fa2b0ff91f57f00003edf8b78868c882878014065 dbf7d3ed6b722680d5fc0f00a4c08730fe7fecf8bffa3f003008000000002001f03fa0 19f8136a11273649b8fcefab9c434c7b89e71560dbfe070030b2e04fd841f33125320b 80b0ecefa5ee21243ac0bb03e0ffc36a813fb13bbe5791a0f5ff9e3bdbffbb87f0cb80 64f03f0000e4b67dd15bc5f4a50a3a006ca72fdee53ec86405b2c0fffa3fa450f725d5 bfed7c49b1fb0fb16b45a87a9adb0740cbfe0700*7DD8F893
Since this log falls on a whole second (507977.000), it is a Reference log.
At the start of the RANGECMP4 log is the identifier for how many bytes are in the log. In this case, there are 295 bytes. The rest of the message is compressed binary data and is transmitted as LSB first so the bytes must be swapped before processing.
OEM7 Commands and Logs Reference Manual v10
1064
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
A.1.1 Reference Header
The Reference Header is sent once per message. See Table 145: Header on page 712 in the RANGECMP4 log section. Decoding the bits starting with the first bytes: GNSS Field (16 bits)
l Grab the first 2 bytes (16 bits) = 0x0300 l Swap the bytes = 0x0003 l 0x0003 in binary form = 0000 0000 0000 0011
In this example the receiver was configured to track only GPS and GLONASS systems. If other systems had been in the configuration and tracked, they would have shown here.
A.1.2 Reference Satellite and Signal Block: GPS
This block is sent once for each bit set to 1 in the GNSS field (See Table 145: Header on page 712). As identified by the above GNSS field, the first system (right to left) is the GPS System. Use Table 146: Satellite and Signal Block on page 713 to determine what satellites and signals data are contained in this GPS system: GPS Satellites field (64 bits)
l Grab the next 8 bytes (64 bits) = 0x0042120400000000 l Swap the bytes = 0x0000000004124200 l 0x0000000004124200 in binary form =
l The 1's above identify that there are 5 tracking GPS PRNs. GPS Signals field (16 bits)
l Grab the next 2 bytes (16 bits) = 0x9200 l Swap the bytes = 0x0092 l 0x0092 in binary form =
OEM7 Commands and Logs Reference Manual v10
1065
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
l The 1's above identify that there are 3 tracking GPS signals: L1CA, L2Y, and L5Q.
GPS Included Signals field (5 PRNs x 3 Signals = 15 bits � Therefore need 2 bytes)
l Up to the point of processing the Included Signals field, the bytes are aligned such that the bits start and end within each batch of bytes. After processing this step, it is quite common for the Included Signals Field (mxn matrix) to not be divisible by 8 so bytes not processed will need to be carried over to the next section depending on the size of the matrix.
l Grab the next 2 bytes (16 bits) = 0xdf76
l Swap the bytes = 0x76df
l 0x76df in binary form = 0111011011011111
l Only need 15 of the 16 bits = X111011011011111
l This bit string breaks down into 5 rows (PRNs) and 3 columns (signals) as specified by the mxn (PRN x signals) parameters. Take the bit string and break it up into sets of 3 starting at the MSB. This will result with the lowest PRN being at the bottom row of the stack and the first signal (L1CA) being the far right column.
111 011 011 011 111
l This stack can be further broken apart to identify the PRNs vs. their Signals:
PRN L5Q L2Y L1CA 27 1 1 1 21 0 1 1 18 0 1 1 15 0 1 1 10 1 1 1
A.1.3 Reference Measurement Block Header: GPS
This block is sent once for each bit set to 1 in the Satellites field found in Table 146: Satellite and Signal Block on page 713. Now that the PRN's signals have been determined, the next step is to determine the specifics of the first PRN (10) and its list of signals (L1CA, L2Y, L5Q). Working from bottom right to upper left of the PRN/Signal chart above, each 1 represents a signal for a PRN. Use Table 147: Measurement Block Header on page 714 to determine the contents of each field:
GPS PRN 10 (first PRN found in the Satellites field)
We will grab enough bytes to process the whole Measurement Block Header. If this was a GLONASS System, a total of 9 bits would be required for this step (1 bit for the Data Format Flag, 3 bits for the Ref Data Block ID, plus 5 bits for the GLONASS Frequency Number). Since this is a GPS system, only 4 bits in total are required (1 bit for the Data Format Flag and 3 bits for the Ref Data Block ID).
OEM7 Commands and Logs Reference Manual v10
1066
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
There was 1 bit not processed in the last byte so that byte will be carried forward. Only 4 bits need to be looked at for this step so grab the next byte as well:
l Use the last byte (0x76) plus the next byte (0x88)= 0x7688 l Swap the bytes = 0x8876 l 0x8876 in binary form = 1000100001110110 l Ignore the 7 processed bits from the last step = 100010000XXXXXXX l Ignore the 5 MSB bits leaving 4 bits for processing =
The Data Format Flag identifies that this batch of data is Reference (0) data. The Ref Data Block ID is 0x000.
The 5 MSBs have not been processed so this byte will be carried forward.
The Data Format Flag identifies if the upcoming data is Reference or Differential data. By default every log that was published on a whole second will always be Reference logs. Logs between seconds will be Differential logs but could be Reference logs depending on the compression calculations. If a discontinuity occurred that made it impossible for a Differential calculation to fit within the Differential Constraints, it will revert to a Reference log.
A.1.4 Reference Measurement Block: GPS
This block is sent once for each bit set to 1 in the Included Signals Field found in Table 146: Satellite and Signal Block on page 713. Use Table 148: Primary Reference Signal Measurement Block on page 715 and Table 149: Secondary Reference Signals Measurement Block on page 716 to determine the contents of each field: A Measurement Block for a single PRN will look like the following:
Primary Parity Flag Primary � Cycle Slip Flag Primary C/No Primary Lock Time Primary Pseudorange Std Deviation Primary Phaserange Std Deviation Primary Pseudorange Primary Phaserange - Primary Pseudorange (determines the Phaserange for the 1st Signal) Primary Doppler
2nd Parity Flag 2nd � Cycle Slip Flag 2nd C/No
OEM7 Commands and Logs Reference Manual v10
1067
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
2nd Lock Time 2nd Pseudorange Std Deviation 2nd Phaserange Std Deviation 2nd Pseudorange - Primary Pseudorange (determines the Pseudorange for the 2nd Signal 2nd Phaserange - 2nd Pseudorange (determines the Phaserange for the 2nd Signal) 2nd Doppler - Primary Doppler (determines the Doppler for the 2nd Signal)
3rd Parity Flag 3rd � Cycle Slip Flag 3rd C/No 3rd Lock Time 3rd Pseudorange Std Deviation 3rd Phaserange Std Deviation 3rd Pseudorange - Primary Pseudorange (determines the Pseudorange for the 3rd Signal 3rd Phaserange - 3rd Pseudorange (determines the Phaserange for the 3rd Signal) 3rd Doppler - Primary Doppler (determines the Doppler for the 3rd Signal) ...
A.1.5 Reference Primary Signal Measurement Block: GPS PRN 10 � L1CA
The next bytes collected will be for the GPS PRN 10 - L1CA signal data. This is the primary signal of the PRN since it is the first signal. As a result, its Measurement Block consists of 111 bits as listed in Table 148: Primary Reference Signal Measurement Block on page 715. Since 111 bits takes up a lot of space, these bits will be split into two groups from Table 148: Primary Reference Signal Measurement Block on page 715: the top 25 bits for signal info followed by the bottom 86 bits for signal data. The signal info section (top 25 bits) is processed as follows:
l With 5 bits left unprocessed from the previous byte, we calculate 25 � 5 = 20 bits which rounds up to 3 bytes. Therefore the previous last byte (0x88) plus the next 3 bytes will be needed. l Use the last byte (0x88) plus grab 3 bytes (x831f61) = 0x88831f61 l Swap the bytes = 0x611f8388 l 0x611f8388 in binary form = 01100001000111111000001110001000 l The previous step used the 3 LSBs = 01100001000111111000001110001XXX
OEM7 Commands and Logs Reference Manual v10
1068
APPENDIX A Example of Bit Parsing a RANGECMP4 Log l 25 bits are needed so ignore the 4 MSBs =
l Parity flag is a 1 (Parity Known) l � Cycle Slip flag is a 0 (Cycle Slip Not Present) l C/No is:
0x10000011100b = 1052 x Scaling Factor of 0.05 = 52.60 dBHz l The Lock Time value is: 0x1111b = 15 which means that this signal has been locked for 262144 ms or more. l The Pseudorange Std Deviation value is: 0x0001b = 1 which means: 0.020 m < PSR Std Dev <= 0.030 m using Table 155: Pseudorange Std Dev on page 722. l The ADR Std Deviation value is: 0x0001b = 1 which means: 0.0039 < ADR Std Dev <= 0.0052 cycles using Table 154: ADR Std Dev on page 721. The signal data section (bottom 86 bits) is processed as follows: l With 4 bits unprocessed from the previous byte, we calculate 86 � 4 = 82 bits = 11 bytes (2 bits will not be processed in the last byte).
l Use the last byte (0x61) plus grab 11 bytes (0x1fd87ca0b03a00638bbdf7) = 0x611fd87ca0b03a00638bbdf7
l Swap the bytes = 0xf7bd8b63003ab0a07cd81f61 l 0xf7bd8b63003ab0a07cd81f61 in binary form =
111 0111 1011 1101 1000 1011 0110 0011 0000 0000 0011 1010 1011 0000 1010 0000 0111 1100 1101 1000 0001 1111 0110 0001 l Only need 86 bits. Ignore last 4 LSBs and first 6 MSBs =
l Use Table 148: Primary Reference Signal Measurement Block on page 715 to identify if a 2's Complement Conversion is needed as well as what Scale Factor should be used before these binary numbers are used in the following calculations.
l The 1st (Primary) Pseudorange is processed by: 1st Pseudorange = 0x0101000000111110011011000000111110110b x Scaling Factor 1st Pseudorange = 43080581622 x 0.0005 L1CA Pseudorange for PRN 10= 21540290.811 m
l The 1st (Primary) Phaserange is a 2's Complement number (as identified by the Range
OEM7 Commands and Logs Reference Manual v10
1069
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
column in Table 148: Primary Reference Signal Measurement Block on page 715) so it is processed in the following manner: 1st Phaserange � 1st Pseudorange = 2's Complement(0x00000000001110101011000b) * Scaling Factor 1st Phaserange � 21540290.811 m = 7512 * 0.0001 L1CA Phaserange = 21540291.5622 m l Convert this to ADR to check against the original RANGE log: ADR = 1st Phaserange * Frequency * (-1)/Speed Of Light ADR = 21540291.5622 m * 1575420000 Hz * (-1)/299792458 m/s L1CA ADR for PRN 10 = -113194996.1627158 cycles
In the range logs, PSR and ADR have opposite signs.
l The 1st (Primary) Doppler is a 2's Complement number (as identified by the Range column in Table 148: Primary Reference Signal Measurement Block on page 715) so it is processed in the following manner: 1st Doppler(m/s) = 2's Complement(0x11101111011000101101100011b) x Scaling Factor 1st Doppler(m/s) = -4,355,229 x 0.0001 L1CA Doppler(m/s) = -435.5229 m/s Convert the Doppler to Hz: 1st Doppler(Hz) = 1st Doppler(m/s) x Frequency * (-1)/Speed Of Light L1CA Doppler(Hz) for PRN 10 = 2288.6883 Hz 1st Doppler(Hz) = -435.5229 m/s x 1575420000 Hz * (-1)/299792458 m/s
A.1.6 Reference Secondary Signals Measurement Block: GPS PRN 10 � L2Y
Signal L1CA was the 1st signal (Primary Signal) of the three PRN 10 signals found in this RANGECMP4 log data. L1CA's data is now used to determine the L2Y's signals data. Since this is the second signal block of this PRN, its data will be processed by using Table 149: Secondary Reference Signals Measurement Block on page 716. With 6 bits left unprocessed from the previous byte, we will require 82 � 6 = 76 bits which rounds up to 10 bytes.
l Use the last byte (0xf7) plus grab the next 10 bytes (0xb82f49b080fd0ec0ff1f) = 0xf7b82f49b080fd0ec0ff1f
l Swap the bytes = 0x1fffc00efd80b0492fb8f7 l 0x1fffc00efd80b0492fb8f7 in binary form =
0001 1111 1111 1111 1100 0000 0000 1110 1111 1101 1000 0000 1011 0000 0100 1001 0010 1111 1011 1000 1111 0111 l Only need 78 bits. The 2 LSBs are ignored as they were already processed above and the 4
OEM7 Commands and Logs Reference Manual v10
1070
APPENDIX A Example of Bit Parsing a RANGECMP4 Log MSBs are ignored so there is a total of 82 bits to process
Use Table 149: Secondary Reference Signals Measurement Block on page 716 to identify if a 2's Complement Conversion is needed as well as what Scale Factor should be used before these binary numbers are used in the following calculations.
l Parity flag is a 1 (Parity Known)
l � Cycle Slip flag is a 0 (Cycle Slip Not Present)
l C/No is: 0x01110001111b = 911 x Scaling factor of 0.05 = 45.55 dBHz
l The Lock Time value is: 0x1111b = 15 which means that this signal has been locked for 262144 ms or more.
l The Pseudorange Std Deviation value is: 0x0101b = 5 which means: 0.099 m < PSR Std Dev <= 0.148 m using Table 155: Pseudorange Std Dev on page 722.
l The ADR Std Deviation value is: 0x0010b = 2 which means: 0.0052 < ADR Std Dev <= 0.0070 cycles using Table 154: ADR Std Dev on page 721.
l The L2Y Pseudorange is a 2's Complement number (as identified by the Range column in Table 149: Secondary Reference Signals Measurement Block on page 716) so it is processed in the following manner:
Pseudorange � 1st Pseudorange = 2's Complement(0x00000001011000001001b) x Scaling Factor Pseudorange � 21540290.811 m = 5641 x 0.0005 2Y Pseudorange = 21540293.6315 m
l The L2Y Phaserange is a 2's Complement number (as identified by the Range column in Table 149: Secondary Reference Signals Measurement Block on page 716) so it is calculated in the following manner:
Phaserange � Pseudorange = 2's Complement(0x00000000001110111111011b) * Scaling Factor Phaserange � 21540293.6315 m = 7675 * 0.0001 L2Y Phaserange = 21540294.399 m
l Convert this to ADR to check against the original RANGE log:
ADR = Phaserange * Frequency * (-1)/Speed Of Light ADR = 21540294.399 m * 1227600000 Hz * (-1)/299792458 m/s L2Y ADR for PRN 10 = -88203904.73002626 cycles
In the range logs, PSR and ADR have opposite signs.
OEM7 Commands and Logs Reference Manual v10
1071
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
l The L2Y Doppler is a 2's Complement number (as identified by the Range Column in Table 149: Secondary Reference Signals Measurement Block on page 716) so it is calculated in the following manner:
Doppler(m/s) � 1st Doppler(m/s) = 2's Complement(0x11111111111111b) x Scaling Factor Doppler(m/s) � (-435.5229 m/s) = (-1) x 0.0001 L2Y Doppler(m/s) = -435.5228 m/s
Convert the Doppler to Hz:
Doppler(Hz) = Doppler(m/s) x Frequency * (-1)/Speed Of Light Doppler(Hz) = -435.5228 m/s x 1227600000 Hz * (-1)/299792458 m/s L2Y Doppler(Hz) for PRN 10 = 1783.3938 Hz
A.1.7 Reference Third Signals Measurement Block: GPS PRN 10 � L5Q
Signal L1CA was the 1st signal (Primary Signal) of the three PRN 10 signals found in this RANGECMP4 log data. L1CA's data is now used to determine the L5Q's signals data. Since this is the third signal block of this PRN, its data will be processed using Table 149: Secondary Reference Signals Measurement Block on page 716.
With 4 bits left unprocessed from the previous byte, we will require 82 � 4 = 78 bits which rounds up to 10 bytes.
l Use the last byte (0x1f) plus grab the next 10 bytes (0x091f8214ff4d4d00a100) = 0x1f091f8214ff4d4d00a100
l Swap the bytes = 0x00a1004d4dff14821f091f
l 0x00a1004d4dff14821f091f in binary form = 0000 0000 1010 0001 0000 0000 0100 1101 0100 1101 1111 1111 0001 0100 1000 0010 0001 1111 0000 1001 0001 1111
l Only need 78 bits. The 4 LSBs are ignored as they were already processed above and the 2 MSBs are ignored so there is a total of 82 bits to process
Use Table 149: Secondary Reference Signals Measurement Block on page 716 to identify if a 2's Complement Conversion is needed as well as what Scale Factor should be used before these binary numbers are used in the following calculations.
l Parity flag is a 1 (Parity Known)
l � Cycle Slip flag is a 0 (Cycle Slip Not Present)
l C/No is: 0x10000100100b = 1060 x Scaling Factor of 0.05 = 53.00 dBHz
l The Lock Time value is: 0x1111b = 15 which means that this signal has been locked for 262144 ms or more.
l The Pseudorange Std Deviation value is: 0x0000b = 0 which means: PSR Std Dev <= 0.020 m using Table 155: Pseudorange Std Dev
OEM7 Commands and Logs Reference Manual v10
1072
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
on page 722. l The ADR Std Deviation value is:
0x0001b = 1 which means: 0.0039 < ADR Std Dev <= 0.0052 cycles using Table 154: ADR Std Dev on page 721. l The L5Q Pseudorange is a 2's Complement number (as identified by Range column in Table 149: Secondary Reference Signals Measurement Block on page 716) so it is processed in the following manner: Pseudorange � 1st Pseudorange = 2's Complement(0x11111111100010100100b) x Scaling Factor Pseudorange � 21540290.811 m = (-1884) x 0.0005 L5Q Pseudorange = 21540289.869 m l The L5Q Phaserange is a 2's Complement number (as identified by the Range column in Table 149: Secondary Reference Signals Measurement Block on page 716) so it is calculated in the following manner: Phaserange � Pseudorange = 2's Complement(0x00000000010011010100110b) * Scaling Factor Phaserange � 21540289.869 m = 9894 * 0.0001 L5Q Phaserange = 21540290.8584 m l Convert this to ADR to check against the original RANGE log: ADR = Phaserange * Frequency * (-1)/Speed Of Light ADR = 21540290.8584 m * 1176450000 Hz * (-1)/299792458 m/s L5Q ADR for PRN 10 = -84528728.13886692 cycles
In the range logs, PSR and ADR have opposite signs.
l The L5Q Doppler is a 2's Complement number (as identified by the Range column Table 149: Secondary Reference Signals Measurement Block on page 716) so it is calculated in the following manner: Doppler(m/s) � 1st Doppler(m/s) = 2's Complement(0x00000010100001b) x Scaling Factor Doppler(m/s) � (-435.5229 m/s) = 80 x 0.0001 L5Q Doppler(m/s) = -435.5149 m/s Convert the Doppler to Hz: Doppler(Hz) = Doppler(m/s) x Frequency * (-1)/Speed Of Light Doppler(Hz) = -435.5149 m/s x 1176450000 Hz * (-1)/299792458 m/s L5Q Doppler(Hz) for PRN 10 = 1709.054 Hz
This concludes the processing of the signals present for PRN 10.
The next PRN as identified in the GPS Included Signals Field is PRN 15 with 2 signals. Processing of this data would be handled as described above, starting with the 4 bit Measurement Block followed by the individual signals. This would be followed by PRN 18, 21, and 27. Processing these remaining PRNs and their signals would use up the next 870 bits as shown below: Bits required for remaining GPS PRNs and Signals: PRN 15
OEM7 Commands and Logs Reference Manual v10
1073
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
l 4 bits Measurement Block header l 111 bits - 1st Signal l 82 bits - 2nd Signal PRN 18 l 4 bits Measurement Block header l 111 bits - 1st Signal l 82 bits - 2nd Signal PRN 21 l 4 bits Measurement Block header l 111 bits - 1st Signal l 82 bits - 2nd Signal PRN 27 l 4 bits Measurement Block header l 111 bits - 1st Signal l 82 bits - 2nd Signal l 82 bits - 3rd Signal Total = 870 bits There are 2 bits left unprocessed from the last byte of PRN 10's processing so 868 more bits (109 bytes) are required. After processing the remaining GPS data, there will be 4 bits left from the last byte to start off the next system (GLONASS as identified by the GNSS field in the Header). After the last GPS bit, the GLONASS system will then be processed since it was identified as the next system by the GNSS field in the Header.
A.1.8 Reference Satellite and Signal Block: GLONASS
This block is sent once for each bit set to 1 in the GNSS field found in Table 145: Header on page 712. As identified by the above GNSS field, the second system (right to left) is the GLONASS System. Use Table 146: Satellite and Signal Block on page 713 to determine what satellites slots and signals data are contained in this GLONASS System: GLONASS Satellites field (64 bits)
l Grab the next 8 bytes (64 bits) = 0x3f0030080000000020 l Swap the bytes = 0x20000000000830003f l 0x20000000000830003f in binary form =
001000000000000000000000000000000000000000001000001100000000000000111111 l Mask out the used 4 LSBs =
00100000000000000000000000000000000000000000100000110000000000000011XXXX l Determine the required 64 bits =
OEM7 Commands and Logs Reference Manual v10
1074
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
l The 1's above identify that there are 5 tracking GLONASS Slots. l The present GLONASS satellite PRNs/Slot ID's (when between 1 to 24) are therefore (37 +
Slot ID): Slot 1 = PRN 38 Slot 2 = PRN 39 Slot 17 = PRN 54 Slot 18 = PRN 55 Slot 24 = PRN 61
If the GLONASS Slot ID was between 43 and 64, this would represent a GLONASS satellite that has an unknown Slot ID and is instead assigned a temporary one based upon 64 minus the unadjusted GLONASS Frequency Number (0 to 20). This Slot ID will be updated once the actual PRN/Slot ID has been determined.
GLONASS Signals field (16 bits) l Append the next 2 bytes (0x01f0) to the last byte (0x20) = 0x2001f0 l Swap the bytes = 0x0f0120 l 0x0f0120 in binary form = 11110000000100100000 l Ignore the processed bits = 1111000000010010XXXX l Determine the required 16 bits =
l The 1's above identify that there are 2 tracking GLONASS signals: L1CA and L2P. GLONASS Included Signals field (5 Slot ID's x 2 Signals = 10 bits)
l Append the next byte (0x3f) to the last byte (0xf0) = 0xf03f l Swap the bytes = 0x3ff0 l 0x3ff0in binary form = 0011111111110000 l Ignore the processed bits = 001111111111XXXX l Determine the required 10 bits = XX1111111111XXXX l This bit string breaks down into 5 rows (Slots) and 2 columns (signals) as specified by the
OEM7 Commands and Logs Reference Manual v10
1075
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
mxn (Slot IDs x signals) parameters. Take the bit string and break it up into sets of 2 starting at the MSB. This will result with the lowest Slot ID being at the bottom row of the stack and the first signal (L1CA) being the far right column.
11 11 11 11 11 l This stack can be further broken apart to identify the Slot ID's vs. their Signals: SLOT L2P L1CA 24 1 1 18 1 1 17 1 1 2 1 1 1 1 1
A.1.9 Reference Measurement Block Header: GLONASS PRN 38
(Slot 1 which was the first Slot found in the Satellites Field) We will grab enough bytes to process the whole Measurement Block Header. Since this is a GLONASS System, a total of 9 bits will be required for this step (1 bit for the Data Format Flag, 3 bits for the Ref Data Block ID, plus 5 bits for the GLONASS Frequency Number). With 2 bits left unprocessed from the previous byte, we will require 9 � 2 = 7 bits which rounds up to 1 byte:
l Use the last byte (0x3f) plus the next byte (0xa0)= 0x3fa0 l Swap the bytes = 0xa03f l 0xa03f in binary form = 1010000000111111 l Ignore the 6 processed bits from the last step = 1010000000XXXXXX l Ignore the 1 MSB bits leaving 9 bits for processing =
The Data Format Flag identifies that this batch of data is Reference (0) data. The Ref Data Block ID is 0x000. The GLONASS Frequency Number is 8 (adjusted to 1). When calculating the GLONASS Carrier frequency, this value (0 to 20) will be adjusted to its -7 to +13 value and then multiplied by that frequencies delta. Note that this field only appears in the Reference data and will not be found in the Differential data.
OEM7 Commands and Logs Reference Manual v10
1076
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
Special Case: When the Slot ID is between 43 and 63, the Slot ID of the GLONASS satellite is unknown. In order to keep track of which satellite it is for these calculations, the Frequency Number is used to assign this GLONASS Satellite a temporary Slot ID based on the GLONASS Frequency Numbers binary value of 0 to 20.
A.1.10 Reference Primary Signal Measurement Block: GLONASS PRN 38 � L1CA
The next bytes collected will be for the GLONASS PRN 38 - L1CA signal data. This is the primary signal of the satellite since it is the first signal. As a result, its Measurement Block consists of 111 bits as listed in Table 148: Primary Reference Signal Measurement Block on page 715. Since 111 bits takes up a lot of space, these bits will be split into two groups from Table 148: Primary Reference Signal Measurement Block on page 715: the top 25 bits for signal info followed by the bottom 86 bits for signal data. The signal info section (top 25 bits) is processed as follows:
l With 1 bit left unprocessed from the previous byte, we calculate 25 � 1 = 24 bits which equals 3 bytes. Therefore the previous last byte (0xa0) plus the next 3 bytes will be needed. l Use the last byte (0xa0) plus grab 3 bytes (x19f813) = 0xa019f813 l Swap the bytes = 0x13f819a0 l 0x13f819a0 in binary form = 00010011111110000001100110100000 l The previous step used the 7 LSBs = 0001001111111000000110011XXXXXXX l Need 25 bits which is exactly what is left over:
l Parity flag is a 1 (Parity Known)
l � Cycle Slip flag is a 1 (Cycle Slip Present)
l C/No is: 0x10000001100b = 1036 x Scaling factor of 0.05 = 51.80 dBHz
l The Lock Time value is: 0x1111b = 15 which means that this signal has been locked for 262144 ms or more.
l The Pseudorange Std Deviation value is: 0x0011b = 3 which means: 0.045 m < PSR Std Dev <= 0.066 m using Table 155: Pseudorange Std Dev on page 722.
l The ADR Std Deviation value is: 0x0001b = 1 which means: 0.0039 < ADR Std Dev <= 0.0052 cycles using Table 154: ADR Std Dev on page 721.
OEM7 Commands and Logs Reference Manual v10
1077
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
The signal data section (bottom 86 bits) is processed as follows: l With no unprocessed bits from the previous byte, we need 86 bits which rounds up to 11 bytes. l Grab 11 bytes = 0x6a11273649b8fcefab9c43 l Swap the bytes = 0x439cabeffcb8493627116a l 0x439cabeffcb8493627116a in binary form = 0100 0011 1001 1100 1010 1011 1110 1111 1111 1100 1011 1000 0100 1001 0011 0110 0010 0111 0001 0001 0110 1010 l Only need 86 bits. Ignore first 2 MSBs =
l Use Table 148: Primary Reference Signal Measurement Block on page 715 to identify if a 2's Complement Conversion is needed as well as what Scale Factor should be used before these binary numbers are used in the following calculations.
l The 1st (Primary) Pseudorange is processed by: 1st Pseudorange = 0x0100100110110001001110001000101101010b x Scaling Factor 1st Pseudorange = 39563235690 x 0.0005 L1CA Pseudorange for PRN 38 = 19781617.845 m
l The 1st (Primary) Phaserange is a 2's Complement number (as identified by the Range column in Table 148: Primary Reference Signal Measurement Block on page 715) so it is processed in the following manner: 1st Phaserange � 1st Pseudorange = 2's Complement(0x11111111110010111000010b) * Scaling Factor 1st Phaserange � 19781617.845 m = -6718 * 0.0001 L1CA Phaserange = 19781617.1732 m
l Convert this to ADR to check against the original RANGE log: ADR = 1st Phaserange * (Carrier Frequency + Frequency Number * 562500 Hz) * (-1)/Speed Of Light ADR = 19781617.1732 m * (1602000000 Hz + 1 * 562500 Hz) * (-1)/299792458 m/s ADR = 19781617.1732 m * 1602562500 Hz * (-1)/299792458 m/s L1CA ADR for PRN 38 = -105744080.6970745 cycles
In the range logs, PSR and ADR have opposite signs.
l The 1st (Primary) Doppler is a 2's Complement number (as identified by the Range column in Table 148: Primary Reference Signal Measurement Block on page 715) so it is processed in the following manner: 1st Doppler(m/s) = 2's Complement(0x00001110011100101010111110b) x Scaling Factor 1st Doppler(m/s) = 3787454 m/s x 0.0001 L1CA Doppler(m/s) = 378.7454 m/s Convert the Doppler to Hz:
OEM7 Commands and Logs Reference Manual v10
1078
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
1st Doppler(Hz) = 1st Doppler(m/s) x (Carrier Frequency + Frequency Number * 562500 Hz) * (-1)/Speed Of Light 1st Doppler(Hz) = 378.7454 m/s x (1602000000 Hz + 1 * 562500 Hz) * (-1)/299792458 m/s 1st Doppler(Hz) = 378.7454 m/s x 1602562500 Hz * (-1)/299792458 m/s L1CA Doppler(Hz) for PRN 38 = -2024.6112 Hz The rest of the GLONASS Reference Signals are handled in a similar manner as described in the above GPS section.
A.2 Differential Log Decoding
Logs not falling on a whole second are most likely Differential logs which are processed differently than the Reference logs. It is possible for a sub-second RANGECMP4 log to be a Reference log if the data contained within it did not fit the tight Differential Compression requirements. Differential logs use the reference data of the same signal unlike reference logs which uses the first signal to define the other signals. The next RANGECMP4 log is at time 507977.250:
#RANGECMP4A,COM1,0,88.5,FINESTEERING,1919,507977.250,02000020,fb0e, 32768;239,030000421204000000009200dff688831f6102005500e70162dc977c0040 15c07988840f6101803a805921cedf8b80002011207080e5f6351f003804081c2200be 0808005c01620808725f93028057801822dae0476000a00f207180fef6251700e80340 1c62f3bdc8060052013009986f5f22020054004ca2053ec408005401ca870180410000 0000000980ff6306fec408004801de07c8692f5102805180f721b2e04f600040152081 804ef7102500600540202205fe040a0086013a0938780f61020061804e224edbdb6800 2010c0498030f7411d0018047812a2d47d090a004c01a609c8544f62028052006a02 *48E189A2
At the start of the RANGECMP4 log is the identifier for how many bytes are in the log. In this case, there are 239 bytes (just under 20% less than a Reference Log). The rest of the message is compressed binary data and is transmitted as LSB first so the bytes must be swapped before processing.
A.2.1 Differential Header
The Differential Header is sent once per message (See Table 145: Header on page 712). Decoding the bits starting with the first bytes: GNSS field (16 bits)
l Grab the first 2 bytes (16 bits) = 0x0300 l Swap the bytes = 0x0003 l 0x0003 in binary form =
OEM7 Commands and Logs Reference Manual v10
1079
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
In this example the receiver was configured to track only GPS and GLONASS systems. If other systems had been in the configuration and tracked, they would have shown here.
A.2.2 Differential Satellite and Signal Block
This block is sent once for each bit set to 1 in the GNSS field found in Table 145: Header on page 712. As identified by the above GNSS field, the first system (right to left) is the GPS System. Use Table 146: Satellite and Signal Block on page 713 to determine what satellites and signals data are contained in this GPS System: GPS Satellites field (64 bits)
l Grab the next 8 bytes (64 bits) = 0x0042120400000000 l Swap the bytes = 0x...0000000004124200 l 0x0000000004124200 in binary form =
l The 1's above identify that there are 5 tracking GPS PRNs. GPS Signals field (16 bits)
l Grab the next 2 bytes (16 bits) = 0x9200 l Swap the bytes = 0x0092 l 0x0092 in binary form =
l The 1's above identify that there are 3 tracking GPS signals: L1CA, L2Y, and L5Q. GPS Included Signals field (5 PRNs x 3 Signals = 15 bits � therefore need 2 bytes) Up to the point of processing the Included Signals field, the bytes are aligned such that the bits start and end within each batch of bytes. After processing this step, it is quite common for the Included Signals field (mxn matrix) to not be divisible by 8 so bytes not processed will need to be carried over to the next section depending on the size of the matrix.
l Grab the next 2 bytes (16 bits) = 0xdff6 l Swap the bytes = 0xf6df l 0xf6df in binary form = 1111011011011111 l Only need 15 of the 16 bits = X111011011011111 l This bit string breaks down into 5 rows (PRNs) and 3 columns (signals) as specified by the
OEM7 Commands and Logs Reference Manual v10
1080
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
mxn (PRN x signals) parameters. Take the bit string and break it up into sets of 3 starting at the MSB. This will result with the lowest PRN being at the bottom row of the stack and the first signal (L1CA) being the far right column.
111 011 011 011 111
l This stack can be further broken apart to identify the PRNs vs. their Signals:
PRN L5Q L2Y L1CA
27 1
1
1
21 0
1
1
18 0
1
1
15 0
1
1
10 1
1
1
A.2.3 Differential Measurement Block Header
This block is sent once for each bit set to 1 in the Satellites field found in Table 146: Satellite and Signal Block on page 713. Now that the PRN's signals have been determined, the next step is to determine the specifics of the first PRN (10) and its list of signals (L1CA, L2Y, L5Q). Working from bottom right to upper left of the PRN/Signal chart above, each 1 represents a signal for a PRN. Use Table 147: Measurement Block Header on page 714 to determine the contents of each field:
GPS PRN 10 (first PRN found in the Satellites field)
We will grab enough bytes to process the whole Measurement Block Header. If this was a GLONASS system, a total of 9 bits would be required at this step (1 bit for the Data Format Flag, 3 bits for the Ref Data Block ID, plus 5 bits for the GLONASS Frequency Number). Since this is a GPS system, only 4 bits in total are required (1 bit for the Data Format Flag and 3 bits for the Ref Data Block ID).
There was 1 bit not processed in the last byte so that byte will be carried forward. Only 4 bits need to be looked at for this step so grab the next byte as well:
l Use the last byte (0xf6) plus the next byte (0x88)= 0xf688
l Swap the bytes = 0x88f6
l 0x88f6 in binary form = 1000 1000 1111 0110
l Ignore the processed bits from the last step = 1000 1000 1XXX XXXX
l Ignore the 5 MSB bits leaving 4 bits for processing =
The Data Format Flag identifies that this batch of data is Differential (1) data.
The Ref Data Block ID is 0x000. The Ref Data Block ID here identifies that this differential data will be calculated from the Reference data that had a Ref Data Block ID equaling 000 (which was determined in the RANGECMP4 log at time 507977.00 seconds).
OEM7 Commands and Logs Reference Manual v10
1081
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
The 5 MSBs have not been processed so this byte will be carried forward.
Logs between seconds will be Differential logs but could be Reference logs depending on the compression calculations. If a discontinuity occurred that made it impossible for a Differential calculation to fit within the Differential Constraints, it will revert to a Reference log.
A.2.4 Differential Measurement Block
This block is sent once for each bit set to 1 in the Included Signals field found in Table 146: Satellite and Signal Block on page 713. Use Table 150: Primary Differential Signal Measurement Block on page 717 and Table 151: Secondary Differential Signals Measurement Block on page 718 to determine the contents of each field: A Measurement Block for a single PRN will look like the following:
Primary Parity Flag Primary � Cycle Slip Flag Primary C/No Primary Lock Time Primary Pseudorange Std Deviation Primary Phaserange Std Deviation Primary Pseudorange Primary Phaserange - Primary Pseudorange (determines the Phaserange for the 1st Signal) Primary Doppler
2nd Parity Flag 2nd � Cycle Slip Flag 2nd C/No 2nd Lock Time 2nd Pseudorange Std Deviation 2nd Phaserange Std Deviation 2nd Pseudorange - Primary Pseudorange (determines the Pseudorange for the 2nd Signal 2nd Phaserange � 2nd Pseudorange (determines the Phaserange for the 2nd Signal) 2nd Doppler � Primary Doppler (determines the Doppler for the 2nd Signal)
3rd Parity Flag 3rd � Cycle Slip Flag 3rd C/No 3rd Lock Time
OEM7 Commands and Logs Reference Manual v10
1082
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
3rd Pseudorange Std Deviation 3rd Phaserange Std Deviation 3rd Pseudorange - Primary Pseudorange (determines the Pseudorange for the 3rd Signal 3rd Phaserange � 3rd Pseudorange (determines the Phaserange for the 3rd Signal) 3rd Doppler � Primary Doppler (determines the Doppler for the 3rd Signal) ...
A.2.5 Differential Primary Signal Measurement Block GPS PRN 10 � L1CA
The next bytes collected will be for the GPS PRN 10 - L1CA signal data. Since this is the primary signal of the PRN, its Measurement Block consists of 78 bits as listed in Table 150: Primary Differential Signal Measurement Block on page 717. The signal info section (top 25 bits) is processed as follows:
l With 5 bits left from the previous byte, we calculate 25 � 5 = 20 bits which rounds up to 3 bytes. Therefore the previous last byte (0x88) plus the next 3 bytes will be needed. l Use the last byte (0x88) plus grab 3 bytes (x831f61) = 0x88831f61 l Swap the bytes = 0x611f8388 l 0x611f8388 in binary form = 0110 0001 0001 1111 1000 0011 1000 1000 l Only need 25 bits. The last byte uses the 5 MSBs and the first byte ignores the 4 MSBs
l Parity flag is a 1 (Parity Known)
l � Cycle Slip flag is a 0 (Cycle Slip Not Present)
l C/No is: 0x10000011100b = 1052 x Scaling factor of 0.05 = 52.60 dBHz
l The Lock Time value is: 0x1111b = 15 which means that this signal has been locked for 262144 ms or more.
l The Pseudorange Std Deviation value is: 0x0001b = 1 which means: 0.020 m < PSR Std Dev <= 0.030 m using Table 155: Pseudorange Std Dev on page 722.
l The ADR Std Deviation value is: 0x0001b = 1 which means: 0.0039 < ADR Std Dev <= 0.0052 cycles using Table 154: ADR Std Dev on page 721Table 10.
OEM7 Commands and Logs Reference Manual v10
1083
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
l For the following calculations, the time difference between the Differential Log and the Reference log is 0.25 seconds as shown below: Time Difference = Current Log Time � Reference log Time = 507977.250 - 507977.000 = 0.250 seconds
The signal data section (bottom 53 bits) is processed as follows: l With 4 bits unprocessed from the previous byte, we calculate 53 � 4 = 49 bits = 7 bytes (7 bits will not be processed in the last byte). l Use the last byte (0x61) plus grab 7 bytes (0x02005500e70162) = 0x6102005500e70162 l Swap the bytes = 0x6201e70055000261 l 0x6201e70055000261 in binary form = 0110 0010 0000 0001 1110 0111 0000 0000 0101 0101 0000 0000 0000 0010 0110 0001 l Only need 53 bits. Ignore last 4 LSBs and first 7 MSBs =
l Use Table 150: Primary Differential Signal Measurement Block on page 717 to identify if a 2's Complement Conversion is needed as well as what Scale Factor should be used before these binary numbers are used in the following calculations.
l The 1st (Primary) Differential Pseudorange is processed by: Predicted Pseudorange = Reference 1st Pseudorange + (1st Doppler x TimeDifference) = 21540181.930275 m = 21540290.811 m + ((-435.5229 m/s) x 0.250 s) 1st DiffPseudorange � Predicted Pseudorange = 0x0000000000000100110b x Scaling Factor 1st DiffPseudorange � 21540181.930275 m = 38 x 0.0005 L1CA Pseudorange for PRN 10 = 21540181.949275 m
l The 1st (Primary) Differential Phaserange is a 2's Complement number (as identified by the Range column in Table 150: Primary Differential Signal Measurement Block on page 717) so it is processed in the following manner: Predicted Phaserange = Reference 1st DiffPhaserange + (1st Doppler x TimeDifference) = 21540291.5622 m + ((-435.5229 m/s) x 0.250 s) = 21540182.681475 m 1st DiffPhaserange � Predicted Phaserange = 2's Complement(0x0000000010101010b) * Scaling Factor 1st DiffPhaserange � 21540182.681475 m = 170 * 0.0001 L1CA Phaserange = 21540182.698475 m
l Convert this to ADR to check against the original RANGE log: ADR = 1st DifPhaserange * Frequency * (-1)/Speed Of Light ADR = 21540182.698475 m * 1575420000 Hz * (-1)/299792458 m/s L1CA ADR for PRN 10 = -113194424.0799796 cycles
OEM7 Commands and Logs Reference Manual v10
1084
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
In the range logs, PSR and ADR have opposite signs.
l The 1st (Primary) Differential Doppler is a 2's Complement number (as identified by the Range column in Table 150: Primary Differential Signal Measurement Block on page 717) so it is processed in the following manner: 1st DiffDoppler(m/s)- Reference 1st Doppler = 2's Complement(0x000000001111001110b) x Scaling Factor 1st DiffDoppler(m/s) � (-435.5229 m/s) = 974 x 0.0001 L1CA Doppler(m/s) = -435.4255 m/s Convert the Doppler to Hz: 1st DiffDoppler(Hz) = 1st DiffDoppler(m/s) x Frequency * (-1)/Speed Of Light 1st DiffDoppler(Hz) = -435.4255 m/s x 1575420000 Hz * (-1)/299792458 m/s L1CA Doppler(Hz) for PRN 10 = 2288.1764464 Hz
A.2.6 Differential Secondary Signals Measurement Block GPS PRN 10 � L2Y
Unlike Reference logs which always reflect back to the initial signal for their computations, Differential logs uses the last Reference log data of the same signal for its calculations.
l With 7 bits unprocessed from the previous byte, we will require 74 � 7 = 67 bits which rounds up to 9 bytes. l Use the last byte (0x62) plus grab the next 9 bytes (0xdc977c004015c07988) = 0x62dc977c004015c07988 l Swap the bytes = 0x8879c01540007c97dc62 l 0x8879c01540007c97dc62 in binary form = 1000 1000 0111 1001 1100 0000 0001 0101 0100 0000 0000 0000 0111 1100 1001 0111 1101 1100 0110 0010 l Only need 74 bits. The 1 LSB is ignored as it was already processed above and the 5 MSBs are ignored so there is a total of 74 bits to process
l Parity flag is a 1 (Parity Known)
l � Cycle Slip flag is a 0 (Cycle Slip Not Present)
l C/No is: 0x01110001100b = 908 x Scaling Factor of 0.05 = 45.4 dBHz
l The Lock Time value is: 0x1111b = 15 which means that this signal has been locked for 262144 ms or more.
l The Pseudorange Std Deviation value is:
OEM7 Commands and Logs Reference Manual v10
1085
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
0x0101b = 5 which means: 0.099 m < PSR Std Dev <= 0.148 m using Table 155: Pseudorange Std Dev on page 722.
l The ADR Std Deviation value is: 0x0010b = 2 which means: 0.0052 < ADR Std Dev <= 0.0070 cycles using Table 154: ADR Std Dev on page 721.
l The L2Y Pseudorange is a 2's Complement number (as identified by the Range column in Table 151: Secondary Differential Signals Measurement Block on page 718) so it is processed in the following manner:
Predicted Pseudorange = Reference 2nd Pseudorange + (2nd Doppler x TimeDifference) = 21540293.6315 m + ((-435.523 m/s) x 0.250 s) = 21540184.75075 m
DiffPseudorange � Predicted Pseudorange = 2's Complement(0x0000000000000011111b) x Scaling Factor DiffPseudorange � 21540184.75075 m = 31 x 0.0005 L2Y Pseudorange = 21540184.76625 m
l The L2Y Phaserange is a 2's Complement number (as identified by the Range column in Table 151: Secondary Differential Signals Measurement Block on page 718) so it is calculated in the following manner:
Predicted Phaserange = Reference 2nd DiffPhaserange + (2nd Doppler x TimeDifference) = 21540294.399 m + ((-435.523 m/s) x 0.250 s) = 21540185.51825 m
DiffPhaserange � Predicted Phaserange = 2's Complement(0x0000000010101010b) * Scaling Factor DiffPhaserange � 21540185.51825 m = 170 * 0.0001 L2Y Phaserange = 21540185.53525 m
l Convert this to ADR to check against the original RANGE log:
ADR = Phaserange * Frequency * (-1)/Speed Of Light ADR = 21540185.53525 m * 1227600000 Hz * (-1)/299792458 m/s L2Y ADR for PRN 10 = -88203458.95116848 cycles
In the range logs, PSR and ADR have opposite signs.
l The L2Y Doppler is a 2's Complement number (as identified by the Range column in Table 151: Secondary Differential Signals Measurement Block on page 718) so it is calculated in the following manner:
DiffDoppler(m/s) � Ref 2nd Doppler(m/s) = 2's Complement(0x00001111001110b) x Scaling Factor DiffDoppler(m/s) � (-435.5229 m/s) = (974) x 0.0001 L2Y Doppler(m/s) = -435.4255 m/s
Convert the Doppler to Hz:
Doppler(Hz) = Doppler(m/s) x Frequency * (-1)/Speed Of Light Doppler(Hz) = -435.4255 m/s x 1227600000 Hz * (-1)/299792458 m/s L2Y Doppler(Hz) for PRN 10 = 1782.994633 Hz
OEM7 Commands and Logs Reference Manual v10
1086
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
A.2.7 Differential Third Signals Measurement Block GPS PRN 10 � L5Q
Unlike Reference logs which always reflect back to the initial signal for their computations, Differential logs uses the last Reference log data of the same signal for its calculations.
l With 3 bits unprocessed from the previous byte, we will require 74 � 3 = 71 bits which rounds up to 9 bytes. l Use the last byte (0x88) plus grab the next 9 bytes (0x 840f6101803a805921) = 0x88840f6101803a805921 l Swap the bytes = 0x2159803a8001610f8488 l 0x2159803a8001610f8488 in binary form = 0010 0001 0101 1001 1000 0000 0011 1010 1000 0000 0000 0001 0110 0001 0000 1111 1000 0100 1000 1000 l Only need 74 bits. The 3 LSBs are ignored as they were already processed and the 3 MSBs are ignored so there is a total of 74 bits to process
l Parity flag is a 1 (Parity Known)
l � Cycle Slip flag is a 0 (Cycle Slip Not Present)
l C/No is: 0x10000100100b = 1060 x Scaling factor of 0.05 = 53.0 dBHz
l The Lock Time value is: 0x1111b = 15 which means that this signal has been locked for 262144 ms or more.
l The Pseudorange Std Deviation value is: 0x0000b = 0 which means: PSR Std Dev <= 0.020 m using Table 155: Pseudorange Std Dev on page 722.
l The ADR Std Deviation value is: 0x0001b = 1 which means: 0.0039 < ADR Std Dev <= 0.0052 cycles using Table 154: ADR Std Dev on page 721.
l The L5Q Pseudorange is a 2's Complement number (as identified by the Range column in Table 151: Secondary Differential Signals Measurement Block on page 718) so it is processed in the following manner:
Predicted Pseudorange = Reference 3rd Pseudorange + (3rd Doppler x TimeDifference) = 21540289.869 m + ((-435.5149 m/s) x 0.250 s) = 21540180.990275 m
DiffPseudorange � Predicted Pseudorange = 2's Complement(0x000 0000 0000 0001 0110b) x Scaling Factor DiffPseudorange � 21540180.990275 m = 22 x 0.0005 L5Q Pseudorange = 21540181.001275 m
l The L5Q Phaserange is a 2's Complement number (as identified by the Range column in
OEM7 Commands and Logs Reference Manual v10
1087
APPENDIX A Example of Bit Parsing a RANGECMP4 Log
Table 151: Secondary Differential Signals Measurement Block on page 718) so it is calculated in the following manner: Predicted Phaserange = Reference 3rd DiffPhaserange + (3rd Doppler x TimeDifference) = 21540290.8584 m + ((-435.5149 m/s) x 0.250 s) = 21540181.979675 m DiffPhaserange � Predicted Phaserange = 2's Complement(0x0000000001110101b) * Scaling Factor DiffPhaserange � 21540181.979675 m = 117 * 0.0001 L5Q Phaserange = 21540181.991375 m l Convert this to ADR to check against the original RANGE log: ADR = Phaserange * Frequency * (-1)/Speed Of Light ADR = 21540181.991375 m * 1176450000 Hz * (-1)/299792458 m/s L5Q ADR for PRN 10 = -84528300.92127641 cycles
In the range logs, PSR and ADR have opposite signs.
l The L5Q Doppler is a 2's Complement number (as identified by the Range column in Table 151: Secondary Differential Signals Measurement Block on page 718) so it is calculated in the following manner: DiffDoppler(m/s) � Ref 3rd Doppler(m/s) = 2's Complement(0x00001010110011b) x Scaling Factor DiffDoppler(m/s) � (-435.5149 m/s) = 691 x 0.0001 L5Q Doppler(m/s) = -435.4458 m/s Convert this to Hz: Doppler(Hz) = Doppler(m/s) x Frequency * (-1)/Speed Of Light Doppler(Hz) = -435.4458 m/s x 1176450000 Hz * (-1)/299792458 m/s L5Q Doppler(Hz) for PRN 10 = 1708.78285 Hz
This concludes the decoding of the Differential Log for PRN 10 (signals L1CA, L2Y, and L5Q). The rest of the decoding for the other PRNs and systems are handled in the same manner.
OEM7 Commands and Logs Reference Manual v10
1088
OEM7 Commands and Logs Reference Manual v10
1089
