Skip to content

Commit d9a8874

Browse files
ArchUsr64praneethbajjuri
authored andcommitted
docs(linux): U-Boot: Falcon-Mode: fix vale warnings
Fix some minor issues in the docs reported by vale during CI tests. Signed-off-by: Anshul Dalal <[email protected]>
1 parent eb2c099 commit d9a8874

File tree

1 file changed

+20
-20
lines changed

1 file changed

+20
-20
lines changed

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

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -3,16 +3,16 @@ U-Boot Falcon Mode
33
==================
44

55
U-Boot's falcon mode on |__PART_FAMILY_DEVICE_NAMES__| bypasses the A-core SPL
6-
and U-Boot stage, which allows for booting straight to linux kernel after OP-TEE
6+
and U-Boot stage, which allows for booting straight to Linux kernel after OP-TEE
77
and ATF.
88

99
**Normal boot flow:**
1010

11-
* R5 SPL -> ATF -> OP-TEE -> *Cortex-A SPL* -> *U-Boot* -> Kernel
11+
* R5 SPL -> ATF -> OP-TEE -> *Cortex-A SPL* -> *U-Boot* -> Linux
1212

1313
**With falcon mode:**
1414

15-
* R5 SPL -> ATF -> OP-TEE -> Kernel
15+
* R5 SPL -> ATF -> OP-TEE -> Linux
1616

1717
Falcon boot support is added by the ``ti-falcon`` yocto override which can be
1818
enabled before :ref:`building the SDK <building-the-sdk-with-yocto>` as follows:
@@ -30,28 +30,28 @@ Changes made by *ti-falcon* override:
3030
ATF:
3131
----
3232

33-
To meet the 2MiB alignment requirement for the linux kernel's load address,
34-
the ``K3_HW_CONFIG_BASE`` *(kernel address)* and ``PRELOADED_BL33_BASE``
35-
*(DTB address)* for ATF are modified from K3 defaults to ``0x82000000`` and
36-
``0x88000000`` respectively.
33+
To meet the 2MiB alignment requirement for the Linux kernel's load address,
34+
the ``K3_HW_CONFIG_BASE`` *(kernel address)* is modified to ``0x82000000``
35+
and ``PRELOADED_BL33_BASE`` *(DTB address)* is modified from the K3 default to
36+
``0x88000000``.
3737

38-
TISPL:
39-
------
38+
TI-SPL:
39+
-------
4040

4141
Falcon mode makes use of a cut down variant of the tispl binary called
42-
``tifalcon.bin`` with the Cortex-A SPL and its corresponding DTB removed.
42+
``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:
4747
-------
4848

49-
The R5 SPL is used for loading the kernel ``fitImage`` as well as the
50-
``tifalcon.bin`` file, though the ``fitImage`` for falcon boot is signed
51-
using an x509 certificate with TIFS keys instead of making use of signature
52-
nodes and keys present in the DT. This allows for faster authentication since
53-
TIFS uses the security accelerator for authentication which is much faster than
54-
doing the same on R5 core.
49+
The R5 SPL is used for loading the kernel ``fitImage`` and ``tifalcon.bin``
50+
file, though the ``fitImage`` for falcon boot is signed by using an x509
51+
certificate with TIFS keys instead of making use of signature nodes and keys
52+
present in the DT. This allows for faster authentication since TIFS uses the
53+
security accelerator for authentication, which is much faster than doing the
54+
same on R5 core.
5555

5656
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.
@@ -61,7 +61,7 @@ fitImage:
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
64-
authenticated from TIFS at boot time which allows for a lower boot time than
64+
authenticated from TIFS at boot time, which allows for a lower boot time than
6565
authenticating on the R5 core.
6666

6767
-------------------
@@ -157,15 +157,15 @@ core-secdev-k3 source:
157157
configurations {
158158
default = "conf-falcon";
159159
conf-falcon {
160-
description = "Presigned Kernel and DTB";
160+
description = "Presigned Linux kernel and DTB";
161161
kernel = "kernel-1";
162162
fdt = "falcon.dtb";
163163
};
164164
};
165165
};
166166
167-
Sign the kernel and dtb using ``secure-binary-image.sh`` and create the
168-
``fitImage`` using mkimage:
167+
Sign the kernel and dtb with ``secure-binary-image.sh`` and create the
168+
``fitImage`` by using mkimage:
169169

170170
.. code-block:: console
171171

0 commit comments

Comments
 (0)