From patchwork Wed Sep 16 09:39:17 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Viresh Kumar X-Patchwork-Id: 312285 Delivered-To: patch@linaro.org Received: by 2002:a92:5ad1:0:0:0:0:0 with SMTP id b78csp287242ilg; Wed, 16 Sep 2020 02:39:38 -0700 (PDT) X-Google-Smtp-Source: ABdhPJz4Z8Rlf+LKQmJrtCERoVlz9fMx+/azuNYqK9VS7PJrNLY61MyD2vb7r1284pStB1cTSOOD X-Received: by 2002:a17:906:9604:: with SMTP id s4mr25317182ejx.182.1600249178827; Wed, 16 Sep 2020 02:39:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1600249178; cv=none; d=google.com; s=arc-20160816; b=Ne2ZikrnDyE7J31JnYcliX30tcD1k+im7kbdbi16qxEAnBgEfhMyNGihkbRs0WI9pX AaopP+cq4lUTALA+vgf7aztJjSRxsOp6510CzQq9fI0cw7ya1Wi9k0tdvL3HmDPKCv4+ cLPgopw8zfIED9Q5bX160J9Oca/fjaiNXzNcsSjAbPa39YbbDMW96ZtPqshIswV2t+3h 7ddVYQWHBcMVCjQ+YDN2/nl8peXPcNFiNee4ntziQDsTvX0upwCsu8UhNUyyarvUvo8I OWVil6AXTr7P9HkTy79jjZrlfZhdtUQRQbejyxZrU6KdZqd+I3wUUIlyf4NcezAhsLTy S9zg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=nr0Ojg9qAm8OgCLg703zoT+O4V7LKzhMDlCC3KmmLNg=; b=yupk2BHSkM1xGXGpQAx75s8nOeu9G+w6l7II+ZXhOfSOeMUC/G1YmbR1vs5Qs/wtTL eMtl/+ZiOWutcr6mWx5j0N90SVLJIob0AeH9ZQDXP2hq/kL206o18V2ZQVHyAO8Xy3Rl W4X52ZdYDot2jmPYCTMIhF6x89qFXScbl1PvNk0TjuC0/kUUu89WDf+dK5vi96lWwaEh sE3s9qV//I3GwFMV6z5i9oz2hkrlMInXg5b45eG52h6AIRRqanUrSzjEyBhJxHLZ1yyA HTWnGfQ6kYQGkMpnOHlx+iniK/k5GC0Q1pLHab0U5CrX32+P7ZS0te9p87F+HAwluKZk sDqg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=QFPsiDrS; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-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. [23.128.96.18]) by mx.google.com with ESMTP id v13si12282834edi.95.2020.09.16.02.39.38; Wed, 16 Sep 2020 02:39:38 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=QFPsiDrS; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-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 S1726701AbgIPJjh (ORCPT + 6 others); Wed, 16 Sep 2020 05:39:37 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43538 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726392AbgIPJje (ORCPT ); Wed, 16 Sep 2020 05:39:34 -0400 Received: from mail-pj1-x1041.google.com (mail-pj1-x1041.google.com [IPv6:2607:f8b0:4864:20::1041]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E709BC06174A for ; Wed, 16 Sep 2020 02:39:33 -0700 (PDT) Received: by mail-pj1-x1041.google.com with SMTP id a9so1299889pjg.1 for ; Wed, 16 Sep 2020 02:39:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=nr0Ojg9qAm8OgCLg703zoT+O4V7LKzhMDlCC3KmmLNg=; b=QFPsiDrSq996so456fe2hEy11ROjrzTSirvXwjTWUbB0rEdhiOQjI4tomWcFP1Xg9L wxALwetR6UBN1FADOof61gUOubuN37oHzcfBGT/7gxfQhV7KK1Lp9OIAbhfChlO3vqqi qbgqRORkRCbuqi4TQXDSldkr7LqKe6XtkVOk2TA+OD0GW6ZdXEyXZfOAYMq1VcwspbOC oW7lKgxY7+AUKbunAGXu3qbC37aFxZYuvE5QfYj3S8hY0uiTPtsfX+FuCSaZcn8eFKk7 IBX0NrbdEGQSGpDW5PxC+zXSV5Lasqu3e/n28ruFiaahhr/kOTIloZz9SPCDpwoi8JOy omgg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=nr0Ojg9qAm8OgCLg703zoT+O4V7LKzhMDlCC3KmmLNg=; b=e0Q6KODEz4SZ2ePlpuJ+06ENFHeKUHWusUs45+PhdIcwQCyCCQObFajnIfM0is+Lqv /G7K9tRK/jxHMC0nE24Ieo2vU5zaA9uQDIV8GYOeIrc+7XKom5UJbWxkNBCtz1+HkhaT e7rzrhSmXnCauOvhpVz+dFcoOAJjTQRev4PAoA4LqElnYGbX998zPunUJe76q3e4oH0v Ovf+RzvDNQ0yzRnFDw+g3n8nTYvi71LYtR1CPLJX0UD3L1fPrI2ET5tHxuKMQix8Ki3y YHgminsBTuQjesQxxCJenjkNGjbSUxeBbtyywBuY2G1aquLIgUXkmUpPK3sVzuBaSEtX 9NPA== X-Gm-Message-State: AOAM530KCwMEw0RhkzGTSGjnhBuvCUspFWj6NkiRIEQ9k64kCQ9PB5C2 uJCWN48UYWu9MBEQBSSuVrhPWg== X-Received: by 2002:a17:902:ea8b:b029:d1:7ed9:55c6 with SMTP id x11-20020a170902ea8bb02900d17ed955c6mr22671038plb.19.1600249173383; Wed, 16 Sep 2020 02:39:33 -0700 (PDT) Received: from localhost ([122.181.54.133]) by smtp.gmail.com with ESMTPSA id i8sm2069029pjv.43.2020.09.16.02.39.31 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 16 Sep 2020 02:39:32 -0700 (PDT) From: Viresh Kumar To: Rob Herring , Jassi Brar , Jassi Brar Cc: Viresh Kumar , Vincent Guittot , Arnd Bergmann , Frank Rowand , Bjorn Andersson , linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH V4 1/2] dt-bindings: mailbox : arm, mhu: Convert to Json-schema Date: Wed, 16 Sep 2020 15:09:17 +0530 Message-Id: <3874de094d193a08624a00a35067a3237e0b42b1.1600249102.git.viresh.kumar@linaro.org> X-Mailer: git-send-email 2.25.0.rc1.19.g042ed3e048af MIME-Version: 1.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Convert the DT binding over to Json-schema. Signed-off-by: Viresh Kumar --- V4: - Dual license - improved description for interrupts .../devicetree/bindings/mailbox/arm,mhu.yaml | 87 +++++++++++++++++++ .../devicetree/bindings/mailbox/arm-mhu.txt | 43 --------- 2 files changed, 87 insertions(+), 43 deletions(-) create mode 100644 Documentation/devicetree/bindings/mailbox/arm,mhu.yaml delete mode 100644 Documentation/devicetree/bindings/mailbox/arm-mhu.txt -- 2.25.0.rc1.19.g042ed3e048af Reviewed-by: Rob Herring diff --git a/Documentation/devicetree/bindings/mailbox/arm,mhu.yaml b/Documentation/devicetree/bindings/mailbox/arm,mhu.yaml new file mode 100644 index 000000000000..2c8df7979c22 --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/arm,mhu.yaml @@ -0,0 +1,87 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mailbox/arm,mhu.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: ARM MHU Mailbox Controller + +maintainers: + - Jassi Brar + +description: | + The ARM's Message-Handling-Unit (MHU) is a mailbox controller that has 3 + independent channels/links to communicate with remote processor(s). MHU links + are hardwired on a platform. A link raises interrupt for any received data. + However, there is no specified way of knowing if the sent data has been read + by the remote. This driver assumes the sender polls STAT register and the + remote clears it after having read the data. The last channel is specified to + be a 'Secure' resource, hence can't be used by Linux running NS. + +# We need a select here so we don't match all nodes with 'arm,primecell' +select: + properties: + compatible: + contains: + const: arm,mhu + required: + - compatible + +properties: + compatible: + items: + - const: arm,mhu + - const: arm,primecell + + reg: + maxItems: 1 + + interrupts: + items: + - description: low-priority non-secure + - description: high-priority non-secure + - description: Secure + maxItems: 3 + + clocks: + maxItems: 1 + + clock-names: + items: + - const: apb_pclk + + '#mbox-cells': + description: Index of the channel. + const: 1 + +required: + - compatible + - reg + - interrupts + - '#mbox-cells' + +additionalProperties: false + +examples: + - | + soc { + #address-cells = <2>; + #size-cells = <2>; + + mhuA: mailbox@2b1f0000 { + #mbox-cells = <1>; + compatible = "arm,mhu", "arm,primecell"; + reg = <0 0x2b1f0000 0 0x1000>; + interrupts = <0 36 4>, /* LP-NonSecure */ + <0 35 4>, /* HP-NonSecure */ + <0 37 4>; /* Secure */ + clocks = <&clock 0 2 1>; + clock-names = "apb_pclk"; + }; + + mhu_client_scb: scb@2e000000 { + compatible = "fujitsu,mb86s70-scb-1.0"; + reg = <0 0x2e000000 0 0x4000>; + mboxes = <&mhuA 1>; /* HP-NonSecure */ + }; + }; diff --git a/Documentation/devicetree/bindings/mailbox/arm-mhu.txt b/Documentation/devicetree/bindings/mailbox/arm-mhu.txt deleted file mode 100644 index 4971f03f0b33..000000000000 --- a/Documentation/devicetree/bindings/mailbox/arm-mhu.txt +++ /dev/null @@ -1,43 +0,0 @@ -ARM MHU Mailbox Driver -====================== - -The ARM's Message-Handling-Unit (MHU) is a mailbox controller that has -3 independent channels/links to communicate with remote processor(s). - MHU links are hardwired on a platform. A link raises interrupt for any -received data. However, there is no specified way of knowing if the sent -data has been read by the remote. This driver assumes the sender polls -STAT register and the remote clears it after having read the data. -The last channel is specified to be a 'Secure' resource, hence can't be -used by Linux running NS. - -Mailbox Device Node: -==================== - -Required properties: --------------------- -- compatible: Shall be "arm,mhu" & "arm,primecell" -- reg: Contains the mailbox register address range (base - address and length) -- #mbox-cells Shall be 1 - the index of the channel needed. -- interrupts: Contains the interrupt information corresponding to - each of the 3 links of MHU. - -Example: --------- - - mhu: mailbox@2b1f0000 { - #mbox-cells = <1>; - compatible = "arm,mhu", "arm,primecell"; - reg = <0 0x2b1f0000 0x1000>; - interrupts = <0 36 4>, /* LP-NonSecure */ - <0 35 4>, /* HP-NonSecure */ - <0 37 4>; /* Secure */ - clocks = <&clock 0 2 1>; - clock-names = "apb_pclk"; - }; - - mhu_client: scb@2e000000 { - compatible = "fujitsu,mb86s70-scb-1.0"; - reg = <0 0x2e000000 0x4000>; - mboxes = <&mhu 1>; /* HP-NonSecure */ - }; From patchwork Wed Sep 16 09:39:18 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Viresh Kumar X-Patchwork-Id: 312287 Delivered-To: patch@linaro.org Received: by 2002:a92:5ad1:0:0:0:0:0 with SMTP id b78csp287336ilg; Wed, 16 Sep 2020 02:39:50 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwZLPSjiDr/3kCSEHUq3VI2vIbvkkBnDs04EbwgWQ6hWLN694vC3nXs52/WScDk5VklsdWy X-Received: by 2002:a17:906:7e42:: with SMTP id z2mr23964208ejr.206.1600249190442; Wed, 16 Sep 2020 02:39:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1600249190; cv=none; d=google.com; s=arc-20160816; b=q7u+SagWV/BVgd5bVRtYHznPoglheyWyihhsYXrNqSIiOYy+58K4u6VF/EVAYMXbsf CbYha1ISdBFh2yByfNGt3MP9OLgvtq5I0F2gi4qTysJF1mTax7flHdO10GibmDrY/kps y4pbSg2cF0ldnK5TIvZTFEB5ggcIhpw1GPyFtIDCGscA7i7VzzDKs3nVAoh8Y2eawSgY KERn4FJZe+ANHr7PdXB7ggcdY3XapR1KlAWmUviim+tWbWBvCJr/Na9qFr3GT7228rmK hGmlMSP8cBLkr3sEcPjKO4875pd4Thuh6Igio4MjMgg0EqdyRXnCc14nKX8qdvKbBl4j QG8Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=H8AkzaxC++FhteIS2uJYfThdR+e4UohlwkKcMuwBI6c=; b=GsK9swKER2Us98mQP4b10jhX0lSEuGp6drYZ3CE3FTf4Yodgvb68lmDB0e+H+kGO/P toKpakdmQ/xmts3TtvOnxjTlBlQhlp+vqGHI/Mu0HyAFPIikxxi1FrY5j1EianqfQzvz Wqz6PtnW5/j7ryciQx3zffr7B8nZ8r5uDtZPRy1PrXeP2Jivn//YPM2/+nyOWoLd5Pw/ WQF/l3K2sOqZJiAw9G0XgUpWQgnqljGEOEu1/JDUlP1EJlV5Ek6vBc3L6+iDqQacMJfR q76Rr7+gmWxaf4FucOOURIR2uuFcJ9yU60BilOia+EXNdF2g1tGxX039S2pRhZBueMyM ib1w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=JqccLoP0; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-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. [23.128.96.18]) by mx.google.com with ESMTP id n24si11224665ejs.611.2020.09.16.02.39.50; Wed, 16 Sep 2020 02:39:50 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=JqccLoP0; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-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 S1726774AbgIPJjo (ORCPT + 6 others); Wed, 16 Sep 2020 05:39:44 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43558 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726766AbgIPJjk (ORCPT ); Wed, 16 Sep 2020 05:39:40 -0400 Received: from mail-pf1-x42b.google.com (mail-pf1-x42b.google.com [IPv6:2607:f8b0:4864:20::42b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A9A17C061788 for ; Wed, 16 Sep 2020 02:39:39 -0700 (PDT) Received: by mail-pf1-x42b.google.com with SMTP id n14so3640417pff.6 for ; Wed, 16 Sep 2020 02:39:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=H8AkzaxC++FhteIS2uJYfThdR+e4UohlwkKcMuwBI6c=; b=JqccLoP0WFWnngf08Ztmi7m6wSbuMixdwIc4ZLcHLmZBTvtysKHRt8CLHEmglfF0h0 yEx33j78CKWyy+7AqA4k0iCvPm2Wqi9biduejIc4TziOXcNcsMMESt/u9ao83muvBJxb H+mpNqiEhWOrKKOABom1aKusMcAX3NlEwaXs3hXgY5ZGOysp4wzq1NUHlgcdpUL32Q5T t1UGMTEavf+KxnOMby8SXAjBGrrbQE8rY8m89Vd8W521336ErWKNAXE6GvWYr6OPhCr6 /EmgoxOhkBnL3XSZDyQb20wtt6W5cyj1rbgS7WZlGxpEfLyV1Zb+UL3bSGOrAPlT01ef SL6w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=H8AkzaxC++FhteIS2uJYfThdR+e4UohlwkKcMuwBI6c=; b=eVBbYGkDo0PLMOTP7ZIPttRhKQKJxwFfL+eQakj2tx8YxshdeCkwaOeGdp8cO1KY42 3dWajjr5vQylMoQ0PcYLcCoabtIqocNFGpqOgcIB9HMYriN5nrdVJi+V3RzNizaFdJUQ 4cbQzI5K8Ktsb87iqqk2zOREe2S0KTzxARrEehIMeRRA+V1RUqobrqjy4q0YOHHdM0iA v2cHxe0kcP43xTyUE/cbm9uEDh90dCapiEzxk0ti7JHs1sBMJfveRUXv6wyQjF26ox++ ypL9QONPG2KlB5yTE0qgIdukuNq0HhkpPqySLlZFHZqH2SERgF4dmqO8NVm7MTDmZGBZ r9dg== X-Gm-Message-State: AOAM5332Z8QPmcKWm0Y0KI14HeFj61dWlQB8Hgd+X5cj84FPRGVemOEW 7AuvAXBdMYJHzQk7cWoqKz0M4A== X-Received: by 2002:a63:7841:: with SMTP id t62mr17348017pgc.183.1600249179169; Wed, 16 Sep 2020 02:39:39 -0700 (PDT) Received: from localhost ([122.181.54.133]) by smtp.gmail.com with ESMTPSA id v6sm16215933pfi.38.2020.09.16.02.39.38 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 16 Sep 2020 02:39:38 -0700 (PDT) From: Viresh Kumar To: Rob Herring , Jassi Brar , Jassi Brar Cc: Viresh Kumar , Vincent Guittot , Arnd Bergmann , Frank Rowand , Bjorn Andersson , linux-arm-kernel@lists.infradead.org, Sudeep Holla , Rob Herring , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH V4 2/2] dt-bindings: mailbox: add doorbell support to ARM MHU Date: Wed, 16 Sep 2020 15:09:18 +0530 Message-Id: <7f4a98d4dac9257d9577e48992cbfb62a968f127.1600249102.git.viresh.kumar@linaro.org> X-Mailer: git-send-email 2.25.0.rc1.19.g042ed3e048af In-Reply-To: <3874de094d193a08624a00a35067a3237e0b42b1.1600249102.git.viresh.kumar@linaro.org> References: <3874de094d193a08624a00a35067a3237e0b42b1.1600249102.git.viresh.kumar@linaro.org> MIME-Version: 1.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Sudeep Holla The ARM MHU's reference manual states following: "The MHU drives the signal using a 32-bit register, with all 32 bits logically ORed together. The MHU provides a set of registers to enable software to set, clear, and check the status of each of the bits of this register independently. The use of 32 bits for each interrupt line enables software to provide more information about the source of the interrupt. For example, each bit of the register can be associated with a type of event that can contribute to raising the interrupt." This patch thus extends the MHU controller's DT binding to add support for doorbell mode. Though the same MHU hardware controller is used in the two modes, A new compatible string is added here to represent the combination of the MHU hardware and the firmware sitting on the other side (which expects each bit to represent a different signal now). Reviewed-by: Rob Herring Signed-off-by: Sudeep Holla Co-developed-by: Viresh Kumar Signed-off-by: Viresh Kumar --- V4: Added Rob's tag. .../devicetree/bindings/mailbox/arm,mhu.yaml | 60 +++++++++++++++++-- 1 file changed, 54 insertions(+), 6 deletions(-) -- 2.25.0.rc1.19.g042ed3e048af Acked-by: Arnd Bergmann diff --git a/Documentation/devicetree/bindings/mailbox/arm,mhu.yaml b/Documentation/devicetree/bindings/mailbox/arm,mhu.yaml index 2c8df7979c22..d43791a2dde7 100644 --- a/Documentation/devicetree/bindings/mailbox/arm,mhu.yaml +++ b/Documentation/devicetree/bindings/mailbox/arm,mhu.yaml @@ -18,20 +18,40 @@ description: | remote clears it after having read the data. The last channel is specified to be a 'Secure' resource, hence can't be used by Linux running NS. + The MHU hardware also allows operations in doorbell mode. The MHU drives the + interrupt signal using a 32-bit register, with all 32-bits logically ORed + together. It provides a set of registers to enable software to set, clear and + check the status of each of the bits of this register independently. The use + of 32 bits per interrupt line enables software to provide more information + about the source of the interrupt. For example, each bit of the register can + be associated with a type of event that can contribute to raising the + interrupt. Each of the 32-bits can be used as "doorbell" to alert the remote + processor. + # We need a select here so we don't match all nodes with 'arm,primecell' select: properties: compatible: contains: - const: arm,mhu + enum: + - arm,mhu + - arm,mhu-doorbell required: - compatible properties: compatible: - items: - - const: arm,mhu - - const: arm,primecell + oneOf: + - description: Data transfer mode + items: + - const: arm,mhu + - const: arm,primecell + + - description: Doorbell mode + items: + - const: arm,mhu-doorbell + - const: arm,primecell + reg: maxItems: 1 @@ -51,8 +71,11 @@ description: | - const: apb_pclk '#mbox-cells': - description: Index of the channel. - const: 1 + description: | + Set to 1 in data transfer mode and represents index of the channel. + Set to 2 in doorbell mode and represents index of the channel and doorbell + number. + enum: [ 1, 2 ] required: - compatible @@ -63,6 +86,7 @@ description: | additionalProperties: false examples: + # Data transfer mode. - | soc { #address-cells = <2>; @@ -85,3 +109,27 @@ additionalProperties: false mboxes = <&mhuA 1>; /* HP-NonSecure */ }; }; + + # Doorbell mode. + - | + soc { + #address-cells = <2>; + #size-cells = <2>; + + mhuB: mailbox@2b2f0000 { + #mbox-cells = <2>; + compatible = "arm,mhu-doorbell", "arm,primecell"; + reg = <0 0x2b2f0000 0 0x1000>; + interrupts = <0 36 4>, /* LP-NonSecure */ + <0 35 4>, /* HP-NonSecure */ + <0 37 4>; /* Secure */ + clocks = <&clock 0 2 1>; + clock-names = "apb_pclk"; + }; + + mhu_client_scpi: scpi@2f000000 { + compatible = "arm,scpi"; + reg = <0 0x2f000000 0 0x200>; + mboxes = <&mhuB 1 4>; /* HP-NonSecure, 5th doorbell */ + }; + };