1* AB8500 Multi-Functional Device (MFD) 2 3Required 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 16The AB8500 consists of a large and varied group of sub-devices: 17 18Device IRQ Names Supply Names Description 19------ --------- ------------ ----------- 20ab8500-bm : : : Battery Manager 21ab8500-btemp : : : Battery Temperature 22ab8500-charger : : : Battery Charger 23ab8500-codec : : : Audio Codec 24ab8500-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 30ab8500-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 36ab8500-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 50ab8500-gpadc : HW_CONV_END : vddadc : Analogue to Digital Converter 51 SW_CONV_END : : 52ab8500-gpio : : : GPIO Controller (AB8500) 53ab8505-gpio : : : GPIO Controller (AB8505) 54ab8500-ponkey : ONKEY_DBF : : Power-on Key 55 ONKEY_DBR : : 56ab8500-pwm : : : Pulse Width Modulator 57ab8500-regulator : : : Regulators (AB8500) 58ab8505-regulator : : : Regulators (AB8505) 59ab8500-rtc : 60S : : Real Time Clock 60 : ALARM : : 61ab8500-sysctrl : : : System Control 62ab8500-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 70Required 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 86Optional 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 92Non-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 100ab8500 { 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}; 281