blob: 431d7e10ab74e2aba8f4964bfe641889315b0998 [file] [log] [blame]
// SPDX-License-Identifier: GPL-2.0+
/*
* Copyright (C) 2018 Doug Zobel <douglas.zobel@climate.com>
*
* Driver for TI lp5562 4 channel LED driver. There are only 3
* engines available for the 4 LEDs, so white and blue LEDs share
* the same engine. This means that the blink period is shared
* between them. Changing the period of blue blink will affect
* the white period (and vice-versa). Blue and white On/Off
* states remain independent (as would PWM brightness if that's
* ever added to the LED core).
*/
#include <dm.h>
#include <errno.h>
#include <led.h>
#include <i2c.h>
#include <asm/gpio.h>
#include <linux/delay.h>
#define DEFAULT_CURRENT 100 /* 10 mA */
#define MIN_BLINK_PERIOD 32 /* ms */
#define MAX_BLINK_PERIOD 2248 /* ms */
/* Register Map */
#define REG_ENABLE 0x00
#define REG_OP_MODE 0x01
#define REG_B_PWM 0x02
#define REG_G_PWM 0x03
#define REG_R_PWM 0x04
#define REG_B_CUR 0x05
#define REG_G_CUR 0x06
#define REG_R_CUR 0x07
#define REG_CONFIG 0x08
#define REG_ENG1_PC 0x09
#define REG_ENG2_PC 0x0A
#define REG_ENG3_PC 0x0B
#define REG_STATUS 0x0C
#define REG_RESET 0x0D
#define REG_W_PWM 0x0E
#define REG_W_CUR 0x0F
#define REG_ENG1_MEM_BEGIN 0x10
#define REG_ENG2_MEM_BEGIN 0x30
#define REG_ENG3_MEM_BEGIN 0x50
#define REG_LED_MAP 0x70
/* LED Register Values */
/* 0x00 ENABLE */
#define REG_ENABLE_CHIP_ENABLE (0x1 << 6)
#define REG_ENABLE_ENG_EXEC_HOLD 0x0
#define REG_ENABLE_ENG_EXEC_RUN 0x2
#define REG_ENABLE_ENG_EXEC_MASK 0x3
/* 0x01 OP MODE */
#define REG_OP_MODE_DISABLED 0x0
#define REG_OP_MODE_LOAD_SRAM 0x1
#define REG_OP_MODE_RUN 0x2
#define REG_OP_MODE_MASK 0x3
/* 0x02, 0x03, 0x04, 0x0E PWM */
#define REG_PWM_MIN_VALUE 0
#define REG_PWM_MAX_VALUE 0xFF
/* 0x08 CONFIG */
#define REG_CONFIG_EXT_CLK 0x0
#define REG_CONFIG_INT_CLK 0x1
#define REG_CONFIG_AUTO_CLK 0x2
#define REG_CONFIG_CLK_MASK 0x3
/* 0x0D RESET */
#define REG_RESET_RESET 0xFF
/* 0x70 LED MAP */
#define REG_LED_MAP_ENG_MASK 0x03
#define REG_LED_MAP_W_ENG_SHIFT 6
#define REG_LED_MAP_R_ENG_SHIFT 4
#define REG_LED_MAP_G_ENG_SHIFT 2
#define REG_LED_MAP_B_ENG_SHIFT 0
/* Engine program related */
#define REG_ENGINE_MEM_SIZE 0x20
#define LED_PGRM_RAMP_INCREMENT_SHIFT 0
#define LED_PGRM_RAMP_SIGN_SHIFT 7
#define LED_PGRM_RAMP_STEP_SHIFT 8
#define LED_PGRM_RAMP_PRESCALE_SHIFT 14
struct lp5562_led_wrap_priv {
struct gpio_desc enable_gpio;
};
struct lp5562_led_priv {
u8 reg_pwm;
u8 reg_current;
u8 map_shift;
u8 enginenum;
};
/* enum values map to LED_MAP (0x70) values */
enum lp5562_led_ctl_mode {
I2C = 0x0,
#ifdef CONFIG_LED_BLINK
ENGINE1 = 0x1,
ENGINE2 = 0x2,
ENGINE3 = 0x3
#endif
};
/*
* Update a register value
* dev - I2C udevice (parent of led)
* regnum - register number to update
* value - value to write to register
* mask - mask of bits that should be changed
*/
static int lp5562_led_reg_update(struct udevice *dev, int regnum,
u8 value, u8 mask)
{
int ret;
if (mask == 0xFF)
ret = dm_i2c_reg_write(dev, regnum, value);
else
ret = dm_i2c_reg_clrset(dev, regnum, mask, value);
/*
* Data sheet says "Delay between consecutive I2C writes to
* ENABLE register (00h) need to be longer than 488 μs
* (typical)." and "Delay between consecutive I2C writes to
* OP_MODE register need to be longer than 153 μs (typ)."
*
* The linux driver does usleep_range(500, 600) and
* usleep_range(200, 300), respectively.
*/
switch (regnum) {
case REG_ENABLE:
udelay(600);
break;
case REG_OP_MODE:
udelay(300);
break;
}
return ret;
}
#ifdef CONFIG_LED_BLINK
/*
* Program the lp5562 engine
* dev - I2C udevice (parent of led)
* program - array of commands
* size - number of commands in program array (1-16)
* engine - engine number (1-3)
*/
static int lp5562_led_program_engine(struct udevice *dev, u16 *program,
u8 size, u8 engine)
{
int ret, cmd;
u8 engine_reg = REG_ENG1_MEM_BEGIN +
((engine - 1) * REG_ENGINE_MEM_SIZE);
u8 shift = (3 - engine) * 2;
__be16 prog_be[16];
if (size < 1 || size > 16 || engine < 1 || engine > 3)
return -EINVAL;
for (cmd = 0; cmd < size; cmd++)
prog_be[cmd] = cpu_to_be16(program[cmd]);
/* set engine mode to 'disabled' */
ret = lp5562_led_reg_update(dev, REG_OP_MODE,
REG_OP_MODE_DISABLED << shift,
REG_OP_MODE_MASK << shift);
if (ret != 0)
goto done;
/* set exec mode to 'hold' */
ret = lp5562_led_reg_update(dev, REG_ENABLE,
REG_ENABLE_ENG_EXEC_HOLD << shift,
REG_ENABLE_ENG_EXEC_MASK << shift);
if (ret != 0)
goto done;
/* set engine mode to 'load SRAM' */
ret = lp5562_led_reg_update(dev, REG_OP_MODE,
REG_OP_MODE_LOAD_SRAM << shift,
REG_OP_MODE_MASK << shift);
if (ret != 0)
goto done;
/* send the re-ordered program sequence */
ret = dm_i2c_write(dev, engine_reg, (uchar *)prog_be, sizeof(u16) * size);
if (ret != 0)
goto done;
/* set engine mode to 'run' */
ret = lp5562_led_reg_update(dev, REG_OP_MODE,
REG_OP_MODE_RUN << shift,
REG_OP_MODE_MASK << shift);
if (ret != 0)
goto done;
/* set engine exec to 'run' */
ret = lp5562_led_reg_update(dev, REG_ENABLE,
REG_ENABLE_ENG_EXEC_RUN << shift,
REG_ENABLE_ENG_EXEC_MASK << shift);
done:
return ret;
}
/*
* Get the LED's current control mode (I2C or ENGINE[1-3])
* dev - led udevice (child udevice)
*/
static enum lp5562_led_ctl_mode lp5562_led_get_control_mode(struct udevice *dev)
{
struct lp5562_led_priv *priv = dev_get_priv(dev);
u8 data;
enum lp5562_led_ctl_mode mode = I2C;
if (dm_i2c_read(dev_get_parent(dev), REG_LED_MAP, &data, 1) == 0)
mode = (data & (REG_LED_MAP_ENG_MASK << priv->map_shift))
>> priv->map_shift;
return mode;
}
#endif
/*
* Set the LED's control mode to I2C or ENGINE[1-3]
* dev - led udevice (child udevice)
* mode - mode to change to
*/
static int lp5562_led_set_control_mode(struct udevice *dev,
enum lp5562_led_ctl_mode mode)
{
struct lp5562_led_priv *priv = dev_get_priv(dev);
return (lp5562_led_reg_update(dev_get_parent(dev), REG_LED_MAP,
mode << priv->map_shift,
REG_LED_MAP_ENG_MASK << priv->map_shift));
}
/*
* Return the LED's PWM value; If LED is in BLINK state, then it is
* under engine control mode which doesn't use this PWM value.
* dev - led udevice (child udevice)
*/
static int lp5562_led_get_pwm(struct udevice *dev)
{
struct lp5562_led_priv *priv = dev_get_priv(dev);
u8 data;
if (dm_i2c_read(dev_get_parent(dev), priv->reg_pwm, &data, 1) != 0)
return -EINVAL;
return data;
}
/*
* Set the LED's PWM value and configure it to use this (I2C mode).
* dev - led udevice (child udevice)
* value - PWM value (0 - 255)
*/
static int lp5562_led_set_pwm(struct udevice *dev, u8 value)
{
struct lp5562_led_priv *priv = dev_get_priv(dev);
if (lp5562_led_reg_update(dev_get_parent(dev), priv->reg_pwm,
value, 0xff) != 0)
return -EINVAL;
/* set LED to I2C register mode */
return lp5562_led_set_control_mode(dev, I2C);
}
/*
* Return the led's current state
* dev - led udevice (child udevice)
*
*/
static enum led_state_t lp5562_led_get_state(struct udevice *dev)
{
enum led_state_t state = LEDST_ON;
if (lp5562_led_get_pwm(dev) == REG_PWM_MIN_VALUE)
state = LEDST_OFF;
#ifdef CONFIG_LED_BLINK
if (lp5562_led_get_control_mode(dev) != I2C)
state = LEDST_BLINK;
#endif
return state;
}
/*
* Set the led state
* dev - led udevice (child udevice)
* state - State to set the LED to
*/
static int lp5562_led_set_state(struct udevice *dev, enum led_state_t state)
{
#ifdef CONFIG_LED_BLINK
struct lp5562_led_priv *priv = dev_get_priv(dev);
#endif
switch (state) {
case LEDST_OFF:
return lp5562_led_set_pwm(dev, REG_PWM_MIN_VALUE);
case LEDST_ON:
return lp5562_led_set_pwm(dev, REG_PWM_MAX_VALUE);
#ifdef CONFIG_LED_BLINK
case LEDST_BLINK:
return lp5562_led_set_control_mode(dev, priv->enginenum);
#endif
case LEDST_TOGGLE:
if (lp5562_led_get_state(dev) == LEDST_OFF)
return lp5562_led_set_state(dev, LEDST_ON);
else
return lp5562_led_set_state(dev, LEDST_OFF);
break;
default:
return -EINVAL;
}
return 0;
}
#ifdef CONFIG_LED_BLINK
/*
* Set the blink period of an LED; note blue and white share the same
* engine so changing the period of one affects the other.
* dev - led udevice (child udevice)
* period_ms - blink period in ms
*/
static int lp5562_led_set_period(struct udevice *dev, int period_ms)
{
struct lp5562_led_priv *priv = dev_get_priv(dev);
u8 opcode = 0;
u16 program[7];
u16 wait_time;
/* Blink is implemented as an engine program. Simple on/off
* for short periods, or fade in/fade out for longer periods:
*
* if (period_ms < 500):
* set PWM to 100%
* pause for period / 2
* set PWM to 0%
* pause for period / 2
* goto start
*
* else
* raise PWM 0% -> 50% in 62.7 ms
* raise PWM 50% -> 100% in 62.7 ms
* pause for (period - 4 * 62.7) / 2
* lower PWM 100% -> 50% in 62.7 ms
* lower PWM 50% -> 0% in 62.7 ms
* pause for (period - 4 * 62.7) / 2
* goto start
*/
if (period_ms < MIN_BLINK_PERIOD)
period_ms = MIN_BLINK_PERIOD;
else if (period_ms > MAX_BLINK_PERIOD)
period_ms = MAX_BLINK_PERIOD;
if (period_ms < 500) {
/* Simple on/off blink */
wait_time = period_ms / 2;
/* 1st command is full brightness */
program[opcode++] =
(1 << LED_PGRM_RAMP_PRESCALE_SHIFT) |
REG_PWM_MAX_VALUE;
/* 2nd command is wait (period / 2) using 15.6ms steps */
program[opcode++] =
(1 << LED_PGRM_RAMP_PRESCALE_SHIFT) |
(((wait_time * 10) / 156) << LED_PGRM_RAMP_STEP_SHIFT) |
(0 << LED_PGRM_RAMP_INCREMENT_SHIFT);
/* 3rd command is 0% brightness */
program[opcode++] =
(1 << LED_PGRM_RAMP_PRESCALE_SHIFT);
/* 4th command is wait (period / 2) using 15.6ms steps */
program[opcode++] =
(1 << LED_PGRM_RAMP_PRESCALE_SHIFT) |
(((wait_time * 10) / 156) << LED_PGRM_RAMP_STEP_SHIFT) |
(0 << LED_PGRM_RAMP_INCREMENT_SHIFT);
/* 5th command: repeat */
program[opcode++] = 0x00;
} else {
/* fade-in / fade-out blink */
wait_time = ((period_ms - 251) / 2);
/* ramp up time is 256 * 0.49ms (125.4ms) done in 2 steps */
/* 1st command is ramp up 1/2 way */
program[opcode++] =
(0 << LED_PGRM_RAMP_PRESCALE_SHIFT) |
(1 << LED_PGRM_RAMP_STEP_SHIFT) |
(127 << LED_PGRM_RAMP_INCREMENT_SHIFT);
/* 2nd command is ramp up rest of the way */
program[opcode++] =
(0 << LED_PGRM_RAMP_PRESCALE_SHIFT) |
(1 << LED_PGRM_RAMP_STEP_SHIFT) |
(127 << LED_PGRM_RAMP_INCREMENT_SHIFT);
/* 3rd: wait ((period - 2 * ramp_time) / 2) (15.6ms steps) */
program[opcode++] =
(1 << LED_PGRM_RAMP_PRESCALE_SHIFT) |
(((wait_time * 10) / 156) << LED_PGRM_RAMP_STEP_SHIFT) |
(0 << LED_PGRM_RAMP_INCREMENT_SHIFT);
/* ramp down is same as ramp up with sign bit set */
/* 4th command is ramp down 1/2 way */
program[opcode++] =
(0 << LED_PGRM_RAMP_PRESCALE_SHIFT) |
(1 << LED_PGRM_RAMP_STEP_SHIFT) |
(1 << LED_PGRM_RAMP_SIGN_SHIFT) |
(127 << LED_PGRM_RAMP_INCREMENT_SHIFT);
/* 5th command is ramp down rest of the way */
program[opcode++] =
(0 << LED_PGRM_RAMP_PRESCALE_SHIFT) |
(1 << LED_PGRM_RAMP_STEP_SHIFT) |
(1 << LED_PGRM_RAMP_SIGN_SHIFT) |
(127 << LED_PGRM_RAMP_INCREMENT_SHIFT);
/* 6th: wait ((period - 2 * ramp_time) / 2) (15.6ms steps) */
program[opcode++] =
(1 << LED_PGRM_RAMP_PRESCALE_SHIFT) |
(((wait_time * 10) / 156) << LED_PGRM_RAMP_STEP_SHIFT) |
(0 << LED_PGRM_RAMP_INCREMENT_SHIFT);
/* 7th command: repeat */
program[opcode++] = 0x00;
}
return lp5562_led_program_engine(dev_get_parent(dev), program,
opcode, priv->enginenum);
}
#endif
static const struct led_ops lp5562_led_ops = {
.get_state = lp5562_led_get_state,
.set_state = lp5562_led_set_state,
#ifdef CONFIG_LED_BLINK
.set_period = lp5562_led_set_period,
#endif
};
static int lp5562_led_probe(struct udevice *dev)
{
struct lp5562_led_priv *priv = dev_get_priv(dev);
u8 current;
int ret = 0;
/* Child LED nodes */
switch (dev_read_addr(dev)) {
case 0:
priv->reg_current = REG_R_CUR;
priv->reg_pwm = REG_R_PWM;
priv->map_shift = REG_LED_MAP_R_ENG_SHIFT;
priv->enginenum = 1;
break;
case 1:
priv->reg_current = REG_G_CUR;
priv->reg_pwm = REG_G_PWM;
priv->map_shift = REG_LED_MAP_G_ENG_SHIFT;
priv->enginenum = 2;
break;
case 2:
priv->reg_current = REG_B_CUR;
priv->reg_pwm = REG_B_PWM;
priv->map_shift = REG_LED_MAP_B_ENG_SHIFT;
priv->enginenum = 3; /* shared with white */
break;
case 3:
priv->reg_current = REG_W_CUR;
priv->map_shift = REG_LED_MAP_W_ENG_SHIFT;
priv->enginenum = 3; /* shared with blue */
break;
default:
return -EINVAL;
}
current = dev_read_u8_default(dev, "max-cur", DEFAULT_CURRENT);
ret = lp5562_led_reg_update(dev_get_parent(dev), priv->reg_current,
current, 0xff);
return ret;
}
static int lp5562_led_bind(struct udevice *dev)
{
struct led_uc_plat *uc_plat = dev_get_uclass_plat(dev);
/*
* For the child nodes, parse a "chan-name" property, since
* the DT bindings for this device use that instead of
* "label".
*/
uc_plat->label = dev_read_string(dev, "chan-name");
return 0;
}
U_BOOT_DRIVER(lp5562_led) = {
.name = "lp5562-led",
.id = UCLASS_LED,
.bind = lp5562_led_bind,
.probe = lp5562_led_probe,
.priv_auto = sizeof(struct lp5562_led_priv),
.ops = &lp5562_led_ops,
};
static int lp5562_led_wrap_probe(struct udevice *dev)
{
struct lp5562_led_wrap_priv *priv = dev_get_priv(dev);
u8 clock_mode;
int ret;
/* Enable gpio if needed */
if (gpio_request_by_name(dev, "enabled-gpios", 0,
&priv->enable_gpio, GPIOD_IS_OUT) == 0) {
dm_gpio_set_value(&priv->enable_gpio, 1);
udelay(1000);
}
/* Ensure all registers have default values. */
ret = lp5562_led_reg_update(dev, REG_RESET, REG_RESET_RESET, 0xff);
if (ret)
return ret;
udelay(10000);
/* Enable the chip */
ret = lp5562_led_reg_update(dev, REG_ENABLE, REG_ENABLE_CHIP_ENABLE, 0xff);
if (ret)
return ret;
/*
* The DT bindings say 0=auto, 1=internal, 2=external, while
* the register[0:1] values are 0=external, 1=internal,
* 2=auto.
*/
clock_mode = dev_read_u8_default(dev, "clock-mode", 0);
ret = lp5562_led_reg_update(dev, REG_CONFIG, 2 - clock_mode, REG_CONFIG_CLK_MASK);
return ret;
}
static int lp5562_led_wrap_bind(struct udevice *dev)
{
return led_bind_generic(dev, "lp5562-led");
}
static const struct udevice_id lp5562_led_ids[] = {
{ .compatible = "ti,lp5562" },
{ /* sentinel */ }
};
U_BOOT_DRIVER(lp5562_led_wrap) = {
.name = "lp5562-led-wrap",
.id = UCLASS_NOP,
.of_match = lp5562_led_ids,
.bind = lp5562_led_wrap_bind,
.probe = lp5562_led_wrap_probe,
.priv_auto = sizeof(struct lp5562_led_wrap_priv),
};