12600131bSAdrian Chadd.\" Copyright (c) 2015 Kevin Lo 27453645fSAndriy Voskoboinyk.\" Copyright (c) 2016 Andriy Voskoboinyk 32600131bSAdrian Chadd.\" All rights reserved. 42600131bSAdrian Chadd.\" 52600131bSAdrian Chadd.\" Redistribution and use in source and binary forms, with or without 62600131bSAdrian Chadd.\" modification, are permitted provided that the following conditions 72600131bSAdrian Chadd.\" are met: 82600131bSAdrian Chadd.\" 1. Redistributions of source code must retain the above copyright 92600131bSAdrian Chadd.\" notice, this list of conditions and the following disclaimer. 102600131bSAdrian Chadd.\" 2. The name of the author may not be used to endorse or promote products 112600131bSAdrian Chadd.\" derived from this software without specific prior written permission. 122600131bSAdrian Chadd.\" 132600131bSAdrian Chadd.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 142600131bSAdrian Chadd.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 152600131bSAdrian Chadd.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 162600131bSAdrian Chadd.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 172600131bSAdrian Chadd.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 182600131bSAdrian Chadd.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 192600131bSAdrian Chadd.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 202600131bSAdrian Chadd.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 212600131bSAdrian Chadd.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 222600131bSAdrian Chadd.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 232600131bSAdrian Chadd.\" 24*d42e525cSAndriy Voskoboinyk.Dd January 3, 2019 252600131bSAdrian Chadd.Dt RTWNFW 4 262600131bSAdrian Chadd.Os 272600131bSAdrian Chadd.Sh NAME 282600131bSAdrian Chadd.Nm rtwnfw 292600131bSAdrian Chadd.Nd "Firmware Module for Realtek Wireless driver" 302600131bSAdrian Chadd.Sh SYNOPSIS 312600131bSAdrian ChaddTo compile this module into the kernel, 322600131bSAdrian Chaddplace the following line in your 332600131bSAdrian Chaddkernel configuration file: 342600131bSAdrian Chadd.Bd -ragged -offset indent 352600131bSAdrian Chadd.Cd "device rtwnfw" 362600131bSAdrian Chadd.Ed 372600131bSAdrian Chadd.Pp 387453645fSAndriy VoskoboinykThis will include all firmware images inside the kernel. 392600131bSAdrian ChaddIf you want to pick only the firmware image for your network adapter choose one 402600131bSAdrian Chaddof the following: 412600131bSAdrian Chadd.Bd -ragged -offset indent 42*d42e525cSAndriy Voskoboinyk.Cd "device rtwn-rtl8188eefw" 437453645fSAndriy Voskoboinyk.Cd "device rtwn-rtl8188eufw" 447453645fSAndriy Voskoboinyk.Cd "device rtwn-rtl8192cfwE_B" 457453645fSAndriy Voskoboinyk.Cd "device rtwn-rtl8192cfwE" 467453645fSAndriy Voskoboinyk.Cd "device rtwn-rtl8192cfwT" 472600131bSAdrian Chadd.Cd "device rtwn-rtl8192cfwU" 4860b9567dSKevin Lo.Cd "device rtwn-rtl8192eufw" 497453645fSAndriy Voskoboinyk.Cd "device rtwn-rtl8812aufw" 507453645fSAndriy Voskoboinyk.Cd "device rtwn-rtl8821aufw" 512600131bSAdrian Chadd.Ed 522600131bSAdrian Chadd.Pp 537453645fSAndriy VoskoboinykAlternatively, to load all firmware images as a 542600131bSAdrian Chaddmodule at boot time, place the following line in 552600131bSAdrian Chadd.Xr loader.conf 5 : 562600131bSAdrian Chadd.Bd -literal -offset indent 57*d42e525cSAndriy Voskoboinykrtwn-rtl8188eefw_load="YES" 587453645fSAndriy Voskoboinykrtwn-rtl8188eufw_load="YES" 597453645fSAndriy Voskoboinykrtwn-rtl8192cfwE_B_load="YES" 607453645fSAndriy Voskoboinykrtwn-rtl8192cfwE_load="YES" 617453645fSAndriy Voskoboinykrtwn-rtl8192cfwT_load="YES" 622600131bSAdrian Chaddrtwn-rtl8192cfwU_load="YES" 6360b9567dSKevin Lortwn-rtl8192eufw_load="YES" 647453645fSAndriy Voskoboinykrtwn-rtl8812aufw_load="YES" 657453645fSAndriy Voskoboinykrtwn-rtl8821aufw_load="YES" 662600131bSAdrian Chadd.Ed 672600131bSAdrian Chadd.Sh DESCRIPTION 687453645fSAndriy Voskoboinykrtwn-rtl8192cfwE and rtl8192cfwE_B modules provide access 697453645fSAndriy Voskoboinykto firmware sets for the Realtek RTL8188CE chip based PCIe adapters. 70*d42e525cSAndriy Voskoboinykrtwn-rtl8188ee module provides access to firmware sets for the 71*d42e525cSAndriy VoskoboinykRealtek RTL8188EE chip based PCIe adapters. 727453645fSAndriy VoskoboinykOther modules provide access to firmware sets for the Realtek RTL8188CUS, 7360b9567dSKevin LoRTL8188CE-VAU, RTL8188EUS, RTL8188RU, RTL8192CU, RTL8192EU, RTL8812AU and 7460b9567dSKevin LoRTL8821AU chip based USB WiFi adapters. 757453645fSAndriy VoskoboinykThey may be 767453645fSAndriy Voskoboinykstatically linked into the kernel, or loaded as a modules. 772600131bSAdrian Chadd.Pp 782600131bSAdrian ChaddFor the loaded firmware to be enabled for use the license at 792600131bSAdrian Chadd.Pa /usr/share/doc/legal/realtek.LICENSE 802600131bSAdrian Chaddmust be agreed to by adding the following line to 812600131bSAdrian Chadd.Xr loader.conf 5 : 822600131bSAdrian Chadd.Pp 832600131bSAdrian Chadd.Dl "legal.realtek.license_ack=1" 842600131bSAdrian Chadd.Sh FILES 852600131bSAdrian Chadd.Bl -tag -width ".Pa /usr/share/doc/legal/realtek.LICENSE" -compact 862600131bSAdrian Chadd.It Pa /usr/share/doc/legal/realtek.LICENSE 872600131bSAdrian Chadd.Nm 882600131bSAdrian Chaddfirmware license 892600131bSAdrian Chadd.El 902600131bSAdrian Chadd.Sh SEE ALSO 912600131bSAdrian Chadd.Xr rtwn 4 , 922600131bSAdrian Chadd.Xr firmware 9 93