Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 0317e4a6 authored by Yue Ma's avatar Yue Ma
Browse files

net: cnss2: Add snapshot of CNSS2 driver 



This is a snapshot of the CNSS2 driver and associated files as
of msm-4.4 commit a5a8c690cff5 ("cnss2: Make WLAN host driver
unregister work uninterruptible").

Change-Id: I197c69a134eae6745c34d3ec0511457e4f5fa0a5
Signed-off-by: default avatarYue Ma <yuem@codeaurora.org>
parent 1c7b30fe

Documentation/devicetree/bindings/cnss/cnss-wlan.txt

0 → 100644
+75 −0
Original line number Diff line number Diff line 
* Qualcomm Technologies, Inc. ConNectivity SubSystem Platform Driver



This platform driver adds support for the CNSS subsystem used for PCIe

based Wi-Fi devices. It also adds support to integrate PCIe WLAN module

to subsystem restart framework. Apart from that, it also manages the

3.3V voltage regulator, WLAN Enable GPIO signal and PCIe link dynamically

with support for suspend and resume by retaining the PCI config space

states when PCIe link is shutdown. The main purpose of this device tree

entry below is to invoke the CNSS platform driver and provide handle to

the WLAN enable GPIO, 3.3V fixed voltage regulator resources. It also

provides the reserved RAM dump memory location and size.



Required properties:

  - compatible: "qcom,cnss" for QCA6174 device

                "qcom,cnss-qca6290" for QCA6290 device

  - wlan-en-gpio: WLAN_EN GPIO signal specified by the chip specifications

  - vdd-wlan-supply: phandle to the regulator device tree node

  - pinctrl-names: Names corresponding to the numbered pinctrl states

  - pinctrl-<n>: Pinctrl states as described in

                 bindings/pinctrl/pinctrl-bindings.txt

  - qcom,wlan-rc-num: PCIe root complex number which WLAN chip is attached to



Optional properties:

  - qcom,notify-modem-status: Boolean property to decide whether modem

                              notification should be enabled or not in this

                              platform

  - wlan-soc-swreg-supply: phandle to the external 1.15V regulator for QCA6174

  - wlan-ant-switch-supply: phandle to the 2.7V regulator for the antenna

                            switch of QCA6174

  - qcom,wlan-uart-access: Boolean property to decide whether QCA6174

                           has exclusive access to UART.

  - vdd-wlan-io-supply: phandle to the 1.8V IO regulator for QCA6174

  - vdd-wlan-xtal-supply: phandle to the 1.8V XTAL regulator for QCA6174

  - vdd-wlan-xtal-aon-supply: phandle to the LDO-4 regulator. This is needed

                              on platforms where XTAL regulator depends on

                              always on regulator in VDDmin.

  - vdd-wlan-core-supply: phandle to the 1.3V CORE regulator for QCA6174

  - vdd-wlan-sp2t-supply: phandle to the 2.7V SP2T regulator for QCA6174

  - qcom,wlan-smmu-iova-address: I/O virtual address range as <start length>

                                 format to be used for allocations associated

                                 between WLAN/PCIe and SMMU

  - qcom,wlan-ramdump-dynamic: To enable CNSS RAMDUMP collection

                               by providing the size of CNSS DUMP

  - reg: Memory regions defined as starting address and size

  - reg-names: Names of the memory regions defined in reg entry

  - wlan-bootstrap-gpio: WLAN_BOOTSTRAP GPIO signal specified by QCA6174

                         which should be drived depending on platforms

  - qcom,is-dual-wifi-enabled: Boolean property to control wlan enable(wlan-en)

                               gpio on dual-wifi platforms.

  - vdd-wlan-en-supply: WLAN_EN fixed regulator specified by QCA6174

                        specifications.

  - qcom,wlan-en-vreg-support: Boolean property to decide the whether the

                               WLAN_EN pin is a gpio or fixed regulator.

  - qcom,mhi: phandle to indicate the device which needs MHI support.

  - qcom,cap-tsf-gpio: WLAN_TSF_CAPTURED GPIO signal specified by the chip

                       specifications, should be drived depending on products



Example:



    qcom,cnss@0d400000 {

        compatible = "qcom,cnss";

        reg = <0x0d400000 0x200000>;

        reg-names = "ramdump";

        qcom,wlan-ramdump-dynamic = <0x200000>;

        wlan-en-gpio = <&msmgpio 82 0>;

        vdd-wlan-supply = <&wlan_vreg>;

        qcom,notify-modem-status;

        wlan-soc-swreg-supply = <&pma8084_l27>;

        pinctrl-names = "default";

        pinctrl-0 = <&cnss_default>;

        qcom,wlan-rc-num = <0>;

        qcom,wlan-smmu-iova-address = <0 0x10000000>;

        qcom,mhi = <&mhi_wlan>;

        qcom,cap-tsf-gpio = <&tlmm 126 1>;

    };

drivers/net/wireless/Kconfig

+1 −0
Original line number Diff line number Diff line
@@ -121,6 +121,7 @@ config CLD_LL_CORE 
	 Select Y to compile the driver in order to have WLAN functionality

	 support.



source "drivers/net/wireless/cnss2/Kconfig"

source "drivers/net/wireless/cnss_utils/Kconfig"

source "drivers/net/wireless/cnss_genl/Kconfig"

drivers/net/wireless/Makefile

+2 −0
Original line number Diff line number Diff line
@@ -26,6 +26,8 @@ obj-$(CONFIG_USB_NET_RNDIS_WLAN) += rndis_wlan.o 


obj-$(CONFIG_MAC80211_HWSIM)	+= mac80211_hwsim.o



obj-$(CONFIG_CNSS2)	+= cnss2/



obj-$(CONFIG_WCNSS_MEM_PRE_ALLOC) += cnss_prealloc/



obj-$(CONFIG_CNSS_UTILS) += cnss_utils/

drivers/net/wireless/cnss2/Kconfig

0 → 100644
+40 −0
Original line number Diff line number Diff line 
config CNSS2

	tristate "CNSS2 Platform Driver for Wi-Fi Module"

	depends on !CNSS && PCI_MSM

	---help---

	  This module adds the support for Connectivity Subsystem (CNSS) used

	  for PCIe based Wi-Fi devices with QCA6174/QCA6290 chipsets.

	  This driver also adds support to integrate WLAN module to subsystem

	  restart framework.



config CNSS2_DEBUG

	bool "CNSS2 Platform Driver Debug Support"

	depends on CNSS2

	---help---

	  This option is to enable CNSS2 platform driver debug support which

	  primarily includes providing additional verbose logs for certain

	  features, enabling kernel panic for certain cases to aid the

	  debugging, and enabling any other debug mechanisms.



config CNSS_ASYNC

	bool "Enable/disable CNSS platform driver asynchronous probe"

	depends on CNSS2

	---help---

	  If enabled, CNSS platform driver would do asynchronous probe.

	  Using asynchronous probe will allow CNSS platform driver to

	  probe in parallel with other device drivers and will help to

	  reduce kernel boot time.



config BUS_AUTO_SUSPEND

	bool "Enable/Disable Runtime PM support for PCIe based WLAN Drivers"

	depends on CNSS2

	depends on PCI

	---help---

	  Runtime Power Management is supported for PCIe based WLAN Drivers.

	  The features enable cld wlan driver to suspend pcie bus when APPS

	  is awake based on the driver inactivity with the Firmware.

	  The Feature uses runtime power management framework from kernel to

	  track bus access clients and to synchronize the driver activity

	  during system pm.

	  This config flag controls the feature per target based. The feature

	  requires CNSS driver support.

drivers/net/wireless/cnss2/Makefile

0 → 100644
+8 −0
Original line number Diff line number Diff line 
obj-$(CONFIG_CNSS2) += cnss2.o



cnss2-y := main.o

cnss2-y += debug.o

cnss2-y += pci.o

cnss2-y += power.o

cnss2-y += qmi.o

cnss2-y += wlan_firmware_service_v01.o