xref: /linux/Documentation/devicetree/bindings/soc/amlogic/amlogic,canvas.yaml (revision ae22a94997b8a03dcb3c922857c203246711f9d4) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2# Copyright 2019 BayLibre, SAS
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/soc/amlogic/amlogic,canvas.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Amlogic Canvas Video Lookup Table
9
10maintainers:
11  - Neil Armstrong <neil.armstrong@linaro.org>
12  - Maxime Jourdan <mjourdan@baylibre.com>
13
14description: |
15  A canvas is a collection of metadata that describes a pixel buffer.
16  Those metadata include: width, height, phyaddr, wrapping and block mode.
17  Starting with GXBB the endianness can also be described.
18
19  Many IPs within Amlogic SoCs rely on canvas indexes to read/write pixel data
20  rather than use the phy addresses directly. For instance, this is the case for
21  the video decoders and the display.
22
23  Amlogic SoCs have 256 canvas.
24
25properties:
26  compatible:
27    oneOf:
28      - items:
29          - enum:
30              - amlogic,meson8-canvas
31              - amlogic,meson8b-canvas
32              - amlogic,meson8m2-canvas
33          - const: amlogic,canvas
34      - const: amlogic,canvas # GXBB and newer SoCs
35
36  reg:
37    maxItems: 1
38
39required:
40  - compatible
41  - reg
42
43additionalProperties: false
44
45examples:
46  - |
47    canvas: video-lut@48 {
48        compatible = "amlogic,canvas";
49        reg = <0x48 0x14>;
50    };
51