Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Best practices for open reference devices

The following article aims to provide a set of best practices that we believe should come highly recommended for any widely available open reference devices. All of the recent Firefox OS reference devices have followed these practices, including the forthcoming Flame.

Devices should have:

  • Easily accessible and installable builds
  • Completely unlocked operating system
  • Worldwide availability
  • Feature support equivalent to consumer phones
  • Availability of replacement batteries
  • Easily enabled language choices

Easily accessible and installable builds

Reference devices are largely aimed at developers and other groups with a greater degree of technical knowledge than average device consumers. But even so, we shouldn't expect users of these devices to compile their own builds if they don't wish to — for many of them this is a complete waste of time.

Open reference devices should have a maintained set of unlocked builds for current and future releases that are easy to access and install. This means having multiple tiers of builds available, at least:

  • Release/Current
  • Stable/Beta
  • Nightly

They should be made easily available on a dedicated download page, and updated regularly and often. Devices should also have OTA updates made available to them.

The OEMs should be responsible for providing these builds since they are the only ones who can legally distribute all the required binaries, etc.

It may make sense to follow a similar model to the Firefox browser, where each of the release, stable and nightly channels are based on subsequent versions of the source code.

Completely unlocked operating system

The device operating system platform should be completely unlocked, so that app and platform developers can have the necessary freedom of control available over their devices to perform any desired tests and development work. This includes:

  • SIM unlocked
  • Bootloader unlocked
  • Root access

Worldwide availability

If you want your reference devices to be a universal standard, then it follows that you should make them available worldwide. If this is not the case, people in different locales will have to make do with different devices, which may carry different behaviours.

Feature support equivalent to consumer phones

There is no point in creating a reference device that does not have support for the same technologies and associated features as the consumer devices you will ultimately be distributing Firefox OS builds and open web apps on.

These include:

  • AGPS/other associated geolocation hardware
  • Phone compass/gyroscope/accelerometer
  • Phone camera(s) with image and video capabilities
  • Vibration hardware
  • SDCard storage
  • Phone ringer
  • Appropriate hardware buttons
  • 3G or better connectivity

Availability of replacement batteries

Replacement batteries can often be really hard to obtain for different devices, and can lead to otherwise useful devices being rendered useless. It is therefore a good idea to make replacement batteries as available as possible.

Easily enabled language choices

Since these device will be distributed worldwide, it is important to make localised builds available for as many languages as possible,  taking into account availability of resources and most popular target market locales.

The most likely solution to this is localised Gaia builds or language packs that can be flashed onto the device separately, and Mozilla is working on a solution to make creation and installation of these as easy as possible.

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, rbrandao
 Last updated by: chrisdavidmills,