Pushing Firefox OS Apps to the Geeksphone

A push to device feature was added in the 3.0 release of the Firefox OS Simulator. This feature allows web apps to be pushed to a connected device by clicking one button in the Simulator Dashboard. Availability of the Developer Preview Phone from Geeksphone has raised interest in the feature, so this post will detail how to configure your Geeksphone and the computer running the Simulator to make use of it.
Firefox OS Simulator on a Mac

Setting Up the Geeksphone Device

To push apps to the Geeksphone Firefox OS Developer Preview phone, you first need to enable Remote debugging. This can be done from the Settings app by selecting Device information > More Information > Developer -> Remote debugging. Now we are ready to configure the computer running the Simulator.

Windows

The team at Geeksphone recently released a set of drivers for Windows to support USB communication with their phones. The drivers are available at Geeksphone’s Web Site (direct ZIP link).

To install them, first download and extract the zip file to a known location on your system. Next, connect the phone to your machine using the provided USB cable. Click on the Start Button and enter “Device Manager” in the Search programs and files text entry field and press enter. This will launch the Windows Device Manager. Alternatively, you can launch the Device Manager from the icon located in the Windows Control Panel.

Device Manager before driver installed

The connected phone will be listed under the Other Devices category. Right click on the Android label and select Update Driver Software….

Right Click options

In the Update Driver Software dialog, choose Browse my computer for driver software.

Update driver dialog

Locate the usb_driver folder from the Geeksphone download and make sure the Include subfolders checkbox is checked. Click on the Next button.

Locate Driver

You will most likely receive a Windows Security alert. Select the Install this driver software anyway entry.

Windows security alert prompt

This will install the proper USB drivers and list the phone as Geeksphone Device in the Device Manager.

Device manager with drivers updated

Launch the Firefox OS Simulator. The Dashboard should now contain a Push button and a Device connected message, and you should be able to add your Firefox OS app to the Simulator and push it to the phone.

Linux

If you are running the Simulator on a Linux machine, you will need to create or modify a udev rules file for the device. This process is described in “Setting up a Device for Development” (Steps 3.a and 3.b). The Geeksphone Firefox OS Developer Preview phone idVendor attribute is “05c6”, so your android.rules file should contain an entry similar to:

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

After making the above changes, either reboot the system or restart the udev service:

sudo service udev restart

If you make these changes and the push to device button does not show up in the Simulator Dashboard, please see this workaround.

Mac

If you are running the Simulator on a Mac, no additional configuration is required to enable push to device.

Reference

Additional information about setting up and using the Firefox OS Simulator, including installing, adding apps, debugging and using the push to device capability can be found on the MDN page for the Firefox OS Simulator.

About Jason Weathersby

Jason Weathersby is a Technical Evangelist for Mozilla, evangelizing Firefox OS. He is also a committer on the BIRT project at the Eclipse Foundation, and has co-authored several books on BIRT integration. He is a proponent of HTML5, Open Source and all things related to web-based gaming.

More articles by Jason Weathersby…


8 comments

  1. Antoine Turmel

    Additional steps for Windows 8 :
    http://www.craftedge.com/tutorials/driver_install_windows8/driver_install_win8.html

    May 14th, 2013 at 16:36

    1. Robert Nyman [Editor]

      Great, thanks for the input!

      May 14th, 2013 at 23:11

  2. Aras

    Hi,
    I followed the instructions and I can see the “Device Connected” message in the simulator. I can add apps in the simulator as well. However, when I press the “push” button, I dont get any feedback and the app does not get installed on the phone. Can you give any suggestions about how to track down what the issue is, or how to fix it?

    I am using FF Aurora 22 on Ubuntu 12.10 64bit

    May 20th, 2013 at 23:36

  3. Jason Weathersby

    When you run adb devices, does the keon show up? Also currently on the Geeksphone you may need to reboot the phone for the app icon to show up.

    May 21st, 2013 at 14:28

    1. Aras

      Jason, you are onto something here. When I run “$adb devices” I get the followin:

      List of devices attached
      ???????????? no permissions

      I am not sure why this is yet

      May 21st, 2013 at 22:08

    2. Aras

      I found the solution here: http://stackoverflow.com/a/14478777/527559 thank you for your response which send me to the right direction. I can now push apps to the device, but as you said I have to restart the phone to see the icon

      May 22nd, 2013 at 02:16

  4. Jason Weathersby

    Glad to hear you got it to work.

    May 22nd, 2013 at 13:51

  5. Julie Sullivan

    Great advice Jason!

    May 22nd, 2013 at 14:04

Comments are closed for this article.