mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-05-30 00:20:08 +00:00
Code Issues Projects Releases Wiki Activity

ref-manual: document FIT_ADDRESS_CELLS

Browse Source 
(From yocto-docs rev: 81ee2e82a5bd0b7f1cb910bf266ceb808c05bba9)

Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
CC: Jamin Lin <jamin_lin@aspeedtech.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Michael Opdenacker
2023-05-04 19:29:23 +02:00
committed by Richard Purdie
parent 2347121381
commit ce7a814b3b
3 changed files with 33 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/migration-guides/release-notes-4.3.rst
+5
View File
@@ -26,6 +26,11 @@ New Features / Enhancements in 4.3
- wic Image Creator enhancements:
- FIT image related improvements:
- New :term:`FIT_ADDRESS_CELLS` variable allowing
to specify 64 bit addresses.
- SDK-related improvements:
- Testing:
documentation/ref-manual/classes.rst
+2 -1
View File
@@ -1590,7 +1590,8 @@ Only a single kernel can be added to the FIT image created by
:ref:`ref-classes-kernel-fitimage` and the kernel image in FIT is mandatory. The
address where the kernel image is to be loaded by U-Boot is
specified by :term:`UBOOT_LOADADDRESS` and the entrypoint by
:term:`UBOOT_ENTRYPOINT`.
:term:`UBOOT_ENTRYPOINT`. Setting :term:`FIT_ADDRESS_CELLS` to "2"
is necessary if such addresses are 64 bit ones.
Multiple device trees can be added to the FIT image created by
:ref:`ref-classes-kernel-fitimage` and the device tree is optional.
documentation/ref-manual/variables.rst
+26
View File
@@ -2898,6 +2898,26 @@ system and gives an overview of their function and contents.
For guidance on how to create your own file permissions settings
table file, examine the existing ``fs-perms.txt``.
:term:`FIT_ADDRESS_CELLS`
Specifies the value of the ``#address-cells`` value for the
description of the kernel FIT image.
The default value is set to "1" by the :ref:`ref-classes-kernel-fitimage`
class, which corresponds to 32 bit addresses.
For platforms who need to set 64 bit addresses in
:term:`UBOOT_LOADADDRESS` and :term:`UBOOT_ENTRYPOINT`, you need to
set this value to "2", as two 32 bit values (cells) will be needed
to represent such addresses.
Here is an example setting "0x400000000" as a load address::
FIT_ADDRESS_CELLS = "2"
UBOOT_LOADADDRESS= "0x04 0x00000000"
See `more details about #address-cells <https://elinux.org/Device_Tree_Usage#How_Addressing_Works>`__.
:term:`FIT_CONF_DEFAULT_DTB`
Specifies the default device tree binary (dtb) file for a fitImage when
multiple are provided.
@@ -9041,11 +9061,17 @@ system and gives an overview of their function and contents.
creation, the :term:`UBOOT_ENTRYPOINT` variable is passed as a
command-line parameter to the ``uboot-mkimage`` utility.
To pass a 64 bit address for FIT image creation, you will need to set
the :term:`FIT_ADDRESS_CELLS` variable too.
:term:`UBOOT_LOADADDRESS`
Specifies the load address for the U-Boot image. During U-Boot image
creation, the :term:`UBOOT_LOADADDRESS` variable is passed as a
command-line parameter to the ``uboot-mkimage`` utility.
To pass a 64 bit address for FIT image creation, you will need to set
the :term:`FIT_ADDRESS_CELLS` variable too.
:term:`UBOOT_LOCALVERSION`
Appends a string to the name of the local version of the U-Boot
image. For example, assuming the version of the U-Boot image built