drivers/media/v4l2-core/v4l2-flash-led-class.c

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