Add documentation for the Two-Dimension Sharpness Processor, or "TDSHP", found in many MediaTek SoCs including MT8196 and its variants.
Signed-off-by: AngeloGioacchino Del Regno <[email protected]> --- .../mediatek/mediatek,mt8196-tdshp.yaml | 98 +++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 Documentation/devicetree/bindings/display/mediatek/mediatek,mt8196-tdshp.yaml diff --git a/Documentation/devicetree/bindings/display/mediatek/mediatek,mt8196-tdshp.yaml b/Documentation/devicetree/bindings/display/mediatek/mediatek,mt8196-tdshp.yaml new file mode 100644 index 000000000000..7aa176c788fc --- /dev/null +++ b/Documentation/devicetree/bindings/display/mediatek/mediatek,mt8196-tdshp.yaml @@ -0,0 +1,98 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/display/mediatek/mediatek,mt8196-tdshp.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: MediaTek Display Two-Dimension Sharpness Processor (TDSHP) + +maintainers: + - AngeloGioacchino Del Regno <[email protected]> + +description: + The MediaTek 2D Sharpness Processor (TDSHP) is responsible for performing + image sharpness adjustments/enhancements in a display pipeline. + This hardware block supports adjusting the luma and contour 2d histograms, + frequency weighting, luma-chroma gain and others, with adaptive weights. + +properties: + compatible: + - const: mediatek,mt8196-disp-tdshp + + reg: + maxItems: 1 + + clocks: + maxItems: 1 + + power-domains: + maxItems: 1 + + ports: + $ref: /schemas/graph.yaml#/properties/ports + + properties: + port@0: + $ref: /schemas/graph.yaml#/properties/port + + port@1: + $ref: /schemas/graph.yaml#/properties/port + + required: + - port@0 + - port@1 + + trigger-sources: + maxItems: 1 + +required: + - compatible + - reg + - clocks + - clock-names + - ports + +additionalProperties: false + +examples: + - | + #include <dt-bindings/interrupt-controller/arm-gic.h> + #include <dt-bindings/clock/mediatek,mt8196-clock.h> + #include <dt-bindings/power/mediatek,mt8196-power.h> + + tdshp@321e0000 { + compatible = "mediatek,mt8196-disp-tdshp"; + reg = <0x321e0000 0x1000>; + clocks = <&dispsys0 CLK_MM_DISP_TDSHP0>; + power-domains = <&hpm_hwv MT8196_POWER_DOMAIN_DIS0_DORMANT>; + trigger-sources = <&disp0_mutex 53>; + + ports { + #address-cells = <1>; + #size-cells = <0>; + + port@0 { + #address-cells = <1>; + #size-cells = <0>; + reg = <0>; + + endpoint@0 { + reg = <0>; + remote-endpoint = <&resizer0_out>; + }; + }; + + port@1 { + #address-cells = <1>; + #size-cells = <0>; + reg = <1>; + + endpoint@0 { + reg = <0>; + remote-endpoint = <&ccorr0_in>; + }; + }; + }; + }; + +... -- 2.54.0
