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