Piksi Multi Settings. 1 Introduction. Firmware Version v1.3.10

Transcription

1 Firmware Version v Introduction Piksi R Multi has a number of settings that can be controlled by the end user via the provided Swift Console or through the SBP binary message protocol. This document serves to enumerate these settings and provide a detailed description of the setting plus any relevant notes. If a setting is listed as Expert in this document, the Show Advanced Settings checkbox must be checked or the command line argument must be passed to the Swift Console in order to see or modify the value. Settings listed as cannot be modified by the user and are available for information only. Version v1.3.10, December 20,

2 2 Settings Table Grouping Name Description acquisition cell modem ethernet ext events 0 ext events 1 ext events 2 frontend imu ndb glonass acquisition enabled qzss acquisition enabled sbas acquisition enabled almanacs enabled bds2 acquisition enabled debug enable device APN modem gateway netmask ip address ip config mode sensitivity edge trigger sensitivity edge trigger sensitivity edge trigger antenna bias antenna selection imu raw output mag raw output mag rate acc range gyro range imu rate erase l2c capb erase utc params erase almanac wn erase almanac erase ephemeris erase iono erase lgf Enable the GLONASS acquisition and raw measurements. Enable the QZSS constellation. Enable the SBAS constellation. Enable the almanac-based acquisition. Enable the bds2 constellation. Additional debug messages for cell modem. None None Access point (provided by cell carrier). The of cell modem in use. The default gateway for the IP config. The netmask for the IP config. The static IP address. Ethernet configuration mode. Minimum time between events (0 = disabled). Select edges to trigger timestamped event capture. Duro only. Minimum time between events (0 = disabled). Duro only. Select edges to trigger timestamped event capture. Duro only. Minimum time between events (0 = disabled). Duro only. Select edges to trigger timestamped event capture. Enable/Disable 4.85V antenna bias. Determines which antenna to use. Enable/Disable IMU raw data output from onboard Bosch BMI160 IMU. Enable/Disable raw data output from onboard Bosch BMM150 Magnetometer. The data rate (in Hz) for magnetometer raw output. The approximate range of accelerations that can be measured. The approximate range of angular rate that can be measured. The data rate (in Hz) for IMU raw output. Erase stored L2C capability mask during boot. Erase stored UTC offset parameters during boot. Erase stored almanac week numbers during boot. Erase stored almanacs during boot. Erase stored ephmerides during boot. Erase stored ionospheric parameters during boot. Erase stored last fix information during boot. Version v1.3.10, December 20,

3 nmea ntrip pps sbp simulator skylark solution valid eph acc valid alm acc lgf update m valid alm days lgf update s gpgga msg rate gpgll msg rate gpgsv msg rate gphdt msg rate gprmc msg rate gpvtg msg rate gsa msg rate gpzda msg rate debug enable url None None Change in position required to update last good fix. Number of days for which Almanac is valid. Update period for navigation database last good fix. Number of Solution Periods between GGA NMEA messages being sent. Number of Solution Periods between GLL NMEA messages being sent. Number of Solution Periods between GSV NMEA messages being sent. Number of Solution Periods between HDT NMEA messages being sent. Number of Solution Periods between RMC NMEA messages being sent. Number of Solution Periods between VTG NMEA messages being sent. Number of Solution Periods between GSA NMEA messages being sent. Number of Solution Periods between ZDA NMEA messages being sent. Additional debug messages for NTRIP (sent to /var/log/messages). Enable NTRIP client. NTRIP URL to use. frequency Generate a pulse with the given frequency (maximum = 20 Hz). polarity Logic level on output pin when the PPS is active. width Number of microseconds the PPS will remain active (allowed range from 1 to us). offset Offset in microseconds between GPS time and the PPS. obs msg max size mode mask radius base ecef x base ecef y base ecef z speed phase sigma pseudorange sigma cn0 sigma speed sigma pos sigma num sats enabled enable url dgnss filter disable klobuchar correction glonass measurement std downweight factor enable glonass Determines the maximum message length for raw observation sbp messages. Determines the s of position outputs for the simulator. Radius of the circle around which the simulated receiver will move. Simulated base station position. Simulated base station position. Simulated base station position. Simulated tangential speed of the receiver. Standard deviation of noise added to the simulated carrier phase. Standard deviation of noise added to the simulated pseudo range. Standard deviation of noise added to the simulated signal to noise. ratio Standard deviation of noise addition to simulated tangential speed. Standard deviation of simulated single point position. The number of satellites for the simulator. Toggles the receiver internal simulator on and off. Enable Skylark client. Skylark URL to use. Determines the of carrier phase ambiguity resolution that the receiver will attempt to achieve. Disable Klobuchar ionospheric corrections. Down weights GLONASS measurements by a given factor in the navigation filter. Enable GLONASS measurement processing in the navigation filter. Version v1.3.10, December 20,

