From patchwork Mon Jun 8 08:18:03 2009 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eduardo Valentin X-Patchwork-Id: 28587 Received: from vger.kernel.org (vger.kernel.org [209.132.176.167]) by demeter.kernel.org (8.14.2/8.14.2) with ESMTP id n588MltU001350 for ; Mon, 8 Jun 2009 08:22:58 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751532AbZFHIWy (ORCPT ); Mon, 8 Jun 2009 04:22:54 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1751593AbZFHIWy (ORCPT ); Mon, 8 Jun 2009 04:22:54 -0400 Received: from smtp.nokia.com ([192.100.122.230]:53351 "EHLO mgw-mx03.nokia.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751532AbZFHIWx (ORCPT ); Mon, 8 Jun 2009 04:22:53 -0400 Received: from vaebh105.NOE.Nokia.com (vaebh105.europe.nokia.com [10.160.244.31]) by mgw-mx03.nokia.com (Switch-3.2.6/Switch-3.2.6) with ESMTP id n588MIZZ025677; Mon, 8 Jun 2009 11:22:29 +0300 Received: from esebh102.NOE.Nokia.com ([172.21.138.183]) by vaebh105.NOE.Nokia.com with Microsoft SMTPSVC(6.0.3790.3959); Mon, 8 Jun 2009 11:22:20 +0300 Received: from vaebe101.NOE.Nokia.com ([10.160.244.11]) by esebh102.NOE.Nokia.com with Microsoft SMTPSVC(6.0.3790.3959); Mon, 8 Jun 2009 11:22:20 +0300 Received: from localhost.localdomain ([172.21.41.99]) by vaebe101.NOE.Nokia.com with Microsoft SMTPSVC(6.0.3790.3959); Mon, 8 Jun 2009 11:22:20 +0300 From: Eduardo Valentin To: "ext Hans Verkuil" , "ext Mauro Carvalho Chehab" Cc: "ext Douglas Schilling Landgraf" , Linux-Media , "Nurkkala Eero.An (EXT-Offcode/Oulu)" , Eduardo Valentin Subject: [PATCHv6 3 of 7] Add documentation description for FM Transmitter Extended Control Class Date: Mon, 8 Jun 2009 11:18:03 +0300 Message-Id: <1244449087-5543-4-git-send-email-eduardo.valentin@nokia.com> X-Mailer: git-send-email 1.6.2.GIT In-Reply-To: <1244449087-5543-3-git-send-email-eduardo.valentin@nokia.com> References: <1244449087-5543-1-git-send-email-eduardo.valentin@nokia.com> <1244449087-5543-2-git-send-email-eduardo.valentin@nokia.com> <1244449087-5543-3-git-send-email-eduardo.valentin@nokia.com> X-OriginalArrivalTime: 08 Jun 2009 08:22:20.0169 (UTC) FILETIME=[3DDC8F90:01C9E812] X-Nokia-AV: Clean Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org From: Eduardo Valentin # HG changeset patch # User Eduardo Valentin # Date 1242209424 -10800 # Node ID ccae4c3150d272235cc2b19af8e9adb2e8b2e5f5 # Parent 6220548f4843ce4d19868dfcf5316d6b58a77824 This single patch adds documentation description for FM Transmitter (FMTX) Extended Control Class and its Control IDs. The text was added under "Extended Controls" section. Priority: normal Signed-off-by: Eduardo Valentin --- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html diff -r 6220548f4843 -r ccae4c3150d2 v4l2-spec/controls.sgml --- a/v4l2-spec/controls.sgml Wed May 27 11:56:46 2009 +0300 +++ b/v4l2-spec/controls.sgml Wed May 13 13:10:24 2009 +0300 @@ -458,6 +458,12 @@ Unfortunately, the original control API lacked some features needed for these new uses and so it was extended into the (not terribly originally named) extended control API. + + Even though the MPEG encoding API was the first effort +to use the Extended Control API, nowadays there are also other classes +of Extended Controls, such as Camera Controls and FM Transmitter Controls. +The Extended Controls API as well as all Extended Controls classes are +described in the following text.
@@ -1816,6 +1822,200 @@
+ +
+ FM Transmitter Control Reference + + The FM Transmitter (FMTX) class includes controls for common features of +FM transmissions capable devices. Currently this class include parameters for audio +compression, pilot tone generation, audio deviation limiter, RDS transmission and +tuning power features. + + + FMTX Control IDs + + + + + + + + + + + ID + Type + Description + + + + + + V4L2_CID_FMTX_CLASS  + class + The FMTX class +descriptor. Calling &VIDIOC-QUERYCTRL; for this control will return a +description of this control class. + + + V4L2_CID_RDS_ENABLED  + boolean + + Enables or disables the RDS transmission feature. + + + V4L2_CID_RDS_PI  + integer + + Sets the RDS Programme Identification field +for transmission. + + + V4L2_CID_RDS_PTY  + integer + + Sets the RDS Programme Type field for transmission. +This coding of up to 31 pre-defined programme types. + + + + V4L2_CID_AUDIO_LIMITER_ENABLED  + boolean + + Enables or disables the audio deviation limiter feature. +The limiter is useful when trying to maximize the audio volume, minimize receiver-generated +distortion and prevent overmodulation. + + + + V4L2_CID_AUDIO_LIMITER_RELEASE_TIME  + integer + + Sets the audio deviation limiter feature release time. +The unit, step and range are driver-specific. + + + V4L2_CID_AUDIO_LIMITER_DEVIATION  + integer + + Configures audio frequency deviation level in Hz. +The range and step are driver-specific. + + + V4L2_CID_AUDIO_COMPRESSION_ENABLED  + boolean + + Enables or disables the audio compression feature. +This feature amplifies signals below the threshold by a fixed gain and compresses audio +signals above the threshold by the ratio of Threshold/(Gain + Threshold). + + + V4L2_CID_AUDIO_COMPRESSION_GAIN  + integer + + Sets the gain for audio compression feature. It is +a dB value. The range and step are driver-specific. + + + V4L2_CID_AUDIO_COMPRESSION_THRESHOLD  + integer + + Sets the threshold level for audio compression freature. +It is a dB value. The range and step are driver-specific. + + + V4L2_CID_AUDIO_COMPRESSION_ATTACK_TIME  + integer + + Sets the attack time for audio compression feature. +It is a useconds value. The range and step are driver-specific. + + + V4L2_CID_AUDIO_COMPRESSION_RELEASE_TIME  + integer + + Sets the release time for audio compression feature. +It is a useconds value. The range and step are driver-specific. + + + V4L2_CID_PILOT_TONE_ENABLED  + boolean + + Enables or disables the pilot tone generation feature. + + + V4L2_CID_PILOT_TONE_DEVIATION  + integer + + Configures pilot tone frequency deviation level. Unit is +in Hz. The range and step are driver-specific. + + + V4L2_CID_PILOT_TONE_FREQUENCY  + integer + + Configures pilot tone frequency value. Unit is +in Hz. The range and step are driver-specific. + + + V4L2_CID_PREEMPHASIS  + integer + + Configures the pre-emphasis value for broadcasting. +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. Possible values +are: + + + + + V4L2_FMTX_PREEMPHASIS_DISABLED  + No pre-emphasis is applied. + + + V4L2_FMTX_PREEMPHASIS_50_uS  + A pre-emphasis of 50 uS is used. + + + V4L2_FMTX_PREEMPHASIS_75_uS  + A pre-emphasis of 75 uS is used. + + + + + + + V4L2_CID_TUNE_POWER_LEVEL  + integer + + Sets the output power level for signal transmission. +Unit is in dBuV. Range and step are driver-specific. + + + V4L2_CID_TUNE_ANTENNA_CAPACITOR  + integer + + This selects the value of antenna tuning capacitor +manually or automatically if set to zero. Unit, range and step are driver-specific. + + + + +
+