Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:6 as permitted sender) client-ip=2620:137:e000::3:6;
Date:   Sun, 22 Oct 2023 12:17:55 -0500
From:   Jeff LaBundy <jeff@labundy.com>
To:     Karel Balej <karelb@gimli.ms.mff.cuni.cz>
Cc:     Karel Balej <balejk@matfyz.cz>,
        Dmitry Torokhov <dmitry.torokhov@gmail.com>,
        Rob Herring <robh+dt@kernel.org>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
        Conor Dooley <conor+dt@kernel.org>,
        Markuss Broks <markuss.broks@gmail.com>,
        linux-input@vger.kernel.org, devicetree@vger.kernel.org,
        linux-kernel@vger.kernel.org,
        Duje =?utf-8?Q?Mihanovi=C4=87?= <duje.mihanovic@skole.hr>,
        ~postmarketos/upstreaming@lists.sr.ht
Subject: Re: [PATCH 2/2] input: Imagis: add support for the IST3032C
 touchscreen
Message-ID: <ZTVZQ+Po20pcDWm8@nixie71>
References: <20230926173531.18715-1-balejk@matfyz.cz>
 <20230926173531.18715-3-balejk@matfyz.cz>
 <ZROIKSVCiTI3VB2B@nixie71>
 <CVUQTCJBG265.1MTSYOLY0FR7Q@gimli.ms.mff.cuni.cz>
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <CVUQTCJBG265.1MTSYOLY0FR7Q@gimli.ms.mff.cuni.cz>
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?hlgoddN5n1XTjkRtkJLQEXiO45JzeToXt168/lujY0r5Mk4sLLVBCiz447Ar?=
 =?us-ascii?Q?nWyyCUnbKRSqkjFGDZMlvWkzi3nBbh5uPrIGKo8/RCpL9PZDaTwsFN2lE6wh?=
 =?us-ascii?Q?rqHEZ54n5mnygDVVQ4j9gG7Frfdvdx+pYErZNYZPAQ9Sc0lrTAGqh6WN+mpd?=
 =?us-ascii?Q?ngzP21MwJK7Opm6KtP35ApDNnRnz6EPZESmD9QTJBS6ZzWKN9OUhYP6vQZiO?=
 =?us-ascii?Q?qqBchlK3JxhT2Y3/qBtFo1ENA3mlHNDvPfueZI5yeu+csFvZRkvRNe9+uH4Y?=
 =?us-ascii?Q?SRfCo8V2px1iy70GyvWcfcGEg13vFS5Bhw59qhc+6vIDqLm5CRb7qAn0JdGK?=
 =?us-ascii?Q?gaBf/nvhJMx7Nhari6wXNE3UwL4GTDj0e8RzWskOzPRIMcY+xD/jXVbwKJRl?=
 =?us-ascii?Q?2g7FDBFp+WPih01ENVcYN/BZHq3GrZBqOc7XiH3KeGgWf+ziu6Wug8cg+Xfd?=
 =?us-ascii?Q?JKCggVTftCgCak0WnnQkvAAMztOtHQH1zm7WckEPW2qrOEbREQG+xQFdlFaQ?=
 =?us-ascii?Q?hC/rfqqzKk6/uM1rqFZgO7cl57T1d0NDjUbi8aFJf7UlIBIga/jCQSjHpHIX?=
 =?us-ascii?Q?s5QvoIAoAuKNtJaeybGh4p3ojzEX3kCHZpFkEdHr0hNto9U5nFc9z8j743X6?=
 =?us-ascii?Q?Dg9JpWWsa9Y7djEbFgszFwOXcGSMN4rL0yzuanWMiLrRNfI6t1HPDQxJT9hc?=
 =?us-ascii?Q?T58SYBZBSwKOWya3lwTpz0r6EKgWmFd47Ik6Jfbv5DzUblla0gxnIPlE0o+a?=
 =?us-ascii?Q?u7RXe+z93WfzOpAUsV0UEpvuGkyOV45djmZL4fnKu5PDtqamOxV8V4xCh4R1?=
 =?us-ascii?Q?EhnkFmimcDc7OGz9D+zr6Ag+w+AwBtyZIYg8FY1gU5qFsdRdljjftuM8rUIg?=
 =?us-ascii?Q?7GQl4KCpZ0Y5JSyd6U3e1kx82VLebBHcvImP9wAz5hD4qao4hh+QXkRtpoH/?=
 =?us-ascii?Q?QW8KLuFfhFLkpGEbS0xkVdJ73R4sl2NtDqIMfNLj6oNCrApn68/kwDP+dRNH?=
 =?us-ascii?Q?wvNDQn171Djg2jh2A/SADzHocIYs3nXKaM71ILLzFp4AxHGP7lCa7cSLBc1E?=
 =?us-ascii?Q?JudpzQcoC/YHDP0kzrL6sct7AdNqpdDulwECiYsOczxaSUmpOhdvs6Tde2Yb?=
 =?us-ascii?Q?wp8HwDKv1g0GGLNWt+6qAXvXVvFhuI7dUGuEbx7e36KLI0As5PMV2vZMdkcM?=
 =?us-ascii?Q?8nY/hTMV2MX6tH9RAK97uRsKOAB3FZwZqql2Jv910/8qYKXPYFBe2lI8QZPC?=
 =?us-ascii?Q?phPEodda46y2BL0e9HJenxuvO8+QNhoHCQz4TrbWcVyYJMApqyKOqBddTzIp?=
 =?us-ascii?Q?pj5IF6nM3MQ4GMRNqTmWLA/MHLvrt3ZtaUPsL28LCZLNzsHWuXD+XvZ7xT8p?=
 =?us-ascii?Q?w9CkUNNN6TRtz/Qx1TYcg/cXhQzXv3iF+35YQY3uDlEab9IEv5EGLHwL0nVi?=
 =?us-ascii?Q?ZiRZ18P66fwBHWlBZnM3bB5f/ENU3znvn0WdSg+xjKjO/ZdqzW5jT6D1Sy4e?=
 =?us-ascii?Q?yebV+wLkgg5VATujBk3XDYV8lWdwJ202tcLiBnW7gU/vLvYFb55MXYY5OCYp?=
 =?us-ascii?Q?QHRG5tLwL6Bu0lW/ClkpS9d4dsvJ1V4RDqfAaKh+?=
