The Mer Wiki now uses your Mer user account and password (create account on https://bugs.merproject.org/)


Adaptations/libhybris/Install SailfishOS for fp2

From Mer Wiki
< Adaptations | libhybris(Difference between revisions)
Jump to: navigation, search
(Status)
(Sailfish OS 2.1.3.7 alpha5 elease)
Line 7: Line 7:
  
 
=== Status ===
 
=== Status ===
<span style="color:red"><b>Do not use the current image on recent FP2 hardware (after summer 2017), because of hardware changes the upcoming Sailfish OS for FP2 release is needed.</b></span>
 
 
 
Items marked with FIX have a known fix and will be included in next release.
 
Items marked with FIX have a known fix and will be included in next release.
 
* Jolla Store works.
 
* Jolla Store works.
 
* Compass direction sensor not working.
 
* 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)
 
* 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.
+
* Random phone app freezes on call end. (Not observed in a long time but could be related to proximity sensor issues)
 
* Double tap to wake does not work. (Probably not supported by firmware)
 
* Double tap to wake does not work. (Probably not supported by firmware)
* [FIX] Camera button not supported in Sailfish camera app.
+
* Random failure of finding resolutions for secondary camera by camera module detection service during installation or update.
* [FIX] Vibrator effect is very weak.
+
* [FIX] Bluetooth LE support
  
 
=== Requirements for installation===
 
=== Requirements for installation===
* '''Opensource OS 16.10 Android from Fairphone.'''
+
* '''Opensource OS 18.02 Android from Fairphone.'''
* Latest Sailfish OS release: https://storage.googleapis.com/fairphone-updates/sailfishos-fp2-sibon-release-2.0.5.6-alpha3.zip.
+
* Latest Sailfish OS release: http://images.devaamo.fi/sfe/fp2-sibon/alpha5/sailfishos-fp2-sibon-release-2.1.3.7-alpha5.zip.
 
* Computer with fastboot installed for fastboot installation.
 
* Computer with fastboot installed for fastboot installation.
 
* Patience and luck.
 
* Patience and luck.
Line 29: Line 27:
  
 
* If instead you want to use Sailfish OS installation zip, all data in Sailfish OS will be removed, so backup everything you might need.  
 
* If instead you want to use Sailfish OS installation zip, all data in Sailfish OS will be removed, so backup everything you might need.  
* '''Requires Fairphone Opensource OS 16.10 https://storage.googleapis.com/fairphone-updates/d7c72422-62fa-4a19-80af-a2fdd4bee25e/fp2-sibon-16.10.0-manual-userdebug.zip (or Fairphone OS 1.8.1), not tested on other releases.'''
+
* '''Requires Fairphone Opensource OS 18.02 https://storage.googleapis.com/fairphone-updates/e9bc40d3-39e5-4a6f-b27f-3244f3ed9f21/fp2-sibon-18.02.0-manual-userdebug.zip (or Fairphone OS 18.02), not tested on other releases.'''
* Install the required Android version (if not installed already) using fastboot and the steps below. Only flash system.img and recovery.img. DO NOT flash other partitions.
+
* Install the required Android version (if not installed already) using fastboot and the steps below. '''Only flash system.img and recovery.img. DO NOT flash other partitions'''.
 
** Sailfish OS will have a battery drain, if in the past you have installed the whole Android zip of Fairphone OS >=1.6.2 or Opensource OS >= 16.08. To fix it:
 
** Sailfish OS will have a battery drain, if in the past you have installed the whole Android zip of Fairphone OS >=1.6.2 or Opensource OS >= 16.08. To fix it:
 
*** Download http://storage.googleapis.com/fairphone-updates/FP2-gms59-1.5.1-manual.zip
 
*** Download http://storage.googleapis.com/fairphone-updates/FP2-gms59-1.5.1-manual.zip
 
*** Extract the files from the zip
 
