From patchwork Mon Jun 6 23:46:43 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bjorn Andersson X-Patchwork-Id: 69454 Delivered-To: patch@linaro.org Received: by 10.140.106.246 with SMTP id e109csp1714393qgf; Mon, 6 Jun 2016 16:46:55 -0700 (PDT) X-Received: by 10.36.85.16 with SMTP id e16mr20947502itb.5.1465256815521; Mon, 06 Jun 2016 16:46:55 -0700 (PDT) Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id w11si83516pfj.166.2016.06.06.16.46.55; Mon, 06 Jun 2016 16:46:55 -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; 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 devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (p=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753043AbcFFXqt (ORCPT + 7 others); Mon, 6 Jun 2016 19:46:49 -0400 Received: from mail-pa0-f54.google.com ([209.85.220.54]:33628 "EHLO mail-pa0-f54.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752683AbcFFXqs (ORCPT ); Mon, 6 Jun 2016 19:46:48 -0400 Received: by mail-pa0-f54.google.com with SMTP id ec8so33957251pac.0 for ; Mon, 06 Jun 2016 16:46:47 -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=FvbV1mTXNrwQR15uzt6qqSziqQWbXwPYFZ0V60TQnaQ=; b=UUSugXjeWs3ZQjML1MY+Cxc5XEav4PY5OfVTzHnLJMho9Yds51VeQ+LUVF6pki9htO pjQ1lAHPaysh7SIPi9As3G5euA7hqclhxMJVPwS7z8LwV9O66B+GZsK0UFzr8wRahyM5 jBc4Wt6NbqCdHa5rISQvTrv5Z9OMuTQuL7/Cs= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=FvbV1mTXNrwQR15uzt6qqSziqQWbXwPYFZ0V60TQnaQ=; b=SoB11PHN0zIKT+PY7JOFxRF1HSNf/pi5BjiSRPTMTXDfYkUD+yvS4TDZucHPD1HcCz sAKZoOpg9YuQ/YzPSVdDT5FIM/Me0rfJ7eTgDDUSi6h6clbpo9yGcbUExxdB8yNU4Ebc 2BM9IsiVfxH6UhPnAsi7PDZc3kECaTXb4Ilfl+uwkxxs3jX49YkQdJQUW2VrluqPjHP1 6a0rLDu6us8E2c1/mxnP6SmGleJNS1zqvNfX1EukryWdQl5LK9UDmiBKKHUW7a0/dSzJ saPjYek9SI0FaTTFcpOhVWgGjMENXuOyBbmPX2CsYMOtv88dUajuEVCjE8OVXbQSxQhk 2KLg== X-Gm-Message-State: ALyK8tL3iJbrnMVv2kfPERBsN0Ct/IAghSPxnMo+aQJY/C9mNVJjR3m/aLEnOkshlgrX+Dmd X-Received: by 10.66.167.6 with SMTP id zk6mr27447424pab.146.1465256807225; Mon, 06 Jun 2016 16:46:47 -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 qz5sm13003854pab.1.2016.06.06.16.46.46 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 06 Jun 2016 16:46:46 -0700 (PDT) From: Bjorn Andersson To: Andy Gross , Rob Herring Cc: linux-arm-msm@vger.kernel.org, linux-soc@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org Subject: [PATCH v3 1/2] dt: binding: Add Qualcomm WCNSS control binding Date: Mon, 6 Jun 2016 16:46:43 -0700 Message-Id: <1465256804-27281-1-git-send-email-bjorn.andersson@linaro.org> X-Mailer: git-send-email 2.5.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This binding describes the control interface for the Qualcomm WCNSS. Signed-off-by: Bjorn Andersson --- Changes since v2: - Fixup some misstakes in the document pointed out by Rob Changes since v1: - Introduce reference to wcnss block node for register block definition - Use wcnss block node compatible for hw version detection (riva vs pronto) - Clean up compatible name for bt node .../devicetree/bindings/soc/qcom/qcom,wcnss.txt | 116 +++++++++++++++++++++ 1 file changed, 116 insertions(+) create mode 100644 Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.txt -- 2.5.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" 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/soc/qcom/qcom,wcnss.txt b/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.txt new file mode 100644 index 000000000000..c2a45043b971 --- /dev/null +++ b/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.txt @@ -0,0 +1,116 @@ +Qualcomm WCNSS Binding + +This binding describes the Qualcomm WCNSS hardware. It consists of control +block and a BT, WiFi and FM radio block, all using SMD as command channels. + +- compatible: + Usage: required + Value type: + Definition: must be: "qcom,wcnss", + +- qcom,smd-channel: + Usage: required + Value type: + Definition: standard SMD property specifying the SMD channel used for + communication with the WiFi firmware. + Should be "WCNSS_CTRL". + +- qcom,mmio: + Usage: required + Value type: + Definition: reference to a node specifying the wcnss "ccu" and "dxe" + register blocks. The node must be compatible with one of + the following: + "qcom,riva", + "qcom,pronto" + += SUBNODES +The subnodes of the wcnss node are optional and describe the individual blocks in +the WCNSS. + +== Bluetooth +The following properties are defined to the bluetooth node: + +- compatible: + Usage: required + Value type: + Definition: must be: + "qcom,wcnss-bt" + +== WiFi +The following properties are defined to the WiFi node: + +- compatible: + Usage: required + Value type: + Definition: must be one of: + "qcom,wcnss-wlan", + +- interrupts: + Usage: required + Value type: + Definition: should specify the "rx" and "tx" interrupts + +- interrupt-names: + Usage: required + Value type: + Definition: must contain "rx" and "tx" + +- qcom,smem-state: + Usage: required + Value type: + Definition: should reference the tx-enable and tx-rings-empty SMEM states + +- qcom,state-names: + Usage: required + Value type: + Definition: must contain "tx-enable" and "tx-rings-empty" + += EXAMPLE +The following example represents a SMD node, with one edge representing the +"pronto" subsystem, with the wcnss device and its wcn3680 BT and WiFi blocks +described; as found on the 8974 platform. + +smd { + compatible = "qcom,smd"; + + pronto-edge { + interrupts = <0 142 1>; + + qcom,ipc = <&apcs 8 17>; + qcom,smd-edge = <6>; + + wcnss { + compatible = "qcom,wcnss"; + qcom,smd-channels = "WCNSS_CTRL"; + + #address-cells = <1>; + #size-cells = <1>; + + qcom,mmio = <&pronto>; + + bt { + compatible = "qcom,wcnss-bt"; + }; + + wlan { + compatible = "qcom,wcnss-wlan"; + + interrupts = <0 145 0>, <0 146 0>; + interrupt-names = "tx", "rx"; + + qcom,state = <&apps_smsm 10>, <&apps_smsm 9>; + qcom,state-names = "tx-enable", "tx-rings-empty"; + }; + }; + }; +}; + +soc { + pronto: pronto { + compatible = "qcom,pronto"; + + reg = <0xfb204000 0x2000>, <0xfb202000 0x1000>, <0xfb21b000 0x3000>; + reg-names = "ccu", "dxe", "pmu"; + }; +};