From patchwork Thu Jun 12 17:01:54 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jassi Brar X-Patchwork-Id: 31855 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-lb0-f198.google.com (mail-lb0-f198.google.com [209.85.217.198]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id CCE742054B for ; Thu, 12 Jun 2014 17:02:23 +0000 (UTC) Received: by mail-lb0-f198.google.com with SMTP id u10sf1036993lbd.1 for ; Thu, 12 Jun 2014 10:02:22 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:delivered-to:from:to:cc:subject :date:message-id:in-reply-to:references:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :list-post:list-help:list-archive:list-unsubscribe; bh=dBNPY87L4FDcVQfVnsDOCmaFjZYFnWnDou/rAfORxDE=; b=DyfnlPNEvnSpcmMFEwqz9Cy/3jzDMs3BHJezdBRbN3qUqazVena+4IXh5AuJ9hm6Pk H0T26J/J4viKr4aBLUCaIMUR9uFz1Te0UBW602sAV1nNjzfmdD5haEren8Y/Wb/5WULt lkfnW5UzIgocf7nDtUbMqvnGnI4MA7rGtR3V2r9u0mxEsAcojwoZUHvBy9kTVD5CUMFC zuE/nxYzYyo8Ylv46ZI75HeIIJ5f0Yb3g1dw8lqaZGJ1zNuReQIa/rmdxkdPWvGmbgFi mHWttgElJ2VkgLUxAHNjpJJe3lwRTRIiS9XDFcWWfn1tnN54WpKaYKIIbcp2ObGlwxCG 0C7Q== X-Gm-Message-State: ALoCoQmcR40usOZWpIKdVlOwrwVDZU4GPADsXi/83WIGrmvaEs4Yu1Ab8N5Ut/P1pMV8k2UCYVW6 X-Received: by 10.180.206.33 with SMTP id ll1mr615098wic.5.1402592538973; Thu, 12 Jun 2014 10:02:18 -0700 (PDT) MIME-Version: 1.0 X-BeenThere: patchwork-forward@linaro.org Received: by 10.140.21.85 with SMTP id 79ls3164678qgk.41.gmail; Thu, 12 Jun 2014 10:02:18 -0700 (PDT) X-Received: by 10.52.139.101 with SMTP id qx5mr8928210vdb.17.1402592538838; Thu, 12 Jun 2014 10:02:18 -0700 (PDT) Received: from mail-vc0-f174.google.com (mail-vc0-f174.google.com [209.85.220.174]) by mx.google.com with ESMTPS id g6si503947vdk.30.2014.06.12.10.02.18 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 12 Jun 2014 10:02:18 -0700 (PDT) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.220.174 as permitted sender) client-ip=209.85.220.174; Received: by mail-vc0-f174.google.com with SMTP id hy4so1117556vcb.19 for ; Thu, 12 Jun 2014 10:02:18 -0700 (PDT) X-Received: by 10.52.252.4 with SMTP id zo4mr8966533vdc.20.1402592538751; Thu, 12 Jun 2014 10:02:18 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patches@linaro.org Received: by 10.221.54.6 with SMTP id vs6csp418920vcb; Thu, 12 Jun 2014 10:02:18 -0700 (PDT) X-Received: by 10.66.188.5 with SMTP id fw5mr22134691pac.63.1402592537980; Thu, 12 Jun 2014 10:02:17 -0700 (PDT) Received: from mail-pb0-f45.google.com (mail-pb0-f45.google.com [209.85.160.45]) by mx.google.com with ESMTPS id zm3si1722868pac.97.2014.06.12.10.02.17 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 12 Jun 2014 10:02:17 -0700 (PDT) Received-SPF: pass (google.com: domain of jaswinder.singh@linaro.org designates 209.85.160.45 as permitted sender) client-ip=209.85.160.45; Received: by mail-pb0-f45.google.com with SMTP id um1so1197688pbc.32 for ; Thu, 12 Jun 2014 10:02:17 -0700 (PDT) X-Received: by 10.66.121.197 with SMTP id lm5mr22665151pab.118.1402592537561; Thu, 12 Jun 2014 10:02:17 -0700 (PDT) Received: from Linaro.www.huaweimobilewifi.com ([115.117.180.66]) by mx.google.com with ESMTPSA id ys1sm7843068pab.7.2014.06.12.10.02.06 for (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Thu, 12 Jun 2014 10:02:16 -0700 (PDT) From: Jassi Brar To: linux-kernel@vger.kernel.org Cc: devicetree@vger.kernel.org, mporter@linaro.org, patches@linaro.org, bjorn@kryo.se, ashwin.chaugule@linaro.org, gregkh@linuxfoundation.org, s-anna@ti.com, loic.pallardy@st.com, lftan.linux@gmail.com, slapdau@yahoo.com.au, courtney.cavin@sonymobile.com, pawel.moll@arm.com, robh+dt@kernel.org, mark.rutland@arm.com, ijc+devicetree@hellion.org.uk, arnd@arndb.de, joshc@codeaurora.org, linus.walleij@linaro.org, galak@codeaurora.org, ks.giri@samsung.com, Jassi Brar Subject: [PATCHv7 3/5] Mailbox: Generic: Specify mailbox api bindings Date: Thu, 12 Jun 2014 22:31:54 +0530 Message-Id: <1402592514-7281-1-git-send-email-jaswinder.singh@linaro.org> X-Mailer: git-send-email 1.8.1.2 In-Reply-To: <1402592317-7043-1-git-send-email-jaswinder.singh@linaro.org> References: <1402592317-7043-1-git-send-email-jaswinder.singh@linaro.org> X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: jaswinder.singh@linaro.org X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.220.174 as permitted sender) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Precedence: list Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org List-ID: X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Due to the platform specific nature of remote's firmware, we can't do much to facilitate shareable client drivers. So the Mailbox api is more like a bunch of useful functions put together. The only feature that can be abstracted out is mailbox channel assignment to client drivers, which this binding specifies. Signed-off-by: Jassi Brar --- .../devicetree/bindings/mailbox/mailbox.txt | 33 ++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 Documentation/devicetree/bindings/mailbox/mailbox.txt diff --git a/Documentation/devicetree/bindings/mailbox/mailbox.txt b/Documentation/devicetree/bindings/mailbox/mailbox.txt new file mode 100644 index 0000000..3f00955 --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/mailbox.txt @@ -0,0 +1,33 @@ +* Generic Mailbox Controller and client driver bindings + +Generic binding to provide a way for Mailbox controller drivers to +assign appropriate mailbox channel to client drivers. + +* Mailbox Controller + +Required property: +- #mbox-cells: Must be at least 1. Number of cells in a mailbox + specifier. + +Example: + mailbox: mailbox { + ... + #mbox-cells = <1>; + }; + + +* Mailbox Client + +Required property: +- mbox: List of phandle and mailbox channel specifier. + +- mbox-names: List of identifier strings for each mailbox channel + required by the client. + +Example: + pwr_cntrl: power { + ... + mbox-names = "pwr-ctrl", "rpc"; + mbox = <&mailbox 0 + &mailbox 1>; + };