Skip to content

Commit d57ffcb

Browse files
ArchUsr64praneethbajjuri
authored andcommitted
docs(linux): U-Boot: Falcon-Mode: use standard headers
Update the document to use standardized section headers as per sphinx documentation: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#sections Signed-off-by: Anshul Dalal <[email protected]>
1 parent d9a8874 commit d57ffcb

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

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

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
==================
1+
##################
22
U-Boot Falcon Mode
3-
==================
3+
##################
44

55
U-Boot's falcon mode on |__PART_FAMILY_DEVICE_NAMES__| bypasses the A-core SPL
66
and U-Boot stage, which allows for booting straight to Linux kernel after OP-TEE
@@ -23,28 +23,28 @@ enabled before :ref:`building the SDK <building-the-sdk-with-yocto>` as follows:
2323
$ # build the SDK
2424
$ MACHINE=<machine> bitbake -k tisdk-default-image
2525
26-
-------------------------------------
26+
*************************************
2727
Changes made by *ti-falcon* override:
28-
-------------------------------------
28+
*************************************
2929

3030
ATF:
31-
----
31+
====
3232

3333
To meet the 2MiB alignment requirement for the Linux kernel's load address,
3434
the ``K3_HW_CONFIG_BASE`` *(kernel address)* is modified to ``0x82000000``
3535
and ``PRELOADED_BL33_BASE`` *(DTB address)* is modified from the K3 default to
3636
``0x88000000``.
3737

3838
TI-SPL:
39-
-------
39+
=======
4040

4141
Falcon mode makes use of a cut down variant of the tispl binary called
4242
``tifalcon.bin`` with the Cortex-A SPL and it's corresponding DTB removed.
4343
This file is deployed to the boot directory inside rootfs so it can be picked by
4444
the R5 SPL at boot time.
4545

4646
R5 SPL:
47-
-------
47+
=======
4848

4949
The R5 SPL is used for loading the kernel ``fitImage`` and ``tifalcon.bin``
5050
file, though the ``fitImage`` for falcon boot is signed by using an x509
@@ -57,21 +57,21 @@ This support depends on the U-Boot's ``k3_r5_falcon.config`` fragment, which is
5757
built alongside the standard R5 defconfig when ``ti-falcon`` is enabled.
5858

5959
fitImage:
60-
---------
60+
=========
6161

6262
The resulting ``fitImage`` file in the boot directory of rootfs is produced
6363
with the constituent binaries pre-signed with x509 certificates. This file is
6464
authenticated from TIFS at boot time, which allows for a lower boot time than
6565
authenticating on the R5 core.
6666

67-
-------------------
67+
*******************
6868
Extra Configuration
69-
-------------------
69+
*******************
7070

7171
.. ifconfig:: CONFIG_part_variant not in ('AM62AX')
7272

7373
OSPI boot:
74-
----------
74+
==========
7575

7676
For OSPI boot, the ``tiboot3.bin`` and ``tifalcon.bin`` files should be
7777
flashed to the same addresses in flash as regular boot flow but the DTB and
@@ -90,7 +90,7 @@ Extra Configuration
9090
=> sf update $loadaddr 0x80000 $filesize
9191
9292
eMMC Boot:
93-
----------
93+
==========
9494

9595
In eMMC boot mode, the ``tiboot3.bin`` file should be flashed to the hardware
9696
boot partition whereas ``tifalcon.bin`` and the ``fitImage`` are read from
@@ -111,7 +111,7 @@ For more information check: :ref:`How to flash eMMC and boot with eMMC Boot
111111
<how-to-emmc-boot>`.
112112

113113
Custom fitImage creation:
114-
-------------------------
114+
=========================
115115

116116
Clone the `core-secdev-k3 source <https://git.ti.com/cgit/security-development-tools/core-secdev-k3>`__:
117117

@@ -174,9 +174,9 @@ Sign the kernel and dtb with ``secure-binary-image.sh`` and create the
174174
$ ./scripts/secure-binary-image.sh falcon.dtb falcon.dtb.sec
175175
$ mkimage -f fitImage.its fitImage
176176
177-
----------------------
177+
**********************
178178
Boot time comparisons:
179-
----------------------
179+
**********************
180180

181181
Removing A-core SPL and U-Boot from the boot process leads to ~60% reduction in
182182
time to kernel. Saving about 1-2 seconds during boot depending on the platform.

0 commit comments

Comments
 (0)