Skip to content

Instantly share code, notes, and snippets.

@jokla
Created November 1, 2019 16:31
Show Gist options
  • Save jokla/ec760feacefdbbe98b1a2b5dbc79d5db to your computer and use it in GitHub Desktop.
Save jokla/ec760feacefdbbe98b1a2b5dbc79d5db to your computer and use it in GitHub Desktop.
; ========================================
; PTPDv2 version 2.3.0-svn default configuration
; ========================================
; NOTE: the following settings are affected by ptpengine:preset selection:
; ptpengine:slave_only
; clock:no_adjust
; ptpengine:clock_class - allowed range and default value
; To see all preset settings, run ptpd2 -H (--long-help)
; Network interface to use (required)
ptpengine:interface = eth0
; PTP engine preset:
; none = Defaults, no clock class restrictions
; slaveonly = Slave only (clock class 255 only)
; masteronly = Master, passive when not best master (clock class 0..127)
; masterslave = Full IEEE 1588 implementation:
; Master, slave when not best master
; (clock class 128..254)
;
; Options: none slaveonly masteronly masterslave
ptpengine:preset = masteronly
; IP transmission mode (requires IP transport) - hybrid mode uses
; multicast for sync and announce, and unicast for delay request /
; response
; Options: multicast unicast hybrid
ptpengine:ip_mode = unicast
ptpengine:unicast_negotiation = N
; Transport type for PTP packets
; Options: ipv4 ethernet
ptpengine:transport = ipv4
; Use libpcap for sending and receiving traffic (automatically enabled
; in Ethernet mode)
ptpengine:use_libpcap = N
; Delay detection mode used - use DELAY_DISABLED for syntonisation
; only (no synchronisation)
; Options: E2E P2P DELAY_DISABLED
ptpengine:delay_mechanism = E2E
; PTP domain number
ptpengine:domain = 0
; Slave only mode (if set, overrides preset setting and sets clock class to 255)
ptpengine:slave_only = N
; Specify latency correction for incoming packets
ptpengine:inbound_latency = 0
; Specify latency correction for outgoing packets
ptpengine:outbound_latency = 0
; Compatibility option: In slave state, always respect UTC offset
; announced by best master, even if the the
; currrentUtcOffsetValid flag is announced FALSE
ptpengine:always_respect_utc_offset = N
; PTP announce message interval in master state (expressed as log 2
; i.e. -1=0.5s, 0=1s, 1=2s etc.)
ptpengine:log_announce_interval = 2
; PTP announce receipt timeout announced in master state
ptpengine:announce_timeout = 6
; PTP announce receipt timeout grace period in slave state:
; when announce receipt timeout occurs, disqualify current best GM,
; then wait n times announce receipt timeout before resetting.
; Allows for a seamless GM failover when standby GMs are slow to react.
; When set to 0, this option is not used.
ptpengine:announce_timeout_grace_period = 0
; PTP sync message interval in master state (expressed as log 2
; i.e. -1=0.5s, 0=1s, 1=2s etc.)
ptpengine:log_sync_interval = 3
; Initial delay request message interval for slave mode, before first
; delay response is received (expressed as log 2 i.e. -1=0.5s, 0=1s,
; 1=2s etc.)
ptpengine:log_delayreq_interval_initial = 2
; Minimum delay request message interval in master state, in slave
; mode overrides the master interval, required in hybrid mode
; (expressed as log 2 i.e. -1=0.5s, 0=1s, 1=2s etc.)
ptpengine:log_delayreq_interval = 4
; Minimum peer delay request message interval in master state.
; (expressed as log 2 i.e. -1=0.5s, 0=1s, 1=2s etc.)
ptpengine:log_peer_delayreq_interval = 1
; Maximum number of foreign masters (foreign master record size
; allocated at startup)
ptpengine:foreignrecord_capacity = 5
; Specify Allan variance announced in master state
ptpengine:ptp_allan_variance = 28768
; Clock accuracy range announced in master state
; Options: ACC_25NS ACC_100NS ACC_250NS ACC_1US ACC_2.5US ACC_10US
; ACC_25US ACC_100US ACC_250US ACC_1MS ACC_2.5MS ACC_10MS ACC_25MS
; ACC_100MS ACC_250MS ACC_1S ACC_10S ACC_10SPLUS ACC_UNKNOWN
ptpengine:ptp_clock_accuracy = ACC_1US
; underlying time source UTC offset announced in master state
ptpengine:utc_offset = 37
; underlying time source UTC offset validity announced in master state
ptpengine:utc_offset_valid = Y
; underlying time source time traceability announced in master state
ptpengine:time_traceable = N
; underlying time source frequency traceability announced in master state
ptpengine:frequency_traceable = N
; Time scale announced in master state (with ARB timescale, UTC
; properties are ignored by slaves), when clock class 13 (application
; specific), this value is ignored and ARB is used.
; Options: PTP ARB
ptpengine:ptp_timescale = PTP
; Time source announced in master state
; Options: ATOMIC_CLOCK GPS TERRESTRIAL_RADIO PTP NTP HAND_SET OTHER
; INTERNAL_OSCILLATOR
ptpengine:ptp_timesource = INTERNAL_OSCILLATOR
; Clock class - announced in master state. Always 255 for slave-only mode.
; Minimum, maximum and default values are controlled by presets.
; If set to 13 (application specific time source), announced
; time scale is always set to ARB. This setting controls the
; states a PTP port can be in. If below 128, port will only
; be in MASTER or PASSIVE states (master only). If above 127,
; port will be in MASTER or SLAVE states.
ptpengine:clock_class = 10
; Priority 1 value announced in master state and used for Best Master
; Clock selection
ptpengine:priority1 = 120
; Priority 2 value announced in master state and used for Best Master
; Clock selection
ptpengine:priority2 = 125
; Specify unicast destination for unicast master mode (in unicast
; slave mode overrides delay request destination)
ptpengine:unicast_address =
ptpengine:unicast_destinations = 192.168.254.1
; Send explicit IGMP joins between servo resets
ptpengine:igmp_refresh = N
; Multicast time to live for multicast PTP packets (ignored and set to
; 1 for peer to peer messages)
ptpengine:multicast_ttl = 64
; DiffServ CodepPoint for packet prioritisation (decimal). When set to
; zero, this option is not used.
; 46 = Expedited Forwarding (0x2e)
ptpengine:ip_dscp = 0
; Enable outlier filter for the Delay Response component in slave state
ptpengine:delay_outlier_filter_enable = N
; Delay Response outlier filter action. If set to 'filter', outliers
; are replaced with moving average
; Options: discard filter
ptpengine:delay_outlier_filter_action = filter
; Number of samples in the Delay Response outlier filter buffer
ptpengine:delay_outlier_filter_capacity = 20
; Delay Response outlier filter threshold: multiplier for the Peirce's
; maximum standard deviation. When set below 1.0, filter is tighter,
; when set above 1.0, filter is looser than standard Peirce's test.
ptpengine:delay_outlier_filter_threshold = 1.000000
; Delay Response outlier weight: if an outlier is detected, this value
; determines the amount of its deviation from mean that is used to
; build the standard deviation statistics and influence further
; outlier detection.
; When set to 1.0, the outlier is used as is.
;
ptpengine:delay_outlier_weight = 1.000000
; Enable outlier filter for the Sync component in slave state
ptpengine:sync_outlier_filter_enable = N
; Sync outlier filter action. If set to 'filter', outliers are
; replaced with moving average
; Options: discard filter
ptpengine:sync_outlier_filter_action = filter
; Number of samples in the Sync outlier filter buffer
ptpengine:sync_outlier_filter_capacity = 20
; Sync outlier filter threshold: multiplier for the Peirce's maximum
; standard deviation. When set below 1.0, filter is tighter, when set
; above 1.0, filter is looser than standard Peirce's test.
ptpengine:sync_outlier_filter_threshold = 1.000000
; Sync outlier weight: if an outlier is detected, this value
; determines the amount of its deviation from mean that is used to
; build the standard deviation statistics and influence further
; outlier detection. When set to 1.0, the outlier is used as is.
ptpengine:sync_outlier_weight = 1.000000
; Delay between moving to slave state and enabling clock updates
; expressed as number of statistics update periods (see
; global:statistics_update_interval). This allows one-way delay to
; stabilise before starting clock updates. Activated when going into
; slave state and during GM failover in slave state.
; 0 - not used.
ptpengine:calibration_delay = 0
; Enable panic mode: when offset from master is above 1 second, stop
; updating the clock for a period of time and then step the clock if
; offset remains above 1 second.
ptpengine:panic_mode = N
; Duration of the panic mode period (no clock updates) when offset
; above 1 second detected
ptpengine:panic_mode_duration = 2
; Use JobID (PID) for UUID
ptpengine:pid_as_clock_idendity = N
; Fail over to NTP when PTP time sync not available - requires
; ntpengine:enabled but does not require the rest of NTP configuration
; - will warn instead of failing over if cannot control ntpd.
ptpengine:ntp_failover = N
; NTP failover timeout in seconds: time between PTP slave going into
; LISTENING state, and failing over to NTP. 0 = fail over immediately.
ptpengine:ntp_failover_timeout = 60
; Prefer NTP time synchronisation when not controlling the clock (all
; states, including slave when clock:no_adjust set)
ptpengine:prefer_ntp = N
; When entering panic mode, fail over to NTP (after the NTP failover
; timeout period) - requires ntpengine:enabled but does not require
; the rest of NTP configuration - will warn instead of failing over if
; it cannot control ntpd.
ptpengine:panic_mode_ntp = N
; Do not adjust the clock
clock:no_adjust = Y
; Do not reset the clock - only slew
clock:no_reset = Y
; Observed drift handling method between servo restarts:
; reset: set to zero (not recommended)
; preserve: use kernel value,
; file: load and save to drift file on startup/shutdown, use kernel
; value inbetween.
; To specify drift file, use the clock:drift_file setting.
; Options: reset preserve file
clock:drift_handling = preserve
; Specify drift file
clock:drift_file = /etc/ptpd2_kernelclock.drift
; Maximum absolute frequency shift which can be applied to the clock servo
; when slewing the clock. Expressed in parts per million (1 ppm = shift of
; 1 us per second. Values above 512 will use the tick duration correction
; to allow even faster slewing. Default maximum is 512 without using tick.
clock:max_offset_ppm = 1000
; One-way delay filter stiffness
servo:delayfilter_stiffness = 6
; Clock servo PI controller proportional component gain (kP)
servo:kp = 0.1
; Clock servo PI controller integral component gain (kI)
servo:ki = 0.001
; Maximum accepted delayMS value in nanoseconds (Sync).
; 0 = not checked.
servo:max_delay = 0
; Enable clock synchronisation servo stability detection
; (based on standard deviation of the observed drift value)
; - drift will be saved to drift file / cached when considered stable,
; also clock stability status will be logged
;
servo:stability_detection = N
; Specify the observed drift standard deviation threshold in parts per billion
; (ppb) - if stanard deviation is within the threshold, servo is considered
; stable.
servo:stability_threshold = 5.000000
; Specify for how many statistics update intervals the observed drift standard
; deviation has to stay within threshold to be considered stable
;
servo:stability_period = 3
; Specify after how many minutes without stabilisation servo is considered
; unstable. Assists with logging servo stability information and
; allows to preserve observed drift if servo cannot stabilise.
;
servo:stability_timeout = 10
; Do not update one-way delay if slave to master delay (from Delay Response)
; is greater than this value (nanoseconds). 0 = not used.
servo:max_delay = 0
; Do not reset the clock if offset from master is greater
; than this value (nanoseconds). 0 = not used.
servo:max_offset = 0
; Send log messages to syslog. Disabling this
; sends all messages to stdout (or speficied log file)
global:use_syslog = N
; Lock file location
global:lock_file =
; Use mode specific and interface specific lock files (overrides
; global:lock_file)
global:auto_lockfile = N
; Lock file directory: used with automatic mode-specific lock files,
; also used when no lock file is specified. When lock file
; is specified, it's expected to be an absolute path.
global:lock_directory = /var/run
; Skip lock file checking and locking
global:ignore_lock = N
; File used to record data about sync packets. Setting this enables recording.
global:quality_file =
; Maximum sync packet record file size (in kB) - file will be
; truncated if size exceeds the limit.
; 0 - no limit.
global:quality_file_max_size = 0
; Enable log rotation of the sync packet record file up to n files.
; 0 - do not rotate.
global:quality_file_max_files = 0
; Truncate the sync packet record file every time it is (re) opened -
; on startup and SIGHUP
global:quality_file_truncate = N
; File used to log ptpd2 status information
global:status_file = /var/run/ptpd2.status.log
; Enable / disable writing status information to file
global:log_status = Y
; Status file update interval in seconds
;
global:status_update_interval = 1
; Specify log file path (event log). Setting this enables logging to file.
global:log_file = /var/run/ptpd2.event.log
; Maximum log file size (in kB) - log file will be truncated if size
; exceeds the limit.
; 0 - no limit.
global:log_file_max_size = 0
; Enable log rotation of the sync packet record file up to n files.
; 0 - do not rotate
global:log_file_max_files = 0
; Truncate the log file every time it is (re) opened - on startup and SIGHUP
global:log_file_truncate = N
; Specify log level (only messages of the specified priority or higer
; will be logged).
; The minimal level is LOG_ERR. LOG_ALL enables debug output if compiled with
; RUNTIME_DEBUG
; Options: LOG_ERR LOG_WARNING LOG_NOTICE LOG_INFO LOG_ALL
global:log_level = LOG_ALL
; Specify statistics log file path. Setting this enables logging of
; statistics but can be overriden with global:log_statistics
global:statistics_file = /var/run/ptpd2.stats.log
; Log timing statistics every n seconds for Sync and Delay Response
; messages (0 - log all)
global:statistics_log_interval = 0
; Maximum statistics log file size (in kB) - log file will be
; truncated if size exceeds the limit.
; 0 - no limit.
global:statistics_file_max_size = 0
; Enable log rotation of the statistics file up to n files. 0 - do not rotate
;
global:statistics_file_max_files = 0
; Truncate the statistics file every time it is (re) opened - on
; startup and SIGHUP
global:statistics_file_truncate = N
; Dump the contents of every PTP packet
global:dump_packets = N
; Run in foreground with statistics and all messages logged to stdout.
; Overrides log file and statistics file settings and disables syslog.
;
global:verbose_foreground = N
; Run in foreground
global:foreground = N
; Log timing statistics for every PTP packet received
global:log_statistics = Y
; Linux only: bind ptpd2 process to a selected CPU core number.
; 0 = first CPU core, etc. -1 = do not bind to a single core.
global:cpuaffinity_cpucore = -1
; Clock synchronisation statistics update interval in seconds
;
global:statistics_update_interval = 5
; Enable NTPd integration
ntpengine:enabled = N
; Enable control over local NTPd daemon
ntpengine:control_enabled = N
; NTP control check interval in seconds
;
ntpengine:check_interval = 15
; NTP key number - must be configured as a trusted control key in ntp.conf,
; and must be non-zero for the ntpengine:control_enabled setting to take effect.
;
ntpengine:key_id = 0
; NTP key (plain text, max. 20 characters) - must match the key
; configured in ntpd's keys file, and must be non-zero for the
; ntpengine:control_enabled setting to take effect.
ntpengine:key =
ptpengine:management_enable = N
; ========= newline required in the end ==========
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment