lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<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

Powered by Openwall GNU/*/Linux Powered by OpenVZ