From: Ammar Mustafa <ammarmustafa34@gmail.com>
To: Andy Shevchenko <andriy.shevchenko@intel.com>
Cc: "Alisa-Dariana Roman" <alisa.roman@analog.com>,
"Jonathan Cameron" <jic23@kernel.org>,
"David Lechner" <dlechner@baylibre.com>,
"Nuno Sá" <nuno.sa@analog.com>,
"Andy Shevchenko" <andy@kernel.org>,
"Jonathan Corbet" <corbet@lwn.net>,
"Shuah Khan" <skhan@linuxfoundation.org>,
linux-iio@vger.kernel.org, linux-doc@vger.kernel.org,
linux-kernel@vger.kernel.org
Subject: Re: [PATCH] Docs: iio: ad7191: Correct clock configuration
Date: Fri, 27 Feb 2026 12:31:51 -0500 [thread overview]
Message-ID: <aaHVB1lLuXIw3pwt@ammar-VM2> (raw)
In-Reply-To: <aaHA8U3HrIbg8D46@ashevche-desk.local>
On Fri, Feb 27, 2026 at 06:06:09PM +0200, Andy Shevchenko wrote:
> On Fri, Feb 27, 2026 at 10:37:41AM -0500, Ammar Mustafa wrote:
> > Correct the ad7191 documentation to match the datasheet:
> > - Fix inverted CLKSEL pin logic: device should use external clock when low,
> > internal CMOS/crystal when high.
> > - Correct CMOS-compatible clock pin from MCLK2 to MCLK1.
>
> ...
>
> > -- When CLKSEL pin is tied LOW: Uses internal 4.92MHz clock (no clock property
> > - needed)
> > -- When CLKSEL pin is tied HIGH: Requires external clock source
> > +- When CLKSEL pin is tied LOW: Requires external clock source
> > - Can be a crystal between MCLK1 and MCLK2 pins
> > - - Or a CMOS-compatible clock driving MCLK2 pin
> > + - Or a CMOS-compatible clock driving MCLK1 pin and MCLK2 left unconnected
> > - Must specify the "clocks" property in device tree when using external clock
> > +- When CLKSEL pin is tied HIGH: Uses internal 4.92MHz clock (no clock property
> > + needed)
>
> Is it active-low or active-high pin?
>
> ...
>
> When I see such a confusion in the documentation I propose to replace HIGH/LOW
> to active/inactive or asserted/deasserted.
>
> And no need to swap the entries.
>
> --
> With Best Regards,
> Andy Shevchenko
>
>
I haven't seen anything in the documentation to believe clksel is
active-low. I agree that assert/deassert would remove this confusion. I
can resend the patch with this change and without the swapped entries.
Thanks,
Ammar Mustafa
next prev parent reply other threads:[~2026-02-27 17:31 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-02-27 15:37 [PATCH] Docs: iio: ad7191: Correct clock configuration Ammar Mustafa
2026-02-27 16:06 ` Andy Shevchenko
2026-02-27 17:31 ` Ammar Mustafa [this message]
2026-02-27 17:43 ` Andy Shevchenko
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=aaHVB1lLuXIw3pwt@ammar-VM2 \
--to=ammarmustafa34@gmail.com \
--cc=alisa.roman@analog.com \
--cc=andriy.shevchenko@intel.com \
--cc=andy@kernel.org \
--cc=corbet@lwn.net \
--cc=dlechner@baylibre.com \
--cc=jic23@kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-iio@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=nuno.sa@analog.com \
--cc=skhan@linuxfoundation.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox