== Installation ==
As some features are still in development for this device, the kernel needs to be built from source using envkernel. To do this, you'll need a copy of the [https://gitlab.com/postmarketOS/pmbootstrap/ pmbootstrap tree], and the [https://github.com/msm8916-mainline/linux latest kernel tree] for the device. Once you have those, and you have run <code>pmbootstrap init</code>, run the following commands: <source> cd /path/to/linux/kernel source /path/to/pmbootstrap/helpers/envkernel.sh make msm8916_defconfig pmos.config make -j<cores> pmbootstrap build --envkernel linux-postmarketos-qcom-msm8916 </source> You will also need to install the [https://github.com/msm8916-mainline/lk2nd/releases/latest lk2nd bootloader], as it is required to handle some quirks
with msm8916 devices on mainline kernels. Flash the <code>lk2nd.img</code> image to the boot partition with <code>fastboot flash boot /path/to/lk2nd.img</code>. lk2nd
also provides a fastboot interface that allows for flashing kernels without overwriting lk2nd itself. To enter it, power on the device, then hold down Vol Down as soon
After that, proceed with [[Installation_guide#Installation_and_flashing|installation]] as usual, using lk2nd's fastboot interface to flash the kernel and rootfs.
=== Modem ===
Modem is currently working on harpia, but as of writing, a few things are still waiting to be merged into pmaports. See [https://gitlab.com/postmarketOS/pmaports/-/merge_requests/907 pmaports!907]
and [https://gitlab.com/postmarketOS/pmaports/-/merge_requests/958 pmaports!958] for more information. This section will be removed once the required changes are merged into pmaports.
'''Following these directions is not recommended until the required changes are in pmaports.''' If you would like to get modem working now, proceed with the above install guide, with the following
* Use the <code>harpia-modem</code> branch of [https://gitlab.com/srxl/pmaports/-/tree/harpia-modem this] fork of pmaports:
git remote add harpia-modem https://gitlab.com/srxl/pmaports.git
git fetch harpia-modem
git checkout harpia-modem
* lk2nd needs to be built from source, as there are some required changes that have not been added to a release yet. The [https://github.com/msm8916-mainline/lk2nd#building README] on the lk2nd repo has instructions on how to do this.
== Usage ==