Jump to content

lk2nd/lk1st

From postmarketOS Wiki
Revision as of 02:31, 17 December 2022 by WonderfulShrineMaidenOfParadise (talk | contribs) (See also: msm8916 and msm8939)


lk2nd is a bootloader for devices based on Qualcomm system-on-chips (SoCs) and simplifies booting standard operating systems by providing unified boot and flashing interface.

Features

lk2nd fastboot screen example

lk2nd provides automatic device and hardware detection, additional bootloader features like file system boot and Dual Booting (booting from SD card) and additional firmware features include booting secondary CPU cores and various of debugging commands that allow better understanding of the hardware for research and development purposes.

Supported SoCs

  • lk2nd-msm8916: APQ8016, MSM8216, MSM8916, MSM8929, MSM8939
  • lk2nd-msm8974: MSM8974
  • lk2nd-msm8226: APQ8026, MSM8226, MSM8926

Usage

lk2nd provides the standard Android fastboot protocol for flashing/booting Android boot images.

Press Volume Down while booting to enter Fastboot mode. Press Volume Up while booting to boot into Recovery mode.

Note: If your stock bootloader uses the same key combinations, you need to wait a bit before pressing the volume keys. Usually, waiting until the screen turns on and/or the device vibrates should be enough to make the stock bootloader ignore the keys.

fastboot flash lk2nd lk2nd.img can be used to update lk2nd directly from its fastboot interface.

Note: fastboot flash boot boot.img will flash the actual boot image with 512 KiB offset into the boot partition. This is done to avoid replacing lk2nd (since it is also booted from the boot partition).

Other fastboot commands work normally.

Troubleshooting

If the device shows up via fastboot you can get a log file from lk2nd using fastboot oem lk_log && fastboot get_staged <output-file>, where <output-file> is either some text file to write to (e.g. output.txt) or /dev/stdout to write the log to standard output.

See also