Received: by 2002:a05:7412:a9a3:b0:f9:327e:43ab with SMTP id o35csp24233rdh; Mon, 18 Dec 2023 03:17:37 -0800 (PST) X-Google-Smtp-Source: AGHT+IFXbD8SzlG0EULyrUJar9TY+f9sLN0Ssct6VLiyy5+c0rAug/T7hla1DfsxiiATj/LVJjmv X-Received: by 2002:a05:6a20:e592:b0:190:1fe6:fc35 with SMTP id ng18-20020a056a20e59200b001901fe6fc35mr14616742pzb.22.1702898257316; Mon, 18 Dec 2023 03:17:37 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1702898257; cv=none; d=google.com; s=arc-20160816; b=Og6JG+tdigsBB0imbLDMsoxMRVKOpyWlXPEBmTtW7VdQufkeSzee8K3826YIZU4IWM LzjhoFLGGvfnw9RELHOk7qptNlrlZa/TO4c3u76qEucEjeDdrpl29Xz+JdS7ngZZLLrR IdtVQHXKul7LP6W92MfoNZHO76ReHFhPhx4xD1+0SQhKtaU1YkV5NiJJ10Z7SdJ8b9tU a0BHXf7Qxs8jTVnuSMSNtWkBNHcyRpwuSOqwWGPD1sMXaKlDGF/37Hq5Vu0fPWdntbmz 9glytixf7CJD3kPUXviWUst325/ewrpabf3TRAA/gNyg90oBuGrDCaRIzgjBfcml/EGf 0Hrw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=in-reply-to:content-disposition:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:message-id:subject:cc :to:from:date:dkim-signature; bh=RMMQN4fL0Rkhb/rzFdapt0B3GfQ0bvY8GknkrM6K3Vg=; fh=crr73JbbHx70Ihsf7PDSfclo9PVY6m1wWRZmZdy/K44=; b=H7h+XV4/XtX/zZ9a7J6YwY1AQUfm+dhAs5+W4NKXp/K5m5nwbZ8PAHwaDf0qVXStyi p2dNWnz0FIt9vL3xzSo45q8TLs54O080SX3NIzk8BbAVyugLBzm+nQFVy2AaokZ65rlS K77OoF7CCR36c4COrgEcpB4Qb2ELxR3t8zNTjowK2RfOXnbnIKtMrdBIay3GslwkvnR/ w8UMq4XPXwggfuoVmZ5l/k3Oix6L14TpHHcKjIHWyXwXt5V3CN4onYZpWCC1qZO8ffJ6 ovoUqs8Pq4f+Wp7YKgb21oCKKS1WRGdlgn8wPFc7OqEmWjSYEB9J1af0GVP8vZYTIiU2 G8MA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=O+QCe0tq; spf=pass (google.com: domain of linux-kernel+bounces-3419-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-3419-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [2604:1380:40f1:3f00::1]) by mx.google.com with ESMTPS id f31-20020a63555f000000b005bddca8236dsi18014031pgm.699.2023.12.18.03.17.36 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 18 Dec 2023 03:17:37 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-3419-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=O+QCe0tq; spf=pass (google.com: domain of linux-kernel+bounces-3419-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-3419-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id E4991B20A2E for ; Mon, 18 Dec 2023 11:17:29 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id AE34219461; Mon, 18 Dec 2023 11:17:21 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="O+QCe0tq" X-Original-To: linux-kernel@vger.kernel.org Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E05BF19447; Mon, 18 Dec 2023 11:17:20 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 886C4C433C8; Mon, 18 Dec 2023 11:17:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1702898240; bh=jhT+AlpmCfyK9JZxXxSNykpbsTEk5+SjdjTlfBVIDyc=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=O+QCe0tqd2vCDzVikw7J9kmofQTYq3GGZXkDl0HrxHbP1Csw36LyitHS1Fl3/fn4f X5BlFoR5vj6mSuaRKiIFqYBaHds9gAO0Y0KwFHSUDWtN1BmbV70TSciYR4o8q7p9Nu IPrsqG2MlzFfWaqSuRZjdheUCQu18z8ek6PjY7tX9LvBlb9vDKajJCWsUEEJ0H7SSl /M3CaAd/COStCa5jev190of+EqNRFOJDciB+Qz3/mEC7YSTF1wraxrvY+pJc+n6FPn ipb0gXtTglGe5lIfg2DW62WORWLnqgbxlcS8m/SA72azZfkd6AJEqjFeCQCB7FSh1U 7LMWLxFyMB0ig== Date: Mon, 18 Dec 2023 11:17:16 +0000 From: Conor Dooley To: Joshua Yeong Cc: jeeheng.sia@starfivetech.com, leyfoon.tan@starfivetech.com, jassisinghbrar@gmail.com, robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, conor+dt@kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 2/3] dt-bindings: mailbox: starfive: Add StarFive Meu Mailbox Driver Message-ID: <20231218-pawing-unripe-e45ad62ff8c7@spud> References: <20231218061201.98136-1-joshua.yeong@starfivetech.com> <20231218061201.98136-3-joshua.yeong@starfivetech.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="aQrXQ+3ue3EP+Cq/" Content-Disposition: inline In-Reply-To: <20231218061201.98136-3-joshua.yeong@starfivetech.com> --aQrXQ+3ue3EP+Cq/ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Dec 18, 2023 at 02:12:00PM +0800, Joshua Yeong wrote: > The StarFive Meu Mailbox allow communication between AP and SCP cores > through mailbox doorbell. >=20 > Co-developed-by: Sia Jee Heng > Signed-off-by: Sia Jee Heng > Signed-off-by: Joshua Yeong > Reviewed-by: Ley Foon Tan > --- > .../bindings/mailbox/starfive-meu.yaml | 66 +++++++++++++++++++ > 1 file changed, 66 insertions(+) > create mode 100644 Documentation/devicetree/bindings/mailbox/starfive-me= u.yaml >=20 > diff --git a/Documentation/devicetree/bindings/mailbox/starfive-meu.yaml = b/Documentation/devicetree/bindings/mailbox/starfive-meu.yaml > new file mode 100644 > index 000000000000..dbc5cfdb90ff > --- /dev/null > +++ b/Documentation/devicetree/bindings/mailbox/starfive-meu.yaml > @@ -0,0 +1,66 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/mailbox/starfive-meu.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: StarFive MEU Mailbox Controller > + > +maintainers: > + - Jee Heng Sia > + - Joshua Yeong > + > +description: | > + StarFive's Message-Exchange-Unit (MEU) is a mailbox controller that ha= s 62 > + independent doorbells. Each MEU channel consist of 31 doorbells and co= nsist of > + a pair of Tx/Rx links that shall communicates with remote processor. T= he > + sender set the bit in the SET register to indicate data readiness for = the > + receiver. An interrupt will be raised whenever receiving notification = doorbell > + from remote processor. The receiver will clear the bit in the CLR regi= ster > + upon handling the doorbell notification. The sender should poll the ST= AT > + register before starting any transaction to ensure all on-going doorbe= lls are > + processed. What is/are the consumer(s) of this mailbox? Is part of your RPMI implementation? Cheers, Conor. > + > +properties: > + compatible: > + enum: > + - starfive,jh8100-meu > + > + reg: > + maxItems: 1 > + > + interrupts: > + items: > + - description: mailbox0 > + - description: mailbox1 > + > + '#mbox-cells': > + description: represents index of the mailbox/doorbell paired channel > + channel 0 - 30 for mailbox0 doorbell > + channel 31 - 61 for mailbox1 doorbell > + const: 1 > + > +required: > + - compatible > + - reg > + - interrupts > + - '#mbox-cells' > + > +additionalProperties: false > + > +examples: > + - | > + soc { > + #address-cells =3D <2>; > + #size-cells =3D <2>; > + > + meu: mailbox@1f370000 { > + compatible =3D "starfive,jh8100-meu"; > + reg =3D <0x0 0x1f370000 0 0x8000>; > + interrupts =3D <170>, /* Mailbox0 */ > + <171>; /* Mailbox1 */ > + #mbox-cells =3D <1>; > + }; > + }; > + > +... > --=20 > 2.25.1 >=20 --aQrXQ+3ue3EP+Cq/ Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEABYIAB0WIQRh246EGq/8RLhDjO14tDGHoIJi0gUCZYAqPAAKCRB4tDGHoIJi 0pAWAP0UxVroFOC8+v7rhvp42LiCfmH/2N8IRe7QzwShM9OO+wD/ZYMubBEEwj3W kqYsynjngk1KxjeF1Ez0nidDqz9ndgQ= =vSfH -----END PGP SIGNATURE----- --aQrXQ+3ue3EP+Cq/--