From patchwork Thu Jun 20 14:39:06 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Florian Fainelli X-Patchwork-Id: 2756591 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork1.web.kernel.org (Postfix) with ESMTP id B5C5A9F39E for ; Thu, 20 Jun 2013 14:46:03 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id E1D5E202E9 for ; Thu, 20 Jun 2013 14:45:58 +0000 (UTC) Received: from casper.infradead.org (casper.infradead.org [85.118.1.10]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 69D3B2024D for ; Thu, 20 Jun 2013 14:45:57 +0000 (UTC) Received: from merlin.infradead.org ([2001:4978:20e::2]) by casper.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1Upg6G-00029w-Cy; Thu, 20 Jun 2013 14:44:36 +0000 Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1Upg5v-0000xd-Oh; Thu, 20 Jun 2013 14:44:16 +0000 Received: from mms2.broadcom.com ([216.31.210.18]) by merlin.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1Upg5V-0000ur-UD for linux-arm-kernel@lists.infradead.org; Thu, 20 Jun 2013 14:43:51 +0000 Received: from [10.9.208.55] by mms2.broadcom.com with ESMTP (Broadcom SMTP Relay (Email Firewall v6.5)); Thu, 20 Jun 2013 07:37:33 -0700 X-Server-Uuid: 4500596E-606A-40F9-852D-14843D8201B2 Received: from IRVEXCHSMTP1.corp.ad.broadcom.com (10.9.207.51) by IRVEXCHCAS07.corp.ad.broadcom.com (10.9.208.55) with Microsoft SMTP Server (TLS) id 14.1.438.0; Thu, 20 Jun 2013 07:43:18 -0700 Received: from mail-irva-13.broadcom.com (10.10.10.20) by IRVEXCHSMTP1.corp.ad.broadcom.com (10.9.207.51) with Microsoft SMTP Server id 14.1.438.0; Thu, 20 Jun 2013 07:43:18 -0700 Received: from fainelli-desktop.broadcom.com ( dhcp-lab-brsc-21.bri.broadcom.com [10.178.5.21]) by mail-irva-13.broadcom.com (Postfix) with ESMTP id BC486F2D73; Thu, 20 Jun 2013 07:43:16 -0700 (PDT) From: "Florian Fainelli" To: lorenzo.pieralisi@arm.com Subject: [PATCH 3/3] ARM: kernel: document ARM CPUs clocks and clock-frequency properties Date: Thu, 20 Jun 2013 15:39:06 +0100 Message-ID: <1371739146-32639-4-git-send-email-f.fainelli@gmail.com> X-Mailer: git-send-email 1.8.1.2 In-Reply-To: <1371739146-32639-1-git-send-email-f.fainelli@gmail.com> References: <1371739146-32639-1-git-send-email-f.fainelli@gmail.com> MIME-Version: 1.0 X-WSS-ID: 7DDDCC271R034429638-01-01 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20130620_104350_222516_E94D7414 X-CRM114-Status: GOOD ( 10.38 ) X-Spam-Score: -2.5 (--) Cc: Florian Fainelli , nico@linaro.org, devicetree-discuss@lists.ozlabs.org, rob.herring@calxeda.com, grant.likely@linaro.org, linux-arm-kernel@lists.infradead.org X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-5.5 required=5.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, FREEMAIL_FROM,RCVD_IN_DNSWL_MED,RP_MATCHES_RCVD,UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP ARM CPU device tree nodes may contain a "clock-frequency" property, when set, this property must contain the CPU frequency in Hz, which is then used by the topology parsing code in arch/arm/kernel/topology.c to deduced the CPU capacity. The "clocks" property, if present shall be a phandle to a valid clock node. Document thes properties to avoid any possible confusion on the clock-frequency unit and also specify that "device_type" is also used by the topology code. Signed-off-by: Florian Fainelli --- Documentation/devicetree/bindings/arm/cpus.txt | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/Documentation/devicetree/bindings/arm/cpus.txt b/Documentation/devicetree/bindings/arm/cpus.txt index f32494d..1ce1ace 100644 --- a/Documentation/devicetree/bindings/arm/cpus.txt +++ b/Documentation/devicetree/bindings/arm/cpus.txt @@ -10,7 +10,7 @@ http://devicetree.org For the ARM architecture every CPU node must contain the following properties: -- device_type: must be "cpu" +- device_type: must be "cpu". Use by the topology code. - reg: property matching the CPU MPIDR[23:0] register bits reg[31:24] bits must be set to 0 - compatible: should be one of: @@ -45,6 +45,11 @@ For the ARM architecture every CPU node must contain the following properties: "marvell,xsc3" "marvell,xscale" +- clocks: phandle and clock specifier for the CPU clock, used if + "device_type" is present. +- clock-frequency: the frequency of the CPU, in Hz. Mandatory if "device_type" + is also present, used as fallback is "clocks" is not present. + Example: cpus {