[PATCH] Doc: dt: arch_timer: discourage clock-frequency use
From: catalin.marinas@arm.com (Catalin Marinas)
Date: 2014-08-29 10:10:39
On Thu, Aug 28, 2014 at 07:37:04PM +0100, Mark Rutland wrote:
The ARM Generic Timer (AKA the architected timer, arm_arch_timer) features a CPU register (CNTFRQ) which firmware is intended to initialize, and non-secure software can read to determine the frequency of the timer. On CPUs with secure state, this register cannot be written from non-secure states. The firmware of early SoCs featuring the timer did not correctly initialize CNTFRQ correctly on all CPUs, requiring the frequency to be described in DT as a workaround. This workaround is not complete however as it is exposed to all software in a privileged non-secure mode (including guests running under a hypervisor). The firmware and DTs for recent SoCs have followed the example set by these early SoCs. This patch updates the arch timer binding documentation to make it clearer that the use of the clock-frequency property is a poor work-around. The MMIO generic timer binding is similarly updated, though this is less of a concern as there is generally no need to expose the MMIO timers to guest OSs. Signed-off-by: Mark Rutland <mark.rutland@arm.com> Acked-by: Olof Johansson <redacted> Acked-by: Marc Zyngier <redacted> Cc: Rob Herring <robh+dt@kernel.org> Cc: Stephen Boyd <redacted> Cc: Will Deacon <redacted> Cc: Catalin Marinas <catalin.marinas@arm.com>
Acked-by: Catalin Marinas <catalin.marinas@arm.com>