mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2026-01-11 17:10:13 +00:00
a730bf753e
Document the support of the I/O synchronization parameters: - skew-delay-input-ps; - skew-delay-output-ps; - st,io-sync. Forbid 'skew-delay-input-ps' and 'skew-delay-output-ps' to be both present on the same pin. Allow the new properties only with compatibles that support them. Add an example that uses the new properties. Co-developed-by: Fabien Dessenne <fabien.dessenne@foss.st.com> Signed-off-by: Fabien Dessenne <fabien.dessenne@foss.st.com> Signed-off-by: Antonio Borneo <antonio.borneo@foss.st.com> Reviewed-by: Conor Dooley <conor.dooley@microchip.com> Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
384 lines
11 KiB
YAML
384 lines
11 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
# Copyright (C) STMicroelectronics 2019.
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/pinctrl/st,stm32-pinctrl.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: STM32 GPIO and Pin Mux/Config controller
|
|
|
|
maintainers:
|
|
- Alexandre TORGUE <alexandre.torgue@foss.st.com>
|
|
|
|
description: |
|
|
STMicroelectronics's STM32 MCUs integrate a GPIO and Pin mux/config hardware
|
|
controller. It controls the input/output settings on the available pins and
|
|
also provides ability to multiplex and configure the output of various
|
|
on-chip controllers onto these pads.
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- st,stm32f429-pinctrl
|
|
- st,stm32f469-pinctrl
|
|
- st,stm32f746-pinctrl
|
|
- st,stm32f769-pinctrl
|
|
- st,stm32h743-pinctrl
|
|
- st,stm32mp135-pinctrl
|
|
- st,stm32mp157-pinctrl
|
|
- st,stm32mp157-z-pinctrl
|
|
- st,stm32mp257-pinctrl
|
|
- st,stm32mp257-z-pinctrl
|
|
|
|
'#address-cells':
|
|
const: 1
|
|
|
|
'#size-cells':
|
|
const: 1
|
|
|
|
ranges: true
|
|
|
|
pins-are-numbered:
|
|
$ref: /schemas/types.yaml#/definitions/flag
|
|
deprecated: true
|
|
|
|
hwlocks: true
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
|
|
st,syscfg:
|
|
description: Phandle+args to the syscon node which includes IRQ mux selection.
|
|
$ref: /schemas/types.yaml#/definitions/phandle-array
|
|
items:
|
|
- minItems: 2
|
|
items:
|
|
- description: syscon node which includes IRQ mux selection
|
|
- description: The offset of the IRQ mux selection register
|
|
- description: The field mask of IRQ mux, needed if different of 0xf
|
|
|
|
st,package:
|
|
description:
|
|
Indicates the SOC package used.
|
|
More details in include/dt-bindings/pinctrl/stm32-pinfunc.h
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [0x1, 0x2, 0x4, 0x8, 0x100, 0x400, 0x800]
|
|
|
|
patternProperties:
|
|
'^gpio@[0-9a-f]*$':
|
|
type: object
|
|
additionalProperties: false
|
|
properties:
|
|
gpio-controller: true
|
|
|
|
'#gpio-cells':
|
|
const: 2
|
|
|
|
interrupt-controller: true
|
|
'#interrupt-cells':
|
|
const: 2
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
maxItems: 1
|
|
|
|
resets:
|
|
maxItems: 1
|
|
|
|
gpio-line-names: true
|
|
|
|
gpio-ranges:
|
|
minItems: 1
|
|
maxItems: 16
|
|
|
|
ngpios:
|
|
description:
|
|
Number of available gpios in a bank.
|
|
minimum: 1
|
|
maximum: 16
|
|
|
|
st,bank-name:
|
|
description:
|
|
Should be a name string for this bank as specified in the datasheet.
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
enum:
|
|
- GPIOA
|
|
- GPIOB
|
|
- GPIOC
|
|
- GPIOD
|
|
- GPIOE
|
|
- GPIOF
|
|
- GPIOG
|
|
- GPIOH
|
|
- GPIOI
|
|
- GPIOJ
|
|
- GPIOK
|
|
- GPIOZ
|
|
|
|
st,bank-ioport:
|
|
description:
|
|
Should correspond to the EXTI IOport selection (EXTI line used
|
|
to select GPIOs as interrupts).
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
minimum: 0
|
|
maximum: 11
|
|
|
|
patternProperties:
|
|
"^(.+-hog(-[0-9]+)?)$":
|
|
type: object
|
|
required:
|
|
- gpio-hog
|
|
|
|
required:
|
|
- gpio-controller
|
|
- '#gpio-cells'
|
|
- reg
|
|
- clocks
|
|
- st,bank-name
|
|
|
|
'-[0-9]*$':
|
|
type: object
|
|
additionalProperties: false
|
|
|
|
patternProperties:
|
|
'^pins':
|
|
type: object
|
|
additionalProperties: false
|
|
description: |
|
|
A pinctrl node should contain at least one subnode representing the
|
|
pinctrl group available on the machine. Each subnode will list the
|
|
pins it needs, and how they should be configured, with regard to muxer
|
|
configuration, pullups, drive, output high/low and output speed.
|
|
$ref: /schemas/pinctrl/pincfg-node.yaml
|
|
|
|
properties:
|
|
pinmux:
|
|
$ref: /schemas/types.yaml#/definitions/uint32-array
|
|
description: |
|
|
Integer array, represents gpio pin number and mux setting.
|
|
Supported pin number and mux varies for different SoCs, and are
|
|
defined in dt-bindings/pinctrl/<soc>-pinfunc.h directly.
|
|
These defines are calculated as: ((port * 16 + line) << 8) | function
|
|
With:
|
|
- port: The gpio port index (PA = 0, PB = 1, ..., PK = 11)
|
|
- line: The line offset within the port (PA0 = 0, PA1 = 1, ..., PA15 = 15)
|
|
- function: The function number, can be:
|
|
* 0 : GPIO
|
|
* 1 : Alternate Function 0
|
|
* 2 : Alternate Function 1
|
|
* 3 : Alternate Function 2
|
|
* ...
|
|
* 16 : Alternate Function 15
|
|
* 17 : Analog
|
|
* 18 : Reserved
|
|
To simplify the usage, macro is available to generate "pinmux" field.
|
|
This macro is available here:
|
|
- include/dt-bindings/pinctrl/stm32-pinfunc.h
|
|
Setting the pinmux's function to the Reserved (RSVD) value is used to inform
|
|
the driver that it shall not apply the mux setting. This can be used to
|
|
reserve some pins, for example to a co-processor not running Linux.
|
|
Some examples of using macro:
|
|
/* GPIO A9 set as alternate function 2 */
|
|
... {
|
|
pinmux = <STM32_PINMUX('A', 9, AF2)>;
|
|
};
|
|
/* GPIO A9 set as GPIO */
|
|
... {
|
|
pinmux = <STM32_PINMUX('A', 9, GPIO)>;
|
|
};
|
|
/* GPIO A9 set as analog */
|
|
... {
|
|
pinmux = <STM32_PINMUX('A', 9, ANALOG)>;
|
|
};
|
|
/* GPIO A9 reserved for co-processor */
|
|
... {
|
|
pinmux = <STM32_PINMUX('A', 9, RSVD)>;
|
|
};
|
|
|
|
bias-disable: true
|
|
|
|
bias-pull-down: true
|
|
|
|
bias-pull-up: true
|
|
|
|
drive-push-pull: true
|
|
|
|
drive-open-drain: true
|
|
|
|
output-low: true
|
|
|
|
output-high: true
|
|
|
|
slew-rate:
|
|
description: |
|
|
0: Low speed
|
|
1: Medium speed
|
|
2: Fast speed
|
|
3: High speed
|
|
minimum: 0
|
|
maximum: 3
|
|
|
|
skew-delay-input-ps:
|
|
description: |
|
|
IO synchronization skew rate applied to the input path
|
|
enum: [0, 300, 500, 750, 1000, 1250, 1500, 1750, 2000, 2250, 2500, 2750, 3000, 3250]
|
|
|
|
skew-delay-output-ps:
|
|
description: |
|
|
IO synchronization latch delay applied to the output path
|
|
enum: [0, 300, 500, 750, 1000, 1250, 1500, 1750, 2000, 2250, 2500, 2750, 3000, 3250]
|
|
|
|
st,io-sync:
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
enum:
|
|
- pass-through
|
|
- clock inverted
|
|
- data on rising edge
|
|
- data on falling edge
|
|
- data on both edges
|
|
description: |
|
|
IO synchronization through re-sampling or inversion
|
|
"pass-through" - data or clock GPIO pass-through
|
|
"clock inverted" - clock GPIO inverted
|
|
"data on rising edge" - data GPIO re-sampled on clock rising edge
|
|
"data on falling edge" - data GPIO re-sampled on clock falling edge
|
|
"data on both edges" - data GPIO re-sampled on both clock edges
|
|
default: pass-through
|
|
|
|
required:
|
|
- pinmux
|
|
|
|
# Not allowed both skew-delay-input-ps and skew-delay-output-ps
|
|
if:
|
|
required:
|
|
- skew-delay-input-ps
|
|
then:
|
|
properties:
|
|
skew-delay-output-ps: false
|
|
|
|
allOf:
|
|
- $ref: pinctrl.yaml#
|
|
|
|
- if:
|
|
not:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- st,stm32mp257-pinctrl
|
|
- st,stm32mp257-z-pinctrl
|
|
then:
|
|
patternProperties:
|
|
'-[0-9]*$':
|
|
patternProperties:
|
|
'^pins':
|
|
properties:
|
|
skew-delay-input-ps: false
|
|
skew-delay-output-ps: false
|
|
st,io-sync: false
|
|
|
|
required:
|
|
- compatible
|
|
- '#address-cells'
|
|
- '#size-cells'
|
|
- ranges
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/pinctrl/stm32-pinfunc.h>
|
|
#include <dt-bindings/mfd/stm32f4-rcc.h>
|
|
//Example 1
|
|
pinctrl@40020000 {
|
|
#address-cells = <1>;
|
|
#size-cells = <1>;
|
|
compatible = "st,stm32f429-pinctrl";
|
|
ranges = <0 0x40020000 0x3000>;
|
|
|
|
gpioa: gpio@0 {
|
|
gpio-controller;
|
|
#gpio-cells = <2>;
|
|
reg = <0x0 0x400>;
|
|
resets = <&reset_ahb1 0>;
|
|
clocks = <&rcc 0 STM32F4_AHB1_CLOCK(GPIOA)>;
|
|
st,bank-name = "GPIOA";
|
|
};
|
|
};
|
|
|
|
//Example 2 (using gpio-ranges)
|
|
pinctrl@50020000 {
|
|
#address-cells = <1>;
|
|
#size-cells = <1>;
|
|
compatible = "st,stm32f429-pinctrl";
|
|
ranges = <0 0x50020000 0x3000>;
|
|
|
|
gpiob: gpio@1000 {
|
|
gpio-controller;
|
|
#gpio-cells = <2>;
|
|
reg = <0x1000 0x400>;
|
|
resets = <&reset_ahb1 0>;
|
|
clocks = <&rcc 0 STM32F4_AHB1_CLOCK(GPIOB)>;
|
|
st,bank-name = "GPIOB";
|
|
gpio-ranges = <&pinctrl 0 0 16>;
|
|
};
|
|
|
|
gpioc: gpio@2000 {
|
|
gpio-controller;
|
|
#gpio-cells = <2>;
|
|
reg = <0x2000 0x400>;
|
|
resets = <&reset_ahb1 0>;
|
|
clocks = <&rcc 0 STM32F4_AHB1_CLOCK(GPIOC)>;
|
|
st,bank-name = "GPIOC";
|
|
ngpios = <5>;
|
|
gpio-ranges = <&pinctrl 0 16 3>,
|
|
<&pinctrl 14 30 2>;
|
|
};
|
|
};
|
|
|
|
//Example 3 pin groups
|
|
pinctrl {
|
|
usart1_pins_a: usart1-0 {
|
|
pins1 {
|
|
pinmux = <STM32_PINMUX('A', 9, AF7)>;
|
|
bias-disable;
|
|
drive-push-pull;
|
|
slew-rate = <0>;
|
|
};
|
|
pins2 {
|
|
pinmux = <STM32_PINMUX('A', 10, AF7)>;
|
|
bias-disable;
|
|
};
|
|
};
|
|
};
|
|
|
|
usart1 {
|
|
pinctrl-0 = <&usart1_pins_a>;
|
|
pinctrl-names = "default";
|
|
};
|
|
|
|
- |
|
|
#include <dt-bindings/pinctrl/stm32-pinfunc.h>
|
|
//Example 4 skew-delay and st,io-sync
|
|
pinctrl: pinctrl@44240000 {
|
|
compatible = "st,stm32mp257-pinctrl";
|
|
#address-cells = <1>;
|
|
#size-cells = <1>;
|
|
ranges = <0 0x44240000 0xa0400>;
|
|
|
|
eth3_rgmii_pins_a: eth3-rgmii-0 {
|
|
pins1 {
|
|
pinmux = <STM32_PINMUX('A', 6, AF14)>;
|
|
st,io-sync = "data on both edges";
|
|
};
|
|
pins2 {
|
|
pinmux = <STM32_PINMUX('H', 2, AF14)>;
|
|
skew-delay-output-ps = <500>;
|
|
};
|
|
};
|
|
};
|
|
|
|
...
|