179 lines
6.3 KiB
YAML
179 lines
6.3 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/pinctrl/nvidia,tegra-pinmux-common.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: NVIDIA Tegra Pinmux Controller
|
|
|
|
maintainers:
|
|
- Thierry Reding <thierry.reding@gmail.com>
|
|
- Jonathan Hunter <jonathanh@nvidia.com>
|
|
|
|
description: |
|
|
Please refer to pinctrl-bindings.txt in this directory for details of the
|
|
common pinctrl bindings used by client devices, including the meaning of
|
|
the phrase "pin configuration node".
|
|
|
|
Tegra's pin configuration nodes act as a container for an arbitrary number
|
|
of subnodes. Each of these subnodes represents some desired configuration
|
|
for a pin, a group, or a list of pins or groups. This configuration can
|
|
include the mux function to select on those pin(s)/ group(s), and various
|
|
pin configuration parameters, such as pull-up, tristate, drive strength,
|
|
etc.
|
|
|
|
The name of each subnode is not important; all subnodes should be
|
|
enumerated and processed purely based on their content.
|
|
|
|
Each subnode only affects those parameters that are explicitly listed. In
|
|
other words, a subnode that lists a mux function but no pin configuration
|
|
parameters implies no information about any pin configuration parameters.
|
|
|
|
Similarly, a pin subnode that describes a pullup parameter implies no
|
|
information about e.g. the mux function or tristate parameter. For this
|
|
reason, even seemingly boolean values are actually tristates in this
|
|
binding: unspecified, off, or on. Unspecified is represented as an absent
|
|
property, and off/on are represented as integer values 0 and 1.
|
|
|
|
Note that many of these properties are only valid for certain specific pins
|
|
or groups. See the Tegra TRM and various pinmux spreadsheets for complete
|
|
details regarding which groups support which functionality. The Linux
|
|
pinctrl driver may also be a useful reference, since it consolidates,
|
|
disambiguates, and corrects data from all those sources.
|
|
|
|
properties:
|
|
nvidia,pins:
|
|
$ref: /schemas/types.yaml#/definitions/string-array
|
|
description: An array of strings. Each string contains the name of a pin
|
|
or group. Valid values for these names are listed below.
|
|
|
|
nvidia,function:
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
description: A string containing the name of the function to mux to the
|
|
pin or group. Valid values for function names are listed below. See the
|
|
Tegra TRM to determine which are valid for each pin or group.
|
|
|
|
nvidia,pull:
|
|
description: Pull-down/up setting to apply to the pin.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
oneOf:
|
|
- description: none
|
|
const: 0
|
|
- description: down
|
|
const: 1
|
|
- description: up
|
|
const: 2
|
|
|
|
nvidia,tristate:
|
|
description: Tristate setting to apply to the pin.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
oneOf:
|
|
- description: drive
|
|
const: 0
|
|
- description: tristate
|
|
const: 1
|
|
|
|
nvidia,schmitt:
|
|
description: Enable Schmitt trigger on the input.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
oneOf:
|
|
- description: disable Schmitt trigger on the input
|
|
const: 0
|
|
- description: enable Schmitt trigger on the input
|
|
const: 1
|
|
|
|
nvidia,pull-down-strength:
|
|
description: Controls drive strength. 0 is weakest. The range of valid
|
|
values depends on the pingroup. See "CAL_DRVDN" in the Tegra TRM.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
nvidia,pull-up-strength:
|
|
description: Controls drive strength. 0 is weakest. The range of valid
|
|
values depends on the pingroup. See "CAL_DRVUP" in the Tegra TRM.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
nvidia,high-speed-mode:
|
|
description: Enable high speed mode the pins.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
oneOf:
|
|
- description: normal speed mode
|
|
const: 0
|
|
- description: high speed mode
|
|
const: 1
|
|
|
|
nvidia,low-power-mode:
|
|
description: Controls the drive power or current. Valid values are from 0
|
|
through 3, where 0 specifies the least power and 3 specifies the most
|
|
power. See "Low Power Mode" or "LPMD1" and "LPMD0" in the Tegra TRM.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [ 0, 1, 2, 3 ]
|
|
|
|
nvidia,enable-input:
|
|
description: Enable the pin's input path.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
oneOf:
|
|
- description: disable input (i.e. output only)
|
|
const: 0
|
|
- description: enable input
|
|
const: 1
|
|
|
|
nvidia,open-drain:
|
|
description: Open-drain configuration for the pin.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
oneOf:
|
|
- description: disable open-drain
|
|
const: 0
|
|
- description: enable open-drain
|
|
const: 1
|
|
|
|
nvidia,lock:
|
|
description: Lock the pin configuration against further changes until
|
|
reset.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
oneOf:
|
|
- description: disable pin configuration lock
|
|
const: 0
|
|
- description: enable pin configuration lock
|
|
const: 1
|
|
|
|
nvidia,io-reset:
|
|
description: reset the I/O path
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [ 0, 1 ]
|
|
|
|
nvidia,rcv-sel:
|
|
description: select VIL/VIH receivers
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
oneOf:
|
|
- description: normal receivers
|
|
const: 0
|
|
- description: high-voltage receivers
|
|
const: 1
|
|
|
|
nvidia,drive-type:
|
|
description: Drive type to configure for the pin.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [ 0, 1, 2, 3 ]
|
|
|
|
nvidia,io-hv:
|
|
description: Select high-voltage receivers.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
oneOf:
|
|
- description: Use normal receivers.
|
|
const: 0
|
|
- description: Use high-voltage receivers.
|
|
const: 1
|
|
|
|
nvidia,slew-rate-rising:
|
|
description: Controls rising signal slew rate. 0 is fastest. The range of
|
|
valid values depends on the pingroup. See "DRVDN_SLWR" in the Tegra TRM.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
nvidia,slew-rate-falling:
|
|
description: Controls falling signal slew rate. 0 is fastest. The range of
|
|
valid values depends on the pingroup. See "DRVUP_SLWF" in the Tegra TRM.
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
|
|
additionalProperties: true
|
|
...
|