Re: [PATCH 0/5] Exynos EHCI/OHCI: resolve conflict with the generic USB device bindings

From: Måns Rullgård
Date: Wed May 22 2019 - 06:57:21 EST


Marek Szyprowski <m.szyprowski@xxxxxxxxxxx> writes:

> Hi Måns
>
> On 2019-05-21 15:30, Måns Rullgård wrote:
>> Marek Szyprowski <m.szyprowski@xxxxxxxxxxx> writes:
>>> Dear All,
>>>
>>> Commit 69bec7259853 ("USB: core: let USB device know device node") added
>>> support for attaching devicetree node for USB devices. Those nodes are
>>> children of their USB host controller. However Exynos EHCI and OHCI
>>> driver bindings already define child-nodes for each physical root hub
>>> port and assigns respective PHY controller and parameters to them. This
>>> leads to the conflict. A workaround for it has been merged as commit
>>> 01d4071486fe ("usb: exynos: add workaround for the USB device bindings
>>> conflict"), but it disabled support for USB device binding for Exynos
>>> EHCI/OHCI controllers.
>>>
>>> This patchset tries to resolve this binding conflict by changing Exynos
>>> EHCI/OHCI bindings: PHYs are moved from the sub-nodes to a standard array
>>> under the 'phys' property. Such solution has been suggested by Måns
>>> Rullgård in the following thread: https://lkml.org/lkml/2019/5/13/228
>>>
>>> To keep everything working during the transitional time, the changes has
>>> been split into 2 steps. First step (patches 1-3) need to be merged before
>>> the second one (patches 4-5). Patches from each step can be merged to
>>> respective trees without any dependencies - the only requirement is that
>>> second step has to be merged after merging all patches from the first one.
>>>
>>> This patchset has been tested on various Exynos4 boards with different
>>> USB host controller configurations (Odroids family: X2, U3, XU3).
>>>
>>> Best regards
>>> Marek Szyprowski
>>> Samsung R&D Institute Poland
>>>
>>> Marek Szyprowski (5):
>>> dt-bindings: switch Exynos EHCI/OHCI bindings to use array of generic
>>> PHYs
>>> ARM: dts: exynos: Add array of generic PHYs to EHCI/OHCI devices
>>> usb: exynos: add support for getting PHYs from the standard dt array
>>> ARM: dts: exynos: Remove obsolete port sub-nodes from EHCI/OHCI
>>> devices
>>> usb: exynos: Remove support for legacy PHY bindings
>> You could retain compatibility with old devicetrees (which may be
>> useful) by using the "phys" property if it exists and falling back
>> on the old method if it doesn't. Then you would get this sequence
>> of changes:
>>
>> 1. Update binding definition.
>> 2. Support new binding in driver, with fallback to old.
>> 3. Switch dts files to new binding.
>
> This is exactly what I did in this patchset. Until Patch #5 is applied,
> Exynos EHCI/OHCI drivers supports both ways of getting PHYs and is fully
> compatible with existing DTBs. This last patch should be applied at
> least one release later that the first 3 patches to keep everything
> working during the -rcX time.

I'm suggesting you keep the fallback in the driver. It does no harm,
and it's contained in one place.

On the dts side, you're adding the new phys property without removing
the old-style nodes at first. If you put the driver change first, the
dts could be switched to the new style in one patch without a confusing
hybrid ever existing.

> Compatibility with so called old DTBs is not so important, because there
> are no boards with Exynos4 and Exynos5 SoCs, which would not update DTB
> together with the kernel zImage. There have been already some
> significant compatibility breaks related to those SoCs during last years.

You can't possibly know what's out there. Besides, isn't the general
policy to not break compatibility without a very good reason?

--
Måns Rullgård