Linux Audio

Check our new training course

Open-source upstreaming

Need help get the support for your hardware in upstream Linux?
Loading...
v6.13.7
  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * LP5521 LED chip driver.
  4 *
  5 * Copyright (C) 2010 Nokia Corporation
  6 * Copyright (C) 2012 Texas Instruments
  7 *
  8 * Contact: Samu Onkalo <samu.p.onkalo@nokia.com>
  9 *          Milo(Woogyom) Kim <milo.kim@ti.com>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 10 */
 11
 12#include <linux/cleanup.h>
 13#include <linux/delay.h>
 14#include <linux/firmware.h>
 15#include <linux/i2c.h>
 16#include <linux/leds.h>
 17#include <linux/module.h>
 18#include <linux/mutex.h>
 19#include <linux/platform_data/leds-lp55xx.h>
 20#include <linux/slab.h>
 21#include <linux/of.h>
 22
 23#include "leds-lp55xx-common.h"
 24
 
 25#define LP5521_MAX_LEDS			3
 26#define LP5521_CMD_DIRECT		0x3F
 27
 28/* Registers */
 29#define LP5521_REG_ENABLE		0x00
 30#define LP5521_REG_OP_MODE		0x01
 31#define LP5521_REG_R_PWM		0x02
 32#define LP5521_REG_G_PWM		0x03
 33#define LP5521_REG_B_PWM		0x04
 34#define LP5521_REG_R_CURRENT		0x05
 35#define LP5521_REG_G_CURRENT		0x06
 36#define LP5521_REG_B_CURRENT		0x07
 37#define LP5521_REG_CONFIG		0x08
 38#define LP5521_REG_STATUS		0x0C
 39#define LP5521_REG_RESET		0x0D
 40#define LP5521_REG_R_PROG_MEM		0x10
 41#define LP5521_REG_G_PROG_MEM		0x30
 42#define LP5521_REG_B_PROG_MEM		0x50
 43
 44/* Base register to set LED current */
 45#define LP5521_REG_LED_CURRENT_BASE	LP5521_REG_R_CURRENT
 46/* Base register to set the brightness */
 47#define LP5521_REG_LED_PWM_BASE		LP5521_REG_R_PWM
 48
 49/* Bits in ENABLE register */
 50#define LP5521_MASTER_ENABLE		0x40	/* Chip master enable */
 51#define LP5521_LOGARITHMIC_PWM		0x80	/* Logarithmic PWM adjustment */
 52#define LP5521_EXEC_RUN			0x2A
 53#define LP5521_ENABLE_DEFAULT	\
 54	(LP5521_MASTER_ENABLE | LP5521_LOGARITHMIC_PWM)
 55#define LP5521_ENABLE_RUN_PROGRAM	\
 56	(LP5521_ENABLE_DEFAULT | LP5521_EXEC_RUN)
 57
 58/* CONFIG register */
 59#define LP5521_PWM_HF			0x40	/* PWM: 0 = 256Hz, 1 = 558Hz */
 60#define LP5521_PWRSAVE_EN		0x20	/* 1 = Power save mode */
 61#define LP5521_CP_MODE_MASK		0x18	/* Charge pump mode */
 62#define LP5521_CP_MODE_SHIFT		3
 
 
 63#define LP5521_R_TO_BATT		0x04	/* R out: 0 = CP, 1 = Vbat */
 64#define LP5521_CLK_INT			0x01	/* Internal clock */
 65#define LP5521_DEFAULT_CFG		(LP5521_PWM_HF | LP5521_PWRSAVE_EN)
 
 66
 67/* Status */
 68#define LP5521_EXT_CLK_USED		0x08
 69
 70/* default R channel current register value */
 71#define LP5521_REG_R_CURR_DEFAULT	0xAF
 72
 73/* Reset register value */
 74#define LP5521_RESET			0xFF
 75
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 76static inline void lp5521_wait_opmode_done(void)
 77{
 78	/* operation mode change needs to be longer than 153 us */
 79	usleep_range(200, 300);
 80}
 81
 82static inline void lp5521_wait_enable_done(void)
 83{
 84	/* it takes more 488 us to update ENABLE register */
 85	usleep_range(500, 600);
 86}
 87
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 88static void lp5521_run_engine(struct lp55xx_chip *chip, bool start)
 89{
 90	int ret;
 
 
 91
 92	/* stop engine */
 93	if (!start) {
 94		lp55xx_stop_engine(chip);
 95		lp55xx_write(chip, LP5521_REG_OP_MODE, LP5521_CMD_DIRECT);
 96		lp5521_wait_opmode_done();
 97		return;
 98	}
 99
100	ret = lp55xx_run_engine_common(chip);
101	if (!ret)
102		lp5521_wait_enable_done();
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
103}
104
105static int lp5521_post_init_device(struct lp55xx_chip *chip)
106{
107	int ret;
108	u8 val;
109
110	/*
111	 * Make sure that the chip is reset by reading back the r channel
112	 * current reg. This is dummy read is required on some platforms -
113	 * otherwise further access to the R G B channels in the
114	 * LP5521_REG_ENABLE register will not have any effect - strange!
115	 */
116	ret = lp55xx_read(chip, LP5521_REG_R_CURRENT, &val);
117	if (ret) {
118		dev_err(&chip->cl->dev, "error in resetting chip\n");
119		return ret;
120	}
121	if (val != LP5521_REG_R_CURR_DEFAULT) {
122		dev_err(&chip->cl->dev,
123			"unexpected data in register (expected 0x%x got 0x%x)\n",
124			LP5521_REG_R_CURR_DEFAULT, val);
125		ret = -EINVAL;
126		return ret;
127	}
128	usleep_range(10000, 20000);
129
130	/* Set all PWMs to direct control mode */
131	ret = lp55xx_write(chip, LP5521_REG_OP_MODE, LP5521_CMD_DIRECT);
132	if (ret)
133		return ret;
134
135	/* Update configuration for the clock setting */
136	val = LP5521_DEFAULT_CFG;
137	if (!lp55xx_is_extclk_used(chip))
138		val |= LP5521_CLK_INT;
139
140	val |= (chip->pdata->charge_pump_mode << LP5521_CP_MODE_SHIFT) & LP5521_CP_MODE_MASK;
141
142	ret = lp55xx_write(chip, LP5521_REG_CONFIG, val);
143	if (ret)
144		return ret;
145
146	/* Initialize all channels PWM to zero -> leds off */
147	lp55xx_write(chip, LP5521_REG_R_PWM, 0);
148	lp55xx_write(chip, LP5521_REG_G_PWM, 0);
149	lp55xx_write(chip, LP5521_REG_B_PWM, 0);
150
151	/* Set engines are set to run state when OP_MODE enables engines */
152	ret = lp55xx_write(chip, LP5521_REG_ENABLE, LP5521_ENABLE_RUN_PROGRAM);
153	if (ret)
154		return ret;
155
156	lp5521_wait_enable_done();
157
158	return 0;
159}
160
161static int lp5521_run_selftest(struct lp55xx_chip *chip, char *buf)
162{
163	struct lp55xx_platform_data *pdata = chip->pdata;
164	int ret;
165	u8 status;
166
167	ret = lp55xx_read(chip, LP5521_REG_STATUS, &status);
168	if (ret < 0)
169		return ret;
170
171	if (pdata->clock_mode != LP55XX_CLOCK_EXT)
172		return 0;
173
174	/* Check that ext clock is really in use if requested */
175	if  ((status & LP5521_EXT_CLK_USED) == 0)
176		return -EIO;
177
178	return 0;
179}
180
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
181static ssize_t lp5521_selftest(struct device *dev,
182			       struct device_attribute *attr,
183			       char *buf)
184{
185	struct lp55xx_led *led = i2c_get_clientdata(to_i2c_client(dev));
186	struct lp55xx_chip *chip = led->chip;
187	int ret;
188
189	guard(mutex)(&chip->lock);
190
191	ret = lp5521_run_selftest(chip, buf);
 
192
193	return sysfs_emit(buf, "%s\n", ret ? "FAIL" : "OK");
194}
195
196/* device attributes */
197LP55XX_DEV_ATTR_ENGINE_MODE(1);
198LP55XX_DEV_ATTR_ENGINE_MODE(2);
199LP55XX_DEV_ATTR_ENGINE_MODE(3);
200LP55XX_DEV_ATTR_ENGINE_LOAD(1);
201LP55XX_DEV_ATTR_ENGINE_LOAD(2);
202LP55XX_DEV_ATTR_ENGINE_LOAD(3);
203static LP55XX_DEV_ATTR_RO(selftest, lp5521_selftest);
204
205static struct attribute *lp5521_attributes[] = {
206	&dev_attr_engine1_mode.attr,
207	&dev_attr_engine2_mode.attr,
208	&dev_attr_engine3_mode.attr,
209	&dev_attr_engine1_load.attr,
210	&dev_attr_engine2_load.attr,
211	&dev_attr_engine3_load.attr,
212	&dev_attr_selftest.attr,
213	NULL
214};
215
216static const struct attribute_group lp5521_group = {
217	.attrs = lp5521_attributes,
218};
219
220/* Chip specific configurations */
221static struct lp55xx_device_config lp5521_cfg = {
222	.reg_op_mode = {
223		.addr = LP5521_REG_OP_MODE,
224	},
225	.reg_exec = {
226		.addr = LP5521_REG_ENABLE,
227	},
228	.reset = {
229		.addr = LP5521_REG_RESET,
230		.val  = LP5521_RESET,
231	},
232	.enable = {
233		.addr = LP5521_REG_ENABLE,
234		.val  = LP5521_ENABLE_DEFAULT,
235	},
236	.prog_mem_base = {
237		.addr = LP5521_REG_R_PROG_MEM,
238	},
239	.reg_led_pwm_base = {
240		.addr = LP5521_REG_LED_PWM_BASE,
241	},
242	.reg_led_current_base = {
243		.addr = LP5521_REG_LED_CURRENT_BASE,
244	},
245	.max_channel  = LP5521_MAX_LEDS,
246	.post_init_device   = lp5521_post_init_device,
247	.brightness_fn      = lp55xx_led_brightness,
248	.multicolor_brightness_fn = lp55xx_multicolor_brightness,
249	.set_led_current    = lp55xx_set_led_current,
250	.firmware_cb        = lp55xx_firmware_loaded_cb,
251	.run_engine         = lp5521_run_engine,
252	.dev_attr_group     = &lp5521_group,
253};
254
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
255static const struct i2c_device_id lp5521_id[] = {
256	{ "lp5521", .driver_data = (kernel_ulong_t)&lp5521_cfg, }, /* Three channel chip */
257	{ }
258};
259MODULE_DEVICE_TABLE(i2c, lp5521_id);
260
 
