[media] media: add new mediabus format enums for dm365

add new enum entries for supporting the media-bus formats on dm365.
These include some bayer and some non-bayer formats.
V4L2_MBUS_FMT_YDYUYDYV8_1X16 and V4L2_MBUS_FMT_UV8_1X8 are used
internal to the hardware by the resizer.
V4L2_MBUS_FMT_SBGGR10_ALAW8_1X8 represents the bayer ALAW format
that is supported by dm365 hardware.

Signed-off-by: Manjunath Hadli <manjunath.hadli@ti.com>
Signed-off-by: Lad, Prabhakar <prabhakar.lad@ti.com>
Acked-by: Sakari Ailus <sakari.ailus@iki.fi>
Acked-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>

2 files changed, 252 insertions, 8 deletions

diff --git a/Documentation/DocBook/media/v4l/subdev-formats.xml b/Documentation/DocBook/media/v4l/subdev-formats.xml
index a0a936455fae..6f341d1eca1a 100644
--- a/Documentation/DocBook/media/v4l/subdev-formats.xml
+++ b/Documentation/DocBook/media/v4l/subdev-formats.xml
@@ -353,9 +353,9 @@
         <listitem><para>The number of bits per pixel component. All components are
         transferred on the same number of bits. Common values are 8, 10 and 12.</para>
         </listitem>
-        <listitem><para>If the pixel components are DPCM-compressed, a mention of the
-        DPCM compression and the number of bits per compressed pixel component.</para>
-        </listitem>
+        <listitem><para>The compression (optional). If the pixel components are
+        ALAW- or DPCM-compressed, a mention of the compression scheme and the
+        number of bits per compressed pixel component.</para></listitem>
         <listitem><para>The number of bus samples per pixel. Pixels that are wider than
         the bus width must be transferred in multiple samples. Common values are
         1 and 2.</para></listitem>
@@ -504,6 +504,74 @@
               <entry>r<subscript>1</subscript></entry>
               <entry>r<subscript>0</subscript></entry>
             </row>
+            <row id="V4L2-MBUS-FMT-SBGGR10-ALAW8-1X8">
+              <entry>V4L2_MBUS_FMT_SBGGR10_ALAW8_1X8</entry>
+              <entry>0x3015</entry>
+              <entry></entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>b<subscript>7</subscript></entry>
+              <entry>b<subscript>6</subscript></entry>
+              <entry>b<subscript>5</subscript></entry>
+              <entry>b<subscript>4</subscript></entry>
+              <entry>b<subscript>3</subscript></entry>
+              <entry>b<subscript>2</subscript></entry>
+              <entry>b<subscript>1</subscript></entry>
+              <entry>b<subscript>0</subscript></entry>
+            </row>
+            <row id="V4L2-MBUS-FMT-SGBRG10-ALAW8-1X8">
+              <entry>V4L2_MBUS_FMT_SGBRG10_ALAW8_1X8</entry>
+              <entry>0x3016</entry>
+              <entry></entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>g<subscript>7</subscript></entry>
+              <entry>g<subscript>6</subscript></entry>
+              <entry>g<subscript>5</subscript></entry>
+              <entry>g<subscript>4</subscript></entry>
+              <entry>g<subscript>3</subscript></entry>
+              <entry>g<subscript>2</subscript></entry>
+              <entry>g<subscript>1</subscript></entry>
+              <entry>g<subscript>0</subscript></entry>
+            </row>
+            <row id="V4L2-MBUS-FMT-SGRBG10-ALAW8-1X8">
+              <entry>V4L2_MBUS_FMT_SGRBG10_ALAW8_1X8</entry>
+              <entry>0x3017</entry>
+              <entry></entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>g<subscript>7</subscript></entry>
+              <entry>g<subscript>6</subscript></entry>
+              <entry>g<subscript>5</subscript></entry>
+              <entry>g<subscript>4</subscript></entry>
+              <entry>g<subscript>3</subscript></entry>
+              <entry>g<subscript>2</subscript></entry>
+              <entry>g<subscript>1</subscript></entry>
+              <entry>g<subscript>0</subscript></entry>
+            </row>
+            <row id="V4L2-MBUS-FMT-SRGGB10-ALAW8-1X8">
+              <entry>V4L2_MBUS_FMT_SRGGB10_ALAW8_1X8</entry>
+              <entry>0x3018</entry>
+              <entry></entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>r<subscript>7</subscript></entry>
+              <entry>r<subscript>6</subscript></entry>
+              <entry>r<subscript>5</subscript></entry>
+              <entry>r<subscript>4</subscript></entry>
+              <entry>r<subscript>3</subscript></entry>
+              <entry>r<subscript>2</subscript></entry>
+              <entry>r<subscript>1</subscript></entry>
+              <entry>r<subscript>0</subscript></entry>
+            </row>
             <row id="V4L2-MBUS-FMT-SBGGR10-DPCM8-1X8">
               <entry>V4L2_MBUS_FMT_SBGGR10_DPCM8_1X8</entry>
               <entry>0x300b</entry>
