aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook
diff options
context:
space:
mode:
authorManjunath Hadli <manjunath.hadli@ti.com>2012-10-18 06:54:59 -0400
committerMauro Carvalho Chehab <mchehab@redhat.com>2012-12-19 09:20:19 -0500
commitc196f6ee61e42df9acec797ab41a0c8d87e8aa2e (patch)
treea1bc606197b84c6b4bf743427cf576594435e575 /Documentation/DocBook
parentf818b358dc94c845490dfc8a9771492e5311fe9e (diff)
[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>
Diffstat (limited to 'Documentation/DocBook')
-rw-r--r--Documentation/DocBook/media/v4l/subdev-formats.xml250
1 files changed, 244 insertions, 6 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 @@
353 <listitem><para>The number of bits per pixel component. All components are 353 <listitem><para>The number of bits per pixel component. All components are
354 transferred on the same number of bits. Common values are 8, 10 and 12.</para> 354 transferred on the same number of bits. Common values are 8, 10 and 12.</para>
355 </listitem> 355 </listitem>
356 <listitem><para>If the pixel components are DPCM-compressed, a mention of the 356 <listitem><para>The compression (optional). If the pixel components are
357 DPCM compression and the number of bits per compressed pixel component.</para> 357 ALAW- or DPCM-compressed, a mention of the compression scheme and the
358 </listitem> 358 number of bits per compressed pixel component.</para></listitem>
359 <listitem><para>The number of bus samples per pixel. Pixels that are wider than 359 <listitem><para>The number of bus samples per pixel. Pixels that are wider than
360 the bus width must be transferred in multiple samples. Common values are 360 the bus width must be transferred in multiple samples. Common values are
361 1 and 2.</para></listitem> 361 1 and 2.</para></listitem>
@@ -504,6 +504,74 @@
504 <entry>r<subscript>1</subscript></entry> 504 <entry>r<subscript>1</subscript></entry>
505 <entry>r<subscript>0</subscript></entry> 505 <entry>r<subscript>0</subscript></entry>
506 </row> 506 </row>
507 <row id="V4L2-MBUS-FMT-SBGGR10-ALAW8-1X8">
508 <entry>V4L2_MBUS_FMT_SBGGR10_ALAW8_1X8</entry>
509 <entry>0x3015</entry>
510 <entry></entry>
511 <entry>-</entry>
512 <entry>-</entry>
513 <entry>-</entry>
514 <entry>-</entry>
515 <entry>b<subscript>7</subscript></entry>
516 <entry>b<subscript>6</subscript></entry>
517 <entry>b<subscript>5</subscript></entry>
518 <entry>b<subscript>4</subscript></entry>
519 <entry>b<subscript>3</subscript></entry>
520 <entry>b<subscript>2</subscript></entry>
521 <entry>b<subscript>1</subscript></entry>
522 <entry>b<subscript>0</subscript></entry>
523 </row>
524 <row id="V4L2-MBUS-FMT-SGBRG10-ALAW8-1X8">
525 <entry>V4L2_MBUS_FMT_SGBRG10_ALAW8_1X8</entry>
526 <entry>0x3016</entry>
527 <entry></entry>
528 <entry>-</entry>
529 <entry>-</entry>
530 <entry>-</entry>
531 <entry>-</entry>
532 <entry>g<subscript>7</subscript></entry>
533 <entry>g<subscript>6</subscript></entry>
534 <entry>g<subscript>5</subscript></entry>
535 <entry>g<subscript>4</subscript></entry>
536 <entry>g<subscript>3</subscript></entry>
537 <entry>g<subscript>2</subscript></entry>
538 <entry>g<subscript>1</subscript></entry>
539 <entry>g<subscript>0</subscript></entry>
540 </row>
541 <row id="V4L2-MBUS-FMT-SGRBG10-ALAW8-1X8">
542 <entry>V4L2_MBUS_FMT_SGRBG10_ALAW8_1X8</entry>
543 <entry>0x3017</entry>
544 <entry></entry>
545 <entry>-</entry>
546 <entry>-</entry>
547 <entry>-</entry>
548 <entry>-</entry>
549 <entry>g<subscript>7</subscript></entry>
550 <entry>g<subscript>6</subscript></entry>
551 <entry>g<subscript>5</subscript></entry>
552 <entry>g<subscript>4</subscript></entry>
553 <entry>g<subscript>3</subscript></entry>
554 <entry>g<subscript>2</subscript></entry>
555 <entry>g<subscript>1</subscript></entry>
556 <entry>g<subscript>0</subscript></entry>
557 </row>
558 <row id="V4L2-MBUS-FMT-SRGGB10-ALAW8-1X8">
559 <entry>V4L2_MBUS_FMT_SRGGB10_ALAW8_1X8</entry>
560 <entry>0x3018</entry>
561 <entry></entry>
562 <entry>-</entry>
563 <entry>-</entry>
564 <entry>-</entry>
565 <entry>-</entry>
566 <entry>r<subscript>7</subscript></entry>
567 <entry>r<subscript>6</subscript></entry>
568 <entry>r<subscript>5</subscript></entry>
569 <entry>r<subscript>4</subscript></entry>
570 <entry>r<subscript>3</subscript></entry>
571 <entry>r<subscript>2</subscript></entry>
572 <entry>r<subscript>1</subscript></entry>
573 <entry>r<subscript>0</subscript></entry>
574 </row>
507 <row id="V4L2-MBUS-FMT-SBGGR10-DPCM8-1X8"> 575 <row id="V4L2-MBUS-FMT-SBGGR10-DPCM8-1X8">
508 <entry>V4L2_MBUS_FMT_SBGGR10_DPCM8_1X8</entry> 576 <entry>V4L2_MBUS_FMT_SBGGR10_DPCM8_1X8</entry>
509 <entry>0x300b</entry> 577 <entry>0x300b</entry>
@@ -853,10 +921,16 @@
853 <title>Packed YUV Formats</title> 921 <title>Packed YUV Formats</title>
854 922
855 <para>Those data formats transfer pixel data as (possibly downsampled) Y, U 923 <para>Those data formats transfer pixel data as (possibly downsampled) Y, U
856 and V components. The format code is made of the following information. 924 and V components. Some formats include dummy bits in some of their samples
925 and are collectively referred to as "YDYC" (Y-Dummy-Y-Chroma) formats.
926 One cannot rely on the values of these dummy bits as those are undefined.
927 </para>
928 <para>The format code is made of the following information.
857 <itemizedlist> 929 <itemizedlist>
858 <listitem><para>The Y, U and V components order code, as transferred on the 930 <listitem><para>The Y, U and V components order code, as transferred on the
859 bus. Possible values are YUYV, UYVY, YVYU and VYUY.</para></listitem> 931 bus. Possible values are YUYV, UYVY, YVYU and VYUY for formats with no
932 dummy bit, and YDYUYDYV, YDYVYDYU, YUYDYVYD and YVYDYUYD for YDYC formats.
933 </para></listitem>
860 <listitem><para>The number of bits per pixel component. All components are 934 <listitem><para>The number of bits per pixel component. All components are
861 transferred on the same number of bits. Common values are 8, 10 and 12.</para> 935 transferred on the same number of bits. Common values are 8, 10 and 12.</para>
862 </listitem> 936 </listitem>
@@ -877,7 +951,21 @@
877 U, Y, V, Y order will be named <constant>V4L2_MBUS_FMT_UYVY8_2X8</constant>. 951 U, Y, V, Y order will be named <constant>V4L2_MBUS_FMT_UYVY8_2X8</constant>.
878 </para> 952 </para>
879 953
880 <para>The following table lisst existing packet YUV formats.</para> 954 <para><xref linkend="v4l2-mbus-pixelcode-yuv8"/> list existing packet YUV
955 formats and describes the organization of each pixel data in each sample.
956 When a format pattern is split across multiple samples each of the samples
957 in the pattern is described.</para>
958
959 <para>The role of each bit transferred over the bus is identified by one
960 of the following codes.</para>
961
962 <itemizedlist>
963 <listitem><para>y<subscript>x</subscript> for luma component bit number x</para></listitem>
964 <listitem><para>u<subscript>x</subscript> for blue chroma component bit number x</para></listitem>
965 <listitem><para>v<subscript>x</subscript> for red chroma component bit number x</para></listitem>
966 <listitem><para>- for non-available bits (for positions higher than the bus width)</para></listitem>
967 <listitem><para>d for dummy bits</para></listitem>
968 </itemizedlist>
881 969
882 <table pgwide="0" frame="none" id="v4l2-mbus-pixelcode-yuv8"> 970 <table pgwide="0" frame="none" id="v4l2-mbus-pixelcode-yuv8">
883 <title>YUV Formats</title> 971 <title>YUV Formats</title>
@@ -965,6 +1053,56 @@
965 <entry>y<subscript>1</subscript></entry> 1053 <entry>y<subscript>1</subscript></entry>
966 <entry>y<subscript>0</subscript></entry> 1054 <entry>y<subscript>0</subscript></entry>
967 </row> 1055 </row>
1056 <row id="V4L2-MBUS-FMT-UV8-1X8">
1057 <entry>V4L2_MBUS_FMT_UV8_1X8</entry>
1058 <entry>0x2015</entry>
1059 <entry></entry>
1060 <entry>-</entry>
1061 <entry>-</entry>
1062 <entry>-</entry>
1063 <entry>-</entry>
1064 <entry>-</entry>
1065 <entry>-</entry>
1066 <entry>-</entry>
1067 <entry>-</entry>
1068 <entry>-</entry>
1069 <entry>-</entry>
1070 <entry>-</entry>
1071 <entry>-</entry>
1072 <entry>u<subscript>7</subscript></entry>
1073 <entry>u<subscript>6</subscript></entry>
1074 <entry>u<subscript>5</subscript></entry>
1075 <entry>u<subscript>4</subscript></entry>
1076 <entry>u<subscript>3</subscript></entry>
1077 <entry>u<subscript>2</subscript></entry>
1078 <entry>u<subscript>1</subscript></entry>
1079 <entry>u<subscript>0</subscript></entry>
1080 </row>
1081 <row>
1082 <entry></entry>
1083 <entry></entry>
1084 <entry></entry>
1085 <entry>-</entry>
1086 <entry>-</entry>
1087 <entry>-</entry>
1088 <entry>-</entry>
1089 <entry>-</entry>
1090 <entry>-</entry>
1091 <entry>-</entry>
1092 <entry>-</entry>
1093 <entry>-</entry>
1094 <entry>-</entry>
1095 <entry>-</entry>
1096 <entry>-</entry>
1097 <entry>v<subscript>7</subscript></entry>
1098 <entry>v<subscript>6</subscript></entry>
1099 <entry>v<subscript>5</subscript></entry>
1100 <entry>v<subscript>4</subscript></entry>
1101 <entry>v<subscript>3</subscript></entry>
1102 <entry>v<subscript>2</subscript></entry>
1103 <entry>v<subscript>1</subscript></entry>
1104 <entry>v<subscript>0</subscript></entry>
1105 </row>
968 <row id="V4L2-MBUS-FMT-UYVY8-1_5X8"> 1106 <row id="V4L2-MBUS-FMT-UYVY8-1_5X8">
969 <entry>V4L2_MBUS_FMT_UYVY8_1_5X8</entry> 1107 <entry>V4L2_MBUS_FMT_UYVY8_1_5X8</entry>
970 <entry>0x2002</entry> 1108 <entry>0x2002</entry>
@@ -2415,6 +2553,106 @@
2415 <entry>u<subscript>1</subscript></entry> 2553 <entry>u<subscript>1</subscript></entry>
2416 <entry>u<subscript>0</subscript></entry> 2554 <entry>u<subscript>0</subscript></entry>
2417 </row> 2555 </row>
2556 <row id="V4L2-MBUS-FMT-YDYUYDYV8-1X16">
2557 <entry>V4L2_MBUS_FMT_YDYUYDYV8_1X16</entry>
2558 <entry>0x2014</entry>
2559 <entry></entry>
2560 <entry>-</entry>
2561 <entry>-</entry>
2562 <entry>-</entry>
2563 <entry>-</entry>
2564 <entry>y<subscript>7</subscript></entry>
2565 <entry>y<subscript>6</subscript></entry>
2566 <entry>y<subscript>5</subscript></entry>
2567 <entry>y<subscript>4</subscript></entry>
2568 <entry>y<subscript>3</subscript></entry>
2569 <entry>y<subscript>2</subscript></entry>
2570 <entry>y<subscript>1</subscript></entry>
2571 <entry>y<subscript>0</subscript></entry>
2572 <entry>d</entry>
2573 <entry>d</entry>
2574 <entry>d</entry>
2575 <entry>d</entry>
2576 <entry>d</entry>
2577 <entry>d</entry>
2578 <entry>d</entry>
2579 <entry>d</entry>
2580 </row>
2581 <row>
2582 <entry></entry>
2583 <entry></entry>
2584 <entry></entry>
2585 <entry>-</entry>
2586 <entry>-</entry>
2587 <entry>-</entry>
2588 <entry>-</entry>
2589 <entry>y<subscript>7</subscript></entry>
2590 <entry>y<subscript>6</subscript></entry>
2591 <entry>y<subscript>5</subscript></entry>
2592 <entry>y<subscript>4</subscript></entry>
2593 <entry>y<subscript>3</subscript></entry>
2594 <entry>y<subscript>2</subscript></entry>
2595 <entry>y<subscript>1</subscript></entry>
2596 <entry>y<subscript>0</subscript></entry>
2597 <entry>u<subscript>7</subscript></entry>
2598 <entry>u<subscript>6</subscript></entry>
2599 <entry>u<subscript>5</subscript></entry>
2600 <entry>u<subscript>4</subscript></entry>
2601 <entry>u<subscript>3</subscript></entry>
2602 <entry>u<subscript>2</subscript></entry>
2603 <entry>u<subscript>1</subscript></entry>
2604 <entry>u<subscript>0</subscript></entry>
2605 </row>
2606 <row>
2607 <entry></entry>
2608 <entry></entry>
2609 <entry></entry>
2610 <entry>-</entry>
2611 <entry>-</entry>
2612 <entry>-</entry>
2613 <entry>-</entry>
2614 <entry>y<subscript>7</subscript></entry>
2615 <entry>y<subscript>6</subscript></entry>
2616 <entry>y<subscript>5</subscript></entry>
2617 <entry>y<subscript>4</subscript></entry>
2618 <entry>y<subscript>3</subscript></entry>
2619 <entry>y<subscript>2</subscript></entry>
2620 <entry>y<subscript>1</subscript></entry>
2621 <entry>y<subscript>0</subscript></entry>
2622 <entry>d</entry>
2623 <entry>d</entry>
2624 <entry>d</entry>
2625 <entry>d</entry>
2626 <entry>d</entry>
2627 <entry>d</entry>
2628 <entry>d</entry>
2629 <entry>d</entry>
2630 </row>
2631 <row>
2632 <entry></entry>
2633 <entry></entry>
2634 <entry></entry>
2635 <entry>-</entry>
2636 <entry>-</entry>
2637 <entry>-</entry>
2638 <entry>-</entry>
2639 <entry>y<subscript>7</subscript></entry>
2640 <entry>y<subscript>6</subscript></entry>
2641 <entry>y<subscript>5</subscript></entry>
2642 <entry>y<subscript>4</subscript></entry>
2643 <entry>y<subscript>3</subscript></entry>
2644 <entry>y<subscript>2</subscript></entry>
2645 <entry>y<subscript>1</subscript></entry>
2646 <entry>y<subscript>0</subscript></entry>
2647 <entry>v<subscript>7</subscript></entry>
2648 <entry>v<subscript>6</subscript></entry>
2649 <entry>v<subscript>5</subscript></entry>
2650 <entry>v<subscript>4</subscript></entry>
2651 <entry>v<subscript>3</subscript></entry>
2652 <entry>v<subscript>2</subscript></entry>
2653 <entry>v<subscript>1</subscript></entry>
2654 <entry>v<subscript>0</subscript></entry>
2655 </row>
2418 <row id="V4L2-MBUS-FMT-YUYV10-1X20"> 2656 <row id="V4L2-MBUS-FMT-YUYV10-1X20">
2419 <entry>V4L2_MBUS_FMT_YUYV10_1X20</entry> 2657 <entry>V4L2_MBUS_FMT_YUYV10_1X20</entry>
2420 <entry>0x200d</entry> 2658 <entry>0x200d</entry>
generated by cgit v1.2.2 (git 2.25.0) at 2024-10-10 13:21:03 -0400