Re: [PATCH v4 0/5] support ipq5332 platform

From: Jie Luo
Date: Fri Jan 05 2024 - 05:37:23 EST




On 1/5/2024 10:48 AM, Sergey Ryazanov wrote:
Hi Luo,

thank you for explaining the case in such details. I also have checked the related DTSs in the Linaro repository to be more familiar with the I/O mem layout. Specifically I checked these two, hope they are relevant to the discussion:
https://git.codelinaro.org/clo/qsdk/oss/kernel/linux-ipq-5.4/-/blob/NHSS.QSDK.12.4.r3/arch/arm64/boot/dts/qcom/ipq5332.dtsi
https://git.codelinaro.org/clo/qsdk/oss/kernel/linux-ipq-5.4/-/blob/NHSS.QSDK.12.4.r3/arch/arm64/boot/dts/qcom/ipq9574.dtsiThanks Sergey for looking into this driver support.

Please find my comments below.

On 03.01.2024 15:31, Jie Luo wrote:
On 1/2/2024 7:01 AM, Sergey Ryazanov wrote:
Hi Luo,

I have a few questions regarding the high level design of implementation. I hope that clarifying these topics will help us to find a good model for the case and finally merge a supporting code. Please find the questions below.

On 25.12.2023 10:44, Luo Jie wrote:
For IPQ5332 platform, there are two MAC PCSs, and qca8084 is
connected with one of them.

1. The Ethernet LDO needs to be enabled to make the PHY GPIO
    reset taking effect, which uses the MDIO bus level reset.

2. The SoC GCC uniphy AHB and SYS clocks need to be enabled
    to make the ethernet PHY device accessible.

3. To provide the clock to the ethernet, the CMN clock needs
    to be initialized for selecting reference clock and enabling
    the output clock.

4. Support optional MDIO clock frequency config.

5. Update dt-bindings doc for the new added properties.

Changes in v2:
    * remove the PHY related features such as PHY address
      program and clock initialization.
    * leverage the MDIO level GPIO reset for qca8084 PHY.

Changes in v3:
    * fix the christmas-tree format issue.
    * improve the dt-binding changes.

Changes in v4:
    * improve the CMN PLL reference clock config.
    * improve the dt-binding changes.

Luo Jie (5):
   net: mdio: ipq4019: move eth_ldo_rdy before MDIO bus register
   net: mdio: ipq4019: enable the SoC uniphy clocks for ipq5332 platform
   net: mdio: ipq4019: configure CMN PLL clock for ipq5332
   net: mdio: ipq4019: support MDIO clock frequency divider
   dt-bindings: net: ipq4019-mdio: Document ipq5332 platform

  .../bindings/net/qcom,ipq4019-mdio.yaml       | 141 ++++++++-
  drivers/net/mdio/mdio-ipq4019.c               | 288 ++++++++++++++++--
  2 files changed, 399 insertions(+), 30 deletions(-)

I'm asking these questions because after checking the patches and following the earlier discussion, the series is looks like an overloading of the MDIO driver with somehow but not strictly related functionality.


First, let me summarize the case. Feel free to correct me if I took something wrong. So, we have:
- a reference design contains IPQ5332 SoC + QCA8084 switch/Phy;

IPQ5322 SoC is currently connected with qca8386(switch that includes
QCA8084 PHY), the pure PHY chip qca8084 is currently connected on the
SoC IPQ9574.

As far as I understand these chips have standardized interfaces and QCA8386/QCA8084 can be reused with another SoC(s) in future. As well as IPQ5332 can be used with different phy. So now we are talking about some specific reference design. Isn't it?

Not the specific reference design.
You are right, these chips can be used with other SoC(s) with the
standardized interfaces supported.


- QCA8084 requires a reference clock for normal functionality;

The reference clock is selected for the CMN PLL block, which outputs
the clocks to the Ethernet devices including the qca8084 PHY for normal
functionality, also for other connected Ethernet devices, the CMN PLL
block is located in SoC such as ipq5332 and ipq9574.

- IPQ5332, as a chip, is able to provide a set of reference clocks for external devices;

Yes, the CMN PLL block of IPQ5332 provides the output clocks as the
working clocks for the external Ethernet devices such as the QCA8386
(switch chip), the reference clocks we are discussing is as the
reference clock source of the CMN PLL block.

Ok, I feel we have some ambiguity regarding the reference clock term here. Sure, CMN PLL needs a reference clock to functioning. And in the same time, the output clock provided by CMN PLL is a reference clock for QCA8384.

