PinePhone

PinePhone is supported by Mobile NixOS: https://mobile.nixos.org/devices/pine64-pinephone.html

This guide is discusses how to use Phosh, the GNOME-derived UI used by Librem and Mobian.

Requirements

This document assumes you have set up NixOS on your PinePhone, as described in https://mobile.nixos.org/getting-started.html

Beware known issues:

Status

Phosh

https://github.com/NixOS/mobile-nixos/pull/352 is a PR to add a phosh-demo to mobile-nixos. The author of this wiki page uses this PR.

Battery

Wake-on-modem works. Wake-on-WiFi is not supported. Something like https://gist.github.com/Peetz0r/bf8fd93a60962b4afcf2daeb4305da40 is needed.

Browsing

GNOME Web is installed by default.
`pkgs.firefox-wayland` works but doesn't scale down the UI well. https://gitlab.com/postmarketOS/mobile-config-firefox is needed for that.

Sound

Working. Settings -> Sound ->Output -> Configuration -> HiFi

Calling

Working with the following (pr: https://github.com/NixOS/nixpkgs/pull/131695/ ):

environment.systemPackages = [ pkgs.calls ];
services.dbus.packages = [ pkgs.callaudiod ];

Known issues:

incoming calls don't trigger music to be paused. Likely need something like https://source.puri.sm/Librem5/librem5-base/-/merge_requests/170/diffs
when the screen is locked, incoming calls can only be answered after unlocking.

SMS

Working with:

Chatty
and the following:

environment.systemPackages = [
  (pkgs.chatty.override {
    plugins = [
      pkgs.purple-mm-sms
    ];
  })
];

MMS

Unsupported. See https://source.puri.sm/Librem5/chatty/-/issues/30

Camera

pkgs.megapixels is the only known application to work with Pinephone. Does not always start correctly, retrying might help.

Front camera works out-of-the-box.
Back camera requires:
- https://github.com/NixOS/mobile-nixos/pull/392
- https://github.com/NixOS/mobile-nixos/issues/393 tracks autofocus support. The camera is usable without this.

Mobile internet

Working via gnome-control-center ("Mobile Broadband" section), or:

$ nmcli c add type gsm ifname cdc-wdm0 con-name $PROVIDER apn $APN

GPS

Working with GNOME applications with:

allow Phosh to use geoclue
and the following:

services.geoclue2.enable = true;
users.users.geoclue.extraGroups = [ "networkmanager" ];

Sensors

The acceleration, compass, and ambient light sensors provide working auto-rotation, compass, and auto-brightness, when you:

hardware.sensor.iio.enable = true;
hardware.firmware = [ config.mobile.device.firmware ];

Disk encryption

The boot process supports opening LUKS volumes. Creating an image to use LUKS is unsupported, but possible. The idea is to write an encrypted LUKS volume to the root partition, as described in https://github.com/NixOS/mobile-nixos/tree/master/examples/testing/qemu-cryptsetup.

Hardware acceleration for video

See https://github.com/NixOS/mobile-nixos/issues/398.

Torch

See https://github.com/NixOS/mobile-nixos/issues/379

Bluetooth