Skip to content

Commit acfa2f5

Browse files
ArchUsr64cshilwant
authored andcommitted
feat(Falcon-Mode): update to use upstream U-Boot docs
With falcon mode support from the R5 SPL documented in upstream U-Boot at commit 489ec1ee14a8 ("doc: ti: document R5 falcon mode for AM62 platforms")[1]. Some sections of the SDK docs can be replaced with a hyperlink to the upstream U-Boot documentation. [1]: u-boot/u-boot@489ec1e Signed-off-by: Anshul Dalal <[email protected]>
1 parent fa552f9 commit acfa2f5

File tree

1 file changed

+16
-98
lines changed

1 file changed

+16
-98
lines changed

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

Lines changed: 16 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -150,118 +150,36 @@ For more information check: :ref:`How to flash eMMC and boot with eMMC Boot
150150
Custom fitImage creation:
151151
=========================
152152

153-
Clone the `core-secdev-k3 source <https://git.ti.com/cgit/security-development-tools/core-secdev-k3>`__:
153+
The following steps show how to create a falcon compatible :file:`fitImage`:
154154

155-
.. code-block:: console
156-
157-
$ git clone https://git.ti.com/cgit/security-development-tools/core-secdev-k3
158-
159-
Copy the required kernel image renamed to :file:`Image` and the device-tree
160-
renamed to :file:`falcon.dtb` inside the `core-secdev-k3` source directory.
161-
162-
Copy the following contents to a file named :file:`fitImage.its` inside
163-
core-secdev-k3 source:
164-
165-
.. code-block:: dts
166-
167-
/dts-v1/;
168-
169-
/ {
170-
description = "Kernel fitImage for falcon mode";
171-
#address-cells = <1>;
172-
173-
images {
174-
kernel-1 {
175-
description = "Linux kernel";
176-
data = /incbin/("Image.sec");
177-
type = "kernel";
178-
arch = "arm64";
179-
os = "linux";
180-
compression = "none";
181-
load = <0x82000000>;
182-
entry = <0x82000000>;
183-
};
184-
falcon.dtb {
185-
description = "Flattened Device Tree blob";
186-
data = /incbin/("falcon.dtb.sec");
187-
type = "flat_dt";
188-
arch = "arm64";
189-
compression = "none";
190-
load = <0x88000000>;
191-
entry = <0x88000000>;
192-
};
193-
};
194-
195-
configurations {
196-
default = "conf-falcon";
197-
conf-falcon {
198-
description = "Presigned Linux kernel and DTB";
199-
kernel = "kernel-1";
200-
fdt = "falcon.dtb";
201-
};
202-
};
203-
};
204-
205-
Sign the kernel and device-tree with :file:`secure-binary-image.sh` and create the
206-
:file:`fitImage` by using ``mkimage``:
207-
208-
.. code-block:: console
209-
210-
$ # inside core-secdev-k3 source
211-
$ ./scripts/secure-binary-image.sh Image Image.sec
212-
$ ./scripts/secure-binary-image.sh falcon.dtb falcon.dtb.sec
213-
$ mkimage -f fitImage.its fitImage
155+
.. ifconfig:: CONFIG_part_variant in ('AM62AX')
214156

215-
****************
216-
Non-Yocto Users:
217-
****************
157+
* `fitImage Creation - U-Boot documentaiton <https://docs.u-boot.org/en/latest/board/ti/am62ax_sk.html#fitimage>`__
218158

219-
Following are the steps to build :file:`tiboot3.bin`, :file:`tifalcon.bin` and the
220-
:file:`fitImage` required for falcon mode:
159+
.. ifconfig:: CONFIG_part_variant in ('AM62PX')
221160

222-
#. For :ref:`ATF build <foundational-components-atf>`, use the following
223-
arguments to update the ATF's jump address for the kernel and the
224-
device-tree: ``PRELOADED_BL33_BASE=0x82000000 K3_HW_CONFIG_BASE=0x88000000``.
161+
* `fitImage Creation - U-Boot documentaiton <https://docs.u-boot.org/en/latest/board/ti/am62px_sk.html#fitimage>`__
225162

226-
#. For :ref:`R5 U-Boot build <Build-U-Boot-label>`, use the
227-
:file:`k3_r5_falcon.config` fragment to enable flacon support at the R5 SPL
228-
stage.
163+
.. ifconfig:: CONFIG_part_variant in ('AM62X')
229164

230-
#. Refer to the :ref:`fitImage creation step
231-
<u-boot_falcon_mode_fitImage_creation>` above for preparing a bootable
232-
:file:`fitImage` with an appropriate kernel and device-tree.
165+
* `fitImage Creation - U-Boot documentaiton <https://docs.u-boot.org/en/latest/board/ti/am62x_sk.html#fitimage>`__
233166

234-
#. Copy the files generated to correct path on SD/eMMC as in the table below:
167+
Non-Yocto Users:
168+
================
235169

236-
.. list-table::
237-
:widths: 8 8 8 25
238-
:header-rows: 1
170+
The following steps show how to enable falcon mode from the R5 SPL standalone:
239171

240-
* - File
241-
- Destination path on SD/eMMC
242-
- Partition
243-
- Description
172+
.. ifconfig:: CONFIG_part_variant in ('AM62AX')
244173

245-
* - :file:`tiboot3.bin`
246-
- :file:`/tiboot3.bin`
247-
- boot (fat)
248-
- R5 SPL with falcon support
174+
* `Falcon Mode - U-Boot documentaiton <https://docs.u-boot.org/en/latest/board/ti/am62ax_sk.html#falcon-mode>`__
249175

250-
* - :file:`tifalcon.bin`
251-
- :file:`/boot/tifalcon.bin`
252-
- root filesystem (ext4)
253-
- tispl binary without SPL for the A core and device-tree
176+
.. ifconfig:: CONFIG_part_variant in ('AM62PX')
254177

255-
* - :file:`fitImage`
256-
- :file:`/boot/fitImage`
257-
- root filesystem (ext4)
258-
- :file:`fitImage` with pre-signed kernel and device-tree
178+
* `Falcon Mode - U-Boot documentaiton <https://docs.u-boot.org/en/latest/board/ti/am62px_sk.html#falcon-mode>`__
259179

260-
.. note::
180+
.. ifconfig:: CONFIG_part_variant in ('AM62X')
261181

262-
The :file:`tifalcon.bin` binary is generated by default for all falcon
263-
supported platforms at the A-Core U-Boot build step and can be found
264-
alongside the existing :file:`tispl.bin` file in U-Boot build's output directory.
182+
* `Falcon Mode - U-Boot documentaiton <https://docs.u-boot.org/en/latest/board/ti/am62x_sk.html#falcon-mode>`__
265183

266184
**********************
267185
Boot time comparisons:

0 commit comments

Comments
 (0)