Documentation/devicetree/bindings/mfd/ab8500.txt

   1 * AB8500 Multi-Functional Device (MFD)
   2
   3 Required parent device properties:
   4 - compatible             : contains "stericsson,ab8500" or "stericsson,ab8505";
   5 - interrupts             : contains the IRQ line for the AB8500
   6 - interrupt-controller   : describes the AB8500 as an Interrupt Controller (has its own domain)
   7 - #interrupt-cells       : should be 2, for 2-cell format
   8                             - The first cell is the AB8500 local IRQ number
   9                             - The second cell is used to specify optional parameters
  10                               - bits[3:0] trigger type and level flags:
  11                                   1 = low-to-high edge triggered
  12                                   2 = high-to-low edge triggered
  13                                   4 = active high level-sensitive
  14                                   8 = active low level-sensitive
  15
  16 The AB8500 consists of a large and varied group of sub-devices:
  17
  18 Device                     IRQ Names              Supply Names   Description
  19 ------                     ---------              ------------   -----------
  20 ab8500-bm                :                      :              : Battery Manager
  21 ab8500-btemp             :                      :              : Battery Temperature
  22 ab8500-charger           :                      :              : Battery Charger
  23 ab8500-codec             :                      :              : Audio Codec
  24 ab8500-fg                :                      : vddadc       : Fuel Gauge
  25                          : NCONV_ACCU           :              : Accumulate N Sample Conversion
  26                          : BATT_OVV             :              : Battery Over Voltage
  27                          : LOW_BAT_F            :              : LOW threshold battery voltage
  28                          : CC_INT_CALIB         :              : Coulomb Counter Internal Calibration
  29                          : CCEOC                :              : Coulomb Counter End of Conversion
  30 ab8500-btemp             :                      : vtvout       : Battery Temperature
  31                          : BAT_CTRL_INDB        :              : Battery Removal Indicator
  32                          : BTEMP_LOW            :              : Btemp < BtempLow, if battery temperature is lower than -10°C
  33                          : BTEMP_LOW_MEDIUM     :              : BtempLow < Btemp < BtempMedium,if battery temperature is between -10 and 0°C
  34                          : BTEMP_MEDIUM_HIGH    :              : BtempMedium < Btemp < BtempHigh,if battery temperature is between 0°C and MaxTemp
  35                          : BTEMP_HIGH           :              : Btemp > BtempHigh, if battery temperature is higher than MaxTemp
  36 ab8500-charger           :                      : vddadc       : Charger interface
  37                          : MAIN_CH_UNPLUG_DET   :              : main charger unplug detection management (not in 8505)
  38                          : MAIN_CHARGE_PLUG_DET :              : main charger plug detection management (not in 8505)
  39                          : MAIN_EXT_CH_NOT_OK   :              : main charger not OK
  40                          : MAIN_CH_TH_PROT_R    :              : Die temp is above main charger
  41                          : MAIN_CH_TH_PROT_F    :              : Die temp is below main charger
  42                          : VBUS_DET_F           :              : VBUS falling detected
  43                          : VBUS_DET_R           :              : VBUS rising detected
  44                          : USB_LINK_STATUS      :              : USB link status has changed
  45                          : USB_CH_TH_PROT_R     :              : Die temp is above usb charger
  46                          : USB_CH_TH_PROT_F     :              : Die temp is below usb charger
  47                          : USB_CHARGER_NOT_OKR  :              : allowed USB charger not ok detection
  48                          : VBUS_OVV             :              : Overvoltage on Vbus ball detected (USB charge is stopped)
  49                          : CH_WD_EXP            :              : Charger watchdog detected
  50 ab8500-gpadc             : HW_CONV_END          : vddadc       : Analogue to Digital Converter
  51                            SW_CONV_END          :              :
  52 ab8500-gpio              :                      :              : GPIO Controller (AB8500)
  53 ab8505-gpio              :                      :              : GPIO Controller (AB8505)
  54 ab8500-ponkey            : ONKEY_DBF            :              : Power-on Key
  55                            ONKEY_DBR            :              :
  56 ab8500-pwm               :                      :              : Pulse Width Modulator
  57 ab8500-regulator         :                      :              : Regulators (AB8500)
  58 ab8505-regulator         :                      :              : Regulators (AB8505)
  59 ab8500-rtc               : 60S                  :              : Real Time Clock
  60                          : ALARM                :              :
  61 ab8500-sysctrl           :                      :              : System Control
  62 ab8500-usb               : ID_WAKEUP_R          : vddulpivio18 : Universal Serial Bus
  63                          : ID_WAKEUP_F          : v-ape        :
  64                          : VBUS_DET_F           : musb_1v8     :
  65                          : VBUS_DET_R           :              :
  66                          : USB_LINK_STATUS      :              :
  67                          : USB_ADP_PROBE_PLUG   :              :
  68                          : USB_ADP_PROBE_UNPLUG :              :
  69
  70 Required child device properties:
  71 - compatible             : "stericsson,ab8500-[bm|btemp|charger|fg|gpadc|gpio|ponkey|
  72                                                pwm|regulator|rtc|sysctrl|usb]";
  73
  74   A few child devices require ADC channels from the GPADC node. Those follow the
  75   standard bindings from iio/iio-bindings.txt and iio/adc/adc.txt
  76
  77   abx500-temp            : io-channels "aux1" and "aux2" for measuring external
  78                            temperatures.
  79   ab8500-fg              : io-channel "main_bat_v" for measuring main battery voltage,
  80   ab8500-btemp           : io-channels "btemp_ball" and "bat_ctrl" for measuring the
  81                            battery voltage.
  82   ab8500-charger         : io-channels "main_charger_v", "main_charger_c", "vbus_v",
  83                            "usb_charger_c" for measuring voltage and current of the
  84                            different charging supplies.
  85
  86 Optional child device properties:
  87 - interrupts             : contains the device IRQ(s) using the 2-cell format (see above)
  88 - interrupt-names        : contains names of IRQ resource in the order in which they were
  89                            supplied in the interrupts property
  90 - <supply_name>-supply   : contains a phandle to the regulator supply node in Device Tree
  91
  92 Non-standard child device properties:
  93  - Audio CODEC:
  94    - stericsson,amic[1|2]-type-single-ended : Single-ended Analoge Mic (default: differential)
  95    - stericsson,amic1a-bias-vamic2          : Analoge Mic wishes to use a non-standard Vamic
  96    - stericsson,amic1b-bias-vamic2          : Analoge Mic wishes to use a non-standard Vamic
  97    - stericsson,amic2-bias-vamic1           : Analoge Mic wishes to use a non-standard Vamic
  98    - stericsson,earpeice-cmv                : Earpeice voltage (only: 950 | 1100 | 1270 | 1580)
  99
 100 ab8500 {
 101          compatible = "stericsson,ab8500";
 102          interrupts = <0 40 0x4>;
 103          interrupt-controller;
 104          #interrupt-cells = <2>;
 105
 106          ab8500-rtc {
 107                  compatible = "stericsson,ab8500-rtc";
 108                  interrupts = <17 0x4
 109                                18 0x4>;
 110                  interrupt-names = "60S", "ALARM";
 111          };
 112
 113         ab8500-gpadc {
 114                 compatible = "stericsson,ab8500-gpadc";
 115                 interrupts = <32 0x4
 116                               39 0x4>;
 117                 interrupt-names = "HW_CONV_END", "SW_CONV_END";
 118                 vddadc-supply = <&ab8500_ldo_tvout_reg>;
 119                 #address-cells = <1>;
 120                 #size-cells = <0>;
 121                 #io-channel-cells = <1>;
 122
 123                 /* GPADC channels */
 124                 bat_ctrl: channel@1 {
 125                         reg = <0x01>;
 126                 };
 127                 btemp_ball: channel@2 {
 128                         reg = <0x02>;
 129                 };
 130                 main_charger_v: channel@3 {
 131                         reg = <0x03>;
 132                 };
 133                 acc_detect1: channel@4 {
 134                         reg = <0x04>;
 135                 };
 136                 acc_detect2: channel@5 {
 137                         reg = <0x05>;
 138                 };
 139                 adc_aux1: channel@6 {
 140                         reg = <0x06>;
 141                 };
 142                 adc_aux2: channel@7 {
 143                         reg = <0x07>;
 144                 };
 145                 main_batt_v: channel@8 {
 146                         reg = <0x08>;
 147                 };
 148                 vbus_v: channel@9 {
 149                         reg = <0x09>;
 150                 };
 151                 main_charger_c: channel@a {
 152                         reg = <0x0a>;
 153                 };
 154                 usb_charger_c: channel@b {
 155                         reg = <0x0b>;
 156                 };
 157                 bk_bat_v: channel@c {
 158                         reg = <0x0c>;
 159                 };
 160                 die_temp: channel@d {
 161                         reg = <0x0d>;
 162                 };
 163                 usb_id: channel@e {
 164                         reg = <0x0e>;
 165                 };
 166                 xtal_temp: channel@12 {
 167                         reg = <0x12>;
 168                 };
 169                 vbat_true_meas: channel@13 {
 170                         reg = <0x13>;
 171                 };
 172                 bat_ctrl_and_ibat: channel@1c {
 173                         reg = <0x1c>;
 174                 };
 175                 vbat_meas_and_ibat: channel@1d {
 176                         reg = <0x1d>;
 177                 };
 178                 vbat_true_meas_and_ibat: channel@1e {
 179                         reg = <0x1e>;
 180                 };
 181                 bat_temp_and_ibat: channel@1f {
 182                         reg = <0x1f>;
 183                 };
 184         };
 185
 186         ab8500_temp {
 187                 compatible = "stericsson,abx500-temp";
 188                 io-channels = <&gpadc 0x06>,
 189                               <&gpadc 0x07>;
 190                 io-channel-name = "aux1", "aux2";
 191         };
 192
 193         ab8500_battery: ab8500_battery {
 194                 stericsson,battery-type = "LIPO";
 195                 thermistor-on-batctrl;
 196         };
 197
 198         ab8500_fg {
 199                 compatible = "stericsson,ab8500-fg";
 200                 battery    = <&ab8500_battery>;
 201                 io-channels = <&gpadc 0x08>;
 202                 io-channel-name = "main_bat_v";
 203         };
 204
 205         ab8500_btemp {
 206                 compatible = "stericsson,ab8500-btemp";
 207                 battery    = <&ab8500_battery>;
 208                 io-channels = <&gpadc 0x02>,
 209                               <&gpadc 0x01>;
 210                 io-channel-name = "btemp_ball",
 211                                 "bat_ctrl";
 212         };
 213
 214         ab8500_charger {
 215                 compatible      = "stericsson,ab8500-charger";
 216                 battery         = <&ab8500_battery>;
 217                 vddadc-supply   = <&ab8500_ldo_tvout_reg>;
 218                 io-channels = <&gpadc 0x03>,
 219                               <&gpadc 0x0a>,
 220                               <&gpadc 0x09>,
 221                               <&gpadc 0x0b>;
 222                 io-channel-name = "main_charger_v",
 223                                 "main_charger_c",
 224                                 "vbus_v",
 225                                 "usb_charger_c";
 226         };
 227
 228         ab8500-usb {
 229                 compatible = "stericsson,ab8500-usb";
 230                 interrupts = < 90 0x4
 231                                96 0x4
 232                                14 0x4
 233                                15 0x4
 234                                79 0x4
 235                                74 0x4
 236                                75 0x4>;
 237                 interrupt-names = "ID_WAKEUP_R",
 238                                   "ID_WAKEUP_F",
 239                                   "VBUS_DET_F",
 240                                   "VBUS_DET_R",
 241                                   "USB_LINK_STATUS",
 242                                   "USB_ADP_PROBE_PLUG",
 243                                   "USB_ADP_PROBE_UNPLUG";
 244                 vddulpivio18-supply = <&ab8500_ldo_intcore_reg>;
 245                 v-ape-supply = <&db8500_vape_reg>;
 246                 musb_1v8-supply = <&db8500_vsmps2_reg>;
 247         };
 248
 249         ab8500-ponkey {
 250                 compatible = "stericsson,ab8500-ponkey";
 251                 interrupts = <6 0x4
 252                               7 0x4>;
 253                 interrupt-names = "ONKEY_DBF", "ONKEY_DBR";
 254         };
 255
 256         ab8500-sysctrl {
 257                 compatible = "stericsson,ab8500-sysctrl";
 258         };
 259
 260         ab8500-pwm {
 261                 compatible = "stericsson,ab8500-pwm";
 262         };
 263
 264         codec: ab8500-codec {
 265                 compatible = "stericsson,ab8500-codec";
 266
 267                 stericsson,earpeice-cmv = <950>; /* Units in mV. */
 268         };
 269
 270         ab8500-regulators {
 271                 compatible = "stericsson,ab8500-regulator";
 272
 273                 ab8500_ldo_aux1_reg: ab8500_ldo_aux1 {
 274                         /*
 275                          * See: Documentation/devicetree/bindings/regulator/regulator.txt
 276                          * for more information on regulators
 277                          */
 278                 };
 279         };
 280 };