Adaptations/libhybris/Install SailfishOS for fp2

Revision as of 15:07, 9 August 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.
• Random phone app freezes on call end.
• Speakerphone volume control doesn't work.
• Camera button not supported in Sailfish camera app.
• Vibrator effect is very weak.
• Double tap to wake does not work.
• MMS sending works only if sending is started before mobile data is enabled or if WLAN is on.
• [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.

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 (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 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.
• Camera Exif fixes.