projects / deliverable / linux.git / blame
| Commit | Line | Data |
|---|---|---|
| ae76f13b BG |
1 | == Amlogic Meson pinmux controller == |
| 2 | ||
| 3 | Required properties for the root node: | |
| 11ca8735 CC |
4 | - compatible: one of "amlogic,meson8-cbus-pinctrl" |
| 5 | "amlogic,meson8b-cbus-pinctrl" | |
| 6 | "amlogic,meson8-aobus-pinctrl" | |
| 7 | "amlogic,meson8b-aobus-pinctrl" | |
| 551a626c CC |
8 | "amlogic,meson-gxbb-periphs-pinctrl" |
| 9 | "amlogic,meson-gxbb-aobus-pinctrl" | |
| ae76f13b BG |
10 | - reg: address and size of registers controlling irq functionality |
| 11 | ||
| 12 | === GPIO sub-nodes === | |
| 13 | ||
| 11ca8735 CC |
14 | The GPIO bank for the controller is represented as a sub-node and it acts as a |
| 15 | GPIO controller. | |
| ae76f13b BG |
16 | |
| 17 | Required properties for sub-nodes are: | |
| 18 | - reg: should contain address and size for mux, pull-enable, pull and | |
| 19 | gpio register sets | |
| 20 | - reg-names: an array of strings describing the "reg" entries. Must | |
| 21 | contain "mux", "pull" and "gpio". "pull-enable" is optional and | |
| 22 | when it is missing the "pull" registers are used instead | |
| 23 | - gpio-controller: identifies the node as a gpio controller | |
| 24 | - #gpio-cells: must be 2 | |
| 25 | ||
| ae76f13b BG |
26 | === Other sub-nodes === |
| 27 | ||
| 28 | Child nodes without the "gpio-controller" represent some desired | |
| 29 | configuration for a pin or a group. Those nodes can be pinmux nodes or | |
| 30 | configuration nodes. | |
| 31 | ||
| 32 | Required properties for pinmux nodes are: | |
| 33 | - groups: a list of pinmux groups. The list of all available groups | |
| 34 | depends on the SoC and can be found in driver sources. | |
| 35 | - function: the name of a function to activate for the specified set | |
| 36 | of groups. The list of all available functions depends on the SoC | |
| 37 | and can be found in driver sources. | |
| 38 | ||
| 39 | Required properties for configuration nodes: | |
| 40 | - pins: a list of pin names | |
| 41 | ||
| 42 | Configuration nodes support the generic properties "bias-disable", | |
| 43 | "bias-pull-up" and "bias-pull-down", described in file | |
| 44 | pinctrl-bindings.txt | |
| 45 | ||
| 46 | === Example === | |
| 47 | ||
| 48 | pinctrl: pinctrl@c1109880 { | |
| 11ca8735 | 49 | compatible = "amlogic,meson8-cbus-pinctrl"; |
| ae76f13b BG |
50 | reg = <0xc1109880 0x10>; |
| 51 | #address-cells = <1>; | |
| 52 | #size-cells = <1>; | |
| 53 | ranges; | |
| 54 | ||
| 55 | gpio: banks@c11080b0 { | |
| 56 | reg = <0xc11080b0 0x28>, | |
| 57 | <0xc11080e8 0x18>, | |
| 58 | <0xc1108120 0x18>, | |
| 59 | <0xc1108030 0x30>; | |
| 60 | reg-names = "mux", "pull", "pull-enable", "gpio"; | |
| 61 | gpio-controller; | |
| 62 | #gpio-cells = <2>; | |
| 63 | }; | |
| 64 | ||
| ae76f13b BG |
65 | nand { |
| 66 | mux { | |
| 67 | groups = "nand_io", "nand_io_ce0", "nand_io_ce1", | |
| 68 | "nand_io_rb0", "nand_ale", "nand_cle", | |
| 69 | "nand_wen_clk", "nand_ren_clk", "nand_dqs", | |
| 70 | "nand_ce2", "nand_ce3"; | |
| 71 | function = "nand"; | |
| 72 | }; | |
| 73 | }; | |
| ae76f13b | 74 | }; |