So, when I was talking about IPQ5332, I meant the whole chip including CMN PLL block. So, I asked about CMN PLL output clock. But you already clarified the SoC capabilities below.

Yes, Sergey.


- you want to configure IPQ5332 to provide the reference clock for QCA8084.

The reference clocks for CMN PLL block is configurable, and the output
clocks of CMN PLL are fixed, the output clocks are 50MHZ, which is given
to the external Ethernet devices.
here is the topology of clocks.
                    ---------
                    |        |
reference clock --->| CMN PLL|--> output 50M clocks --> qca8084/qca8386
                    |        |
                    ---------


So, the high level questions are:
1. Is QCA8084 capable to consume the clock from some other generator? Is it possible to clock QCA8084 from external XO/PLL/whatever?
No, the clock of qca8084/qca8386 is provided from the output clock of
CMN PLL as above.

Right, in case of pairing QCA8386 with IPQ5332, it is a good option to provide the clock from the SoC. But in general QCA8386 will be Ok with any 50 MHz clock. Right? I would like to say that thinking about this specific reference design being a single possible combination limits a scope of driver implementation options.

Yes, from the view of qca8386(qca8084), any input 50M reference clock
should be fine, but normally we should keep the same clock source for
qca8386 and the connected SoC to avoid any pps offset.

For example, we also tried the crystal 50M as the reference clock of
qca8386, since the SoC connected with qca8386 has the different clock
source from qca8386, which leads to some packet drop because of the
little bit of clock frequency shift.
Normally we should keep the clock source of qca8386 same as the clock
from the connected SoC.


2. Is IPQ5332 capable to provide reference clock to another switch model?

Yes, IPQ5332 can provide the reference clock to all connected Ethernet
devices, such as qca8386(switch), qca8081 phy and others.

Ok. Thank you for clarifying this.

3. Is the reference clock generation subsystem part of the MDIO block of IPQ5332?

the reference clock of CMN PLL block can be from wifi and external xtal, the CMN PLL is integrated in the MDIO block, CMN PLL is the independent
block that generates the clocks for the connected Ethernet devices.



And there are some tiny questions to make sure that we are on the same page:
a. What is the mentioned Ethernet LDO? AFAIK, LDO is some kind of gate (or switch) that enables clock output through an IPQ5332 pin. Isn't it?

That's correct, the LDO is for enabling the output 50M clock of CMN PLL
to the connected Ethernet device, which is controlled by the hardware
register on the IPQ5332.

And if it's true, then can you clarify, what exactly clock is outputted?

the 50M clock is outputted to the external Ethernet devices.

b. Is the Ethernet LDO part of the MDIO block of IPQ5332? According to iomem addresses that was used in the example reg property, the Ethernet LDO is not part of MDIO.

LDO is not the part of MDIO block, LDO has the different register space
from MDIO, which is located in the independent Ethernet part.

I have checked the Linaro's DTSs and noticed that mentioned LDO addresses belong to a node called 'ess-uniphy'. So these LDO(s) are part of UNIPHY block. So far, so good.

Yes, LDO is a part of uniphy block on IPQ5332.


c. Is the CMN PLL part of the MDIO block of IPQ5332? Again, according to iomem address, the CMN PLL is not part of MDIO.

No, CMN PLL is not the part of MDIO block, which is the independent
block, but it generates the clocks to the connected Ethernet devices
managed by MDIO bus, and the CMN PLL block needs to be configured
correctly to generate the clocks to make the MDIO devices(Ethernet
devices) working.

I came to the same conclusion checking Linaro's DTS. So the CMN PLL block looks like a small block implemented outside of any other block. Now I am starting to understand, why everything was putted into the MDIO driver. This PLL is so small that it doesn't seem to deserve a dedicated driver. Am I got it right?

Yes, you are right. CMN block is a independent block, we just need to
configure this block for selecting the reference clock and then do a
reset, which is a simple configuration and the related output clocks
to the Ethernet devices, so it is put in the MDIO driver currently.


d. Are GCC AHB & SYS clocks really consumed by MDIO itself? Or are they need for the external reference clock generation?

GCC AHB & SYS clocks are consumed by the uniphy(PCS) that is connected
with the Ethernet devices, so we can say the GCC AHB & SYS clocks are
consumed by the Ethernet devices, which is not for the external
reference clock generation, external reference clock of CMN PLL are the
fix clock that are from wifi or external XO.

