1 // SPDX-License-Identifier: GPL-2.0
2 //
3 // regmap based irq_chip
4 //
5 // Copyright 2011 Wolfson Microelectronics plc
6 //
7 // Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
8 
9 #include <linux/device.h>
10 #include <linux/export.h>
11 #include <linux/interrupt.h>
12 #include <linux/irq.h>
13 #include <linux/irqdomain.h>
14 #include <linux/pm_runtime.h>
15 #include <linux/regmap.h>
16 #include <linux/slab.h>
17 
18 #include "internal.h"
19 
20 struct regmap_irq_chip_data {
21 	struct mutex lock;
22 	struct irq_chip irq_chip;
23 
24 	struct regmap *map;
25 	const struct regmap_irq_chip *chip;
26 
27 	int irq_base;
28 	struct irq_domain *domain;
29 
30 	int irq;
31 	int wake_count;
32 
33 	void *status_reg_buf;
34 	unsigned int *main_status_buf;
35 	unsigned int *status_buf;
36 	unsigned int *mask_buf;
37 	unsigned int *mask_buf_def;
38 	unsigned int *wake_buf;
39 	unsigned int *type_buf;
40 	unsigned int *type_buf_def;
41 	unsigned int **config_buf;
42 
43 	unsigned int irq_reg_stride;
44 
45 	unsigned int (*get_irq_reg)(struct regmap_irq_chip_data *data,
46 				    unsigned int base, int index);
47 
48 	unsigned int clear_status:1;
49 };
50 
51 static inline const
irq_to_regmap_irq(struct regmap_irq_chip_data * data,int irq)52 struct regmap_irq *irq_to_regmap_irq(struct regmap_irq_chip_data *data,
53 				     int irq)
54 {
55 	return &data->chip->irqs[irq];
56 }
57 
regmap_irq_can_bulk_read_status(struct regmap_irq_chip_data * data)58 static bool regmap_irq_can_bulk_read_status(struct regmap_irq_chip_data *data)
59 {
60 	struct regmap *map = data->map;
61 
62 	/*
63 	 * While possible that a user-defined ->get_irq_reg() callback might
64 	 * be linear enough to support bulk reads, most of the time it won't.
65 	 * Therefore only allow them if the default callback is being used.
66 	 */
67 	return data->irq_reg_stride == 1 && map->reg_stride == 1 &&
68 	       data->get_irq_reg == regmap_irq_get_irq_reg_linear &&
69 	       !map->use_single_read;
70 }
71 
regmap_irq_lock(struct irq_data * data)72 static void regmap_irq_lock(struct irq_data *data)
73 {
74 	struct regmap_irq_chip_data *d = irq_data_get_irq_chip_data(data);
75 
76 	mutex_lock(&d->lock);
77 }
78 
regmap_irq_sync_unlock(struct irq_data * data)79 static void regmap_irq_sync_unlock(struct irq_data *data)
80 {
81 	struct regmap_irq_chip_data *d = irq_data_get_irq_chip_data(data);
82 	struct regmap *map = d->map;
83 	int i, j, ret;
84 	u32 reg;
85 	u32 val;
86 
87 	if (d->chip->runtime_pm) {
88 		ret = pm_runtime_get_sync(map->dev);
89 		if (ret < 0)
90 			dev_err(map->dev, "IRQ sync failed to resume: %d\n",
91 				ret);
92 	}
93 
94 	if (d->clear_status) {
95 		for (i = 0; i < d->chip->num_regs; i++) {
96 			reg = d->get_irq_reg(d, d->chip->status_base, i);
97 
98 			ret = regmap_read(map, reg, &val);
99 			if (ret)
100 				dev_err(d->map->dev,
101 					"Failed to clear the interrupt status bits\n");
102 		}
103 
104 		d->clear_status = false;
105 	}
106 
107 	/*
108 	 * If there's been a change in the mask write it back to the
109 	 * hardware.  We rely on the use of the regmap core cache to
110 	 * suppress pointless writes.
111 	 */
112 	for (i = 0; i < d->chip->num_regs; i++) {
113 		if (d->chip->handle_mask_sync)
114 			d->chip->handle_mask_sync(i, d->mask_buf_def[i],
115 						  d->mask_buf[i],
116 						  d->chip->irq_drv_data);
117 
118 		if (d->chip->mask_base && !d->chip->handle_mask_sync) {
119 			reg = d->get_irq_reg(d, d->chip->mask_base, i);
120 			ret = regmap_update_bits(d->map, reg,
121 						 d->mask_buf_def[i],
122 						 d->mask_buf[i]);
123 			if (ret)
124 				dev_err(d->map->dev, "Failed to sync masks in %x\n", reg);
125 		}
126 
127 		if (d->chip->unmask_base && !d->chip->handle_mask_sync) {
128 			reg = d->get_irq_reg(d, d->chip->unmask_base, i);
129 			ret = regmap_update_bits(d->map, reg,
130 					d->mask_buf_def[i], ~d->mask_buf[i]);
131 			if (ret)
132 				dev_err(d->map->dev, "Failed to sync masks in %x\n",
133 					reg);
134 		}
135 
136 		reg = d->get_irq_reg(d, d->chip->wake_base, i);
137 		if (d->wake_buf) {
138 			if (d->chip->wake_invert)
139 				ret = regmap_update_bits(d->map, reg,
140 							 d->mask_buf_def[i],
141 							 ~d->wake_buf[i]);
142 			else
143 				ret = regmap_update_bits(d->map, reg,
144 							 d->mask_buf_def[i],
145 							 d->wake_buf[i]);
146 			if (ret != 0)
147 				dev_err(d->map->dev,
148 					"Failed to sync wakes in %x: %d\n",
149 					reg, ret);
150 		}
151 
152 		if (!d->chip->init_ack_masked)
153 			continue;
154 		/*
155 		 * Ack all the masked interrupts unconditionally,
156 		 * OR if there is masked interrupt which hasn't been Acked,
157 		 * it'll be ignored in irq handler, then may introduce irq storm
158 		 */
159 		if (d->mask_buf[i] && (d->chip->ack_base || d->chip->use_ack)) {
160 			reg = d->get_irq_reg(d, d->chip->ack_base, i);
161 
162 			/* some chips ack by write 0 */
163 			if (d->chip->ack_invert)
164 				ret = regmap_write(map, reg, ~d->mask_buf[i]);
165 			else
166 				ret = regmap_write(map, reg, d->mask_buf[i]);
167 			if (d->chip->clear_ack) {
168 				if (d->chip->ack_invert && !ret)
169 					ret = regmap_write(map, reg, UINT_MAX);
170 				else if (!ret)
171 					ret = regmap_write(map, reg, 0);
172 			}
173 			if (ret != 0)
174 				dev_err(d->map->dev, "Failed to ack 0x%x: %d\n",
175 					reg, ret);
176 		}
177 	}
178 
179 	for (i = 0; i < d->chip->num_config_bases; i++) {
180 		for (j = 0; j < d->chip->num_config_regs; j++) {
181 			reg = d->get_irq_reg(d, d->chip->config_base[i], j);
182 			ret = regmap_write(map, reg, d->config_buf[i][j]);
183 			if (ret)
184 				dev_err(d->map->dev,
185 					"Failed to write config %x: %d\n",
186 					reg, ret);
187 		}
188 	}
189 
190 	if (d->chip->runtime_pm)
191 		pm_runtime_put(map->dev);
192 
193 	/* If we've changed our wakeup count propagate it to the parent */
194 	if (d->wake_count < 0)
195 		for (i = d->wake_count; i < 0; i++)
196 			irq_set_irq_wake(d->irq, 0);
197 	else if (d->wake_count > 0)
198 		for (i = 0; i < d->wake_count; i++)
199 			irq_set_irq_wake(d->irq, 1);
200 
201 	d->wake_count = 0;
202 
203 	mutex_unlock(&d->lock);
204 }
205 
regmap_irq_enable(struct irq_data * data)206 static void regmap_irq_enable(struct irq_data *data)
207 {
208 	struct regmap_irq_chip_data *d = irq_data_get_irq_chip_data(data);
209 	struct regmap *map = d->map;
210 	const struct regmap_irq *irq_data = irq_to_regmap_irq(d, data->hwirq);
211 	unsigned int reg = irq_data->reg_offset / map->reg_stride;
212 	unsigned int mask;
213 
214 	/*
215 	 * The type_in_mask flag means that the underlying hardware uses
216 	 * separate mask bits for each interrupt trigger type, but we want
217 	 * to have a single logical interrupt with a configurable type.
218 	 *
219 	 * If the interrupt we're enabling defines any supported types
220 	 * then instead of using the regular mask bits for this interrupt,
221 	 * use the value previously written to the type buffer at the
222 	 * corresponding offset in regmap_irq_set_type().
223 	 */
224 	if (d->chip->type_in_mask && irq_data->type.types_supported)
225 		mask = d->type_buf[reg] & irq_data->mask;
226 	else
227 		mask = irq_data->mask;
228 
229 	if (d->chip->clear_on_unmask)
230 		d->clear_status = true;
231 
232 	d->mask_buf[reg] &= ~mask;
233 }
234 
regmap_irq_disable(struct irq_data * data)235 static void regmap_irq_disable(struct irq_data *data)
236 {
237 	struct regmap_irq_chip_data *d = irq_data_get_irq_chip_data(data);
238 	struct regmap *map = d->map;
239 	const struct regmap_irq *irq_data = irq_to_regmap_irq(d, data->hwirq);
240 
241 	d->mask_buf[irq_data->reg_offset / map->reg_stride] |= irq_data->mask;
242 }
243 
regmap_irq_set_type(struct irq_data * data,unsigned int type)244 static int regmap_irq_set_type(struct irq_data *data, unsigned int type)
245 {
246 	struct regmap_irq_chip_data *d = irq_data_get_irq_chip_data(data);
247 	struct regmap *map = d->map;
248 	const struct regmap_irq *irq_data = irq_to_regmap_irq(d, data->hwirq);
249 	int reg, ret;
250 	const struct regmap_irq_type *t = &irq_data->type;
251 
252 	if ((t->types_supported & type) != type)
253 		return 0;
254 
255 	reg = t->type_reg_offset / map->reg_stride;
256 
257 	if (d->chip->type_in_mask) {
258 		ret = regmap_irq_set_type_config_simple(&d->type_buf, type,
259 							irq_data, reg, d->chip->irq_drv_data);
260 		if (ret)
261 			return ret;
262 	}
263 
264 	if (d->chip->set_type_config) {
265 		ret = d->chip->set_type_config(d->config_buf, type, irq_data,
266 					       reg, d->chip->irq_drv_data);
267 		if (ret)
268 			return ret;
269 	}
270 
271 	return 0;
272 }
273 
regmap_irq_set_wake(struct irq_data * data,unsigned int on)274 static int regmap_irq_set_wake(struct irq_data *data, unsigned int on)
275 {
276 	struct regmap_irq_chip_data *d = irq_data_get_irq_chip_data(data);
277 	struct regmap *map = d->map;
278 	const struct regmap_irq *irq_data = irq_to_regmap_irq(d, data->hwirq);
279 
280 	if (on) {
281 		if (d->wake_buf)
282 			d->wake_buf[irq_data->reg_offset / map->reg_stride]
283 				&= ~irq_data->mask;
284 		d->wake_count++;
285 	} else {
286 		if (d->wake_buf)
287 			d->wake_buf[irq_data->reg_offset / map->reg_stride]
288 				|= irq_data->mask;
289 		d->wake_count--;
290 	}
291 
292 	return 0;
293 }
294 
295 static const struct irq_chip regmap_irq_chip = {
296 	.irq_bus_lock		= regmap_irq_lock,
297 	.irq_bus_sync_unlock	= regmap_irq_sync_unlock,
298 	.irq_disable		= regmap_irq_disable,
299 	.irq_enable		= regmap_irq_enable,
300 	.irq_set_type		= regmap_irq_set_type,
301 	.irq_set_wake		= regmap_irq_set_wake,
302 };
303 
read_sub_irq_data(struct regmap_irq_chip_data * data,unsigned int b)304 static inline int read_sub_irq_data(struct regmap_irq_chip_data *data,
305 					   unsigned int b)
306 {
307 	const struct regmap_irq_chip *chip = data->chip;
308 	const struct regmap_irq_sub_irq_map *subreg;
309 	struct regmap *map = data->map;
310 	unsigned int reg;
311 	int i, ret = 0;
312 
313 	if (!chip->sub_reg_offsets) {
314 		reg = data->get_irq_reg(data, chip->status_base, b);
315 		ret = regmap_read(map, reg, &data->status_buf[b]);
316 	} else {
317 		/*
318 		 * Note we can't use ->get_irq_reg() here because the offsets
319 		 * in 'subreg' are *not* interchangeable with indices.
320 		 */
321 		subreg = &chip->sub_reg_offsets[b];
322 		for (i = 0; i < subreg->num_regs; i++) {
323 			unsigned int offset = subreg->offset[i];
324 			unsigned int index = offset / map->reg_stride;
325 
326 			ret = regmap_read(map, chip->status_base + offset,
327 					  &data->status_buf[index]);
328 			if (ret)
329 				break;
330 		}
331 	}
332 	return ret;
333 }
334 
regmap_irq_thread(int irq,void * d)335 static irqreturn_t regmap_irq_thread(int irq, void *d)
336 {
337 	struct regmap_irq_chip_data *data = d;
338 	const struct regmap_irq_chip *chip = data->chip;
339 	struct regmap *map = data->map;
340 	int ret, i;
341 	bool handled = false;
342 	u32 reg;
343 
344 	if (chip->handle_pre_irq)
345 		chip->handle_pre_irq(chip->irq_drv_data);
346 
347 	if (chip->runtime_pm) {
348 		ret = pm_runtime_get_sync(map->dev);
349 		if (ret < 0) {
350 			dev_err(map->dev, "IRQ thread failed to resume: %d\n",
351 				ret);
352 			goto exit;
353 		}
354 	}
355 
356 	/*
357 	 * Read only registers with active IRQs if the chip has 'main status
358 	 * register'. Else read in the statuses, using a single bulk read if
359 	 * possible in order to reduce the I/O overheads.
360 	 */
361 
362 	if (chip->no_status) {
363 		/* no status register so default to all active */
364 		memset32(data->status_buf, GENMASK(31, 0), chip->num_regs);
365 	} else if (chip->num_main_regs) {
366 		unsigned int max_main_bits;
367 		unsigned long size;
368 
369 		size = chip->num_regs * sizeof(unsigned int);
370 
371 		max_main_bits = (chip->num_main_status_bits) ?
372 				 chip->num_main_status_bits : chip->num_regs;
373 		/* Clear the status buf as we don't read all status regs */
374 		memset(data->status_buf, 0, size);
375 
376 		/* We could support bulk read for main status registers
377 		 * but I don't expect to see devices with really many main
378 		 * status registers so let's only support single reads for the
379 		 * sake of simplicity. and add bulk reads only if needed
380 		 */
381 		for (i = 0; i < chip->num_main_regs; i++) {
382 			reg = data->get_irq_reg(data, chip->main_status, i);
383 			ret = regmap_read(map, reg, &data->main_status_buf[i]);
384 			if (ret) {
385 				dev_err(map->dev,
386 					"Failed to read IRQ status %d\n",
387 					ret);
388 				goto exit;
389 			}
390 		}
391 
392 		/* Read sub registers with active IRQs */
393 		for (i = 0; i < chip->num_main_regs; i++) {
394 			unsigned int b;
395 			const unsigned long mreg = data->main_status_buf[i];
396 
397 			for_each_set_bit(b, &mreg, map->format.val_bytes * 8) {
398 				if (i * map->format.val_bytes * 8 + b >
399 				    max_main_bits)
400 					break;
401 				ret = read_sub_irq_data(data, b);
402 
403 				if (ret != 0) {
404 					dev_err(map->dev,
405 						"Failed to read IRQ status %d\n",
406 						ret);
407 					goto exit;
408 				}
409 			}
410 
411 		}
412 	} else if (regmap_irq_can_bulk_read_status(data)) {
413 
414 		u8 *buf8 = data->status_reg_buf;
415 		u16 *buf16 = data->status_reg_buf;
416 		u32 *buf32 = data->status_reg_buf;
417 
418 		BUG_ON(!data->status_reg_buf);
419 
420 		ret = regmap_bulk_read(map, chip->status_base,
421 				       data->status_reg_buf,
422 				       chip->num_regs);
423 		if (ret != 0) {
424 			dev_err(map->dev, "Failed to read IRQ status: %d\n",
425 				ret);
426 			goto exit;
427 		}
428 
429 		for (i = 0; i < data->chip->num_regs; i++) {
430 			switch (map->format.val_bytes) {
431 			case 1:
432 				data->status_buf[i] = buf8[i];
433 				break;
434 			case 2:
435 				data->status_buf[i] = buf16[i];
436 				break;
437 			case 4:
438 				data->status_buf[i] = buf32[i];
439 				break;
440 			default:
441 				BUG();
442 				goto exit;
443 			}
444 		}
445 
446 	} else {
447 		for (i = 0; i < data->chip->num_regs; i++) {
448 			unsigned int reg = data->get_irq_reg(data,
449 					data->chip->status_base, i);
450 			ret = regmap_read(map, reg, &data->status_buf[i]);
451 
452 			if (ret != 0) {
453 				dev_err(map->dev,
454 					"Failed to read IRQ status: %d\n",
455 					ret);
456 				goto exit;
457 			}
458 		}
459 	}
460 
461 	if (chip->status_invert)
462 		for (i = 0; i < data->chip->num_regs; i++)
463 			data->status_buf[i] = ~data->status_buf[i];
464 
465 	/*
466 	 * Ignore masked IRQs and ack if we need to; we ack early so
467 	 * there is no race between handling and acknowledging the
468 	 * interrupt.  We assume that typically few of the interrupts
469 	 * will fire simultaneously so don't worry about overhead from
470 	 * doing a write per register.
471 	 */
472 	for (i = 0; i < data->chip->num_regs; i++) {
473 		data->status_buf[i] &= ~data->mask_buf[i];
474 
475 		if (data->status_buf[i] && (chip->ack_base || chip->use_ack)) {
476 			reg = data->get_irq_reg(data, data->chip->ack_base, i);
477 
478 			if (chip->ack_invert)
479 				ret = regmap_write(map, reg,
480 						~data->status_buf[i]);
481 			else
482 				ret = regmap_write(map, reg,
483 						data->status_buf[i]);
484 			if (chip->clear_ack) {
485 				if (chip->ack_invert && !ret)
486 					ret = regmap_write(map, reg, UINT_MAX);
487 				else if (!ret)
488 					ret = regmap_write(map, reg, 0);
489 			}
490 			if (ret != 0)
491 				dev_err(map->dev, "Failed to ack 0x%x: %d\n",
492 					reg, ret);
493 		}
494 	}
495 
496 	for (i = 0; i < chip->num_irqs; i++) {
497 		if (data->status_buf[chip->irqs[i].reg_offset /
498 				     map->reg_stride] & chip->irqs[i].mask) {
499 			handle_nested_irq(irq_find_mapping(data->domain, i));
500 			handled = true;
501 		}
502 	}
503 
504 exit:
505 	if (chip->handle_post_irq)
506 		chip->handle_post_irq(chip->irq_drv_data);
507 
508 	if (chip->runtime_pm)
509 		pm_runtime_put(map->dev);
510 
511 	if (handled)
512 		return IRQ_HANDLED;
513 	else
514 		return IRQ_NONE;
515 }
516 
517 static struct lock_class_key regmap_irq_lock_class;
518 static struct lock_class_key regmap_irq_request_class;
519 
regmap_irq_map(struct irq_domain * h,unsigned int virq,irq_hw_number_t hw)520 static int regmap_irq_map(struct irq_domain *h, unsigned int virq,
521 			  irq_hw_number_t hw)
522 {
523 	struct regmap_irq_chip_data *data = h->host_data;
524 
525 	irq_set_chip_data(virq, data);
526 	irq_set_lockdep_class(virq, ®map_irq_lock_class, ®map_irq_request_class);
527 	irq_set_chip(virq, &data->irq_chip);
528 	irq_set_nested_thread(virq, 1);
529 	irq_set_parent(virq, data->irq);
530 	irq_set_noprobe(virq);
531 
532 	return 0;
533 }
534 
535 static const struct irq_domain_ops regmap_domain_ops = {
536 	.map	= regmap_irq_map,
537 	.xlate	= irq_domain_xlate_onetwocell,
538 };
539 
540 /**
541  * regmap_irq_get_irq_reg_linear() - Linear IRQ register mapping callback.
542  * @data: Data for the &struct regmap_irq_chip
543  * @base: Base register
544  * @index: Register index
545  *
546  * Returns the register address corresponding to the given @base and @index
547  * by the formula ``base + index * regmap_stride * irq_reg_stride``.
548  */
regmap_irq_get_irq_reg_linear(struct regmap_irq_chip_data * data,unsigned int base,int index)549 unsigned int regmap_irq_get_irq_reg_linear(struct regmap_irq_chip_data *data,
550 					   unsigned int base, int index)
551 {
552 	struct regmap *map = data->map;
553 
554 	return base + index * map->reg_stride * data->irq_reg_stride;
555 }
556 EXPORT_SYMBOL_GPL(regmap_irq_get_irq_reg_linear);
557 
558 /**
559  * regmap_irq_set_type_config_simple() - Simple IRQ type configuration callback.
560  * @buf: Buffer containing configuration register values, this is a 2D array of
561  *       `num_config_bases` rows, each of `num_config_regs` elements.
562  * @type: The requested IRQ type.
563  * @irq_data: The IRQ being configured.
564  * @idx: Index of the irq's config registers within each array `buf[i]`
565  * @irq_drv_data: Driver specific IRQ data
566  *
567  * This is a &struct regmap_irq_chip->set_type_config callback suitable for
568  * chips with one config register. Register values are updated according to
569  * the &struct regmap_irq_type data associated with an IRQ.
570  */
regmap_irq_set_type_config_simple(unsigned int ** buf,unsigned int type,const struct regmap_irq * irq_data,int idx,void * irq_drv_data)571 int regmap_irq_set_type_config_simple(unsigned int **buf, unsigned int type,
572 				      const struct regmap_irq *irq_data,
573 				      int idx, void *irq_drv_data)
574 {
575 	const struct regmap_irq_type *t = &irq_data->type;
576 
577 	if (t->type_reg_mask)
578 		buf[0][idx] &= ~t->type_reg_mask;
579 	else
580 		buf[0][idx] &= ~(t->type_falling_val |
581 				 t->type_rising_val |
582 				 t->type_level_low_val |
583 				 t->type_level_high_val);
584 
585 	switch (type) {
586 	case IRQ_TYPE_EDGE_FALLING:
587 		buf[0][idx] |= t->type_falling_val;
588 		break;
589 
590 	case IRQ_TYPE_EDGE_RISING:
591 		buf[0][idx] |= t->type_rising_val;
592 		break;
593 
594 	case IRQ_TYPE_EDGE_BOTH:
595 		buf[0][idx] |= (t->type_falling_val |
596 				t->type_rising_val);
597 		break;
598 
599 	case IRQ_TYPE_LEVEL_HIGH:
600 		buf[0][idx] |= t->type_level_high_val;
601 		break;
602 
603 	case IRQ_TYPE_LEVEL_LOW:
604 		buf[0][idx] |= t->type_level_low_val;
605 		break;
606 
607 	default:
608 		return -EINVAL;
609 	}
610 
611 	return 0;
612 }
613 EXPORT_SYMBOL_GPL(regmap_irq_set_type_config_simple);
614 
regmap_irq_create_domain(struct fwnode_handle * fwnode,int irq_base,const struct regmap_irq_chip * chip,struct regmap_irq_chip_data * d)615 static int regmap_irq_create_domain(struct fwnode_handle *fwnode, int irq_base,
616 				    const struct regmap_irq_chip *chip,
617 				    struct regmap_irq_chip_data *d)
618 {
619 	struct irq_domain_info info = {
620 		.fwnode = fwnode,
621 		.size = chip->num_irqs,
622 		.hwirq_max = chip->num_irqs,
623 		.virq_base = irq_base,
624 		.ops = ®map_domain_ops,
625 		.host_data = d,
626 		.name_suffix = chip->domain_suffix,
627 	};
628 
629 	d->domain = irq_domain_instantiate(&info);
630 	if (IS_ERR(d->domain)) {
631 		dev_err(d->map->dev, "Failed to create IRQ domain\n");
632 		return PTR_ERR(d->domain);
633 	}
634 
635 	return 0;
636 }
637 
638 
639 /**
640  * regmap_add_irq_chip_fwnode() - Use standard regmap IRQ controller handling
641  *
642  * @fwnode: The firmware node where the IRQ domain should be added to.
643  * @map: The regmap for the device.
644  * @irq: The IRQ the device uses to signal interrupts.
645  * @irq_flags: The IRQF_ flags to use for the primary interrupt.
646  * @irq_base: Allocate at specific IRQ number if irq_base > 0.
647  * @chip: Configuration for the interrupt controller.
648  * @data: Runtime data structure for the controller, allocated on success.
649  *
650  * Returns 0 on success or an errno on failure.
651  *
652  * In order for this to be efficient the chip really should use a
653  * register cache.  The chip driver is responsible for restoring the
654  * register values used by the IRQ controller over suspend and resume.
655  */
regmap_add_irq_chip_fwnode(struct fwnode_handle * fwnode,struct regmap * map,int irq,int irq_flags,int irq_base,const struct regmap_irq_chip * chip,struct regmap_irq_chip_data ** data)656 int regmap_add_irq_chip_fwnode(struct fwnode_handle *fwnode,
657 			       struct regmap *map, int irq,
658 			       int irq_flags, int irq_base,
659 			       const struct regmap_irq_chip *chip,
660 			       struct regmap_irq_chip_data **data)
661 {
662 	struct regmap_irq_chip_data *d;
663 	int i;
664 	int ret = -ENOMEM;
665 	u32 reg;
666 
667 	if (chip->num_regs <= 0)
668 		return -EINVAL;
669 
670 	if (chip->clear_on_unmask && (chip->ack_base || chip->use_ack))
671 		return -EINVAL;
672 
673 	if (chip->mask_base && chip->unmask_base && !chip->mask_unmask_non_inverted)
674 		return -EINVAL;
675 
676 	for (i = 0; i < chip->num_irqs; i++) {
677 		if (chip->irqs[i].reg_offset % map->reg_stride)
678 			return -EINVAL;
679 		if (chip->irqs[i].reg_offset / map->reg_stride >=
680 		    chip->num_regs)
681 			return -EINVAL;
682 	}
683 
684 	if (irq_base) {
685 		irq_base = irq_alloc_descs(irq_base, 0, chip->num_irqs, 0);
686 		if (irq_base < 0) {
687 			dev_warn(map->dev, "Failed to allocate IRQs: %d\n",
688 				 irq_base);
689 			return irq_base;
690 		}
691 	}
692 
693 	d = kzalloc(sizeof(*d), GFP_KERNEL);
694 	if (!d)
695 		return -ENOMEM;
696 
697 	if (chip->num_main_regs) {
698 		d->main_status_buf = kcalloc(chip->num_main_regs,
699 					     sizeof(*d->main_status_buf),
700 					     GFP_KERNEL);
701 
702 		if (!d->main_status_buf)
703 			goto err_alloc;
704 	}
705 
706 	d->status_buf = kcalloc(chip->num_regs, sizeof(*d->status_buf),
707 				GFP_KERNEL);
708 	if (!d->status_buf)
709 		goto err_alloc;
710 
711 	d->mask_buf = kcalloc(chip->num_regs, sizeof(*d->mask_buf),
712 			      GFP_KERNEL);
713 	if (!d->mask_buf)
714 		goto err_alloc;
715 
716 	d->mask_buf_def = kcalloc(chip->num_regs, sizeof(*d->mask_buf_def),
717 				  GFP_KERNEL);
718 	if (!d->mask_buf_def)
719 		goto err_alloc;
720 
721 	if (chip->wake_base) {
722 		d->wake_buf = kcalloc(chip->num_regs, sizeof(*d->wake_buf),
723 				      GFP_KERNEL);
724 		if (!d->wake_buf)
725 			goto err_alloc;
726 	}
727 
728 	if (chip->type_in_mask) {
729 		d->type_buf_def = kcalloc(chip->num_regs,
730 					  sizeof(*d->type_buf_def), GFP_KERNEL);
731 		if (!d->type_buf_def)
732 			goto err_alloc;
733 
734 		d->type_buf = kcalloc(chip->num_regs, sizeof(*d->type_buf), GFP_KERNEL);
735 		if (!d->type_buf)
736 			goto err_alloc;
737 	}
738 
739 	if (chip->num_config_bases && chip->num_config_regs) {
740 		/*
741 		 * Create config_buf[num_config_bases][num_config_regs]
742 		 */
743 		d->config_buf = kcalloc(chip->num_config_bases,
744 					sizeof(*d->config_buf), GFP_KERNEL);
745 		if (!d->config_buf)
746 			goto err_alloc;
747 
748 		for (i = 0; i < chip->num_config_bases; i++) {
749 			d->config_buf[i] = kcalloc(chip->num_config_regs,
750 						   sizeof(**d->config_buf),
751 						   GFP_KERNEL);
752 			if (!d->config_buf[i])
753 				goto err_alloc;
754 		}
755 	}
756 
757 	d->irq_chip = regmap_irq_chip;
758 	d->irq_chip.name = chip->name;
759 	d->irq = irq;
760 	d->map = map;
761 	d->chip = chip;
762 	d->irq_base = irq_base;
763 
764 	if (chip->irq_reg_stride)
765 		d->irq_reg_stride = chip->irq_reg_stride;
766 	else
767 		d->irq_reg_stride = 1;
768 
769 	if (chip->get_irq_reg)
770 		d->get_irq_reg = chip->get_irq_reg;
771 	else
772 		d->get_irq_reg = regmap_irq_get_irq_reg_linear;
773 
774 	if (regmap_irq_can_bulk_read_status(d)) {
775 		d->status_reg_buf = kmalloc_array(chip->num_regs,
776 						  map->format.val_bytes,
777 						  GFP_KERNEL);
778 		if (!d->status_reg_buf)
779 			goto err_alloc;
780 	}
781 
782 	mutex_init(&d->lock);
783 
784 	for (i = 0; i < chip->num_irqs; i++)
785 		d->mask_buf_def[chip->irqs[i].reg_offset / map->reg_stride]
786 			|= chip->irqs[i].mask;
787 
788 	/* Mask all the interrupts by default */
789 	for (i = 0; i < chip->num_regs; i++) {
790 		d->mask_buf[i] = d->mask_buf_def[i];
791 
792 		if (chip->handle_mask_sync) {
793 			ret = chip->handle_mask_sync(i, d->mask_buf_def[i],
794 						     d->mask_buf[i],
795 						     chip->irq_drv_data);
796 			if (ret)
797 				goto err_alloc;
798 		}
799 
800 		if (chip->mask_base && !chip->handle_mask_sync) {
801 			reg = d->get_irq_reg(d, chip->mask_base, i);
802 			ret = regmap_update_bits(d->map, reg,
803 						 d->mask_buf_def[i],
804 						 d->mask_buf[i]);
805 			if (ret) {
806 				dev_err(map->dev, "Failed to set masks in 0x%x: %d\n",
807 					reg, ret);
808 				goto err_alloc;
809 			}
810 		}
811 
812 		if (chip->unmask_base && !chip->handle_mask_sync) {
813 			reg = d->get_irq_reg(d, chip->unmask_base, i);
814 			ret = regmap_update_bits(d->map, reg,
815 					d->mask_buf_def[i], ~d->mask_buf[i]);
816 			if (ret) {
817 				dev_err(map->dev, "Failed to set masks in 0x%x: %d\n",
818 					reg, ret);
819 				goto err_alloc;
820 			}
821 		}
822 
823 		if (!chip->init_ack_masked)
824 			continue;
825 
826 		/* Ack masked but set interrupts */
827 		if (d->chip->no_status) {
828 			/* no status register so default to all active */
829 			d->status_buf[i] = GENMASK(31, 0);
830 		} else {
831 			reg = d->get_irq_reg(d, d->chip->status_base, i);
832 			ret = regmap_read(map, reg, &d->status_buf[i]);
833 			if (ret != 0) {
834 				dev_err(map->dev, "Failed to read IRQ status: %d\n",
835 					ret);
836 				goto err_alloc;
837 			}
838 		}
839 
840 		if (chip->status_invert)
841 			d->status_buf[i] = ~d->status_buf[i];
842 
843 		if (d->status_buf[i] && (chip->ack_base || chip->use_ack)) {
844 			reg = d->get_irq_reg(d, d->chip->ack_base, i);
845 			if (chip->ack_invert)
846 				ret = regmap_write(map, reg,
847 					~(d->status_buf[i] & d->mask_buf[i]));
848 			else
849 				ret = regmap_write(map, reg,
850 					d->status_buf[i] & d->mask_buf[i]);
851 			if (chip->clear_ack) {
852 				if (chip->ack_invert && !ret)
853 					ret = regmap_write(map, reg, UINT_MAX);
854 				else if (!ret)
855 					ret = regmap_write(map, reg, 0);
856 			}
857 			if (ret != 0) {
858 				dev_err(map->dev, "Failed to ack 0x%x: %d\n",
859 					reg, ret);
860 				goto err_alloc;
861 			}
862 		}
863 	}
864 
865 	/* Wake is disabled by default */
866 	if (d->wake_buf) {
867 		for (i = 0; i < chip->num_regs; i++) {
868 			d->wake_buf[i] = d->mask_buf_def[i];
869 			reg = d->get_irq_reg(d, d->chip->wake_base, i);
870 
871 			if (chip->wake_invert)
872 				ret = regmap_update_bits(d->map, reg,
873 							 d->mask_buf_def[i],
874 							 0);
875 			else
876 				ret = regmap_update_bits(d->map, reg,
877 							 d->mask_buf_def[i],
878 							 d->wake_buf[i]);
879 			if (ret != 0) {
880 				dev_err(map->dev, "Failed to set masks in 0x%x: %d\n",
881 					reg, ret);
882 				goto err_alloc;
883 			}
884 		}
885 	}
886 
887 	ret = regmap_irq_create_domain(fwnode, irq_base, chip, d);
888 	if (ret)
889 		goto err_alloc;
890 
891 	ret = request_threaded_irq(irq, NULL, regmap_irq_thread,
892 				   irq_flags | IRQF_ONESHOT,
893 				   chip->name, d);
894 	if (ret != 0) {
895 		dev_err(map->dev, "Failed to request IRQ %d for %s: %d\n",
896 			irq, chip->name, ret);
897 		goto err_domain;
898 	}
899 
900 	*data = d;
901 
902 	return 0;
903 
904 err_domain:
905 	/* Should really dispose of the domain but... */
906 err_alloc:
907 	kfree(d->type_buf);
908 	kfree(d->type_buf_def);
909 	kfree(d->wake_buf);
910 	kfree(d->mask_buf_def);
911 	kfree(d->mask_buf);
912 	kfree(d->main_status_buf);
913 	kfree(d->status_buf);
914 	kfree(d->status_reg_buf);
915 	if (d->config_buf) {
916 		for (i = 0; i < chip->num_config_bases; i++)
917 			kfree(d->config_buf[i]);
918 		kfree(d->config_buf);
919 	}
920 	kfree(d);
921 	return ret;
922 }
923 EXPORT_SYMBOL_GPL(regmap_add_irq_chip_fwnode);
924 
925 /**
926  * regmap_add_irq_chip() - Use standard regmap IRQ controller handling
927  *
928  * @map: The regmap for the device.
929  * @irq: The IRQ the device uses to signal interrupts.
930  * @irq_flags: The IRQF_ flags to use for the primary interrupt.
931  * @irq_base: Allocate at specific IRQ number if irq_base > 0.
932  * @chip: Configuration for the interrupt controller.
933  * @data: Runtime data structure for the controller, allocated on success.
934  *
935  * Returns 0 on success or an errno on failure.
936  *
937  * This is the same as regmap_add_irq_chip_fwnode, except that the firmware
938  * node of the regmap is used.
939  */
regmap_add_irq_chip(struct regmap * map,int irq,int irq_flags,int irq_base,const struct regmap_irq_chip * chip,struct regmap_irq_chip_data ** data)940 int regmap_add_irq_chip(struct regmap *map, int irq, int irq_flags,
941 			int irq_base, const struct regmap_irq_chip *chip,
942 			struct regmap_irq_chip_data **data)
943 {
944 	return regmap_add_irq_chip_fwnode(dev_fwnode(map->dev), map, irq,
945 					  irq_flags, irq_base, chip, data);
946 }
947 EXPORT_SYMBOL_GPL(regmap_add_irq_chip);
948 
949 /**
950  * regmap_del_irq_chip() - Stop interrupt handling for a regmap IRQ chip
951  *
952  * @irq: Primary IRQ for the device
953  * @d: ®map_irq_chip_data allocated by regmap_add_irq_chip()
954  *
955  * This function also disposes of all mapped IRQs on the chip.
956  */
regmap_del_irq_chip(int irq,struct regmap_irq_chip_data * d)957 void regmap_del_irq_chip(int irq, struct regmap_irq_chip_data *d)
958 {
959 	unsigned int virq;
960 	int i, hwirq;
961 
962 	if (!d)
963 		return;
964 
965 	free_irq(irq, d);
966 
967 	/* Dispose all virtual irq from irq domain before removing it */
968 	for (hwirq = 0; hwirq < d->chip->num_irqs; hwirq++) {
969 		/* Ignore hwirq if holes in the IRQ list */
970 		if (!d->chip->irqs[hwirq].mask)
971 			continue;
972 
973 		/*
974 		 * Find the virtual irq of hwirq on chip and if it is
975 		 * there then dispose it
976 		 */
977 		virq = irq_find_mapping(d->domain, hwirq);
978 		if (virq)
979 			irq_dispose_mapping(virq);
980 	}
981 
982 	irq_domain_remove(d->domain);
983 	kfree(d->type_buf);
984 	kfree(d->type_buf_def);
985 	kfree(d->wake_buf);
986 	kfree(d->mask_buf_def);
987 	kfree(d->mask_buf);
988 	kfree(d->main_status_buf);
989 	kfree(d->status_reg_buf);
990 	kfree(d->status_buf);
991 	if (d->config_buf) {
992 		for (i = 0; i < d->chip->num_config_bases; i++)
993 			kfree(d->config_buf[i]);
994 		kfree(d->config_buf);
995 	}
996 	kfree(d);
997 }
998 EXPORT_SYMBOL_GPL(regmap_del_irq_chip);
999 
devm_regmap_irq_chip_release(struct device * dev,void * res)1000 static void devm_regmap_irq_chip_release(struct device *dev, void *res)
1001 {
1002 	struct regmap_irq_chip_data *d = *(struct regmap_irq_chip_data **)res;
1003 
1004 	regmap_del_irq_chip(d->irq, d);
1005 }
1006 
devm_regmap_irq_chip_match(struct device * dev,void * res,void * data)1007 static int devm_regmap_irq_chip_match(struct device *dev, void *res, void *data)
1008 
1009 {
1010 	struct regmap_irq_chip_data **r = res;
1011 
1012 	if (!r || !*r) {
1013 		WARN_ON(!r || !*r);
1014 		return 0;
1015 	}
1016 	return *r == data;
1017 }
1018 
1019 /**
1020  * devm_regmap_add_irq_chip_fwnode() - Resource managed regmap_add_irq_chip_fwnode()
1021  *
1022  * @dev: The device pointer on which irq_chip belongs to.
1023  * @fwnode: The firmware node where the IRQ domain should be added to.
1024  * @map: The regmap for the device.
1025  * @irq: The IRQ the device uses to signal interrupts
1026  * @irq_flags: The IRQF_ flags to use for the primary interrupt.
1027  * @irq_base: Allocate at specific IRQ number if irq_base > 0.
1028  * @chip: Configuration for the interrupt controller.
1029  * @data: Runtime data structure for the controller, allocated on success
1030  *
1031  * Returns 0 on success or an errno on failure.
1032  *
1033  * The ®map_irq_chip_data will be automatically released when the device is
1034  * unbound.
1035  */
devm_regmap_add_irq_chip_fwnode(struct device * dev,struct fwnode_handle * fwnode,struct regmap * map,int irq,int irq_flags,int irq_base,const struct regmap_irq_chip * chip,struct regmap_irq_chip_data ** data)1036 int devm_regmap_add_irq_chip_fwnode(struct device *dev,
1037 				    struct fwnode_handle *fwnode,
1038 				    struct regmap *map, int irq,
1039 				    int irq_flags, int irq_base,
1040 				    const struct regmap_irq_chip *chip,
1041 				    struct regmap_irq_chip_data **data)
1042 {
1043 	struct regmap_irq_chip_data **ptr, *d;
1044 	int ret;
1045 
1046 	ptr = devres_alloc(devm_regmap_irq_chip_release, sizeof(*ptr),
1047 			   GFP_KERNEL);
1048 	if (!ptr)
1049 		return -ENOMEM;
1050 
1051 	ret = regmap_add_irq_chip_fwnode(fwnode, map, irq, irq_flags, irq_base,
1052 					 chip, &d);
1053 	if (ret < 0) {
1054 		devres_free(ptr);
1055 		return ret;
1056 	}
1057 
1058 	*ptr = d;
1059 	devres_add(dev, ptr);
1060 	*data = d;
1061 	return 0;
1062 }
1063 EXPORT_SYMBOL_GPL(devm_regmap_add_irq_chip_fwnode);
1064 
1065 /**
1066  * devm_regmap_add_irq_chip() - Resource managed regmap_add_irq_chip()
1067  *
1068  * @dev: The device pointer on which irq_chip belongs to.
1069  * @map: The regmap for the device.
1070  * @irq: The IRQ the device uses to signal interrupts
1071  * @irq_flags: The IRQF_ flags to use for the primary interrupt.
1072  * @irq_base: Allocate at specific IRQ number if irq_base > 0.
1073  * @chip: Configuration for the interrupt controller.
1074  * @data: Runtime data structure for the controller, allocated on success
1075  *
1076  * Returns 0 on success or an errno on failure.
1077  *
1078  * The ®map_irq_chip_data will be automatically released when the device is
1079  * unbound.
1080  */
devm_regmap_add_irq_chip(struct device * dev,struct regmap * map,int irq,int irq_flags,int irq_base,const struct regmap_irq_chip * chip,struct regmap_irq_chip_data ** data)1081 int devm_regmap_add_irq_chip(struct device *dev, struct regmap *map, int irq,
1082 			     int irq_flags, int irq_base,
1083 			     const struct regmap_irq_chip *chip,
1084 			     struct regmap_irq_chip_data **data)
1085 {
1086 	return devm_regmap_add_irq_chip_fwnode(dev, dev_fwnode(map->dev), map,
1087 					       irq, irq_flags, irq_base, chip,
1088 					       data);
1089 }
1090 EXPORT_SYMBOL_GPL(devm_regmap_add_irq_chip);
1091 
1092 /**
1093  * devm_regmap_del_irq_chip() - Resource managed regmap_del_irq_chip()
1094  *
1095  * @dev: Device for which the resource was allocated.
1096  * @irq: Primary IRQ for the device.
1097  * @data: ®map_irq_chip_data allocated by regmap_add_irq_chip().
1098  *
1099  * A resource managed version of regmap_del_irq_chip().
1100  */
devm_regmap_del_irq_chip(struct device * dev,int irq,struct regmap_irq_chip_data * data)1101 void devm_regmap_del_irq_chip(struct device *dev, int irq,
1102 			      struct regmap_irq_chip_data *data)
1103 {
1104 	int rc;
1105 
1106 	WARN_ON(irq != data->irq);
1107 	rc = devres_release(dev, devm_regmap_irq_chip_release,
1108 			    devm_regmap_irq_chip_match, data);
1109 
1110 	if (rc != 0)
1111 		WARN_ON(rc);
1112 }
1113 EXPORT_SYMBOL_GPL(devm_regmap_del_irq_chip);
1114 
1115 /**
1116  * regmap_irq_chip_get_base() - Retrieve interrupt base for a regmap IRQ chip
1117  *
1118  * @data: regmap irq controller to operate on.
1119  *
1120  * Useful for drivers to request their own IRQs.
1121  */
regmap_irq_chip_get_base(struct regmap_irq_chip_data * data)1122 int regmap_irq_chip_get_base(struct regmap_irq_chip_data *data)
1123 {
1124 	WARN_ON(!data->irq_base);
1125 	return data->irq_base;
1126 }
1127 EXPORT_SYMBOL_GPL(regmap_irq_chip_get_base);
1128 
1129 /**
1130  * regmap_irq_get_virq() - Map an interrupt on a chip to a virtual IRQ
1131  *
1132  * @data: regmap irq controller to operate on.
1133  * @irq: index of the interrupt requested in the chip IRQs.
1134  *
1135  * Useful for drivers to request their own IRQs.
1136  */
regmap_irq_get_virq(struct regmap_irq_chip_data * data,int irq)1137 int regmap_irq_get_virq(struct regmap_irq_chip_data *data, int irq)
1138 {
1139 	/* Handle holes in the IRQ list */
1140 	if (!data->chip->irqs[irq].mask)
1141 		return -EINVAL;
1142 
1143 	return irq_create_mapping(data->domain, irq);
1144 }
1145 EXPORT_SYMBOL_GPL(regmap_irq_get_virq);
1146 
1147 /**
1148  * regmap_irq_get_domain() - Retrieve the irq_domain for the chip
1149  *
1150  * @data: regmap_irq controller to operate on.
1151  *
1152  * Useful for drivers to request their own IRQs and for integration
1153  * with subsystems.  For ease of integration NULL is accepted as a
1154  * domain, allowing devices to just call this even if no domain is
1155  * allocated.
1156  */
regmap_irq_get_domain(struct regmap_irq_chip_data * data)1157 struct irq_domain *regmap_irq_get_domain(struct regmap_irq_chip_data *data)
1158 {
1159 	if (data)
1160 		return data->domain;
1161 	else
1162 		return NULL;
1163 }
1164 EXPORT_SYMBOL_GPL(regmap_irq_get_domain);
1165