Help¶

If the application is built for chain-loading by a bootloader this variable is required to be set to value that leaves sufficient space between the beginning of the image and the start of the .text section to store an image header or any other metadata. In the particular case of the MCUboot bootloader this reserves enough space to store the image header, which should also meet vector table alignment requirements on most ARM targets, although some targets may require smaller or larger values.

Defaults¶

0x2000 if (CODE_HYPERFLASH || CODE_QSPI) && BOARD_MIMXRT1050_EVK
0x30 if BOARD_ARDUINO_101
0x30 if BOARD_TINYTILE
0x800 if XIP && SOC_CC3220SF && SOC_SERIES_CC32XX
0x0 if !XIP && SOC_CC3220SF && SOC_SERIES_CC32XX
0x200 if BOOTLOADER_MCUBOOT
0

Kconfig definitions¶

At boards/arm/mimxrt1050_evk/Kconfig.defconfig:42

Included via Kconfig:10 → Kconfig.zephyr:19

Menu path: (top menu)

config TEXT_SECTION_OFFSET
    hex
    default 0x2000 if (CODE_HYPERFLASH || CODE_QSPI) && BOARD_MIMXRT1050_EVK
    depends on (CODE_HYPERFLASH || CODE_QSPI) && BOARD_MIMXRT1050_EVK

At boards/x86/arduino_101/Kconfig.defconfig:7

Included via Kconfig:10 → Kconfig.zephyr:19

Menu path: (top menu)

config TEXT_SECTION_OFFSET
    hex
    default 0x30 if BOARD_ARDUINO_101
    depends on BOARD_ARDUINO_101

At boards/x86/tinytile/Kconfig.defconfig:7

Included via Kconfig:10 → Kconfig.zephyr:19

Menu path: (top menu)

config TEXT_SECTION_OFFSET
    hex
    default 0x30 if BOARD_TINYTILE
    depends on BOARD_TINYTILE

At arch/arm/soc/ti_simplelink/cc32xx/Kconfig.defconfig.cc3220sf:20

Included via Kconfig:10 → Kconfig.zephyr:20 → arch/arm/soc/ti_simplelink/Kconfig.defconfig:1 → arch/arm/soc/ti_simplelink/cc32xx/Kconfig.defconfig.series:6

Menu path: (top menu)

config TEXT_SECTION_OFFSET
    hex
    default 0x800 if XIP && SOC_CC3220SF && SOC_SERIES_CC32XX
    default 0x0 if !XIP && SOC_CC3220SF && SOC_SERIES_CC32XX
    depends on SOC_CC3220SF && SOC_SERIES_CC32XX

At misc/Kconfig:44

Included via Kconfig:10 → Kconfig.zephyr:31

Menu path: (top menu) → Build and Link Features → Linker Options

config TEXT_SECTION_OFFSET
    hex
    prompt "TEXT section offset"
    default 0x200 if BOOTLOADER_MCUBOOT
    default 0
    help
      If the application is built for chain-loading by a bootloader this
      variable is required to be set to value that leaves sufficient
      space between the beginning of the image and the start of the .text
      section to store an image header or any other metadata.
      In the particular case of the MCUboot bootloader this reserves enough
      space to store the image header, which should also meet vector table
      alignment requirements on most ARM targets, although some targets
      may require smaller or larger values.

(Definitions include propagated dependencies, including from if’s and menus.)