* [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08'
@ 2014-01-31 3:36 Antti Palosaari
2014-01-31 3:36 ` [PATCH 2/2] DocBook: V4L: add V4L2_SDR_FMT_CU16LE - 'CU16' Antti Palosaari
` (2 more replies)
0 siblings, 3 replies; 5+ messages in thread
From: Antti Palosaari @ 2014-01-31 3:36 UTC (permalink / raw)
To: linux-media; +Cc: Antti Palosaari, Hans Verkuil
Document V4L2_SDR_FMT_CU8 SDR format.
It is complex unsigned 8-bit IQ sample. Used by software defined
radio devices.
Cc: Hans Verkuil <hverkuil@xs4all.nl>
Signed-off-by: Antti Palosaari <crope@iki.fi>
---
.../DocBook/media/v4l/pixfmt-sdr-cu08.xml | 44 ++++++++++++++++++++++
Documentation/DocBook/media/v4l/pixfmt.xml | 2 +
2 files changed, 46 insertions(+)
create mode 100644 Documentation/DocBook/media/v4l/pixfmt-sdr-cu08.xml
diff --git a/Documentation/DocBook/media/v4l/pixfmt-sdr-cu08.xml b/Documentation/DocBook/media/v4l/pixfmt-sdr-cu08.xml
new file mode 100644
index 0000000..2d80104
--- /dev/null
+++ b/Documentation/DocBook/media/v4l/pixfmt-sdr-cu08.xml
@@ -0,0 +1,44 @@
+<refentry id="V4L2-SDR-FMT-CU08">
+ <refmeta>
+ <refentrytitle>V4L2_SDR_FMT_CU8 ('CU08')</refentrytitle>
+ &manvol;
+ </refmeta>
+ <refnamediv>
+ <refname>
+ <constant>V4L2_SDR_FMT_CU8</constant>
+ </refname>
+ <refpurpose>Complex unsigned 8-bit IQ sample</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <para>
+This format contains sequence of complex number samples. Each complex number
+consist two parts, called In-phase and Quadrature (IQ). Both I and Q are
+represented as a 8 bit unsigned number. I value comes first and Q value after
+that.
+ </para>
+ <example>
+ <title><constant>V4L2_SDR_FMT_CU8</constant> 1 sample</title>
+ <formalpara>
+ <title>Byte Order.</title>
+ <para>Each cell is one byte.
+ <informaltable frame="none">
+ <tgroup cols="2" align="center">
+ <colspec align="left" colwidth="2*" />
+ <tbody valign="top">
+ <row>
+ <entry>start + 0:</entry>
+ <entry>I'<subscript>0</subscript></entry>
+ </row>
+ <row>
+ <entry>start + 1:</entry>
+ <entry>Q'<subscript>0</subscript></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </formalpara>
+ </example>
+ </refsect1>
+</refentry>
diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
index f586d34..40adcb8 100644
--- a/Documentation/DocBook/media/v4l/pixfmt.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt.xml
@@ -817,6 +817,8 @@ extended control <constant>V4L2_CID_MPEG_STREAM_TYPE</constant>, see
<para>These formats are used for <link linkend="sdr">SDR Capture</link>
interface only.</para>
+ &sub-sdr-cu08;
+
</section>
<section id="pixfmt-reserved">
--
1.8.5.3
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [PATCH 2/2] DocBook: V4L: add V4L2_SDR_FMT_CU16LE - 'CU16'
2014-01-31 3:36 [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08' Antti Palosaari
@ 2014-01-31 3:36 ` Antti Palosaari
2014-01-31 8:05 ` Hans Verkuil
2014-01-31 3:40 ` [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08' Antti Palosaari
2014-01-31 8:05 ` Hans Verkuil
2 siblings, 1 reply; 5+ messages in thread
From: Antti Palosaari @ 2014-01-31 3:36 UTC (permalink / raw)
To: linux-media; +Cc: Antti Palosaari, Hans Verkuil
Document V4L2_SDR_FMT_CU16LE format.
It is complex unsigned 16-bit little endian IQ sample. Used by
software defined radio devices.
Cc: Hans Verkuil <hverkuil@xs4all.nl>
Signed-off-by: Antti Palosaari <crope@iki.fi>
---
.../DocBook/media/v4l/pixfmt-sdr-cu16le.xml | 46 ++++++++++++++++++++++
Documentation/DocBook/media/v4l/pixfmt.xml | 1 +
2 files changed, 47 insertions(+)
create mode 100644 Documentation/DocBook/media/v4l/pixfmt-sdr-cu16le.xml
diff --git a/Documentation/DocBook/media/v4l/pixfmt-sdr-cu16le.xml b/Documentation/DocBook/media/v4l/pixfmt-sdr-cu16le.xml
new file mode 100644
index 0000000..26288ff
--- /dev/null
+++ b/Documentation/DocBook/media/v4l/pixfmt-sdr-cu16le.xml
@@ -0,0 +1,46 @@
+<refentry id="V4L2-SDR-FMT-CU16LE">
+ <refmeta>
+ <refentrytitle>V4L2_SDR_FMT_CU16LE ('CU16')</refentrytitle>
+ &manvol;
+ </refmeta>
+ <refnamediv>
+ <refname>
+ <constant>V4L2_SDR_FMT_CU16LE</constant>
+ </refname>
+ <refpurpose>Complex unsigned 16-bit little endian IQ sample</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <para>
+This format contains sequence of complex number samples. Each complex number
+consist two parts, called In-phase and Quadrature (IQ). Both I and Q are
+represented as a 16 bit unsigned little endian number. I value comes first
+and Q value after that.
+ </para>
+ <example>
+ <title><constant>V4L2_SDR_FMT_CU16LE</constant> 1 sample</title>
+ <formalpara>
+ <title>Byte Order.</title>
+ <para>Each cell is one byte.
+ <informaltable frame="none">
+ <tgroup cols="3" align="center">
+ <colspec align="left" colwidth="2*" />
+ <tbody valign="top">
+ <row>
+ <entry>start + 0:</entry>
+ <entry>I'<subscript>0[7:0]</subscript></entry>
+ <entry>I'<subscript>0[15:8]</subscript></entry>
+ </row>
+ <row>
+ <entry>start + 2:</entry>
+ <entry>Q'<subscript>0[7:0]</subscript></entry>
+ <entry>Q'<subscript>0[15:8]</subscript></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </formalpara>
+ </example>
+ </refsect1>
+</refentry>
diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
index 40adcb8..f535d9b 100644
--- a/Documentation/DocBook/media/v4l/pixfmt.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt.xml
@@ -818,6 +818,7 @@ extended control <constant>V4L2_CID_MPEG_STREAM_TYPE</constant>, see
interface only.</para>
&sub-sdr-cu08;
+ &sub-sdr-cu16le;
</section>
--
1.8.5.3
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08'
2014-01-31 3:36 [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08' Antti Palosaari
2014-01-31 3:36 ` [PATCH 2/2] DocBook: V4L: add V4L2_SDR_FMT_CU16LE - 'CU16' Antti Palosaari
@ 2014-01-31 3:40 ` Antti Palosaari
2014-01-31 8:05 ` Hans Verkuil
2 siblings, 0 replies; 5+ messages in thread
From: Antti Palosaari @ 2014-01-31 3:40 UTC (permalink / raw)
To: linux-media; +Cc: Hans Verkuil
On 31.01.2014 05:36, Antti Palosaari wrote:
> Document V4L2_SDR_FMT_CU8 SDR format.
I decided to shorten these names by replacing "PIX" with "SDR".
V4L2_SDR_FMT_CU8
V4L2_PIX_FMT_GREY
regards
Antti
--
http://palosaari.fi/
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08'
2014-01-31 3:36 [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08' Antti Palosaari
2014-01-31 3:36 ` [PATCH 2/2] DocBook: V4L: add V4L2_SDR_FMT_CU16LE - 'CU16' Antti Palosaari
2014-01-31 3:40 ` [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08' Antti Palosaari
@ 2014-01-31 8:05 ` Hans Verkuil
2 siblings, 0 replies; 5+ messages in thread
From: Hans Verkuil @ 2014-01-31 8:05 UTC (permalink / raw)
To: Antti Palosaari; +Cc: linux-media
Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Regards,
Hans
On 01/31/2014 04:36 AM, Antti Palosaari wrote:
> Document V4L2_SDR_FMT_CU8 SDR format.
> It is complex unsigned 8-bit IQ sample. Used by software defined
> radio devices.
>
> Cc: Hans Verkuil <hverkuil@xs4all.nl>
> Signed-off-by: Antti Palosaari <crope@iki.fi>
> ---
> .../DocBook/media/v4l/pixfmt-sdr-cu08.xml | 44 ++++++++++++++++++++++
> Documentation/DocBook/media/v4l/pixfmt.xml | 2 +
> 2 files changed, 46 insertions(+)
> create mode 100644 Documentation/DocBook/media/v4l/pixfmt-sdr-cu08.xml
>
> diff --git a/Documentation/DocBook/media/v4l/pixfmt-sdr-cu08.xml b/Documentation/DocBook/media/v4l/pixfmt-sdr-cu08.xml
> new file mode 100644
> index 0000000..2d80104
> --- /dev/null
> +++ b/Documentation/DocBook/media/v4l/pixfmt-sdr-cu08.xml
> @@ -0,0 +1,44 @@
> +<refentry id="V4L2-SDR-FMT-CU08">
> + <refmeta>
> + <refentrytitle>V4L2_SDR_FMT_CU8 ('CU08')</refentrytitle>
> + &manvol;
> + </refmeta>
> + <refnamediv>
> + <refname>
> + <constant>V4L2_SDR_FMT_CU8</constant>
> + </refname>
> + <refpurpose>Complex unsigned 8-bit IQ sample</refpurpose>
> + </refnamediv>
> + <refsect1>
> + <title>Description</title>
> + <para>
> +This format contains sequence of complex number samples. Each complex number
> +consist two parts, called In-phase and Quadrature (IQ). Both I and Q are
> +represented as a 8 bit unsigned number. I value comes first and Q value after
> +that.
> + </para>
> + <example>
> + <title><constant>V4L2_SDR_FMT_CU8</constant> 1 sample</title>
> + <formalpara>
> + <title>Byte Order.</title>
> + <para>Each cell is one byte.
> + <informaltable frame="none">
> + <tgroup cols="2" align="center">
> + <colspec align="left" colwidth="2*" />
> + <tbody valign="top">
> + <row>
> + <entry>start + 0:</entry>
> + <entry>I'<subscript>0</subscript></entry>
> + </row>
> + <row>
> + <entry>start + 1:</entry>
> + <entry>Q'<subscript>0</subscript></entry>
> + </row>
> + </tbody>
> + </tgroup>
> + </informaltable>
> + </para>
> + </formalpara>
> + </example>
> + </refsect1>
> +</refentry>
> diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
> index f586d34..40adcb8 100644
> --- a/Documentation/DocBook/media/v4l/pixfmt.xml
> +++ b/Documentation/DocBook/media/v4l/pixfmt.xml
> @@ -817,6 +817,8 @@ extended control <constant>V4L2_CID_MPEG_STREAM_TYPE</constant>, see
> <para>These formats are used for <link linkend="sdr">SDR Capture</link>
> interface only.</para>
>
> + &sub-sdr-cu08;
> +
> </section>
>
> <section id="pixfmt-reserved">
>
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH 2/2] DocBook: V4L: add V4L2_SDR_FMT_CU16LE - 'CU16'
2014-01-31 3:36 ` [PATCH 2/2] DocBook: V4L: add V4L2_SDR_FMT_CU16LE - 'CU16' Antti Palosaari
@ 2014-01-31 8:05 ` Hans Verkuil
0 siblings, 0 replies; 5+ messages in thread
From: Hans Verkuil @ 2014-01-31 8:05 UTC (permalink / raw)
To: Antti Palosaari; +Cc: linux-media
Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Regards,
Hans
On 01/31/2014 04:36 AM, Antti Palosaari wrote:
> Document V4L2_SDR_FMT_CU16LE format.
> It is complex unsigned 16-bit little endian IQ sample. Used by
> software defined radio devices.
>
> Cc: Hans Verkuil <hverkuil@xs4all.nl>
> Signed-off-by: Antti Palosaari <crope@iki.fi>
> ---
> .../DocBook/media/v4l/pixfmt-sdr-cu16le.xml | 46 ++++++++++++++++++++++
> Documentation/DocBook/media/v4l/pixfmt.xml | 1 +
> 2 files changed, 47 insertions(+)
> create mode 100644 Documentation/DocBook/media/v4l/pixfmt-sdr-cu16le.xml
>
> diff --git a/Documentation/DocBook/media/v4l/pixfmt-sdr-cu16le.xml b/Documentation/DocBook/media/v4l/pixfmt-sdr-cu16le.xml
> new file mode 100644
> index 0000000..26288ff
> --- /dev/null
> +++ b/Documentation/DocBook/media/v4l/pixfmt-sdr-cu16le.xml
> @@ -0,0 +1,46 @@
> +<refentry id="V4L2-SDR-FMT-CU16LE">
> + <refmeta>
> + <refentrytitle>V4L2_SDR_FMT_CU16LE ('CU16')</refentrytitle>
> + &manvol;
> + </refmeta>
> + <refnamediv>
> + <refname>
> + <constant>V4L2_SDR_FMT_CU16LE</constant>
> + </refname>
> + <refpurpose>Complex unsigned 16-bit little endian IQ sample</refpurpose>
> + </refnamediv>
> + <refsect1>
> + <title>Description</title>
> + <para>
> +This format contains sequence of complex number samples. Each complex number
> +consist two parts, called In-phase and Quadrature (IQ). Both I and Q are
> +represented as a 16 bit unsigned little endian number. I value comes first
> +and Q value after that.
> + </para>
> + <example>
> + <title><constant>V4L2_SDR_FMT_CU16LE</constant> 1 sample</title>
> + <formalpara>
> + <title>Byte Order.</title>
> + <para>Each cell is one byte.
> + <informaltable frame="none">
> + <tgroup cols="3" align="center">
> + <colspec align="left" colwidth="2*" />
> + <tbody valign="top">
> + <row>
> + <entry>start + 0:</entry>
> + <entry>I'<subscript>0[7:0]</subscript></entry>
> + <entry>I'<subscript>0[15:8]</subscript></entry>
> + </row>
> + <row>
> + <entry>start + 2:</entry>
> + <entry>Q'<subscript>0[7:0]</subscript></entry>
> + <entry>Q'<subscript>0[15:8]</subscript></entry>
> + </row>
> + </tbody>
> + </tgroup>
> + </informaltable>
> + </para>
> + </formalpara>
> + </example>
> + </refsect1>
> +</refentry>
> diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
> index 40adcb8..f535d9b 100644
> --- a/Documentation/DocBook/media/v4l/pixfmt.xml
> +++ b/Documentation/DocBook/media/v4l/pixfmt.xml
> @@ -818,6 +818,7 @@ extended control <constant>V4L2_CID_MPEG_STREAM_TYPE</constant>, see
> interface only.</para>
>
> &sub-sdr-cu08;
> + &sub-sdr-cu16le;
>
> </section>
>
>
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2014-01-31 8:05 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-01-31 3:36 [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08' Antti Palosaari
2014-01-31 3:36 ` [PATCH 2/2] DocBook: V4L: add V4L2_SDR_FMT_CU16LE - 'CU16' Antti Palosaari
2014-01-31 8:05 ` Hans Verkuil
2014-01-31 3:40 ` [PATCH 1/2] DocBook: V4L: add V4L2_SDR_FMT_CU8 - 'CU08' Antti Palosaari
2014-01-31 8:05 ` Hans Verkuil
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.