Re: [RFC/PATCH] v4l: Add V4L2_MBUS_FMT_JPEG_1X8 media bus format

2011-03-24 Thread Laurent Pinchart
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.nawro...@samsung.com
 Signed-off-by: Kyungmin Park kyungmin.p...@samsung.com
 ---
 
 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 RD 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
 +  titleJPEG Compressed Formats/title
 +
 +  paraThose 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
 +   listitemThe bus width in bits./listitem
 + /itemizedlist
 +
 + paraFor instance, a format where bus width is 8 bits will be named
 +   constantV4L2_MBUS_FMT_JPEG_1X8/constant.
 + /para
 +
 +  /para
 +
 +  paraThe following table lists existing JPEG compressed
 formats./para +
 +  table pgwide=0 frame=none id=v4l2-mbus-pixelcode-jpeg
 + titleJPEG Formats/title
 + tgroup cols=23
 +   colspec colname=id align=left /
 +   colspec colname=code align=left/
 +   colspec colname=remarks align=left/
 +   thead
 + row
 +   entryIdentifier/entry
 +   entryCode/entry
 +   entryRemarks/entry
 + /row
 +   /thead
 +   tbody valign=top
 + row id=V4L2-MBUS-FMT-JPEG-1X8
 +   entryV4L2_MBUS_FMT_JPEG_1X8/entry
 +   entry0x4001/entry
 +   entry This format shall be used for of transmission of JPEG
 + 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.

 +   /entry
 + /row
 +
 +   /tbody
 + /tgroup
 +  /table
 +/section
/section
  /section
 diff --git a/include/linux/v4l2-mediabus.h b/include/linux/v4l2-mediabus.h
 index 7054a7a..15d6cda 100644
 --- a/include/linux/v4l2-mediabus.h
 +++ b/include/linux/v4l2-mediabus.h
 @@ -86,6 +86,9 @@ enum v4l2_mbus_pixelcode {
   V4L2_MBUS_FMT_SGBRG12_1X12 = 0x3010,
   V4L2_MBUS_FMT_SGRBG12_1X12 = 0x3011,
   V4L2_MBUS_FMT_SRGGB12_1X12 = 0x3012,
 +
 + /* JPEG compressed formats - next is 0x4002 */
 + V4L2_MBUS_FMT_JPEG_1X8 = 0x4001,
  };
 
  /**

-- 
Regards,

Laurent Pinchart
--
To unsubscribe from this list: send the line unsubscribe linux-media in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


Re: [RFC/PATCH] v4l: Add V4L2_MBUS_FMT_JPEG_1X8 media bus format

2011-03-24 Thread Sylwester Nawrocki
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.nawro...@samsung.com
 Signed-off-by: Kyungmin Park kyungmin.p...@samsung.com
 ---

 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 RD 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
 +  titleJPEG Compressed Formats/title
 +
 +  paraThose 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
 +  listitemThe bus width in bits./listitem
 +/itemizedlist
 +
 +paraFor instance, a format where bus width is 8 bits will be named
 +  constantV4L2_MBUS_FMT_JPEG_1X8/constant.
 +/para
 +
 +  /para
 +
 +  paraThe following table lists existing JPEG compressed
 formats./para +
 +  table pgwide=0 frame=none id=v4l2-mbus-pixelcode-jpeg
 +titleJPEG 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
 +  entryIdentifier/entry
 +  entryCode/entry
 +  entryRemarks/entry
 +/row
 +  /thead
 +  tbody valign=top
 +row id=V4L2-MBUS-FMT-JPEG-1X8
 +  entryV4L2_MBUS_FMT_JPEG_1X8/entry
 +  entry0x4001/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:
...
+   entry0x4001/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 RD Center
--
To unsubscribe from this list: send the line unsubscribe linux-media in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html


Re: [RFC/PATCH] v4l: Add V4L2_MBUS_FMT_JPEG_1X8 media bus format

2011-03-24 Thread Laurent Pinchart
Hi Sylwester,

On Thursday 24 March 2011 15:58:02 Sylwester Nawrocki wrote:
 On 03/24/2011 03:38 PM, Laurent Pinchart wrote:
  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.nawro...@samsung.com
  Signed-off-by: Kyungmin Park kyungmin.p...@samsung.com
  ---
  
  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 RD 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
  +  titleJPEG Compressed Formats/title
  +
  +  paraThose 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
  +listitemThe bus width in bits./listitem
  +  /itemizedlist
  +
  +  paraFor instance, a format where bus width is 8 bits will be named
  +constantV4L2_MBUS_FMT_JPEG_1X8/constant.
  +  /para
  +
  +  /para
  +
  +  paraThe following table lists existing JPEG compressed
  formats./para +
  +  table pgwide=0 frame=none id=v4l2-mbus-pixelcode-jpeg
  +  titleJPEG 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
  +entryIdentifier/entry
  +entryCode/entry
  +entryRemarks/entry
  +  /row
  +/thead
  +tbody valign=top
  +  row id=V4L2-MBUS-FMT-JPEG-1X8
  +entryV4L2_MBUS_FMT_JPEG_1X8/entry
  +entry0x4001/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:
 ...
 + entry0x4001/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?

Yes that's better. Your first version sounded like the format was only used 
for MIPI CSI-2 sensors to me.

-- 
Regards,

Laurent Pinchart
--
To unsubscribe from this list: send the line unsubscribe linux-media in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html