xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/mfd/twl4030-power.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunTexas Instruments TWL family (twl4030) reset and power management module
2*4882a593Smuzhiyun
3*4882a593SmuzhiyunThe power management module inside the TWL family provides several facilities
4*4882a593Smuzhiyunto control the power resources, including power scripts. For now, the
5*4882a593Smuzhiyunbinding only supports the complete shutdown of the system after poweroff.
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunRequired properties:
8*4882a593Smuzhiyun- compatible : must be one of the following
9*4882a593Smuzhiyun	"ti,twl4030-power"
10*4882a593Smuzhiyun	"ti,twl4030-power-reset"
11*4882a593Smuzhiyun	"ti,twl4030-power-idle"
12*4882a593Smuzhiyun	"ti,twl4030-power-idle-osc-off"
13*4882a593Smuzhiyun
14*4882a593SmuzhiyunThe use of ti,twl4030-power-reset is recommended at least on
15*4882a593Smuzhiyun3530 that needs a special configuration for warm reset to work.
16*4882a593Smuzhiyun
17*4882a593SmuzhiyunWhen using ti,twl4030-power-idle, the TI recommended configuration
18*4882a593Smuzhiyunfor idle modes is loaded to the tlw4030 PMIC.
19*4882a593Smuzhiyun
20*4882a593SmuzhiyunWhen using ti,twl4030-power-idle-osc-off, the TI recommended
21*4882a593Smuzhiyunconfiguration is used with the external oscillator being shut
22*4882a593Smuzhiyundown during off-idle. Note that this does not work on all boards
23*4882a593Smuzhiyundepending on how the external oscillator is wired.
24*4882a593Smuzhiyun
25*4882a593SmuzhiyunOptional properties:
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun- ti,system-power-controller: This indicates that TWL4030 is the
28*4882a593Smuzhiyun  power supply master of the system. With this flag, the chip will
29*4882a593Smuzhiyun  initiate an ACTIVE-to-OFF or SLEEP-to-OFF transition when the
30*4882a593Smuzhiyun  system poweroffs.
31*4882a593Smuzhiyun
32*4882a593Smuzhiyun- ti,use_poweroff: Deprecated name for ti,system-power-controller
33*4882a593Smuzhiyun
34*4882a593SmuzhiyunExample:
35*4882a593Smuzhiyun&i2c1 {
36*4882a593Smuzhiyun	clock-frequency = <2600000>;
37*4882a593Smuzhiyun
38*4882a593Smuzhiyun	twl: twl@48 {
39*4882a593Smuzhiyun		reg = <0x48>;
40*4882a593Smuzhiyun		interrupts = <7>; /* SYS_NIRQ cascaded to intc */
41*4882a593Smuzhiyun		interrupt-parent = <&intc>;
42*4882a593Smuzhiyun
43*4882a593Smuzhiyun		twl_power: power {
44*4882a593Smuzhiyun			compatible = "ti,twl4030-power";
45*4882a593Smuzhiyun			ti,use_poweroff;
46*4882a593Smuzhiyun		};
47*4882a593Smuzhiyun	};
48*4882a593Smuzhiyun};
49