Linux Audio

Check our new training course

Loading...
v5.9
  1// SPDX-License-Identifier: GPL-2.0-only
  2/*
  3 * Core driver for TI TPS6586x PMIC family
  4 *
  5 * Copyright (c) 2010 CompuLab Ltd.
  6 * Mike Rapoport <mike@compulab.co.il>
  7 *
  8 * Based on da903x.c.
  9 * Copyright (C) 2008 Compulab, Ltd.
 10 * Mike Rapoport <mike@compulab.co.il>
 11 * Copyright (C) 2006-2008 Marvell International Ltd.
 12 * Eric Miao <eric.miao@marvell.com>
 
 
 
 
 13 */
 14
 15#include <linux/interrupt.h>
 16#include <linux/irq.h>
 17#include <linux/irqdomain.h>
 18#include <linux/kernel.h>
 19#include <linux/module.h>
 20#include <linux/mutex.h>
 21#include <linux/slab.h>
 22#include <linux/err.h>
 23#include <linux/i2c.h>
 24#include <linux/platform_device.h>
 25#include <linux/regmap.h>
 26#include <linux/of.h>
 27
 28#include <linux/mfd/core.h>
 29#include <linux/mfd/tps6586x.h>
 30
 31#define TPS6586X_SUPPLYENE	0x14
 32#define EXITSLREQ_BIT		BIT(1)
 33#define SLEEP_MODE_BIT		BIT(3)
 34
 35/* interrupt control registers */
 36#define TPS6586X_INT_ACK1	0xb5
 37#define TPS6586X_INT_ACK2	0xb6
 38#define TPS6586X_INT_ACK3	0xb7
 39#define TPS6586X_INT_ACK4	0xb8
 40
 41/* interrupt mask registers */
 42#define TPS6586X_INT_MASK1	0xb0
 43#define TPS6586X_INT_MASK2	0xb1
 44#define TPS6586X_INT_MASK3	0xb2
 45#define TPS6586X_INT_MASK4	0xb3
 46#define TPS6586X_INT_MASK5	0xb4
 47
 48/* device id */
 49#define TPS6586X_VERSIONCRC	0xcd
 50
 51/* Maximum register */
 52#define TPS6586X_MAX_REGISTER	TPS6586X_VERSIONCRC
 53
 54struct tps6586x_irq_data {
 55	u8	mask_reg;
 56	u8	mask_mask;
 57};
 58
 59#define TPS6586X_IRQ(_reg, _mask)				\
 60	{							\
 61		.mask_reg = (_reg) - TPS6586X_INT_MASK1,	\
 62		.mask_mask = (_mask),				\
 63	}
 64
 65static const struct tps6586x_irq_data tps6586x_irqs[] = {
 66	[TPS6586X_INT_PLDO_0]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 0),
 67	[TPS6586X_INT_PLDO_1]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 1),
 68	[TPS6586X_INT_PLDO_2]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 2),
 69	[TPS6586X_INT_PLDO_3]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 3),
 70	[TPS6586X_INT_PLDO_4]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 4),
 71	[TPS6586X_INT_PLDO_5]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 5),
 72	[TPS6586X_INT_PLDO_6]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 6),
 73	[TPS6586X_INT_PLDO_7]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 7),
 74	[TPS6586X_INT_COMP_DET]	= TPS6586X_IRQ(TPS6586X_INT_MASK4, 1 << 0),
 75	[TPS6586X_INT_ADC]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 1),
 76	[TPS6586X_INT_PLDO_8]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 2),
 77	[TPS6586X_INT_PLDO_9]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 3),
 78	[TPS6586X_INT_PSM_0]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 4),
 79	[TPS6586X_INT_PSM_1]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 5),
 80	[TPS6586X_INT_PSM_2]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 6),
 81	[TPS6586X_INT_PSM_3]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 7),
 82	[TPS6586X_INT_RTC_ALM1]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 4),
 83	[TPS6586X_INT_ACUSB_OVP] = TPS6586X_IRQ(TPS6586X_INT_MASK5, 0x03),
 84	[TPS6586X_INT_USB_DET]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 2),
 85	[TPS6586X_INT_AC_DET]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 3),
 86	[TPS6586X_INT_BAT_DET]	= TPS6586X_IRQ(TPS6586X_INT_MASK3, 1 << 0),
 87	[TPS6586X_INT_CHG_STAT]	= TPS6586X_IRQ(TPS6586X_INT_MASK4, 0xfc),
 88	[TPS6586X_INT_CHG_TEMP]	= TPS6586X_IRQ(TPS6586X_INT_MASK3, 0x06),
 89	[TPS6586X_INT_PP]	= TPS6586X_IRQ(TPS6586X_INT_MASK3, 0xf0),
 90	[TPS6586X_INT_RESUME]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 5),
 91	[TPS6586X_INT_LOW_SYS]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 6),
 92	[TPS6586X_INT_RTC_ALM2] = TPS6586X_IRQ(TPS6586X_INT_MASK4, 1 << 1),
 93};
 94
 95static struct resource tps6586x_rtc_resources[] = {
 96	{
 97		.start  = TPS6586X_INT_RTC_ALM1,
 98		.end	= TPS6586X_INT_RTC_ALM1,
 99		.flags	= IORESOURCE_IRQ,
100	},
101};
102
103static const struct mfd_cell tps6586x_cell[] = {
104	{
105		.name = "tps6586x-gpio",
106	},
107	{
108		.name = "tps6586x-regulator",
109	},
110	{
111		.name = "tps6586x-rtc",
112		.num_resources = ARRAY_SIZE(tps6586x_rtc_resources),
113		.resources = &tps6586x_rtc_resources[0],
114	},
115	{
116		.name = "tps6586x-onkey",
117	},
118};
119
120struct tps6586x {
121	struct device		*dev;
122	struct i2c_client	*client;
123	struct regmap		*regmap;
124	int			version;
125
126	int			irq;
127	struct irq_chip		irq_chip;
128	struct mutex		irq_lock;
129	int			irq_base;
130	u32			irq_en;
131	u8			mask_reg[5];
132	struct irq_domain	*irq_domain;
133};
134
135static inline struct tps6586x *dev_to_tps6586x(struct device *dev)
136{
137	return i2c_get_clientdata(to_i2c_client(dev));
138}
139
140int tps6586x_write(struct device *dev, int reg, uint8_t val)
141{
142	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
143
144	return regmap_write(tps6586x->regmap, reg, val);
145}
146EXPORT_SYMBOL_GPL(tps6586x_write);
147
148int tps6586x_writes(struct device *dev, int reg, int len, uint8_t *val)
149{
150	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
151
152	return regmap_bulk_write(tps6586x->regmap, reg, val, len);
153}
154EXPORT_SYMBOL_GPL(tps6586x_writes);
155
156int tps6586x_read(struct device *dev, int reg, uint8_t *val)
157{
158	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
159	unsigned int rval;
160	int ret;
161
162	ret = regmap_read(tps6586x->regmap, reg, &rval);
163	if (!ret)
164		*val = rval;
165	return ret;
166}
167EXPORT_SYMBOL_GPL(tps6586x_read);
168
169int tps6586x_reads(struct device *dev, int reg, int len, uint8_t *val)
170{
171	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
172
173	return regmap_bulk_read(tps6586x->regmap, reg, val, len);
174}
175EXPORT_SYMBOL_GPL(tps6586x_reads);
176
177int tps6586x_set_bits(struct device *dev, int reg, uint8_t bit_mask)
178{
179	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
180
181	return regmap_update_bits(tps6586x->regmap, reg, bit_mask, bit_mask);
182}
183EXPORT_SYMBOL_GPL(tps6586x_set_bits);
184
185int tps6586x_clr_bits(struct device *dev, int reg, uint8_t bit_mask)
186{
187	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
188
189	return regmap_update_bits(tps6586x->regmap, reg, bit_mask, 0);
190}
191EXPORT_SYMBOL_GPL(tps6586x_clr_bits);
192
193int tps6586x_update(struct device *dev, int reg, uint8_t val, uint8_t mask)
194{
195	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
196
197	return regmap_update_bits(tps6586x->regmap, reg, mask, val);
198}
199EXPORT_SYMBOL_GPL(tps6586x_update);
200
201int tps6586x_irq_get_virq(struct device *dev, int irq)
202{
203	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
204
205	return irq_create_mapping(tps6586x->irq_domain, irq);
206}
207EXPORT_SYMBOL_GPL(tps6586x_irq_get_virq);
208
209int tps6586x_get_version(struct device *dev)
210{
211	struct tps6586x *tps6586x = dev_get_drvdata(dev);
212
213	return tps6586x->version;
214}
215EXPORT_SYMBOL_GPL(tps6586x_get_version);
216
217static int __remove_subdev(struct device *dev, void *unused)
218{
219	platform_device_unregister(to_platform_device(dev));
220	return 0;
221}
222
223static int tps6586x_remove_subdevs(struct tps6586x *tps6586x)
224{
225	return device_for_each_child(tps6586x->dev, NULL, __remove_subdev);
226}
227
228static void tps6586x_irq_lock(struct irq_data *data)
229{
230	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(data);
231
232	mutex_lock(&tps6586x->irq_lock);
233}
234
235static void tps6586x_irq_enable(struct irq_data *irq_data)
236{
237	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(irq_data);
238	unsigned int __irq = irq_data->hwirq;
239	const struct tps6586x_irq_data *data = &tps6586x_irqs[__irq];
240
241	tps6586x->mask_reg[data->mask_reg] &= ~data->mask_mask;
242	tps6586x->irq_en |= (1 << __irq);
243}
244
245static void tps6586x_irq_disable(struct irq_data *irq_data)
246{
247	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(irq_data);
248
249	unsigned int __irq = irq_data->hwirq;
250	const struct tps6586x_irq_data *data = &tps6586x_irqs[__irq];
251
252	tps6586x->mask_reg[data->mask_reg] |= data->mask_mask;
253	tps6586x->irq_en &= ~(1 << __irq);
254}
255
256static void tps6586x_irq_sync_unlock(struct irq_data *data)
257{
258	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(data);
259	int i;
260
261	for (i = 0; i < ARRAY_SIZE(tps6586x->mask_reg); i++) {
262		int ret;
263		ret = tps6586x_write(tps6586x->dev,
264					    TPS6586X_INT_MASK1 + i,
265					    tps6586x->mask_reg[i]);
266		WARN_ON(ret);
267	}
268
269	mutex_unlock(&tps6586x->irq_lock);
270}
271
272#ifdef CONFIG_PM_SLEEP
273static int tps6586x_irq_set_wake(struct irq_data *irq_data, unsigned int on)
274{
275	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(irq_data);
276	return irq_set_irq_wake(tps6586x->irq, on);
277}
278#else
279#define tps6586x_irq_set_wake NULL
280#endif
281
282static struct irq_chip tps6586x_irq_chip = {
283	.name = "tps6586x",
284	.irq_bus_lock = tps6586x_irq_lock,
285	.irq_bus_sync_unlock = tps6586x_irq_sync_unlock,
286	.irq_disable = tps6586x_irq_disable,
287	.irq_enable = tps6586x_irq_enable,
288	.irq_set_wake = tps6586x_irq_set_wake,
289};
290
291static int tps6586x_irq_map(struct irq_domain *h, unsigned int virq,
292				irq_hw_number_t hw)
293{
294	struct tps6586x *tps6586x = h->host_data;
295
296	irq_set_chip_data(virq, tps6586x);
297	irq_set_chip_and_handler(virq, &tps6586x_irq_chip, handle_simple_irq);
298	irq_set_nested_thread(virq, 1);
 
 
 
 
 
 
299	irq_set_noprobe(virq);
 
300
301	return 0;
302}
303
304static const struct irq_domain_ops tps6586x_domain_ops = {
305	.map    = tps6586x_irq_map,
306	.xlate  = irq_domain_xlate_twocell,
307};
308
309static irqreturn_t tps6586x_irq(int irq, void *data)
310{
311	struct tps6586x *tps6586x = data;
312	uint32_t acks;
313	__le32 val;
314	int ret = 0;
315
316	ret = tps6586x_reads(tps6586x->dev, TPS6586X_INT_ACK1,
317			     sizeof(acks), (uint8_t *)&val);
318
319	if (ret < 0) {
320		dev_err(tps6586x->dev, "failed to read interrupt status\n");
321		return IRQ_NONE;
322	}
323
324	acks = le32_to_cpu(val);
325
326	while (acks) {
327		int i = __ffs(acks);
328
329		if (tps6586x->irq_en & (1 << i))
330			handle_nested_irq(
331				irq_find_mapping(tps6586x->irq_domain, i));
332
333		acks &= ~(1 << i);
334	}
335
336	return IRQ_HANDLED;
337}
338
339static int tps6586x_irq_init(struct tps6586x *tps6586x, int irq,
340				       int irq_base)
341{
342	int i, ret;
343	u8 tmp[4];
344	int new_irq_base;
345	int irq_num = ARRAY_SIZE(tps6586x_irqs);
346
347	tps6586x->irq = irq;
348
349	mutex_init(&tps6586x->irq_lock);
350	for (i = 0; i < 5; i++) {
351		tps6586x->mask_reg[i] = 0xff;
352		tps6586x_write(tps6586x->dev, TPS6586X_INT_MASK1 + i, 0xff);
353	}
354
355	tps6586x_reads(tps6586x->dev, TPS6586X_INT_ACK1, sizeof(tmp), tmp);
356
357	if  (irq_base > 0) {
358		new_irq_base = irq_alloc_descs(irq_base, 0, irq_num, -1);
359		if (new_irq_base < 0) {
360			dev_err(tps6586x->dev,
361				"Failed to alloc IRQs: %d\n", new_irq_base);
362			return new_irq_base;
363		}
364	} else {
365		new_irq_base = 0;
366	}
367
368	tps6586x->irq_domain = irq_domain_add_simple(tps6586x->dev->of_node,
369				irq_num, new_irq_base, &tps6586x_domain_ops,
370				tps6586x);
371	if (!tps6586x->irq_domain) {
372		dev_err(tps6586x->dev, "Failed to create IRQ domain\n");
373		return -ENOMEM;
374	}
375	ret = request_threaded_irq(irq, NULL, tps6586x_irq, IRQF_ONESHOT,
376				   "tps6586x", tps6586x);
377
378	if (!ret)
379		device_init_wakeup(tps6586x->dev, 1);
380
381	return ret;
382}
383
384static int tps6586x_add_subdevs(struct tps6586x *tps6586x,
385					  struct tps6586x_platform_data *pdata)
386{
387	struct tps6586x_subdev_info *subdev;
388	struct platform_device *pdev;
389	int i, ret = 0;
390
391	for (i = 0; i < pdata->num_subdevs; i++) {
392		subdev = &pdata->subdevs[i];
393
394		pdev = platform_device_alloc(subdev->name, subdev->id);
395		if (!pdev) {
396			ret = -ENOMEM;
397			goto failed;
398		}
399
400		pdev->dev.parent = tps6586x->dev;
401		pdev->dev.platform_data = subdev->platform_data;
402		pdev->dev.of_node = subdev->of_node;
403
404		ret = platform_device_add(pdev);
405		if (ret) {
406			platform_device_put(pdev);
407			goto failed;
408		}
409	}
410	return 0;
411
412failed:
413	tps6586x_remove_subdevs(tps6586x);
414	return ret;
415}
416
417#ifdef CONFIG_OF
418static struct tps6586x_platform_data *tps6586x_parse_dt(struct i2c_client *client)
419{
420	struct device_node *np = client->dev.of_node;
421	struct tps6586x_platform_data *pdata;
422
423	pdata = devm_kzalloc(&client->dev, sizeof(*pdata), GFP_KERNEL);
424	if (!pdata)
 
425		return NULL;
 
426
427	pdata->num_subdevs = 0;
428	pdata->subdevs = NULL;
429	pdata->gpio_base = -1;
430	pdata->irq_base = -1;
431	pdata->pm_off = of_property_read_bool(np, "ti,system-power-controller");
432
433	return pdata;
434}
435
436static const struct of_device_id tps6586x_of_match[] = {
437	{ .compatible = "ti,tps6586x", },
438	{ },
439};
440#else
441static struct tps6586x_platform_data *tps6586x_parse_dt(struct i2c_client *client)
442{
443	return NULL;
444}
445#endif
446
447static bool is_volatile_reg(struct device *dev, unsigned int reg)
448{
449	/* Cache all interrupt mask register */
450	if ((reg >= TPS6586X_INT_MASK1) && (reg <= TPS6586X_INT_MASK5))
451		return false;
452
453	return true;
454}
455
456static const struct regmap_config tps6586x_regmap_config = {
457	.reg_bits = 8,
458	.val_bits = 8,
459	.max_register = TPS6586X_MAX_REGISTER,
460	.volatile_reg = is_volatile_reg,
461	.cache_type = REGCACHE_RBTREE,
462};
463
464static struct device *tps6586x_dev;
465static void tps6586x_power_off(void)
466{
467	if (tps6586x_clr_bits(tps6586x_dev, TPS6586X_SUPPLYENE, EXITSLREQ_BIT))
468		return;
469
470	tps6586x_set_bits(tps6586x_dev, TPS6586X_SUPPLYENE, SLEEP_MODE_BIT);
471}
472
473static void tps6586x_print_version(struct i2c_client *client, int version)
474{
475	const char *name;
476
477	switch (version) {
478	case TPS658621A:
479		name = "TPS658621A";
480		break;
481	case TPS658621CD:
482		name = "TPS658621C/D";
483		break;
484	case TPS658623:
485		name = "TPS658623";
486		break;
487	case TPS658640:
488	case TPS658640v2:
489		name = "TPS658640";
490		break;
491	case TPS658643:
492		name = "TPS658643";
493		break;
494	default:
495		name = "TPS6586X";
496		break;
497	}
498
499	dev_info(&client->dev, "Found %s, VERSIONCRC is %02x\n", name, version);
500}
501
502static int tps6586x_i2c_probe(struct i2c_client *client,
503					const struct i2c_device_id *id)
504{
505	struct tps6586x_platform_data *pdata = dev_get_platdata(&client->dev);
506	struct tps6586x *tps6586x;
507	int ret;
508	int version;
509
510	if (!pdata && client->dev.of_node)
511		pdata = tps6586x_parse_dt(client);
512
513	if (!pdata) {
514		dev_err(&client->dev, "tps6586x requires platform data\n");
515		return -ENOTSUPP;
516	}
517
518	version = i2c_smbus_read_byte_data(client, TPS6586X_VERSIONCRC);
519	if (version < 0) {
520		dev_err(&client->dev, "Chip ID read failed: %d\n", version);
521		return -EIO;
522	}
523
524	tps6586x = devm_kzalloc(&client->dev, sizeof(*tps6586x), GFP_KERNEL);
525	if (!tps6586x)
526		return -ENOMEM;
527
528	tps6586x->version = version;
529	tps6586x_print_version(client, tps6586x->version);
530
531	tps6586x->client = client;
532	tps6586x->dev = &client->dev;
533	i2c_set_clientdata(client, tps6586x);
534
535	tps6586x->regmap = devm_regmap_init_i2c(client,
536					&tps6586x_regmap_config);
537	if (IS_ERR(tps6586x->regmap)) {
538		ret = PTR_ERR(tps6586x->regmap);
539		dev_err(&client->dev, "regmap init failed: %d\n", ret);
540		return ret;
541	}
542
543
544	if (client->irq) {
545		ret = tps6586x_irq_init(tps6586x, client->irq,
546					pdata->irq_base);
547		if (ret) {
548			dev_err(&client->dev, "IRQ init failed: %d\n", ret);
549			return ret;
550		}
551	}
552
553	ret = mfd_add_devices(tps6586x->dev, -1,
554			      tps6586x_cell, ARRAY_SIZE(tps6586x_cell),
555			      NULL, 0, tps6586x->irq_domain);
556	if (ret < 0) {
557		dev_err(&client->dev, "mfd_add_devices failed: %d\n", ret);
558		goto err_mfd_add;
559	}
560
561	ret = tps6586x_add_subdevs(tps6586x, pdata);
562	if (ret) {
563		dev_err(&client->dev, "add devices failed: %d\n", ret);
564		goto err_add_devs;
565	}
566
567	if (pdata->pm_off && !pm_power_off) {
568		tps6586x_dev = &client->dev;
569		pm_power_off = tps6586x_power_off;
570	}
571
572	return 0;
573
574err_add_devs:
575	mfd_remove_devices(tps6586x->dev);
576err_mfd_add:
577	if (client->irq)
578		free_irq(client->irq, tps6586x);
579	return ret;
580}
581
582static int tps6586x_i2c_remove(struct i2c_client *client)
583{
584	struct tps6586x *tps6586x = i2c_get_clientdata(client);
585
586	tps6586x_remove_subdevs(tps6586x);
587	mfd_remove_devices(tps6586x->dev);
588	if (client->irq)
589		free_irq(client->irq, tps6586x);
590	return 0;
591}
592
593static int __maybe_unused tps6586x_i2c_suspend(struct device *dev)
594{
595	struct tps6586x *tps6586x = dev_get_drvdata(dev);
596
597	if (tps6586x->client->irq)
598		disable_irq(tps6586x->client->irq);
599
600	return 0;
601}
602
603static int __maybe_unused tps6586x_i2c_resume(struct device *dev)
604{
605	struct tps6586x *tps6586x = dev_get_drvdata(dev);
606
607	if (tps6586x->client->irq)
608		enable_irq(tps6586x->client->irq);
609
610	return 0;
611}
612
613static SIMPLE_DEV_PM_OPS(tps6586x_pm_ops, tps6586x_i2c_suspend,
614			 tps6586x_i2c_resume);
615
616static const struct i2c_device_id tps6586x_id_table[] = {
617	{ "tps6586x", 0 },
618	{ },
619};
620MODULE_DEVICE_TABLE(i2c, tps6586x_id_table);
621
622static struct i2c_driver tps6586x_driver = {
623	.driver	= {
624		.name	= "tps6586x",
 
625		.of_match_table = of_match_ptr(tps6586x_of_match),
626		.pm	= &tps6586x_pm_ops,
627	},
628	.probe		= tps6586x_i2c_probe,
629	.remove		= tps6586x_i2c_remove,
630	.id_table	= tps6586x_id_table,
631};
632
633static int __init tps6586x_init(void)
634{
635	return i2c_add_driver(&tps6586x_driver);
636}
637subsys_initcall(tps6586x_init);
638
639static void __exit tps6586x_exit(void)
640{
641	i2c_del_driver(&tps6586x_driver);
642}
643module_exit(tps6586x_exit);
644
645MODULE_DESCRIPTION("TPS6586X core driver");
646MODULE_AUTHOR("Mike Rapoport <mike@compulab.co.il>");
647MODULE_LICENSE("GPL");
v3.15
 
  1/*
  2 * Core driver for TI TPS6586x PMIC family
  3 *
  4 * Copyright (c) 2010 CompuLab Ltd.
  5 * Mike Rapoport <mike@compulab.co.il>
  6 *
  7 * Based on da903x.c.
  8 * Copyright (C) 2008 Compulab, Ltd.
  9 * Mike Rapoport <mike@compulab.co.il>
 10 * Copyright (C) 2006-2008 Marvell International Ltd.
 11 * Eric Miao <eric.miao@marvell.com>
 12 *
 13 * This program is free software; you can redistribute it and/or modify
 14 * it under the terms of the GNU General Public License version 2 as
 15 * published by the Free Software Foundation.
 16 */
 17
 18#include <linux/interrupt.h>
 19#include <linux/irq.h>
 20#include <linux/irqdomain.h>
 21#include <linux/kernel.h>
 22#include <linux/module.h>
 23#include <linux/mutex.h>
 24#include <linux/slab.h>
 25#include <linux/err.h>
 26#include <linux/i2c.h>
 27#include <linux/platform_device.h>
 28#include <linux/regmap.h>
 29#include <linux/of.h>
 30
 31#include <linux/mfd/core.h>
 32#include <linux/mfd/tps6586x.h>
 33
 34#define TPS6586X_SUPPLYENE	0x14
 35#define EXITSLREQ_BIT		BIT(1)
 36#define SLEEP_MODE_BIT		BIT(3)
 37
 38/* interrupt control registers */
 39#define TPS6586X_INT_ACK1	0xb5
 40#define TPS6586X_INT_ACK2	0xb6
 41#define TPS6586X_INT_ACK3	0xb7
 42#define TPS6586X_INT_ACK4	0xb8
 43
 44/* interrupt mask registers */
 45#define TPS6586X_INT_MASK1	0xb0
 46#define TPS6586X_INT_MASK2	0xb1
 47#define TPS6586X_INT_MASK3	0xb2
 48#define TPS6586X_INT_MASK4	0xb3
 49#define TPS6586X_INT_MASK5	0xb4
 50
 51/* device id */
 52#define TPS6586X_VERSIONCRC	0xcd
 53
 54/* Maximum register */
 55#define TPS6586X_MAX_REGISTER	(TPS6586X_VERSIONCRC + 1)
 56
 57struct tps6586x_irq_data {
 58	u8	mask_reg;
 59	u8	mask_mask;
 60};
 61
 62#define TPS6586X_IRQ(_reg, _mask)				\
 63	{							\
 64		.mask_reg = (_reg) - TPS6586X_INT_MASK1,	\
 65		.mask_mask = (_mask),				\
 66	}
 67
 68static const struct tps6586x_irq_data tps6586x_irqs[] = {
 69	[TPS6586X_INT_PLDO_0]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 0),
 70	[TPS6586X_INT_PLDO_1]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 1),
 71	[TPS6586X_INT_PLDO_2]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 2),
 72	[TPS6586X_INT_PLDO_3]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 3),
 73	[TPS6586X_INT_PLDO_4]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 4),
 74	[TPS6586X_INT_PLDO_5]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 5),
 75	[TPS6586X_INT_PLDO_6]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 6),
 76	[TPS6586X_INT_PLDO_7]	= TPS6586X_IRQ(TPS6586X_INT_MASK1, 1 << 7),
 77	[TPS6586X_INT_COMP_DET]	= TPS6586X_IRQ(TPS6586X_INT_MASK4, 1 << 0),
 78	[TPS6586X_INT_ADC]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 1),
 79	[TPS6586X_INT_PLDO_8]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 2),
 80	[TPS6586X_INT_PLDO_9]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 3),
 81	[TPS6586X_INT_PSM_0]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 4),
 82	[TPS6586X_INT_PSM_1]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 5),
 83	[TPS6586X_INT_PSM_2]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 6),
 84	[TPS6586X_INT_PSM_3]	= TPS6586X_IRQ(TPS6586X_INT_MASK2, 1 << 7),
 85	[TPS6586X_INT_RTC_ALM1]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 4),
 86	[TPS6586X_INT_ACUSB_OVP] = TPS6586X_IRQ(TPS6586X_INT_MASK5, 0x03),
 87	[TPS6586X_INT_USB_DET]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 2),
 88	[TPS6586X_INT_AC_DET]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 3),
 89	[TPS6586X_INT_BAT_DET]	= TPS6586X_IRQ(TPS6586X_INT_MASK3, 1 << 0),
 90	[TPS6586X_INT_CHG_STAT]	= TPS6586X_IRQ(TPS6586X_INT_MASK4, 0xfc),
 91	[TPS6586X_INT_CHG_TEMP]	= TPS6586X_IRQ(TPS6586X_INT_MASK3, 0x06),
 92	[TPS6586X_INT_PP]	= TPS6586X_IRQ(TPS6586X_INT_MASK3, 0xf0),
 93	[TPS6586X_INT_RESUME]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 5),
 94	[TPS6586X_INT_LOW_SYS]	= TPS6586X_IRQ(TPS6586X_INT_MASK5, 1 << 6),
 95	[TPS6586X_INT_RTC_ALM2] = TPS6586X_IRQ(TPS6586X_INT_MASK4, 1 << 1),
 96};
 97
 98static struct resource tps6586x_rtc_resources[] = {
 99	{
100		.start  = TPS6586X_INT_RTC_ALM1,
101		.end	= TPS6586X_INT_RTC_ALM1,
102		.flags	= IORESOURCE_IRQ,
103	},
104};
105
106static const struct mfd_cell tps6586x_cell[] = {
107	{
108		.name = "tps6586x-gpio",
109	},
110	{
111		.name = "tps6586x-regulator",
112	},
113	{
114		.name = "tps6586x-rtc",
115		.num_resources = ARRAY_SIZE(tps6586x_rtc_resources),
116		.resources = &tps6586x_rtc_resources[0],
117	},
118	{
119		.name = "tps6586x-onkey",
120	},
121};
122
123struct tps6586x {
124	struct device		*dev;
125	struct i2c_client	*client;
126	struct regmap		*regmap;
127	int			version;
128
129	int			irq;
130	struct irq_chip		irq_chip;
131	struct mutex		irq_lock;
132	int			irq_base;
133	u32			irq_en;
134	u8			mask_reg[5];
135	struct irq_domain	*irq_domain;
136};
137
138static inline struct tps6586x *dev_to_tps6586x(struct device *dev)
139{
140	return i2c_get_clientdata(to_i2c_client(dev));
141}
142
143int tps6586x_write(struct device *dev, int reg, uint8_t val)
144{
145	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
146
147	return regmap_write(tps6586x->regmap, reg, val);
148}
149EXPORT_SYMBOL_GPL(tps6586x_write);
150
151int tps6586x_writes(struct device *dev, int reg, int len, uint8_t *val)
152{
153	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
154
155	return regmap_bulk_write(tps6586x->regmap, reg, val, len);
156}
157EXPORT_SYMBOL_GPL(tps6586x_writes);
158
159int tps6586x_read(struct device *dev, int reg, uint8_t *val)
160{
161	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
162	unsigned int rval;
163	int ret;
164
165	ret = regmap_read(tps6586x->regmap, reg, &rval);
166	if (!ret)
167		*val = rval;
168	return ret;
169}
170EXPORT_SYMBOL_GPL(tps6586x_read);
171
172int tps6586x_reads(struct device *dev, int reg, int len, uint8_t *val)
173{
174	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
175
176	return regmap_bulk_read(tps6586x->regmap, reg, val, len);
177}
178EXPORT_SYMBOL_GPL(tps6586x_reads);
179
180int tps6586x_set_bits(struct device *dev, int reg, uint8_t bit_mask)
181{
182	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
183
184	return regmap_update_bits(tps6586x->regmap, reg, bit_mask, bit_mask);
185}
186EXPORT_SYMBOL_GPL(tps6586x_set_bits);
187
188int tps6586x_clr_bits(struct device *dev, int reg, uint8_t bit_mask)
189{
190	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
191
192	return regmap_update_bits(tps6586x->regmap, reg, bit_mask, 0);
193}
194EXPORT_SYMBOL_GPL(tps6586x_clr_bits);
195
196int tps6586x_update(struct device *dev, int reg, uint8_t val, uint8_t mask)
197{
198	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
199
200	return regmap_update_bits(tps6586x->regmap, reg, mask, val);
201}
202EXPORT_SYMBOL_GPL(tps6586x_update);
203
204int tps6586x_irq_get_virq(struct device *dev, int irq)
205{
206	struct tps6586x *tps6586x = dev_to_tps6586x(dev);
207
208	return irq_create_mapping(tps6586x->irq_domain, irq);
209}
210EXPORT_SYMBOL_GPL(tps6586x_irq_get_virq);
211
212int tps6586x_get_version(struct device *dev)
213{
214	struct tps6586x *tps6586x = dev_get_drvdata(dev);
215
216	return tps6586x->version;
217}
218EXPORT_SYMBOL_GPL(tps6586x_get_version);
219
220static int __remove_subdev(struct device *dev, void *unused)
221{
222	platform_device_unregister(to_platform_device(dev));
223	return 0;
224}
225
226static int tps6586x_remove_subdevs(struct tps6586x *tps6586x)
227{
228	return device_for_each_child(tps6586x->dev, NULL, __remove_subdev);
229}
230
231static void tps6586x_irq_lock(struct irq_data *data)
232{
233	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(data);
234
235	mutex_lock(&tps6586x->irq_lock);
236}
237
238static void tps6586x_irq_enable(struct irq_data *irq_data)
239{
240	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(irq_data);
241	unsigned int __irq = irq_data->hwirq;
242	const struct tps6586x_irq_data *data = &tps6586x_irqs[__irq];
243
244	tps6586x->mask_reg[data->mask_reg] &= ~data->mask_mask;
245	tps6586x->irq_en |= (1 << __irq);
246}
247
248static void tps6586x_irq_disable(struct irq_data *irq_data)
249{
250	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(irq_data);
251
252	unsigned int __irq = irq_data->hwirq;
253	const struct tps6586x_irq_data *data = &tps6586x_irqs[__irq];
254
255	tps6586x->mask_reg[data->mask_reg] |= data->mask_mask;
256	tps6586x->irq_en &= ~(1 << __irq);
257}
258
259static void tps6586x_irq_sync_unlock(struct irq_data *data)
260{
261	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(data);
262	int i;
263
264	for (i = 0; i < ARRAY_SIZE(tps6586x->mask_reg); i++) {
265		int ret;
266		ret = tps6586x_write(tps6586x->dev,
267					    TPS6586X_INT_MASK1 + i,
268					    tps6586x->mask_reg[i]);
269		WARN_ON(ret);
270	}
271
272	mutex_unlock(&tps6586x->irq_lock);
273}
274
275#ifdef CONFIG_PM_SLEEP
276static int tps6586x_irq_set_wake(struct irq_data *irq_data, unsigned int on)
277{
278	struct tps6586x *tps6586x = irq_data_get_irq_chip_data(irq_data);
279	return irq_set_irq_wake(tps6586x->irq, on);
280}
281#else
282#define tps6586x_irq_set_wake NULL
283#endif
284
285static struct irq_chip tps6586x_irq_chip = {
286	.name = "tps6586x",
287	.irq_bus_lock = tps6586x_irq_lock,
288	.irq_bus_sync_unlock = tps6586x_irq_sync_unlock,
289	.irq_disable = tps6586x_irq_disable,
290	.irq_enable = tps6586x_irq_enable,
291	.irq_set_wake = tps6586x_irq_set_wake,
292};
293
294static int tps6586x_irq_map(struct irq_domain *h, unsigned int virq,
295				irq_hw_number_t hw)
296{
297	struct tps6586x *tps6586x = h->host_data;
298
299	irq_set_chip_data(virq, tps6586x);
300	irq_set_chip_and_handler(virq, &tps6586x_irq_chip, handle_simple_irq);
301	irq_set_nested_thread(virq, 1);
302
303	/* ARM needs us to explicitly flag the IRQ as valid
304	 * and will set them noprobe when we do so. */
305#ifdef CONFIG_ARM
306	set_irq_flags(virq, IRQF_VALID);
307#else
308	irq_set_noprobe(virq);
309#endif
310
311	return 0;
312}
313
314static struct irq_domain_ops tps6586x_domain_ops = {
315	.map    = tps6586x_irq_map,
316	.xlate  = irq_domain_xlate_twocell,
317};
318
319static irqreturn_t tps6586x_irq(int irq, void *data)
320{
321	struct tps6586x *tps6586x = data;
322	u32 acks;
 
323	int ret = 0;
324
325	ret = tps6586x_reads(tps6586x->dev, TPS6586X_INT_ACK1,
326			     sizeof(acks), (uint8_t *)&acks);
327
328	if (ret < 0) {
329		dev_err(tps6586x->dev, "failed to read interrupt status\n");
330		return IRQ_NONE;
331	}
332
333	acks = le32_to_cpu(acks);
334
335	while (acks) {
336		int i = __ffs(acks);
337
338		if (tps6586x->irq_en & (1 << i))
339			handle_nested_irq(
340				irq_find_mapping(tps6586x->irq_domain, i));
341
342		acks &= ~(1 << i);
343	}
344
345	return IRQ_HANDLED;
346}
347
348static int tps6586x_irq_init(struct tps6586x *tps6586x, int irq,
349				       int irq_base)
350{
351	int i, ret;
352	u8 tmp[4];
353	int new_irq_base;
354	int irq_num = ARRAY_SIZE(tps6586x_irqs);
355
356	tps6586x->irq = irq;
357
358	mutex_init(&tps6586x->irq_lock);
359	for (i = 0; i < 5; i++) {
360		tps6586x->mask_reg[i] = 0xff;
361		tps6586x_write(tps6586x->dev, TPS6586X_INT_MASK1 + i, 0xff);
362	}
363
364	tps6586x_reads(tps6586x->dev, TPS6586X_INT_ACK1, sizeof(tmp), tmp);
365
366	if  (irq_base > 0) {
367		new_irq_base = irq_alloc_descs(irq_base, 0, irq_num, -1);
368		if (new_irq_base < 0) {
369			dev_err(tps6586x->dev,
370				"Failed to alloc IRQs: %d\n", new_irq_base);
371			return new_irq_base;
372		}
373	} else {
374		new_irq_base = 0;
375	}
376
377	tps6586x->irq_domain = irq_domain_add_simple(tps6586x->dev->of_node,
378				irq_num, new_irq_base, &tps6586x_domain_ops,
379				tps6586x);
380	if (!tps6586x->irq_domain) {
381		dev_err(tps6586x->dev, "Failed to create IRQ domain\n");
382		return -ENOMEM;
383	}
384	ret = request_threaded_irq(irq, NULL, tps6586x_irq, IRQF_ONESHOT,
385				   "tps6586x", tps6586x);
386
387	if (!ret)
388		device_init_wakeup(tps6586x->dev, 1);
389
390	return ret;
391}
392
393static int tps6586x_add_subdevs(struct tps6586x *tps6586x,
394					  struct tps6586x_platform_data *pdata)
395{
396	struct tps6586x_subdev_info *subdev;
397	struct platform_device *pdev;
398	int i, ret = 0;
399
400	for (i = 0; i < pdata->num_subdevs; i++) {
401		subdev = &pdata->subdevs[i];
402
403		pdev = platform_device_alloc(subdev->name, subdev->id);
404		if (!pdev) {
405			ret = -ENOMEM;
406			goto failed;
407		}
408
409		pdev->dev.parent = tps6586x->dev;
410		pdev->dev.platform_data = subdev->platform_data;
411		pdev->dev.of_node = subdev->of_node;
412
413		ret = platform_device_add(pdev);
414		if (ret) {
415			platform_device_put(pdev);
416			goto failed;
417		}
418	}
419	return 0;
420
421failed:
422	tps6586x_remove_subdevs(tps6586x);
423	return ret;
424}
425
426#ifdef CONFIG_OF
427static struct tps6586x_platform_data *tps6586x_parse_dt(struct i2c_client *client)
428{
429	struct device_node *np = client->dev.of_node;
430	struct tps6586x_platform_data *pdata;
431
432	pdata = devm_kzalloc(&client->dev, sizeof(*pdata), GFP_KERNEL);
433	if (!pdata) {
434		dev_err(&client->dev, "Memory allocation failed\n");
435		return NULL;
436	}
437
438	pdata->num_subdevs = 0;
439	pdata->subdevs = NULL;
440	pdata->gpio_base = -1;
441	pdata->irq_base = -1;
442	pdata->pm_off = of_property_read_bool(np, "ti,system-power-controller");
443
444	return pdata;
445}
446
447static struct of_device_id tps6586x_of_match[] = {
448	{ .compatible = "ti,tps6586x", },
449	{ },
450};
451#else
452static struct tps6586x_platform_data *tps6586x_parse_dt(struct i2c_client *client)
453{
454	return NULL;
455}
456#endif
457
458static bool is_volatile_reg(struct device *dev, unsigned int reg)
459{
460	/* Cache all interrupt mask register */
461	if ((reg >= TPS6586X_INT_MASK1) && (reg <= TPS6586X_INT_MASK5))
462		return false;
463
464	return true;
465}
466
467static const struct regmap_config tps6586x_regmap_config = {
468	.reg_bits = 8,
469	.val_bits = 8,
470	.max_register = TPS6586X_MAX_REGISTER - 1,
471	.volatile_reg = is_volatile_reg,
472	.cache_type = REGCACHE_RBTREE,
473};
474
475static struct device *tps6586x_dev;
476static void tps6586x_power_off(void)
477{
478	if (tps6586x_clr_bits(tps6586x_dev, TPS6586X_SUPPLYENE, EXITSLREQ_BIT))
479		return;
480
481	tps6586x_set_bits(tps6586x_dev, TPS6586X_SUPPLYENE, SLEEP_MODE_BIT);
482}
483
484static void tps6586x_print_version(struct i2c_client *client, int version)
485{
486	const char *name;
487
488	switch (version) {
489	case TPS658621A:
490		name = "TPS658621A";
491		break;
492	case TPS658621CD:
493		name = "TPS658621C/D";
494		break;
495	case TPS658623:
496		name = "TPS658623";
497		break;
 
 
 
 
498	case TPS658643:
499		name = "TPS658643";
500		break;
501	default:
502		name = "TPS6586X";
503		break;
504	}
505
506	dev_info(&client->dev, "Found %s, VERSIONCRC is %02x\n", name, version);
507}
508
509static int tps6586x_i2c_probe(struct i2c_client *client,
510					const struct i2c_device_id *id)
511{
512	struct tps6586x_platform_data *pdata = dev_get_platdata(&client->dev);
513	struct tps6586x *tps6586x;
514	int ret;
515	int version;
516
517	if (!pdata && client->dev.of_node)
518		pdata = tps6586x_parse_dt(client);
519
520	if (!pdata) {
521		dev_err(&client->dev, "tps6586x requires platform data\n");
522		return -ENOTSUPP;
523	}
524
525	version = i2c_smbus_read_byte_data(client, TPS6586X_VERSIONCRC);
526	if (version < 0) {
527		dev_err(&client->dev, "Chip ID read failed: %d\n", version);
528		return -EIO;
529	}
530
531	tps6586x = devm_kzalloc(&client->dev, sizeof(*tps6586x), GFP_KERNEL);
532	if (!tps6586x)
533		return -ENOMEM;
534
535	tps6586x->version = version;
536	tps6586x_print_version(client, tps6586x->version);
537
538	tps6586x->client = client;
539	tps6586x->dev = &client->dev;
540	i2c_set_clientdata(client, tps6586x);
541
542	tps6586x->regmap = devm_regmap_init_i2c(client,
543					&tps6586x_regmap_config);
544	if (IS_ERR(tps6586x->regmap)) {
545		ret = PTR_ERR(tps6586x->regmap);
546		dev_err(&client->dev, "regmap init failed: %d\n", ret);
547		return ret;
548	}
549
550
551	if (client->irq) {
552		ret = tps6586x_irq_init(tps6586x, client->irq,
553					pdata->irq_base);
554		if (ret) {
555			dev_err(&client->dev, "IRQ init failed: %d\n", ret);
556			return ret;
557		}
558	}
559
560	ret = mfd_add_devices(tps6586x->dev, -1,
561			      tps6586x_cell, ARRAY_SIZE(tps6586x_cell),
562			      NULL, 0, tps6586x->irq_domain);
563	if (ret < 0) {
564		dev_err(&client->dev, "mfd_add_devices failed: %d\n", ret);
565		goto err_mfd_add;
566	}
567
568	ret = tps6586x_add_subdevs(tps6586x, pdata);
569	if (ret) {
570		dev_err(&client->dev, "add devices failed: %d\n", ret);
571		goto err_add_devs;
572	}
573
574	if (pdata->pm_off && !pm_power_off) {
575		tps6586x_dev = &client->dev;
576		pm_power_off = tps6586x_power_off;
577	}
578
579	return 0;
580
581err_add_devs:
582	mfd_remove_devices(tps6586x->dev);
583err_mfd_add:
584	if (client->irq)
585		free_irq(client->irq, tps6586x);
586	return ret;
587}
588
589static int tps6586x_i2c_remove(struct i2c_client *client)
590{
591	struct tps6586x *tps6586x = i2c_get_clientdata(client);
592
593	tps6586x_remove_subdevs(tps6586x);
594	mfd_remove_devices(tps6586x->dev);
595	if (client->irq)
596		free_irq(client->irq, tps6586x);
597	return 0;
598}
599
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
600static const struct i2c_device_id tps6586x_id_table[] = {
601	{ "tps6586x", 0 },
602	{ },
603};
604MODULE_DEVICE_TABLE(i2c, tps6586x_id_table);
605
606static struct i2c_driver tps6586x_driver = {
607	.driver	= {
608		.name	= "tps6586x",
609		.owner	= THIS_MODULE,
610		.of_match_table = of_match_ptr(tps6586x_of_match),
 
611	},
612	.probe		= tps6586x_i2c_probe,
613	.remove		= tps6586x_i2c_remove,
614	.id_table	= tps6586x_id_table,
615};
616
617static int __init tps6586x_init(void)
618{
619	return i2c_add_driver(&tps6586x_driver);
620}
621subsys_initcall(tps6586x_init);
622
623static void __exit tps6586x_exit(void)
624{
625	i2c_del_driver(&tps6586x_driver);
626}
627module_exit(tps6586x_exit);
628
629MODULE_DESCRIPTION("TPS6586X core driver");
630MODULE_AUTHOR("Mike Rapoport <mike@compulab.co.il>");
631MODULE_LICENSE("GPL");