Received-SPF: pass (google.com: domain of linux-kernel+bounces-30330-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1;
Date: Thu, 18 Jan 2024 16:06:29 +0000
From: Conor Dooley <conor@kernel.org>
To: Ceclan Dumitru <mitrutzceclan@gmail.com>
Cc: linus.walleij@linaro.org, brgl@bgdev.pl, andy@kernel.org,
	linux-gpio@vger.kernel.org, Lars-Peter Clausen <lars@metafoo.de>,
	Jonathan Cameron <jic23@kernel.org>,
	Rob Herring <robh+dt@kernel.org>,
	Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
	Conor Dooley <conor+dt@kernel.org>,
	Michael Walle <michael@walle.cc>,
	Andy Shevchenko <andy.shevchenko@gmail.com>,
	Arnd Bergmann <arnd@arndb.de>, ChiaEn Wu <chiaen_wu@richtek.com>,
	Niklas Schnelle <schnelle@linux.ibm.com>,
	Leonard =?iso-8859-1?Q?G=F6hrs?= <l.goehrs@pengutronix.de>,
	Mike Looijmans <mike.looijmans@topic.nl>,
	Haibo Chen <haibo.chen@nxp.com>,
	Hugo Villeneuve <hvilleneuve@dimonoff.com>,
	David Lechner <dlechner@baylibre.com>,
	Ceclan Dumitru <dumitru.ceclan@analog.com>,
	linux-iio@vger.kernel.org, devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org
Subject: Re: [PATCH v12 1/2] dt-bindings: adc: add AD7173
Message-ID: <20240118-freebase-uptake-ec5fdf786d20@spud>
References: <20240118125001.12809-1-mitrutzceclan@gmail.com>
 <20240118-lunar-anthem-31bf3b9b351d@spud>
 <b96d5bfc-cc38-44c7-a88f-e7ac5e4eb71d@gmail.com>
Precedence: bulk
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
	protocol="application/pgp-signature"; boundary="LOsWyA9HATo5sHZY"
Content-Disposition: inline
In-Reply-To: <b96d5bfc-cc38-44c7-a88f-e7ac5e4eb71d@gmail.com>


--LOsWyA9HATo5sHZY
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Thu, Jan 18, 2024 at 05:51:20PM +0200, Ceclan Dumitru wrote:
>=20
>=20
> On 1/18/24 17:23, Conor Dooley wrote:
> > On Thu, Jan 18, 2024 at 02:49:22PM +0200, Dumitru Ceclan wrote:
>=20
> ...
>=20
> >> +  adi,clock-select:
> >> +    description: |
> >> +      Select the ADC clock source. Valid values are:
> >> +      int         : Internal oscillator
> >> +      int-out     : Internal oscillator with output on XTAL2 pin
> >> +      ext-clk     : External clock input on XTAL2 pin
> >> +      xtal        : External crystal on XTAL1 and XTAL2 pins
> >> +
> >> +    $ref: /schemas/types.yaml#/definitions/string
> >> +    enum:
> >> +      - int
> >> +      - int-out
> >> +      - ext-clk
> >> +      - xtal
> >> +    default: int
> > I am not a fan of properties like this one, that in my view reimplement
> > things that are supported by the regular clocks properties. I've got
> > some questions for you so I can understand whether or not this custom
> > property is required.
> >=20
> > Whether or not the ext-clk or xtal is used is known based on
> > clock-names - why is the custom property required to determine that?

> > If neither of those clocks are present, then the internal clock would be
> > used. Choosing to use the internal clock if an external one is provided
> > sounds to me like a software policy decision made by the operating
> > system.
>=20
> If there was no int-out, sure. I considered that the choice between int
> and int-out could be made here. So better for driver to choose int/int-ou=
t?

This part of my comments was specifically about choosing between use of
the internal clock when ext-clk or xtal are provided, which I think
excludes the possibility of using int-out, since the XTAL2 pin is an
input.

There's 3 situations:
- no external clock provided
- ext-clk provided
- xtal provided

For the former, you know you're in that state when no "clocks" property
is present. The latter two you can differentiate based on "clock-names".

Choosing to use the internal clock if an external clock is provided
seems to be a software policy decision, unless I am mistaken.

> >=20
> > Finally, if the ADC has a clock output, why can that not be represented
> > by making the ADC a clock-controller?
> >=20
>=20
> Was not familiar with this/did not cross my mind. So if xtal/ext-clk is
> present, the driver should detect it and disable the option for clock
> output? (Common pin XTAL2)

Yeah, if those clocks are provided you would not register as a clock
controller. If there is a user of the output clock, it should have its
own "clocks" property that references the ADC's output.

Your dt-binding could also make clocks/clock-names & clock-controller
mutually exclusive.

Cheers,
Conor.

--LOsWyA9HATo5sHZY
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iHUEABYIAB0WIQRh246EGq/8RLhDjO14tDGHoIJi0gUCZalMhAAKCRB4tDGHoIJi
0u1GAQDLF9wUQ+s0LZcpRfaCXxjuTn+bnIp1+ISbdg+ShIwu1QEAozUJEcnwITnj
abuVUXJ5gSOUB5wZwS7hYPBOxPhpngA=
=nOWF
-----END PGP SIGNATURE-----

--LOsWyA9HATo5sHZY--