4 send heading Enables SBP heading output. Heading is calculated from base station to rover and represents the inverse tangent of the north and east components of the baseline. standalone logging surveyed position system info system monitor tcp client0 tcp client1 output every n obs disable raim heading offset elevation mask dgnss solution mode soln freq correction age max file duration max fill enable output directory broadcast surveyed alt surveyed lat surveyed lon firmware version firmware build id hw revision hw version nap channels mac address sbp sender id uuid serial number nap build date loader build date pfwp build date nap build id loader build id pfwp build id firmware build date watchdog spectrum analyzer heartbeat period milliseconds Integer divisor of solution frequency for which the observations will be output. Receiver Autonomous Integrity Monitoring. Rotate the heading output. SPP / RTK solution elevation mask. Selects the of RTK solution to output. The frequency at which a position solution is computed. The maximum age of corrections for which an RTK solution will be generated. Duration of each logfile. Maximum storage device usage. Standalone logging enabled. Standalone logging path. Broadcast surveyed base station position. Surveyed altitude of the antenna. Surveyed latitude of the antenna. Surveyed longitude of the antenna. Firmware version of the receiver. Full build id for firmware version. Hardware revision of the receiver. Hardware version number. Number of channels in SwiftNap FPGA. The MAC address of the receiver. The SBP sender ID for any messages sent by the device. The UUID of the receiver. The serial number of the receiver. build date for SwiftNap FPGA bitstream. build date for boot loader (uboot). build date for real-time GNSS firmware (piksi firmware). build id for SwiftNap FPGA bitstream. build id for loader (uboot). build id for real-time GNSS firmware (piksi firmware). firmware build date. Enable hardware watchdog timer to reset the receiver if it locks up for. any reason Enable spectrum analyzer. Period for sending the SBP HEARTBEAT messages. enabled sbp messages Configure which messages should be sent on the port. address IP address and port for TCP client 0 to connect to. mode Communication protocol for TCP client 0. enabled sbp messages Configure which messages should be sent on the port. address IP address and port for TCP client 1 to connect to. mode Communication protocol for TCP client 1. Version v1.3.10, December 20,

5 tcp server0 tcp server1 track uart0 uart1 udp client0 udp client1 udp server0 udp server1 usb0 enabled sbp messages Configure which messages should be sent on the port. port Port for TCP server 0. mode Communication protocol for TCP server 0. enabled sbp messages Configure which messages should be sent on the port. port Port for TCP server 1. mode Communication protocol for TCP server 1. send trk detailed max pll integration time ms iq output mask elevation mask send detailed tracking state message. Controls maximum possible integration time for a measurement. Output raw I/Q correlations. Tracking elevation mask. enabled sbp messages Configure which messages should be sent on the port. mode Communication protocol for UART0. flow control Enable hardware flow control (RTS/CTS). baudrate The Baud rate for the UART 0. enabled sbp messages Configure which messages should be sent on the port. mode Communication protocol for UART 1. flow control Enable hardware flow control (RTS/CTS). baudrate The Baud rate for the UART 1. enabled sbp messages Configure which messages should be sent on the port. address IP address for UDP client 0. mode Communication protocol for UDP client 0. enabled sbp messages Configure which messages should be sent on the port. address IP address for UDP client 1. mode Communication protocol for UDP client 1. enabled sbp messages Configure which messages should be sent on the port. port Port for UDP server 0. mode Communication protocol for UDP server 0. enabled sbp messages Configure which messages should be sent on the port. port Port for UDP server 1. mode Communication protocol for UDP server 1. enabled sbp messages mode Configure which messages should be sent on the port. Communication protocol for USB0. Table 2.0.1: Summary of message s Version v1.3.10, December 20,

6 3 Settings Detail 3.1 acquisition glonass acquisition enabled Description: Enable the GLONASS acquisition and raw measurements. acquisition glonass acquisition enabled boolean, Table 3.1.1: glonass acquisition enabled Notes: This is a precondition for navigation with GLONASS qzss acquisition enabled Description: Enable the QZSS constellation. acquisition qzss acquisition enabled boolean, Table 3.1.2: qzss acquisition enabled Notes: None sbas acquisition enabled Description: Enable the SBAS constellation. Version v1.3.10, December 20,

7 acquisition sbas acquisition enabled boolean, Table 3.1.3: sbas acquisition enabled Notes: None almanacs enabled Description: Enable the almanac-based acquisition. acquisition almanacs enabled boolean, Table 3.1.4: almanacs enabled Notes: None bds2 acquisition enabled Description: Enable the bds2 constellation. acquisition bds2 acquisition enabled boolean, Table 3.1.5: bds2 acquisition enabled Version v1.3.10, December 20,

8 Notes: None 3.2 cell modem debug Description: Additional debug messages for cell modem. cell modem debug boolean Table 3.2.1: debug enable Description: None cell modem enable boolean Table 3.2.2: enable device Description: None Version v1.3.10, December 20,

9 cell modem device ttyacm0 Table 3.2.3: device APN Description: Access point (provided by cell carrier). cell modem APN INTERNET Table 3.2.4: APN modem Description: The of cell modem in use. cell modem modem GSM enum GSM,CDMA Table 3.2.5: modem Version v1.3.10, December 20,

10 3.3 ethernet gateway Description: The default gateway for the IP config. ethernet gateway Table 3.3.1: gateway Notes: The configured gateway in XXX.XXX.XXX.XXX format netmask Description: The netmask for the IP config. ethernet netmask Table 3.3.2: netmask Notes: The configured netmask in XXX.XXX.XXX.XXX format ip address Description: The static IP address. Version v1.3.10, December 20,

