[PATCH v3 19/19] doc: board: ti: Update documentation for binman flow
Neha Malcom Francis
n-francis at ti.com
Tue Apr 25 08:23:49 CEST 2023
Hi Simon
On 25/04/23 01:12, Simon Glass wrote:
> Hi Neha,
>
> On Fri, 21 Apr 2023 at 06:33, Neha Malcom Francis <n-francis at ti.com> wrote:
>>
>> Earlier documentation specified builds for generating bootloader images
>> using an external TI repository k3-image-gen and core-secdev-k3. Modify
>> this to using the binman flow so that user understands how to build the
>> final boot images.
>>
>> Signed-off-by: Neha Malcom Francis <n-francis at ti.com>
>> ---
>> doc/board/ti/am62x_sk.rst | 20 ++++--------
>> doc/board/ti/j721e_evm.rst | 37 ++++++++-------------
>> doc/board/ti/k3.rst | 67 ++++++++++----------------------------
>> 3 files changed, 36 insertions(+), 88 deletions(-)
>
> Reviewed-by: Simon Glass <sjg at chromium.org>
>
>>
>> diff --git a/doc/board/ti/am62x_sk.rst b/doc/board/ti/am62x_sk.rst
>> index b1b7d99bef..f5e0774899 100644
>> --- a/doc/board/ti/am62x_sk.rst
>> +++ b/doc/board/ti/am62x_sk.rst
>> @@ -115,23 +115,19 @@ Below is the pictorial representation of boot flow:
>>
>> Sources:
>> --------
>> -1. SYSFW:
>> - Tree: git://git.ti.com/k3-image-gen/k3-image-gen.git
>> - Branch: master
>> -
>> -2. ATF:
>> +1. ATF:
>> Tree: https://github.com/ARM-software/arm-trusted-firmware.git
>> Branch: master
>>
>> -3. OPTEE:
>> +2. OPTEE:
>> Tree: https://github.com/OP-TEE/optee_os.git
>> Branch: master
>>
>> -4. U-Boot:
>> +3. U-Boot:
>> Tree: https://source.denx.de/u-boot/u-boot
>> Branch: master
>>
>> -5. TI Linux Firmware:
>> +4. TI Linux Firmware:
>> Tree: git://git.ti.com/processor-firmware/ti-linux-firmware.git
>> Branch: ti-linux-firmware
>>
>> @@ -156,18 +152,14 @@ Build procedure:
>> .. code-block:: text
>>
>> $ make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabihf- am62x_evm_r5_defconfig O=/tmp/r5
>> - $ make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabihf- O=/tmp/r5
>> - $ cd <k3-image-gen>
>> - $ make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabihf- SOC=am62x SBL=/tmp/r5/spl/u-boot-spl.bin SYSFW_PATH=<path to ti-linux-firmware>/ti-sysfw/ti-fs-firmware-am62x-gp.bin
>> -
>> -Use the tiboot3.bin generated from last command
>> + $ make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabihf- O=/tmp/r5 BINMAN_INDIRS=<path/to/ti-linux-firmware>
>>
>> * 3.2 A53:
>>
>> .. code-block:: text
>>
>> $ make ARCH=arm CROSS_COMPILE=aarch64-none-linux-gnu- am62x_evm_a53_defconfig O=/tmp/a53
>> - $ make ARCH=arm CROSS_COMPILE=aarch64-none-linux-gnu- ATF=<path to ATF dir>/build/k3/lite/release/bl31.bin TEE=<path to OPTEE OS dir>/out/arm-plat-k3/core/tee-pager_v2.bin DM=<path to ti-linux-firmware>/ti-dm/am62xx/ipc_echo_testb_mcu1_0_release_strip.xer5f O=/tmp/a53
>> + $ make ARCH=arm CROSS_COMPILE=aarch64-none-linux-gnu- BL31=<path to ATF dir>/build/k3/lite/release/bl31.bin TEE=<path to OPTEE OS dir>/out/arm-plat-k3/core/tee-pager_v2.bin BINMAN_INDIRS=<path/to/ti-linux-firmware>
>>
>> Target Images
>> --------------
>> diff --git a/doc/board/ti/j721e_evm.rst b/doc/board/ti/j721e_evm.rst
>> index e898601c41..c90e2b8279 100644
>> --- a/doc/board/ti/j721e_evm.rst
>> +++ b/doc/board/ti/j721e_evm.rst
>> @@ -130,67 +130,56 @@ support. Below is the pictorial representation of boot flow:
>>
>> Sources:
>> --------
>> -1. SYSFW:
>> - Tree: git://git.ti.com/k3-image-gen/k3-image-gen.git
>> - Branch: master
>> -
>> -2. ATF:
>> +1. ATF:
>> Tree: https://github.com/ARM-software/arm-trusted-firmware.git
>> Branch: master
>>
>> -3. OPTEE:
>> +2. OPTEE:
>> Tree: https://github.com/OP-TEE/optee_os.git
>> Branch: master
>>
>> -4. DM Firmware:
>> - Tree: git://git.ti.com/processor-firmware/ti-linux-firmware.git
>> - Branch: ti-linux-firmware
>> -
>> -5. U-Boot:
>> +3. U-Boot:
>> Tree: https://source.denx.de/u-boot/u-boot
>> Branch: master
>>
>> +4. TI Linux Firmware:
>> + Tree: git://git.ti.com/processor-firmware/ti-linux-firmware.git
>> + Branch: ti-linux-firmware
>> +
>> Build procedure:
>> ----------------
>> -1. SYSFW:
>> -
>> -.. code-block:: bash
>> -
>> - make CROSS_COMPILE=arm-linux-gnueabihf- SOC=j721e
>> -
>> -2. ATF:
>> +1. ATF:
>>
>> .. code-block:: bash
>>
>> make CROSS_COMPILE=aarch64-linux-gnu- ARCH=aarch64 PLAT=k3 TARGET_BOARD=generic SPD=opteed
>>
>> -3. OPTEE:
>> +2. OPTEE:
>>
>> .. code-block:: bash
>>
>> make PLATFORM=k3-j721e CFG_ARM64_core=y
>>
>> -4. U-Boot:
>> +3. U-Boot:
>>
>> * 4.1 R5:
>>
>> .. code-block:: bash
>>
>> make CROSS_COMPILE=arm-linux-gnueabihf- j721e_evm_r5_defconfig O=build/r5
>> - make CROSS_COMPILE=arm-linux-gnueabihf- O=build/r5
>> + make CROSS_COMPILE=arm-linux-gnueabihf- O=build/r5 BINMAN_INDIRS=<path/to/ti-linux-firmware>
>>
>> * 4.2 A72:
>>
>> .. code-block:: bash
>>
>> make CROSS_COMPILE=aarch64-linux-gnu- j721e_evm_a72_defconfig O=build/a72
>> - make CROSS_COMPILE=aarch64-linux-gnu- ATF=<ATF dir>/build/k3/generic/release/bl31.bin TEE=<OPTEE OS dir>/out/arm-plat-k3/core/tee-pager_v2.bin DM=<DM firmware>/ti-dm/j721e/ipc_echo_testb_mcu1_0_release_strip.xer5f O=build/a72
>> + make CROSS_COMPILE=aarch64-linux-gnu- BL31=<ATF dir>/build/k3/generic/release/bl31.bin TEE=<OPTEE OS dir>/out/arm-plat-k3/core/tee-pager_v2.bin BINMAN_INDIRS=<path/to/ti-linux-firmware>
>
> Is there an 'O=build/a72' missing there?
>
Yes, thanks for catching that!
> You can combine these as well, by using 'j721e_evm_a72_defconfig all'
> to both configure and build.
>
> Also it might be nice to keep the line length shorter if you can.
> [..]
>
Thanks I will do that.
> Regards,
> Simon
--
Thanking You
Neha Malcom Francis
More information about the U-Boot
mailing list