forked from torvalds/linux
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
dt-bindings: cpufreq: apple,soc-cpufreq: Add binding for Apple SoC cp…
…ufreq This binding represents the cpufreq/DVFS hardware present in Apple SoCs. The hardware has an independent controller per CPU cluster, but we represent them as a single cpufreq node since there can only be one systemwide cpufreq device (and since in the future, interactions with memory controller performance states will also involve cooperation between multiple frequency domains). Signed-off-by: Hector Martin <marcan@marcan.st>
- Loading branch information
Showing
1 changed file
with
121 additions
and
0 deletions.
There are no files selected for viewing
121 changes: 121 additions & 0 deletions
121
Documentation/devicetree/bindings/cpufreq/apple,soc-cpufreq.yaml
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,121 @@ | ||
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause | ||
%YAML 1.2 | ||
--- | ||
$id: http://devicetree.org/schemas/cpufreq/apple,soc-cpufreq.yaml# | ||
$schema: http://devicetree.org/meta-schemas/core.yaml# | ||
|
||
title: Apple SoC cpufreq device | ||
|
||
maintainers: | ||
- Hector Martin <marcan@marcan.st> | ||
|
||
description: | | ||
Apple SoCs (e.g. M1) have a per-cpu-cluster DVFS controller that is part of | ||
the cluster management register block. This binding uses the standard | ||
operating-points-v2 table to define the CPU performance states, with the | ||
opp-level property specifying the hardware p-state index for that level. | ||
properties: | ||
compatible: | ||
items: | ||
- enum: | ||
- apple,t8103-soc-cpufreq | ||
- apple,t6000-soc-cpufreq | ||
- const: apple,soc-cpufreq | ||
|
||
reg: | ||
minItems: 1 | ||
maxItems: 6 | ||
description: One register region per CPU cluster DVFS controller | ||
|
||
reg-names: | ||
minItems: 1 | ||
items: | ||
- const: cluster0 | ||
- const: cluster1 | ||
- const: cluster2 | ||
- const: cluster3 | ||
- const: cluster4 | ||
- const: cluster5 | ||
|
||
'#freq-domain-cells': | ||
const: 1 | ||
|
||
required: | ||
- compatible | ||
- reg | ||
- reg-names | ||
- '#freq-domain-cells' | ||
|
||
additionalProperties: false | ||
|
||
examples: | ||
- | | ||
// This example shows a single CPU per domain and 2 domains, | ||
// with two p-states per domain. | ||
// Shipping hardware has 2-4 CPUs per domain and 2-6 domains. | ||
cpus { | ||
#address-cells = <2>; | ||
#size-cells = <0>; | ||
cpu@0 { | ||
compatible = "apple,icestorm"; | ||
device_type = "cpu"; | ||
reg = <0x0 0x0>; | ||
operating-points-v2 = <&ecluster_opp>; | ||
apple,freq-domain = <&cpufreq_hw 0>; | ||
}; | ||
cpu@10100 { | ||
compatible = "apple,firestorm"; | ||
device_type = "cpu"; | ||
reg = <0x0 0x10100>; | ||
operating-points-v2 = <&pcluster_opp>; | ||
apple,freq-domain = <&cpufreq_hw 1>; | ||
}; | ||
}; | ||
ecluster_opp: opp-table-0 { | ||
compatible = "operating-points-v2"; | ||
opp-shared; | ||
opp01 { | ||
opp-hz = /bits/ 64 <600000000>; | ||
opp-level = <1>; | ||
clock-latency-ns = <7500>; | ||
}; | ||
opp02 { | ||
opp-hz = /bits/ 64 <972000000>; | ||
opp-level = <2>; | ||
clock-latency-ns = <22000>; | ||
}; | ||
}; | ||
pcluster_opp: opp-table-1 { | ||
compatible = "operating-points-v2"; | ||
opp-shared; | ||
opp01 { | ||
opp-hz = /bits/ 64 <600000000>; | ||
opp-level = <1>; | ||
clock-latency-ns = <8000>; | ||
}; | ||
opp02 { | ||
opp-hz = /bits/ 64 <828000000>; | ||
opp-level = <2>; | ||
clock-latency-ns = <19000>; | ||
}; | ||
}; | ||
soc { | ||
#address-cells = <2>; | ||
#size-cells = <2>; | ||
cpufreq_hw: cpufreq@210e20000 { | ||
compatible = "apple,t8103-soc-cpufreq", "apple,soc-cpufreq"; | ||
reg = <0x2 0x10e20000 0 0x1000>, | ||
<0x2 0x11e20000 0 0x1000>; | ||
reg-names = "cluster0", "cluster1"; | ||
#freq-domain-cells = <1>; | ||
}; | ||
}; |