Status: Implemented and tested

Wi-Fi & Networking Subsystem

Wi-Fi diagnostics evaluates wireless radio hardware: dual/tri-band support (2.4 GHz, 5 GHz, 6 GHz), operating channels, instantaneous PHY link speeds, signal strength (RSSI), and generation standards (Wi-Fi 4, 5, 6).

Why Does Reading Wi-Fi Information Require Location Permission?

Many users are surprised when a hardware utility requests ACCESS_FINE_LOCATION just to display the name of the connected Wi-Fi network. Because global geolocation databases (like Google Location Services) map unique Wi-Fi router BSSIDs (MAC addresses) to precise physical street coordinates, Android treats reading the Wi-Fi SSID and BSSID as equivalent to querying GPS coordinates. If location permission is withheld, Android conceals the network name and returns <unknown ssid>.

Security & Ethical Boundary: Never Retrieving Wi-Fi Passwords

Voodoo Hardware Info does not retrieve, crack, or display Wi-Fi network security passwords. In Android, network pre-shared keys (PSKs) are securely encrypted inside the OS Keystore and wpa_supplicant.conf (inaccessible without elevated root). We inspect radio hardware and connection performance exclusively.

How Voodoo Inspects Wi-Fi Subsystems

1. Primary Call & API-Level Fallback Chain

Extracted from WifiCollector.kt. Queries WifiManager and WifiInfo, with segregated helpers for API 30+ Wi-Fi standards:

// Excerpt from com.tool3.hardwareinfo.categories.wifi.WifiCollector.kt
val wifiManager = context.applicationContext.getSystemService(Context.WIFI_SERVICE) as WifiManager
val wifiInfo = wifiManager.connectionInfo

val isWifiEnabled = wifiManager.isWifiEnabled
val rssi = wifiInfo?.rssi ?: -127
val linkSpeedMbps = wifiInfo?.linkSpeed ?: -1
val frequencyMhz = if (Build.VERSION.SDK_INT >= 21) wifiInfo?.frequency ?: 0 else 0

// Modern Wi-Fi generation standard (API 30+)
val wifiStandard = if (Build.VERSION.SDK_INT >= 30 && wifiInfo != null) {
    ModernWifiHelper.getWifiStandard(wifiInfo) // e.g. WIFI_STANDARD_11AX (Wi-Fi 6)
} else null

2. Permission & Privilege Gate

  • Adapter presence, link speed, and state require ACCESS_WIFI_STATE (granted automatically at install).
  • Reading SSID and BSSID requires ACCESS_FINE_LOCATION on Android 8.0+ (API 26+). If not granted, Voodoo displays basic link metrics and marks SSID as PERMISSION_DENIED.

3. Interpretation & Normalization Logic

  • Channel Calculation (WifiChannelHelper.kt): Converts raw frequency in MHz into standard Wi-Fi channel numbers: 2.4 GHz channels 1–14 ((freq - 2407) / 5), 5 GHz UNII channels 36–165 ((freq - 5000) / 5), and 6 GHz Wi-Fi 6E channels.
  • Signal Quality: Normalized from raw RSSI dBm into a percentage scale (WifiManager.calculateSignalLevel).

4. Availability-State Triggers

  • When Wi-Fi is disabled, active connection fields return AvailabilityState.UNAVAILABLE.
  • getWifiStandard() on Android < 11 triggers AvailabilityState.UNSUPPORTED.

Subsystem Field Inventory

Field ID Display Name Type Primary Source / API Min API
wifi.adapter_state Wi-Fi Adapter State BOOLEAN WifiManager.isWifiEnabled API 1
wifi.link_speed_mbps Link Speed (Mbps) INTEGER WifiInfo.getLinkSpeed() API 1
wifi.frequency_mhz Channel Frequency (MHz) INTEGER WifiInfo.getFrequency() (API 21+) API 21
wifi.channel Wi-Fi Channel INTEGER Calculated from frequency (WifiChannelHelper) API 21
wifi.signal_rssi Signal Strength (RSSI) INTEGER WifiInfo.getRssi() API 1
wifi.standard Wi-Fi Standard (Generation) STRING WifiInfo.getWifiStandard() (API 30+) API 30