Most Android developers have used ADB. Fewer understand how wireless ADB actually works under the hood. This post explains the complete flow — and why it sometimes fails.
What is ADB?
ADB (Android Debug Bridge) is a command-line tool that lets your computer communicate with an Android device. It has three components:
- adb client — runs on your computer, sends commands
- adb daemon (adbd) — runs on the Android device, receives commands
- adb server — runs on your computer, manages client-daemon connections
The 4-Step Wireless Connection Flow
Here's exactly what happens when you connect wirelessly:
1 Enable TCP/IP mode on the device
This is the adb tcpip 5555 command. It tells the ADB daemon on your phone to start listening on TCP port 5555 instead of (or in addition to) USB. Without this step, your phone has no open port to connect to wirelessly.
2 Find the device's IP address
Your phone is on a WiFi network. You need its IP address on that network. You can find it manually in Settings → WiFi → Details, or programmatically via:
adb shell ip addr show wlan0
This command asks the phone to show network interface details. The output contains the IP in CIDR format (e.g., 192.168.1.5/24) which needs to be parsed.
3 Connect over TCP
Once you have the IP, you tell your adb client to connect to that IP on port 5555:
adb connect 192.168.1.5:5555
The adb server on your computer opens a TCP socket to the phone's IP. The phone's adbd daemon accepts the connection. They perform a handshake.
4 Verify the connection
adb devices should now show your device as 192.168.1.5:5555 with status 'device'. If it shows 'unauthorized', you need to accept the debug prompt on your phone again.
Why It Fails — Common Reasons
Wireless ADB can fail for several reasons. Here are the most common:
- Wrong IP address — phone's IP changed (DHCP reassignment)
- Wrong network interface — on mobile hotspot, IP is on
ap0notwlan0 - Port blocked — firewall or network policy blocking port 5555
- TCP/IP mode not set — forgot to run
adb tcpip 5555first - Different network — phone and computer on different WiFi networks
- ADB daemon crashed — needs
adb kill-server && adb start-server
The Mobile Hotspot Problem
This is the issue AirADB specifically solves for Indian developers. When your phone IS the hotspot (sharing internet to your laptop), the network topology changes:
- Your phone's hotspot IP is typically
192.168.43.1(Android default) - The IP lives on the
ap0interface, notwlan0 - Standard guides tell you to check
wlan0— it returns nothing - Developers get confused, give up, stay on USB
AirADB checks all three interfaces in sequence — wlan0, ap0, rndis0 — until it finds a valid non-localhost IP. This is why it works reliably across all network configurations.
How AirADB Automates All of This
AirADB runs the complete 4-step flow automatically with error handling at each stage:
| Stage 1 | Check ADB installation |
| Stage 2 | Detect USB device |
| Stage 3 | Enable TCP/IP mode (port 5555) |
| Stage 4 | Detect IP (wlan0 → ap0 → rndis0) |
| Stage 5 | Connect wirelessly |
| Stage 6 | Verify connection |
| Stage 7 | Success! |
Each stage has timeout handling, retry logic, and plain-English error messages. If anything fails, you know exactly why and what to do next.