From e86d77c86edee73929a92123a13a23b423172af2 Mon Sep 17 00:00:00 2001 From: Dinesh Neelapu Date: Wed, 5 Jul 2023 19:46:34 +0000 Subject: [PATCH] PTP PMC example and system configuartion changes. (r8, r9, dsR8, dsR9) 1. Replaced few commands with updated ones. 2. Updated the title from "SyncE and Introduction" to "SyncE Introduction". 3. Added a note in "Instance Specific Considerations" section. 4. Added and modifed few content in PTP Introduction and General Information sections. (Added PHC to the abbreviation list). Change-Id: I1d457c379869e264663a82625b1373384de16033 Signed-off-by: Dinesh Neelapu --- doc/source/shared/abbrevs.txt | 2 ++ .../gnss-and-synce-support-62004dc97f3e.rst | 8 ++++---- ...nce-specific-considerations-d9d9509c79dd.rst | 17 ++++++++++++++--- ...tp-instance-troubleshooting-7a7c576ee57a.rst | 14 +++++++++----- .../ptp-introduction-d981dd710bda.rst | 15 +++++++++------ 5 files changed, 38 insertions(+), 18 deletions(-) diff --git a/doc/source/shared/abbrevs.txt b/doc/source/shared/abbrevs.txt index 618b7a811..e86dde998 100755 --- a/doc/source/shared/abbrevs.txt +++ b/doc/source/shared/abbrevs.txt @@ -112,6 +112,8 @@ .. |PEM| replace:: :abbr:`PEM (Privacy Enhanced Mail)` .. |PF| replace:: :abbr:`PF (Physical Function)` .. |PHB| replace:: :abbr:`PHB (Per-Hop Behavior)` +.. |PHC| replace:: :abbr:`PHC (PTP Hardware Clock)` +.. |PHCs| replace:: :abbr:`PHC (PTP Hardware Clock)` .. |PMD| replace:: :abbr:`PMD (Pole Mode Driver)` .. |PQDN| replace:: :abbr:`PDQN (Partially Qualified Domain Name)` .. |PQDNs| replace:: :abbr:`PQDNs (Partially Qualified Domain Names)` diff --git a/doc/source/system_configuration/kubernetes/gnss-and-synce-support-62004dc97f3e.rst b/doc/source/system_configuration/kubernetes/gnss-and-synce-support-62004dc97f3e.rst index be402d31c..2dcbc3c4c 100644 --- a/doc/source/system_configuration/kubernetes/gnss-and-synce-support-62004dc97f3e.rst +++ b/doc/source/system_configuration/kubernetes/gnss-and-synce-support-62004dc97f3e.rst @@ -1,8 +1,8 @@ .. _gnss-and-synce-support-62004dc97f3e: -====================== -SyncE and Introduction -====================== +================== +SyncE Introduction +================== Intel's Westport Channel and Logan Beach NICs support a built-in GNSS module and the ability to distribute clock via Synchronous Ethernet (SyncE). This @@ -15,7 +15,7 @@ additional details if required. .. important:: - Reference the user guide for their Westport Channel or Logan Beach NIC for + Reference the user guide for their Westport Channel or Logan Beach |NIC| for additional information on configuring these features. The intent of this section is to explain how these parameters can be set, rather than describing each possible configuration. diff --git a/doc/source/system_configuration/kubernetes/instance-specific-considerations-d9d9509c79dd.rst b/doc/source/system_configuration/kubernetes/instance-specific-considerations-d9d9509c79dd.rst index 49b3d882d..ab4727cb5 100644 --- a/doc/source/system_configuration/kubernetes/instance-specific-considerations-d9d9509c79dd.rst +++ b/doc/source/system_configuration/kubernetes/instance-specific-considerations-d9d9509c79dd.rst @@ -32,6 +32,17 @@ NONE An interface with a port must be assigned to the ``ptp4l`` instance in order for it to start. +.. note:: + + It is recommended to configure one ``ptp4l`` instance per |PHC|. Some |NIC| + designs have a single |PHC| shared between all the ports on the |NIC|, while + others may have one |PHC| per port. Refer to the |NIC| documentation to + determine if a |NIC| has multiple |PHCs|. Configuring a ``ptp4l`` instance + with multiple interfaces, each with its own |PHC|, results in degraded + timing accuracy or other undesirable behaviors. This means that a given + ``ptp4l`` instance should only be configured with interfaces that are on the + same |NIC| and share a |PHC|. + phc2sys ======= @@ -89,7 +100,7 @@ named differently on each system. **Other requirements** An interface with a port must be assigned to the ``ts2phc`` instance in order -for time to be synced from GNSS to the phc. +for time to be synced from GNSS to the |PHC|. clock ===== @@ -108,8 +119,8 @@ NONE **Other requirements** -The clock type instance is a special instance used for configuring the NIC -control parameters of the Westport Channel or Logan Beach NIC clock +The clock type instance is a special instance used for configuring the |NIC| +control parameters of the Westport Channel or Logan Beach |NIC| clock interface parameters. These parameters can be applied to the interface of a clock instance |PTP| diff --git a/doc/source/system_configuration/kubernetes/ptp-instance-troubleshooting-7a7c576ee57a.rst b/doc/source/system_configuration/kubernetes/ptp-instance-troubleshooting-7a7c576ee57a.rst index 34699065e..b254a8df8 100644 --- a/doc/source/system_configuration/kubernetes/ptp-instance-troubleshooting-7a7c576ee57a.rst +++ b/doc/source/system_configuration/kubernetes/ptp-instance-troubleshooting-7a7c576ee57a.rst @@ -44,8 +44,8 @@ terminal output. .. code-block:: - ~(keystone_admin)]$ cat /etc/ptpinstance/ptp4l-ptp4l-legacy.conf - + ~(keystone_admin)]$ cat /etc/linuxptp/ptpinstance/ptp4l-ptp4l-legacy.conf + [global] ## ## Default Data Set @@ -66,8 +66,7 @@ terminal output. .. code-block:: - ~(keystone_admin)]$ ptp4l -f /etc/ptpinstance/ptp4l-ptp4l-legacy.conf - no interface specified + ~(keystone_admin)]$ ptp4l -f /etc/linuxptp/ptpinstance/ptp4l-ptp4l-legacy.conf In this example the ``ptp4l`` program indicates that there is no interface specified, which is confirmed by the contents of the config file above. @@ -90,7 +89,12 @@ Additional tools # General command format: sudo pmc -u -b 0 -f -s 'COMMAND GOES HERE' - eg. pmc -u -b 0 -f /etc/ptpinstance/ptp4l-ptp1.conf -s /var/run/ptp4l-ptp1 'get PORT_DATA_SET + + For Example: + + .. code-block:: + + pmc -u -b 0 -f /etc/linuxptp/ptpinstance/ptp4l-ptp1.conf -s /var/run/ptp4l-ptp1 ‘get PORT_DATA_SET’ :command:`PHC_CTL` diff --git a/doc/source/system_configuration/kubernetes/ptp-introduction-d981dd710bda.rst b/doc/source/system_configuration/kubernetes/ptp-introduction-d981dd710bda.rst index b709ed467..506d924ae 100644 --- a/doc/source/system_configuration/kubernetes/ptp-introduction-d981dd710bda.rst +++ b/doc/source/system_configuration/kubernetes/ptp-introduction-d981dd710bda.rst @@ -27,8 +27,8 @@ part of the linuxptp project (https://sourceforge.net/projects/linuxptp/). ``ptp4l`` ptp4l is the implementation of Precision Time Protocol according to the IEEE standard 1588 for Linux. It handles communication between |PTP| nodes as - well as setting the |PTP| Hardware Clock (PHC) on the NIC. See man ptp4l for - a complete list of configuration parameters. + well as setting the |PTP| Hardware Clock (PHC) on the NIC. Refer to the man + page (:command:`man ptp41`) for a complete list of configuration parameters. ``phc2sys`` phc2sys is used to synchronize the system time with a PHC. The PHC may be @@ -78,8 +78,10 @@ Overview of the |prod| configuration units ``currentUtcOffsetValid=1`` at the the ``ptp4l`` instance level to set this flag. - To return the CLOCK_TAI offset to 0, the ``currentUtcOffsetValid=1`` parameter - must be removed and the host must be restarted via lock/unlock. + To return the CLOCK_TAI offset to 0, the ``currentUtcOffsetValid=1`` + parameter must be removed using system ptp-instance-parameter delete and + the PTP configuration must be re-applied with :command:`system + ptp-instance-apply``. General information @@ -87,8 +89,9 @@ General information The relevant system locations for |PTP| instance configuration files are: -``/etc/ptpinstance/`` - Application configuration files, one per instance (excluding clock type). +``/etc/linuxptp/ptpinstance/`` + Application configuration files. A single configuration file is generated + for each configured instance. ``/etc/sysconfig/ptpinstance`` Environment variable files, one per instance