261static const struct of_device_id of_lp5521_leds_match[] = {
262	{ .compatible = "national,lp5521", .data = &lp5521_cfg, },
263	{},
264};
265
266MODULE_DEVICE_TABLE(of, of_lp5521_leds_match);
267
268static struct i2c_driver lp5521_driver = {
269	.driver = {
270		.name	= "lp5521",
271		.of_match_table = of_lp5521_leds_match,
272	},
273	.probe		= lp55xx_probe,
274	.remove		= lp55xx_remove,
275	.id_table	= lp5521_id,
276};
277
278module_i2c_driver(lp5521_driver);
279
280MODULE_AUTHOR("Mathias Nyman, Yuri Zaporozhets, Samu Onkalo");
281MODULE_AUTHOR("Milo Kim <milo.kim@ti.com>");
282MODULE_DESCRIPTION("LP5521 LED engine");
283MODULE_LICENSE("GPL v2");
v4.10.11
 
  1/*
  2 * LP5521 LED chip driver.
  3 *
  4 * Copyright (C) 2010 Nokia Corporation
  5 * Copyright (C) 2012 Texas Instruments
  6 *
  7 * Contact: Samu Onkalo <samu.p.onkalo@nokia.com>
  8 *          Milo(Woogyom) Kim <milo.kim@ti.com>
  9 *
 10 * This program is free software; you can redistribute it and/or
 11 * modify it under the terms of the GNU General Public License
 12 * version 2 as published by the Free Software Foundation.
 13 *
 14 * This program is distributed in the hope that it will be useful, but
 15 * WITHOUT ANY WARRANTY; without even the implied warranty of
 16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
 17 * General Public License for more details.
 18 *
 19 * You should have received a copy of the GNU General Public License
 20 * along with this program; if not, write to the Free Software
 21 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 22 * 02110-1301 USA
 23 */
 24
 
 25#include <linux/delay.h>
 26#include <linux/firmware.h>
 27#include <linux/i2c.h>
 28#include <linux/leds.h>
 29#include <linux/module.h>
 30#include <linux/mutex.h>
 31#include <linux/platform_data/leds-lp55xx.h>
 32#include <linux/slab.h>
 33#include <linux/of.h>
 34
 35#include "leds-lp55xx-common.h"
 36
 37#define LP5521_PROGRAM_LENGTH		32
 38#define LP5521_MAX_LEDS			3
 39#define LP5521_CMD_DIRECT		0x3F
 40
 41/* Registers */
 42#define LP5521_REG_ENABLE		0x00
 43#define LP5521_REG_OP_MODE		0x01
 44#define LP5521_REG_R_PWM		0x02
 45#define LP5521_REG_G_PWM		0x03
 46#define LP5521_REG_B_PWM		0x04
 47#define LP5521_REG_R_CURRENT		0x05
 48#define LP5521_REG_G_CURRENT		0x06
 49#define LP5521_REG_B_CURRENT		0x07
 50#define LP5521_REG_CONFIG		0x08
 51#define LP5521_REG_STATUS		0x0C
 52#define LP5521_REG_RESET		0x0D
 53#define LP5521_REG_R_PROG_MEM		0x10
 54#define LP5521_REG_G_PROG_MEM		0x30
 55#define LP5521_REG_B_PROG_MEM		0x50
 56
 57/* Base register to set LED current */
 58#define LP5521_REG_LED_CURRENT_BASE	LP5521_REG_R_CURRENT
 59/* Base register to set the brightness */
 60#define LP5521_REG_LED_PWM_BASE		LP5521_REG_R_PWM
 61
 62/* Bits in ENABLE register */
 63#define LP5521_MASTER_ENABLE		0x40	/* Chip master enable */
 64#define LP5521_LOGARITHMIC_PWM		0x80	/* Logarithmic PWM adjustment */
 65#define LP5521_EXEC_RUN			0x2A
 66#define LP5521_ENABLE_DEFAULT	\
 67	(LP5521_MASTER_ENABLE | LP5521_LOGARITHMIC_PWM)
 68#define LP5521_ENABLE_RUN_PROGRAM	\
 69	(LP5521_ENABLE_DEFAULT | LP5521_EXEC_RUN)
 70
 71/* CONFIG register */
 72#define LP5521_PWM_HF			0x40	/* PWM: 0 = 256Hz, 1 = 558Hz */
 73#define LP5521_PWRSAVE_EN		0x20	/* 1 = Power save mode */
 74#define LP5521_CP_MODE_OFF		0	/* Charge pump (CP) off */
 75#define LP5521_CP_MODE_BYPASS		8	/* CP forced to bypass mode */
 76#define LP5521_CP_MODE_1X5		0x10	/* CP forced to 1.5x mode */
 77#define LP5521_CP_MODE_AUTO		0x18	/* Automatic mode selection */
 78#define LP5521_R_TO_BATT		0x04	/* R out: 0 = CP, 1 = Vbat */
 79#define LP5521_CLK_INT			0x01	/* Internal clock */
 80#define LP5521_DEFAULT_CFG		\
 81	(LP5521_PWM_HF | LP5521_PWRSAVE_EN | LP5521_CP_MODE_AUTO)
 82
 83/* Status */
 84#define LP5521_EXT_CLK_USED		0x08
 85
 86/* default R channel current register value */
 87#define LP5521_REG_R_CURR_DEFAULT	0xAF
 88
 89/* Reset register value */
 90#define LP5521_RESET			0xFF
 91
 92/* Program Memory Operations */
 93#define LP5521_MODE_R_M			0x30	/* Operation Mode Register */
 94#define LP5521_MODE_G_M			0x0C
 95#define LP5521_MODE_B_M			0x03
 96#define LP5521_LOAD_R			0x10
 97#define LP5521_LOAD_G			0x04
 98#define LP5521_LOAD_B			0x01
 99