11 ethernet ip address Table 3.3.3: ip address Notes: The configured IP address in XXX.XXX.XXX.XXX format ip config mode Description: Ethernet configuration mode. ethernet ip config mode Static enum Static,DHCP Table 3.3.4: ip config mode Notes: If DHCP is chosen the IP address will be assigned automatically. The DHCP assigned IP address cannot be viewed under the Settings tab, instead use the Advanced Tab and click on Refresh Network Status. 3.4 ext events sensitivity Description: Minimum time between events (0 = disabled). Version v1.3.10, December 20,

12 ext events 0 sensitivity us (microseconds) 0 integer None Table 3.4.1: sensitivity Notes: Any event that is triggered within the sensitivity window after the previous event will be ignored and no MSG EXT EVENT will be generated edge trigger Description: Select edges to trigger timestamped event capture. ext events 0 edge trigger None enum None,Rising,Falling,Both Table 3.4.2: edge trigger Notes: You can use this to record the exact time that some external event in your system occurred, e.g. camera shutter time. Upon detecting the event, receiver will generate a MSG EXT EVENT message reporting the event, including a timestamp accurate to better than a microsecond. 3.5 ext events sensitivity Description: Duro only. Minimum time between events (0 = disabled). Version v1.3.10, December 20,

13 ext events 1 sensitivity us (microseconds) 0 integer None Table 3.5.1: sensitivity Notes: Any event that is triggered within the sensitivity window after the previous event will be ignored and no MSG EXT EVENT will be generated edge trigger Description: Duro only. Select edges to trigger timestamped event capture. ext events 1 edge trigger None enum None,Rising,Falling,Both Table 3.5.2: edge trigger Notes: You can use this to record the exact time that some external event in your system occurred, e.g. camera shutter time. Upon detecting the event, receiver will generate a MSG EXT EVENT message reporting the event, including a timestamp accurate to better than a microsecond. 3.6 ext events sensitivity Description: Duro only. Minimum time between events (0 = disabled). Version v1.3.10, December 20,

14 ext events 2 sensitivity us (microseconds) 0 integer None Table 3.6.1: sensitivity Notes: Any event that is triggered within the sensitivity window after the previous event will be ignored and no MSG EXT EVENT will be generated edge trigger Description: Duro only. Select edges to trigger timestamped event capture. ext events 2 edge trigger None enum None,Rising,Falling,Both Table 3.6.2: edge trigger Notes: You can use this to record the exact time that some external event in your system occurred, e.g. camera shutter time. Upon detecting the event, receiver will generate a MSG EXT EVENT message reporting the event, including a timestamp accurate to better than a microsecond. 3.7 frontend antenna bias Description: Enable/Disable 4.85V antenna bias. Version v1.3.10, December 20,

15 frontend antenna bias bool Table 3.7.1: antenna bias Notes: Most active antennas require an antenna bias in order to power the amplifier in the antenna antenna selection Description: Determines which antenna to use. frontend antenna selection Primary enum Primary,Secondary Table 3.7.2: antenna selection Notes: This setting selects the antenna input that should be used by the receiver. Piksi Multi boards and Duro ship with only a Primary antenna connector, so this should always be set to Primary. 3.8 imu imu raw output Description: Enable/Disable IMU raw data output from onboard Bosch BMI160 IMU. imu imu raw output boolean Table 3.8.1: imu raw output Version v1.3.10, December 20,

16 Notes: The IMU raw data can be seen in the Advanced Tab of the Swift Console mag raw output Description: Enable/Disable raw data output from onboard Bosch BMM150 Magnetometer. imu mag raw output boolean Table 3.8.2: mag raw output Notes: The magnetometer raw data can be seen in the Advanced Tab of the Swift Console mag rate Description: The data rate (in Hz) for magnetometer raw output. imu mag rate Hz 12.5 enum 6.25, 12.5, 25 Table 3.8.3: mag rate acc range Description: The approximate range of accelerations that can be measured. Version v1.3.10, December 20,

17 imu acc range g 8 enum 2, 4, 8, 16 Table 3.8.4: acc range Notes: When 2 g is chosen, it means the accelerometer is scaled to measure about +/- 2 g of acceleration. Refer to the IMU datasheet for detailed information gyro range Description: The approximate range of angular rate that can be measured. imu gyro range deg/s 1000 enum 125, 250, 500, 1000, 2000 Table 3.8.5: gyro range Notes: When 125 is chosen, it means the gyro is scaled to measure about +/- 125 deg/s of angular rate. Refer to the IMU datasheet for detailed information imu rate Description: The data rate (in Hz) for IMU raw output. Version v1.3.10, December 20,

18 imu imu rate Hz 50 enum 25, 50, 100, 200 Table 3.8.6: imu rate Notes: It is recommended to use Ethernet or USB for IMU data output for data rates over 25 Hz. 3.9 ndb erase l2c capb Description: Erase stored L2C capability mask during boot. ndb erase l2c capb boolean Table 3.9.1: erase l2c capb erase utc params Description: Erase stored UTC offset parameters during boot. ndb erase utc params boolean Table 3.9.2: erase utc params Version v1.3.10, December 20,

19 3.9.3 erase almanac wn Description: Erase stored almanac week numbers during boot. ndb erase almanac wn boolean Table 3.9.3: erase almanac wn erase almanac Description: Erase stored almanacs during boot. ndb erase almanac boolean Table 3.9.4: erase almanac erase ephemeris Description: Erase stored ephmerides during boot. ndb erase ephemeris boolean Table 3.9.5: erase ephemeris Version v1.3.10, December 20,

