From patchwork Wed Feb 14 03:49:49 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Leo Yan X-Patchwork-Id: 128304 Delivered-To: patch@linaro.org Received: by 10.46.124.24 with SMTP id x24csp186135ljc; Tue, 13 Feb 2018 19:50:29 -0800 (PST) X-Google-Smtp-Source: AH8x2256nkl5RrYIf79xgBU3I08DQj+UobnjLFPCEQ2ZUzWEBug6RcnDfe9/DUSOd9nmixTd0jHJ X-Received: by 10.99.5.197 with SMTP id 188mr2756638pgf.196.1518580229487; Tue, 13 Feb 2018 19:50:29 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1518580229; cv=none; d=google.com; s=arc-20160816; b=zWwgmNFe1Q4KpmpwPilDQZ622veGMV3zze54OlAn1OSfONPwOSgo2OK7iJkMFMK3gz WD/jhmkSRFEqSs2AU4BtktVN2GvFsiPU5tIyH/FPxPM5TpjyMG5E1qTSdNzYwrb80rck 8WMjD6NaR+fZHZvaaG7nMuDAin9XF8f606BHaxmD+/1Jye7xPdrJp262jJlyWGaozajc J6toVG5F+QhABkpQ9Ok9H40DI/eYSzRZ2dtgde5LPC8kpRNvbyJVvpihegpJ2y8+fluY rgOz/FTCuk5DTY/NWVEuEQYqrNaHrlYs8GFpeYfrp3bGUcEbiQ1c6eYvnQC+InfAYWU4 r29w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:references:in-reply-to:message-id:date :subject:to:from:dkim-signature:arc-authentication-results; bh=j+e8zjGL/a6pJXiUE2ARCYfYacO85JK3k9DrZe8f2Ks=; b=K1ExILic3+G/G+yq4E9fpQd1eotJ3yE9TP9DHWaB9aeY7SyE2yldMc2lAN8pPzYqsU TG7Z5+TAFTWtq7DSJR0maYr8sspaSZOyBmmvUvDP0gbmRC63FmdTfzxcAGfa84Xy0tny hnzM023PLIfj427ZP5L7z0MGzeYK5+9fO7/7C5oxU1FAv2/D56LsuNwNfWW/RRVCeloW LYBZQclxVbDwNGPfFWnWSPda09ewlwPT999ZKSz7Yn1BrqRWceXJYKDUhPNcNn50c8qc Io61lqDzb/CVH1c2SzVyWCCmL4kr7Z/uSq4alFrS46VJoww2eshNPQwOSHvoy2GHbrci pDqg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=GtULeT8s; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id l22si7519778pgn.578.2018.02.13.19.50.29; Tue, 13 Feb 2018 19:50:29 -0800 (PST) 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; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=GtULeT8s; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S966817AbeBNDu0 (ORCPT + 28 others); Tue, 13 Feb 2018 22:50:26 -0500 Received: from mail-qk0-f194.google.com ([209.85.220.194]:37697 "EHLO mail-qk0-f194.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S966671AbeBNDuW (ORCPT ); Tue, 13 Feb 2018 22:50:22 -0500 Received: by mail-qk0-f194.google.com with SMTP id c128so25121145qkb.4 for ; Tue, 13 Feb 2018 19:50:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:subject:date:message-id:in-reply-to:references; bh=j+e8zjGL/a6pJXiUE2ARCYfYacO85JK3k9DrZe8f2Ks=; b=GtULeT8sxJgms2pt1eTTQNgh9S4jvjONOdjsrW06OLJtKdfvSSeTNOmAwZE42/5095 j+luss3DLpEeLonvkE4IBLVFffjeHYSOdXKOMcOy4O2MH0HVVjWw8JtNjIYZrib+97gF peuAm2tbvWo0al1JKRXuX9tkHWeN1sAFltDlU= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references; bh=j+e8zjGL/a6pJXiUE2ARCYfYacO85JK3k9DrZe8f2Ks=; b=DU8u6YUf0uSjJYGhH4MvT8QjdrUkikRc4xiFiNfUXqHrcTKxkEbeDTcufFk9c80oOq 04ufxNuNgJMrQJSg8UaBLNNaweMzLqn5/zrh0EmlozuyFaI+QiW8ai1yUYCM3ZC//F0U 9oSp5FScFgg7PenpVUJr67w8wJ0jZW9/B45gqd1HOTBa4mC4sWKFnZRfjB+4Yo8gfN2I hNsfICxJ/90/1mw7UAth3GYu1o24MsED/mVWcoUIUzUwLjy/j91pXv3jd6WU8TBYS3g8 rngwuRlb3cdWMStHw6qn02TCk4ogGmEJ0sLs8wc0kMySh59PFidOOTHwxzXWYCeCl6sW OqyQ== X-Gm-Message-State: APf1xPBHZvvSSic8+vjA0vQMne+crTbTRPU39SXKXSs2TJvyRToGaA+w k3Yj1F4i9NIwFwR/VGrHW8jJgQ== X-Received: by 10.55.95.4 with SMTP id t4mr5624127qkb.102.1518580221842; Tue, 13 Feb 2018 19:50:21 -0800 (PST) Received: from localhost.localdomain ([45.77.212.61]) by smtp.gmail.com with ESMTPSA id h45sm8913800qtc.34.2018.02.13.19.50.16 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 13 Feb 2018 19:50:20 -0800 (PST) From: Leo Yan To: Rob Herring , Mark Rutland , Wei Xu , Jassi Brar , Leo Yan , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, Kaihua Zhong , Guodong Xu , Haojian Zhuang Subject: [PATCH RESEND v5 1/3] dt-bindings: mailbox: Introduce Hi3660 controller binding Date: Wed, 14 Feb 2018 11:49:49 +0800 Message-Id: <1518580191-26451-2-git-send-email-leo.yan@linaro.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1518580191-26451-1-git-send-email-leo.yan@linaro.org> References: <1518580191-26451-1-git-send-email-leo.yan@linaro.org> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Introduce a binding for the Hi3660 mailbox controller, the mailbox is used within application processor (AP), communication processor (CP), HIFI and MCU, etc. Acked-by: Rob Herring Signed-off-by: Leo Yan --- .../bindings/mailbox/hisilicon,hi3660-mailbox.txt | 51 ++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 Documentation/devicetree/bindings/mailbox/hisilicon,hi3660-mailbox.txt -- 1.9.1 diff --git a/Documentation/devicetree/bindings/mailbox/hisilicon,hi3660-mailbox.txt b/Documentation/devicetree/bindings/mailbox/hisilicon,hi3660-mailbox.txt new file mode 100644 index 0000000..3e5b453 --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/hisilicon,hi3660-mailbox.txt @@ -0,0 +1,51 @@ +Hisilicon Hi3660 Mailbox Controller + +Hisilicon Hi3660 mailbox controller supports up to 32 channels. Messages +are passed between processors, including application & communication +processors, MCU, HIFI, etc. Each channel is unidirectional and accessed +by using MMIO registers; it supports maximum to 8 words message. + +Controller +---------- + +Required properties: +- compatible: : Shall be "hisilicon,hi3660-mbox" +- reg: : Offset and length of the device's register set +- #mbox-cells: : Must be 3 + <&phandle channel dst_irq ack_irq> + phandle : Label name of controller + channel : Channel number + dst_irq : Remote interrupt vector + ack_irq : Local interrupt vector + +- interrupts: : Contains the two IRQ lines for mailbox. + +Example: + +mailbox: mailbox@e896b000 { + compatible = "hisilicon,hi3660-mbox"; + reg = <0x0 0xe896b000 0x0 0x1000>; + interrupts = <0x0 0xc0 0x4>, + <0x0 0xc1 0x4>; + #mbox-cells = <3>; +}; + +Client +------ + +Required properties: +- compatible : See the client docs +- mboxes : Standard property to specify a Mailbox (See ./mailbox.txt) + Cells must match 'mbox-cells' (See Controller docs above) + +Optional properties +- mbox-names : Name given to channels seen in the 'mboxes' property. + +Example: + +stub_clock: stub_clock@e896b500 { + compatible = "hisilicon,hi3660-stub-clk"; + reg = <0x0 0xe896b500 0x0 0x0100>; + #clock-cells = <1>; + mboxes = <&mailbox 13 3 0>; +};