dt-bindings: phy: rockchip,pcie3-phy: add rockchip,rx-common-refclk-mode
authorNiklas Cassel <cassel@kernel.org>
Fri, 12 Apr 2024 12:58:15 +0000 (14:58 +0200)
committerVinod Koul <vkoul@kernel.org>
Sat, 13 Apr 2024 06:06:15 +0000 (11:36 +0530)
commit46492d10067660785a09db4ce9244545126a17b8
treef8c81f4c35437ba30242d571b067eba5da85f6d8
parent2f70bbddeb457580cef3ceb574506083b9272188
dt-bindings: phy: rockchip,pcie3-phy: add rockchip,rx-common-refclk-mode

>From the RK3588 Technical Reference Manual, Part1,
section 6.19 PCIe3PHY_GRF Register Description:
"rxX_cmn_refclk_mode"
RX common reference clock mode for lane X. This mode should be enabled
only when the far-end and near-end devices are running with a common
reference clock.

The hardware reset value for this field is 0x1 (enabled).
Note that this register field is only available on RK3588, not on RK3568.

The link training either fails or is highly unstable (link state will jump
continuously between L0 and recovery) when this mode is enabled while
using an endpoint running in Separate Reference Clock with No SSC (SRNS)
mode or Separate Reference Clock with SSC (SRIS) mode.
(Which is usually the case when using a real SoC as endpoint, e.g. the
RK3588 PCIe controller can run in both Root Complex and Endpoint mode.)

Add a rockchip specific property to enable/disable the rxX_cmn_refclk_mode
per lane. (Since this PHY supports bifurcation.)

Signed-off-by: Niklas Cassel <cassel@kernel.org>
Acked-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: Sebastian Reichel <sebastian.reichel@collabora.com>
Link: https://lore.kernel.org/r/20240412125818.17052-2-cassel@kernel.org
Signed-off-by: Vinod Koul <vkoul@kernel.org>
Documentation/devicetree/bindings/phy/rockchip,pcie3-phy.yaml