Documentation/devicetree/bindings/pinctrl/pinctrl-multiplexer.yaml

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/pinctrl/pinctrl-multiplexer.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Generic pinctrl device for on-board MUX Chips

maintainers:
  - Frank Li <Frank.Li@nxp.com>

description:
  Generic pinctrl device for on-board MUX Chips, which switch SoC signals
  between different peripherals (e.g. MMC and UART).

  The MUX select lines are often driven by a I2C GPIO expander.

properties:
  compatible:
    const: pinctrl-multiplexer

patternProperties:
  '-grp$':
    type: object
    additionalProperties: false
    properties:
      mux-states:
        maxItems: 1

    required:
      - mux-states

required:
  - compatible

allOf:
  - $ref: pinctrl.yaml#

unevaluatedProperties: false

examples:
  - |
    pinctrl-mux {
        compatible = "pinctrl-multiplexer";

        uart-grp {
            mux-states = <&mux 0>;
        };

        spi-grp {
            mux-states = <&mux 1>;
        };

        i2c-grp {
            mux-states = <&mux 2>;
        };
    };