*** Extract the files from the zip
*** Edit the flash.bat or flash.sh scripts and remove the lines containing aboot, boot, system and recovery
+
*** Edit the flash.bat or flash.sh scripts and remove all lines containing aboot, boot, system and recovery
 
*** Run the flash.bat or flash.sh.
 
*** Run the flash.bat or flash.sh.
 
** Extract filesystem images from Android zip on your computer.
 
** Extract filesystem images from Android zip on your computer.
Line 48: Line 46:
 
** Reboot
 
** Reboot
  
=== WIP Over-the-Air updates (OTA) ===
+
=== 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.
 
* 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.
 
* You can be on any Sailfish OS version you have installed before.
* If you are updating from 2.0.0.10 (alpha1) or 2.0.1.11 (alpha2) you will need to manually flash system.img from Fairphone Opensource OS 16.10 fastboot image to system partition using fastboot '''after updating Sailfish OS'''.
+
* '''IMPORTANT!''' You will need to manually flash system.img from Fairphone Opensource OS 18.02 fastboot image to system partition using fastboot '''after updating Sailfish OS'''.
 
** Check previous chapter for instructions how to use fastboot.
 
** Check previous chapter for instructions how to use fastboot.
 
** <tt>fastboot flash system system.img</tt>
 
** <tt>fastboot flash system system.img</tt>
 
* Open shell with normal nemo user preferrably via ssh.
 
* Open shell with normal nemo user preferrably via ssh.
 
* Updating Sailfish OS via commandline:
 
* Updating Sailfish OS via commandline:
* Updating from 2.0.5.6 (alpha3)
+
* Updating from 2.0.5.6 (alpha3) or 2.1.0.11 (alpha4)
  RELEASE=2.1.0.11
+
  RELEASE=2.1.3.7
 
   
 
   
 
  ssu release $RELEASE
 
  ssu release $RELEASE
Line 77: Line 75:
 
  version --dup
 
  version --dup
 
  # if above fails, try again
 
  # if above fails, try again
  version --dup
+
  # version --dup
 
   
 
   
 
  sync
 
  sync
Line 83: Line 81:
  
 
* Updating from pre-2.0.5.6 releases (alpha1 or alpha2)
 
* Updating from pre-2.0.5.6 releases (alpha1 or alpha2)
  RELEASE=2.1.0.11
+
  RELEASE=2.1.3.7
 
   
 
   
 
  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
 
  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
Line 129: Line 127:
  
 
=== Changelog ===
 
=== Changelog ===
 +
'''Alpha5 - 5 March 2018'''
 +
* Sailfish OS 2.1.3.7
 +
* First release based on Android 6 base
 +
* '''Fairphone Opensource OS 18.02 or Fairphone OS 18.82 required.'''
 +
* Support for new Fairphone display and camera modules.
 +
* Camera button supported in Sailfish camera app.
 +
* Improved vibrator effects.
 +
 
'''Alpha4 - 27 June 2017'''
 
'''Alpha4 - 27 June 2017'''
 
* Sailfish OS 2.1.0.11
 
* Sailfish OS 2.1.0.11

Revision as of 17:57, 5 March 2018

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

Contents

Hardware Support

Legend:  Y  - Working (y=hack),  Y  - HAL works, not hooked up to UI/MW/init yet,  N  - Not working,  ?  - Untested,  N/A  - N/A on device.
Device released Linux
Kernel
Display Touch LED Audio NFC Bluetooth GSM WLAN GPS Camera Fingerprint Sensors Keys Vibra Haptics Power
Mgmt.
RTC
alarms
USB FM Radio
SMS Voice Data Connect Hotspot ALS PS Accel. Gyro. Magne. Vol+/- Home Net. Charge
2015/12 3.4.0 Y Y Y Y N/A Y Y Y Y Y Y Y Y N/A Y Y Y Y Y Y N/A Y Y Y Y Y Y Y

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. (Not observed in a long time but could be related to proximity sensor issues)
  • Double tap to wake does not work. (Probably not supported by firmware)
  • Random failure of finding resolutions for secondary camera by camera module detection service during installation or update.
  • [FIX] Bluetooth LE support

