Skip to content

Commit 2242326

Browse files
committed
Add Inspect network adapters
1 parent 6d2b1b4 commit 2242326

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

docs/troubleshooting.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,20 @@ WifiInterface = wlan0
7272

7373
RaspAP's debug log contains information about your system and local network configuration. However, no passwords or other senstive data are included.
7474

75+
## Inspect network adapters
76+
:octicons-beaker-24: Experimental · :octicons-heart-fill-24:{: .heart } [Insiders only](insiders.md)
77+
78+
If you've installed an external WLAN or other adapter on your device, RaspAP can assist you with troubleshooting common issues. The **System > Tools > Inspect adapters** button will open a dialog that lets you perform a comprehensive inspection of your network adapters.
79+
80+
![adapter health check](images/health-check.png){: style="width:580px"}
81+
82+
The inspection tool returns details about available network hardware including drivers, firmware versions, supported modes and so on. RaspAP also has an innovative one-click **Adapter health check** option. This performs a multi-step check of your selected adapter to identify common problems that may prevent it from working with RaspAP.
83+
84+
!!! tip "Tip"
85+
Many WLAN interfaces will report a failed state for the "Can reach internet" check. This is expected if you're using an interface to host an access point, for example, or if it's in an unconfigured state. For comparison, choose an interface that's a source of internet connectivity on your device, such as `eth0` or `usb0`.
86+
87+
The **Inspect adapters** and **Adapter health check** are the best available diagnostic tools for your device's network hardware.
88+
7589
## Diagnosing problems
7690
Look for any reported errors logged by the `hostapd`, `dhcpcd` or `dnsmasq` services. In most cases, errors thrown by one or more of these services have been discussed in various online forums.
7791
Start by searching the official [Raspberry Pi forums](https://www.raspberrypi.org/forums/) or [Raspberry Pi on Stack Exchange](https://raspberrypi.stackexchange.com/). Chances are the problems with your AP have been discussed and answered before.

0 commit comments

Comments
 (0)