Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
clk: qcom: clk-rcg2: document calc_rate function
Update calc_rate docs to reflect, that pre_div
is not pure divisor, but a register value, and requires conversion.
Signed-off-by: Dzmitry Sankouski <dsankouski@gmail.com>
Link: https://lore.kernel.org/r/20241118-starqltechn_integration_upstream-v8-1-ac8e36a3aa65@gmail.com
Signed-off-by: Bjorn Andersson <andersson@kernel.org>
authored by
Dzmitry Sankouski
and committed by
Bjorn Andersson
cef0523d
d26c4ad3
+12
-3
+12
-3
drivers/clk/qcom/clk-rcg2.c
+12
-3
drivers/clk/qcom/clk-rcg2.c
···
148
148
return update_config(rcg);
149
149
}
150
150
151
-
/*
152
-
* Calculate m/n:d rate
151
+
/**
152
+
* calc_rate() - Calculate rate based on m/n:d values
153
+
*
154
+
* @rate: Parent rate.
155
+
* @m: Multiplier.
156
+
* @n: Divisor.
157
+
* @mode: Use zero to ignore m/n calculation.
158
+
* @hid_div: Pre divisor register value. Pre divisor value
159
+
* relates to hid_div as pre_div = (hid_div + 1) / 2.
160
+
*
161
+
* Return calculated rate according to formula:
153
162
*
154
163
* parent_rate m
155
164
* rate = ----------- x ---
156
-
* hid_div n
165
+
* pre_div n
157
166
*/
158
167
static unsigned long
159
168
calc_rate(unsigned long rate, u32 m, u32 n, u32 mode, u32 hid_div)