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. + + + 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 or Disable the RDS Alternate frequency feature. When enabled the driver will decode the RDS AF field and tries to switch to this AF frequency once the current frequency RSSI (Received signal strength indication) level goes below the threshold. 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 . + + V4L2_CTRL_CLASS_FM_RX + 0x9c0000 + The class containing FM Receiver (FM RX) controls. +These controls are described in . + V4L2_CTRL_CLASS_FLASH 0x9c0000 diff --git a/Documentation/DocBook/media/v4l/vidioc-g-tuner.xml b/Documentation/DocBook/media/v4l/vidioc-g-tuner.xml index 91ec2fb..edad182 100644 --- a/Documentation/DocBook/media/v4l/vidioc-g-tuner.xml +++ b/Documentation/DocBook/media/v4l/vidioc-g-tuner.xml @@ -328,6 +328,31 @@ radio tuners. 0x0200 The RDS data is parsed by the hardware and set via controls. + + V4L2_TUNER_CAP_BAND_TYPE_DEFAULT + 0x010000 + This is the default band, which should be the widest frequency range supported by the hardware. + + + V4L2_TUNER_CAP_BAND_TYPE_EUROPE_US + 0x020000 + Europe or US band (87.5 Mhz - 108 MHz). + + + V4L2_TUNER_CAP_BAND_TYPE_JAPAN + 0x030000 + Japan band (76 MHz - 90 MHz). + + + V4L2_TUNER_CAP_BAND_TYPE_RUSSIAN + 0x040000 + OIRT or Russian band (65.8 MHz - 74 MHz). + + + V4L2_TUNER_CAP_BAND_TYPE_WEATHER + 0x050000 + Weather band (162.4 MHz - 162.55 MHz). + 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..b86c1db 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] + band + Configure the FM chip to a specific band before starting seek operation. Please refer to table 'Radio Band Types'. + + + __u32 + reserved[6] Reserved for future extensions. Applications must set the array to zero. @@ -103,6 +108,35 @@ field and the &v4l2-tuner; index field. + + Radio Band Types + + &cs-str; + + + V4L2_FM_BAND_DEFAULT + This is the default band, which should be the widest frequency range supported by + the hardware. + + + V4L2_FM_BAND_EUROPE_US + Europe or US band (87.5 Mhz - 108 MHz). + + + V4L2_FM_BAND_JAPAN + Japan band (76 MHz - 90 MHz). + + + V4L2_FM_BAND_RUSSIAN + OIRT or Russian band (65.8 MHz - 74 MHz). + + + V4L2_FM_BAND_WEATHER + Weather band (162.4 MHz - 162.55 MHz). + + + +

&return-value; @@ -112,7 +146,7 @@ field and the &v4l2-tuner; index field. EINVAL The tuner index is out of -bounds, the wrap_around value is not supported or the value in the type field is +bounds, the band is not supported, the wrap_around value is not supported or the value in the type field is wrong. -- 1.7.4.1 -- 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/