From sacadmin Mon Jul 21 22:39:34 2008 Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m6M5dYeL017580; Mon, 21 Jul 2008 22:39:34 -0700 (PDT) Received: (from xc149992@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m6M5dYjC017576; Mon, 21 Jul 2008 22:39:34 -0700 (PDT) Date: Mon, 21 Jul 2008 22:39:34 -0700 (PDT) From: Xiang-Dong Frank Che Message-Id: <200807220539.m6M5dYjC017576@sac.sfbay.sun.com> To: PSARC-record@sac.sfbay.sun.com Subject: usbvc(7D) Interface Addition [PSARC/2008/468 Self Review] Status: RO Content-Length: 561 Template Version: @(#)sac_nextcase 1.66 04/17/08 SMI This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: usbvc(7D) Interface Addition 1.2. Name of Document Author/Supplier: Author: Raymond Chen 1.3 Date of This Document: 21 July, 2008 4. Technical Description See the case directory for more detail 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: ON 6.5. ARC review type: Automatic 6.6. ARC Exposure: open From Frank.Che@sun.com Mon Jul 21 23:29:35 2008 Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m6M6TYrq018767 for ; Mon, 21 Jul 2008 23:29:34 -0700 (PDT) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m6M6TUGA001806 for <@sunmail2sca.sfbay.sun.com:PSARC-ext@sun.com>; Tue, 22 Jul 2008 07:29:33 +0100 (BST) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0K4E00601A18XB00@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon, 21 Jul 2008 23:29:32 -0700 (PDT) Received: from sineb-mail-2.sun.com ([192.18.19.7]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0K4E002YXA16VJ20@nwk-avmta-2.sfbay.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Mon, 21 Jul 2008 23:29:32 -0700 (PDT) Received: from fe-apac-06.sun.com (fe-apac-06.sun.com [192.18.19.177] (may be forged)) by sineb-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id m6M6Uei3027913 for ; Tue, 22 Jul 2008 06:30:40 +0000 (GMT) Received: from conversion-daemon.mail-apac.sun.com by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0K4E003019T0TQ00@mail-apac.sun.com> (original mail from Frank.Che@Sun.COM) for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 22 Jul 2008 14:27:04 +0800 (SGT) Received: from [129.158.218.60] by mail-apac.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0K4E00F1H9X4QYKP@mail-apac.sun.com> for PSARC-ext@sun.com (ORCPT PSARC-ext@sun.com); Tue, 22 Jul 2008 14:27:04 +0800 (SGT) Date: Tue, 22 Jul 2008 14:29:24 +0800 From: Frank Che Subject: PSARC 2008/468 usbvc(7D) Interface Addition [Self Review] Sender: Frank.Che@sun.com To: PSARC-ext@sun.com Cc: Raymond.Chen@sun.com Message-id: <48857E44.8050900@sun.com> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT X-PMX-Version: 5.4.1.325704 User-Agent: Thunderbird 2.0.0.4 (X11/20070622) Status: RO Content-Length: 2757 I'm sponsoring this case for Raymond Chen. This case is to add two more exported interfaces to PSARC 2006/484. The requested release binding is patch/micro. I have marked it as "closed approved automatic" since the change is straightforward and the interface is clear. If there is request, I'd be happy to upgrade it to a fast track and set the timer. -Frank Template Version: @(#)sac_nextcase 1.66 04/17/08 SMI This information is Copyright 2008 Sun Microsystems 1. Introduction 1.1. Project/Component Working Name: usbvc(7D) Interface Addition 1.2. Name of Document Author/Supplier: Author: Raymond Chen 1.3 Date of This Document: 22 July, 2008 4. Technical Description Summary: Propose to support IOCTL VIDIOC_G_PARM and VIDIOC_S_PARM in usbvc(7D) Requested release binding is patch/micro Detail: usbvc(7D) provides the support for USB Video Class compliant device. It imported V4L2 specification to interface with popular applications. But it didn't implement all the interfaces that the V4L2 specification defines. The Gnome applications "Cheese", has brought up requirements to have support of other IOCTLs, the VIDIOC_G_PARM and VIDIOC_S_PARM. These two IOCTLs have been included in . In this case, the VIDIOC_G_PARM and VIDIOC_S_PARM are going to be implemented in usbvc(7D). The new IOCTLs will have the same stability level as others in PSARC/2006/484, i.e. Uncommitted. Exported Interfaces: Interface Stability Comments ----------------------------------------------------------------------- VIDIOC_G_PARM Uncommitted Get streaming parameters VIDIOC_S_PARM Uncommitted Set streaming parameters usbvc(7D) manpage changes: @@ -177,7 +177,19 @@ Set the device's current video control. + VIDIOC_G_PARM + Get streaming parameters, the number of frames per second + and number of buffers used internally by driver in + read/write mode. + + VIDIOC_S_PARM + + Set streaming parameters, the number of frames per second + and number of buffers used internally by driver in + read/write mode. + + ERRORS EBUSY An open was attempted after the device has already been opened. 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: ON 6.5. ARC review type: self-review 6.6. ARC Exposure: open References: [1] PSARC/2006/484 USB Video Class Driver