xref: /freebsd-14.2/sys/contrib/dev/rtw88fw/README (revision 73d4ebea)
1
2 rtw88 firmware
3================
4
5This repository contains firmware images supported by Realtek's wireless
6driver rtw88. And some of the devices run with more than one firmware
7file. Basically, a "normal" firmware is necessary to be downloaded to
8the device.
9And another is called "wowlan" firmware, it should be loaded when a
10device is going to suspend. Which means driver will "re-download/swap"
11the firmware image. The wowlan firmware contains wake up functions that
12can recognize specific events and send a wake up signal to device if
13needed, and the system will resume to running state. During resume,
14driver will then swap the normal firmware back, return to running state.
15
16If any distros or platforms do not require wowlan feature, they can
17_only_ pick the normal firmware. And everything still works fine,
18except that the device cannot be waken from the wireless NICs.
19
20Currently supported devices with corresponding firmwares:
21
22RTL8822BE
23    rtw8822b_fw.bin
24
25RTL8821CE
26    rtw8821c_fw.bin
27
28RTL8822CE
29    rtw8822c_fw.bin
30    rtw8822c_wow_fw.bin
31
32RTL8723DE
33    rtw8723d_fw.bin
34
35