From eed0c52278895ff4f26fd7a0e4f373f76276f540 Mon Sep 17 00:00:00 2001 From: Jeffrey Mouroux Date: Mon, 28 Aug 2017 14:56:53 -0700 Subject: [PATCH] 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 Reviewed-by: Hyun Kwon Signed-off-by: Michal Simek --- .../bindings/dma/xilinx/xilinx_frmbuf.txt | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Documentation/devicetree/bindings/dma/xilinx/xilinx_frmbuf.txt b/Documentation/devicetree/bindings/dma/xilinx/xilinx_frmbuf.txt index 996f20e86ee5..a20fa6e0c6fe 100644 --- 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 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 +YUV8 +Y8 y8 V4L2_PIX_FMT_GREY 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"; }; -- 2.39.2