First, download the following images:
The last to images are specific to your device. You can either build them yourself using the halium buildsystem, or download a prebuilt one from the server if one is available for your device.
After downloading, you can install the halium system image and the rootfs. For that you can use this halium-install script.
Reboot your device into the TWRP recovery, and use
halium-install -p debian-pm rootfs.tar.xz system.img
to install the images. Please note that you need to use
halium-install -p debian-pm-caf rootfs.tar.xz system.img
to install the images on caf (Qualcomm) devices.
The last step is flashing the hybris-boot.img, which is also a halium part. Depending on the device, you can use fastboot or heimdal to do it.
On fastboot capable devices, it can be installed using
fastboot flash boot hybris-boot.img
Download the system image for the pinephone device. This image can directly be flashed to an SD-Card or EMMC chip.
To find out which kernel device was assigned to your SD-Card or EMMC, run
sudo fdisk -l and look for the correct device.
Once you know the device, for example /dev/sdb, you can flash the image to it using dd.
zcat debian-pinephone-plasma-mobile-testing-arm64.img.gz | sudo dd status=progress of=/dev/mmcblk0
The flashing will take a lot of time depending on the speed of your storage device.
Alternative: If you plan to flash nightly builds often, and don’t need a local copy of the image, you can directly flash the image to your SD-Card using bmaptool:
sudo bmaptool copy https://archive.kaidan.im/debian-pm/images/pinephone/plasma-mobile/debian-pinephone-plasma-mobile-testing-arm64.img.gz --bmap https://archive.kaidan.im/debian-pm/images/pinephone/plasma-mobile/debian-pinephone-plasma-mobile-testing-arm64.img.bmap /dev/mmcblk0
If the plasmashell crashes at the first startup, it will not try to place the proper widgets again (taskpanel etc.), as a result you will only see the homescreen after the next reboot, missing some parts.
To workaround this,
- pinephone: switch the headphone killswitch to off, and connect your headphone serial debugging cable. Then use picocom to connect
sudo picocom /dev/ttyUSB0 -b 115200
- Halium devices: connect the USB cable and ssh into
You can then log in as
rm ~/.config/plasma-org.kde.plasma.phone-appletsrc ~/.config/plasmashellrc.