git: 20eeed6844e2 - main - rtw88: add man pages and hook up to build
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Fri, 01 Apr 2022 00:32:29 UTC
The branch main has been updated by bz:
URL: https://cgit.FreeBSD.org/src/commit/?id=20eeed6844e2ab82b909e02c720101297e78d916
commit 20eeed6844e2ab82b909e02c720101297e78d916
Author: Bjoern A. Zeeb <bz@FreeBSD.org>
AuthorDate: 2022-03-30 22:36:03 +0000
Commit: Bjoern A. Zeeb <bz@FreeBSD.org>
CommitDate: 2022-04-01 00:07:24 +0000
rtw88: add man pages and hook up to build
Add man pages for rtw88 and rtw88fw. Install a copy of the firmware
license file and hook up the driver and firmware modules to the build.
MFC after: 2 weeks
Sponsored by: The FreeBSD Foundation
Relnotes: yes
---
share/doc/legal/Makefile | 3 +-
share/doc/legal/realtek_rtw88/Makefile | 7 +++
share/man/man4/Makefile | 2 +
share/man/man4/rtw88.4 | 95 ++++++++++++++++++++++++++++++++++
share/man/man4/rtw88fw.4 | 56 ++++++++++++++++++++
sys/modules/Makefile | 6 +++
6 files changed, 168 insertions(+), 1 deletion(-)
diff --git a/share/doc/legal/Makefile b/share/doc/legal/Makefile
index 7a20215305d2..9710bfa48832 100644
--- a/share/doc/legal/Makefile
+++ b/share/doc/legal/Makefile
@@ -5,7 +5,8 @@ SUBDIR= intel_ipw \
intel_iwlwififw \
intel_iwn \
intel_wpi \
- realtek
+ realtek \
+ realtek_rtw88
SUBDIR_PARALLEL=
diff --git a/share/doc/legal/realtek_rtw88/Makefile b/share/doc/legal/realtek_rtw88/Makefile
new file mode 100644
index 000000000000..8f1d6d9b9c41
--- /dev/null
+++ b/share/doc/legal/realtek_rtw88/Makefile
@@ -0,0 +1,7 @@
+# $FreeBSD$
+
+FILES= ${SRCTOP}/sys/contrib/dev/rtw88fw/LICENCE.rtlwifi_firmware.txt
+FILESDIR= ${SHAREDIR}/doc/legal
+FILESNAME= realtek_rtw88_firmware.LICENCE
+
+.include <bsd.prog.mk>
diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 251b09081b34..605285816ce3 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -466,6 +466,8 @@ MAN= aac.4 \
rndtest.4 \
route.4 \
rtsx.4 \
+ rtw88.4 \
+ rtw88fw.4 \
rtwn.4 \
rtwnfw.4 \
rtwn_pci.4 \
diff --git a/share/man/man4/rtw88.4 b/share/man/man4/rtw88.4
new file mode 100644
index 000000000000..b34fbf96c5df
--- /dev/null
+++ b/share/man/man4/rtw88.4
@@ -0,0 +1,95 @@
+.\"-
+.\" Copyright (c) 2022 Bjoern A. Zeeb
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\" $FreeBSD$
+.\"
+.Dd March 31, 2022
+.Dt rtw88 4
+.Os
+.Sh NAME
+.Nm rtw88
+.Nd Realtek IEEE 802.11n/ac wireless network driver
+.Sh SYNOPSIS
+The driver will auto-load without any user interaction using
+.Xr devmatch 8
+if enabled in
+.Xr rc.conf 5 .
+.Pp
+Only if auto-loading is explicitly disabled, place the following
+lines in
+.Xr rc.conf 5
+to manually load the driver as a module at boot time:
+.Bd -literal -offset indent
+kld_list="${kld_list} if_rtw88"
+.Ed
+.Pp
+The driver should automatically load any
+.Xr rtw88fw 4
+firmware needed for the particular chipset.
+.Pp
+It is discouraged to load the driver from
+.Xr loader 8 .
+.Sh DESCRIPTION
+The
+.Nm
+driver is derived from Realtek's Linux rtw88 driver and provides support for
+the following chipsets:
+.Pp
+.Bl -tag -width Ds -offset indent -compact
+.It Realtek 802.11n wireless 8723de (RTL8723DE)
+.It Realtek 802.11ac wireless 8821ce (RTL8821CE)
+.It Realtek 802.11ac wireless 8822be (RTL8822BE)
+.It Realtek 802.11ac wireless 8822ce (RTL8822CE)
+.El
+.Pp
+The driver uses the
+.\" No LinuxKPI man pages so no .Xr here.
+.Em linuxkpi_wlan
+and
+.Em linuxkpi
+compat framework to bridge between the Linux and
+native FreeBSD driver code as well as to the native
+.Xr net80211 4
+wireless stack.
+.Pp
+While
+.Nm
+supports all 802.11 a/b/g/n and ac
+the compatibility code currently only supports 802.11 a/b/g modes.
+Support for 802.11 n/ac is to come.
+.Sh BUGS
+Certainly.
+.Pp
+Does not seem to work (reliably) on machines with more than 4GB of
+main memory.
+.Sh SEE ALSO
+.Xr rtw88fw 4 ,
+.Xr wlan 4 ,
+.Xr ifconfig 8 ,
+.Xr wpa_supplicant 8
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Fx 14.0 .
diff --git a/share/man/man4/rtw88fw.4 b/share/man/man4/rtw88fw.4
new file mode 100644
index 000000000000..1bf756d67e57
--- /dev/null
+++ b/share/man/man4/rtw88fw.4
@@ -0,0 +1,56 @@
+.\"-
+.\" Copyright (c) 2022 Bjoern A. Zeeb
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\" $FreeBSD$
+.\"
+.Dd March 31, 2022
+.Dt rtw88fw 4
+.Os
+.Sh NAME
+.Nm rtw88fw
+.Nd Firmware modules for Realtek rtw88 wireless network driver
+.Sh SYNOPSIS
+The
+.Xr rtw88 4
+driver should auto-load any firmware needed.
+It is discouraged to load the driver or firmware manually from
+.Xr loader 8 .
+.Sh DESCRIPTION
+Multiple modules provide access to firmware for the various chipset
+models supported by the
+.Xr rtw88 4
+driver.
+.Sh FILES
+A copy of the
+.Xr rtw88 4
+firmware license is installed at
+.Em /usr/share/doc/legal/realtek_rtw88_firmware.LICENCE .
+.Sh SEE ALSO
+.Xr rtw88 4 ,
+.Xr firmware 9
+.Sh HISTORY
+The
+.Nm
+firmware modules first appeared in
+.Fx 14.0 .
diff --git a/sys/modules/Makefile b/sys/modules/Makefile
index 15f92f04da26..3731e9c1e453 100644
--- a/sys/modules/Makefile
+++ b/sys/modules/Makefile
@@ -319,6 +319,8 @@ SUBDIR= \
rl \
${_rockchip} \
rtsx \
+ ${_rtw88} \
+ ${_rtw88fw} \
rtwn \
rtwn_pci \
rtwn_usb \
@@ -529,6 +531,10 @@ _mlx4ib= mlx4ib
_mlx5ib= mlx5ib
.endif
_ossl= ossl
+_rtw88= rtw88
+.if ${MK_SOURCELESS_UCODE} != "no"
+_rtw88fw= rtw88fw
+.endif
_vmware= vmware
.endif