# Revision history [back]

### GeminiPDA with sailfish os community port on planet computers

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.

have fun ... and what a graet strat into the summer.

### GeminiPDA with sailfish os community port on planet computers

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.

have fun ... and what a graet strat greate start into the summer.

### GeminiPDA with sailfish os community port on planet computers

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.

have fun ... and what a greate great start into the summer.

### GeminiPDA with sailfish os community port on planet computers

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.

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.

### GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eatsmy battery. 2.
2. Display standard is landscapeInverted. It turns to early to landscape and all is upside down. 3. down.
3. The geminipda should switch microphone and speaker if you turn it over on a call. With sailfishos it does not.

### GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eatsmy eats my 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.
 7 retagged

### GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
 8 No.8 Revision

### GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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

### GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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(), _updatePageOrientation(), replace "pageOrientation pageOrientation = desiredPageOrientation" desiredPageOrientation with "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.

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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionatity for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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.&gt; <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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionatity functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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.&gt; <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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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.

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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.

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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.

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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.

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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.

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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).

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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

3. delete the files at /usr/share/ssu/features.d/

4. set releasemode an add repos
ssu re 3.0.1.11
version --dup

5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"

and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before

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)

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


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).

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

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

3. delete the files at /usr/share/ssu/features.d/

4. set releasemode an add repos
ssu re 3.0.1.11
version --dup

5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"

and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before

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)

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).

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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.

option. This community port is still usable. It is updateable if you have done the modifications listed below at 'Edit 2018-11-19'.

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 :-)):

1. Start sfos 1st time
2. Enable settings -> Untrusted software -> Allow untrusted software
3. Download fingerterm latest (armv7hl) from openrepos.net, click on downloaded message, click on fingerterm in transfers and after that on '+' to install it.
4. start fingerterm an do 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 a great start into the summer.I did exactly, sorry)
5. reboot after update finished
6. create or enter Jolla account and store is usable and developer mode is possible.

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

3. delete the files at /usr/share/ssu/features.d/

4. set releasemode an add repos
ssu re 3.0.1.11
version --dup

5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"

and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before

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)

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).

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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'.

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 :-)):

1. Start sfos 1st time
2. Enable settings -> Untrusted software -> Allow untrusted software
3. Download fingerterm latest (armv7hl) from openrepos.net, click on downloaded message, click on fingerterm in transfers and after that on '+' to install it.
4. start fingerterm an do 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)
5. reboot after update finished
6. create or enter Jolla account and store is usable and developer mode is possible.

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

3. delete the files at /usr/share/ssu/features.d/

4. set releasemode an add repos
ssu re 3.0.1.11
version --dup

5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"

and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before

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)

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).

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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'.

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 :-)):

1. Start sfos 1st time
2. Enable settings -> Untrusted software -> Allow untrusted software
3. Download fingerterm latest (armv7hl) from openrepos.net, click on downloaded message, click on fingerterm in transfers and after that on '+' to install it.
4. start fingerterm an do 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)
5. reboot after update finished
6. create or enter Jolla account and store is usable and developer mode is possible.

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

3. delete the files at /usr/share/ssu/features.d/

4. set releasemode an add repos
ssu re 3.0.1.11
version --dup

5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"

and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before

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)

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).

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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'.

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 :-)):

1. Start sfos 1st time
2. Enable settings -> Untrusted software -> Allow untrusted software
3. Download fingerterm latest (armv7hl) from openrepos.net, click on downloaded message, click on fingerterm in transfers and after that on '+' to install it.
4. start fingerterm an do 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)
5. reboot after update finished
6. create or enter Jolla account and store is usable and developer mode is possible.

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

3. delete the files at /usr/share/ssu/features.d/

4. set releasemode an add repos
ssu re 3.0.1.11
version --dup

5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"

and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before

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)

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).

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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'.

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 :-)):

1. Start sfos 1st time
2. Enable settings -> Untrusted software -> Allow untrusted software
3. Download fingerterm latest (armv7hl) from openrepos.net, click on downloaded message, click on fingerterm in transfers and after that on '+' to install it.
4. start fingerterm an do ssu re 3.0.1.14; version --dup3.0.1.14 (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)
5. potentially reboot after update finished
6. create or enter Jolla account and store is usable and developer mode is possible.

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

3. delete the files at /usr/share/ssu/features.d/

4. set releasemode an add repos
ssu re 3.0.1.11
version --dup

5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"

and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before

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)

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).

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)

### [Wiki] GeminiPDA with sailfish os community port on planet computers

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'.

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 :-)):

1. Start sfos 1st time
2. Enable settings -> Untrusted software -> Allow untrusted software
3. Download fingerterm latest (armv7hl) from openrepos.net, click on downloaded message, click on fingerterm in transfers and after that on '+' to install it.
4. start fingerterm an do ssu re 3.0.1.14 (and a version --dup to update all to 3.0.1.14)
5. potentially reboot after update finished
6. create or enter Jolla account and store is usable and developer mode is possible.

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

3. delete the files at /usr/share/ssu/features.d/

4. set releasemode an add repos
ssu re 3.0.1.11
version --dup

5. check repositories,
ssu lr
you should find under
"Enabled repositories (global):"

and if this repos are there, then delete the user repos adaptation-0 and adaptation-1 we created before

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)

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).

[adaptation-community]
description = Enable ssu for community ports

[repositories]


[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-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:

1. Permanent deauth and reauth of wifi starts if display turns off and eats my 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.
4. More telephony quirks. You have to open it to answer a call or make one, and the silver button does nothing. It should be at least possible to answer an incoming with a closed clam shell.
5. External speaker still on when headphones plugged in

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:

• In Settings, enter the "Untrusted Software" section and enable the installation. Read the warnings carefully.

Applications with added keyboard functionality for gemini pda

Webcat bb10 key shortcuts for the browser.

• P - Previous,
• N - Next,
• K - Bookmarks,
• Q - Tabs,
• W - New Tab,
• Shift+W - New Window,
• T - Scroll to top,
• B - Scroll to bottom,
• A - Add to bookmarks,

Piepmatz key shortcuts for the Twitter client:

• 1-6 - Tabs (Timeline, Notifications, ...)
• [cursor up/dn] - Scroll tweet up/dn
• t - Top
• b - bottom
• [cursor left] | ESC - back
• N - New tweet
• R - Refresh
• S - Settings
• [Enter] inside a tweet - Show thread

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:

• Search for and install "Patchmanager 2" from coderus via the storeman application. Alternatively, you may try the beta of "Patchmanager 3", which uses a new method of changing files in memory instead of on the disk.

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.

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):

• new: usb stick automount via otg out of the box

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):

• new: wifi bug fixed, on x25 network freeze after a while (read all before update)

as root:

vi /usr/share/ssu/features.d/adaptation-community-common.ini

change content to:

[adaptation-community-common]
pattern = Feature adaptation community common
description = Common packages needed by community's HW adaptation

[repositories-release]


Next vi /usr/share/ssu/features.d/adaptation-community.ini

change content to:

[adaptation-community]
description = Enable ssu for community ports

[repositories]


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)