xref: /freebsd/sys/contrib/device-tree/Bindings/soc/amlogic/amlogic,canvas.yaml (revision 38829592dc77e9ead4259785e0bfb93bd4c2fe34)
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