Wireless ADB connection refused despite Blueprint settings: enable Internet ADB Switcher on the device

Android

If you're trying to connect to an Android device wirelessly via ADB but receive a "connection refused" error, the issue may be that an additional on-device toggle needs to be enabled. This article explains how to resolve this on Rockchip-based devices.

Before you begin

Ensure that:

• You have created and applied a Blueprint with ADB-over-Wi-Fi settings to your device
• The Blueprint has been confirmed as applied in the Esper Console
• Your workstation and device are on the same network (or port 5555 is routable between them)
• No firewall is blocking TCP port 5555

How to enable wireless ADB on your device

1. In the Esper Console, verify that your Blueprint is applied. Navigate to Devices & Groups → [Device Name] → Blueprint and confirm the ADB Wi-Fi settings are active.
2. On your physical device (or via Remote Viewer), open Settings → Connected devices.
3. Locate the Internet ADB toggle and enable it.
4. From your workstation, run:

   adb connect <device_ip>:5555

5. Verify the connection by running:

   adb devices

   Your device should appear in the list with device status (not unauthorized or offline).

If the connection still fails

Try the following troubleshooting steps:

• Double-check the device IP address: Ensure it is correct and that your workstation can reach the device on the network.
• Verify all Blueprint settings are applied: Navigate to Devices & Groups → [Device Name] → Device Details → Settings and confirm that adb_enabled, adb_wifi_enabled, adb_wifi_port, and allowWirelessAdb are all present and set correctly.
• Reboot the device: After enabling the Internet ADB toggle, reboot your device and retry the connection.
• Look for alternate toggle locations: On Android 11 and above, the wireless ADB setting may be located at Developer options → Wireless debugging instead of under Connected devices. Check both locations.
• Confirm your device model and Android version: If you cannot find the Internet ADB toggle, the OEM firmware on your device may expose it under a different path or may not support it.

Still need help?

If you've followed these steps and your device still won't connect via wireless ADB, contact Esper Support. include your device model, Android version, Esper Agent version, and the exact error message you received.