Difference between revisions of "PinePhone Software Releases"

Jump to navigation Jump to search
(https, fixes)
(We're no longer using lists for that)
Line 13: Line 13:
(Unofficial) Arch Linux ARM with Phosh as the UI selection, it's usable on the PinePhone and currently being maintained by the DanctNIX community.
(Unofficial) Arch Linux ARM with Phosh as the UI selection, it's usable on the PinePhone and currently being maintained by the DanctNIX community.


* ''' Download location '''
'''Download location'''
 
Get the latest image here: https://github.com/dreemurrs-embedded/Pine64-Arch/releases
Get the latest image here: https://github.com/dreemurrs-embedded/Pine64-Arch/releases


* ''' username/password '''
'''username/password'''
 
alarm/123456
alarm/123456


* ''' What works, what does not work '''
'''What works, what does not work'''
 
Most of the things now works, there are some minor issues with crust.
Most of the things now works, there are some minor issues with crust.


* ''' How to contribute and report defects '''
'''How to contribute and report defects'''
 
Feel free to send us merge requests and report issues on [https://github.com/dreemurrs-embedded/Pine64-Arch/pulls GitHub].
Feel free to send us merge requests and report issues on [https://github.com/dreemurrs-embedded/Pine64-Arch/pulls GitHub].


Line 32: Line 36:
See [https://forum.pine64.org/showthread.php?tid=9347 this thread in the forum].
See [https://forum.pine64.org/showthread.php?tid=9347 this thread in the forum].


* ''' Download location '''
'''Download location'''
 
[https://github.com/nikhiljha/pp-fedora-sdsetup/releases/ flashable images] or [https://github.com/nikhiljha/pp-fedora-sdsetup/tree/image build scripts]
[https://github.com/nikhiljha/pp-fedora-sdsetup/releases/ flashable images] or [https://github.com/nikhiljha/pp-fedora-sdsetup/tree/image build scripts]


* ''' username/password '''
'''username/password'''
 
pine/1111
pine/1111


* ''' What works, what does not work '''
'''What works, what does not work'''
 
WiFi, Bluetooth, SMS, Data, Calls all work! There are still a few bugs though, and [some features don't have driver support yet https://xnux.eu/devices/pine64-pinephone.html#toc-feature-driver-support-matrix] on any PinePhone distribution.  
WiFi, Bluetooth, SMS, Data, Calls all work! There are still a few bugs though, and [some features don't have driver support yet https://xnux.eu/devices/pine64-pinephone.html#toc-feature-driver-support-matrix] on any PinePhone distribution.  


* ''' How to contribute and report defects '''
'''How to contribute and report defects'''
 
Please send your bug reports at [https://github.com/nikhiljha/pp-fedora-sdsetup/issues the project's issue tracker]. Be sure to include logs if applicable! Send us merge requests on [https://github.com/nikhiljha/pp-fedora-sdsetup/ Github].
Please send your bug reports at [https://github.com/nikhiljha/pp-fedora-sdsetup/issues the project's issue tracker]. Be sure to include logs if applicable! Send us merge requests on [https://github.com/nikhiljha/pp-fedora-sdsetup/ Github].


Line 48: Line 56:
An unofficial Gentoo overlay with ebuilds for the PinePhone. There is no image - you'll be building it yourself, picking which kernel, bootloader and desktop environment you want to use.
An unofficial Gentoo overlay with ebuilds for the PinePhone. There is no image - you'll be building it yourself, picking which kernel, bootloader and desktop environment you want to use.


* ''' Download location '''
'''Download location'''


https://gitlab.com/bingch/gentoo-overlay/-/blob/master/README.md
https://gitlab.com/bingch/gentoo-overlay/-/blob/master/README.md
Line 58: Line 66:
A fully open source port of Android to the PinePhone
A fully open source port of Android to the PinePhone


* ''' Download location '''
'''Download location'''


https://github.com/GloDroid/glodroid_manifest/releases
https://github.com/GloDroid/glodroid_manifest/releases


* ''' username/password'''
'''What works, what does not work'''
* ''' What works, what does not work '''
 
Works: WiFi, screen dimming, touchscreen and charging work.
Works: WiFi, screen dimming, touchscreen and charging work.
Don't work: Bluetooth, Telephony, GPS
Don't work: Bluetooth, Telephony, GPS
Line 73: Line 81:
Based on KDE Neon for the desktop, comes with Plasma Mobile.
Based on KDE Neon for the desktop, comes with Plasma Mobile.


* ''' Download location '''
'''Download location'''
 
Plasma mobile images can be found [https://images.plasma-mobile.org/pinephone/ here].
Plasma mobile images can be found [https://images.plasma-mobile.org/pinephone/ here].


* ''' username/password '''
'''username/password'''
 
phablet/1234
phablet/1234
* ''' What works, what does not work '''
* ''' How to contribute and report defects '''


== LuneOS ==
== LuneOS ==
Line 87: Line 93:
Based on WebOS by LG, comes with Luna Next desktop environment.
Based on WebOS by LG, comes with Luna Next desktop environment.


* ''' Download location '''
'''Download location'''
[http://build.webos-ports.org/luneos-testing/images/pinephone/ LuneOS test image for PinePhone]
[http://build.webos-ports.org/luneos-testing/images/pinephone/ LuneOS test image for PinePhone]
Tofe recommends using bmaptool ; for example "bmaptool copy http://build.webos-ports.org/luneos-testing/images/pinephone/luneos-dev-image-pinephone-testing-0-15.rootfs.wic.gz /dev/mmcblk0". Rename .wic file to .img for standard dd usage.  
Tofe recommends using bmaptool ; for example "bmaptool copy http://build.webos-ports.org/luneos-testing/images/pinephone/luneos-dev-image-pinephone-testing-0-15.rootfs.wic.gz /dev/mmcblk0". Rename .wic file to .img for standard dd usage.  
* ''' username/password '''
* ''' What works, what does not work '''
* ''' How to contribute and report defects '''


== Maemo Leste ==
== Maemo Leste ==
Line 106: Line 106:
More detailed information can be found on [https://leste.maemo.org/Main_Page the Maemo Leste wiki], or follow [https://maemo-leste.github.io/ announcements on their website], and check out [https://leste.maemo.org/Leste_FAQ Frequently Asked Questions].  
More detailed information can be found on [https://leste.maemo.org/Main_Page the Maemo Leste wiki], or follow [https://maemo-leste.github.io/ announcements on their website], and check out [https://leste.maemo.org/Leste_FAQ Frequently Asked Questions].  


* ''' Download location '''
'''Download location'''
 
[http://maedevu.maemo.org/images/pinephone/ Maemo Leste test builds]. There is also an [https://github.com/maemo-leste/image-builder image builder], see their wiki for instructions on how to [https://leste.maemo.org/Image_Builder build a custom image].
[http://maedevu.maemo.org/images/pinephone/ Maemo Leste test builds]. There is also an [https://github.com/maemo-leste/image-builder image builder], see their wiki for instructions on how to [https://leste.maemo.org/Image_Builder build a custom image].


* ''' username/password '''
'''username/password'''
 
root/toor
root/toor


You may use "sudo" directly.
You may use "sudo" directly.


* ''' What works, what does not work '''
'''What works, what does not work'''
For current status and workarounds please read their [https://leste.maemo.org/PinePhone PinePhone wiki page], and update as necessary (make sure to notify them of new issues by leaving a report on their github, see below).
For current status and workarounds please read their [https://leste.maemo.org/PinePhone PinePhone wiki page], and update as necessary (make sure to notify them of new issues by leaving a report on their github, see below).


* ''' How to contribute and report defects '''
'''How to contribute and report defects'''
Most discussion occurs at #maemo-leste on freenode IRC. The Maemo website also has an [https://talk.maemo.org/showthread.php?p=1565822 ongoing forum thread] for feedback about Maemo Leste on the PinePhone BraveHeart edition.
Most discussion occurs at #maemo-leste on freenode IRC. The Maemo website also has an [https://talk.maemo.org/showthread.php?p=1565822 ongoing forum thread] for feedback about Maemo Leste on the PinePhone BraveHeart edition.


Line 127: Line 129:
Manjaro is a user-friendly Linux distribution based on the independently developed Arch operating system with the Plasma Mobile desktop environment.
Manjaro is a user-friendly Linux distribution based on the independently developed Arch operating system with the Plasma Mobile desktop environment.


* ''' Download location '''
'''Download location'''


Phosh: [https://osdn.net/projects/manjaro-arm/storage/pinephone/phosh/ Download link for Phosh releases]
Phosh: [https://osdn.net/projects/manjaro-arm/storage/pinephone/phosh/ Download link for Phosh releases]
Line 135: Line 137:
Lomiri: [https://osdn.net/projects/manjaro-arm/storage/pinephone/lomiri/ Download link for Lomiri releases]
Lomiri: [https://osdn.net/projects/manjaro-arm/storage/pinephone/lomiri/ Download link for Lomiri releases]


* ''' username/password '''
'''username/password'''
** manjaro/123456
 
** root/root
manjaro/123456
 
root/root
 
'''What works, what does not work'''


* ''' What works, what does not work '''
See Manjaro's [https://forum.manjaro.org/t/manjaro-arm-beta4-with-phosh-pinephone/43299 announcement].
See Manjaro's [https://forum.manjaro.org/t/manjaro-arm-beta4-with-phosh-pinephone/43299 announcement].


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


See the end of the [https://forum.manjaro.org/t/manjaro-arm-beta4-with-phosh-pinephone/43299 announcement].
See the end of the [https://forum.manjaro.org/t/manjaro-arm-beta4-with-phosh-pinephone/43299 announcement].
Line 151: Line 156:
An unofficial Debian build for ARM64 running with the Phosh user interface (developed by Purism, Phosh uses Wayland instead of Xorg). The base system is pure Debian, with only the GUI applications and a few others (ModemManager, WiFi chip firmware) being built from modified sources (as well as the kernel and u-boot). Current version is Debian Bullseye.
An unofficial Debian build for ARM64 running with the Phosh user interface (developed by Purism, Phosh uses Wayland instead of Xorg). The base system is pure Debian, with only the GUI applications and a few others (ModemManager, WiFi chip firmware) being built from modified sources (as well as the kernel and u-boot). Current version is Debian Bullseye.


* ''' Download location '''
'''Download location'''
 
[https://images.mobian-project.org/ Mobian downloadable images]
[https://images.mobian-project.org/ Mobian downloadable images]


Line 159: Line 165:
See the [https://wiki.mobian-project.org/doku.php?id=install project page] for specific installation instructions.
See the [https://wiki.mobian-project.org/doku.php?id=install project page] for specific installation instructions.


* ''' username/password '''
'''username/password'''
 
mobian/1234
mobian/1234


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


See [https://gitlab.com/mobian1/mobian-recipes/-/blob/master/README.md the project's README file] or [https://wiki.mobian-project.org/doku.php?id=pinephone the wiki]for most up to date status.
See [https://gitlab.com/mobian1/mobian-recipes/-/blob/master/README.md the project's README file] or [https://wiki.mobian-project.org/doku.php?id=pinephone the wiki]for most up to date status.
Line 168: Line 175:
Check [https://gitlab.com/groups/mobian1/-/issues bug tracker] for known issues. Questions? Ask on our [https://forum.pine64.org/showthread.php?tid=9016 thread].
Check [https://gitlab.com/groups/mobian1/-/issues bug tracker] for known issues. Questions? Ask on our [https://forum.pine64.org/showthread.php?tid=9016 thread].


* ''' How to contribute and report defects '''
'''How to contribute and report defects'''
 
It is recommended that you log your bug reports in [https://gitlab.com/mobian1/issues the project's issue tracker]. As a general rule, issues with third-party apps (even the default ones) should be reported upstream. A Mobian issue would be related to getting the hardware to work on the PinePhone, but if unsure where the issue should be reported just open a ticket or ask. Feel free to pick an open issue to work on, or send a merge request on [https://gitlab.com/mobian1 Gitlab].
It is recommended that you log your bug reports in [https://gitlab.com/mobian1/issues the project's issue tracker]. As a general rule, issues with third-party apps (even the default ones) should be reported upstream. A Mobian issue would be related to getting the hardware to work on the PinePhone, but if unsure where the issue should be reported just open a ticket or ask. Feel free to pick an open issue to work on, or send a merge request on [https://gitlab.com/mobian1 Gitlab].


* ''' Notes '''
'''Notes'''
 
See [[Mobian for PinePhone]] or [https://wiki.mobian-project.org/doku.php?id=start the wiki] for additional information regarding screen resolution, USB networking, WiFi hotspot, Chatty and the repository.
See [[Mobian for PinePhone]] or [https://wiki.mobian-project.org/doku.php?id=start the wiki] for additional information regarding screen resolution, USB networking, WiFi hotspot, Chatty and the repository.


Line 186: Line 195:
You can install Nemo on any device that runs Sailfish, see the above website for details. Or you can flash the image to SD card/emmc on the PinePhone, download here https://yadi.sk/d/8oSZp-frGidscw (requires Yandex Disk account).
You can install Nemo on any device that runs Sailfish, see the above website for details. Or you can flash the image to SD card/emmc on the PinePhone, download here https://yadi.sk/d/8oSZp-frGidscw (requires Yandex Disk account).


* ''' Download location '''
'''Download location'''
 
Download location is [https://github.com/neochapay/nemo-device-dont_be_evil/ here on GitHub]. The latest version is not an image file and therefore not for beginners!
Download location is [https://github.com/neochapay/nemo-device-dont_be_evil/ here on GitHub]. The latest version is not an image file and therefore not for beginners!


Line 203: Line 213:
If necessary, reboot.
If necessary, reboot.


* ''' username/password '''
'''What works, what does not work'''


* ''' What works, what does not work '''
Scroll down the page [https://github.com/neochapay/nemo-device-dont_be_evil/ here].
Scroll down the page [https://github.com/neochapay/nemo-device-dont_be_evil/ here].


* ''' How to contribute and report defects '''
'''How to contribute and report defects'''
 
For more info please visit [https://github.com/neochapay/nemo-device-dont_be_evil neochapay's Github page]
For more info please visit [https://github.com/neochapay/nemo-device-dont_be_evil neochapay's Github page]


Line 215: Line 225:
''NixOS support is handled through the Mobile NixOS project.''
''NixOS support is handled through the Mobile NixOS project.''


* [https://mobile.nixos.org/ Project home page]
[https://mobile.nixos.org/ Project home page]
* [https://github.com/NixOS/mobile-nixos Source code repository]
[https://github.com/NixOS/mobile-nixos Source code repository]


There is no pre-built complete image. For now users are expected to follow the instructions in the [https://mobile.nixos.org/getting-started.html Getting Started page], and on [https://mobile.nixos.org/devices/pine64-pinephone-braveheart.html the device's page].
There is no pre-built complete image. For now users are expected to follow the instructions in the [https://mobile.nixos.org/getting-started.html Getting Started page], and on [https://mobile.nixos.org/devices/pine64-pinephone-braveheart.html the device's page].


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


This information may change, but currently it boots, it's as compatible as the Android-based devices are with Mobile NixOS. It even supports a bit more since it can use WiFi.
This information may change, but currently it boots, it's as compatible as the Android-based devices are with Mobile NixOS. It even supports a bit more since it can use WiFi.
Line 228: Line 238:
</cite>
</cite>


* ''' How to contribute and report defects '''
'''How to contribute and report defects'''
 
On [https://github.com/NixOS/mobile-nixos/issues the project's repository]. Please specify that you are using a PinePhone when reporting issues. Details about contributions and donations are on the [https://nixos.org/nixos/community.html NixOS website].
On [https://github.com/NixOS/mobile-nixos/issues the project's repository]. Please specify that you are using a PinePhone when reporting issues. Details about contributions and donations are on the [https://nixos.org/nixos/community.html NixOS website].


Line 235: Line 246:
OpenMandriva with Plasma Mobile as UI.
OpenMandriva with Plasma Mobile as UI.


* ''' Download location '''
'''Download location'''
 
The official image can be found [https://sourceforge.net/projects/openmandriva/files/release/4.2/RC/Pinephone/ here]. See [https://www.openmandriva.org/en/news/article/openmandriva-lx-4-2-rc-available-for-testing here] for the announcement.
The official image can be found [https://sourceforge.net/projects/openmandriva/files/release/4.2/RC/Pinephone/ here]. See [https://www.openmandriva.org/en/news/article/openmandriva-lx-4-2-rc-available-for-testing here] for the announcement.


Line 243: Line 255:
openSUSE Tumbleweed running on the PinePhone.
openSUSE Tumbleweed running on the PinePhone.


* ''' Download location '''
'''Download location'''
 
Offical openSUSE images can be found [https://download.opensuse.org/repositories/devel:/ARM:/Factory:/Contrib:/PinePhone/images/ here].
Offical openSUSE images can be found [https://download.opensuse.org/repositories/devel:/ARM:/Factory:/Contrib:/PinePhone/images/ here].


Line 250: Line 263:
CI/CD for nightly slemos images [https://jenkins.alefnode.com/job/public/job/slemos-imagebuilder/ here].
CI/CD for nightly slemos images [https://jenkins.alefnode.com/job/public/job/slemos-imagebuilder/ here].


* ''' username/password'''
'''username/password'''
 
The default login is pine/1234 but the root user does not have a password (use sudo).
The default login is pine/1234 but the root user does not have a password (use sudo).


* ''' What works, what does not work '''
'''What works, what does not work'''
 
You can find all information about the progress of the project [https://gitlab.com/slem.os/slem.os/-/blob/master/CHANGELOG.md here].
You can find all information about the progress of the project [https://gitlab.com/slem.os/slem.os/-/blob/master/CHANGELOG.md here].


Line 261: Line 276:
postmarketOS is a preconfigured version of [https://www.alpinelinux.org/ Alpine Linux] for mobile devices that offers a choice of several desktop environments including Plasma Mobile and Phosh.
postmarketOS is a preconfigured version of [https://www.alpinelinux.org/ Alpine Linux] for mobile devices that offers a choice of several desktop environments including Plasma Mobile and Phosh.


* ''' Download location '''
'''Download location'''
 
Rather than downloading a demo image, postmarketOS [https://wiki.postmarketos.org/wiki/Installation_guide recommends the use of their script], pmbootstrap, that can tailor build your SD card for you.
Rather than downloading a demo image, postmarketOS [https://wiki.postmarketos.org/wiki/Installation_guide recommends the use of their script], pmbootstrap, that can tailor build your SD card for you.


Line 268: Line 284:
Demo images can be found [https://images.postmarketos.org/pinephone/ here].
Demo images can be found [https://images.postmarketos.org/pinephone/ here].


* ''' username/password '''
'''username/password'''
 
demo/147147 (for demo images only - when building an image with pmbootstrap you set your own username and password (the Phosh lock screen requires your password, but only presents a numeric keyboard, so you should use only numbers in your password).
demo/147147 (for demo images only - when building an image with pmbootstrap you set your own username and password (the Phosh lock screen requires your password, but only presents a numeric keyboard, so you should use only numbers in your password).


* ''' What works, what does not work '''
'''What works, what does not work'''
 
See [https://wiki.postmarketos.org/wiki/PINE64_PinePhone_(pine64-pinephone) postmarketOS dedicated PinePhone wiki page]
See [https://wiki.postmarketos.org/wiki/PINE64_PinePhone_(pine64-pinephone) postmarketOS dedicated PinePhone wiki page]


If you install Firefox browser (or are using a demo image that already has it installed) then [https://wiki.postmarketos.org/wiki/Firefox these hints] in the postmarketOS wiki are recommended.
If you install Firefox browser (or are using a demo image that already has it installed) then [https://wiki.postmarketos.org/wiki/Firefox these hints] in the postmarketOS wiki are recommended.


* ''' How to contribute and report defects '''
'''How to contribute and report defects'''
 
[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.


Line 284: Line 303:
Sailfish OS is a Linux-based operating system based on open source projects such as Mer and including a closed source UI.
Sailfish OS is a Linux-based operating system based on open source projects such as Mer and including a closed source UI.


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


Line 296: Line 316:
# Execute it: <code>./flash-it.sh</code>
# Execute it: <code>./flash-it.sh</code>
# 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 '''
'''username/password'''


OR...when asked where to flash, type 'raw' and it will build the image on your pc/mac
OR...when asked where to flash, type 'raw' and it will build the image on your pc/mac
Line 304: Line 324:
Set PIN on initialization.
Set PIN on initialization.


* ''' 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.
NB The first run sometimes stalls before the tutorial. Reboot and it starts 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.
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.
Line 320: Line 340:
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.
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://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


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


Line 331: Line 352:
A collection of Suckless programs to create a mobile UI. Based on postmarketOS
A collection of Suckless programs to create a mobile UI. Based on postmarketOS


* ''' Download location '''
'''Download location'''
 
Sxmo images can be found [https://images.lrdu.org/pinephone/ here].
Sxmo images can be found [https://images.lrdu.org/pinephone/ here].


* ''' username/password '''
'''username/password'''
 
mo/mo
mo/mo


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


PinePhone's backlight turns off at 2/10 brightness.
PinePhone's backlight turns off at 2/10 brightness.


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


All the contributing information is [https://git.sr.ht/~mil/sxmo-docs/tree/master/CONTRIBUTING.md here].
All the contributing information is [https://git.sr.ht/~mil/sxmo-docs/tree/master/CONTRIBUTING.md here].
Line 352: Line 375:
Ubuntu touch is a mobile version of Ubuntu developed by the UBports community. Installation instructions can be found on [https://gitlab.com/ubports/community-ports/pinephone#how-do-i-install-ubuntu-touch-on-my-pinephone the UBports PinePhone project]. There is also a [https://github.com/goddard/pinephone/ script] to download the latest image and flash to your PinePhone. In the future, Ubuntu Touch will be able to be installed onto the PinePhone with the [https://devices.ubuntu-touch.io/installer UBports installer] GUI tool.
Ubuntu touch is a mobile version of Ubuntu developed by the UBports community. Installation instructions can be found on [https://gitlab.com/ubports/community-ports/pinephone#how-do-i-install-ubuntu-touch-on-my-pinephone the UBports PinePhone project]. There is also a [https://github.com/goddard/pinephone/ script] to download the latest image and flash to your PinePhone. In the future, Ubuntu Touch will be able to be installed onto the PinePhone with the [https://devices.ubuntu-touch.io/installer UBports installer] GUI tool.


* ''' Download location '''
'''Download location'''
 
[https://gitlab.com/ubports/community-ports/pinephone#how-do-i-install-ubuntu-touch-on-my-pinephone UBports PinePhone project]
[https://gitlab.com/ubports/community-ports/pinephone#how-do-i-install-ubuntu-touch-on-my-pinephone UBports PinePhone project]


* ''' username/password '''
'''username/password'''
 
Set up during boot
Set up during boot


* ''' What works, what does not work '''
'''What works, what does not work'''
 
Scroll down to the bottom of [https://gitlab.com/ubports/community-ports/pinephone this page].
Scroll down to the bottom of [https://gitlab.com/ubports/community-ports/pinephone this page].


* ''' How to contribute and report defects '''
'''How to contribute and report defects'''
 
See [https://gitlab.com/ubports/community-ports/pinephone UBports gitlab page]. See [https://ubports.com/foundation/sponsors UBports website] for how to donate.
See [https://gitlab.com/ubports/community-ports/pinephone UBports gitlab page]. See [https://ubports.com/foundation/sponsors UBports website] for how to donate.


Line 368: Line 395:


Links:
Links:
* [https://images.postmarketos.org/pinephone/ Software Images] (download the latest one that is marked pine-pinephone-YYYYMMDD-factorytestX.img.xz)
[https://images.postmarketos.org/pinephone/ Software Images] (download the latest one that is marked pine-pinephone-YYYYMMDD-factorytestX.img.xz)
* [https://gitlab.com/MartijnBraam/factorytest Git repo]
[https://gitlab.com/MartijnBraam/factorytest Git repo]
* [https://gitlab.com/MartijnBraam/factorytest/-/blob/master/README.rst Documentation]
[https://gitlab.com/MartijnBraam/factorytest/-/blob/master/README.rst Documentation]


== Factory-loaded postmarketOS build ==
== Factory-loaded postmarketOS build ==
* This is a postmarketOS build that was preloaded in the factory with testing utility.
This is a postmarketOS build that was preloaded in the factory with testing utility.
* Download the build, extract the image and dd it to the microSD and then insert it into the phone. Power up the PinePhone, perform and complete the test routine, then apply the build from microSD card to eMMC.
Download the build, extract the image and dd it to the microSD and then insert it into the phone. Power up the PinePhone, perform and complete the test routine, then apply the build from microSD card to eMMC.
* dd the image on a 8 GB micoSD card or larger.
dd the image on a 8 GB micoSD card or larger.
** [https://files.pine64.org/os/PinePhone/PostMarketOS/pine64-pinephone-20200726-phosh-v20.05-factory.img.xz Direct download from pine64.org]
*[https://files.pine64.org/os/PinePhone/PostMarketOS/pine64-pinephone-20200726-phosh-v20.05-factory.img.xz Direct download from pine64.org]
*** MD5 (XZip file): 244093be2f6d728fcbd1d29114607727
**MD5 (XZip file): 244093be2f6d728fcbd1d29114607727
*** File Size: 517MB
**File Size: 517MB


== Factory-loaded Ubuntu Touch build ==
== Factory-loaded Ubuntu Touch build ==
* This is an Ubuntu Touch build that was preloaded in the factory with testing utility.
This is an Ubuntu Touch build that was preloaded in the factory with testing utility.
* Download the build, extract the image and dd it to the microSD and then insert it into the phone. Power up the PinePhone, perform and complete the test routine, then apply the build from microSD card to eMMC.
Download the build, extract the image and dd it to the microSD and then insert it into the phone. Power up the PinePhone, perform and complete the test routine, then apply the build from microSD card to eMMC.
* dd the image on a 8 GB micoSD card or larger.
dd the image on a 8 GB micoSD card or larger.
** [https://files.pine64.org/os/PinePhone/UBPorts/PinePhone-flasher-ubuntu-7b.img.gz Direct download from pine64.org]
*[https://files.pine64.org/os/PinePhone/UBPorts/PinePhone-flasher-ubuntu-7b.img.gz Direct download from pine64.org]
*** MD5 (GZip file): 2d7f5271e7a281db8f1b1219bedbe131
**MD5 (GZip file): 2d7f5271e7a281db8f1b1219bedbe131
*** File Size: 1.05GB
**File Size: 1.05GB


== Factory-loaded Manjaro build ==
== Factory-loaded Manjaro build ==
* This is a Manjaro OS build that was preloaded in the factory with testing utility.
This is a Manjaro OS build that was preloaded in the factory with testing utility.
* Download the build, extract the image and dd it to the microSD and then insert it into the phone. Power up the PinePhone, perform and complete the test routine, then apply the build from microSD card to eMMC.
Download the build, extract the image and dd it to the microSD and then insert it into the phone. Power up the PinePhone, perform and complete the test routine, then apply the build from microSD card to eMMC.
* dd the image on a 8 GB micoSD card or larger.
dd the image on a 8 GB micoSD card or larger.
** [https://files.pine64.org/os/PinePhone/Manjaro/pine64-pinephone-20201013-manjaro-stable-20201018-factory56.img.xz Direct download from pine64.org]
*[https://files.pine64.org/os/PinePhone/Manjaro/pine64-pinephone-20201013-manjaro-stable-20201018-factory56.img.xz Direct download from pine64.org]
*** MD5 (XZip file): 4edfd4dceaefdd32a3417c1727161c29
**MD5 (XZip file): 4edfd4dceaefdd32a3417c1727161c29
*** File Size: 1.04 GB
**File Size: 1.04 GB


= Installing other ARM64 distributions =
= Installing other ARM64 distributions =
'''Warning:''' Distributions not on this page may not even boot after you follow this section. In the best case, they will be barely usable. This is more for fun, or if you would like to port a new distribution to the PinePhone.
'''Warning:'''Distributions not on this page may not even boot after you follow this section. In the best case, they will be barely usable. This is more for fun, or if you would like to port a new distribution to the PinePhone.


'''Note:''' This section uses megi's kernel releases, and not the official ones from Pine64. While it is possible to use the official (and in the future, mainline) kernel, megi provides binary releases, which makes it very easy.
'''Note:'''This section uses megi's kernel releases, and not the official ones from Pine64. While it is possible to use the official (and in the future, mainline) kernel, megi provides binary releases, which makes it very easy.


If you would like to see specific commands for how to complete these steps, see https://github.com/nikhiljha/pp-fedora-sdsetup (an example for Fedora) or https://xnux.eu/howtos/install-arch-linux-arm.html (an example for Arch Linux).
If you would like to see specific commands for how to complete these steps, see https://github.com/nikhiljha/pp-fedora-sdsetup (an example for Fedora) or https://xnux.eu/howtos/install-arch-linux-arm.html (an example for Arch Linux).
Line 412: Line 439:
= Other Resources =
= Other Resources =
Community
Community
* [[Main_Page#Community_and_Support|Links to the community services]]
[[Main_Page#Community_and_Support|Links to the community services]]


Hardware information
Hardware information
* [[PinePhone|General PinePhone hardware info]] in this Pine64 wiki.
[[PinePhone|General PinePhone hardware info]] in this Pine64 wiki.
* [[PinePhone_v1.1_-_Braveheart|PinePhone 1.1 Braveheart hardware details]] (details specific to the Braveheart Edition).
[[PinePhone_v1.1_-_Braveheart|PinePhone 1.1 Braveheart hardware details]] (details specific to the Braveheart Edition).
* [[PinePhone_v1.2|PinePhone 1.2 hardware details]] (details specific to the Community Edition).
[[PinePhone_v1.2|PinePhone 1.2 hardware details]] (details specific to the Community Edition).
* The postmarketOS wiki has a detailed page on the PinePhone hardware [https://wiki.postmarketos.org/wiki/PINE64_PinePhone_(pine64-pinephone) here] and the preceding devkit [https://wiki.postmarketos.org/wiki/PINE64_Don%27t_be_evil_devkit_(pine64-dontbeevil) here].
The postmarketOS wiki has a detailed page on the PinePhone hardware [https://wiki.postmarketos.org/wiki/PINE64_PinePhone_(pine64-pinephone) here] and the preceding devkit [https://wiki.postmarketos.org/wiki/PINE64_Don%27t_be_evil_devkit_(pine64-dontbeevil) here].


Other software information
Other software information
* [https://linux-sunxi.org/Main_Page sunxi community wiki]
[https://linux-sunxi.org/Main_Page sunxi community wiki]
* [https://xnux.eu/devices/pine64-pinephone.html megi feature/driver support matrix]
[https://xnux.eu/devices/pine64-pinephone.html megi feature/driver support matrix]
* [https://megous.com/dl/tmp/README.bootui megi bootUI notes (for dualbooting/multibooting)] see demonstration [https://www.youtube.com/watch?v=ZL1GREqoqx8 on YouTube,]
[https://megous.com/dl/tmp/README.bootui megi bootUI notes (for dualbooting/multibooting)] see demonstration [https://www.youtube.com/watch?v=ZL1GREqoqx8 on YouTube,]
* [https://github.com/ayufan-pine64/boot-tools ayufan boot tools]
[https://github.com/ayufan-pine64/boot-tools ayufan boot tools]


Other
Other
* [https://pine64.com/?post_type=product Pine64 shop]
[https://pine64.com/?post_type=product Pine64 shop]
* [https://www.pine64.org/2020/01/24/setting-the-record-straight-pinephone-misconceptions/ Pine64 blog on blobs]
[https://www.pine64.org/2020/01/24/setting-the-record-straight-pinephone-misconceptions/ Pine64 blog on blobs]
* [https://tuxphones.com/yet-another-librem-5-and-pinephone-linux-smartphone-comparison/ Martijn Braam Librem 5 comparison, especially covering openness/blobs]
[https://tuxphones.com/yet-another-librem-5-and-pinephone-linux-smartphone-comparison/ Martijn Braam Librem 5 comparison, especially covering openness/blobs]
* [https://fam-ribbers.com/2019/12/28/State-of-Linux-on-mobile-and-common-misconceptions.html Bart Ribbers blog on Linux distributions and desktop environments on mobile devices]
[https://fam-ribbers.com/2019/12/28/State-of-Linux-on-mobile-and-common-misconceptions.html Bart Ribbers blog on Linux distributions and desktop environments on mobile devices]
* [https://www.jeffgeerling.com/blog/2019/a2-class-microsd-cards-offer-no-better-performance-raspberry-pi Jeff Geerling on testing microSD cards]
[https://www.jeffgeerling.com/blog/2019/a2-class-microsd-cards-offer-no-better-performance-raspberry-pi Jeff Geerling on testing microSD cards]




[[Category:PinePhone]]
[[Category:PinePhone]]