To-do-list¶
Basic description¶
What it is
What it’s not
Technical terms short glossary (acronyms especially) - 2.5G
Features known not to work / under development (some, device dependent) - Troubleshooting
Computer-based OS concepts, vs. phone-based, vs. special features
Apps, vs DEB packages (Apps just have an icon and descriptor file (otherwise they are deb packages))
Compatible standards, radio, power (device dependent)
Quick-start (in short, + links to reference section)¶
Warning - multi-device OS (link to device-specific info - Device specific info [wip])
How to turn the device on and off, reboot (partially device dependent)
How to charge the battery (device dependent)
How to clean the device (device dependent)
How to install the SIM card and the microSD card (device dependent)
How to navigate through the user interface (UI Navigation - start apps, change app settings, switch between apps, go back, close apps)
How to change basic settings: screen brightness, sound volume (Volume slider), display language (Device language), keyboard layout (Hardware keyboard layout & 1st language & 2nd language), Date & Time & Time zone
How to place a call
How to access a website
How to take a picture using the camera
How to reset user data (Restore original settings & Clear device)
How-to list (links to reference section)¶
Basic usage: calling, sending SMSes, internet surfing, IM, sharing files
How to modify frequently needed settings, and how to choose different options - Settings
How to customize the interface - Customize the main screen
What is expected to be similar to a GNU+Linux distribution (links to Devuan docs?)
Tools for building the manual, and their licences¶
To compile the documents in the best form, you will need Sphinx, which is published under a two clause BSD licence.
Reference¶
Interface and user interaction
Status menu - modify basic options from the status menu (Internet connection menu, sound volume (Volume slider), screen brightness..)
Switch between apps, the Dashboard - Task switcher
Stacked windows (x switches to a back arrow, as you navigate down) - In-app navigation
Navigation using buttons (device dependent) - Device specific info [wip] e.g. Droid 4 hardware buttons
Exit menus without a cancel button - Area around menus
Touch the title (some apps have a small down arrow - not the QT ones) - In-app menu
For received IM
Some devices have keyboards, others don’t - Device specific info [wip]
Keyboard layout, etc.
Hardware vs. virtual keyboard
Customization¶
Themes: how to change Themes, how to add themes (from the Application Manager)
Language & region: how to select a different language - Device language
Profiles (silent, normal, etc) and sound. This is about sounds the device makes, but also for example vibration when touching the screen.
Clock & Alarms - How to check and change the time and zones, how to set alarms
Hardware settings¶
Display settings
USB connection - gadget -> network; OTG -> mouse should work (not storage, etc.)
HDMI - screen mirroring works only from cli [wip]
Connectivity¶
SIM card configuration, How to connect to mobile data (Internet connection menu & Internet connections), set APNs (Edit (Mobile connection) [wip]
WiFi (Internet connection menu & Internet connections) - How to connect to wireless, how to manage wireless connections and such. Probably also mention that various supported WPA types (New (Wi-Fi connection).
Bluetooth: How to set up bluetooth, for example keyboard, for example headset, etc.
Communication tools¶
Phone calls: SIP/VoIP calls, regular calls [wip]
Contacts: contacts application, how to import/export, how to synchronise contacts
Email: cover email application and how it works, notifications
VoIP and IM: accounts (VoIP and IM accounts) - which ones we currently support, how to set them up, etc [wip]
VoIP and IM: Telepathy, Conversations software, how to chat with others using it, notifications [wip]
Group chats [wip]
Internet tools¶
Web browser: how to use it (QTWebBrowser)
Security¶
Tor: How to use it
Wireguard: how to use it
Office tools¶
Calendar: how to use it and how to synchronise
PDF reader
Multimedia & Entertainment¶
Photos: camera application, how to make photos
Images: how to view images
Music / media player: Default application, how to use it [wip]
eBook reader (Dorian)
Games, game emulators
System administration¶
Application Manager¶
How to install applications
File management¶
Standard file locations
File synchronisation¶
Device specific info [wip]¶
Troubleshooting¶
Missing important features¶
Notifications don’t work for IM [wip]
USB connection - gadget -> network; OTG -> mouse should work (not storage, etc.)
Virtual keyboard terminal workarounds
Scrolling inconsistencies (scrolling should work in QT apps, using arrows on hw keyboard as workaround)
enabling mobile network roaming only works through cli
Known bugs¶
Black text on black (style bug - should be fixed soon)
Slow scroll (driver dependent)
Ephemeral contacts in contact list (based on the contact rosters of online accounts) show as (No name)
Error about diversions when upgrading using apt - fix by removing the diversion $ sudo dpkg-divert –remove /lib/udev/rules.d/85-input-devices.rules
In Language & region, the option Date format should probably be named Regional format, since it refers to decimal and thousands separator. The date format is determined by the device language.
The Hardware keyboard layout doesn’t seem to change. Possible bug.
Word completion doesn’t seem to work. Possible bug.
CloudGPS application’s interface seems to not behave well, appearing to have graphical errors.
Unexpected behavior¶
It’s not possible to move a shortcut from another desktop view then the currently displayed one (you need to see it in order to select it, and you cannot move between views when editing, only when adding a new one). See Add shortcut.
Disabling a view by using Manage views will delete the shortcuts from that particular view, without warning. Make sure you move the shortcuts you want to keep to another view, before disabling the view.
Manually changing the desktop image (outside of a theme) from Change background -> More will only change the image of the current desktop view. Each view should then have a different image, and if any fluid transition between views is desired, then that particular image should be prepared (split accordingly) in advance, in an external program.
Sometimes the in-app menu arrow indicator is not shown. The QT applications usually don’t have it.
Some applications only work in landscape mode (e.g. email, calendar)
When changing Themes, you have to still manually change the wallpaper by selecting the wallpaper corresponding to the theme from Change background in the Desktop menu
Pressing on Pair new device to pair a new external GPS device seems to not do anything.
tapping on an XMPP address of a contact in the Contacts application doesn’t do what’s expected for it to do, namely to open the Conversations application. Instead, it goes back to the main screen of the Contacts application.
Send via Text message option for sending a contact card or a contact detail via text message doesn’t seem to work. It does nothing.
Send via Bluetooth option for sending a contact card or a contact detail via BLuetooth doesn’t seem to work. It gives an internal error.
From the five steps of display Brightness levels available, the last two seems to correspond to the same brightness level (tested using Droid 4), so this means that there are five steps, but only four brightness levels.
Checking the Secure autentication option when setting up e-mail Incoming details doesn’t seem to do anything.
It’s not obvious what the Automatically add to contacts option does, or whether it works.
It’s not obvious what the Restore applications option does, or whether it works.
Some functions of Maep don’t seem to work, such as Wikipedia and Screen Rotation.
Some functions of GPS Recorder don’t seem to work, for instance the CELL button doesn’t seem to ever be active.
Leftovers¶
Nokia-branded (Nokia, Ovi) features in certain places
The Network positioning service seems to not work. supl.nokia.com is given as default server, which seems to not be reachable anymore.
The Synchronize from other device option doesn’t seem to work.
When settin up a New account for e-mail, you are being told that some data is going to be sent to Nokia servers. This most likely is not true anymore.
What do do in certain situations¶
When the phone doesn’t turn on (volume down + power to reset)
When the phone is stuck (volume down + power to reset)
When the battery doesn’t charge (boot to Android)
When you want to boot into Android (select Android from boot menu / remove SD card)
Advanced¶
Tips¶
How to choose a good password¶
minimum numbers of characters
no dictionary names (except for passphrases)
numbers and special characters
different than others
password managers
Structural details¶
Useful cli commands¶
connect via SSH
bluetooth (for now it works only from cli)
mirror screen to HDMI
enable mobile network roaming
To-do¶
What is the Secure device option doing?
Which is the default Device lock code?
Test the Heart Rate