Again this UNIPHY block. The UNIPHY node was missed from the upstream DTS, so it was decided to assign AHB & SYS clocks to MDIO. Right?

Right, currently there is no UNIPHY node defined in upstream.


What do you think about implementing this clocks handling functionality in a dedicated driver (e.g. uniphy) and create a dedicated DTS node for it? This driver could consume AHB & SYS clocks as well as consuming CMN PLL clock and be a clock provider for the Ethernet PHY (e.g. QCA8336).

As for AHB & SYS clocks, that can be consumed by the dedicated in the
future uniphy driver, but it seem there is a sequence issue with
qca8386(qca8084) as mentioned in the reply to your comment below.

Maybe we can enable these uniphy clocks in the GCC(SoC) provider driver?
i am not sure whether it is acceptable by the GCC(SoC) provider driver.


And looks like CMN PLL should be implemented as a dedicated micro driver. A driver that consumes fixed reference clocks (XO or from WiFi) and provides the clock to UNIPHY, to be passed to the Ethernet PHY by means of LDO gate.
the CMN PLL block can be realized as the independent driver.
maybe this CMN driver can be put in the directory drivers/clk/qcom?


To speed up the discussion, let me share my user's view of the reference clocks modeling. I would like to join the option that has already been suggested by the maintainers. It is better to implement reference clocks handling using the clocks API, and the clock subsystem will take care of enabling and configuring them.

And considering the expected answers to the above questions, I would like to suggest to implement the clock handling using a dedicated clock controlling driver. Or even using several of such tiny dedicated drivers. So DTS will become like this:

   ext_ref_clock: ext_ref_clock {
     compatible = "fixed-clock";
     clock-frequency = <48000000>;
   };

   eth_cmn_pll: clock-controller@9b000 {
     compatible = "qcom,eth-cmn-pll-ipq5223";
     reg = <0x9b000 0x800>;
     clocks = <&ext_ref_clock>; /* use external 48MHz clock */
   };

   phy0_ext_clk: clock-controller@7a00610 {
     compatible = "qcom,ipq-eth-ldo";
     reg = <0x7a00610 0x4>;
     clocks = <&eth_cmn_pll>;
   };

   mdio@90000 {
     compatible = "qcom,ipq4019-mdio";
     reg = <0x90000 0x64>;
     clocks = <&gcc GCC_MDIO_AHB_CLK>;

     ethernet-phy@1 {
       compatible = "...";
       reg = <1>;
       clocks = <&phy0_ext_clk>;
       reset-gpios = <&gcc ...>;
     };
   };

Thanks Sergey for the reference DTS.
Since the GPIO reset of qca8084/qca8386 is needed before configuring the
Ethernet device.

The configuration of and phy0_ext_clk(LDO) should be configured
firstly, which enables the clocks to the Ethernet devices, then the GPIO
reset of the connected Ethernet devices(such as qca8386) can take
effect, currently the GPIO reset takes the MDIO bus level reset.

So phy0_ext_clk can't be put in the PHY device tree node, one LDO
controls the clock output enabled to the connected Ethernet device such
as qca8386.

I still feel lost. Why it is impossible to specify clocks and resets in the PHY node and then implement the initialization sequence in the QCA8386 driver? I read the discussion of the QCA8386 driver submission. That driver modeling also looks a complex task. But it still puzzling me, why a part of the QCA8386 driver should be implemented inside the MDIO driver.

--
Sergey

Let me clarify the work sequence here.
1. configure CMN PLL to generate the reference clocks for qca8386(
same as qca8084).
2. enable LDO and configure the uniphy ahb & sys clocks.
3. do GPIO reset on qca8386(qca8084), the GPIO reset is for chip,
just need to do one GPIO reset on quad PHYs.
4. configure the initial clocks and resets, which are from NSSCC
clock provider driver, the NSSCC is also located in qca8386(qca8084),
these clocks and resets for all quad PHYs of qca8386(qca8084), which
just needs to be initialized one time.
5. then the qca8386(qca8084) PHY capability can be acquired correctly in
the PHY probe function.

Currently, The GPIO reset of qca8386(qca8084) takes use of the MDIO
level GPIO reset, so i put the LDO enable in the MDIO probe function
called before MDIO bus level reset.

To take your proposal, we can't use the MDIO bus level reset and MDIO
device level reset from the MDIO bus framework code, we need to do
reset in one PHY probe function, and the CMN driver and uniphy driver
needs to be initialized before PHY probe function, CMN driver is fine,
but it seems be not usual for uniphy(pcs) driver called before PHY probe
function.