3d21a46093
json-schema versions draft7 and earlier have a weird behavior in that any keywords combined with a '$ref' are ignored (silently). The correct form was to put a '$ref' under an 'allOf'. This behavior is now changed in the 2019-09 json-schema spec and '$ref' can be mixed with other keywords. The json-schema library doesn't yet support this, but the tooling now does a fixup for this and either way works. This has been a constant source of review comments, so let's change this treewide so everyone copies the simpler syntax. Scripted with ruamel.yaml with some manual fixups. Some minor whitespace changes from the script. Signed-off-by: Rob Herring <robh@kernel.org> Acked-by: Maxime Ripard <mripard@kernel.org> Acked-by: Lee Jones <lee.jones@linaro.org> Acked-By: Vinod Koul <vkoul@kernel.org> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com> Acked-by: Wolfram Sang <wsa@the-dreams.de> # for I2C Reviewed-by: Linus Walleij <linus.walleij@linaro.org> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for-iio Reviewed-by: Stephen Boyd <sboyd@kernel.org> # clock Signed-off-by: Rob Herring <robh@kernel.org>
114 lines
3.5 KiB
YAML
114 lines
3.5 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/display/allwinner,sun4i-a10-display-engine.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Allwinner A10 Display Engine Pipeline Device Tree Bindings
|
|
|
|
maintainers:
|
|
- Chen-Yu Tsai <wens@csie.org>
|
|
- Maxime Ripard <mripard@kernel.org>
|
|
|
|
description: |
|
|
The display engine pipeline (and its entry point, since it can be
|
|
either directly the backend or the frontend) is represented as an
|
|
extra node.
|
|
|
|
The Allwinner A10 Display pipeline is composed of several components
|
|
that are going to be documented below:
|
|
|
|
For all connections between components up to the TCONs in the
|
|
display pipeline, when there are multiple components of the same
|
|
type at the same depth, the local endpoint ID must be the same as
|
|
the remote component's index. For example, if the remote endpoint is
|
|
Frontend 1, then the local endpoint ID must be 1.
|
|
|
|
Frontend 0 [0] ------- [0] Backend 0 [0] ------- [0] TCON 0
|
|
[1] -- -- [1] [1] -- -- [1]
|
|
\ / \ /
|
|
X X
|
|
/ \ / \
|
|
[0] -- -- [0] [0] -- -- [0]
|
|
Frontend 1 [1] ------- [1] Backend 1 [1] ------- [1] TCON 1
|
|
|
|
For a two pipeline system such as the one depicted above, the lines
|
|
represent the connections between the components, while the numbers
|
|
within the square brackets corresponds to the ID of the local endpoint.
|
|
|
|
The same rule also applies to DE 2.0 mixer-TCON connections:
|
|
|
|
Mixer 0 [0] ----------- [0] TCON 0
|
|
[1] ---- ---- [1]
|
|
\ /
|
|
X
|
|
/ \
|
|
[0] ---- ---- [0]
|
|
Mixer 1 [1] ----------- [1] TCON 1
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- allwinner,sun4i-a10-display-engine
|
|
- allwinner,sun5i-a10s-display-engine
|
|
- allwinner,sun5i-a13-display-engine
|
|
- allwinner,sun6i-a31-display-engine
|
|
- allwinner,sun6i-a31s-display-engine
|
|
- allwinner,sun7i-a20-display-engine
|
|
- allwinner,sun8i-a23-display-engine
|
|
- allwinner,sun8i-a33-display-engine
|
|
- allwinner,sun8i-a83t-display-engine
|
|
- allwinner,sun8i-h3-display-engine
|
|
- allwinner,sun8i-r40-display-engine
|
|
- allwinner,sun8i-v3s-display-engine
|
|
- allwinner,sun9i-a80-display-engine
|
|
- allwinner,sun50i-a64-display-engine
|
|
- allwinner,sun50i-h6-display-engine
|
|
|
|
allwinner,pipelines:
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
minItems: 1
|
|
maxItems: 2
|
|
description: |
|
|
Available display engine frontends (DE 1.0) or mixers (DE
|
|
2.0/3.0) available.
|
|
|
|
required:
|
|
- compatible
|
|
- allwinner,pipelines
|
|
|
|
additionalProperties: false
|
|
|
|
if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- allwinner,sun4i-a10-display-engine
|
|
- allwinner,sun6i-a31-display-engine
|
|
- allwinner,sun6i-a31s-display-engine
|
|
- allwinner,sun7i-a20-display-engine
|
|
- allwinner,sun8i-a83t-display-engine
|
|
- allwinner,sun8i-r40-display-engine
|
|
- allwinner,sun9i-a80-display-engine
|
|
- allwinner,sun50i-a64-display-engine
|
|
|
|
then:
|
|
properties:
|
|
allwinner,pipelines:
|
|
minItems: 2
|
|
|
|
else:
|
|
properties:
|
|
allwinner,pipelines:
|
|
maxItems: 1
|
|
|
|
examples:
|
|
- |
|
|
de: display-engine {
|
|
compatible = "allwinner,sun4i-a10-display-engine";
|
|
allwinner,pipelines = <&fe0>, <&fe1>;
|
|
};
|
|
|
|
...
|