include/linux/i2c/tps65010.h

   1 /* linux/i2c/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 /*
  32  * ----------------------------------------------------------------------------
  33  * Registers, all 8 bits
  34  * ----------------------------------------------------------------------------
  35  */
  36
  37 #define TPS_CHGSTATUS           0x01
  38 #       define  TPS_CHG_USB             (1 << 7)
  39 #       define  TPS_CHG_AC              (1 << 6)
  40 #       define  TPS_CHG_THERM           (1 << 5)
  41 #       define  TPS_CHG_TERM            (1 << 4)
  42 #       define  TPS_CHG_TAPER_TMO       (1 << 3)
  43 #       define  TPS_CHG_CHG_TMO         (1 << 2)
  44 #       define  TPS_CHG_PRECHG_TMO      (1 << 1)
  45 #       define  TPS_CHG_TEMP_ERR        (1 << 0)
  46 #define TPS_REGSTATUS           0x02
  47 #       define  TPS_REG_ONOFF           (1 << 7)
  48 #       define  TPS_REG_COVER           (1 << 6)
  49 #       define  TPS_REG_UVLO            (1 << 5)
  50 #       define  TPS_REG_NO_CHG          (1 << 4)        /* tps65013 */
  51 #       define  TPS_REG_PG_LD02         (1 << 3)
  52 #       define  TPS_REG_PG_LD01         (1 << 2)
  53 #       define  TPS_REG_PG_MAIN         (1 << 1)
  54 #       define  TPS_REG_PG_CORE         (1 << 0)
  55 #define TPS_MASK1               0x03
  56 #define TPS_MASK2               0x04
  57 #define TPS_ACKINT1             0x05
  58 #define TPS_ACKINT2             0x06
  59 #define TPS_CHGCONFIG           0x07
  60 #       define  TPS_CHARGE_POR          (1 << 7)        /* 65010/65012 */
  61 #       define  TPS65013_AUA            (1 << 7)        /* 65011/65013 */
  62 #       define  TPS_CHARGE_RESET        (1 << 6)
  63 #       define  TPS_CHARGE_FAST         (1 << 5)
  64 #       define  TPS_CHARGE_CURRENT      (3 << 3)
  65 #       define  TPS_VBUS_500MA          (1 << 2)
  66 #       define  TPS_VBUS_CHARGING       (1 << 1)
  67 #       define  TPS_CHARGE_ENABLE       (1 << 0)
  68 #define TPS_LED1_ON             0x08
  69 #define TPS_LED1_PER            0x09
  70 #define TPS_LED2_ON             0x0a
  71 #define TPS_LED2_PER            0x0b
  72 #define TPS_VDCDC1              0x0c
  73 #       define  TPS_ENABLE_LP           (1 << 3)
  74 #define TPS_VDCDC2              0x0d
  75 #       define  TPS_LP_COREOFF  (1 << 7)
  76 #       define  TPS_VCORE_1_8V  (7<<4)
  77 #       define  TPS_VCORE_1_5V  (6 << 4)
  78 #       define  TPS_VCORE_1_4V  (5 << 4)
  79 #       define  TPS_VCORE_1_3V  (4 << 4)
  80 #       define  TPS_VCORE_1_2V  (3 << 4)
  81 #       define  TPS_VCORE_1_1V  (2 << 4)
  82 #       define  TPS_VCORE_1_0V  (1 << 4)
  83 #       define  TPS_VCORE_0_85V (0 << 4)
  84 #       define  TPS_VCORE_LP_1_2V (3 << 2)
  85 #       define  TPS_VCORE_LP_1_1V (2 << 2)
  86 #       define  TPS_VCORE_LP_1_0V (1 << 2)
  87 #       define  TPS_VCORE_LP_0_85V (0 << 2)
  88 #       define  TPS_VIB         (1 << 1)
  89 #       define  TPS_VCORE_DISCH (1 << 0)
  90 #define TPS_VREGS1              0x0e
  91 #       define  TPS_LDO2_ENABLE (1 << 7)
  92 #       define  TPS_LDO2_OFF    (1 << 6)
  93 #       define  TPS_VLDO2_3_0V  (3 << 4)
  94 #       define  TPS_VLDO2_2_75V (2 << 4)
  95 #       define  TPS_VLDO2_2_5V  (1 << 4)
  96 #       define  TPS_VLDO2_1_8V  (0 << 4)
  97 #       define  TPS_LDO1_ENABLE (1 << 3)
  98 #       define  TPS_LDO1_OFF    (1 << 2)
  99 #       define  TPS_VLDO1_3_0V  (3 << 0)
 100 #       define  TPS_VLDO1_2_75V (2 << 0)
 101 #       define  TPS_VLDO1_2_5V  (1 << 0)
 102 #       define  TPS_VLDO1_ADJ   (0 << 0)
 103 #define TPS_MASK3               0x0f
 104 #define TPS_DEFGPIO             0x10
 105
 106 /*
 107  * ----------------------------------------------------------------------------
 108  * Macros used by exported functions
 109  * ----------------------------------------------------------------------------
 110  */
 111
 112 #define LED1  1
 113 #define LED2  2
 114 #define OFF   0
 115 #define ON    1
 116 #define BLINK 2
 117 #define GPIO1 1
 118 #define GPIO2 2
 119 #define GPIO3 3
 120 #define GPIO4 4
 121 #define LOW   0
 122 #define HIGH  1
 123
 124 /*
 125  * ----------------------------------------------------------------------------
 126  * Exported functions
 127  * ----------------------------------------------------------------------------
 128  */
 129
 130 /* Draw from VBUS:
 131  *   0 mA -- DON'T DRAW (might supply power instead)
 132  * 100 mA -- usb unit load (slowest charge rate)
 133  * 500 mA -- usb high power (fast battery charge)
 134  */
 135 extern int tps65010_set_vbus_draw(unsigned mA);
 136
 137 /* tps65010_set_gpio_out_value parameter:
 138  * gpio:  GPIO1, GPIO2, GPIO3 or GPIO4
 139  * value: LOW or HIGH
 140  */
 141 extern int tps65010_set_gpio_out_value(unsigned gpio, unsigned value);
 142
 143 /* tps65010_set_led parameter:
 144  * led:  LED1 or LED2
 145  * mode: ON, OFF or BLINK
 146  */
 147 extern int tps65010_set_led(unsigned led, unsigned mode);
 148
 149 /* tps65010_set_vib parameter:
 150  * value: ON or OFF
 151  */
 152 extern int tps65010_set_vib(unsigned value);
 153
 154 /* tps65010_set_low_pwr parameter:
 155  * mode: ON or OFF
 156  */
 157 extern int tps65010_set_low_pwr(unsigned mode);
 158
 159 /* tps65010_config_vregs1 parameter:
 160  * value to be written to VREGS1 register
 161  * Note: The complete register is written, set all bits you need
 162  */
 163 extern int tps65010_config_vregs1(unsigned value);
 164
 165 /* tps65013_set_low_pwr parameter:
 166  * mode: ON or OFF
 167  */
 168 extern int tps65013_set_low_pwr(unsigned mode);
 169
 170 /* tps65010_set_vdcdc2
 171  *  value to be written to VDCDC2
 172  */
 173 extern int tps65010_config_vdcdc2(unsigned value);
 174
 175 struct i2c_client;
 176
 177 /**
 178  * struct tps65010_board - packages GPIO and LED lines
 179  * @base: the GPIO number to assign to GPIO-1
 180  * @outmask: bit (N-1) is set to allow GPIO-N to be used as an
 181  *      (open drain) output
 182  * @setup: optional callback issued once the GPIOs are valid
 183  * @teardown: optional callback issued before the GPIOs are invalidated
 184  * @context: optional parameter passed to setup() and teardown()
 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         int                             base;
 197         unsigned                        outmask;
 198
 199         int             (*setup)(struct i2c_client *client, void *context);
 200         int             (*teardown)(struct i2c_client *client, void *context);
 201         void            *context;
 202 };
 203
 204 #endif /*  __LINUX_I2C_TPS65010_H */
 205