From patchwork Sun Jun 12 11:59:59 2011 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 872922 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by demeter2.kernel.org (8.14.4/8.14.4) with ESMTP id p5CC09G3017883 for ; Sun, 12 Jun 2011 12:00:10 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753241Ab1FLMAG (ORCPT ); Sun, 12 Jun 2011 08:00:06 -0400 Received: from mx1.redhat.com ([209.132.183.28]:62101 "EHLO mx1.redhat.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753220Ab1FLMAF (ORCPT ); Sun, 12 Jun 2011 08:00:05 -0400 Received: from int-mx12.intmail.prod.int.phx2.redhat.com (int-mx12.intmail.prod.int.phx2.redhat.com [10.5.11.25]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id p5CC02rK005548 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 12 Jun 2011 08:00:03 -0400 Received: from [10.11.11.26] (vpn-11-26.rdu.redhat.com [10.11.11.26]) by int-mx12.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id p5CC00lc017018; Sun, 12 Jun 2011 08:00:01 -0400 Message-ID: <4DF4AA3F.5040005@redhat.com> Date: Sun, 12 Jun 2011 08:59:59 -0300 From: Mauro Carvalho Chehab User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.2.17) Gecko/20110419 Red Hat/3.1.10-1.el6_0 Thunderbird/3.1.10 MIME-Version: 1.0 To: Hans Verkuil CC: Linux Media Mailing List , Andy Walls Subject: Re: [RFCv1 PATCH 7/7] tuner-core: s_tuner should not change tuner mode. References: <1307799283-15518-1-git-send-email-hverkuil@xs4all.nl> <201106111927.15981.hverkuil@xs4all.nl> <4DF3BC59.3000404@redhat.com> <201106121336.18395.hverkuil@xs4all.nl> In-Reply-To: <201106121336.18395.hverkuil@xs4all.nl> X-Scanned-By: MIMEDefang 2.68 on 10.5.11.25 Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-Greylist: IP, sender and recipient auto-whitelisted, not delayed by milter-greylist-4.2.6 (demeter2.kernel.org [140.211.167.43]); Sun, 12 Jun 2011 12:00:10 +0000 (UTC) Em 12-06-2011 08:36, Hans Verkuil escreveu: > On Saturday, June 11, 2011 21:04:57 Mauro Carvalho Chehab wrote: >> Em 11-06-2011 14:27, Hans Verkuil escreveu: >>> On Saturday, June 11, 2011 15:54:59 Mauro Carvalho Chehab wrote: >>>> Em 11-06-2011 10:34, Hans Verkuil escreveu: >>>>> From: Hans Verkuil >>>>> >>>>> According to the spec the tuner type field is not used when calling >>>>> S_TUNER: index, audmode and reserved are the only writable fields. >>>>> >>>>> So remove the type check. Instead, just set the audmode if the current >>>>> tuner mode is set to radio. >>>> >>>> I suspect that this patch also breaks support for a separate radio tuner. >>>> if tuner-type is not properly filled, then the easiest fix would be to >>>> revert some changes done at the tuner cleanup/fixup patches applied on .39. >>>> Yet, the previous logic were trying to hint the device mode, with is bad >>>> (that's why it was changed). >>>> >>>> The proper change seems to add a parameter to this callback, set by the >>>> bridge driver, informing if the device is using radio or video mode. >>>> We need also to patch the V4L API specs, as it allows using a video node >>>> for radio, and vice versa. This is not well supported, and it seems silly >>>> to keep it at the specs and needing to add hints at the drivers due to >>>> that. >>> >>> So, just to make sure I understand correctly what you want. The bridge or >>> platform drivers will fill in the vf->type (for g/s_frequency) or vt->type >>> (for g/s_tuner) based on the device node: RADIO if /dev/radio is used, >>> TV for anything else. >> >> Yes. I remember I've reviewed the bridge drivers when I rewrote the tuner code. >> Of course, I might have left something else. Btw, the older code were also >> requiring it. >> >> The cx18 implementation were merged after the changes, so maybe it is not doing >> the right thing. > > Actually, G_TUNER was wrong for bttv, ivtv, cx18 and pvrusb2. So it wasn't > just some random driver that failed to set vf/vt->type. G_FREQUENCY were broken just on cx18. As I said before, filling the type were always required. Anyway, I've added a proper documentation for it. See the patch bellow. The same patch should be done also for G_TUNER. >>> What about VIDIOC_S_FREQUENCY? The spec says that the app needs to fill this >>> in. Will we just overwrite vf->type or will we check and return -EINVAL if >>> the app tries to set e.g. a TV frequency on /dev/radio? >> >> That's a very good question. What happens is that the V4L2 API used to allow >> opening a /dev/radio device for TV (or even for VBI). IMHO, this were a trouble >> at the API specs. I think that this were changed on newer versions of the spec. > > If you want, then I can add an extra patch to my v4 patch series that returns > -EINVAL in video_ioctl2 if S_FREQUENCY is called with an inconsistent tuner type. > (inconsistent with the device node's type, that is). The reason why check_mode returns -EINVAL is that this error code may need to be returned to the caller. You should note, however, that the bridge code may need to be fixed if you return the check_mode error code, as otherwise the error will simply be discarded or it it will break devices with two tuners. For example, currently, bttv driver uses v4l2_device_call_all() for it. So, any errors returned by it will be simply discarded. If some bridge driver is using v4l2_device_call_until_err(), it will stop on the first tuner that gets an error. The solution is to implement a v4l2_device_call_until_not_err() and use it for the tuner commands. >>> Is VIDIOC_S_FREQUENCY allowed to change the tuner mode? E.g. if /dev/radio was >>> opened, and now I open /dev/video and call S_FREQUENCY with the TV tuner type, >>> should that change the tuner to tv mode? >> >> Yes. I think that some applications like kradio just keeps the device node opened. >> If we return -EBUSY, those applications will break. The reverse is more tricky: >> e. g. if /dev/video is streaming, I think that the bridge driver should return >> -EBUSY if the device can't do both TV and radio at the same time, but this is >> something that it is device-specific, so such logic, if needed, should be implemented >> at the bridge driver. > > Agreed. > >>> I think the type passed to S_FREQUENCY should 1) match the device node's type >>> (if not, then return -EINVAL) and 2) should match the current mode (if not, >>> then return -EBUSY). So attempts to change the TV frequency when in radio >>> mode should fail. This second rule should also be valid for S_TUNER. >> >> See above. >> >>> What should G_TUNER return on a video node when in radio mode or vice versa? >>> For G_FREQUENCY you can still return the last used frequency, but that's >>> much more ambiguous for G_TUNER. One option is to set rxsubchans, signal and >>> afc all to 0 if you query G_TUNER when 'in the wrong mode'. >> >> The current logic should handle this case well. I tested it carefully. Basically, >> if the device is on Radio mode, and has a separate tuner for TV, the TV tuner >> should not touch the structure. The Radio tuner should properly fill the values. > > I analyzed it again and you are correct. > >> Calls to G_TUNER/G_FREQUENCY shouldn't switch the device mode, or they may break >> applications like kradio, that may be always there during the entire KDE section. > > Obviously. > >>> The VIDIOC_G/S_MODULATOR ioctls do not have a type and they are RADIO only, >>> so that's OK. >>> >>> And how do we switch between radio and TV? Right now opening the radio node >>> will set the tuner in radio mode, and calling S_STD will change the mode to >>> TV again. As mentioned above, what S_FREQUENCY is supposed to do is undefined >>> at the moment. >> >> If S_FREQUENCY is called from /dev/video (or /dev/vbi), it should set it to TV. If >> it is called from /dev/radio, it should put the device on radio mode. >> >> The current logic already does that. I tested it on several devices, with both >> tea5767 and without it. >> >>> What about this: >>> >>> Opening /dev/radio effectively starts the radio mode. So if there is TV >>> capture in progress, then the open should return -EBUSY. Otherwise it >>> switches the tuner to radio mode. And it stays in radio mode until the >>> last filehandle of /dev/radio is closed. At that point it will automatically >>> switch back to TV mode (if there is one, of course). >> >> No. This would break existing applications. The mode switch should be done >> at S_FREQUENCY (e. g. when the radio application is tuning into a channel). > > This is not what happens today as the switch to radio occurs as soon as you open > the radio node. It's the reason for the s_radio op. The s_radio op is something that I wanted to remove. It was there in the past to feed the TV/radio hint logic. I wrote a patch for it, but I ended by discarding from my final queue (I can't remember why). I think that the hint logic were completely removed, but we may need to take a look on the callers for s_radio. I'll check it right now. > The V4L2 specification is silent on this topic, unfortunately. And I'm not sure > how applications handle this. > > I think only changing the mode when calling S_FREQUENCY (and S_STD) is a good > thing since this automatic mode switch when just opening a node goes against > the V4L2 philosophy. Just opening a node shouldn't change the state of the > device. Agreed. >>> While it is in radio mode calls to S_STD and S_FREQUENCY from /dev/video >>> will return -EBUSY. Any attempt to start streaming from /dev/video will >>> also return -EBUSY (radio 'streaming' is in progress after all). >> >> For the same reason as said above, this will cause troubles for existing >> appications. >> >> >>> Effectively, S_STD no longer switches back to TV mode. That only happens when >>> the last user of /dev/radio left. It certainly sounds a lot saner to me. >> >> Opening a /dev/radio device doesn't mean that radio is "streaming". A radio >> is streaming if: >> - tuner was set with S_FREQUENCY >> - device is not muted. >> >> Btw, the console application "radio" allows you to, open a device, set a frequency, >> unmute the device and close the radio device: >> radio -qf 91.4 >> >> So, even having the device node closed doesn't mean that the radio is not being >> used. > > Yeah, that's right. It slipped my mind when I wrote that. > > Regards, > > Hans commit a307ec69602894c917485f331f8d1fef31c411b8 Author: Mauro Carvalho Chehab Date: Sun Jun 12 08:36:34 2011 -0300 [media] tuner: fix g_frequency subdev call and properly document it The tuner type needs to be initialized before calling g_frequency. cx18 doesn't do it. Fix the logic and properly document the function. While here, remove a duplicated line at cx88. Signed-off-by: Mauro Carvalho Chehab --- 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 --git a/drivers/media/video/cx18/cx18-ioctl.c b/drivers/media/video/cx18/cx18-ioctl.c index 1933d4d..5463548 100644 --- a/drivers/media/video/cx18/cx18-ioctl.c +++ b/drivers/media/video/cx18/cx18-ioctl.c @@ -611,6 +611,11 @@ static int cx18_g_frequency(struct file *file, void *fh, if (vf->tuner != 0) return -EINVAL; + if (test_bit(CX18_F_I_RADIO_USER, &cx->i_flags)) + vf->type = V4L2_TUNER_RADIO; + else + vf->type = V4L2_TUNER_ANALOG_TV; + cx18_call_all(cx, tuner, g_frequency, vf); return 0; } diff --git a/drivers/media/video/cx88/cx88-video.c b/drivers/media/video/cx88/cx88-video.c index cef4f28..13636f7 100644 --- a/drivers/media/video/cx88/cx88-video.c +++ b/drivers/media/video/cx88/cx88-video.c @@ -1394,7 +1394,6 @@ static int vidioc_g_frequency (struct file *file, void *priv, if (unlikely(UNSET == core->board.tuner_type)) return -EINVAL; - /* f->type = fh->radio ? V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV; */ f->type = fh->radio ? V4L2_TUNER_RADIO : V4L2_TUNER_ANALOG_TV; f->frequency = core->freq; diff --git a/drivers/media/video/tuner-core.c b/drivers/media/video/tuner-core.c index 5748d04..34cd9b0 100644 --- a/drivers/media/video/tuner-core.c +++ b/drivers/media/video/tuner-core.c @@ -1133,6 +1133,17 @@ static int tuner_s_frequency(struct v4l2_subdev *sd, struct v4l2_frequency *f) return 0; } +/** + * tuner_g_frequency - Gets the tuned frequency for the tuner + * @sd: pointer to struct v4l2_subdev + * @f: opinter to struct v4l2_frequency + * + * At return, the structure f will be filled with tuner frequency, + * if the tuner matches the f->type. + * Note: f->type should be initialized before calling it. + * as userspace won't initialize f->type, it is up to the bridge driver + * to set it to either V4L2_TUNER_RADIO or V4L2_TUNER_ANALOG_TV. + */ static int tuner_g_frequency(struct v4l2_subdev *sd, struct v4l2_frequency *f) { struct tuner *t = to_tuner(sd);