FM Receiver Control Reference

document, from CENELEC. > > > +

> + FM Receiver Control Reference > + > + The FM Receiver (FM_RX) class includes controls for common features of > +FM Reception capable devices. Currently this class includes parameter for Alternate > +frequency. Remove the last sentence ("Currently this..."). It serves no purpose and would only need to be updated whenever a control is added. > + > + > + FM_RX Control IDs > + > + > + > + > + > + > + > + > + > + > + ID > + Type > + Description > + > + > + > + > + > + V4L2_CID_FM_RX_CLASS > + class > + The FM_RX class > +descriptor. Calling &VIDIOC-QUERYCTRL; for this control will return a > +description of this control class. > + > + > + V4L2_CID_RDS_AF_SWITCH > + boolean > + > + Enable/Disable's FM RX RDS Alternate frequency feature. When enabled driver will decode the RDS AF field and tries to switch to this AF frequency once current frequency RSSI level goes below threshold. Value of G_FREQUENCY is unchanged since both original frequency and AF frequency share the same PI code. Small improvement: Enable/Disable's -> Enable or Disable the I'd also remove the "FM RX" part: it's already obvious that we are in the FM RX class of controls. "When enabled" -> "When enabled the" "once current" -> once the current" "below threshold" -> "below the threshold" I don't understand what you mean with the last sentence: "Value of G_FREQUENCY...". Shouldn't it be something like: If the frequency is switched, then &VIDIOC-G-FREQUENCY; will return the new frequency." > + > + > + V4L2_CID_TUNE_DEEMPHASIS > + integer > + > + Configures the de-emphasis value for reception. > +A pre-emphasis filter is applied to the broadcast to accentuate the high audio frequencies. > +Depending on the region, a time constant of either 50 or 75 useconds is used. The enum v4l2_preemphasis > +defines possible values for pre-emphasis. Here they are: > + > + > + > + > + V4L2_PREEMPHASIS_DISABLED > + No de-emphasis is applied. > + > + > + V4L2_PREEMPHASIS_50_uS > + A de-emphasis of 50 uS is used. > + > + > + V4L2_PREEMPHASIS_75_uS > + A de-emphasis of 75 uS is used. > + > + > + > + > + > + > + > + > +

> + > +

> Flash Control Reference > > diff --git a/Documentation/DocBook/media/v4l/dev-rds.xml b/Documentation/DocBook/media/v4l/dev-rds.xml > index 38883a4..8188161 100644 > --- a/Documentation/DocBook/media/v4l/dev-rds.xml > +++ b/Documentation/DocBook/media/v4l/dev-rds.xml > @@ -55,8 +55,9 @@ If the driver only passes RDS blocks without interpreting the data > the V4L2_TUNER_CAP_RDS_BLOCK_IO flag has to be set. If the > tuner is capable of handling RDS entities like program identification codes and radio > text, the flag V4L2_TUNER_CAP_RDS_CONTROLS should be set, > -see Writing RDS data and > -FM Transmitter Control Reference. > +see Writing RDS data, > +FM Transmitter Control Reference > +FM Receiver Control Reference. >

> >

> diff --git a/Documentation/DocBook/media/v4l/vidioc-g-ext-ctrls.xml b/Documentation/DocBook/media/v4l/vidioc-g-ext-ctrls.xml > index b17a7aa..2a8b44e 100644 > --- a/Documentation/DocBook/media/v4l/vidioc-g-ext-ctrls.xml > +++ b/Documentation/DocBook/media/v4l/vidioc-g-ext-ctrls.xml > @@ -258,6 +258,13 @@ These controls are described in These controls are described in linkend="fm-tx-controls" />. > > + > + V4L2_CTRL_CLASS_FM_RX > + 0x9c0000 > + The class containing FM Receiver (FM RX) controls. > +These controls are described in + linkend="fm-rx-controls" />. > + > > V4L2_CTRL_CLASS_FLASH > 0x9c0000 > diff --git a/Documentation/DocBook/media/v4l/vidioc-s-hw-freq-seek.xml b/Documentation/DocBook/media/v4l/vidioc-s-hw-freq-seek.xml > index 18b1a82..c244da9 100644 > --- a/Documentation/DocBook/media/v4l/vidioc-s-hw-freq-seek.xml > +++ b/Documentation/DocBook/media/v4l/vidioc-s-hw-freq-seek.xml > @@ -95,7 +95,12 @@ field and the &v4l2-tuner; index field. > > > __u32 > - reserved[7] > + fm_band > + If zero search whole band (from OIRT till Weather if chip supports) else search in a mentioned bands(1=Europe/US, 2=Japan, 3=Russian and 4=Weather band) We need proper defines for these bands in linux/videodev2.h! And it also needs to be properly documented: make a small table as is done for other ioctls as well and include the official frequency ranges for each. I also suggest renaming fm_band by just 'band': it might be used for e.g. AM bands as well in the future (unlikely, but you never know). Regards, Hans > + > + > + __u32 > + reserved[6] > Reserved for future extensions. Applications > must set the array to zero. > > -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/