leds: Add driver for NCP5623 3-channel I2C LED driver
Subsystems (2)
v4 cover leds: Add driver for NCP5623 3-channel I2C LED driver
Hello Jacek and Pavel,
Winter came, then spring, summer and automn went away. Snow came again, and now here is the v4 of the NCP5623 patch... Never too late!
This series add a new driver for On Semiconductor NCP5623, a 3-channel I2C LED driver. It is used in our design to drive a RGB LED.
The first patch introduces the device tree binding, while the second patch adds the driver itself.
Best regards,
Florian
---
v3 -> v4:
- Rebased on Linux 4.15
- Moved ncp5623_of_match[] after probe
- Fixed computation of max_brightness
- Some more simplifications
- Updated copyright and SPDX license
v2 -> v3:
- Rebased on latest leds/for-next
- Minor fixes to the binding documentation
- Removed ncp5623_set_pwm() by inlining it directly inside the caller
- Removed ncp5623_destroy_devices() as we are already using devm_ flavours
- Got rid of the 'active' state variable by using 'led_no' instead
- Some other cosmetic fixes
v1 -> v2:
- Adapted the DT binding (led-max-microamp for each LED node)
- Removed underscores from node names in the example
- Use brightness_set_blocking to avoid workqueue
- Introduced LED_to_CMD macro to avoid switch statement
- Various other fixes
Florian Vaussard (2):
leds: ncp5623: Add device tree binding documentation
leds: Add driver for NCP5623 3-channel I2C LED driver
.../devicetree/bindings/leds/leds-ncp5623.txt | 60 ++++++ drivers/leds/Kconfig | 11 + drivers/leds/Makefile | 1 + drivers/leds/leds-ncp5623.c | 228 +++++++++++++++++++++ 4 files changed, 300 insertions(+) create mode 100644 Documentation/devicetree/bindings/leds/leds-ncp5623.txt create mode 100644 drivers/leds/leds-ncp5623.c
Signature · 1 line
2.13.6
PATCH v4 1/2 leds: ncp5623: Add device tree binding documentation
Add device tree binding documentation for On Semiconductor NCP5623 I2C LED driver. The driver can independently control the PWM of the 3 channels with 32 levels of intensity.
The current delivered by the current source can also be controlled. To do so, the led-max-microamp property is used by each LED sub-node. The maximum value is then found and used as a limit to compute the final intensity of the current source. If a LED happens to have a lower limit, the PWM is then used to limit the current to the requested value.
In order to control the current source, it is also necessary to know the current on the Iref pin, hence the onnn,led-iref-microamp property. It is usually set using an external bias resistor, following Iref = Vref/Rbias with Vref=0.6V.
--- .../devicetree/bindings/leds/leds-ncp5623.txt | 60 ++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 Documentation/devicetree/bindings/leds/leds-ncp5623.txt
Documentation/devicetree/bindings/leds/leds-ncp5623.txt new file +60 -0
@@ -0,0 +1,60 @@ +* ON Semiconductor - NCP5623 3-Channel LED Driver + +The NCP5623 is a 3-channel I2C LED driver. The brightness of each +channel can be independently set using 32 levels. Each LED is represented +as a sub-node of the device. + +Required properties: + - compatible: Should be "onnn,ncp5623" + - reg: I2C slave address (fixed to 0x38) + - #address-cells: must be 1 + - #size-cells: must be 0 + - onnn,led-iref-microamp: Current on the Iref pin in microampere. It depends + on the value of the external bias resistor Rbias, following + Iref = Vref / Rbias with Vref = 0.6V. This is used to set the intensity of + the current that can be provided by the internal current source, based on + the maximum current permitted by LED sub-nodes (see below), but no more than + Imax = 2400 * Iref. + +LED sub-nodes +============= + +Required properties: + - reg : LED channel number (0..2) + - led-max-microamp: Maximum allowable current inside the LED in microampere. + This property is used to limit the PWM ratio, based on the intensity of the + internal current source (see above). + +Optional properties: + - label: see Documentation/devicetree/bindings/leds/common.txt + - linux,default-trigger: see Documentation/devicetree/bindings/leds/common.txt + +Example +======= + +led1: ncp5623@38 { + #address-cells = <1>; + #size-cells = <0>; + compatible = "onnn,ncp5623"; + reg = <0x38>; + onnn,led-iref-microamp = <10>; + + led1r@0 { + label = "ncp:power:red"; + linux,default-trigger = "default-on"; + reg = <0>; + led-max-microamp = <20000>; + }; + + led1b@1 { + label = "ncp:power:blue"; + reg = <1>; + led-max-microamp = <20000>; + }; + + led1g@2 { + label = "ncp:power:green"; + reg = <2>; + led-max-microamp = <20000>; + }; +};
Signature · 1 line
2.13.6
Re: [PATCH v4 1/2] leds: ncp5623: Add device tree binding documentation
Hi!
Quoted 3 lines
Documentation/devicetree/bindings/leds/leds-ncp5623.txt new file +3
-0+Required properties: + - compatible: Should be "onnn,ncp5623" + - reg: I2C slave address (fixed to 0x38)
..
Review
Quoted 2 lines
(quoted diff) +2
-0+Required properties: + - reg : LED channel number (0..2)
For consistency, there should be no space between reg and :.
Anyway, this can be fixed later.
Signature · 2 lines
(english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html
Re: [PATCH v4 1/2] leds: ncp5623: Add device tree binding documentation
In reply to Florian VaussardHi Florian,
Thanks for the v4.
Quoted 79 lines · Florian Vaussard
Add device tree binding documentation for On Semiconductor NCP5623 I2C LED driver. The driver can independently control the PWM of the 3 channels with 32 levels of intensity.
The current delivered by the current source can also be controlled. To do so, the led-max-microamp property is used by each LED sub-node. The maximum value is then found and used as a limit to compute the final intensity of the current source. If a LED happens to have a lower limit, the PWM is then used to limit the current to the requested value.
In order to control the current source, it is also necessary to know the current on the Iref pin, hence the onnn,led-iref-microamp property. It is usually set using an external bias resistor, following Iref = Vref/Rbias with Vref=0.6V.
Signed-off-by Florian Vaussard <[email protected]>Acked-by Rob Herring <[email protected]>--- .../devicetree/bindings/leds/leds-ncp5623.txt | 60 ++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 Documentation/devicetree/bindings/leds/leds-ncp5623.txtDocumentation/devicetree/bindings/leds/leds-ncp5623.txt new file +50
-0@@ -0,0 +1,60 @@ +* ON Semiconductor - NCP5623 3-Channel LED Driver + +The NCP5623 is a 3-channel I2C LED driver. The brightness of each +channel can be independently set using 32 levels. Each LED is represented +as a sub-node of the device. + +Required properties: + - compatible: Should be "onnn,ncp5623" + - reg: I2C slave address (fixed to 0x38) + - #address-cells: must be 1 + - #size-cells: must be 0 + - onnn,led-iref-microamp: Current on the Iref pin in microampere. It depends + on the value of the external bias resistor Rbias, following + Iref = Vref / Rbias with Vref = 0.6V. This is used to set the intensity of + the current that can be provided by the internal current source, based on + the maximum current permitted by LED sub-nodes (see below), but no more than + Imax = 2400 * Iref. + +LED sub-nodes +============= + +Required properties: + - reg : LED channel number (0..2) + - led-max-microamp: Maximum allowable current inside the LED in microampere. + This property is used to limit the PWM ratio, based on the intensity of the + internal current source (see above). + +Optional properties: + - label: see Documentation/devicetree/bindings/leds/common.txt + - linux,default-trigger: see Documentation/devicetree/bindings/leds/common.txt + +Example +======= + +led1: ncp5623@38 { + #address-cells = <1>; + #size-cells = <0>; + compatible = "onnn,ncp5623"; + reg = <0x38>; + onnn,led-iref-microamp = <10>; + + led1r@0 { + label = "ncp:power:red"; + linux,default-trigger = "default-on"; + reg = <0>; + led-max-microamp = <20000>; + }; + + led1b@1 { + label = "ncp:power:blue";
Documentation/devicetree/bindings/leds/leds-ncp5623.txt line 60
Quoted 10 lines
Documentation/devicetree/bindings/leds/leds-ncp5623.txt new file +10
-0+ reg = <1>; + led-max-microamp = <20000>; + }; + + led1g@2 { + label = "ncp:power:green"; + reg = <2>; + led-max-microamp = <20000>; + }; +};
Some time ago we was instructed how our DT bindings should look like. See [0]. In view of that, the above should be changed as below. Please note dropped "ncp:" segment from label. Also LED class device name pattern is "devicename:colour:function", so you will have to reverse the order of segments in your labels. Last but not least - couldn't the LED functions be better distinguishable - now we have "power" for all three LEDs?
led-controller@38 {
#address-cells = <1>;
#size-cells = <0>;
compatible = "onnn,ncp5623";
reg = <0x38>;
onnn,led-iref-microamp = <10>;
led@0 {
label = "red:power";
linux,default-trigger = "default-on";
reg = <0>;
led-max-microamp = <20000>;
};
led@1 {
label = "blue:power";
reg = <1>;
led-max-microamp = <20000>;
};
led@2 {
label = "green:power";
reg = <2>;
led-max-microamp = <20000>;
};You can refer to drivers/leds/leds-lp8860.c on how to construct the label. Generally from the discussions with DT maintainer it turned out that we shouldn't have controller name in the LED class device name at all, but it will have to be addressed globally for all LED class drivers at once at some point.
[0] https://patchwork.kernel.org/patch/10093757/
Signature · 2 lines
Best regards, Jacek Anaszewski
PATCH v4 2/2 leds: Add driver for NCP5623 3-channel I2C LED driver
In reply to Florian VaussardThe NCP5623 is a 3-channel LED driver from On Semiconductor controlled through I2C. The PWM of each channel can be independently set with 32 distinct levels. In addition, the intensity of the current source can be globally set using an external bias resistor fixing the reference current (Iref) and a dedicated register (ILED), following the relationship:
I = 2400*Iref/(31-ILED)
with Iref = Vref/Rbias, and Vref = 0.6V.
--- drivers/leds/Kconfig | 11 +++ drivers/leds/Makefile | 1 + drivers/leds/leds-ncp5623.c | 228 ++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 240 insertions(+) create mode 100644 drivers/leds/leds-ncp5623.c
drivers/leds/Kconfig +11 -0
@@ -706,6 +706,17 @@ config LEDS_NIC78BX To compile this driver as a module, choose M here: the module will be called leds-nic78bx. +config LEDS_NCP5623 + tristate "LED Support for NCP5623 I2C chip" + depends on LEDS_CLASS + depends on I2C + help + This option enables support for LEDs connected to NCP5623 + LED driver chips accessed via the I2C bus. + Driver supports brightness control. + + Say Y to enable this driver. + comment "LED Triggers" source "drivers/leds/trigger/Kconfig"
drivers/leds/Makefile +1 -0
@@ -74,6 +74,7 @@ obj-$(CONFIG_LEDS_PM8058) += leds-pm8058.o obj-$(CONFIG_LEDS_MLXCPLD) += leds-mlxcpld.o obj-$(CONFIG_LEDS_NIC78BX) += leds-nic78bx.o obj-$(CONFIG_LEDS_MT6323) += leds-mt6323.o +obj-$(CONFIG_LEDS_NCP5623) += leds-ncp5623.o # LED SPI Drivers obj-$(CONFIG_LEDS_DAC124S085) += leds-dac124s085.o
drivers/leds/leds-ncp5623.c new file +228 -0
228 lines not on this page · raw message
Signature · 1 line
2.13.6
Quoted 10 lines · Florian Vaussard
The NCP5623 is a 3-channel LED driver from On Semiconductor controlled through I2C. The PWM of each channel can be independently set with 32 distinct levels. In addition, the intensity of the current source can be globally set using an external bias resistor fixing the reference current (Iref) and a dedicated register (ILED), following the relationship:
I = 2400*Iref/(31-ILED)
with Iref = Vref/Rbias, and Vref = 0.6V.
First of all, why it's rebased on top of v4.15 while we have v4.16-rc2 already?
Quoted 5 lines
+/*
+ * Copyright 2018 Florian Vaussard <[email protected]>
+ *
+ * SPDX-License-Identifier: GPL-2.0
+ */
Check license-rules.rst.
drivers/leds/leds-ncp5623.c line 29
Quoted 9 lines
drivers/leds/leds-ncp5623.c new file +9
-0+#define NCP5623_CMD_SHIFT 5 +#define CMD_SHUTDOWN (0x00 << NCP5623_CMD_SHIFT) +#define CMD_ILED (0x01 << NCP5623_CMD_SHIFT) +#define CMD_PWM1 (0x02 << NCP5623_CMD_SHIFT) +#define CMD_PWM2 (0x03 << NCP5623_CMD_SHIFT) +#define CMD_PWM3 (0x04 << NCP5623_CMD_SHIFT) +#define CMD_UPWARD_DIM (0x05 << NCP5623_CMD_SHIFT) +#define CMD_DOWNWARD_DIM (0x06 << NCP5623_CMD_SHIFT) +#define CMD_DIM_STEP (0x07 << NCP5623_CMD_SHIFT)
Just put 5 instead. My eyes hurts by above.
Quoted 1 line
+#define
LED_TO_PWM_CMD(led)((0x02+ led - 1) <<NCP5623_CMD_SHIFT)
led -> (led)
Review
Quoted 2 lines
(quoted diff) +2
-0+ +#define NCP5623_DATA_MASK GENMASK(NCP5623_CMD_SHIFT - 1, 0)
While here is OK.
Quoted 1 line
+static struct
ncp5623_led*ldev_to_led(structled_classdev*ldev)
More usual pattern isto_ncp5623_led()
Quoted 1 line
+ return (err < 0 ? err : 0);
Where this style comes from?
I mean redundant parens.
drivers/leds/leds-ncp5623.c line 131
Quoted 2 lines
drivers/leds/leds-ncp5623.c new file +2
-0+ err =of_property_read_u32 (np,"onnn,led-iref-microamp" , + &priv->led_iref);
Don't we have some generic property for iref:s?
Quoted 11 lines
drivers/leds/leds-ncp5623.c new file +11
-0+static int ncp5623_probe (struct i2c_client *client, +const struct i2c_device_id *id) +{ +struct device *dev = &client->dev; +struct device_node *np = dev->of_node; +struct ncp5623_priv *priv; +int err; + + priv =devm_kzalloc (dev,sizeof (*priv),GFP_KERNEL ); +if (!priv) +return -ENOMEM ;
drivers/leds/leds-ncp5623.c line 200
Quoted 10 lines
drivers/leds/leds-ncp5623.c new file +9
-0+ + priv->client = client; +i2c_set_clientdata (client, priv); + + err =ncp5623_parse_dt (priv, np); +if (err) +return err; + +return ncp5623_configure (dev, priv);
This sounds wrong.
You call configure while it does two unrelated things: configure + registration.
Name it properly and move closer to ->probe().
drivers/leds/leds-ncp5623.c line 213
Quoted 5 lines
drivers/leds/leds-ncp5623.c new file +5
-0+static const struct i2c_device_id ncp5623_id[] = { + {"ncp5623" }, + {}, +}; +MODULE_DEVICE_TABLE (i2c, ncp5623_id);
Do you really need this? Consider to switch to ->probe_new().
Quoted 1 line
+ .of_match_table =
of_match_ptr(ncp5623_of_match),
Here you will get a compiler warning. Remove this pointless of_match_ptr().
Signature · 2 lines
With Best Regards, Andy Shevchenko
Hi!
drivers/leds/leds-ncp5623.c line 228
Quoted 5 lines
drivers/leds/leds-ncp5623.c new file +5
-0+module_i2c_driver (ncp5623_driver); + +MODULE_AUTHOR ("Florian Vaussard <[email protected]>" ); +MODULE_LICENSE ("GPL v2" ); +MODULE_DESCRIPTION ("NCP5623 LED driver" );
Signature · 2 lines
(english) http://www.livejournal.com/~pavelmachek (cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html