Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   1) Qualcomm Resource Power Manager (RPM)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   2) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   3) This driver is used to interface with the Resource Power Manager (RPM) found in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   4) various Qualcomm platforms. The RPM allows each component in the system to vote
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   5) for state of the system resources, such as clocks, regulators and bus
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   6) frequencies.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   7) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   8) - compatible:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   9) 	Usage: required
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  10) 	Value type: <string>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  11) 	Definition: must be one of:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  12) 		    "qcom,rpm-apq8064"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  13) 		    "qcom,rpm-msm8660"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  14) 		    "qcom,rpm-msm8960"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  15) 		    "qcom,rpm-ipq8064"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  16) 		    "qcom,rpm-mdm9615"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  17) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  18) - reg:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  19) 	Usage: required
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  20) 	Value type: <prop-encoded-array>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  21) 	Definition: base address and size of the RPM's message ram
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  22) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  23) - interrupts:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  24) 	Usage: required
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  25) 	Value type: <prop-encoded-array>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  26) 	Definition: three entries specifying the RPM's:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  27) 		    1. acknowledgement interrupt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  28) 		    2. error interrupt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  29) 		    3. wakeup interrupt
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  30) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  31) - interrupt-names:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  32) 	Usage: required
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  33) 	Value type: <string-array>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  34) 	Definition: must be the three strings "ack", "err" and "wakeup", in order
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  35) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  36) - qcom,ipc:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  37) 	Usage: required
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  38) 	Value type: <prop-encoded-array>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  39) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  40) 	Definition: three entries specifying the outgoing ipc bit used for
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  41) 		    signaling the RPM:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  42) 		    - phandle to a syscon node representing the apcs registers
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  43) 		    - u32 representing offset to the register within the syscon
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  44) 		    - u32 representing the ipc bit within the register
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  45) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  46) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  47) = SUBNODES
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  48) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  49) The RPM exposes resources to its subnodes. The below bindings specify the set
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  50) of valid subnodes that can operate on these resources.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  51) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  52) == Regulators
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  53) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  54) Regulator nodes are identified by their compatible:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  55) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  56) - compatible:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  57) 	Usage: required
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  58) 	Value type: <string>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  59) 	Definition: must be one of:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  60) 		    "qcom,rpm-pm8058-regulators"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  61) 		    "qcom,rpm-pm8901-regulators"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  62) 		    "qcom,rpm-pm8921-regulators"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  63) 		    "qcom,rpm-pm8018-regulators"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  64) 		    "qcom,rpm-smb208-regulators"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  65) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  66) - vdd_l0_l1_lvs-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  67) - vdd_l2_l11_l12-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  68) - vdd_l3_l4_l5-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  69) - vdd_l6_l7-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  70) - vdd_l8-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  71) - vdd_l9-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  72) - vdd_l10-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  73) - vdd_l13_l16-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  74) - vdd_l14_l15-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  75) - vdd_l17_l18-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  76) - vdd_l19_l20-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  77) - vdd_l21-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  78) - vdd_l22-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  79) - vdd_l23_l24_l25-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  80) - vdd_ncp-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  81) - vdd_s0-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  82) - vdd_s1-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  83) - vdd_s2-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  84) - vdd_s3-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  85) - vdd_s4-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  86) 	Usage: optional (pm8058 only)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  87) 	Value type: <phandle>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  88) 	Definition: reference to regulator supplying the input pin, as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  89) 		    described in the data sheet
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  90) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  91) - lvs0_in-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  92) - lvs1_in-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  93) - lvs2_in-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  94) - lvs3_in-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  95) - mvs_in-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  96) - vdd_l0-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  97) - vdd_l1-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  98) - vdd_l2-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  99) - vdd_l3-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) - vdd_l4-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) - vdd_l5-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) - vdd_l6-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) - vdd_s0-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) - vdd_s1-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) - vdd_s2-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) - vdd_s3-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) - vdd_s4-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) 	Usage: optional (pm8901 only)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) 	Value type: <phandle>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) 	Definition: reference to regulator supplying the input pin, as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) 		    described in the data sheet
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) - vdd_l1_l2_l12_l18-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) - vdd_l3_l15_l17-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) - vdd_l4_l14-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) - vdd_l5_l8_l16-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) - vdd_l6_l7-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) - vdd_l9_l11-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) - vdd_l10_l22-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) - vdd_l21_l23_l29-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) - vdd_l24-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) - vdd_l25-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) - vdd_l26-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) - vdd_l27-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) - vdd_l28-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) - vdd_ncp-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) - vdd_s1-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) - vdd_s2-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) - vdd_s4-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) - vdd_s5-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) - vdd_s6-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) - vdd_s7-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) - vdd_s8-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) - vin_5vs-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) - vin_lvs1_3_6-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) - vin_lvs2-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) - vin_lvs4_5_7-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) 	Usage: optional (pm8921 only)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) 	Value type: <phandle>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) 	Definition: reference to regulator supplying the input pin, as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) 		    described in the data sheet
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) - vin_lvs1-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) - vdd_l7-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) - vdd_l8-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) - vdd_l9_l10_l11_l12-supply:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) 	Usage: optional (pm8018 only)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) 	Value type: <phandle>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) 	Definition: reference to regulator supplying the input pin, as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) 		    described in the data sheet
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) The regulator node houses sub-nodes for each regulator within the device. Each
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) sub-node is identified using the node's name, with valid values listed for each
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) of the pmics below.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) pm8058:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) 	l0, l1, l2, l3, l4, l5, l6, l7, l8, l9, l10, l11, l12, l13, l14, l15,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) 	l16, l17, l18, l19, l20, l21, l22, l23, l24, l25, s0, s1, s2, s3, s4,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) 	lvs0, lvs1, ncp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) pm8901:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) 	l0, l1, l2, l3, l4, l5, l6, s0, s1, s2, s3, s4, lvs0, lvs1, lvs2, lvs3,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) 	mvs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) pm8921:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) 	s1, s2, s3, s4, s7, s8, l1, l2, l3, l4, l5, l6, l7, l8, l9, l10, l11,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) 	l12, l14, l15, l16, l17, l18, l21, l22, l23, l24, l25, l26, l27, l28,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) 	l29, lvs1, lvs2, lvs3, lvs4, lvs5, lvs6, lvs7, usb-switch, hdmi-switch,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) 	ncp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) pm8018:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) 	s1, s2, s3, s4, s5, , l1, l2, l3, l4, l5, l6, l7, l8, l9, l10, l11,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) 	l12, l14, lvs1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) smb208:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) 	s1a, s1b, s2a, s2b
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) The content of each sub-node is defined by the standard binding for regulators -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) see regulator.txt - with additional custom properties described below:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) === Switch-mode Power Supply regulator custom properties
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) - bias-pull-down:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) 	Usage: optional
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) 	Value type: <empty>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) 	Definition: enable pull down of the regulator when inactive
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) - qcom,switch-mode-frequency:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) 	Usage: required
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) 	Value type: <u32>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) 	Definition: Frequency (Hz) of the switch-mode power supply;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) 		    must be one of:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193) 		    19200000, 9600000, 6400000, 4800000, 3840000, 3200000,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) 		    2740000, 2400000, 2130000, 1920000, 1750000, 1600000,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195) 		    1480000, 1370000, 1280000, 1200000
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197) - qcom,force-mode:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198) 	Usage: optional (default if no other qcom,force-mode is specified)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) 	Value type: <u32>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) 	Definition: indicates that the regulator should be forced to a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) 		   particular mode, valid values are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) 		   QCOM_RPM_FORCE_MODE_NONE - do not force any mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) 		   QCOM_RPM_FORCE_MODE_LPM - force into low power mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) 		   QCOM_RPM_FORCE_MODE_HPM - force into high power mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) 		   QCOM_RPM_FORCE_MODE_AUTO - allow regulator to automatically
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) 					      select its own mode based on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207) 					      realtime current draw, only for:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208) 					      pm8921 smps and ftsmps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210) - qcom,power-mode-hysteretic:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) 	Usage: optional
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212) 	Value type: <empty>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213) 	Definition: select that the power supply should operate in hysteretic
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) 		    mode, instead of the default pwm mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) === Low-dropout regulator custom properties
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218) - bias-pull-down:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219) 	Usage: optional
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220) 	Value type: <empty>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) 	Definition: enable pull down of the regulator when inactive
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 222) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 223) - qcom,force-mode:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 224) 	Usage: optional
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 225) 	Value type: <u32>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 226) 	Definition: indicates that the regulator should not be forced to any
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 227) 		   particular mode, valid values are:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 228) 		   QCOM_RPM_FORCE_MODE_NONE - do not force any mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 229) 		   QCOM_RPM_FORCE_MODE_LPM - force into low power mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 230) 		   QCOM_RPM_FORCE_MODE_HPM - force into high power mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 231) 		   QCOM_RPM_FORCE_MODE_BYPASS - set regulator to use bypass
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 232) 						mode, i.e.  to act as a switch
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 233) 						and not regulate, only for:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 234) 						pm8921 pldo, nldo and nldo1200
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 235) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 236) === Negative Charge Pump custom properties
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 237) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 238) - qcom,switch-mode-frequency:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 239) 	Usage: required
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 240) 	Value type: <u32>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 241) 	Definition: Frequency (Hz) of the switch mode power supply;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 242) 		    must be one of:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 243) 		    19200000, 9600000, 6400000, 4800000, 3840000, 3200000,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 244) 		    2740000, 2400000, 2130000, 1920000, 1750000, 1600000,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 245) 		    1480000, 1370000, 1280000, 1200000
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 246) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 247) = EXAMPLE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 248) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 249) 	#include <dt-bindings/mfd/qcom-rpm.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 250) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 251) 	rpm@108000 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 252) 		compatible = "qcom,rpm-msm8960";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 253) 		reg = <0x108000 0x1000>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 254) 		qcom,ipc = <&apcs 0x8 2>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 255) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 256) 		interrupts = <0 19 0>, <0 21 0>, <0 22 0>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 257) 		interrupt-names = "ack", "err", "wakeup";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 258) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 259) 		regulators {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 260) 			compatible = "qcom,rpm-pm8921-regulators";
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 261) 			vdd_l1_l2_l12_l18-supply = <&pm8921_s4>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 262) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 263) 			s1 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 264) 				regulator-min-microvolt = <1225000>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 265) 				regulator-max-microvolt = <1225000>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 266) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 267) 				bias-pull-down;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 268) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 269) 				qcom,switch-mode-frequency = <3200000>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 270) 			};
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 271) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 272) 			pm8921_s4: s4 {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 273) 				regulator-min-microvolt = <1800000>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 274) 				regulator-max-microvolt = <1800000>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 275) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 276) 				qcom,switch-mode-frequency = <1600000>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 277) 				bias-pull-down;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 278) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 279) 				qcom,force-mode = <QCOM_RPM_FORCE_MODE_AUTO>;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 280) 			};
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 281) 		};
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 282) 	};
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 283)