source: networking/netprogs/wireless-kernel.xml@ c41cafb

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since c41cafb was ca66edf, checked in by Xi Ruoyao <xry111@…>, 15 months ago

Clarify wireless kernel requirements

  • Property mode set to 100644
File size: 2.3 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="wireless-kernel" xreflabel="Configure the Linux Kernel for Wireless">
9 <?dbhtml filename="wireless-kernel.html"?>
10
11
12 <title>Configure the Linux Kernel for Wireless</title>
13
14 <para>
15 Before using any userspace tool for connecting with a wireless AP,
16 the Linux kernel must be configured to drive the wireless NIC properly.
17 Enable the following options in the kernel configuration as well as
18 specific device drivers for your hardware and recompile the kernel if
19 necessary:
20 </para>
21
22<screen><literal>[*] Networking support ---&gt; [CONFIG_NET]
23 [*] Wireless ---&gt; [CONFIG_WIRELESS]
24 &lt;*/M&gt; cfg80211 - wireless configuration API [CONFIG_CFG80211]
25 &lt; /*/M&gt; Generic IEEE 802.11 Networking Stack (mac80211) [CONFIG_MAC80211]
26Device Drivers ---&gt;
27 [*] Network device support ---&gt; [CONFIG_NETDEVICES]
28 [*] Wireless LAN ---&gt; [CONFIG_WLAN]</literal></screen>
29
30 <para>
31 Open the <quote>Wireless LAN</quote> submenu and select the options that
32 support your hardware. <command>lspci</command> from
33 <xref linkend="pciutils"/> or <command>lsusb</command> from
34 <xref linkend="usbutils"/> can be used to
35 view your hardware configuration. Note that many (though not all)
36 options for the wireless NICs depend on
37 <parameter>CONFIG_MAC80211</parameter>. After the correct drivers are
38 loaded, the interface will appear in
39 <filename>/sys/class/net</filename>, or the output of the
40 <command>ip link</command> command.
41 </para>
42
43 <para>
44 Many wireless NIC drivers require a firmware. If you've enabled the
45 correct driver in the kernel configuration but it fails to load (with
46 the messages like <quote><computeroutput>Direct firmware load for
47 <replaceable>&lt;filename</replaceable>&gt; failed with error
48 -2</computeroutput></quote>, it means you need to install the firmware
49 or the wireless NIC won't work. Read <xref linkend='postlfs-firmware'/>
50 for details.
51 </para>
52
53</sect1>
Note: See TracBrowser for help on using the repository browser.