Skip to content

Commit 065f646

Browse files
committed
Issue #11: Clean up GPS debugging and baud rate setting notes.
1 parent f758158 commit 065f646

File tree

1 file changed

+12
-31
lines changed

1 file changed

+12
-31
lines changed

README.md

Lines changed: 12 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -63,9 +63,9 @@ This should configure the clients to acquire PTP time from the grandmaster Pi.
6363

6464
> **Note**: This playbook is still under active development. See [Issue #1](https://github.com/geerlingguy/time-pi/issues/1) for the latest.
6565
66-
## GPS Notes
66+
## GPS / GNSS Notes
6767

68-
Using u-blox GPS modules, you may encounter a baud rate mismatch. Many of the u-blox modules default to `38400` baud, but this project recommends `115200` baud for slightly faster timing updates.
68+
Using u-blox GPS modules, you may encounter a baud rate mismatch. Many newer u-blox modules default to `38400` baud, while older modules default to `9600` baud. This project recommends `115200` baud for slightly faster timing updates.
6969

7070
```
7171
# Get the protocol version ('PROTVER')
@@ -86,14 +86,19 @@ export UBXOPTS="-P 32.01"
8686
ubxtool -S 115200
8787
8888
# Persist the setting
89-
ubxtool -p SAVE
90-
```
89+
ubxtool -p SAVE -P 32.01
90+
ubxtool -p COLDBOOT -P 32.01
9191
92-
**KNOWN ISSUE**: The baud setting is currently not persisting across reboots. See [this GitHub issue](https://github.com/geerlingguy/time-pi/issues/11) for updates.
92+
# If running GPSd, update the rate gpsd's config and restart gpsd
93+
sudo nano /etc/default/gpsd
94+
sudo systemctl restart gpsd
95+
```
9396

9497
`ubxtool` is installed as part of the `gpsd-clients` package, which is automatically installed by this playbook.
9598

96-
For more on how to set the baud rate (or tweak other GPS module parameters), see [millerjs.org's ubxtool page](https://wiki.millerjs.org/ubxtool) and the [ubxtool examples](https://gpsd.io/ubxtool-examples.html) page.
99+
For more on how to set the baud rate (or tweak other GPS module parameters), see [millerjs.org's ubxtool page](https://wiki.millerjs.org/ubxtool) and the [ubxtool examples](https://gpsd.io/ubxtool-examples.html) page. You can also configure most options via `pygpsclient` using a GUI.
100+
101+
See this issue for more: [Debug NEO-M9N module on TimeHAT V2](https://github.com/geerlingguy/time-pi/issues/11).
97102

98103
## Usage and Debugging
99104

@@ -126,31 +131,6 @@ sudo phc_ctl eth1 cmp # should be nearly -37000000000ns
126131

127132
Much of the work that went into this project was documented in [this thread on the TimeHat v2](https://github.com/geerlingguy/raspberry-pi-pcie-devices/issues/674).
128133

129-
## GPS / GNSS Module debugging
130-
131-
Like cellular modems, GPS modules can be a bit tricky, using arcane syntaxes and custom protocols for communication.
132-
133-
For the NEO-M9N module, the default `baud` rate is a little low for my liking, but to get it working, I had to go through a lengthy process learning `ubxtool`.
134-
135-
To configure my module for `115200` baud, I did the following:
136-
137-
```
138-
# Set the baud rate
139-
ubxtool -S 115200
140-
141-
# Save the settings (get the `-P` PROTVER with `ubxtool -p MON-VER`)
142-
$ ubxtool -p SAVE -P 32.01
143-
144-
# Update the rate in your GPSd config and restart `gpsd`
145-
sudo nano /etc/default/gpsd
146-
sudo systemctl restart gpsd
147-
148-
# Test the settings by rebooting the GPS module manually.
149-
$ ubxtool -p COLDBOOT -P 32.01
150-
```
151-
152-
See this issue for more: [Debug NEO-M9N module on TimeHAT V2](https://github.com/geerlingguy/time-pi/issues/11).
153-
154134
## Slave / Client Setup
155135

156136
For PTP, you need to install and configure PTP for Linux on slave/client machines, and synchronize them to the master/server node as well.
@@ -172,6 +152,7 @@ An example configuration for a slave/client node is set up in `ptp-client-node.y
172152
- [LeapSecond.com](http://www.leapsecond.com) (great resources for timing nerds)
173153
- [Time-Nuts Mailing List](http://www.leapsecond.com/time-nuts.htm) (for amateurs who are interested in precise Time & Frequency)
174154
- [Where does my computer get the time from?](https://dotat.at/@/2023-05-26-whence-time.html) (good overview of the sources of modern NTP + GPS time, with the history of each source)
155+
- [Satpulse time server architecture](https://satpulse.net/2025/05/21/time-server-architecture.html) (System clock vs PHC vs NIC, and how time is transferred internally and through PTP and NTP)
175156

176157
## License
177158

0 commit comments

Comments
 (0)