Skip to content

Latest commit

 

History

History
248 lines (153 loc) · 11.4 KB

quick-first-setup-guide.md

File metadata and controls

248 lines (153 loc) · 11.4 KB

Quick First Setup Guide v1.1.1

This is the guide originally written for the SailFish OS community forum and reported here in Github .md format.

(C) 2023, Roberto A. Foglietta <[email protected]> released under CC BY-NC-SA 4.0 license terms.

If you are going to use this guide for commercial purposes, feel free to contact me to negotiate a license for your business-specific needs.

RATIONALE

This is a step-by-step mini guide to follow immediately after having flashed your smartphone with SailFish OS. It has been written and tested with a Sony Xperia 10 II smartphone. Having this guide allows everyone involved in supporting the hardware to have a standard starting point in order to reduce, as much as possible, the interference caused by a different setup procedure.

⚠️ WARNING

Some suggestions about flashing your smartphone with SailFish OS and how-to dealing with the USB v3.x problems have been reported at the beginning of the Quick Start Guide and that section belongs to this guide more than the other one. At the moment, the integration of the two guides has not started yet, and for the flashing tools, there is dedicated page that has not yet collected all the contributions also present in the guides about this topic.

DUAL SIM

For dual SIM smartphone owners: put the SIM you wish to use for mobile data in slot #1. If the other SIM has a PIN enabled, put it in slot #2 otherwise, do not, but do it later, when you will complete the network operator configuration of the first SIM. It is not strictly necessary, but it helps a lot in some troubling cases.

EARLY SETUP

For everybody:

  1. complete the flash procedure with these two commands:

    sudo fastboot flash oem_b SW_binaries_*.img
sudo fastboot reboot

  2. choose the language that you like to use for the UI;

  3. accept the end-user license;

  4. insert the PIN for the SIM in slot #1;

  5. skip with the X to insert the PIN for the SIM in slot #2, and confirm: continue;

  6. enter your security PIN/password for the internal storage encryption;

  7. re-enter the PIN/password for confirmation;

  8. click on the blue bottom half of the display to skip the connection, and confirm: skip;

  9. select the timezone manually (optional), but later it will be set automatically;

  10. accept (optional but suggested) to setup the fingerprint reader;

  11. insert the fingerprint of the thumb of the hand in which you keep the smartphone, and confirm: next;

  12. skip to learn the basics about SFOS with the (X) on the top right, you will do it later;

  13. confirm your choice with the x-close-tutorial button.

BASIC SETTINGS

Now the smartphone needs a little more effort to be completely configured on the basics.

  1. Swipe from the bottom of the home display, choose Settings and its System tab;

in Settings:System page:

  1. Display -> Text size: choose the one that is comfortable for you;
  2. Sounds and feedback raise all the volumes to 100%, the fine-tuning later;
  3. Gestures -> Show hints and tips: OFF, learning later;
  4. Battery -> Activation threshold: set Battery 20%;
  5. Battery -> Charging mode: set Apply threshold, Stop charging: 90%;
  6. Device Lock -> Show notifications when the device is locked: OFF.

The battery settings are not strictly required, but it is supposed that your battery will last longer, and with the power-saving mode starting at 20% of the battery, the smartphone will last as long as having fully charged the battery.

Showing notifications when the device is locked - ON by default - allows sensible information to leak to everyone who can see your unattended smartphone display. Like the content of SMS/text messages, which sometimes contain an OTP used by some banks or other service providers to confirm a transaction or authorize a sensitive change by a registered mobile number. A leak that can be leveraged to be actively used.

SIM SETTINGS

  1. swipe from the bottom on the bottom edge and choose the Messages app;
  2. in Message, swipe from above on the display and select a new message;
  3. send a configuration SMS/text request to your network operator: wait for it;
  4. swipe from the bottom on the bottom edge and choose Settings;
  5. in Settings -> Mobile network check the configuration for SIM #1;
  6. select SIM #1 and enable the mobile data connection, it should go into Connected state.

For those have a dual-SIM smartphone and two SIMs, it is time to configure SIM #2:

  • insert the second SIM into slot #2, if you did not do it before and configure it;

or

  • for those who have the second SIM in  slot #2 but have not unlocked it, unlock and configure it.

TOP MENU

This part of the configuration is optional, but it will be useful for many.

In Settings:System -> Top menu:

  1. disable Show ambiance in Top menu, it will save a lot of useful space in the top menu;
  2. enables the following: Silence, Flashlight, VPN, NFC, Developer tools, Utilities, Take a selfie.

Make all the other changes you wish. 

About the VPN, it should be configured before using it. Check the Quick Start Guide for it.

About the NFC is useful only if you are going to use it. Otherwise, disable it in: 

  • Settings:System -> NFC: OFF.

