freebsd-dev/sys/contrib/dev/rtw88fw/README
Bjoern A. Zeeb 73d4ebea35 rtw88: import firmware for Realtek's rtw88 supported chipsets.
Import the most recent versions of the firmware images for the
rtw88 driver.

This is based on linux-firmware at 681281e49fb6778831370e5d94e6e1d97f0752d6.

The license of the firmware matches the previous rtwnfw(4) firmware
files (modulo a Copyright year) and you can find a copy in
sys/contrib/dev/rtw88fw/LICENCE.rtlwifi_firmware.txt.

Add build infrastructure to create the .ko files but do not yet hook
it up to the build until all parts are in the tree.

Approved by:	core (imp)
MFC after:	2 weeks
2022-04-01 00:07:24 +00:00

35 lines
1.1 KiB
Plaintext

rtw88 firmware
================
This repository contains firmware images supported by Realtek's wireless
driver rtw88. And some of the devices run with more than one firmware
file. Basically, a "normal" firmware is necessary to be downloaded to
the device.
And another is called "wowlan" firmware, it should be loaded when a
device is going to suspend. Which means driver will "re-download/swap"
the firmware image. The wowlan firmware contains wake up functions that
can recognize specific events and send a wake up signal to device if
needed, and the system will resume to running state. During resume,
driver will then swap the normal firmware back, return to running state.
If any distros or platforms do not require wowlan feature, they can
_only_ pick the normal firmware. And everything still works fine,
except that the device cannot be waken from the wireless NICs.
Currently supported devices with corresponding firmwares:
RTL8822BE
rtw8822b_fw.bin
RTL8821CE
rtw8821c_fw.bin
RTL8822CE
rtw8822c_fw.bin
rtw8822c_wow_fw.bin
RTL8723DE
rtw8723d_fw.bin