Documentation/devicetree/bindings/pinctrl/bitmain,bm1880-pinctrl.yaml

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

title: Bitmain BM1880 Pin Controller

maintainers:
  - Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>

properties:
  compatible:
    const: bitmain,bm1880-pinctrl

  reg:
    maxItems: 1

additionalProperties:
  description: A pin configuration node.
  type: object
  additionalProperties: false

  properties:
    pinmux:
      type: object
      description: Pin multiplexing parameters.
      allOf:
        - $ref: /schemas/pinctrl/pincfg-node.yaml#
        - $ref: /schemas/pinctrl/pinmux-node.yaml#
      additionalProperties: false

      properties:
        pins:
          items:
            pattern: '^MIO[0-9]+$'

        groups:
          items:
            enum: [
              nand_grp, spi_grp, emmc_grp, sdio_grp, eth0_grp, pwm0_grp,
              pwm1_grp, pwm2_grp, pwm3_grp, pwm4_grp, pwm5_grp, pwm6_grp,
              pwm7_grp, pwm8_grp, pwm9_grp, pwm10_grp, pwm11_grp, pwm12_grp,
              pwm13_grp, pwm14_grp, pwm15_grp, pwm16_grp, pwm17_grp,
              pwm18_grp, pwm19_grp, pwm20_grp, pwm21_grp, pwm22_grp,
              pwm23_grp, pwm24_grp, pwm25_grp, pwm26_grp, pwm27_grp,
              pwm28_grp, pwm29_grp, pwm30_grp, pwm31_grp, pwm32_grp,
              pwm33_grp, pwm34_grp, pwm35_grp, pwm36_grp, i2c0_grp,
              i2c1_grp, i2c2_grp, i2c3_grp, i2c4_grp, uart0_grp, uart1_grp,
              uart2_grp, uart3_grp, uart4_grp, uart5_grp, uart6_grp,
              uart7_grp, uart8_grp, uart9_grp, uart10_grp, uart11_grp,
              uart12_grp, uart13_grp, uart14_grp, uart15_grp, gpio0_grp,
              gpio1_grp, gpio2_grp, gpio3_grp, gpio4_grp, gpio5_grp,
              gpio6_grp, gpio7_grp, gpio8_grp, gpio9_grp, gpio10_grp,
              gpio11_grp, gpio12_grp, gpio13_grp, gpio14_grp, gpio15_grp,
              gpio16_grp, gpio17_grp, gpio18_grp, gpio19_grp, gpio20_grp,
              gpio21_grp, gpio22_grp, gpio23_grp, gpio24_grp, gpio25_grp,
              gpio26_grp, gpio27_grp, gpio28_grp, gpio29_grp, gpio30_grp,
              gpio31_grp, gpio32_grp, gpio33_grp, gpio34_grp, gpio35_grp,
              gpio36_grp, gpio37_grp, gpio38_grp, gpio39_grp, gpio40_grp,
              gpio41_grp, gpio42_grp, gpio43_grp, gpio44_grp, gpio45_grp,
              gpio46_grp, gpio47_grp, gpio48_grp, gpio49_grp, gpio50_grp,
              gpio51_grp, gpio52_grp, gpio53_grp, gpio54_grp, gpio55_grp,
              gpio56_grp, gpio57_grp, gpio58_grp, gpio59_grp, gpio60_grp,
              gpio61_grp, gpio62_grp, gpio63_grp, gpio64_grp, gpio65_grp,
              gpio66_grp, gpio67_grp, eth1_grp, i2s0_grp, i2s0_mclkin_grp,
              i2s1_grp, i2s1_mclkin_grp, spi0_grp
            ]

        function:
          items:
            enum: [
              nand, spi, emmc, sdio, eth0, pwm0, pwm1, pwm2, pwm3, pwm4,
              pwm5, pwm6, pwm7, pwm8, pwm9, pwm10, pwm11, pwm12, pwm13,
              pwm14, pwm15, pwm16, pwm17, pwm18, pwm19, pwm20, pwm21, pwm22,
              pwm23, pwm24, pwm25, pwm26, pwm27, pwm28, pwm29, pwm30, pwm31,
              pwm32, pwm33, pwm34, pwm35, pwm36, i2c0, i2c1, i2c2, i2c3,
              i2c4, uart0, uart1, uart2, uart3, uart4, uart5, uart6, uart7,
              uart8, uart9, uart10, uart11, uart12, uart13, uart14, uart15,
              gpio0, gpio1, gpio2, gpio3, gpio4, gpio5, gpio6, gpio7, gpio8,
              gpio9, gpio10, gpio11, gpio12, gpio13, gpio14, gpio15, gpio16,
              gpio17, gpio18, gpio19, gpio20, gpio21, gpio22, gpio23,
              gpio24, gpio25, gpio26, gpio27, gpio28, gpio29, gpio30,
              gpio31, gpio32, gpio33, gpio34, gpio35, gpio36, gpio37,
              gpio38, gpio39, gpio40, gpio41, gpio42, gpio43, gpio44,
              gpio45, gpio46, gpio47, gpio48, gpio49, gpio50, gpio51,
              gpio52, gpio53, gpio54, gpio55, gpio56, gpio57, gpio58,
              gpio59, gpio60, gpio61, gpio62, gpio63, gpio64, gpio65,
              gpio66, gpio67, eth1, i2s0, i2s0_mclkin, i2s1, i2s1_mclkin,
              spi0
            ]

        bias-disable: true
        bias-pull-down: true
        bias-pull-up: true
        input-schmitt-enable: true
        input-schmitt-disable: true

        slew-rate:
          description: >
            Sets slew rate. Valid values: 0 = Slow, 1 = Fast.
          enum: [0, 1]

        drive-strength:
          enum: [4, 8, 12, 16, 20, 24, 28, 32]

      oneOf:
        - required:
            - pins
        - required:
            - groups

      required:
        - function

required:
  - compatible
  - reg

examples:
  - |
    pinctrl@400 {
        compatible = "bitmain,bm1880-pinctrl";
        reg = <0x400 0x120>;

        uart0-default {
            pinmux {
                groups = "uart0_grp";
                function = "uart0";
            };
        };
    };