1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * V4L2 flash LED sub-device registration helpers.
4 *
5 * Copyright (C) 2015 Samsung Electronics Co., Ltd
6 * Author: Jacek Anaszewski <j.anaszewski@samsung.com>
7 */
8
9 #include <linux/led-class-flash.h>
10 #include <linux/module.h>
11 #include <linux/mutex.h>
12 #include <linux/property.h>
13 #include <linux/slab.h>
14 #include <linux/types.h>
15 #include <media/v4l2-flash-led-class.h>
16
17 #define has_flash_op(v4l2_flash, op) \
18 (v4l2_flash && v4l2_flash->ops && v4l2_flash->ops->op)
19
20 #define call_flash_op(v4l2_flash, op, arg) \
21 (has_flash_op(v4l2_flash, op) ? \
22 v4l2_flash->ops->op(v4l2_flash, arg) : \
23 -EINVAL)
24
25 enum ctrl_init_data_id {
26 LED_MODE,
27 TORCH_INTENSITY,
28 FLASH_INTENSITY,
29 INDICATOR_INTENSITY,
30 FLASH_TIMEOUT,
31 STROBE_SOURCE,
32 /*
33 * Only above values are applicable to
34 * the 'ctrls' array in the struct v4l2_flash.
35 */
36 FLASH_STROBE,
37 STROBE_STOP,
38 STROBE_STATUS,
39 FLASH_FAULT,
40 NUM_FLASH_CTRLS,
41 };
42
__intensity_to_led_brightness(struct v4l2_ctrl * ctrl,s32 intensity)43 static enum led_brightness __intensity_to_led_brightness(
44 struct v4l2_ctrl *ctrl, s32 intensity)
45 {
46 intensity -= ctrl->minimum;
47 intensity /= (u32) ctrl->step;
48
49 /*
50 * Indicator LEDs, unlike torch LEDs, are turned on/off basing on
51 * the state of V4L2_CID_FLASH_INDICATOR_INTENSITY control only.
52 * Therefore it must be possible to set it to 0 level which in
53 * the LED subsystem reflects LED_OFF state.
54 */
55 if (ctrl->minimum)
56 ++intensity;
57
58 return intensity;
59 }
60
__led_brightness_to_intensity(struct v4l2_ctrl * ctrl,enum led_brightness brightness)61 static s32 __led_brightness_to_intensity(struct v4l2_ctrl *ctrl,
62 enum led_brightness brightness)
63 {
64 /*
65 * Indicator LEDs, unlike torch LEDs, are turned on/off basing on
66 * the state of V4L2_CID_FLASH_INDICATOR_INTENSITY control only.
67 * Do not decrement brightness read from the LED subsystem for
68 * indicator LED as it may equal 0. For torch LEDs this function
69 * is called only when V4L2_FLASH_LED_MODE_TORCH is set and the
70 * brightness read is guaranteed to be greater than 0. In the mode
71 * V4L2_FLASH_LED_MODE_NONE the cached torch intensity value is used.
72 */
73 if (ctrl->id != V4L2_CID_FLASH_INDICATOR_INTENSITY)
74 --brightness;
75
76 return (brightness * ctrl->step) + ctrl->minimum;
77 }
78
v4l2_flash_set_led_brightness(struct v4l2_flash * v4l2_flash,struct v4l2_ctrl * ctrl)79 static int v4l2_flash_set_led_brightness(struct v4l2_flash *v4l2_flash,
80 struct v4l2_ctrl *ctrl)
81 {
82 struct v4l2_ctrl **ctrls = v4l2_flash->ctrls;
83 struct led_classdev *led_cdev;
84 enum led_brightness brightness;
85
86 if (has_flash_op(v4l2_flash, intensity_to_led_brightness))
87 brightness = call_flash_op(v4l2_flash,
88 intensity_to_led_brightness,
89 ctrl->val);
90 else
91 brightness = __intensity_to_led_brightness(ctrl, ctrl->val);
92 /*
93 * In case a LED Flash class driver provides ops for custom
94 * brightness <-> intensity conversion, it also must have defined
95 * related v4l2 control step == 1. In such a case a backward conversion
96 * from led brightness to v4l2 intensity is required to find out the
97 * aligned intensity value.
98 */
99 if (has_flash_op(v4l2_flash, led_brightness_to_intensity))
100 ctrl->val = call_flash_op(v4l2_flash,
101 led_brightness_to_intensity,
102 brightness);
103
104 if (ctrl == ctrls[TORCH_INTENSITY]) {
105 if (ctrls[LED_MODE]->val != V4L2_FLASH_LED_MODE_TORCH)
106 return 0;
107
108 if (WARN_ON_ONCE(!v4l2_flash->fled_cdev))
109 return -EINVAL;
110
111 led_cdev = &v4l2_flash->fled_cdev->led_cdev;
112 } else {
113 if (WARN_ON_ONCE(!v4l2_flash->iled_cdev))
114 return -EINVAL;
115
116 led_cdev = v4l2_flash->iled_cdev;
117 }
118
119 return led_set_brightness_sync(led_cdev, brightness);
120 }
121
v4l2_flash_update_led_brightness(struct v4l2_flash * v4l2_flash,struct v4l2_ctrl * ctrl)122 static int v4l2_flash_update_led_brightness(struct v4l2_flash *v4l2_flash,
123 struct v4l2_ctrl *ctrl)
124 {
125 struct v4l2_ctrl **ctrls = v4l2_flash->ctrls;
126 struct led_classdev *led_cdev;
127 int ret;
128
129 if (ctrl == ctrls[TORCH_INTENSITY]) {
130 /*
131 * Update torch brightness only if in TORCH_MODE. In other modes
132 * torch led is turned off, which would spuriously inform the
133 * user space that V4L2_CID_FLASH_TORCH_INTENSITY control value
134 * has changed to 0.
135 */
136 if (ctrls[LED_MODE]->val != V4L2_FLASH_LED_MODE_TORCH)
137 return 0;
138
139 if (WARN_ON_ONCE(!v4l2_flash->fled_cdev))
140 return -EINVAL;
141
142 led_cdev = &v4l2_flash->fled_cdev->led_cdev;
143 } else {
144 if (WARN_ON_ONCE(!v4l2_flash->iled_cdev))
145 return -EINVAL;
146
147 led_cdev = v4l2_flash->iled_cdev;
148 }
149
150 ret = led_update_brightness(led_cdev);
151 if (ret < 0)
152 return ret;
153
154 if (has_flash_op(v4l2_flash, led_brightness_to_intensity))
155 ctrl->val = call_flash_op(v4l2_flash,
156 led_brightness_to_intensity,
157 led_cdev->brightness);
158 else
159 ctrl->val = __led_brightness_to_intensity(ctrl,
160 led_cdev->brightness);
161
162 return 0;
163 }
164
v4l2_flash_g_volatile_ctrl(struct v4l2_ctrl * c)165 static int v4l2_flash_g_volatile_ctrl(struct v4l2_ctrl *c)
166 {
167 struct v4l2_flash *v4l2_flash = v4l2_ctrl_to_v4l2_flash(c);
168 struct led_classdev_flash *fled_cdev = v4l2_flash->fled_cdev;
169 bool is_strobing;
170 int ret;
171
172 switch (c->id) {
173 case V4L2_CID_FLASH_TORCH_INTENSITY:
174 case V4L2_CID_FLASH_INDICATOR_INTENSITY:
175 return v4l2_flash_update_led_brightness(v4l2_flash, c);
176 }
177
178 if (!fled_cdev)
179 return -EINVAL;
180
181 switch (c->id) {
182 case V4L2_CID_FLASH_INTENSITY:
183 ret = led_update_flash_brightness(fled_cdev);
184 if (ret < 0)
185 return ret;
186 /*
187 * No conversion is needed as LED Flash class also uses
188 * microamperes for flash intensity units.
189 */
190 c->val = fled_cdev->brightness.val;
191 return 0;
192 case V4L2_CID_FLASH_STROBE_STATUS:
193 ret = led_get_flash_strobe(fled_cdev, &is_strobing);
194 if (ret < 0)
195 return ret;
196 c->val = is_strobing;
197 return 0;
198 case V4L2_CID_FLASH_FAULT:
199 /* LED faults map directly to V4L2 flash faults */
200 return led_get_flash_fault(fled_cdev, &c->val);
201 default:
202 return -EINVAL;
203 }
204 }
205
__software_strobe_mode_inactive(struct v4l2_ctrl ** ctrls)206 static bool __software_strobe_mode_inactive(struct v4l2_ctrl **ctrls)
207 {
208 return ((ctrls[LED_MODE]->val != V4L2_FLASH_LED_MODE_FLASH) ||
209 (ctrls[STROBE_SOURCE] && (ctrls[STROBE_SOURCE]->val !=
210 V4L2_FLASH_STROBE_SOURCE_SOFTWARE)));
211 }
212
v4l2_flash_s_ctrl(struct v4l2_ctrl * c)213 static int v4l2_flash_s_ctrl(struct v4l2_ctrl *c)
214 {
215 struct v4l2_flash *v4l2_flash = v4l2_ctrl_to_v4l2_flash(c);
216 struct led_classdev_flash *fled_cdev = v4l2_flash->fled_cdev;
217 struct led_classdev *led_cdev;
218 struct v4l2_ctrl **ctrls = v4l2_flash->ctrls;
219 bool external_strobe;
220 int ret = 0;
221
222 switch (c->id) {
223 case V4L2_CID_FLASH_TORCH_INTENSITY:
224 case V4L2_CID_FLASH_INDICATOR_INTENSITY:
225 return v4l2_flash_set_led_brightness(v4l2_flash, c);
226 }
227
228 if (!fled_cdev)
229 return -EINVAL;
230
231 led_cdev = &fled_cdev->led_cdev;
232
233 switch (c->id) {
234 case V4L2_CID_FLASH_LED_MODE:
235 switch (c->val) {
236 case V4L2_FLASH_LED_MODE_NONE:
237 led_set_brightness_sync(led_cdev, LED_OFF);
238 return led_set_flash_strobe(fled_cdev, false);
239 case V4L2_FLASH_LED_MODE_FLASH:
240 /* Turn the torch LED off */
241 led_set_brightness_sync(led_cdev, LED_OFF);
242 if (ctrls[STROBE_SOURCE]) {
243 external_strobe = (ctrls[STROBE_SOURCE]->val ==
244 V4L2_FLASH_STROBE_SOURCE_EXTERNAL);
245
246 ret = call_flash_op(v4l2_flash,
247 external_strobe_set,
248 external_strobe);
249 }
250 return ret;
251 case V4L2_FLASH_LED_MODE_TORCH:
252 if (ctrls[STROBE_SOURCE]) {
253 ret = call_flash_op(v4l2_flash,
254 external_strobe_set,
255 false);
256 if (ret < 0)
257 return ret;
258 }
259 /* Stop flash strobing */
260 ret = led_set_flash_strobe(fled_cdev, false);
261 if (ret < 0)
262 return ret;
263
264 return v4l2_flash_set_led_brightness(v4l2_flash,
265 ctrls[TORCH_INTENSITY]);
266 }
267 break;
268 case V4L2_CID_FLASH_STROBE_SOURCE:
269 external_strobe = (c->val == V4L2_FLASH_STROBE_SOURCE_EXTERNAL);
270 /*
271 * For some hardware arrangements setting strobe source may
272 * affect torch mode. Therefore, if not in the flash mode,
273 * cache only this setting. It will be applied upon switching
274 * to flash mode.
275 */
276 if (ctrls[LED_MODE]->val != V4L2_FLASH_LED_MODE_FLASH)
277 return 0;
278
279 return call_flash_op(v4l2_flash, external_strobe_set,
280 external_strobe);
281 case V4L2_CID_FLASH_STROBE:
282 if (__software_strobe_mode_inactive(ctrls))
283 return -EBUSY;
284 return led_set_flash_strobe(fled_cdev, true);
285 case V4L2_CID_FLASH_STROBE_STOP:
286 if (__software_strobe_mode_inactive(ctrls))
287 return -EBUSY;
288 return led_set_flash_strobe(fled_cdev, false);
289 case V4L2_CID_FLASH_TIMEOUT:
290 /*
291 * No conversion is needed as LED Flash class also uses
292 * microseconds for flash timeout units.
293 */
294 return led_set_flash_timeout(fled_cdev, c->val);
295 case V4L2_CID_FLASH_INTENSITY:
296 /*
297 * No conversion is needed as LED Flash class also uses
298 * microamperes for flash intensity units.
299 */
300 return led_set_flash_brightness(fled_cdev, c->val);
301 }
302
303 return -EINVAL;
304 }
305
306 static const struct v4l2_ctrl_ops v4l2_flash_ctrl_ops = {
307 .g_volatile_ctrl = v4l2_flash_g_volatile_ctrl,
308 .s_ctrl = v4l2_flash_s_ctrl,
309 };
310
__lfs_to_v4l2_ctrl_config(struct led_flash_setting * s,struct v4l2_ctrl_config * c)311 static void __lfs_to_v4l2_ctrl_config(struct led_flash_setting *s,
312 struct v4l2_ctrl_config *c)
313 {
314 c->min = s->min;
315 c->max = s->max;
316 c->step = s->step;
317 c->def = s->val;
318 }
319
__fill_ctrl_init_data(struct v4l2_flash * v4l2_flash,struct v4l2_flash_config * flash_cfg,struct v4l2_flash_ctrl_data * ctrl_init_data)320 static void __fill_ctrl_init_data(struct v4l2_flash *v4l2_flash,
321 struct v4l2_flash_config *flash_cfg,
322 struct v4l2_flash_ctrl_data *ctrl_init_data)
323 {
324 struct led_classdev_flash *fled_cdev = v4l2_flash->fled_cdev;
325 struct led_classdev *led_cdev = fled_cdev ? &fled_cdev->led_cdev : NULL;
326 struct v4l2_ctrl_config *ctrl_cfg;
327 u32 mask;
328
329 /* Init INDICATOR_INTENSITY ctrl data */
330 if (v4l2_flash->iled_cdev) {
331 ctrl_init_data[INDICATOR_INTENSITY].cid =
332 V4L2_CID_FLASH_INDICATOR_INTENSITY;
333 ctrl_cfg = &ctrl_init_data[INDICATOR_INTENSITY].config;
334 __lfs_to_v4l2_ctrl_config(&flash_cfg->intensity,
335 ctrl_cfg);
336 ctrl_cfg->id = V4L2_CID_FLASH_INDICATOR_INTENSITY;
337 ctrl_cfg->min = 0;
338 ctrl_cfg->flags = V4L2_CTRL_FLAG_VOLATILE |
339 V4L2_CTRL_FLAG_EXECUTE_ON_WRITE;
340 }
341
342 if (!led_cdev || WARN_ON(!(led_cdev->flags & LED_DEV_CAP_FLASH)))
343 return;
344
345 /* Init FLASH_FAULT ctrl data */
346 if (flash_cfg->flash_faults) {
347 ctrl_init_data[FLASH_FAULT].cid = V4L2_CID_FLASH_FAULT;
348 ctrl_cfg = &ctrl_init_data[FLASH_FAULT].config;
349 ctrl_cfg->id = V4L2_CID_FLASH_FAULT;
350 ctrl_cfg->max = flash_cfg->flash_faults;
351 ctrl_cfg->flags = V4L2_CTRL_FLAG_VOLATILE |
352 V4L2_CTRL_FLAG_READ_ONLY;
353 }
354
355 /* Init FLASH_LED_MODE ctrl data */
356 mask = 1 << V4L2_FLASH_LED_MODE_NONE |
357 1 << V4L2_FLASH_LED_MODE_TORCH;
358 if (led_cdev->flags & LED_DEV_CAP_FLASH)
359 mask |= 1 << V4L2_FLASH_LED_MODE_FLASH;
360
361 ctrl_init_data[LED_MODE].cid = V4L2_CID_FLASH_LED_MODE;
362 ctrl_cfg = &ctrl_init_data[LED_MODE].config;
363 ctrl_cfg->id = V4L2_CID_FLASH_LED_MODE;
364 ctrl_cfg->max = V4L2_FLASH_LED_MODE_TORCH;
365 ctrl_cfg->menu_skip_mask = ~mask;
366 ctrl_cfg->def = V4L2_FLASH_LED_MODE_NONE;
367 ctrl_cfg->flags = 0;
368
369 /* Init TORCH_INTENSITY ctrl data */
370 ctrl_init_data[TORCH_INTENSITY].cid = V4L2_CID_FLASH_TORCH_INTENSITY;
371 ctrl_cfg = &ctrl_init_data[TORCH_INTENSITY].config;
372 __lfs_to_v4l2_ctrl_config(&flash_cfg->intensity, ctrl_cfg);
373 ctrl_cfg->id = V4L2_CID_FLASH_TORCH_INTENSITY;
374 ctrl_cfg->flags = V4L2_CTRL_FLAG_VOLATILE |
375 V4L2_CTRL_FLAG_EXECUTE_ON_WRITE;
376
377 /* Init FLASH_STROBE ctrl data */
378 ctrl_init_data[FLASH_STROBE].cid = V4L2_CID_FLASH_STROBE;
379 ctrl_cfg = &ctrl_init_data[FLASH_STROBE].config;
380 ctrl_cfg->id = V4L2_CID_FLASH_STROBE;
381
382 /* Init STROBE_STOP ctrl data */
383 ctrl_init_data[STROBE_STOP].cid = V4L2_CID_FLASH_STROBE_STOP;
384 ctrl_cfg = &ctrl_init_data[STROBE_STOP].config;
385 ctrl_cfg->id = V4L2_CID_FLASH_STROBE_STOP;
386
387 /* Init FLASH_STROBE_SOURCE ctrl data */
388 if (flash_cfg->has_external_strobe) {
389 mask = (1 << V4L2_FLASH_STROBE_SOURCE_SOFTWARE) |
390 (1 << V4L2_FLASH_STROBE_SOURCE_EXTERNAL);
391 ctrl_init_data[STROBE_SOURCE].cid =
392 V4L2_CID_FLASH_STROBE_SOURCE;
393 ctrl_cfg = &ctrl_init_data[STROBE_SOURCE].config;
394 ctrl_cfg->id = V4L2_CID_FLASH_STROBE_SOURCE;
395 ctrl_cfg->max = V4L2_FLASH_STROBE_SOURCE_EXTERNAL;
396 ctrl_cfg->menu_skip_mask = ~mask;
397 ctrl_cfg->def = V4L2_FLASH_STROBE_SOURCE_SOFTWARE;
398 }
399
400 /* Init STROBE_STATUS ctrl data */
401 if (has_flash_op(fled_cdev, strobe_get)) {
402 ctrl_init_data[STROBE_STATUS].cid =
403 V4L2_CID_FLASH_STROBE_STATUS;
404 ctrl_cfg = &ctrl_init_data[STROBE_STATUS].config;
405 ctrl_cfg->id = V4L2_CID_FLASH_STROBE_STATUS;
406 ctrl_cfg->flags = V4L2_CTRL_FLAG_VOLATILE |
407 V4L2_CTRL_FLAG_READ_ONLY;
408 }
409
410 /* Init FLASH_TIMEOUT ctrl data */
411 if (has_flash_op(fled_cdev, timeout_set)) {
412 ctrl_init_data[FLASH_TIMEOUT].cid = V4L2_CID_FLASH_TIMEOUT;
413 ctrl_cfg = &ctrl_init_data[FLASH_TIMEOUT].config;
414 __lfs_to_v4l2_ctrl_config(&fled_cdev->timeout, ctrl_cfg);
415 ctrl_cfg->id = V4L2_CID_FLASH_TIMEOUT;
416 }
417
418 /* Init FLASH_INTENSITY ctrl data */
419 if (has_flash_op(fled_cdev, flash_brightness_set)) {
420 ctrl_init_data[FLASH_INTENSITY].cid = V4L2_CID_FLASH_INTENSITY;
421 ctrl_cfg = &ctrl_init_data[FLASH_INTENSITY].config;
422 __lfs_to_v4l2_ctrl_config(&fled_cdev->brightness, ctrl_cfg);
423 ctrl_cfg->id = V4L2_CID_FLASH_INTENSITY;
424 ctrl_cfg->flags = V4L2_CTRL_FLAG_VOLATILE |
425 V4L2_CTRL_FLAG_EXECUTE_ON_WRITE;
426 }
427 }
428
v4l2_flash_init_controls(struct v4l2_flash * v4l2_flash,struct v4l2_flash_config * flash_cfg)429 static int v4l2_flash_init_controls(struct v4l2_flash *v4l2_flash,
430 struct v4l2_flash_config *flash_cfg)
431
432 {
433 struct v4l2_flash_ctrl_data *ctrl_init_data;
434 struct v4l2_ctrl *ctrl;
435 struct v4l2_ctrl_config *ctrl_cfg;
436 int i, ret, num_ctrls = 0;
437
438 v4l2_flash->ctrls = devm_kcalloc(v4l2_flash->sd.dev,
439 STROBE_SOURCE + 1,
440 sizeof(*v4l2_flash->ctrls),
441 GFP_KERNEL);
442 if (!v4l2_flash->ctrls)
443 return -ENOMEM;
444
445 /* allocate memory dynamically so as not to exceed stack frame size */
446 ctrl_init_data = kzalloc_objs(*ctrl_init_data, NUM_FLASH_CTRLS);
447 if (!ctrl_init_data)
448 return -ENOMEM;
449
450 __fill_ctrl_init_data(v4l2_flash, flash_cfg, ctrl_init_data);
451
452 for (i = 0; i < NUM_FLASH_CTRLS; ++i)
453 if (ctrl_init_data[i].cid)
454 ++num_ctrls;
455
456 v4l2_ctrl_handler_init(&v4l2_flash->hdl, num_ctrls);
457
458 for (i = 0; i < NUM_FLASH_CTRLS; ++i) {
459 ctrl_cfg = &ctrl_init_data[i].config;
460 if (!ctrl_init_data[i].cid)
461 continue;
462
463 if (ctrl_cfg->id == V4L2_CID_FLASH_LED_MODE ||
464 ctrl_cfg->id == V4L2_CID_FLASH_STROBE_SOURCE)
465 ctrl = v4l2_ctrl_new_std_menu(&v4l2_flash->hdl,
466 &v4l2_flash_ctrl_ops,
467 ctrl_cfg->id,
468 ctrl_cfg->max,
469 ctrl_cfg->menu_skip_mask,
470 ctrl_cfg->def);
471 else
472 ctrl = v4l2_ctrl_new_std(&v4l2_flash->hdl,
473 &v4l2_flash_ctrl_ops,
474 ctrl_cfg->id,
475 ctrl_cfg->min,
476 ctrl_cfg->max,
477 ctrl_cfg->step,
478 ctrl_cfg->def);
479
480 if (ctrl)
481 ctrl->flags |= ctrl_cfg->flags;
482
483 if (i <= STROBE_SOURCE)
484 v4l2_flash->ctrls[i] = ctrl;
485 }
486
487 kfree(ctrl_init_data);
488
489 if (v4l2_flash->hdl.error) {
490 ret = v4l2_flash->hdl.error;
491 goto error_free_handler;
492 }
493
494 v4l2_ctrl_handler_setup(&v4l2_flash->hdl);
495
496 v4l2_flash->sd.ctrl_handler = &v4l2_flash->hdl;
497
498 return 0;
499
500 error_free_handler:
501 v4l2_ctrl_handler_free(&v4l2_flash->hdl);
502 return ret;
503 }
504
__sync_device_with_v4l2_controls(struct v4l2_flash * v4l2_flash)505 static int __sync_device_with_v4l2_controls(struct v4l2_flash *v4l2_flash)
506 {
507 struct led_classdev_flash *fled_cdev = v4l2_flash->fled_cdev;
508 struct v4l2_ctrl **ctrls = v4l2_flash->ctrls;
509 int ret = 0;
510
511 if (ctrls[TORCH_INTENSITY]) {
512 ret = v4l2_flash_set_led_brightness(v4l2_flash,
513 ctrls[TORCH_INTENSITY]);
514 if (ret < 0)
515 return ret;
516 }
517
518 if (ctrls[INDICATOR_INTENSITY]) {
519 ret = v4l2_flash_set_led_brightness(v4l2_flash,
520 ctrls[INDICATOR_INTENSITY]);
521 if (ret < 0)
522 return ret;
523 }
524
525 if (ctrls[FLASH_TIMEOUT]) {
526 if (WARN_ON_ONCE(!fled_cdev))
527 return -EINVAL;
528
529 ret = led_set_flash_timeout(fled_cdev,
530 ctrls[FLASH_TIMEOUT]->val);
531 if (ret < 0)
532 return ret;
533 }
534
535 if (ctrls[FLASH_INTENSITY]) {
536 if (WARN_ON_ONCE(!fled_cdev))
537 return -EINVAL;
538
539 ret = led_set_flash_brightness(fled_cdev,
540 ctrls[FLASH_INTENSITY]->val);
541 if (ret < 0)
542 return ret;
543 }
544
545 /*
546 * For some hardware arrangements setting strobe source may affect
547 * torch mode. Synchronize strobe source setting only if not in torch
548 * mode. For torch mode case it will get synchronized upon switching
549 * to flash mode.
550 */
551 if (ctrls[STROBE_SOURCE] &&
552 ctrls[LED_MODE]->val != V4L2_FLASH_LED_MODE_TORCH)
553 ret = call_flash_op(v4l2_flash, external_strobe_set,
554 ctrls[STROBE_SOURCE]->val);
555
556 return ret;
557 }
558
559 /*
560 * V4L2 subdev internal operations
561 */
562
v4l2_flash_open(struct v4l2_subdev * sd,struct v4l2_subdev_fh * fh)563 static int v4l2_flash_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
564 {
565 struct v4l2_flash *v4l2_flash = v4l2_subdev_to_v4l2_flash(sd);
566 struct led_classdev_flash *fled_cdev = v4l2_flash->fled_cdev;
567 struct led_classdev *led_cdev = fled_cdev ? &fled_cdev->led_cdev : NULL;
568 struct led_classdev *led_cdev_ind = v4l2_flash->iled_cdev;
569 int ret = 0;
570
571 if (!v4l2_fh_is_singular(&fh->vfh))
572 return 0;
573
574 if (led_cdev) {
575 mutex_lock(&led_cdev->led_access);
576
577 led_sysfs_disable(led_cdev);
578 led_trigger_remove(led_cdev);
579
580 mutex_unlock(&led_cdev->led_access);
581 }
582
583 if (led_cdev_ind) {
584 mutex_lock(&led_cdev_ind->led_access);
585
586 led_sysfs_disable(led_cdev_ind);
587 led_trigger_remove(led_cdev_ind);
588
589 mutex_unlock(&led_cdev_ind->led_access);
590 }
591
592 ret = __sync_device_with_v4l2_controls(v4l2_flash);
593 if (ret < 0)
594 goto out_sync_device;
595
596 return 0;
597 out_sync_device:
598 if (led_cdev) {
599 mutex_lock(&led_cdev->led_access);
600 led_sysfs_enable(led_cdev);
601 mutex_unlock(&led_cdev->led_access);
602 }
603
604 if (led_cdev_ind) {
605 mutex_lock(&led_cdev_ind->led_access);
606 led_sysfs_enable(led_cdev_ind);
607 mutex_unlock(&led_cdev_ind->led_access);
608 }
609
610 return ret;
611 }
612
v4l2_flash_close(struct v4l2_subdev * sd,struct v4l2_subdev_fh * fh)613 static int v4l2_flash_close(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
614 {
615 struct v4l2_flash *v4l2_flash = v4l2_subdev_to_v4l2_flash(sd);
616 struct led_classdev_flash *fled_cdev = v4l2_flash->fled_cdev;
617 struct led_classdev *led_cdev = fled_cdev ? &fled_cdev->led_cdev : NULL;
618 struct led_classdev *led_cdev_ind = v4l2_flash->iled_cdev;
619 int ret = 0;
620
621 if (!v4l2_fh_is_singular(&fh->vfh))
622 return 0;
623
624 if (led_cdev) {
625 mutex_lock(&led_cdev->led_access);
626
627 if (v4l2_flash->ctrls[STROBE_SOURCE])
628 ret = v4l2_ctrl_s_ctrl(
629 v4l2_flash->ctrls[STROBE_SOURCE],
630 V4L2_FLASH_STROBE_SOURCE_SOFTWARE);
631 led_sysfs_enable(led_cdev);
632
633 mutex_unlock(&led_cdev->led_access);
634 }
635
636 if (led_cdev_ind) {
637 mutex_lock(&led_cdev_ind->led_access);
638 led_sysfs_enable(led_cdev_ind);
639 mutex_unlock(&led_cdev_ind->led_access);
640 }
641
642 return ret;
643 }
644
645 static const struct v4l2_subdev_internal_ops v4l2_flash_subdev_internal_ops = {
646 .open = v4l2_flash_open,
647 .close = v4l2_flash_close,
648 };
649
650 static const struct v4l2_subdev_ops v4l2_flash_subdev_ops;
651
__v4l2_flash_init(struct device * dev,struct fwnode_handle * fwn,struct led_classdev_flash * fled_cdev,struct led_classdev * iled_cdev,const struct v4l2_flash_ops * ops,struct v4l2_flash_config * config)652 static struct v4l2_flash *__v4l2_flash_init(
653 struct device *dev, struct fwnode_handle *fwn,
654 struct led_classdev_flash *fled_cdev, struct led_classdev *iled_cdev,
655 const struct v4l2_flash_ops *ops, struct v4l2_flash_config *config)
656 {
657 struct v4l2_flash *v4l2_flash;
658 struct v4l2_subdev *sd;
659 int ret;
660
661 if (!config)
662 return ERR_PTR(-EINVAL);
663
664 v4l2_flash = devm_kzalloc(dev, sizeof(*v4l2_flash), GFP_KERNEL);
665 if (!v4l2_flash)
666 return ERR_PTR(-ENOMEM);
667
668 sd = &v4l2_flash->sd;
669 v4l2_flash->fled_cdev = fled_cdev;
670 v4l2_flash->iled_cdev = iled_cdev;
671 v4l2_flash->ops = ops;
672 sd->dev = dev;
673 sd->fwnode = fwn ? fwn : dev_fwnode(dev);
674 v4l2_subdev_init(sd, &v4l2_flash_subdev_ops);
675 sd->internal_ops = &v4l2_flash_subdev_internal_ops;
676 sd->flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
677 strscpy(sd->name, config->dev_name, sizeof(sd->name));
678
679 ret = media_entity_pads_init(&sd->entity, 0, NULL);
680 if (ret < 0)
681 return ERR_PTR(ret);
682
683 sd->entity.function = MEDIA_ENT_F_FLASH;
684
685 ret = v4l2_flash_init_controls(v4l2_flash, config);
686 if (ret < 0)
687 goto err_init_controls;
688
689 fwnode_handle_get(sd->fwnode);
690
691 ret = v4l2_async_register_subdev(sd);
692 if (ret < 0)
693 goto err_async_register_sd;
694
695 return v4l2_flash;
696
697 err_async_register_sd:
698 fwnode_handle_put(sd->fwnode);
699 v4l2_ctrl_handler_free(sd->ctrl_handler);
700 err_init_controls:
701 media_entity_cleanup(&sd->entity);
702
703 return ERR_PTR(ret);
704 }
705
v4l2_flash_init(struct device * dev,struct fwnode_handle * fwn,struct led_classdev_flash * fled_cdev,const struct v4l2_flash_ops * ops,struct v4l2_flash_config * config)706 struct v4l2_flash *v4l2_flash_init(
707 struct device *dev, struct fwnode_handle *fwn,
708 struct led_classdev_flash *fled_cdev,
709 const struct v4l2_flash_ops *ops,
710 struct v4l2_flash_config *config)
711 {
712 return __v4l2_flash_init(dev, fwn, fled_cdev, NULL, ops, config);
713 }
714 EXPORT_SYMBOL_GPL(v4l2_flash_init);
715
v4l2_flash_indicator_init(struct device * dev,struct fwnode_handle * fwn,struct led_classdev * iled_cdev,struct v4l2_flash_config * config)716 struct v4l2_flash *v4l2_flash_indicator_init(
717 struct device *dev, struct fwnode_handle *fwn,
718 struct led_classdev *iled_cdev,
719 struct v4l2_flash_config *config)
720 {
721 return __v4l2_flash_init(dev, fwn, NULL, iled_cdev, NULL, config);
722 }
723 EXPORT_SYMBOL_GPL(v4l2_flash_indicator_init);
724
v4l2_flash_release(struct v4l2_flash * v4l2_flash)725 void v4l2_flash_release(struct v4l2_flash *v4l2_flash)
726 {
727 struct v4l2_subdev *sd;
728
729 if (IS_ERR_OR_NULL(v4l2_flash))
730 return;
731
732 sd = &v4l2_flash->sd;
733
734 v4l2_async_unregister_subdev(sd);
735
736 fwnode_handle_put(sd->fwnode);
737
738 v4l2_ctrl_handler_free(sd->ctrl_handler);
739 media_entity_cleanup(&sd->entity);
740 }
741 EXPORT_SYMBOL_GPL(v4l2_flash_release);
742
743 MODULE_AUTHOR("Jacek Anaszewski <j.anaszewski@samsung.com>");
744 MODULE_DESCRIPTION("V4L2 Flash sub-device helpers");
745 MODULE_LICENSE("GPL v2");
746