Documentation/devicetree/bindings/soc/amlogic/amlogic,canvas.yaml

   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
   8 title: Amlogic Canvas Video Lookup Table
   9
  10 maintainers:
  11   - Neil Armstrong <narmstrong@baylibre.com>
  12   - Maxime Jourdan <mjourdan@baylibre.com>
  13
  14 description: |
  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
  25 properties:
  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
  39 required:
  40   - compatible
  41   - reg
  42
  43 additionalProperties: false
  44
  45 examples:
  46   - |
  47     canvas: video-lut@48 {
  48         compatible = "amlogic,canvas";
  49         reg = <0x48 0x14>;
  50     };
  51