diff options
Diffstat (limited to 'static/freebsd/man4/rtw89.4 3.html')
| -rw-r--r-- | static/freebsd/man4/rtw89.4 3.html | 102 |
1 files changed, 102 insertions, 0 deletions
diff --git a/static/freebsd/man4/rtw89.4 3.html b/static/freebsd/man4/rtw89.4 3.html new file mode 100644 index 00000000..a4a74d16 --- /dev/null +++ b/static/freebsd/man4/rtw89.4 3.html @@ -0,0 +1,102 @@ +<table class="head"> + <tr> + <td class="head-ltitle">RTW89(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">RTW89(4)</td> + </tr> +</table> +<div class="manual-text"> +<section class="Sh"> +<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> +<p class="Pp"><code class="Nm">rtw89</code> — <span class="Nd">Realtek + IEEE 802.11ax wireless network driver</span></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> +<p class="Pp">The driver will auto-load without any user interaction using + <a class="Xr">devmatch(8)</a> if enabled in + <a class="Xr">rc.conf(5)</a>.</p> +<p class="Pp">Only if auto-loading is explicitly disabled, place the following + lines in <a class="Xr">rc.conf(5)</a> to manually load the driver as a + module at boot time:</p> +<div class="Bd Pp Bd-indent Li"> +<pre>kld_list="${kld_list} if_rtw89"</pre> +</div> +<p class="Pp">It is not possible to load the driver from + <a class="Xr">loader(8)</a>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> +<p class="Pp">The <code class="Nm">rtw89</code> driver is derived from Realtek's + Linux rtw89 driver.</p> +<p class="Pp">This driver requires firmware to be loaded before it will work. + The package <span class="Pa">wifi-firmware-rtw89-kmod</span> from the + <span class="Pa">ports/net/wifi-firmware-rtw89-kmod</span> port needs to be + installed before the driver is loaded. Otherwise no + <a class="Xr">wlan(4)</a> interface can be created using + <a class="Xr">ifconfig(8)</a>. One should use <a class="Xr">fwget(8)</a> to + install the correct firmware package.</p> +<p class="Pp" id="linuxkpi_wlan">The driver uses the + <a class="permalink" href="#linuxkpi_wlan"><b class="Sy">linuxkpi_wlan</b></a> + and + <a class="permalink" href="#linuxkpi"><b class="Sy" id="linuxkpi">linuxkpi</b></a> + compat framework to bridge between the Linux and native + <span class="Ux">FreeBSD</span> driver code as well as to the native + <a class="Xr">net80211(4)</a> wireless stack.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1> +<p class="Pp">The <code class="Nm">rtw89</code> driver supports PCIe devices + with the following chipsets:</p> +<p class="Pp"></p> +<ul class="Bl-bullet Bd-indent Bl-compact"> + <li>Realtek 8851BE Wi-Fi 6 (RTL8851BE)</li> + <li>Realtek 8852AE Wi-Fi 6 (RTL8852AE)</li> + <li>Realtek 8852BE Wi-Fi 6 (RTL8852BE)</li> + <li>Realtek 8852CE Wi-Fi 6E (RTL8852CE)</li> + <li>Realtek 8922AE Wi-Fi 7 (RTL8922AE)</li> +</ul> +</section> +<section class="Sh"> +<h1 class="Sh" id="LOADER_TUNABLES"><a class="permalink" href="#LOADER_TUNABLES">LOADER + TUNABLES</a></h1> +<dl class="Bl-tag"> + <dt id="compat.linuxkpi.skb.mem_limit"><var class="Va">compat.linuxkpi.skb.mem_limit</var></dt> + <dd>If you are running a 64bit system with more than 4GB of main memory you + need to set this tunable to + <a class="permalink" href="#1"><b class="Sy" id="1">1</b></a> in + <a class="Xr">loader.conf(5)</a> and reboot once to make it effective. + This tunable will work around a problem with DMA and limit allocations for + network buffer memory to the lower 32bit of physical memory and make the + driver work.</dd> +</dl> +</section> +<section class="Sh"> +<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE + ALSO</a></h1> +<p class="Pp"><a class="Xr">wlan(4)</a>, <a class="Xr">networking(7)</a>, + <a class="Xr">fwget(8)</a>, <a class="Xr">ifconfig(8)</a>, + <a class="Xr">wpa_supplicant(8)</a></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1> +<p class="Pp">The <code class="Nm">rtw89</code> driver first appeared in + <span class="Ux">FreeBSD 14.2</span>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> +<p class="Pp">Certainly.</p> +<p class="Pp">Does not seem to work (reliably) on machines with more than 4GB of + main memory. See in the <a class="Sx" href="#LOADER_TUNABLES">LOADER + TUNABLES</a> section above.</p> +<p class="Pp">While <code class="Nm">rtw89</code> supports 802.11a/b/g/n/ac/ax + modes, the compatibility code currently only supports 802.11a/b/g modes. + Support for 802.11n/ac/ax is yet to come.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">June 13, 2025</td> + <td class="foot-os">FreeBSD 15.0</td> + </tr> +</table> |