From patchwork Wed May 3 05:29:26 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bjorn Andersson X-Patchwork-Id: 9708885 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id EA8F560351 for ; Wed, 3 May 2017 05:29:41 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id DB014285E9 for ; Wed, 3 May 2017 05:29:41 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id CE892285F2; Wed, 3 May 2017 05:29:41 +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=-6.8 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=unavailable version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 60C9E285E9 for ; Wed, 3 May 2017 05:29:41 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751456AbdECF3g (ORCPT ); Wed, 3 May 2017 01:29:36 -0400 Received: from mail-pf0-f179.google.com ([209.85.192.179]:36764 "EHLO mail-pf0-f179.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751120AbdECF3e (ORCPT ); Wed, 3 May 2017 01:29:34 -0400 Received: by mail-pf0-f179.google.com with SMTP id q66so7410007pfi.3 for ; Tue, 02 May 2017 22:29:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=rWFpQKa9/Uo6Z0qhaDARLSCI9zlzG2a/LeNMhA+nYwM=; b=TEmGzx4Ex0Yiny2mzs5Km/KZtAJoSnFEi33p22l4QoVdR6t6PzuF2EhokR9/hPBZ0x NbnBVQF3H/fOaYtxL2xAC4E0eV75OZAFfoPRPwDhCYEoQqHpEWAEYe5hcc9bCNgALXbS 260hvoxCKJpeA7mGmyA8nQn3ADtQPKSyFgcpM= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=rWFpQKa9/Uo6Z0qhaDARLSCI9zlzG2a/LeNMhA+nYwM=; b=M7JCQIobwar8bmAyD0Xn/b1qKkmyl7YXYYy1kmr0mtD81H+HIgLnIMSMh1qGS9Z5RX fPRI5W7rlnzYFAXyl6tT8YpGC/mrCRSF9nBIdObetdGEvB3p4kDjprx7ywX1dhyV0LXM 6rwcMW4IiXIQh2aFy3DJMqAjMuvfsPnl6YEzVSFCeLwsgpaGZJoVWw8JL575lCC8TCcM y0BMmvnUf8ADDtMTj1SgipfCPkcdsx5vqzFeugNQgb/lLpar6gO2G84nK5Mv6mZJsQg5 p5o1AKtGxuQS1EMvQO+FKBzRdmaoDzyfSTLILinEIRnMB5r+0IIVgv3UTPh4345P7+ov 66hA== X-Gm-Message-State: AN3rC/4IjONQx3CvANtffYq9YX3DI+JUV3o2vlGkircjYfEgQK8H8+gV 455ruPhms/CSwA+Y X-Received: by 10.84.224.10 with SMTP id r10mr22630750plj.25.1493789373618; Tue, 02 May 2017 22:29:33 -0700 (PDT) Received: from localhost.localdomain (ip68-111-223-48.sd.sd.cox.net. [68.111.223.48]) by smtp.gmail.com with ESMTPSA id e72sm2001576pfk.17.2017.05.02.22.29.32 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 02 May 2017 22:29:32 -0700 (PDT) From: Bjorn Andersson To: Andy Gross , Rob Herring , Mark Rutland , Ohad Ben-Cohen Cc: linux-arm-msm@vger.kernel.org, linux-soc@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-remoteproc@vger.kernel.org Subject: [PATCH v3 1/4] dt-bindings: Introduce doorbell binding Date: Tue, 2 May 2017 22:29:26 -0700 Message-Id: <20170503052929.17422-1-bjorn.andersson@linaro.org> X-Mailer: git-send-email 2.12.0 Sender: linux-remoteproc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-remoteproc@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Introduce the generic doorbell binding as well as a binding for the Qualcomm APCS Global block. This is used to expose doorbell-like devices in the system. Signed-off-by: Bjorn Andersson --- Changes since v2: - New binding .../devicetree/bindings/doorbell/doorbell.txt | 31 +++++++++++++++ .../bindings/doorbell/qcom,apcs-kpss-global.txt | 45 ++++++++++++++++++++++ 2 files changed, 76 insertions(+) create mode 100644 Documentation/devicetree/bindings/doorbell/doorbell.txt create mode 100644 Documentation/devicetree/bindings/doorbell/qcom,apcs-kpss-global.txt diff --git a/Documentation/devicetree/bindings/doorbell/doorbell.txt b/Documentation/devicetree/bindings/doorbell/doorbell.txt new file mode 100644 index 000000000000..8fd814898c3f --- /dev/null +++ b/Documentation/devicetree/bindings/doorbell/doorbell.txt @@ -0,0 +1,31 @@ +Doorbell binding +============================================ + +The doorbell binding is used to describe a set of doorbells for client blocks +to ring. + +1) Doorbell controller +---------------------- + +A doorbell controller is a device that exposes a number of doorbells, that can +client devices can ring to signal some event to some piece of hardware. + +- #doorbell-cells: + Usage: required + Value type: + Definition: should be 0 for single-doorbell controllers and 1 for + multi-doorbell controllers + +2) Doorbell user +---------------- + +- doorbells: + Usage: required + Value type: + Definition: list of doorbell references + +- doorbell-names: + Usage: optional + Value type: + Definition: list of strings identifying each entry in the doorbells + property diff --git a/Documentation/devicetree/bindings/doorbell/qcom,apcs-kpss-global.txt b/Documentation/devicetree/bindings/doorbell/qcom,apcs-kpss-global.txt new file mode 100644 index 000000000000..6320e1a355cb --- /dev/null +++ b/Documentation/devicetree/bindings/doorbell/qcom,apcs-kpss-global.txt @@ -0,0 +1,45 @@ +Binding for the Qualcomm APCS global block +========================================== + +This binding describes the APCS "global" block found in various Qualcomm +platforms. + +- compatible: + Usage: required + Value type: + Definition: must be one of: + "qcom,msm8916-apcs-kpss-global", + "qcom,msm8996-apcs-hmss-global" + +- reg: + Usage: required + Value type: + Definition: must specify the base address and size of the global block + +- #doorbell-cells: + Usage: required + Value type: + Definition: as described in doorbell.txt, must be 1 + + += EXAMPLE +The following example describes the APCS HMSS found in MSM8996 and part of the +GLINK RPM referencing the "rpm_hlos" doorbell therein. + + apcs_glb: apcs-glb@9820000 { + compatible = "qcom,msm8996-apcs-hmss-global"; + reg = <0x9820000 0x1000>; + + #doorbell-cells = <1>; + }; + + rpm-glink { + compatible = "qcom,glink-rpm"; + + interrupts = ; + + qcom,rpm-msg-ram = <&rpm_msg_ram>; + + doorbells = <&apcs_glb 0>; + }; +