From patchwork Fri May 29 07:33:24 2009 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eduardo Valentin X-Patchwork-Id: 26873 X-Patchwork-Delegate: dougsland@redhat.com 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 n4T7d9Wu013191 for ; Fri, 29 May 2009 07:39:10 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754273AbZE2HiR (ORCPT ); Fri, 29 May 2009 03:38:17 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1754383AbZE2HiR (ORCPT ); Fri, 29 May 2009 03:38:17 -0400 Received: from smtp.nokia.com ([192.100.122.230]:18674 "EHLO mgw-mx03.nokia.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754273AbZE2HiP (ORCPT ); Fri, 29 May 2009 03:38:15 -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 n4T7bdx7032178; Fri, 29 May 2009 10:37:44 +0300 Received: from vaebh104.NOE.Nokia.com ([10.160.244.30]) by vaebh105.NOE.Nokia.com with Microsoft SMTPSVC(6.0.3790.3959); Fri, 29 May 2009 10:37:46 +0300 Received: from vaebe101.NOE.Nokia.com ([10.160.244.11]) by vaebh104.NOE.Nokia.com with Microsoft SMTPSVC(6.0.3790.3959); Fri, 29 May 2009 10:37:44 +0300 Received: from localhost.localdomain ([172.21.41.99]) by vaebe101.NOE.Nokia.com with Microsoft SMTPSVC(6.0.3790.3959); Fri, 29 May 2009 10:37:43 +0300 From: Eduardo Valentin To: "\\\"ext Hans Verkuil\\\"" , "\\\"ext Mauro Carvalho Chehab\\\"" Cc: "\\\"Nurkkala Eero.An (EXT-Offcode/Oulu)\\\"" , "\\\"ext Douglas Schilling Landgraf\\\"" , Linux-Media , Eduardo Valentin Subject: [PATCHv5 4 of 8] Add documentation description for FM Transmitter Extended Control Class Date: Fri, 29 May 2009 10:33:24 +0300 Message-Id: <1243582408-13084-5-git-send-email-eduardo.valentin@nokia.com> X-Mailer: git-send-email 1.6.2.GIT In-Reply-To: <1243582408-13084-4-git-send-email-eduardo.valentin@nokia.com> References: <1243582408-13084-1-git-send-email-eduardo.valentin@nokia.com> <1243582408-13084-2-git-send-email-eduardo.valentin@nokia.com> <1243582408-13084-3-git-send-email-eduardo.valentin@nokia.com> <1243582408-13084-4-git-send-email-eduardo.valentin@nokia.com> X-OriginalArrivalTime: 29 May 2009 07:37:43.0844 (UTC) FILETIME=[5A844640:01C9E030] X-Nokia-AV: Clean Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org # HG changeset patch # User Eduardo Valentin # Date 1242209424 -10800 # Branch export # Node ID 2dd45d3736ae1952dfa98e65b072eb08157fb19d # Parent fadf1cddf504609cdb4889f4aa3305ca8d15323a From: Eduardo Valentin 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 fadf1cddf504 -r 2dd45d3736ae v4l2-spec/controls.sgml --- a/v4l2-spec/controls.sgml Wed May 27 11:56:47 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 + + iSets 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. + + + + +
+