qcom,wcnss-pil.txt 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132
  1. Qualcomm WCNSS Peripheral Image Loader
  2. This document defines the binding for a component that loads and boots firmware
  3. on the Qualcomm WCNSS core.
  4. - compatible:
  5. Usage: required
  6. Value type: <string>
  7. Definition: must be one of:
  8. "qcom,riva-pil",
  9. "qcom,pronto-v1-pil",
  10. "qcom,pronto-v2-pil"
  11. - reg:
  12. Usage: required
  13. Value type: <prop-encoded-array>
  14. Definition: must specify the base address and size of the CCU, DXE and
  15. PMU register blocks
  16. - reg-names:
  17. Usage: required
  18. Value type: <stringlist>
  19. Definition: must be "ccu", "dxe", "pmu"
  20. - interrupts-extended:
  21. Usage: required
  22. Value type: <prop-encoded-array>
  23. Definition: must list the watchdog and fatal IRQs and may specify the
  24. ready, handover and stop-ack IRQs
  25. - interrupt-names:
  26. Usage: required
  27. Value type: <stringlist>
  28. Definition: should be "wdog", "fatal", optionally followed by "ready",
  29. "handover", "stop-ack"
  30. - vddmx-supply:
  31. - vddcx-supply:
  32. - vddpx-supply:
  33. Usage: required
  34. Value type: <phandle>
  35. Definition: reference to the regulators to be held on behalf of the
  36. booting of the WCNSS core
  37. - qcom,smem-states:
  38. Usage: optional
  39. Value type: <prop-encoded-array>
  40. Definition: reference to the SMEM state used to indicate to WCNSS that
  41. it should shut down
  42. - qcom,smem-state-names:
  43. Usage: optional
  44. Value type: <stringlist>
  45. Definition: should be "stop"
  46. - memory-region:
  47. Usage: required
  48. Value type: <prop-encoded-array>
  49. Definition: reference to reserved-memory node for the remote processor
  50. see ../reserved-memory/reserved-memory.txt
  51. = SUBNODES
  52. A single subnode of the WCNSS PIL describes the attached rf module and its
  53. resource dependencies.
  54. - compatible:
  55. Usage: required
  56. Value type: <string>
  57. Definition: must be one of:
  58. "qcom,wcn3620",
  59. "qcom,wcn3660",
  60. "qcom,wcn3680"
  61. - clocks:
  62. Usage: required
  63. Value type: <prop-encoded-array>
  64. Definition: should specify the xo clock and optionally the rf clock
  65. - clock-names:
  66. Usage: required
  67. Value type: <stringlist>
  68. Definition: should be "xo", optionally followed by "rf"
  69. - vddxo-supply:
  70. - vddrfa-supply:
  71. - vddpa-supply:
  72. - vdddig-supply:
  73. Usage: required
  74. Value type: <phandle>
  75. Definition: reference to the regulators to be held on behalf of the
  76. booting of the WCNSS core
  77. = EXAMPLE
  78. The following example describes the resources needed to boot control the WCNSS,
  79. with attached WCN3680, as it is commonly found on MSM8974 boards.
  80. pronto@fb204000 {
  81. compatible = "qcom,pronto-v2-pil";
  82. reg = <0xfb204000 0x2000>, <0xfb202000 0x1000>, <0xfb21b000 0x3000>;
  83. reg-names = "ccu", "dxe", "pmu";
  84. interrupts-extended = <&intc 0 149 1>,
  85. <&wcnss_smp2p_slave 0 0>,
  86. <&wcnss_smp2p_slave 1 0>,
  87. <&wcnss_smp2p_slave 2 0>,
  88. <&wcnss_smp2p_slave 3 0>;
  89. interrupt-names = "wdog", "fatal", "ready", "handover", "stop-ack";
  90. vddmx-supply = <&pm8841_s1>;
  91. vddcx-supply = <&pm8841_s2>;
  92. vddpx-supply = <&pm8941_s3>;
  93. qcom,smem-states = <&wcnss_smp2p_out 0>;
  94. qcom,smem-state-names = "stop";
  95. memory-region = <&wcnss_region>;
  96. pinctrl-names = "default";
  97. pinctrl-0 = <&wcnss_pin_a>;
  98. iris {
  99. compatible = "qcom,wcn3680";
  100. clocks = <&rpmcc RPM_CXO_CLK_SRC>, <&rpmcc RPM_CXO_A2>;
  101. clock-names = "xo", "rf";
  102. vddxo-supply = <&pm8941_l6>;
  103. vddrfa-supply = <&pm8941_l11>;
  104. vddpa-supply = <&pm8941_l19>;
  105. vdddig-supply = <&pm8941_s3>;
  106. };
  107. };