Difference between revisions of "PinePhone Software Releases"

Jump to navigation Jump to search
m (enhance postmarketOS section)
(Update SailfishOS, now Sailfish OS)
Line 6: Line 6:


= Software Releases =
= Software Releases =
This is a list of OSes that specifically support the PinePhone, but as support is included in Mainline Linux, in principle any ARM Linux OS can be used, if possible required patches are included.
This is a list of OSes that specifically support the PinePhone, but as support is included in Mainline Linux, in principle any ARM Linux OS can be used, if possible required patches are included.


Line 211: Line 212:


then
then
  pkcon refresh
  pkcon refresh


Line 307: Line 309:


[https://gitlab.com/postmarketOS/postmarketos/issues/3 postmarketOS issue tracker] for PinePhone support. See [https://wiki.postmarketos.org/wiki/Contributing postmarketOS wiki] for options to contribute.
[https://gitlab.com/postmarketOS/postmarketos/issues/3 postmarketOS issue tracker] for PinePhone support. See [https://wiki.postmarketos.org/wiki/Contributing postmarketOS wiki] for options to contribute.
== Sailfish OS ==
[[File:Sailfish_logo.png|150px]]


== SailfishOS ==
[https://sailfishos.org/ Sailfish OS] is a Linux-based operating system based on open source projects such as [https://wiki.merproject.org/wiki/Main_Page Mer], and a closed source UI based on [https://sailfishos.org/wiki/Lipstick Lipstick].
[[File:Sailfish_logo.png|150px]]


Sailfish OS is a Linux-based operating system based on open source projects such as Mer and including a closed source UI.
* [https://wiki.merproject.org/wiki/Adaptations/PinePhone64 PinePhone Wiki Page] on Mer Wiki, for both Nemo Mobile and Sailfish OS.
* [https://gitlab.com/pinephone-sailfish-os/linux-kernel/ Linux kernel config repo]
* [https://gitlab.com/sailfishos-porters-ci/dont_be_evil-ci/ Sailfish OS repo]


'''Download location'''
'''Download location'''


The SailfishOS image is built on Gitlab CI. The latest image can be installed using the [https://raw.githubusercontent.com/sailfish-on-dontbeevil/flash-it/master/flash-it.sh flashing script].
'''Flashing script'''


The script downloads the image and bootloader from our CI, extracts everything and burns it onto the SD card. Note: The script will format and erase the SD card!
The Sailfish OS image is built on Gitlab CI. The latest image can be installed using the [https://raw.githubusercontent.com/sailfish-on-dontbeevil/flash-it/master/flash-it.sh flashing script].
 
The script downloads the image and bootloader from the CI, extracts everything and burns it onto the SD card. Note: The script will format and erase the SD card!


Instructions:
Instructions:
Line 327: Line 334:
# Follow the instructions. Some commands in the script require root permissions (for example: mounting and flashing the SD card).
# Follow the instructions. Some commands in the script require root permissions (for example: mounting and flashing the SD card).


'''username/password'''
* When asked where to flash, type 'raw' and it will build the image on your computer.


Or when asked where to flash, type 'raw' and it will build the image on your pc/mac
'''Prebuilt image'''


Or download the .img from https://gitlab.com/as400l/pp-sailfishos-images
Download the image file (.img) from [https://gitlab.com/as400l/pp-sailfishos-images].
 
'''username/password'''


Set PIN on initialization.
Set PIN on initialization.
* Sometimes the first run stalls before the tutorial. Reboot and it will start from setting the security pin.
* The homescreen may be locked unless you boot with a sim card inserted. An old expired sim will do. '''If you do not have a SIM card on hands, do NOT set a security code on first boot.'''
* When a screen with a loading circle is displayed, just left/right swipe it away.
* If you're not familiar with Sailfish OS, pay attention to the tutorial - the interface works great, but not immediately obvious. If you are familiar with it, you can skip the tutorial by touching all 4 corners starting top left.


'''What works, what does not work'''
'''What works, what does not work'''


NB The first run sometimes stalls before the tutorial. Reboot and it starts from setting the security pin.
See the [https://wiki.merproject.org/wiki/Adaptations/PinePhone64#Hardware_Support Hardware Support section] on the Mer Wiki's PinePhone Page.
The homescreen may be locked unless you boot with a sim card inserted. An old expired sim will do. If you do not have a SIM card on hands, do NOT set a security code on first boot. When a screen with a loading circle is displayed, just left/right swipe it away.
 
There is a limited selection of apps available from the Jolla store, the vast majority are hosted on openrepos.net. The Storeman app for openrepos is now preinstalled, and also Webcat browser (the built-in browser) is not working at the moment.
If you're not familiar with SFOS, pay attention to the tutorial - the interface works great but isn't immediately obvious. If you are familiar with SF you can skip the tutorial by touching all 4 corners starting top left. There is a limited selection of apps available from the Jolla store, the vast majority are hosted on openrepos.net. The Storeman app for openrepos is now preinstalled, and also Webcat browser as the built in browser is not working at the moment.


'''How to contribute and report defects'''
'''How to contribute and report defects'''


See the [https://sailfishos.org/wiki/Collaborative_Development#Reporting_issues SailfishOS wiki] for links to their forum as well as info required when reporting an issue. See the [https://sailfishos.org/wiki/SailfishOS SailfishOS wiki] for options to contribute
See the [https://wiki.merproject.org/wiki/Adaptations/PinePhone64#Installation Installation section] on the Mer Wiki's PinePhone Page for compile, build and development.
 
Git repo links are at the top of this OS section. other repos that may be helpful:
 
* [https://github.com/sailfish-on-dontbeevil GitHub project page]
* [https://github.com/sailfish-on-dontbeevil/flash-it the repo of the flash-it.sh flashing script]
* [https://build.merproject.org/project/show/nemo:devel:hw:pine:dontbeevil Mer Open Build Service page] ([https://forum.sailfishos.org/t/changes-needed-to-merge-the-project-names-to-sailfish-os/1672 Mer is being assimilated into Sailfish OS] and [https://forum.sailfishos.org/t/obs-shut-down-and-next-steps/1814 OBS is shutting down], also see [https://specs.openstack.org/openstack/fuel-specs/specs/7.0/replace-obs.html OpenStack is replacing OBS with another build system based on Jenkins], if it's related, even OBS come back under Sailfish OS, it will be different.)
 
See the [https://sailfishos.org/wiki/Collaborative_Development#Reporting_issues Sailfish OS wiki] for links to their forum, as well as info required when reporting an issue. See the [https://sailfishos.org/wiki/SailfishOS Sailfish OS wiki main page] for options to contribute to Sailfish OS.


'''Notes'''
'''Notes'''


OTA is supported: <code>zypper refresh && zypper update</code> as root (<code>devel-su</code> to get root access). Things that need reflash are bootloader specific at the moment. If improvements like crust or changes of partition layout are added then you need to reflash.
OTA is supported: <code>zypper refresh && zypper update</code> as root (<code>devel-su</code> to get root access). Things that need reflash are bootloader specific at the moment. If improvements like crust or changes of partition layout are added, then you need to reflash.


== SkiffOS ==
== SkiffOS ==
Retrieved from "https://wiki.pine64.org/wiki/PinePhone_Software_Releases"