xref: /linux/Documentation/devicetree/bindings/pinctrl/samsung,pinctrl-pins-cfg.yaml (revision 9f2c9170934eace462499ba0bfe042cc72900173) 
1# 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
81