1 /* linux/mfd/tps65010.h
2  *
3  * Functions to access TPS65010 power management device.
4  *
5  * Copyright (C) 2004 Dirk Behme <dirk.behme@de.bosch.com>
6  *
7  * This program is free software; you can redistribute it and/or modify it
8  * under the terms of the GNU General Public License as published by the
9  * Free Software Foundation; either version 2 of the License, or (at your
10  * option) any later version.
11  *
12  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
13  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
14  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN
15  * NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
16  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
17  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
18  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
19  * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
20  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
21  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
22  *
23  * You should have received a copy of the  GNU General Public License along
24  * with this program; if not, write  to the Free Software Foundation, Inc.,
25  * 675 Mass Ave, Cambridge, MA 02139, USA.
26  */
27 
28 #ifndef __LINUX_I2C_TPS65010_H
29 #define __LINUX_I2C_TPS65010_H
30 
31 struct gpio_chip;
32 
33 /*
34  * ----------------------------------------------------------------------------
35  * Registers, all 8 bits
36  * ----------------------------------------------------------------------------
37  */
38 
39 #define	TPS_CHGSTATUS		0x01
40 #	define	TPS_CHG_USB		(1 << 7)
41 #	define	TPS_CHG_AC		(1 << 6)
42 #	define	TPS_CHG_THERM		(1 << 5)
43 #	define	TPS_CHG_TERM		(1 << 4)
44 #	define	TPS_CHG_TAPER_TMO	(1 << 3)
45 #	define	TPS_CHG_CHG_TMO		(1 << 2)
46 #	define	TPS_CHG_PRECHG_TMO	(1 << 1)
47 #	define	TPS_CHG_TEMP_ERR	(1 << 0)
48 #define	TPS_REGSTATUS		0x02
49 #	define	TPS_REG_ONOFF		(1 << 7)
50 #	define	TPS_REG_COVER		(1 << 6)
51 #	define	TPS_REG_UVLO		(1 << 5)
52 #	define	TPS_REG_NO_CHG		(1 << 4)	/* tps65013 */
53 #	define	TPS_REG_PG_LD02		(1 << 3)
54 #	define	TPS_REG_PG_LD01		(1 << 2)
55 #	define	TPS_REG_PG_MAIN		(1 << 1)
56 #	define	TPS_REG_PG_CORE		(1 << 0)
57 #define	TPS_MASK1		0x03
58 #define	TPS_MASK2		0x04
59 #define	TPS_ACKINT1		0x05
60 #define	TPS_ACKINT2		0x06
61 #define	TPS_CHGCONFIG		0x07
62 #	define	TPS_CHARGE_POR		(1 << 7)	/* 65010/65012 */
63 #	define	TPS65013_AUA		(1 << 7)	/* 65011/65013 */
64 #	define	TPS_CHARGE_RESET	(1 << 6)
65 #	define	TPS_CHARGE_FAST		(1 << 5)
66 #	define	TPS_CHARGE_CURRENT	(3 << 3)
67 #	define	TPS_VBUS_500MA		(1 << 2)
68 #	define	TPS_VBUS_CHARGING	(1 << 1)
69 #	define	TPS_CHARGE_ENABLE	(1 << 0)
70 #define	TPS_LED1_ON		0x08
71 #define	TPS_LED1_PER		0x09
72 #define	TPS_LED2_ON		0x0a
73 #define	TPS_LED2_PER		0x0b
74 #define	TPS_VDCDC1		0x0c
75 #	define	TPS_ENABLE_LP		(1 << 3)
76 #define	TPS_VDCDC2		0x0d
77 #	define	TPS_LP_COREOFF	(1 << 7)
78 #	define 	TPS_VCORE_1_8V	(7<<4)
79 #	define 	TPS_VCORE_1_5V	(6 << 4)
80 #	define 	TPS_VCORE_1_4V	(5 << 4)
81 #	define 	TPS_VCORE_1_3V	(4 << 4)
82 #	define 	TPS_VCORE_1_2V	(3 << 4)
83 #	define 	TPS_VCORE_1_1V	(2 << 4)
84 #	define 	TPS_VCORE_1_0V	(1 << 4)
85 #	define 	TPS_VCORE_0_85V	(0 << 4)
86 #	define	TPS_VCORE_LP_1_2V (3 << 2)
87 #	define	TPS_VCORE_LP_1_1V (2 << 2)
88 #	define	TPS_VCORE_LP_1_0V (1 << 2)
89 #	define	TPS_VCORE_LP_0_85V (0 << 2)
90 #	define	TPS_VIB		(1 << 1)
91 #	define	TPS_VCORE_DISCH	(1 << 0)
92 #define	TPS_VREGS1		0x0e
93 #	define	TPS_LDO2_ENABLE	(1 << 7)
94 #	define	TPS_LDO2_OFF	(1 << 6)
95 #	define	TPS_VLDO2_3_0V	(3 << 4)
96 #	define	TPS_VLDO2_2_75V	(2 << 4)
97 #	define	TPS_VLDO2_2_5V	(1 << 4)
98 #	define	TPS_VLDO2_1_8V	(0 << 4)
99 #	define	TPS_LDO1_ENABLE	(1 << 3)
100 #	define	TPS_LDO1_OFF	(1 << 2)
101 #	define	TPS_VLDO1_3_0V	(3 << 0)
102 #	define	TPS_VLDO1_2_75V	(2 << 0)
103 #	define	TPS_VLDO1_2_5V	(1 << 0)
104 #	define	TPS_VLDO1_ADJ	(0 << 0)
105 #define	TPS_MASK3		0x0f
106 #define	TPS_DEFGPIO		0x10
107 
108 /*
109  * ----------------------------------------------------------------------------
110  * Macros used by exported functions
111  * ----------------------------------------------------------------------------
112  */
113 
114 #define LED1  1
115 #define LED2  2
116 #define OFF   0
117 #define ON    1
118 #define BLINK 2
119 #define GPIO1 1
120 #define GPIO2 2
121 #define GPIO3 3
122 #define GPIO4 4
123 #define LOW   0
124 #define HIGH  1
125 
126 /*
127  * ----------------------------------------------------------------------------
128  * Exported functions
129  * ----------------------------------------------------------------------------
130  */
131 
132 /* Draw from VBUS:
133  *   0 mA -- DON'T DRAW (might supply power instead)
134  * 100 mA -- usb unit load (slowest charge rate)
135  * 500 mA -- usb high power (fast battery charge)
136  */
137 extern int tps65010_set_vbus_draw(unsigned mA);
138 
139 /* tps65010_set_gpio_out_value parameter:
140  * gpio:  GPIO1, GPIO2, GPIO3 or GPIO4
141  * value: LOW or HIGH
142  */
143 extern int tps65010_set_gpio_out_value(unsigned gpio, unsigned value);
144 
145 /* tps65010_set_led parameter:
146  * led:  LED1 or LED2
147  * mode: ON, OFF or BLINK
148  */
149 extern int tps65010_set_led(unsigned led, unsigned mode);
150 
151 /* tps65010_set_vib parameter:
152  * value: ON or OFF
153  */
154 extern int tps65010_set_vib(unsigned value);
155 
156 /* tps65010_set_low_pwr parameter:
157  * mode: ON or OFF
158  */
159 extern int tps65010_set_low_pwr(unsigned mode);
160 
161 /* tps65010_config_vregs1 parameter:
162  * value to be written to VREGS1 register
163  * Note: The complete register is written, set all bits you need
164  */
165 extern int tps65010_config_vregs1(unsigned value);
166 
167 /* tps65013_set_low_pwr parameter:
168  * mode: ON or OFF
169  */
170 extern int tps65013_set_low_pwr(unsigned mode);
171 
172 /* tps65010_set_vdcdc2
173  *  value to be written to VDCDC2
174  */
175 extern int tps65010_config_vdcdc2(unsigned value);
176 
177 struct i2c_client;
178 
179 /**
180  * struct tps65010_board - packages GPIO and LED lines
181  * @outmask: bit (N-1) is set to allow GPIO-N to be used as an
182  *	(open drain) output
183  * @setup: optional callback issued once the GPIOs are valid
184  * @teardown: optional callback issued before the GPIOs are invalidated
185  *
186  * Board data may be used to package the GPIO (and LED) lines for use
187  * in by the generic GPIO and LED frameworks.  The first four GPIOs
188  * starting at gpio_base are GPIO1..GPIO4.  The next two are LED1/nPG
189  * and LED2 (with hardware blinking capability, not currently exposed).
190  *
191  * The @setup callback may be used with the kind of board-specific glue
192  * which hands the (now-valid) GPIOs to other drivers, or which puts
193  * devices in their initial states using these GPIOs.
194  */
195 struct tps65010_board {
196 	unsigned			outmask;
197 	int		(*setup)(struct i2c_client *client, struct gpio_chip *gc);
198 	void		(*teardown)(struct i2c_client *client, struct gpio_chip *gc);
199 };
200 
201 #endif /*  __LINUX_I2C_TPS65010_H */
202 
203