Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases

Console

as

Get Started
Design and Develop
Publish
Reference
Support
Skip to main content
This page provides solutions to common VDA connection and power issues with Fire TV devices. If you don’t find your issue here, post in the Developer Forum for support. All VDA commands in this document use vega exec vda to ensure you’re using the VDA version that matches your active SDK. If you have only one SDK version installed, you can use vda directly.

​
Check VDA version

Before troubleshooting connection issues, verify you’re using the correct VDA version that matches your active SDK.
Example output:
If you encounter persistent issues after verifying your VDA version, proceed with the specific issues listed here.

​
App install fails with timeout or “Parameter value bad” error

Cause: A pending download on the device blocks new app installations. Symptoms:
  • App installation times out when sideloading through Vega Studio or the command line
  • The install log shows: Installing/Updating '/tmp/myapp.vpkg' ...error (Parameter value bad )
Solution:
  1. Shell into the device:
  2. Cancel all pending downloads:
  3. Reinstall your app using your normal workflow (Vega Studio or command line).

​
Device not appearing in VDA device list after enabling Developer Mode

Cause: The following conditions cause this issue:
  • ADB server conflict when ADB is installed on the host machine
  • Device is configured for VDA network mode instead of USB connection
Symptoms: After you enable Developer Mode, you might see:
  • Running vega exec vda devices shows no device in the list
  • USB detection commands show no device:
    • On Mac: ioreg -p IOUSB -w0 -l | grep Lab126 returns nothing
    • On Linux: lsusb -v | grep Lab126 returns nothing
Solution: Step 1: Kill ADB server (if ADB is installed on host)
Verify the device connection:
If the device still doesn’t appear, proceed to Step 2. Step 2: Check if device is on VDA network mode
  1. Get your Fire TV device’s IP address from Settings > My Fire TV > About > Network.
  2. Ping device from host:
If you can’t ping the device, the device isn’t on the same network as the host. Connect both devices to the same Wi-Fi network and try again. If you can ping the device, add the device to VDA in network mode:
If the connection fails, you see output similar to the following:
  • Ensure Developer Mode is enabled on the device. See Configure Developer Mode.
  • Use a personal phone hotspot to connect host and device, as some corporate networks have communication restrictions.
If the connection succeeds, you see output similar to the following:
Verify the device connection:
Example output:
After verifying the connection, connect to the device shell:
If the shell connection fails or you still can’t connect, see Configure VDA Over TCP/IP for detailed setup instructions. You can also post your issue in the Developer Forum.

​
Random USB disconnection from Fire TV Stick

Cause: The Fire TV Stick randomly disconnects during debug sessions due to faulty or incompatible USB cables. Symptoms:
  • Both vega exec vda devices and vega devices list commands return empty results
  • The device becomes unresponsive and unavailable for debugging
  • Disconnecting or reconnecting temporarily resolves the issue, but the problem recurs
Solution: Replace the USB cable with a different one. For recommended USB specifications, see Troubleshoot Fire TV Stick issues. After replacing the cable, verify the connection:
If the device still disconnects randomly after cable replacement, try connecting to a different USB port or contact support through the Developer Forum.

​
Connection or power issues

Cause: Insufficient power, faulty cables, or system power management settings interfere with device connectivity. Symptoms:
  • Device randomly disconnects during use
  • Device not detected by VDA
  • Intermittent connection drops
  • Device appears and disappears from device list
Solution:
  1. Use the original USB cable that came with your Fire TV device.
  2. Disable the automatic sleep mode and “Selective Suspend” feature in your operating system.
  3. Power cycle your Fire TV device:
    • Unplug the power supply
    • Wait 10 seconds
    • Reconnect the power supply
  4. Reconnect the USB cable to a different port on your computer.
  5. Restart your host computer and reconnect VDA.
  6. Verify the connection:
    Example output:
If the device still doesn’t appear after completing all steps, see Undetected Fire TV Device for hardware-level troubleshooting.

​
Undetected Fire TV device

Cause: USB hubs, virtual machines, or intermediate devices interfere with direct communication between the host and the Fire TV device. Symptoms:
  • Fire TV device not appearing in vega exec vda devices list
  • Device works when connected to another computer
  • Connection works intermittently
Solution:
  1. Connect your Fire TV device directly to the host computer.
  2. Remove any USB hubs or intermediate devices.
  3. Disable virtual machine (VM) or port forwarding from other hardware like the Raspberry Pi.
  4. Verify the connection:
If the device still doesn’t appear, see Device Detection Issue for hardware-level troubleshooting.

​
Chrome USB discovery conflicts

Cause: Chrome Developer Tools’ USB discovery feature conflicts with VDA device detection. Symptoms:
  • Device not appearing in VDA device list
  • Device detection works after closing Chrome
  • Intermittent device detection issues when Chrome is running
Solution: Disable the USB discovery feature:
  1. Open Chrome Developer Tools.
  2. Choose Settings > Remote Devices.
  3. Clear the Discover USB devices checkbox.
  4. Reconnect your Fire TV device.
  5. Verify the connection:

​
TCP/IP connection issues

Cause: Network connectivity issues, incorrect IP address, firewall blocking the connection port, or VDA daemon not running in TCP/IP mode. Symptoms:
  • Device not appearing when using vega exec vda connect [IP_ADDRESS]:5555
  • Error messages: unable to connect or connection refused
  • Connection timeout errors
  • Device works over USB but not over network
