diff --git a/Documentation/ABI/testing/sysfs-class-led-driver-ltc3220 b/Documentation/ABI/testing/sysfs-class-led-driver-ltc3220 new file mode 100644 index 0000000000000..d5ac611dea463 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-class-led-driver-ltc3220 @@ -0,0 +1,48 @@ +What: /sys/class/leds//shutdown +Date: November 2025 +Contact: Edelweise Escala +Description: LTC3220 shutdown command. If you write 1 it + shuts down part while preserving data in registers. + If you write 0 device is in normal operation. + +What: /sys/class/leds//force_cpo_mode +Date: November 2025 +Contact: Edelweise Escala +Description: LTC3220 force charge pump settings (0..3): + 0 - Enables mode logic to control mode changes based on dropout signal + 1 - Forces charge pump into 1.5x mode + 2 - Forces charge pump into 2x mode + 3 - Forces charge pump into 1x mode + +What: /sys/class/leds//quick_write +Date: November 2025 +Contact: Edelweise Escala +Description: LTC3220 quick_write setting. LTC3220 has a quick write configuration + which allows parallel write on all 18 LED registers, when data is being written on + REG1. If you write 1 quick_write is enabled, 0 to disable. + +What: /sys/class/leds//gradation_speed +Date: November 2025 +Contact: Edelweise Escala +Description: LTC3220 gradation speed (0..3) where: + 0 - disabled + 1 - Ramp time of 0.24s and Period of 0.313s + 2 - Ramp time of 0.48s and Period of 0.625s + 3 - Ramp time of 0.96s and Period of 1.25s + +What: /sys/class/leds//gradation_is_increasing +Date: November 2025 +Contact: Edelweise Escala +Description: LTC3220 gradation increasing command. This sets if gradation + will ramp up or down. If you write 1 it gradation will ramp up, 0 will + ramp down. + +What: /sys/class/leds//blink_cfg +Date: November 2025 +Contact: Edelweise Escala +Description: LTC3220 device blink setting. The blink settings for all LEDs + (0..3) where: + 0 - On Time of 0.625s and Period of 1.25s + 1 - On Time of 0.156s and Period of 1.25s + 2 - On Time of 0.625s and Period of 2.5s + 3 - On Time of 0.156s and Period of 2.5s \ No newline at end of file diff --git a/Documentation/devicetree/bindings/leds/leds-ltc3220.yaml b/Documentation/devicetree/bindings/leds/leds-ltc3220.yaml new file mode 100644 index 0000000000000..0cd478dc2d932 --- /dev/null +++ b/Documentation/devicetree/bindings/leds/leds-ltc3220.yaml @@ -0,0 +1,114 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/leds/leds-ltc3220.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Analog Devices LTC3220 LED Drivers + +maintainers: + - Edelweise Escala + +description: Bindings for the Analog Devices LTC3220 18 channel LED Drivers. + + For more product information please see the link below + https://www.analog.com/en/products/ltc3220.html + +properties: + compatible: + enum: + - adi,ltc3220 + - adi,ltc3220-1 + + reg: + maxItems: 1 + + '#address-cells': + const: 1 + + '#size-cells': + const: 0 + + reset-gpios: + maxItems: 1 + description: GPIO attached to the chip's reset pin + +patternProperties: + "(^led@([1-9]|1[0-8])$|led)": + type: object + $ref: common.yaml# + unevaluatedProperties: false + properties: + reg: + description: Output channel for the LED. reg value to output to LED output number + enum: + - 1 # LED output D1 + - 2 # LED output D2 + - 3 # LED output D3 + - 4 # LED output D4 + - 5 # LED output D5 + - 6 # LED output D6 + - 7 # LED output D7 + - 8 # LED output D8 + - 9 # LED output D9 + - 10 # LED output D10 + - 11 # LED output D11 + - 12 # LED output D12 + - 13 # LED output D13 + - 14 # LED output D14 + - 15 # LED output D15 + - 16 # LED output D16 + - 17 # LED output D17 + - 18 # LED output D18 + required: + - reg + +required: + - compatible + - reg + - reset-gpios + +additionalProperties: false + +examples: + - | + #include + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + led-controller@1c { + compatible = "adi,ltc3220"; + reg = <0x1c>; + #address-cells = <1>; + #size-cells = <0>; + reset-gpios = <&gpio 17 0>; + + led@1 { + reg = <1>; + }; + + led@2 { + reg = <2>; + }; + + led@3 { + reg = <3>; + }; + + led@4 { + reg = <4>; + }; + + led@5 { + reg = <5>; + }; + + led@6 { + reg = <6>; + }; + }; + }; + +... diff --git a/Kconfig.adi b/Kconfig.adi index b55ae80169496..1a83bd4be01e6 100644 --- a/Kconfig.adi +++ b/Kconfig.adi @@ -71,6 +71,7 @@ config KERNEL_ALL_ADI_DRIVERS imply PMIC_ADP5520 imply PWM_AXI_PWMGEN imply LEDS_ADP5520 + imply LEDS_LTC3220 imply BACKLIGHT_ADP5520 imply BACKLIGHT_ADP8860 imply BACKLIGHT_ADP8870 diff --git a/drivers/leds/Kconfig b/drivers/leds/Kconfig index b784bb74a8378..af6bb652d6dc6 100644 --- a/drivers/leds/Kconfig +++ b/drivers/leds/Kconfig @@ -931,6 +931,16 @@ config LEDS_LM36274 Say Y to enable the LM36274 LED driver for TI LMU devices. This supports the LED device LM36274. +config LEDS_LTC3220 + tristate "LED Driver for LTC3220/LTC3220-1" + depends on I2C && LEDS_CLASS + help + If you have an 18-Channel LED Driver connected to LTC3220, or LTC3220-1 + say Y here to enable this driver. + + To compile this driver as a module, choose M here: the module will + be called ltc3220. + config LEDS_TPS6105X tristate "LED support for TI TPS6105X" depends on LEDS_CLASS diff --git a/drivers/leds/Makefile b/drivers/leds/Makefile index 18afbb5a23ee5..530bf81344ba8 100644 --- a/drivers/leds/Makefile +++ b/drivers/leds/Makefile @@ -58,6 +58,7 @@ obj-$(CONFIG_LEDS_LP8501) += leds-lp8501.o obj-$(CONFIG_LEDS_LP8788) += leds-lp8788.o obj-$(CONFIG_LEDS_LP8860) += leds-lp8860.o obj-$(CONFIG_LEDS_LT3593) += leds-lt3593.o +obj-$(CONFIG_LEDS_LTC3220) += leds-ltc3220.o obj-$(CONFIG_LEDS_MAX5970) += leds-max5970.o obj-$(CONFIG_LEDS_MAX77650) += leds-max77650.o obj-$(CONFIG_LEDS_MAX8997) += leds-max8997.o diff --git a/drivers/leds/leds-ltc3220.c b/drivers/leds/leds-ltc3220.c new file mode 100644 index 0000000000000..b439fc02616df --- /dev/null +++ b/drivers/leds/leds-ltc3220.c @@ -0,0 +1,533 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * LTC3220 18-Channel LED Driver + * + * Copyright 2025 Analog Devices Inc. + * + * Author: Edelweise Escala + */ + +#include +#include +#include +#include +#include +#include + +/* LTC3220 Registers */ +#define LTC3220_COMMAND 0x00 +#define LTC3220_ULED01 0x01 +#define LTC3220_ULED02 0x02 +#define LTC3220_ULED03 0x03 +#define LTC3220_ULED04 0x04 +#define LTC3220_ULED05 0x05 +#define LTC3220_ULED06 0x06 +#define LTC3220_ULED07 0x07 +#define LTC3220_ULED08 0x08 +#define LTC3220_ULED09 0x09 +#define LTC3220_ULED10 0x0A +#define LTC3220_ULED11 0x0B +#define LTC3220_ULED12 0x0C +#define LTC3220_ULED13 0x0D +#define LTC3220_ULED14 0x0E +#define LTC3220_ULED15 0x0F +#define LTC3220_ULED16 0x10 +#define LTC3220_ULED17 0x11 +#define LTC3220_ULED18 0x12 +#define LTC3220_GRAD_BLINK 0x13 + +#define LTC3220_BIT0 BIT(0) +#define LTC3220_BIT1 BIT(1) +#define LTC3220_BIT2 BIT(2) +#define LTC3220_BIT3 BIT(3) +#define LTC3220_BIT4 BIT(4) + +#define LTC3220_LED_CURRENT_MASK GENMASK(5, 0) +#define LTC3220_LED_MODE_MASK GENMASK(7, 6) +#define LTC3220_BLINK_MASK GENMASK(4, 3) +#define LTC3220_GRADATION_MASK GENMASK(2, 1) +#define LTC3220_CPO_COMMAND_MASK GENMASK(2, 1) + +#define LTC3220_NUM_LEDS 18 + +enum ltc3220_uled_mode { + LTC3220_LED_NORMAL = 0, + LTC3220_LED_BLINK = 1, + LTC3220_LED_GRADATION = 2, + LTC3220_LED_GPO = 3 +}; + +struct ltc3220_command_cfg { + bool is_quick_write; + bool is_shutdown; + u8 force_cpo_mode; +}; + +struct ltc3220_uled_cfg { + u8 led_index; + u8 reg_value; + struct i2c_client *client; + struct led_classdev led_cdev; +}; + +struct ltc3220_blink_cfg { + bool is_blink_long_period; + bool is_blink_fast_on; +}; + +struct ltc3220_grad_cfg { + bool is_increasing; + u8 gradation_speed; +}; + +struct ltc3220_state { + u8 blink_cfg; + struct i2c_client *client; + struct ltc3220_command_cfg command_cfg; + struct ltc3220_uled_cfg uled_cfg[LTC3220_NUM_LEDS]; + struct ltc3220_grad_cfg grad_cfg; + struct led_classdev led_cdev; + struct device *dev; + struct gpio_desc *reset_gpio; +}; + +static int ltc3220_set_command(struct ltc3220_state *ltc3220_state, + bool is_shutdown, u8 force_cpo_mode, bool quick_write) +{ + u8 reg_val; + int ret; + struct i2c_client *client = ltc3220_state->client; + + reg_val = FIELD_PREP(LTC3220_BIT3, is_shutdown); + reg_val |= FIELD_PREP(LTC3220_CPO_COMMAND_MASK, force_cpo_mode); + reg_val |= FIELD_PREP(LTC3220_BIT0, quick_write); + ret = i2c_smbus_write_byte_data(client, LTC3220_COMMAND, reg_val); + if (ret < 0) { + dev_err(&client->dev, "Set command fail\n"); + return ret; + } + + return 0; +} + +static ssize_t ltc3220_shutdown_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + return sysfs_emit(buf, "%d\n", ltc3220_state->command_cfg.is_shutdown); +} + +static ssize_t ltc3220_shutdown_store(struct device *dev, + struct device_attribute *dev_attr, + const char *buf, size_t size) +{ + unsigned int state; + int ret; + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + ret = kstrtouint(buf, 0, &state); + if (ret) + return ret; + + ret = ltc3220_set_command(ltc3220_state, + state, + ltc3220_state->command_cfg.force_cpo_mode, + ltc3220_state->command_cfg.is_quick_write); + if (ret < 0) + return ret; + + ltc3220_state->command_cfg.is_shutdown = state; + + return size; +} +static DEVICE_ATTR(shutdown, 0644, + ltc3220_shutdown_show, + ltc3220_shutdown_store); + +static ssize_t ltc3220_force_cpo_mode_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + return sysfs_emit(buf, "%d\n", ltc3220_state->command_cfg.force_cpo_mode); +} + +static ssize_t ltc3220_force_cpo_mode_store(struct device *dev, + struct device_attribute *dev_attr, + const char *buf, size_t size) +{ + u8 state; + int ret; + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + ret = kstrtou8(buf, 10, &state); + if (ret) + return ret; + + if (state > 3) { + dev_err(<c3220_state->client->dev, + "Invalid cpo mode %u, must be 0-3\n", state); + return -EINVAL; + } + + ret = ltc3220_set_command(ltc3220_state, + ltc3220_state->command_cfg.is_shutdown, + state, + ltc3220_state->command_cfg.is_quick_write); + if (ret < 0) + return ret; + + ltc3220_state->command_cfg.force_cpo_mode = state; + + return size; +} +static DEVICE_ATTR(force_cpo_mode, 0644, + ltc3220_force_cpo_mode_show, + ltc3220_force_cpo_mode_store); + +static ssize_t ltc3220_quick_write_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + return sysfs_emit(buf, "%d\n", ltc3220_state->command_cfg.is_quick_write); +} + +static ssize_t ltc3220_quick_write_store(struct device *dev, + struct device_attribute *dev_attr, + const char *buf, size_t size) +{ + unsigned int state; + int ret; + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + ret = kstrtouint(buf, 0, &state); + if (ret) + return ret; + + ret = ltc3220_set_command(ltc3220_state, + ltc3220_state->command_cfg.is_shutdown, + ltc3220_state->command_cfg.force_cpo_mode, + state); + if (ret < 0) + return ret; + + ltc3220_state->command_cfg.is_quick_write = state; + + return size; +} +static DEVICE_ATTR(quick_write, 0644, + ltc3220_quick_write_show, + ltc3220_quick_write_store); + +static int ltc3220_set_led_data(struct led_classdev *led_cdev, + enum led_brightness brightness) +{ + u8 led_data; + int ret; + int i = 0; + struct ltc3220_state *ltc3220_state; + struct ltc3220_uled_cfg *uled_cfg; + + uled_cfg = container_of(led_cdev, struct ltc3220_uled_cfg, led_cdev); + led_data = brightness; + + ret = i2c_smbus_write_byte_data(uled_cfg->client, + LTC3220_ULED01 + uled_cfg->led_index, led_data); + if (ret < 0) + return ret; + + ltc3220_state = i2c_get_clientdata(uled_cfg->client); + if (ltc3220_state->command_cfg.is_quick_write && uled_cfg->led_index == 0) { + for (i = 0; i < LTC3220_NUM_LEDS; i++) + ltc3220_state->uled_cfg[i].reg_value = led_data; + } else { + uled_cfg->reg_value = led_data; + } + return 0; +} + +static enum led_brightness ltc3220_get_led_data(struct led_classdev *led_cdev) +{ + struct ltc3220_uled_cfg *uled_cfg = container_of(led_cdev, struct ltc3220_uled_cfg, led_cdev); + + return uled_cfg->reg_value; +} + +static int ltc3220_set_blink_and_gradation(struct ltc3220_state *ltc3220_state, + u8 blink_cfg, u8 gradation_speed, + bool is_increasing) +{ + u8 reg_val; + int ret; + struct i2c_client *client = ltc3220_state->client; + + reg_val = FIELD_PREP(LTC3220_BLINK_MASK, blink_cfg); + reg_val |= FIELD_PREP(LTC3220_GRADATION_MASK, gradation_speed); + reg_val |= FIELD_PREP(LTC3220_BIT0, is_increasing); + + ret = i2c_smbus_write_byte_data(client, LTC3220_GRAD_BLINK, reg_val); + if (ret < 0) { + dev_err(&client->dev, "Set blinking and gradation fail\n"); + return ret; + } + + return 0; +} + +static ssize_t ltc3220_gradation_speed_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + return sysfs_emit(buf, "%d\n", ltc3220_state->grad_cfg.gradation_speed); +} + +static ssize_t ltc3220_gradation_speed_store(struct device *dev, + struct device_attribute *dev_attr, + const char *buf, size_t size) +{ + u8 state; + int ret; + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + ret = kstrtou8(buf, 10, &state); + if (ret) + return ret; + + if (state > 3) { + dev_err(<c3220_state->client->dev, + "Invalid gradation speed %u, must be 0-3\n", state); + return -EINVAL; + } + + ret = ltc3220_set_blink_and_gradation(ltc3220_state, + ltc3220_state->blink_cfg, + state, + ltc3220_state->grad_cfg.is_increasing); + if (ret < 0) + return ret; + + ltc3220_state->grad_cfg.gradation_speed = state; + + return size; +} +static DEVICE_ATTR(gradation_speed, 0644, + ltc3220_gradation_speed_show, + ltc3220_gradation_speed_store); + +static ssize_t ltc3220_gradation_is_increasing_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + return sysfs_emit(buf, "%d\n", ltc3220_state->grad_cfg.is_increasing); +} + +static ssize_t ltc3220_gradation_is_increasing_store(struct device *dev, + struct device_attribute *dev_attr, + const char *buf, size_t size) +{ + unsigned int state; + int ret; + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + ret = kstrtouint(buf, 0, &state); + if (ret) + return ret; + + ret = ltc3220_set_blink_and_gradation(ltc3220_state, + ltc3220_state->blink_cfg, + ltc3220_state->grad_cfg.gradation_speed, + state); + if (ret < 0) + return ret; + + ltc3220_state->grad_cfg.is_increasing = state; + + return size; +} +static DEVICE_ATTR(gradation_is_increasing, 0644, + ltc3220_gradation_is_increasing_show, + ltc3220_gradation_is_increasing_store); + +static ssize_t ltc3220_blink_cfg_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + return sysfs_emit(buf, "%d\n", ltc3220_state->blink_cfg); +} + +static ssize_t ltc3220_blink_cfg_store(struct device *dev, + struct device_attribute *dev_attr, + const char *buf, size_t size) +{ + u8 state; + int ret; + struct ltc3220_state *ltc3220_state = dev_get_drvdata(dev); + + ret = kstrtou8(buf, 10, &state); + if (ret) + return ret; + + if (state > 3) { + dev_err(<c3220_state->client->dev, + "Invalid gradation speed %u, must be 0-3\n", state); + return -EINVAL; + } + + ret = ltc3220_set_blink_and_gradation(ltc3220_state, + state, + ltc3220_state->grad_cfg.gradation_speed, + ltc3220_state->grad_cfg.is_increasing); + if (ret < 0) + return ret; + + ltc3220_state->blink_cfg = state; + + return size; +} +static DEVICE_ATTR(blink_cfg, 0644, + ltc3220_blink_cfg_show, + ltc3220_blink_cfg_store); + +static struct attribute *device_cfg_attrs[] = { + &dev_attr_shutdown.attr, + &dev_attr_force_cpo_mode.attr, + &dev_attr_quick_write.attr, + &dev_attr_gradation_speed.attr, + &dev_attr_gradation_is_increasing.attr, + &dev_attr_blink_cfg.attr, + NULL +}; + +static struct attribute_group device_cfg_group = { + .attrs = device_cfg_attrs, +}; + +static void ltc3220_reset_gpio_action(void *data) +{ + struct gpio_desc *reset_gpio = data; + + gpiod_set_value_cansleep(reset_gpio, 0); +} + +static int ltc3220_reset(struct ltc3220_state *ltc3220_state) +{ + if (ltc3220_state->reset_gpio) { + gpiod_set_value_cansleep(ltc3220_state->reset_gpio, 0); + msleep(20); + gpiod_set_value_cansleep(ltc3220_state->reset_gpio, 1); + } else { + ltc3220_set_command(ltc3220_state, 0, 0, 1); + i2c_smbus_write_byte_data(ltc3220_state->client, LTC3220_ULED01, 0); + ltc3220_set_command(ltc3220_state, 0, 0, 0); + ltc3220_set_blink_and_gradation(ltc3220_state, 0, 0, 0); + } + + return 0; +} + +static void ltc3220_remove(struct i2c_client *client) +{ + sysfs_remove_group(&client->dev.kobj, &device_cfg_group); +} + +static int ltc3220_probe(struct i2c_client *client) +{ + u8 i = 0; + int ret; + struct fwnode_handle *child; + struct ltc3220_state *ltc3220_state; + + if (!i2c_check_functionality(client->adapter, + I2C_FUNC_SMBUS_BYTE_DATA)) { + dev_err(&client->dev, "SMBUS Byte Data not Supported\n"); + return -EIO; + } + + ltc3220_state = devm_kzalloc(&client->dev, sizeof(*ltc3220_state), GFP_KERNEL); + if (!ltc3220_state) + return -ENODEV; + + ltc3220_state->client = client; + i2c_set_clientdata(client, ltc3220_state); + + ltc3220_state->reset_gpio = devm_gpiod_get_optional(&client->dev, "reset", GPIOD_OUT_HIGH); + if (IS_ERR(ltc3220_state->reset_gpio)) { + return dev_err_probe(&client->dev, PTR_ERR(ltc3220_state->reset_gpio), + "Failed to set reset GPIO\n"); + } + ltc3220_reset(ltc3220_state); + + ret = devm_add_action_or_reset(&client->dev, ltc3220_reset_gpio_action, ltc3220_state->reset_gpio); + if (ret) + return ret; + + device_for_each_child_node(&client->dev, child) { + u32 source; + struct led_init_data init_data = {}; + char label_buffer[32]; + + ret = fwnode_property_read_u32(child, "reg", &source); + if (ret != 0 || !source || source > LTC3220_NUM_LEDS) { + dev_err(&client->dev, "Couldn't read LED address: %d\n", + ret); + fwnode_handle_put(child); + return -ENOMEM; + } + + i = source - 1; + init_data.fwnode = child; + init_data.devicename = "ltc3220"; + snprintf(label_buffer, sizeof(label_buffer), ":led%d", i); + init_data.default_label = label_buffer; + + ltc3220_state->uled_cfg[i].led_index = i; + ltc3220_state->uled_cfg[i].client = client; + ltc3220_state->uled_cfg[i].reg_value = 0; + ltc3220_state->uled_cfg[i].led_cdev.brightness_set_blocking = ltc3220_set_led_data; + ltc3220_state->uled_cfg[i].led_cdev.brightness_get = ltc3220_get_led_data; + + ret = devm_led_classdev_register_ext(&client->dev, + <c3220_state->uled_cfg[i].led_cdev, + &init_data); + if (ret) { + dev_err(&client->dev, "Fail LED class register\n"); + fwnode_handle_put(child); + return -ENOMEM; + } + } + + ret = sysfs_create_group(&client->dev.kobj, &device_cfg_group); + if (ret < 0) { + dev_err(&client->dev, "Failed to create Device config sysfs group\n"); + return -ENOMEM; + } + + return 0; +} + +static const struct of_device_id ltc3220_of_match[] = { + { .compatible = "adi,ltc3220", }, + { .compatible = "adi,ltc3220-1", }, + { }, +}; +MODULE_DEVICE_TABLE(of, ltc3220_of_match); + +static struct i2c_driver ltc3220_led_driver = { + .driver = { + .name = "ltc3220", + .of_match_table = ltc3220_of_match, + }, + .probe = ltc3220_probe, + .remove = ltc3220_remove, +}; + +module_i2c_driver(ltc3220_led_driver); + +MODULE_AUTHOR("Edelweise Escala "); +MODULE_DESCRIPTION("LED driver for LTC3220 controllers"); +MODULE_LICENSE("GPL");