Merge pull request #95522 from openshift-cherrypick-robot/cherry-pick-95044-to-enterprise-4.17

[enterprise-4.17] TELCODOCS#2164: Added pin information

Author: stevsmit

modules/nw-ptp-dual-wpc-hardware-config-reference.adoc

@@ -36,3 +36,25 @@ The value that you configure depends on your specific measurements and SMA1 cabl
 |`spec.profile.ptp4lConf`
 |Set the value of `boundary_clock_jbod` to 1 to enable support for multiple NICs.
 |====
+
+Each value in the `spec.profile.plugins.e810.pins` list follows the `<function>` `<channel_number>` format.
+
+Where:
+
+`<function>`: Specifies the pin role. The following values are associated with the pin role:
+
+* `0`: Disabled
+* `1`: Receive (Rx) – for 1PPS IN
+* `2`: Transmit (Tx) – for 1PPS OUT
+
+`<channel_number>`: A number associated with the physical connector. The following channel numbers are associated with the physical connectors:
+
+* `1`: `SMA1` or `U.FL1`
+* `2`: `SMA2` or `U.FL2`
+
+Examples:
+
+* `2 1`: Enables `1PPS OUT` (Tx) on `SMA1`.
+* `1 1`: Enables `1PPS IN` (Rx) on `SMA1`.
+
+The PTP Operator passes these values to the Intel E810 hardware plugin and writes them to the sysfs pin configuration interface on each NIC.

modules/nw-ptp-e810-hardware-configuration-reference.adoc

@@ -24,10 +24,35 @@ The `SMA1` connector is bidirectional.
 The `SMA2` connector is bidirectional.
 |====
 
+You can set the pin configuration on the Intel E810 NIC by using the `spec.profile.plugins.e810.pins` parameters as shown in the following example:
+[source,yaml]
+----
+pins:
+      <interface_name>:
+        <connector_name>: <function> <channel_number>
+----
+
+Where:
+
+`<function>`: Specifies the role of the pin. The following values are associated with the pin role:
+
+* `0`: Disabled
+* `1`: Rx (Receive timestamping)
+* `2`: Tx (Transmit timestamping)
+
+`<channel number>`: A number associated with the physical connector. The following channel numbers are associated with the physical connectors:
+
+* `1`: `SMA1` or `U.FL1`
+* `2`: `SMA2` or `U.FL2`
+
+Examples:
+
+* `0 1`: Disables the pin mapped to `SMA1` or `U.FL1`.
+* `1 2`: Assigns the Rx function to `SMA2` or `U.FL2`.
+
 [NOTE]
 ====
-`SMA1` and `U.FL1` connectors share channel one.
-`SMA2` and `U.FL2` connectors share channel two.
+`SMA1` and `U.FL1` connectors share channel one. `SMA2` and `U.FL2` connectors share channel two.
 ====
 
 Set `spec.profile.plugins.e810.ublxCmds` parameters to configure the GNSS clock in the `PtpConfig` custom resource (CR).