From patchwork Wed Sep 29 12:40:39 2010 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: m7aalton X-Patchwork-Id: 4465 Return-path: Envelope-to: mchehab@pedra Delivery-date: Wed, 29 Sep 2010 09:58:11 -0300 Received: from mchehab by pedra with local (Exim 4.72) (envelope-from ) id 1P0wEc-0001OC-Uu for mchehab@pedra; Wed, 29 Sep 2010 09:58:11 -0300 Received: from bombadil.infradead.org [18.85.46.34] by pedra with IMAP (fetchmail-6.3.17) for (single-drop); Wed, 29 Sep 2010 09:58:10 -0300 (BRT) Received: from vger.kernel.org ([209.132.180.67]) by bombadil.infradead.org with esmtp (Exim 4.72 #1 (Red Hat Linux)) id 1P0vyE-0000AR-Te; Wed, 29 Sep 2010 12:41:15 +0000 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755547Ab0I2MlM (ORCPT + 1 other); Wed, 29 Sep 2010 08:41:12 -0400 Received: from smtp.nokia.com ([192.100.122.233]:36815 "EHLO mgw-mx06.nokia.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751893Ab0I2MlL (ORCPT ); Wed, 29 Sep 2010 08:41:11 -0400 Received: from esebh106.NOE.Nokia.com (esebh106.ntc.nokia.com [172.21.138.213]) by mgw-mx06.nokia.com (Switch-3.3.3/Switch-3.3.3) with ESMTP id o8TCeWxL008044; Wed, 29 Sep 2010 15:40:55 +0300 Received: from vaebh104.NOE.Nokia.com ([10.160.244.30]) by esebh106.NOE.Nokia.com with Microsoft SMTPSVC(6.0.3790.4675); Wed, 29 Sep 2010 15:40:54 +0300 Received: from mgw-da02.ext.nokia.com ([147.243.128.26]) by vaebh104.NOE.Nokia.com over TLS secured channel with Microsoft SMTPSVC(6.0.3790.4675); Wed, 29 Sep 2010 15:40:54 +0300 Received: from localhost.localdomain (masi.nmp.nokia.com [172.22.211.19]) by mgw-da02.ext.nokia.com (Switch-3.3.3/Switch-3.3.3) with ESMTP id o8TCedHO016063; Wed, 29 Sep 2010 15:40:48 +0300 From: "Matti J. Aaltonen" To: linux-media@vger.kernel.org, mchehab@redhat.com, hverkuil@xs4all.nl, eduardo.valentin@nokia.com Cc: "Matti J. Aaltonen" Subject: [PATCH v11 4/4] Documentation: v4l: Add hw_seek spacing and two TUNER_RDS_CAP flags. Date: Wed, 29 Sep 2010 15:40:39 +0300 Message-Id: <1285764039-5767-5-git-send-email-matti.j.aaltonen@nokia.com> X-Mailer: git-send-email 1.6.1.3 In-Reply-To: <1285764039-5767-4-git-send-email-matti.j.aaltonen@nokia.com> References: <1285764039-5767-1-git-send-email-matti.j.aaltonen@nokia.com> <1285764039-5767-2-git-send-email-matti.j.aaltonen@nokia.com> <1285764039-5767-3-git-send-email-matti.j.aaltonen@nokia.com> <1285764039-5767-4-git-send-email-matti.j.aaltonen@nokia.com> X-OriginalArrivalTime: 29 Sep 2010 12:40:54.0412 (UTC) FILETIME=[8E86ACC0:01CB5FD3] X-Nokia-AV: Clean Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Sender: Add a couple of words about the spacing field in the HW seek struct, also a few words about the new RDS tuner capability flags V4L2_TUNER_CAP_RDS_BLOCK-IO and V4L2_TUNER_CAP_RDS_CONTROLS. Signed-off-by: Matti J. Aaltonen --- Documentation/DocBook/v4l/dev-rds.xml | 10 +++++++++- .../DocBook/v4l/vidioc-s-hw-freq-seek.xml | 10 ++++++++-- 2 files changed, 17 insertions(+), 3 deletions(-) diff --git a/Documentation/DocBook/v4l/dev-rds.xml b/Documentation/DocBook/v4l/dev-rds.xml index 0869d70..e7be392 100644 --- a/Documentation/DocBook/v4l/dev-rds.xml +++ b/Documentation/DocBook/v4l/dev-rds.xml @@ -28,6 +28,10 @@ returned by the &VIDIOC-QUERYCAP; ioctl. Any tuner that supports RDS will set the V4L2_TUNER_CAP_RDS flag in the capability field of &v4l2-tuner;. +If the driver only passes RDS blocks without interpreting the data +the V4L2_TUNER_SUB_RDS_BLOCK_IO flag has to be set. If the +tuner is capable of handling RDS entities like program identication codes and radio +text the flag V4L2_TUNER_SUB_RDS_CONTROLS should be set. Whether an RDS signal is present can be detected by looking at the rxsubchans field of &v4l2-tuner;: the V4L2_TUNER_SUB_RDS will be set if RDS data was detected. @@ -40,7 +44,11 @@ Any modulator that supports RDS will set the V4L2_TUNER_CAP_RDS flag in the capability field of &v4l2-modulator;. In order to enable the RDS transmission one must set the V4L2_TUNER_SUB_RDS -bit in the txsubchans field of &v4l2-modulator;. +bit in the txsubchans field of &v4l2-modulator;. +If the driver only passes RDS blocks without interpreting the data +the V4L2_TUNER_SUB_RDS_BLOCK_IO flag has to be set. If the +tuner is capable of handling RDS entities like program identication codes and radio +text the flag V4L2_TUNER_SUB_RDS_CONTROLS should be set. diff --git a/Documentation/DocBook/v4l/vidioc-s-hw-freq-seek.xml b/Documentation/DocBook/v4l/vidioc-s-hw-freq-seek.xml index 14b3ec7..c30dcc4 100644 --- a/Documentation/DocBook/v4l/vidioc-s-hw-freq-seek.xml +++ b/Documentation/DocBook/v4l/vidioc-s-hw-freq-seek.xml @@ -51,7 +51,8 @@ Start a hardware frequency seek from the current frequency. To do this applications initialize the tuner, -type, seek_upward and +type, seek_upward, +spacing and wrap_around fields, and zero out the reserved array of a &v4l2-hw-freq-seek; and call the VIDIOC_S_HW_FREQ_SEEK ioctl with a pointer @@ -89,7 +90,12 @@ field and the &v4l2-tuner; index field. __u32 - reserved[8] + spacing + If non-zero, defines the hardware seek resolution in Hz. The driver selects the nearest value that is supported by the device. If spacing is zero a reasonable default value is used. + + + __u32 + reserved[7] Reserved for future extensions. Drivers and applications must set the array to zero.