[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <kam6fgc7ykxwnksu562etrib2z4w3sucvr27ojxq62iwyrdai3@i76ygp2anscy>
Date: Sat, 20 Sep 2025 11:25:40 +0530
From: Manivannan Sadhasivam <mani@...nel.org>
To: Alex Elder <elder@...cstar.com>
Cc: robh@...nel.org, krzk+dt@...nel.org, conor+dt@...nel.org,
lpieralisi@...nel.org, kwilczynski@...nel.org, bhelgaas@...gle.com, vkoul@...nel.org,
kishon@...nel.org, dlan@...too.org, paul.walmsley@...ive.com, palmer@...belt.com,
aou@...s.berkeley.edu, alex@...ti.fr, p.zabel@...gutronix.de, tglx@...utronix.de,
johan+linaro@...nel.org, thippeswamy.havalige@....com, namcao@...utronix.de,
mayank.rana@....qualcomm.com, shradha.t@...sung.com, inochiama@...il.com,
quic_schintav@...cinc.com, fan.ni@...sung.com, devicetree@...r.kernel.org,
linux-phy@...ts.infradead.org, linux-pci@...r.kernel.org, spacemit@...ts.linux.dev,
linux-riscv@...ts.infradead.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH 3/6] dt-bindings: phy: spacemit: introduce PCIe root
complex
On Fri, Sep 19, 2025 at 03:14:05PM -0500, Alex Elder wrote:
> On 9/15/25 3:14 AM, Manivannan Sadhasivam wrote:
> > On Wed, Aug 13, 2025 at 01:46:57PM GMT, Alex Elder wrote:
> >
> > Subject should have 'pci' prefix, not 'phy'.
>
> OK I'll update that in the next version.
>
> > > Add the Device Tree binding for the PCIe root complex found on the
> > > SpacemiT K1 SoC. This device is derived from the Synopsys Designware
> > > PCIe IP. It supports up to three PCIe ports operating at PCIe gen 2
> > > link speeds (5 GT/sec). One of the ports uses a combo PHY, which is
> > > typically used to support a USB 3 port.
> > >
> > > Signed-off-by: Alex Elder <elder@...cstar.com>
> > > ---
> > > .../bindings/pci/spacemit,k1-pcie-rc.yaml | 141 ++++++++++++++++++
> > > 1 file changed, 141 insertions(+)
> > > create mode 100644 Documentation/devicetree/bindings/pci/spacemit,k1-pcie-rc.yaml
> > >
> > > diff --git a/Documentation/devicetree/bindings/pci/spacemit,k1-pcie-rc.yaml b/Documentation/devicetree/bindings/pci/spacemit,k1-pcie-rc.yaml
> > > new file mode 100644
> > > index 0000000000000..6bcca2f91a6fd
> > > --- /dev/null
> > > +++ b/Documentation/devicetree/bindings/pci/spacemit,k1-pcie-rc.yaml
> > > @@ -0,0 +1,141 @@
> > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> > > +%YAML 1.2
> > > +---
> > > +$id: http://devicetree.org/schemas/pci/spacemit,k1-pcie-rc.yaml#
> > > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > > +
> > > +title: SpacemiT K1 PCI Express Root Complex
> > > +
> > > +maintainers:
> > > + - Alex Elder <elder@...cstar.com>
> > > +
> > > +description:
> > > + The SpacemiT K1 SoC PCIe root complex controller is based on the
> > > + Synopsys DesignWare PCIe IP.
> > > +
> > > +properties:
> > > + compatible:
> > > + const: spacemit,k1-pcie-rc.yaml
> > > +
> > > + reg:
> > > + items:
> > > + - description: DesignWare PCIe registers
> > > + - description: ATU address space
> > > + - description: PCIe configuration space
> > > + - description: Link control registers
> > > +
> > > + reg-names:
> > > + items:
> > > + - const: dbi
> > > + - const: atu
> > > + - const: config
> > > + - const: link
> > > +
> > > + clocks:
> > > + items:
> > > + - description: DWC PCIe Data Bus Interface (DBI) clock
> > > + - description: DWC PCIe application AXI-bus Master interface clock
> > > + - description: DWC PCIe application AXI-bus Slave interface clock.
> > > +
> > > + clock-names:
> > > + items:
> > > + - const: dbi
> > > + - const: mstr
> > > + - const: slv
> > > +
> > > + resets:
> > > + items:
> > > + - description: DWC PCIe Data Bus Interface (DBI) reset
> > > + - description: DWC PCIe application AXI-bus Master interface reset
> > > + - description: DWC PCIe application AXI-bus Slave interface reset.
> > > + - description: Global reset; must be deasserted for PHY to function
> > > +
> > > + reset-names:
> > > + items:
> > > + - const: dbi
> > > + - const: mstr
> > > + - const: slv
> > > + - const: global
> > > +
> > > + interrupts-extended:
> > > + maxItems: 1
> >
> > What is the purpose of this property? Is it for MSI or INTx?
>
> It is for MSIs, which are translated into this interrupt.
> I'll add a short description indicating this.
>
> Is there a better way to represent this?
>
For external MSI controllers, it is recommended to use 'msi-map' property as the
client often need to pass RID, RID length and other sideband data to the MSI
controller.
> > > +
> > > + spacemit,syscon-pmu:
> > > + description:
> > > + PHandle that refers to the APMU system controller, whose
> > > + regmap is used in managing resets and link state.
> > > + $ref: /schemas/types.yaml#/definitions/phandle
> > > +
> > > + device_type:
> > > + const: pci
> > > +
> > > + max-link-speed:
> > > + const: 2
> >
> > Why do you need to limit it to 5 GT/s always?
>
> It's what the hardware overview says is the speed
> of the ports.
> PCIE PortA Gen2x1
> PCIE PortB Gen2x2
> PCIE PortC Gen2x2
>
> But I think what you're asking might be "why do you
> need to specify in DT that the link speed is limited".
> And in that case, I realize now that it is not needed.
> I will specify dw_pcie->max_link_speed to 2 before
> calling dw_pcie_host_init().
>
You only need to specify this property if you want to limit the link speed to a
certain data rate by the controller driver than what is supported by the
hardware.
Looks like your hardware supports 5 GT/s by default for all ports. So you can
omit this property and also no need to set 'dw_pcie->max_link_speed'. In the
absence of this property, 'dw_pcie->max_link_speed' will be populated with the
hardware default value, which will be 2 in your case.
> If that's not what you meant, please let me know.
>
> > > + num-viewport:
> > > + const: 8
> > > +
> > > +required:
> > > + - compatible
> > > + - reg
> > > + - clocks
> > > + - clock-names
> > > + - resets
> > > + - reset-names
> > > + - spacemit,syscon-pmu
> > > + - "#address-cells"
> > > + - "#size-cells"
> > > + - device_type
> > > + - max-link-speed
> >
> > Same comment as above.
> >
> > > + - bus-range
> > > + - num-viewport
> > > +
> > > +additionalProperties: false
> > > +
> > > +examples:
> > > + - |
> > > + #include <dt-bindings/clock/spacemit,k1-syscon.h>
> > > + pcie0: pcie@...00000 {
> > > + compatible = "spacemit,k1-pcie-rc";
> > > + reg = <0x0 0xca000000 0x0 0x00001000>,
> > > + <0x0 0xca300000 0x0 0x0001ff24>,
> > > + <0x0 0x8f000000 0x0 0x00002000>,
> > > + <0x0 0xc0b20000 0x0 0x00001000>;
> > > + reg-names = "dbi",
> > > + "atu",
> > > + "config",
> > > + "link";
> > > +
> > > + ranges = <0x01000000 0x8f002000 0x0 0x8f002000 0x0 0x100000>,
> >
> > I/O port CPU address starts from 0.
>
> First, I'm not sure what this comment means.
>
Sorry, I meant to say 'PCI address' not 'CPU address'. The second element in
your 'ranges' example corresponds to the PCI start address of the I/O port and
it should always start from 0. Also, the encoding for both tuples are wrong. It
should be:
ranges = <0x01000000 0x0 0x00000000 0x8f002000 0x0 0x100000>,
<0x02000000 0x0 0x80000000 0x80000000 0x0 0x0f000000>;
- Mani
--
மணிவண்ணன் சதாசிவம்
Powered by blists - more mailing lists