Time Slave User Manual#

User Manual Time Slave Component
status: draft
security: NO
safety: QM
version: 1

Overview#

The TimeSlave component is a system daemon responsible for synchronizing with the PTP Grandmaster Clock over the network. It adjusts the hardware clock (PHC) and publishes synchronization data to shared memory for consumption by the TimeDaemon.

For module-level integration and deployment information, see the main module manual.

Configuration#

Runtime Requirements#

Operating System Privileges#

The TimeSlave executable (time_slave) requires elevated privileges to access raw network sockets and control the hardware clock. It is strongly recommended not to run this process as the root user. Instead, grant the required Linux Capabilities to the executable:

sudo setcap cap_net_admin,cap_net_raw,cap_sys_time+eip /path/to/time_slave
  • cap_net_admin: For network interface configuration.

  • cap_net_raw: For the use of raw sockets to listen to PTP traffic.

  • cap_sys_time: For adjusting the system’s hardware clock.

Network Requirements#

  • The network interface used for PTP communication must be provided via the -i, --interface <name> command-line argument.

  • The ECU must have network connectivity to the PTP Grandmaster clock on this interface.

  • Network hardware must support PHC (PTP Hardware Clock).