Re: [net-next PATCH RFC v3 1/8] dt-bindings: net: document ethernet PHY package nodes

[Jie Luo]

On 1/9/2024 9:48 PM, Andrew Lunn wrote:
> > __| |_______________| |__
> > | PCS0 |          |PCS1 |
> > |______|          |_____|
> > |_______                |<---- REF clock 50MHZ
> > |      |------------    |
> > |NSSCC |    |clks  |rsts|<---- GPIO reset
> > |______|    |      |    |
> > |           V      V    |
> > |_______________________|
> > |     |     |     |     |
> > |PHY1 |PHY2 |PHY3 |PHY4 |
> > |_____|_____|_____|_____|
>
> Not the best of improvements. So the ref clock goes to the package,
> and then magically somehow gets to the NSSCC? Are there any more
> blocks it goes through before reaching the NSSCC? How does the GPIO
> reset get converted into multiple reset inside the package? Details,
> details, details.

The GPIO reset for the whole CHIP, like a GPIO reset on the single port
PHY qca8081, after the GPIO reset, the whole qca8084 chip is in the cold
reset state, so the initial clocks ans resets need to be initialized as
we are designing the clock model here.

As for the reference clock 50M input, this reference clock 50MHZ is
PLLed by the PCS1 block of qca8084, then there are fix 312.5MHZ is
generated to the NSSCC, NSSCC includes multiple RCG clock trees to
generate the clocks to the PHY and PCS, all these blocks(PCS and PHY)
are located in the qca8084 PHY chip, sorry for missed this diagram
info, updated the diagram as below, since the PCS generates the clocks
to NSSCC, there are initial clocks ans resets included for PCS need
to be configured before CHIP to work.

So the parent clocks are PCS0(uniphy0) and PCS1(uniphy1) for NSSCC,
as i provide the DT of NSSCC provider below, the parent clock rate
of PCS is changed according to the PHY link speed, and there are
also fix clock rate 312.5MHZ from PCS1, these parent clocks are
the root clock of RCG clock tree in NSSCC, the output clocks of
the RCG are consumed by the PHYs(PHY1-PHY4 and PCS0, PCS1).

   REF 50MHZ
      |
      |
______V__________________
| PCS1 |       ____|PCS0|
|______|      |    |____|
|  |  ________|         |
|  | |                  |<----------GPIO reset
|__V_V__                |
|      |------------    |
|NSSCC |    |clks  |rsts|
|______|    |      |    |
|           V      V    |
|_______________________|
|     |     |     |     |
|PHY1 |PHY2 |PHY3 |PHY4 |
|_____|_____|_____|_____|

> > There are difference clock trees generated from NSSCC for the different
> > PHYs, all clocks and resets for qca8084 CHIP working are internally
> > provided by the NSSCC.
>
> So show this in the block diagram.
>
> > Yes, Andrew, the NSSCC provider driver is probed based on the MDIO
> > device, the PHY CHIP occupies the MDIO addresses, so the NSSCC is
> > registered as the MDIO device.
> >
> > DT of the NSSCC device node:
> > mdio {
> >        #address-cells = <1>;
> >        #size-cells = <0>;
> >
> >        clock-controller@18 {
> >          compatible = "qcom,qca8084-nsscc";
> >          reg = <0x18>;
> >          clocks = <&qca8k_xo>,
> >                   <&qca8k_uniphy0_rx>,
> >                   <&qca8k_uniphy0_tx>,
> >                   <&qca8k_uniphy1_rx>,
> >                   <&qca8k_uniphy1_tx>,
> >                   <&qca8k_uniphy1_rx312p5m>,
> >                   <&qca8k_uniphy1_tx312p5m>;
> >          #clock-cells = <1>;
> >          #reset-cells = <1>;
> >          #power-domain-cells = <1>;
> >        };
> >      };
>   
> This does not make any sense. You have one clock input, 50MHz. So why
> are you listing 6 consumer clocks, not one? And where are the clocks
> this clock controller provides, clock-output-names=<...>;

Hi Andrew,
Sorry for the confusion.
the DT of the NSSCC device node is from the NSSCC provider driver, which
is under review currently as the link below.
https://lore.kernel.org/lkml/20231104034858.9159-2-quic_luoj@xxxxxxxxxxx/T/#m204c22d14be8f9dda7cd7f666ed726b8fc3301ef

the property "clocks" are the parent clock list of RCG clock tree in
the NSSCC driver, for qca8084 chip, there are two UNIPHY(PCS) as
mentioned in the diagram, there are also fix rate clocks 312.5MHZ,
the output clocks of NSSCC are not listed in the DT, which is same
as the GCC(IPQ SoC) DT.

The output clocks of NSSCC are provided by the DT of the clock consumer
such as the DT of qca8084 as below.
phy0 {
        reg = <0>;
        clocks = <&qca8k_nsscc NSS_CC_GEPHY0_SYS_CLK>;
        clock-names = "gephy0_sys";
        resets = <&qca8k_nsscc NSS_CC_GEPHY0_SYS_ARES>,
                 <&qca8k_nsscc NSS_CC_GEPHY0_ARES>;
        reset-names = "gephy0_sys", "gephy0_soft";
     };

In the DT node above, the qca8k_nssc refers to the NSSCC clock provider
DT node "clock-controller@18", the clock ID "NSS_CC_GEPHY0_SYS_CLK" is
also provided by the NSSCC clock provider driver.

The different PHY(PHY1-PHY4) of qca8084 has the different clock
tree(RCG), the clock consumer driver needs to define the DT properties
clocks and clcok-names to get the clocks from the NSSCC clock provider.

> I give up. Please consider this PHY driver NACKed.
>
> Get Linaro, or some other organisation with a lot of experience with
> mainline to take over the work.
>
> 	 Andrew