GPSDConfig Help

GPSD Config controls

Top row

• Serial Ports - Choose your GPS receiver from the list of devices. The name of your device depends on the USB port that it is plugged in to. Please be aware of this if you move it from one port to another.
• Units - Either Metric or Imperial or Nautical measurements.
• Terminal - Open the macOS Terminal utility. This is useful for running the command line tools supplied with gpsd - e.g. gpsmon and cgps.
• ChronyControl - Launch the ChronyControl Utility if you have it installed.

chronyd

• PID - Process ID if chronyd is running.
• Refclock - Copy this text to your chronyd configuration file. This can be done using ChronyControl.

gpsd settings

• gpsd - The file system path to the gpsd code file. Select it using the Path button.
• options - Any additional options to pass to gpsd. GPSDConfig always includes -n -N but there are others that may be useful. Run man gpsd in a Terminal window for a full list.
  To allow remote gpsd clients to connect to your gpsd server, you must specify the -G option, in addition to making any firewall changes to allow incoming TCP connections on port 2947.
• Wait for chronyd - gpsd must be started after chronyd if you want to pass the GPS time data to chronyd. Leave this unchecked if you are not running chronyd.
• Install / Uninstall - Generate and install the files required to start gpsd at system boot. This is a privileged operation and you will be prompted for your admin login and password. The files installed are: /Library/LaunchDamons/net.whatroute.gpsdstart.plist /Library/Application Support/GPSDConfig/gpsdstart.plist

gpsd monitor

This pane shows some of the data received from gpsd when the GPS receiver has locked on to the satellites.

Clicking the Apple Maps icon will open Maps at your current location. You could also just look out the window.

The PID field will be hidden if you are monitoring a remote instance of gpsd.

Monitor host …

Use the Monitor host button to start monitoring a remote host. You will be able to choose the host and/or port that the remote host is using. By default gpsd uses port 2947

If you clear the fields, GPSDConfig will revert to monitoring your local machine at the network address localhost:2947

Stop/Start gpsd

These buttons are used to control the state of gpsd. You can still have gpsd running when you are monitoring a remote host.