About Screenshot, the keys combination volume up + down is a much faster way to get your display screenshot.

About Take a selfie is a straightforward mis-defined shortcut to the camera. Therefore: 

  • Settings:System -> Gesture -> Quick access to the Camera: OFF 

will simplify the UI without undermining the user experience.

About Connect to Internet is quite useless, and disabling it will let you gain a free icon position in the top menu or even save an entire line in some cases.

OPTIONS AVAILABLE

Now it is time to take some decisions:

  • Are you going to enable the developer mode activating the SSH connection? No? Why have a GNU/Linux-like smartphone and not use it like that?

  • You may want to register for the smartphone with a Jolla account or not. In the negative case some repositories will be unavailable and it is suggested that you will disable them. This part will be explained below in this mini guide.

  • Are you going to use a WiFi connection or do you wish that your smartphone could share the mobile data connection with your other devices? In this case, you have to configure the tethering.

About the tethering: the one via WiFi is quite immediate to configure by the UI and will be explained later in this guide while the one via USB requires a package to be installed and you will find the related section in the Quick Start Guide.

SSH CONNECTION

These steps will let you activate the SSH service, in Settings:System -> Developer tools:

  1. Show reboot option on Top menu: ON;
  2. Developer mode: ON;
  3. Remote connection: set a strong root password and save it;
  4. Remote connection: ON.

At this point, you have two ways to access the SSH connection: via USB and via WiFi or WiFi tethering.

You will need to digit your password two times: the first for the SSH login and the second to become root. Otherwise, you will not be able to configure, administer the system, or install packages.

In the Quick Start Guide, it is explained how to configure a secure and quick way to access your smartphone via SSH as root without the use of a password, but this functionality is limited to trusted devices only.

The patch above allows you to enable and disable the login with the password, just in case.

JOLLA ACCOUNT

To add or create your Jolla account:

  1. in Settings choose the tab Account;
  2. add an account, choose Jolla;
  3. follow the procedure;
  4. install the Jolla apps that you like.

For those who wish not to register their smartphone with a Jolla account, some repositories need to be disabled:

  1. connect your smartphone to your laptop/PC via USB or via WiFi or WiFi tethering;

  2. login via SSH and, as root, execute:

    repo_list='adaptation0 aliendalvik sailfish-eas xt9'
for repo in $repo_list; do ssu disablerepo $repo; done

WiFi TETHERING

⚠️ Warning

Your laptop/PC especially when running Microsoft Windows, will use your smartphone's WiFi tethering like an Internet cabled line by default, and this can easily consume a lot of data traffic, which can involve extra costs or blocking your SIM data mobile traffic until the next month or next data pack renewal, depending on your plan.

Follow these instructions to activate it in Settings:System -> Internet sharing:

  1. set the WiFi name (SSID);
  2. change the password to a stronger one;
  3. set Internet sharing: ON.

In the future, you can also activate the WiFi hotspot/tethering from the top menu.

@smartiz wrote:

devel-su
pkcon refresh
pkcon install usb-moded-connection-sharing-android-connman-config
systemctl restart usb-moded

As soon as you manage to login into a SSH connection or into a terminal, the above commands are suggested in order to deal with tethering problems and also about the wifi tethering dhcpd service.

ADVANCED SSH

For those who connect to their SFOS smartphone frequently, both via USB and via WiFi, these two simple functions added to your .bashrc will avoid you having to digit the same stuff every time:

wfish() { ssh [email protected] "$@"; }
ufish() { ssh [email protected] "$@"; }

Just for fun, I developed a much more extreme approach to the problem, and I have released a patch, which is not for the SFOS but for your laptop/PC:

It requires having installed on your SFOS device another patch

These patches are not for SFOS but your laptop/PC. The first contains a bash environment that defines some functions useful to quickly and easily connect to your SFOS device to avoid you having to type the user and the IP address every time. Moreover, it will automatically find the quickest network path among those available when there are more than one. While the second enable a secure password-less root login via SSH.

For the installation of both patches, follow the instructions provided in their descriptions. Here below is a list of available functions that are available after having sourced the environment or set it into your .profile or  .bashrc:

  • tfish [command] - to use recovery telnet via USB on its default IPv4
  • rfish [command] - to use recovery SSH via USB on its default IPv4
  • ufish [command] - to use SSH via USB connection on its default IPv4
  • wfish [command] - to use SSH via WiFi connection on its default IPv4
  • afish [command] - to use the fast route IPv4 for SSH, updates IPv4 default
  • sfish [command] - to use the previous route for SSH or it finds the fastest

extras:

  • afish getip - set the fastest route IPv4 for establishing the SSH connection
  • ufish devtether - enable on the SFOS the tethering via USB in developer mode

Continue to explore SailFish OS and leverage its functionality with the

Have fun <3, R-