1 // SPDX-License-Identifier: GPL-2.0-or-later
3 // max20086-regulator.c - MAX20086-MAX20089 camera power protector driver
5 // Copyright (C) 2022 Laurent Pinchart <laurent.pinchart@idesonboard.com>
6 // Copyright (C) 2018 Avnet, Inc.
9 #include <linux/gpio.h>
10 #include <linux/gpio/consumer.h>
11 #include <linux/i2c.h>
12 #include <linux/module.h>
13 #include <linux/regmap.h>
14 #include <linux/regulator/driver.h>
15 #include <linux/regulator/machine.h>
16 #include <linux/regulator/of_regulator.h>
17 #include <linux/slab.h>
20 #define MAX20086_REG_MASK 0x00
21 #define MAX20086_REG_CONFIG 0x01
22 #define MAX20086_REG_ID 0x02
23 #define MAX20086_REG_STAT1 0x03
24 #define MAX20086_REG_STAT2_L 0x04
25 #define MAX20086_REG_STAT2_H 0x05
26 #define MAX20086_REG_ADC1 0x06
27 #define MAX20086_REG_ADC2 0x07
28 #define MAX20086_REG_ADC3 0x08
29 #define MAX20086_REG_ADC4 0x09
32 #define MAX20086_DEVICE_ID_MAX20086 0x40
33 #define MAX20086_DEVICE_ID_MAX20087 0x20
34 #define MAX20086_DEVICE_ID_MAX20088 0x10
35 #define MAX20086_DEVICE_ID_MAX20089 0x00
36 #define DEVICE_ID_MASK 0xf0
39 #define MAX20086_EN_MASK 0x0f
40 #define MAX20086_EN_OUT1 0x01
41 #define MAX20086_EN_OUT2 0x02
42 #define MAX20086_EN_OUT3 0x04
43 #define MAX20086_EN_OUT4 0x08
44 #define MAX20086_INT_DISABLE_ALL 0x3f
46 #define MAX20086_MAX_REGULATORS 4
48 struct max20086_chip_info {
50 unsigned int num_outputs;
53 struct max20086_regulator {
54 struct device_node *of_node;
55 struct regulator_init_data *init_data;
56 const struct regulator_desc *desc;
57 struct regulator_dev *rdev;
62 struct regmap *regmap;
63 struct gpio_desc *ena_gpiod;
65 const struct max20086_chip_info *info;
67 struct max20086_regulator regulators[MAX20086_MAX_REGULATORS];
70 static const struct regulator_ops max20086_buck_ops = {
71 .enable = regulator_enable_regmap,
72 .disable = regulator_disable_regmap,
73 .is_enabled = regulator_is_enabled_regmap,
76 #define MAX20086_REGULATOR_DESC(n) \
79 .supply_name = "in", \
81 .ops = &max20086_buck_ops, \
82 .type = REGULATOR_VOLTAGE, \
83 .owner = THIS_MODULE, \
84 .enable_reg = MAX20086_REG_CONFIG, \
85 .enable_mask = 1 << ((n) - 1), \
86 .enable_val = 1 << ((n) - 1), \
90 static const char * const max20086_output_names[] = {
97 static const struct regulator_desc max20086_regulators[] = {
98 MAX20086_REGULATOR_DESC(1),
99 MAX20086_REGULATOR_DESC(2),
100 MAX20086_REGULATOR_DESC(3),
101 MAX20086_REGULATOR_DESC(4),
104 static int max20086_regulators_register(struct max20086 *chip)
108 for (i = 0; i < chip->info->num_outputs; i++) {
109 struct max20086_regulator *reg = &chip->regulators[i];
110 struct regulator_config config = { };
111 struct regulator_dev *rdev;
113 config.dev = chip->dev;
114 config.init_data = reg->init_data;
115 config.driver_data = chip;
116 config.of_node = reg->of_node;
117 config.regmap = chip->regmap;
118 config.ena_gpiod = chip->ena_gpiod;
120 rdev = devm_regulator_register(chip->dev, reg->desc, &config);
123 "Failed to register regulator output %s\n",
125 return PTR_ERR(rdev);
134 static int max20086_parse_regulators_dt(struct max20086 *chip, bool *boot_on)
136 struct of_regulator_match matches[MAX20086_MAX_REGULATORS] = { };
137 struct device_node *node;
141 node = of_get_child_by_name(chip->dev->of_node, "regulators");
143 dev_err(chip->dev, "regulators node not found\n");
147 for (i = 0; i < chip->info->num_outputs; ++i)
148 matches[i].name = max20086_output_names[i];
150 ret = of_regulator_match(chip->dev, node, matches,
151 chip->info->num_outputs);
154 dev_err(chip->dev, "Failed to match regulators\n");
160 for (i = 0; i < chip->info->num_outputs; i++) {
161 struct max20086_regulator *reg = &chip->regulators[i];
163 reg->init_data = matches[i].init_data;
164 reg->of_node = matches[i].of_node;
165 reg->desc = &max20086_regulators[i];
167 if (reg->init_data) {
168 if (reg->init_data->constraints.always_on ||
169 reg->init_data->constraints.boot_on)
177 static int max20086_detect(struct max20086 *chip)
182 ret = regmap_read(chip->regmap, MAX20086_REG_ID, &data);
184 dev_err(chip->dev, "Failed to read DEVICE_ID reg: %d\n", ret);
188 if ((data & DEVICE_ID_MASK) != chip->info->id) {
189 dev_err(chip->dev, "Invalid device ID 0x%02x\n", data);
196 static bool max20086_gen_is_writeable_reg(struct device *dev, unsigned int reg)
199 case MAX20086_REG_MASK:
200 case MAX20086_REG_CONFIG:
207 static const struct regmap_config max20086_regmap_config = {
210 .writeable_reg = max20086_gen_is_writeable_reg,
212 .cache_type = REGCACHE_NONE,
215 static int max20086_i2c_probe(struct i2c_client *i2c)
217 struct max20086 *chip;
218 enum gpiod_flags flags;
222 chip = devm_kzalloc(&i2c->dev, sizeof(*chip), GFP_KERNEL);
226 chip->dev = &i2c->dev;
227 chip->info = device_get_match_data(chip->dev);
229 i2c_set_clientdata(i2c, chip);
231 chip->regmap = devm_regmap_init_i2c(i2c, &max20086_regmap_config);
232 if (IS_ERR(chip->regmap)) {
233 ret = PTR_ERR(chip->regmap);
234 dev_err(chip->dev, "Failed to allocate register map: %d\n", ret);
238 ret = max20086_parse_regulators_dt(chip, &boot_on);
242 ret = max20086_detect(chip);
246 /* Until IRQ support is added, just disable all interrupts. */
247 ret = regmap_update_bits(chip->regmap, MAX20086_REG_MASK,
248 MAX20086_INT_DISABLE_ALL,
249 MAX20086_INT_DISABLE_ALL);
251 dev_err(chip->dev, "Failed to disable interrupts: %d\n", ret);
256 * Get the enable GPIO. If any of the outputs is marked as being
257 * enabled at boot, request the GPIO with an initial high state to
258 * avoid disabling outputs that may have been turned on by the boot
259 * loader. Otherwise, request it with a low state to enter lower-power
262 flags = boot_on ? GPIOD_OUT_HIGH : GPIOD_OUT_LOW;
263 chip->ena_gpiod = devm_gpiod_get(chip->dev, "enable", flags);
264 if (IS_ERR(chip->ena_gpiod)) {
265 ret = PTR_ERR(chip->ena_gpiod);
266 dev_err(chip->dev, "Failed to get enable GPIO: %d\n", ret);
270 ret = max20086_regulators_register(chip);
272 dev_err(chip->dev, "Failed to register regulators: %d\n", ret);
279 static const struct i2c_device_id max20086_i2c_id[] = {
287 MODULE_DEVICE_TABLE(i2c, max20086_i2c_id);
289 static const struct of_device_id max20086_dt_ids[] __maybe_unused = {
291 .compatible = "maxim,max20086",
292 .data = &(const struct max20086_chip_info) {
293 .id = MAX20086_DEVICE_ID_MAX20086,
297 .compatible = "maxim,max20087",
298 .data = &(const struct max20086_chip_info) {
299 .id = MAX20086_DEVICE_ID_MAX20087,
303 .compatible = "maxim,max20088",
304 .data = &(const struct max20086_chip_info) {
305 .id = MAX20086_DEVICE_ID_MAX20088,
309 .compatible = "maxim,max20089",
310 .data = &(const struct max20086_chip_info) {
311 .id = MAX20086_DEVICE_ID_MAX20089,
318 MODULE_DEVICE_TABLE(of, max20086_dt_ids);
320 static struct i2c_driver max20086_regulator_driver = {
323 .probe_type = PROBE_PREFER_ASYNCHRONOUS,
324 .of_match_table = of_match_ptr(max20086_dt_ids),
326 .probe_new = max20086_i2c_probe,
327 .id_table = max20086_i2c_id,
330 module_i2c_driver(max20086_regulator_driver);
332 MODULE_AUTHOR("Watson Chow <watson.chow@avnet.com>");
333 MODULE_DESCRIPTION("MAX20086-MAX20089 Camera Power Protector Driver");
334 MODULE_LICENSE("GPL");