-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Documentation: Describe the AB8500 Device Tree bindings
Although for the most part, the AB8500 uses common bindings, some of the ways in which they are used differ slightly to the common uses of those bindings. To clear up some of these varying concepts we provide some documentation describing each of the properties and how they are used. Signed-off-by: Lee Jones <lee.jones@linaro.org> Acked-by: Arnd Bergmann <arnd@arndb.de> Acked-by: Linus Walleij <linus.walleij@linaro.org> Signed-off-by: Samuel Ortiz <sameo@linux.intel.com>
- Loading branch information
Lee Jones
authored and
Samuel Ortiz
committed
Jul 16, 2012
1 parent
d02e83c
commit ad95ad1
Showing
1 changed file
with
123 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,123 @@ | ||
| * AB8500 Multi-Functional Device (MFD) | ||
|
|
||
| Required parent device properties: | ||
| - compatible : contains "stericsson,ab8500"; | ||
| - interrupts : contains the IRQ line for the AB8500 | ||
| - interrupt-controller : describes the AB8500 as an Interrupt Controller (has its own domain) | ||
| - #interrupt-cells : should be 2, for 2-cell format | ||
| - The first cell is the AB8500 local IRQ number | ||
| - The second cell is used to specify optional parameters | ||
| - bits[3:0] trigger type and level flags: | ||
| 1 = low-to-high edge triggered | ||
| 2 = high-to-low edge triggered | ||
| 4 = active high level-sensitive | ||
| 8 = active low level-sensitive | ||
|
|
||
| Optional parent device properties: | ||
| - reg : contains the PRCMU mailbox address for the AB8500 i2c port | ||
|
|
||
| The AB8500 consists of a large and varied group of sub-devices: | ||
|
|
||
| Device IRQ Names Supply Names Description | ||
| ------ --------- ------------ ----------- | ||
| ab8500-bm : : : Battery Manager | ||
| ab8500-btemp : : : Battery Temperature | ||
| ab8500-charger : : : Battery Charger | ||
| ab8500-fg : : : Fuel Gauge | ||
| ab8500-gpadc : HW_CONV_END : vddadc : Analogue to Digital Converter | ||
| SW_CONV_END : : | ||
| ab8500-gpio : : : GPIO Controller | ||
| ab8500-ponkey : ONKEY_DBF : : Power-on Key | ||
| ONKEY_DBR : : | ||
| ab8500-pwm : : : Pulse Width Modulator | ||
| ab8500-regulator : : : Regulators | ||
| ab8500-rtc : 60S : : Real Time Clock | ||
| : ALARM : : | ||
| ab8500-sysctrl : : : System Control | ||
| ab8500-usb : ID_WAKEUP_R : vddulpivio18 : Universal Serial Bus | ||
| : ID_WAKEUP_F : v-ape : | ||
| : VBUS_DET_F : musb_1v8 : | ||
| : VBUS_DET_R : : | ||
| : USB_LINK_STATUS : : | ||
| : USB_ADP_PROBE_PLUG : : | ||
| : USB_ADP_PROBE_UNPLUG : : | ||
|
|
||
| Required child device properties: | ||
| - compatible : "stericsson,ab8500-[bm|btemp|charger|fg|gpadc|gpio|ponkey| | ||
| pwm|regulator|rtc|sysctrl|usb]"; | ||
|
|
||
| Optional child device properties: | ||
| - interrupts : contains the device IRQ(s) using the 2-cell format (see above) | ||
| - interrupt-names : contains names of IRQ resource in the order in which they were | ||
| supplied in the interrupts property | ||
| - <supply_name>-supply : contains a phandle to the regulator supply node in Device Tree | ||
|
|
||
| ab8500@5 { | ||
| compatible = "stericsson,ab8500"; | ||
| reg = <5>; /* mailbox 5 is i2c */ | ||
| interrupts = <0 40 0x4>; | ||
| interrupt-controller; | ||
| #interrupt-cells = <2>; | ||
|
|
||
| ab8500-rtc { | ||
| compatible = "stericsson,ab8500-rtc"; | ||
| interrupts = <17 0x4 | ||
| 18 0x4>; | ||
| interrupt-names = "60S", "ALARM"; | ||
| }; | ||
|
|
||
| ab8500-gpadc { | ||
| compatible = "stericsson,ab8500-gpadc"; | ||
| interrupts = <32 0x4 | ||
| 39 0x4>; | ||
| interrupt-names = "HW_CONV_END", "SW_CONV_END"; | ||
| vddadc-supply = <&ab8500_ldo_tvout_reg>; | ||
| }; | ||
|
|
||
| ab8500-usb { | ||
| compatible = "stericsson,ab8500-usb"; | ||
| interrupts = < 90 0x4 | ||
| 96 0x4 | ||
| 14 0x4 | ||
| 15 0x4 | ||
| 79 0x4 | ||
| 74 0x4 | ||
| 75 0x4>; | ||
| interrupt-names = "ID_WAKEUP_R", | ||
| "ID_WAKEUP_F", | ||
| "VBUS_DET_F", | ||
| "VBUS_DET_R", | ||
| "USB_LINK_STATUS", | ||
| "USB_ADP_PROBE_PLUG", | ||
| "USB_ADP_PROBE_UNPLUG"; | ||
| vddulpivio18-supply = <&ab8500_ldo_initcore_reg>; | ||
| v-ape-supply = <&db8500_vape_reg>; | ||
| musb_1v8-supply = <&db8500_vsmps2_reg>; | ||
| }; | ||
|
|
||
| ab8500-ponkey { | ||
| compatible = "stericsson,ab8500-ponkey"; | ||
| interrupts = <6 0x4 | ||
| 7 0x4>; | ||
| interrupt-names = "ONKEY_DBF", "ONKEY_DBR"; | ||
| }; | ||
|
|
||
| ab8500-sysctrl { | ||
| compatible = "stericsson,ab8500-sysctrl"; | ||
| }; | ||
|
|
||
| ab8500-pwm { | ||
| compatible = "stericsson,ab8500-pwm"; | ||
| }; | ||
|
|
||
| ab8500-regulators { | ||
| compatible = "stericsson,ab8500-regulator"; | ||
|
|
||
| ab8500_ldo_aux1_reg: ab8500_ldo_aux1 { | ||
| /* | ||
| * See: Documentation/devicetree/bindings/regulator/regulator.txt | ||
| * for more information on regulators | ||
| */ | ||
| }; | ||
| }; | ||
| }; |