xref: /openbmc/linux/drivers/mfd/max77686.c (revision aa311596)
1 // SPDX-License-Identifier: GPL-2.0+
2 //
3 // max77686.c - mfd core driver for the Maxim 77686/802
4 //
5 // Copyright (C) 2012 Samsung Electronics
6 // Chiwoong Byun <woong.byun@samsung.com>
7 // Jonghwa Lee <jonghwa3.lee@samsung.com>
8 //
9 //This driver is based on max8997.c
10 
11 #include <linux/export.h>
12 #include <linux/slab.h>
13 #include <linux/i2c.h>
14 #include <linux/irq.h>
15 #include <linux/interrupt.h>
16 #include <linux/pm_runtime.h>
17 #include <linux/module.h>
18 #include <linux/mfd/core.h>
19 #include <linux/mfd/max77686.h>
20 #include <linux/mfd/max77686-private.h>
21 #include <linux/err.h>
22 #include <linux/of.h>
23 
24 static const struct mfd_cell max77686_devs[] = {
25 	{ .name = "max77686-pmic", },
26 	{ .name = "max77686-rtc", },
27 	{ .name = "max77686-clk", },
28 };
29 
30 static const struct mfd_cell max77802_devs[] = {
31 	{ .name = "max77802-pmic", },
32 	{ .name = "max77802-clk", },
33 	{ .name = "max77802-rtc", },
34 };
35 
36 static bool max77802_pmic_is_accessible_reg(struct device *dev,
37 					    unsigned int reg)
38 {
39 	return reg < MAX77802_REG_PMIC_END;
40 }
41 
42 static bool max77802_rtc_is_accessible_reg(struct device *dev,
43 					   unsigned int reg)
44 {
45 	return (reg >= MAX77802_RTC_INT && reg < MAX77802_RTC_END);
46 }
47 
48 static bool max77802_is_accessible_reg(struct device *dev, unsigned int reg)
49 {
50 	return (max77802_pmic_is_accessible_reg(dev, reg) ||
51 		max77802_rtc_is_accessible_reg(dev, reg));
52 }
53 
54 static bool max77802_pmic_is_precious_reg(struct device *dev, unsigned int reg)
55 {
56 	return (reg == MAX77802_REG_INTSRC || reg == MAX77802_REG_INT1 ||
57 		reg == MAX77802_REG_INT2);
58 }
59 
60 static bool max77802_rtc_is_precious_reg(struct device *dev, unsigned int reg)
61 {
62 	return (reg == MAX77802_RTC_INT ||
63 		reg == MAX77802_RTC_UPDATE0 ||
64 		reg == MAX77802_RTC_UPDATE1);
65 }
66 
67 static bool max77802_is_precious_reg(struct device *dev, unsigned int reg)
68 {
69 	return (max77802_pmic_is_precious_reg(dev, reg) ||
70 		max77802_rtc_is_precious_reg(dev, reg));
71 }
72 
73 static bool max77802_pmic_is_volatile_reg(struct device *dev, unsigned int reg)
74 {
75 	return (max77802_is_precious_reg(dev, reg) ||
76 		reg == MAX77802_REG_STATUS1 || reg == MAX77802_REG_STATUS2 ||
77 		reg == MAX77802_REG_PWRON);
78 }
79 
80 static bool max77802_rtc_is_volatile_reg(struct device *dev, unsigned int reg)
81 {
82 	return (max77802_rtc_is_precious_reg(dev, reg) ||
83 		reg == MAX77802_RTC_SEC ||
84 		reg == MAX77802_RTC_MIN ||
85 		reg == MAX77802_RTC_HOUR ||
86 		reg == MAX77802_RTC_WEEKDAY ||
87 		reg == MAX77802_RTC_MONTH ||
88 		reg == MAX77802_RTC_YEAR ||
89 		reg == MAX77802_RTC_MONTHDAY);
90 }
91 
92 static bool max77802_is_volatile_reg(struct device *dev, unsigned int reg)
93 {
94 	return (max77802_pmic_is_volatile_reg(dev, reg) ||
95 		max77802_rtc_is_volatile_reg(dev, reg));
96 }
97 
98 static const struct regmap_config max77686_regmap_config = {
99 	.reg_bits = 8,
100 	.val_bits = 8,
101 };
102 
103 static const struct regmap_config max77802_regmap_config = {
104 	.reg_bits = 8,
105 	.val_bits = 8,
106 	.writeable_reg = max77802_is_accessible_reg,
107 	.readable_reg = max77802_is_accessible_reg,
108 	.precious_reg = max77802_is_precious_reg,
109 	.volatile_reg = max77802_is_volatile_reg,
110 	.name = "max77802-pmic",
111 	.cache_type = REGCACHE_RBTREE,
112 };
113 
114 static const struct regmap_irq max77686_irqs[] = {
115 	/* INT1 interrupts */
116 	{ .reg_offset = 0, .mask = MAX77686_INT1_PWRONF_MSK, },
117 	{ .reg_offset = 0, .mask = MAX77686_INT1_PWRONR_MSK, },
118 	{ .reg_offset = 0, .mask = MAX77686_INT1_JIGONBF_MSK, },
119 	{ .reg_offset = 0, .mask = MAX77686_INT1_JIGONBR_MSK, },
120 	{ .reg_offset = 0, .mask = MAX77686_INT1_ACOKBF_MSK, },
121 	{ .reg_offset = 0, .mask = MAX77686_INT1_ACOKBR_MSK, },
122 	{ .reg_offset = 0, .mask = MAX77686_INT1_ONKEY1S_MSK, },
123 	{ .reg_offset = 0, .mask = MAX77686_INT1_MRSTB_MSK, },
124 	/* INT2 interrupts */
125 	{ .reg_offset = 1, .mask = MAX77686_INT2_140C_MSK, },
126 	{ .reg_offset = 1, .mask = MAX77686_INT2_120C_MSK, },
127 };
128 
129 static const struct regmap_irq_chip max77686_irq_chip = {
130 	.name			= "max77686-pmic",
131 	.status_base		= MAX77686_REG_INT1,
132 	.mask_base		= MAX77686_REG_INT1MSK,
133 	.num_regs		= 2,
134 	.irqs			= max77686_irqs,
135 	.num_irqs		= ARRAY_SIZE(max77686_irqs),
136 };
137 
138 static const struct regmap_irq_chip max77802_irq_chip = {
139 	.name			= "max77802-pmic",
140 	.status_base		= MAX77802_REG_INT1,
141 	.mask_base		= MAX77802_REG_INT1MSK,
142 	.num_regs		= 2,
143 	.irqs			= max77686_irqs, /* same masks as 77686 */
144 	.num_irqs		= ARRAY_SIZE(max77686_irqs),
145 };
146 
147 static const struct of_device_id max77686_pmic_dt_match[] = {
148 	{
149 		.compatible = "maxim,max77686",
150 		.data = (void *)TYPE_MAX77686,
151 	},
152 	{
153 		.compatible = "maxim,max77802",
154 		.data = (void *)TYPE_MAX77802,
155 	},
156 	{ },
157 };
158 MODULE_DEVICE_TABLE(of, max77686_pmic_dt_match);
159 
160 static int max77686_i2c_probe(struct i2c_client *i2c)
161 {
162 	struct max77686_dev *max77686 = NULL;
163 	unsigned int data;
164 	int ret = 0;
165 	const struct regmap_config *config;
166 	const struct regmap_irq_chip *irq_chip;
167 	const struct mfd_cell *cells;
168 	int n_devs;
169 
170 	max77686 = devm_kzalloc(&i2c->dev,
171 				sizeof(struct max77686_dev), GFP_KERNEL);
172 	if (!max77686)
173 		return -ENOMEM;
174 
175 	i2c_set_clientdata(i2c, max77686);
176 	max77686->type = (unsigned long)of_device_get_match_data(&i2c->dev);
177 	max77686->dev = &i2c->dev;
178 	max77686->i2c = i2c;
179 
180 	max77686->irq = i2c->irq;
181 
182 	if (max77686->type == TYPE_MAX77686) {
183 		config = &max77686_regmap_config;
184 		irq_chip = &max77686_irq_chip;
185 		cells =  max77686_devs;
186 		n_devs = ARRAY_SIZE(max77686_devs);
187 	} else {
188 		config = &max77802_regmap_config;
189 		irq_chip = &max77802_irq_chip;
190 		cells =  max77802_devs;
191 		n_devs = ARRAY_SIZE(max77802_devs);
192 	}
193 
194 	max77686->regmap = devm_regmap_init_i2c(i2c, config);
195 	if (IS_ERR(max77686->regmap)) {
196 		ret = PTR_ERR(max77686->regmap);
197 		dev_err(max77686->dev, "Failed to allocate register map: %d\n",
198 				ret);
199 		return ret;
200 	}
201 
202 	ret = regmap_read(max77686->regmap, MAX77686_REG_DEVICE_ID, &data);
203 	if (ret < 0) {
204 		dev_err(max77686->dev,
205 			"device not found on this channel (this is not an error)\n");
206 		return -ENODEV;
207 	}
208 
209 	ret = devm_regmap_add_irq_chip(&i2c->dev, max77686->regmap,
210 				       max77686->irq,
211 				       IRQF_ONESHOT | IRQF_SHARED, 0, irq_chip,
212 				       &max77686->irq_data);
213 	if (ret < 0) {
214 		dev_err(&i2c->dev, "failed to add PMIC irq chip: %d\n", ret);
215 		return ret;
216 	}
217 
218 	ret = devm_mfd_add_devices(max77686->dev, -1, cells, n_devs, NULL,
219 				   0, NULL);
220 	if (ret < 0) {
221 		dev_err(&i2c->dev, "failed to add MFD devices: %d\n", ret);
222 		return ret;
223 	}
224 
225 	return 0;
226 }
227 
228 static int max77686_suspend(struct device *dev)
229 {
230 	struct i2c_client *i2c = to_i2c_client(dev);
231 	struct max77686_dev *max77686 = i2c_get_clientdata(i2c);
232 
233 	if (device_may_wakeup(dev))
234 		enable_irq_wake(max77686->irq);
235 
236 	/*
237 	 * IRQ must be disabled during suspend because if it happens
238 	 * while suspended it will be handled before resuming I2C.
239 	 *
240 	 * When device is woken up from suspend (e.g. by RTC wake alarm),
241 	 * an interrupt occurs before resuming I2C bus controller.
242 	 * Interrupt handler tries to read registers but this read
243 	 * will fail because I2C is still suspended.
244 	 */
245 	disable_irq(max77686->irq);
246 
247 	return 0;
248 }
249 
250 static int max77686_resume(struct device *dev)
251 {
252 	struct i2c_client *i2c = to_i2c_client(dev);
253 	struct max77686_dev *max77686 = i2c_get_clientdata(i2c);
254 
255 	if (device_may_wakeup(dev))
256 		disable_irq_wake(max77686->irq);
257 
258 	enable_irq(max77686->irq);
259 
260 	return 0;
261 }
262 
263 static DEFINE_SIMPLE_DEV_PM_OPS(max77686_pm, max77686_suspend, max77686_resume);
264 
265 static struct i2c_driver max77686_i2c_driver = {
266 	.driver = {
267 		   .name = "max77686",
268 		   .pm = pm_sleep_ptr(&max77686_pm),
269 		   .of_match_table = max77686_pmic_dt_match,
270 	},
271 	.probe = max77686_i2c_probe,
272 };
273 
274 module_i2c_driver(max77686_i2c_driver);
275 
276 MODULE_DESCRIPTION("MAXIM 77686/802 multi-function core driver");
277 MODULE_AUTHOR("Chiwoong Byun <woong.byun@samsung.com>");
278 MODULE_LICENSE("GPL");
279