From Fedora Project Wiki
(add recommended pkgs and install instructions)
(pretty wiki)
Line 5: Line 5:
The [https://www.pine64.org/pinephone/ PinePhone] is a Linux-native mobile phone. It is based on an [[Architectures/ARM/AllWinner|AllWinner]] CPU. Fedora does not (yet) support the PinePhone, but it is possible to get it running with a custom kernel. This documentation describes how to install Fedora on a PinePhone, and links to useful resources.
The [https://www.pine64.org/pinephone/ PinePhone] is a Linux-native mobile phone. It is based on an [[Architectures/ARM/AllWinner|AllWinner]] CPU. Fedora does not (yet) support the PinePhone, but it is possible to get it running with a custom kernel. This documentation describes how to install Fedora on a PinePhone, and links to useful resources.


== Installation Guide ==
= Installation Guide =


The general steps to get a working install are as follows:
An unofficial script that generates a flashable image can be [https://github.com/nikhiljha/pp-fedora-sdsetup found here], and unofficial prebuilt images can be [https://github.com/nikhiljha/pp-fedora-sdsetup/releases found here]. Currently, the images do not support the internal eMMC and most be booted from an SD card.


1. Make a boot partition with a pinephone-compatible kernel
= Recommended Packages =


2. write the corresponding bootloader 8 bytes after the start of your SD card
The default GNOME install doesn't work very well on such a small touch screen. Instead, librem's Phosh and various other related software have been packaged in [https://copr.fedorainfracloud.org/coprs/njha/mobile/packages/ the njha/mobile COPR]. KDE Plasma Mobile should also be compatible, but hasn't been packaged. If you're interested in packaging it, coordinate with others in the chat.


3. copy a Fedora aarch64 rootfs into a second larger partition, filling the rest of the SD card
== njha/mobile packages ==


4. copy the kernel modules into the rootfs
* phoc - A wayland compositor, needed to run phosh.
* phosh - A mobile version of the GNOME shell.
* carbons - XMPP Message sync for libpurple. Used by chatty.
* chatty - A libpurple client (alternative to Pidgin) optimized for Phosh.
* feedbackd - Physical feedback daemon (LED, vibration, sound) integrated with Phosh.
* pidgin - A mildly hacked up version of pidgin that exposes private libraries for chatty to link with. (Don't worry, [https://source.puri.sm/Librem5/chatty/issues/266 upstream is working on it].)
* purple-mm-sms - A libpurple plugin for SMS- integrates with ModemManager.
* rtl8723cs-firmware - Firmware needed for Bluetooth on the PinePhone.
* squeekboard - A touchscreen mobile keyboard, integrated with Phosh.
* pinephone-helpers - Runs some scripts to initialize the modem, switch audio routing when a call is in progress, etc. Ideally all these tweaks will be built into the respective software eventually.


5. edit the fstab file to correspond to this new partition layout
== Main repository ==


An unofficial script that automatically does the steps and generates a flashable image can be [https://github.com/nikhiljha/pp-fedora-sdsetup found here], and unofficial prebuilt images can be [https://github.com/nikhiljha/pp-fedora-sdsetup/releases found here].
* NetworkManager - Connect to the modem, needed for data, sms, calls.
* gnome-terminal - Self explanatory
* gnome-contacts - Self explanatory
* purple-matrix - Matrix plugin for libpurple.
* purple-telegram - Telegram plugin for libpurple.
* gdm - Self explanatory. Ideally this would be switched out for lightdm but I (njha) haven't been able to get that to work.


== Recommended Packages ==
= Contributing =


The default GNOME install doesn't work very well on such a small touch screen. Instead, librem's Phosh and various other related software have been packaged in [https://copr.fedorainfracloud.org/coprs/njha/mobile/packages/ the njha/mobile COPR].
We need help with everything! Please help :)


From the COPR: carbons chatty feedbackd phoc phosh pidgin purple-mm-sms rtl8723cs-firmware squeekboard
== Chat ==


From the main repository: NetworkManager gnome-terminal gnome-contacts purple-matrix purple-telegram gdm
If you're interested in improving Fedora on PinePhone, there is a bridged chatroom for Telegram, Discord, Matrix, and IRC.


(Untested) Available on other COPRs: pidgin-lurch
Telegram: https://t.me/fedoraphone
Discord: https://discord.gg/NV4U45G
IRC: #fedora-phone on Freenode (not recommended, images and video aren't bridged)
Matrix: #fedora-mobile:matrix.org
 
== Other Resources ==
 
Pine64's Wiki: https://wiki.pine64.org/index.php/PinePhone
Megi' Website + Kernel: https://xnux.eu/devices/pine64-pinephone.html
Pine64's Kernel: https://gitlab.com/pine64-org/linux/
PostmarketOS Wiki: https://wiki.postmarketos.org/wiki/PINE64_PinePhone_(pine64-pinephone)
Pine64 Forum: https://forum.pine64.org/forumdisplay.php?fid=120


Also available, not recommended: ofono


[[Category:AArch64]]
[[Category:AArch64]]

Revision as of 05:35, 21 March 2020

Introduction

The PinePhone is a Linux-native mobile phone. It is based on an AllWinner CPU. Fedora does not (yet) support the PinePhone, but it is possible to get it running with a custom kernel. This documentation describes how to install Fedora on a PinePhone, and links to useful resources.

Installation Guide

An unofficial script that generates a flashable image can be found here, and unofficial prebuilt images can be found here. Currently, the images do not support the internal eMMC and most be booted from an SD card.

Recommended Packages

The default GNOME install doesn't work very well on such a small touch screen. Instead, librem's Phosh and various other related software have been packaged in the njha/mobile COPR. KDE Plasma Mobile should also be compatible, but hasn't been packaged. If you're interested in packaging it, coordinate with others in the chat.

njha/mobile packages

  • phoc - A wayland compositor, needed to run phosh.
  • phosh - A mobile version of the GNOME shell.
  • carbons - XMPP Message sync for libpurple. Used by chatty.
  • chatty - A libpurple client (alternative to Pidgin) optimized for Phosh.
  • feedbackd - Physical feedback daemon (LED, vibration, sound) integrated with Phosh.
  • pidgin - A mildly hacked up version of pidgin that exposes private libraries for chatty to link with. (Don't worry, upstream is working on it.)
  • purple-mm-sms - A libpurple plugin for SMS- integrates with ModemManager.
  • rtl8723cs-firmware - Firmware needed for Bluetooth on the PinePhone.
  • squeekboard - A touchscreen mobile keyboard, integrated with Phosh.
  • pinephone-helpers - Runs some scripts to initialize the modem, switch audio routing when a call is in progress, etc. Ideally all these tweaks will be built into the respective software eventually.

Main repository

  • NetworkManager - Connect to the modem, needed for data, sms, calls.
  • gnome-terminal - Self explanatory
  • gnome-contacts - Self explanatory
  • purple-matrix - Matrix plugin for libpurple.
  • purple-telegram - Telegram plugin for libpurple.
  • gdm - Self explanatory. Ideally this would be switched out for lightdm but I (njha) haven't been able to get that to work.

Contributing

We need help with everything! Please help :)

Chat

If you're interested in improving Fedora on PinePhone, there is a bridged chatroom for Telegram, Discord, Matrix, and IRC.

Telegram: https://t.me/fedoraphone Discord: https://discord.gg/NV4U45G IRC: #fedora-phone on Freenode (not recommended, images and video aren't bridged) Matrix: #fedora-mobile:matrix.org

Other Resources

Pine64's Wiki: https://wiki.pine64.org/index.php/PinePhone Megi' Website + Kernel: https://xnux.eu/devices/pine64-pinephone.html Pine64's Kernel: https://gitlab.com/pine64-org/linux/ PostmarketOS Wiki: https://wiki.postmarketos.org/wiki/PINE64_PinePhone_(pine64-pinephone) Pine64 Forum: https://forum.pine64.org/forumdisplay.php?fid=120