1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/nw-ptp-dual-wpc-hardware-config-reference.adoc
2025-07-02 14:42:25 +00:00

60 lines
2.6 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// Module included in the following assemblies:
//
// * networking/ptp/configuring-ptp.adoc
:_mod-docs-content-type: REFERENCE
[id="nw-ptp-dual-e810-hardware-config-reference_{context}"]
= Dual E810 NIC configuration reference
Use this information to understand how to use the link:https://github.com/openshift/linuxptp-daemon/blob/release-4.14/addons/intel/e810.go[Intel E810 hardware plugin] to configure a pair of E810 network interfaces as PTP grandmaster clock (T-GM).
Before you configure the dual-NIC cluster host, you must connect the two NICs with an SMA1 cable using the 1PPS faceplace connections.
When you configure a dual-NIC T-GM, you need to compensate for the 1PPS signal delay that occurs when you connect the NICs using the SMA1 connection ports.
Various factors such as cable length, ambient temperature, and component and manufacturing tolerances can affect the signal delay.
To compensate for the delay, you must calculate the specific value that you use to offset the signal delay.
.E810 dual-NIC T-GM PtpConfig CR reference
[cols="1,2" width="90%", options="header"]
|====
|PtpConfig field
|Description
|`spec.profile.plugins.e810.pins`
a|Configure the E810 hardware pins using the PTP Operator E810 hardware plugin.
* Pin `2 1` enables the `1PPS OUT` connection for `SMA1` on NIC one.
* Pin `1 1` enables the `1PPS IN` connection for `SMA1` on NIC two.
|`spec.profile.ts2phcConf`
|Use the `ts2phcConf` field to configure parameters for NIC one and NIC two.
Set `ts2phc.master 0` for NIC two.
This configures the timing source for NIC two from the 1PPS input, not GNSS.
Configure the `ts2phc.extts_correction` value for NIC two to compensate for the delay that is incurred for the specific SMA cable and cable length that you use.
The value that you configure depends on your specific measurements and SMA1 cable length.
|`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.