Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1365844

[PATCH 3/5] dt-binding: Add Qualcomm WCNSS control binding

Show all headers | View raw

This binding describes the control interface for the Qualcomm WCNSS.

Signed-off-by: Bjorn Andersson <bjorn.andersson@linaro.org>
---

Got a reviewed-by from Andy and acked-by from Rob on the WiFi part of this
binding. But during futher testing I spotted a timing issue, where the
wcnss_ctrl driver must finish the uploading of NV to the core os of the wcnss
before the wifi driver can initiate any communication with the wifi part
(although available from the get-go).

The sanest way I could figure to model this is to describe the core part as
parent of the wifi and bt pieces.

 .../devicetree/bindings/soc/qcom/qcom,wcnss.txt    | 104 +++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.txt

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..5488904b6185
--- /dev/null
+++ b/Documentation/devicetree/bindings/soc/qcom/qcom,wcnss.txt
@@ -0,0 +1,104 @@
+Qualcomm WCNSS Binding
+
+This binding describes the Qualcomm WCNSS hardware. It consists of control
+block and a BT, WiFi and FM radio block, all useing SMD as command channels.
+
+- compatible:
+	Usage: required
+	Value type: <string>
+	Definition: must be: "qcom,wcnss",
+
+- qcom,smd-channel:
+	Usage: required
+	Value type: <string>
+	Definition: standard SMD property specifying the SMD channel used for
+		    communication with the WiFi firmware
+
+= 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: <string>
+	Definition: must be: "qcom,btqcomsmd"
+
+== WiFi
+The following properties are defined to the WiFi node:
+
+- compatible:
+	Usage: required
+	Value type: <string>
+	Definition: must be one of:
+		    "qcom,wcn3620-wlan",
+		    "qcom,wcn3660-wlan",
+		    "qcom,wcn3680-wlan"
+
+- qcom,wcnss-mmio:
+	Usage: required
+	Value type: <prop-encoded-array>
+	Definition: should specify base address and size of the WiFi related
+		    registers of WCNSS
+
+- interrupts:
+	Usage: required
+	Value type: <prop-encoded-array>
+	Definition: should specify the "rx" and "tx" interrupts
+
+- interrupt-names:
+	Usage: required
+	Value type: <stringlist>
+	Definition: must contain "rx" and "tx"
+
+- qcom,state:
+	Usage: required
+	Value type: <prop-encoded-array>
+	Definition: should reference the tx-enable and tx-rings-empty SMEM states
+
+- qcom,state-names:
+	Usage: required
+	Value type: <stringlist>
+	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 {
+		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>;
+
+			bt {
+				compatible = "qcom,btqcomsmd";
+			};
+
+			wifi {
+				compatible = "qcom,wcn3680-wlan";
+
+				qcom,wcnss-mmio = <0xfb000000 0x21b000>;
+
+				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";
+			};
+		};
+	};
+};
-- 
2.5.0

Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[PATCH 1/5] soc: qcom: smd: Make callback pass channel reference Bjorn Andersson <bjorn.andersson@linaro.org> - 2016-03-29 06:40 +0200
  [PATCH 4/5] soc: qcom: wcnss_ctrl: Make wcnss_ctrl parent the other components Bjorn Andersson <bjorn.andersson@linaro.org> - 2016-03-29 06:40 +0200
    Re: [PATCH 4/5] soc: qcom: wcnss_ctrl: Make wcnss_ctrl parent the  other components Andy Gross <andy.gross@linaro.org> - 2016-03-31 20:50 +0200
      Re: [PATCH 4/5] soc: qcom: wcnss_ctrl: Make wcnss_ctrl parent the  other components Bjorn Andersson <bjorn.andersson@linaro.org> - 2016-03-31 21:40 +0200
  [PATCH 3/5] dt-binding: Add Qualcomm WCNSS control binding Bjorn Andersson <bjorn.andersson@linaro.org> - 2016-03-29 06:40 +0200
    Re: [PATCH 3/5] dt-binding: Add Qualcomm WCNSS control binding Rob Herring <robh@kernel.org> - 2016-03-31 16:30 +0200
      Re: [PATCH 3/5] dt-binding: Add Qualcomm WCNSS control binding Bjorn Andersson <bjorn.andersson@linaro.org> - 2016-03-31 19:20 +0200
        Re: [PATCH 3/5] dt-binding: Add Qualcomm WCNSS control binding Rob Herring <robh@kernel.org> - 2016-03-31 19:40 +0200
          Re: [PATCH 3/5] dt-binding: Add Qualcomm WCNSS control binding Bjorn Andersson <bjorn.andersson@linaro.org> - 2016-03-31 20:30 +0200
            Re: [PATCH 3/5] dt-binding: Add Qualcomm WCNSS control binding Rob Herring <robh@kernel.org> - 2016-03-31 22:50 +0200
              Re: [PATCH 3/5] dt-binding: Add Qualcomm WCNSS control binding Bjorn Andersson <bjorn.andersson@linaro.org> - 2016-03-31 23:30 +0200
  [PATCH 2/5] soc: qcom: smem: Use write-combine remap for SMEM Bjorn Andersson <bjorn.andersson@linaro.org> - 2016-03-29 06:40 +0200
    Re: [PATCH 2/5] soc: qcom: smem: Use write-combine remap for SMEM Andy Gross <andy.gross@linaro.org> - 2016-03-31 20:30 +0200
  [PATCH 5/5] ARM: dts: qcom: msm8974: Introduce pronto node Bjorn Andersson <bjorn.andersson@linaro.org> - 2016-03-29 06:40 +0200

csiph-web