From patchwork Fri Dec 20 02:45:00 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ravi Patel X-Patchwork-Id: 303843 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 78C682C0200 for ; Fri, 20 Dec 2013 13:51:13 +1100 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752692Ab3LTCvJ (ORCPT ); Thu, 19 Dec 2013 21:51:09 -0500 Received: from exprod5og103.obsmtp.com ([64.18.0.145]:40169 "HELO exprod5og103.obsmtp.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with SMTP id S1751032Ab3LTCvF (ORCPT ); Thu, 19 Dec 2013 21:51:05 -0500 Received: from mail-pb0-f49.google.com ([209.85.160.49]) (using TLSv1) by exprod5ob103.postini.com ([64.18.4.12]) with SMTP ID DSNKUrOwmfEfk9ZOanOQOc/IUzTwqCzFX0wn@postini.com; Thu, 19 Dec 2013 18:51:05 PST Received: by mail-pb0-f49.google.com with SMTP id jt11so1978890pbb.22 for ; Thu, 19 Dec 2013 18:51:04 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=JA88G8cg337W/2YNGzoQgslH0ti72q6kgsrWpJ4Q330=; b=TogDB5IK/AlJ+kIcIg73CC7AJBto5ODZNHpBwdCPJHk3kJTO5wRlU76soqmyYhgrgq neyiOyhoF3LJXb6Tgj73wwgVngvagElweRXLJgwF5ZzuOSBWtXxQ8yNy1iQCYVHyHrZx 0jyx8iMNH4yv5rIIHsZkliPI5izwaDKSSfxk4IM6I86se6XJcwqE99ycwWRklTS4Ye0m HZFueBXPIP3hMgosLsGVkplIqv7gBVGA/Jhaf0UWqxV7VljLDcsFYlLM2ucwi7UCdq84 GRhf/mYAyYj2ur8J7VjTmIdviIvTqZiQPRO1azu33ZXRw6zilxYW4nUY/0sHF95qOMYP XXsQ== X-Received: by 10.66.139.166 with SMTP id qz6mr5687036pab.88.1387507517606; Thu, 19 Dec 2013 18:45:17 -0800 (PST) X-Gm-Message-State: ALoCoQkXx+sfANwd1QHTf2trKrkUm7OLVbWRMZ94Gmtl0+3dxqE3RmtkjWDzAufDrrHYkns2V8yfu0Ms8uiL1ys5zavoZB0UjbVrp20jnb+X4LcM+lcfNc0c0Q0FAq/vD8Ly9v0G6foRdzlR5JbZr05gSmNhf9Z5t2jQRAM/7TRzIwLfIiLkHuc= X-Received: by 10.66.139.166 with SMTP id qz6mr5687019pab.88.1387507517502; Thu, 19 Dec 2013 18:45:17 -0800 (PST) Received: from amcclab-Precision-WorkStation-T3400.amcc.com (63-147-59-2.dia.static.qwest.net. [63.147.59.2]) by mx.google.com with ESMTPSA id qf7sm13792526pac.14.2013.12.19.18.45.16 for (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 19 Dec 2013 18:45:16 -0800 (PST) From: Ravi Patel To: arnd@arndb.de, gregkh@linuxfoundation.org, davem@davemloft.net Cc: netdev@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, jcm@redhat.com, patches@apm.com, Ravi Patel , Keyur Chudgar Subject: [PATCH 1/4] Documentation: Add documentation for APM X-Gene SoC Queue Manager/Traffic Manager DTS binding Date: Thu, 19 Dec 2013 18:45:00 -0800 Message-Id: <1387507503-7565-2-git-send-email-rapatel@apm.com> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1387507503-7565-1-git-send-email-rapatel@apm.com> References: <1387507503-7565-1-git-send-email-rapatel@apm.com> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This patch adds device tree binding documentation for APM X-Gene SoC Queue Manager/Traffic Manager. Signed-off-by: Ravi Patel Signed-off-by: Keyur Chudgar --- .../devicetree/bindings/misc/apm-xgene-qmtm.txt | 51 ++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 Documentation/devicetree/bindings/misc/apm-xgene-qmtm.txt diff --git a/Documentation/devicetree/bindings/misc/apm-xgene-qmtm.txt b/Documentation/devicetree/bindings/misc/apm-xgene-qmtm.txt new file mode 100644 index 0000000..f3234d5 --- /dev/null +++ b/Documentation/devicetree/bindings/misc/apm-xgene-qmtm.txt @@ -0,0 +1,51 @@ +* APM X-Gene SOC Queue Manager/Traffic Manager nodes + +QMTM nodes are defined to describe on-chip Queue Managers in APM X-Gene SOC. +APM X-Gene SOC Ethernet, PktDMA, and Security Engine subsystems communicate +with a central Queue Manager using messages which include information about +the work to be performed and the location of the associated data buffers. +There are multiple instances of QMTM. Each QMTM instance has its own node. +Its corresponding clock nodes are shown below. + +Required properties: +- compatible : Shall be "apm,xgene-qmtm-lite" for QMLite instance +- reg : First memory resource shall be the QMTM CSR memory + resource. + Second memory resource shall be the QMTM IO-Fabric + memory resource. +- slave-name : Shall be "CPU_QMTM3" which is receiver for ingress + work messages for the QMTM. Here receiver is CPU. +- interrupts : First interrupt resource shall be the QMTM Error + interrupt. + Remaining interrupt resources shall be the Ingress + work message interrupt mapping for receiver, + receiving work messages for the QMTM. +- clocks : Reference to the clock entry. + +Optional properties: +- status : Shall be "ok" if enabled or "disabled" if disabled. + Default is "ok". + +Example: + qmlclk: qmlclk { + compatible = "apm,xgene-device-clock"; + #clock-cells = <1>; + clock-names = "qmlclk"; + status = "ok"; + csr-offset = <0x0>; + csr-mask = <0x3>; + enable-offset = <0x8>; + enable-mask = <0x3>; + }; + + qmlite: qmtm@17030000 { + compatible = "apm,xgene-qmtm-lite"; + reg = <0x0 0x17030000 0x0 0x10000>, + <0x0 0x10000000 0x0 0x400000>; + slave-name = "CPU_QMTM3"; + interrupts = <0x0 0x40 0x4>, + <0x0 0x3c 0x4>; + status = "ok"; + #clock-cells = <1>; + clocks = <&qmlclk 0>; + };