Skip to content

Commit 8e1f893

Browse files
authored
Clean up wireless.md per review
1 parent dc45b19 commit 8e1f893

1 file changed

Lines changed: 27 additions & 33 deletions

File tree

content/wireless.md

Lines changed: 27 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,12 @@ If your computer can’t connect to wireless networks or the connection is unsta
2424

2525
1. Reboot the router/modem and the computer.
2626

27-
2. Toggle Airplane Mode from the system menu in the top-right corner of the screen, or using your keyboard shortcut which varies by System76 model. Most commonly **Fn + F11**
27+
2. Toggle Airplane Mode from the system menu in the top-right corner of the screen, or using your keyboard shortcut (most commonly **Fn + F11**, depending on your System76 model).
2828

29-
3. If your Wi-Fi issues began after an update and you are using an Intel wireless card with the `backport-iwlwifi-dkms` package installed manually, removing it may resolve the issue. Open the Terminal by pressing Super+T, type the following command, and press Enter:
29+
3. If you've installed the backport-iwlwifi-dkms package for your Intel wireless card and your Wi-Fi issues began after an update, removing that package may resolve the issue.
3030

3131
```bash
32-
sudo apt remove backport-iwlwifi-dkms
32+
sudo apt remove backport-iwlwifi-dkms
3333
```
3434
Then restart your computer.
3535

@@ -39,35 +39,35 @@ Then restart your computer.
3939

4040
## Router and Access Point Recommendations
4141

42-
Make sure your access point is configured for stability and compatibility.
42+
- Make sure your access point is configured for stability and compatibility.
4343

44-
Use 2.4 GHz channels 1, 6, or 11 to minimize overlap.
44+
- Use 2.4 GHz channels 1, 6, or 11 to minimize overlap.
4545

46-
Set the channel width to 20 MHz for crowded networks.
46+
- Set the channel width to 20 MHz for crowded networks.
4747

48-
For 5 GHz, use an explicit channel instead of “Auto” when troubleshooting.
48+
- For 5 GHz, use an explicit channel instead of “Auto” when troubleshooting.
4949

50-
Use mixed mode (b/g/n/ax) if devices vary by generation.
50+
- Use mixed mode (b/g/n/ax) if devices vary by generation.
5151

52-
If a single device struggles, temporarily set your router to a common mode and test.
52+
- If a single device struggles, temporarily set your router to a widely supported mode (such as **802.11n-only**) and test connectivity.
5353

54-
Avoid complex access point features such as
54+
- Avoid complex access point features such as:
5555

56-
Band steering
56+
- Band steering
57+
58+
- Aggressive airtime fairness
59+
60+
- Deep MAC filtering
5761

58-
Aggressive airtime fairness
59-
60-
Deep MAC filtering
61-
62-
Ensure your device’s MAC address isn’t being filtered
62+
Ensure your device’s MAC address isn’t being filtered.
6363

6464
Check with
6565

6666
```bash
6767
ip link show | grep ether
6868
```
6969

70-
Then confirm that address is allowed in your router’s admin panel.
70+
Then confirm the MAC address is allowed in your router’s admin panel.
7171

7272
You can also confirm what channel and frequency your connection is using:
7373

@@ -84,31 +84,31 @@ These commands help verify whether your wireless card and drivers are functionin
8484
ip a
8585
```
8686

87-
List all network interfaces and IP addresses confirms your Wi-Fi interface (usually wlp2s0 or wlan0) is recognized.
87+
Confirm that your Wi-Fi interface (usually `wlp2s0` or `wlan0`) is recognized.
8888

8989
```bash
9090
iw dev
9191
```
9292

93-
Show wireless devices and their states.
93+
Show wireless devices and their states:
9494

9595
```bash
9696
sudo rfkill list
9797
```
9898

99-
Check for hardware or software Wi-Fi blocks.
99+
Check for hardware or software Wi-Fi blocks:
100100

101101
```bash
102102
nmcli device status
103103
```
104104

105-
Check NetworkManager device states.
105+
Check NetworkManager device states:
106106

107107
```bash
108108
sudo systemctl restart NetworkManager
109109
```
110110

111-
Restart the network stack (safe to run anytime).
111+
Restart the network stack (safe to run at any time).
112112

113113
```bash
114114
journalctl -b | grep -i network
@@ -132,8 +132,6 @@ sudo dmesg | grep -i wlan > ~/wireless-dmesg.txt
132132

133133
If the device is detected but unstable, verify the driver and firmware setup.
134134

135-
Confirm the kernel has loaded the correct driver and firmware.
136-
137135
Check for missing firmware messages:
138136

139137
```bash
@@ -149,11 +147,9 @@ sudo apt install --reinstall linux-firmware
149147

150148
Test with a different router or mobile hotspot.
151149

152-
Try a Live USB session to determine if the issue is system-specific.
153-
154150
## NetworkManager and Configuration Tips
155151

156-
NetworkManager controls Wi-Fi connections on most Linux systems.
152+
NetworkManager controls Wi-Fi connections on many Linux systems, including Pop!_OS and Ubuntu systems by default.
157153

158154
Restart NetworkManager:
159155

@@ -168,13 +164,11 @@ nmcli connection delete <SSID>
168164
nmcli device wifi connect <SSID>
169165
```
170166

171-
For unstable networks, set IPv6 to “Ignore” in the network settings
167+
For unstable networks, set IPv6 to “Ignore” in the network settings:
172168

173169
1. Open Settings → Network.
174-
175170
2. Select your Wi-Fi connection.
176-
177-
3. Go to the IPv6 tab → change method to Ignore.
171+
3. Go to the IPv6 tab → change the method to Ignore.
178172

179173
## Bluetooth and Airplane Mode Interactions
180174

@@ -188,7 +182,7 @@ sudo systemctl restart bluetooth
188182
If the issues started after you applied updates, add a modprobe configuration to prevent a problematic Wi-Fi driver from loading, then reboot your computer:
189183

190184
```bash
191-
echo "blacklist iwlwifi" | sudo tee -a /etc/modprobe.d/iwlwifi.conf
185+
echo "options iwlwifi bt_coex_active=0" | sudo tee -a /etc/modprobe.d/iwlwifi.conf
192186
```
193187

194188
Save, then reboot.
@@ -352,4 +346,4 @@ If you're dual booting Windows, you may lose access to your Wi-Fi card entirely
352346

353347
## Contact System76 Support
354348

355-
If you purchased a System76 computer and you’ve tried all the steps above, but your wireless connection still isn’t working as expected, please collect the output from the diagnostic commands and [contact support](https://system76.com/contact/support).
349+
If you purchased a System76 computer and you’ve tried all the steps above, but your wireless connection still isn’t working as expected, please collect the output from the diagnostic commands and [contact System76 support](https://system76.com/contact/support).

0 commit comments

Comments
 (0)