100#define LP5521_R_IS_LOADING(mode)	\
101	((mode & LP5521_MODE_R_M) == LP5521_LOAD_R)
102#define LP5521_G_IS_LOADING(mode)	\
103	((mode & LP5521_MODE_G_M) == LP5521_LOAD_G)
104#define LP5521_B_IS_LOADING(mode)	\
105	((mode & LP5521_MODE_B_M) == LP5521_LOAD_B)
106
107#define LP5521_EXEC_R_M			0x30	/* Enable Register */
108#define LP5521_EXEC_G_M			0x0C
109#define LP5521_EXEC_B_M			0x03
110#define LP5521_EXEC_M			0x3F
111#define LP5521_RUN_R			0x20
112#define LP5521_RUN_G			0x08
113#define LP5521_RUN_B			0x02
114
115static inline void lp5521_wait_opmode_done(void)
116{
117	/* operation mode change needs to be longer than 153 us */
118	usleep_range(200, 300);
119}
120
121static inline void lp5521_wait_enable_done(void)
122{
123	/* it takes more 488 us to update ENABLE register */
124	usleep_range(500, 600);
125}
126
127static void lp5521_set_led_current(struct lp55xx_led *led, u8 led_current)
128{
129	led->led_current = led_current;
130	lp55xx_write(led->chip, LP5521_REG_LED_CURRENT_BASE + led->chan_nr,
131		led_current);
132}
133
134static void lp5521_load_engine(struct lp55xx_chip *chip)
135{
136	enum lp55xx_engine_index idx = chip->engine_idx;
137	u8 mask[] = {
138		[LP55XX_ENGINE_1] = LP5521_MODE_R_M,
139		[LP55XX_ENGINE_2] = LP5521_MODE_G_M,
140		[LP55XX_ENGINE_3] = LP5521_MODE_B_M,
141	};
142
143	u8 val[] = {
144		[LP55XX_ENGINE_1] = LP5521_LOAD_R,
145		[LP55XX_ENGINE_2] = LP5521_LOAD_G,
146		[LP55XX_ENGINE_3] = LP5521_LOAD_B,
147	};
148
149	lp55xx_update_bits(chip, LP5521_REG_OP_MODE, mask[idx], val[idx]);
150
151	lp5521_wait_opmode_done();
152}
153
154static void lp5521_stop_all_engines(struct lp55xx_chip *chip)
155{
156	lp55xx_write(chip, LP5521_REG_OP_MODE, 0);
157	lp5521_wait_opmode_done();
158}
159
160static void lp5521_stop_engine(struct lp55xx_chip *chip)
161{
162	enum lp55xx_engine_index idx = chip->engine_idx;
163	u8 mask[] = {
164		[LP55XX_ENGINE_1] = LP5521_MODE_R_M,
165		[LP55XX_ENGINE_2] = LP5521_MODE_G_M,
166		[LP55XX_ENGINE_3] = LP5521_MODE_B_M,
167	};
168
169	lp55xx_update_bits(chip, LP5521_REG_OP_MODE, mask[idx], 0);
170
171	lp5521_wait_opmode_done();
172}
173
174static void lp5521_run_engine(struct lp55xx_chip *chip, bool start)
175{
176	int ret;
177	u8 mode;
178	u8 exec;
179
180	/* stop engine */
181	if (!start) {
182		lp5521_stop_engine(chip);
183		lp55xx_write(chip, LP5521_REG_OP_MODE, LP5521_CMD_DIRECT);
184		lp5521_wait_opmode_done();
185		return;
186	}
187
188	/*
189	 * To run the engine,
190	 * operation mode and enable register should updated at the same time
191	 */
192
193	ret = lp55xx_read(chip, LP5521_REG_OP_MODE, &mode);
194	if (ret)
195		return;
196
197	ret = lp55xx_read(chip, LP5521_REG_ENABLE, &exec);
198	if (ret)
199		return;
200
201	/* change operation mode to RUN only when each engine is loading */
202	if (LP5521_R_IS_LOADING(mode)) {
203		mode = (mode & ~LP5521_MODE_R_M) | LP5521_RUN_R;
204		exec = (exec & ~LP5521_EXEC_R_M) | LP5521_RUN_R;
205	}
206
207	if (LP5521_G_IS_LOADING(mode)) {
208		mode = (mode & ~LP5521_MODE_G_M) | LP5521_RUN_G;
209		exec = (exec & ~LP5521_EXEC_G_M) | LP5521_RUN_G;
210	}
211
212	if (LP5521_B_IS_LOADING(mode)) {
213		mode = (mode & ~LP5521_MODE_B_M) | LP5521_RUN_B;
214		exec = (exec & ~LP5521_EXEC_B_M) | LP5521_RUN_B;
215	}
216
217	lp55xx_write(chip, LP5521_REG_OP_MODE, mode);
218	lp5521_wait_opmode_done();
219
220	lp55xx_update_bits(chip, LP5521_REG_ENABLE, LP5521_EXEC_M, exec);
221	lp5521_wait_enable_done();
222}
223
224static int lp5521_update_program_memory(struct lp55xx_chip *chip,
225					const u8 *data, size_t size)
226{
227	enum lp55xx_engine_index idx = chip->engine_idx;
228	u8 pattern[LP5521_PROGRAM_LENGTH] = {0};
229	u8 addr[] = {
230		[LP55XX_ENGINE_1] = LP5521_REG_R_PROG_MEM,
231		[LP55XX_ENGINE_2] = LP5521_REG_G_PROG_MEM,
232		[LP55XX_ENGINE_3] = LP5521_REG_B_PROG_MEM,
233	};
234	unsigned cmd;
235	char c[3];
236	int nrchars;
237	int ret;
238	int offset = 0;
239	int i = 0;
240
241	while ((offset < size - 1) && (i < LP5521_PROGRAM_LENGTH)) {
242		/* separate sscanfs because length is working only for %s */
243		ret = sscanf(data + offset, "%2s%n ", c, &nrchars);
244		if (ret != 1)
245			goto err;
246
247		ret = sscanf(c, "%2x", &cmd);
248		if (ret != 1)
249			goto err;
250
251		pattern[i] = (u8)cmd;
252		offset += nrchars;
253		i++;
254	}
255
256	/* Each instruction is 16bit long. Check that length is even */
257	if (i % 2)
258		goto err;
259
260	for (i = 0; i < LP5521_PROGRAM_LENGTH; i++) {
261		ret = lp55xx_write(chip, addr[idx] + i, pattern[i]);
262		if (ret)
263			return -EINVAL;
264	}
265
266	return size;
267
268err:
269	dev_err(&chip->cl->dev, "wrong pattern format\n");
270	return -EINVAL;
271}
272
273static void lp5521_firmware_loaded(struct lp55xx_chip *chip)
274{
275	const struct firmware *fw = chip->fw;
276
277	if (fw->size > LP5521_PROGRAM_LENGTH) {
278		dev_err(&chip->cl->dev, "firmware data size overflow: %zu\n",
279			fw->size);
280		return;
281	}
282
283	/*
284	 * Program momery sequence
285	 *  1) set engine mode to "LOAD"
286	 *  2) write firmware data into program memory
287	 */
288
289	lp5521_load_engine(chip);
290	lp5521_update_program_memory(chip, fw->data, fw->size);
291}
292
293static int lp5521_post_init_device(struct lp55xx_chip *chip)
294{
295	int ret;
296	u8 val;
297
298	/*
299	 * Make sure that the chip is reset by reading back the r channel
300	 * current reg. This is dummy read is required on some platforms -
301	 * otherwise further access to the R G B channels in the
302	 * LP5521_REG_ENABLE register will not have any effect - strange!
303	 */
304	ret = lp55xx_read(chip, LP5521_REG_R_CURRENT, &val);
305	if (ret) {
306		dev_err(&chip->cl->dev, "error in resetting chip\n");
307		return ret;
308	}
309	if (val != LP5521_REG_R_CURR_DEFAULT) {
310		dev_err(&chip->cl->dev,
311			"unexpected data in register (expected 0x%x got 0x%x)\n",
312			LP5521_REG_R_CURR_DEFAULT, val);
313		ret = -EINVAL;
314		return ret;
315	}
316	usleep_range(10000, 20000);
317
318	/* Set all PWMs to direct control mode */
319	ret = lp55xx_write(chip, LP5521_REG_OP_MODE, LP5521_CMD_DIRECT);
 
 
320
321	/* Update configuration for the clock setting */
322	val = LP5521_DEFAULT_CFG;
323	if (!lp55xx_is_extclk_used(chip))
324		val |= LP5521_CLK_INT;
325
 
 
326	ret = lp55xx_write(chip, LP5521_REG_CONFIG, val);
327	if (ret)
328		return ret;
329
330	/* Initialize all channels PWM to zero -> leds off */
331	lp55xx_write(chip, LP5521_REG_R_PWM, 0);
332	lp55xx_write(chip, LP5521_REG_G_PWM, 0);
333	lp55xx_write(chip, LP5521_REG_B_PWM, 0);
334
335	/* Set engines are set to run state when OP_MODE enables engines */
336	ret = lp55xx_write(chip, LP5521_REG_ENABLE, LP5521_ENABLE_RUN_PROGRAM);
337	if (ret)
338		return ret;
339
340	lp5521_wait_enable_done();
341
342	return 0;
343}
344
345static int lp5521_run_selftest(struct lp55xx_chip *chip, char *buf)
346{
347	struct lp55xx_platform_data *pdata = chip->pdata;
348	int ret;
349	u8 status;
350
351	ret = lp55xx_read(chip, LP5521_REG_STATUS, &status);
352	if (ret < 0)
353		return ret;
354
355	if (pdata->clock_mode != LP55XX_CLOCK_EXT)
356		return 0;
357
358	/* Check that ext clock is really in use if requested */
359	if  ((status & LP5521_EXT_CLK_USED) == 0)
360		return -EIO;
361
362	return 0;
363}
364
365static int lp5521_led_brightness(struct lp55xx_led *led)
366{
367	struct lp55xx_chip *chip = led->chip;
368	int ret;
369
370	mutex_lock(&chip->lock);
371	ret = lp55xx_write(chip, LP5521_REG_LED_PWM_BASE + led->chan_nr,
372		led->brightness);
373	mutex_unlock(&chip->lock);
374
375	return ret;
376}
377
378static ssize_t show_engine_mode(struct device *dev,
379				struct device_attribute *attr,
380				char *buf, int nr)
381{
382	struct lp55xx_led *led = i2c_get_clientdata(to_i2c_client(dev));
383	struct lp55xx_chip *chip = led->chip;
384	enum lp55xx_engine_mode mode = chip->engines[nr - 1].mode;
385
386	switch (mode) {
387	case LP55XX_ENGINE_RUN:
388		return sprintf(buf, "run\n");
389	case LP55XX_ENGINE_LOAD:
390		return sprintf(buf, "load\n");
391	case LP55XX_ENGINE_DISABLED:
392	default:
393		return sprintf(buf, "disabled\n");
394	}
395}
396show_mode(1)
397show_mode(2)
398show_mode(3)
399
400static ssize_t store_engine_mode(struct device *dev,
401				 struct device_attribute *attr,
402				 const char *buf, size_t len, int nr)
403{
404	struct lp55xx_led *led = i2c_get_clientdata(to_i2c_client(dev));
405	struct lp55xx_chip *chip = led->chip;
406	struct lp55xx_engine *engine = &chip->engines[nr - 1];
407
408	mutex_lock(&chip->lock);
409
410	chip->engine_idx = nr;
411
412	if (!strncmp(buf, "run", 3)) {
413		lp5521_run_engine(chip, true);
414		engine->mode = LP55XX_ENGINE_RUN;
415	} else if (!strncmp(buf, "load", 4)) {
416		lp5521_stop_engine(chip);
417		lp5521_load_engine(chip);
418		engine->mode = LP55XX_ENGINE_LOAD;
419	} else if (!strncmp(buf, "disabled", 8)) {
420		lp5521_stop_engine(chip);
421		engine->mode = LP55XX_ENGINE_DISABLED;
422	}
423
424	mutex_unlock(&chip->lock);
425
426	return len;
427}
428store_mode(1)
429store_mode(2)
430store_mode(3)
431
432static ssize_t store_engine_load(struct device *dev,
433			     struct device_attribute *attr,
434			     const char *buf, size_t len, int nr)
435{
436	struct lp55xx_led *led = i2c_get_clientdata(to_i2c_client(dev));
437	struct lp55xx_chip *chip = led->chip;
438	int ret;
439
440	mutex_lock(&chip->lock);
441
442	chip->engine_idx = nr;
443	lp5521_load_engine(chip);
444	ret = lp5521_update_program_memory(chip, buf, len);
445
446	mutex_unlock(&chip->lock);
447
448	return ret;
449}
450store_load(1)
451store_load(2)
452store_load(3)
453
454static ssize_t lp5521_selftest(struct device *dev,
455			       struct device_attribute *attr,
456			       char *buf)
457{
458	struct lp55xx_led *led = i2c_get_clientdata(to_i2c_client(dev));
459	struct lp55xx_chip *chip = led->chip;
460	int ret;
461
462	mutex_lock(&chip->lock);
 
463	ret = lp5521_run_selftest(chip, buf);
464	mutex_unlock(&chip->lock);
465
466	return scnprintf(buf, PAGE_SIZE, "%s\n", ret ? "FAIL" : "OK");
467}
468
469/* device attributes */
470static LP55XX_DEV_ATTR_RW(engine1_mode, show_engine1_mode, store_engine1_mode);
471static LP55XX_DEV_ATTR_RW(engine2_mode, show_engine2_mode, store_engine2_mode);
472static LP55XX_DEV_ATTR_RW(engine3_mode, show_engine3_mode, store_engine3_mode);
473static LP55XX_DEV_ATTR_WO(engine1_load, store_engine1_load);
474static LP55XX_DEV_ATTR_WO(engine2_load, store_engine2_load);
475static LP55XX_DEV_ATTR_WO(engine3_load, store_engine3_load);
476static LP55XX_DEV_ATTR_RO(selftest, lp5521_selftest);
477
478static struct attribute *lp5521_attributes[] = {
479	&dev_attr_engine1_mode.attr,
480	&dev_attr_engine2_mode.attr,
481	&dev_attr_engine3_mode.attr,
482	&dev_attr_engine1_load.attr,
483	&dev_attr_engine2_load.attr,
484	&dev_attr_engine3_load.attr,
485	&dev_attr_selftest.attr,
486	NULL
487};
488
489static const struct attribute_group lp5521_group = {
490	.attrs = lp5521_attributes,
491};
492
493/* Chip specific configurations */
494static struct lp55xx_device_config lp5521_cfg = {
 
 
 
 
 
 
495	.reset = {
496		.addr = LP5521_REG_RESET,
497		.val  = LP5521_RESET,
498	},
499	.enable = {
500		.addr = LP5521_REG_ENABLE,
501		.val  = LP5521_ENABLE_DEFAULT,
502	},
 
 
 
 
 
 
 
 
 
503	.max_channel  = LP5521_MAX_LEDS,
504	.post_init_device   = lp5521_post_init_device,
505	.brightness_fn      = lp5521_led_brightness,
506	.set_led_current    = lp5521_set_led_current,
507	.firmware_cb        = lp5521_firmware_loaded,
 
508	.run_engine         = lp5521_run_engine,
509	.dev_attr_group     = &lp5521_group,
510};
511
512static int lp5521_probe(struct i2c_client *client,
513			const struct i2c_device_id *id)
514{
515	int ret;
516	struct lp55xx_chip *chip;
517	struct lp55xx_led *led;
518	struct lp55xx_platform_data *pdata = dev_get_platdata(&client->dev);
519	struct device_node *np = client->dev.of_node;
520
521	if (!pdata) {
522		if (np) {
523			pdata = lp55xx_of_populate_pdata(&client->dev, np);
524			if (IS_ERR(pdata))
525				return PTR_ERR(pdata);
526		} else {
527			dev_err(&client->dev, "no platform data\n");
528			return -EINVAL;
529		}
530	}
531
532	chip = devm_kzalloc(&client->dev, sizeof(*chip), GFP_KERNEL);
533	if (!chip)
534		return -ENOMEM;
535
536	led = devm_kzalloc(&client->dev,
537			sizeof(*led) * pdata->num_channels, GFP_KERNEL);
538	if (!led)
539		return -ENOMEM;
540
541	chip->cl = client;
542	chip->pdata = pdata;
543	chip->cfg = &lp5521_cfg;
544
545	mutex_init(&chip->lock);
546
547	i2c_set_clientdata(client, led);
548
549	ret = lp55xx_init_device(chip);
550	if (ret)
551		goto err_init;
552
553	dev_info(&client->dev, "%s programmable led chip found\n", id->name);
554
555	ret = lp55xx_register_leds(led, chip);
556	if (ret)
557		goto err_register_leds;
558
559	ret = lp55xx_register_sysfs(chip);
560	if (ret) {
561		dev_err(&client->dev, "registering sysfs failed\n");
562		goto err_register_sysfs;
563	}
564
565	return 0;
566
567err_register_sysfs:
568	lp55xx_unregister_leds(led, chip);
569err_register_leds:
570	lp55xx_deinit_device(chip);
571err_init:
572	return ret;
573}
574
575static int lp5521_remove(struct i2c_client *client)
576{
577	struct lp55xx_led *led = i2c_get_clientdata(client);
578	struct lp55xx_chip *chip = led->chip;
579
580	lp5521_stop_all_engines(chip);
581	lp55xx_unregister_sysfs(chip);
582	lp55xx_unregister_leds(led, chip);
583	lp55xx_deinit_device(chip);
584
585	return 0;
586}
587
588static const struct i2c_device_id lp5521_id[] = {
589	{ "lp5521", 0 }, /* Three channel chip */
590	{ }
591};
592MODULE_DEVICE_TABLE(i2c, lp5521_id);
593
594#ifdef CONFIG_OF
595static const struct of_device_id of_lp5521_leds_match[] = {
596	{ .compatible = "national,lp5521", },
597	{},
598};
599
600MODULE_DEVICE_TABLE(of, of_lp5521_leds_match);
601#endif
602static struct i2c_driver lp5521_driver = {
603	.driver = {
604		.name	= "lp5521",
605		.of_match_table = of_match_ptr(of_lp5521_leds_match),
606	},
607	.probe		= lp5521_probe,
608	.remove		= lp5521_remove,
609	.id_table	= lp5521_id,
610};
611
612module_i2c_driver(lp5521_driver);
613
614MODULE_AUTHOR("Mathias Nyman, Yuri Zaporozhets, Samu Onkalo");
615MODULE_AUTHOR("Milo Kim <milo.kim@ti.com>");
616MODULE_DESCRIPTION("LP5521 LED engine");
617MODULE_LICENSE("GPL v2");