xref: /OK3568_Linux_fs/kernel/drivers/regulator/ti-abb-regulator.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  * Texas Instruments SoC Adaptive Body Bias(ABB) Regulator
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * Copyright (C) 2011 Texas Instruments, Inc.
5*4882a593Smuzhiyun  * Mike Turquette <mturquette@ti.com>
6*4882a593Smuzhiyun  *
7*4882a593Smuzhiyun  * Copyright (C) 2012-2013 Texas Instruments, Inc.
8*4882a593Smuzhiyun  * Andrii Tseglytskyi <andrii.tseglytskyi@ti.com>
9*4882a593Smuzhiyun  * Nishanth Menon <nm@ti.com>
10*4882a593Smuzhiyun  *
11*4882a593Smuzhiyun  * This program is free software; you can redistribute it and/or modify
12*4882a593Smuzhiyun  * it under the terms of the GNU General Public License version 2 as
13*4882a593Smuzhiyun  * published by the Free Software Foundation.
14*4882a593Smuzhiyun  *
15*4882a593Smuzhiyun  * This program is distributed "as is" WITHOUT ANY WARRANTY of any
16*4882a593Smuzhiyun  * kind, whether express or implied; without even the implied warranty
17*4882a593Smuzhiyun  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18*4882a593Smuzhiyun  * GNU General Public License for more details.
19*4882a593Smuzhiyun  */
20*4882a593Smuzhiyun #include <linux/clk.h>
21*4882a593Smuzhiyun #include <linux/delay.h>
22*4882a593Smuzhiyun #include <linux/err.h>
23*4882a593Smuzhiyun #include <linux/io.h>
24*4882a593Smuzhiyun #include <linux/module.h>
25*4882a593Smuzhiyun #include <linux/of_device.h>
26*4882a593Smuzhiyun #include <linux/of.h>
27*4882a593Smuzhiyun #include <linux/platform_device.h>
28*4882a593Smuzhiyun #include <linux/regulator/driver.h>
29*4882a593Smuzhiyun #include <linux/regulator/machine.h>
30*4882a593Smuzhiyun #include <linux/regulator/of_regulator.h>
31*4882a593Smuzhiyun 
32*4882a593Smuzhiyun /*
33*4882a593Smuzhiyun  * ABB LDO operating states:
34*4882a593Smuzhiyun  * NOMINAL_OPP:	bypasses the ABB LDO
35*4882a593Smuzhiyun  * FAST_OPP:	sets ABB LDO to Forward Body-Bias
36*4882a593Smuzhiyun  * SLOW_OPP:	sets ABB LDO to Reverse Body-Bias
37*4882a593Smuzhiyun  */
38*4882a593Smuzhiyun #define TI_ABB_NOMINAL_OPP	0
39*4882a593Smuzhiyun #define TI_ABB_FAST_OPP		1
40*4882a593Smuzhiyun #define TI_ABB_SLOW_OPP		3
41*4882a593Smuzhiyun 
42*4882a593Smuzhiyun /**
43*4882a593Smuzhiyun  * struct ti_abb_info - ABB information per voltage setting
44*4882a593Smuzhiyun  * @opp_sel:	one of TI_ABB macro
45*4882a593Smuzhiyun  * @vset:	(optional) vset value that LDOVBB needs to be overriden with.
46*4882a593Smuzhiyun  *
47*4882a593Smuzhiyun  * Array of per voltage entries organized in the same order as regulator_desc's
48*4882a593Smuzhiyun  * volt_table list. (selector is used to index from this array)
49*4882a593Smuzhiyun  */
50*4882a593Smuzhiyun struct ti_abb_info {
51*4882a593Smuzhiyun 	u32 opp_sel;
52*4882a593Smuzhiyun 	u32 vset;
53*4882a593Smuzhiyun };
54*4882a593Smuzhiyun 
55*4882a593Smuzhiyun /**
56*4882a593Smuzhiyun  * struct ti_abb_reg - Register description for ABB block
57*4882a593Smuzhiyun  * @setup_off:			setup register offset from base
58*4882a593Smuzhiyun  * @control_off:		control register offset from base
59*4882a593Smuzhiyun  * @sr2_wtcnt_value_mask:	setup register- sr2_wtcnt_value mask
60*4882a593Smuzhiyun  * @fbb_sel_mask:		setup register- FBB sel mask
61*4882a593Smuzhiyun  * @rbb_sel_mask:		setup register- RBB sel mask
62*4882a593Smuzhiyun  * @sr2_en_mask:		setup register- enable mask
63*4882a593Smuzhiyun  * @opp_change_mask:		control register - mask to trigger LDOVBB change
64*4882a593Smuzhiyun  * @opp_sel_mask:		control register - mask for mode to operate
65*4882a593Smuzhiyun  */
66*4882a593Smuzhiyun struct ti_abb_reg {
67*4882a593Smuzhiyun 	u32 setup_off;
68*4882a593Smuzhiyun 	u32 control_off;
69*4882a593Smuzhiyun 
70*4882a593Smuzhiyun 	/* Setup register fields */
71*4882a593Smuzhiyun 	u32 sr2_wtcnt_value_mask;
72*4882a593Smuzhiyun 	u32 fbb_sel_mask;
73*4882a593Smuzhiyun 	u32 rbb_sel_mask;
74*4882a593Smuzhiyun 	u32 sr2_en_mask;
75*4882a593Smuzhiyun 
76*4882a593Smuzhiyun 	/* Control register fields */
77*4882a593Smuzhiyun 	u32 opp_change_mask;
78*4882a593Smuzhiyun 	u32 opp_sel_mask;
79*4882a593Smuzhiyun };
80*4882a593Smuzhiyun 
81*4882a593Smuzhiyun /**
82*4882a593Smuzhiyun  * struct ti_abb - ABB instance data
83*4882a593Smuzhiyun  * @rdesc:			regulator descriptor
84*4882a593Smuzhiyun  * @clk:			clock(usually sysclk) supplying ABB block
85*4882a593Smuzhiyun  * @base:			base address of ABB block
86*4882a593Smuzhiyun  * @setup_reg:			setup register of ABB block
87*4882a593Smuzhiyun  * @control_reg:		control register of ABB block
88*4882a593Smuzhiyun  * @int_base:			interrupt register base address
89*4882a593Smuzhiyun  * @efuse_base:			(optional) efuse base address for ABB modes
90*4882a593Smuzhiyun  * @ldo_base:			(optional) LDOVBB vset override base address
91*4882a593Smuzhiyun  * @regs:			pointer to struct ti_abb_reg for ABB block
92*4882a593Smuzhiyun  * @txdone_mask:		mask on int_base for tranxdone interrupt
93*4882a593Smuzhiyun  * @ldovbb_override_mask:	mask to ldo_base for overriding default LDO VBB
94*4882a593Smuzhiyun  *				vset with value from efuse
95*4882a593Smuzhiyun  * @ldovbb_vset_mask:		mask to ldo_base for providing the VSET override
96*4882a593Smuzhiyun  * @info:			array to per voltage ABB configuration
97*4882a593Smuzhiyun  * @current_info_idx:		current index to info
98*4882a593Smuzhiyun  * @settling_time:		SoC specific settling time for LDO VBB
99*4882a593Smuzhiyun  */
100*4882a593Smuzhiyun struct ti_abb {
101*4882a593Smuzhiyun 	struct regulator_desc rdesc;
102*4882a593Smuzhiyun 	struct clk *clk;
103*4882a593Smuzhiyun 	void __iomem *base;
104*4882a593Smuzhiyun 	void __iomem *setup_reg;
105*4882a593Smuzhiyun 	void __iomem *control_reg;
106*4882a593Smuzhiyun 	void __iomem *int_base;
107*4882a593Smuzhiyun 	void __iomem *efuse_base;
108*4882a593Smuzhiyun 	void __iomem *ldo_base;
109*4882a593Smuzhiyun 
110*4882a593Smuzhiyun 	const struct ti_abb_reg *regs;
111*4882a593Smuzhiyun 	u32 txdone_mask;
112*4882a593Smuzhiyun 	u32 ldovbb_override_mask;
113*4882a593Smuzhiyun 	u32 ldovbb_vset_mask;
114*4882a593Smuzhiyun 
115*4882a593Smuzhiyun 	struct ti_abb_info *info;
116*4882a593Smuzhiyun 	int current_info_idx;
117*4882a593Smuzhiyun 
118*4882a593Smuzhiyun 	u32 settling_time;
119*4882a593Smuzhiyun };
120*4882a593Smuzhiyun 
121*4882a593Smuzhiyun /**
122*4882a593Smuzhiyun  * ti_abb_rmw() - handy wrapper to set specific register bits
123*4882a593Smuzhiyun  * @mask:	mask for register field
124*4882a593Smuzhiyun  * @value:	value shifted to mask location and written
125*4882a593Smuzhiyun  * @reg:	register address
126*4882a593Smuzhiyun  *
127*4882a593Smuzhiyun  * Return: final register value (may be unused)
128*4882a593Smuzhiyun  */
ti_abb_rmw(u32 mask,u32 value,void __iomem * reg)129*4882a593Smuzhiyun static inline u32 ti_abb_rmw(u32 mask, u32 value, void __iomem *reg)
130*4882a593Smuzhiyun {
131*4882a593Smuzhiyun 	u32 val;
132*4882a593Smuzhiyun 
133*4882a593Smuzhiyun 	val = readl(reg);
134*4882a593Smuzhiyun 	val &= ~mask;
135*4882a593Smuzhiyun 	val |= (value << __ffs(mask)) & mask;
136*4882a593Smuzhiyun 	writel(val, reg);
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun 	return val;
139*4882a593Smuzhiyun }
140*4882a593Smuzhiyun 
141*4882a593Smuzhiyun /**
142*4882a593Smuzhiyun  * ti_abb_check_txdone() - handy wrapper to check ABB tranxdone status
143*4882a593Smuzhiyun  * @abb:	pointer to the abb instance
144*4882a593Smuzhiyun  *
145*4882a593Smuzhiyun  * Return: true or false
146*4882a593Smuzhiyun  */
ti_abb_check_txdone(const struct ti_abb * abb)147*4882a593Smuzhiyun static inline bool ti_abb_check_txdone(const struct ti_abb *abb)
148*4882a593Smuzhiyun {
149*4882a593Smuzhiyun 	return !!(readl(abb->int_base) & abb->txdone_mask);
150*4882a593Smuzhiyun }
151*4882a593Smuzhiyun 
152*4882a593Smuzhiyun /**
153*4882a593Smuzhiyun  * ti_abb_clear_txdone() - handy wrapper to clear ABB tranxdone status
154*4882a593Smuzhiyun  * @abb:	pointer to the abb instance
155*4882a593Smuzhiyun  */
ti_abb_clear_txdone(const struct ti_abb * abb)156*4882a593Smuzhiyun static inline void ti_abb_clear_txdone(const struct ti_abb *abb)
157*4882a593Smuzhiyun {
158*4882a593Smuzhiyun 	writel(abb->txdone_mask, abb->int_base);
159*4882a593Smuzhiyun };
160*4882a593Smuzhiyun 
161*4882a593Smuzhiyun /**
162*4882a593Smuzhiyun  * ti_abb_wait_tranx() - waits for ABB tranxdone event
163*4882a593Smuzhiyun  * @dev:	device
164*4882a593Smuzhiyun  * @abb:	pointer to the abb instance
165*4882a593Smuzhiyun  *
166*4882a593Smuzhiyun  * Return: 0 on success or -ETIMEDOUT if the event is not cleared on time.
167*4882a593Smuzhiyun  */
ti_abb_wait_txdone(struct device * dev,struct ti_abb * abb)168*4882a593Smuzhiyun static int ti_abb_wait_txdone(struct device *dev, struct ti_abb *abb)
169*4882a593Smuzhiyun {
170*4882a593Smuzhiyun 	int timeout = 0;
171*4882a593Smuzhiyun 	bool status;
172*4882a593Smuzhiyun 
173*4882a593Smuzhiyun 	while (timeout++ <= abb->settling_time) {
174*4882a593Smuzhiyun 		status = ti_abb_check_txdone(abb);
175*4882a593Smuzhiyun 		if (status)
176*4882a593Smuzhiyun 			return 0;
177*4882a593Smuzhiyun 
178*4882a593Smuzhiyun 		udelay(1);
179*4882a593Smuzhiyun 	}
180*4882a593Smuzhiyun 
181*4882a593Smuzhiyun 	dev_warn_ratelimited(dev, "%s:TRANXDONE timeout(%duS) int=0x%08x\n",
182*4882a593Smuzhiyun 			     __func__, timeout, readl(abb->int_base));
183*4882a593Smuzhiyun 	return -ETIMEDOUT;
184*4882a593Smuzhiyun }
185*4882a593Smuzhiyun 
186*4882a593Smuzhiyun /**
187*4882a593Smuzhiyun  * ti_abb_clear_all_txdone() - clears ABB tranxdone event
188*4882a593Smuzhiyun  * @dev:	device
189*4882a593Smuzhiyun  * @abb:	pointer to the abb instance
190*4882a593Smuzhiyun  *
191*4882a593Smuzhiyun  * Return: 0 on success or -ETIMEDOUT if the event is not cleared on time.
192*4882a593Smuzhiyun  */
ti_abb_clear_all_txdone(struct device * dev,const struct ti_abb * abb)193*4882a593Smuzhiyun static int ti_abb_clear_all_txdone(struct device *dev, const struct ti_abb *abb)
194*4882a593Smuzhiyun {
195*4882a593Smuzhiyun 	int timeout = 0;
196*4882a593Smuzhiyun 	bool status;
197*4882a593Smuzhiyun 
198*4882a593Smuzhiyun 	while (timeout++ <= abb->settling_time) {
199*4882a593Smuzhiyun 		ti_abb_clear_txdone(abb);
200*4882a593Smuzhiyun 
201*4882a593Smuzhiyun 		status = ti_abb_check_txdone(abb);
202*4882a593Smuzhiyun 		if (!status)
203*4882a593Smuzhiyun 			return 0;
204*4882a593Smuzhiyun 
205*4882a593Smuzhiyun 		udelay(1);
206*4882a593Smuzhiyun 	}
207*4882a593Smuzhiyun 
208*4882a593Smuzhiyun 	dev_warn_ratelimited(dev, "%s:TRANXDONE timeout(%duS) int=0x%08x\n",
209*4882a593Smuzhiyun 			     __func__, timeout, readl(abb->int_base));
210*4882a593Smuzhiyun 	return -ETIMEDOUT;
211*4882a593Smuzhiyun }
212*4882a593Smuzhiyun 
213*4882a593Smuzhiyun /**
214*4882a593Smuzhiyun  * ti_abb_program_ldovbb() - program LDOVBB register for override value
215*4882a593Smuzhiyun  * @dev:	device
216*4882a593Smuzhiyun  * @abb:	pointer to the abb instance
217*4882a593Smuzhiyun  * @info:	ABB info to program
218*4882a593Smuzhiyun  */
ti_abb_program_ldovbb(struct device * dev,const struct ti_abb * abb,struct ti_abb_info * info)219*4882a593Smuzhiyun static void ti_abb_program_ldovbb(struct device *dev, const struct ti_abb *abb,
220*4882a593Smuzhiyun 				  struct ti_abb_info *info)
221*4882a593Smuzhiyun {
222*4882a593Smuzhiyun 	u32 val;
223*4882a593Smuzhiyun 
224*4882a593Smuzhiyun 	val = readl(abb->ldo_base);
225*4882a593Smuzhiyun 	/* clear up previous values */
226*4882a593Smuzhiyun 	val &= ~(abb->ldovbb_override_mask | abb->ldovbb_vset_mask);
227*4882a593Smuzhiyun 
228*4882a593Smuzhiyun 	switch (info->opp_sel) {
229*4882a593Smuzhiyun 	case TI_ABB_SLOW_OPP:
230*4882a593Smuzhiyun 	case TI_ABB_FAST_OPP:
231*4882a593Smuzhiyun 		val |= abb->ldovbb_override_mask;
232*4882a593Smuzhiyun 		val |= info->vset << __ffs(abb->ldovbb_vset_mask);
233*4882a593Smuzhiyun 		break;
234*4882a593Smuzhiyun 	}
235*4882a593Smuzhiyun 
236*4882a593Smuzhiyun 	writel(val, abb->ldo_base);
237*4882a593Smuzhiyun }
238*4882a593Smuzhiyun 
239*4882a593Smuzhiyun /**
240*4882a593Smuzhiyun  * ti_abb_set_opp() - Setup ABB and LDO VBB for required bias
241*4882a593Smuzhiyun  * @rdev:	regulator device
242*4882a593Smuzhiyun  * @abb:	pointer to the abb instance
243*4882a593Smuzhiyun  * @info:	ABB info to program
244*4882a593Smuzhiyun  *
245*4882a593Smuzhiyun  * Return: 0 on success or appropriate error value when fails
246*4882a593Smuzhiyun  */
ti_abb_set_opp(struct regulator_dev * rdev,struct ti_abb * abb,struct ti_abb_info * info)247*4882a593Smuzhiyun static int ti_abb_set_opp(struct regulator_dev *rdev, struct ti_abb *abb,
248*4882a593Smuzhiyun 			  struct ti_abb_info *info)
249*4882a593Smuzhiyun {
250*4882a593Smuzhiyun 	const struct ti_abb_reg *regs = abb->regs;
251*4882a593Smuzhiyun 	struct device *dev = &rdev->dev;
252*4882a593Smuzhiyun 	int ret;
253*4882a593Smuzhiyun 
254*4882a593Smuzhiyun 	ret = ti_abb_clear_all_txdone(dev, abb);
255*4882a593Smuzhiyun 	if (ret)
256*4882a593Smuzhiyun 		goto out;
257*4882a593Smuzhiyun 
258*4882a593Smuzhiyun 	ti_abb_rmw(regs->fbb_sel_mask | regs->rbb_sel_mask, 0, abb->setup_reg);
259*4882a593Smuzhiyun 
260*4882a593Smuzhiyun 	switch (info->opp_sel) {
261*4882a593Smuzhiyun 	case TI_ABB_SLOW_OPP:
262*4882a593Smuzhiyun 		ti_abb_rmw(regs->rbb_sel_mask, 1, abb->setup_reg);
263*4882a593Smuzhiyun 		break;
264*4882a593Smuzhiyun 	case TI_ABB_FAST_OPP:
265*4882a593Smuzhiyun 		ti_abb_rmw(regs->fbb_sel_mask, 1, abb->setup_reg);
266*4882a593Smuzhiyun 		break;
267*4882a593Smuzhiyun 	}
268*4882a593Smuzhiyun 
269*4882a593Smuzhiyun 	/* program next state of ABB ldo */
270*4882a593Smuzhiyun 	ti_abb_rmw(regs->opp_sel_mask, info->opp_sel, abb->control_reg);
271*4882a593Smuzhiyun 
272*4882a593Smuzhiyun 	/*
273*4882a593Smuzhiyun 	 * program LDO VBB vset override if needed for !bypass mode
274*4882a593Smuzhiyun 	 * XXX: Do not switch sequence - for !bypass, LDO override reset *must*
275*4882a593Smuzhiyun 	 * be performed *before* switch to bias mode else VBB glitches.
276*4882a593Smuzhiyun 	 */
277*4882a593Smuzhiyun 	if (abb->ldo_base && info->opp_sel != TI_ABB_NOMINAL_OPP)
278*4882a593Smuzhiyun 		ti_abb_program_ldovbb(dev, abb, info);
279*4882a593Smuzhiyun 
280*4882a593Smuzhiyun 	/* Initiate ABB ldo change */
281*4882a593Smuzhiyun 	ti_abb_rmw(regs->opp_change_mask, 1, abb->control_reg);
282*4882a593Smuzhiyun 
283*4882a593Smuzhiyun 	/* Wait for ABB LDO to complete transition to new Bias setting */
284*4882a593Smuzhiyun 	ret = ti_abb_wait_txdone(dev, abb);
285*4882a593Smuzhiyun 	if (ret)
286*4882a593Smuzhiyun 		goto out;
287*4882a593Smuzhiyun 
288*4882a593Smuzhiyun 	ret = ti_abb_clear_all_txdone(dev, abb);
289*4882a593Smuzhiyun 	if (ret)
290*4882a593Smuzhiyun 		goto out;
291*4882a593Smuzhiyun 
292*4882a593Smuzhiyun 	/*
293*4882a593Smuzhiyun 	 * Reset LDO VBB vset override bypass mode
294*4882a593Smuzhiyun 	 * XXX: Do not switch sequence - for bypass, LDO override reset *must*
295*4882a593Smuzhiyun 	 * be performed *after* switch to bypass else VBB glitches.
296*4882a593Smuzhiyun 	 */
297*4882a593Smuzhiyun 	if (abb->ldo_base && info->opp_sel == TI_ABB_NOMINAL_OPP)
298*4882a593Smuzhiyun 		ti_abb_program_ldovbb(dev, abb, info);
299*4882a593Smuzhiyun 
300*4882a593Smuzhiyun out:
301*4882a593Smuzhiyun 	return ret;
302*4882a593Smuzhiyun }
303*4882a593Smuzhiyun 
304*4882a593Smuzhiyun /**
305*4882a593Smuzhiyun  * ti_abb_set_voltage_sel() - regulator accessor function to set ABB LDO
306*4882a593Smuzhiyun  * @rdev:	regulator device
307*4882a593Smuzhiyun  * @sel:	selector to index into required ABB LDO settings (maps to
308*4882a593Smuzhiyun  *		regulator descriptor's volt_table)
309*4882a593Smuzhiyun  *
310*4882a593Smuzhiyun  * Return: 0 on success or appropriate error value when fails
311*4882a593Smuzhiyun  */
ti_abb_set_voltage_sel(struct regulator_dev * rdev,unsigned sel)312*4882a593Smuzhiyun static int ti_abb_set_voltage_sel(struct regulator_dev *rdev, unsigned sel)
313*4882a593Smuzhiyun {
314*4882a593Smuzhiyun 	const struct regulator_desc *desc = rdev->desc;
315*4882a593Smuzhiyun 	struct ti_abb *abb = rdev_get_drvdata(rdev);
316*4882a593Smuzhiyun 	struct device *dev = &rdev->dev;
317*4882a593Smuzhiyun 	struct ti_abb_info *info, *oinfo;
318*4882a593Smuzhiyun 	int ret = 0;
319*4882a593Smuzhiyun 
320*4882a593Smuzhiyun 	if (!abb) {
321*4882a593Smuzhiyun 		dev_err_ratelimited(dev, "%s: No regulator drvdata\n",
322*4882a593Smuzhiyun 				    __func__);
323*4882a593Smuzhiyun 		return -ENODEV;
324*4882a593Smuzhiyun 	}
325*4882a593Smuzhiyun 
326*4882a593Smuzhiyun 	if (!desc->n_voltages || !abb->info) {
327*4882a593Smuzhiyun 		dev_err_ratelimited(dev,
328*4882a593Smuzhiyun 				    "%s: No valid voltage table entries?\n",
329*4882a593Smuzhiyun 				    __func__);
330*4882a593Smuzhiyun 		return -EINVAL;
331*4882a593Smuzhiyun 	}
332*4882a593Smuzhiyun 
333*4882a593Smuzhiyun 	if (sel >= desc->n_voltages) {
334*4882a593Smuzhiyun 		dev_err(dev, "%s: sel idx(%d) >= n_voltages(%d)\n", __func__,
335*4882a593Smuzhiyun 			sel, desc->n_voltages);
336*4882a593Smuzhiyun 		return -EINVAL;
337*4882a593Smuzhiyun 	}
338*4882a593Smuzhiyun 
339*4882a593Smuzhiyun 	/* If we are in the same index as we were, nothing to do here! */
340*4882a593Smuzhiyun 	if (sel == abb->current_info_idx) {
341*4882a593Smuzhiyun 		dev_dbg(dev, "%s: Already at sel=%d\n", __func__, sel);
342*4882a593Smuzhiyun 		return ret;
343*4882a593Smuzhiyun 	}
344*4882a593Smuzhiyun 
345*4882a593Smuzhiyun 	info = &abb->info[sel];
346*4882a593Smuzhiyun 	/*
347*4882a593Smuzhiyun 	 * When Linux kernel is starting up, we are'nt sure of the
348*4882a593Smuzhiyun 	 * Bias configuration that bootloader has configured.
349*4882a593Smuzhiyun 	 * So, we get to know the actual setting the first time
350*4882a593Smuzhiyun 	 * we are asked to transition.
351*4882a593Smuzhiyun 	 */
352*4882a593Smuzhiyun 	if (abb->current_info_idx == -EINVAL)
353*4882a593Smuzhiyun 		goto just_set_abb;
354*4882a593Smuzhiyun 
355*4882a593Smuzhiyun 	/* If data is exactly the same, then just update index, no change */
356*4882a593Smuzhiyun 	oinfo = &abb->info[abb->current_info_idx];
357*4882a593Smuzhiyun 	if (!memcmp(info, oinfo, sizeof(*info))) {
358*4882a593Smuzhiyun 		dev_dbg(dev, "%s: Same data new idx=%d, old idx=%d\n", __func__,
359*4882a593Smuzhiyun 			sel, abb->current_info_idx);
360*4882a593Smuzhiyun 		goto out;
361*4882a593Smuzhiyun 	}
362*4882a593Smuzhiyun 
363*4882a593Smuzhiyun just_set_abb:
364*4882a593Smuzhiyun 	ret = ti_abb_set_opp(rdev, abb, info);
365*4882a593Smuzhiyun 
366*4882a593Smuzhiyun out:
367*4882a593Smuzhiyun 	if (!ret)
368*4882a593Smuzhiyun 		abb->current_info_idx = sel;
369*4882a593Smuzhiyun 	else
370*4882a593Smuzhiyun 		dev_err_ratelimited(dev,
371*4882a593Smuzhiyun 				    "%s: Volt[%d] idx[%d] mode[%d] Fail(%d)\n",
372*4882a593Smuzhiyun 				    __func__, desc->volt_table[sel], sel,
373*4882a593Smuzhiyun 				    info->opp_sel, ret);
374*4882a593Smuzhiyun 	return ret;
375*4882a593Smuzhiyun }
376*4882a593Smuzhiyun 
377*4882a593Smuzhiyun /**
378*4882a593Smuzhiyun  * ti_abb_get_voltage_sel() - Regulator accessor to get current ABB LDO setting
379*4882a593Smuzhiyun  * @rdev:	regulator device
380*4882a593Smuzhiyun  *
381*4882a593Smuzhiyun  * Return: 0 on success or appropriate error value when fails
382*4882a593Smuzhiyun  */
ti_abb_get_voltage_sel(struct regulator_dev * rdev)383*4882a593Smuzhiyun static int ti_abb_get_voltage_sel(struct regulator_dev *rdev)
384*4882a593Smuzhiyun {
385*4882a593Smuzhiyun 	const struct regulator_desc *desc = rdev->desc;
386*4882a593Smuzhiyun 	struct ti_abb *abb = rdev_get_drvdata(rdev);
387*4882a593Smuzhiyun 	struct device *dev = &rdev->dev;
388*4882a593Smuzhiyun 
389*4882a593Smuzhiyun 	if (!abb) {
390*4882a593Smuzhiyun 		dev_err_ratelimited(dev, "%s: No regulator drvdata\n",
391*4882a593Smuzhiyun 				    __func__);
392*4882a593Smuzhiyun 		return -ENODEV;
393*4882a593Smuzhiyun 	}
394*4882a593Smuzhiyun 
395*4882a593Smuzhiyun 	if (!desc->n_voltages || !abb->info) {
396*4882a593Smuzhiyun 		dev_err_ratelimited(dev,
397*4882a593Smuzhiyun 				    "%s: No valid voltage table entries?\n",
398*4882a593Smuzhiyun 				    __func__);
399*4882a593Smuzhiyun 		return -EINVAL;
400*4882a593Smuzhiyun 	}
401*4882a593Smuzhiyun 
402*4882a593Smuzhiyun 	if (abb->current_info_idx >= (int)desc->n_voltages) {
403*4882a593Smuzhiyun 		dev_err(dev, "%s: Corrupted data? idx(%d) >= n_voltages(%d)\n",
404*4882a593Smuzhiyun 			__func__, abb->current_info_idx, desc->n_voltages);
405*4882a593Smuzhiyun 		return -EINVAL;
406*4882a593Smuzhiyun 	}
407*4882a593Smuzhiyun 
408*4882a593Smuzhiyun 	return abb->current_info_idx;
409*4882a593Smuzhiyun }
410*4882a593Smuzhiyun 
411*4882a593Smuzhiyun /**
412*4882a593Smuzhiyun  * ti_abb_init_timings() - setup ABB clock timing for the current platform
413*4882a593Smuzhiyun  * @dev:	device
414*4882a593Smuzhiyun  * @abb:	pointer to the abb instance
415*4882a593Smuzhiyun  *
416*4882a593Smuzhiyun  * Return: 0 if timing is updated, else returns error result.
417*4882a593Smuzhiyun  */
ti_abb_init_timings(struct device * dev,struct ti_abb * abb)418*4882a593Smuzhiyun static int ti_abb_init_timings(struct device *dev, struct ti_abb *abb)
419*4882a593Smuzhiyun {
420*4882a593Smuzhiyun 	u32 clock_cycles;
421*4882a593Smuzhiyun 	u32 clk_rate, sr2_wt_cnt_val, cycle_rate;
422*4882a593Smuzhiyun 	const struct ti_abb_reg *regs = abb->regs;
423*4882a593Smuzhiyun 	int ret;
424*4882a593Smuzhiyun 	char *pname = "ti,settling-time";
425*4882a593Smuzhiyun 
426*4882a593Smuzhiyun 	/* read device tree properties */
427*4882a593Smuzhiyun 	ret = of_property_read_u32(dev->of_node, pname, &abb->settling_time);
428*4882a593Smuzhiyun 	if (ret) {
429*4882a593Smuzhiyun 		dev_err(dev, "Unable to get property '%s'(%d)\n", pname, ret);
430*4882a593Smuzhiyun 		return ret;
431*4882a593Smuzhiyun 	}
432*4882a593Smuzhiyun 
433*4882a593Smuzhiyun 	/* ABB LDO cannot be settle in 0 time */
434*4882a593Smuzhiyun 	if (!abb->settling_time) {
435*4882a593Smuzhiyun 		dev_err(dev, "Invalid property:'%s' set as 0!\n", pname);
436*4882a593Smuzhiyun 		return -EINVAL;
437*4882a593Smuzhiyun 	}
438*4882a593Smuzhiyun 
439*4882a593Smuzhiyun 	pname = "ti,clock-cycles";
440*4882a593Smuzhiyun 	ret = of_property_read_u32(dev->of_node, pname, &clock_cycles);
441*4882a593Smuzhiyun 	if (ret) {
442*4882a593Smuzhiyun 		dev_err(dev, "Unable to get property '%s'(%d)\n", pname, ret);
443*4882a593Smuzhiyun 		return ret;
444*4882a593Smuzhiyun 	}
445*4882a593Smuzhiyun 	/* ABB LDO cannot be settle in 0 clock cycles */
446*4882a593Smuzhiyun 	if (!clock_cycles) {
447*4882a593Smuzhiyun 		dev_err(dev, "Invalid property:'%s' set as 0!\n", pname);
448*4882a593Smuzhiyun 		return -EINVAL;
449*4882a593Smuzhiyun 	}
450*4882a593Smuzhiyun 
451*4882a593Smuzhiyun 	abb->clk = devm_clk_get(dev, NULL);
452*4882a593Smuzhiyun 	if (IS_ERR(abb->clk)) {
453*4882a593Smuzhiyun 		ret = PTR_ERR(abb->clk);
454*4882a593Smuzhiyun 		dev_err(dev, "%s: Unable to get clk(%d)\n", __func__, ret);
455*4882a593Smuzhiyun 		return ret;
456*4882a593Smuzhiyun 	}
457*4882a593Smuzhiyun 
458*4882a593Smuzhiyun 	/*
459*4882a593Smuzhiyun 	 * SR2_WTCNT_VALUE is the settling time for the ABB ldo after a
460*4882a593Smuzhiyun 	 * transition and must be programmed with the correct time at boot.
461*4882a593Smuzhiyun 	 * The value programmed into the register is the number of SYS_CLK
462*4882a593Smuzhiyun 	 * clock cycles that match a given wall time profiled for the ldo.
463*4882a593Smuzhiyun 	 * This value depends on:
464*4882a593Smuzhiyun 	 * settling time of ldo in micro-seconds (varies per OMAP family)
465*4882a593Smuzhiyun 	 * # of clock cycles per SYS_CLK period (varies per OMAP family)
466*4882a593Smuzhiyun 	 * the SYS_CLK frequency in MHz (varies per board)
467*4882a593Smuzhiyun 	 * The formula is:
468*4882a593Smuzhiyun 	 *
469*4882a593Smuzhiyun 	 *                      ldo settling time (in micro-seconds)
470*4882a593Smuzhiyun 	 * SR2_WTCNT_VALUE = ------------------------------------------
471*4882a593Smuzhiyun 	 *                   (# system clock cycles) * (sys_clk period)
472*4882a593Smuzhiyun 	 *
473*4882a593Smuzhiyun 	 * Put another way:
474*4882a593Smuzhiyun 	 *
475*4882a593Smuzhiyun 	 * SR2_WTCNT_VALUE = settling time / (# SYS_CLK cycles / SYS_CLK rate))
476*4882a593Smuzhiyun 	 *
477*4882a593Smuzhiyun 	 * To avoid dividing by zero multiply both "# clock cycles" and
478*4882a593Smuzhiyun 	 * "settling time" by 10 such that the final result is the one we want.
479*4882a593Smuzhiyun 	 */
480*4882a593Smuzhiyun 
481*4882a593Smuzhiyun 	/* Convert SYS_CLK rate to MHz & prevent divide by zero */
482*4882a593Smuzhiyun 	clk_rate = DIV_ROUND_CLOSEST(clk_get_rate(abb->clk), 1000000);
483*4882a593Smuzhiyun 
484*4882a593Smuzhiyun 	/* Calculate cycle rate */
485*4882a593Smuzhiyun 	cycle_rate = DIV_ROUND_CLOSEST(clock_cycles * 10, clk_rate);
486*4882a593Smuzhiyun 
487*4882a593Smuzhiyun 	/* Calulate SR2_WTCNT_VALUE */
488*4882a593Smuzhiyun 	sr2_wt_cnt_val = DIV_ROUND_CLOSEST(abb->settling_time * 10, cycle_rate);
489*4882a593Smuzhiyun 
490*4882a593Smuzhiyun 	dev_dbg(dev, "%s: Clk_rate=%ld, sr2_cnt=0x%08x\n", __func__,
491*4882a593Smuzhiyun 		clk_get_rate(abb->clk), sr2_wt_cnt_val);
492*4882a593Smuzhiyun 
493*4882a593Smuzhiyun 	ti_abb_rmw(regs->sr2_wtcnt_value_mask, sr2_wt_cnt_val, abb->setup_reg);
494*4882a593Smuzhiyun 
495*4882a593Smuzhiyun 	return 0;
496*4882a593Smuzhiyun }
497*4882a593Smuzhiyun 
498*4882a593Smuzhiyun /**
499*4882a593Smuzhiyun  * ti_abb_init_table() - Initialize ABB table from device tree
500*4882a593Smuzhiyun  * @dev:	device
501*4882a593Smuzhiyun  * @abb:	pointer to the abb instance
502*4882a593Smuzhiyun  * @rinit_data:	regulator initdata
503*4882a593Smuzhiyun  *
504*4882a593Smuzhiyun  * Return: 0 on success or appropriate error value when fails
505*4882a593Smuzhiyun  */
ti_abb_init_table(struct device * dev,struct ti_abb * abb,struct regulator_init_data * rinit_data)506*4882a593Smuzhiyun static int ti_abb_init_table(struct device *dev, struct ti_abb *abb,
507*4882a593Smuzhiyun 			     struct regulator_init_data *rinit_data)
508*4882a593Smuzhiyun {
509*4882a593Smuzhiyun 	struct ti_abb_info *info;
510*4882a593Smuzhiyun 	const u32 num_values = 6;
511*4882a593Smuzhiyun 	char *pname = "ti,abb_info";
512*4882a593Smuzhiyun 	u32 i;
513*4882a593Smuzhiyun 	unsigned int *volt_table;
514*4882a593Smuzhiyun 	int num_entries, min_uV = INT_MAX, max_uV = 0;
515*4882a593Smuzhiyun 	struct regulation_constraints *c = &rinit_data->constraints;
516*4882a593Smuzhiyun 
517*4882a593Smuzhiyun 	/*
518*4882a593Smuzhiyun 	 * Each abb_info is a set of n-tuple, where n is num_values, consisting
519*4882a593Smuzhiyun 	 * of voltage and a set of detection logic for ABB information for that
520*4882a593Smuzhiyun 	 * voltage to apply.
521*4882a593Smuzhiyun 	 */
522*4882a593Smuzhiyun 	num_entries = of_property_count_u32_elems(dev->of_node, pname);
523*4882a593Smuzhiyun 	if (num_entries < 0) {
524*4882a593Smuzhiyun 		dev_err(dev, "No '%s' property?\n", pname);
525*4882a593Smuzhiyun 		return num_entries;
526*4882a593Smuzhiyun 	}
527*4882a593Smuzhiyun 
528*4882a593Smuzhiyun 	if (!num_entries || (num_entries % num_values)) {
529*4882a593Smuzhiyun 		dev_err(dev, "All '%s' list entries need %d vals\n", pname,
530*4882a593Smuzhiyun 			num_values);
531*4882a593Smuzhiyun 		return -EINVAL;
532*4882a593Smuzhiyun 	}
533*4882a593Smuzhiyun 	num_entries /= num_values;
534*4882a593Smuzhiyun 
535*4882a593Smuzhiyun 	info = devm_kcalloc(dev, num_entries, sizeof(*info), GFP_KERNEL);
536*4882a593Smuzhiyun 	if (!info)
537*4882a593Smuzhiyun 		return -ENOMEM;
538*4882a593Smuzhiyun 
539*4882a593Smuzhiyun 	abb->info = info;
540*4882a593Smuzhiyun 
541*4882a593Smuzhiyun 	volt_table = devm_kcalloc(dev, num_entries, sizeof(unsigned int),
542*4882a593Smuzhiyun 				  GFP_KERNEL);
543*4882a593Smuzhiyun 	if (!volt_table)
544*4882a593Smuzhiyun 		return -ENOMEM;
545*4882a593Smuzhiyun 
546*4882a593Smuzhiyun 	abb->rdesc.n_voltages = num_entries;
547*4882a593Smuzhiyun 	abb->rdesc.volt_table = volt_table;
548*4882a593Smuzhiyun 	/* We do not know where the OPP voltage is at the moment */
549*4882a593Smuzhiyun 	abb->current_info_idx = -EINVAL;
550*4882a593Smuzhiyun 
551*4882a593Smuzhiyun 	for (i = 0; i < num_entries; i++, info++, volt_table++) {
552*4882a593Smuzhiyun 		u32 efuse_offset, rbb_mask, fbb_mask, vset_mask;
553*4882a593Smuzhiyun 		u32 efuse_val;
554*4882a593Smuzhiyun 
555*4882a593Smuzhiyun 		/* NOTE: num_values should equal to entries picked up here */
556*4882a593Smuzhiyun 		of_property_read_u32_index(dev->of_node, pname, i * num_values,
557*4882a593Smuzhiyun 					   volt_table);
558*4882a593Smuzhiyun 		of_property_read_u32_index(dev->of_node, pname,
559*4882a593Smuzhiyun 					   i * num_values + 1, &info->opp_sel);
560*4882a593Smuzhiyun 		of_property_read_u32_index(dev->of_node, pname,
561*4882a593Smuzhiyun 					   i * num_values + 2, &efuse_offset);
562*4882a593Smuzhiyun 		of_property_read_u32_index(dev->of_node, pname,
563*4882a593Smuzhiyun 					   i * num_values + 3, &rbb_mask);
564*4882a593Smuzhiyun 		of_property_read_u32_index(dev->of_node, pname,
565*4882a593Smuzhiyun 					   i * num_values + 4, &fbb_mask);
566*4882a593Smuzhiyun 		of_property_read_u32_index(dev->of_node, pname,
567*4882a593Smuzhiyun 					   i * num_values + 5, &vset_mask);
568*4882a593Smuzhiyun 
569*4882a593Smuzhiyun 		dev_dbg(dev,
570*4882a593Smuzhiyun 			"[%d]v=%d ABB=%d ef=0x%x rbb=0x%x fbb=0x%x vset=0x%x\n",
571*4882a593Smuzhiyun 			i, *volt_table, info->opp_sel, efuse_offset, rbb_mask,
572*4882a593Smuzhiyun 			fbb_mask, vset_mask);
573*4882a593Smuzhiyun 
574*4882a593Smuzhiyun 		/* Find min/max for voltage set */
575*4882a593Smuzhiyun 		if (min_uV > *volt_table)
576*4882a593Smuzhiyun 			min_uV = *volt_table;
577*4882a593Smuzhiyun 		if (max_uV < *volt_table)
578*4882a593Smuzhiyun 			max_uV = *volt_table;
579*4882a593Smuzhiyun 
580*4882a593Smuzhiyun 		if (!abb->efuse_base) {
581*4882a593Smuzhiyun 			/* Ignore invalid data, but warn to help cleanup */
582*4882a593Smuzhiyun 			if (efuse_offset || rbb_mask || fbb_mask || vset_mask)
583*4882a593Smuzhiyun 				dev_err(dev, "prop '%s': v=%d,bad efuse/mask\n",
584*4882a593Smuzhiyun 					pname, *volt_table);
585*4882a593Smuzhiyun 			goto check_abb;
586*4882a593Smuzhiyun 		}
587*4882a593Smuzhiyun 
588*4882a593Smuzhiyun 		efuse_val = readl(abb->efuse_base + efuse_offset);
589*4882a593Smuzhiyun 
590*4882a593Smuzhiyun 		/* Use ABB recommendation from Efuse */
591*4882a593Smuzhiyun 		if (efuse_val & rbb_mask)
592*4882a593Smuzhiyun 			info->opp_sel = TI_ABB_SLOW_OPP;
593*4882a593Smuzhiyun 		else if (efuse_val & fbb_mask)
594*4882a593Smuzhiyun 			info->opp_sel = TI_ABB_FAST_OPP;
595*4882a593Smuzhiyun 		else if (rbb_mask || fbb_mask)
596*4882a593Smuzhiyun 			info->opp_sel = TI_ABB_NOMINAL_OPP;
597*4882a593Smuzhiyun 
598*4882a593Smuzhiyun 		dev_dbg(dev,
599*4882a593Smuzhiyun 			"[%d]v=%d efusev=0x%x final ABB=%d\n",
600*4882a593Smuzhiyun 			i, *volt_table, efuse_val, info->opp_sel);
601*4882a593Smuzhiyun 
602*4882a593Smuzhiyun 		/* Use recommended Vset bits from Efuse */
603*4882a593Smuzhiyun 		if (!abb->ldo_base) {
604*4882a593Smuzhiyun 			if (vset_mask)
605*4882a593Smuzhiyun 				dev_err(dev, "prop'%s':v=%d vst=%x LDO base?\n",
606*4882a593Smuzhiyun 					pname, *volt_table, vset_mask);
607*4882a593Smuzhiyun 			continue;
608*4882a593Smuzhiyun 		}
609*4882a593Smuzhiyun 		info->vset = (efuse_val & vset_mask) >> __ffs(vset_mask);
610*4882a593Smuzhiyun 		dev_dbg(dev, "[%d]v=%d vset=%x\n", i, *volt_table, info->vset);
611*4882a593Smuzhiyun check_abb:
612*4882a593Smuzhiyun 		switch (info->opp_sel) {
613*4882a593Smuzhiyun 		case TI_ABB_NOMINAL_OPP:
614*4882a593Smuzhiyun 		case TI_ABB_FAST_OPP:
615*4882a593Smuzhiyun 		case TI_ABB_SLOW_OPP:
616*4882a593Smuzhiyun 			/* Valid values */
617*4882a593Smuzhiyun 			break;
618*4882a593Smuzhiyun 		default:
619*4882a593Smuzhiyun 			dev_err(dev, "%s:[%d]v=%d, ABB=%d is invalid! Abort!\n",
620*4882a593Smuzhiyun 				__func__, i, *volt_table, info->opp_sel);
621*4882a593Smuzhiyun 			return -EINVAL;
622*4882a593Smuzhiyun 		}
623*4882a593Smuzhiyun 	}
624*4882a593Smuzhiyun 
625*4882a593Smuzhiyun 	/* Setup the min/max voltage constraints from the supported list */
626*4882a593Smuzhiyun 	c->min_uV = min_uV;
627*4882a593Smuzhiyun 	c->max_uV = max_uV;
628*4882a593Smuzhiyun 
629*4882a593Smuzhiyun 	return 0;
630*4882a593Smuzhiyun }
631*4882a593Smuzhiyun 
632*4882a593Smuzhiyun static const struct regulator_ops ti_abb_reg_ops = {
633*4882a593Smuzhiyun 	.list_voltage = regulator_list_voltage_table,
634*4882a593Smuzhiyun 
635*4882a593Smuzhiyun 	.set_voltage_sel = ti_abb_set_voltage_sel,
636*4882a593Smuzhiyun 	.get_voltage_sel = ti_abb_get_voltage_sel,
637*4882a593Smuzhiyun };
638*4882a593Smuzhiyun 
639*4882a593Smuzhiyun /* Default ABB block offsets, IF this changes in future, create new one */
640*4882a593Smuzhiyun static const struct ti_abb_reg abb_regs_v1 = {
641*4882a593Smuzhiyun 	/* WARNING: registers are wrongly documented in TRM */
642*4882a593Smuzhiyun 	.setup_off		= 0x04,
643*4882a593Smuzhiyun 	.control_off		= 0x00,
644*4882a593Smuzhiyun 
645*4882a593Smuzhiyun 	.sr2_wtcnt_value_mask	= (0xff << 8),
646*4882a593Smuzhiyun 	.fbb_sel_mask		= (0x01 << 2),
647*4882a593Smuzhiyun 	.rbb_sel_mask		= (0x01 << 1),
648*4882a593Smuzhiyun 	.sr2_en_mask		= (0x01 << 0),
649*4882a593Smuzhiyun 
650*4882a593Smuzhiyun 	.opp_change_mask	= (0x01 << 2),
651*4882a593Smuzhiyun 	.opp_sel_mask		= (0x03 << 0),
652*4882a593Smuzhiyun };
653*4882a593Smuzhiyun 
654*4882a593Smuzhiyun static const struct ti_abb_reg abb_regs_v2 = {
655*4882a593Smuzhiyun 	.setup_off		= 0x00,
656*4882a593Smuzhiyun 	.control_off		= 0x04,
657*4882a593Smuzhiyun 
658*4882a593Smuzhiyun 	.sr2_wtcnt_value_mask	= (0xff << 8),
659*4882a593Smuzhiyun 	.fbb_sel_mask		= (0x01 << 2),
660*4882a593Smuzhiyun 	.rbb_sel_mask		= (0x01 << 1),
661*4882a593Smuzhiyun 	.sr2_en_mask		= (0x01 << 0),
662*4882a593Smuzhiyun 
663*4882a593Smuzhiyun 	.opp_change_mask	= (0x01 << 2),
664*4882a593Smuzhiyun 	.opp_sel_mask		= (0x03 << 0),
665*4882a593Smuzhiyun };
666*4882a593Smuzhiyun 
667*4882a593Smuzhiyun static const struct ti_abb_reg abb_regs_generic = {
668*4882a593Smuzhiyun 	.sr2_wtcnt_value_mask	= (0xff << 8),
669*4882a593Smuzhiyun 	.fbb_sel_mask		= (0x01 << 2),
670*4882a593Smuzhiyun 	.rbb_sel_mask		= (0x01 << 1),
671*4882a593Smuzhiyun 	.sr2_en_mask		= (0x01 << 0),
672*4882a593Smuzhiyun 
673*4882a593Smuzhiyun 	.opp_change_mask	= (0x01 << 2),
674*4882a593Smuzhiyun 	.opp_sel_mask		= (0x03 << 0),
675*4882a593Smuzhiyun };
676*4882a593Smuzhiyun 
677*4882a593Smuzhiyun static const struct of_device_id ti_abb_of_match[] = {
678*4882a593Smuzhiyun 	{.compatible = "ti,abb-v1", .data = &abb_regs_v1},
679*4882a593Smuzhiyun 	{.compatible = "ti,abb-v2", .data = &abb_regs_v2},
680*4882a593Smuzhiyun 	{.compatible = "ti,abb-v3", .data = &abb_regs_generic},
681*4882a593Smuzhiyun 	{ },
682*4882a593Smuzhiyun };
683*4882a593Smuzhiyun 
684*4882a593Smuzhiyun MODULE_DEVICE_TABLE(of, ti_abb_of_match);
685*4882a593Smuzhiyun 
686*4882a593Smuzhiyun /**
687*4882a593Smuzhiyun  * ti_abb_probe() - Initialize an ABB ldo instance
688*4882a593Smuzhiyun  * @pdev: ABB platform device
689*4882a593Smuzhiyun  *
690*4882a593Smuzhiyun  * Initializes an individual ABB LDO for required Body-Bias. ABB is used to
691*4882a593Smuzhiyun  * addional bias supply to SoC modules for power savings or mandatory stability
692*4882a593Smuzhiyun  * configuration at certain Operating Performance Points(OPPs).
693*4882a593Smuzhiyun  *
694*4882a593Smuzhiyun  * Return: 0 on success or appropriate error value when fails
695*4882a593Smuzhiyun  */
ti_abb_probe(struct platform_device * pdev)696*4882a593Smuzhiyun static int ti_abb_probe(struct platform_device *pdev)
697*4882a593Smuzhiyun {
698*4882a593Smuzhiyun 	struct device *dev = &pdev->dev;
699*4882a593Smuzhiyun 	const struct of_device_id *match;
700*4882a593Smuzhiyun 	struct resource *res;
701*4882a593Smuzhiyun 	struct ti_abb *abb;
702*4882a593Smuzhiyun 	struct regulator_init_data *initdata = NULL;
703*4882a593Smuzhiyun 	struct regulator_dev *rdev = NULL;
704*4882a593Smuzhiyun 	struct regulator_desc *desc;
705*4882a593Smuzhiyun 	struct regulation_constraints *c;
706*4882a593Smuzhiyun 	struct regulator_config config = { };
707*4882a593Smuzhiyun 	char *pname;
708*4882a593Smuzhiyun 	int ret = 0;
709*4882a593Smuzhiyun 
710*4882a593Smuzhiyun 	match = of_match_device(ti_abb_of_match, dev);
711*4882a593Smuzhiyun 	if (!match) {
712*4882a593Smuzhiyun 		/* We do not expect this to happen */
713*4882a593Smuzhiyun 		dev_err(dev, "%s: Unable to match device\n", __func__);
714*4882a593Smuzhiyun 		return -ENODEV;
715*4882a593Smuzhiyun 	}
716*4882a593Smuzhiyun 	if (!match->data) {
717*4882a593Smuzhiyun 		dev_err(dev, "%s: Bad data in match\n", __func__);
718*4882a593Smuzhiyun 		return -EINVAL;
719*4882a593Smuzhiyun 	}
720*4882a593Smuzhiyun 
721*4882a593Smuzhiyun 	abb = devm_kzalloc(dev, sizeof(struct ti_abb), GFP_KERNEL);
722*4882a593Smuzhiyun 	if (!abb)
723*4882a593Smuzhiyun 		return -ENOMEM;
724*4882a593Smuzhiyun 	abb->regs = match->data;
725*4882a593Smuzhiyun 
726*4882a593Smuzhiyun 	/* Map ABB resources */
727*4882a593Smuzhiyun 	if (abb->regs->setup_off || abb->regs->control_off) {
728*4882a593Smuzhiyun 		pname = "base-address";
729*4882a593Smuzhiyun 		res = platform_get_resource_byname(pdev, IORESOURCE_MEM, pname);
730*4882a593Smuzhiyun 		abb->base = devm_ioremap_resource(dev, res);
731*4882a593Smuzhiyun 		if (IS_ERR(abb->base))
732*4882a593Smuzhiyun 			return PTR_ERR(abb->base);
733*4882a593Smuzhiyun 
734*4882a593Smuzhiyun 		abb->setup_reg = abb->base + abb->regs->setup_off;
735*4882a593Smuzhiyun 		abb->control_reg = abb->base + abb->regs->control_off;
736*4882a593Smuzhiyun 
737*4882a593Smuzhiyun 	} else {
738*4882a593Smuzhiyun 		pname = "control-address";
739*4882a593Smuzhiyun 		res = platform_get_resource_byname(pdev, IORESOURCE_MEM, pname);
740*4882a593Smuzhiyun 		abb->control_reg = devm_ioremap_resource(dev, res);
741*4882a593Smuzhiyun 		if (IS_ERR(abb->control_reg))
742*4882a593Smuzhiyun 			return PTR_ERR(abb->control_reg);
743*4882a593Smuzhiyun 
744*4882a593Smuzhiyun 		pname = "setup-address";
745*4882a593Smuzhiyun 		res = platform_get_resource_byname(pdev, IORESOURCE_MEM, pname);
746*4882a593Smuzhiyun 		abb->setup_reg = devm_ioremap_resource(dev, res);
747*4882a593Smuzhiyun 		if (IS_ERR(abb->setup_reg))
748*4882a593Smuzhiyun 			return PTR_ERR(abb->setup_reg);
749*4882a593Smuzhiyun 	}
750*4882a593Smuzhiyun 
751*4882a593Smuzhiyun 	pname = "int-address";
752*4882a593Smuzhiyun 	res = platform_get_resource_byname(pdev, IORESOURCE_MEM, pname);
753*4882a593Smuzhiyun 	if (!res) {
754*4882a593Smuzhiyun 		dev_err(dev, "Missing '%s' IO resource\n", pname);
755*4882a593Smuzhiyun 		return -ENODEV;
756*4882a593Smuzhiyun 	}
757*4882a593Smuzhiyun 	/*
758*4882a593Smuzhiyun 	 * We may have shared interrupt register offsets which are
759*4882a593Smuzhiyun 	 * write-1-to-clear between domains ensuring exclusivity.
760*4882a593Smuzhiyun 	 */
761*4882a593Smuzhiyun 	abb->int_base = devm_ioremap(dev, res->start,
762*4882a593Smuzhiyun 					     resource_size(res));
763*4882a593Smuzhiyun 	if (!abb->int_base) {
764*4882a593Smuzhiyun 		dev_err(dev, "Unable to map '%s'\n", pname);
765*4882a593Smuzhiyun 		return -ENOMEM;
766*4882a593Smuzhiyun 	}
767*4882a593Smuzhiyun 
768*4882a593Smuzhiyun 	/* Map Optional resources */
769*4882a593Smuzhiyun 	pname = "efuse-address";
770*4882a593Smuzhiyun 	res = platform_get_resource_byname(pdev, IORESOURCE_MEM, pname);
771*4882a593Smuzhiyun 	if (!res) {
772*4882a593Smuzhiyun 		dev_dbg(dev, "Missing '%s' IO resource\n", pname);
773*4882a593Smuzhiyun 		ret = -ENODEV;
774*4882a593Smuzhiyun 		goto skip_opt;
775*4882a593Smuzhiyun 	}
776*4882a593Smuzhiyun 
777*4882a593Smuzhiyun 	/*
778*4882a593Smuzhiyun 	 * We may have shared efuse register offsets which are read-only
779*4882a593Smuzhiyun 	 * between domains
780*4882a593Smuzhiyun 	 */
781*4882a593Smuzhiyun 	abb->efuse_base = devm_ioremap(dev, res->start,
782*4882a593Smuzhiyun 					       resource_size(res));
783*4882a593Smuzhiyun 	if (!abb->efuse_base) {
784*4882a593Smuzhiyun 		dev_err(dev, "Unable to map '%s'\n", pname);
785*4882a593Smuzhiyun 		return -ENOMEM;
786*4882a593Smuzhiyun 	}
787*4882a593Smuzhiyun 
788*4882a593Smuzhiyun 	pname = "ldo-address";
789*4882a593Smuzhiyun 	res = platform_get_resource_byname(pdev, IORESOURCE_MEM, pname);
790*4882a593Smuzhiyun 	if (!res) {
791*4882a593Smuzhiyun 		dev_dbg(dev, "Missing '%s' IO resource\n", pname);
792*4882a593Smuzhiyun 		ret = -ENODEV;
793*4882a593Smuzhiyun 		goto skip_opt;
794*4882a593Smuzhiyun 	}
795*4882a593Smuzhiyun 	abb->ldo_base = devm_ioremap_resource(dev, res);
796*4882a593Smuzhiyun 	if (IS_ERR(abb->ldo_base))
797*4882a593Smuzhiyun 		return PTR_ERR(abb->ldo_base);
798*4882a593Smuzhiyun 
799*4882a593Smuzhiyun 	/* IF ldo_base is set, the following are mandatory */
800*4882a593Smuzhiyun 	pname = "ti,ldovbb-override-mask";
801*4882a593Smuzhiyun 	ret =
802*4882a593Smuzhiyun 	    of_property_read_u32(pdev->dev.of_node, pname,
803*4882a593Smuzhiyun 				 &abb->ldovbb_override_mask);
804*4882a593Smuzhiyun 	if (ret) {
805*4882a593Smuzhiyun 		dev_err(dev, "Missing '%s' (%d)\n", pname, ret);
806*4882a593Smuzhiyun 		return ret;
807*4882a593Smuzhiyun 	}
808*4882a593Smuzhiyun 	if (!abb->ldovbb_override_mask) {
809*4882a593Smuzhiyun 		dev_err(dev, "Invalid property:'%s' set as 0!\n", pname);
810*4882a593Smuzhiyun 		return -EINVAL;
811*4882a593Smuzhiyun 	}
812*4882a593Smuzhiyun 
813*4882a593Smuzhiyun 	pname = "ti,ldovbb-vset-mask";
814*4882a593Smuzhiyun 	ret =
815*4882a593Smuzhiyun 	    of_property_read_u32(pdev->dev.of_node, pname,
816*4882a593Smuzhiyun 				 &abb->ldovbb_vset_mask);
817*4882a593Smuzhiyun 	if (ret) {
818*4882a593Smuzhiyun 		dev_err(dev, "Missing '%s' (%d)\n", pname, ret);
819*4882a593Smuzhiyun 		return ret;
820*4882a593Smuzhiyun 	}
821*4882a593Smuzhiyun 	if (!abb->ldovbb_vset_mask) {
822*4882a593Smuzhiyun 		dev_err(dev, "Invalid property:'%s' set as 0!\n", pname);
823*4882a593Smuzhiyun 		return -EINVAL;
824*4882a593Smuzhiyun 	}
825*4882a593Smuzhiyun 
826*4882a593Smuzhiyun skip_opt:
827*4882a593Smuzhiyun 	pname = "ti,tranxdone-status-mask";
828*4882a593Smuzhiyun 	ret =
829*4882a593Smuzhiyun 	    of_property_read_u32(pdev->dev.of_node, pname,
830*4882a593Smuzhiyun 				 &abb->txdone_mask);
831*4882a593Smuzhiyun 	if (ret) {
832*4882a593Smuzhiyun 		dev_err(dev, "Missing '%s' (%d)\n", pname, ret);
833*4882a593Smuzhiyun 		return ret;
834*4882a593Smuzhiyun 	}
835*4882a593Smuzhiyun 	if (!abb->txdone_mask) {
836*4882a593Smuzhiyun 		dev_err(dev, "Invalid property:'%s' set as 0!\n", pname);
837*4882a593Smuzhiyun 		return -EINVAL;
838*4882a593Smuzhiyun 	}
839*4882a593Smuzhiyun 
840*4882a593Smuzhiyun 	initdata = of_get_regulator_init_data(dev, pdev->dev.of_node,
841*4882a593Smuzhiyun 					      &abb->rdesc);
842*4882a593Smuzhiyun 	if (!initdata) {
843*4882a593Smuzhiyun 		dev_err(dev, "%s: Unable to alloc regulator init data\n",
844*4882a593Smuzhiyun 			__func__);
845*4882a593Smuzhiyun 		return -ENOMEM;
846*4882a593Smuzhiyun 	}
847*4882a593Smuzhiyun 
848*4882a593Smuzhiyun 	/* init ABB opp_sel table */
849*4882a593Smuzhiyun 	ret = ti_abb_init_table(dev, abb, initdata);
850*4882a593Smuzhiyun 	if (ret)
851*4882a593Smuzhiyun 		return ret;
852*4882a593Smuzhiyun 
853*4882a593Smuzhiyun 	/* init ABB timing */
854*4882a593Smuzhiyun 	ret = ti_abb_init_timings(dev, abb);
855*4882a593Smuzhiyun 	if (ret)
856*4882a593Smuzhiyun 		return ret;
857*4882a593Smuzhiyun 
858*4882a593Smuzhiyun 	desc = &abb->rdesc;
859*4882a593Smuzhiyun 	desc->name = dev_name(dev);
860*4882a593Smuzhiyun 	desc->owner = THIS_MODULE;
861*4882a593Smuzhiyun 	desc->type = REGULATOR_VOLTAGE;
862*4882a593Smuzhiyun 	desc->ops = &ti_abb_reg_ops;
863*4882a593Smuzhiyun 
864*4882a593Smuzhiyun 	c = &initdata->constraints;
865*4882a593Smuzhiyun 	if (desc->n_voltages > 1)
866*4882a593Smuzhiyun 		c->valid_ops_mask |= REGULATOR_CHANGE_VOLTAGE;
867*4882a593Smuzhiyun 	c->always_on = true;
868*4882a593Smuzhiyun 
869*4882a593Smuzhiyun 	config.dev = dev;
870*4882a593Smuzhiyun 	config.init_data = initdata;
871*4882a593Smuzhiyun 	config.driver_data = abb;
872*4882a593Smuzhiyun 	config.of_node = pdev->dev.of_node;
873*4882a593Smuzhiyun 
874*4882a593Smuzhiyun 	rdev = devm_regulator_register(dev, desc, &config);
875*4882a593Smuzhiyun 	if (IS_ERR(rdev)) {
876*4882a593Smuzhiyun 		ret = PTR_ERR(rdev);
877*4882a593Smuzhiyun 		dev_err(dev, "%s: failed to register regulator(%d)\n",
878*4882a593Smuzhiyun 			__func__, ret);
879*4882a593Smuzhiyun 		return ret;
880*4882a593Smuzhiyun 	}
881*4882a593Smuzhiyun 	platform_set_drvdata(pdev, rdev);
882*4882a593Smuzhiyun 
883*4882a593Smuzhiyun 	/* Enable the ldo if not already done by bootloader */
884*4882a593Smuzhiyun 	ti_abb_rmw(abb->regs->sr2_en_mask, 1, abb->setup_reg);
885*4882a593Smuzhiyun 
886*4882a593Smuzhiyun 	return 0;
887*4882a593Smuzhiyun }
888*4882a593Smuzhiyun 
889*4882a593Smuzhiyun MODULE_ALIAS("platform:ti_abb");
890*4882a593Smuzhiyun 
891*4882a593Smuzhiyun static struct platform_driver ti_abb_driver = {
892*4882a593Smuzhiyun 	.probe = ti_abb_probe,
893*4882a593Smuzhiyun 	.driver = {
894*4882a593Smuzhiyun 		   .name = "ti_abb",
895*4882a593Smuzhiyun 		   .of_match_table = of_match_ptr(ti_abb_of_match),
896*4882a593Smuzhiyun 		   },
897*4882a593Smuzhiyun };
898*4882a593Smuzhiyun module_platform_driver(ti_abb_driver);
899*4882a593Smuzhiyun 
900*4882a593Smuzhiyun MODULE_DESCRIPTION("Texas Instruments ABB LDO regulator driver");
901*4882a593Smuzhiyun MODULE_AUTHOR("Texas Instruments Inc.");
902*4882a593Smuzhiyun MODULE_LICENSE("GPL v2");
903