README

   1 Microdia USB 2.0 Webcam Driver
   2 ==============================
   3
   4 This Driver is essentially a fork of the Syntek Webcam drivers for Linux
   5 by Nicolas Vivien, specifically to accomodate SN9C20x chipset based Webcams.
   6
   7 The driver currently supports the latest version of Video For Linux i.e
   8 V4L2. V4L1 is deprecated, and applications like Camorama that use only V4L1 will
   9 no longer work.
  10
  11 This driver currently supports Skype v2.x, Ekiga v2.x & even aMSN
  12
  13 Warning :
  14 The Microdia USB 2.0 Webcam Driver for SN9C20x chipset based Webcams is
  15 currently under development. Using this driver can result in damage.
  16 Use this driver only if you know what you are doing.
  17 --------------------------------------------------------------------------------
  18
  19 Table of contents :
  20
  21 1. Requirements
  22  1.1 Kernel module
  23  1.2 Documentation
  24
  25 2. Available Packages
  26
  27 3. Compilation
  28  3.1 Kernel module
  29  3.2 Documentation
  30
  31 4. Testing
  32
  33 5. Installation
  34
  35 6. Usage
  36
  37 7. Status of project
  38
  39 8. Documentation & References
  40
  41 9. Contact
  42
  43 10. Licence
  44
  45 11. Disclaimer
  46
  47 --------------------------------------------------------------------------------
  48
  49 1. Requirements
  50
  51  1.1 Kernel module
  52
  53    To compile the driver you need :
  54      Kernel 2.6.18 or higher
  55      Kernel headers
  56      make
  57      gcc
  58
  59  1.2 Documentation
  60
  61    To compile the documentation you need :
  62      doxygen
  63      graphviz
  64
  65 --------------------------------------------------------------------------------
  66
  67 2. Available Packages
  68
  69   There are packages for various distributions available here:
  70     http://repo.or.cz/w/pkgmicrodia.git
  71
  72 --------------------------------------------------------------------------------
  73
  74 3. Compilation
  75
  76  3.1 Kernel module
  77
  78    To build the kernel module ("driver") :
  79      $ make
  80      (This will create the kernel object file called "microdia.ko".)
  81
  82  3.2 Documentation
  83
  84    To build the documentation :
  85      $ make doc
  86      $ make cleandoc
  87
  88 --------------------------------------------------------------------------------
  89
  90 4. Testing
  91
  92   To load the driver, follow these steps (as root) :
  93     # modprobe videodev
  94     # modprobe compat-ioctl32  // Only required for 64-bit Linux OS
  95     # make insmod
  96
  97   To test the driver with a V4L2 compliant application, try mplayer :
  98     $ mplayer tv:// -tv driver=v4l2:width=640:height=480:fps=25:device=/dev/video0 -vo x11
  99     $ mplayer tv:// -tv driver=v4l2:width=640:height=480:fps=25:device=/dev/video0 -vo xv
 100
 101 --------------------------------------------------------------------------------
 102
 103 5. Install
 104
 105   $ strip -g microdia.ko
 106   And as root :
 107   # cp microdia.ko /lib/modules/`uname -r`/kernel/drivers/media/video/usbvideo/
 108   # depmod -a
 109
 110 --------------------------------------------------------------------------------
 111
 112 6. Usage
 113
 114   We recommend to use v4l2ucp to improve image quality.
 115     http://sourceforge.net/projects/v4l2ucp/
 116
 117   We also develop our own gui, available here:
 118     http://repo.or.cz/r/guimicrodia.git
 119
 120 --------------------------------------------------------------------------------
 121
 122 7. Status
 123
 124   The kernel module is currently under active development.
 125
 126   Currently the driver supports following webcam models :
 127     0c45:6242
 128     0c45:624e
 129     0c45:624f
 130     0c45:6253
 131     0c45:6260
 132     0c45:6270
 133     0c45:627b
 134     0c45:627f
 135     0c45:6288
 136   The full list can be found here :
 137     http://groups.google.com/group/microdia/web/project-status
 138
 139 --------------------------------------------------------------------------------
 140
 141 8. Contact
 142
 143   To request support, please contact us on Microdia Mailing List :
 144     https://groups.google.com/group/microdia/
 145     microdia@googlegroups.com
 146
 147 --------------------------------------------------------------------------------
 148
 149 9. More Documentation & References
 150
 151   All documentation and references for microdia webcam driver can be found at
 152     http://groups.google.com/group/microdia/web
 153
 154   Latest version of this driver is usually available at the following location
 155     http://repo.or.cz/w/microdia.git
 156
 157 --------------------------------------------------------------------------------
 158
 159 10. Licence
 160
 161   Microdia USB 2.0 Webcam Driver is distributed under the GPL licence version 2
 162   or later (GPLv2+).
 163
 164 --------------------------------------------------------------------------------
 165
 166 11. Disclaimer
 167
 168   The Microdia Linux driver has no connection to "MICRODIA Ltd.". They are not
 169   responsible for anything we do or our driver does and we are not responsible
 170   for their actions or their hardware.