Skip to content

Commit 074c500

Browse files
committed
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 <anshuld@ti.com>
1 parent dbb6bfc commit 074c500

1 file changed

Lines changed: 52 additions & 0 deletions

File tree

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

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -123,6 +123,7 @@ 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:
126127
Custom fitImage creation:
127128
=========================
128129

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

0 commit comments

Comments
 (0)