Re: [PATCH] iio: light: ltrf216a: Drop undocumented ltr,ltrf216a compatible string

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 07/07/2024 15:37, Jonathan Cameron wrote:
> On Sun, 7 Jul 2024 14:02:39 +0200
> Krzysztof Kozlowski <krzk@xxxxxxxxxx> wrote:
> 
>> On 05/07/2024 12:42, Shreeya Patel wrote:
>>> On Friday, July 05, 2024 15:20 IST, Marek Vasut <marex@xxxxxxx> wrote:
>>>   
>>>> The "ltr,ltrf216a" compatible string is not documented in DT binding
>>>> document, remove it.
>>>>
>>>> Signed-off-by: Marek Vasut <marex@xxxxxxx>
>>>> ---
>>>> Cc: Conor Dooley <conor+dt@xxxxxxxxxx>
>>>> Cc: Jonathan Cameron <jic23@xxxxxxxxxx>
>>>> Cc: Krzysztof Kozlowski <krzk+dt@xxxxxxxxxx>
>>>> Cc: Lars-Peter Clausen <lars@xxxxxxxxxx>
>>>> Cc: Marek Vasut <marex@xxxxxxx>
>>>> Cc: Rob Herring <robh@xxxxxxxxxx>
>>>> Cc: Shreeya Patel <shreeya.patel@xxxxxxxxxxxxx>
>>>> Cc: devicetree@xxxxxxxxxxxxxxx
>>>> Cc: linux-iio@xxxxxxxxxxxxxxx
>>>> ---
>>>>  drivers/iio/light/ltrf216a.c | 1 -
>>>>  1 file changed, 1 deletion(-)
>>>>
>>>> diff --git a/drivers/iio/light/ltrf216a.c b/drivers/iio/light/ltrf216a.c
>>>> index 68dc48420a886..78fc910fcb18c 100644
>>>> --- a/drivers/iio/light/ltrf216a.c
>>>> +++ b/drivers/iio/light/ltrf216a.c
>>>> @@ -528,7 +528,6 @@ MODULE_DEVICE_TABLE(i2c, ltrf216a_id);
>>>>  
>>>>  static const struct of_device_id ltrf216a_of_match[] = {
>>>>  	{ .compatible = "liteon,ltrf216a" },
>>>> -	{ .compatible = "ltr,ltrf216a" },
>>>>  	{}  
>>>
>>> This compatible string with a different vendor prefix was added for a specific reason.
>>> Please see the commit message of the following patch :-
>>> https://lore.kernel.org/all/20220511094024.175994-2-shreeya.patel@xxxxxxxxxxxxx/  
>>
>> And adding this specific compatible was clearly NAKed:
>> https://lore.kernel.org/all/20220516170406.GB2825626-robh@xxxxxxxxxx/
>>
>> yet you still added it. That's a deliberate going around maintainer's
>> decision.
>>
> 
> The statement from Rob was very specific. The schema is not applicable to ACPI bindings
> - that's the basis on which he doesn't want this in the schema. Specifically
> because "There's not really any point in having this in schema as you can't
> use that schema with ACPI".
> 
> That is true (though arguably you could with sufficient tooling apply the schema
> to the relevant part of DSDT).
> 
> The compatible is usable, via PRP0001 ACPI IDs.

Uh, that's sounds like a slippery slope. To my understanding, PRP0001
allows to create ACPI IDs from OF IDs, so it requires to have a valid OF
ID. Valid OF ID requires bindings, doesn't it?

If it does not, then anyone can add any Devicetree properties, claiming
it is for ACPI ID thus not providing bindings (or bypassing bindings
review / NAK).

> 
>>>
>>> We were very well aware that not documenting this was going to generate a warning so  
>>
>> You *CANNOT* have undocumented compatibles.
> 
> Why not? This corner case is a valid reason for that to be allowed.
> You cannot use that compatible with DT bindings.  Absolutely.  The compatible
> has other uses...

Okay. With that approach what stops anyone from submitting DTS using
that compatible (claiming there is a driver for that compatible)?

> 
> 
>>
>>> we tried to fix that with a deprecated tag but it was NAKd by Rob. What we understood  
>>
>> Because the driver was NAKed obviously as well.
>>
>>> from his last message was that it wasn't necessary to fix the DT warning.  
>>
>> I am quite angry that maintainer tells you something, but you push your
>> patch through because apparently you need to fulfill your project
>> requirements.
> 
> I think this is a fundamental misunderstanding of the situation and probably
> at least partly my fault for not clarifying my reading of the situation more
> fully at the time.
> 
> As far as I am concerned. The situation is:
> 1) Existing shipping consumer device.  We have 100s of cases of ACPI bindings
>    that exist just to deal with garbage firmware's.  The folk involved in
>    reviewing these have pushed back hard for a long time, but sadly there
>    is still a lot of garbage shipping because Windows lets it through and
>    Linux support comes second.  It's made even worse by Microsoft defining
>    their own standards that aren't compliant with ACPI as they don't
>    even bother with reserving the methods IDs.  ROTM for example.

Hm, and these devices do not provide normal ACPI IDs? They use Of-like
ones? I don't know that much about ACPI, but aren't they coming without
vendor prefix thus "ltr,ltrf216a" is just wrong and should be "lTRF216A"
alone?

> 
> 2) This is an ACPI binding, it just happens to use a DT compatible via the
>    PRP0001 mechanism.  Yes, we strongly discourage people doing that in
>    shipping products but there have been other cases of it.

OK, is this the case here?

> 
> 3) Shreeya read a distinction (that I also agree with) between the schema
>    and the compatible list.  The schema does not apply to this situation
>    (because we can't actually check it today for DSDT) hence Rob's Nack
>    was making the point it was inappropriate to carry it there.
> 
> So, I don't see this as a deliberate attempt to bypass a maintainer Nack.
> I'd love to be in a position to say no on ACPI bindings that are garbage
> (there are a lot of them) but Windows is dominant in that space so
> we get stuck with their mess.  On server's it is a different game
> and the kernel community regularly gets significant changes made.

Original discussion had only vague statement of "vendor prefix name as
'ltr' through ACPI". But what does it even mean? What ACPI ID is
reported by these devices?

Best regards,
Krzysztof





[Index of Archives]     [Device Tree Compilter]     [Device Tree Spec]     [Linux Driver Backports]     [Video for Linux]     [Linux USB Devel]     [Linux PCI Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Yosemite Backpacking]


  Powered by Linux