mbox series

[RFT,0/5] Convert adi,adv7511.txt DT bindings to yaml

Message ID 20200501083227.10886-1-ricardo.canuelo@collabora.com (mailing list archive)
Headers show
Series Convert adi,adv7511.txt DT bindings to yaml | expand

Message

Ricardo Cañuelo May 1, 2020, 8:32 a.m. UTC
Hi,

This series convert the adi,adv7511.txt DT bindings to json-schema. As a
result of the conversion some dts files needed to be updated.

The changes to the dts files are of two types:

  - Reordering of the I2C slave addresses list of the ADV75xx node. The
    addresses in the 'reg' property and the matching names in
    'reg-names' for an I2C slave don't need to be in any particular
    order, but the DT schema defines these properties as a cell array
    and a string array respectively, which are ordered, so the
    definitions in the dts files must match the order in the binding.

  - Filling the minimum binding requirements. Most of the time this
    means creating a 'ports' node in the boards that don't define
    them. Note, however, that the purpose of this is simply to make the
    definition compliant with the binding. I didn't define any endpoints
    for the ports.

About the binding conversion:

  - The dependencies between properties are properly modelled but the
    result might look cluttered. If you find it hard to read or
    maintain, another option is to split the binding in two: one for the
    ADV7511/11w/13 and another one for the ADV7533/35.

Patches 1/5 to 4/5 contain the dts changes. Patch 5/5 contains the
binding conversion.

NOTE: the bindings have been tested with:

  make dt_binding_check ARCH=<arch> DT_SCHEMA_FILES=<...adi,adv7511.yaml>
  make dtbs_check ARCH=<arch> DT_SCHEMA_FILES=<...adi,adv7511.yaml>

for <arch> = arm and arm64. dts changes haven't been tested in hardware.

Kind regards,
Ricardo

Ricardo Cañuelo (5):
  arm64: dts: draak: Reorder hdmi-encoder@39 reg and reg-names
    properties
  ARM: dts: wheat: reorder reg and reg-names properties in hdmi bridges
  ARM: dts: zynq: add port definitions to hdmi-tx@39
  arm64: dts: hisilicon: hikey960: add missing hdmi bridge properties
  dt-bindings: drm: bridge: adi,adv7511.txt: convert to yaml

 .../bindings/display/bridge/adi,adv7511.txt   | 143 ---------
 .../bindings/display/bridge/adi,adv7511.yaml  | 295 ++++++++++++++++++
 arch/arm/boot/dts/r8a7792-wheat.dts           |   8 +-
 arch/arm/boot/dts/zynq-zc702.dts              |  10 +
 arch/arm/boot/dts/zynq-zc706.dts              |  10 +
 .../boot/dts/hisilicon/hi3660-hikey960.dts    |  11 +
 .../arm64/boot/dts/renesas/r8a77995-draak.dts |   4 +-
 7 files changed, 332 insertions(+), 149 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/display/bridge/adi,adv7511.txt
 create mode 100644 Documentation/devicetree/bindings/display/bridge/adi,adv7511.yaml