Skip to content

Commit dc45b19

Browse files
authored
Fix wireless troubleshooting docs
1 parent 598298b commit dc45b19

File tree

1 file changed

+15
-31
lines changed

1 file changed

+15
-31
lines changed

content/wireless.md

Lines changed: 15 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Wireless and Basic Troubleshooting
2+
title: Wireless Troubleshooting
33
description: >
44
If your computer can’t connect to wireless networks or the connection is unstable, use this guide to diagnose and resolve the issue.
55
keywords:
@@ -16,27 +16,26 @@ section: network-troubleshooting
1616
tableOfContents: true
1717
---
1818

19-
If your computer can’t connect to wireless networks or the connection is unstable, use this guide to diagnose and resolve the issue.
20-
Start with the quick checks, then follow the targeted diagnostic and recovery steps.
19+
If your computer can’t connect to wireless networks or the connection is unstable, this guide can help you diagnose and fix the issue.
2120

2221
---
2322

2423
## Initial Troubleshooting
2524

26-
1.Reboot the router/modem and the computer.
25+
1. Reboot the router/modem and the computer.
2726

28-
2.Toggle Airplane Mode by pressing **Fn + F11 →.**
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**
2928

30-
3.If your Wi-Fi issues started after an update, try removing the backported Wi-Fi driver using the command line. Open the Terminal by pressing Super+t and type the following and press Enter:
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:
3130

3231
```bash
3332
sudo apt remove backport-iwlwifi-dkms
3433
```
3534
Then restart your computer.
3635

37-
4.Temporarily use a phone hotspot to confirm whether the network or your computer is the issue.
36+
4. Temporarily use a phone hotspot to confirm whether the network or your computer is the issue.
3837

39-
5.[Boot from a Live USB](https://support.system76.com/articles/live-disk) of your distribution to determine whether the issue exists outside your installed system.
38+
5. [Boot from a Live USB](https://support.system76.com/articles/live-disk) of your distribution to determine whether the issue exists outside your installed system.
4039

4140
## Router and Access Point Recommendations
4241

@@ -175,7 +174,7 @@ For unstable networks, set IPv6 to “Ignore” in the network settings
175174

176175
2. Select your Wi-Fi connection.
177176

178-
3. Go to IPv6 tab → change method to Ignore.
177+
3. Go to the IPv6 tab → change method to Ignore.
179178

180179
## Bluetooth and Airplane Mode Interactions
181180

@@ -186,16 +185,10 @@ sudo rfkill list
186185
sudo systemctl restart bluetooth
187186
```
188187

189-
You can also disable Bluetooth coexistence in the Intel Wi-Fi driver configuration file:
188+
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:
190189

191190
```bash
192-
sudo gedit /etc/modprobe.d/iwlwifi.conf
193-
```
194-
195-
Add the following line:
196-
197-
```bash
198-
options iwlwifi bt_coex_active=0
191+
echo "blacklist iwlwifi" | sudo tee -a /etc/modprobe.d/iwlwifi.conf
199192
```
200193

201194
Save, then reboot.
@@ -261,22 +254,13 @@ If you have trouble with a Bluetooth headset and keeping a steady downlink speed
261254
262255
### Power Management
263256

264-
Another way to help with Wi-Fi issues is to turn off power management for the hardware. To do so, edit the configuration file with this command:
257+
Another way to help with Wi-Fi issues is to turn off Wi-Fi power management by adding a NetworkManager configuration, then reboot your computer:
265258

266259
```bash
267-
sudo gedit /etc/NetworkManager/conf.d/default-wifi-powersave-on.conf
260+
echo -e "[connection]\nwifi.powersave = 2" | sudo tee /etc/NetworkManager/conf.d/default-wifi-powersave-off.conf
268261
```
269262

270-
And change the file to read (effective upon reboot):
271-
272-
> \[connection\]
273-
> wifi.powersave = 2
274-
275-
If `tlp` is installed, take a look at the settings file found here for additional Wi-Fi power saving being enabled:
276-
277-
```bash
278-
sudo gedit /etc/default/tlp
279-
```
263+
If TLP is installed, it may also enable Wi-Fi power saving. You can review its configuration in `/etc/default/tlp`.
280264

281265
## Useful Programs
282266

@@ -364,8 +348,8 @@ Sometimes the newest version of the firmware will clear up occasional bugs. Ple
364348

365349
### Windows Dual Boot
366350

367-
If you are dual booting Windows, you may lose access to your Wi-Fi card entirely after running driver/OS updates in Windows. You may be able to gain access to your Wi-Fi card again by disabling "Fast Startup" in the Windows power options before booting back into Pop!_OS.
351+
If you're dual booting Windows, you may lose access to your Wi-Fi card entirely after running driver/OS updates in Windows. You may be able to gain access to your Wi-Fi card again by disabling "Fast Startup" in the Windows power options before booting back into Pop!_OS.
368352

369353
## Contact System76 Support
370354

371-
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)
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).

0 commit comments

Comments
 (0)