Test/Flashing your device: Difference between revisions

No edit summary
 
(32 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Flashing Your Device==
====Notes About Terminology====
 
* Firefox OS is frequently referred to by its code name (and original name) ''B2G''.   
====A couple notes about terminology====
* The files we use to flash the device are referred to as images, [http://en.wikipedia.org/wiki/Read-only_memory ROMs] or builds.
* Firefox OS is frequently referred to by it's code name (and original name) B2G.   
* The proper abbreviation for Firefox OS is ''FxOS''.
* The proper abbreviation for Firefox OS is FxOS.
* The process of [http://en.wikipedia.org/wiki/Flashing_%28technology%29 ''flashing''] refers to writing the ROMs to the device to update the operating system to a different version.
* The files we use to flash the device are referred to as images, [http://en.wikipedia.org/wiki/Read-only_memory ROMs] or sometimes builds.
* ''Flatfish'' is the code name we use to refer to the 10" tablets being tested.
* The process of [http://en.wikipedia.org/wiki/Flashing_%28technology%29 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 (Foxconn InFocus New Tab F1) being tested.
----
----
If you're looking to build B2G, you want to [https://wiki.mozilla.org/FirefoxOS/TCP/Patching go here].
If you're looking to build B2G, you want to [https://wiki.mozilla.org/FirefoxOS/TCP/Patching go here].
===Build Instructions===
* Install the Android Debug Bridge (adb) (https://developer.mozilla.org/en-US/Firefox_OS/Debugging/Connecting_a_Firefox_OS_device_to_the_desktop) onto your computer. Note the special considerations for Windows 8, Windows XP, Linux and Mac on that page.
* [Get the image files for Firefox OS](link to "Getting Builds" wiki page)
* Move or extract the images files into the same folder containing adb and fastboot.
* Plug the device into your computer with the USB cable.  (Windows may try to update drivers but will fail to find any.)
* Open a Windows Explorer window
* '''While holding shift''' right click on the white background of the file area and select "Open command window here" [include screenshot]
* Test that the device is detected by typing <code>adb devices</code> and hitting enter. The result may show the device name to be "???????????? device", this is ok as long as it can see the device.
* Type <code>adb reboot boot-fastboot</code>
* The tablet should now display the Firefox OS logo.
Enter the following commands (hitting enter each time of course)
fastboot erase cache


If you are moving between major versions (such as 1.4 to 2.0 or 2.0 to 1.4) then run these commands, if not then you may want to skip this as it deletes all user data such as downloaded apps or emails.
'''These instructions are aimed at Windows users.'''
 
==Flashing Your Device==
* Use [http://www.howtogeek.com/125769/how-to-install-and-use-abd-the-android-debug-bridge-utility/ these instructions] to install the Android Debug Bridge (ADB).
** Please note, under the '''Enable USB Debugging''' section, the setting can be found in Firefox OS in the ''Settings'' app under <code>Device Information</code> > <code>More Information</code> > <code>Developer</code>.  In the developer menu, check "Remote debugging".
** Follow all instructions including listing the device and installing additional USB drivers if necessary.
* If you are on Windows 8 or Windows XP Home Edition see these [https://developer.mozilla.org/en-US/Firefox_OS/Debugging/Connecting_a_Firefox_OS_device_to_the_desktop#Special_instructions_for_Windows special considerations] if you have issues installing drivers or detecting the device.
* [(link)Download the image files] for your Flatfish device.
* Move or extract the image files into the same folder containing adb.
* The device should be powered on and plugged into your computer with the USB cable.
* In the Command window you opened earlier type <code>adb reboot boot-fastboot</code> <br>The tablet should now display the Firefox OS logo.
Enter the following commands
fastboot erase cache
 
If you are moving between major versions (such as 1.4 > 2.0 or 2.0 > 1.4) then run the following commands, if not then you may want to skip them as they delete all user data such as downloaded apps or emails.
  fastboot erase data
  fastboot erase data
  fastboot flash data userdata.img
  fastboot flash data userdata.img


If boot.img was not included in your download, skip this:
If ''boot.img'' was not included in the image files you downloaded, skip this:
  fastboot flash boot boot.img
  fastboot flash boot boot.img


Line 34: Line 34:
  fastboot reboot
  fastboot reboot
The tablet should reboot into a fresh install of Firefox OS.
The tablet should reboot into a fresh install of Firefox OS.
To check your build version open the Settings app, then ''Device Information'' > ''More Information'' > ''Firmware Revision''.  The date of your current revision is embedded as YYYYMMDD.
Confirmed users
247

edits