Test/Flashing your device/Flashing your device

From MozillaWiki
Jump to navigation Jump to search

Notes About Terminology

  • Firefox OS is frequently referred to by its code name (and original name) B2G.
  • The files we use to flash the device are referred to as images, ROMs or builds.
  • The proper abbreviation for Firefox OS is FxOS.
  • The process of flashing refers to writing the ROMs to the device to update the operating system to a different version.
  • Flatfish is the code name we use to refer to the 10" tablets being tested.

Flashing Your Device

Before beginning, it is best if your device is not almost dead (if the battery's red, it's almost dead).

  • [Download the build you would like to flash.]
  • Turn on your device and plug it in to your computer via the USB cord.
  • Extract the zip file you downloaded into a folder and run the flash file.
    • On Windows the file will be called flash or flash.bat (if you have file extensions unhidden). The icon may have gears in it.
    • On Linux the file will be called flash.sh
    • On Mac the file will be called flash_mac.sh
  • You should then be asked if you want to flash user data. Saying yes will clear any user data such as apps you have installed and emails. Some data, such as that stored on an SD Card will survive.
  • If you are moving between a major version of FxOS (e.g. 1.4 -> 2.0 or 2.0 -> 1.4) we recommend that you choose to flash the user data (thereby deleting it).
  • If the tablet is plugged in to your PC but you see error: device not found then you probably need to install the OEM USB drivers for your computer.
  • After you hit enter the tablet will reboot. If you see < waiting for device > for longer than 30 seconds, try unplugging the cord from your computer and plugging it back in.
  • The flash will take a couple of minutes and the screen may display random colors. Do not unplug, disturb or mock the device during this time.

Technical note: Our current packaged zip does not include boot.img (aka gonk) or recovery.img.

Once finished, press any key to reboot.

It is best not to flash the OS on a very low battery. do not disturb or unplug during the flashing process

Retrieved from "https://wiki.mozilla.org/index.php?title=Test/Flashing_your_device/Flashing_your_device&oldid=983873"