blob: f796f27bf0e648196a17013873893a7bae2deac6 [file] [log] [blame]
Tom Rini53633a82024-02-29 12:33:36 -05001# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/pinctrl/samsung,pinctrl-pins-cfg.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Samsung S3C/S5P/Exynos SoC pin controller - pins configuration
8
9maintainers:
10 - Krzysztof Kozlowski <krzk@kernel.org>
11 - Sylwester Nawrocki <s.nawrocki@samsung.com>
12 - Tomasz Figa <tomasz.figa@gmail.com>
13
14description: |
15 This is a part of device tree bindings for Samsung S3C/S5P/Exynos SoC pin
16 controller.
17
18 Pins configuration for Samsung S3C/S5P/Exynos SoC pin controller.
19
20 The values used for config properties should be derived from the hardware
21 manual and these values are programmed as-is into the pin pull up/down and
22 driver strength register of the pin-controller.
23
24 See also Documentation/devicetree/bindings/pinctrl/samsung,pinctrl.yaml for
25 additional information and example.
26
27properties:
28 samsung,pins:
29 description: |
30 List of pins to configure. For initial and sleep states, the maximum
31 number is one pin. In other cases there is no upper limit.
32
33 The pins should use lowercase names matching hardware manual, e.g. for
34 GPA0 bank: gpa0-0, gpa0-1, gpa0-2.
35 $ref: /schemas/types.yaml#/definitions/string-array
36
37 samsung,pin-function:
38 description: |
39 The pin function selection that should be applied on the pins listed in the
40 child node is specified using the "samsung,pin-function" property. The value
41 of this property that should be applied to each of the pins listed in the
42 "samsung,pins" property should be picked from the hardware manual of the SoC
43 for the specified pin group. This property is optional in the child node if
44 no specific function selection is desired for the pins listed in the child
45 node. The value of this property is used as-is to program the pin-controller
46 function selector register of the pin-bank.
47 $ref: /schemas/types.yaml#/definitions/uint32
48 minimum: 0
49 maximum: 15
50
51 samsung,pin-drv:
52 description: Drive strength configuration.
53 $ref: /schemas/types.yaml#/definitions/uint32
54 minimum: 0
55 maximum: 15
56
57 samsung,pin-pud:
58 description: Pull up/down configuration.
59 $ref: /schemas/types.yaml#/definitions/uint32
60 enum: [0, 1, 2, 3]
61
62 samsung,pin-val:
63 description: Initial value of pin output buffer.
64 $ref: /schemas/types.yaml#/definitions/uint32
65 enum: [0, 1]
66
67 samsung,pin-con-pdn:
68 description: Function in power down mode.
69 $ref: /schemas/types.yaml#/definitions/uint32
70 enum: [0, 1, 2, 3]
71
72 samsung,pin-pud-pdn:
73 description: Pull up/down configuration in power down mode.
74 $ref: /schemas/types.yaml#/definitions/uint32
75 enum: [0, 1, 2, 3]
76
77required:
78 - samsung,pins
79
80additionalProperties: false