Commit e3037485 authored by Yan-Hsuan Chuang's avatar Yan-Hsuan Chuang Committed by Kalle Valo
Browse files

rtw88: new Realtek 802.11ac driver 

This is a new mac80211 driver for Realtek 802.11ac wireless network chips.
rtw88 now supports RTL8822BE/RTL8822CE now, with basic station mode
functionalities. The firmware for both can be found at linux-firmware.

https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git


For RTL8822BE: rtw88/rtw8822b_fw.bin
For RTL8822CE: rtw88/rtw8822c_fw.bin

And for now, only PCI buses (RTL8xxxE) are supported. We will add support
for USB and SDIO in the future. The bus interface abstraction can be seen
in this driver such as hci.h. Most of the hardware setting are the same
except for some TRX path or probing setup should be separated.

Supported:

 * Basic STA/AP/ADHOC mode, and TDLS (STA is well tested)

Missing feature:

 * WOW/PNO
 * USB & SDIO bus (such as RTL8xxxU/RTL8xxxS)
 * BT coexistence (8822B/8822C are combo ICs)
 * Multiple interfaces (for now single STA is better supported)
 * Dynamic hardware calibrations (to improve/stabilize performance)

Potential problems:

 * static calibration spends too much time, and it is painful for
   driver to leave IDLE state. And slows down associate process.
   But reload function are under development, will be added soon!
 * TRX statictics misleading, as we are not reporting status correctly,
   or say, not reporting for "every" packet.

The next patch set should have BT coexistence code since RTL8822B/C are
combo ICs, and the driver for BT can be found after Linux Kernel v4.20.
So it is better to add it first to make WiFi + BT work concurrently.

Although now rtw88 is simple but we are developing more features for it.
Even we want to add support for more chips such as RTL8821C/RTL8814B.

Finally, rtw88 has many authors, listed alphabetically:

Ping-Ke Shih <pkshih@realtek.com>
Tzu-En Huang <tehuang@realtek.com>
Yan-Hsuan Chuang <yhchuang@realtek.com>

Reviewed-by: default avatarStanislaw Gruszka <sgruszka@redhat.com>
Reviewed-by: default avatarBrian Norris <briannorris@chromium.org>
Tested-by: default avatarBrian Norris <briannorris@chromium.org>
Signed-off-by: default avatarYan-Hsuan Chuang <yhchuang@realtek.com>
Signed-off-by: default avatarKalle Valo <kvalo@codeaurora.org>
parent c745f722

MAINTAINERS

+6 −0
Original line number Diff line number Diff line
@@ -13396,6 +13396,12 @@ T: git git://git.kernel.org/pub/scm/linux/kernel/git/linville/wireless-testing.g 
S:	Maintained

F:	drivers/net/wireless/realtek/rtlwifi/



REALTEK WIRELESS DRIVER (rtw88)

M:	Yan-Hsuan Chuang <yhchuang@realtek.com>

L:	linux-wireless@vger.kernel.org

S:	Maintained

F:	drivers/net/wireless/realtek/rtw88/



RTL8XXXU WIRELESS DRIVER (rtl8xxxu)

M:	Jes Sorensen <Jes.Sorensen@gmail.com>

L:	linux-wireless@vger.kernel.org

drivers/net/wireless/realtek/Kconfig

+1 −0
Original line number Diff line number Diff line
@@ -14,5 +14,6 @@ if WLAN_VENDOR_REALTEK 
source "drivers/net/wireless/realtek/rtl818x/Kconfig"

source "drivers/net/wireless/realtek/rtlwifi/Kconfig"

source "drivers/net/wireless/realtek/rtl8xxxu/Kconfig"

source "drivers/net/wireless/realtek/rtw88/Kconfig"



endif # WLAN_VENDOR_REALTEK

drivers/net/wireless/realtek/Makefile

+1 −0
Original line number Diff line number Diff line
@@ -6,4 +6,5 @@ obj-$(CONFIG_RTL8180) += rtl818x/ 
obj-$(CONFIG_RTL8187)		+= rtl818x/

obj-$(CONFIG_RTLWIFI)		+= rtlwifi/

obj-$(CONFIG_RTL8XXXU)		+= rtl8xxxu/

obj-$(CONFIG_RTW88)		+= rtw88/

drivers/net/wireless/realtek/rtw88/Kconfig

0 → 100644
+54 −0
Original line number Diff line number Diff line 
menuconfig RTW88

	tristate "Realtek 802.11ac wireless chips support"

	depends on MAC80211

	help

	  This module adds support for mac80211-based wireless drivers that

	  enables Realtek IEEE 802.11ac wireless chipsets.



	  If you choose to build a module, it'll be called rtw88.



if RTW88



config RTW88_CORE

	tristate



config RTW88_PCI

	tristate



config RTW88_8822BE

	bool "Realtek 8822BE PCI wireless network adapter"

	depends on PCI

	select RTW88_CORE

	select RTW88_PCI

	help

	  Select this option will enable support for 8822BE chipset



	  802.11ac PCIe wireless network adapter



config RTW88_8822CE

	bool "Realtek 8822CE PCI wireless network adapter"

	depends on PCI

	select RTW88_CORE

	select RTW88_PCI

	help

	  Select this option will enable support for 8822CE chipset



	  802.11ac PCIe wireless network adapter



config RTW88_DEBUG

	bool "Realtek rtw88 debug support"

	depends on RTW88_CORE

	help

	  Enable debug support



	  If unsure, say Y to simplify debug problems



config RTW88_DEBUGFS

	bool "Realtek rtw88 debugfs support"

	depends on RTW88_CORE

	help

	  Enable debug support



	  If unsure, say Y to simplify debug problems



endif

drivers/net/wireless/realtek/rtw88/Makefile

0 → 100644
+20 −0
Original line number Diff line number Diff line 
obj-$(CONFIG_RTW88_CORE)	+= rtw88.o

rtw88-y += main.o \

	   mac80211.o \

	   util.o \

	   debug.o \

	   tx.o \

	   rx.o \

	   mac.o \

	   phy.o \

	   efuse.o \

	   fw.o \

	   ps.o \

	   sec.o \

	   regd.o



rtw88-$(CONFIG_RTW88_8822BE)	+= rtw8822b.o rtw8822b_table.o

rtw88-$(CONFIG_RTW88_8822CE)	+= rtw8822c.o rtw8822c_table.o



obj-$(CONFIG_RTW88_PCI)		+= rtwpci.o

rtwpci-objs			:= pci.o

CRA Git | Maintained and supported by SUSTech CRA and CCSE