Documentation/devicetree/bindings/mfd/ab8500.txt

   1 * AB8500 Multi-Functional Device (MFD)
   2
   3 Required parent device properties:
   4 - compatible             : contains "stericsson,ab8500";
   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 Optional parent device properties:
  17 - reg                    : contains the PRCMU mailbox address for the AB8500 i2c port
  18
  19 The AB8500 consists of a large and varied group of sub-devices:
  20
  21 Device                     IRQ Names              Supply Names   Description
  22 ------                     ---------              ------------   -----------
  23 ab8500-bm                :                      :              : Battery Manager
  24 ab8500-btemp             :                      :              : Battery Temperature
  25 ab8500-charger           :                      :              : Battery Charger
  26 ab8500-codec             :                      :              : Audio Codec
  27 ab8500-fg                :                      :              : Fuel Gauge
  28 ab8500-gpadc             : HW_CONV_END          : vddadc       : Analogue to Digital Converter
  29                            SW_CONV_END          :              :
  30 ab8500-gpio              :                      :              : GPIO Controller
  31 ab8500-ponkey            : ONKEY_DBF            :              : Power-on Key
  32                            ONKEY_DBR            :              :
  33 ab8500-pwm               :                      :              : Pulse Width Modulator
  34 ab8500-regulator         :                      :              : Regulators
  35 ab8500-rtc               : 60S                  :              : Real Time Clock
  36                          : ALARM                :              :
  37 ab8500-sysctrl           :                      :              : System Control
  38 ab8500-usb               : ID_WAKEUP_R          : vddulpivio18 : Universal Serial Bus
  39                          : ID_WAKEUP_F          : v-ape        :
  40                          : VBUS_DET_F           : musb_1v8     :
  41                          : VBUS_DET_R           :              :
  42                          : USB_LINK_STATUS      :              :
  43                          : USB_ADP_PROBE_PLUG   :              :
  44                          : USB_ADP_PROBE_UNPLUG :              :
  45
  46 Required child device properties:
  47 - compatible             : "stericsson,ab8500-[bm|btemp|charger|fg|gpadc|gpio|ponkey|
  48                                                pwm|regulator|rtc|sysctrl|usb]";
  49
  50 Optional child device properties:
  51 - interrupts             : contains the device IRQ(s) using the 2-cell format (see above)
  52 - interrupt-names        : contains names of IRQ resource in the order in which they were
  53                            supplied in the interrupts property
  54 - <supply_name>-supply   : contains a phandle to the regulator supply node in Device Tree
  55
  56 Non-standard child device properties:
  57  - Audio CODEC:
  58    - stericsson,amic[1|2]-type-single-ended : Single-ended Analoge Mic (default: differential)
  59    - stericsson,amic1a-bias-vamic2          : Analoge Mic wishes to use a non-standard Vamic
  60    - stericsson,amic1b-bias-vamic2          : Analoge Mic wishes to use a non-standard Vamic
  61    - stericsson,amic2-bias-vamic1           : Analoge Mic wishes to use a non-standard Vamic
  62    - stericsson,earpeice-cmv                : Earpeice voltage (only: 950 | 1100 | 1270 | 1580)
  63
  64 ab8500@5 {
  65          compatible = "stericsson,ab8500";
  66          reg = <5>; /* mailbox 5 is i2c */
  67          interrupts = <0 40 0x4>;
  68          interrupt-controller;
  69          #interrupt-cells = <2>;
  70
  71          ab8500-rtc {
  72                  compatible = "stericsson,ab8500-rtc";
  73                  interrupts = <17 0x4
  74                                18 0x4>;
  75                  interrupt-names = "60S", "ALARM";
  76          };
  77
  78         ab8500-gpadc {
  79                 compatible = "stericsson,ab8500-gpadc";
  80                 interrupts = <32 0x4
  81                               39 0x4>;
  82                 interrupt-names = "HW_CONV_END", "SW_CONV_END";
  83                 vddadc-supply = <&ab8500_ldo_tvout_reg>;
  84         };
  85
  86         ab8500-usb {
  87                 compatible = "stericsson,ab8500-usb";
  88                 interrupts = < 90 0x4
  89                                96 0x4
  90                                14 0x4
  91                                15 0x4
  92                                79 0x4
  93                                74 0x4
  94                                75 0x4>;
  95                 interrupt-names = "ID_WAKEUP_R",
  96                                   "ID_WAKEUP_F",
  97                                   "VBUS_DET_F",
  98                                   "VBUS_DET_R",
  99                                   "USB_LINK_STATUS",
 100                                   "USB_ADP_PROBE_PLUG",
 101                                   "USB_ADP_PROBE_UNPLUG";
 102                 vddulpivio18-supply = <&ab8500_ldo_initcore_reg>;
 103                 v-ape-supply = <&db8500_vape_reg>;
 104                 musb_1v8-supply = <&db8500_vsmps2_reg>;
 105         };
 106
 107         ab8500-ponkey {
 108                 compatible = "stericsson,ab8500-ponkey";
 109                 interrupts = <6 0x4
 110                               7 0x4>;
 111                 interrupt-names = "ONKEY_DBF", "ONKEY_DBR";
 112         };
 113
 114         ab8500-sysctrl {
 115                 compatible = "stericsson,ab8500-sysctrl";
 116         };
 117
 118         ab8500-pwm {
 119                 compatible = "stericsson,ab8500-pwm";
 120         };
 121
 122         codec: ab8500-codec {
 123                 compatible = "stericsson,ab8500-codec";
 124
 125                 stericsson,earpeice-cmv = <950>; /* Units in mV. */
 126         };
 127
 128         ab8500-regulators {
 129                 compatible = "stericsson,ab8500-regulator";
 130
 131                 ab8500_ldo_aux1_reg: ab8500_ldo_aux1 {
 132                         /*
 133                          * See: Documentation/devicetree/bindings/regulator/regulator.txt
 134                          * for more information on regulators
 135                          */
 136                 };
 137         };
 138 };