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: 98462 Delivered-To: patch@linaro.org Received: by 10.140.89.200 with SMTP id v66csp137355qgd; Tue, 2 May 2017 22:29:38 -0700 (PDT) X-Received: by 10.98.10.147 with SMTP id 19mr2769567pfk.193.1493789378142; Tue, 02 May 2017 22:29:38 -0700 (PDT) Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id c5si1554355pfe.328.2017.05.02.22.29.37; Tue, 02 May 2017 22:29:38 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-arm-msm-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org; spf=pass (google.com: best guess record for domain of linux-arm-msm-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-arm-msm-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751442AbdECF3g (ORCPT + 10 others); Wed, 3 May 2017 01:29:36 -0400 Received: from mail-pg0-f52.google.com ([74.125.83.52]:34210 "EHLO mail-pg0-f52.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751108AbdECF3e (ORCPT ); Wed, 3 May 2017 01:29:34 -0400 Received: by mail-pg0-f52.google.com with SMTP id v1so72448564pgv.1 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=VmP8eui5YnW6Npdp11e8VDjVaNbFqoSK3iRL+iHkliJS+siSbD5hynaCN4Uq1o8K7p Ewsu07ZZlUtd3S3jVSjeLwxv4I+o+UR1K5Y5oiZbZJe0g6Hye86d2QV9KvWVrUCT8ry2 zRQ1A+YsYspEQ2Dq2jKBmFdmvUpM7TU+CvlIcfFfanAK2JMqsY57Uz+cwk/f34mBrHBn eZm/RjSK5FPM2uCFVcW0gjfkGQv3CoYG4ePIeE5s9U/j3T765VJcIjzmASoe80smObvi p+3EiaBjwB+QX92jj4D5cf0t97dEYB1leNn3wdjW5D44GvhQbU0A4CxxDv8wwgthFu9d cWHA== X-Gm-Message-State: AN3rC/4s4GOCLvxywFA4MMUvZR0x/Bp81yFaCKSboukbN7gib+yANC8W yqFdVyn/n9OkNmtt 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-arm-msm-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-arm-msm@vger.kernel.org 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 -- 2.12.0 -- To unsubscribe from this list: send the line "unsubscribe linux-arm-msm" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html 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>; + }; +