2 .\" Copyright (c) 2022 Bjoern A. Zeeb
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .Nd Realtek IEEE 802.11n/ac wireless network driver
34 The driver will auto-load without any user interaction using
39 Only if auto-loading is explicitly disabled, place the following
42 to manually load the driver as a module at boot time:
43 .Bd -literal -offset indent
44 kld_list="${kld_list} if_rtw88"
47 The driver should automatically load any
49 firmware needed for the particular chipset.
51 It is discouraged to load the driver from
56 driver is derived from Realtek's Linux rtw88 driver and provides support for
57 the following chipsets:
59 .Bl -tag -width Ds -offset indent -compact
60 .It Realtek 802.11n wireless 8723de (RTL8723DE)
61 .It Realtek 802.11ac wireless 8821ce (RTL8821CE)
62 .It Realtek 802.11ac wireless 8822be (RTL8822BE)
63 .It Realtek 802.11ac wireless 8822ce (RTL8822CE)
67 .\" No LinuxKPI man pages so no .Xr here.
71 compat framework to bridge between the Linux and
74 driver code as well as to the native
80 supports all 802.11 a/b/g/n and ac
81 the compatibility code currently only supports 802.11 a/b/g modes.
82 Support for 802.11 n/ac is to come.
84 .Bl -tag -width indent
85 .It Va compat.linuxkpi.skb.mem_limit
86 If you are running a 64bit system with more than 4GB of main memory
87 you need to set this tunable to
91 and reboot once to make it effective.
92 This tunable will work around a problem with DMA and limit allocations
93 for network buffer memory to the lower 32bit of physical memory and
99 Does not seem to work (reliably) on machines with more than 4GB of
112 driver first appeared in