Skip to content

Commit 1332591

Browse files
ArchUsr64StaticRocket
authored andcommitted
docs(linux): U-Boot: Falcon-Mode: add non-yocto users section
Falcon mode is the U-Boot feature and not specific to our yocto distro. Therefore document the usage of the feature for non-yocto users who would have to run the commands implemented by `ti-falcon` override manually. Signed-off-by: Anshul Dalal <[email protected]>
1 parent c773978 commit 1332591

File tree

1 file changed

+53
-0
lines changed

1 file changed

+53
-0
lines changed

source/linux/Foundational_Components/U-Boot/UG-Falcon-Mode.rst

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -123,6 +123,8 @@ partition and write ``tiboot3.bin`` to the correct offset.
123123
For more information check: :ref:`How to flash eMMC and boot with eMMC Boot
124124
<how-to-emmc-boot>`.
125125

126+
.. _u-boot_falcon_mode_fitImage_creation:
127+
126128
Custom fitImage creation:
127129
=========================
128130

@@ -188,6 +190,57 @@ Sign the kernel and dtb with ``secure-binary-image.sh`` and create the
188190
$ ./scripts/secure-binary-image.sh falcon.dtb falcon.dtb.sec
189191
$ mkimage -f fitImage.its fitImage
190192
193+
****************
194+
Non-Yocto Users:
195+
****************
196+
197+
Following are the steps to build ``tiboot3.bin``, ``tifalcon.bin`` and the
198+
``fitImage`` required for falcon mode:
199+
200+
#. For :ref:`ATF build <foundational-components-atf>`, use the following
201+
arguments to update the ATF's jump address for the kernel and the
202+
device-tree: ``PRELOADED_BL33_BASE=0x82000000 K3_HW_CONFIG_BASE=0x88000000``.
203+
204+
#. For :ref:`R5 U-Boot build <Build-U-Boot-label>`, use the
205+
``k3_r5_falcon.config`` fragment to enable flacon support at the R5 SPL
206+
stage.
207+
208+
#. Refer to the :ref:`fitImage creation step
209+
<u-boot_falcon_mode_fitImage_creation>` above for preparing a bootable
210+
``fitImage`` with an appropriate kernel and DTB.
211+
212+
#. Copy the files generated to correct path on SD/eMMC as in the table below:
213+
214+
.. list-table::
215+
:widths: 8 8 8 25
216+
:header-rows: 1
217+
218+
* - File
219+
- Destination path on SD/eMMC
220+
- Partition
221+
- Description
222+
223+
* - ``tiboot3.bin``
224+
- ``/tiboot3.bin``
225+
- boot (fat)
226+
- R5 SPL with falcon support
227+
228+
* - ``tifalcon.bin``
229+
- ``/boot/tifalcon.bin``
230+
- rootfs (ext4)
231+
- tispl binary without SPL for the A core and DTB
232+
233+
* - ``fitImage``
234+
- ``/boot/fitImage``
235+
- rootfs (ext4)
236+
- kernel and dtb fitImage with pre-signed binaries
237+
238+
.. note::
239+
240+
The ``tifalcon.bin`` binary is generated by default for all falcon
241+
supported platforms at the A-Core U-Boot build step and can be found
242+
alongside the existing ``tispl.bin`` file in U-Boot build's output directory.
243+
191244
**********************
192245
Boot time comparisons:
193246
**********************

0 commit comments

Comments
 (0)