20 3.9.6 erase iono Description: Erase stored ionospheric parameters during boot. ndb erase iono boolean Table 3.9.6: erase iono erase lgf Description: Erase stored last fix information during boot. ndb erase lgf boolean Table 3.9.7: erase lgf valid eph acc Description: None ndb valid eph acc meters 100 int Table 3.9.8: valid eph acc Version v1.3.10, December 20,

21 3.9.9 valid alm acc Description: None ndb valid alm acc meters 5000 int Table 3.9.9: valid alm acc lgf update m Description: Change in position required to update last good fix. ndb lgf update m meters int Table : lgf update m valid alm days Description: Number of days for which Almanac is valid. ndb valid alm days days 6 int Table : valid alm days Version v1.3.10, December 20,

22 lgf update s Description: Update period for navigation database last good fix. ndb lgf update s seconds 1800 int Table : lgf update s 3.10 nmea gpgga msg rate Description: Number of Solution Periods between GGA NMEA messages being sent. nmea gpgga msg rate Solution Period 1 integer Table : gpgga msg rate Notes: This setting represents the integer number of solution periods between each transmission of the NMEA message. For example, if the solution rate is 10 Hz, and this rate setting is 2, the NMEA message will be sent every two solution epochs at a rate of 5 Hz. If this setting is 0, the msg will be suppressed gpgll msg rate Description: Number of Solution Periods between GLL NMEA messages being sent. Version v1.3.10, December 20,

23 nmea gpgll msg rate Solution Period 10 integer Table : gpgll msg rate Notes: This setting represents the integer number of solution periods between each transmission of the NMEA message. For example, if the solution rate is 10 Hz, and this rate setting is 2, the NMEA message will be sent every two solution epochs at a rate of 5 Hz. If this setting is 0, the msg will be suppressed gpgsv msg rate Description: Number of Solution Periods between GSV NMEA messages being sent. nmea gpgsv msg rate Solution Period 10 integer Table : gpgsv msg rate Notes: This setting represents the integer number of solution periods between each transmission of the NMEA message. For example, if the solution rate is 10 Hz, and this rate setting is 2, the NMEA message will be sent every two solution epochs at a rate of 5 Hz. If this setting is 0, the msg will be suppressed gphdt msg rate Description: Number of Solution Periods between HDT NMEA messages being sent. Version v1.3.10, December 20,

24 nmea gphdt msg rate Solution Period 1 integer Table : gphdt msg rate Notes: This setting represents the integer number of solution periods between each transmission of the NMEA message. For example, if the solution rate is 10 Hz, and this rate setting is 2, the NMEA message will be sent every two solution epochs at a rate of 5 Hz. If this setting is 0, the msg will be suppressed gprmc msg rate Description: Number of Solution Periods between RMC NMEA messages being sent. nmea gprmc msg rate Solution Period 10 integer Table : gprmc msg rate Notes: This setting represents the integer number of solution periods between each transmission of the NMEA message. For example, if the solution rate is 10 Hz, and this rate setting is 2, the NMEA message will be sent every two solution epochs at a rate of 5 Hz. If this setting is 0, the msg will be suppressed gpvtg msg rate Description: Number of Solution Periods between VTG NMEA messages being sent. Version v1.3.10, December 20,

25 nmea gpvtg msg rate Solution Period 1 integer Table : gpvtg msg rate Notes: This setting represents the integer number of solution periods between each transmission of the NMEA message. For example, if the solution rate is 10 Hz, and this rate setting is 2, the NMEA message will be sent every two solution epochs at a rate of 5 Hz. If this setting is 0, the msg will be suppressed gsa msg rate Description: Number of Solution Periods between GSA NMEA messages being sent. nmea gsa msg rate Solution Periods 10 integer None Table : gsa msg rate Notes: This setting represents the integer number of solution periods between each transmission of the NMEA message. For example, if the solution rate is 10 Hz, and this rate setting is 2, the NMEA message will be sent every two solution epochs at a rate of 5 Hz. If this setting is 0, the msg will be suppressed gpzda msg rate Description: Number of Solution Periods between ZDA NMEA messages being sent. Version v1.3.10, December 20,

26 nmea gpzda msg rate Solution Period 10 integer None Table : gpzda msg rate Notes: This setting represents the integer number of solution periods between each transmission of the NMEA message. For example, if the solution rate is 10 Hz, and this rate setting is 2, the NMEA message will be sent every two solution epochs at a rate of 5 Hz. If this setting is 0, the msg will be suppressed ntrip debug Description: Additional debug messages for NTRIP (sent to /var/log/messages). ntrip debug boolean Table : debug enable Description: Enable NTRIP client. Version v1.3.10, December 20,

27 ntrip enable boolean, Table : enable Notes: If, NTRIP client will be used url Description: NTRIP URL to use. ntrip url None Table : url Notes: URL to use with NTRIP client. NTRIP must be enabled to use this setting. URLs should be HTTP URLs with optional credentials, a port, and a mountpoint path such as user:password@example.com:2101/baz RTCM3 or example.com:2101/baz RTCM pps frequency Description: Generate a pulse with the given frequency (maximum = 20 Hz). Version v1.3.10, December 20,

