Connecting a Firefox OS device to the desktop

This guide explains how to connect a Firefox OS device to your desktop over USB.

Note: If you just want to debug apps on a Firefox OS device, and you are running Firefox OS 1.2+, your best option is to use WebIDE. If your version of Firefox OS is less than 1.2, read Setting up to debug on Firefox OS using Firefox developer tools to learn about using standard remote debugging.

Setting up the device

On your Firefox OS device (see the layout):

  1. open the Settings app, then Device Information > More Information > Developer.
  2. In the developer menu, check "Remote debugging".

Setting up the desktop

To connect a device to the desktop, you need the Android Debug Bridge (adb) to be installed. Note that the ADB Helper add-on (for use with WebIDE) bundles adb for you.

Instructions for setting up your desktop are specific to your operating system and are detailed in point 3 of "Setting up a Device for Development" on the Android developer site. We've listed some additional instructions below.

Special Instructions for Mac OS X

If you're running Mac OS X, you have downloaded a package which has a name along adt-bundle-mac-x86_64-20130522. Put that folder into the Applications folder, so that you get /Applications/adt-bundle-mac-x86_64-20130522/ which contains two directories: eclipse and sdk. Then you can edit your ~/.bashrc and add

export PATH="/Applications/adt-bundle-mac-x86_64-20130522/sdk/platform-tools:$PATH"

(It will be ready for the next time you start your shell). You can now type on the CLI of the shell:

adb devices

and it will return a list of connected devices such as:

List of devices attached
AA:BB:A5:B5:AA:BB    device

Special instructions for Linux

If you're running Linux, the vendor ID to use for Firefox OS Geeksphone devices is 05c6, so your /etc/udev/rules.d/51-android.rules file should contain an entry similar to:

SUBSYSTEM=="usb", ATTR{idVendor}=="05c6", MODE="0666", GROUP="plugdev"

Special instructions for Windows

You can download Windows drivers for the Geeksphone from the Geeksphone website.

Windows 8 by default will not let you install unsigned drivers. See this tutorial on "How to install an unsigned driver on Windows 8".

Since Windows XP Home Edition doesn't include tasklist.exe, Simulator won't detect the device. This can be solved downloading that file from ComputerHope website and putting it in Windows\System32 folder.

Checking your setup

Once you've followed these instructions, attach the device to the desktop using a USB cable, open a command prompt and type "adb devices" (ensuring that adb is in your path). You should see your Firefox OS device listed in the output.