diff options
Diffstat (limited to 'drivers/media/video/pwc/philips.txt')
-rw-r--r-- | drivers/media/video/pwc/philips.txt | 66 |
1 files changed, 33 insertions, 33 deletions
diff --git a/drivers/media/video/pwc/philips.txt b/drivers/media/video/pwc/philips.txt index 04a640d723ed..11f751a6bda5 100644 --- a/drivers/media/video/pwc/philips.txt +++ b/drivers/media/video/pwc/philips.txt | |||
@@ -47,17 +47,17 @@ don't know how to set it properly in the driver. The options are: | |||
47 | size | 47 | size |
48 | Can be one of 'sqcif', 'qsif', 'qcif', 'sif', 'cif' or | 48 | Can be one of 'sqcif', 'qsif', 'qcif', 'sif', 'cif' or |
49 | 'vga', for an image size of resp. 128x96, 160x120, 176x144, | 49 | 'vga', for an image size of resp. 128x96, 160x120, 176x144, |
50 | 320x240, 352x288 and 640x480 (of course, only for those cameras that | 50 | 320x240, 352x288 and 640x480 (of course, only for those cameras that |
51 | support these resolutions). | 51 | support these resolutions). |
52 | 52 | ||
53 | fps | 53 | fps |
54 | Specifies the desired framerate. Is an integer in the range of 4-30. | 54 | Specifies the desired framerate. Is an integer in the range of 4-30. |
55 | 55 | ||
56 | fbufs | 56 | fbufs |
57 | This paramter specifies the number of internal buffers to use for storing | 57 | This paramter specifies the number of internal buffers to use for storing |
58 | frames from the cam. This will help if the process that reads images from | 58 | frames from the cam. This will help if the process that reads images from |
59 | the cam is a bit slow or momentarely busy. However, on slow machines it | 59 | the cam is a bit slow or momentarely busy. However, on slow machines it |
60 | only introduces lag, so choose carefully. The default is 3, which is | 60 | only introduces lag, so choose carefully. The default is 3, which is |
61 | reasonable. You can set it between 2 and 5. | 61 | reasonable. You can set it between 2 and 5. |
62 | 62 | ||
63 | mbufs | 63 | mbufs |
@@ -65,9 +65,9 @@ mbufs | |||
65 | buffers to reserve for mmap(), VIDIOCCGMBUF, VIDIOCMCAPTURE and friends. | 65 | buffers to reserve for mmap(), VIDIOCCGMBUF, VIDIOCMCAPTURE and friends. |
66 | The default is 2, which is adequate for most applications (double | 66 | The default is 2, which is adequate for most applications (double |
67 | buffering). | 67 | buffering). |
68 | 68 | ||
69 | Should you experience a lot of 'Dumping frame...' messages during | 69 | Should you experience a lot of 'Dumping frame...' messages during |
70 | grabbing with a tool that uses mmap(), you might want to increase if. | 70 | grabbing with a tool that uses mmap(), you might want to increase if. |
71 | However, it doesn't really buffer images, it just gives you a bit more | 71 | However, it doesn't really buffer images, it just gives you a bit more |
72 | slack when your program is behind. But you need a multi-threaded or | 72 | slack when your program is behind. But you need a multi-threaded or |
73 | forked program to really take advantage of these buffers. | 73 | forked program to really take advantage of these buffers. |
@@ -88,15 +88,15 @@ power_save | |||
88 | 88 | ||
89 | compression (only useful with the plugin) | 89 | compression (only useful with the plugin) |
90 | With this option you can control the compression factor that the camera | 90 | With this option you can control the compression factor that the camera |
91 | uses to squeeze the image through the USB bus. You can set the | 91 | uses to squeeze the image through the USB bus. You can set the |
92 | parameter between 0 and 3: | 92 | parameter between 0 and 3: |
93 | 0 = prefer uncompressed images; if the requested mode is not available | 93 | 0 = prefer uncompressed images; if the requested mode is not available |
94 | in an uncompressed format, the driver will silently switch to low | 94 | in an uncompressed format, the driver will silently switch to low |
95 | compression. | 95 | compression. |
96 | 1 = low compression. | 96 | 1 = low compression. |
97 | 2 = medium compression. | 97 | 2 = medium compression. |
98 | 3 = high compression. | 98 | 3 = high compression. |
99 | 99 | ||
100 | High compression takes less bandwidth of course, but it could also | 100 | High compression takes less bandwidth of course, but it could also |
101 | introduce some unwanted artefacts. The default is 2, medium compression. | 101 | introduce some unwanted artefacts. The default is 2, medium compression. |
102 | See the FAQ on the website for an overview of which modes require | 102 | See the FAQ on the website for an overview of which modes require |
@@ -112,7 +112,7 @@ leds | |||
112 | this is let the LED blink while the camera is in use. This: | 112 | this is let the LED blink while the camera is in use. This: |
113 | 113 | ||
114 | leds=500,500 | 114 | leds=500,500 |
115 | 115 | ||
116 | will blink the LED once every second. But with: | 116 | will blink the LED once every second. But with: |
117 | 117 | ||
118 | leds=0,0 | 118 | leds=0,0 |
@@ -123,7 +123,7 @@ leds | |||
123 | when the camera is not used anymore. | 123 | when the camera is not used anymore. |
124 | 124 | ||
125 | This parameter works only with the ToUCam range of cameras (720, 730, 740, | 125 | This parameter works only with the ToUCam range of cameras (720, 730, 740, |
126 | 750) and OEMs. For other cameras this command is silently ignored, and | 126 | 750) and OEMs. For other cameras this command is silently ignored, and |
127 | the LED cannot be controlled. | 127 | the LED cannot be controlled. |
128 | 128 | ||
129 | Finally: this parameters does not take effect UNTIL the first time you | 129 | Finally: this parameters does not take effect UNTIL the first time you |
@@ -144,35 +144,35 @@ dev_hint | |||
144 | format: | 144 | format: |
145 | 145 | ||
146 | [type[.serialnumber]:]node | 146 | [type[.serialnumber]:]node |
147 | 147 | ||
148 | The square brackets mean that both the type and the serialnumber are | 148 | The square brackets mean that both the type and the serialnumber are |
149 | optional, but a serialnumber cannot be specified without a type (which | 149 | optional, but a serialnumber cannot be specified without a type (which |
150 | would be rather pointless). The serialnumber is separated from the type | 150 | would be rather pointless). The serialnumber is separated from the type |
151 | by a '.'; the node number by a ':'. | 151 | by a '.'; the node number by a ':'. |
152 | 152 | ||
153 | This somewhat cryptic syntax is best explained by a few examples: | 153 | This somewhat cryptic syntax is best explained by a few examples: |
154 | 154 | ||
155 | dev_hint=3,5 The first detected cam gets assigned | 155 | dev_hint=3,5 The first detected cam gets assigned |
156 | /dev/video3, the second /dev/video5. Any | 156 | /dev/video3, the second /dev/video5. Any |
157 | other cameras will get the first free | 157 | other cameras will get the first free |
158 | available slot (see below). | 158 | available slot (see below). |
159 | 159 | ||
160 | dev_hint=645:1,680:2 The PCA645 camera will get /dev/video1, | 160 | dev_hint=645:1,680:2 The PCA645 camera will get /dev/video1, |
161 | and a PCVC680 /dev/video2. | 161 | and a PCVC680 /dev/video2. |
162 | 162 | ||
163 | dev_hint=645.0123:3,645.4567:0 The PCA645 camera with serialnumber | 163 | dev_hint=645.0123:3,645.4567:0 The PCA645 camera with serialnumber |
164 | 0123 goes to /dev/video3, the same | 164 | 0123 goes to /dev/video3, the same |
165 | camera model with the 4567 serial | 165 | camera model with the 4567 serial |
166 | gets /dev/video0. | 166 | gets /dev/video0. |
167 | 167 | ||
168 | dev_hint=750:1,4,5,6 The PCVC750 camera will get /dev/video1, the | 168 | dev_hint=750:1,4,5,6 The PCVC750 camera will get /dev/video1, the |
169 | next 3 Philips cams will use /dev/video4 | 169 | next 3 Philips cams will use /dev/video4 |
170 | through /dev/video6. | 170 | through /dev/video6. |
171 | 171 | ||
172 | Some points worth knowing: | 172 | Some points worth knowing: |
173 | - Serialnumbers are case sensitive and must be written full, including | 173 | - Serialnumbers are case sensitive and must be written full, including |
174 | leading zeroes (it's treated as a string). | 174 | leading zeroes (it's treated as a string). |
175 | - If a device node is already occupied, registration will fail and | 175 | - If a device node is already occupied, registration will fail and |
176 | the webcam is not available. | 176 | the webcam is not available. |
177 | - You can have up to 64 video devices; be sure to make enough device | 177 | - You can have up to 64 video devices; be sure to make enough device |
178 | nodes in /dev if you want to spread the numbers (this does not apply | 178 | nodes in /dev if you want to spread the numbers (this does not apply |
@@ -186,13 +186,13 @@ trace | |||
186 | kernel log at debug level. | 186 | kernel log at debug level. |
187 | 187 | ||
188 | The trace variable is a bitmask; each bit represents a certain feature. | 188 | The trace variable is a bitmask; each bit represents a certain feature. |
189 | If you want to trace something, look up the bit value(s) in the table | 189 | If you want to trace something, look up the bit value(s) in the table |
190 | below, add the values together and supply that to the trace variable. | 190 | below, add the values together and supply that to the trace variable. |
191 | 191 | ||
192 | Value Value Description Default | 192 | Value Value Description Default |
193 | (dec) (hex) | 193 | (dec) (hex) |
194 | 1 0x1 Module initialization; this will log messages On | 194 | 1 0x1 Module initialization; this will log messages On |
195 | while loading and unloading the module | 195 | while loading and unloading the module |
196 | 196 | ||
197 | 2 0x2 probe() and disconnect() traces On | 197 | 2 0x2 probe() and disconnect() traces On |
198 | 198 | ||
@@ -203,7 +203,7 @@ trace | |||
203 | 16 0x10 Memory allocation of buffers, etc. Off | 203 | 16 0x10 Memory allocation of buffers, etc. Off |
204 | 204 | ||
205 | 32 0x20 Showing underflow, overflow and Dumping frame On | 205 | 32 0x20 Showing underflow, overflow and Dumping frame On |
206 | messages | 206 | messages |
207 | 207 | ||
208 | 64 0x40 Show viewport and image sizes Off | 208 | 64 0x40 Show viewport and image sizes Off |
209 | 209 | ||
@@ -217,7 +217,7 @@ trace | |||
217 | 217 | ||
218 | 218 | ||
219 | Example: | 219 | Example: |
220 | 220 | ||
221 | # modprobe pwc size=cif fps=15 power_save=1 | 221 | # modprobe pwc size=cif fps=15 power_save=1 |
222 | 222 | ||
223 | The fbufs, mbufs and trace parameters are global and apply to all connected | 223 | The fbufs, mbufs and trace parameters are global and apply to all connected |