| Message ID | 20190114211723.11186-2-dmurphy@ti.com |
|---|---|
| State | New |
| Headers | show |
| Series | None | expand |
Hi! ..snip. Let me read it and reply when I have a time. > > You know what? First, submit driver with similar functionality to > > existing RGB drivers, using same interface existing drivers are > > using. When that is accepted, we can talk about extending > > kernel<->user interfaces. > > > > I could do that but then there is no way for users to have any other color but "white" with this driver. > That defeats the purpose of the device itself. No, that is not what I meant. We do have RGB drivers in tree, they just present three separate LEDs -- red, green and blue. I ask you to do the same for initial submission. You'll still be able to set brightness independently on the red/green/blue LEDs... > I am not sure if you are aware of this or care but I found this recent blog on this effort: > https://www.phoronix.com/scan.php?page=news_item&px=Linux-RGB-LED-Interface > See some of the comments. I went through the comments quickly, but see nothing really interesting. Best regards, Pavel -- (english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html
Hi! > >Moreover, I think that RGB LED class with configurable > >brightness-model, and with possible color range adjustments via > >icc-profiles or something similar, is the best solution that has been > >proposed so far. It is just flexible. > > > >I'd like to capitalize on the ideas shared in this thread and have > >finally LED RGB class materialized. > > > > I have now updated my github code with my understanding of the discussion: > https://github.com/vesajaaskelainen/linux/tree/wip-multi-color-led > > Commits: > - dt-bindings: leds: Introduce linux,default-brightness-model for all leds > https://github.com/vesajaaskelainen/linux/commit/4ffb21d644056686096226bbede7c8c78b0254c2 > - drivers: leds: Add core support for multi color element LEDs > https://github.com/vesajaaskelainen/linux/commit/627f38bb78cebc694b8e6d735fb088c87925435d > - dt-bindings: leds: leds-pwm: Introduce multi color element leds support > https://github.com/vesajaaskelainen/linux/commit/ef6c5730d621e79ea0b02470caa83bc39439536a > - WIP: drivers: leds: leds-pwm: Add multi color element LED support. > https://github.com/vesajaaskelainen/linux/commit/0430a27823d9162926424b32c23be1c53eb9cbe2 > > First two commits are common and could be taken before I am happy with the > pwm led driver changes. This new conditional feature flag makes it a bit > harder. Of course one option would be to require it to be enabled. > > Current set of concepts: > - brightness-model: hardware, onoff, linear > - could be extended in future with other modes like hsv if wanted Would it be enough to tell userspace what is relation between values it writes and output power? Onoff is subset of linear, I guess. We already have max_brightness in the API. > # Setting up color to not so bright purple with brightness set to 255 > $ echo "32 0 32 255" > color > # Setting up color to a bit brighter purple with brightness > $ echo "128 0 128 255" > color This would require colorspace conversion in kernel. I have: scales = (1., 0.39, 0.11) # for n900 val = map(lambda x: int((x**2.2)*255), val) (r, g, b) = val (r_, g_, b_) = m.scales red = r*r_ ... x**2.2 is simplified, real expression is more complex. But it is floating point math... Do we want to do that? Pavel -- (english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html
Jacek Replying to code comments. On 1/15/19 3:47 PM, Jacek Anaszewski wrote: > Hi Da, > > Thank you for the v2. > I will probably submit v3 outside the realm of the multi color framework. We can always convert as Pavel pointed out. > I have some remarks below. > > On 1/14/19 10:17 PM, Dan Murphy wrote: >> Introduce the LP5036/30/24/18 RGB LED driver. >> The difference in these parts are the number of >> LED outputs where the: >> >> LP5036 can control 36 LEDs >> LP5030 can control 30 LEDs >> LP5024 can control 24 LEDs >> LP5018 can control 18 LEDs >> >> The device has the ability to group LED output into control banks >> so that multiple LED banks can be controlled with the same mixing and >> brightness. Inversely the LEDs can also be controlled independently. >> >> Signed-off-by: Dan Murphy <dmurphy@ti.com> >> --- >> >> v2 - Changed the mix and module files to a single "color" file, added the LP5030 >> and LP5036 register mapping, added ABI documentation, updated the parsing of >> DT and led sources to match DT, renamed driver to leds-lp50xx.c - https://lore.kernel.org/patchwork/patch/1026515/ >> >> Documentation/leds/leds-lp50xx.txt | 36 ++ >> drivers/leds/Kconfig | 7 + >> drivers/leds/Makefile | 1 + >> drivers/leds/leds-lp50xx.c | 754 +++++++++++++++++++++++++++++ >> 4 files changed, 798 insertions(+) >> create mode 100644 Documentation/leds/leds-lp50xx.txt >> create mode 100644 drivers/leds/leds-lp50xx.c >> >> diff --git a/Documentation/leds/leds-lp50xx.txt b/Documentation/leds/leds-lp50xx.txt > > Please move it to > > Documentation/ABI/testing/sysfs-class-led-driver-lp50xx > > and use standard ABI documentation format. > Ack. I will add this file as well per the doc format. > >> new file mode 100644 >> index 000000000000..8b1b01dfdd22 >> --- /dev/null >> +++ b/Documentation/leds/leds-lp50xx.txt >> @@ -0,0 +1,36 @@ >> +LP5018/LP5024/LP5030/LP5036 Common Driver >> +================================================= >> + >> +Authors: Dan Murphy <dmurphy@ti.com> >> + >> +Description >> +----------- >> +The LP50XX RGB LED drivers have the ability to group multiple RGB cluster >> +LEDs into a single group for simultaneous control or expose single RGB cluster >> +for control. This device exposes different register interfaces to control >> +the cluster brightness as well as the individual RGB LEDs color intensity. >> + >> +RGB Cluster Color Control >> +------------------------- >> +The LP50xx driver will expose a file called "color" for each LED class instance >> +defined. This file will accept a 24-bit RGB value in which the the color of the >> +RGB LEDs will be set. >> + >> +The 24-bit RGB value passed in follows the pattern 0xXXRRGGBB >> +XX - Do not care ignored by the driver >> +RR - is the 8 bit Red LED value >> +GG - is the 8 bit Green LED value >> +BB - is the 8 bit Blue LED value >> + >> +Example: >> +LED module output 4 of the LP5024 will be a yellow color: >> +echo 0xe6de00 > /sys/class/leds/lp5024\:led4_mod/color >> + >> +LED module output 4 of the LP5024 will be dimmed 50%: >> +echo 0x80 > /sys/class/leds/lp5024\:led4_mod/brightness >> + >> +LED banked RGBs of the LP5036 will be a white color: >> +echo 0xffffff > /sys/class/leds/lp5036\:led_banked/color > > This part with example cans remain in Documentation/leds if you like. > >> + >> +LED banked RGBs of the LP50364 will be dimmed 50%: >> +echo 0x80 > /sys/class/leds/lp5036\:led_banked/brightness >> diff --git a/drivers/leds/Kconfig b/drivers/leds/Kconfig >> index a72f97fca57b..5f413445a667 100644 >> --- a/drivers/leds/Kconfig >> +++ b/drivers/leds/Kconfig >> @@ -326,6 +326,13 @@ config LEDS_LP3952 >> To compile this driver as a module, choose M here: the >> module will be called leds-lp3952. >> +config LEDS_LP50XX >> + tristate "LED Support for TI LP5036/30/24/18 LED driver chip" >> + depends on LEDS_CLASS && REGMAP_I2C >> + help >> + If you say yes here you get support for the Texas Instruments >> + LP5036, LP5030, LP5024 and LP5018 LED driver. >> + >> config LEDS_LP55XX_COMMON >> tristate "Common Driver for TI/National LP5521/5523/55231/5562/8501" >> depends on LEDS_LP5521 || LEDS_LP5523 || LEDS_LP5562 || LEDS_LP8501 >> diff --git a/drivers/leds/Makefile b/drivers/leds/Makefile >> index 4c1b0054f379..852eff0b773f 100644 >> --- a/drivers/leds/Makefile >> +++ b/drivers/leds/Makefile >> @@ -32,6 +32,7 @@ obj-$(CONFIG_LEDS_GPIO_REGISTER) += leds-gpio-register.o >> obj-$(CONFIG_LEDS_GPIO) += leds-gpio.o >> obj-$(CONFIG_LEDS_LP3944) += leds-lp3944.o >> obj-$(CONFIG_LEDS_LP3952) += leds-lp3952.o >> +obj-$(CONFIG_LEDS_LP50XX) += leds-lp50xx.o >> obj-$(CONFIG_LEDS_LP55XX_COMMON) += leds-lp55xx-common.o >> obj-$(CONFIG_LEDS_LP5521) += leds-lp5521.o >> obj-$(CONFIG_LEDS_LP5523) += leds-lp5523.o >> diff --git a/drivers/leds/leds-lp50xx.c b/drivers/leds/leds-lp50xx.c >> new file mode 100644 >> index 000000000000..41bb2e0129c8 >> --- /dev/null >> +++ b/drivers/leds/leds-lp50xx.c >> @@ -0,0 +1,754 @@ >> +// SPDX-License-Identifier: GPL-2.0 >> +/* TI LP50XX LED chip family driver >> + * Copyright (C) 2018 Texas Instruments Incorporated - http://www.ti.com/ >> + */ > > Let's use uniform "//" comment style here. Ack > >> +#include <linux/gpio/consumer.h> >> +#include <linux/i2c.h> >> +#include <linux/init.h> >> +#include <linux/leds.h> >> +#include <linux/module.h> >> +#include <linux/mutex.h> >> +#include <linux/of.h> >> +#include <linux/of_gpio.h> >> +#include <linux/regmap.h> >> +#include <linux/regulator/consumer.h> >> +#include <linux/slab.h> >> +#include <uapi/linux/uleds.h> >> + >> +#define LP50XX_DEV_CFG0 0x00 >> +#define LP50XX_DEV_CFG1 0x01 >> +#define LP50XX_LED_CFG0 0x02 >> + >> +/* LP5018 and LP5024 registers */ >> +#define LP5024_BNK_BRT 0x03 >> +#define LP5024_BNKA_CLR 0x04 >> +#define LP5024_BNKB_CLR 0x05 >> +#define LP5024_BNKC_CLR 0x06 >> +#define LP5024_LED0_BRT 0x07 >> +#define LP5024_LED1_BRT 0x08 >> +#define LP5024_LED2_BRT 0x09 >> +#define LP5024_LED3_BRT 0x0a >> +#define LP5024_LED4_BRT 0x0b >> +#define LP5024_LED5_BRT 0x0c >> +#define LP5024_LED6_BRT 0x0d >> +#define LP5024_LED7_BRT 0x0e >> + >> +#define LP5024_OUT0_CLR 0x0f >> +#define LP5024_OUT1_CLR 0x10 >> +#define LP5024_OUT2_CLR 0x11 >> +#define LP5024_OUT3_CLR 0x12 >> +#define LP5024_OUT4_CLR 0x13 >> +#define LP5024_OUT5_CLR 0x14 >> +#define LP5024_OUT6_CLR 0x15 >> +#define LP5024_OUT7_CLR 0x16 >> +#define LP5024_OUT8_CLR 0x17 >> +#define LP5024_OUT9_CLR 0x18 >> +#define LP5024_OUT10_CLR 0x19 >> +#define LP5024_OUT11_CLR 0x1a >> +#define LP5024_OUT12_CLR 0x1b >> +#define LP5024_OUT13_CLR 0x1c >> +#define LP5024_OUT14_CLR 0x1d >> +#define LP5024_OUT15_CLR 0x1e >> +#define LP5024_OUT16_CLR 0x1f >> +#define LP5024_OUT17_CLR 0x20 >> +#define LP5024_OUT18_CLR 0x21 >> +#define LP5024_OUT19_CLR 0x22 >> +#define LP5024_OUT20_CLR 0x23 >> +#define LP5024_OUT21_CLR 0x24 >> +#define LP5024_OUT22_CLR 0x25 >> +#define LP5024_OUT23_CLR 0x26 >> +#define LP5024_RESET 0x27 >> + >> +/* LP5030 and LP5036 registers */ >> +#define LP5036_LED_CFG1 0x03 >> +#define LP5036_BNK_BRT 0x04 >> +#define LP5036_BNKA_CLR 0x05 >> +#define LP5036_BNKB_CLR 0x06 >> +#define LP5036_BNKC_CLR 0x07 >> +#define LP5036_LED0_BRT 0x08 >> +#define LP5036_LED1_BRT 0x09 >> +#define LP5036_LED2_BRT 0x0a >> +#define LP5036_LED3_BRT 0x0b >> +#define LP5036_LED4_BRT 0x0c >> +#define LP5036_LED5_BRT 0x0d >> +#define LP5036_LED6_BRT 0x0e >> +#define LP5036_LED7_BRT 0x0f >> +#define LP5036_LED8_BRT 0x10 >> +#define LP5036_LED9_BRT 0x11 >> +#define LP5036_LED10_BRT 0x12 >> +#define LP5036_LED11_BRT 0x13 >> + >> +#define LP5036_OUT0_CLR 0x14 >> +#define LP5036_OUT1_CLR 0x15 >> +#define LP5036_OUT2_CLR 0x16 >> +#define LP5036_OUT3_CLR 0x17 >> +#define LP5036_OUT4_CLR 0x18 >> +#define LP5036_OUT5_CLR 0x19 >> +#define LP5036_OUT6_CLR 0x1a >> +#define LP5036_OUT7_CLR 0x1b >> +#define LP5036_OUT8_CLR 0x1c >> +#define LP5036_OUT9_CLR 0x1d >> +#define LP5036_OUT10_CLR 0x1e >> +#define LP5036_OUT11_CLR 0x1f >> +#define LP5036_OUT12_CLR 0x20 >> +#define LP5036_OUT13_CLR 0x21 >> +#define LP5036_OUT14_CLR 0x22 >> +#define LP5036_OUT15_CLR 0x23 >> +#define LP5036_OUT16_CLR 0x24 >> +#define LP5036_OUT17_CLR 0x25 >> +#define LP5036_OUT18_CLR 0x26 >> +#define LP5036_OUT19_CLR 0x27 >> +#define LP5036_OUT20_CLR 0x28 >> +#define LP5036_OUT21_CLR 0x29 >> +#define LP5036_OUT22_CLR 0x2a >> +#define LP5036_OUT23_CLR 0x2b >> +#define LP5036_OUT24_CLR 0x2c >> +#define LP5036_OUT25_CLR 0x2d >> +#define LP5036_OUT26_CLR 0x2e >> +#define LP5036_OUT27_CLR 0x2f >> +#define LP5036_OUT28_CLR 0x30 >> +#define LP5036_OUT29_CLR 0x31 >> +#define LP5036_OUT30_CLR 0x32 >> +#define LP5036_OUT31_CLR 0x33 >> +#define LP5036_OUT32_CLR 0x34 >> +#define LP5036_OUT33_CLR 0x35 >> +#define LP5036_OUT34_CLR 0x36 >> +#define LP5036_OUT35_CLR 0x37 >> +#define LP5036_RESET 0x38 >> + >> +#define LP50XX_SW_RESET 0xff >> + >> +#define LP50XX_CHIP_EN BIT(6) >> + >> +#define LP5018_MAX_LED_STRINGS 6 >> +#define LP5024_MAX_LED_STRINGS 8 >> +#define LP5030_MAX_LED_STRINGS 10 >> +#define LP5036_MAX_LED_STRINGS 12 >> + >> +enum lp50xx_model { >> + LP5018, >> + LP5024, >> + LP5030, >> + LP5036, >> +}; >> + >> +struct lp50xx_led { >> + u32 led_strings[LP5036_MAX_LED_STRINGS]; > > It is possible to have only one bank, so this can be a property > of struct lp50xx. Moreover, it doesn't need to be an array, > but should be: > > unsigned long bank_modules; > > Then you will be able to use bitops on it, where bit position will > refer to the id of RGB LED module assigned to the bank. > ACK. Had to think a bit on this to make sure there was enough room but aligning on LEDn_MODULES/BANKS should be fine >> + char label[LED_MAX_NAME_SIZE]; >> + struct led_classdev led_dev; >> + struct lp50xx *priv; >> + int led_number; >> + u8 ctrl_bank_enabled; >> +}; >> + >> +/** >> + * struct lp50xx - >> + * @enable_gpio: Hardware enable gpio >> + * @regulator: LED supply regulator pointer >> + * @client: Pointer to the I2C client >> + * @regmap: Devices register map >> + * @dev: Pointer to the devices device struct >> + * @lock: Lock for reading/writing the device >> + * @model_id: ID of the device >> + * @leds: Array of LED strings > > Please don't use capital letters for property description. > Still, some of the properties below remain undocumented. > You are referring to ID and I2C or do you mean no capitals to start the description? Yes I added the properties and missed documenting them. >> + */ >> +struct lp50xx { >> + struct gpio_desc *enable_gpio; >> + struct regulator *regulator; >> + struct i2c_client *client; >> + struct regmap *regmap; >> + struct device *dev; >> + struct mutex lock; >> + enum lp50xx_model model_id; >> + int max_leds; >> + int num_of_leds; >> + >> + u8 led_brightness0_reg; >> + u8 mix_out0_reg; >> + u8 bank_brt_reg; >> + u8 bank_mix_reg; >> + u8 reset_reg; >> + >> + /* This needs to be at the end of the struct */ >> + struct lp50xx_led leds[]; >> +}; >> + >> +static const struct reg_default lp5024_reg_defs[] = { >> + {LP50XX_DEV_CFG0, 0x0}, >> + {LP50XX_DEV_CFG1, 0x3c}, >> + {LP50XX_LED_CFG0, 0x0}, >> + {LP5024_BNK_BRT, 0xff}, >> + {LP5024_BNKA_CLR, 0x0f}, >> + {LP5024_BNKB_CLR, 0x0f}, >> + {LP5024_BNKC_CLR, 0x0f}, >> + {LP5024_LED0_BRT, 0x0f}, >> + {LP5024_LED1_BRT, 0xff}, >> + {LP5024_LED2_BRT, 0xff}, >> + {LP5024_LED3_BRT, 0xff}, >> + {LP5024_LED4_BRT, 0xff}, >> + {LP5024_LED5_BRT, 0xff}, >> + {LP5024_LED6_BRT, 0xff}, >> + {LP5024_LED7_BRT, 0xff}, >> + {LP5024_OUT0_CLR, 0x0f}, >> + {LP5024_OUT1_CLR, 0x00}, >> + {LP5024_OUT2_CLR, 0x00}, >> + {LP5024_OUT3_CLR, 0x00}, >> + {LP5024_OUT4_CLR, 0x00}, >> + {LP5024_OUT5_CLR, 0x00}, >> + {LP5024_OUT6_CLR, 0x00}, >> + {LP5024_OUT7_CLR, 0x00}, >> + {LP5024_OUT8_CLR, 0x00}, >> + {LP5024_OUT9_CLR, 0x00}, >> + {LP5024_OUT10_CLR, 0x00}, >> + {LP5024_OUT11_CLR, 0x00}, >> + {LP5024_OUT12_CLR, 0x00}, >> + {LP5024_OUT13_CLR, 0x00}, >> + {LP5024_OUT14_CLR, 0x00}, >> + {LP5024_OUT15_CLR, 0x00}, >> + {LP5024_OUT16_CLR, 0x00}, >> + {LP5024_OUT17_CLR, 0x00}, >> + {LP5024_OUT18_CLR, 0x00}, >> + {LP5024_OUT19_CLR, 0x00}, >> + {LP5024_OUT20_CLR, 0x00}, >> + {LP5024_OUT21_CLR, 0x00}, >> + {LP5024_OUT22_CLR, 0x00}, >> + {LP5024_OUT23_CLR, 0x00}, >> + {LP5024_RESET, 0x00} >> +}; >> + >> +static const struct reg_default lp5036_reg_defs[] = { >> + {LP50XX_DEV_CFG0, 0x0}, >> + {LP50XX_DEV_CFG1, 0x3c}, >> + {LP50XX_LED_CFG0, 0x0}, >> + {LP5036_LED_CFG1, 0x0}, >> + {LP5036_BNK_BRT, 0xff}, >> + {LP5036_BNKA_CLR, 0x0f}, >> + {LP5036_BNKB_CLR, 0x0f}, >> + {LP5036_BNKC_CLR, 0x0f}, >> + {LP5036_LED0_BRT, 0x0f}, >> + {LP5036_LED1_BRT, 0xff}, >> + {LP5036_LED2_BRT, 0xff}, >> + {LP5036_LED3_BRT, 0xff}, >> + {LP5036_LED4_BRT, 0xff}, >> + {LP5036_LED5_BRT, 0xff}, >> + {LP5036_LED6_BRT, 0xff}, >> + {LP5036_LED7_BRT, 0xff}, >> + {LP5036_OUT0_CLR, 0x0f}, >> + {LP5036_OUT1_CLR, 0x00}, >> + {LP5036_OUT2_CLR, 0x00}, >> + {LP5036_OUT3_CLR, 0x00}, >> + {LP5036_OUT4_CLR, 0x00}, >> + {LP5036_OUT5_CLR, 0x00}, >> + {LP5036_OUT6_CLR, 0x00}, >> + {LP5036_OUT7_CLR, 0x00}, >> + {LP5036_OUT8_CLR, 0x00}, >> + {LP5036_OUT9_CLR, 0x00}, >> + {LP5036_OUT10_CLR, 0x00}, >> + {LP5036_OUT11_CLR, 0x00}, >> + {LP5036_OUT12_CLR, 0x00}, >> + {LP5036_OUT13_CLR, 0x00}, >> + {LP5036_OUT14_CLR, 0x00}, >> + {LP5036_OUT15_CLR, 0x00}, >> + {LP5036_OUT16_CLR, 0x00}, >> + {LP5036_OUT17_CLR, 0x00}, >> + {LP5036_OUT18_CLR, 0x00}, >> + {LP5036_OUT19_CLR, 0x00}, >> + {LP5036_OUT20_CLR, 0x00}, >> + {LP5036_OUT21_CLR, 0x00}, >> + {LP5036_OUT22_CLR, 0x00}, >> + {LP5036_OUT23_CLR, 0x00}, >> + {LP5036_OUT24_CLR, 0x00}, >> + {LP5036_OUT25_CLR, 0x00}, >> + {LP5036_OUT26_CLR, 0x00}, >> + {LP5036_OUT27_CLR, 0x00}, >> + {LP5036_OUT28_CLR, 0x00}, >> + {LP5036_OUT29_CLR, 0x00}, >> + {LP5036_OUT30_CLR, 0x00}, >> + {LP5036_OUT31_CLR, 0x00}, >> + {LP5036_OUT32_CLR, 0x00}, >> + {LP5036_OUT33_CLR, 0x00}, >> + {LP5036_OUT34_CLR, 0x00}, >> + {LP5036_OUT35_CLR, 0x00}, >> + {LP5036_RESET, 0x00} >> +}; >> + >> +static const struct regmap_config lp5024_regmap_config = { >> + .reg_bits = 8, >> + .val_bits = 8, >> + >> + .max_register = LP5024_RESET, >> + .reg_defaults = lp5024_reg_defs, >> + .num_reg_defaults = ARRAY_SIZE(lp5024_reg_defs), >> + .cache_type = REGCACHE_RBTREE, >> +}; >> + >> +static const struct regmap_config lp5036_regmap_config = { >> + .reg_bits = 8, >> + .val_bits = 8, >> + >> + .max_register = LP5036_RESET, >> + .reg_defaults = lp5036_reg_defs, >> + .num_reg_defaults = ARRAY_SIZE(lp5036_reg_defs), >> + .cache_type = REGCACHE_RBTREE, >> +}; >> + >> +static ssize_t color_show(struct device *dev, >> + struct device_attribute *attr, >> + char *buf) >> +{ >> + struct led_classdev *led_cdev = dev_get_drvdata(dev); >> + struct lp50xx_led *led = container_of(led_cdev, struct lp50xx_led, >> + led_dev); >> + struct lp50xx *priv = led->priv; >> + unsigned int red_val, green_val, blue_val; >> + u8 red_reg, green_reg, blue_reg; >> + u32 mix_value = 0; >> + u8 led_offset; >> + int ret; >> + >> + if (led->ctrl_bank_enabled) { >> + red_reg = priv->bank_mix_reg; >> + green_reg = priv->bank_mix_reg + 1; >> + blue_reg = priv->bank_mix_reg + 2; >> + } else { >> + led_offset = (led->led_number * 3); >> + red_reg = priv->mix_out0_reg + led_offset; >> + green_reg = priv->mix_out0_reg + led_offset + 1; >> + blue_reg = priv->mix_out0_reg + led_offset + 2; >> + } >> + >> + ret = regmap_read(priv->regmap, red_reg, &red_val); >> + if (ret) { >> + dev_err(&priv->client->dev, "Cannot read LED value\n"); >> + goto out; >> + } >> + >> + ret = regmap_read(priv->regmap, green_reg, &green_val); >> + if (ret) { >> + dev_err(&priv->client->dev, "Cannot read LED value\n"); >> + goto out; >> + } >> + >> + ret = regmap_read(priv->regmap, blue_reg, &blue_val); >> + if (ret) { >> + dev_err(&priv->client->dev, "Cannot read LED value\n"); >> + goto out; >> + } >> + >> + mix_value = (red_val << 16 | green_val << 8 | blue_val); >> + >> +out: >> + return scnprintf(buf, PAGE_SIZE, "0x%X\n", mix_value); >> +} >> + >> +static ssize_t color_store(struct device *dev, >> + struct device_attribute *attr, >> + const char *buf, size_t size) >> +{ >> + struct led_classdev *led_cdev = dev_get_drvdata(dev); >> + struct lp50xx_led *led = container_of(led_cdev, struct lp50xx_led, >> + led_dev); >> + struct lp50xx *priv = led->priv; >> + u8 led_offset; >> + unsigned long mix_value; >> + u8 red_reg, green_reg, blue_reg; >> + u8 red_val, green_val, blue_val; >> + int ret; >> + >> + ret = kstrtoul(buf, 0, &mix_value); >> + if (ret) >> + return ret; >> + >> + if (led->ctrl_bank_enabled) { >> + red_reg = priv->bank_mix_reg; >> + green_reg = priv->bank_mix_reg + 1; >> + blue_reg = priv->bank_mix_reg + 2; >> + } else { >> + led_offset = (led->led_number * 3); >> + red_reg = priv->mix_out0_reg + led_offset; >> + green_reg = priv->mix_out0_reg + led_offset + 1; >> + blue_reg = priv->mix_out0_reg + led_offset + 2; >> + } >> + >> + red_val = (mix_value & 0xff0000) >> 16; >> + green_val = (mix_value & 0xff00) >> 8; >> + blue_val = (mix_value & 0xff); > > I've been rather thinking about space separated list of decimal > "red green blue" values, but maybe this way it will be less > controversial. Let's if there will be other opinions. > Has anything changed based on this? Should I change the file name from "color" to something else? >> + >> + ret = regmap_write(priv->regmap, red_reg, red_val); >> + if (ret) { >> + dev_err(&priv->client->dev, "Cannot write LED value\n"); >> + goto out; >> + } >> + >> + ret = regmap_write(priv->regmap, green_reg, green_val); >> + if (ret) { >> + dev_err(&priv->client->dev, "Cannot write LED value\n"); >> + goto out; >> + } >> + >> + ret = regmap_write(priv->regmap, blue_reg, blue_val); >> + if (ret) { >> + dev_err(&priv->client->dev, "Cannot write LED value\n"); >> + goto out; >> + } >> +out: >> + return size; >> +} >> + >> +static DEVICE_ATTR_RW(color); >> + >> +static struct attribute *lp50xx_led_color_attrs[] = { >> + &dev_attr_color.attr, >> + NULL >> +}; >> +ATTRIBUTE_GROUPS(lp50xx_led_color); >> + >> +static int lp50xx_brightness_set(struct led_classdev *led_cdev, >> + enum led_brightness brt_val) >> +{ >> + struct lp50xx_led *led = container_of(led_cdev, struct lp50xx_led, >> + led_dev); >> + int ret = 0; >> + u8 reg_val; >> + >> + mutex_lock(&led->priv->lock); >> + >> + if (led->ctrl_bank_enabled) >> + reg_val = led->priv->bank_brt_reg; >> + else >> + reg_val = led->priv->led_brightness0_reg + led->led_number; >> + >> + ret = regmap_write(led->priv->regmap, reg_val, brt_val); >> + >> + mutex_unlock(&led->priv->lock); >> + >> + return ret; >> +} >> + >> +static enum led_brightness lp50xx_brightness_get(struct led_classdev *led_cdev) >> +{ >> + struct lp50xx_led *led = container_of(led_cdev, struct lp50xx_led, >> + led_dev); >> + unsigned int brt_val; >> + u8 reg_val; >> + int ret; >> + >> + mutex_lock(&led->priv->lock); >> + >> + if (led->ctrl_bank_enabled) >> + reg_val = led->priv->bank_brt_reg; >> + else >> + reg_val = led->priv->led_brightness0_reg + led->led_number; >> + >> + ret = regmap_read(led->priv->regmap, reg_val, &brt_val); >> + >> + mutex_unlock(&led->priv->lock); >> + >> + return brt_val; >> +} >> + >> +static void lp50xx_set_led_values(struct lp50xx *priv) >> +{ >> + if (priv->model_id == LP5018 || priv->model_id == LP5024) { >> + priv->led_brightness0_reg = LP5024_LED0_BRT; >> + priv->mix_out0_reg = LP5024_OUT0_CLR; >> + priv->bank_brt_reg = LP5024_BNK_BRT; >> + priv->bank_mix_reg = LP5024_BNKA_CLR; >> + priv->reset_reg = LP5024_RESET; >> + } else { >> + priv->led_brightness0_reg = LP5036_LED0_BRT; >> + priv->mix_out0_reg = LP5036_OUT0_CLR; >> + priv->bank_brt_reg = LP5036_BNK_BRT; >> + priv->bank_mix_reg = LP5036_BNKA_CLR; >> + priv->reset_reg = LP5036_RESET; >> + } >> +} >> + >> +static int lp50xx_set_banks(struct lp50xx *priv) >> +{ >> + struct lp50xx_led *led; >> + u8 led_ctrl_enable = 0; >> + u8 led1_ctrl_enable = 0; >> + u8 ctrl_ext = 0; >> + int i, j; >> + int ret; >> + >> + for (i = 0; i <= priv->num_of_leds; i++) { >> + led = &priv->leds[i]; >> + if (!led->ctrl_bank_enabled) >> + continue; >> + >> + for (j = 0; j <= priv->max_leds - 1; j++) { >> + if (led->led_strings[j] > (LP5024_MAX_LED_STRINGS - 1)) { >> + ctrl_ext = led->led_strings[j] - LP5024_MAX_LED_STRINGS; >> + led1_ctrl_enable |= (1 << ctrl_ext); >> + } else { >> + led_ctrl_enable |= (1 << led->led_strings[j]); >> + } >> + } >> + } > > With centralized bank_modules flags it should look simpler. > I don't think so. The LP5030 and LP5036 have 2 registers to denote Module vs banked. But once I convert it we will know. >> + >> + ret = regmap_write(priv->regmap, LP50XX_LED_CFG0, led_ctrl_enable); >> + >> + if (led1_ctrl_enable) >> + ret = regmap_write(priv->regmap, LP5036_LED_CFG1, >> + led1_ctrl_enable); >> + >> + return ret; >> +} >> + >> +static int lp50xx_init(struct lp50xx *priv) >> +{ >> + int ret; >> + >> + lp50xx_set_led_values(priv); >> + >> + if (priv->enable_gpio) { >> + gpiod_direction_output(priv->enable_gpio, 1); >> + } else { >> + ret = regmap_write(priv->regmap, priv->reset_reg, >> + LP50XX_SW_RESET); >> + if (ret) { >> + dev_err(&priv->client->dev, >> + "Cannot reset the device\n"); >> + goto out; >> + } >> + } >> + >> + ret = lp50xx_set_banks(priv); >> + if (ret) { >> + dev_err(&priv->client->dev, "Cannot set the banks\n"); >> + goto out; >> + } >> + >> + ret = regmap_write(priv->regmap, LP50XX_DEV_CFG0, LP50XX_CHIP_EN); >> + if (ret) >> + dev_err(&priv->client->dev, "Cannot write ctrl enable\n"); >> + >> +out: >> + return ret; >> +} >> + >> +static int lp50xx_probe_dt(struct lp50xx *priv) >> +{ >> + struct fwnode_handle *child = NULL; >> + struct lp50xx_led *led; >> + int control_bank_defined = 0; >> + const char *name; >> + int led_number; >> + size_t i = 0; >> + int ret; >> + >> + priv->enable_gpio = devm_gpiod_get_optional(&priv->client->dev, >> + "enable", GPIOD_OUT_LOW); >> + if (IS_ERR(priv->enable_gpio)) { >> + ret = PTR_ERR(priv->enable_gpio); >> + dev_err(&priv->client->dev, "Failed to get enable gpio: %d\n", >> + ret); >> + return ret; >> + } >> + >> + priv->regulator = devm_regulator_get(&priv->client->dev, "vled"); >> + if (IS_ERR(priv->regulator)) >> + priv->regulator = NULL; >> + >> + if (priv->model_id == LP5018) >> + priv->max_leds = LP5018_MAX_LED_STRINGS; >> + else if (priv->model_id == LP5024) >> + priv->max_leds = LP5024_MAX_LED_STRINGS; >> + else if (priv->model_id == LP5030) >> + priv->max_leds = LP5030_MAX_LED_STRINGS; >> + else >> + priv->max_leds = LP5036_MAX_LED_STRINGS; > > Let's change STRINGS to MODULEs. > ACK. >> + >> + device_for_each_child_node(&priv->client->dev, child) { >> + led = &priv->leds[i]; >> + >> + if (fwnode_property_present(child, "ti,led-bank")) { >> + led->ctrl_bank_enabled = 1; >> + if (!control_bank_defined) >> + control_bank_defined = 1; >> + else { >> + dev_err(&priv->client->dev, >> + "ti,led-bank defined twice\n"); >> + fwnode_handle_put(child); >> + goto child_out; >> + } >> + } else { >> + led->ctrl_bank_enabled = 0; >> + } > > Any bit set in bank_modules will signify that bank is defined > and enabled. > This is stored so that when the brightness or color is called the correct register either bank or LEDn_MODULES is used. This way I don't have to go out and read the devices bank enable register and try to determine what was banked and what was not. Dan >> + if (led->ctrl_bank_enabled) { >> + ret = fwnode_property_read_u32_array(child, >> + "ti,led-bank", >> + NULL, 0); >> + ret = fwnode_property_read_u32_array(child, >> + "ti,led-bank", >> + led->led_strings, >> + ret); >> + >> + led->led_number = led->led_strings[0]; >> + >> + } else { >> + ret = fwnode_property_read_u32(child, "ti,led-module", >> + &led_number); >> + >> + led->led_number = led_number; >> + } >> + if (ret) { >> + dev_err(&priv->client->dev, >> + "led sourcing property missing\n"); >> + fwnode_handle_put(child); >> + goto child_out; >> + } >> + >> + if (led_number > priv->max_leds) { >> + dev_err(&priv->client->dev, >> + "led-sources property is invalid\n"); >> + ret = -EINVAL; >> + fwnode_handle_put(child); >> + goto child_out; >> + } >> + >> + ret = fwnode_property_read_string(child, "label", &name); >> + if (ret) >> + snprintf(led->label, sizeof(led->label), >> + "%s::", priv->client->name); >> + else >> + snprintf(led->label, sizeof(led->label), >> + "%s:%s", priv->client->name, name); >> + >> + fwnode_property_read_string(child, "linux,default-trigger", >> + &led->led_dev.default_trigger); >> + >> + led->priv = priv; >> + led->led_dev.name = led->label; >> + led->led_dev.brightness_set_blocking = lp50xx_brightness_set; >> + led->led_dev.brightness_get = lp50xx_brightness_get; >> + led->led_dev.groups = lp50xx_led_color_groups; >> + >> + ret = devm_led_classdev_register(&priv->client->dev, >> + &led->led_dev); >> + if (ret) { >> + dev_err(&priv->client->dev, "led register err: %d\n", >> + ret); >> + fwnode_handle_put(child); >> + goto child_out; >> + } >> + i++; >> + } >> + priv->num_of_leds = i; >> + >> +child_out: >> + return ret; >> +} >> + >> +static int lp50xx_probe(struct i2c_client *client, >> + const struct i2c_device_id *id) >> +{ >> + struct lp50xx *led; >> + int count; >> + int ret; >> + >> + count = device_get_child_node_count(&client->dev); >> + if (!count) { >> + dev_err(&client->dev, "LEDs are not defined in device tree!"); >> + return -ENODEV; >> + } >> + >> + led = devm_kzalloc(&client->dev, struct_size(led, leds, count), >> + GFP_KERNEL); >> + if (!led) >> + return -ENOMEM; >> + >> + mutex_init(&led->lock); >> + led->client = client; >> + led->dev = &client->dev; >> + led->model_id = id->driver_data; >> + i2c_set_clientdata(client, led); >> + >> + if (led->model_id == LP5018 || led->model_id == LP5024) >> + led->regmap = devm_regmap_init_i2c(client, >> + &lp5024_regmap_config); >> + else >> + led->regmap = devm_regmap_init_i2c(client, >> + &lp5036_regmap_config); >> + >> + if (IS_ERR(led->regmap)) { >> + ret = PTR_ERR(led->regmap); >> + dev_err(&client->dev, "Failed to allocate register map: %d\n", >> + ret); >> + return ret; >> + } >> + >> + ret = lp50xx_probe_dt(led); >> + if (ret) >> + return ret; >> + >> + ret = lp50xx_init(led); >> + if (ret) >> + return ret; >> + >> + return 0; >> +} >> + >> +static int lp50xx_remove(struct i2c_client *client) >> +{ >> + struct lp50xx *led = i2c_get_clientdata(client); >> + int ret; >> + >> + ret = regmap_update_bits(led->regmap, LP50XX_DEV_CFG0, >> + LP50XX_CHIP_EN, 0); >> + if (ret) { >> + dev_err(&led->client->dev, "Failed to disable regulator\n"); >> + return ret; >> + } >> + >> + if (led->enable_gpio) >> + gpiod_direction_output(led->enable_gpio, 0); >> + >> + if (led->regulator) { >> + ret = regulator_disable(led->regulator); >> + if (ret) >> + dev_err(&led->client->dev, >> + "Failed to disable regulator\n"); >> + } >> + >> + mutex_destroy(&led->lock); >> + >> + return 0; >> +} >> + >> +static const struct i2c_device_id lp50xx_id[] = { >> + { "lp5018", LP5018 }, >> + { "lp5024", LP5024 }, >> + { "lp5030", LP5030 }, >> + { "lp5036", LP5036 }, >> + { } >> +}; >> +MODULE_DEVICE_TABLE(i2c, lp50xx_id); >> + >> +static const struct of_device_id of_lp50xx_leds_match[] = { >> + { .compatible = "ti,lp5018", }, >> + { .compatible = "ti,lp5024", }, >> + { .compatible = "ti,lp5030", }, >> + { .compatible = "ti,lp5036", }, >> + {}, >> +}; >> +MODULE_DEVICE_TABLE(of, of_lp50xx_leds_match); >> + >> +static struct i2c_driver lp50xx_driver = { >> + .driver = { >> + .name = "lp50xx", >> + .of_match_table = of_lp50xx_leds_match, >> + }, >> + .probe = lp50xx_probe, >> + .remove = lp50xx_remove, >> + .id_table = lp50xx_id, >> +}; >> +module_i2c_driver(lp50xx_driver); >> + >> +MODULE_DESCRIPTION("Texas Instruments LP5024 LED driver"); >> +MODULE_AUTHOR("Dan Murphy <dmurphy@ti.com>"); >> +MODULE_LICENSE("GPL v2"); >> > -- ------------------ Dan Murphy
Hi! > > First, I think we want to decide if RGB LED should be presented as > > 3 LEDs or as 1 LED... and what to do with existing RGB leds being > > presented as 3 LEDs. > > What do we do with RGBW drivers? Like the LP5562. RGB can be grouped as a single > LED but does the white LED get grouped too or should it register as a new LED? > > I am assuming the answer is that it would register as a new LED. We could extend this to more than three channels, and specify "color" for each channel. We could probably specify wavelength for monochromatic LEDs and color temperature for white LEDs.... > > pwm_channels -- "1000 240 300" -- "red part should be full on, green > > should be pwm controlled to 240/1000, blue should be 300/1000" > > > > Why 1000? Why not based on a duty cycle percentage and let the LED driver figure out > what that means to the device? > > pwm_channels -- "100 24 30" -- red part is full on 100%, green is 24% duty cycle and > blue is 30% duty cycle. Percentage would work, too. Having base of 1000 (not 100) gives a bit more precision. > > pwm_white -- "1000 500 400" -- tells userspace what to write to PWM > > channels to get approximately white color. > > > > Same as above on the duty cycle. > > But I still am in disagreement with the kernel detailing what is white or how to > achieve white. > > Based on my earlier email about light pipes and the LED vendors and aging I think product > developers will need to fine tune what is "white" on their product from user space or even a DT node. > Yes, this needs to be in the DT and kernel needs to expose it to userspace in sysfs. > > This would assume that RGB LEDs are always pwm controlled. That > > seems to be true for hardware I seen. > > > > GPIO LEDs can be binary or use PWM depending on what is needed. > > > + no complex math in kernel > > We can eliminate the math if we use the "color" file that was proposed and pass in absolute > hex/decimal numbers for color. No you can't. > > + userspace knows enough to display arbitrary colors > > > > + userspace can use full range of available PWM intensities > > > > Do we need a pwm_max file to indicate to the user space what the max values of the pwm > is for each color? Maybe. I'd assume brightness_max would be equal to max pwm. Pavel -- (english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html
diff --git a/Documentation/leds/leds-lp50xx.txt b/Documentation/leds/leds-lp50xx.txt new file mode 100644 index 000000000000..8b1b01dfdd22 --- /dev/null +++ b/Documentation/leds/leds-lp50xx.txt @@ -0,0 +1,36 @@ +LP5018/LP5024/LP5030/LP5036 Common Driver +================================================= + +Authors: Dan Murphy <dmurphy@ti.com> + +Description +----------- +The LP50XX RGB LED drivers have the ability to group multiple RGB cluster +LEDs into a single group for simultaneous control or expose single RGB cluster +for control. This device exposes different register interfaces to control +the cluster brightness as well as the individual RGB LEDs color intensity. + +RGB Cluster Color Control +------------------------- +The LP50xx driver will expose a file called "color" for each LED class instance +defined. This file will accept a 24-bit RGB value in which the the color of the +RGB LEDs will be set. + +The 24-bit RGB value passed in follows the pattern 0xXXRRGGBB +XX - Do not care ignored by the driver +RR - is the 8 bit Red LED value +GG - is the 8 bit Green LED value +BB - is the 8 bit Blue LED value + +Example: +LED module output 4 of the LP5024 will be a yellow color: +echo 0xe6de00 > /sys/class/leds/lp5024\:led4_mod/color + +LED module output 4 of the LP5024 will be dimmed 50%: +echo 0x80 > /sys/class/leds/lp5024\:led4_mod/brightness + +LED banked RGBs of the LP5036 will be a white color: +echo 0xffffff > /sys/class/leds/lp5036\:led_banked/color + +LED banked RGBs of the LP50364 will be dimmed 50%: +echo 0x80 > /sys/class/leds/lp5036\:led_banked/brightness diff --git a/drivers/leds/Kconfig b/drivers/leds/Kconfig index a72f97fca57b..5f413445a667 100644 --- a/drivers/leds/Kconfig +++ b/drivers/leds/Kconfig @@ -326,6 +326,13 @@ config LEDS_LP3952 To compile this driver as a module, choose M here: the module will be called leds-lp3952. +config LEDS_LP50XX + tristate "LED Support for TI LP5036/30/24/18 LED driver chip" + depends on LEDS_CLASS && REGMAP_I2C + help + If you say yes here you get support for the Texas Instruments + LP5036, LP5030, LP5024 and LP5018 LED driver. + config LEDS_LP55XX_COMMON tristate "Common Driver for TI/National LP5521/5523/55231/5562/8501" depends on LEDS_LP5521 || LEDS_LP5523 || LEDS_LP5562 || LEDS_LP8501 diff --git a/drivers/leds/Makefile b/drivers/leds/Makefile index 4c1b0054f379..852eff0b773f 100644 --- a/drivers/leds/Makefile +++ b/drivers/leds/Makefile @@ -32,6 +32,7 @@ obj-$(CONFIG_LEDS_GPIO_REGISTER) += leds-gpio-register.o obj-$(CONFIG_LEDS_GPIO) += leds-gpio.o obj-$(CONFIG_LEDS_LP3944) += leds-lp3944.o obj-$(CONFIG_LEDS_LP3952) += leds-lp3952.o +obj-$(CONFIG_LEDS_LP50XX) += leds-lp50xx.o obj-$(CONFIG_LEDS_LP55XX_COMMON) += leds-lp55xx-common.o obj-$(CONFIG_LEDS_LP5521) += leds-lp5521.o obj-$(CONFIG_LEDS_LP5523) += leds-lp5523.o diff --git a/drivers/leds/leds-lp50xx.c b/drivers/leds/leds-lp50xx.c new file mode 100644 index 000000000000..41bb2e0129c8 --- /dev/null +++ b/drivers/leds/leds-lp50xx.c @@ -0,0 +1,754 @@ +// SPDX-License-Identifier: GPL-2.0 +/* TI LP50XX LED chip family driver + * Copyright (C) 2018 Texas Instruments Incorporated - http://www.ti.com/ + */ + +#include <linux/gpio/consumer.h> +#include <linux/i2c.h> +#include <linux/init.h> +#include <linux/leds.h> +#include <linux/module.h> +#include <linux/mutex.h> +#include <linux/of.h> +#include <linux/of_gpio.h> +#include <linux/regmap.h> +#include <linux/regulator/consumer.h> +#include <linux/slab.h> +#include <uapi/linux/uleds.h> + +#define LP50XX_DEV_CFG0 0x00 +#define LP50XX_DEV_CFG1 0x01 +#define LP50XX_LED_CFG0 0x02 + +/* LP5018 and LP5024 registers */ +#define LP5024_BNK_BRT 0x03 +#define LP5024_BNKA_CLR 0x04 +#define LP5024_BNKB_CLR 0x05 +#define LP5024_BNKC_CLR 0x06 +#define LP5024_LED0_BRT 0x07 +#define LP5024_LED1_BRT 0x08 +#define LP5024_LED2_BRT 0x09 +#define LP5024_LED3_BRT 0x0a +#define LP5024_LED4_BRT 0x0b +#define LP5024_LED5_BRT 0x0c +#define LP5024_LED6_BRT 0x0d +#define LP5024_LED7_BRT 0x0e + +#define LP5024_OUT0_CLR 0x0f +#define LP5024_OUT1_CLR 0x10 +#define LP5024_OUT2_CLR 0x11 +#define LP5024_OUT3_CLR 0x12 +#define LP5024_OUT4_CLR 0x13 +#define LP5024_OUT5_CLR 0x14 +#define LP5024_OUT6_CLR 0x15 +#define LP5024_OUT7_CLR 0x16 +#define LP5024_OUT8_CLR 0x17 +#define LP5024_OUT9_CLR 0x18 +#define LP5024_OUT10_CLR 0x19 +#define LP5024_OUT11_CLR 0x1a +#define LP5024_OUT12_CLR 0x1b +#define LP5024_OUT13_CLR 0x1c +#define LP5024_OUT14_CLR 0x1d +#define LP5024_OUT15_CLR 0x1e +#define LP5024_OUT16_CLR 0x1f +#define LP5024_OUT17_CLR 0x20 +#define LP5024_OUT18_CLR 0x21 +#define LP5024_OUT19_CLR 0x22 +#define LP5024_OUT20_CLR 0x23 +#define LP5024_OUT21_CLR 0x24 +#define LP5024_OUT22_CLR 0x25 +#define LP5024_OUT23_CLR 0x26 +#define LP5024_RESET 0x27 + +/* LP5030 and LP5036 registers */ +#define LP5036_LED_CFG1 0x03 +#define LP5036_BNK_BRT 0x04 +#define LP5036_BNKA_CLR 0x05 +#define LP5036_BNKB_CLR 0x06 +#define LP5036_BNKC_CLR 0x07 +#define LP5036_LED0_BRT 0x08 +#define LP5036_LED1_BRT 0x09 +#define LP5036_LED2_BRT 0x0a +#define LP5036_LED3_BRT 0x0b +#define LP5036_LED4_BRT 0x0c +#define LP5036_LED5_BRT 0x0d +#define LP5036_LED6_BRT 0x0e +#define LP5036_LED7_BRT 0x0f +#define LP5036_LED8_BRT 0x10 +#define LP5036_LED9_BRT 0x11 +#define LP5036_LED10_BRT 0x12 +#define LP5036_LED11_BRT 0x13 + +#define LP5036_OUT0_CLR 0x14 +#define LP5036_OUT1_CLR 0x15 +#define LP5036_OUT2_CLR 0x16 +#define LP5036_OUT3_CLR 0x17 +#define LP5036_OUT4_CLR 0x18 +#define LP5036_OUT5_CLR 0x19 +#define LP5036_OUT6_CLR 0x1a +#define LP5036_OUT7_CLR 0x1b +#define LP5036_OUT8_CLR 0x1c +#define LP5036_OUT9_CLR 0x1d +#define LP5036_OUT10_CLR 0x1e +#define LP5036_OUT11_CLR 0x1f +#define LP5036_OUT12_CLR 0x20 +#define LP5036_OUT13_CLR 0x21 +#define LP5036_OUT14_CLR 0x22 +#define LP5036_OUT15_CLR 0x23 +#define LP5036_OUT16_CLR 0x24 +#define LP5036_OUT17_CLR 0x25 +#define LP5036_OUT18_CLR 0x26 +#define LP5036_OUT19_CLR 0x27 +#define LP5036_OUT20_CLR 0x28 +#define LP5036_OUT21_CLR 0x29 +#define LP5036_OUT22_CLR 0x2a +#define LP5036_OUT23_CLR 0x2b +#define LP5036_OUT24_CLR 0x2c +#define LP5036_OUT25_CLR 0x2d +#define LP5036_OUT26_CLR 0x2e +#define LP5036_OUT27_CLR 0x2f +#define LP5036_OUT28_CLR 0x30 +#define LP5036_OUT29_CLR 0x31 +#define LP5036_OUT30_CLR 0x32 +#define LP5036_OUT31_CLR 0x33 +#define LP5036_OUT32_CLR 0x34 +#define LP5036_OUT33_CLR 0x35 +#define LP5036_OUT34_CLR 0x36 +#define LP5036_OUT35_CLR 0x37 +#define LP5036_RESET 0x38 + +#define LP50XX_SW_RESET 0xff + +#define LP50XX_CHIP_EN BIT(6) + +#define LP5018_MAX_LED_STRINGS 6 +#define LP5024_MAX_LED_STRINGS 8 +#define LP5030_MAX_LED_STRINGS 10 +#define LP5036_MAX_LED_STRINGS 12 + +enum lp50xx_model { + LP5018, + LP5024, + LP5030, + LP5036, +}; + +struct lp50xx_led { + u32 led_strings[LP5036_MAX_LED_STRINGS]; + char label[LED_MAX_NAME_SIZE]; + struct led_classdev led_dev; + struct lp50xx *priv; + int led_number; + u8 ctrl_bank_enabled; +}; + +/** + * struct lp50xx - + * @enable_gpio: Hardware enable gpio + * @regulator: LED supply regulator pointer + * @client: Pointer to the I2C client + * @regmap: Devices register map + * @dev: Pointer to the devices device struct + * @lock: Lock for reading/writing the device + * @model_id: ID of the device + * @leds: Array of LED strings + */ +struct lp50xx { + struct gpio_desc *enable_gpio; + struct regulator *regulator; + struct i2c_client *client; + struct regmap *regmap; + struct device *dev; + struct mutex lock; + enum lp50xx_model model_id; + int max_leds; + int num_of_leds; + + u8 led_brightness0_reg; + u8 mix_out0_reg; + u8 bank_brt_reg; + u8 bank_mix_reg; + u8 reset_reg; + + /* This needs to be at the end of the struct */ + struct lp50xx_led leds[]; +}; + +static const struct reg_default lp5024_reg_defs[] = { + {LP50XX_DEV_CFG0, 0x0}, + {LP50XX_DEV_CFG1, 0x3c}, + {LP50XX_LED_CFG0, 0x0}, + {LP5024_BNK_BRT, 0xff}, + {LP5024_BNKA_CLR, 0x0f}, + {LP5024_BNKB_CLR, 0x0f}, + {LP5024_BNKC_CLR, 0x0f}, + {LP5024_LED0_BRT, 0x0f}, + {LP5024_LED1_BRT, 0xff}, + {LP5024_LED2_BRT, 0xff}, + {LP5024_LED3_BRT, 0xff}, + {LP5024_LED4_BRT, 0xff}, + {LP5024_LED5_BRT, 0xff}, + {LP5024_LED6_BRT, 0xff}, + {LP5024_LED7_BRT, 0xff}, + {LP5024_OUT0_CLR, 0x0f}, + {LP5024_OUT1_CLR, 0x00}, + {LP5024_OUT2_CLR, 0x00}, + {LP5024_OUT3_CLR, 0x00}, + {LP5024_OUT4_CLR, 0x00}, + {LP5024_OUT5_CLR, 0x00}, + {LP5024_OUT6_CLR, 0x00}, + {LP5024_OUT7_CLR, 0x00}, + {LP5024_OUT8_CLR, 0x00}, + {LP5024_OUT9_CLR, 0x00}, + {LP5024_OUT10_CLR, 0x00}, + {LP5024_OUT11_CLR, 0x00}, + {LP5024_OUT12_CLR, 0x00}, + {LP5024_OUT13_CLR, 0x00}, + {LP5024_OUT14_CLR, 0x00}, + {LP5024_OUT15_CLR, 0x00}, + {LP5024_OUT16_CLR, 0x00}, + {LP5024_OUT17_CLR, 0x00}, + {LP5024_OUT18_CLR, 0x00}, + {LP5024_OUT19_CLR, 0x00}, + {LP5024_OUT20_CLR, 0x00}, + {LP5024_OUT21_CLR, 0x00}, + {LP5024_OUT22_CLR, 0x00}, + {LP5024_OUT23_CLR, 0x00}, + {LP5024_RESET, 0x00} +}; + +static const struct reg_default lp5036_reg_defs[] = { + {LP50XX_DEV_CFG0, 0x0}, + {LP50XX_DEV_CFG1, 0x3c}, + {LP50XX_LED_CFG0, 0x0}, + {LP5036_LED_CFG1, 0x0}, + {LP5036_BNK_BRT, 0xff}, + {LP5036_BNKA_CLR, 0x0f}, + {LP5036_BNKB_CLR, 0x0f}, + {LP5036_BNKC_CLR, 0x0f}, + {LP5036_LED0_BRT, 0x0f}, + {LP5036_LED1_BRT, 0xff}, + {LP5036_LED2_BRT, 0xff}, + {LP5036_LED3_BRT, 0xff}, + {LP5036_LED4_BRT, 0xff}, + {LP5036_LED5_BRT, 0xff}, + {LP5036_LED6_BRT, 0xff}, + {LP5036_LED7_BRT, 0xff}, + {LP5036_OUT0_CLR, 0x0f}, + {LP5036_OUT1_CLR, 0x00}, + {LP5036_OUT2_CLR, 0x00}, + {LP5036_OUT3_CLR, 0x00}, + {LP5036_OUT4_CLR, 0x00}, + {LP5036_OUT5_CLR, 0x00}, + {LP5036_OUT6_CLR, 0x00}, + {LP5036_OUT7_CLR, 0x00}, + {LP5036_OUT8_CLR, 0x00}, + {LP5036_OUT9_CLR, 0x00}, + {LP5036_OUT10_CLR, 0x00}, + {LP5036_OUT11_CLR, 0x00}, + {LP5036_OUT12_CLR, 0x00}, + {LP5036_OUT13_CLR, 0x00}, + {LP5036_OUT14_CLR, 0x00}, + {LP5036_OUT15_CLR, 0x00}, + {LP5036_OUT16_CLR, 0x00}, + {LP5036_OUT17_CLR, 0x00}, + {LP5036_OUT18_CLR, 0x00}, + {LP5036_OUT19_CLR, 0x00}, + {LP5036_OUT20_CLR, 0x00}, + {LP5036_OUT21_CLR, 0x00}, + {LP5036_OUT22_CLR, 0x00}, + {LP5036_OUT23_CLR, 0x00}, + {LP5036_OUT24_CLR, 0x00}, + {LP5036_OUT25_CLR, 0x00}, + {LP5036_OUT26_CLR, 0x00}, + {LP5036_OUT27_CLR, 0x00}, + {LP5036_OUT28_CLR, 0x00}, + {LP5036_OUT29_CLR, 0x00}, + {LP5036_OUT30_CLR, 0x00}, + {LP5036_OUT31_CLR, 0x00}, + {LP5036_OUT32_CLR, 0x00}, + {LP5036_OUT33_CLR, 0x00}, + {LP5036_OUT34_CLR, 0x00}, + {LP5036_OUT35_CLR, 0x00}, + {LP5036_RESET, 0x00} +}; + +static const struct regmap_config lp5024_regmap_config = { + .reg_bits = 8, + .val_bits = 8, + + .max_register = LP5024_RESET, + .reg_defaults = lp5024_reg_defs, + .num_reg_defaults = ARRAY_SIZE(lp5024_reg_defs), + .cache_type = REGCACHE_RBTREE, +}; + +static const struct regmap_config lp5036_regmap_config = { + .reg_bits = 8, + .val_bits = 8, + + .max_register = LP5036_RESET, + .reg_defaults = lp5036_reg_defs, + .num_reg_defaults = ARRAY_SIZE(lp5036_reg_defs), + .cache_type = REGCACHE_RBTREE, +}; + +static ssize_t color_show(struct device *dev, + struct device_attribute *attr, + char *buf) +{ + struct led_classdev *led_cdev = dev_get_drvdata(dev); + struct lp50xx_led *led = container_of(led_cdev, struct lp50xx_led, + led_dev); + struct lp50xx *priv = led->priv; + unsigned int red_val, green_val, blue_val; + u8 red_reg, green_reg, blue_reg; + u32 mix_value = 0; + u8 led_offset; + int ret; + + if (led->ctrl_bank_enabled) { + red_reg = priv->bank_mix_reg; + green_reg = priv->bank_mix_reg + 1; + blue_reg = priv->bank_mix_reg + 2; + } else { + led_offset = (led->led_number * 3); + red_reg = priv->mix_out0_reg + led_offset; + green_reg = priv->mix_out0_reg + led_offset + 1; + blue_reg = priv->mix_out0_reg + led_offset + 2; + } + + ret = regmap_read(priv->regmap, red_reg, &red_val); + if (ret) { + dev_err(&priv->client->dev, "Cannot read LED value\n"); + goto out; + } + + ret = regmap_read(priv->regmap, green_reg, &green_val); + if (ret) { + dev_err(&priv->client->dev, "Cannot read LED value\n"); + goto out; + } + + ret = regmap_read(priv->regmap, blue_reg, &blue_val); + if (ret) { + dev_err(&priv->client->dev, "Cannot read LED value\n"); + goto out; + } + + mix_value = (red_val << 16 | green_val << 8 | blue_val); + +out: + return scnprintf(buf, PAGE_SIZE, "0x%X\n", mix_value); +} + +static ssize_t color_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t size) +{ + struct led_classdev *led_cdev = dev_get_drvdata(dev); + struct lp50xx_led *led = container_of(led_cdev, struct lp50xx_led, + led_dev); + struct lp50xx *priv = led->priv; + u8 led_offset; + unsigned long mix_value; + u8 red_reg, green_reg, blue_reg; + u8 red_val, green_val, blue_val; + int ret; + + ret = kstrtoul(buf, 0, &mix_value); + if (ret) + return ret; + + if (led->ctrl_bank_enabled) { + red_reg = priv->bank_mix_reg; + green_reg = priv->bank_mix_reg + 1; + blue_reg = priv->bank_mix_reg + 2; + } else { + led_offset = (led->led_number * 3); + red_reg = priv->mix_out0_reg + led_offset; + green_reg = priv->mix_out0_reg + led_offset + 1; + blue_reg = priv->mix_out0_reg + led_offset + 2; + } + + red_val = (mix_value & 0xff0000) >> 16; + green_val = (mix_value & 0xff00) >> 8; + blue_val = (mix_value & 0xff); + + ret = regmap_write(priv->regmap, red_reg, red_val); + if (ret) { + dev_err(&priv->client->dev, "Cannot write LED value\n"); + goto out; + } + + ret = regmap_write(priv->regmap, green_reg, green_val); + if (ret) { + dev_err(&priv->client->dev, "Cannot write LED value\n"); + goto out; + } + + ret = regmap_write(priv->regmap, blue_reg, blue_val); + if (ret) { + dev_err(&priv->client->dev, "Cannot write LED value\n"); + goto out; + } +out: + return size; +} + +static DEVICE_ATTR_RW(color); + +static struct attribute *lp50xx_led_color_attrs[] = { + &dev_attr_color.attr, + NULL +}; +ATTRIBUTE_GROUPS(lp50xx_led_color); + +static int lp50xx_brightness_set(struct led_classdev *led_cdev, + enum led_brightness brt_val) +{ + struct lp50xx_led *led = container_of(led_cdev, struct lp50xx_led, + led_dev); + int ret = 0; + u8 reg_val; + + mutex_lock(&led->priv->lock); + + if (led->ctrl_bank_enabled) + reg_val = led->priv->bank_brt_reg; + else + reg_val = led->priv->led_brightness0_reg + led->led_number; + + ret = regmap_write(led->priv->regmap, reg_val, brt_val); + + mutex_unlock(&led->priv->lock); + + return ret; +} + +static enum led_brightness lp50xx_brightness_get(struct led_classdev *led_cdev) +{ + struct lp50xx_led *led = container_of(led_cdev, struct lp50xx_led, + led_dev); + unsigned int brt_val; + u8 reg_val; + int ret; + + mutex_lock(&led->priv->lock); + + if (led->ctrl_bank_enabled) + reg_val = led->priv->bank_brt_reg; + else + reg_val = led->priv->led_brightness0_reg + led->led_number; + + ret = regmap_read(led->priv->regmap, reg_val, &brt_val); + + mutex_unlock(&led->priv->lock); + + return brt_val; +} + +static void lp50xx_set_led_values(struct lp50xx *priv) +{ + if (priv->model_id == LP5018 || priv->model_id == LP5024) { + priv->led_brightness0_reg = LP5024_LED0_BRT; + priv->mix_out0_reg = LP5024_OUT0_CLR; + priv->bank_brt_reg = LP5024_BNK_BRT; + priv->bank_mix_reg = LP5024_BNKA_CLR; + priv->reset_reg = LP5024_RESET; + } else { + priv->led_brightness0_reg = LP5036_LED0_BRT; + priv->mix_out0_reg = LP5036_OUT0_CLR; + priv->bank_brt_reg = LP5036_BNK_BRT; + priv->bank_mix_reg = LP5036_BNKA_CLR; + priv->reset_reg = LP5036_RESET; + } +} + +static int lp50xx_set_banks(struct lp50xx *priv) +{ + struct lp50xx_led *led; + u8 led_ctrl_enable = 0; + u8 led1_ctrl_enable = 0; + u8 ctrl_ext = 0; + int i, j; + int ret; + + for (i = 0; i <= priv->num_of_leds; i++) { + led = &priv->leds[i]; + if (!led->ctrl_bank_enabled) + continue; + + for (j = 0; j <= priv->max_leds - 1; j++) { + if (led->led_strings[j] > (LP5024_MAX_LED_STRINGS - 1)) { + ctrl_ext = led->led_strings[j] - LP5024_MAX_LED_STRINGS; + led1_ctrl_enable |= (1 << ctrl_ext); + } else { + led_ctrl_enable |= (1 << led->led_strings[j]); + } + } + } + + ret = regmap_write(priv->regmap, LP50XX_LED_CFG0, led_ctrl_enable); + + if (led1_ctrl_enable) + ret = regmap_write(priv->regmap, LP5036_LED_CFG1, + led1_ctrl_enable); + + return ret; +} + +static int lp50xx_init(struct lp50xx *priv) +{ + int ret; + + lp50xx_set_led_values(priv); + + if (priv->enable_gpio) { + gpiod_direction_output(priv->enable_gpio, 1); + } else { + ret = regmap_write(priv->regmap, priv->reset_reg, + LP50XX_SW_RESET); + if (ret) { + dev_err(&priv->client->dev, + "Cannot reset the device\n"); + goto out; + } + } + + ret = lp50xx_set_banks(priv); + if (ret) { + dev_err(&priv->client->dev, "Cannot set the banks\n"); + goto out; + } + + ret = regmap_write(priv->regmap, LP50XX_DEV_CFG0, LP50XX_CHIP_EN); + if (ret) + dev_err(&priv->client->dev, "Cannot write ctrl enable\n"); + +out: + return ret; +} + +static int lp50xx_probe_dt(struct lp50xx *priv) +{ + struct fwnode_handle *child = NULL; + struct lp50xx_led *led; + int control_bank_defined = 0; + const char *name; + int led_number; + size_t i = 0; + int ret; + + priv->enable_gpio = devm_gpiod_get_optional(&priv->client->dev, + "enable", GPIOD_OUT_LOW); + if (IS_ERR(priv->enable_gpio)) { + ret = PTR_ERR(priv->enable_gpio); + dev_err(&priv->client->dev, "Failed to get enable gpio: %d\n", + ret); + return ret; + } + + priv->regulator = devm_regulator_get(&priv->client->dev, "vled"); + if (IS_ERR(priv->regulator)) + priv->regulator = NULL; + + if (priv->model_id == LP5018) + priv->max_leds = LP5018_MAX_LED_STRINGS; + else if (priv->model_id == LP5024) + priv->max_leds = LP5024_MAX_LED_STRINGS; + else if (priv->model_id == LP5030) + priv->max_leds = LP5030_MAX_LED_STRINGS; + else + priv->max_leds = LP5036_MAX_LED_STRINGS; + + device_for_each_child_node(&priv->client->dev, child) { + led = &priv->leds[i]; + + if (fwnode_property_present(child, "ti,led-bank")) { + led->ctrl_bank_enabled = 1; + if (!control_bank_defined) + control_bank_defined = 1; + else { + dev_err(&priv->client->dev, + "ti,led-bank defined twice\n"); + fwnode_handle_put(child); + goto child_out; + } + } else { + led->ctrl_bank_enabled = 0; + } + + if (led->ctrl_bank_enabled) { + ret = fwnode_property_read_u32_array(child, + "ti,led-bank", + NULL, 0); + ret = fwnode_property_read_u32_array(child, + "ti,led-bank", + led->led_strings, + ret); + + led->led_number = led->led_strings[0]; + + } else { + ret = fwnode_property_read_u32(child, "ti,led-module", + &led_number); + + led->led_number = led_number; + } + if (ret) { + dev_err(&priv->client->dev, + "led sourcing property missing\n"); + fwnode_handle_put(child); + goto child_out; + } + + if (led_number > priv->max_leds) { + dev_err(&priv->client->dev, + "led-sources property is invalid\n"); + ret = -EINVAL; + fwnode_handle_put(child); + goto child_out; + } + + ret = fwnode_property_read_string(child, "label", &name); + if (ret) + snprintf(led->label, sizeof(led->label), + "%s::", priv->client->name); + else + snprintf(led->label, sizeof(led->label), + "%s:%s", priv->client->name, name); + + fwnode_property_read_string(child, "linux,default-trigger", + &led->led_dev.default_trigger); + + led->priv = priv; + led->led_dev.name = led->label; + led->led_dev.brightness_set_blocking = lp50xx_brightness_set; + led->led_dev.brightness_get = lp50xx_brightness_get; + led->led_dev.groups = lp50xx_led_color_groups; + + ret = devm_led_classdev_register(&priv->client->dev, + &led->led_dev); + if (ret) { + dev_err(&priv->client->dev, "led register err: %d\n", + ret); + fwnode_handle_put(child); + goto child_out; + } + i++; + } + priv->num_of_leds = i; + +child_out: + return ret; +} + +static int lp50xx_probe(struct i2c_client *client, + const struct i2c_device_id *id) +{ + struct lp50xx *led; + int count; + int ret; + + count = device_get_child_node_count(&client->dev); + if (!count) { + dev_err(&client->dev, "LEDs are not defined in device tree!"); + return -ENODEV; + } + + led = devm_kzalloc(&client->dev, struct_size(led, leds, count), + GFP_KERNEL); + if (!led) + return -ENOMEM; + + mutex_init(&led->lock); + led->client = client; + led->dev = &client->dev; + led->model_id = id->driver_data; + i2c_set_clientdata(client, led); + + if (led->model_id == LP5018 || led->model_id == LP5024) + led->regmap = devm_regmap_init_i2c(client, + &lp5024_regmap_config); + else + led->regmap = devm_regmap_init_i2c(client, + &lp5036_regmap_config); + + if (IS_ERR(led->regmap)) { + ret = PTR_ERR(led->regmap); + dev_err(&client->dev, "Failed to allocate register map: %d\n", + ret); + return ret; + } + + ret = lp50xx_probe_dt(led); + if (ret) + return ret; + + ret = lp50xx_init(led); + if (ret) + return ret; + + return 0; +} + +static int lp50xx_remove(struct i2c_client *client) +{ + struct lp50xx *led = i2c_get_clientdata(client); + int ret; + + ret = regmap_update_bits(led->regmap, LP50XX_DEV_CFG0, + LP50XX_CHIP_EN, 0); + if (ret) { + dev_err(&led->client->dev, "Failed to disable regulator\n"); + return ret; + } + + if (led->enable_gpio) + gpiod_direction_output(led->enable_gpio, 0); + + if (led->regulator) { + ret = regulator_disable(led->regulator); + if (ret) + dev_err(&led->client->dev, + "Failed to disable regulator\n"); + } + + mutex_destroy(&led->lock); + + return 0; +} + +static const struct i2c_device_id lp50xx_id[] = { + { "lp5018", LP5018 }, + { "lp5024", LP5024 }, + { "lp5030", LP5030 }, + { "lp5036", LP5036 }, + { } +}; +MODULE_DEVICE_TABLE(i2c, lp50xx_id); + +static const struct of_device_id of_lp50xx_leds_match[] = { + { .compatible = "ti,lp5018", }, + { .compatible = "ti,lp5024", }, + { .compatible = "ti,lp5030", }, + { .compatible = "ti,lp5036", }, + {}, +}; +MODULE_DEVICE_TABLE(of, of_lp50xx_leds_match); + +static struct i2c_driver lp50xx_driver = { + .driver = { + .name = "lp50xx", + .of_match_table = of_lp50xx_leds_match, + }, + .probe = lp50xx_probe, + .remove = lp50xx_remove, + .id_table = lp50xx_id, +}; +module_i2c_driver(lp50xx_driver); + +MODULE_DESCRIPTION("Texas Instruments LP5024 LED driver"); +MODULE_AUTHOR("Dan Murphy <dmurphy@ti.com>"); +MODULE_LICENSE("GPL v2");
Introduce the LP5036/30/24/18 RGB LED driver. The difference in these parts are the number of LED outputs where the: LP5036 can control 36 LEDs LP5030 can control 30 LEDs LP5024 can control 24 LEDs LP5018 can control 18 LEDs The device has the ability to group LED output into control banks so that multiple LED banks can be controlled with the same mixing and brightness. Inversely the LEDs can also be controlled independently. Signed-off-by: Dan Murphy <dmurphy@ti.com> --- v2 - Changed the mix and module files to a single "color" file, added the LP5030 and LP5036 register mapping, added ABI documentation, updated the parsing of DT and led sources to match DT, renamed driver to leds-lp50xx.c - https://lore.kernel.org/patchwork/patch/1026515/ Documentation/leds/leds-lp50xx.txt | 36 ++ drivers/leds/Kconfig | 7 + drivers/leds/Makefile | 1 + drivers/leds/leds-lp50xx.c | 754 +++++++++++++++++++++++++++++ 4 files changed, 798 insertions(+) create mode 100644 Documentation/leds/leds-lp50xx.txt create mode 100644 drivers/leds/leds-lp50xx.c -- 2.20.1.98.gecbdaf0899