include/linux/led-class-multicolor.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /* LED Multicolor class interface
   3  * Copyright (C) 2019-20 Texas Instruments Incorporated - http://www.ti.com/
   4  */
   5
   6 #ifndef _LINUX_MULTICOLOR_LEDS_H_INCLUDED
   7 #define _LINUX_MULTICOLOR_LEDS_H_INCLUDED
   8
   9 #include <linux/leds.h>
  10 #include <dt-bindings/leds/common.h>
  11
  12 struct mc_subled {
  13         unsigned int color_index;
  14         unsigned int brightness;
  15         unsigned int intensity;
  16         unsigned int channel;
  17 };
  18
  19 struct led_classdev_mc {
  20         /* led class device */
  21         struct led_classdev led_cdev;
  22         unsigned int num_colors;
  23
  24         struct mc_subled *subled_info;
  25 };
  26
  27 static inline struct led_classdev_mc *lcdev_to_mccdev(
  28                                                 struct led_classdev *led_cdev)
  29 {
  30         return container_of(led_cdev, struct led_classdev_mc, led_cdev);
  31 }
  32
  33 #if IS_ENABLED(CONFIG_LEDS_CLASS_MULTICOLOR)
  34 /**
  35  * led_classdev_multicolor_register_ext - register a new object of led_classdev
  36  *                                    class with support for multicolor LEDs
  37  * @parent: the multicolor LED to register
  38  * @mcled_cdev: the led_classdev_mc structure for this device
  39  * @init_data: the LED class multicolor device initialization data
  40  *
  41  * Returns: 0 on success or negative error value on failure
  42  */
  43 int led_classdev_multicolor_register_ext(struct device *parent,
  44                                             struct led_classdev_mc *mcled_cdev,
  45                                             struct led_init_data *init_data);
  46
  47 /**
  48  * led_classdev_multicolor_unregister - unregisters an object of led_classdev
  49  *                                      class with support for multicolor LEDs
  50  * @mcled_cdev: the multicolor LED to unregister
  51  *
  52  * Unregister a previously registered via led_classdev_multicolor_register
  53  * object
  54  */
  55 void led_classdev_multicolor_unregister(struct led_classdev_mc *mcled_cdev);
  56
  57 /* Calculate brightness for the monochrome LED cluster */
  58 int led_mc_calc_color_components(struct led_classdev_mc *mcled_cdev,
  59                                  enum led_brightness brightness);
  60
  61 int devm_led_classdev_multicolor_register_ext(struct device *parent,
  62                                           struct led_classdev_mc *mcled_cdev,
  63                                           struct led_init_data *init_data);
  64
  65 void devm_led_classdev_multicolor_unregister(struct device *parent,
  66                                             struct led_classdev_mc *mcled_cdev);
  67 #else
  68
  69 static inline int led_classdev_multicolor_register_ext(struct device *parent,
  70                                             struct led_classdev_mc *mcled_cdev,
  71                                             struct led_init_data *init_data)
  72 {
  73         return 0;
  74 }
  75
  76 static inline void led_classdev_multicolor_unregister(struct led_classdev_mc *mcled_cdev) {};
  77 static inline int led_mc_calc_color_components(struct led_classdev_mc *mcled_cdev,
  78                                                enum led_brightness brightness)
  79 {
  80         return 0;
  81 }
  82
  83 static inline int devm_led_classdev_multicolor_register_ext(struct device *parent,
  84                                           struct led_classdev_mc *mcled_cdev,
  85                                           struct led_init_data *init_data)
  86 {
  87         return 0;
  88 }
  89
  90 static inline void devm_led_classdev_multicolor_unregister(struct device *parent,
  91                                             struct led_classdev_mc *mcled_cdev)
  92 {};
  93
  94 #endif  /* IS_ENABLED(CONFIG_LEDS_CLASS_MULTICOLOR) */
  95
  96 static inline int led_classdev_multicolor_register(struct device *parent,
  97                                             struct led_classdev_mc *mcled_cdev)
  98 {
  99         return led_classdev_multicolor_register_ext(parent, mcled_cdev, NULL);
 100 }
 101
 102 static inline int devm_led_classdev_multicolor_register(struct device *parent,
 103                                              struct led_classdev_mc *mcled_cdev)
 104 {
 105         return devm_led_classdev_multicolor_register_ext(parent, mcled_cdev,
 106                                                          NULL);
 107 }
 108
 109 #endif  /* _LINUX_MULTICOLOR_LEDS_H_INCLUDED */