X-Git-Url: https://git.kernelconcepts.de/?a=blobdiff_plain;ds=sidebyside;f=Documentation%2FDocBook%2Fmedia%2Fv4l%2Fdev-sdr.xml;h=a659771f7b7cca90feb6e22958d1e480e881d084;hb=ad1dd382629e84bbcbf4ef11c5c93d831399c5cd;hp=f8903568a243d81dcd2f5e5a76ab40e37b4b4e22;hpb=890ca861f868a10617029ffc87eae7d48ea6876c;p=karo-tx-linux.git
diff --git a/Documentation/DocBook/media/v4l/dev-sdr.xml b/Documentation/DocBook/media/v4l/dev-sdr.xml
index f8903568a243..a659771f7b7c 100644
--- a/Documentation/DocBook/media/v4l/dev-sdr.xml
+++ b/Documentation/DocBook/media/v4l/dev-sdr.xml
@@ -28,6 +28,16 @@ Devices supporting the SDR receiver interface set the
capabilities field of &v4l2-capability;
returned by the &VIDIOC-QUERYCAP; ioctl. That flag means the device has an
Analog to Digital Converter (ADC), which is a mandatory element for the SDR receiver.
+
+
+Devices supporting the SDR transmitter interface set the
+V4L2_CAP_SDR_OUTPUT and
+V4L2_CAP_MODULATOR flag in the
+capabilities field of &v4l2-capability;
+returned by the &VIDIOC-QUERYCAP; ioctl. That flag means the device has an
+Digital to Analog Converter (DAC), which is a mandatory element for the SDR transmitter.
+
+
At least one of the read/write, streaming or asynchronous I/O methods must
be supported.
@@ -39,15 +49,16 @@ be supported.
SDR devices can support controls, and must
support the tuner ioctls. Tuner ioctls are used
-for setting the ADC sampling rate (sampling frequency) and the possible RF tuner
-frequency.
+for setting the ADC/DAC sampling rate (sampling frequency) and the possible
+radio frequency (RF).
-The V4L2_TUNER_ADC tuner type is used for ADC tuners, and
-the V4L2_TUNER_RF tuner type is used for RF tuners. The
-tuner index of the RF tuner (if any) must always follow the ADC tuner index.
-Normally the ADC tuner is #0 and the RF tuner is #1.
+The V4L2_TUNER_SDR tuner type is used for setting SDR
+device ADC/DAC frequency, and the V4L2_TUNER_RF
+tuner type is used for setting radio frequency.
+The tuner index of the RF tuner (if any) must always follow the SDR tuner index.
+Normally the SDR tuner is #0 and the RF tuner is #1.
@@ -59,9 +70,9 @@ The &VIDIOC-S-HW-FREQ-SEEK; ioctl is not supported.
Data Format Negotiation
-The SDR capture device uses the format ioctls to
-select the capture format. Both the sampling resolution and the data streaming
-format are bound to that selectable format. In addition to the basic
+The SDR device uses the format ioctls to
+select the capture and output format. Both the sampling resolution and the data
+streaming format are bound to that selectable format. In addition to the basic
format ioctls, the &VIDIOC-ENUM-FMT; ioctl
must be supported as well.
@@ -69,7 +80,8 @@ must be supported as well.
To use the format ioctls applications set the
type field of a &v4l2-format; to
-V4L2_BUF_TYPE_SDR_CAPTURE and use the &v4l2-sdr-format;
+V4L2_BUF_TYPE_SDR_CAPTURE or
+V4L2_BUF_TYPE_SDR_OUTPUT and use the &v4l2-sdr-format;
sdr member of the fmt
union as needed per the desired operation.
Currently there is two fields, pixelformat and