Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: arm: move cpu-capacity to a shared loation

RISC-V uses the same generic topology code as arm64 & while there
currently exists no binding for cpu-capacity on RISC-V, the code paths
can be hit if the property is present.

Move the documentation of cpu-capacity to a shared location, ahead of
defining a binding for capacity-dmips-mhz on RISC-V. Update some
references to this document in the process.

Signed-off-by: Conor Dooley <conor.dooley@microchip.com>
Reviewed-by: Ley Foon Tan <leyfoon.tan@starfivetech.com>
Acked-by: Rob Herring <robh@kernel.org>
Reviewed-by: Yanteng Si <siyanteng@loongson.cn>
Link: https://lore.kernel.org/r/20230104180513.1379453-2-conor@kernel.org
Signed-off-by: Palmer Dabbelt <palmer@rivosinc.com>

authored by

Conor Dooley and committed by
Palmer Dabbelt
7d207831 c1d61058

+5 -5
+2 -2
Documentation/devicetree/bindings/arm/cpu-capacity.txt Documentation/devicetree/bindings/cpu/cpu-capacity.txt
··· 1 1 ========================================== 2 - ARM CPUs capacity bindings 2 + CPU capacity bindings 3 3 ========================================== 4 4 5 5 ========================================== 6 6 1 - Introduction 7 7 ========================================== 8 8 9 - ARM systems may be configured to have cpus with different power/performance 9 + Some systems may be configured to have cpus with different power/performance 10 10 characteristics within the same chip. In this case, additional information has 11 11 to be made available to the kernel for it to be aware of such differences and 12 12 take decisions accordingly.
+1 -1
Documentation/devicetree/bindings/arm/cpus.yaml
··· 257 257 258 258 capacity-dmips-mhz: 259 259 description: 260 - u32 value representing CPU capacity (see ./cpu-capacity.txt) in 260 + u32 value representing CPU capacity (see ../cpu/cpu-capacity.txt) in 261 261 DMIPS/MHz, relative to highest capacity-dmips-mhz 262 262 in the system. 263 263
+1 -1
Documentation/scheduler/sched-capacity.rst
··· 260 260 261 261 The arm and arm64 architectures directly map this to the arch_topology driver 262 262 CPU scaling data, which is derived from the capacity-dmips-mhz CPU binding; see 263 - Documentation/devicetree/bindings/arm/cpu-capacity.txt. 263 + Documentation/devicetree/bindings/cpu/cpu-capacity.txt. 264 264 265 265 3.2 Frequency invariance 266 266 ------------------------
+1 -1
Documentation/translations/zh_CN/scheduler/sched-capacity.rst
··· 233 233 234 234 arm和arm64架构直接把这个信息映射到arch_topology驱动的CPU scaling数据中(译注:参考 235 235 arch_topology.h的percpu变量cpu_scale),它是从capacity-dmips-mhz CPU binding中衍生计算 236 - 出来的。参见Documentation/devicetree/bindings/arm/cpu-capacity.txt。 236 + 出来的。参见Documentation/devicetree/bindings/cpu/cpu-capacity.txt。 237 237 238 238 3.2 频率不变性 239 239 --------------