[gps]
Setting | Type | Explanation |
---|---|---|
enabled | Integer 0 or 1 | Indicates whether GPS support is enabled. GPS support currently requires a u-blox USB GPS receiver. Either a UBlox-7 VK172, or a UBlox 8 M8030 device is supported. Note that if GPS support is enabled and no device is plugged in, nothing different will happen; it will be just as if GPS is disabled. You may want to disable GPS without unplugging it; that is where this setting comes into play. |
usegpsheading | Integer 1 or 0 | This setting is currently ignored; the GPS heading will always be used when a heading is required (there is limited internal support for a digital compass which theoretically provides better heading information because it works when the vehicle is not moving, but as yet I haven’t found it to be reliable enough in the car’s environment due to magnetic interference from other devices) |
logmessages | Integer 0 or 1 | Turns on GPS logging of all messages being received from the GPS receiver. The messages are logged to the device log in their raw ASCII form. Warning: GPS logging is VERY noisy and should not be left enabled as it may have a performance impact. You should only use it for diagnosis purposes. See also the console command gps log |
positionratehz | Integer, default 10 | UBlox receivers only. Defines the position calculation rate to be used by the GPS receiver. Does not normally need to be changed. |
satslockedratehz | Integer, default 2 | UBlox receivers only. Specifies the rate in hz at which the sats locked message should be generated by the GPS device. Does not normally need to be changed. |
satsinviewratehz | Integer, default 2 | UBlox receivers only. Specifies the rate in hz at which the sats seen message should be generated by the GPS device. Does not normally need to be changed. |
baudrate | Integer, default 115200 | Sets the line speed between SDC and the GPS device. The ublox-specific driver also uses this setting to configure some ublox-specific parameters. A UBlox 7 VK172 will run as low as 38400 but the M8030 UBlox 8 may require up to 115200, although it will run reasonably well at 57600. |
logfilter | string | Comma separated list of NMEA sentence ids (e.g. logfilter=rmc,gsv). This setting defaults to an empty string. If specified, then only when logmessages=1 is set, the messages received are passed through this filter. Only messages with ids that are present in the filter list are logged. This setting has no effect if logging is not enabled. |
driver | string | Valid values are ublox or none . If this setting is not specified, the default value of ublox is used. This setting defines which kind of receiver is connected to the USB port, and therefore what initialisation process to follow to configure the receiver for SDC. The receiver must be a CDC ACM device. Serial devices, or devices that use other Serial to USB chipsets, are not supported. The value of none means that no initialisation process will follow, and therefore the receiver will use its factory settings. For many receivers this means a position, course, and speed recalculation once per second, with a slow data stream. The configured baud rate must match the receiver’s capabilities. |