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