On 7/12/22 11:18 AM, Krzysztof Kozlowski wrote:
> On 12/07/2022 17:06, Sean Anderson wrote:
>> Hi Krzysztof,
>>
>> On 7/12/22 4:51 AM, Krzysztof Kozlowski wrote:
>>> On 11/07/2022 18:05, Sean Anderson wrote:
>>>> This allows multiple phandles to be specified for pcs-handle, such as
>>>> when multiple PCSs are present for a single MAC. To differentiate
>>>> between them, also add a pcs-names property.
>>>>
>>>> Signed-off-by: Sean Anderson <sean.anderson@xxxxxxxx>
>>>> ---
>>>>
>>>> .../devicetree/bindings/net/ethernet-controller.yaml | 7 ++++++-
>>>> 1 file changed, 6 insertions(+), 1 deletion(-)
>>>>
>>>> diff --git a/Documentation/devicetree/bindings/net/ethernet-controller.yaml b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
>>>> index 4f15463611f8..c033e536f869 100644
>>>> --- a/Documentation/devicetree/bindings/net/ethernet-controller.yaml
>>>> +++ b/Documentation/devicetree/bindings/net/ethernet-controller.yaml
>>>> @@ -107,11 +107,16 @@ properties:
>>>> $ref: "#/properties/phy-connection-type"
>>>>
>>>> pcs-handle:
>>>> - $ref: /schemas/types.yaml#/definitions/phandle
>>>> + $ref: /schemas/types.yaml#/definitions/phandle-array
>>>> description:
>>>> Specifies a reference to a node representing a PCS PHY device on a MDIO
>>>> bus to link with an external PHY (phy-handle) if exists.
>>>
>>> You need to update all existing bindings and add maxItems:1.
>>>
>>>>
>>>> + pcs-names:
>>>
>>> To be consistent with other properties this should be "pcs-handle-names"
>>> and the other "pcs-handles"... and then actually drop the "handle".
>>
>> Sorry, I'm not sure what you're recommending in the second half here.
>
> I would be happy to see consistent naming with other xxxs/xxx-names
> properties, therefore I recommend to:
> 1. deprecate pcs-handle because anyway the naming is encoding DT spec
> into the name ("handle"),
I agree with you here.
> 2. add new property 'pcs' or 'pcss' (the 's' at the end like clocks but
> maybe that's too much) with pcs-names.
>
> However before implementing this, please wait for more feedback. Maybe
> Rob or net folks will have different opinions.
For some context:
https://lore.kernel.org/netdev/20211004191527.1610759-2-sean.anderson@xxxxxxxx/
https://lore.kernel.org/netdev/20220321152515.287119-3-andy.chiu@xxxxxxxxxx/
--Sean
