diff options
Diffstat (limited to 'Documentation/video4linux/zc0301.txt')
| -rw-r--r-- | Documentation/video4linux/zc0301.txt | 80 |
1 files changed, 48 insertions, 32 deletions
diff --git a/Documentation/video4linux/zc0301.txt b/Documentation/video4linux/zc0301.txt index f55262c6733b..f406f5e80046 100644 --- a/Documentation/video4linux/zc0301.txt +++ b/Documentation/video4linux/zc0301.txt | |||
| @@ -1,9 +1,9 @@ | |||
| 1 | 1 | ||
| 2 | ZC0301 Image Processor and Control Chip | 2 | ZC0301 and ZC0301P Image Processor and Control Chip |
| 3 | Driver for Linux | 3 | Driver for Linux |
| 4 | ======================================= | 4 | =================================================== |
| 5 | 5 | ||
| 6 | - Documentation - | 6 | - Documentation - |
| 7 | 7 | ||
| 8 | 8 | ||
| 9 | Index | 9 | Index |
| @@ -51,13 +51,13 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. | |||
| 51 | 51 | ||
| 52 | 4. Overview and features | 52 | 4. Overview and features |
| 53 | ======================== | 53 | ======================== |
| 54 | This driver supports the video interface of the devices mounting the ZC0301 | 54 | This driver supports the video interface of the devices mounting the ZC0301 or |
| 55 | Image Processor and Control Chip. | 55 | ZC0301P Image Processors and Control Chips. |
| 56 | 56 | ||
| 57 | The driver relies on the Video4Linux2 and USB core modules. It has been | 57 | The driver relies on the Video4Linux2 and USB core modules. It has been |
| 58 | designed to run properly on SMP systems as well. | 58 | designed to run properly on SMP systems as well. |
| 59 | 59 | ||
| 60 | The latest version of the ZC0301 driver can be found at the following URL: | 60 | The latest version of the ZC0301[P] driver can be found at the following URL: |
| 61 | http://www.linux-projects.org/ | 61 | http://www.linux-projects.org/ |
| 62 | 62 | ||
| 63 | Some of the features of the driver are: | 63 | Some of the features of the driver are: |
| @@ -117,7 +117,7 @@ supported by the USB Audio driver thanks to the ALSA API: | |||
| 117 | 117 | ||
| 118 | And finally: | 118 | And finally: |
| 119 | 119 | ||
| 120 | # USB Multimedia devices | 120 | # V4L USB devices |
| 121 | # | 121 | # |
| 122 | CONFIG_USB_ZC0301=m | 122 | CONFIG_USB_ZC0301=m |
| 123 | 123 | ||
| @@ -146,46 +146,46 @@ Name: video_nr | |||
| 146 | Type: short array (min = 0, max = 64) | 146 | Type: short array (min = 0, max = 64) |
| 147 | Syntax: <-1|n[,...]> | 147 | Syntax: <-1|n[,...]> |
| 148 | Description: Specify V4L2 minor mode number: | 148 | Description: Specify V4L2 minor mode number: |
| 149 | -1 = use next available | 149 | -1 = use next available |
| 150 | n = use minor number n | 150 | n = use minor number n |
| 151 | You can specify up to 64 cameras this way. | 151 | You can specify up to 64 cameras this way. |
| 152 | For example: | 152 | For example: |
| 153 | video_nr=-1,2,-1 would assign minor number 2 to the second | 153 | video_nr=-1,2,-1 would assign minor number 2 to the second |
| 154 | registered camera and use auto for the first one and for every | 154 | registered camera and use auto for the first one and for every |
| 155 | other camera. | 155 | other camera. |
| 156 | Default: -1 | 156 | Default: -1 |
| 157 | ------------------------------------------------------------------------------- | 157 | ------------------------------------------------------------------------------- |
| 158 | Name: force_munmap | 158 | Name: force_munmap |
| 159 | Type: bool array (min = 0, max = 64) | 159 | Type: bool array (min = 0, max = 64) |
| 160 | Syntax: <0|1[,...]> | 160 | Syntax: <0|1[,...]> |
| 161 | Description: Force the application to unmap previously mapped buffer memory | 161 | Description: Force the application to unmap previously mapped buffer memory |
| 162 | before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not | 162 | before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not |
| 163 | all the applications support this feature. This parameter is | 163 | all the applications support this feature. This parameter is |
| 164 | specific for each detected camera. | 164 | specific for each detected camera. |
| 165 | 0 = do not force memory unmapping | 165 | 0 = do not force memory unmapping |
| 166 | 1 = force memory unmapping (save memory) | 166 | 1 = force memory unmapping (save memory) |
| 167 | Default: 0 | 167 | Default: 0 |
| 168 | ------------------------------------------------------------------------------- | 168 | ------------------------------------------------------------------------------- |
| 169 | Name: frame_timeout | 169 | Name: frame_timeout |
| 170 | Type: uint array (min = 0, max = 64) | 170 | Type: uint array (min = 0, max = 64) |
| 171 | Syntax: <n[,...]> | 171 | Syntax: <n[,...]> |
| 172 | Description: Timeout for a video frame in seconds. This parameter is | 172 | Description: Timeout for a video frame in seconds. This parameter is |
| 173 | specific for each detected camera. This parameter can be | 173 | specific for each detected camera. This parameter can be |
| 174 | changed at runtime thanks to the /sys filesystem interface. | 174 | changed at runtime thanks to the /sys filesystem interface. |
| 175 | Default: 2 | 175 | Default: 2 |
| 176 | ------------------------------------------------------------------------------- | 176 | ------------------------------------------------------------------------------- |
| 177 | Name: debug | 177 | Name: debug |
| 178 | Type: ushort | 178 | Type: ushort |
| 179 | Syntax: <n> | 179 | Syntax: <n> |
| 180 | Description: Debugging information level, from 0 to 3: | 180 | Description: Debugging information level, from 0 to 3: |
| 181 | 0 = none (use carefully) | 181 | 0 = none (use carefully) |
| 182 | 1 = critical errors | 182 | 1 = critical errors |
| 183 | 2 = significant informations | 183 | 2 = significant informations |
| 184 | 3 = more verbose messages | 184 | 3 = more verbose messages |
| 185 | Level 3 is useful for testing only, when only one device | 185 | Level 3 is useful for testing only, when only one device |
| 186 | is used at the same time. It also shows some more informations | 186 | is used at the same time. It also shows some more informations |
| 187 | about the hardware being detected. This module parameter can be | 187 | about the hardware being detected. This module parameter can be |
| 188 | changed at runtime thanks to the /sys filesystem interface. | 188 | changed at runtime thanks to the /sys filesystem interface. |
| 189 | Default: 2 | 189 | Default: 2 |
| 190 | ------------------------------------------------------------------------------- | 190 | ------------------------------------------------------------------------------- |
| 191 | 191 | ||
| @@ -204,11 +204,25 @@ Vendor ID Product ID | |||
| 204 | 0x041e 0x4017 | 204 | 0x041e 0x4017 |
| 205 | 0x041e 0x401c | 205 | 0x041e 0x401c |
| 206 | 0x041e 0x401e | 206 | 0x041e 0x401e |
| 207 | 0x041e 0x401f | ||
| 208 | 0x041e 0x4022 | ||
| 207 | 0x041e 0x4034 | 209 | 0x041e 0x4034 |
| 208 | 0x041e 0x4035 | 210 | 0x041e 0x4035 |
| 211 | 0x041e 0x4036 | ||
| 212 | 0x041e 0x403a | ||
| 213 | 0x0458 0x7007 | ||
| 214 | 0x0458 0x700C | ||
| 215 | 0x0458 0x700f | ||
| 216 | 0x046d 0x08ae | ||
| 217 | 0x055f 0xd003 | ||
| 218 | 0x055f 0xd004 | ||
| 209 | 0x046d 0x08ae | 219 | 0x046d 0x08ae |
| 210 | 0x0ac8 0x0301 | 220 | 0x0ac8 0x0301 |
| 221 | 0x0ac8 0x301b | ||
| 222 | 0x0ac8 0x303b | ||
| 223 | 0x10fd 0x0128 | ||
| 211 | 0x10fd 0x8050 | 224 | 0x10fd 0x8050 |
| 225 | 0x10fd 0x804e | ||
| 212 | 226 | ||
| 213 | The list above does not imply that all those devices work with this driver: up | 227 | The list above does not imply that all those devices work with this driver: up |
| 214 | until now only the ones that mount the following image sensors are supported; | 228 | until now only the ones that mount the following image sensors are supported; |
| @@ -217,6 +231,7 @@ kernel messages will always tell you whether this is the case: | |||
| 217 | Model Manufacturer | 231 | Model Manufacturer |
| 218 | ----- ------------ | 232 | ----- ------------ |
| 219 | PAS202BCB PixArt Imaging, Inc. | 233 | PAS202BCB PixArt Imaging, Inc. |
| 234 | PB-0330 Photobit Corporation | ||
| 220 | 235 | ||
| 221 | 236 | ||
| 222 | 9. Notes for V4L2 application developers | 237 | 9. Notes for V4L2 application developers |
| @@ -250,5 +265,6 @@ the fingerprint is: '88E8 F32F 7244 68BA 3958 5D40 99DA 5D2A FCE6 35A4'. | |||
| 250 | been taken from the documentation of the ZC030x Video4Linux1 driver written | 265 | been taken from the documentation of the ZC030x Video4Linux1 driver written |
| 251 | by Andrew Birkett <andy@nobugs.org>; | 266 | by Andrew Birkett <andy@nobugs.org>; |
| 252 | - The initialization values of the ZC0301 controller connected to the PAS202BCB | 267 | - The initialization values of the ZC0301 controller connected to the PAS202BCB |
| 253 | image sensor have been taken from the SPCA5XX driver maintained by | 268 | and PB-0330 image sensors have been taken from the SPCA5XX driver maintained |
| 254 | Michel Xhaard <mxhaard@magic.fr>. | 269 | by Michel Xhaard <mxhaard@magic.fr>; |
| 270 | - Stanislav Lechev donated one camera. | ||
