Re: [PATCH v2] PM / devfreq: Add support for QCOM devfreq firmware

[Saravana Kannan <skannan@codeaurora.org>]

On 05/22/2018 11:08 AM, Rob Herring wrote:
> On Fri, May 18, 2018 at 12:52:40AM -0700, Saravana Kannan wrote:
>> The firmware present in some QCOM chipsets offloads the steps necessary for
>> changing the frequency of some devices (Eg: L3). This driver implements the
>> devfreq interface for this firmware so that various governors could be used
>> to scale the frequency of these devices.
>>
>> Each client (say cluster 0 and cluster 1) that wants to vote for a
>> particular device's frequency (say, L3 frequency) is represented as a
>> separate voter device (qcom,devfreq-fw-voter) that's a child of the
>> firmware device (qcom,devfreq-fw).
>>
>> Signed-off-by: Saravana Kannan <skannan@codeaurora.org>
>> ---
>>   .../bindings/devfreq/devfreq-qcom-fw.txt           |  41 +++
>>   drivers/devfreq/Kconfig                            |  14 +
>>   drivers/devfreq/Makefile                           |   1 +
>>   drivers/devfreq/devfreq_qcom_fw.c                  | 330 +++++++++++++++++++++
>>   4 files changed, 386 insertions(+)
>>   create mode 100644 Documentation/devicetree/bindings/devfreq/devfreq-qcom-fw.txt
>>   create mode 100644 drivers/devfreq/devfreq_qcom_fw.c
>>
>> diff --git a/Documentation/devicetree/bindings/devfreq/devfreq-qcom-fw.txt b/Documentation/devicetree/bindings/devfreq/devfreq-qcom-fw.txt
>> new file mode 100644
>> index 0000000..f882a0b
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/devfreq/devfreq-qcom-fw.txt
>> @@ -0,0 +1,41 @@
>> +QCOM Devfreq firmware device
>> +
>> +Some Qualcomm Technologies, Inc. (QTI) chipsets have a firmware that
>> +offloads the steps for frequency switching. It provides a table of
>> +supported frequencies and a register to request one of the supported
>> +freqencies.
>> +
>> +The qcom,devfreq-fw represents this firmware as a device. Sometimes,
>> +multiple entities want to vote on the frequency request that is sent to the
>> +firmware. The qcom,devfreq-fw-voter represents these voters as child
>> +devices of the corresponding qcom,devfreq-fw device.
>> +
>> +Required properties:
>> +- compatible:		Must be "qcom,devfreq-fw" or "qcom,devfreq-fw-voter"
>
> No versions of firmware?

Sure, I can add a v1. Right now the interface has always been identical. 
I thought if it changed in the future I'll add -v2.

>
>> +Only for qcom,devfreq-fw:
>> +- reg:			Pairs of physical base addresses and region sizes of
>> +			memory mapped registers.
>
> Registers? Is this firmware or h/w block?

It's a HW block that has its own firmware.

>
>> +- reg-names:		Names of the bases for the above registers.
>> +			Required register regions are:
>> +			- "en-base": address of register to check if the
>> +			  firmware is enabled.
>> +			- "ftbl-base": address region for the frequency
>> +			  table.
>> +			- "perf-base": address of register to request a
>> +			  frequency.
>> +
>> +Example:
>> +
>> +	qcom,devfreq-l3 {
>> +		compatible = "qcom,devfreq-fw";
>> +		reg-names = "en-base", "ftbl-base", "perf-base";
>> +		reg = <0x18321000 0x4>, <0x18321110 0x600>, <0x18321920 0x4>;
>> +
>> +		qcom,cpu0-l3 {
>> +			compatible = "qcom,devfreq-fw-voter";
>
> There's no point in these nodes. They don't have any properties or
> resources.

These nodes decide how many voters this device supports. Each voter 
would be a devfreq node that will have its own governor set. For 
example, one of them would use this governor:
http://lkml.iu.edu/hypermail/linux/kernel/1805.2/02474.html

You can also attach different devfreq-event devices to each one of these 
voter devices based on what events you want to use for scaling each 
voter. So, the devices are definitely needed in the larger context.

Thanks,
Saravana

-- 
Qualcomm Innovation Center, Inc.
The Qualcomm Innovation Center, Inc. is a member of Code Aurora Forum,
a Linux Foundation Collaborative Project