From patchwork Sat Mar 2 04:29:39 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Samuel Holland X-Patchwork-Id: 10836375 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id B43FD1669 for ; Sat, 2 Mar 2019 04:30:14 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 9D91B2D398 for ; Sat, 2 Mar 2019 04:30:14 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 8F5B02D3EA; Sat, 2 Mar 2019 04:30:14 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.2 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 1C3892D398 for ; Sat, 2 Mar 2019 04:30:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=CyS2pRjtA5XSrrxbq5J3c6IuHwwLD7/Yhi9cFPTVpFo=; b=j5rv8v09Ws22PK cpmYRmSxdkrzkWpm8/PY1R/CxakozSGXNoWZg5rxBC6yVcvsbePx9h5ljGmLjIPGBiHzA/TPOVu/6 26rVWAUMOnmW1D9WwEaSunq7zLS9ytQyiLB4cBtlASH1RRR0Bx/NpCnUbSAwVDVqVZpRPIIFYcOtR bux0q3a3Uvabp/rr2uyXT+vZLIzhttwVw/A32o+YRW20T3OsA5F8HmO07HBXCRCIBCnu+p5MFj/Vi 3WeU09blvKEfXT2MvDGHY18uDRVW2oMXXB78kDcoaGFwln9bg7gN6cFgLQ06lVNQa/PD0kXmKuHqK MO9GUy92eFtA6tuo8Skg==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.90_1 #2 (Red Hat Linux)) id 1gzwHm-0007p7-Ky; Sat, 02 Mar 2019 04:30:06 +0000 Received: from out2-smtp.messagingengine.com ([66.111.4.26]) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1gzwHg-0007Ud-AN for linux-arm-kernel@lists.infradead.org; Sat, 02 Mar 2019 04:30:02 +0000 Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.nyi.internal (Postfix) with ESMTP id BFC0F22107; Fri, 1 Mar 2019 23:29:54 -0500 (EST) Received: from mailfrontend2 ([10.202.2.163]) by compute5.internal (MEProxy); Fri, 01 Mar 2019 23:29:54 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sholland.org; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; s=fm2; bh=iLEPvGgrt5WqP zIw2urRr/v4MmxlFfFvpU7UgAt2d8Q=; b=b0jwaB9m/EjN53tkICO/h2lN120sr lXFf0bC+/OHUH8wT6Uow6gujK+rgTNx4yNBaWEiLHpNjZPukRGi7gom6uI3RrOBs 7ASdHwjg6zdzXwt0cPCCt65HNt9TIdltt1O7CBxb49Ch+7hqCfbuwZU2a5pyEzQh DFbcF7HMtlw+EsaUE6LiBkP4jZrpBcklG5ka+Ran3cY0VKO0OA+aNxqr8poT8zQO 973lLWCzTrxDkbsVMn8pQmO1PPuhXFCwBcRYHi7XlXpHSunnRmWlQ2XJ6iFGLiTx 3hvNLWLb5aTvurzU4u7yoxqltIQExkV+6zuLUnJIyJFTzp5kG+d8DKfog== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :in-reply-to:message-id:mime-version:references:subject:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm2; bh=iLEPvGgrt5WqPzIw2urRr/v4MmxlFfFvpU7UgAt2d8Q=; b=rFR18QMM H95sSz+9TvR/XkJpzcOy0NGbbUwzNmhpVSRm80OoQQU9T5lf7/TxtxXneHOkdAFI NgAME5IlHFoe9siOh4W3hvjXW5ukjJbqfBrX/8s/bLGN8tmFQLcR4/SPqKHvjav0 jDdf0f6Wl99nG2pXROXNCPPV1t+axQQwfvEZ13CBU8AUiNwi4KheGkGQ0esXGm5T LLrVtwIkVwpm45vPG5G+1nLzXL12MTBk2XEYQAmkkWNRx/owRny2WrAtQAMzQm+K cBlfZIjiw1OJIzhLYtL+3QljKL3mAizrGkGDZdC1xRkGt7axeoDU6/PMfgd38/HL r8xAiLu2TysmoA== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedutddrvdeigdejtdcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvffufffkofgjfhgggfestdekredtredttdenucfhrhhomhepufgrmhhuvghl ucfjohhllhgrnhguuceoshgrmhhuvghlsehshhholhhlrghnugdrohhrgheqnecuffhomh grihhnpeguvghvihgtvghtrhgvvgdrohhrghenucfkphepjedtrddufeehrddugeekrddu hedunecurfgrrhgrmhepmhgrihhlfhhrohhmpehsrghmuhgvlhesshhhohhllhgrnhgurd horhhgnecuvehluhhsthgvrhfuihiivgeptd X-ME-Proxy: Received: from titanium.stl.sholland.net (70-135-148-151.lightspeed.stlsmo.sbcglobal.net [70.135.148.151]) by mail.messagingengine.com (Postfix) with ESMTPA id D491210328; Fri, 1 Mar 2019 23:29:53 -0500 (EST) From: Samuel Holland To: Maxime Ripard , Chen-Yu Tsai , Jassi Brar , Michael Turquette , Stephen Boyd , Rob Herring , Mark Rutland Subject: [PATCH v3 03/15] dt-bindings: mailbox: Add a sunxi message box binding Date: Fri, 1 Mar 2019 22:29:39 -0600 Message-Id: <20190302042951.53671-4-samuel@sholland.org> X-Mailer: git-send-email 2.19.2 In-Reply-To: <20190302042951.53671-1-samuel@sholland.org> References: <20190302042951.53671-1-samuel@sholland.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20190301_203000_585254_80FAA7A7 X-CRM114-Status: GOOD ( 10.48 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, Samuel Holland , linux-kernel@vger.kernel.org, linux-sunxi@googlegroups.com, linux-clk@vger.kernel.org, linux-arm-kernel@lists.infradead.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP This mailbox hardware is present in Allwinner sun8i, sun9i, and sun50i SoCs. Add a device tree binding for it. Signed-off-by: Samuel Holland Reviewed-by: Rob Herring --- .../mailbox/allwinner,sunxi-msgbox.yaml | 79 +++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 Documentation/devicetree/bindings/mailbox/allwinner,sunxi-msgbox.yaml diff --git a/Documentation/devicetree/bindings/mailbox/allwinner,sunxi-msgbox.yaml b/Documentation/devicetree/bindings/mailbox/allwinner,sunxi-msgbox.yaml new file mode 100644 index 000000000000..f34a1909ab2e --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/allwinner,sunxi-msgbox.yaml @@ -0,0 +1,79 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mailbox/allwinner,sunxi-msgbox.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Allwinner sunxi Message Box + +maintainers: + - Samuel Holland + +description: | + The hardware message box on sun6i and newer sunxi SoCs is a two-user mailbox + controller containing 8 unidirectional FIFOs. An interrupt is raised for + received messages, but software must poll to know when a transmitted message + has been acknowledged by the remote user. Each FIFO can hold four 32-bit + messages; when a FIFO is full, clients must wait before more transmissions. + + Refer to ./mailbox.txt for generic information about mailbox device-tree + bindings. + +properties: + compatible: + oneOf: + - items: + - enum: + - allwinner,sun8i-a83t-msgbox + - allwinner,sun8i-h3-msgbox + - allwinner,sun9i-a80-msgbox + - allwinner,sun50i-a64-msgbox + - allwinner,sun50i-h6-msgbox + - const: allwinner,sun6i-a31-msgbox + - items: + - const: allwinner,sun6i-a31-msgbox + + reg: + items: + - description: MMIO register range + + clocks: + maxItems: 1 + description: bus clock + + resets: + maxItems: 1 + description: bus reset + + interrupts: + maxItems: 1 + description: controller interrupt + + '#mbox-cells': + const: 1 + +required: + - compatible + - reg + - clocks + - resets + - interrupts + - '#mbox-cells' + +examples: + - | + #include + #include + #include + + msgbox: mailbox@1c17000 { + compatible = "allwinner,sun8i-h3-msgbox", + "allwinner,sun6i-a31-msgbox"; + reg = <0x01c17000 0x1000>; + clocks = <&ccu CLK_BUS_MSGBOX>; + resets = <&ccu RST_BUS_MSGBOX>; + interrupts = ; + #mbox-cells = <1>; + }; + +...