Issue #1: Automate PTP configuration and services.

Author: geerlingguy

example.config.yml

@@ -1,7 +1,8 @@
 ---
 # GPSd configuration.
 gpsd_devices: "/dev/ttyAMA0"
-gpsd_options: "-s 38400 -n"
+gpsd_baud: "115200"
+gpsd_options: "-s 115200 -n"
 
 # Refclock to be used as a time source.
 # See: https://chrony-project.org/doc/3.4/chrony.conf.html#refclock
@@ -15,3 +16,27 @@ chrony_allow: "10.0.2.0/24"
 # Force i226 eth1 interface to 1 Gbps speed.
 # See: https://github.com./geerlingguy/time-pi/issues/2
 i226_force_1gbps: true
+
+# PTP 4 Linux options.
+ptp4l_ptp_iface: eth1
+ptp4l_service_state: started
+ptp4l_service_enabled: true
+
+ts2phc_service_state: started
+ts2phc_service_enabled: true
+ts2phc_logging_level: 7
+ts2phc_clock: '/dev/ptp0'
+ts2phc_source: 'generic'
+ts2phc_extra_opts: '-m'
+
+# Intel IGC driver has a bug - rising and falling edges are always used,
+# therefore we need to overrided a couple settings to lock sync.
+# See: https://github.com./geerlingguy/time-pi/issues/13
+ts2phc_extts_polarity: both
+ts2phc_pulsewidth: 100000000
+
+phc2sys_service_state: started
+phc2sys_service_enabled: true
+phc2sys_clock: 'CLOCK_REALTIME'
+phc2sys_source: '/dev/ptp0'
+phc2sys_extra_opts: '-O 37 -m'

handlers/main.yml

@@ -0,0 +1,30 @@
+---
+- name: Restart chrony
+  ansible.builtin.service:
+    name: chrony
+    state: restarted
+
+- name: Restart gpsd
+  ansible.builtin.service:
+    name: gpsd
+    state: restarted
+
+- name: Restart NetworkManager
+  ansible.builtin.service:
+    name: NetworkManager
+    state: restarted
+
+- name: Restart ptp4l
+  ansible.builtin.service:
+    name: ptp4l
+    state: restarted
+
+- name: Restart ts2phc
+  ansible.builtin.service:
+    name: ts2phc
+    state: restarted
+
+- name: Restart phc2sys
+  ansible.builtin.service:
+    name: phc2sys
+    state: restarted

main.yml

@@ -6,20 +6,8 @@
   vars_files: ['config.yml']
 
   handlers:
-    - name: Restart chrony
-      ansible.builtin.service:
-        name: chrony
-        state: restarted
-
-    - name: Restart gpsd
-      ansible.builtin.service:
-        name: gpsd
-        state: restarted
-
-    - name: Restart NetworkManager
-      ansible.builtin.service:
-        name: NetworkManager
-        state: restarted
+    - name: Include various service handlers.
+      ansible.builtin.include_tasks: handlers/main.yml
 
   tasks:
     - name: Configure Raspberry Pi settings.

tasks/ptp.yml

@@ -4,6 +4,54 @@
     name: linuxptp
     state: present
 
-# TODO: Set up NIC as grandmaster, configure phc2sys, and set up testptp
-# See: https://github.com./geerlingguy/time-pi/issues/1
-# sudo ptp4l -i eth1 -m
+- name: Copy ts2phc systemd unit file into place.
+  ansible.builtin.template:
+    src: ts2phc.unit.j2
+    dest: /etc/systemd/system/ts2phc.service
+    owner: root
+    group: root
+    mode: 0755
+  notify: Restart ts2phc
+
+- name: Ensure ts2phc service is in the correct state.
+  ansible.builtin.service:
+    name: ts2phc
+    state: "{{ ts2phc_service_state }}"
+    enabled: "{{ ts2phc_service_enabled }}"
+
+- name: Copy phc2sys systemd unit file into place.
+  ansible.builtin.template:
+    src: phc2sys.unit.j2
+    dest: /etc/systemd/system/phc2sys.service
+    owner: root
+    group: root
+    mode: 0755
+  notify: Restart phc2sys
+
+- name: Ensure phc2sys service is in the correct state.
+  ansible.builtin.service:
+    name: phc2sys
+    state: "{{ phc2sys_service_state }}"
+    enabled: "{{ phc2sys_service_enabled }}"
+
+- name: Add ptp4l configuration.
+  ansible.builtin.template:
+    src: "templates/ptp4l.conf.j2"
+    dest: "/etc/ptp4l.conf"
+    mode: 0644
+  notify: Restart ptp4l
+
+- name: Copy ptp4l systemd unit file into place.
+  ansible.builtin.template:
+    src: ptp4l.unit.j2
+    dest: /etc/systemd/system/ptp4l.service
+    owner: root
+    group: root
+    mode: 0755
+  notify: Restart ptp4l
+
+- name: Ensure ptp4l service is in the correct state.
+  ansible.builtin.service:
+    name: ptp4l
+    state: "{{ ptp4l_service_state }}"
+    enabled: "{{ ptp4l_service_enabled }}"

templates/phc2sys.unit.j2

@@ -0,0 +1,13 @@
+[Unit]
+Description=Sync PHC to System clock
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=/usr/sbin/phc2sys -s {{ phc2sys_source }} -c {{ phc2sys_clock }} --step_threshold=1 --transportSpecific=1 {{ phc2sys_extra_opts }}
+Restart=always
+RestartSec=3
+
+[Install]
+WantedBy=multi-user.target

templates/ptp4l.conf.j2

@@ -0,0 +1,16 @@
+[global]
+
+# See: https://austinsnerdythings.com/2025/02/18/nanosecond-accurate-ptp-server-grandmaster-and-client-tutorial-for-raspberry-pi/
+
+# Log level (0 = disabled, 1 = print to stdout)
+verbose 1
+
+# Force hardware timestamping
+time_stamping         hardware
+
+# Act only as a master. ('serverOnly' on later versions...)
+masterOnly 1
+
+# clockClass=6 for GNSS reference
+# other classes = https://documentation.nokia.com/srlinux/24-10/books/network-synchronization/ieee-1588-ptp.html
+clockClass 6

templates/ptp4l.unit.j2

@@ -0,0 +1,13 @@
+[Unit]
+Description=Precision Time Protocol (PTP) service
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=/usr/sbin/ptp4l -f /etc/ptp4l.conf -i {{ ptp4l_ptp_iface }}
+Restart=always
+RestartSec=3
+
+[Install]
+WantedBy=multi-user.target

templates/ts2phc.unit.j2

@@ -0,0 +1,13 @@
+[Unit]
+Description=Timestamp to PHC synchronization service
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=/usr/sbin/ts2phc -c {{ ts2phc_clock }} -s {{ ts2phc_source }} --ts2phc.pin_index 2 --ts2phc.extts_polarity {{ ts2phc_extts_polarity }} --ts2phc.pulsewidth {{ ts2phc_pulsewidth }} -l {{ ts2phc_logging_level }} {{ ts2phc_extra_opts }}
+Restart=always
+RestartSec=3
+
+[Install]
+WantedBy=multi-user.target