Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: pinctrl: pinctrl-max77620: convert to DT schema
Convert pinctrl-max77620 devicetree bindings for the MAX77620 PMIC from
TXT to YAML format. This patch does not change any functionality; the
bindings remain the same.
Signed-off-by: Svyatoslav Ryhel <clamor95@gmail.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Signed-off-by: Linus Walleij <linusw@kernel.org>
authored by
Svyatoslav Ryhel
and committed by
Linus Walleij
c43b91ee
6ea71857
+98
-127
+98
Documentation/devicetree/bindings/pinctrl/maxim,max77620-pinctrl.yaml
+98
Documentation/devicetree/bindings/pinctrl/maxim,max77620-pinctrl.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/pinctrl/maxim,max77620-pinctrl.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Pinmux controller function for Maxim MAX77620 Power management IC
8
+
9
+
maintainers:
10
+
- Svyatoslav Ryhel <clamor95@gmail.com>
11
+
12
+
description:
13
+
Device has 8 GPIO pins which can be configured as GPIO as well as the
14
+
special IO functions.
15
+
16
+
allOf:
17
+
- $ref: /schemas/pinctrl/pincfg-node.yaml
18
+
- $ref: /schemas/pinctrl/pinmux-node.yaml
19
+
20
+
patternProperties:
21
+
"^(pin|gpio).":
22
+
type: object
23
+
additionalProperties: false
24
+
25
+
properties:
26
+
pins:
27
+
items:
28
+
enum: [ gpio0, gpio1, gpio2, gpio3, gpio4, gpio5, gpio6, gpio7 ]
29
+
30
+
function:
31
+
items:
32
+
enum: [ gpio, lpm-control-in, fps-out, 32k-out1, sd0-dvs-in, sd1-dvs-in,
33
+
reference-out ]
34
+
35
+
drive-push-pull: true
36
+
drive-open-drain: true
37
+
bias-pull-up: true
38
+
bias-pull-down: true
39
+
40
+
maxim,active-fps-source:
41
+
$ref: /schemas/types.yaml#/definitions/uint32
42
+
description: |
43
+
FPS source for the GPIOs to get enabled/disabled when system is in
44
+
active state. Valid values are:
45
+
- MAX77620_FPS_SRC_0: FPS source is FPS0.
46
+
- MAX77620_FPS_SRC_1: FPS source is FPS1
47
+
- MAX77620_FPS_SRC_2: FPS source is FPS2
48
+
- MAX77620_FPS_SRC_NONE: GPIO is not controlled by FPS events and
49
+
it gets enabled/disabled by register access.
50
+
Absence of this property will leave the FPS configuration register
51
+
for that GPIO to default configuration.
52
+
53
+
maxim,active-fps-power-up-slot:
54
+
$ref: /schemas/types.yaml#/definitions/uint32
55
+
description:
56
+
Sequencing event slot number on which the GPIO get enabled when
57
+
master FPS input event set to HIGH. This is applicable if FPS source
58
+
is selected as FPS0, FPS1 or FPS2.
59
+
enum: [0, 1, 2, 3, 4, 5, 6, 7]
60
+
61
+
maxim,active-fps-power-down-slot:
62
+
$ref: /schemas/types.yaml#/definitions/uint32
63
+
description:
64
+
Sequencing event slot number on which the GPIO get disabled when
65
+
master FPS input event set to LOW. This is applicable if FPS source
66
+
is selected as FPS0, FPS1 or FPS2.
67
+
enum: [0, 1, 2, 3, 4, 5, 6, 7]
68
+
69
+
maxim,suspend-fps-source:
70
+
$ref: /schemas/types.yaml#/definitions/uint32
71
+
description:
72
+
This is same as property "maxim,active-fps-source" but value get
73
+
configured when system enters in to suspend state.
74
+
75
+
maxim,suspend-fps-power-up-slot:
76
+
$ref: /schemas/types.yaml#/definitions/uint32
77
+
description:
78
+
This is same as property "maxim,active-fps-power-up-slot" but this
79
+
value get configured into FPS configuration register when system
80
+
enters into suspend. This is applicable if suspend state FPS source
81
+
is selected as FPS0, FPS1 or FPS2.
82
+
enum: [0, 1, 2, 3, 4, 5, 6, 7]
83
+
84
+
maxim,suspend-fps-power-down-slot:
85
+
$ref: /schemas/types.yaml#/definitions/uint32
86
+
description:
87
+
This is same as property "maxim,active-fps-power-down-slot" but this
88
+
value get configured into FPS configuration register when system
89
+
enters into suspend. This is applicable if suspend state FPS source
90
+
is selected as FPS0, FPS1 or FPS2.
91
+
enum: [0, 1, 2, 3, 4, 5, 6, 7]
92
+
93
+
required:
94
+
- pins
95
+
96
+
additionalProperties: false
97
+
98
+
# see maxim,max77620.yaml for an example
-127
Documentation/devicetree/bindings/pinctrl/pinctrl-max77620.txt
-127
Documentation/devicetree/bindings/pinctrl/pinctrl-max77620.txt
···
1
-
Pincontrol driver for MAX77620 Power management IC from Maxim Semiconductor.
2
-
3
-
Device has 8 GPIO pins which can be configured as GPIO as well as the
4
-
special IO functions.
5
-
6
-
Please refer file <devicetree/bindings/pinctrl/pinctrl-bindings.txt>
7
-
for details of the common pinctrl bindings used by client devices,
8
-
including the meaning of the phrase "pin configuration node".
9
-
10
-
Optional Pinmux properties:
11
-
--------------------------
12
-
Following properties are required if default setting of pins are required
13
-
at boot.
14
-
- pinctrl-names: A pinctrl state named per <pinctrl-bindings.txt>.
15
-
- pinctrl[0...n]: Properties to contain the phandle for pinctrl states per
16
-
<pinctrl-bindings.txt>.
17
-
18
-
The pin configurations are defined as child of the pinctrl states node. Each
19
-
sub-node have following properties:
20
-
21
-
Required properties:
22
-
------------------
23
-
- pins: List of pins. Valid values of pins properties are:
24
-
gpio0, gpio1, gpio2, gpio3, gpio4, gpio5, gpio6, gpio7.
25
-
26
-
Optional properties:
27
-
-------------------
28
-
Following are optional properties defined as pinmux DT binding document
29
-
<pinctrl-bindings.txt>. Absence of properties will leave the configuration
30
-
on default.
31
-
function,
32
-
drive-push-pull,
33
-
drive-open-drain,
34
-
bias-pull-up,
35
-
bias-pull-down.
36
-
37
-
Valid values for function properties are:
38
-
gpio, lpm-control-in, fps-out, 32k-out, sd0-dvs-in, sd1-dvs-in,
39
-
reference-out
40
-
41
-
There are also customised properties for the GPIO1, GPIO2 and GPIO3. These
42
-
customised properties are required to configure FPS configuration parameters
43
-
of these GPIOs. Please refer <devicetree/bindings/mfd/max77620.txt> for more
44
-
detail of Flexible Power Sequence (FPS).
45
-
46
-
- maxim,active-fps-source: FPS source for the GPIOs to get
47
-
enabled/disabled when system is in
48
-
active state. Valid values are:
49
-
- MAX77620_FPS_SRC_0,
50
-
FPS source is FPS0.
51
-
- MAX77620_FPS_SRC_1,
52
-
FPS source is FPS1
53
-
- MAX77620_FPS_SRC_2 and
54
-
FPS source is FPS2
55
-
- MAX77620_FPS_SRC_NONE.
56
-
GPIO is not controlled
57
-
by FPS events and it gets
58
-
enabled/disabled by register
59
-
access.
60
-
Absence of this property will leave
61
-
the FPS configuration register for that
62
-
GPIO to default configuration.
63
-
64
-
- maxim,active-fps-power-up-slot: Sequencing event slot number on which
65
-
the GPIO get enabled when
66
-
master FPS input event set to HIGH.
67
-
Valid values are 0 to 7.
68
-
This is applicable if FPS source is
69
-
selected as FPS0, FPS1 or FPS2.
70
-
71
-
- maxim,active-fps-power-down-slot: Sequencing event slot number on which
72
-
the GPIO get disabled when master
73
-
FPS input event set to LOW.
74
-
Valid values are 0 to 7.
75
-
This is applicable if FPS source is
76
-
selected as FPS0, FPS1 or FPS2.
77
-
78
-
- maxim,suspend-fps-source: This is same as property
79
-
"maxim,active-fps-source" but value
80
-
get configured when system enters in
81
-
to suspend state.
82
-
83
-
- maxim,suspend-fps-power-up-slot: This is same as property
84
-
"maxim,active-fps-power-up-slot" but
85
-
this value get configured into FPS
86
-
configuration register when system
87
-
enters into suspend.
88
-
This is applicable if suspend state
89
-
FPS source is selected as FPS0, FPS1 or
90
-
91
-
- maxim,suspend-fps-power-down-slot: This is same as property
92
-
"maxim,active-fps-power-down-slot" but
93
-
this value get configured into FPS
94
-
configuration register when system
95
-
enters into suspend.
96
-
This is applicable if suspend state
97
-
FPS source is selected as FPS0, FPS1 or
98
-
FPS2.
99
-
100
-
Example:
101
-
--------
102
-
#include <dt-bindings/mfd/max77620.h>
103
-
...
104
-
max77620@3c {
105
-
106
-
pinctrl-names = "default";
107
-
pinctrl-0 = <&spmic_default>;
108
-
109
-
spmic_default: pinmux@0 {
110
-
pin_gpio0 {
111
-
pins = "gpio0";
112
-
function = "gpio";
113
-
};
114
-
115
-
pin_gpio1 {
116
-
pins = "gpio1";
117
-
function = "fps-out";
118
-
maxim,active-fps-source = <MAX77620_FPS_SRC_0>;
119
-
};
120
-
121
-
pin_gpio2 {
122
-
pins = "gpio2";
123
-
function = "fps-out";
124
-
maxim,active-fps-source = <MAX77620_FPS_SRC_1>;
125
-
};
126
-
};
127
-
};