Re: [PATCH v2] dt-bindings: power: Convert bq27xxx dt to yaml

[Dan Murphy <dmurphy@ti.com>]

Sebastian

On 5/11/20 10:30 AM, Sebastian Reichel wrote:
> Hi,
>
> On Mon, May 11, 2020 at 09:55:11AM -0500, Dan Murphy wrote:
>> On 5/11/20 9:57 AM, Sebastian Reichel wrote:
>>> On Mon, May 11, 2020 at 09:29:59AM -0500, Dan Murphy wrote:
>>>> On 5/11/20 9:32 AM, Sebastian Reichel wrote:
>>>>> On Mon, May 11, 2020 at 07:25:06AM -0500, Dan Murphy wrote:
>>>>>> On 5/10/20 11:17 AM, Sebastian Reichel wrote:
>>>>>>> This needs is missing the power-supplies property. The N900 DT
>>>>>>> contains a bq27200 referencing the charger, so it should fail the DT
>>>>>>> check without the property being listed here.
>>>>>> Hmm.  I ran the dt checker specifically on the binding and it did not fail.
>>>>>> Unless I need to build some other DTs as well.
>>>>>> Either I will have the power-supplies property
>>>>> I just tried it myself. The problem is the way you are specifying
>>>>> the compatible strings. This is the parsing result:
>>>>>
>>>>> enum: ['ti,bq27200 - BQ27200', 'ti,bq27210 - BQ27210', 'ti,bq27500 - deprecated,
>>>>>          use revision specific property below', ...
>>>>>
>>>>> You can see this in Documentation/devicetree/bindings/processed-schema.yaml, which
>>>>> is generated by running the check. The compatible comments need a # as separation
>>>>> character like this to generate proper bindings:
>>>>>
>>>>> properties:
>>>>>      compatible:
>>>>>        enum:
>>>>>          - ti,bq27200 # BQ27200
>>>>>          - ti,bq27210 # BQ27210
>>>>>          - ti,bq27500 # deprecated, use revision specific property below
>>>> Well honestly not sure why we need the comment either. These are pretty
>>>> self explanatory maybe we should just remove the additional comments
>>> Fine with me.
>> Ack
>>>> Any consideration on just removing the deprecated values?
>>> Let's keep them with their comment for now. Removing them should
>>> start with marking them as depracated in the binding and generating
>>> a runtime warning in the driver, so that people become aware of the
>>> problem. At least for ti,bq27500 we have mainline users At least for
>>> ti,bq27500 we have mainline users.
>> There are only 2 dts files that have this reference unless we are not sure
>> which device is actually in use.
> DT is considered ABI and one is supposed to be able to boot a new
> kernel with an old DT. It's not enough to just update the in-tree
> dts files. I suppose we can consider removing support for the old
> compatible values after having the warning being printed for some
> time and the mainline users being converted to the new binding.

Yes I know. I may have said that before.

After looking at the driver and how this is all stitched together I 
think I am just going to stick to the DT conversion as is.

I will make the basic changes for conversion but any changes to the 
compatibles should be done later.

Dan


> -- Sebastian