| Angus Ainslie | 3f8667c | 2022-08-25 06:46:02 -0700 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0+ |
| 2 | |
| 3 | Librem5 |
| Heinrich Schuchardt | b72160b | 2023-10-28 11:59:32 +0200 | [diff] [blame] | 4 | ======= |
| Angus Ainslie | 3f8667c | 2022-08-25 06:46:02 -0700 | [diff] [blame] | 5 | |
| 6 | U-Boot for the Purism Librem5 phone |
| 7 | |
| 8 | Quick Start |
| 9 | ----------- |
| 10 | |
| 11 | - Build the ARM Trusted firmware binary |
| 12 | - Get ddr and hdmi firmware |
| 13 | - Build U-Boot |
| 14 | |
| 15 | Get and Build the ARM Trusted firmware |
| 16 | -------------------------------------- |
| 17 | |
| 18 | Note: srctree is U-Boot source directory |
| 19 | Get ATF from: https://source.puri.sm/Librem5/arm-trusted-firmware |
| 20 | branch: librem5 |
| 21 | |
| 22 | .. code-block:: bash |
| 23 | |
| 24 | $ make PLAT=imx8mq CROSS_COMPILE=aarch64-linux-gnu- bl31 |
| 25 | $ cp build/imx8mq/release/bl31.bin $(builddir) |
| 26 | |
| 27 | Get the ddr and display port firmware |
| 28 | ------------------------------------- |
| 29 | |
| 30 | .. code-block:: bash |
| 31 | |
| 32 | $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.15.bin |
| 33 | $ chmod +x firmware-imx-8.15.bin |
| 34 | $ ./firmware-imx-8.15.bin |
| 35 | $ cp firmware-imx-8.15/firmware/hdmi/cadence/signed_dp_imx8m.bin $(builddir) |
| 36 | $ cp firmware-imx-8.15/firmware/ddr/synopsys/lpddr4*.bin $(builddir) |
| 37 | |
| 38 | Build U-Boot |
| 39 | ------------ |
| 40 | |
| 41 | .. code-block:: bash |
| 42 | |
| 43 | $ export CROSS_COMPILE=aarch64-linux-gnu- |
| 44 | $ make librem5_defconfig |
| 45 | $ make ARCH=arm |
| 46 | |
| 47 | Burn the flash.bin |
| 48 | ------------------ |
| 49 | |
| 50 | Use uuu to burn flash.bin. Power on the phone while holding vol+ to get it |
| 51 | into uuu mode. |
| 52 | |
| 53 | .. code-block:: bash |
| 54 | |
| 55 | $ git clone https://source.puri.sm/Librem5/librem5-devkit-tools.git |
| 56 | $ cd librem5-devkit-tools |
| 57 | $ cp $(builddir)/flash.bin files/u-boot-librem5.imx |
| 58 | $ uuu uuu_scripts/u-boot_flash_librem5.lst |
| 59 | |
| 60 | Reboot the phone. |