Requirements for installation

Installation steps


  • If instead you want to use Sailfish OS installation zip, all data in Sailfish OS will be removed, so backup everything you might need.
  • Requires Fairphone Opensource OS 18.02 https://storage.googleapis.com/fairphone-updates/e9bc40d3-39e5-4a6f-b27f-3244f3ed9f21/fp2-sibon-18.02.0-manual-userdebug.zip (or Fairphone OS 18.02), not tested on other releases.
  • Install the required Android version (if not installed already) using fastboot and the steps below. Only flash system.img and recovery.img. DO NOT flash other partitions.
    • Sailfish OS will have a battery drain, if in the past you have installed the whole Android zip of Fairphone OS >=1.6.2 or Opensource OS >= 16.08. To fix it:
    • Extract filesystem images from Android zip on your computer.
    • 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 system system.img
    • fastboot flash recovery recovery.img
    • fastboot reboot
  • Sailfish OS installation
    • Copy the downloaded Sailfish OS zip to sdcard or to somewhere outside sailfish rootfs in userdata partition
    • Boot to TWRP recovery, disable Zip file signature verification and install Sailfish OS zip over Android (without erasing system partition).
    • Reboot

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.
  • IMPORTANT! You will need to manually flash system.img from Fairphone Opensource OS 18.02 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:
  • Updating from 2.0.5.6 (alpha3) or 2.1.0.11 (alpha4)
RELEASE=2.1.3.7

ssu release $RELEASE

ssu lr
# Check the output that you have repos adaptation-community and adaptation-community-common
# if either of those is missing run these commands
# devel-su touch /usr/share/ssu/features.d/adaptation-community.ini
# devel-su touch /usr/share/ssu/features.d/adaptation-community-common.ini

# 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
  • Updating from pre-2.0.5.6 releases (alpha1 or alpha2)
RELEASE=2.1.3.7

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 and the repos are enabled
# (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

# After update check that you have repos adaptation-community and adaptation-community-common in output of
ssu lr
# if either of those is missing run these commands
# devel-su touch /usr/share/ssu/features.d/adaptation-community.ini
# devel-su touch /usr/share/ssu/features.d/adaptation-community-common.ini

ssu rr adaptation0
ssu rr extra

sync
poweroff

Report bugs

Changelog

Alpha5 - 5 March 2018

  • Sailfish OS 2.1.3.7
  • First release based on Android 6 base
  • Fairphone Opensource OS 18.02 or Fairphone OS 18.82 required.
  • Support for new Fairphone display and camera modules.
  • Camera button supported in Sailfish camera app.
  • Improved vibrator effects.

Alpha4 - 27 June 2017

  • Sailfish OS 2.1.0.11
  • OTA-only release, no new installation zip.
  • Fairphone Opensource OS 16.10 or Fairphone OS 1.8.1 recommended, not tested on other releases.
  • Fix LED regression in alpha3.

Alpha3 - 21 December 2016

  • Sailfish OS 2.0.5.6
  • Fairphone Opensource OS 16.10 or Fairphone OS 1.8.1 recommended, not tested on other releases.
  • Dual-SIM support added.
  • FM Radio Media app plugin added.
  • MMS sending and receiving fixed.
  • Disabled persistent debug telnet from USB interface on release images.
  • Offline charging UI fixed.
  • Initial display brightness after boot fixed.
  • Speakerphone volume control fixed.
  • OBEX configurations added.
  • MLSDB for using cell phone tower info for obtaining location.
  • Bluetooth state now remembered after reboot.
  • Fix mobile network settings randomly missing.
  • Flash torch option for video recording added.
  • Volume keys disabled when display is off.
  • Camera Exif fixes.
  • Flashlight shortcut added.

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.
Personal tools