Documentation/devicetree/bindings/pinctrl/fsl,imx8ulp-pinctrl.yaml

   1 # SPDX-License-Identifier: GPL-2.0
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/pinctrl/fsl,imx8ulp-pinctrl.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Freescale IMX8ULP IOMUX Controller
   8
   9 maintainers:
  10   - Jacky Bai <ping.bai@nxp.com>
  11
  12 description:
  13   Please refer to fsl,imx-pinctrl.txt and pinctrl-bindings.txt in this directory
  14   for common binding part and usage.
  15
  16 properties:
  17   compatible:
  18     const: fsl,imx8ulp-iomuxc1
  19
  20   reg:
  21     maxItems: 1
  22
  23 # Client device subnode's properties
  24 patternProperties:
  25   'grp$':
  26     type: object
  27     description:
  28       Pinctrl node's client devices use subnodes for desired pin configuration.
  29       Client device subnodes use below standard properties.
  30
  31     properties:
  32       fsl,pins:
  33         description:
  34           each entry consists of 5 integers and represents the mux and config
  35           setting for one pin. The first 4 integers <mux_config_reg input_reg
  36           mux_mode input_val> are specified using a PIN_FUNC_ID macro, which can
  37           be found in <arch/arm64/boot/dts/freescale/imx8ulp-pinfunc.h>. The last
  38           integer CONFIG is the pad setting value like pull-up on this pin. Please
  39           refer to i.MX8ULP Reference Manual for detailed CONFIG settings.
  40         $ref: /schemas/types.yaml#/definitions/uint32-matrix
  41         items:
  42           items:
  43             - description: |
  44                 "mux_config_reg" indicates the offset of mux register.
  45             - description: |
  46                 "input_reg" indicates the offset of select input register.
  47             - description: |
  48                 "mux_mode" indicates the mux value to be applied.
  49             - description: |
  50                 "input_val" indicates the select input value to be applied.
  51             - description: |
  52                 "pad_setting" indicates the pad configuration value to be applied.
  53
  54     required:
  55       - fsl,pins
  56
  57     additionalProperties: false
  58
  59 required:
  60   - compatible
  61   - reg
  62
  63 additionalProperties: false
  64
  65 examples:
  66   # Pinmux controller node
  67   - |
  68     iomuxc: pinctrl@298c0000 {
  69         compatible = "fsl,imx8ulp-iomuxc1";
  70         reg = <0x298c0000 0x10000>;
  71
  72         pinctrl_lpuart5: lpuart5grp {
  73             fsl,pins =
  74                 <0x0138 0x08F0 0x4 0x3  0x3>,
  75                 <0x013C 0x08EC 0x4 0x3  0x3>;
  76         };
  77     };
  78
  79 ...