1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * TI LMU (Lighting Management Unit) Core Driver
4 *
5 * Copyright 2017 Texas Instruments
6 *
7 * Author: Milo Kim <milo.kim@ti.com>
8 */
9
10#include <linux/delay.h>
11#include <linux/err.h>
12#include <linux/gpio/consumer.h>
13#include <linux/i2c.h>
14#include <linux/kernel.h>
15#include <linux/mfd/core.h>
16#include <linux/mfd/ti-lmu.h>
17#include <linux/mfd/ti-lmu-register.h>
18#include <linux/module.h>
19#include <linux/of.h>
20#include <linux/slab.h>
21
22struct ti_lmu_data {
23 const struct mfd_cell *cells;
24 int num_cells;
25 unsigned int max_register;
26};
27
28static int ti_lmu_enable_hw(struct ti_lmu *lmu, enum ti_lmu_id id)
29{
30 if (lmu->en_gpio)
31 gpiod_set_value(desc: lmu->en_gpio, value: 1);
32
33 /* Delay about 1ms after HW enable pin control */
34 usleep_range(min: 1000, max: 1500);
35
36 /* LM3631 has additional power up sequence - enable LCD_EN bit. */
37 if (id == LM3631) {
38 return regmap_update_bits(map: lmu->regmap, LM3631_REG_DEVCTRL,
39 LM3631_LCD_EN_MASK,
40 LM3631_LCD_EN_MASK);
41 }
42
43 return 0;
44}
45
46static void ti_lmu_disable_hw(void *data)
47{
48 struct ti_lmu *lmu = data;
49 if (lmu->en_gpio)
50 gpiod_set_value(desc: lmu->en_gpio, value: 0);
51}
52
53#define LM363X_REGULATOR(_id) \
54{ \
55 .name = "lm363x-regulator", \
56 .id = _id, \
57 .of_compatible = "ti,lm363x-regulator", \
58} \
59
60static const struct mfd_cell lm3631_devices[] = {
61 LM363X_REGULATOR(LM3631_BOOST),
62 LM363X_REGULATOR(LM3631_LDO_CONT),
63 LM363X_REGULATOR(LM3631_LDO_OREF),
64 LM363X_REGULATOR(LM3631_LDO_POS),
65 LM363X_REGULATOR(LM3631_LDO_NEG),
66 {
67 .name = "ti-lmu-backlight",
68 .id = LM3631,
69 .of_compatible = "ti,lm3631-backlight",
70 },
71};
72
73static const struct mfd_cell lm3632_devices[] = {
74 LM363X_REGULATOR(LM3632_BOOST),
75 LM363X_REGULATOR(LM3632_LDO_POS),
76 LM363X_REGULATOR(LM3632_LDO_NEG),
77 {
78 .name = "ti-lmu-backlight",
79 .id = LM3632,
80 .of_compatible = "ti,lm3632-backlight",
81 },
82};
83
84static const struct mfd_cell lm3633_devices[] = {
85 {
86 .name = "ti-lmu-backlight",
87 .id = LM3633,
88 .of_compatible = "ti,lm3633-backlight",
89 },
90 {
91 .name = "lm3633-leds",
92 .of_compatible = "ti,lm3633-leds",
93 },
94 /* Monitoring driver for open/short circuit detection */
95 {
96 .name = "ti-lmu-fault-monitor",
97 .id = LM3633,
98 .of_compatible = "ti,lm3633-fault-monitor",
99 },
100};
101
102static const struct mfd_cell lm3695_devices[] = {
103 {
104 .name = "ti-lmu-backlight",
105 .id = LM3695,
106 .of_compatible = "ti,lm3695-backlight",
107 },
108};
109
110static const struct mfd_cell lm36274_devices[] = {
111 LM363X_REGULATOR(LM36274_BOOST),
112 LM363X_REGULATOR(LM36274_LDO_POS),
113 LM363X_REGULATOR(LM36274_LDO_NEG),
114 {
115 .name = "lm36274-leds",
116 .id = LM36274,
117 .of_compatible = "ti,lm36274-backlight",
118 },
119};
120
121#define TI_LMU_DATA(chip, max_reg) \
122static const struct ti_lmu_data chip##_data = \
123{ \
124 .cells = chip##_devices, \
125 .num_cells = ARRAY_SIZE(chip##_devices),\
126 .max_register = max_reg, \
127} \
128
129TI_LMU_DATA(lm3631, LM3631_MAX_REG);
130TI_LMU_DATA(lm3632, LM3632_MAX_REG);
131TI_LMU_DATA(lm3633, LM3633_MAX_REG);
132TI_LMU_DATA(lm3695, LM3695_MAX_REG);
133TI_LMU_DATA(lm36274, LM36274_MAX_REG);
134
135static int ti_lmu_probe(struct i2c_client *cl)
136{
137 const struct i2c_device_id *id = i2c_client_get_device_id(client: cl);
138 struct device *dev = &cl->dev;
139 const struct ti_lmu_data *data;
140 struct regmap_config regmap_cfg;
141 struct ti_lmu *lmu;
142 int ret;
143
144 /*
145 * Get device specific data from of_match table.
146 * This data is defined by using TI_LMU_DATA() macro.
147 */
148 data = of_device_get_match_data(dev);
149 if (!data)
150 return -ENODEV;
151
152 lmu = devm_kzalloc(dev, size: sizeof(*lmu), GFP_KERNEL);
153 if (!lmu)
154 return -ENOMEM;
155
156 lmu->dev = &cl->dev;
157
158 /* Setup regmap */
159 memset(&regmap_cfg, 0, sizeof(struct regmap_config));
160 regmap_cfg.reg_bits = 8;
161 regmap_cfg.val_bits = 8;
162 regmap_cfg.name = id->name;
163 regmap_cfg.max_register = data->max_register;
164
165 lmu->regmap = devm_regmap_init_i2c(cl, &regmap_cfg);
166 if (IS_ERR(ptr: lmu->regmap))
167 return PTR_ERR(ptr: lmu->regmap);
168
169 /* HW enable pin control and additional power up sequence if required */
170 lmu->en_gpio = devm_gpiod_get_optional(dev, con_id: "enable", flags: GPIOD_OUT_HIGH);
171 if (IS_ERR(ptr: lmu->en_gpio)) {
172 ret = PTR_ERR(ptr: lmu->en_gpio);
173 dev_err(dev, "Can not request enable GPIO: %d\n", ret);
174 return ret;
175 }
176
177 ret = ti_lmu_enable_hw(lmu, id: id->driver_data);
178 if (ret)
179 return ret;
180
181 ret = devm_add_action_or_reset(dev, ti_lmu_disable_hw, lmu);
182 if (ret)
183 return ret;
184
185 /*
186 * Fault circuit(open/short) can be detected by ti-lmu-fault-monitor.
187 * After fault detection is done, some devices should re-initialize
188 * configuration. The notifier enables such kind of handling.
189 */
190 BLOCKING_INIT_NOTIFIER_HEAD(&lmu->notifier);
191
192 i2c_set_clientdata(client: cl, data: lmu);
193
194 return devm_mfd_add_devices(dev: lmu->dev, id: 0, cells: data->cells,
195 n_devs: data->num_cells, NULL, irq_base: 0, NULL);
196}
197
198static const struct of_device_id ti_lmu_of_match[] = {
199 { .compatible = "ti,lm3631", .data = &lm3631_data },
200 { .compatible = "ti,lm3632", .data = &lm3632_data },
201 { .compatible = "ti,lm3633", .data = &lm3633_data },
202 { .compatible = "ti,lm3695", .data = &lm3695_data },
203 { .compatible = "ti,lm36274", .data = &lm36274_data },
204 { }
205};
206MODULE_DEVICE_TABLE(of, ti_lmu_of_match);
207
208static const struct i2c_device_id ti_lmu_ids[] = {
209 { "lm3631", LM3631 },
210 { "lm3632", LM3632 },
211 { "lm3633", LM3633 },
212 { "lm3695", LM3695 },
213 { "lm36274", LM36274 },
214 { }
215};
216MODULE_DEVICE_TABLE(i2c, ti_lmu_ids);
217
218static struct i2c_driver ti_lmu_driver = {
219 .probe = ti_lmu_probe,
220 .driver = {
221 .name = "ti-lmu",
222 .of_match_table = ti_lmu_of_match,
223 },
224 .id_table = ti_lmu_ids,
225};
226
227module_i2c_driver(ti_lmu_driver);
228
229MODULE_DESCRIPTION("TI LMU MFD Core Driver");
230MODULE_AUTHOR("Milo Kim");
231MODULE_LICENSE("GPL v2");
232

source code of linux/drivers/mfd/ti-lmu.c