w9967cf.sgml

华邦的W996[78]cf芯片组的摄象头驱动程序

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[]>

<book id="V4LGuide">
 <bookinfo>
  <title>Winbond 996[78]cf Linux Driver</title>
  
  <authorgroup>
   <author>
    <firstname></firstname>
    <surname></surname>
    <affiliation>
     <address>
      <email></email>
     </address>
    </affiliation>
   </author>
  </authorgroup>

  <copyright>
   <year></year>
   <holder></holder>
  </copyright>

  <legalnotice>
   <para>
     This documentation is free software; you can redistribute
     it and/or modify it under the terms of the GNU General Public
     License as published by the Free Software Foundation; either
     version 2 of the License, or (at your option) any later
     version.
   </para>
      
   <para>
     This program is distributed in the hope that it will be
     useful, but WITHOUT ANY WARRANTY; without even the implied
     warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
     See the GNU General Public License for more details.
   </para>
      
   <para>
     You should have received a copy of the GNU General Public
     License along with this program; if not, write to the Free
     Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
     MA 02111-1307 USA
   </para>
      
   <para>
     For more details see the file COPYING in the source
     distribution of Linux.
   </para>
  </legalnotice>
 </bookinfo>

<toc></toc>

  <chapter id="intro">
      <title>Introduction</title>
  <para>
      This is aimed to be the Linux driver for cams based on the
      Winbond w9967cf and/or w9968cf. Those chips are used in the
      Creative WebCam Go (and Go Plus) webcam.    
  </para>
  <para>
      The driver is in a earlier development phase. For the end-user
      there is nothing useful. There is a lot of work to do to make
      the driver work.
  </para>
  </chapter>

  <chapter id="structure">
    <title>Driver structure</title>
    <para>
      First, the driver register itself within the USB subsystem via the
      w9967cf_probe. This function is called only if the product is listed
      in the array of know vid:pid named device_table
    </para>
    <programlisting>    
static __devinitdata struct usb_device_id device_table [] = {
	{ idVendor: 0x041e, idProduct: 0x4003 }, /* WebCam GO Plus */
	{ idVendor: 0x1046, idProduct: 0x9967 }, /* W9967cf/W9968cf based cam */
	{ }  /* Terminating entry */
};
    </programlisting>
    <para>
      The w9967cf_probe fills some basic camera parameters in the structure
      w9967cfcam, the alternate interface 1 (1023 Mb/s) (provvisiory?), then
      try to register the driver with video4linux as a VIDEO_CAPTURE
      interface. (The v4l calls w9967cf_init_done) If the registration is
      ok, the probe function return 0 and exit.
    </para>
  </chapter>

</book>