How to Inspect Wi-Fi Link Telemetry and Connection States on Android Using ADB dumpsys wifi

Diagnosing wireless connectivity degradation, roaming latency, and unexpected packet loss on Android devices often requires telemetry beyond the standard Wi-Fi settings interface. While the graphical user interface displays basic signal bars and network SSIDs, low-level metrics—such as received signal strength indication (RSSI) decibels, link negotiation speeds, channel frequencies, MAC address randomisation states, and background scan throttle locks—are managed by the Android Wi-Fi framework service. Using the Android Debug Bridge (ADB), engineers can extract real-time diagnostic telemetry through dumpsys wifi to audit network performance and isolate wireless faults.

Architecture of the Android Wi-Fi Service

The Android Wi-Fi subsystem is driven by the WifiService and WifiScanningService system daemons. These components interface with the wpa_supplicant or hostapd native daemons and the underlying Wi-Fi Hardware Abstraction Layer (HAL). When a device roams between access points, negotiates dynamic link speeds, or throttles background scanning to conserve battery power, the Wi-Fi service maintains an exhaustive state ledger.

The dumpsys wifi utility provides an in-depth window into this internal state machine, reporting active client mode managers, candidate scan rankings, DHCP lease metadata, and hardware radio chip power metrics.

Inspecting Real-Time Wi-Fi Link Telemetry

To inspect active connection metrics, establish an ADB connection to your device via USB or TCP/IP and run:

adb shell dumpsys wifi

Because the complete Wi-Fi dump generates substantial output, filtering for specific diagnostic blocks allows you to isolate connection parameters quickly.

Querying Current Link Speed, RSSI, and Frequency

To view real-time link negotiation details for the active wireless connection, query the Wi-Fi information block:

adb shell dumpsys wifi | grep -A 20 "mWifiInfo"

The service returns structured telemetry:

mWifiInfo:
  SSID: "Corporate-5G"
  BSSID: 04:d9:f5:82:1a:90
  MAC: 72:3c:5b:91:e2:11
  Supplicant state: COMPLETED
  RSSI: -58 dBm
  Link speed: 866 Mbps
  Tx Link speed: 866 Mbps
  Rx Link speed: 866 Mbps
  Frequency: 5240 MHz (Channel 48)
  Standard: 11ac (Wi-Fi 5)
  Channel width: 80 MHz

Critical operational metrics include:

• RSSI: Signal strength measured in dBm. Values between -30 dBm and -65 dBm represent strong, reliable signals; values below -75 dBm trigger aggressive background roaming scans.
• Link speed (Tx/Rx): Real-time PHY negotiation rate. A sharp divergence between Tx and Rx speeds typically indicates local radio interference or asymmetric transmit power between the access point and the mobile device.
• Frequency & Channel width: Indicates whether the device operates on 2.4 GHz (20/40 MHz), 5 GHz (80/160 MHz), or 6 GHz (Wi-Fi 6E/7 channels).

Auditing Wi-Fi Scan Results and Candidate Selection

When an Android device roams across corporate or campus environments with multiple overlapping access points sharing the same SSID, the Wi-Fi framework evaluates candidates using internal score scoring algorithms.

To view the most recent scan cache and candidate rankings:

adb shell dumpsys wifi | grep -A 30 "Latest scan results:"

Each detected BSSID appears with its detected signal strength, supported capabilities (such as WPA3-SAE, WPA2-PSK, or 802.11k/v/r roaming tags), and timestamp. If your device clings to a distant access point with poor throughput rather than roaming to a nearby access point, reviewing the scan score calculations in the dump reveals whether hysteresis thresholds are preventing timely handoffs.

Diagnosing Wi-Fi Power-Saving and Scan Throttling

Android enforces strict Wi-Fi scan throttling to prevent aggressive apps from draining battery power. Under default operating system policies, foreground applications can trigger scans only four times in a 2-minute period, while background apps are restricted to one scan every 30 minutes.

To inspect active scan throttle states and screen-on/screen-off radio policies:

adb shell dumpsys wifi | grep -A 15 "ScanRequestProxy"

To temporarily disable Wi-Fi scan throttling during network benchmarking and site survey audits, run:

adb shell cmd wifi set-scan-throttle-enabled 0

To re-enable scan throttling and restore standard battery-saving policies:

adb shell cmd wifi set-scan-throttle-enabled 1

Monitoring Wi-Fi State Transitions in Real Time

To trace Wi-Fi state machine transitions, authentication handshakes, and roaming decisions as they occur, pipe logcat output through a dedicated Wi-Fi tag filter:

adb logcat -v time -s WifiClientModeImpl WifiNetworkSelector WifiNative

Executing network reconnections while monitoring this stream provides immediate feedback on 4-way WPA handshakes, DHCP address acquisition times, and gateway ping verifications.