We have moved to a new Sailfish OS Forum. Please start new discussions there.
![]() | 1 | initial version | posted 2018-06-24 18:27:20 +0300 |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a graet strat into the summer.
![]() | 2 | No.2 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun
... and what a graet strat greate start into the summer.
![]() | 3 | No.3 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun
... and what a greate great start into the summer.
![]() | 4 | No.4 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed the a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems of this early community version: 1. Permanent deauth and reauth of wifi starts if display turns off and eatsmy battery. 2. Display standard is landscapeInverted. It turns to early to landscape and all is upside down. 3. The geminipda should switch microphone and speaker if you turn it over on a call. With sailfishos it does not.
![]() | 5 | No.5 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed the a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems of with this early community version:
1. version:
![]() | 6 | No.6 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed the a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with this early community version:
![]() | 7 | retagged |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with this early community version:
![]() | 8 | No.8 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with this early community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation(), replace "pageOrientation = desiredPageOrientation" with "pageOrientation = Orientation.LandscapeInverted"
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside
Item { id: page …,
replace
property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates
The default image can be updated from OBS TODO: finish
Useful patches
"Launcher combined patches" – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
![]() | 9 | No.9 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with this early community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function
, replace _updatePageOrientation(), _updatePageOrientation()"pageOrientation pageOrientation
=
with desiredPageOrientation" desiredPageOrientation"pageOrientation pageOrientation
=
Orientation.LandscapeInverted"Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside
Item { id: page
…,…,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates
The default image can be updated from OBS TODO: finish
Useful patches
"Launcher combined patches" – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
![]() | 10 | No.10 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with this early community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS
TODO: finishOBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
new: wifi bug fixed, on x25 network freeze after a while (read all before update)
ssu re 2.2.1.18 pkcon refresh version --dup sync reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
"Launcher combined patches" – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
![]() | 11 | No.11 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with this early community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
new: wifi bug fixed, on x25 network freeze after a while (read all before update)
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
"Launcher combined patches" – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
![]() | 12 | No.12 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with this early community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionatity for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control ´echo "<ledno.> <red=""> <green> <blue>" > /proc/aw9120_operation´ values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
"Launcher 'Launcher combined patches" patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 13 | No.13 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with this early community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionatity functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
´echo "<ledno.> <red="">
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation´
/proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 14 | No.14 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with this early the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 15 | No.15 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 16 | No.16 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 20180630:
2018-06-30:
Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install.
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of them).
The system works as expected. But sometimes WLan did not work and i have to reboot the system. Also the landscape but is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 17 | No.17 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 2018-06-30:
2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install.
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of them).
The system works as expected. But sometimes WLan did not work and i have to reboot the system. Also the landscape but is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 18 | No.18 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment. End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install.
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of them).the patches).
The system works as expected.
But sometimes WLan did not work and i have to reboot the system.
Also the landscape but bug is not fixed (not on startup screen nor on settings).
I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 19 | No.19 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment. End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install.
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected.
But sometimes WLan did not work and i have to reboot the system.
reboot.
Also the landscape bug is not fixed (not on startup screen nor on settings).
I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always).always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 20 | No.20 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment. End Edit 2018-06-30:
Edit 2018-11-19:*Edit 2018-11-19: (state is testing) *
Community Port Version 3.0.0.8 is ready to install.
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 21 | No.21 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
comment.
End Edit 2018-06-30:
*Edit 2018-11-19: (state is testing) *Edit 2018-11-19:
Community Port Version 3.0.0.8 is ready to install.install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 22 | No.22 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA from Jolla. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 23 | No.23 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
You can select sailfish os in the Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and what a great start into the summer.
Edit 2019-01-09:
Ok, it is update time again -- but it is a little bit tricky. tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update.update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10.0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 24 | No.24 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option.
More Information on Planet Computers support page.
have fun ... and .
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linunx partition with debian beside it, you should not install the new version. New since 12 February 2019: A 'community like' Jolla beta (looks like pre official version to me, without eas, without xt9 and without alien dalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for android, if do not want to use it. Tip: if you want to use android or rooted android beside it, select android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modifies the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. Sailfish os is using the linux partition for itself, there is no more room for linux (debian or kali), because sailfish os uses lvm (logical volume management) and the debian or kali does not use lvm.
Using sfos after flashing it is tricky: The Jolla port is version 3.0.1.13 and this cbeta version (closed to cbeta tester group). It looks to me, that the repositories are not public. Symptoms: You cannot use the Jolla store, you cannot enable developer mode. Jolla fix it for the users, please. Nerds may like it.
But there is a light in every night (just make a jump to the left or 3.0.1.14 :-)):
ssu re 3.0.1.14; version --dup
(if you get permission errors try it with devel-su
in front of each line, the ';' is line separator - forgot what Conclusion:
it is beta (most known bugs still there), nice list for 3.0.1.11 still valid,
but wlan eats the battery.
Many apps with orientation problems patch needed (use patchmanager3 and geminiPDA patches)
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 25 | No.25 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linunx partition with debian beside it, you should not install the new version. New since 12 February 2019: A 'community like' Jolla beta (looks like pre official version to me, without eas, without xt9 and without alien dalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for android, if do not want to use it. Tip: if you want to use android or rooted android beside it, select android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modifies the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. Sailfish os is using the linux partition for itself, there is no more room for linux (debian or kali), because sailfish os uses lvm (logical volume management) and the debian or kali does not use lvm.
Using sfos after flashing it is tricky: The Jolla port is version 3.0.1.13 and this cbeta version (closed to cbeta tester group). It looks to me, that the repositories are not public. Symptoms: You cannot use the Jolla store, you cannot enable developer mode. Jolla fix it for the users, please. Nerds may like it.
But there is a light in every night (just make a jump to the left or 3.0.1.14 :-)):
ssu re 3.0.1.14; version --dup
(if you get permission errors try it with devel-su
in front of each line, the ';' is line separator - forgot what I did exactly, sorry)Conclusion:
it is beta (most known bugs still there), nice list for 3.0.1.11 still valid,
but wlan eats the battery.
Many apps with orientation problems patch needed (use patchmanager3 and geminiPDA patches)
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 26 | No.26 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linunx linux partition with debian beside it, you should not install the new version.
New since 12 February 2019: A 'community like' Jolla beta (looks like pre official version to me, without eas, without xt9 and without alien dalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for android, if do not want to use it.
Tip: if you want to use android or rooted android beside it, select android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modifies the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. Sailfish os is using the linux partition for itself, there is no more room for linux (debian or kali), because sailfish os uses lvm (logical volume management) and the debian or kali does not use lvm.
Using sfos after flashing it is tricky: The Jolla port is version 3.0.1.13 and this cbeta version (closed to cbeta tester group). It looks to me, that the repositories are not public. Symptoms: You cannot use the Jolla store, you cannot enable developer mode. Jolla fix it for the users, please. Nerds may like it.
But there is a light in every night (just make a jump to the left or 3.0.1.14 :-)):
ssu re 3.0.1.14; version --dup
(if you get permission errors try it with devel-su
in front of each line, the ';' is line separator - forgot what I did exactly, sorry)Conclusion:
it is beta (most known bugs still there), nice list for 3.0.1.11 still valid,
but wlan eats the battery.
Many apps with orientation problems patch needed (use patchmanager3 and geminiPDA patches)
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 27 | No.27 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12 12th February 2019: A 'community like' Jolla beta (looks like pre official version to me, without eas, without xt9 and without alien dalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for android, if do not want to use it.
Tip: if you want to use android or rooted android beside it, select android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modifies the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. Sailfish os is using the linux partition for itself, there is no more room for linux (debian or kali), because sailfish os uses lvm (logical volume management) and the debian or kali does not use lvm.
Using sfos after flashing it is tricky: The Jolla port is version 3.0.1.13 and this cbeta version (closed to cbeta tester group). It looks to me, that the repositories are not public. Symptoms: You cannot use the Jolla store, you cannot enable developer mode. Jolla fix it for the users, please. Nerds may like it.
But there is a light in every night (just make a jump to the left or 3.0.1.14 :-)):
ssu re 3.0.1.14; version --dup
(if you get permission errors try it with devel-su
in front of each line, the ';' is line separator - forgot what I did exactly, sorry)Conclusion:
it is beta (most known bugs still there), nice list for 3.0.1.11 still valid,
but wlan eats the battery.
Many apps with orientation problems patch needed (use patchmanager3 and geminiPDA patches)
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 28 | No.28 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
version.
New since 12th February 2019: A 'community like' Jolla beta (looks like pre official version to me, without eas, without xt9 and without alien dalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for android, if do not want to use it. Tip: if you want to use android or rooted android beside it, select android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modifies the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. Sailfish os is using the linux partition for itself, there is no more room for linux (debian or kali), because sailfish os uses lvm (logical volume management) and the debian or kali does not use lvm.
Using sfos after flashing it is tricky: The Jolla port is version 3.0.1.13 and this cbeta version (closed to cbeta tester group). It looks to me, that the repositories are not public. Symptoms: You cannot use the Jolla store, you cannot enable developer mode. Jolla fix it for the users, please. Nerds may like it.
But there is a light in every night (just make a jump to the left or 3.0.1.14 :-)):
ssu re 3.0.1.14; version --dup3.0.1.14
devel-su
in front of each line, the ';' is line separator - forgot what I did exactly, sorry)Conclusion:
it is beta (most known bugs still there), nice list for 3.0.1.11 still valid,
but wlan eats the battery.
Many apps with orientation problems patch needed (use patchmanager3 and geminiPDA patches)
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 29 | No.29 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' Jolla beta (looks like pre official version to me, without eas, without xt9 and without alien dalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for android, if do not want to use it. Tip: if you want to use android or rooted android beside it, select android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modifies the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. Sailfish os is using the linux partition for itself, there is no more room for linux (debian or kali), because sailfish os uses lvm (logical volume management) and the debian or kali does not use lvm.
Using sfos after flashing it is tricky: The Jolla port is version 3.0.1.13 and this cbeta version (closed to cbeta tester group). It looks to me, that the repositories are not public. Symptoms: You cannot use the Jolla store, you cannot enable developer mode. Jolla fix it for the users, please. Nerds may like it.
But there is a light in every night (just make a jump to the left or 3.0.1.14 :-)):
ssu re 3.0.1.14
(and a version --dup
to update all to 3.0.1.14)Conclusion:
it is beta (most known bugs still there), nice list for 3.0.1.11 still valid,
but wlan eats the battery.
Many apps with orientation problems patch needed (use patchmanager3 and geminiPDA patches)
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 30 | No.30 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' Jolla SFOS beta (looks like pre official version to me, a pre-official version, without eas, without xt9 and without alien dalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for android, if do not want to use it.
Tip: if you want to use android or rooted android beside it, select android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modifies the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. Sailfish os is using the linux partition for itself, there is no more room for linux (debian or kali), because sailfish os uses lvm (logical volume management) and the debian or kali does not use lvm.
Using sfos Making fully SFOS usable after flashing it is is a bit tricky: The Jolla port is SFOS version downloaded is called 3.0.1.13 and (which seems to be wrong, see below) and is an "early acess (EA)" version (for "cbeta" subscribed users). It looks, that this cbeta is rather really 3.0.1.14, and the version (closed to cbeta tester group). It looks to me, that the repositories are not public. Symptoms: mismatch is causing a couple of annoying symptoms: You cannot use the Jolla store, you cannot enable developer mode. Jolla fix it for the users, please. Nerds may like it.mode.
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
version --dup
Conclusion:
it is beta (most known bugs still there), nice list for 3.0.1.11 still valid,
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 31 | No.31 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019:
A 'community like' SFOS beta (looks like a pre-official version, without eas, EAS, without xt9 XT9 and without alien dalvik) AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for android, Android, if do not want to use it.
Android / LineageOS.
Tip: if If you want to use android or rooted android Android beside it, SFOS, select android Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modifies modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. Sailfish os SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because sailfish os SailfishOS uses lvm (logical volume management) manager) and the debian or kali does do not use lvm.
Making fully SFOS usable after flashing is a bit tricky: The SFOS version downloaded is called 3.0.1.13 (which seems to be wrong, see below) and is an "early acess (EA)" version (for "cbeta" "community beta (cbeta)" subscribed users). It looks, that this is rather really 3.0.1.14, and the version mismatch is causing a couple of annoying symptoms: You cannot use the Jolla store, Store, you cannot enable developer mode.mode etc.
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.version --dup
as root to make sure all installed RPMs are for 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 32 | No.32 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019:
A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use android or rooted Android beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making fully SFOS usable after flashing is a bit tricky: The SFOS version downloaded is called 3.0.1.13 (which seems to be wrong, see below) and is an "early acess (EA)" version (for "community beta (cbeta)" subscribed users). It looks, that this is rather really 3.0.1.14, and the version mismatch is causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode etc.
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini) followed by a version --dup
Conclusion:
End Edit 2019-02-142019-02-12
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 33 | No.33 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14: You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019:
A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use android or rooted Android beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully SFOS usable after flashing is a bit tricky: The SFOS version downloaded is called 3.0.1.13 (which seems to be wrong, see below) and is an "early acess (EA)" version (for "community beta (cbeta)" subscribed users). It looks, that this is rather really 3.0.1.14, and the version mismatch is causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode etc.
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini) followed by a version --dup
ensure all installed RPMs are for 3.0.1.14 (it will just pull in a few QT-related RPMs).Conclusion:
End Edit 2019-02-12
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 34 | No.34 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use android or rooted Android beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version downloaded is called 3.0.1.13 (which seems to be wrong, see below) and is an "early acess (EA)" version (for "community beta (cbeta)" subscribed users). It looks, that this is rather really 3.0.1.14, and the version mismatch is causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode etc.
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini) followed by a version --dup
ensure all installed RPMs are for 3.0.1.14 (it will just pull in a few QT-related RPMs).Conclusion:
End Edit 2019-02-122019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 35 | No.35 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use android or rooted Android beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version downloaded is called 3.0.1.13 (which seems to be wrong, (for which no online repositories are available, see below) and is an "early acess (EA)" version (for "community beta (cbeta)" aka cbeta" subscribed users). It looks, that this is rather really 3.0.1.14, and the version mismatch is users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode etc.mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.iniversion --dup
to ensure all installed RPMs are for 3.0.1.14 (it Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 36 | No.36 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use android or rooted Android beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version downloaded is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acess "early acess (EA)" version (for "community beta "community beta aka cbeta" cbeta" subscribed users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might pull in a few RPMs).Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 37 | No.37 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use android Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version downloaded flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acess (EA)" version (for "community beta aka cbeta" subscribed users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 38 | No.38 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acess (EA)" version (for "community beta aka cbeta" subscribed users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 39 | No.39 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acess (EA)" version (for "community beta aka cbeta" subscribed users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 40 | No.40 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acess (EA)" version (for "community beta aka cbeta" subscribed users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 41 | No.41 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acess (EA)" version (for "community beta aka cbeta" subscribed users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 42 | No.42 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acess (EA)" version (for "community beta aka cbeta" subscribed users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 43 | No.43 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfisX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acess (EA)" version (for "community beta aka cbeta" subscribed users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 44 | No.44 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfisX SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acess (EA)" version (for "community beta aka cbeta" subscribed users).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 45 | No.45 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early acessaccess (EA) (EA)" " version (for "community betaEA aka cbeta" subscribed users).users only, but anybody with a Jolla Store account can subscribe).
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 46 | No.46 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-03-19 SailfishX
The official 3.0.2.8 SailfishX for EA (early access) users is available. Look at release notes. You may subscribe at account.jolla.com to early access.
You can manually update the community port as well (at your own risk: ssu re 3.0.2.8; version --dup). But you will stay with the kernel of the community version.
SailfishX 3.0.1.14
Linux Sailfish 3.18.41 #1 SMP PREEMPT Mon Jan 14 06:59:39 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
SailfishX 3.0.2.8
Linux Sailfish 3.18.41 #1 SMP PREEMPT Tue Feb 12 23:08:05 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
You have to build and flash a boot image for the community port manualy if you want to use a new kernel.
ATM I do not know what the changes are; obviously the compile date. But it is still a 3.18.41 kernel like the community port.
End edit 2019-03-19
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is an "early access (EA)" a version (for EA subscribed for cbeta users only, but anybody with a Jolla Store account can subscribe).only.
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 47 | No.47 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-03-19 SailfishX
The official 3.0.2.8 SailfishX for EA (early access) users is available. Look at release notes. You may subscribe at account.jolla.com to early access.
You can manually update the community port as well (at your own risk: ssu re 3.0.2.8; version --dup). But you will stay with the kernel of the community version.
SailfishX 3.0.1.14
Linux Sailfish 3.18.41 #1 SMP PREEMPT Mon Jan 14 06:59:39 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
SailfishX 3.0.2.8
Linux Sailfish 3.18.41 #1 SMP PREEMPT Tue Feb 12 23:08:05 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
You have to build and flash a boot image for the community port manualy if you want to use a new kernel.
ATM I do not know what the changes are; obviously the compile date. But it is still a 3.18.41 kernel like the community port.
End edit 2019-03-19
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is a version for cbeta users only.
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with
pkcon install sd-utils
sd-utils (older SFOS, newer versions should have udisks2 installed per default instead)
then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 48 | No.48 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-03-19 SailfishX2019-08-23
Jolla's SailfishOS releases 3.0.3 and 3.1.0 brought only minor enhancements for the Gemini PDA.
This is in line with Jolla still defining these releases as betas for the Gemini (and hence charges only € 30,-) and they lack "Android support". Jolla might base Gemini's "Android support" on that for the XA2s, but this requires a newer kernel to be used. Supposedly SailfishOS for the Gemini will come out of its beta phase, when these two feats are accomplished.
End edit 2019-08-23
Edit 2019-03-19
The official 3.0.2.8 SailfishX for EA (early access) users is available. Look at release notes. You may subscribe at account.jolla.com to early access.
You can manually update the community port as well (at your own risk: ssu re 3.0.2.8; version --dup). But you will stay with the kernel of the community version.
SailfishX 3.0.1.14
Linux Sailfish 3.18.41 #1 SMP PREEMPT Mon Jan 14 06:59:39 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
SailfishX 3.0.2.8
Linux Sailfish 3.18.41 #1 SMP PREEMPT Tue Feb 12 23:08:05 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
You have to build and flash a boot image for the community port manualy if you want to use a new kernel.
ATM I do not know what the changes are; obviously the compile date. But it is still a 3.18.41 kernel like the community port.
End edit 2019-03-19
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is a version for cbeta users only.
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils (older SFOS, newer versions should have udisks2 installed per default instead) then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 49 | No.49 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-08-23
Jolla's SailfishOS releases 3.0.3 and 3.1.0 brought only minor enhancements for the Gemini PDA.
This is in line with Jolla still defining these releases as betas for the Gemini (and hence still charges only € 30,-) 30,- for a license) and they lack "Android support". Jolla might base Gemini's "Android support" on that for the XA2s, but this requires a newer kernel to be used. Supposedly SailfishOS for the Gemini will come out of its beta phase, when these two feats are accomplished.
accomplished.
End edit 2019-08-23
Edit 2019-03-19
The official 3.0.2.8 SailfishX for EA (early access) users is available. Look at release notes. You may subscribe at account.jolla.com to early access.
You can manually update the community port as well (at your own risk: ssu re 3.0.2.8; version --dup). But you will stay with the kernel of the community version.
SailfishX 3.0.1.14
Linux Sailfish 3.18.41 #1 SMP PREEMPT Mon Jan 14 06:59:39 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
SailfishX 3.0.2.8
Linux Sailfish 3.18.41 #1 SMP PREEMPT Tue Feb 12 23:08:05 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
You have to build and flash a boot image for the community port manualy if you want to use a new kernel.
ATM I do not know what the changes are; obviously the compile date. But it is still a 3.18.41 kernel like the community port.
End edit 2019-03-19
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is a version for cbeta users only.
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils (older SFOS, newer versions should have udisks2 installed per default instead) then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 50 | No.50 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-08-23
Jolla's SailfishOS releases 3.0.3 and 3.1.0 brought only minor enhancements for the Gemini PDA.
This is in line with Jolla still defining these releases as betas for the Gemini (and hence still charges only € 30,- for a license) and they lack "Android support". Jolla might base Gemini's "Android support" on that for the XA2s, but this requires seems to require a newer kernel to be used. used (than 3.18 as currently in SailfishOS; PlanetCom's recent Android images provide a kernel 4.4 for the Gemini).
Supposedly SailfishOS for the Gemini will come out of its beta phase, when these two feats are accomplished.
End edit 2019-08-23
Edit 2019-03-19
The official 3.0.2.8 SailfishX for EA (early access) users is available. Look at release notes. You may subscribe at account.jolla.com to early access.
You can manually update the community port as well (at your own risk: ssu re 3.0.2.8; version --dup). But you will stay with the kernel of the community version.
SailfishX 3.0.1.14
Linux Sailfish 3.18.41 #1 SMP PREEMPT Mon Jan 14 06:59:39 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
SailfishX 3.0.2.8
Linux Sailfish 3.18.41 #1 SMP PREEMPT Tue Feb 12 23:08:05 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
You have to build and flash a boot image for the community port manualy if you want to use a new kernel.
ATM I do not know what the changes are; obviously the compile date. But it is still a 3.18.41 kernel like the community port.
End edit 2019-03-19
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is a version for cbeta users only.
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils (older SFOS, newer versions should have udisks2 installed per default instead) then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 51 | No.51 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-11-24
This will probable be my last edit in this wiki. We have Sailfish 3 version 3.2.0.14 for a while. Updating to new versions is easy with it. But I cannot see any progress. We still have no alien dalvik for the device, Jolla promised for 'Final phase'. I do not believe we will get it in future. But may be Jolla knows more secrets about it. And other features are still missing or buggy, here a partial list (answer calls with gemini is closed, switch microphone, screen orientation, apps orientation, battery drain with wifi, alarm not working). The device is good enougth for playing around with sailfish only, but far from be a daily driver since 1.5 years.
End edit 2019-11-24
Edit 2019-08-23
Jolla's SailfishOS releases 3.0.3 and 3.1.0 brought only minor enhancements for the Gemini PDA.
This is in line with Jolla still defining these releases as betas for the Gemini (and hence still charges only € 30,- for a license) and they lack "Android support". Jolla might base Gemini's "Android support" on that for the XA2s, but this seems to require a newer kernel to be used (than 3.18 as currently in SailfishOS; PlanetCom's recent Android images provide a kernel 4.4 for the Gemini).
Supposedly SailfishOS for the Gemini will come out of its beta phase, when these two feats are accomplished.
End edit 2019-08-23
Edit 2019-03-19
The official 3.0.2.8 SailfishX for EA (early access) users is available. Look at release notes. You may subscribe at account.jolla.com to early access.
You can manually update the community port as well (at your own risk: ssu re 3.0.2.8; version --dup). But you will stay with the kernel of the community version.
SailfishX 3.0.1.14
Linux Sailfish 3.18.41 #1 SMP PREEMPT Mon Jan 14 06:59:39 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
SailfishX 3.0.2.8
Linux Sailfish 3.18.41 #1 SMP PREEMPT Tue Feb 12 23:08:05 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
You have to build and flash a boot image for the community port manualy if you want to use a new kernel.
ATM I do not know what the changes are; obviously the compile date. But it is still a 3.18.41 kernel like the community port.
End edit 2019-03-19
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is a version for cbeta users only.
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils (older SFOS, newer versions should have udisks2 installed per default instead) then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 52 | No.52 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2019-11-24
This will probable be my last edit in this wiki. We have Sailfish 3 version 3.2.0.14 for a while. Updating to new versions is easy with it. But I cannot see any progress. We still have no alien dalvik for the device, Jolla promised for 'Final phase'. I do not believe we will get it in future. But may be Jolla knows more secrets about it. And other features are still missing or buggy, here a partial list (answer calls with gemini is closed, switch microphone, screen orientation, apps orientation, battery drain with wifi, alarm not working). The device is good enougth enough for playing around with sailfish only, but far from be a daily driver since 1.5 years.
End edit 2019-11-24
Edit 2019-08-23
Jolla's SailfishOS releases 3.0.3 and 3.1.0 brought only minor enhancements for the Gemini PDA.
This is in line with Jolla still defining these releases as betas for the Gemini (and hence still charges only € 30,- for a license) and they lack "Android support". Jolla might base Gemini's "Android support" on that for the XA2s, but this seems to require a newer kernel to be used (than 3.18 as currently in SailfishOS; PlanetCom's recent Android images provide a kernel 4.4 for the Gemini).
Supposedly SailfishOS for the Gemini will come out of its beta phase, when these two feats are accomplished.
End edit 2019-08-23
Edit 2019-03-19
The official 3.0.2.8 SailfishX for EA (early access) users is available. Look at release notes. You may subscribe at account.jolla.com to early access.
You can manually update the community port as well (at your own risk: ssu re 3.0.2.8; version --dup). But you will stay with the kernel of the community version.
SailfishX 3.0.1.14
Linux Sailfish 3.18.41 #1 SMP PREEMPT Mon Jan 14 06:59:39 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
SailfishX 3.0.2.8
Linux Sailfish 3.18.41 #1 SMP PREEMPT Tue Feb 12 23:08:05 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
You have to build and flash a boot image for the community port manualy if you want to use a new kernel.
ATM I do not know what the changes are; obviously the compile date. But it is still a 3.18.41 kernel like the community port.
End edit 2019-03-19
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is a version for cbeta users only.
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils (older SFOS, newer versions should have udisks2 installed per default instead) then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 53 | No.53 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2020-06-19
Late, but some addidtional information for the 3.3.0.16 version.
It seems that there are some updates at this version, but no additional features or bug fixes (see Edit 2019-11-24).
There is also no /home encryption for the Gemini PDA available (see question https://together.jolla.com/question/227861/why-is-there-no-home-encryption-on-geminipda-sailfishx/).
End Edit 2020-06-19
Edit 2019-11-24
This will probable be my last edit in this wiki. We have Sailfish 3 version 3.2.0.14 for a while. Updating to new versions is easy with it. But I cannot see any progress. We still have no alien dalvik for the device, Jolla promised for 'Final phase'. I do not believe we will get it in future. But may be Jolla knows more secrets about it. And other features are still missing or buggy, here a partial list (answer calls with gemini is closed, switch microphone, screen orientation, apps orientation, battery drain with wifi, alarm not working). The device is good enough for playing around with sailfish only, but far from be a daily driver since 1.5 years.
End edit 2019-11-24
Edit 2019-08-23
Jolla's SailfishOS releases 3.0.3 and 3.1.0 brought only minor enhancements for the Gemini PDA.
This is in line with Jolla still defining these releases as betas for the Gemini (and hence still charges only € 30,- for a license) and they lack "Android support". Jolla might base Gemini's "Android support" on that for the XA2s, but this seems to require a newer kernel to be used (than 3.18 as currently in SailfishOS; PlanetCom's recent Android images provide a kernel 4.4 for the Gemini).
Supposedly SailfishOS for the Gemini will come out of its beta phase, when these two feats are accomplished.
End edit 2019-08-23
Edit 2019-03-19
The official 3.0.2.8 SailfishX for EA (early access) users is available. Look at release notes. You may subscribe at account.jolla.com to early access.
You can manually update the community port as well (at your own risk: ssu re 3.0.2.8; version --dup). But you will stay with the kernel of the community version.
SailfishX 3.0.1.14
Linux Sailfish 3.18.41 #1 SMP PREEMPT Mon Jan 14 06:59:39 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
SailfishX 3.0.2.8
Linux Sailfish 3.18.41 #1 SMP PREEMPT Tue Feb 12 23:08:05 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
You have to build and flash a boot image for the community port manualy if you want to use a new kernel.
ATM I do not know what the changes are; obviously the compile date. But it is still a 3.18.41 kernel like the community port.
End edit 2019-03-19
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is a version for cbeta users only.
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils (older SFOS, newer versions should have udisks2 installed per default instead) then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)
![]() | 54 | No.54 Revision |
Since 22th of June 2018 there is an 'official' flash image of a sailfish os 2.1.4.14 community port at Planet Computers support page.
Edit 2020-06-19
Late, but some addidtional information for the 3.3.0.16 version.
It seems that there are some updates at this version, but no additional features or bug fixes (see Edit 2019-11-24).
There is also no /home encryption for the Gemini PDA available (see question https://together.jolla.com/question/227861/why-is-there-no-home-encryption-on-geminipda-sailfishx/).Why is there no /home encryption on GeminiPDA SailfishX?).
End Edit 2020-06-19
Edit 2019-11-24
This will probable be my last edit in this wiki. We have Sailfish 3 version 3.2.0.14 for a while. Updating to new versions is easy with it. But I cannot see any progress. We still have no alien dalvik for the device, Jolla promised for 'Final phase'. I do not believe we will get it in future. But may be Jolla knows more secrets about it. And other features are still missing or buggy, here a partial list (answer calls with gemini is closed, switch microphone, screen orientation, apps orientation, battery drain with wifi, alarm not working). The device is good enough for playing around with sailfish only, but far from be a daily driver since 1.5 years.
End edit 2019-11-24
Edit 2019-08-23
Jolla's SailfishOS releases 3.0.3 and 3.1.0 brought only minor enhancements for the Gemini PDA.
This is in line with Jolla still defining these releases as betas for the Gemini (and hence still charges only € 30,- for a license) and they lack "Android support". Jolla might base Gemini's "Android support" on that for the XA2s, but this seems to require a newer kernel to be used (than 3.18 as currently in SailfishOS; PlanetCom's recent Android images provide a kernel 4.4 for the Gemini).
Supposedly SailfishOS for the Gemini will come out of its beta phase, when these two feats are accomplished.
End edit 2019-08-23
Edit 2019-03-19
The official 3.0.2.8 SailfishX for EA (early access) users is available. Look at release notes. You may subscribe at account.jolla.com to early access.
You can manually update the community port as well (at your own risk: ssu re 3.0.2.8; version --dup). But you will stay with the kernel of the community version.
SailfishX 3.0.1.14
Linux Sailfish 3.18.41 #1 SMP PREEMPT Mon Jan 14 06:59:39 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
SailfishX 3.0.2.8
Linux Sailfish 3.18.41 #1 SMP PREEMPT Tue Feb 12 23:08:05 UTC 2019 aarch64 aarch64 aarch64 GNU/Linux
You have to build and flash a boot image for the community port manualy if you want to use a new kernel.
ATM I do not know what the changes are; obviously the compile date. But it is still a 3.18.41 kernel like the community port.
End edit 2019-03-19
Edit 2019-02-28
You can buy an official SailfishX from Jollas shop. It comes with 'MS Exchange support', 'Software updates as long as device is supported' and 'Customer support as long as device is supported'. But there is
No other linux install option beside official SailfishX possible, because SailfishX uses the linux partition as lvm (logical volume manager) device. (As per description at 'Edit 2019-02-14')
Almost all known issues from the community version are still present. For me it is disappointing, waiting so long and getting not more than a community+ version.
But, maybe buying SailfishX will support the development in the future.
End Edit 2019-02-28
Edit 2019-02-14:
You can select sailfish os (community port 2.1.4.14) in the old Partitioning Tool as 2nd or 3rd boot option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.
More Information on Planet Computers support page.
There is a new version available. It needs new flashing. If you want to stay with the community port which is integrated into the linux partition with debian beside it, you should not install the new version.
New since 12th February 2019: A 'community like' SFOS beta (looks like a pre-official version, without EAS, without XT9 and without AlienDalvik) is available. Select it with Partitioning Tool. It is possible to use it as 1st boot option. You can select 0GB for Android, if do not want to use Android / LineageOS.
Tip: If you want to use Android or rooted Android / LineageOS beside SFOS, select Android for 1st boot option. Why? Because updating process and rooting tools like Magisk do not know about boot2 and boot3 and always modify the boot image in boot (1st boot). That will kill your sfos boot image if it is in the 1st boot.
Flashing is easy following instructions from Planet Computers support page Linux_Flasing_Guide. SailfishOS is using the linux partition for itself, there is no more room for linux (debian or kali), because SailfishOS uses lvm (logical volume manager) and the debian or kali do not use lvm.
Making SFOS fully usable after flashing is a bit tricky: The SFOS version flashed is called 3.0.1.13 (for which no online repositories are available, see below) and is a version for cbeta users only.
The missing online repos are causing a couple of annoying symptoms: You cannot use the Jolla Store, you cannot enable developer mode, etc. (i.e., all actions, which need additional RPMs from Jolla's repositories).
But there is a light in every night (just make a jump to the left or set SSU to 3.0.1.14 :-)):
ssu re 3.0.1.14
in there.devel-su
and execute ssu re 3.0.1.14
again (done as root it is able to set the correct release number permanently in ssu.ini), followed by a version --dup
to ensure all installed RPMs are for 3.0.1.14 (it might download and install a few RPMs).pkcon refresh
(as root): You now have a fully working installation of SFOS 3.0.1.14Conclusion:
End Edit 2019-02-14
Edit 2019-01-09: Ok, it is update time again -- but it is a little bit tricky and you need an account for the Jolla store to do it. Because the last community version is 3.0.0.8 and the next version is 3.0.1.11 EA (early access) from Jolla. It is beta and still under development. Read this step by step guide first and if you understand everything you may start. I did it this way and it works for me. Remember, if you are using patches, that there may be no version for 3.0.1.11, because it is not official. If you need your patches do not update. As before every update disable all patches before you start.
If you have debian installed too, an optional backup of sailfishos is very easy before update: Start your debian and use terminal as root to makethe backup as tar archive.
tar --numeric-owner -C /.stowaways -czvf /YOURBACKUPFOLDER/sailfishos.tar.gz ./sailfishos
Lets do the change from community version 3.0.0.8 to Jolla EA version 3.0.1.11 (Device adaptation 0.0.3.10). It is still like community, no aliendalvik, no eas, no xt9. You do it at your own risk just for fun. Start your sailfishos and make all as root in terminal.
1. disable your patches (settings-patchmanager) and disable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu dr $i ; done
2. disable community adaptation repos
ssu dr adaptation-community
ssu dr adaptation-community-common
3. delete the files at /usr/share/ssu/features.d/
rm -f /usr/share/ssu/features.d/adaptation-community-common.ini
rm -f /usr/share/ssu/features.d/adaptation-community.ini
4. set releasemode an add repos
ssu re 3.0.1.11
ssu ar adaptation-0 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
ssu ar adaptation-1 https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/armv7hl/
version --dup
5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"
- adaptation0 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda/armv7hl/
- adaptation1 ... https://store-repository.jolla.com/releases/3.0.1.11/jolla-hw/adaptation-mediatek-geminipda-dhd/arm
and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before
ssu rr adaptation-0
ssu rr adaptation-1
the old adaptation-community and adaptation-community-common are still under disabled repos, if they are without url then delete them else they should stay disabled (you can do it with the following commands)
ssu er adaptation-community
ssu rr adaptation-community
ssu dr adaptation-community
ssu er adaptation-community-common
ssu rr adaptation-community-common
ssu dr adaptation-community-common
5. reboot
6. enable openrepos repositories
for i in $(ssu lr 2>&1 | grep openrepo | cut -d" " -f3); do ssu er $i ; done
7. refresh package cache
devel-su pkcon refresh
Check at "Settings->About product" the Device adaptation 0.0.3.10 = done. If it is not 0.0.3.10 something went wrong and you may have lost sensor functionality and more.
on error If something or everything wents wrong, its time to restore your backup. Start your debian and use terminal as root to make the restore from tar archive.
tar --numeric-owner -C /.stowaways -xzvf /YOURBACKUPFOLDER/sailfishos.tar.gz
Reboot to your Sailfishos community version.
End Edit 2019-01-09:
Edit 2018-06-30: Since 26th of June it is possible to set android space to 0 in the Partitioning Tool and use debian as boot1 and sailfishos as boot2 and boot3. You will get a 'LinuxOnly' scatter file. I flashed my x25 geminipda with the 'Gemini_x25_LinuxOnly.txt' and have a device without android now.
I read, that x27 users have to use android to select the SIM first, before sailfishos is working. Maybe 'LinuxOnly' is not working on x27. If you have a x27 and flashed a working 'LinuxOnly', please add it to this wiki or write a comment.
End Edit 2018-06-30:
Edit 2018-11-19: Community Port Version 3.0.0.8 is ready to install (state is testing).
/usr/share/ssu/features.d/adaptation-community.ini
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/testing:/hw:/planet:/geminipda/sailfishos_%(release)/
/usr/share/ssu/features.d/adaptation-community-common.ini
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
start the update to 3.0.0.8:
ssu re 3.0.0.8
pkcon refresh
version --dup
sync
reboot
Maybe you have to disable openrepo repositories for update and revert some patches (i have installed non of the patches).
The system works as expected. But sometimes WLan did not work and i have to reboot. Also the landscape bug is not fixed (not on startup screen nor on settings). I think adapting it from the table version should be some kind easy (but i'm no a programming geek) ..
Terminal rotates most times fine on startup (may be the sensor calibration did not work always exactly).
Other hints show below on older versions.
End Edit 2018-11-19:
Problems with the community version:
Possible first steps after installing the community edition:
Warning: A lot of these things change your system. An Error might ruin your Installation. You have been warned.
Openrepos
As with every Sailfish OS system, you'll find most applications on openrepos.net. To make installing apps easy, the following steps will help:
Applications with added keyboard functionality for gemini pda
Webcat bb10 key shortcuts for the browser.
Piepmatz key shortcuts for the Twitter client:
Special commands for gemini pda*
Turn wifi off
echo "0" > /dev/wmtWifi
if you done so you have to turn it on before you can use it again
echo "1" > /dev/wmtWifi
LED control
echo "<ledNo.> <red> <green> <blue>" > /proc/aw9120_operation
values: - ledNo. [1..6] - red: [01] - green [01] - blue [01] LEDs 1 to 6 have RGB, example
echo "1 1 0 0" > /proc/aw9120_operation # LED1 turns red
echo "1 0 1 0" > /proc/aw9120_operation # LED1 turns green
echo "1 0 0 1" > /proc/aw9120_operation # LED1 turns blue
echo "1 0 0 0" > /proc/aw9120_operation # LED1 turns off
you may combine colors by yourself setting RGB at the same time to 1.
LED7 is different and has only RBx as parameters you can set it to red, blue, violet and off.
echo "7 1 0 0" > /proc/aw9120_operation # LED7 turns red
echo "7 0 1 0" > /proc/aw9120_operation # LED7 turns blue
echo "7 1 1 0" > /proc/aw9120_operation # LED7 turns violet
echo "7 0 0 0" > /proc/aw9120_operation # LED7 turns off
Funzel uses gemini pda LEDs for visualisation of incoming calls.
Patchmanager
If you know what you're doing, installing coderus' Patchmanager (from openrepos) enables you to change many facets of the system. If you kind of know what you're doing you can use premade patches to make your life easier:
Landscape Mode
After boot, everything will be sideways until you turn the device a bit.
If you have installed 'patchmanger 3' and do not want to change some system files install 'Default allowed orientations patch' from 'elros34' using the patchmanger webcatalog.
Set the allowed orientation from terminal this way
dconf write /desktop/sailfish/silica/default_allowed_orientations 8
Everything is done after a restart of lipstick or reboot. You have not to edit the system files.
If you have not installed patchmanger 3 or like to change system files do this: As root (devel-su):
vi /usr/lib/qt5/qml/Sailfish/Silica/Page.qml
→ inside function _updatePageOrientation()
, replace pageOrientation = desiredPageOrientation
with pageOrientation = Orientation.LandscapeInverted
FingerTerm will be rotated weirdly, but you can use ToeTerm as an alternative. If you can not live without FingerTerm, more changes are needed (also as root):
vi /usr/share/fingerterm/Main.qml
→ inside Item { id: page …,
replace property int orientation: forceOrientation ? forcedOrientation : Screen.orientation
with property int orientation: forceOrientation ? forcedOrientation : 8
Micro SD card
to use a micro sd card, open the terminal and install the required package with pkcon install sd-utils (older SFOS, newer versions should have udisks2 installed per default instead) then reboot.
Updates (you can do it at your own risk)
The default image can be updated from OBS. The 'Problems with this early community version' described above will remain. Some x27 users told on telegram, that the 'wifi bug' is solved (read at 2.2.1.18 update about my experience on a x25 device).
update to 2.2.0.29 (state is testing):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change this line:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
to:
adaptation-community-common = http://repo.merproject.org/obs/nemo:/testing:/hw:/common/sailfishos_%(release)/
If do not change from devel: (state: unstable) to testing: (state: testing) you get trouble with your sensorfw (sensors not working, only a software problem). Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.0.29:
ssu re 2.2.0.29
pkcon refresh
version --dup
sync
reboot
update done.
update to 2.2.1.18 (state is unstable):
as root:
vi /usr/share/ssu/features.d/adaptation-community-common.ini
change content to:
[adaptation-community-common]
repos = adaptation-community-common
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation
[repositories-release]
adaptation-community-common = http://repo.merproject.org/obs/nemo:/devel:/hw:/common/sailfish_latest_%(arch)/
Next
vi /usr/share/ssu/features.d/adaptation-community.ini
change content to:
[adaptation-community]
repos = adaptation-community
pattern = Feature community adaptation
description = Enable ssu for community ports
[repositories]
adaptation-community = http://repo.merproject.org/obs/nemo:/devel:/hw:/planet:/geminipda/sailfish_latest_%(arch)/
Before next step you can verify that the change is done with:
ssu lr
start the update to 2.2.1.18:
ssu re 2.2.1.18
pkcon refresh
version --dup
sync
reboot
Some x27 users told, that the 'permanent deauth reauth wifi bug' is fixed with the 2.2.1.18 update. On my x25 early bird the bug is gone too, but after a while the network dies. Symptom: I cannot switch wifi on/off, cannot switch flight mode on/off and have to restart network or reboot.
Responsible is 'sailfish-connman-plugin-suspend-wmtwifi-0.0.2-1.3.1.jolla.armv7hl.rpm' that suspends the wifi. I decided to deinstall it.
devel-su pkcon remove sailfish-connman-plugin-suspend-wmtwifi
The 'permanent deauth reauth wifi bug' ist back, but the network is working all the time. To save battery life switch wifi off manualy before the display turns off.
update done.
Useful patches
'Launcher combined patches' – lets you customise, for example, the number of rows/colums in the application grid, which is really nice on the 2:1 aspect ratio. You may have to install the forked version from openrepos if you are on SFOS 2.1
'Default allowed orientations patch' – fix the orientation (look above at Landscape Mode)