This is an archived page. It's not actively maintained.

Troubleshooting B2G OS


This article provides tips for resolving common problems you may have while using B2G OS. Please feel free to add more content to this page!

Networking problems

If you are having trouble connecting to Wi-Fi networks, it may be helpful to delete the Wi-Fi configuration file:

adb shell rm /data/misc/wifi/wpa_supplicant.conf
adb reboot

Note: These instructions assume you have configured the udev settings for your device.

Bricked Phone

If you happen to brick the phone, by, for example, trying to flash wrong images on it,  try rebooting into the bootloader (fastboot or heimdal depending on your phone). The exact sequence varies depending on the phone. Try removing the usb cable, removing and then re-inserting the battery. For the Unagi and Otoro, press and hold volume up and power for several seconds until you see the splash screen. Verify that the phone is in bootloader mode by using fastboot devices (or heimdall devices for some Samsung phones). Once you can see your phone using fastboot devices, seek your current folder to the directory that contains a base image or the SD package files provided by the device maker (depending on your phone). Now, you have two options for flashing:

  • use ./ to flash your image (recommanded).
  • run the following commands from a terminal window:
fastboot flash boot boot.img
fastboot flash userdata userdata.img
fastboot flash system system.img
fastboot flash recovery recovery.img
fastboot erase cache
fastboot reboot

Flashing Red LED (otoro/unagi)

This means that the battery is too low to boot the phone. You can let it charge for a while (until the red LED stops flashing and a little bit longer), or you can unplug the USB cable, remove the battery, insert the USB cable, and re-insert the battery.

Failure to receive SMS after switching over from iPhone

If you have switched your SIM card over from an iPhone to a B2G OS (or another different platform) device, you may run into a problem whereby you can no longer receive text messages from iPhone users. This is because iPhone to iPhone SMS messages are sent using iMessage, which works by routing iPhone-to-iPhone messages through Apple's servers instead of sending them as actual text messages, saving iPhone users money. Unfortunately when you leave iPhone, iMessage has no way of knowing you've left and SMS from other iPhone users will still go through iMessage, meaning that you won't receive them.

To fix this you have to turn off iMessage for your SIM; there is a guide on how to do this at — read Here's how to turn off iMessage.

Device not appearing to ADB on OSX

When running adb devices in OSX, some devices may simply not appear in the device list, for a variety of reasons. This can be fixed by adding your device's vendor ID to your ~/.android/adb_usb.ini file, to provide a hint to ADB for finding your device.

Note: See this stackoverflow post for a lot more detail, including how to find the vendor ID of the attached device, and how to add it into adb_usb.ini.