Received-SPF: pass (google.com: domain of linux-kernel+bounces-123063-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249;
Date: Thu, 28 Mar 2024 15:20:46 +0100
From: Kory Maincent <kory.maincent@bootlin.com>
To: Andrew Lunn <andrew@lunn.ch>
Cc: Rob Herring <robh@kernel.org>, devicetree@vger.kernel.org, Thomas
 Petazzoni <thomas.petazzoni@bootlin.com>, Dent Project
 <dentproject@linuxfoundation.org>, "Rafael J. Wysocki" <rafael@kernel.org>,
 Jonathan Corbet <corbet@lwn.net>, Rob Herring <robh+dt@kernel.org>, Russell
 King <linux@armlinux.org.uk>, Conor Dooley <conor+dt@kernel.org>, Jakub
 Kicinski <kuba@kernel.org>, Frank Rowand <frowand.list@gmail.com>,
 Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, Heiner Kallweit
 <hkallweit1@gmail.com>, Russ Weight <russ.weight@linux.dev>, "David S.
 Miller" <davem@davemloft.net>, Greg Kroah-Hartman
 <gregkh@linuxfoundation.org>, Oleksij Rempel <o.rempel@pengutronix.de>,
 Paolo Abeni <pabeni@redhat.com>, Mark Brown <broonie@kernel.org>,
 netdev@vger.kernel.org, linux-doc@vger.kernel.org, Eric Dumazet
 <edumazet@google.com>, Luis Chamberlain <mcgrof@kernel.org>,
 linux-kernel@vger.kernel.org
Subject: Re: [PATCH net-next v6 11/17] dt-bindings: net: pse-pd: Add another
 way of describing several PSE PIs
Message-ID: <20240328152046.0b908024@kmaincent-XPS-13-7390>
In-Reply-To: <5230d786-44a8-45a0-ab0d-e1aa4ab6a836@lunn.ch>
References: <20240326-feature_poe-v6-0-c1011b6ea1cb@bootlin.com>
	<20240326-feature_poe-v6-11-c1011b6ea1cb@bootlin.com>
	<171146756753.2253156.218733720090104400.robh@kernel.org>
	<5230d786-44a8-45a0-ab0d-e1aa4ab6a836@lunn.ch>
Organization: bootlin
Precedence: bulk
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

On Thu, 28 Mar 2024 13:32:09 +0100
Andrew Lunn <andrew@lunn.ch> wrote:

> On Tue, Mar 26, 2024 at 10:39:28AM -0500, Rob Herring wrote:
> >=20
> > On Tue, 26 Mar 2024 15:04:48 +0100, Kory Maincent wrote: =20
> > > From: Kory Maincent (Dent Project) <kory.maincent@bootlin.com>
> > >=20
> > > PSE PI setup may encompass multiple PSE controllers or auxiliary circ=
uits
> > > that collectively manage power delivery to one Ethernet port.
> > > Such configurations might support a range of PoE standards and require
> > > the capability to dynamically configure power delivery based on the
> > > operational mode (e.g., PoE2 versus PoE4) or specific requirements of
> > > connected devices. In these instances, a dedicated PSE PI node becomes
> > > essential for accurately documenting the system architecture. This no=
de
> > > would serve to detail the interactions between different PSE controll=
ers,
> > > the support for various PoE modes, and any additional logic required =
to
> > > coordinate power delivery across the network infrastructure.
> > >=20
> > > The old usage of "#pse-cells" is unsuficient as it carries only the P=
SE PI
> > > index information.
> > >=20
> > > Signed-off-by: Kory Maincent <kory.maincent@bootlin.com>
> > > --- =20
> > My bot found errors running 'make DT_CHECKER_FLAGS=3D-m dt_binding_chec=
k'
> > on your patch (DT_CHECKER_FLAGS is new in v5.13):
> >=20
> > yamllint warnings/errors:
> >=20
> > dtschema/dtc warnings/errors:
> >=20
> >=20
> > doc reference errors (make refcheckdocs):
> > Warning: Documentation/devicetree/bindings/net/pse-pd/pse-controller.ya=
ml
> > references a file that doesn't exist:
> > Documentation/networking/pse-pd/pse-pi.rst
> > Documentation/devicetree/bindings/net/pse-pd/pse-controller.yaml:
> > Documentation/networking/pse-pd/pse-pi.rst =20
>=20
> Is this a false positive?

I suppose so as the file is added in the patch 10.

Regards,
--=20
K=C3=B6ry Maincent, Bootlin
Embedded Linux and kernel engineering
https://bootlin.com