From patchwork Tue Oct 20 08:41:57 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "majun \(F\)" X-Patchwork-Id: 55292 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-lf0-f72.google.com (mail-lf0-f72.google.com [209.85.215.72]) by patches.linaro.org (Postfix) with ESMTPS id 35F4923024 for ; Tue, 20 Oct 2015 08:47:30 +0000 (UTC) Received: by lfaz124 with SMTP id z124sf1900396lfa.0 for ; Tue, 20 Oct 2015 01:47:29 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:from:to:subject:date:message-id :in-reply-to:references:mime-version:content-type:sender:precedence :list-id:x-original-sender:x-original-authentication-results :mailing-list:list-post:list-help:list-archive:list-unsubscribe; bh=RzWkGEWKZdaH/CtStlReCeQNUrMWWh6WrF6Mjhu5uhw=; b=S6ZLV0frlOXfRPmo3kDYohwqZc5vX3nTooFfmKOWX7OEqeINSZ2X4duwkBNE93LXDu pYyQpmPXHGDUfXqh35Y0sltL4MKySPVdM7/0rkX+gisPLLSwtGh79FBieR9SBf0iTYTr +DG+m40qSX9ABb6wIOtADrBQhuNrw7K2rb2oDYsoaY0HQqoqbTwNL2xYh2iQNQ+MVguW qc2KhPB2wnhAk2sUFg0a51/dpWb6vxJ+RIC6pHUr89r1olR5mjK6xJIXkB1S8/dNIPcD 5zvC2rOEmP7V342EgvwSqWdHlSRNhH4mEo0fPFme07xzhpg+bRRSLNwJL00IeBT0Jpd1 Dx2Q== X-Gm-Message-State: ALoCoQnw0Ktpq71OxsMtziO0/qFEYvRvAEmat3A1yffGcCdtZ8wcx0KcqALElXYUKCqbgOlbfao5 X-Received: by 10.180.87.164 with SMTP id az4mr5076460wib.1.1445330849142; Tue, 20 Oct 2015 01:47:29 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.25.145.136 with SMTP id t130ls44479lfd.89.gmail; Tue, 20 Oct 2015 01:47:28 -0700 (PDT) X-Received: by 10.112.146.231 with SMTP id tf7mr1055555lbb.103.1445330848961; Tue, 20 Oct 2015 01:47:28 -0700 (PDT) Received: from mail-lb0-f174.google.com (mail-lb0-f174.google.com. [209.85.217.174]) by mx.google.com with ESMTPS id vv3si1445749lbb.102.2015.10.20.01.47.28 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 20 Oct 2015 01:47:28 -0700 (PDT) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.217.174 as permitted sender) client-ip=209.85.217.174; Received: by lbbec13 with SMTP id ec13so7422444lbb.0 for ; Tue, 20 Oct 2015 01:47:28 -0700 (PDT) X-Received: by 10.112.163.131 with SMTP id yi3mr1057170lbb.36.1445330848857; Tue, 20 Oct 2015 01:47:28 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.112.59.35 with SMTP id w3csp1943314lbq; Tue, 20 Oct 2015 01:47:27 -0700 (PDT) X-Received: by 10.50.83.34 with SMTP id n2mr23292542igy.21.1445330847621; Tue, 20 Oct 2015 01:47:27 -0700 (PDT) Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id n1si14324884igp.19.2015.10.20.01.47.27; Tue, 20 Oct 2015 01:47:27 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753941AbbJTIrR (ORCPT + 28 others); Tue, 20 Oct 2015 04:47:17 -0400 Received: from szxga01-in.huawei.com ([58.251.152.64]:18590 "EHLO szxga01-in.huawei.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932299AbbJTIrI (ORCPT ); Tue, 20 Oct 2015 04:47:08 -0400 Received: from 172.24.1.48 (EHLO szxeml434-hub.china.huawei.com) ([172.24.1.48]) by szxrg01-dlp.huawei.com (MOS 4.3.7-GA FastPath queued) with ESMTP id CXE55684; Tue, 20 Oct 2015 16:42:11 +0800 (CST) Received: from localhost (10.177.235.245) by szxeml434-hub.china.huawei.com (10.82.67.225) with Microsoft SMTP Server id 14.3.235.1; Tue, 20 Oct 2015 16:42:01 +0800 From: MaJun To: , , , , , , , , , , , , , , , , , , , , , , , Subject: [PATCH v6 1/4] dt-binding:Documents of the mbigen bindings Date: Tue, 20 Oct 2015 16:41:57 +0800 Message-ID: <1445330520-11960-2-git-send-email-majun258@huawei.com> X-Mailer: git-send-email 1.9.5.msysgit.1 In-Reply-To: <1445330520-11960-1-git-send-email-majun258@huawei.com> References: <1445330520-11960-1-git-send-email-majun258@huawei.com> MIME-Version: 1.0 X-Originating-IP: [10.177.235.245] X-CFilter-Loop: Reflected Sender: linux-kernel-owner@vger.kernel.org Precedence: list List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: majun258@huawei.com X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.217.174 as permitted sender) smtp.mailfrom=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , From: Ma Jun Add the mbigen msi interrupt controller bindings document. This patch based on Mark Rutland's patch https://lkml.org/lkml/2015/7/23/558 Signed-off-by: Ma Jun --- Documentation/devicetree/bindings/arm/mbigen.txt | 63 ++++++++++++++++++++++ 1 files changed, 63 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/arm/mbigen.txt diff --git a/Documentation/devicetree/bindings/arm/mbigen.txt b/Documentation/devicetree/bindings/arm/mbigen.txt new file mode 100644 index 0000000..eb9a7fd --- /dev/null +++ b/Documentation/devicetree/bindings/arm/mbigen.txt @@ -0,0 +1,63 @@ +Hisilicon mbigen device tree bindings. +======================================= + +Mbigen means: message based interrupt generator. + +MBI is kind of msi interrupt only used on Non-PCI devices. + +To reduce the wired interrupt number connected to GIC, +Hisilicon designed mbigen to collect and generate interrupt. + + +Non-pci devices can connect to mbigen and generate the +interrupt by writing ITS register. + +The mbigen chip and devices connect to mbigen have the following properties: + +Mbigen main node required properties: +------------------------------------------- +- compatible: Should be "hisilicon,mbigen-v2" +- reg: Specifies the base physical address and size of the Mbigen + registers. +- interrupt controller: Identifies the node as an interrupt controller +- msi-parent: This property has two cells. + The 1st cell specifies the ITS this device connected. + The 2nd cell specifies the device id. +- nr-msis:Specifies the total number of interrupt this device has. +- #interrupt-cells : Specifies the number of cells needed to encode an + interrupt source. The value is 2 now. + + The 1st cell is global hardware pin number of the interrupt. + This value depends on the Soc design. + The 2nd cell is the interrupt trigger type. + +Examples: + + mbigen_device_gmac:intc { + compatible = "hisilicon,mbigen-v2"; + reg = <0x0 0xc0080000 0x0 0x10000>; + interrupt-controller; + msi-parent = <&its_dsa 0x40b1c>; + num-msis = <9>; + #interrupt-cells = <2>; + }; + +Devices connect to mbigen required properties: +---------------------------------------------------- +-interrupt-parent: Specifies the mbigen device node which device connected. +-interrupts:specifies the interrupt source. + The 1st cell is global hardware pin number of the interrupt. + This value depends on the Soc design. + The 2nd cell is the interrupt trigger type + +Examples: + gmac0: ethernet@c2080000 { + #address-cells = <1>; + #size-cells = <0>; + reg = <0 0xc2080000 0 0x20000>, + <0 0xc0000000 0 0x1000>; + interrupt-parent = <&mbigen_device_gmac>; + interrupts = <656 1>, + <657 1>; + }; +