This IP has only one interrupt, hence interrupt-names is not necessary
to have.
Since there is no user yet, simply remove interrupt-names.
Signed-off-by: AngeloGioacchino Del Regno <[email protected]>
---
.../devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml | 5 -----
1 file changed, 5 deletions(-)
diff --git a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
index 053264e60583..339bc9c00ac0 100644
--- a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
+++ b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
@@ -22,10 +22,6 @@ properties:
interrupts:
maxItems: 1
- interrupt-names:
- items:
- - const: PD_IRQB
-
connector:
type: object
$ref: ../connector/usb-connector.yaml#
@@ -58,7 +54,6 @@ examples:
tcpc {
compatible = "mediatek,mt6360-tcpc";
interrupts-extended = <&gpio26 3 IRQ_TYPE_LEVEL_LOW>;
- interrupt-names = "PD_IRQB";
connector {
compatible = "usb-c-connector";
--
2.43.0
This IP has only one interrupt and names are not needed in this case:
change to use platform_get_irq() instead, dropping the PD_IRQB name.
Signed-off-by: AngeloGioacchino Del Regno <[email protected]>
---
drivers/usb/typec/tcpm/tcpci_mt6360.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/drivers/usb/typec/tcpm/tcpci_mt6360.c b/drivers/usb/typec/tcpm/tcpci_mt6360.c
index 02b7fd302265..171592ae1bbe 100644
--- a/drivers/usb/typec/tcpm/tcpci_mt6360.c
+++ b/drivers/usb/typec/tcpm/tcpci_mt6360.c
@@ -153,7 +153,7 @@ static int mt6360_tcpc_probe(struct platform_device *pdev)
return -ENODEV;
}
- mti->irq = platform_get_irq_byname(pdev, "PD_IRQB");
+ mti->irq = platform_get_irq(pdev, 0);
if (mti->irq < 0)
return mti->irq;
--
2.43.0
On Fri, 19 Jan 2024 10:41:04 +0100, AngeloGioacchino Del Regno wrote:
> This IP has only one interrupt, hence interrupt-names is not necessary
> to have.
> Since there is no user yet, simply remove interrupt-names.
>
> Signed-off-by: AngeloGioacchino Del Regno <[email protected]>
> ---
> .../devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml | 5 -----
> 1 file changed, 5 deletions(-)
>
My bot found errors running 'make DT_CHECKER_FLAGS=-m dt_binding_check'
on your patch (DT_CHECKER_FLAGS is new in v5.13):
yamllint warnings/errors:
dtschema/dtc warnings/errors:
/builds/robherring/dt-review-ci/linux/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.example.dtb: mt6360@34: tcpc: 'interrupt-names' is a required property
from schema $id: http://devicetree.org/schemas/mfd/mediatek,mt6360.yaml#
/builds/robherring/dt-review-ci/linux/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.example.dtb: tcpc: 'interrupt-names' is a required property
from schema $id: http://devicetree.org/schemas/usb/mediatek,mt6360-tcpc.yaml#
/builds/robherring/dt-review-ci/linux/Documentation/devicetree/bindings/mfd/mediatek,mt6360.example.dtb: pmic@34: tcpc: 'interrupt-names' does not match any of the regexes: 'pinctrl-[0-9]+'
from schema $id: http://devicetree.org/schemas/mfd/mediatek,mt6360.yaml#
/builds/robherring/dt-review-ci/linux/Documentation/devicetree/bindings/mfd/mediatek,mt6360.example.dtb: tcpc: 'interrupt-names' does not match any of the regexes: 'pinctrl-[0-9]+'
from schema $id: http://devicetree.org/schemas/usb/mediatek,mt6360-tcpc.yaml#
doc reference errors (make refcheckdocs):
See https://patchwork.ozlabs.org/project/devicetree-bindings/patch/[email protected]
The base for the series is generally the latest rc1. A different dependency
should be noted in *this* patch.
If you already ran 'make dt_binding_check' and didn't see the above
error(s), then make sure 'yamllint' is installed and dt-schema is up to
date:
pip3 install dtschema --upgrade
Please check and re-submit after running the above command yourself. Note
that DT_SCHEMA_FILES can be set to your schema file to speed up checking
your schema. However, it must be unset to test all examples with your schema.
On Fri, Jan 19, 2024 at 10:41:04AM +0100, AngeloGioacchino Del Regno wrote:
> This IP has only one interrupt, hence interrupt-names is not necessary
> to have.
> Since there is no user yet, simply remove interrupt-names.
I'm a bit confused chief. Patch 2 in this series removes a user of this
property from a driver, so can you explain how this statement is true?
Maybe I need to drink a few cans of Monster and revisit this patchset?
Thanks,
Conor.
> ---
> .../devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml | 5 -----
> 1 file changed, 5 deletions(-)
>
> diff --git a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
> index 053264e60583..339bc9c00ac0 100644
> --- a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
> +++ b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
> @@ -22,10 +22,6 @@ properties:
> interrupts:
> maxItems: 1
>
> - interrupt-names:
> - items:
> - - const: PD_IRQB
> -
> connector:
> type: object
> $ref: ../connector/usb-connector.yaml#
> @@ -58,7 +54,6 @@ examples:
> tcpc {
> compatible = "mediatek,mt6360-tcpc";
> interrupts-extended = <&gpio26 3 IRQ_TYPE_LEVEL_LOW>;
> - interrupt-names = "PD_IRQB";
>
> connector {
> compatible = "usb-c-connector";
> --
> 2.43.0
>
Il 19/01/24 17:32, Conor Dooley ha scritto:
> On Fri, Jan 19, 2024 at 10:41:04AM +0100, AngeloGioacchino Del Regno wrote:
>> This IP has only one interrupt, hence interrupt-names is not necessary
>> to have.
>> Since there is no user yet, simply remove interrupt-names.
>
> I'm a bit confused chief. Patch 2 in this series removes a user of this
> property from a driver, so can you explain how this statement is true?
>
> Maybe I need to drink a few cans of Monster and revisit this patchset?
>
What I mean with "there is no user" is that there's no device tree with any
mt6360-tcpc node upstream yet, so there is no meaningful ABI breakage.
Different story would be if there was a device tree using this already, in
which case, you can make a required property optional but not remove it.
Anything wrong?! :-)
Cheers,
Angelo
> Thanks,
> Conor.
>
>> ---
>> .../devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml | 5 -----
>> 1 file changed, 5 deletions(-)
>>
>> diff --git a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
>> index 053264e60583..339bc9c00ac0 100644
>> --- a/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
>> +++ b/Documentation/devicetree/bindings/usb/mediatek,mt6360-tcpc.yaml
>> @@ -22,10 +22,6 @@ properties:
>> interrupts:
>> maxItems: 1
>>
>> - interrupt-names:
>> - items:
>> - - const: PD_IRQB
>> -
>> connector:
>> type: object
>> $ref: ../connector/usb-connector.yaml#
>> @@ -58,7 +54,6 @@ examples:
>> tcpc {
>> compatible = "mediatek,mt6360-tcpc";
>> interrupts-extended = <&gpio26 3 IRQ_TYPE_LEVEL_LOW>;
>> - interrupt-names = "PD_IRQB";
>>
>> connector {
>> compatible = "usb-c-connector";
>> --
>> 2.43.0
>>
On Mon, Jan 22, 2024 at 11:32:30AM +0100, AngeloGioacchino Del Regno wrote:
> Il 19/01/24 17:32, Conor Dooley ha scritto:
> > On Fri, Jan 19, 2024 at 10:41:04AM +0100, AngeloGioacchino Del Regno wrote:
> > > This IP has only one interrupt, hence interrupt-names is not necessary
> > > to have.
> > > Since there is no user yet, simply remove interrupt-names.
> >
> > I'm a bit confused chief. Patch 2 in this series removes a user of this
> > property from a driver, so can you explain how this statement is true?
> >
> > Maybe I need to drink a few cans of Monster and revisit this patchset?
> >
>
> What I mean with "there is no user" is that there's no device tree with any
> mt6360-tcpc node upstream yet, so there is no meaningful ABI breakage.
> Different story would be if there was a device tree using this already, in
> which case, you can make a required property optional but not remove it.
Not every devicetree lives within the kernel.. If the driver is using
it, I'm not inclined to agree that it should be removed.
On Wed, Jan 24, 2024 at 09:48:23AM +0100, AngeloGioacchino Del Regno wrote:
> Il 23/01/24 18:14, Conor Dooley ha scritto:
> > On Mon, Jan 22, 2024 at 11:32:30AM +0100, AngeloGioacchino Del Regno wrote:
> > > Il 19/01/24 17:32, Conor Dooley ha scritto:
> > > > On Fri, Jan 19, 2024 at 10:41:04AM +0100, AngeloGioacchino Del Regno wrote:
> > > > > This IP has only one interrupt, hence interrupt-names is not necessary
> > > > > to have.
> > > > > Since there is no user yet, simply remove interrupt-names.
> > > >
> > > > I'm a bit confused chief. Patch 2 in this series removes a user of this
> > > > property from a driver, so can you explain how this statement is true?
> > > >
> > > > Maybe I need to drink a few cans of Monster and revisit this patchset?
> > > >
> > >
> > > What I mean with "there is no user" is that there's no device tree with any
> > > mt6360-tcpc node upstream yet, so there is no meaningful ABI breakage.
> > > Different story would be if there was a device tree using this already, in
> > > which case, you can make a required property optional but not remove it.
> >
> > Not every devicetree lives within the kernel.. If the driver is using
> > it, I'm not inclined to agree that it should be removed.
>
> I get the point, but as far as I remember, it's not the first time that this
> kind of change is upstreamed.
>
> I'm fine with keeping things as they are but, since my intention is to actually
> introduce an actual user of this binding upstream, and that actually depends on
> if this change is accepted or not (as I have to know whether I can omit adding
> the interrupt-names property or not)....
>
> ....may I ask for more feedback/opinions from Rob and/or Krzk?
Sure, I am happy to be overruled if they disagree.
On 24/01/2024 09:48, AngeloGioacchino Del Regno wrote:
> Il 23/01/24 18:14, Conor Dooley ha scritto:
>> On Mon, Jan 22, 2024 at 11:32:30AM +0100, AngeloGioacchino Del Regno wrote:
>>> Il 19/01/24 17:32, Conor Dooley ha scritto:
>>>> On Fri, Jan 19, 2024 at 10:41:04AM +0100, AngeloGioacchino Del Regno wrote:
>>>>> This IP has only one interrupt, hence interrupt-names is not necessary
>>>>> to have.
>>>>> Since there is no user yet, simply remove interrupt-names.
>>>>
>>>> I'm a bit confused chief. Patch 2 in this series removes a user of this
>>>> property from a driver, so can you explain how this statement is true?
>>>>
>>>> Maybe I need to drink a few cans of Monster and revisit this patchset?
>>>>
>>>
>>> What I mean with "there is no user" is that there's no device tree with any
>>> mt6360-tcpc node upstream yet, so there is no meaningful ABI breakage.
>>> Different story would be if there was a device tree using this already, in
>>> which case, you can make a required property optional but not remove it.
>>
>> Not every devicetree lives within the kernel.. If the driver is using
>> it, I'm not inclined to agree that it should be removed.
>
> I get the point, but as far as I remember, it's not the first time that this
> kind of change is upstreamed.
>
> I'm fine with keeping things as they are but, since my intention is to actually
> introduce an actual user of this binding upstream, and that actually depends on
> if this change is accepted or not (as I have to know whether I can omit adding
> the interrupt-names property or not)....
>
> ....may I ask for more feedback/opinions from Rob and/or Krzk?
Driver is the user and this is an old binding (released!), thus there
can be out-of-kernel users already.
Minor cleanup is not really a reason to affect ABI. You could deprecate
it, though. Driver change is fine.
Best regards,
Krzysztof
Il 25/01/24 11:32, Krzysztof Kozlowski ha scritto:
> On 24/01/2024 09:48, AngeloGioacchino Del Regno wrote:
>> Il 23/01/24 18:14, Conor Dooley ha scritto:
>>> On Mon, Jan 22, 2024 at 11:32:30AM +0100, AngeloGioacchino Del Regno wrote:
>>>> Il 19/01/24 17:32, Conor Dooley ha scritto:
>>>>> On Fri, Jan 19, 2024 at 10:41:04AM +0100, AngeloGioacchino Del Regno wrote:
>>>>>> This IP has only one interrupt, hence interrupt-names is not necessary
>>>>>> to have.
>>>>>> Since there is no user yet, simply remove interrupt-names.
>>>>>
>>>>> I'm a bit confused chief. Patch 2 in this series removes a user of this
>>>>> property from a driver, so can you explain how this statement is true?
>>>>>
>>>>> Maybe I need to drink a few cans of Monster and revisit this patchset?
>>>>>
>>>>
>>>> What I mean with "there is no user" is that there's no device tree with any
>>>> mt6360-tcpc node upstream yet, so there is no meaningful ABI breakage.
>>>> Different story would be if there was a device tree using this already, in
>>>> which case, you can make a required property optional but not remove it.
>>>
>>> Not every devicetree lives within the kernel.. If the driver is using
>>> it, I'm not inclined to agree that it should be removed.
>>
>> I get the point, but as far as I remember, it's not the first time that this
>> kind of change is upstreamed.
>>
>> I'm fine with keeping things as they are but, since my intention is to actually
>> introduce an actual user of this binding upstream, and that actually depends on
>> if this change is accepted or not (as I have to know whether I can omit adding
>> the interrupt-names property or not)....
>>
>> ....may I ask for more feedback/opinions from Rob and/or Krzk?
>
> Driver is the user and this is an old binding (released!), thus there
> can be out-of-kernel users already.
>
> Minor cleanup is not really a reason to affect ABI. You could deprecate
> it, though. Driver change is fine.
>
Thanks for the clarification. If USB maintainers want to take the driver part only
without me resending this, I'd appreciate that.
The interrupt-names is not a required property in this binding anyway... :-)
Thanks again,
Angelo
On Thu, Jan 25, 2024 at 12:41:57PM +0100, AngeloGioacchino Del Regno wrote:
> Il 25/01/24 11:32, Krzysztof Kozlowski ha scritto:
> > On 24/01/2024 09:48, AngeloGioacchino Del Regno wrote:
> > > Il 23/01/24 18:14, Conor Dooley ha scritto:
> > > > On Mon, Jan 22, 2024 at 11:32:30AM +0100, AngeloGioacchino Del Regno wrote:
> > > > > Il 19/01/24 17:32, Conor Dooley ha scritto:
> > > > > > On Fri, Jan 19, 2024 at 10:41:04AM +0100, AngeloGioacchino Del Regno wrote:
> > > > > > > This IP has only one interrupt, hence interrupt-names is not necessary
> > > > > > > to have.
> > > > > > > Since there is no user yet, simply remove interrupt-names.
> > > > > >
> > > > > > I'm a bit confused chief. Patch 2 in this series removes a user of this
> > > > > > property from a driver, so can you explain how this statement is true?
> > > > > >
> > > > > > Maybe I need to drink a few cans of Monster and revisit this patchset?
> > > > > >
> > > > >
> > > > > What I mean with "there is no user" is that there's no device tree with any
> > > > > mt6360-tcpc node upstream yet, so there is no meaningful ABI breakage.
> > > > > Different story would be if there was a device tree using this already, in
> > > > > which case, you can make a required property optional but not remove it.
> > > >
> > > > Not every devicetree lives within the kernel.. If the driver is using
> > > > it, I'm not inclined to agree that it should be removed.
> > >
> > > I get the point, but as far as I remember, it's not the first time that this
> > > kind of change is upstreamed.
> > >
> > > I'm fine with keeping things as they are but, since my intention is to actually
> > > introduce an actual user of this binding upstream, and that actually depends on
> > > if this change is accepted or not (as I have to know whether I can omit adding
> > > the interrupt-names property or not)....
> > >
> > > ....may I ask for more feedback/opinions from Rob and/or Krzk?
> >
> > Driver is the user and this is an old binding (released!), thus there
> > can be out-of-kernel users already.
> >
> > Minor cleanup is not really a reason to affect ABI. You could deprecate
> > it, though. Driver change is fine.
> >
>
> Thanks for the clarification. If USB maintainers want to take the driver part only
> without me resending this, I'd appreciate that.
>
> The interrupt-names is not a required property in this binding anyway... :-)
Having -names properties that are not required when the base property is
always seem so pointless to me, except in cases where they're not
required for the case where there's one item but required when there are
more than one. Ultimately they're pointless if not required since they
can't be relied on. I think dropping it from the driver is required for
correctness.
On Thu, Jan 25, 2024 at 04:57:33PM +0000, Conor Dooley wrote:
> On Thu, Jan 25, 2024 at 12:41:57PM +0100, AngeloGioacchino Del Regno wrote:
> > Il 25/01/24 11:32, Krzysztof Kozlowski ha scritto:
> > > On 24/01/2024 09:48, AngeloGioacchino Del Regno wrote:
> > > > Il 23/01/24 18:14, Conor Dooley ha scritto:
> > > > > On Mon, Jan 22, 2024 at 11:32:30AM +0100, AngeloGioacchino Del Regno wrote:
> > > > > > Il 19/01/24 17:32, Conor Dooley ha scritto:
> > > > > > > On Fri, Jan 19, 2024 at 10:41:04AM +0100, AngeloGioacchino Del Regno wrote:
> > > > > > > > This IP has only one interrupt, hence interrupt-names is not necessary
> > > > > > > > to have.
> > > > > > > > Since there is no user yet, simply remove interrupt-names.
> > > > > > >
> > > > > > > I'm a bit confused chief. Patch 2 in this series removes a user of this
> > > > > > > property from a driver, so can you explain how this statement is true?
> > > > > > >
> > > > > > > Maybe I need to drink a few cans of Monster and revisit this patchset?
> > > > > > >
> > > > > >
> > > > > > What I mean with "there is no user" is that there's no device tree with any
> > > > > > mt6360-tcpc node upstream yet, so there is no meaningful ABI breakage.
> > > > > > Different story would be if there was a device tree using this already, in
> > > > > > which case, you can make a required property optional but not remove it.
> > > > >
> > > > > Not every devicetree lives within the kernel.. If the driver is using
> > > > > it, I'm not inclined to agree that it should be removed.
> > > >
> > > > I get the point, but as far as I remember, it's not the first time that this
> > > > kind of change is upstreamed.
> > > >
> > > > I'm fine with keeping things as they are but, since my intention is to actually
> > > > introduce an actual user of this binding upstream, and that actually depends on
> > > > if this change is accepted or not (as I have to know whether I can omit adding
> > > > the interrupt-names property or not)....
> > > >
> > > > ....may I ask for more feedback/opinions from Rob and/or Krzk?
> > >
> > > Driver is the user and this is an old binding (released!), thus there
> > > can be out-of-kernel users already.
> > >
> > > Minor cleanup is not really a reason to affect ABI. You could deprecate
> > > it, though. Driver change is fine.
> > >
> >
> > Thanks for the clarification. If USB maintainers want to take the driver part only
> > without me resending this, I'd appreciate that.
> >
>
> > The interrupt-names is not a required property in this binding anyway... :-)
>
> Having -names properties that are not required when the base property is
> always seem so pointless to me, except in cases where they're not
> required for the case where there's one item but required when there are
> more than one. Ultimately they're pointless if not required since they
> can't be relied on. I think dropping it from the driver is required for
> correctness.
Actually, looking at the binding again:
| required:
| - compatible
| - interrupts
| - interrupt-names
It looks like it is a required property after all!
On Fri, Jan 26, 2024 at 10:15:54AM +0100, AngeloGioacchino Del Regno wrote:
> > | required:
> > | - compatible
> > | - interrupts
> > | - interrupt-names
> >
> > It looks like it is a required property after all!
>
> Apparently my brain's binding had
>
> required:
> - blindness
>
> :-P
>
> Yeah, I have no idea why I didn't see that, sorry!
Possibly because your patch never removed it from required in the first
place, if you only looked back at that, and not the binding (or Rob's
bot's report), I can see how you could miss it.
Il 25/01/24 18:02, Conor Dooley ha scritto:
> On Thu, Jan 25, 2024 at 04:57:33PM +0000, Conor Dooley wrote:
>> On Thu, Jan 25, 2024 at 12:41:57PM +0100, AngeloGioacchino Del Regno wrote:
>>> Il 25/01/24 11:32, Krzysztof Kozlowski ha scritto:
>>>> On 24/01/2024 09:48, AngeloGioacchino Del Regno wrote:
>>>>> Il 23/01/24 18:14, Conor Dooley ha scritto:
>>>>>> On Mon, Jan 22, 2024 at 11:32:30AM +0100, AngeloGioacchino Del Regno wrote:
>>>>>>> Il 19/01/24 17:32, Conor Dooley ha scritto:
>>>>>>>> On Fri, Jan 19, 2024 at 10:41:04AM +0100, AngeloGioacchino Del Regno wrote:
>>>>>>>>> This IP has only one interrupt, hence interrupt-names is not necessary
>>>>>>>>> to have.
>>>>>>>>> Since there is no user yet, simply remove interrupt-names.
>>>>>>>>
>>>>>>>> I'm a bit confused chief. Patch 2 in this series removes a user of this
>>>>>>>> property from a driver, so can you explain how this statement is true?
>>>>>>>>
>>>>>>>> Maybe I need to drink a few cans of Monster and revisit this patchset?
>>>>>>>>
>>>>>>>
>>>>>>> What I mean with "there is no user" is that there's no device tree with any
>>>>>>> mt6360-tcpc node upstream yet, so there is no meaningful ABI breakage.
>>>>>>> Different story would be if there was a device tree using this already, in
>>>>>>> which case, you can make a required property optional but not remove it.
>>>>>>
>>>>>> Not every devicetree lives within the kernel.. If the driver is using
>>>>>> it, I'm not inclined to agree that it should be removed.
>>>>>
>>>>> I get the point, but as far as I remember, it's not the first time that this
>>>>> kind of change is upstreamed.
>>>>>
>>>>> I'm fine with keeping things as they are but, since my intention is to actually
>>>>> introduce an actual user of this binding upstream, and that actually depends on
>>>>> if this change is accepted or not (as I have to know whether I can omit adding
>>>>> the interrupt-names property or not)....
>>>>>
>>>>> ....may I ask for more feedback/opinions from Rob and/or Krzk?
>>>>
>>>> Driver is the user and this is an old binding (released!), thus there
>>>> can be out-of-kernel users already.
>>>>
>>>> Minor cleanup is not really a reason to affect ABI. You could deprecate
>>>> it, though. Driver change is fine.
>>>>
>>>
>>> Thanks for the clarification. If USB maintainers want to take the driver part only
>>> without me resending this, I'd appreciate that.
>>>
>>
>>> The interrupt-names is not a required property in this binding anyway... :-)
>>
>> Having -names properties that are not required when the base property is
>> always seem so pointless to me, except in cases where they're not
>> required for the case where there's one item but required when there are
>> more than one. Ultimately they're pointless if not required since they
>> can't be relied on. I think dropping it from the driver is required for
>> correctness.
>
> Actually, looking at the binding again:
>
> | required:
> | - compatible
> | - interrupts
> | - interrupt-names
>
> It looks like it is a required property after all!
Apparently my brain's binding had
required:
- blindness
:-P
Yeah, I have no idea why I didn't see that, sorry!
Cheers,
Angelo