Documentation: devicetree: bindings: dma: New dts property

A new device tree property is described that will describe
the video formats supported in the Video Framebuffer DMA device.
The Video Framebuffer IP is configurabe and can be configured with
varying support for a number of possible video memory formats in
an effort to tailor the size of the logic footprint.  The driver
will utilize this new device tree property to describe this
configuration.

Signed-off-by: Jeffrey Mouroux <jmouroux@xilinx.com>
Reviewed-by: Hyun Kwon <hyun.kwon@xilinx.com>
Signed-off-by: Michal Simek <michal.simek@xilinx.com>

diff --git a/Documentation/devicetree/bindings/dma/xilinx/xilinx_frmbuf.txt b/Documentation/devicetree/bindings/dma/xilinx/xilinx_frmbuf.txt
index 996f20e86ee57407a37a3d067a632722f805b1f5..a20fa6e0c6fe7c32c40a7756dd63ccad446c0356 100644 (file)
--- a/Documentation/devicetree/bindings/dma/xilinx/xilinx_frmbuf.txt
+++ b/Documentation/devicetree/bindings/dma/xilinx/xilinx_frmbuf.txt
@@ -26,6 +26,26 @@ Required Properties Common to both FB Read and FB Write:
 - reset-gpios          : Should contain GPIO reset phandle
 - reg                  : Memory map for module access
 - xlnx,dma-addr-width  : Size of dma address pointer in IP (either 32 or 64)
+- xlnx,vid-formats     : A list of strings indicating what video memory
+                         formats the IP has been configured to support.
+                         See VIDEO FORMATS table below and examples.
+
+VIDEO FORMATS
+The following table describes the legal string values to be used for
+the xlnx,vid-formats property.  To the left is the string value and the
+two columns to the right describe how this is mapped to an equivalent V4L2
+and DRM fourcc code---respectively---by the driver.
+
+IP FORMAT      DTS String      V4L2 Fourcc             DRM Fourcc
+-------------|----------------|----------------------|---------------------
+RGB8           bgr888          V4L2_PIX_FMT_RGB24      DRM_FORMAT_BGR888
+RGBX8          xbgr8888        <not supported>         DRM_FORMAT_XBGR8888
+YUYV8          yuyv            V4L2_PIX_FMT_YUYV       DRM_FORMAT_YUYV
+Y_UV8          nv16            V4L2_PIX_FMT_NV16       DRM_FORMAT_NV16
+Y_UV8_420      nv12            V4L2_PIX_FMT_NV12       DRM_FORMAT_NV12
+YUVX8          <none>          <not supported>         <not supported>
+YUV8           <none>          <not supported>         <not supported>
+Y8             y8              V4L2_PIX_FMT_GREY       <not supported>
 
 Examples
 
@@ -39,6 +59,7 @@ v_frmbuf_rd_0: v_frmbuf_rd@80000000 {
        reset-gpios = <&gpio 80 1>;
        reg = <0x0 0x80000000 0x0 0x10000>;
        xlnx,dma-addr-width = <32>;
+       xlnx,vid-formats = "bgr888","xbgr8888";
 };
 
 FB Write Example:
@@ -51,4 +72,5 @@ v_frmbuf_wr_0: v_frmbuf_wr@80000000 {
        reset-gpios = <&gpio 80 1>;
        reg = <0x0 0x80000000 0x0 0x10000>;
        xlnx,dma-addr-width = <64>;
+       xlnx,vid-formats = "bgr888","yuyv","nv16","nv12";
 };