diff options
Diffstat (limited to 'include/media/v4l2-common.h')
-rw-r--r-- | include/media/v4l2-common.h | 159 |
1 files changed, 34 insertions, 125 deletions
diff --git a/include/media/v4l2-common.h b/include/media/v4l2-common.h index 95e74f1874e1..c48c24e4d0fa 100644 --- a/include/media/v4l2-common.h +++ b/include/media/v4l2-common.h | |||
@@ -102,11 +102,15 @@ int v4l2_ctrl_check(struct v4l2_ext_control *ctrl, struct v4l2_queryctrl *qctrl, | |||
102 | const char *v4l2_ctrl_get_name(u32 id); | 102 | const char *v4l2_ctrl_get_name(u32 id); |
103 | const char **v4l2_ctrl_get_menu(u32 id); | 103 | const char **v4l2_ctrl_get_menu(u32 id); |
104 | int v4l2_ctrl_query_fill(struct v4l2_queryctrl *qctrl, s32 min, s32 max, s32 step, s32 def); | 104 | int v4l2_ctrl_query_fill(struct v4l2_queryctrl *qctrl, s32 min, s32 max, s32 step, s32 def); |
105 | int v4l2_ctrl_query_fill_std(struct v4l2_queryctrl *qctrl); | ||
106 | int v4l2_ctrl_query_menu(struct v4l2_querymenu *qmenu, | 105 | int v4l2_ctrl_query_menu(struct v4l2_querymenu *qmenu, |
107 | struct v4l2_queryctrl *qctrl, const char **menu_items); | 106 | struct v4l2_queryctrl *qctrl, const char **menu_items); |
108 | #define V4L2_CTRL_MENU_IDS_END (0xffffffff) | 107 | #define V4L2_CTRL_MENU_IDS_END (0xffffffff) |
109 | int v4l2_ctrl_query_menu_valid_items(struct v4l2_querymenu *qmenu, const u32 *ids); | 108 | int v4l2_ctrl_query_menu_valid_items(struct v4l2_querymenu *qmenu, const u32 *ids); |
109 | |||
110 | /* Note: ctrl_classes points to an array of u32 pointers. Each u32 array is a | ||
111 | 0-terminated array of control IDs. Each array must be sorted low to high | ||
112 | and belong to the same control class. The array of u32 pointers must also | ||
113 | be sorted, from low class IDs to high class IDs. */ | ||
110 | u32 v4l2_ctrl_next(const u32 * const *ctrl_classes, u32 id); | 114 | u32 v4l2_ctrl_next(const u32 * const *ctrl_classes, u32 id); |
111 | 115 | ||
112 | /* ------------------------------------------------------------------------- */ | 116 | /* ------------------------------------------------------------------------- */ |
@@ -121,7 +125,7 @@ int v4l2_chip_match_host(const struct v4l2_dbg_match *match); | |||
121 | 125 | ||
122 | /* ------------------------------------------------------------------------- */ | 126 | /* ------------------------------------------------------------------------- */ |
123 | 127 | ||
124 | /* Helper function for I2C legacy drivers */ | 128 | /* I2C Helper functions */ |
125 | 129 | ||
126 | struct i2c_driver; | 130 | struct i2c_driver; |
127 | struct i2c_adapter; | 131 | struct i2c_adapter; |
@@ -131,157 +135,62 @@ struct v4l2_device; | |||
131 | struct v4l2_subdev; | 135 | struct v4l2_subdev; |
132 | struct v4l2_subdev_ops; | 136 | struct v4l2_subdev_ops; |
133 | 137 | ||
134 | int v4l2_i2c_attach(struct i2c_adapter *adapter, int address, struct i2c_driver *driver, | ||
135 | const char *name, | ||
136 | int (*probe)(struct i2c_client *, const struct i2c_device_id *)); | ||
137 | 138 | ||
138 | /* Load an i2c module and return an initialized v4l2_subdev struct. | 139 | /* Load an i2c module and return an initialized v4l2_subdev struct. |
139 | Only call request_module if module_name != NULL. | 140 | Only call request_module if module_name != NULL. |
140 | The client_type argument is the name of the chip that's on the adapter. */ | 141 | The client_type argument is the name of the chip that's on the adapter. */ |
141 | struct v4l2_subdev *v4l2_i2c_new_subdev(struct i2c_adapter *adapter, | 142 | struct v4l2_subdev *v4l2_i2c_new_subdev(struct v4l2_device *v4l2_dev, |
143 | struct i2c_adapter *adapter, | ||
142 | const char *module_name, const char *client_type, u8 addr); | 144 | const char *module_name, const char *client_type, u8 addr); |
143 | /* Probe and load an i2c module and return an initialized v4l2_subdev struct. | 145 | /* Probe and load an i2c module and return an initialized v4l2_subdev struct. |
144 | Only call request_module if module_name != NULL. | 146 | Only call request_module if module_name != NULL. |
145 | The client_type argument is the name of the chip that's on the adapter. */ | 147 | The client_type argument is the name of the chip that's on the adapter. */ |
146 | struct v4l2_subdev *v4l2_i2c_new_probed_subdev(struct i2c_adapter *adapter, | 148 | struct v4l2_subdev *v4l2_i2c_new_probed_subdev(struct v4l2_device *v4l2_dev, |
149 | struct i2c_adapter *adapter, | ||
147 | const char *module_name, const char *client_type, | 150 | const char *module_name, const char *client_type, |
148 | const unsigned short *addrs); | 151 | const unsigned short *addrs); |
152 | /* Like v4l2_i2c_new_probed_subdev, except probe for a single address. */ | ||
153 | struct v4l2_subdev *v4l2_i2c_new_probed_subdev_addr(struct v4l2_device *v4l2_dev, | ||
154 | struct i2c_adapter *adapter, | ||
155 | const char *module_name, const char *client_type, u8 addr); | ||
149 | /* Initialize an v4l2_subdev with data from an i2c_client struct */ | 156 | /* Initialize an v4l2_subdev with data from an i2c_client struct */ |
150 | void v4l2_i2c_subdev_init(struct v4l2_subdev *sd, struct i2c_client *client, | 157 | void v4l2_i2c_subdev_init(struct v4l2_subdev *sd, struct i2c_client *client, |
151 | const struct v4l2_subdev_ops *ops); | 158 | const struct v4l2_subdev_ops *ops); |
159 | /* Return i2c client address of v4l2_subdev. */ | ||
160 | unsigned short v4l2_i2c_subdev_addr(struct v4l2_subdev *sd); | ||
161 | |||
162 | enum v4l2_i2c_tuner_type { | ||
163 | ADDRS_RADIO, /* Radio tuner addresses */ | ||
164 | ADDRS_DEMOD, /* Demod tuner addresses */ | ||
165 | ADDRS_TV, /* TV tuner addresses */ | ||
166 | /* TV tuner addresses if demod is present, this excludes | ||
167 | addresses used by the demodulator from the list of | ||
168 | candidates. */ | ||
169 | ADDRS_TV_WITH_DEMOD, | ||
170 | }; | ||
171 | /* Return a list of I2C tuner addresses to probe. Use only if the tuner | ||
172 | addresses are unknown. */ | ||
173 | const unsigned short *v4l2_i2c_tuner_addrs(enum v4l2_i2c_tuner_type type); | ||
152 | 174 | ||
153 | /* ------------------------------------------------------------------------- */ | 175 | /* ------------------------------------------------------------------------- */ |
154 | 176 | ||
155 | /* Internal ioctls */ | 177 | /* Note: these remaining ioctls/structs should be removed as well, but they are |
156 | 178 | still used in tuner-simple.c (TUNER_SET_CONFIG), cx18/ivtv (RESET) and | |
157 | /* VIDIOC_INT_DECODE_VBI_LINE */ | 179 | v4l2-int-device.h (v4l2_routing). To remove these ioctls some more cleanup |
158 | struct v4l2_decode_vbi_line { | 180 | is needed in those modules. */ |
159 | u32 is_second_field; /* Set to 0 for the first (odd) field, | ||
160 | set to 1 for the second (even) field. */ | ||
161 | u8 *p; /* Pointer to the sliced VBI data from the decoder. | ||
162 | On exit points to the start of the payload. */ | ||
163 | u32 line; /* Line number of the sliced VBI data (1-23) */ | ||
164 | u32 type; /* VBI service type (V4L2_SLICED_*). 0 if no service found */ | ||
165 | }; | ||
166 | 181 | ||
182 | /* s_config */ | ||
167 | struct v4l2_priv_tun_config { | 183 | struct v4l2_priv_tun_config { |
168 | int tuner; | 184 | int tuner; |
169 | void *priv; | 185 | void *priv; |
170 | }; | 186 | }; |
171 | |||
172 | /* audio ioctls */ | ||
173 | |||
174 | /* v4l device was opened in Radio mode, to be replaced by VIDIOC_INT_S_TUNER_MODE */ | ||
175 | #define AUDC_SET_RADIO _IO('d',88) | ||
176 | |||
177 | /* tuner ioctls */ | ||
178 | |||
179 | /* Sets tuner type and its I2C addr */ | ||
180 | #define TUNER_SET_TYPE_ADDR _IOW('d', 90, int) | ||
181 | |||
182 | /* Puts tuner on powersaving state, disabling it, except for i2c. To be replaced | ||
183 | by VIDIOC_INT_S_STANDBY. */ | ||
184 | #define TUNER_SET_STANDBY _IOW('d', 91, int) | ||
185 | |||
186 | /* Sets tda9887 specific stuff, like port1, port2 and qss */ | ||
187 | #define TUNER_SET_CONFIG _IOW('d', 92, struct v4l2_priv_tun_config) | 187 | #define TUNER_SET_CONFIG _IOW('d', 92, struct v4l2_priv_tun_config) |
188 | 188 | ||
189 | /* Switch the tuner to a specific tuner mode. Replacement of AUDC_SET_RADIO */ | ||
190 | #define VIDIOC_INT_S_TUNER_MODE _IOW('d', 93, enum v4l2_tuner_type) | ||
191 | |||
192 | /* Generic standby command. Passing -1 (all bits set to 1) will put the whole | ||
193 | chip into standby mode, value 0 will make the chip fully active. Specific | ||
194 | bits can be used by certain chips to enable/disable specific subsystems. | ||
195 | Replacement of TUNER_SET_STANDBY. */ | ||
196 | #define VIDIOC_INT_S_STANDBY _IOW('d', 94, u32) | ||
197 | |||
198 | /* 100, 101 used by VIDIOC_DBG_[SG]_REGISTER */ | ||
199 | |||
200 | /* Generic reset command. The argument selects which subsystems to reset. | ||
201 | Passing 0 will always reset the whole chip. */ | ||
202 | #define VIDIOC_INT_RESET _IOW ('d', 102, u32) | 189 | #define VIDIOC_INT_RESET _IOW ('d', 102, u32) |
203 | 190 | ||
204 | /* Set the frequency (in Hz) of the audio clock output. | ||
205 | Used to slave an audio processor to the video decoder, ensuring that audio | ||
206 | and video remain synchronized. | ||
207 | Usual values for the frequency are 48000, 44100 or 32000 Hz. | ||
208 | If the frequency is not supported, then -EINVAL is returned. */ | ||
209 | #define VIDIOC_INT_AUDIO_CLOCK_FREQ _IOW ('d', 103, u32) | ||
210 | |||
211 | /* Video decoders that support sliced VBI need to implement this ioctl. | ||
212 | Field p of the v4l2_sliced_vbi_line struct is set to the start of the VBI | ||
213 | data that was generated by the decoder. The driver then parses the sliced | ||
214 | VBI data and sets the other fields in the struct accordingly. The pointer p | ||
215 | is updated to point to the start of the payload which can be copied | ||
216 | verbatim into the data field of the v4l2_sliced_vbi_data struct. If no | ||
217 | valid VBI data was found, then the type field is set to 0 on return. */ | ||
218 | #define VIDIOC_INT_DECODE_VBI_LINE _IOWR('d', 104, struct v4l2_decode_vbi_line) | ||
219 | |||
220 | /* Used to generate VBI signals on a video signal. v4l2_sliced_vbi_data is | ||
221 | filled with the data packets that should be output. Note that if you set | ||
222 | the line field to 0, then that VBI signal is disabled. If no | ||
223 | valid VBI data was found, then the type field is set to 0 on return. */ | ||
224 | #define VIDIOC_INT_S_VBI_DATA _IOW ('d', 105, struct v4l2_sliced_vbi_data) | ||
225 | |||
226 | /* Used to obtain the sliced VBI packet from a readback register. Not all | ||
227 | video decoders support this. If no data is available because the readback | ||
228 | register contains invalid or erroneous data -EIO is returned. Note that | ||
229 | you must fill in the 'id' member and the 'field' member (to determine | ||
230 | whether CC data from the first or second field should be obtained). */ | ||
231 | #define VIDIOC_INT_G_VBI_DATA _IOWR('d', 106, struct v4l2_sliced_vbi_data) | ||
232 | |||
233 | /* Sets I2S speed in bps. This is used to provide a standard way to select I2S | ||
234 | clock used by driving digital audio streams at some board designs. | ||
235 | Usual values for the frequency are 1024000 and 2048000. | ||
236 | If the frequency is not supported, then -EINVAL is returned. */ | ||
237 | #define VIDIOC_INT_I2S_CLOCK_FREQ _IOW ('d', 108, u32) | ||
238 | |||
239 | /* Routing definition, device dependent. It specifies which inputs (if any) | ||
240 | should be routed to which outputs (if any). */ | ||
241 | struct v4l2_routing { | 191 | struct v4l2_routing { |
242 | u32 input; | 192 | u32 input; |
243 | u32 output; | 193 | u32 output; |
244 | }; | 194 | }; |
245 | 195 | ||
246 | /* These internal commands should be used to define the inputs and outputs | ||
247 | of an audio/video chip. They will replace the v4l2 API commands | ||
248 | VIDIOC_S/G_INPUT, VIDIOC_S/G_OUTPUT, VIDIOC_S/G_AUDIO and VIDIOC_S/G_AUDOUT | ||
249 | that are meant to be used by the user. | ||
250 | The internal commands should be used to switch inputs/outputs | ||
251 | because only the driver knows how to map a 'Television' input to the precise | ||
252 | input/output routing of an A/D converter, or a DSP, or a video digitizer. | ||
253 | These four commands should only be sent directly to an i2c device, they | ||
254 | should not be broadcast as the routing is very device specific. */ | ||
255 | #define VIDIOC_INT_S_AUDIO_ROUTING _IOW ('d', 109, struct v4l2_routing) | ||
256 | #define VIDIOC_INT_G_AUDIO_ROUTING _IOR ('d', 110, struct v4l2_routing) | ||
257 | #define VIDIOC_INT_S_VIDEO_ROUTING _IOW ('d', 111, struct v4l2_routing) | ||
258 | #define VIDIOC_INT_G_VIDEO_ROUTING _IOR ('d', 112, struct v4l2_routing) | ||
259 | |||
260 | struct v4l2_crystal_freq { | ||
261 | u32 freq; /* frequency in Hz of the crystal */ | ||
262 | u32 flags; /* device specific flags */ | ||
263 | }; | ||
264 | |||
265 | /* Sets the frequency of the crystal used to generate the clocks. | ||
266 | An extra flags field allows device specific configuration regarding | ||
267 | clock frequency dividers, etc. If not used, then set flags to 0. | ||
268 | If the frequency is not supported, then -EINVAL is returned. */ | ||
269 | #define VIDIOC_INT_S_CRYSTAL_FREQ _IOW('d', 113, struct v4l2_crystal_freq) | ||
270 | |||
271 | /* Initialize the sensor registors to some sort of reasonable | ||
272 | default values. */ | ||
273 | #define VIDIOC_INT_INIT _IOW('d', 114, u32) | ||
274 | |||
275 | /* Set v4l2_std_id for video OUTPUT devices. This is ignored by | ||
276 | video input devices. */ | ||
277 | #define VIDIOC_INT_S_STD_OUTPUT _IOW('d', 115, v4l2_std_id) | ||
278 | |||
279 | /* Get v4l2_std_id for video OUTPUT devices. This is ignored by | ||
280 | video input devices. */ | ||
281 | #define VIDIOC_INT_G_STD_OUTPUT _IOW('d', 116, v4l2_std_id) | ||
282 | |||
283 | /* Set GPIO pins. Very simple right now, might need to be extended with | ||
284 | a v4l2_gpio struct if a direction is also needed. */ | ||
285 | #define VIDIOC_INT_S_GPIO _IOW('d', 117, u32) | ||
286 | |||
287 | #endif /* V4L2_COMMON_H_ */ | 196 | #endif /* V4L2_COMMON_H_ */ |