Solution: Step 1: Verify network connectivity
  1. Verify both devices are on the same Wi-Fi network:
    • macOS: Choose the Wi-Fi icon in the menu bar to view the connected network
    • Linux: Choose the network icon in the system tray or run iwconfig
    • Fire TV: Choose Settings > Network/Wi-Fi to check the connected network
    If devices are on different networks, connect them to the same Wi-Fi network before proceeding.
  2. Get your Fire TV device’s IP address from Settings > My Fire TV > About > Network.
  3. Connect to your device using the IP address:
    Replace [IP_ADDRESS] with your device’s IP address from step 2.
Step 2: Configure VDA for TCP/IP mode If the connection fails, configure VDA for TCP/IP mode:
  1. Ensure VDA daemon operates in TCP/IP mode:
  2. Kill the VDA server:
  3. Restart the VDA server:
Step 3: Check firewall settings
  • Ensure port 5555 isn’t blocked
  • Temporarily disable the firewall for testing
  • Re-enable the firewall after confirming the connection works
Step 4: Try alternative solutions
  1. Restart your Fire TV device and try connecting again.
  2. If issues persist, try an alternative port:
  3. For detailed TCP/IP setup instructions, see Configure VDA Over TCP/IP.

​
Fire TV device unresponsive in TCP/IP mode

Cause: Device stops working after switching to TCP/IP mode and becomes unresponsive. Symptoms:
  • Device not responding to VDA commands
  • Can’t switch back to USB mode through normal settings
  • Device appears offline in VDA device list
Solution:
  1. Go to Settings > My Fire TV > About > Developer Options
  2. Choose Connection Mode to switch to USB. The device reboots.
  3. Verify USB connection:
    Example output:
    If you don’t see the device:
    1. Perform a factory reset to revert to USB mode:
      • Go to Settings > My Fire TV > Reset to Factory Defaults
      • Choose Reset and confirm
      • Wait for the device to restart
    1. Complete the initial setup.
    2. Review the requirements and steps in Configure VDA Over TCP/IP for Fire TV Devices before attempting TCP/IP mode again.

​
Ubuntu 64-bit compatibility issues

Cause: VDA is a 32-bit app requiring 32-bit architecture support on 64-bit Ubuntu systems. Symptoms:
  • VDA commands fail to execute
  • Error messages about missing libraries
  • Permission errors when running VDA commands
Solution:
  1. Install 32-bit shared libraries:
  2. If permission errors occur, add yourself to the plugdev group:

​
VDA server isn’t responding

Cause: VDA server process becomes unresponsive or fails to start properly. Symptoms:
  • VDA commands hang or timeout
  • No response from vega exec vda devices command
  • Error messages about server not running
Solution:
  1. Stop the VDA server:
  2. Restart the VDA server:
  3. Verify the server is running:
    Example output:

​
VDA permission issues

Cause: Insufficient system permissions prevent VDA from accessing USB devices on Linux systems. This commonly occurs with the Fire TV 4K Select because the device’s USB Vendor ID may not be included in default udev rules. Symptoms:
  • Error messages:
  • Device detected but not accessible
  • Commands fail with permission errors
  • vega exec vda devices returns empty even though the device is connected via USB
Solution (Linux only): Step 1: Identify the device Vendor ID
  1. Connect your Fire TV device via USB.
  2. Run lsusb to list connected USB devices:
  3. Look for an entry containing “Amazon” or “Lab126”. The Vendor ID is the four characters after ID and before the colon (for example, 1949 in ID 1949:xxxx).
Step 2: Create a udev rule for the device
  1. Disconnect VDA from your Fire TV device:
  2. Create a udev rules file with the Fire TV device’s Vendor ID. Replace 1949 with the Vendor ID from Step 1 if it was different:
  3. Add permissions to the rules file:
  4. Add yourself to the plugdev group (if not already a member):
  5. Reload the udev rules and restart the service:
  6. Restart VDA:
  7. Reconnect your Fire TV device and verify it is detected:
    Example output:

​
Device detection issue

Cause: The host system may not recognize the Fire TV device at the hardware level, preventing proper connection. Symptoms:
  • Device not appearing in vega exec vda devices list
  • No hardware detection at system level
  • USB port appears inactive
Solution: On Linux:
  1. Run lsusb in the terminal.
  2. Look for “Lab126 Alexa” entry with your Fire TV device serial number.
On macOS:
  1. Install lsusb:
  2. Run lsusb in the terminal.
  3. Look for “Lab126 Alexa” entry with your Fire TV device serial number.
  4. Alternatively, check System Report > USB devices for “Lab126 Alexa” device.
If you see the “Lab126 Alexa” entry: The device is detected at the hardware level. The issue is with VDA software. Try VDA Server Isn’t Responding or VDA Permission Issues. If you don’t see the “Lab126 Alexa” entry: The device isn’t detected at the hardware level. Try:

​
Device detection fails on current host

Cause: The issue may be specific to your host system rather than the Fire TV device itself. Symptoms:
  • Device not detected on current computer
  • Same device works on other computers
  • All troubleshooting steps have been attempted without success
Solution:
  1. Connect your Fire TV device to another Mac or Linux machine.
  2. Open the terminal on the alternate host.
  3. Run vega exec vda devices.
  4. Check if your Fire TV device appears in the output.
If the device appears on the other computer: The issue is specific to your original host system. Possible causes:
  • USB controller driver issues
  • System configuration problems
  • Hardware incompatibility
Try reinstalling VDA or updating your system drivers. If issues persist, contact support through the Developer Forum. If the device doesn’t appear on the other computer: The issue is with the Fire TV device itself. Try:
Last modified on March 24, 2026