From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id EF32CC67861 for ; Mon, 8 Apr 2024 11:09:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:References: Message-ID:Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=JaTnFfrH5il2UVtV90CXEgcmeU5C/JoDeywzpMG1zMw=; b=E01bCdGELbOz4N lHEvFrYJ/b/Kfj2BxV9+C9WbDXti7AhFl96fNyt54W3ESVGSJb/AKdtWYXvjPQnY7cL7dw/lcs64S tVtUg76FyyCj1kep7nANDivb2Rbqn3XG5dVQItO84pNmE1DHrvsjCdRZX+A6Mxf/lXWVsbLHEmJVY bs7UlDkfk33BAlpz42ct0b+fKRxAUdPUKRB0L6POw7Fx+2QoeHyenITLj8p8K0SejYm6Y6JoTNHwE XWjmFiXTdvSs40wPdSXAc+etimpTC8PkR0ya329THSTe+ghMAHAx4i039+V0n2pPb+bNtGfbApPnw f9Jr+FVnh6T65df0OMYg==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1rtmsT-0000000FLXn-1S2Y; Mon, 08 Apr 2024 11:09:29 +0000 Received: from foss.arm.com ([217.140.110.172]) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1rtmsP-0000000FLXE-3cEo for linux-arm-kernel@lists.infradead.org; Mon, 08 Apr 2024 11:09:27 +0000 Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 5F921DA7; Mon, 8 Apr 2024 04:09:52 -0700 (PDT) Received: from pluto (unknown [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id A97743F766; Mon, 8 Apr 2024 04:09:20 -0700 (PDT) Date: Mon, 8 Apr 2024 12:09:18 +0100 From: Cristian Marussi To: Jassi Brar Cc: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, sudeep.holla@arm.com, robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, conor+dt@kernel.org Subject: Re: [PATCH v3 1/2] dt-bindings: mailbox: arm,mhuv3: Add bindings Message-ID: References: <20240404062347.3219795-1-cristian.marussi@arm.com> <20240404062347.3219795-2-cristian.marussi@arm.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240408_040926_040046_AC061A2A X-CRM114-Status: GOOD ( 55.59 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org T24gU3VuLCBBcHIgMDcsIDIwMjQgYXQgMDY6Mzg6NTJQTSAtMDUwMCwgSmFzc2kgQnJhciB3cm90 ZToKPiBPbiBUaHUsIEFwciA0LCAyMDI0IGF0IDE6MjXigK9BTSBDcmlzdGlhbiBNYXJ1c3NpCj4g PGNyaXN0aWFuLm1hcnVzc2lAYXJtLmNvbT4gd3JvdGU6Cj4gPgo+ID4gQWRkIGJpbmRpbmdzIGZv ciB0aGUgQVJNIE1IVXYzIE1haWxib3ggY29udHJvbGxlci4KPiA+CgpIaSwKCj4gPiBTaWduZWQt b2ZmLWJ5OiBDcmlzdGlhbiBNYXJ1c3NpIDxjcmlzdGlhbi5tYXJ1c3NpQGFybS5jb20+Cj4gPiAt LS0KPiA+IHYyIC0+IHYzCj4gPiAtIGZpeGVkIHNwdXJpb3VzIHRhYnMgaW4gZHRfYmluZGluZ19j aGVjawo+ID4gdjEgLT4gdjIKPiA+IC0gY2xhcmlmaWVkIGV4dGVuc2lvbiBkZXNjcmlwdGlvbnMg YXJvdW5kIGNvbmZpZ3VyYWJpbGl0eSBhbmQgZGlzY292ZXJhYmlsaXR5Cj4gPiAtIHJlbW92ZWQg dW51c2VkIGxhYmVscyBmcm9tIHRoZSBleGFtcGxlCj4gPiAtIHVzaW5nIHBhdHRlcm4gcHJvcGVy dGllcyB0byBkZWZpbmUgaW50ZXJydXB0LW5hbWVzCj4gPiAtIGJ1bXBlZCBpbnRlcnJ1cHQgbWF4 SXRlbXMgdG8gNzQgKGFsbG93aW5nIHVvIHRvIDggY2hhbm5lbHMgcGVyIGV4dGVuc2lvbikKPiA+ IC0tLQo+ID4gIC4uLi9iaW5kaW5ncy9tYWlsYm94L2FybSxtaHV2My55YW1sICAgICAgICAgICB8 IDIxNyArKysrKysrKysrKysrKysrKysKPiA+ICAxIGZpbGUgY2hhbmdlZCwgMjE3IGluc2VydGlv bnMoKykKPiA+ICBjcmVhdGUgbW9kZSAxMDA2NDQgRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2Jp bmRpbmdzL21haWxib3gvYXJtLG1odXYzLnlhbWwKPiA+Cj4gPiBkaWZmIC0tZ2l0IGEvRG9jdW1l bnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL21haWxib3gvYXJtLG1odXYzLnlhbWwgYi9Eb2N1 bWVudGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3MvbWFpbGJveC9hcm0sbWh1djMueWFtbAo+ID4g bmV3IGZpbGUgbW9kZSAxMDA2NDQKPiA+IGluZGV4IDAwMDAwMDAwMDAwMC4uMzJhOGJiNzExNDY0 Cj4gPiAtLS0gL2Rldi9udWxsCj4gPiArKysgYi9Eb2N1bWVudGF0aW9uL2RldmljZXRyZWUvYmlu ZGluZ3MvbWFpbGJveC9hcm0sbWh1djMueWFtbAo+ID4gQEAgLTAsMCArMSwyMTcgQEAKPiA+ICsj IFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiAoR1BMLTIuMC1vbmx5IE9SIEJTRC0yLUNsYXVzZSkK PiA+ICslWUFNTCAxLjIKPiA+ICstLS0KPiA+ICskaWQ6IGh0dHA6Ly9kZXZpY2V0cmVlLm9yZy9z Y2hlbWFzL21haWxib3gvYXJtLG1odXYzLnlhbWwjCj4gPiArJHNjaGVtYTogaHR0cDovL2Rldmlj ZXRyZWUub3JnL21ldGEtc2NoZW1hcy9jb3JlLnlhbWwjCj4gPiArCj4gPiArdGl0bGU6IEFSTSBN SFV2MyBNYWlsYm94IENvbnRyb2xsZXIKPiA+ICsKPiA+ICttYWludGFpbmVyczoKPiA+ICsgIC0g U3VkZWVwIEhvbGxhIDxzdWRlZXAuaG9sbGFAYXJtLmNvbT4KPiA+ICsgIC0gQ3Jpc3RpYW4gTWFy dXNzaSA8Y3Jpc3RpYW4ubWFydXNzaUBhcm0uY29tPgo+ID4gKwo+ID4gK2Rlc2NyaXB0aW9uOiB8 Cj4gPiArICBUaGUgQXJtIE1lc3NhZ2UgSGFuZGxpbmcgVW5pdCAoTUhVKSBWZXJzaW9uIDMgaXMg YSBtYWlsYm94IGNvbnRyb2xsZXIgdGhhdAo+ID4gKyAgZW5hYmxlcyB1bmlkaXJlY3Rpb25hbCBj b21tdW5pY2F0aW9ucyB3aXRoIHJlbW90ZSBwcm9jZXNzb3JzIHRocm91Z2ggdmFyaW91cwo+ID4g KyAgcG9zc2libGUgdHJhbnNwb3J0IHByb3RvY29scy4KPiA+ICsgIFRoZSBjb250cm9sbGVyIGNh biBvcHRpb25hbGx5IHN1cHBvcnQgYSB2YXJ5aW5nIG51bWJlciBvZiBleHRlbnNpb25zIHRoYXQs IGluCj4gPiArICB0dXJuLCBlbmFibGUgZGlmZmVyZW50IGtpbmRzIG9mIHRyYW5zcG9ydCB0byBi ZSB1c2VkIGZvciBjb21tdW5pY2F0aW9uLgo+ID4gKyAgTnVtYmVyLCB0eXBlIGFuZCBjaGFyYWN0 ZXJpc3RpY3Mgb2YgZWFjaCBzdXBwb3J0ZWQgZXh0ZW5zaW9uIGNhbiBiZSBkaXNjb3ZlcmVkCj4g PiArICBkeW5hbWljYWxseSBhdCBydW50aW1lLgo+ID4gKwo+ID4gKyAgR2l2ZW4gdGhlIHVuaWRp cmVjdGlvbmFsIG5hdHVyZSBvZiB0aGUgY29udHJvbGxlciwgYW4gTUhVdjMgbWFpbGJveCBjb250 cm9sbGVyCj4gPiArICBpcyBjb21wb3NlZCBvZiBhIE1IVSBTZW5kZXIgKE1IVVMpIGNvbnRhaW5p bmcgYSBQb3N0Qm94IChQQlgpIGJsb2NrIGFuZCBhIE1IVQo+ID4gKyAgUmVjZWl2ZXIgKE1IVVIp IGNvbnRhaW5pbmcgYSBNYWlsQm94IChNQlgpIGJsb2NrLCB3aGVyZQo+ID4gKwo+ID4gKyAgIFBC WCBpcyB1c2VkIHRvCj4gPiArICAgICAgLSBDb25maWd1cmUgdGhlIE1IVQo+ID4gKyAgICAgIC0g U2VuZCBUcmFuc2ZlcnMgdG8gdGhlIFJlY2VpdmVyCj4gPiArICAgICAgLSBPcHRpb25hbGx5IHJl Y2VpdmUgYWNrbm93bGVkZ21lbnQgb2YgYSBUcmFuc2ZlciBmcm9tIHRoZSBSZWNlaXZlcgo+ID4g Kwo+ID4gKyAgIE1CWCBpcyB1c2VkIHRvCj4gPiArICAgICAgLSBDb25maWd1cmUgdGhlIE1IVQo+ ID4gKyAgICAgIC0gUmVjZWl2ZSBUcmFuc2ZlcnMgZnJvbSB0aGUgU2VuZGVyCj4gPiArICAgICAg LSBPcHRpb25hbGx5IGFja25vd2xlZGdlIFRyYW5zZmVycyBzZW50IGJ5IHRoZSBTZW5kZXIKPiA+ ICsKPiA+ICsgIEJvdGggUEJYIGFuZCBNQlggbmVlZCB0byBiZSBwcmVzZW50IGFuZCBkZWZpbmVk IGluIHRoZSBEVCBkZXNjcmlwdGlvbiBpZiB5b3UKPiA+ICsgIG5lZWQgdG8gZXN0YWJsaXNoIGEg YmlkaXJlY3Rpb25hbCBjb21tdW5pY2F0aW9uLCBzaW5jZSB5b3Ugd2lsbCBoYXZlIHRvCj4gPiAr ICBhY3F1aXJlIHR3byBkaXN0aW5jdCB1bmlkaXJlY3Rpb25hbCBjaGFubmVscywgb25lIGZvciBl YWNoIGJsb2NrLgo+ID4gKwo+ID4gKyAgQXMgYSBjb25zZXF1ZW5jZSBib3RoIGJsb2NrcyBuZWVk cyB0byBiZSByZXByZXNlbnRlZCBzZXBhcmF0ZWx5IGFuZCBzcGVjaWZpZWQKPiA+ICsgIGFzIGRp c3RpbmN0IERUIG5vZGVzIGluIG9yZGVyIHRvIHByb3Blcmx5IGRlc2NyaWJlIHRoZWlyIHJlc291 cmNlcy4KPiA+ICsKPiA+ICsgIE5vdGUgdGhhdCwgdGhvdWdoLCB0aGFua3MgdG8gdGhlIHJ1bnRp bWUgZGlzY292ZXJhYmlsaXR5LCB0aGVyZSBpcyBubyBuZWVkIHRvCj4gPiArICBpZGVudGlmeSB0 aGUgdHlwZSBvZiBibG9ja3Mgd2l0aCBkaXN0aW5jdCBjb21wYXRpYmxlcy4KPiA+ICsKPiA+ICsg IEZvbGxvd2luZyBhcmUgdGhlIE1IVXYzIHBvc3NpYmxlIGV4dGVuc2lvbnMuCj4gPiArCj4gPiAr ICAtIERvb3JiZWxsIEV4dGVuc2lvbiAoREJFKTogREJFIGRlZmluZXMgYSB0eXBlIG9mIGNoYW5u ZWwgY2FsbGVkIGEgRG9vcmJlbGwKPiA+ICsgICAgQ2hhbm5lbCAoREJDSCkuIERCQ0ggZW5hYmxl cyBhIHNpbmdsZSBiaXQgVHJhbnNmZXIgdG8gYmUgc2VudCBmcm9tIHRoZQo+ID4gKyAgICBTZW5k ZXIgdG8gUmVjZWl2ZXIuIFRoZSBUcmFuc2ZlciBpbmRpY2F0ZXMgdGhhdCBhbiBldmVudCBoYXMg b2NjdXJyZWQuCj4gPiArICAgIFdoZW4gREJFIGlzIGltcGxlbWVudGVkLCB0aGUgbnVtYmVyIG9m IERCQ0hzIHRoYXQgYW4gaW1wbGVtZW50YXRpb24gb2YgdGhlCj4gPiArICAgIE1IVSBjYW4gc3Vw cG9ydCBpcyBiZXR3ZWVuIDEgYW5kIDEyOCwgbnVtYmVyZWQgc3RhcnRpbmcgZnJvbSAwIGluIGFz Y2VuZGluZwo+ID4gKyAgICBvcmRlciBhbmQgZGlzY292ZXJhYmxlIGF0IHJ1bi10aW1lLgo+ID4g KyAgICBFYWNoIERCQ0ggY29udGFpbnMgMzIgaW5kaXZpZHVhbCBmaWVsZHMsIHJlZmVycmVkIHRv IGFzIGZsYWdzLCBlYWNoIG9mIHdoaWNoCj4gPiArICAgIGNhbiBiZSB1c2VkIGluZGVwZW5kZW50 bHkuIEl0IGlzIHBvc3NpYmxlIGZvciB0aGUgU2VuZGVyIHRvIHNlbmQgbXVsdGlwbGUKPiA+ICsg ICAgVHJhbnNmZXJzIGF0IG9uY2UgdXNpbmcgYSBzaW5nbGUgREJDSCwgc28gbG9uZyBhcyBlYWNo IFRyYW5zZmVyIHVzZXMKPiA+ICsgICAgYSBkaWZmZXJlbnQgZmxhZyBpbiB0aGUgREJDSC4KPiA+ ICsgICAgT3B0aW9uYWxseSwgZGF0YSBtYXkgYmUgdHJhbnNtaXR0ZWQgdGhyb3VnaCBhbiBvdXQt b2YtYmFuZCBzaGFyZWQgbWVtb3J5Cj4gPiArICAgIHJlZ2lvbiwgd2hlcmVpbiB0aGUgTUhVIERv b3JiZWxsIGlzIHVzZWQgc3RyaWN0bHkgYXMgYW4gaW50ZXJydXB0IGdlbmVyYXRpb24KPiA+ICsg ICAgbWVjaGFuaXNtLCBidXQgdGhpcyBpcyBvdXQgb2YgdGhlIHNjb3BlIG9mIHRoZXNlIGJpbmRp bmdzLgo+ID4gKwo+ID4gKyAgLSBGYXN0Q2hhbm5lbCBFeHRlbnNpb24gKEZDRSk6IEZDRSBkZWZp bmVzIGEgdHlwZSBvZiBjaGFubmVsIGNhbGxlZCBhIEZhc3QKPiA+ICsgICAgQ2hhbm5lbCAoRkNI KS4gRkNIIGlzIGludGVuZGVkIGZvciBsb3dlciBvdmVyaGVhZCBjb21tdW5pY2F0aW9uIGJldHdl ZW4KPiA+ICsgICAgU2VuZGVyIGFuZCBSZWNlaXZlciBhdCB0aGUgZXhwZW5zZSBvZiBkZXRlcm1p bmlzbS4gQW4gRkNIIGFsbG93cyB0aGUgU2VuZGVyCj4gPiArICAgIHRvIHVwZGF0ZSB0aGUgY2hh bm5lbCB2YWx1ZSBhdCBhbnkgdGltZSwgcmVnYXJkbGVzcyBvZiB3aGV0aGVyIHRoZSBwcmV2aW91 cwo+ID4gKyAgICB2YWx1ZSBoYXMgYmVlbiBzZWVuIGJ5IHRoZSBSZWNlaXZlci4gV2hlbiB0aGUg UmVjZWl2ZXIgcmVhZHMgdGhlIGNoYW5uZWwncwo+ID4gKyAgICBjb250ZW50IGl0IGdldHMgdGhl IGxhc3QgdmFsdWUgd3JpdHRlbiB0byB0aGUgY2hhbm5lbC4KPiA+ICsgICAgRkNIIGlzIGNvbnNp ZGVyZWQgbG9zc3kgaW4gbmF0dXJlLCBhbmQgbWVhbnMgdGhhdCB0aGUgU2VuZGVyIGhhcyBubyB3 YXkgb2YKPiA+ICsgICAga25vd2luZyBpZiwgb3Igd2hlbiwgdGhlIFJlY2VpdmVyIHdpbGwgYWN0 IG9uIHRoZSBUcmFuc2Zlci4KPiA+ICsgICAgRkNIcyBhcmUgZXhwZWN0ZWQgdG8gYmVoYXZlIGFz IFJBTSB3aGljaCBnZW5lcmF0ZXMgaW50ZXJydXB0cyB3aGVuIHdyaXRlcwo+ID4gKyAgICBvY2N1 ciB0byB0aGUgbG9jYXRpb25zIHdpdGhpbiB0aGUgUkFNLgo+ID4gKyAgICBXaGVuIEZDRSBpcyBp bXBsZW1lbnRlZCwgdGhlIG51bWJlciBvZiBGQ0hzIHRoYXQgYW4gaW1wbGVtZW50YXRpb24gb2Yg dGhlCj4gPiArICAgIE1IVSBjYW4gc3VwcG9ydCBpcyBiZXR3ZWVuIDEtMTAyNCwgaWYgdGhlIEZh c3RDaGFubmVsIHdvcmQtc2l6ZSBpcyAzMi1iaXRzLAo+ID4gKyAgICBvciBiZXR3ZWVuIDEtNTEy LCB3aGVuIHRoZSBGYXN0Q2hhbm5lbCB3b3JkLXNpemUgaXMgNjQtYml0cy4KPiA+ICsgICAgRkNI cyBhcmUgbnVtYmVyZWQgZnJvbSAwIGluIGFzY2VuZGluZyBvcmRlci4KPiA+ICsgICAgTm90ZSB0 aGF0IHRoZSBudW1iZXIgb2YgRkNIcyBhbmQgdGhlIHdvcmQtc2l6ZSBhcmUgaW1wbGVtZW50YXRp b24gZGVmaW5lZCwKPiA+ICsgICAgbm90IGNvbmZpZ3VyYWJsZSBidXQgZGlzY292ZXJhYmxlIGF0 IHJ1bi10aW1lLgo+ID4gKyAgICBPcHRpb25hbGx5LCBkYXRhIG1heSBiZSB0cmFuc21pdHRlZCB0 aHJvdWdoIGFuIG91dC1vZi1iYW5kIHNoYXJlZCBtZW1vcnkKPiA+ICsgICAgcmVnaW9uLCB3aGVy ZWluIHRoZSBNSFUgRmFzdENoYW5uZWwgaXMgdXNlZCBhcyBhbiBpbnRlcnJ1cHQgZ2VuZXJhdGlv bgo+ID4gKyAgICBtZWNoYW5pc20gd2hpY2ggY2FycmllcyBhbHNvIGEgcG9pbnRlciB0byBzdWNo IG91dC1vZi1iYW5kIGRhdGEsIGJ1dCB0aGlzCj4gPiArICAgIGlzIG91dCBvZiB0aGUgc2NvcGUg b2YgdGhlc2UgYmluZGluZ3MuCj4gPiArCj4gPiArICAtIEZJRk8gRXh0ZW5zaW9uIChGRSk6IEZF IGRlZmluZXMgYSBDaGFubmVsIHR5cGUgY2FsbGVkIGEgRklGTyBDaGFubmVsIChGRkNIKS4KPiA+ ICsgICAgRkZDSCBhbGxvd3MgYSBTZW5kZXIgdG8gc2VuZAo+ID4gKyAgICAgICAtIE11bHRpcGxl IFRyYW5zZmVycyB0byB0aGUgUmVjZWl2ZXIgd2l0aG91dCBoYXZpbmcgdG8gd2FpdCBmb3IgdGhl Cj4gPiArICAgICAgICAgcHJldmlvdXMgVHJhbnNmZXIgdG8gYmUgYWNrbm93bGVkZ2VkIGJ5IHRo ZSBSZWNlaXZlciwgYXMgbG9uZyBhcyB0aGUKPiA+ICsgICAgICAgICBGSUZPIGhhcyByb29tIGZv ciB0aGUgVHJhbnNmZXIuCj4gPiArICAgICAgIC0gVHJhbnNmZXJzIHdoaWNoIHJlcXVpcmUgdGhl IFJlY2VpdmVyIHRvIHByb3ZpZGUgYWNrbm93bGVkZ21lbnQuCj4gPiArICAgICAgIC0gVHJhbnNm ZXJzIHdoaWNoIGhhdmUgaW4tYmFuZCBwYXlsb2FkLgo+ID4gKyAgICBJbiBhbGwgY2FzZXMsIHRo ZSBkYXRhIGlzIGd1YXJhbnRlZWQgdG8gYmUgb2JzZXJ2ZWQgYnkgdGhlIFJlY2VpdmVyIGluIHRo ZQo+ID4gKyAgICBzYW1lIG9yZGVyIHdoaWNoIHRoZSBTZW5kZXIgc2VudCBpdC4KPiA+ICsgICAg V2hlbiBGRSBpcyBpbXBsZW1lbnRlZCwgdGhlIG51bWJlciBvZiBGRkNIcyB0aGF0IGFuIGltcGxl bWVudGF0aW9uIG9mIHRoZQo+ID4gKyAgICBNSFUgY2FuIHN1cHBvcnQgaXMgYmV0d2VlbiAxIGFu ZCA2NCwgbnVtYmVyZWQgc3RhcnRpbmcgZnJvbSAwIGluIGFzY2VuZGluZwo+ID4gKyAgICBvcmRl ci4gVGhlIG51bWJlciBvZiBGRkNIcywgdGhlaXIgZGVwdGggKHNhbWUgZm9yIGFsbCBpbXBsZW1l bnRlZCBGRkNIcykgYW5kCj4gPiArICAgIHRoZSBhY2Nlc3MtZ3JhbnVsYXJpdHkgYXJlIGltcGxl bWVudGF0aW9uIGRlZmluZWQsIG5vdCBjb25maWd1cmFibGUgYnV0Cj4gPiArICAgIGRpc2NvdmVy YWJsZSBhdCBydW4tdGltZS4KPiA+ICsgICAgT3B0aW9uYWxseSwgYWRkaXRpb25hbCBkYXRhIG1h eSBiZSB0cmFuc21pdHRlZCB0aHJvdWdoIGFuIG91dC1vZi1iYW5kIHNoYXJlZAo+ID4gKyAgICBt ZW1vcnkgcmVnaW9uLCB3aGVyZWluIHRoZSBNSFUgRklGTyBpcyB1c2VkIHRvIHRyYW5zbWl0LCBp biBvcmRlciwgYSBzbWFsbAo+ID4gKyAgICBwYXJ0IG9mIHRoZSBwYXlsb2FkIChsaWtlIGEgaGVh ZGVyKSBhbmQgYSByZWZlcmVuY2UgdG8gdGhlIHNoYXJlZCBtZW1vcnkKPiA+ICsgICAgYXJlYSBo b2xkaW5nIHRoZSByZW1haW5pbmcsIGJpZ2dlciwgY2h1bmsgb2YgdGhlIHBheWxvYWQsIGJ1dCB0 aGlzIGlzIG91dCBvZgo+ID4gKyAgICB0aGUgc2NvcGUgb2YgdGhlc2UgYmluZGluZ3MuCj4gPiAr Cj4gPiArcHJvcGVydGllczoKPiA+ICsgIGNvbXBhdGlibGU6Cj4gPiArICAgIGNvbnN0OiBhcm0s bWh1djMKPiA+ICsKPiA+ICsgIHJlZzoKPiA+ICsgICAgbWF4SXRlbXM6IDEKPiA+ICsKPiA+ICsg IGludGVycnVwdHM6Cj4gPiArICAgIG1pbkl0ZW1zOiAxCj4gPiArICAgIG1heEl0ZW1zOiA3NAo+ ID4gKwo+ID4gKyAgaW50ZXJydXB0LW5hbWVzOgo+ID4gKyAgICBkZXNjcmlwdGlvbjogfAo+ID4g KyAgICAgIFRoZSBNSFV2MyBjb250cm9sbGVyIGdlbmVyYXRlcyBhIG51bWJlciBvZiBldmVudHMg c29tZSBvZiB3aGljaCBhcmUgdXNlZAo+ID4gKyAgICAgIHRvIGdlbmVyYXRlIGludGVycnVwdHM7 IGFzIGEgY29uc2VxdWVuY2UgaXQgY2FuIGV4cG9zZSBhIHZhcnlpbmcgbnVtYmVyIG9mCj4gPiAr ICAgICAgb3B0aW9uYWwgUEJYL01CWCBpbnRlcnJ1cHRzLCByZXByZXNlbnRpbmcgdGhlIGV2ZW50 cyBnZW5lcmF0ZWQgZHVyaW5nIHRoZQo+ID4gKyAgICAgIG9wZXJhdGlvbiBvZiB0aGUgdmFyaW91 cyB0cmFuc3BvcnQgcHJvdG9jb2xzIGFzc29jaWF0ZWQgd2l0aCBkaWZmZXJlbnQKPiA+ICsgICAg ICBleHRlbnNpb25zLiBBbGwgaW50ZXJydXB0cyBvZiB0aGUgTUhVIGFyZSBsZXZlbC1zZW5zaXRp dmUuCj4gPiArICAgICAgU29tZSBvZiB0aGVzZSBvcHRpb25hbCBpbnRlcnJ1cHRzIGFyZSBkZWZp bmVkIHBlci1jaGFubmVsLCB3aGVyZSB0aGUKPiA+ICsgICAgICBudW1iZXIgb2YgY2hhbm5lbHMg ZWZmZWN0aXZlbHkgYXZhaWxhYmxlIGlzIGltcGxlbWVudGF0aW9uIGRlZmluZWQgYW5kCj4gPiAr ICAgICAgcnVuLXRpbWUgZGlzY292ZXJhYmxlLgo+ID4gKyAgICAgIEluIHRoZSBmb2xsb3dpbmcg bmFtZXMgYXJlIGVudW1lcmF0ZWQgdXNpbmcgcGF0dGVybnMsIHdpdGggcGVyLWNoYW5uZWwKPiA+ ICsgICAgICBpbnRlcnJ1cHRzIGltcGxpY2l0bHkgY2FwcGVkIGF0IHRoZSBtYXhpbXVtIGNoYW5u ZWxzIGFsbG93ZWQgYnkgdGhlCj4gPiArICAgICAgc3BlY2lmaWNhdGlvbiBmb3IgZWFjaCBleHRl bnNpb24gdHlwZS4KPiA+ICsgICAgICBGb3IgdGhlIHNha2Ugb2Ygc2ltcGxpY2l0eSBtYXhJdGVt cyBpcyBhbnl3YXkgY2FwcGVkIHRvIGEgbW9zdCBwbGF1c2libGUKPiA+ICsgICAgICBudW1iZXIs IGFzc3VtaW5nIHdheSBsZXNzIGNoYW5uZWxzIHdvdWxkIGJlIGltcGxlbWVudGVkIHRoYW4gYWN0 dWFsbHkKPiA+ICsgICAgICBwb3NzaWJsZS4KPiA+ICsKPiA+ICsgICAgICBUaGUgb25seSBtYW5k YXRvcnkgaW50ZXJydXB0cyBvbiB0aGUgTUhVIGFyZToKPiA+ICsgICAgICAgIC0gY29tYmluZWQK PiA+ICsgICAgICAgIC0gbWJ4LWZjaC14ZmVyLTxOPiBidXQgb25seSBpZiBtYngtZmNncnAteGZl ci08Tj4gaXMgbm90IGltcGxlbWVudGVkLgo+ID4gKwo+ID4gKyAgICBtaW5JdGVtczogMQo+ID4g KyAgICBtYXhJdGVtczogNzQKPiA+ICsgICAgaXRlbXM6Cj4gPiArICAgICAgb25lT2Y6Cj4gPiAr ICAgICAgICAtIGNvbnN0OiBjb21iaW5lZAo+ID4gKyAgICAgICAgICBkZXNjcmlwdGlvbjogUEJY L01CWCBDb21iaW5lZCBpbnRlcnJ1cHQKPiA+ICsgICAgICAgIC0gY29uc3Q6IGNvbWJpbmVkLWZm Y2gKPiA+ICsgICAgICAgICAgZGVzY3JpcHRpb246IFBCWC9NQlggRklGTyBDb21iaW5lZCBpbnRl cnJ1cHQKPiA+ICsgICAgICAgIC0gcGF0dGVybjogJ15mZmNoLWxvdy10aWRlLVswLTldKyQnCj4g PiArICAgICAgICAgIGRlc2NyaXB0aW9uOiBQQlgvTUJYIEZJRk8gQ2hhbm5lbCA8Tj4gTG93IFRp ZGUgaW50ZXJydXB0Cj4gPiArICAgICAgICAtIHBhdHRlcm46ICdeZmZjaC1oaWdoLXRpZGUtWzAt OV0rJCcKPiA+ICsgICAgICAgICAgZGVzY3JpcHRpb246IFBCWC9NQlggRklGTyBDaGFubmVsIDxO PiBIaWdoIFRpZGUgaW50ZXJydXB0Cj4gPiArICAgICAgICAtIHBhdHRlcm46ICdeZmZjaC1mbHVz aC1bMC05XSskJwo+ID4gKyAgICAgICAgICBkZXNjcmlwdGlvbjogUEJYL01CWCBGSUZPIENoYW5u ZWwgPE4+IEZsdXNoIGludGVycnVwdAo+ID4gKyAgICAgICAgLSBwYXR0ZXJuOiAnXm1ieC1kYmNo LXhmZXItWzAtOV0rJCcKPiA+ICsgICAgICAgICAgZGVzY3JpcHRpb246IE1CWCBEb29yYmVsbCBD aGFubmVsIDxOPiBUcmFuc2ZlciBpbnRlcnJ1cHQKPiA+ICsgICAgICAgIC0gcGF0dGVybjogJ15t YngtZmNoLXhmZXItWzAtOV0rJCcKPiA+ICsgICAgICAgICAgZGVzY3JpcHRpb246IE1CWCBGYXN0 Q2hhbm5lbCA8Tj4gVHJhbnNmZXIgaW50ZXJydXB0Cj4gPiArICAgICAgICAtIHBhdHRlcm46ICde bWJ4LWZjaGdycC14ZmVyLVswLTldKyQnCj4gPiArICAgICAgICAgIGRlc2NyaXB0aW9uOiBNQlgg RmFzdENoYW5uZWwgPE4+IEdyb3VwIFRyYW5zZmVyIGludGVycnVwdAo+ID4gKyAgICAgICAgLSBw YXR0ZXJuOiAnXm1ieC1mZmNoLXhmZXItWzAtOV0rJCcKPiA+ICsgICAgICAgICAgZGVzY3JpcHRp b246IE1CWCBGSUZPIENoYW5uZWwgPE4+IFRyYW5zZmVyIGludGVycnVwdAo+ID4gKyAgICAgICAg LSBwYXR0ZXJuOiAnXnBieC1kYmNoLXhmZXItYWNrLVswLTldKyQnCj4gPiArICAgICAgICAgIGRl c2NyaXB0aW9uOiBQQlggRG9vcmJlbGwgQ2hhbm5lbCA8Tj4gVHJhbnNmZXIgQWNrIGludGVycnVw dAo+ID4gKyAgICAgICAgLSBwYXR0ZXJuOiAnXnBieC1mZmNoLXhmZXItYWNrLVswLTldKyQnCj4g PiArICAgICAgICAgIGRlc2NyaXB0aW9uOiBQQlggRklGTyBDaGFubmVsIDxOPiBUcmFuc2ZlciBB Y2sgaW50ZXJydXB0Cj4gPiArCj4gQ2FuIHdlIGhhdmUgb3B0aW9uYWwgc3Vibm9kZXMgKHdpdGgg ZGlmZmVyZW50IHByb3BlcnRpZXMgYXMgcmVxdWlyZWQpCj4gZm9yIGVhY2ggZXh0ZW5zaW9uIHR5 cGUgPwo+CgpOb3Qgc3VyZSBpZiBJIGhhdmUgdW5kZXJzdG9vZCBwcm9wZXJseSB5b3UgcmVxdWVz dCwgYnV0IHRoZSB0eXBlIG9mIGV4dGVuc2lvbnMKcHJlc2VudCBpbiBhIFBCWC9NQlggYmxvY2sg Y2FuIGJlIGRpc2NvdmVyZWQgYXQgcnVudGltZSB0b2dldGhlciB3aXRoIHRoZWlyCmNoYXJhY3Rl cmlzdGljcyAobGlrZSB0aGUgbnVtYmVyIG9mIGNoYW5uZWxzKSBzbyB0aGUgc3BlY2lmaWMgRFQg cHJvcGVydGllcwpjYW4gYmUgc2VhcmNoZWQgKG9yIE5PVCkgYmFzZWQgb24gdGhlIGZlYXR1cmVz IGRpc2NvdmVyZWQgYXQgcnVuLXRpbWU6CmFyZSB5b3UgYXNraW5nIGZvciBzdWJub2RlcyBhcyBh IG1lYW5zIG9mIGFkZGluZyBjbGFyaXR5IHRvIHdoYXQgY2FuIGJlCmRlZmluZWQgaW4gYSBibG9j ayBkZXBlbmRpbmcgb24gd2hhdCBpdCBpcyAoUEJYIHZzIE1CWCkgYW5kIHdoYXQKZXh0ZW5zaW9u cyBpdCBoYXMgPwoKaWYgdGhhdCBpcyB0aGUgcmVhc29uIC4uLiB0aGUgY29udm9sdXRlZCBuYW1l cyBsaWtlIHBieC9tYngtZGJjaC0gZXRjLi4uCndhcyBteSBhdHRlbXB0IGF0IHRoaGF0IDpEIC4u LiB0byBnaXZlIGEgaGludCBhdCB3aGF0IHlvdSBjYW4gZGVmaW5lIGluIGEgUEJYCnZzIE1CWCBi bG9jayBhbmQgd2hhdCBpcyByZWxhdGVkIHRvIGVhY2ggZXh0ZW5zaW9ucy4uLgoKTm90ZSB0aGF0 LCB0aG91Z2gsIHNpbmNlIHRoZSBQQlgvTUJYIGJsb2NrcyBhcmUgZGlzY292ZXJhYmxlIGF0IHJ1 bnRpbWUgYXMgc3VjaCwKdGhleSBhcmUgbm90IGlkZW50aWZpZWQgYXMgc3VjaCBpbiB0aGUgRFQg KHNhbWUgY29tcGF0aWJsZSkgc28gSSB3b3VsZCBub3QgaGF2ZQphbnl3YXl5IHRoZSBjYXBhYmls aXR5IHRvIGNoZWNrIGluIHRoZSBEVCB3aGljaCBpcyB3aGljaCAoUEJYL01CWCkgYW5kIGlmIHRo ZQpwcm9wZXJ0aWVzIGFyZSBhcHByb3ByaWF0ZSBvciBub3QsIG5vciBJIGNvdWxkIGtub3cgd2hp Y2ggZXh0ZW5zaW9ucyBhcmUgcmVhbGx5CmltcGxlbWVudGVkLCBzbyBzdWNoIHN1Ym5vZGVzIHdv dWxkIG9ueSBiZSBhIHdheSBvZiBncm91cGluZyBwcm9wcyBpbiB0aGUgRFQKd2l0aG91dCBhZGRp bmcgYW55IGNvbXBpbGUgdGltZSBjaGVjayBjYXBhYmlsaXR5IG5vciBhZGRpbmcgYW55IGltcHJv dmVtZW50IHRvCnRoZSBydW50aW1lIERUIHBhcnNpbmcgcHJvY2VzLi4uCgouLi5CVVQsIG9mIGNv dXJzZSwgSSBjb3VsZCBiZSB3cm9uZyBhbmQgbWlzc2luZyBhIHNvbWV0aGluZyBoZXJlLCBzbyBJ CmFtIGhhcHB5IHRvIGNvcnJlY3RlZCBvbiB0aGUgc3Vibm9kZXMgdXRpbGl0eS4uLgoKPiAKPiA+ ICsgICcjbWJveC1jZWxscyc6Cj4gPiArICAgIGRlc2NyaXB0aW9uOiB8Cj4gPiArICAgICAgVGhl IGZpcnN0IGFyZ3VtZW50IGluIHRoZSBjb25zdW1lcnMgJ21ib3hlcycgcHJvcGVydHkgcmVwcmVz ZW50cyB0aGUKPiA+ICsgICAgICBleHRlbnNpb24gdHlwZSwgdGhlIHNlY29uZCBpcyBmb3IgdGhl IGNoYW5uZWwgbnVtYmVyIHdoaWxlIHRoZSB0aGlyZAo+ID4gKyAgICAgIGRlcGVuZHMgb24gZXh0 ZW5zaW9uIHR5cGUuCj4gPiArCj4gPiArICAgICAgRXh0ZW5zaW9uIHR5cGUgZm9yIERCRSBpcyAw IGFuZCB0aGUgdGhpcmQgcGFyYW1ldGVyIHJlcHJlc2VudHMgdGhlCj4gPiArICAgICAgZG9vcmJl bGwgZmxhZyBudW1iZXIgdG8gdXNlLgo+ID4gKyAgICAgIEV4dGVuc2lvbiB0eXBlIGZvciBGQ0Ug aXMgMSwgdGhpcmQgcGFyYW1ldGVyIHVudXNlZC4KPiA+ICsgICAgICBFeHRlbnNpb24gdHlwZSBm b3IgRkUgaXMgMiwgdGhpcmQgcGFyYW1ldGVyIHVudXNlZC4KPiA+ICsKPiA+ICsgICAgICBtYm94 ZXMgPSA8Jm1odSAwIDAgNT47IC8vIERCRSwgRG9vcmJlbGwgQ2hhbm5lbCBXaW5kb3cgMCwgZG9v cmJlbGwgZmxhZyA1Lgo+ID4gKyAgICAgIG1ib3hlcyA9IDwmbWh1IDAgMSA3PjsgLy8gREJFLCBE b29yYmVsbCBDaGFubmVsIFdpbmRvdyAxLCBkb29yYmVsbCBmbGFnIDcuCj4gPiArICAgICAgbWJv eGVzID0gPCZtaHUgMSAwIDA+OyAvLyBGQ0UsIEZhc3RDaGFubmVsIFdpbmRvdyAwLgo+ID4gKyAg ICAgIG1ib3hlcyA9IDwmbWh1IDEgMyAwPjsgLy8gRkNFLCBGYXN0Q2hhbm5lbCBXaW5kb3cgMy4K PiA+ICsgICAgICBtYm94ZXMgPSA8Jm1odSAyIDEgMD47IC8vIEZFLCBGSUZPIENoYW5uZWwgV2lu ZG93IDEuCj4gPiArICAgICAgbWJveGVzID0gPCZtaHUgMiA3IDA+OyAvLyBGRSwgRklGTyBDaGFu bmVsIFdpbmRvdyA3Lgo+ID4KPiBQbGVhc2UgZGVmaW5lIHRoZSBleHRlbnNpb24gdHlwZXMsIGlu c3RlYWQgb2YgMCwgMSBhbmQgMi4KPiAKCkknbGwgZG8uCgpUaGFua3MgZm9yIHRoZSByZXZpZXcu CkNyaXN0aWFuCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f XwpsaW51eC1hcm0ta2VybmVsIG1haWxpbmcgbGlzdApsaW51eC1hcm0ta2VybmVsQGxpc3RzLmlu ZnJhZGVhZC5vcmcKaHR0cDovL2xpc3RzLmluZnJhZGVhZC5vcmcvbWFpbG1hbi9saXN0aW5mby9s aW51eC1hcm0ta2VybmVsCg== From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 92F733FB81; Mon, 8 Apr 2024 11:09:22 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.140.110.172 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712574564; cv=none; b=r162lVlZEb5spTvET81ToOtSAh9hZTW5hfjqFtfg4VHvTqI3ltPRzyhGOa6f8tN3bP5qji/MUid1eDxosl6ely5aVD7Y0CFT8/N+vcvAUbUakOmFFWBJxx8Y+NK5wUxmPCRW2VB3qW7vsg/SauH237YTIqMtjy9WQ8NbqMYcgAM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712574564; c=relaxed/simple; bh=9CeiNUcdm4E9QUyAOhGqsopVTsAAf2iZyW0FuV0/aj4=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=AiSC2soF3wbuz0qjJLbvA58Oub9K+eLqXRSJ/Vb65NEbpJpdEYniLF+MKT2oAm+p8MdznCvcxYyYrwl++hjFITsaGcErq5TqpizW7g8V4LDF8ETTG/Hj/NB8ClNbq9m+mLmxZY73iAKXFU6inj5vS8XMFz++v9bIuniGPDzp7ns= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com; spf=pass smtp.mailfrom=arm.com; arc=none smtp.client-ip=217.140.110.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=arm.com Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 5F921DA7; Mon, 8 Apr 2024 04:09:52 -0700 (PDT) Received: from pluto (unknown [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id A97743F766; Mon, 8 Apr 2024 04:09:20 -0700 (PDT) Date: Mon, 8 Apr 2024 12:09:18 +0100 From: Cristian Marussi To: Jassi Brar Cc: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, sudeep.holla@arm.com, robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, conor+dt@kernel.org Subject: Re: [PATCH v3 1/2] dt-bindings: mailbox: arm,mhuv3: Add bindings Message-ID: References: <20240404062347.3219795-1-cristian.marussi@arm.com> <20240404062347.3219795-2-cristian.marussi@arm.com> Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: On Sun, Apr 07, 2024 at 06:38:52PM -0500, Jassi Brar wrote: > On Thu, Apr 4, 2024 at 1:25 AM Cristian Marussi > wrote: > > > > Add bindings for the ARM MHUv3 Mailbox controller. > > Hi, > > Signed-off-by: Cristian Marussi > > --- > > v2 -> v3 > > - fixed spurious tabs in dt_binding_check > > v1 -> v2 > > - clarified extension descriptions around configurability and discoverability > > - removed unused labels from the example > > - using pattern properties to define interrupt-names > > - bumped interrupt maxItems to 74 (allowing uo to 8 channels per extension) > > --- > > .../bindings/mailbox/arm,mhuv3.yaml | 217 ++++++++++++++++++ > > 1 file changed, 217 insertions(+) > > create mode 100644 Documentation/devicetree/bindings/mailbox/arm,mhuv3.yaml > > > > diff --git a/Documentation/devicetree/bindings/mailbox/arm,mhuv3.yaml b/Documentation/devicetree/bindings/mailbox/arm,mhuv3.yaml > > new file mode 100644 > > index 000000000000..32a8bb711464 > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/mailbox/arm,mhuv3.yaml > > @@ -0,0 +1,217 @@ > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > > +%YAML 1.2 > > +--- > > +$id: http://devicetree.org/schemas/mailbox/arm,mhuv3.yaml# > > +$schema: http://devicetree.org/meta-schemas/core.yaml# > > + > > +title: ARM MHUv3 Mailbox Controller > > + > > +maintainers: > > + - Sudeep Holla > > + - Cristian Marussi > > + > > +description: | > > + The Arm Message Handling Unit (MHU) Version 3 is a mailbox controller that > > + enables unidirectional communications with remote processors through various > > + possible transport protocols. > > + The controller can optionally support a varying number of extensions that, in > > + turn, enable different kinds of transport to be used for communication. > > + Number, type and characteristics of each supported extension can be discovered > > + dynamically at runtime. > > + > > + Given the unidirectional nature of the controller, an MHUv3 mailbox controller > > + is composed of a MHU Sender (MHUS) containing a PostBox (PBX) block and a MHU > > + Receiver (MHUR) containing a MailBox (MBX) block, where > > + > > + PBX is used to > > + - Configure the MHU > > + - Send Transfers to the Receiver > > + - Optionally receive acknowledgment of a Transfer from the Receiver > > + > > + MBX is used to > > + - Configure the MHU > > + - Receive Transfers from the Sender > > + - Optionally acknowledge Transfers sent by the Sender > > + > > + Both PBX and MBX need to be present and defined in the DT description if you > > + need to establish a bidirectional communication, since you will have to > > + acquire two distinct unidirectional channels, one for each block. > > + > > + As a consequence both blocks needs to be represented separately and specified > > + as distinct DT nodes in order to properly describe their resources. > > + > > + Note that, though, thanks to the runtime discoverability, there is no need to > > + identify the type of blocks with distinct compatibles. > > + > > + Following are the MHUv3 possible extensions. > > + > > + - Doorbell Extension (DBE): DBE defines a type of channel called a Doorbell > > + Channel (DBCH). DBCH enables a single bit Transfer to be sent from the > > + Sender to Receiver. The Transfer indicates that an event has occurred. > > + When DBE is implemented, the number of DBCHs that an implementation of the > > + MHU can support is between 1 and 128, numbered starting from 0 in ascending > > + order and discoverable at run-time. > > + Each DBCH contains 32 individual fields, referred to as flags, each of which > > + can be used independently. It is possible for the Sender to send multiple > > + Transfers at once using a single DBCH, so long as each Transfer uses > > + a different flag in the DBCH. > > + Optionally, data may be transmitted through an out-of-band shared memory > > + region, wherein the MHU Doorbell is used strictly as an interrupt generation > > + mechanism, but this is out of the scope of these bindings. > > + > > + - FastChannel Extension (FCE): FCE defines a type of channel called a Fast > > + Channel (FCH). FCH is intended for lower overhead communication between > > + Sender and Receiver at the expense of determinism. An FCH allows the Sender > > + to update the channel value at any time, regardless of whether the previous > > + value has been seen by the Receiver. When the Receiver reads the channel's > > + content it gets the last value written to the channel. > > + FCH is considered lossy in nature, and means that the Sender has no way of > > + knowing if, or when, the Receiver will act on the Transfer. > > + FCHs are expected to behave as RAM which generates interrupts when writes > > + occur to the locations within the RAM. > > + When FCE is implemented, the number of FCHs that an implementation of the > > + MHU can support is between 1-1024, if the FastChannel word-size is 32-bits, > > + or between 1-512, when the FastChannel word-size is 64-bits. > > + FCHs are numbered from 0 in ascending order. > > + Note that the number of FCHs and the word-size are implementation defined, > > + not configurable but discoverable at run-time. > > + Optionally, data may be transmitted through an out-of-band shared memory > > + region, wherein the MHU FastChannel is used as an interrupt generation > > + mechanism which carries also a pointer to such out-of-band data, but this > > + is out of the scope of these bindings. > > + > > + - FIFO Extension (FE): FE defines a Channel type called a FIFO Channel (FFCH). > > + FFCH allows a Sender to send > > + - Multiple Transfers to the Receiver without having to wait for the > > + previous Transfer to be acknowledged by the Receiver, as long as the > > + FIFO has room for the Transfer. > > + - Transfers which require the Receiver to provide acknowledgment. > > + - Transfers which have in-band payload. > > + In all cases, the data is guaranteed to be observed by the Receiver in the > > + same order which the Sender sent it. > > + When FE is implemented, the number of FFCHs that an implementation of the > > + MHU can support is between 1 and 64, numbered starting from 0 in ascending > > + order. The number of FFCHs, their depth (same for all implemented FFCHs) and > > + the access-granularity are implementation defined, not configurable but > > + discoverable at run-time. > > + Optionally, additional data may be transmitted through an out-of-band shared > > + memory region, wherein the MHU FIFO is used to transmit, in order, a small > > + part of the payload (like a header) and a reference to the shared memory > > + area holding the remaining, bigger, chunk of the payload, but this is out of > > + the scope of these bindings. > > + > > +properties: > > + compatible: > > + const: arm,mhuv3 > > + > > + reg: > > + maxItems: 1 > > + > > + interrupts: > > + minItems: 1 > > + maxItems: 74 > > + > > + interrupt-names: > > + description: | > > + The MHUv3 controller generates a number of events some of which are used > > + to generate interrupts; as a consequence it can expose a varying number of > > + optional PBX/MBX interrupts, representing the events generated during the > > + operation of the various transport protocols associated with different > > + extensions. All interrupts of the MHU are level-sensitive. > > + Some of these optional interrupts are defined per-channel, where the > > + number of channels effectively available is implementation defined and > > + run-time discoverable. > > + In the following names are enumerated using patterns, with per-channel > > + interrupts implicitly capped at the maximum channels allowed by the > > + specification for each extension type. > > + For the sake of simplicity maxItems is anyway capped to a most plausible > > + number, assuming way less channels would be implemented than actually > > + possible. > > + > > + The only mandatory interrupts on the MHU are: > > + - combined > > + - mbx-fch-xfer- but only if mbx-fcgrp-xfer- is not implemented. > > + > > + minItems: 1 > > + maxItems: 74 > > + items: > > + oneOf: > > + - const: combined > > + description: PBX/MBX Combined interrupt > > + - const: combined-ffch > > + description: PBX/MBX FIFO Combined interrupt > > + - pattern: '^ffch-low-tide-[0-9]+$' > > + description: PBX/MBX FIFO Channel Low Tide interrupt > > + - pattern: '^ffch-high-tide-[0-9]+$' > > + description: PBX/MBX FIFO Channel High Tide interrupt > > + - pattern: '^ffch-flush-[0-9]+$' > > + description: PBX/MBX FIFO Channel Flush interrupt > > + - pattern: '^mbx-dbch-xfer-[0-9]+$' > > + description: MBX Doorbell Channel Transfer interrupt > > + - pattern: '^mbx-fch-xfer-[0-9]+$' > > + description: MBX FastChannel Transfer interrupt > > + - pattern: '^mbx-fchgrp-xfer-[0-9]+$' > > + description: MBX FastChannel Group Transfer interrupt > > + - pattern: '^mbx-ffch-xfer-[0-9]+$' > > + description: MBX FIFO Channel Transfer interrupt > > + - pattern: '^pbx-dbch-xfer-ack-[0-9]+$' > > + description: PBX Doorbell Channel Transfer Ack interrupt > > + - pattern: '^pbx-ffch-xfer-ack-[0-9]+$' > > + description: PBX FIFO Channel Transfer Ack interrupt > > + > Can we have optional subnodes (with different properties as required) > for each extension type ? > Not sure if I have understood properly you request, but the type of extensions present in a PBX/MBX block can be discovered at runtime together with their characteristics (like the number of channels) so the specific DT properties can be searched (or NOT) based on the features discovered at run-time: are you asking for subnodes as a means of adding clarity to what can be defined in a block depending on what it is (PBX vs MBX) and what extensions it has ? if that is the reason ... the convoluted names like pbx/mbx-dbch- etc... was my attempt at thhat :D ... to give a hint at what you can define in a PBX vs MBX block and what is related to each extensions... Note that, though, since the PBX/MBX blocks are discoverable at runtime as such, they are not identified as such in the DT (same compatible) so I would not have anywayy the capability to check in the DT which is which (PBX/MBX) and if the properties are appropriate or not, nor I could know which extensions are really implemented, so such subnodes would ony be a way of grouping props in the DT without adding any compile time check capability nor adding any improvement to the runtime DT parsing proces... ...BUT, of course, I could be wrong and missing a something here, so I am happy to corrected on the subnodes utility... > > > + '#mbox-cells': > > + description: | > > + The first argument in the consumers 'mboxes' property represents the > > + extension type, the second is for the channel number while the third > > + depends on extension type. > > + > > + Extension type for DBE is 0 and the third parameter represents the > > + doorbell flag number to use. > > + Extension type for FCE is 1, third parameter unused. > > + Extension type for FE is 2, third parameter unused. > > + > > + mboxes = <&mhu 0 0 5>; // DBE, Doorbell Channel Window 0, doorbell flag 5. > > + mboxes = <&mhu 0 1 7>; // DBE, Doorbell Channel Window 1, doorbell flag 7. > > + mboxes = <&mhu 1 0 0>; // FCE, FastChannel Window 0. > > + mboxes = <&mhu 1 3 0>; // FCE, FastChannel Window 3. > > + mboxes = <&mhu 2 1 0>; // FE, FIFO Channel Window 1. > > + mboxes = <&mhu 2 7 0>; // FE, FIFO Channel Window 7. > > > Please define the extension types, instead of 0, 1 and 2. > I'll do. Thanks for the review. Cristian