[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <Ybhc0VW6JeJ4CNY9@matsya>
Date: Tue, 14 Dec 2021 14:28:57 +0530
From: Vinod Koul <vkoul@...nel.org>
To: Johan Jonker <jbx6244@...il.com>
Cc: heiko@...ech.de, robh+dt@...nel.org, kishon@...com,
p.zabel@...gutronix.de, yifeng.zhao@...k-chips.com,
kever.yang@...k-chips.com, cl@...k-chips.com,
linux-phy@...ts.infradead.org,
linux-arm-kernel@...ts.infradead.org,
linux-rockchip@...ts.infradead.org, devicetree@...r.kernel.org,
linux-kernel@...r.kernel.org
Subject: Re: [RFC PATCH v4 2/4] dt-bindings: phy: rockchip: Add Naneng combo
PHY bindings
On 08-12-21, 19:54, Johan Jonker wrote:
> From: Yifeng Zhao <yifeng.zhao@...k-chips.com>
>
> Add the compatible strings for the Naneng combo PHY found on rockchip SoC.
Why is this series still tagged RFC..?
>
> Signed-off-by: Yifeng Zhao <yifeng.zhao@...k-chips.com>
> Signed-off-by: Johan Jonker <jbx6244@...il.com>
> ---
>
> Changed V4:
> restyle
> remove some minItems
> add more properties
> remove reset-names
> move #phy-cells
> add rockchip,rk3568-pipe-grf
> add rockchip,rk3568-pipe-phy-grf
> ---
> .../phy/phy-rockchip-naneng-combphy.yaml | 127 ++++++++++++++++++
> 1 file changed, 127 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/phy/phy-rockchip-naneng-combphy.yaml
>
> diff --git a/Documentation/devicetree/bindings/phy/phy-rockchip-naneng-combphy.yaml b/Documentation/devicetree/bindings/phy/phy-rockchip-naneng-combphy.yaml
> new file mode 100644
> index 000000000..d309e2008
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/phy/phy-rockchip-naneng-combphy.yaml
> @@ -0,0 +1,127 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/phy/phy-rockchip-naneng-combphy.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Rockchip SoC Naneng Combo Phy Device Tree Bindings
> +
> +maintainers:
> + - Heiko Stuebner <heiko@...ech.de>
> +
> +properties:
> + compatible:
> + enum:
> + - rockchip,rk3568-naneng-combphy
> +
> + reg:
> + maxItems: 1
> +
> + clocks:
> + items:
> + - description: reference clock
> + - description: apb clock
> + - description: pipe clock
no maxItems or minItems for this?
> +
> + clock-names:
> + items:
> + - const: ref
> + - const: apb
> + - const: pipe
> +
> + resets:
> + items:
> + - description: exclusive apb reset line
> + - description: exclusive PHY reset line
Ditto?
> +
> + rockchip,dis-u3otg0-port:
> + type: boolean
> + description:
> + Disable the u3otg0 port.
why not make it explicit and say rockchip,disable-u3otg0-port
Also why should this port be disabled?
> +
> + rockchip,dis-u3otg1-port:
> + type: boolean
> + description:
> + Disable the u3otg1 port.
ditto
> +
> + rockchip,enable-ssc:
> + type: boolean
> + description:
> + In U3 and SATA mode the SSC option is already disabled by default.
> + In PCIE mode the option SSC can be enabled.
> + If Spread Spectrum Clocking (SSC) is used it is
> + required that a common reference clock is used by the link partners.
> + Most commercially available platforms with PCIe backplanes use
> + SSC to reduce EMI.
> +
> + rockchip,ext-refclk:
> + type: boolean
> + description:
> + Many PCIe connections, especially backplane connections,
> + require a synchronous reference clock between the two link partners.
> + To achieve this a common clock source, referred to as REFCLK in
> + the PCI Express Card Electromechanical Specification,
> + should be used by both ends of the PCIe link.
> + The PCIe PHY provides 100MHz differential clock output
> + (optional with SSC) in RC mode for system applications.
> +
> + rockchip,pipe-grf:
> + $ref: /schemas/types.yaml#/definitions/phandle
> + description:
> + Some additional phy settings are accessed through GRF regs.
> +
> + rockchip,pipe-phy-grf:
> + $ref: /schemas/types.yaml#/definitions/phandle
> + description:
> + Some additional pipe settings are accessed through GRF regs.
> +
> + rockchip,sgmii-mac-sel:
> + $ref: /schemas/types.yaml#/definitions/uint32
> + enum: [0, 1]
> + default: 0
> + description:
> + Select gmac0 or gmac1 to be used as SGMII controller.
> +
> + "#phy-cells":
> + const: 1
> +
> +required:
> + - compatible
> + - reg
> + - clocks
> + - clock-names
> + - resets
> + - rockchip,pipe-grf
> + - rockchip,pipe-phy-grf
> + - "#phy-cells"
> +
> +additionalProperties: false
> +
> +examples:
> + - |
> + #include <dt-bindings/clock/rk3568-cru.h>
> +
> + pipegrf: syscon@...50000 {
> + compatible = "rockchip,rk3568-pipe-grf", "syscon";
> + reg = <0xfdc50000 0x1000>;
> + };
> +
> + pipe_phy_grf0: syscon@...70000 {
> + compatible = "rockchip,rk3568-pipe-phy-grf", "syscon";
> + reg = <0xfdc70000 0x1000>;
> + };
> +
> + combphy0: phy@...20000 {
> + compatible = "rockchip,rk3568-naneng-combphy";
> + reg = <0xfe820000 0x100>;
> + clocks = <&pmucru CLK_PCIEPHY0_REF>,
> + <&cru PCLK_PIPEPHY0>,
> + <&cru PCLK_PIPE>;
> + clock-names = "ref", "apb", "pipe";
> + assigned-clocks = <&pmucru CLK_PCIEPHY0_REF>;
> + assigned-clock-rates = <100000000>;
> + resets = <&cru SRST_P_PIPEPHY0>, <&cru SRST_PIPEPHY0>;
> + rockchip,pipe-grf = <&pipegrf>;
> + rockchip,pipe-phy-grf = <&pipe_phy_grf0>;
> + #phy-cells = <1>;
> + };
> --
> 2.20.1
--
~Vinod
Powered by blists - more mailing lists