28 pps frequency Hz 1.0 double None Table : frequency Notes: None polarity Description: Logic level on output pin when the PPS is active. pps polarity Logic Level 1 integer 0, 1 Notes: None Table : polarity width Description: Number of microseconds the PPS will remain active (allowed range from 1 to us). pps width us (microseconds) integer None Table : width Version v1.3.10, December 20,

29 Notes: None offset Description: Offset in microseconds between GPS time and the PPS. pps offset us (microseconds) 0 integer None Table : offset Notes: None 3.13 sbp obs msg max size Description: Determines the maximum message length for raw observation sbp messages. sbp obs msg max size bytes 255 integer None Table : obs msg max size Notes: This parameter is useful for tuning observation messages for compatibility with radio modems. Some serial modems will internally split serial packets for their protocol and this parameter allows the size of the message to be reduced as to prevent the modem from sending multiple packets. If the parameter exceeds 255 bytes (the maximum size of an SBP message), the receiver firmware will ignore the parameter and use 255 bytes. If the parameter is set smaller than the size of one observation, the firmware will ignore the parameter and use the size of one observation as the maximum message size simulator mode mask Description: Determines the s of position outputs for the simulator. Version v1.3.10, December 20,

30 simulator mode mask 15(decimal), 0xF (hexadecimal) packed bitfield None Table : mode mask Notes: bit 0 (decimal value 1) turns on single point position PVT simulated outputs bit 1 (decimal value 2) turns on the satellite tracking simulated outputs bit 2 (decimal value 4) turns on Float IAR simulated RTK outputs bit 3 (decimal value 8) turns on Fixed IAR simulated RTK outputs radius Description: Radius of the circle around which the simulated receiver will move. simulator radius meters 100 double None Table : radius Notes: None base ecef x Description: Simulated base station position. Version v1.3.10, December 20,

31 simulator base ecef x meters double None Table : base ecef x Notes: Earth Centered Earth Fixed (ECEF) x position of the simulated base station base ecef y Description: Simulated base station position. simulator base ecef y meters double None Table : base ecef y Notes: Earth Centered Earth Fixed (ECEF) y position of the simulated base station base ecef z Description: Simulated base station position. simulator base ecef z meters double None Table : base ecef z Version v1.3.10, December 20,

32 Notes: Earth Centered Earth Fixed (ECEF) z position of the simulated base station speed Description: Simulated tangential speed of the receiver. simulator speed m/s 4 double None Table : speed Notes: None phase sigma Description: Standard deviation of noise added to the simulated carrier phase. simulator phase sigma cycles 0.03 double None Table : phase sigma Notes: None pseudorange sigma Description: Standard deviation of noise added to the simulated pseudo range. Version v1.3.10, December 20,

33 simulator pseudorange sigma meters 4 double None Table : pseudorange sigma Notes: None cn0 sigma Description: Standard deviation of noise added to the simulated signal to noise. ratio simulator cn0 sigma dbm-hz 0.3 double None Table : cn0 sigma Notes: None speed sigma Description: Standard deviation of noise addition to simulated tangential speed. simulator speed sigma meters 2 /s double None Table : speed sigma Version v1.3.10, December 20,

34 Notes: None pos sigma Description: Standard deviation of simulated single point position. simulator pos sigma meters double None Table : pos sigma Notes: None num sats Description: The number of satellites for the simulator. simulator num sats 9 integer None Table : num sats Notes: None enabled Description: Toggles the receiver internal simulator on and off. Version v1.3.10, December 20,

35 simulator enabled boolean, Table : enabled Notes: The simulator will provide simulated outputs of a stationary base station and the Local receiver moving in a circle around the base station. The simulator is intended to aid in system integration by providing realistic looking outputs but does not faithfully simulate every aspect of device operation skylark enable Description: Enable Skylark client. skylark enable boolean, Table : enable Notes: If, Skyark client will be used url Description: Skylark URL to use. Version v1.3.10, December 20,

36 skylark url None Table : url Notes: URL to use with Skylark client. Skylark must be enabled to use this setting solution dgnss filter Description: Determines the of carrier phase ambiguity resolution that the receiver will attempt to achieve. solution dgnss filter Fixed enum Fixed,Float Table : dgnss filter Notes: If fixed, the receiver will output a integer fixed ambiguity estimate. If no fixed solution is available, it will revert to the float solution. If float, the device will only output the float ambiguity estimate. This settings is not used by Piksi Multi and Duro disable klobuchar correction Description: Disable Klobuchar ionospheric corrections. Version v1.3.10, December 20,

37 solution disable klobuchar correction boolean, Table : disable klobuchar correction Notes: If, Klobuchar ionospheric corrections will not be applied glonass measurement std downweight factor Description: Down weights GLONASS measurements by a given factor in the navigation filter. solution glonass measurement std downweight factor 4.0 float None Table : glonass measurement std downweight factor Notes: This parameter down weights GLONASS observations relative to GPS observations by this factor enable glonass Description: Enable GLONASS measurement processing in the navigation filter. solution enable glonass boolean, Table : enable glonass Version v1.3.10, December 20,

