Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: mfd: Convert da9063 to yaml
Convert the dt binding for the da9063/da9063l to yaml.
Signed-off-by: Conor Dooley <conor.dooley@microchip.com>
Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20220606201343.514391-4-mail@conchuod.ie
authored by
Conor Dooley
and committed by
Lee Jones
361104b0
62fa5c98
+133
-116
-114
Documentation/devicetree/bindings/mfd/da9063.txt
-114
Documentation/devicetree/bindings/mfd/da9063.txt
···
1
-
* Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC)
2
-
3
-
DA9063 consists of a large and varied group of sub-devices (I2C Only):
4
-
5
-
Device Supply Names Description
6
-
------ ------------ -----------
7
-
da9063-regulator : : LDOs & BUCKs
8
-
da9063-onkey : : On Key
9
-
da9063-rtc : : Real-Time Clock (DA9063 only)
10
-
da9063-watchdog : : Watchdog
11
-
12
-
======
13
-
14
-
Required properties:
15
-
16
-
- compatible : Should be "dlg,da9063" or "dlg,da9063l"
17
-
- reg : Specifies the I2C slave address (this defaults to 0x58 but it can be
18
-
modified to match the chip's OTP settings).
19
-
- interrupts : IRQ line information.
20
-
- interrupt-controller
21
-
22
-
Sub-nodes:
23
-
24
-
- regulators : This node defines the settings for the LDOs and BUCKs.
25
-
The DA9063(L) regulators are bound using their names listed below:
26
-
27
-
bcore1 : BUCK CORE1
28
-
bcore2 : BUCK CORE2
29
-
bpro : BUCK PRO
30
-
bmem : BUCK MEM
31
-
bio : BUCK IO
32
-
bperi : BUCK PERI
33
-
ldo1 : LDO_1 (DA9063 only)
34
-
ldo2 : LDO_2 (DA9063 only)
35
-
ldo3 : LDO_3
36
-
ldo4 : LDO_4 (DA9063 only)
37
-
ldo5 : LDO_5 (DA9063 only)
38
-
ldo6 : LDO_6 (DA9063 only)
39
-
ldo7 : LDO_7
40
-
ldo8 : LDO_8
41
-
ldo9 : LDO_9
42
-
ldo10 : LDO_10 (DA9063 only)
43
-
ldo11 : LDO_11
44
-
45
-
The component follows the standard regulator framework and the bindings
46
-
details of individual regulator device can be found in:
47
-
Documentation/devicetree/bindings/regulator/regulator.txt
48
-
49
-
- rtc : This node defines settings for the Real-Time Clock associated with
50
-
the DA9063 only. The RTC is not present in DA9063L. There are currently
51
-
no entries in this binding, however compatible = "dlg,da9063-rtc" should
52
-
be added if a node is created.
53
-
54
-
- onkey : This node defines the OnKey settings for controlling the key
55
-
functionality of the device. The node should contain the compatible property
56
-
with the value "dlg,da9063-onkey".
57
-
58
-
Optional onkey properties:
59
-
60
-
- dlg,disable-key-power : Disable power-down using a long key-press. If this
61
-
entry exists the OnKey driver will remove support for the KEY_POWER key
62
-
press. If this entry does not exist then by default the key-press
63
-
triggered power down is enabled and the OnKey will support both KEY_POWER
64
-
and KEY_SLEEP.
65
-
66
-
- watchdog : This node defines settings for the Watchdog timer associated
67
-
with the DA9063 and DA9063L. The node should contain the compatible property
68
-
with the value "dlg,da9063-watchdog".
69
-
70
-
Optional watchdog properties:
71
-
- dlg,use-sw-pm: Add this property to disable the watchdog during suspend.
72
-
Only use this option if you can't use the watchdog automatic suspend
73
-
function during a suspend (see register CONTROL_B).
74
-
75
-
Example:
76
-
77
-
pmic0: da9063@58 {
78
-
compatible = "dlg,da9063"
79
-
reg = <0x58>;
80
-
interrupt-parent = <&gpio6>;
81
-
interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
82
-
interrupt-controller;
83
-
84
-
rtc {
85
-
compatible = "dlg,da9063-rtc";
86
-
};
87
-
88
-
wdt {
89
-
compatible = "dlg,da9063-watchdog";
90
-
};
91
-
92
-
onkey {
93
-
compatible = "dlg,da9063-onkey";
94
-
dlg,disable-key-power;
95
-
};
96
-
97
-
regulators {
98
-
DA9063_BCORE1: bcore1 {
99
-
regulator-name = "BCORE1";
100
-
regulator-min-microvolt = <300000>;
101
-
regulator-max-microvolt = <1570000>;
102
-
regulator-min-microamp = <500000>;
103
-
regulator-max-microamp = <2000000>;
104
-
regulator-boot-on;
105
-
};
106
-
DA9063_LDO11: ldo11 {
107
-
regulator-name = "LDO_11";
108
-
regulator-min-microvolt = <900000>;
109
-
regulator-max-microvolt = <3600000>;
110
-
regulator-boot-on;
111
-
};
112
-
};
113
-
};
114
-
+132
Documentation/devicetree/bindings/mfd/dlg,da9063.yaml
+132
Documentation/devicetree/bindings/mfd/dlg,da9063.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/mfd/dlg,da9063.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC)
8
+
9
+
maintainers:
10
+
- Steve Twiss <stwiss.opensource@diasemi.com>
11
+
12
+
description: |
13
+
For device-tree bindings of other sub-modules refer to the binding documents
14
+
under the respective sub-system directories.
15
+
16
+
properties:
17
+
compatible:
18
+
enum:
19
+
- dlg,da9063
20
+
- dlg,da9063l
21
+
22
+
reg:
23
+
maxItems: 1
24
+
25
+
interrupts:
26
+
maxItems: 1
27
+
28
+
interrupt-controller: true
29
+
30
+
"#interrupt-cells":
31
+
const: 2
32
+
33
+
dlg,use-sw-pm:
34
+
type: boolean
35
+
description:
36
+
Disable the watchdog during suspend.
37
+
Only use this option if you can't use the watchdog automatic suspend
38
+
function during a suspend (see register CONTROL_B).
39
+
40
+
watchdog:
41
+
type: object
42
+
$ref: /schemas/watchdog/watchdog.yaml#
43
+
unevaluatedProperties: false
44
+
properties:
45
+
compatible:
46
+
const: dlg,da9063-watchdog
47
+
48
+
rtc:
49
+
type: object
50
+
$ref: /schemas/rtc/rtc.yaml#
51
+
unevaluatedProperties: false
52
+
properties:
53
+
compatible:
54
+
const: dlg,da9063-rtc
55
+
56
+
onkey:
57
+
type: object
58
+
$ref: /schemas/input/input.yaml#
59
+
unevaluatedProperties: false
60
+
properties:
61
+
compatible:
62
+
const: dlg,da9063-onkey
63
+
64
+
dlg,disable-key-power:
65
+
type: boolean
66
+
description: |
67
+
Disable power-down using a long key-press.
68
+
If this entry does not exist then by default the key-press triggered
69
+
power down is enabled and the OnKey will support both KEY_POWER and
70
+
KEY_SLEEP.
71
+
72
+
regulators:
73
+
type: object
74
+
patternProperties:
75
+
"^(ldo[1-11]|bcore[1-2]|bpro|bmem|bio|bperi)$":
76
+
$ref: /schemas/regulator/regulator.yaml
77
+
unevaluatedProperties: false
78
+
79
+
required:
80
+
- compatible
81
+
- reg
82
+
- interrupts
83
+
- interrupt-controller
84
+
85
+
additionalProperties: false
86
+
87
+
examples:
88
+
- |
89
+
#include <dt-bindings/interrupt-controller/irq.h>
90
+
i2c {
91
+
#address-cells = <1>;
92
+
#size-cells = <0>;
93
+
pmic@58 {
94
+
compatible = "dlg,da9063";
95
+
reg = <0x58>;
96
+
#interrupt-cells = <2>;
97
+
interrupt-parent = <&gpio6>;
98
+
interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
99
+
interrupt-controller;
100
+
101
+
rtc {
102
+
compatible = "dlg,da9063-rtc";
103
+
};
104
+
105
+
watchdog {
106
+
compatible = "dlg,da9063-watchdog";
107
+
};
108
+
109
+
onkey {
110
+
compatible = "dlg,da9063-onkey";
111
+
dlg,disable-key-power;
112
+
};
113
+
114
+
regulators {
115
+
regulator-bcore1 {
116
+
regulator-name = "BCORE1";
117
+
regulator-min-microvolt = <300000>;
118
+
regulator-max-microvolt = <1570000>;
119
+
regulator-min-microamp = <500000>;
120
+
regulator-max-microamp = <2000000>;
121
+
regulator-boot-on;
122
+
};
123
+
regulator-ldo11 {
124
+
regulator-name = "LDO_11";
125
+
regulator-min-microvolt = <900000>;
126
+
regulator-max-microvolt = <3600000>;
127
+
regulator-boot-on;
128
+
};
129
+
};
130
+
};
131
+
};
132
+
...
-2
Documentation/devicetree/bindings/trivial-devices.yaml
-2
Documentation/devicetree/bindings/trivial-devices.yaml
···
93
93
- dh,dhcom-board
94
94
# DA9053: flexible system level PMIC with multicore support
95
95
- dlg,da9053
96
-
# DA9063: system PMIC for quad-core application processors
97
-
- dlg,da9063
98
96
# DMARD05: 3-axis I2C Accelerometer
99
97
- domintech,dmard05
100
98
# DMARD06: 3-axis I2C Accelerometer
+1
MAINTAINERS
+1
MAINTAINERS
···
5831
5831
F: Documentation/devicetree/bindings/input/da90??-onkey.txt
5832
5832
F: Documentation/devicetree/bindings/input/dlg,da72??.txt
5833
5833
F: Documentation/devicetree/bindings/mfd/da90*.txt
5834
+
F: Documentation/devicetree/bindings/mfd/da90*.yaml
5834
5835
F: Documentation/devicetree/bindings/regulator/dlg,da9*.yaml
5835
5836
F: Documentation/devicetree/bindings/regulator/da92*.txt
5836
5837
F: Documentation/devicetree/bindings/regulator/slg51000.txt