xref: /freebsd/sys/contrib/device-tree/Bindings/pinctrl/fsl,imx7d-pinctrl.txt (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
1* Freescale i.MX7 Dual IOMUX Controller
2
3iMX7D supports two iomuxc controllers, fsl,imx7d-iomuxc controller is similar
4as previous iMX SoC generation and fsl,imx7d-iomuxc-lpsr which provides low
5power state retention capabilities on gpios that are part of iomuxc-lpsr
6(GPIO1_IO7..GPIO1_IO0). While iomuxc-lpsr provides its own set of registers for
7mux and pad control settings, it shares the input select register from main
8iomuxc controller for daisy chain settings, the fsl,input-sel property extends
9fsl,imx-pinctrl driver to support iomuxc-lpsr controller.
10
11iomuxc_lpsr: iomuxc-lpsr@302c0000 {
12	compatible = "fsl,imx7d-iomuxc-lpsr";
13	reg = <0x302c0000 0x10000>;
14	fsl,input-sel = <&iomuxc>;
15};
16
17iomuxc: iomuxc@30330000 {
18	compatible = "fsl,imx7d-iomuxc";
19	reg = <0x30330000 0x10000>;
20};
21
22Peripherals using pads from iomuxc-lpsr support low state retention power
23state, under LPSR mode GPIO's state of pads are retain.
24
25Please refer to fsl,imx-pinctrl.txt in this directory for common binding part
26and usage.
27
28Required properties:
29- compatible: "fsl,imx7d-iomuxc" for main IOMUXC controller, or
30  "fsl,imx7d-iomuxc-lpsr" for Low Power State Retention IOMUXC controller.
31- fsl,pins: each entry consists of 6 integers and represents the mux and config
32  setting for one pin.  The first 5 integers <mux_reg conf_reg input_reg mux_val
33  input_val> are specified using a PIN_FUNC_ID macro, which can be found in
34  imx7d-pinfunc.h under device tree source folder.  The last integer CONFIG is
35  the pad setting value like pull-up on this pin.  Please refer to i.MX7 Dual
36  Reference Manual for detailed CONFIG settings.
37- fsl,input-sel: required property for iomuxc-lpsr controller, this property is
38  a phandle for main iomuxc controller which shares the input select register for
39  daisy chain settings.
40
41CONFIG bits definition:
42PAD_CTL_PUS_100K_DOWN           (0 << 5)
43PAD_CTL_PUS_5K_UP               (1 << 5)
44PAD_CTL_PUS_47K_UP              (2 << 5)
45PAD_CTL_PUS_100K_UP             (3 << 5)
46PAD_CTL_PUE                     (1 << 4)
47PAD_CTL_HYS                     (1 << 3)
48PAD_CTL_SRE_SLOW                (1 << 2)
49PAD_CTL_SRE_FAST                (0 << 2)
50PAD_CTL_DSE_X1                  (0 << 0)
51PAD_CTL_DSE_X4                  (1 << 0)
52PAD_CTL_DSE_X2                  (2 << 0)
53PAD_CTL_DSE_X6                  (3 << 0)
54
55Examples:
56While iomuxc-lpsr is intended to be used by dedicated peripherals to take
57advantages of LPSR power mode, is also possible that an IP to use pads from
58any of the iomux controllers. For example the I2C1 IP can use SCL pad from
59iomuxc-lpsr controller and SDA pad from iomuxc controller as:
60
61i2c1: i2c@30a20000 {
62	pinctrl-names = "default";
63	pinctrl-0 = <&pinctrl_i2c1_1>, <&pinctrl_i2c1_2>;
64};
65
66iomuxc-lpsr@302c0000 {
67	compatible = "fsl,imx7d-iomuxc-lpsr";
68	reg = <0x302c0000 0x10000>;
69	fsl,input-sel = <&iomuxc>;
70
71	pinctrl_i2c1_1: i2c1grp-1 {
72		fsl,pins = <
73			MX7D_PAD_GPIO1_IO04__I2C1_SCL 0x4000007f
74		>;
75	};
76};
77
78iomuxc@30330000 {
79	compatible = "fsl,imx7d-iomuxc";
80	reg = <0x30330000 0x10000>;
81
82	pinctrl_i2c1_2: i2c1grp-2 {
83		fsl,pins = <
84			MX7D_PAD_I2C1_SDA__I2C1_SDA 0x4000007f
85		>;
86	};
87};
88