38 Notes: If set to, GLONASS measurements are processed in the navigation filter for SPP and RTK send heading Description: Enables SBP heading output. Heading is calculated from base station to rover and represents the inverse tangent of the north and east components of the baseline. solution send heading boolean, Table : send heading Notes: No smoothing or additional processing is provided to improve heading output. The heading feature requires the following additional settings Time Matched Mode Equal Observation rate between both base and rover The observation rate will also determine the heading output rate and is defined as soln freq / output every n obs output every n obs Description: Integer divisor of solution frequency for which the observations will be output. solution output every n obs 2 integer None Table : output every n obs Notes: For instance, if the solution frequency (soln freq) is 10 Hz, and the output every n obs setting is 10, it means that the observation output will occur at a rate of 1 Hz. This parameter is designed to tune the rate at which correction information is passed from one receiver to the other as to efficiently use radio modem bandwidth and fit with user applications. Version v1.3.10, December 20,

39 disable raim Description: Receiver Autonomous Integrity Monitoring. solution disable raim None boolean, Table : disable raim Notes: If, RAIM checks will not be performed heading offset Description: Rotate the heading output. solution heading offset degrees 0.0 double Table : heading offset Notes: Adds an offset to the heading output to rotate the heading vector to align the baseline heading with a desired 0 heading. Valid values are to degrees elevation mask Description: SPP / RTK solution elevation mask. Version v1.3.10, December 20,

40 solution elevation mask degrees 10 float None Table : elevation mask Notes: Satellites must be above the horizon by at least this angle before they will be used in a solution dgnss solution mode Description: Selects the of RTK solution to output. solution dgnss solution mode Low Latency enum Low Latency, Time Matched, No DGNSS Table : dgnss solution mode Notes: A Low Latency solution uses an internal model of anticipated satellite observations to provide RTK output with minimal latency but slightly reduced accuracy. Low Latency mode assumes that the base station is stationary. For applications where accuracy is desired over timeliness or when both receivers are moving, Time Matched mode should be chosen. This means that the RTK output will require a corresponding set of correction observations for each timestamp. When No DGNSS is chosen, no differential output will be attempted by the receiver soln freq Description: The frequency at which a position solution is computed. Version v1.3.10, December 20,

41 solution soln freq Hz 10 integer None Table : soln freq Notes: None correction age max Description: The maximum age of corrections for which an RTK solution will be generated. solution correction age max seconds 30 float None Notes: None 3.17 standalone logging file duration Description: Duration of each logfile. Table : correction age max standalone logging file duration minutes 10 int Table : file duration Version v1.3.10, December 20,

42 Notes: Sets the number of minutes to output to each standalone log file before opening the next one. If this setting is changed while logging is enabled, it will go into effect immediately which will close the current file if its length exceeds the new duration max fill Description: Maximum storage device usage. standalone logging max fill percent 95 int Table : max fill Notes: Sets a limit on how full the storage device can be before logging is stopped. If the drive is more than this percent full, no new log files will be created and a warning will be logged every 30 seconds. If this setting is changed while logging is enabled, it will go into effect on the next file that is created enable Description: Standalone logging enabled. standalone logging enable boolean Table : enable Notes: Setting this to true triggers the logger to start trying to write logs to the output directory. Setting this to false will immediately close the current file and stop logging. Reenabling logging will increment the session counter which is reflected in the log file s (see USB Logging File Output section) output directory Description: Standalone logging path. Version v1.3.10, December 20,

43 standalone logging output directory /media/sda1/ Table : output directory Notes: Sets the paths in which to write logs. A warning will be logged every 30 seconds if this path is invalid or unavailable. The system will not create a folder that does not exist. If this setting is changed while logging is enabled, it will go into effect on the next file that is created surveyed position broadcast Description: Broadcast surveyed base station position. surveyed position broadcast None boolean, Table : broadcast Notes: This flag ultimately determines whether the SBP message with identifier MSG BASE POS ECEF will be calculated and sent. Logically, setting this attribute to true sets the Local receiver as a base station and configures the unit to send its surveyed position coordinates to the other receiver(s) with which the base station is communicating. If true, the remote receiver that receives the surveyed position will calculate and communicate a pseudo absolute RTK position based upon the received position surveyed alt Description: Surveyed altitude of the antenna. Version v1.3.10, December 20,

44 surveyed position surveyed alt meters 0 Double None Table : surveyed alt Notes: This setting represents the altitude of the receiver s antenna above the WGS84 ellipsoid, in meters. If surveyed position broadcast is set to true, this coordinate will be communicated to remote receivers for use in calculating their pseudo-absolute position. This value should be precise to 1 cm. Any errors in the surveyed position will directly affect the pseudo-absolute RTK position measurement reported by the Rover surveyed lat Description: Surveyed latitude of the antenna. surveyed position surveyed lat degrees 0 Double None Table : surveyed lat Notes: This setting represents the latitude of the local receiver s antenna, expressed in decimal degrees relative to the equator (north = positive, south = negative). If surveyed position broadcast is set to true, the coordinate will be communicated to remote receivers for use in calculating their pseudo-absolute RTK position. The value should be as accurate as possible and should have precision to at least 7 digits following the decimal point. For reference, 1e-7 degrees of latitude is about 1.1 cm on the surface of the earth. Any errors in the surveyed position will directly affect the pseudo-absolute RTK position measurement reported by the remote receiver surveyed lon Description: Surveyed longitude of the antenna. Version v1.3.10, December 20,

