feature: PTP driver

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+### Added
+
+- Support for PTP devices as sources (subject to the "ptp" compile flag, enabled by default).  See docs/guide/ptp.md for details.
+
 ## [1.6.1] - 2025-07-16
 
 ### Fixed

Cargo.toml

@@ -43,6 +43,7 @@ toml = { version = ">=0.6.0,<0.9.0", default-features = false, features = ["pars
 timestamped-socket = "0.2.2"
 clock-steering = "0.2.1"
 pps-time = "0.2.3"
+ptp-time = "0.1.0"
 
 # TLS
 rustls23 = { package = "rustls", version = "0.23.16", features = ["logging", "std"] }

docs/development/code-structure.md

@@ -14,8 +14,9 @@ ntpd-rs is split into several crates with three goals in mind:
    straightforward to verify.
 
 The main `ntp-proto` and `ntpd` crates are set up such that neither contains any
-unsafe code. Unsafe code is limited to the (external) `timestamped-socket`, `clock-steering` and `pps-time` crates,
-which are purposefully kept small and only offer a safe API.
+unsafe code. Unsafe code is limited to the (external) `timestamped-socket`,
+`clock-steering`, `pps-time`, and `ptp-time` crates, which are purposefully kept
+small and only offer a safe API.
 
 ### ntp-proto
 
@@ -47,6 +48,11 @@ clock. Touching the system clock uses `libc` and is inherently unsafe.
 The [`pps-time` crate](https://github.com/pendulum-project/pps-time) wraps the system calls needed to interact with a PPS device. To
 interact with PPS devices ioctl system calls are used, which uses `libc` and is inherently unsafe.
 
+### ptp-time
+
+The [`ptp-time` crate](https://github.com/paulgear/ptp-time) wraps the system calls needed to interact with a PTP device. To
+interact with PTP devices ioctl system calls are used, which uses `libc` and is inherently unsafe.
+
 ### ntpd
 
 The `ntpd` crate contains the code for all three end-user binaries that our
@@ -140,4 +146,3 @@ an example of how to interact with this socket.
 
 Because this task reads from its socket, it is advised to restrict the
 permissions on this socket.
-

docs/development/prompts/ptp/README.md

@@ -0,0 +1 @@
+This directory contains some of the prompts which were used in the AI-assisted development of the PTP driver.  They may be deleted when no longer considered useful.