ypwalter / b2g-flash-tool

for fast flashing images to devices

Script tools for B2G project

autoflash.sh

This script will download latest release build from pvt server. You'll need an LDAP account and accessibility to the folder to access it.

Usage: [Environment] ./autoflash.sh [--flash][--flash-only][--eng][-v=][--backup][--backup-only][--recover-only][--device][-y][-h]

Environment:

HTTP_USER={username} HTTP_PWD={password} ADB_PATH=<adb_path>

Environment is not a necessary condition. The script has an interaction mode if you leave it blank.

Parameters:

-f|--flash      Flash your device (unagi) after downlaod finish.
                You may have to input root password when you add this argument.
                Your PATH should has adb path, or you can setup the ADB_PATH.
-F|--flash-only Flash your device from local zipped build(ex: -F{file name}); default: use latest downloaded
-s|--shallow    Shallow flash, download package only compiled binary and push into device, without modifying image
-e|--eng        change the target build to engineer build.
-v|--version,   give the target build version, ex: -vtef == -v100; show available version if nothing specified.
--tef           change the target build to tef build v1.0.0.
--shira         change the target build to shira build v1.0.1.
--v1train       change the target build to v1train build.
--vmaster       change the target build to master build. (Currently, it's only for unagi)
-b|--backup     backup and recover the origin profile.
                (it will work with -f anf -F)
-B|--backup-only:       backup the phone to local machine
-R|--recover-only:      recover the phone from local machine
-d|--device:    choose device, default for unagi
-y              Assume "yes" to all questions
-h|--help       Display help.

Example:

Download an unagi Engineer build and auto flash into the device without prompt

./autoflash.sh -e -f -y

Download an leo user build and auto flash

./autoflash.sh -f -d=leo

Note:

If you are MAC OS X User, and got the error while trying to get the build from server.

Connecting to path.to.server|xxx.xxx.xxx.xxx|:443... connected.
ERROR: The certificate of 'path.to.server' is not trusted.
ERROR: The certificate of 'path.to.server' hasn't got a known issuer.
Download https://path.to.server/xxx/xxx/xxx.zip failed.

Please do the following steps to fix the wget problem, and try again.

sudo port install curl-ca-bundle
echo CA_CERTIFICATE=/opt/local/share/curl/curl-ca-bundle.crt >> ~/.wgetrc

---

auto_flash_from_TWCI.sh

This script was written for download builds from TW-CI server.

Parameters:

  -v|--version  the target build version.
  -d|--device   the target device.
  -s <serial number>    directs command to device with the given serial number.
  -f|--flash    flash image into device.
  -g|--gaia     shallow flash gaia into device.
  -G|--Gecko    shallow flash gecko into device.
  -w            interaction GUI mode.
  -y            Assume "yes" to all questions
  -h|--help     display help.

Example:

Flash unagi v1train image

./auto_flash_from_TWCI.sh -vv1train -dunagi -f

Flash wasabi master gaia/gecko

./auto_flash_from_TWCI.sh -vmaster -dwasabi -g -G

Flash by interaction GUI mode

./auto_flash_from_TWCI.sh -w

---

change_OTA_URL.sh

This script is used to change OTA update URL to a local or a specific URL.

Parameters:

-u | --url <URL>              - set the following URL for OTA
-p                            - show current preference
-h | --help                   - print usage.

Example:

Change the OTA update URL to http://update.server/update.xml.

./change_OTA_URL.sh --url http://update.server/update.xml

---

check_versions.sh

Checking the version of B2G on devices. Please make sure your devices can be detected by ADB tool.

Parameters:

-s <serial number>            - directs command to the USB device or emulator with
                                 the given serial number. Overrides ANDROID_SERIAL
                                 environment variable.
-h | --help                   - print usage.

Example:

Check version with serial number parameter

./check_versions.sh -s serialnumber

Check version with environment variable

ANDROID_SERIAL=serialnumber ./check_versions.sh

---

enable_captiveportal.sh

This script was written for enable Captive Portal detection for v1.0.1 and above.

Please create the config file .enable_captiveportal.conf first.

The Bug 869394 turn on Captive Portal detection by default after 2013/05/09.

---

download_desktop_client.sh

This script was written for download last desktop from server.

Visit MDN: Using the B2G desktop client for more detail information.

Parameters:

There are two version 18 and 26, three os platform l32, l64 and mac.

This script was written for download last desktop from server.

Usage: ./download_desktop_client.sh [parameters]
-o|--os         The target OS. Default: --os l64
                show available OS if nothing specified.
-v|--version    The target build version. Default: -v18
                show available version if nothing specified.
-r|--run-once   Run once to get BuildID.
-h|--help       Display help.
Example:
  B2G 26 Linux 32bit build.     ./download_desktop_client.sh --os=l32 -v26
  B2G 18 Linux 64bit build.     ./download_desktop_client.sh --os=l64 -v18
  B2G 18 Mac build.     ./download_desktop_client.sh -omac

---

get_crashreports.sh

This is to get the crash reports of submitted/pending.

---

grant_geo_permission.sh

This script was written for grant the geolocation permission of unagi.

---

shallow_flash.sh

This script was written for shallow flash the gaia and/or gecko.

Parameters:

-g|--gaia       Flash the gaia (zip format) into your device.
-G|--gecko      Flash the gecko (tar.gz format) into your device.
-s <serial number>      directs command to device with the given serial number.
-y              flash the file without asking askeing (it's a joke...)
-h|--help       Display help.

Example:

Flash gaia.

./autoflash.sh --gaia=gaia.zip

Flash gecko.

./autoflash.sh --gecko=b2g-18.0.en-US.android-arm.tar.gz

Flash gaia and gecko.

./autoflash.sh -ggaia.zip -Gb2g-18.0.en-US.android-arm.tar.gz

---