45 surveyed position surveyed lon degrees 0 Double None Table : surveyed lon Notes: This setting represents the longitude of the local receiver s antenna, expressed in decimal degrees relative to the Prime Meridian (east = positive, west = negative). If surveyed position broadcast is set to true, the coordinate will be communicated to remote receivers for use in calculating their pseudo-absolute RTK position. The value should be as accurate as possible and should have precision to at least 7 digits following the decimal point. For reference, 1e-7 degrees of longitude at 35 degree latitude is about 1 cm. Any errors in the surveyed position will directly affect the pseudo-absolute RTK position measurement reported by the remote receiver system info firmware version Description: Firmware version of the receiver. system info firmware version None Table : firmware version Notes: The git hash is removed from this version identifier. This is a read only setting firmware build id Description: Full build id for firmware version. Version v1.3.10, December 20,

46 system info firmware build id None Table : firmware build id Notes: For user generated images, this will appear the same as the command git describe dirty. This is a read only setting hw revision Description: Hardware revision of the receiver. system info hw revision None Table : hw revision Notes: This is a read only setting that refers to the product family of the hardware hw version Description: Hardware version number. Version v1.3.10, December 20,

47 system info hw version None Table : hw version Notes: This is a read only setting that corresponds to the version number printed on the oem module hardware version sticker nap channels Description: Number of channels in SwiftNap FPGA. system info nap channels 40 None Table : nap channels Notes: This is a read only setting mac address Description: The MAC address of the receiver. Version v1.3.10, December 20,

48 system info mac address None Table : mac address Notes: This is a read only setting sbp sender id Description: The SBP sender ID for any messages sent by the device. system info sbp sender id None Table : sbp sender id Notes: ID value is equal to the lower 16 bits of the UUID. This is a read only setting uuid Description: The UUID of the receiver. system info uuid None Table : uuid Version v1.3.10, December 20,

49 Notes: The UUID is a Universally Unique IDentifier for this receiver. The lower 16 bits of the UUID are used for the SBP Sender ID. This is a read only setting serial number Description: The serial number of the receiver. system info serial number integer None Table : serial number Notes: This number should match the number on the barcode on the board and cannot be modified nap build date Description: build date for SwiftNap FPGA bitstream. system info nap build date None Table : nap build date Notes: This is a read only setting loader build date Description: build date for boot loader (uboot). Version v1.3.10, December 20,

50 system info loader build date None Table : loader build date Notes: This is a read only setting pfwp build date Description: build date for real-time GNSS firmware (piksi firmware). system info pfwp build date None Table : pfwp build date Notes: This is a read only setting nap build id Description: build id for SwiftNap FPGA bitstream. system info nap build id None Table : nap build id Version v1.3.10, December 20,

51 Notes: This is a read only setting loader build id Description: build id for loader (uboot). system info loader build id None Table : loader build id Notes: This is a read only setting pfwp build id Description: build id for real-time GNSS firmware (piksi firmware). system info pfwp build id None Table : pfwp build id Notes: This is a read only setting firmware build date Description: firmware build date. Version v1.3.10, December 20,

52 system info firmware build date None Table : firmware build date Notes: This is a read only setting system monitor watchdog Description: Enable hardware watchdog timer to reset the receiver if it locks up for. any reason system monitor watchdog boolean, Table : watchdog Notes: You must reset the receiver for this change to take effect spectrum analyzer Description: Enable spectrum analyzer. system monitor spectrum analyzer boolean, Table : spectrum analyzer Version v1.3.10, December 20,

53 Notes: This setting enables the on-device spectrum analyzer and associated SBP output. The spectrum analyzer is available from the Advanced tab of the console heartbeat period milliseconds Description: Period for sending the SBP HEARTBEAT messages. system monitor heartbeat period milliseconds ms 1000 integer None Table : heartbeat period milliseconds Notes: None 3.21 tcp client enabled sbp messages Description: Configure which messages should be sent on the port. tcp client0 enabled sbp messages blank - all messages are enabled Table : enabled sbp messages Notes: The enabled sbp messages settings is a list of message s and rate divisors that will be sent out of the interface. If left blank, all messages will be sent. If not blank, a comma separated list of SBP message IDs in base 10 integer format should be provided. Optionally, a divisor can be specified after the / character for each id. For example, an entry of 3456/10 would provide message with ID 3456 at 1/10th the normal rate. For Ethernet, the is optimal for logging and communication with the console address Description: IP address and port for TCP client 0 to connect to. Version v1.3.10, December 20,

54 tcp client0 address Table : address Notes: The address setting is defined according to the convention host:port. For example, it should match the format :55555 or xxxxx.net: mode Description: Communication protocol for TCP client 0. tcp client0 mode Disabled enum SBP,NMEA OUT,RTCMv3 IN Table : mode Notes: SBP configures the interface to transmit messages specified in the enabled sbp messages setting and to receive incoming SBP messages. If the mode is changed from SBP the console will no longer be able to communicate over the interface. NMEA OUT configures the interface to transmit the GGA, RMC, GGL, VTG, ZDA, GSA, and GSV NMEA 0183 messages. The interface will not receive incoming messages. RTCMv3.1 IN configures the interface to receive RTK corrections in RTCM format. The interface will receive 1002, 1004, 1005, 1006, 1010, and 1012 RTCMv3.1 messages and will not transmit or receive any other messages tcp client enabled sbp messages Description: Configure which messages should be sent on the port. Version v1.3.10, December 20,

