From patchwork Mon Oct 5 13:02:16 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 54500 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-wi0-f200.google.com (mail-wi0-f200.google.com [209.85.212.200]) by patches.linaro.org (Postfix) with ESMTPS id 9CC2E22F05 for ; Mon, 5 Oct 2015 13:38:05 +0000 (UTC) Received: by wicgb1 with SMTP id gb1sf29529926wic.3 for ; Mon, 05 Oct 2015 06:38:04 -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:sender:precedence:list-id :x-original-sender:x-original-authentication-results:mailing-list :list-post:list-help:list-archive:list-unsubscribe; bh=7EOA5W9ZSBeOYkbZd9nFF5B4ImwI9SrbtXmRwbjCU0U=; b=I259IU/6t6g0uympvxkJWTO0zCWt1X/pRKx62XPsOEF2irBlv8LlGFO6vOYWh5/9L8 xecknSddvPLbGK12jaMf3weqaODsPuNp1/ExzcYjj+8JHRoTssDPj6Wr0Kh1tGaK0w1t BwG69Pfxn+hKIn9+P+xmJumwpzuV0gEs2YHq3X/GzN4kGzM/WtmrV+BNZTp3/wdt3pqq T7rLWIimMWSMVz2IZklU5qVZUMgPYHxa6+KumlslX6feQNKVBdwHzY0Hbb6BnxhzKfMX kElo+lOpKiJdhrIKUroy6IxG1cPh2+WoobDeeK5ucxrGDNAu+l8TUWwE470YYJImnvok TYMQ== X-Gm-Message-State: ALoCoQlb8hYp7hcz1Wu2uAksXCunRc4stimpgxHkroEtMedwco/FKBpSK20cHnJgJrRaJNhOU3Bl X-Received: by 10.112.130.41 with SMTP id ob9mr5154800lbb.17.1444050405032; Mon, 05 Oct 2015 06:06:45 -0700 (PDT) MIME-Version: 1.0 X-BeenThere: patchwork-forward@linaro.org Received: by 10.25.84.1 with SMTP id i1ls417050lfb.15.gmail; Mon, 05 Oct 2015 06:06:44 -0700 (PDT) X-Received: by 10.25.33.145 with SMTP id h139mr7143326lfh.123.1444050404891; Mon, 05 Oct 2015 06:06:44 -0700 (PDT) Received: from mail-lb0-f180.google.com (mail-lb0-f180.google.com. [209.85.217.180]) by mx.google.com with ESMTPS id ec5si16858731lbc.119.2015.10.05.06.06.44 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 05 Oct 2015 06:06:44 -0700 (PDT) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.217.180 as permitted sender) client-ip=209.85.217.180; Received: by lbwr8 with SMTP id r8so57360075lbw.2 for ; Mon, 05 Oct 2015 06:06:44 -0700 (PDT) X-Received: by 10.112.163.131 with SMTP id yi3mr11655274lbb.36.1444050404739; Mon, 05 Oct 2015 06:06:44 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.112.59.35 with SMTP id w3csp1252289lbq; Mon, 5 Oct 2015 06:06:43 -0700 (PDT) X-Received: by 10.66.186.141 with SMTP id fk13mr39851066pac.7.1444050403692; Mon, 05 Oct 2015 06:06:43 -0700 (PDT) Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id gu1si40218710pac.39.2015.10.05.06.06.43; Mon, 05 Oct 2015 06:06:43 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752619AbbJENGm (ORCPT + 7 others); Mon, 5 Oct 2015 09:06:42 -0400 Received: from mail-wi0-f176.google.com ([209.85.212.176]:35985 "EHLO mail-wi0-f176.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751246AbbJENEo (ORCPT ); Mon, 5 Oct 2015 09:04:44 -0400 Received: by wicgb1 with SMTP id gb1so118623867wic.1 for ; Mon, 05 Oct 2015 06:04:42 -0700 (PDT) X-Received: by 10.194.59.236 with SMTP id c12mr30081081wjr.23.1444050282736; Mon, 05 Oct 2015 06:04:42 -0700 (PDT) Received: from localhost.localdomain (host81-129-171-83.range81-129.btcentralplus.com. [81.129.171.83]) by smtp.gmail.com with ESMTPSA id cc8sm13388976wjc.46.2015.10.05.06.04.41 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 05 Oct 2015 06:04:42 -0700 (PDT) From: Lee Jones To: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Cc: jassisinghbrar@gmail.com, devicetree@vger.kernel.org Subject: [PATCH v4 1/5] mailbox: dt: Supply bindings for ST's Mailbox IP Date: Mon, 5 Oct 2015 14:02:16 +0100 Message-Id: <1444050140-24733-2-git-send-email-lee.jones@linaro.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1444050140-24733-1-git-send-email-lee.jones@linaro.org> References: <1444050140-24733-1-git-send-email-lee.jones@linaro.org> Sender: devicetree-owner@vger.kernel.org Precedence: list List-ID: X-Mailing-List: devicetree@vger.kernel.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: lee.jones@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.217.180 as permitted sender) smtp.mailfrom=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Signed-off-by: Lee Jones --- .../devicetree/bindings/mailbox/sti-mailbox.txt | 52 ++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 Documentation/devicetree/bindings/mailbox/sti-mailbox.txt diff --git a/Documentation/devicetree/bindings/mailbox/sti-mailbox.txt b/Documentation/devicetree/bindings/mailbox/sti-mailbox.txt new file mode 100644 index 0000000..9fb4400 --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/sti-mailbox.txt @@ -0,0 +1,52 @@ +ST Microelectronics Mailbox Driver + +Each ST Mailbox IP currently consists of 4 instances of 32 channels. Messages +are passed between Application and Remote processors using shared memory. + +Controller +---------- + +Required properties: +- compatible : Should be "st,stih407-mailbox" +- reg : Offset and length of the device's register set +- mbox-name : Name of the mailbox +- #mbox-cells: : Must be 2 + <&phandle instance channel direction> + phandle : Label name of controller + instance : Instance number + channel : Channel number + +Optional properties +- interrupts : Contains the IRQ line for a Rx mailbox +- tx-only : Denotes Mailbox cannot receive messages + +Example: + +mailbox0: mailbox@0 { + compatible = "st,stih407-mailbox"; + reg = <0x08f00000 0x1000>; + interrupts = ; + #mbox-cells = <2>; + mbox-name = "a9"; +}; + +Client +------ + +Required properties: +- compatible : Many (See the client docs) +- reg : Shared (between Application and Remote) memory address +- mboxes : Standard property to specify a Mailbox (See ./mailbox.txt) + Cells must match 'mbox-cells' (See Controller docs above) + +Optional properties +- mbox-names : Name given to channels seen in the 'mboxes' property. + +Example: + +mailbox_test { + compatible = "mailbox_test"; + reg = <0x[shared_memory_address], [shared_memory_size]>; + mboxes = <&mailbox2 0 1>, <&mailbox0 2 1>; + mbox-names = "tx", "rx"; +};