Skip to content

Commit 77e8a21

Browse files
authored
Update wireless.md
All requested edits have been completed, and the document is now ready for review. Thank you for the helpful feedback I appreciate your time and guidance!
1 parent d4e9a1f commit 77e8a21

File tree

1 file changed

+46
-43
lines changed

1 file changed

+46
-43
lines changed

content/wireless.md

Lines changed: 46 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -17,29 +17,23 @@ tableOfContents: true
1717
---
1818

1919
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.
21-
Include logs when you ask for support.
20+
Start with the quick checks, then follow the targeted diagnostic and recovery steps.
2221

2322
---
2423

25-
## Quick Checks (First Steps)
26-
2724
Try these steps before diving into advanced troubleshooting:
28-
29-
- Reboot the router/modem and the computer.
30-
- Toggle Airplane Mode: **Fn + F11 → wait 10s → disable Airplane Mode.**
31-
- If your Wi-Fi issues started after an update, try removing the backported Wi-Fi driver:
25+
1. Reboot the router/modem and the computer.
26+
2. Toggle Airplane Mode by pressing **Fn + F11 →.**
27+
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:
3228

3329
```bash
3430
sudo apt remove backport-iwlwifi-dkms
3531
```
3632
Then restart your computer.
37-
Temporarily use a phone hotspot to confirm whether the network or your computer is the issue.
38-
Boot from a Live USB of your distribution to determine whether the issue exists outside your installed system.
39-
40-
Router and Access Point Recommendations
33+
4. Temporarily use a phone hotspot to confirm whether the network or your computer is the issue.
34+
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.
4135

42-
Many connection issues are caused by router settings.
36+
## Router and Access Point Recommendations
4337

4438
Make sure your access point is configured for stability and compatibility.
4539

@@ -77,19 +71,48 @@ iwlist wlan0 scan | grep -E 'SSID|Channel|Frequency'
7771

7872
These commands help verify whether your wireless card and drivers are functioning correctly.
7973

80-
ip a — List all network interfaces and IP addresses confirms your Wi-Fi interface (usually wlp2s0 or wlan0) is recognized.
74+
```bash
75+
ip a
76+
```
77+
78+
List all network interfaces and IP addresses confirms your Wi-Fi interface (usually wlp2s0 or wlan0) is recognized.
79+
80+
```bash
81+
iw dev
82+
```
83+
84+
Show wireless devices and their states.
85+
86+
```bash
87+
sudo rfkill list
88+
```
89+
90+
Check for hardware or software Wi-Fi blocks.
91+
92+
```bash
93+
nmcli device status
94+
```
95+
96+
Check NetworkManager device states.
8197

82-
iw dev — Show wireless devices and their states.
8398

84-
sudo rfkill list — Check for hardware or software Wi-Fi blocks.
99+
```bash
100+
sudo systemctl restart NetworkManager
101+
```
85102

86-
nmcli device status — Check NetworkManager device states.
103+
Restart the network stack (safe to run anytime).
104+
105+
```bash
106+
journalctl -b | grep -i network
107+
```
87108

88-
sudo systemctl restart NetworkManager — Restart the network stack (safe to run anytime).
109+
View network-related boot logs.
89110

90-
journalctl -b | grep -i network — View network-related boot logs.
111+
```bash
112+
dmesg | grep -i -E 'wifi|wlan|firmware|ieee80211|rtl|brcm|ath'
113+
```
91114

92-
dmesg | grep -i -E 'wifi|wlan|firmware|ieee80211|rtl|brcm|ath' — View driver and firmware kernel logs.
115+
View driver and firmware kernel logs.
93116

94117
To collect diagnostic info automatically:
95118

@@ -130,7 +153,7 @@ Restart NetworkManager:
130153
sudo systemctl restart NetworkManager
131154
```
132155

133-
-Delete and recreate saved connections:
156+
Delete and recreate saved connections:
134157

135158
```bash
136159
nmcli connection delete <SSID>
@@ -165,17 +188,6 @@ options iwlwifi bt_coex_active=0
165188

166189
Save, then reboot.
167190

168-
## Quick Reference Commands
169-
170-
```bash
171-
ip a
172-
iw dev
173-
sudo rfkill list
174-
nmcli device status
175-
sudo systemctl restart NetworkManager
176-
sudo dmesg | grep -i wlan > ~/wireless-dmesg.txt
177-
```
178-
179191
## Advanced Troubleshooting
180192

181193
If the above steps aren't working, or you would like to fine tune and improve you connection, see the following steps.
@@ -338,15 +350,6 @@ Sometimes the newest version of the firmware will clear up occasional bugs. Ple
338350

339351
If you are dual booting Windows, you may lose access to your wifi card entirely after running driver/OS updates in Windows. You may be able to gain access to your wifi card again by disabling "Fast Startup" in the Windows power options before booting back into Pop!_OS.
340352

341-
## When to Contact Support
342-
343-
If you’ve tried all the steps above and your wireless connection still isn’t working as expected, please collect the output from the diagnostic commands and contact System76 Support.
344-
345-
When reaching out, include:
346-
-The model of your computer
347-
-Your version of Pop!_OS or Ubuntu
348-
-The commands and results listed above
349-
350-
This information helps the support team quickly identify the cause and get you back online.
353+
## Contact System76 Support
351354

352-
This will save relevant wireless logs you can share with System76 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 [System76 Support](https://system76.com/contact/support)

0 commit comments

Comments
 (0)