55 tcp client1 enabled sbp messages blank - all messages are enabled Table : enabled sbp messages Notes: The enabled sbp messages settings is a list of message s and rate divisors that will be sent out of the interface. If left blank, all messages will be sent. If not blank, a comma separated list of SBP message IDs in base 10 integer format should be provided. Optionally, a divisor can be specified after the / character for each id. For example, an entry of 3456/10 would provide message with ID 3456 at 1/10th the normal rate. For Ethernet, the is optimal for logging and communication with the console address Description: IP address and port for TCP client 1 to connect to. tcp client1 address Table : address Notes: The address setting is defined according to the convention host:port. For example, it should match the format :55555 or xxxxx.net: mode Description: Communication protocol for TCP client 1. Version v1.3.10, December 20,

56 tcp client1 mode Disabled enum SBP,NMEA OUT,RTCMv3 IN Table : mode Notes: SBP configures the interface to transmit messages specified in the enabled sbp messages setting and to receive incoming SBP messages. If the mode is changed from SBP the console will no longer be able to communicate over the interface. NMEA OUT configures the interface to transmit the GGA, RMC, GGL, VTG, ZDA, GSA, and GSV NMEA 0183 messages. The interface will not receive incoming messages. RTCMv3.1 IN configures the interface to receive RTK corrections in RTCM format. The interface will receive 1002, 1004, 1005, 1006, 1010, and 1012 RTCMv3.1 messages and will not transmit or receive any other messages tcp server enabled sbp messages Description: Configure which messages should be sent on the port. tcp server0 enabled sbp messages blank - all messages are enabled Table : enabled sbp messages Notes: The enabled sbp messages settings is a list of message s and rate divisors that will be sent out of the interface. If left blank, all messages will be sent. If not blank, a comma separated list of SBP message IDs in base 10 integer format should be provided. Optionally, a divisor can be specified after the / character for each id. For example, an entry of 3456/10 would provide message with ID 3456 at 1/10th the normal rate. For Ethernet, the is optimal for logging and communication with the console port Description: Port for TCP server 0. Version v1.3.10, December 20,

57 tcp server0 port integer Table : port Notes: None mode Description: Communication protocol for TCP server 0. tcp server0 mode SBP (Swift Binary Protocol) enum SBP,NMEA OUT,RTCMv3 IN Table : mode Notes: SBP configures the interface to transmit messages specified in the enabled sbp messages setting and to receive incoming SBP messages. If the mode is changed from SBP the console will no longer be able to communicate over the interface. NMEA OUT configures the interface to transmit the GGA, RMC, GGL, VTG, ZDA, GSA, and GSV NMEA 0183 messages. The interface will not receive incoming messages. RTCMv3.1 IN configures the interface to receive RTK corrections in RTCM format. The interface will receive 1002, 1004, 1005, 1006, 1010, and 1012 RTCMv3.1 messages and will not transmit or receive any other messages tcp server enabled sbp messages Description: Configure which messages should be sent on the port. Version v1.3.10, December 20,

58 tcp server1 enabled sbp messages blank - all messages are enabled Table : enabled sbp messages Notes: The enabled sbp messages settings is a list of message s and rate divisors that will be sent out of the interface. If left blank, all messages will be sent. If not blank, a comma separated list of SBP message IDs in base 10 integer format should be provided. Optionally, a divisor can be specified after the / character for each id. For example, an entry of 3456/10 would provide message with ID 3456 at 1/10th the normal rate. For Ethernet, the is optimal for logging and communication with the console port Description: Port for TCP server 1. tcp server1 port integer Table : port Notes: None mode Description: Communication protocol for TCP server 1. Version v1.3.10, December 20,

59 tcp server1 mode SBP (Swift Binary Protocol) enum SBP,NMEA OUT,RTCMv3 IN Table : mode Notes: SBP configures the interface to transmit messages specified in the enabled sbp messages setting and to receive incoming SBP messages. If the mode is changed from SBP the console will no longer be able to communicate over the interface. NMEA OUT configures the interface to transmit the GGA, RMC, GGL, VTG, ZDA, GSA, and GSV NMEA 0183 messages. The interface will not receive incoming messages. RTCMv3.1 IN configures the interface to receive RTK corrections in RTCM format. The interface will receive 1002, 1004, 1005, 1006, 1010, and 1012 RTCMv3.1 messages and will not transmit or receive any other messages track send trk detailed Description: send detailed tracking state message. track send trk detailed boolean Table : send trk detailed Notes: None max pll integration time ms Description: Controls maximum possible integration time for a measurement. Version v1.3.10, December 20,

60 track max pll integration time ms 20 integer None Table : max pll integration time ms Notes: This can be used to configure the sensitivity and dynamic tracking modes permitted to be used by receiver. Lower values provide lower sensitivity and noisier phase measurements but better performance in dynamic conditions iq output mask Description: Output raw I/Q correlations. track iq output mask None integer None Table : iq output mask Notes: Bitmask of channel IDs (not PRNs) elevation mask Description: Tracking elevation mask. Version v1.3.10, December 20,