Hi Laurent, thanks for your comments. On 03/24/2011 03:38 PM, Laurent Pinchart wrote: > Hi Sylwester, > > On Thursday 24 March 2011 15:19:54 Sylwester Nawrocki wrote: >> Add V4L2_MBUS_FMT_JPEG_1X8 format and the corresponding Docbook >> documentation. >> >> Signed-off-by: Sylwester Nawrocki <s.nawrocki@xxxxxxxxxxx> >> Signed-off-by: Kyungmin Park <kyungmin.park@xxxxxxxxxxx> >> --- >> >> Hi all, >> >> I would like to propose and addition of JPEG format to the list >> of media bus formats. The requirement of this format had already >> been discussed in the past [1], [2]. >> This patch adds relevant entry in v4l2-mediabus.h header and >> the documentation. Initially I have added only bus width information >> to the format code. I am not sure what other information could be >> included. I am open to suggestions if anyone knows about any other >> requirements. >> >> JPEG format on media bus is, among others, required for Samsung >> S5P MIPI CSI receiver [3] and M-5MOLS camera drivers [4]. >> >> Comments are welcome! >> >> -- >> Regards, >> Sylwester Nawrocki, >> Samsung Poland R&D Center >> >> [1] http://www.spinics.net/lists/linux-media/msg27980.html >> [2] http://www.spinics.net/lists/linux-media/msg28651.html >> [3] http://www.spinics.net/lists/linux-samsung-soc/msg03807.html >> [4] http://lwn.net/Articles/433836/ >> --- >> Documentation/DocBook/v4l/subdev-formats.xml | 45 >> ++++++++++++++++++++++++++ include/linux/v4l2-mediabus.h | >> 3 ++ >> 2 files changed, 48 insertions(+), 0 deletions(-) >> >> diff --git a/Documentation/DocBook/v4l/subdev-formats.xml >> b/Documentation/DocBook/v4l/subdev-formats.xml index b5376e2..60a6fe2 >> 100644 >> --- a/Documentation/DocBook/v4l/subdev-formats.xml >> +++ b/Documentation/DocBook/v4l/subdev-formats.xml >> @@ -2463,5 +2463,50 @@ >> </tgroup> >> </table> >> </section> >> + >> + <section> >> + <title>JPEG Compressed Formats</title> >> + >> + <para>Those data formats are used to transfer arbitrary byte-based >> image + data obtained from JPEG compression process. The format code >> + is made of the following information. >> + <itemizedlist> >> + <listitem>The bus width in bits.</listitem> >> + </itemizedlist> >> + >> + <para>For instance, a format where bus width is 8 bits will be named >> + <constant>V4L2_MBUS_FMT_JPEG_1X8</constant>. >> + </para> >> + >> + </para> >> + >> + <para>The following table lists existing JPEG compressed >> formats.</para> + >> + <table pgwide="0" frame="none" id="v4l2-mbus-pixelcode-jpeg"> >> + <title>JPEG Formats</title> >> + <tgroup cols="23"> Oops, looks like I've send wrong patch version. That should read <tgroup cols="3"> >> + <colspec colname="id" align="left" /> >> + <colspec colname="code" align="left"/> >> + <colspec colname="remarks" align="left"/> >> + <thead> >> + <row> >> + <entry>Identifier</entry> >> + <entry>Code</entry> >> + <entry>Remarks</entry> >> + </row> >> + </thead> >> + <tbody valign="top"> >> + <row id="V4L2-MBUS-FMT-JPEG-1X8"> >> + <entry>V4L2_MBUS_FMT_JPEG_1X8</entry> >> + <entry>0x4001</entry> >> + <entry> This format shall be used for of transmission of JPEG ..and s/for of/for >> + data over MIPI CSI-2 bus with User Defined 8-bit Data types. > > JPEG formats are not limited to MIPI, some parallel sensors can transmit JPEG > as well. Yes, I am aware of that. One of examples could be the old TCM8240MD sensor. http://www.sparkfun.com/datasheets/Sensors/Imaging/TCM8240MD_E150405_REV13.pdf My intention was to indicate that V4L2_MBUS_FMT_JPEG_1X8 format is the preferred one for "User Defined 8-bit Data Transmission" over the serial MIPI-CSI link. I'm not sure if "Remarks" column is needed. Maybe something like: ... + <entry>0x4001</entry> + <entry> This format is recommended for transmission of JPEG + data over MIPI CSI-2 bus with User Defined 8-bit Data types. + <entry> ... would be better? -- Regards, Sylwester -- Sylwester Nawrocki Samsung Poland R&D Center -- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
