Building Sailfish OS for Nexus 5

Revision as of 21:16, 22 July 2014

Download the HADK documentation from http://releases.sailfishos.org/sfa-ea/2014-07-18_SailfishOSHardwareAdaptationDevelopmentKit.pdf

This document mentions configurations required to build Sailfish OS for Nexus 5 (hammerhead). HADK should be followed as it is and this document should be referred only to learn about build configurations specific to Nexus 5.

HADK mentions references to CM 10.1 while Nexus 5 is based on CM 11. All the steps carried out in HADK should be in context of CM 11 only.

Chapter 3

Install CM 11 instead of CM 10.1 on your device and test the functionality as mentioned in HADK.

Chapter 4

cat <<EOF > $HOME/.hadk.env
export MER_ROOT="[insert value of your choosing]"
export ANDROID_ROOT="$MER_ROOT/android/droid"
export VENDOR="lge"
export DEVICE="hammerhead"
EOF
cat <<'EOF' >> $HOME/.mersdkubu.profile
function hadk() { source $HOME/.hadk.env${1:+.$1}; echo "Env setup for $DEVICE"; }
export PS1="HABUILD_SDK [\${DEVICE}] $PS1"
hadk
EOF
cat <<'EOF' >> $HOME/.mersdk.profile
function hadk() { source $HOME/.hadk.env${1:+.$1}; echo "Env setup for $DEVICE"; }
hadk
EOF

Chapter 5

hadk
sudo mkdir -p $ANDROID_ROOT
sudo chown -R $USER $ANDROID_ROOT
cd $ANDROID_ROOT
repo init -u git://github.com/mer-hybris/android.git -b hybris-11.0
repo sync

Known Issues

• dhcp assigns wrong ip address to host and it has to be fixed manually to be able to telnet to 2323 :

ifconfig -a and look for the interface name through which Nexus 5 is connected to host
sudo ifconfig <interface_name> 192.168.2.10 broadcast 192.168.2.255

• Lipstick crashes at startup if debugfs is mounted
  • TMP!workaround into your .ks %post section:

rm -f /lib/systemd/system/sysinit.target.wants/sys-kernel-debug.mount

• Lipstick crashes if qt5-qtsensors-plugin-sensorfw package is installed.
  • Workaround: zypper rm qt5-qtsensors-plugin-sensorfw
• the two issues above can be worked-around by the following changes in the .ks file :

sed -i "/post$/a rm -f \/lib\/systemd\/system\/sysinit.target.wants\/sys-kernel-debug.mount"  $ANDROID_ROOT/tmp/Jolla-@RELEASE@-$DEVICE-@ARCH@.ks
sed -i "/post$/a rm -f \/usr\/lib\/qt5\/plugins\/sensors\/libqtsensors_sensorfw.so"  $ANDROID_ROOT/tmp/Jolla-@RELEASE@-$DEVICE-@ARCH@.ks  

• Qt5 QPA hwcomposer plugin does not handle virtual displays correctly and causes UI to tear frequently.
  • Either wait for http://review.cyanogenmod.org/#/c/67489/ to be merged (or DIY locally) and use https://github.com/siteshwar/qt5-qpa-hwcomposer-plugin/commits/hammerhead
  • or use master https://github.com/mer-hybris/qt5-qpa-hwcomposer-plugin/commits/master - currently with tearing and UI freeze - to fix this, it needs some fence handling, contact situ or morphis on #sailfishos-porters
• droid-hal-init is sometimes started before /system is mounted and causes problems with property service.
• Correct time is not shown on booting.
• you will discover that any zypper operation is slow like hell. Cause two repos that shall not be there adaptation0 and xt9. Workaround: remove them:

zypper rr adaptation0 xt9

• wireless hotspot is not working... wip?
• mp3 do not seem to play

Hardware Support

For current status of hardware support refer to https://wiki.merproject.org/wiki/Adaptations/libhybris

Help

If you need any help join us on #sailfishos-porters on irc.freenode.net