@@ -853,10 +921,16 @@
       <title>Packed YUV Formats</title>
 
       <para>Those data formats transfer pixel data as (possibly downsampled) Y, U
-      and V components. The format code is made of the following information.
+      and V components. Some formats include dummy bits in some of their samples
+      and are collectively referred to as "YDYC" (Y-Dummy-Y-Chroma) formats.
+      One cannot rely on the values of these dummy bits as those are undefined.
+      </para>
+      <para>The format code is made of the following information.
       <itemizedlist>
         <listitem><para>The Y, U and V components order code, as transferred on the
-        bus. Possible values are YUYV, UYVY, YVYU and VYUY.</para></listitem>
+        bus. Possible values are YUYV, UYVY, YVYU and VYUY for formats with no
+        dummy bit, and YDYUYDYV, YDYVYDYU, YUYDYVYD and YVYDYUYD for YDYC formats.
+        </para></listitem>
         <listitem><para>The number of bits per pixel component. All components are
         transferred on the same number of bits. Common values are 8, 10 and 12.</para>
         </listitem>
@@ -877,7 +951,21 @@
       U, Y, V, Y order will be named <constant>V4L2_MBUS_FMT_UYVY8_2X8</constant>.
       </para>
 
-      <para>The following table lisst existing packet YUV formats.</para>
+        <para><xref linkend="v4l2-mbus-pixelcode-yuv8"/> list existing packet YUV
+        formats and describes the organization of each pixel data in each sample.
+        When a format pattern is split across multiple samples each of the samples
+        in the pattern is described.</para>
+
+        <para>The role of each bit transferred over the bus is identified by one
+        of the following codes.</para>
+
+        <itemizedlist>
+           <listitem><para>y<subscript>x</subscript> for luma component bit number x</para></listitem>
+           <listitem><para>u<subscript>x</subscript> for blue chroma component bit number x</para></listitem>
+           <listitem><para>v<subscript>x</subscript> for red chroma component bit number x</para></listitem>
+           <listitem><para>- for non-available bits (for positions higher than the bus width)</para></listitem>
+           <listitem><para>d for dummy bits</para></listitem>
+        </itemizedlist>
 
       <table pgwide="0" frame="none" id="v4l2-mbus-pixelcode-yuv8">
         <title>YUV Formats</title>
@@ -965,6 +1053,56 @@
               <entry>y<subscript>1</subscript></entry>
               <entry>y<subscript>0</subscript></entry>
             </row>
+            <row id="V4L2-MBUS-FMT-UV8-1X8">
+              <entry>V4L2_MBUS_FMT_UV8_1X8</entry>
+              <entry>0x2015</entry>
+              <entry></entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>
+              <entry>-</entry>