From patchwork Thu Aug 28 17:03:06 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mark Rutland X-Patchwork-Id: 383975 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 21AF414012E for ; Fri, 29 Aug 2014 03:04:05 +1000 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751608AbaH1RED (ORCPT ); Thu, 28 Aug 2014 13:04:03 -0400 Received: from cam-admin0.cambridge.arm.com ([217.140.96.50]:38622 "EHLO cam-admin0.cambridge.arm.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750862AbaH1REC (ORCPT ); Thu, 28 Aug 2014 13:04:02 -0400 Received: from leverpostej (leverpostej.cambridge.arm.com [10.1.205.151]) by cam-admin0.cambridge.arm.com (8.12.6/8.12.6) with ESMTP id s7SH3Bwo002769; Thu, 28 Aug 2014 18:03:11 +0100 (BST) Date: Thu, 28 Aug 2014 18:03:06 +0100 From: Mark Rutland To: Olof Johansson , marc.zyngier@arm.com Cc: Naveen Krishna Chatradhi , Catalin Marinas , "naveenkrishna.ch@gmail.com" , "linux-arm-kernel@lists.infradead.org" , "linux-samsung-soc@vger.kernel.org" , "devicetree@vger.kernel.org" , "cpgs@samsung.com" , Thomas Abraham , Rob Herring Subject: Re: [PATCH 11/14] arm64: dts: Add initial device tree support for EXYNOS7 Message-ID: <20140828170306.GQ14650@leverpostej> References: <1409132660-1898-1-git-send-email-ch.naveen@samsung.com> <1409132660-1898-3-git-send-email-ch.naveen@samsung.com> <20140828035639.GB4972@localhost> <20140828094846.GD14650@leverpostej> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org On Thu, Aug 28, 2014 at 05:28:22PM +0100, Olof Johansson wrote: > On Thu, Aug 28, 2014 at 2:48 AM, Mark Rutland wrote: > > Hi, > > > >> > + cpus { > >> > + #address-cells = <2>; > >> > + #size-cells = <0>; > >> > >> Why size-cells=2? Can you not fit a cpuid in 32 bits? > > > > As of commit 72aea393a2e7 (arm64: smp: honour #address-size when parsing > > CPU reg property) Linux can handle single-cell cpu node reg entries > > where /cpus/#address-cells = <1>. > > > > I can't make any guarantees about other code (e.g. bootloaders) which > > might try to do things with cpu nodes, YMMV. > > Ok. If address-cells is kept at 2 the unit address needs to be changed > to "0,0". So one or the other has to be changed. I'm happy either way. I'm not sure the rest of the tree had "0," prefixes on all of the unit-addresses for 64-bit addresses that were under 4GB, and I'm not sure that existing dts consistently do that either. Do we want to enforce that for all 64-bit unit-addresses? > > [...] > > > >> > + hsi2c_2: hsi2c@14E60000 { > >> > >> I much prefer lowercase hex in unit addresses (and reg entries) below. I > >> know 32-bit uses uppercase, but let's switch going forward here. > > > > My preference also; I'm happy to enforce that on new dts. > > > > [...] > > > >> > + timer { > >> > + compatible = "arm,armv8-timer"; > >> > + interrupts = <1 13 0xff01>, > >> > + <1 14 0xff01>, > >> > + <1 11 0xff01>, > >> > + <1 10 0xff01>; > >> > + clock-frequency = <24000000>; > >> > + use-clocksource-only; > >> > + use-physical-timer; > >> > >> These two properties are not standard, and I would expect any 64-bit > >> platform to come with PSCI such that you have a way to initialize the > >> virtual timers. > > > > Likewise with clock-frequency. It's not a full workaround, and it's not > > hard to initialise CNTFRQ on each CPU. > > Technically clock-frequency is documented, but not recommended to be > used unless needed for working around firmware that doesn't setup the > register value. :) True. > In this case it's likely a cargo cult carry over from 5250 where the > CNTFRQ requirement happened around the same time as we were working on > it so that generation firmware lacked support for it -- it should > since then have been fixed properly. It's probably unhelpful that the documentation isn't explicit about that. On that front, how about the patch below? Mark. ---->8---- >From 67104ad5a56e4c18f9c41f06af028b7561740afd Mon Sep 17 00:00:00 2001 From: Mark Rutland Date: Thu, 28 Aug 2014 17:41:03 +0100 Subject: [PATCH] Doc: dt: arch_timer: discourage clock-frequency use 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 CNTFRQ is exposed to all software in a privileged non-secure mode, including KVM guests. 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 Cc: Marc Zyngier Acked-by: Olof Johansson Acked-by: Marc Zyngier --- Documentation/devicetree/bindings/arm/arch_timer.txt | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/Documentation/devicetree/bindings/arm/arch_timer.txt b/Documentation/devicetree/bindings/arm/arch_timer.txt index 37b2caf..5ca3f95 100644 --- a/Documentation/devicetree/bindings/arm/arch_timer.txt +++ b/Documentation/devicetree/bindings/arm/arch_timer.txt @@ -17,7 +17,10 @@ to deliver its interrupts via SPIs. - interrupts : Interrupt list for secure, non-secure, virtual and hypervisor timers, in that order. -- clock-frequency : The frequency of the main counter, in Hz. Optional. +- clock-frequency : The frequency of the main counter, in Hz. Should be present + only where necessary to work around BROKEN firmware which does not configure + CNTFRQ on all CPUs to a uniform correct value. Use of this property is + STRONGLY DISCOURAGED; fix your firmware unless absolutely impossible. - always-on : a boolean property. If present, the timer is powered through an always-on power domain, therefore it never loses context. @@ -38,7 +41,8 @@ Example: - compatible : Should at least contain "arm,armv7-timer-mem". -- clock-frequency : The frequency of the main counter, in Hz. Optional. +- clock-frequency : The frequency of the main counter, in Hz. Should be present + only when firmware has not configured the MMIO CNTFRQ registers. - reg : The control frame base address.