X-OriginatorOrg: labundy.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 50706b65-4e7d-42e9-431b-08dbd322d8ba
X-MS-Exchange-CrossTenant-AuthSource: SN4PR0801MB3774.namprd08.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Oct 2023 17:18:02.5373
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 00b69d09-acab-4585-aca7-8fb7c6323e6f
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: b1LCs8vIHwYmHe4lZx8vPC4vOWbdM/LTCLv0N43eo0j9bq46UygtwYfA3w01tzNq0YkvD1I/SH5rVk94Neulgw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS0PR08MB8980
X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID,
	HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE,
	SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on pete.vger.email
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (pete.vger.email [0.0.0.0]); Sun, 22 Oct 2023 10:18:21 -0700 (PDT)

Hi Karel,

On Thu, Sep 28, 2023 at 07:56:45PM +0200, Karel Balej wrote:
> Hello, Jeff,
> 
> thank you very much for your feedback.
> 
> > > +	if (chip_id == IST3032C_WHOAMI) {
> > > +		/*
> > > +		 * if the regulator voltage is not set like this, the touchscreen
> > > +		 * generates random touches without user interaction
> > > +		 */
> > > +		error = regulator_set_voltage(ts->supplies[0].consumer, 3100000, 3100000);
> > > +		if (error)
> > > +			dev_warn(dev, "failed to set regulator voltage\n");
> > > +	}
> > > +
> >
> > Opinions may vary, but mine is that this kind of hard-coded board-level policy
> > does not belong in the driver. Surely the supply need not be equal to exactly
> > 3.1 V and this is merely an upper or lower limit? Assuming so, what if the board
> > designer opts to share this supply with another consumer that requires a specific
> > voltage not equal to 3.1 V, but still within the safe range of IST3032C?
> >
> > To me, this restriction belongs in dts, specifically within the regulator child
> > node referenced by the client which bears the new 'ist3032c' compatible string.
> > Maybe a better solution is to simply note this presumed silicon erratum in the
> > description of the vdd supply in the binding which, as Conor states, must not be
> > clubbed with driver patches.
> 
> I agree that the voltage should not be hardcoded. I do not know what the
> safe range for the touchscreen is though, because the downstream driver
> does exactly this. I will try to test it with several values within the
> range allowed by the regulator and see if I can determine some limits on
> when the "ghost" touches do not appear.
> 
> However I am not sure whether this setting should be moved to the
> regulator DT - it is my understanding that the DT for the regulator
> should list the min/max range *supported* by the regulator, not conform
> to requirements of its consumers, which should instead ask for the
> regulator to be set to a range they require themselves, via their driver
> - is it not so?
> 
> The regulator driver is not mainlined yet (although I managed to get the
> downstream code working with mainline), however the downstream DT
> contains much wider range of supported voltage (compared to those 3.1 V
> used by the touchscreen) - an information which would get lost if I set
> the DT for the regulator by the requirements of the touchscreen, which I
> believe would have similiar implications as what you said regarding
> using this regulator with other consumers.
> 
> What would seem a reasonable solution to me would be to move the voltage
> range values to the touchscreen DT (which incidentally is what the
> downstream driver does also, except it uses one value for both min and
> max), so that they would be set by the driver but not hardcoded in the
> code - what do you think about this?

I believe this has been clarified in the other thread with Markuss, but
just to close this out: in general, individual drivers should not be
setting the output value of a regulator. Instead, they should merely mark
themselves as a consumer of a regulator, and increment or decrement its
usage counter by enabling and disabling the regulator, respectively.

You are correct that the regulator node typically specifies the minimum
and maximum voltages supported by the regulator, but if your board has
a stricter range because said regulator is tied to something such as this
touchscreen controller, then you can override the maximum voltage with
something smaller (e.g. 3.1 V). The regulator framework will then set the
output voltage according to the ultimate range defined in the device tree.

Often times the baseline regulator nodes are defined in a PMIC-specific
.dtsi file, or part of a more generic board definition. Then, some nodes
are overridden at a higher level in the heirarchy tailored to the board,
or an overlay applied by the bootloader.

> 
> Best regards,
> K. B.

Kind regards,
Jeff LaBundy