Purism Librem5 (purism-librem5)

From postmarketOS
Revision as of 10:38, 21 February 2021 by Ollieparanoid (talk | contribs) (remove device milestone link)
Jump to navigation Jump to search
Purism Librem 5
Manufacturer Purism
Name Librem 5
Codename purism-librem5
Released 2019
Category community
Original software PureOS
Hardware
Chipset Emcraft NXP i.MX8M
CPU 4x 1.5 GHz Cortex-A53
GPU Vivante GC7000Lite
Display 1440x720
Storage 32 GB eMMC
Memory 3 GB
Architecture aarch64
Non-Android based device
Features
USB Networking
Works
Flashing
Works
Touchscreen
Works
Display
Works
WiFi
Works
Xwayland
Works
FDE
Works
Mainline
Works
Battery
Works
3D Acceleration
Works
Accelerometer
Works
Audio
Works
Bluetooth
Works
Camera
GPS
Works
Mobile data
Works
SMS
Works
Calls
Works
USB OTG
Partial



Contributors

Installation

From pre-built image (easy method)

Official images of postmarketOS for the Librem 5 are built at least every week. Currently the device is only supported on the edge branch of postmarketOS.

This method requires the uuu application is installed on the host computer. <uuu> is NXP's image deploy tool, and may be found in some distros in a package named mfgtools.

Download the right image

  • Branch (more):
    • edge: bleeding edge version (has latest features, but may break more often).
  • User interface
    • Phosh: Purism's GTK based phone interface (more)
    • Plasma Mobile: KDE's Plasma based phone interface (more)
    • (Note that more interfaces are available, build your own image with pmbootstrap if interested)
  • Pick the latest image by its date
  • Choose the regular image, or the installer image
    • Graphical Installer:
      • Ends in -installer.img.xz
      • Recommended for a proper installation.
      • Encrypting your installation is possible
      • Passwords for user and SSH are set during installation (and SSH can be disabled)
    • Regular image:
      • Ends in .img.xz
      • An installation of postmarketOS with defaults for passwords and no full disk encryption
      • The login is user with password 147147
      • sshd is currently enabled by default! (build.postmarketos.org#85)
      • Not recommended, unless looking for a quick way to try out postmarketOS

Download JumpDrive

Grab the latest purism-librem5.tar.xz image from the JumpDrive release page

JumpDrive 0.7 is the first version to support the Librem 5

Extract it, and you should see something similar:

$ tar xf purism-librem5.tar.xz
$ ls
boot-purism-librem5.sh  dtbs  initramfs-purism-librem5.gz  kernel-librem5.gz  purism-librem5.lst  purism-librem5.tar.xz  u-boot-librem5.bin

Run JumpDrive

Place the Librem 5 into #Flash Mode.

Use the helper script from the JumpDrive release to flash the Librem 5:

$ ./boot-purism-librem5.sh
uuu (Universal Update Utility) for nxp imx chips -- libuuu_1.4.72-0-g8e9e189

Success 1    Failure 0

3:2     10/10 [Done                                  ] FB: Done

Flash to EMMC

In order to flash the postmarketOS image to the Librem 5, locate the bock device exposed to the host computer via JumpDrive:

$ lsblk -o name,size,model,vendor
NAME        SIZE MODEL                     VENDOR
sda       476.9G Samsung_SSD_860_PRO_512GB ATA
├─sda1   1007.5K
├─sda2    476.8G
│ └─root  476.8G
└─sda3     99.3M
sdc        29.1G e_eMMC                    JumpDriv
├─sdc1      189M
└─sdc2     28.9G
zram0       247M

In the example above, the /dev/sdc is the EMMC device on the Librem 5.

Warning! Triple check you have selected the right block device when performing the next step!!
$ xzcat 20210217-0609-postmarketOS-edge-phosh-6-purism-librem5-installer.img.xz | sudo dd of=/dev/DRIVE status=progress bs=1M oflag=direct iflag=fullblock
4277141504 bytes (4.3 GB, 4.0 GiB) copied, 194 s, 22.0 MB/s
4093+0 records in
4093+0 records out
4291821568 bytes (4.3 GB, 4.0 GiB) copied, 200.427 s, 21.4 MB/s

Remove the usb cable and power cycle the phone to boot into the postmarketOS installer.

With pmbootstrap (Advanced)

Use pmbootstrap to build a customized image. Consult the installation guide for details.

$ pmbootstrap init # vendor: purism, device: librem5
$ pmbootstrap install...  # add --fde for full disk encryption

Place the device into #Flash Mode, then flash it with:

$ pmbootstrap flasher flash_rootfs

Flash Mode

To place the Librem 5 info flashing mode, perform the following:

  1. Ensure that the phone is switched off.
  2. Turn all Hardware-Kill-Switches off
  3. Remove battery
  4. Hold volume-up
  5. Insert the USB-c cable: (red light blinks, no green light)
  6. Reinsert the battery: (red light is constantly on, the script will continue)
  7. Release volume-up
Some USB-C cables may need to be plugged into the phone with a particular orientation. If the instructions above do not appear to work, try flipping the USB-C end of the cable over and replugging it into the phone.

These directions were gathered from Purism's documentation, refer to it for additional details/troubleshooting.

Known Issues

For an ever-up-to-date list of issues, see gitlab

  • Suspend, as implemented in gnome settings under phosh, is not supported by the device [1].

Related

  • pmaports!1673 upgrade to 5.9.1, information about selecting dtb on boot with u-boot (not enabled in this MR yet)