Adaptations/libhybris/Install SailfishOS for fp2

Revision as of 21:37, 12 December 2016

Notes for installing Sailfish OS on the Fairphone 2 (fp2).

Hardware Support

Status

Items marked with FIX have a known fix and will be included in next release.

• Jolla Store works.
• Compass direction sensor not working.
• Possibly some issues with proximity sensor during calls. (It is possible to calibrate the proximity sensor, which should fix the issues, but using the needed firmware causes poor battery life in Sailfish OS)
• Random phone app freezes on call end.
• Camera button not supported in Sailfish camera app.
• Vibrator effect is very weak.
• Double tap to wake does not work.
• [FIX] Correct initial display brightness after boot.
• [FIX] Speakerphone volume control doesn't work.
• [FIX] Add configurations for OBEX.
• [FIX] Add MLSDB for using cell phone tower info for obtaining location.
• [FIX] Fix remembering Bluetooth state after reboot.
• [FIX] MMS sending and receiving.
• [FIX] No dual-SIM support.
• [FIX] Mobile network settings randomly missing.
• [FIX] Flash torch during video recording.
• [FIX] Volume keys always active when display is off.
• [FIX] Integrated FM Radio Media app plugin.
• [FIX] Camera Exif fixes.
• [FIX] Flashlight shortcut.

Requirements for installation

• Opensource OS 16.06 Android from Fairphone.
• Latest Sailfish OS release:
  • for fastboot installation http://storage.googleapis.com/fairphone-updates/FP2-sailfishos-2.0.1.11-alpha2-fastboot.zip
  • for installation via TWRP recovery http://storage.googleapis.com/fairphone-updates/FP2-sailfishos-2.0.1.11-alpha2-ota.zip.
• Computer with fastboot installed for fastboot installation.
• Patience and luck.

Installation steps

• The fastboot installation method will overwrite your Android user data, please backup your files before continuing.
• Current Sailfish OS installation will be overwritten by both installation methods and all data in Sailfish OS will be removed so backup everything you might need.
• Install Android (if not installed already) using recovery or fastboot.
• Requires Fairphone Opensource OS 16.06 https://storage.googleapis.com/fairphone-updates/fp2-sibon-16.06.0-image-userdebug.zip (or Fairphone OS 1.4.2), not tested on other releases.
• Two optional installation methods:
• Recovery installation
  • Copy the downloaded Sailfish OS OTA zip to sdcard or to somewhere outside sailfish rootfs in userdata partition
  • Boot to TWRP recovery, disable Zip file signature verification and install Sailfish OTA zip over Android (without erasing system partition).
  • Reboot
• Fastboot installation
  • Extract filesystem images from Sailfish zip on your computer.
  • Install the Sailfish OS on top of Android via fastboot:
    • Enter fastboot mode on your phone by turning off device, when device is powered down press and hold volume down button and then plug USB cable.
    • Open a terminal on your computer and go to the folder where you extracted the file system images.
    • Check that the device is detected with fastboot devices
    • fastboot flash userdata userdata.img
    • fastboot flash boot boot.img
    • fastboot reboot

WIP Over-the-Air updates (OTA)

• Backup of Sailfish OS user files to a sdcard or to another device is strongly encouraged before updating Sailfish OS.
• You can be on any Sailfish OS version you have installed before.
• If you are updating from alpha1 you will need to manually flash system.img from Fairphone Opensource OS 16.06 fastboot image to system partition using fastboot after updating Sailfish OS.
  • Check previous chapter for instructions how to use fastboot.
  • fastboot flash system system.img
• Open shell with normal nemo user preferrably via ssh.
• Updating Sailfish OS via commandline:

RELEASE=2.0.1.11

devel-su sed -i -e 's#^adaptation=.*$#adaptation=http://repo.merproject.org/obs/nemo:/testing:/hw:/%(vendor):/%(adaptation)/sailfishos_%(release)/#' /usr/share/ssu/repos.ini

ssu rr dhd
ssu rr extra
ssu ar extra http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_$RELEASE/

ssu release $RELEASE

ssu lr
# Check the output that the adaptation0 and extra repos have the correct urls 
# (note that the url for adaptation0 mentioned above has variables which will be replaced with values in ssu lr output).
# also check that no other similar repos exist.

# You may have many of OpenRepos enabled. It's recommended to disable them, even
# though version --dup will do its best-effort to isolate repositories:
ssu lr | grep openrepos

devel-su zypper clean -a
devel-su zypper ref -f

version --dup
# if above fails, try again
version --dup

sync
poweroff

Report bugs

• Software-related bugs (Sailfish OS): first search in https://together.jolla.com. If not found, add your question and tag with "porting".
• App bugs (e.g. an app doesn't scale well on different screens): contact its developer.
• Problems which depend on hardware: at the Nemo Mobile Project: search existing http://bit.ly/port-bugs; add new http://bit.ly/port-new-bug.
• Please do not contact Fairphone, Jolla Care or Jolla Developer Care, as this is community's build for other phones.

Changelog

Alpha2 - 9 August 2016

• Sailfish OS 2.0.1.11
• Requires Fairphone Opensource OS 16.06 or Fairphone OS 1.4.2, not tested on other releases.
• Bluetooth MAC address fixed.
• Bluetooth MAC address now shown in Settings->About product.
• WLAN MAC address fixed.
• Sending MMS messages fixed partially.
• Camera and audio/video codecs work with FP Android >= 1.2.8.
• Larger 16:9 image resolution for camera.
• FM Radio support (no preinstalled app, harbour-piratefm works).
• Display brightness control improvements.