Collector GPS

The location source is the GPS source for a Nexus Telemetry Fleet collector. The default is the Starlink terminal. It is set per collector, in the dashboard on the Admin view of the terminal’s page, or in the collector’s configuration file.

Sources

Source Description Fields File value
Starlink terminal The terminal’s own GPS. The default none dish
Fixed coordinates Coordinates typed in or chosen on the map Latitude, Longitude fixed
Off (no position) No position is recorded none off
Serial GPS (auto-detect) A GPS receiver connected to the host Serial receiver and Baud, both optional serial
NMEA over TCP A receiver or multiplexer on the network Host, Port nmea_tcp
NMEA over UDP A receiver broadcasting to a port on the collector Port nmea_udp
gpsd The gpsd GPS service, on the host or on the network. Defaults to localhost:2947 Host, Port gpsd

Serial GPS (auto-detect) with no Serial receiver set scans the serial ports at 9600, 38400, 115200 and 4800 baud, and uses the first that returns a valid GPS sentence. A named receiver with no baud set is read at 9600.

Setting the source

  1. In the dashboard, open the terminal’s page and its Admin view.
  2. In the Location section, press Override…. The button reads Change… when a source is already set from the dashboard.
  3. Choose a Source.
  4. Complete the fields for that source. For Fixed coordinates, click a point on the map, or search for a place name and select it.
  5. Press Set location.

A connected collector applies the change immediately, without a restart. An offline collector applies it when it next connects.

Place search uses OpenStreetMap. The fleet server runs the search, so the fleet server requires internet access and the browser does not.

Revert to the collector’s own config clears the source set from the dashboard, after a confirmation. The collector then uses the source in its configuration file. With no source in the file, it uses the terminal.

A user with the Viewer role sees the Location section as read-only. See Users and roles for the roles.

Current source

The Location section shows the coordinates, or No position yet, and a line with two facts.

Fact Value
Where the source was set Set from the dashboard and the source’s file value, nmea_tcp for example, or Reported by the collector from its own configuration.
What the collector reports ok for a live position, No fix yet, Holding the last known fix, or Position withheld by the terminal

In the same section a fixed position is marked fixed and a position set from the dashboard is marked pushed. The mark separates a configured position from a GPS position.

When the terminal is the source and stops reporting a position, the collector keeps the last known position and marks it stale. With no position ever received it reports 0, 0, shown as No position yet.

Configuration file

The source can be set in collector.toml, with the file value from the table above. The file applies when no source has been set from the dashboard.

toml
location_source = "fixed"
location_lat = 50.1234
location_lon = -4.5678
location_lock = false

After the collector restarts, the Location section is marked fixed.

location_lock = true gives the file precedence over the dashboard. A source set from the dashboard is then recorded by the fleet server and not applied by the collector. Otherwise the dashboard takes precedence over the file, and the file over the terminal.

A source set from the dashboard is kept across a restart. See Collector configuration for every key and its environment variable.

← Onboard status page Retire and revoke →