dt-bindings: display: mediatek: Add OF graph support for board path
authorAngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>
Thu, 17 Oct 2024 10:38:07 +0000 (12:38 +0200)
committerChun-Kuang Hu <chunkuang.hu@kernel.org>
Mon, 21 Oct 2024 12:39:14 +0000 (12:39 +0000)
commit2b6433f30b870c7fbd172f5e1969e1df5e03cad7
tree1b14f7e1adea11dbb925aff035bd4e693d8f1dde
parent9852d85ec9d492ebef56dc5f229416c925758edc
dt-bindings: display: mediatek: Add OF graph support for board path

The display IPs in MediaTek SoCs support being interconnected with
different instances of DDP IPs (for example, merge0 or merge1) and/or
with different DDP IPs (for example, rdma can be connected with either
color, dpi, dsi, merge, etc), forming a full Display Data Path that
ends with an actual display.

The final display pipeline is effectively board specific, as it does
depend on the display that is attached to it, and eventually on the
sensors supported by the board (for example, Adaptive Ambient Light
would need an Ambient Light Sensor, otherwise it's pointless!), other
than the output type.

Add support for OF graphs to most of the MediaTek DDP (display) bindings
to add flexibility to build custom hardware paths, hence enabling board
specific configuration of the display pipeline and allowing to finally
migrate away from using hardcoded paths.

Please note that - while this commit retains retro-compatibility with
old device trees - it will break the ABI for mediatek,dsi and for
mediatek,dpi for the sake of consistency between the `ports` in all
MediaTek DRM drivers versus DRM bridge drivers as in the previous
binding, MediaTek was using `port` (implicitly, port@0) as an OUTPUT,
while now the first port is an INPUT, and the second one is an OUTPUT,
which is consistent with other DRM drivers which can be chained to
drm/mediatek.

As for maintainability concerns, I am aware that the old device tree
will not be actively tested anymore, but retrocompatibility breakages
will *not* be more likely to happen in the future because any addition
to the graph (new drivers) will be done only for features present on
newer SoCs, keeping the old ones (and their default pipeline) untouched.

Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Reviewed-by: Alexandre Mergnat <amergnat@baylibre.com>
Tested-by: Alexandre Mergnat <amergnat@baylibre.com>
Reviewed-by: CK Hu <ck.hu@mediatek.com>
Tested-by: Michael Walle <mwalle@kernel.org> # on kontron-sbc-i1200
Signed-off-by: AngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>
Link: https://patchwork.kernel.org/project/dri-devel/patch/20241017103809.156056-2-angelogioacchino.delregno@collabora.com/
Signed-off-by: Chun-Kuang Hu <chunkuang.hu@kernel.org>
16 files changed:
Documentation/devicetree/bindings/display/mediatek/mediatek,aal.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,ccorr.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,color.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,dither.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,dpi.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,dsc.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,dsi.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,ethdr.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,gamma.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,merge.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,od.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,ovl-2l.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,ovl.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,postmask.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,rdma.yaml
Documentation/devicetree/bindings/display/mediatek/mediatek,ufoe.yaml