nexell,s5pxx18-pinctrl.txt 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. Binding for Nexell s5pxx18 pin cotroller
  2. ========================================
  3. Nexell's ARM bases SoC's integrates a GPIO and Pin mux/config hardware
  4. controller. It controls the input/output settings on the available pads/pins
  5. and also provides ability to multiplex and configure the output of various
  6. on-chip controllers onto these pads.
  7. Please refer to pinctrl-bindings.txt in this directory for details of the
  8. common pinctrl bindings used by client devices, including the meaning of the
  9. phrase "pin configuration node".
  10. Required properties:
  11. - compatible: "nexell,s5pxx18-pinctrl"
  12. - reg: should be register base and length as documented in the datasheet
  13. - interrupts: interrupt specifier for the controller over gpio and alive pins
  14. Example:
  15. pinctrl_0: pinctrl@c0010000 {
  16. compatible = "nexell,s5pxx18-pinctrl";
  17. reg = <0xc0010000 0xf000>;
  18. u-boot,dm-pre-reloc;
  19. };
  20. Nexell's pin configuration nodes act as a container for an arbitrary number of
  21. subnodes. Each of these subnodes represents some desired configuration for a
  22. pin, a group, or a list of pins or groups. This configuration can include the
  23. mux function to select on those pin(s)/group(s), and various pin configuration
  24. parameters.
  25. Child nodes must be set at least one of the following settings:
  26. - pins = Select pins for using this function.
  27. - pin-function = Select the function for use in a selected pin.
  28. - pin-pull = Pull up/down configuration.
  29. - pin-strength = Drive strength configuration.
  30. Valid values for nexell,pins are:
  31. "gpioX-N" : X in {A,B,C,D,E}, N in {0-31}
  32. Valid values for nexell,pin-function are:
  33. "N" : N in {0-3}.
  34. This setting means that the value is different for each pin.
  35. Please refer to datasheet.
  36. Valid values for nexell,pin-pull are:
  37. "N" : 0 - Down, 1 - Up, 2 - Off
  38. Valid values for nexell,pin-strength are:
  39. "N" : 0,1,2,3
  40. Example:
  41. - pin settings
  42. mmc0_clk: mmc0-clk {
  43. pins = "gpioa-29";
  44. pin-function = <1>;
  45. pin-pull = <2>;
  46. pin-strength = <2>;
  47. };
  48. mmc0_cmd: mmc0-cmd {
  49. pins = "gpioa-31";
  50. pin-function = <1>;
  51. pin-pull = <2>;
  52. pin-strength = <1>;
  53. };
  54. mmc0_bus4: mmc0-bus-width4 {
  55. pins = "gpiob-1, gpiob-3, gpiob-5, gpiob-7";
  56. pin-function = <1>;
  57. pin-pull = <2>;
  58. pin-strength = <1>;
  59. };
  60. - used by client devices
  61. mmc0:mmc@... {
  62. pinctrl-names = "default";
  63. pinctrl-0 = <&mmc0_clk>, <&mmc0_cmd>, <&mmc0_bus4>;
  64. ...
  65. };