patrick/zephyr
1
0
Fork 0
Code Issues Pull requests Actions 8 Packages Projects Releases Wiki Activity
zephyr/Kconfig.zephyr

867 lines
28 KiB
Plaintext
Raw Normal View History

kconfig: Clean up header comments and make them consistent Use this short header style in all Kconfig files: # <description> # <copyright> # <license> ... Also change all <description>s from # Kconfig[.extension] - Foo-related options to just # Foo-related options It's clear enough that it's about Kconfig. The <description> cleanup was done with this command, along with some manual cleanup (big letter at the start, etc.) git ls-files '*Kconfig*' | \ xargs sed -i -E '1 s/#\s*Kconfig[\w.-]*\s*-\s*/# /' Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-11-01 13:45:29 +01:00
# General configuration options
Split main Kconfig to allow application specific Kconfig This will allow adding an application level Kconfig, for example mainmenu "Zephyr Application" config ZEPHYR_BASE string option env="ZEPHYR_BASE" config APPLICATION_BASE string option env="PROJECT_BASE" source "$ZEPHYR_BASE/Kconfig.zephyr" config TESTME bool "Test me" default y config BLAH bool "blah" default y source "$APPLICATION_BASE/src/Kconfig" In the application file, add the following for example: KBUILD_KCONFIG := $(PWD)/Kconfig export KBUILD_KCONFIG Change-Id: I7b7a6daace5f589ddadab0f0de54b5adc1b8dc86 Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2015-08-22 20:43:07 +02:00
# Copyright (c) 2014-2015 Wind River Systems, Inc.
kconfig: untangle ordering and dependencies There are two major issues with the kconfig: () Some of the config options have incorrect dependencies inside help under menuconfig. For example, CONFIG_GPIO depends on BOARD_GALILEO. () Since the SoC and board specific kconfig files are parsed first, the help screen would say, for example, CONFIG_SPI is defined at arch/arm/soc/fsl_frdm_k64f/Kconfig. This is incorrect because the actual config is defined in drivers/spi/Kconfig. These cause great confusion to users of menuconfig/xconfig. To fix these, the SoC and board defaults are now to be parsed last. Note that the position swapping of defaults in this patch is due to the fact the the default parsed last will be used. And, spi_test is broken due to the fact that it requires CONFIG_SPI_INTEL_PORT_1, but never enables it anywhere. This is bypassed for now. Origin: refactored and edited from existing files Change-Id: I2a4b1ae5be4d27e68c960aa47d91ef350f2d500f Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2016-03-25 22:30:50 +01:00
# Copyright (c) 2016 Intel Corporation
license: Replace Apache boilerplate with SPDX tag Replace the existing Apache 2.0 boilerplate header with an SPDX tag throughout the zephyr code tree. This patch was generated via a script run over the master branch. Also updated doc/porting/application.rst that had a dependency on line numbers in a literal include. Manually updated subsys/logging/sys_log.c that had a malformed header in the original file. Also cleanup several cases that already had a SPDX tag and we either got a duplicate or missed updating. Jira: ZEP-1457 Change-Id: I6131a1d4ee0e58f5b938300c2d2fc77d2e69572c Signed-off-by: David B. Kinder <david.b.kinder@intel.com> Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2017-01-19 02:01:01 +01:00
# SPDX-License-Identifier: Apache-2.0
kconfig: Prune kconfig files that don't match the ARCH or BOARD When Kconfiglib was introduced it caused a significant performance issue. This patch uses pruning to mitigate the performance issue. The pruning exploits the fact that before the Kconfig database is parsed we already know what ARCH and BOARD has been selected. So in theory we could prune away all Kconfig sources that are not related to the current ARCH or BOARD. In practice, it is only the Kconfig sources in zephyr/arch/$ARCH and zephyr/board/$ARCH/ that are easy to prune. Still, that is quite a few Kconfig sources. For qemu_x86 this patch reduced the number of parsed Kconfig source files from 632 to 272. This pruning resulted in a incremental reconfiguration (time cmake ..) speedup of 21% (0.56s to 0.46) and a clean build speedup of 4% (Using board qemu_x86 and sample hello_world). Furthermore, it should be easier to maintain ARCH's and BOARD's out-of-tree since the user now has a mechanism to redirect where Kconfig sources are found. But this has not been explored. Signed-off-by: Sebastian Bøe <sebastian.boe@nordicsemi.no>
2018-01-09 14:12:07 +01:00
kconfig: enclose module Kconfigs into a menu Solve the issue of having all module Kconfig land in the top level Kconfig menu when viewed in menuconfig. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-05-28 20:22:51 +02:00
kconfig: Clarify Kconfig.defconfig explanation in Kconfig.zephyr Group the 'source's of Kconfig.defconfig files together to make it clearer what the comment is talking about. Remove blank lines between the other 'source's too, splitting the 'source's into two groups. Also touch up the comment to make it more concrete and shorten it a bit. Mention that it applies to 'choice's as well. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2020-01-26 23:47:41 +01:00
# Include Kconfig.defconfig files first so that they can override defaults and
# other symbol/choice properties by adding extra symbol/choice definitions.
# After merging all definitions for a symbol/choice, Kconfig picks the first
# property (e.g. the first default) with a satisfied condition.
Kconfig: Use the first default with a satisfied condition Up until now, Zephyr has patched Kconfig to use the last 'default' with a satisfied condition, instead of the first one. I'm not sure why the patch was added (it predates Kconfiglib), but I suspect it's related to Kconfig.defconfig files. There are at least three problems with the patch: 1. It's inconsistent with how Kconfig works in other projects, which might confuse newcomers. 2. Due to oversights, earlier 'range' properties are still preferred, as well as earlier 'default' properties on choices. In addition to being inconsistent, this makes it impossible to override 'range' properties and choice 'default' properties if the base definition of the symbol/choice already has 'range'/'default' properties. I've seen errors caused by the inconsistency, and I suspect there are more. 3. A fork of Kconfiglib that adds the patch needs to be maintained. Get rid of the patch and go back to standard Kconfig behavior, as follows: 1. Include the Kconfig.defconfig files first instead of last in Kconfig.zephyr. 2. Include boards/Kconfig and arch/<arch>/Kconfig first instead of last in arch/Kconfig. 3. Include arch/<arch>/soc/*/Kconfig first instead of last in arch/<arch>/Kconfig. 4. Swap a few other 'source's to preserve behavior for some scattered symbols with multiple definitions. Swap 'source's in some no-op cases too, where it might match the intent. 5. Reverse the defaults on symbol definitions that have more than one default. Skip defaults that are mutually exclusive, e.g. where each default has an 'if <some board>' condition. They are already safe. 6. Remove the prefer-later-defaults patch from Kconfiglib. Testing was done with a Python script that lists all Kconfig symbols/choices with multiple defaults, along with a whitelist of fixed symbols. The script also verifies that there are no "unreachable" defaults hidden by defaults without conditions As an additional test, zephyr/.config was generated before and after the change for several samples and checked to be identical (after sorting). This commit includes some default-related cleanups as well: - Simplify some symbol definitions, e.g. where a default has 'if FOO' when the symbol already has 'depends on FOO'. - Remove some redundant 'default ""' for string symbols. This is the implicit default. Piggyback fixes for swapped ranges on BT_L2CAP_RX_MTU and BT_L2CAP_TX_MTU (caused by confusing inconsistency). Piggyback some fixes for style nits too, e.g. unindented help texts. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-07-30 10:57:47 +02:00
#
kconfig: Clarify Kconfig.defconfig explanation in Kconfig.zephyr Group the 'source's of Kconfig.defconfig files together to make it clearer what the comment is talking about. Remove blank lines between the other 'source's too, splitting the 'source's into two groups. Also touch up the comment to make it more concrete and shorten it a bit. Mention that it applies to 'choice's as well. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2020-01-26 23:47:41 +01:00
# Shield defaults should have precedence over board defaults, which should have
# precedence over SoC defaults, so include them in that order.
Kconfig: Use the first default with a satisfied condition Up until now, Zephyr has patched Kconfig to use the last 'default' with a satisfied condition, instead of the first one. I'm not sure why the patch was added (it predates Kconfiglib), but I suspect it's related to Kconfig.defconfig files. There are at least three problems with the patch: 1. It's inconsistent with how Kconfig works in other projects, which might confuse newcomers. 2. Due to oversights, earlier 'range' properties are still preferred, as well as earlier 'default' properties on choices. In addition to being inconsistent, this makes it impossible to override 'range' properties and choice 'default' properties if the base definition of the symbol/choice already has 'range'/'default' properties. I've seen errors caused by the inconsistency, and I suspect there are more. 3. A fork of Kconfiglib that adds the patch needs to be maintained. Get rid of the patch and go back to standard Kconfig behavior, as follows: 1. Include the Kconfig.defconfig files first instead of last in Kconfig.zephyr. 2. Include boards/Kconfig and arch/<arch>/Kconfig first instead of last in arch/Kconfig. 3. Include arch/<arch>/soc/*/Kconfig first instead of last in arch/<arch>/Kconfig. 4. Swap a few other 'source's to preserve behavior for some scattered symbols with multiple definitions. Swap 'source's in some no-op cases too, where it might match the intent. 5. Reverse the defaults on symbol definitions that have more than one default. Skip defaults that are mutually exclusive, e.g. where each default has an 'if <some board>' condition. They are already safe. 6. Remove the prefer-later-defaults patch from Kconfiglib. Testing was done with a Python script that lists all Kconfig symbols/choices with multiple defaults, along with a whitelist of fixed symbols. The script also verifies that there are no "unreachable" defaults hidden by defaults without conditions As an additional test, zephyr/.config was generated before and after the change for several samples and checked to be identical (after sorting). This commit includes some default-related cleanups as well: - Simplify some symbol definitions, e.g. where a default has 'if FOO' when the symbol already has 'depends on FOO'. - Remove some redundant 'default ""' for string symbols. This is the implicit default. Piggyback fixes for swapped ranges on BT_L2CAP_RX_MTU and BT_L2CAP_TX_MTU (caused by confusing inconsistency). Piggyback some fixes for style nits too, e.g. unindented help texts. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-07-30 10:57:47 +02:00
#
kconfig: Clarify Kconfig.defconfig explanation in Kconfig.zephyr Group the 'source's of Kconfig.defconfig files together to make it clearer what the comment is talking about. Remove blank lines between the other 'source's too, splitting the 'source's into two groups. Also touch up the comment to make it more concrete and shorten it a bit. Mention that it applies to 'choice's as well. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2020-01-26 23:47:41 +01:00
# $ARCH and $BOARD_DIR will be glob patterns when building documentation.
kconfig: soc and shield cleanup Always source the Zephyr base soc and shield (board root) Kconfigs directly from Kconfig instead of generated Kconfig files. This has the benefit that it is no longer necessary to generate Kconfig files to source SoC root and shield (board root) when no custom roots are provided. Also this cleans up the doc/CMakeLists.txt and ensures that the doc/CMakeLists.txt is not getting out of sync with the Kconfig.cmake. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-06-02 08:47:21 +02:00
# This loads custom shields defconfigs (from BOARD_ROOT)
osource "$(KCONFIG_BINARY_DIR)/Kconfig.shield.defconfig"
# This loads Zephyr base shield defconfigs
source "boards/shields/*/Kconfig.defconfig"
Kconfig: Use new preprocessor syntax for env. variables With the new Kconfig preprocessor (described in https://github.com/torvalds/linux/blob/master/Documentation/kbuild/ kconfig-macro-language.txt), the syntax for expanding environment variables is $(FOO) rather than $FOO. $(FOO) is a general preprocessor variable expansion, which falls back to environment variables if the variable isn't set (like in Make). It can also be used in prompts, 'comment's, etc. The old syntax will probably be supported forever in Kconfiglib for backwards compatibility, but might as well make it consistent now that people might start using the preprocessor more. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-09-05 13:10:19 +02:00
source "$(BOARD_DIR)/Kconfig.defconfig"
kconfig: soc and shield cleanup Always source the Zephyr base soc and shield (board root) Kconfigs directly from Kconfig instead of generated Kconfig files. This has the benefit that it is no longer necessary to generate Kconfig files to source SoC root and shield (board root) when no custom roots are provided. Also this cleans up the doc/CMakeLists.txt and ensures that the doc/CMakeLists.txt is not getting out of sync with the Kconfig.cmake. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-06-02 08:47:21 +02:00
# This loads custom SoC root defconfigs
osource "$(KCONFIG_BINARY_DIR)/Kconfig.soc.defconfig"
# This loads Zephyr base SoC root defconfigs
osource "soc/$(ARCH)/*/Kconfig.defconfig"
armclang: ARM Compiler C library support Support for ARM Compiler C library. This commit add support for the ARM Compiler C libary in: - Kconfig - libc/armstdc A new Kconfig symbol is added to allow a toolchain to specify if they support linking with the minimal C library. Also the CMake variable `TOOLCHAIN_HAS_NEWLIB` is exported to Kconfig so that CONFIG_NEWLIB_LIBS can only be enabled if the toolchain has newlib. The armclang toolchain selects the CMake scatter file generator and disables support for the LD linker template which is not supported by armlink. For the ARM Compiler C library, a corresponding lib/libc/armstc/ folder with a minimal implementation to work with the ARM Compiler C library is added. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-08-15 23:14:21 +02:00
# This loads the toolchain defconfigs
osource "$(TOOLCHAIN_KCONFIG_DIR)/Kconfig.defconfig"
testsuite: ztress: Use XOSHIRO generator when ztress is used Use XOSHIRO random number generator if target has entropy generator. Some entropy generators may have limitations (e.g. only thread context) which would conflict with ztress usage. Added Kconfig.defconfig for testsuite. Signed-off-by: Krzysztof Chruscinski <krzysztof.chruscinski@nordicsemi.no>
2022-09-06 12:50:10 +02:00
# This loads the testsuite defconfig
source "subsys/testsuite/Kconfig.defconfig"
Kconfig: Use the first default with a satisfied condition Up until now, Zephyr has patched Kconfig to use the last 'default' with a satisfied condition, instead of the first one. I'm not sure why the patch was added (it predates Kconfiglib), but I suspect it's related to Kconfig.defconfig files. There are at least three problems with the patch: 1. It's inconsistent with how Kconfig works in other projects, which might confuse newcomers. 2. Due to oversights, earlier 'range' properties are still preferred, as well as earlier 'default' properties on choices. In addition to being inconsistent, this makes it impossible to override 'range' properties and choice 'default' properties if the base definition of the symbol/choice already has 'range'/'default' properties. I've seen errors caused by the inconsistency, and I suspect there are more. 3. A fork of Kconfiglib that adds the patch needs to be maintained. Get rid of the patch and go back to standard Kconfig behavior, as follows: 1. Include the Kconfig.defconfig files first instead of last in Kconfig.zephyr. 2. Include boards/Kconfig and arch/<arch>/Kconfig first instead of last in arch/Kconfig. 3. Include arch/<arch>/soc/*/Kconfig first instead of last in arch/<arch>/Kconfig. 4. Swap a few other 'source's to preserve behavior for some scattered symbols with multiple definitions. Swap 'source's in some no-op cases too, where it might match the intent. 5. Reverse the defaults on symbol definitions that have more than one default. Skip defaults that are mutually exclusive, e.g. where each default has an 'if <some board>' condition. They are already safe. 6. Remove the prefer-later-defaults patch from Kconfiglib. Testing was done with a Python script that lists all Kconfig symbols/choices with multiple defaults, along with a whitelist of fixed symbols. The script also verifies that there are no "unreachable" defaults hidden by defaults without conditions As an additional test, zephyr/.config was generated before and after the change for several samples and checked to be identical (after sorting). This commit includes some default-related cleanups as well: - Simplify some symbol definitions, e.g. where a default has 'if FOO' when the symbol already has 'depends on FOO'. - Remove some redundant 'default ""' for string symbols. This is the implicit default. Piggyback fixes for swapped ranges on BT_L2CAP_RX_MTU and BT_L2CAP_TX_MTU (caused by confusing inconsistency). Piggyback some fixes for style nits too, e.g. unindented help texts. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2018-07-30 10:57:47 +02:00
kconfig: Move Kconfig.dts sourcing earlier Move Kconfig.dts before modules so that any of the auto generated symbols will be available to module Kconfigs. Signed-off-by: Kumar Gala <galak@kernel.org>
2022-08-12 17:00:38 +02:00
# This should be early since the autogen Kconfig.dts symbols may get
# used by modules
source "dts/Kconfig"
Kconfig.zephyr: allow override default values in module Kconfig files Allow Kconfig to override default values of Kconfig symbols defined in modules' Kconfig files. For that, the .defonfig files need to be source'd before the modules' Kconfig files. Signed-off-by: Ioannis Glaropoulos <Ioannis.Glaropoulos@nordicsemi.no>
2020-12-07 18:42:52 +01:00
menu "Modules"
source "modules/Kconfig"
endmenu
kconfig: move soc selection to ZEPHYR_BASE/soc/ Rather than do that for each architecture, source SoC Kconfigs where the code is maintained, under ZEPHYR_BASE/soc. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-09-04 15:32:07 +02:00
source "boards/Kconfig"
cmake: kconfig: support for multiple SOC_ROOT This commit introduces support for multiple SOC_ROOT. This means that additional SOC_ROOTs specified using -DSOC_ROOT as argument to CMake will be forming a list together with ${ZEPHYR_BASE}. This allows for greater flexibility, as developers can now specify multiple out-of-tree SoCs and not worry about the SoC used for the board they compile for. Also it avoid code, such as: if(BOARD STREQUAL my_board_using_out_of_tree_soc) set(SOC_ROOT some/out/of/tree/soc/path) endif() in application CMakeLists.txt. Finally, allowing multiple SOC_ROOTs prepares for specifying SOC_ROOTs in Zephyr modules. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2020-07-06 12:53:39 +02:00
source "soc/Kconfig"
kconfig: define architecture as a kconfig variable Do not depend on environment variables and use a kconfig variable for defining the architecture. In addition, remove the X86_32 variable, it just duplicates X86 for not good reason, at least until start supporting MCUs with 64bit. Change-Id: Ia001db81ed007e6a43f34506fed9be1345b88a4b Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2015-10-09 12:20:52 +02:00
source "arch/Kconfig"
source "kernel/Kconfig"
source "drivers/Kconfig"
tinycrypt: move from lib to regular objects tinycrypt was built using the lib- scripts without any real benefit. We also had a wrong placement of the Kconfig files under misc/ and a Kconfig file for Crypto that was never used before. Change-Id: I82d5902d92e7c06e10a95f418d9ead3cbcabcce4 Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-05-15 05:10:51 +02:00
source "lib/Kconfig"
fs: Move file system code to subsys/ Subsystems code will reside in subsys/ folder. This patch creates the folder and moves FS code there. Jira: ZEP-1120 Change-Id: If3b1bcb996c5fbd4056cd5d1920d41d29810d6b2 Signed-off-by: Ramesh Thomas <ramesh.thomas@intel.com>
2016-10-29 13:10:36 +02:00
source "subsys/Kconfig"
ext: plumb out Kconfig support for external source code Add missing Kconfig files and connections to expose Kconfig options in ext/ directories. Fixup QMSI to only be exposed on platforms that utilize it. Change-Id: I6c6c5011b2bf2966f65aa8279dc594a244821956 Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2016-05-24 21:23:26 +02:00
cmake: Introduce optional Kconfig for toolchains Allow a given toolchain to specify Kconfig options that might be relevant to a feature available in that toolchain. For example, the ARM embedded GNU toolchain supports two variants of newlib and you select the smaller one via a spec file. We can use a Kconfig option like HAS_NEWLIB_LIBC_NANO to convey that this feature is supported by that toolchain. We look for the toolchain Kconfig in ${TOOLCHAIN_KCONFIG_DIR}/Kconfig, and default TOOLCHAIN_KCONFIG_DIR to: ${TOOLCHAIN_ROOT}/cmake/toolchain/${ZEPHYR_TOOLCHAIN_VARIANT}) toolchain specific cmake files can override the default if needed. Additionally tweaked the zephyr/generic.cmake to use ${CMAKE_CURRENT_LIST_DIR} to reduce some duplication. Signed-off-by: Kumar Gala <kumar.gala@linaro.org> Signed-off-by: Sebastian Bøe <sebastian.boe@nordicsemi.no> Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2020-01-24 16:39:40 +01:00
osource "$(TOOLCHAIN_KCONFIG_DIR)/Kconfig"
modules: move module kconfig to main tree Due to in-tree dependencies on Kconfig options defined in modules we end up having warnings and errors when those modules are not part of the manifest. Users should be able to remove unwanted modules from their downstream manifest and still build any board configurations. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-05-23 23:19:41 +02:00
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
menu "Build and Link Features"
menu "Linker Options"
linker: warn about orphan sections (Previous patch set was reverted due to issue with priv_stack. Resubmitting after fixing the faults caused by priv_stack.noinit not at the end of RAM.) This adds a linker flag and necessary changes to linker scripts so that linker will warn about orphan sections. Relates to #5534. Fixes #10473, #10474, #10515. Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2018-10-19 19:15:19 +02:00
choice
prompt "Linker Orphan Section Handling"
default LINKER_ORPHAN_SECTION_WARN
config LINKER_ORPHAN_SECTION_PLACE
bool "Place"
help
Linker puts orphan sections in place without warnings
or errors.
config LINKER_ORPHAN_SECTION_WARN
bool "Warn"
help
docs: fix misspelling across the tree Found a few annoying typos and figured I better run script and fix anything it can find, here are the results... Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-06-18 20:45:40 +02:00
Linker places the orphan sections in output and issues
linker: warn about orphan sections (Previous patch set was reverted due to issue with priv_stack. Resubmitting after fixing the faults caused by priv_stack.noinit not at the end of RAM.) This adds a linker flag and necessary changes to linker scripts so that linker will warn about orphan sections. Relates to #5534. Fixes #10473, #10474, #10515. Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2018-10-19 19:15:19 +02:00
warning about those sections.
config LINKER_ORPHAN_SECTION_ERROR
bool "Error"
help
Linker exits with error when an orphan section is found.
endchoice
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config HAS_FLASH_LOAD_OFFSET
bool
help
This option is selected by targets having a FLASH_LOAD_OFFSET
and FLASH_LOAD_SIZE.
kconfig: Factor out HAS_FLASH_LOAD_OFFSET dependency Use a top-level 'if' instead of three separate 'depends on'. They're exactly equivalent (top-level 'if's are just a shorthand for adding 'depends on' to each item within the 'if'). Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-11-16 01:33:09 +01:00
if HAS_FLASH_LOAD_OFFSET
kconfig: Rename USE_CODE_PARTITION to USE_DT_CODE_PARTITION USE_CODE_PARTITION is a bit vague as a symbol name ("use code partition how?"). Rename it to USE_DT_CODE_PARTITION to make it clearer that it's about devicetree. This would break any third-party configuration files that set it, but it'll generate an error since kconfig.py promotes warnings to errors, so it's probably not a big deal. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-11-16 01:22:16 +01:00
config USE_DT_CODE_PARTITION
kconfig: Improve USE_CODE_PARTITION prompt and help string The prompt and help string for USE_CODE_PARTITION were too terse and didn't make it clear that it's related to devicetree, which confused me. Spell things out in more detail. Unless the meaning of a symbol is completely obvious from context, aim for at least a few sentences of help text. Think about what would be confusing for someone coming at it without much context. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-11-16 01:16:57 +01:00
bool "Link application into /chosen/zephyr,code-partition from devicetree"
zephyr: fix mcuboot can't link into boot-partition Objective of the path is to allow to select by the application to link into the chosen code-partition. Introduced USE_CODE_PARTITION will be set by bootloader project. fixes #14566 Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>
2019-03-18 14:02:11 +01:00
help
kconfig: Improve USE_CODE_PARTITION prompt and help string The prompt and help string for USE_CODE_PARTITION were too terse and didn't make it clear that it's related to devicetree, which confused me. Spell things out in more detail. Unless the meaning of a symbol is completely obvious from context, aim for at least a few sentences of help text. Think about what would be confusing for someone coming at it without much context. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-11-16 01:16:57 +01:00
When enabled, the application will be linked into the flash partition
selected by the zephyr,code-partition property in /chosen in devicetree.
When this is disabled, the flash load offset and size can be set manually
below.
zephyr: fix mcuboot can't link into boot-partition Objective of the path is to allow to select by the application to link into the chosen code-partition. Introduced USE_CODE_PARTITION will be set by bootloader project. fixes #14566 Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>
2019-03-18 14:02:11 +01:00
kconfig: Convert device tree chosen properties to new kconfigfunctions Convert how we get the various chosen properties like "zephyr,console" to use the new kconfig functions like dt_chosen_to_label. Because of how kconfig parses things we define a set of variables of the form DT_CHOSEN_Z_<PROP> since comma's are parsed as field seperators in macros. This conversion allows us to remove code in gen_defines.py for the following chosen properties: zephyr,console zephyr,shell-uart zephyr,bt-uart zephyr,uart-pipe zephyr,bt-mon-uart zephyr,uart-mcumgr zephyr,bt-c2h-uart Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2019-08-28 16:29:26 +02:00
# Workaround for not being able to have commas in macro arguments
DT_CHOSEN_Z_CODE_PARTITION := zephyr,code-partition
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config FLASH_LOAD_OFFSET
kconfig: Rename USE_CODE_PARTITION to USE_DT_CODE_PARTITION USE_CODE_PARTITION is a bit vague as a symbol name ("use code partition how?"). Rename it to USE_DT_CODE_PARTITION to make it clearer that it's about devicetree. This would break any third-party configuration files that set it, but it'll generate an error since kconfig.py promotes warnings to errors, so it's probably not a big deal. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-11-16 01:22:16 +01:00
# Only user-configurable when USE_DT_CODE_PARTITION is disabled
hex "Kernel load offset" if !USE_DT_CODE_PARTITION
default $(dt_chosen_reg_addr_hex,$(DT_CHOSEN_Z_CODE_PARTITION)) if USE_DT_CODE_PARTITION
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
default 0
help
This option specifies the byte offset from the beginning of flash that
the kernel should be loaded into. Changing this value from zero will
affect the Zephyr image's link, and will decrease the total amount of
flash available for use by application code.
If unsure, leave at the default value 0.
config FLASH_LOAD_SIZE
kconfig: Rename USE_CODE_PARTITION to USE_DT_CODE_PARTITION USE_CODE_PARTITION is a bit vague as a symbol name ("use code partition how?"). Rename it to USE_DT_CODE_PARTITION to make it clearer that it's about devicetree. This would break any third-party configuration files that set it, but it'll generate an error since kconfig.py promotes warnings to errors, so it's probably not a big deal. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-11-16 01:22:16 +01:00
# Only user-configurable when USE_DT_CODE_PARTITION is disabled
hex "Kernel load size" if !USE_DT_CODE_PARTITION
default $(dt_chosen_reg_size_hex,$(DT_CHOSEN_Z_CODE_PARTITION)) if USE_DT_CODE_PARTITION
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
default 0
help
If non-zero, this option specifies the size, in bytes, of the flash
area that the Zephyr image will be allowed to occupy. If zero, the
image will be able to occupy from the FLASH_LOAD_OFFSET to the end of
the device.
If unsure, leave at the default value 0.
kconfig: Factor out HAS_FLASH_LOAD_OFFSET dependency Use a top-level 'if' instead of three separate 'depends on'. They're exactly equivalent (top-level 'if's are just a shorthand for adding 'depends on' to each item within the 'if'). Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-11-16 01:33:09 +01:00
endif # HAS_FLASH_LOAD_OFFSET
config: Rename TEXT_SECTION_OFFSET to ROM_START_OFFSET The `TEXT_SECTION_OFFSET` symbol is used to specify the offset between the beginning of the ROM area and the address of the first ROM section. This commit renames `TEXT_SECTION_OFFSET` to `ROM_START_OFFSET` because the first ROM section is not always the `.text` section. Signed-off-by: Stephanos Ioannidis <root@stephanos.io>
2020-02-10 08:37:24 +01:00
config ROM_START_OFFSET
kconfig: Removed prompt for TEXT_SECTION_OFFSET when MCUboot is used When this syntax is used for the type definition: hex "TEXT section offset" Kconfig expect the user to enter the value for TEXT_SECTION_OFFSET and the defaut value for BOOTLOADER_MCUBOOT is not used. Changing the syntax to this: hex prompt "TEXT section offset" if !BOOTLOADER_MCUBOOT will tell Kconfig that TEXT_SECTION_OFFSET will not be set by the user when BOOTLOADER_MCUBOOT is set and then Kconfig will use the default value. Signed-off-by: Ole Sæther <ole.saether@nordicsemi.no>
2019-01-23 14:13:03 +01:00
hex
config: Rename TEXT_SECTION_OFFSET to ROM_START_OFFSET The `TEXT_SECTION_OFFSET` symbol is used to specify the offset between the beginning of the ROM area and the address of the first ROM section. This commit renames `TEXT_SECTION_OFFSET` to `ROM_START_OFFSET` because the first ROM section is not always the `.text` section. Signed-off-by: Stephanos Ioannidis <root@stephanos.io>
2020-02-10 08:37:24 +01:00
prompt "ROM start offset" if !BOOTLOADER_MCUBOOT
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
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
config: Rename TEXT_SECTION_OFFSET to ROM_START_OFFSET The `TEXT_SECTION_OFFSET` symbol is used to specify the offset between the beginning of the ROM area and the address of the first ROM section. This commit renames `TEXT_SECTION_OFFSET` to `ROM_START_OFFSET` because the first ROM section is not always the `.text` section. Signed-off-by: Stephanos Ioannidis <root@stephanos.io>
2020-02-10 08:37:24 +01:00
space between the beginning of the image and the start of the first
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
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.
kconfig: cmake: CMake linker script generator symbol added A "Linker script" choice group has been added to the linker options menu. The existing HAVE_CUSTOM_LINKER_SCRIPT config has been relocated inside the linker script menu. Two new entries has been created: - LD template, for using the old ld template files together with the C pre-processor to create the final linker script. - CMake linker generator, used for ARMClang / armlink toolchain. The CMake linker generator is also supported for LD linker scripts for the ARM architecture. In CMake, the file cmake/linker/ld/target.cmake has been updated to support the CMake LD linker generator. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-06-09 11:22:07 +02:00
config LD_LINKER_SCRIPT_SUPPORTED
bool
default y
choice LINKER_SCRIPT
prompt "Linker script"
default LD_LINKER_TEMPLATE if LD_LINKER_SCRIPT_SUPPORTED
config LD_LINKER_TEMPLATE
bool "LD template"
depends on LD_LINKER_SCRIPT_SUPPORTED
help
Select this option to use the LD linker script templates.
The templates are pre-processed by the C pre-processor to create the
final LD linker script.
config CMAKE_LINKER_GENERATOR
bool "CMake generator"
depends on ARM
help
Select this option to use the Zephyr CMake linker script generator.
The linker configuration is written in CMake and the final linker
script will be generated by the toolchain specific linker generator.
For LD based linkers, this will be the ld generator, for ARMClang /
armlink based linkers it will be the scatter generator.
endchoice
LLVM: add built-in lld linker support for x86. add support to use LLVM built-in lld linker to build zephyr applications for x86 platforms. Signed-off-by: Chen Peng1 <peng1.chen@intel.com>
2022-02-25 09:21:27 +01:00
config LLVM_USE_LD
bool "LLVM use ld linker"
depends on "${ZEPHYR_TOOLCHAIN_VARIANT}" = "llvm"
default y
help
Use binutils ld linker instead of LLVM built-in lld linker.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config HAVE_CUSTOM_LINKER_SCRIPT
kconfig: cmake: CMake linker script generator symbol added A "Linker script" choice group has been added to the linker options menu. The existing HAVE_CUSTOM_LINKER_SCRIPT config has been relocated inside the linker script menu. Two new entries has been created: - LD template, for using the old ld template files together with the C pre-processor to create the final linker script. - CMake linker generator, used for ARMClang / armlink toolchain. The CMake linker generator is also supported for LD linker scripts for the ARM architecture. In CMake, the file cmake/linker/ld/target.cmake has been updated to support the CMake LD linker generator. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-06-09 11:22:07 +02:00
bool "Custom linker script provided"
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
help
Set this option if you have a custom linker script which needed to
be define in CUSTOM_LINKER_SCRIPT.
config CUSTOM_LINKER_SCRIPT
string "Path to custom linker script"
depends on HAVE_CUSTOM_LINKER_SCRIPT
help
Path to the linker script to be used instead of the one define by the
board.
The linker script must be based on a version provided by Zephyr since
the kernel can expect a certain layout/certain regions.
This is useful when an application needs to add sections into the
linker script and avoid having to change the script provided by
Zephyr.
config KERNEL_ENTRY
string "Kernel entry symbol"
default "__start"
help
Code entry symbol, to be set at linking phase.
cmake: LD: Allow input sections to remain unsorted We have users that have problems in their linker scripts where the order of input sections matters. To allow users to use the latest Zephyr while working on a fix to their linker scripts we add an option to allow leaving the sections unsorted. See discussion here for more details https://github.com/zephyrproject-rtos/zephyr/pull/14183 Signed-off-by: Sebastian Bøe <sebastian.boe@nordicsemi.no>
2019-03-15 14:05:09 +01:00
config LINKER_SORT_BY_ALIGNMENT
bool "Sort input sections by alignment"
default y
help
This turns on the linker flag to sort sections by alignment
in decreasing size of symbols. This helps to minimize
padding between symbols.
boards: stm32f0: explicit RAM vector table control Add a new Kconfig symbol that explicitly controls whether the vector table should be placed in RAM. This eliminates the side effect of `IS_BOOTLOADER` controlling vector table location. Making the condition a positive assertion also allows the config to be used in CMakeLists conditions (`zephyr_linker_sources_ifdef()`, etc). Signed-off-by: Jordan Yates <jordan.yates@data61.csiro.au>
2021-04-17 12:04:33 +02:00
config SRAM_VECTOR_TABLE
bool "Place the vector table in SRAM instead of flash"
help
The option specifies that the vector table should be placed at the
start of SRAM instead of the start of flash.
kernel: add CONFIG_SRAM_OFFSET This adds a new kconfig CONFIG_SRAM_OFFSET to specify the offset from beginning of SRAM where the kernel begins. On x86 and PC compatible platforms, the first 1MB of RAM is reserved and Zephyr should not link anything there. However, this 1MB still needs to be mapped by the MMU to access various platform related information. CONFIG_SRAM_OFFSET serves similar function as CONFIG_KERNEL_VM_OFFSET and is needed for proper phys/virt address translations. Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2021-02-20 20:02:17 +01:00
config HAS_SRAM_OFFSET
bool
help
This option is selected by targets that require SRAM_OFFSET.
config SRAM_OFFSET
hex "Kernel SRAM offset" if HAS_SRAM_OFFSET
default 0
help
This option specifies the byte offset from the beginning of SRAM
where the kernel begins. Changing this value from zero will affect
the Zephyr image's link, and will decrease the total amount of
SRAM available for use by application code.
If unsure, leave at the default value 0.
linker: add bits for boot regions This adds the necessary bits for linker scripts and source code to specify which symbols are needed for boot process so they can be grouped together. One use of this is to group boot related code and data so these won't interval with other kernel and application for better caching. This is a must for demand paging as some functions and data must be available during the boot process and before the memory manager is initialized. During this time, paging cannot be used so symbols linked in virtual memory space are unavailable. This is up to the arch/SoC/board to define the sections in their linker scripts as section may need special alignment which cannot be done in common script snippets. Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2021-02-24 19:18:34 +01:00
menu "Linker Sections"
config LINKER_USE_BOOT_SECTION
kconfig: tweak Kconfig prompts Tweak some Kconfig prompts after the removal of "Enable...". Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-03-09 12:31:16 +01:00
bool "Use Boot Linker Section"
linker: add bits for boot regions This adds the necessary bits for linker scripts and source code to specify which symbols are needed for boot process so they can be grouped together. One use of this is to group boot related code and data so these won't interval with other kernel and application for better caching. This is a must for demand paging as some functions and data must be available during the boot process and before the memory manager is initialized. During this time, paging cannot be used so symbols linked in virtual memory space are unavailable. This is up to the arch/SoC/board to define the sections in their linker scripts as section may need special alignment which cannot be done in common script snippets. Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2021-02-24 19:18:34 +01:00
help
If enabled, the symbols which are needed for the boot process
will be put into another linker section reserved for these
symbols.
Requires that boot sections exist in the architecture, SoC,
board or custom linker script.
linker: add bits for pinned regions This adds the necessary bits for linker scripts and source code to specify which symbols need to be pinned in memory. This is needed for demand paging as some functions and data must reside in memory all the time and cannot be paged out (e.g. paging, scheduler, and interrupt routines for functionality). This is up to the arch/SoC/board to define the sections in their linker scripts as the pinned section may need special alignment which cannot be done in common script snippets. Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2021-02-23 22:33:38 +01:00
config LINKER_USE_PINNED_SECTION
kconfig: tweak Kconfig prompts Tweak some Kconfig prompts after the removal of "Enable...". Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-03-09 12:31:16 +01:00
bool "Use Pinned Linker Section"
linker: add bits for pinned regions This adds the necessary bits for linker scripts and source code to specify which symbols need to be pinned in memory. This is needed for demand paging as some functions and data must reside in memory all the time and cannot be paged out (e.g. paging, scheduler, and interrupt routines for functionality). This is up to the arch/SoC/board to define the sections in their linker scripts as the pinned section may need special alignment which cannot be done in common script snippets. Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2021-02-23 22:33:38 +01:00
help
If enabled, the symbols which need to be pinned in memory
will be put into another linker section reserved for pinned
symbols. During boot, the corresponding memory will be marked
as pinned.
Requires that pinned sections exist in the architecture, SoC,
board or custom linker script.
kernel: add kconfig to say not all code/data is present at boot With demand paging and pinned sections enabled, it is possible for data to be brought into physical memory as required by current execution context. However, the kernel still assumes that all data pages are present at boot which may not be desirable for certain scenarios. This introduces a new kconfig to specify that those data pages other than the boot and pinned sections are not present, and they would be paged in on demand. Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2021-07-12 19:58:45 +02:00
config LINKER_GENERIC_SECTIONS_PRESENT_AT_BOOT
bool "Generic sections are present at boot" if DEMAND_PAGING && LINKER_USE_PINNED_SECTION
default y
help
When disabled, the linker sections other than the boot and
pinned sections will be marked as not present in the page
tables. This allows kernel to pull in data pages on demand
as required by current execution context when demand paging
is enabled. There is no need to load all code and data into
memory at once.
If unsure, say Y.
linker: add bits for boot regions This adds the necessary bits for linker scripts and source code to specify which symbols are needed for boot process so they can be grouped together. One use of this is to group boot related code and data so these won't interval with other kernel and application for better caching. This is a must for demand paging as some functions and data must be available during the boot process and before the memory manager is initialized. During this time, paging cannot be used so symbols linked in virtual memory space are unavailable. This is up to the arch/SoC/board to define the sections in their linker scripts as section may need special alignment which cannot be done in common script snippets. Signed-off-by: Daniel Leung <daniel.leung@intel.com>
2021-02-24 19:18:34 +01:00
endmenu # "Linker Sections"
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
endmenu
menu "Compiler Options"
coding_guideline: Add an option to enforce rules Add a Kconfig option to enable compiler flags that help to enforce some code guideline rules. Note: As the current code base is not in compliance with the adopted code guideline, some rules will generate warnings during the build. This is intended to help to spot violations. Signed-off-by: Flavio Ceolin <flavio.ceolin@intel.com>
2020-08-26 18:48:33 +02:00
config CODING_GUIDELINE_CHECK
bool "Enforce coding guideline rules"
help
Use available compiler flags to check coding guideline rules during
the build.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config NATIVE_APPLICATION
bool "Build as a native host application"
help
Build as a native application that can run on the host and using
resources and libraries provided by the host.
kconfig: add names to some choices In order to be able to make a "choice" from any other Kconfig.defconfig (-ish) file, the choice needs to be named. This commit names a few choices. Signed-off-by: Emil Lindqvist <emil@lindq.gr>
2021-09-03 13:52:33 +02:00
choice COMPILER_OPTIMIZATIONS
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
prompt "Optimization level"
default NO_OPTIMIZATIONS if COVERAGE
default DEBUG_OPTIMIZATIONS if DEBUG
default SIZE_OPTIMIZATIONS
help
Note that these flags shall only control the compiler
optimization level, and that no extra debug code shall be
conditionally compiled based on them.
config SIZE_OPTIMIZATIONS
bool "Optimize for size"
help
Compiler optimizations will be set to -Os independently of other
options.
config SPEED_OPTIMIZATIONS
bool "Optimize for speed"
help
Compiler optimizations will be set to -O2 independently of other
options.
config DEBUG_OPTIMIZATIONS
bool "Optimize debugging experience"
help
Compiler optimizations will be set to -Og independently of other
options.
config NO_OPTIMIZATIONS
bool "Optimize nothing"
help
Compiler optimizations will be set to -O0 independently of other
options.
endchoice
cmake: gcc/clang: enable colour diagnostics in terminal output When compiler results are piped through a non-terminal (e.g. ninja) the compiler disables colour diagnostics. Using `-fdiagnostics-color` forces the compiler to enable colour output. This flag is always enabled for clang and gcc. Setting `CONFIG_COMPILER_COLOR_DIAGNOSTICS=n` disables this feature and reverts to plain diagnostic messages with no formatting. Signed-off-by: Arvin Farahmand <arvinf@ip-logix.com>
2021-04-15 17:20:10 +02:00
config COMPILER_COLOR_DIAGNOSTICS
kconfig: remove Enable from boolean prompts According to Kconfig guidelines, boolean prompts must not start with "Enable...". The following command has been used to automate the changes in this patch: sed -i "s/bool \"[Ee]nables\? \(\w\)/bool \"\U\1/g" **/Kconfig* Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-03-09 12:05:12 +01:00
bool "Colored diagnostics"
cmake: gcc/clang: enable colour diagnostics in terminal output When compiler results are piped through a non-terminal (e.g. ninja) the compiler disables colour diagnostics. Using `-fdiagnostics-color` forces the compiler to enable colour output. This flag is always enabled for clang and gcc. Setting `CONFIG_COMPILER_COLOR_DIAGNOSTICS=n` disables this feature and reverts to plain diagnostic messages with no formatting. Signed-off-by: Arvin Farahmand <arvinf@ip-logix.com>
2021-04-15 17:20:10 +02:00
default y
help
Compiler diagnostic messages are colorized.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config COMPILER_OPT
string "Custom compiler options"
help
This option is a free-form string that is passed to the compiler
when building all parts of a project (i.e. kernel).
The compiler options specified by this string supplement the
predefined set of compiler supplied by the build system,
and can be used to change compiler optimization, warning and error
messages, and so on.
Kconfig.zephyr: fix MISRA_SANE location This belongs under "Compiler Options", not "Boot Options" where it currently is. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2021-05-21 19:56:23 +02:00
config MISRA_SANE
bool "MISRA standards compliance features"
help
Causes the source code to build in "MISRA" mode, which
disallows some otherwise-permitted features of the C
standard for safety reasons. Specifically variable length
arrays are not permitted (and gcc will enforce this).
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
endmenu
base: add error checking macros Define there options for runtime error handling: - assert on all errors (ASSERT_ON_ERRORS) - no runtime checks (no asserts, no runtime error handling) (NO_RUNTIME_CHECKS) - full runtime error handling (the default) (RUNTIME_ERROR_CHECKS) Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-11-24 17:28:38 +01:00
choice
prompt "Error checking behavior for CHECK macro"
default RUNTIME_ERROR_CHECKS
config ASSERT_ON_ERRORS
bool "Assert on all errors"
help
Assert on errors covered with the CHECK macro.
config NO_RUNTIME_CHECKS
bool "No runtime error checks"
help
Do not do any runtime checks or asserts when using the CHECK macro.
config RUNTIME_ERROR_CHECKS
kconfig: remove Enable from boolean prompts According to Kconfig guidelines, boolean prompts must not start with "Enable...". The following command has been used to automate the changes in this patch: sed -i "s/bool \"[Ee]nables\? \(\w\)/bool \"\U\1/g" **/Kconfig* Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-03-09 12:05:12 +01:00
bool "Runtime error checks"
base: add error checking macros Define there options for runtime error handling: - assert on all errors (ASSERT_ON_ERRORS) - no runtime checks (no asserts, no runtime error handling) (NO_RUNTIME_CHECKS) - full runtime error handling (the default) (RUNTIME_ERROR_CHECKS) Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-11-24 17:28:38 +01:00
help
Always perform runtime checks covered with the CHECK macro. This
option is the default and the only option used during testing.
endchoice
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
menu "Build Options"
config KERNEL_BIN_NAME
string "The kernel binary name"
default "zephyr"
help
This option sets the name of the generated kernel binary.
config OUTPUT_STAT
bool "Create a statistics file"
default y
help
Create a stat file using readelf -e <elf>
build: generate symbols file Optional way for generating symbols file using binutils. This file will be generated on demand for tests which will then be parsed by twister to create an accurate test plan from the listed testcase/suites. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2022-06-27 16:08:37 +02:00
config OUTPUT_SYMBOLS
bool "Create a symbol file"
help
Create a symbol file using nm <elf>
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config OUTPUT_DISASSEMBLY
bool "Create a disassembly file"
default y
help
Create an .lst file with the assembly listing of the firmware.
cmake: Assembly listing containing all sections Added support for creating an assembly listing containing all sections like rodata, data and debug sections, not just those expected to contain instructions. Signed-off-by: Rohit Gujarathi <gujju.rohit@gmail.com>
2020-05-07 06:38:37 +02:00
config OUTPUT_DISASSEMBLE_ALL
bool "Disassemble all sections with source. Fill zeros."
default n
depends on OUTPUT_DISASSEMBLY
help
The .lst file will contain complete disassembly of the firmware
not just those expected to contain instructions including zeros
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config OUTPUT_PRINT_MEMORY_USAGE
bool "Print memory usage to stdout"
default y
help
If the toolchain supports it, this option will pass
--print-memory-region to the linker when it is doing it's first
linker pass. Note that the memory regions are symbolic concepts
defined by the linker scripts and do not necessarily map
directly to the real physical address space. Take also note that
some platforms do two passes of the linker so the results do not
match exactly to the final elf file. See also rom_report,
ram_report and
https://sourceware.org/binutils/docs/ld/MEMORY.html
build: add option to delete intermediate files Add option to remove intermediate files to save space and remove clutter. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2020-10-20 20:31:56 +02:00
config CLEANUP_INTERMEDIATE_FILES
bool "Remove all intermediate files"
help
Delete intermediate files to save space and cleanup clutter resulting
from the build process.
Kconfig.zephyr: help text fixes The text "need by some platforms" in various CONFIG_BUILD_OUTPUT_FOO help is grammatically incorrect. Fix this by rewording. Move 'config BUILD_NO_GAP_FILL' to before the list of 'config BUILD_OUTPUT_FOO' definitions instead of sandwiching it inside. Fix the extension of the stripped binary. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-06 23:57:17 +02:00
config BUILD_NO_GAP_FILL
bool "Don't fill gaps in generated hex/bin/s19 files."
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config BUILD_OUTPUT_HEX
bool "Build a binary in HEX format"
help
Kconfig.zephyr: help text fixes The text "need by some platforms" in various CONFIG_BUILD_OUTPUT_FOO help is grammatically incorrect. Fix this by rewording. Move 'config BUILD_NO_GAP_FILL' to before the list of 'config BUILD_OUTPUT_FOO' definitions instead of sandwiching it inside. Fix the extension of the stripped binary. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-06 23:57:17 +02:00
Build an Intel HEX binary zephyr/zephyr.hex in the build directory.
The name of this file can be customized with CONFIG_KERNEL_BIN_NAME.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config BUILD_OUTPUT_BIN
bool "Build a binary in BIN format"
default y
help
Kconfig.zephyr: help text fixes The text "need by some platforms" in various CONFIG_BUILD_OUTPUT_FOO help is grammatically incorrect. Fix this by rewording. Move 'config BUILD_NO_GAP_FILL' to before the list of 'config BUILD_OUTPUT_FOO' definitions instead of sandwiching it inside. Fix the extension of the stripped binary. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-06 23:57:17 +02:00
Build a "raw" binary zephyr/zephyr.bin in the build directory.
The name of this file can be customized with CONFIG_KERNEL_BIN_NAME.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
boards: x86: depend on CONFIG_BUILD_OUTPUT_EFI Add a new Kconfig CONFIG_BUILD_OUTPUT_EFI and select that for boards that want to generate an EFI application. Make qemu_x86_64 also generate an EFI file, however do not enable this by default yet. Goal is to boot qemu using EFI to be able to test this path in the future. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2021-01-26 12:58:30 +01:00
config BUILD_OUTPUT_EFI
bool "Build as an EFI application"
default n
depends on X86_64
help
Build as an EFI application.
This works by creating a "zephyr.efi" EFI binary containing a zephyr
image extracted from a built zephyr.elf file. EFI applications are
relocatable, and cannot be placed at specific locations in memory.
Instead, the stub code will copy the embedded zephyr sections to the
appropriate locations at startup, clear any zero-filled (BSS, etc...)
areas, then jump into the 64 bit entry point.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config BUILD_OUTPUT_EXE
bool "Build a binary in ELF format with .exe extension"
help
Kconfig.zephyr: help text fixes The text "need by some platforms" in various CONFIG_BUILD_OUTPUT_FOO help is grammatically incorrect. Fix this by rewording. Move 'config BUILD_NO_GAP_FILL' to before the list of 'config BUILD_OUTPUT_FOO' definitions instead of sandwiching it inside. Fix the extension of the stripped binary. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-06 23:57:17 +02:00
Build an ELF binary that can run in the host system at
zephyr/zephyr.exe in the build directory.
The name of this file can be customized with CONFIG_KERNEL_BIN_NAME.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config BUILD_OUTPUT_S19
bool "Build a binary in S19 format"
help
Kconfig.zephyr: help text fixes The text "need by some platforms" in various CONFIG_BUILD_OUTPUT_FOO help is grammatically incorrect. Fix this by rewording. Move 'config BUILD_NO_GAP_FILL' to before the list of 'config BUILD_OUTPUT_FOO' definitions instead of sandwiching it inside. Fix the extension of the stripped binary. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-06 23:57:17 +02:00
Build an S19 binary zephyr/zephyr.s19 in the build directory.
The name of this file can be customized with CONFIG_KERNEL_BIN_NAME.
kconfig: cmake: Support for images without gaps. Defines a Kconfig variable which allows the user to specify that any generated hex/bin/s19 file should not have filled gaps. This is done to support building in a multi image context, where several image files will be merged together. Signed-off-by: Håkon Øye Amundsen <haakon.amundsen@nordicsemi.no>
2018-11-26 10:47:16 +01:00
cmake: Add UF2 as an additional build output option. Add ability to build a UF2 (https://github.com/Microsoft/uf2) image as an additional output type. This leverages the code partition offset for the UF2 base address, and a configurable UF2 family ID. Includes an unmodified (except for headers for licensing, pylit disabling) version of the uf2conv.py script copied the UF2 format specification repository, used to convert the bin to UF2. Origin: UF2 file format specification reference utilies License: MIT URL: https://github.com/microsoft/uf2/blob/master/utils/uf2conv.py commit: 587abb8b909266e9b468d6284f2fbd425235d1b5 Signed-off-by: Pete Johanson <peter@peterjohanson.com>
2020-12-31 22:51:52 +01:00
config BUILD_OUTPUT_UF2
bool "Build a binary in UF2 format"
depends on BUILD_OUTPUT_BIN
help
Build a UF2 binary zephyr/zephyr.uf2 in the build directory.
The name of this file can be customized with CONFIG_KERNEL_BIN_NAME.
if BUILD_OUTPUT_UF2
config BUILD_OUTPUT_UF2_FAMILY_ID
soc: Add standard UF2 family IDs for supported SoCs. Defaults from https://github.com/Microsoft/uf2#family-list Signed-off-by: Pete Johanson <peter@peterjohanson.com>
2021-02-16 15:35:11 +01:00
string "UF2 device family ID"
default "0x1c5f21b0" if SOC_ESP32
soc: Add UF2 family ID for nRF52833 ID from https://github.com/Microsoft/uf2#family-list Signed-off-by: Xudong Zheng <7pkvm5aw@slicealias.com>
2022-03-22 17:15:50 +01:00
default "0x621e937a" if SOC_NRF52833_QIAA
soc: Add standard UF2 family IDs for supported SoCs. Defaults from https://github.com/Microsoft/uf2#family-list Signed-off-by: Pete Johanson <peter@peterjohanson.com>
2021-02-16 15:35:11 +01:00
default "0xada52840" if SOC_NRF52840_QIAA
default "0x4fb2d5bd" if SOC_SERIES_IMX_RT
default "0x2abc77ec" if SOC_SERIES_LPC55XXX
soc: rp2040: Added UF2 output file support Added support for the UF2 file format for the RP2040 SoC Signed-off-by: Yonatan Schachter <yonatan.schachter@gmail.com>
2022-02-01 22:05:04 +01:00
default "0xe48bff56" if SOC_SERIES_RP2XXX
soc: Add standard UF2 family IDs for supported SoCs. Defaults from https://github.com/Microsoft/uf2#family-list Signed-off-by: Pete Johanson <peter@peterjohanson.com>
2021-02-16 15:35:11 +01:00
default "0x68ed2b88" if SOC_SERIES_SAMD21
default "0x55114460" if SOC_SERIES_SAMD51
default "0x647824b6" if SOC_SERIES_STM32F0X
default "0x5d1a0a2e" if SOC_SERIES_STM32F2X
default "0x6b846188" if SOC_SERIES_STM32F3X
default "0x53b80f00" if SOC_SERIES_STM32F7X
default "0x300f5633" if SOC_SERIES_STM32G0X
default "0x4c71240a" if SOC_SERIES_STM32G4X
default "0x6db66082" if SOC_SERIES_STM32H7X
default "0x202e3a91" if SOC_SERIES_STM32L0X
default "0x1e1f432d" if SOC_SERIES_STM32L1X
default "0x00ff6919" if SOC_SERIES_STM32L4X
default "0x04240bdf" if SOC_SERIES_STM32L5X
default "0x70d16653" if SOC_SERIES_STM32WBX
default "0x5ee21072" if SOC_STM32F103XE
default "0x57755a57" if SOC_STM32F401XC || SOC_STM32F401XE
default "0x6d0922fa" if SOC_STM32F407XE
default "0x8fb060fe" if SOC_STM32F407XG
cmake: Add UF2 as an additional build output option. Add ability to build a UF2 (https://github.com/Microsoft/uf2) image as an additional output type. This leverages the code partition offset for the UF2 base address, and a configurable UF2 family ID. Includes an unmodified (except for headers for licensing, pylit disabling) version of the uf2conv.py script copied the UF2 format specification repository, used to convert the bin to UF2. Origin: UF2 file format specification reference utilies License: MIT URL: https://github.com/microsoft/uf2/blob/master/utils/uf2conv.py commit: 587abb8b909266e9b468d6284f2fbd425235d1b5 Signed-off-by: Pete Johanson <peter@peterjohanson.com>
2020-12-31 22:51:52 +01:00
help
UF2 bootloaders only accept UF2 files with a matching family ID.
This can be either a hex, e.g. 0x68ed2b88, or well-known family
soc: Add standard UF2 family IDs for supported SoCs. Defaults from https://github.com/Microsoft/uf2#family-list Signed-off-by: Pete Johanson <peter@peterjohanson.com>
2021-02-16 15:35:11 +01:00
name string. If the SoC in use is known by UF2, the Family ID will
be pre-filled with the known value.
cmake: Add UF2 as an additional build output option. Add ability to build a UF2 (https://github.com/Microsoft/uf2) image as an additional output type. This leverages the code partition offset for the UF2 base address, and a configurable UF2 family ID. Includes an unmodified (except for headers for licensing, pylit disabling) version of the uf2conv.py script copied the UF2 format specification repository, used to convert the bin to UF2. Origin: UF2 file format specification reference utilies License: MIT URL: https://github.com/microsoft/uf2/blob/master/utils/uf2conv.py commit: 587abb8b909266e9b468d6284f2fbd425235d1b5 Signed-off-by: Pete Johanson <peter@peterjohanson.com>
2020-12-31 22:51:52 +01:00
build: uf2: Flexible UF2 offset selection. UF2 offset configurable to be either flash base reg + offset, or simply the flash bare reg if the offset is configured to be ignored. Signed-off-by: Peter Johanson <peter@peterjohanson.com>
2022-01-27 06:45:27 +01:00
config BUILD_OUTPUT_UF2_USE_FLASH_BASE
bool
default n
config BUILD_OUTPUT_UF2_USE_FLASH_OFFSET
bool
default n
cmake: Add UF2 as an additional build output option. Add ability to build a UF2 (https://github.com/Microsoft/uf2) image as an additional output type. This leverages the code partition offset for the UF2 base address, and a configurable UF2 family ID. Includes an unmodified (except for headers for licensing, pylit disabling) version of the uf2conv.py script copied the UF2 format specification repository, used to convert the bin to UF2. Origin: UF2 file format specification reference utilies License: MIT URL: https://github.com/microsoft/uf2/blob/master/utils/uf2conv.py commit: 587abb8b909266e9b468d6284f2fbd425235d1b5 Signed-off-by: Pete Johanson <peter@peterjohanson.com>
2020-12-31 22:51:52 +01:00
endif # BUILD_OUTPUT_UF2
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config BUILD_OUTPUT_STRIPPED
bool "Build a stripped binary"
help
Kconfig.zephyr: help text fixes The text "need by some platforms" in various CONFIG_BUILD_OUTPUT_FOO help is grammatically incorrect. Fix this by rewording. Move 'config BUILD_NO_GAP_FILL' to before the list of 'config BUILD_OUTPUT_FOO' definitions instead of sandwiching it inside. Fix the extension of the stripped binary. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-06 23:57:17 +02:00
Build a stripped binary zephyr/zephyr.strip in the build directory.
The name of this file can be customized with CONFIG_KERNEL_BIN_NAME.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
cmake: support ELF image adjustment This commit adds support for adjust the addresses of the final image. This is useful when the image is to be flashed at a location different from the LMA address encoded in the ELF file by the linker. An example use-case is multicore systems where core A might load image from a flash partition into RAM in order for core B to execute and load, but where the image itself is build with the RAM addresses as LMA. It updates the zephyr_image_info.h header with information of adjustment value. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2022-01-12 14:21:07 +01:00
config BUILD_OUTPUT_ADJUST_LMA
string
help
This will adjust the LMA address in the final ELF and hex files with
the value provided.
This will not affect the internal address symbols inside the image but
can be useful when adjusting the LMA address for flash tools or multi
stage loaders where a pre-loader may copy image to a second location
before booting a second core.
The value will be evaluated as a math expression, this means that
following are valid expression
- 1024
- 0x1000
- -0x1000
- 0x20000000 - 0x10000000
Note: negative numbers are valid.
To adjust according to a chosen flash partition one can specify a
default as:
DT_CHOSEN_IMAGE_<name> := <name>,<name>-partition
DT_CHOSEN_Z_FLASH := zephyr,flash
config BUILD_OUTPUT_ADJUST_LMA
default "$(dt_chosen_reg_addr_hex,$(DT_CHOSEN_IMAGE_M4))-\
$(dt_chosen_reg_addr_hex,$(DT_CHOSEN_Z_FLASH))"
scripts: generate image info header file This commit adds the `gen_image_info.py` script which supports creation of a header file with image information from the EFL file. This version populates the header file with: - Number of segments in the image - LMA address of each segment - VMA address of each segment - Size of each segment The header file can be used by a secondary build system which needs this information. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2022-01-10 11:02:26 +01:00
config BUILD_OUTPUT_INFO_HEADER
bool "Create a image information header"
help
Create an image information header which will contain image
information from the Zephyr binary.
Example of information contained in the header file:
- Number of segments in the image
- LMA address of each segment
- VMA address of each segment
- Size of each segment
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config APPLICATION_DEFINED_SYSCALL
bool "Scan application folder for any syscall definition"
help
Scan additional folders inside application source folder
for application defined syscalls.
cmake: Add option for exporting build metadata to Make Add an opt-in feature that will generate a Makefile with build variables like CC, and KBUILD_CFLAGS for consumption by third-party Make-based build systems. This emulates the 'outputexports' target that KBuild supported and is supported for the same reasons that KBuild supported it. Easier integration with third-party build systems. Signed-off-by: Sebastian Bøe <sebastian.boe@nordicsemi.no>
2019-10-17 14:25:34 +02:00
config MAKEFILE_EXPORTS
bool "Generate build metadata files named Makefile.exports"
help
Generates a file with build information that can be read by
third party Makefile-based build systems.
scripts: support for build meta file creation This commit is motivated by the west discussion in: https://github.com/zephyrproject-rtos/west/issues/548 The commit provides the ability to generate a build meta info file containing lists of: - Zephyr: path and revision - Zephyr modules: name, path, and revision - West: manifest path path and revision for each project For Zephyr or Zephyr modules the revision will be `null` if it is not under git version control. If Zephyr, a modules, or a project has uncommitted changes, the revision will be marked dirty. If west is not installed or used for the build process, the west-projects list will be empty. If a project is both a Zephyr module and a west project it will show up in both lists. Similar to Zephyr, which is independently referred as the Zephyr in use but also listed as west project when west is used. This is important in case ZEPHYR_BASE was manually set and pointing to a different Zephyr repository. The build meta file is not created per default but can be enabled with the BUILD_OUTPUT_META Kconfig setting. A project using west and having an extra Zephyr module loaded not controlled using git can look like: zephyr: path: /.../zephyr revision: 863600cd0e3c0a271e86629c5089821e5e4380cc-dirty modules: - name: mcuboot path: /.../bootloader/mcuboot revision: c61538748ead773ea75a551a7beee299228bdcaf - name: local_module path: /.../local_module revision: null west: manifest: /.../zephyr/west.yml projects: - path: /.../zephyr revision: 863600cd0e3c0a271e86629c5089821e5e4380cc-dirty - path: /.../bootloader/mcuboot revision: c61538748ead773ea75a551a7beee299228bdcaf - path: /.../tools/net-tools revision: f49bd1354616fae4093bf36e5eaee43c51a55127 And without west: zephyr: path: /.../zephyr revision: 863600cd0e3c0a271e86629c5089821e5e4380cc-dirty modules: - name: hal_nordic path: /.../modules/hal/nordic revision: a6e5299041f152da5ae0ab17b2e44e088bb96d6d west: null Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-10-12 23:08:36 +02:00
config BUILD_OUTPUT_META
bool "Create a build meta file"
help
Create a build meta file in the build directory containing lists of:
- Zephyr: path and revision (if git repo)
- Zephyr modules: name, path, and revision (if git repo)
scripts: build meta file workspace status extension The PR #39382 raised a discussion on build reproducibility and knowledge of west projects being out of sync with the west manifest. Similar to how `git submodules` will report the working tree dirty if any of the submodules HEAD points to a SHA different than the one recorded in the super project. Based on this discussion this commit extends the Zephyr build meta file with overall workspace status included in the meta file. It adds the following meta info to the build meta file: > workspace: > dirty: false / true > extra: false / true > off: false / true A project using west and having an extra Zephyr module loaded not controlled using git and a west project at a SHA different than the SHA referenced by the manifest can look like: zephyr: path: /.../zephyr revision: 863600cd0e3c0a271e86629c5089821e5e4380cc modules: - name: mcuboot path: /.../bootloader/mcuboot revision: c61538748ead773ea75a551a7beee299228bdcaf - name: local_module path: /.../local_module revision: null west: manifest: /.../zephyr/west.yml projects: - path: /.../zephyr revision: 863600cd0e3c0a271e86629c5089821e5e4380cc - path: /.../bootloader/mcuboot revision: c61538748ead773ea75a551a7beee299228bdcaf-off - path: /.../tools/net-tools revision: f49bd1354616fae4093bf36e5eaee43c51a55127 workspace: dirty: false extra: true 'off': true And without west: zephyr: path: /.../zephyr revision: 863600cd0e3c0a271e86629c5089821e5e4380cc modules: - name: hal_nordic path: /.../modules/hal/nordic revision: a6e5299041f152da5ae0ab17b2e44e088bb96d6d - name: local_module path: /.../local_module revision: null workspace: dirty: false extra: true Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-11-04 14:28:21 +01:00
- West:
- manifest: path and revision
- projects: path and revision
- Workspace:
- dirty: one or more repositories are marked dirty
- extra: extra Zephyr modules are manually included in the build
- off: the SHA of one or more west projects are not what the manifest
defined when `west update` was run the last time (`manifest-rev`).
The off state is only present if a west workspace is found.
scripts: support for build meta file creation This commit is motivated by the west discussion in: https://github.com/zephyrproject-rtos/west/issues/548 The commit provides the ability to generate a build meta info file containing lists of: - Zephyr: path and revision - Zephyr modules: name, path, and revision - West: manifest path path and revision for each project For Zephyr or Zephyr modules the revision will be `null` if it is not under git version control. If Zephyr, a modules, or a project has uncommitted changes, the revision will be marked dirty. If west is not installed or used for the build process, the west-projects list will be empty. If a project is both a Zephyr module and a west project it will show up in both lists. Similar to Zephyr, which is independently referred as the Zephyr in use but also listed as west project when west is used. This is important in case ZEPHYR_BASE was manually set and pointing to a different Zephyr repository. The build meta file is not created per default but can be enabled with the BUILD_OUTPUT_META Kconfig setting. A project using west and having an extra Zephyr module loaded not controlled using git can look like: zephyr: path: /.../zephyr revision: 863600cd0e3c0a271e86629c5089821e5e4380cc-dirty modules: - name: mcuboot path: /.../bootloader/mcuboot revision: c61538748ead773ea75a551a7beee299228bdcaf - name: local_module path: /.../local_module revision: null west: manifest: /.../zephyr/west.yml projects: - path: /.../zephyr revision: 863600cd0e3c0a271e86629c5089821e5e4380cc-dirty - path: /.../bootloader/mcuboot revision: c61538748ead773ea75a551a7beee299228bdcaf - path: /.../tools/net-tools revision: f49bd1354616fae4093bf36e5eaee43c51a55127 And without west: zephyr: path: /.../zephyr revision: 863600cd0e3c0a271e86629c5089821e5e4380cc-dirty modules: - name: hal_nordic path: /.../modules/hal/nordic revision: a6e5299041f152da5ae0ab17b2e44e088bb96d6d west: null Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-10-12 23:08:36 +02:00
File extension is .meta
scripts: support propagating workspace status to zephyr revision The PR #39382 raised a discussion on build reproducibility and knowledge of west projects being out of sync with the west manifest. Similar to how `git submodules` will report the working tree dirty if any of the submodules HEAD points to a SHA different than the one recorded in the super project. Based on this discussion this commit extends the Zephyr and manifest repo (when `west` is used) revisions to include the concatenated states of the workspace. The workspace states are: > dirty: false / true > extra: false / true > off: false / true the final revision will become: <SHA>-<state1>-<state2>-<state3> For example: > zephyr: > path: /.../zephyr > revision: <SHA>-dirty-extra-off or > zephyr: > path: /.../zephyr > revision: <SHA>-extra The `BUILD_OUTPUT_META_STATE_PROPAGATE` Kconfig setting is introduced to provide user control of this behavior. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-11-04 18:35:50 +01:00
config BUILD_OUTPUT_META_STATE_PROPAGATE
bool "Propagate module and project state"
depends on BUILD_OUTPUT_META
help
Propagate to state of each module to the Zephyr revision field.
If west is used the state of each west project is also propagated to
the Zephyr revision field.
West manifest repo revision field will also
be marked with the same state as the Zephyr revision.
The final revision will become: <SHA>-<state1>-<state2>-<state3>...
If no states are appended to the SHA it means the build is of a clean
tree.
- dirty: one or more repositories are marked dirty
- extra: extra Zephyr modules are manually included in the build
- off: the SHA of one or more west projects are not what the manifest
defined when `west update` was run the last time (`manifest-rev`).
The off state is only present if a west workspace is found.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
endmenu
kconfig: add support for warnings when using experimental features This adds two new Kconfig settings. The first setting `EXPERIMENTAL` which is a promptless symbol. This symbol must be selected by any setting which is used to enable an experimental feature. The second setting is `WARN_EXPERIMENTAL` which is a user controlled setting that configures the build system to print a warning when experimental features are enabled. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-03-22 14:29:38 +01:00
kconfig: add support for warnings when enabling deprecated features This adds two new Kconfig settings. The first setting `DEPRECATED` which is a promptless symbol. This symbol must be selected by any deprecated setting when enabled. The second setting is `WARN_DEPRECATED` which is a user controlled setting that configures the build system to print a warning when a deprecated feature is enabled. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2022-07-15 12:05:04 +02:00
config DEPRECATED
bool
help
Symbol that must be selected by a feature or module if it is
considered to be deprecated.
config WARN_DEPRECATED
bool
default y
prompt "Warn on deprecated usage"
help
Print a warning when the Kconfig tree is parsed if any deprecated
features are enabled.
kconfig: add support for warnings when using experimental features This adds two new Kconfig settings. The first setting `EXPERIMENTAL` which is a promptless symbol. This symbol must be selected by any setting which is used to enable an experimental feature. The second setting is `WARN_EXPERIMENTAL` which is a user controlled setting that configures the build system to print a warning when experimental features are enabled. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2021-03-22 14:29:38 +01:00
config EXPERIMENTAL
bool
help
Symbol that must be selected by a feature if it is considered to be
at an experimental implementation stage.
config WARN_EXPERIMENTAL
bool
prompt "Warn on experimental usage"
help
Print a warning when the Kconfig tree is parsed if any experimental
features are enabled.
blobs: Introduce TAINT and TAINT_BLOBS Kconfig options In order to ensure that builds properly reflect the use of binary blobs, it is important to markt the build as tainted. For that purpose introduce two new Kconfig options that ultimately will be reflected in the build image itself. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2022-08-22 18:38:16 +02:00
config TAINT
bool
help
Symbol that must be selected by a feature or module if the Zephyr
build is considered tainted.
build: make Zephyr stdint convention enforcing configurable There are few cases where removing this enforcement is desirable: - linking against binary C++ libs with incompatible type mangling - linking against system provided headers i.e. native_posix - compiling with legacy code that assumes a different convention So let's create a Kconfig symbol for it. This is IMHO a good compromize compared to using the %"PRId32" abomination everywhere otherwise. Signed-off-by: Nicolas Pitre <npitre@baylibre.com>
2022-06-20 19:18:14 +02:00
config ENFORCE_ZEPHYR_STDINT
bool
prompt "Enforce Zephyr convention for stdint"
depends on !ARCH_POSIX
default y
help
This enforces the Zephyr stdint convention where int32_t = int,
int64_t = long long, and intptr_t = long so that short string
format length modifiers can be used universally across ILP32
and LP64 architectures. Sometimes this is not possible e.g. when
linking against a binary-only C++ library whose type mangling
is incompatible with the Zephyr convention, or if the build
environment doesn't allow such enforcement, in which case this
should be turned off with the caveat that argument type validation
on Zephyr code will be skipped.
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
endmenu
menu "Boot Options"
config IS_BOOTLOADER
bool "Act as a bootloader"
depends on XIP
depends on ARM
help
This option indicates that Zephyr will act as a bootloader to execute
a separate Zephyr image payload.
config BOOTLOADER_SRAM_SIZE
int "SRAM reserved for bootloader"
default 16
depends on !XIP || IS_BOOTLOADER
dts: intel_s1000: Exclude sram space dedicated for mcubootloader The starting 192kB SRAM is reserved for the mcubootloader. Exclude this region while building an application to be loaded by mcubootloader. Signed-off-by: Rajavardhan Gundi <rajavardhan.gundi@intel.com>
2018-12-14 12:25:43 +01:00
depends on ARM || XTENSA
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
help
This option specifies the amount of SRAM (measure in kB) reserved for
a bootloader image, when either:
- the Zephyr image itself is to act as the bootloader, or
- Zephyr is a !XIP image, which implicitly assumes existence of a
bootloader that loads the Zephyr !XIP image onto SRAM.
kconfig: hide option for mcuboot support if image is mcuboot Don't show the option for MCUBoot bootloader support when the image being built is MCUBoot itself. Signed-off-by: Håkon Øye Amundsen <haakon.amundsen@nordicsemi.no>
2020-09-17 14:05:15 +02:00
config MCUBOOT
bool
help
Hidden option used to indicate that the current image is MCUBoot
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config BOOTLOADER_MCUBOOT
bool "MCUboot bootloader support"
kconfig: Rename USE_CODE_PARTITION to USE_DT_CODE_PARTITION USE_CODE_PARTITION is a bit vague as a symbol name ("use code partition how?"). Rename it to USE_DT_CODE_PARTITION to make it clearer that it's about devicetree. This would break any third-party configuration files that set it, but it'll generate an error since kconfig.py promotes warnings to errors, so it's probably not a big deal. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-11-16 01:22:16 +01:00
select USE_DT_CODE_PARTITION
zephyr: make images loaded by MCUboot enable arch core HW regs init Instruct Zephyr images that are loaded by MCUboot to force the initialization of architecture core HW registers, if the architecture supports the functionality. Signed-off-by: Ioannis Glaropoulos <Ioannis.Glaropoulos@nordicsemi.no>
2020-10-21 15:56:38 +02:00
imply INIT_ARCH_HW_AT_BOOT if ARCH_SUPPORTS_ARCH_HW_INIT
kconfig: hide option for mcuboot support if image is mcuboot Don't show the option for MCUBoot bootloader support when the image being built is MCUBoot itself. Signed-off-by: Håkon Øye Amundsen <haakon.amundsen@nordicsemi.no>
2020-09-17 14:05:15 +02:00
depends on !MCUBOOT
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
help
This option signifies that the target uses MCUboot as a bootloader,
or in other words that the image is to be chain-loaded by MCUboot.
This sets several required build system and Device Tree options in
order for the image generated to be bootable using the MCUboot open
source bootloader. Currently this includes:
config: Rename TEXT_SECTION_OFFSET to ROM_START_OFFSET The `TEXT_SECTION_OFFSET` symbol is used to specify the offset between the beginning of the ROM area and the address of the first ROM section. This commit renames `TEXT_SECTION_OFFSET` to `ROM_START_OFFSET` because the first ROM section is not always the `.text` section. Signed-off-by: Stephanos Ioannidis <root@stephanos.io>
2020-02-10 08:37:24 +01:00
* Setting ROM_START_OFFSET to a default value that allows space
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
for the MCUboot image header
Kconfig: update BOOTLOADER_MCUBOOT help message Description was updated so reflects fact that this option activates SW_VECTOR_RELAY_CLIENT feature now. Signed-off-by: Andrzej Puzdrowski <andrzej.puzdrowski@nordicsemi.no>
2020-07-03 16:01:33 +02:00
* Activating SW_VECTOR_RELAY_CLIENT on Cortex-M0
(or Armv8-M baseline) targets with no built-in vector relocation
mechanisms
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
zephyr: make images loaded by MCUboot enable arch core HW regs init Instruct Zephyr images that are loaded by MCUboot to force the initialization of architecture core HW registers, if the architecture supports the functionality. Signed-off-by: Ioannis Glaropoulos <Ioannis.Glaropoulos@nordicsemi.no>
2020-10-21 15:56:38 +02:00
By default, this option instructs Zephyr to initialize the core
architecture HW registers during boot, when this is supported by
the application. This removes the need by MCUboot to reset
the core registers' state itself.
build: auto-generate signed mcuboot binaries Add new Kconfig options which depend on CONFIG_BOOTLOADER_MCUBOOT: - CONFIG_MCUBOOT_SIGNATURE_KEY_FILE: the path to the key pair which should be used to sign the image, in PEM format. This is sent to imgtool via 'west sign' when set to produce zephyr.signed.bin and zephyr.signed.hex files as needed. - CONFIG_MCUBOOT_EXTRA_IMGTOOL_ARGS: additional arguments to pass to imgtool. - CONFIG_MCUBOOT_GENERATE_CONFIRMED_IMAGE: also generate zephyr.signed.confirmed.{bin,hex} Add build system support for these options. This makes a separate 'west sign' step unnecessary when using MCUboot, if the application image is properly configured with the location of the key file. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-18 20:28:04 +02:00
if BOOTLOADER_MCUBOOT
config MCUBOOT_SIGNATURE_KEY_FILE
string "Path to the mcuboot signing key file"
default ""
module: mcuboot: Add config option to support unsigned binary generation This commit adds a change to support running west sign command even if the keyfile is not provided. Default value of the configuration is set to n in order to maintain backward compatibility. Signed-off-by: Shubham Kulkarni <shubham.kulkarni@espressif.com>
2021-08-30 13:44:49 +02:00
depends on !MCUBOOT_GENERATE_UNSIGNED_IMAGE
build: auto-generate signed mcuboot binaries Add new Kconfig options which depend on CONFIG_BOOTLOADER_MCUBOOT: - CONFIG_MCUBOOT_SIGNATURE_KEY_FILE: the path to the key pair which should be used to sign the image, in PEM format. This is sent to imgtool via 'west sign' when set to produce zephyr.signed.bin and zephyr.signed.hex files as needed. - CONFIG_MCUBOOT_EXTRA_IMGTOOL_ARGS: additional arguments to pass to imgtool. - CONFIG_MCUBOOT_GENERATE_CONFIRMED_IMAGE: also generate zephyr.signed.confirmed.{bin,hex} Add build system support for these options. This makes a separate 'west sign' step unnecessary when using MCUboot, if the application image is properly configured with the location of the key file. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-18 20:28:04 +02:00
help
The file contains a key pair whose public half is verified
by your target's MCUboot image. The file is in PEM format.
If set to a non-empty value, the build system tries to
sign the final binaries using a 'west sign -t imgtool' command.
The signed binaries are placed in the build directory
at zephyr/zephyr.signed.bin and zephyr/zephyr.signed.hex.
The file names can be customized with CONFIG_KERNEL_BIN_NAME.
The existence of bin and hex files depends on CONFIG_BUILD_OUTPUT_BIN
and CONFIG_BUILD_OUTPUT_HEX.
kconfig: Add option for encryption of binaries Introduce new Kconfig option MCUBOOT_ENCRYPTION_KEY_FILE. If the string is not empty Cmake will try to encrypt the final binaries using the given key file. Signed-off-by: Helge Juul <helge@fastmail.com>
2021-08-10 10:59:00 +02:00
This option should contain a path to the same file as the
BOOT_SIGNATURE_KEY_FILE option in your MCUboot .config. The path
may be absolute or relative to the west workspace topdir. (The MCUboot
config option is used for the MCUboot bootloader image; this option is
for your application which is to be loaded by MCUboot. The MCUboot
config option can be a relative path from the MCUboot repository
root.)
build: auto-generate signed mcuboot binaries Add new Kconfig options which depend on CONFIG_BOOTLOADER_MCUBOOT: - CONFIG_MCUBOOT_SIGNATURE_KEY_FILE: the path to the key pair which should be used to sign the image, in PEM format. This is sent to imgtool via 'west sign' when set to produce zephyr.signed.bin and zephyr.signed.hex files as needed. - CONFIG_MCUBOOT_EXTRA_IMGTOOL_ARGS: additional arguments to pass to imgtool. - CONFIG_MCUBOOT_GENERATE_CONFIRMED_IMAGE: also generate zephyr.signed.confirmed.{bin,hex} Add build system support for these options. This makes a separate 'west sign' step unnecessary when using MCUboot, if the application image is properly configured with the location of the key file. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-18 20:28:04 +02:00
If left empty, you must sign the Zephyr binaries manually.
kconfig: Add option for encryption of binaries Introduce new Kconfig option MCUBOOT_ENCRYPTION_KEY_FILE. If the string is not empty Cmake will try to encrypt the final binaries using the given key file. Signed-off-by: Helge Juul <helge@fastmail.com>
2021-08-10 10:59:00 +02:00
config MCUBOOT_ENCRYPTION_KEY_FILE
string "Path to the mcuboot encryption key file"
default ""
depends on MCUBOOT_SIGNATURE_KEY_FILE != ""
help
The file contains the public key that is used to encrypt the
ephemeral key that encrypts the image. The corresponding
private key is hard coded in the MCUboot source code and is
used to decrypt the ephemeral key that is embedded in the
image. The file is in PEM format.
If set to a non-empty value, the build system tries to
sign and encrypt the final binaries using a 'west sign -t imgtool'
command. The binaries are placed in the build directory at
zephyr/zephyr.signed.encrypted.bin and
zephyr/zephyr.signed.encrypted.hex.
The file names can be customized with CONFIG_KERNEL_BIN_NAME.
The existence of bin and hex files depends on CONFIG_BUILD_OUTPUT_BIN
and CONFIG_BUILD_OUTPUT_HEX.
This option should either be an absolute path or a path relative to
the west workspace topdir.
Example: './bootloader/mcuboot/enc-rsa2048-pub.pem'
If left empty, you must encrypt the Zephyr binaries manually.
build: auto-generate signed mcuboot binaries Add new Kconfig options which depend on CONFIG_BOOTLOADER_MCUBOOT: - CONFIG_MCUBOOT_SIGNATURE_KEY_FILE: the path to the key pair which should be used to sign the image, in PEM format. This is sent to imgtool via 'west sign' when set to produce zephyr.signed.bin and zephyr.signed.hex files as needed. - CONFIG_MCUBOOT_EXTRA_IMGTOOL_ARGS: additional arguments to pass to imgtool. - CONFIG_MCUBOOT_GENERATE_CONFIRMED_IMAGE: also generate zephyr.signed.confirmed.{bin,hex} Add build system support for these options. This makes a separate 'west sign' step unnecessary when using MCUboot, if the application image is properly configured with the location of the key file. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-18 20:28:04 +02:00
config MCUBOOT_EXTRA_IMGTOOL_ARGS
string "Extra arguments to pass to imgtool"
default ""
help
If CONFIG_MCUBOOT_SIGNATURE_KEY_FILE is a non-empty string,
you can use this option to pass extra options to imgtool.
For example, you could set this to "--version 1.2".
module: mcuboot: Add config option to support unsigned binary generation This commit adds a change to support running west sign command even if the keyfile is not provided. Default value of the configuration is set to n in order to maintain backward compatibility. Signed-off-by: Shubham Kulkarni <shubham.kulkarni@espressif.com>
2021-08-30 13:44:49 +02:00
config MCUBOOT_GENERATE_UNSIGNED_IMAGE
bool "Generate unsigned binary image bootable with MCUboot"
help
Enabling this configuration allows automatic unsigned binary image
generation when MCUboot signing key is not provided,
i.e., MCUBOOT_SIGNATURE_KEY_FILE is left empty.
build: auto-generate signed mcuboot binaries Add new Kconfig options which depend on CONFIG_BOOTLOADER_MCUBOOT: - CONFIG_MCUBOOT_SIGNATURE_KEY_FILE: the path to the key pair which should be used to sign the image, in PEM format. This is sent to imgtool via 'west sign' when set to produce zephyr.signed.bin and zephyr.signed.hex files as needed. - CONFIG_MCUBOOT_EXTRA_IMGTOOL_ARGS: additional arguments to pass to imgtool. - CONFIG_MCUBOOT_GENERATE_CONFIRMED_IMAGE: also generate zephyr.signed.confirmed.{bin,hex} Add build system support for these options. This makes a separate 'west sign' step unnecessary when using MCUboot, if the application image is properly configured with the location of the key file. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-18 20:28:04 +02:00
config MCUBOOT_GENERATE_CONFIRMED_IMAGE
cmake: mcuboot: confirmed images needs to be padded Add --pad to imgtool.py command line arguments when generating confirmed images, otherwise the image contains no trailer magic for writing the confirmed status. Signed-off-by: Henrik Brix Andersen <hebad@vestas.com>
2020-09-03 20:37:31 +02:00
bool "Also generate a padded, confirmed image"
build: auto-generate signed mcuboot binaries Add new Kconfig options which depend on CONFIG_BOOTLOADER_MCUBOOT: - CONFIG_MCUBOOT_SIGNATURE_KEY_FILE: the path to the key pair which should be used to sign the image, in PEM format. This is sent to imgtool via 'west sign' when set to produce zephyr.signed.bin and zephyr.signed.hex files as needed. - CONFIG_MCUBOOT_EXTRA_IMGTOOL_ARGS: additional arguments to pass to imgtool. - CONFIG_MCUBOOT_GENERATE_CONFIRMED_IMAGE: also generate zephyr.signed.confirmed.{bin,hex} Add build system support for these options. This makes a separate 'west sign' step unnecessary when using MCUboot, if the application image is properly configured with the location of the key file. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-18 20:28:04 +02:00
help
cmake: mcuboot: confirmed images needs to be padded Add --pad to imgtool.py command line arguments when generating confirmed images, otherwise the image contains no trailer magic for writing the confirmed status. Signed-off-by: Henrik Brix Andersen <hebad@vestas.com>
2020-09-03 20:37:31 +02:00
The signed, padded, and confirmed binaries are placed in the build
directory at zephyr/zephyr.signed.confirmed.bin and
build: auto-generate signed mcuboot binaries Add new Kconfig options which depend on CONFIG_BOOTLOADER_MCUBOOT: - CONFIG_MCUBOOT_SIGNATURE_KEY_FILE: the path to the key pair which should be used to sign the image, in PEM format. This is sent to imgtool via 'west sign' when set to produce zephyr.signed.bin and zephyr.signed.hex files as needed. - CONFIG_MCUBOOT_EXTRA_IMGTOOL_ARGS: additional arguments to pass to imgtool. - CONFIG_MCUBOOT_GENERATE_CONFIRMED_IMAGE: also generate zephyr.signed.confirmed.{bin,hex} Add build system support for these options. This makes a separate 'west sign' step unnecessary when using MCUboot, if the application image is properly configured with the location of the key file. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2020-08-18 20:28:04 +02:00
zephyr/zephyr.signed.confirmed.hex.
The file names can be customized with CONFIG_KERNEL_BIN_NAME.
The existence of bin and hex files depends on CONFIG_BUILD_OUTPUT_BIN
and CONFIG_BUILD_OUTPUT_HEX.
endif # BOOTLOADER_MCUBOOT
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
config BOOTLOADER_ESP_IDF
bool "ESP-IDF bootloader support"
soc: esp32: add support to mcuboot build Select configuration when mcuboot is enabled. At this moment, only UNSIGNED image is supported as per Espressif's mcuboot porting. This also updates esp32 runner to use proper bin_file name and updates default bootloader check. Move CMakeLists.txt content from board to soc directory as this support is for esp32 architecture and not board specific. Signed-off-by: Sylvio Alves <sylvio.alves@espressif.com>
2021-11-27 20:32:00 +01:00
depends on (SOC_ESP32 || SOC_ESP32S2 || SOC_ESP32C3) && !BOOTLOADER_MCUBOOT
default y
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
help
This option will trigger the compilation of the ESP-IDF bootloader
inside the build folder.
At flash time, the bootloader will be flashed with the zephyr image
soc: sam0: add support for the BOSSA bootloader This adds a new config option for SAM0 targets that use the BOSSA bootloader. If the CDC ACM driver is also enabled, then the programmer can automatically reset the board into the bootloader for programming. Signed-off-by: Michael Hope <mlhx@google.com>
2020-06-13 21:32:11 +02:00
config BOOTLOADER_BOSSA
bool "BOSSA bootloader support"
select USE_DT_CODE_PARTITION
help
Signifies that the target uses a BOSSA compatible bootloader. If CDC
ACM USB support is also enabled then the board will reboot into the
bootloader automatically when bossac is run.
config BOOTLOADER_BOSSA_DEVICE_NAME
string "BOSSA CDC ACM device name"
depends on BOOTLOADER_BOSSA && CDC_ACM_DTE_RATE_CALLBACK_SUPPORT
default "CDC_ACM_0"
help
Sets the CDC ACM port to watch for reboot commands.
choice
prompt "BOSSA bootloader variant"
depends on BOOTLOADER_BOSSA
scripts: runners: bossac: Add legacy mode Add compatibility mode with old sam-ba flash bootloaders that don't have offset capabilities. These bootloaders flash to a pre-defined flash region. At end, bossac will suppress --offset parameter. Signed-off-by: Gerson Fernando Budke <nandojve@gmail.com>
2021-05-07 02:20:11 +02:00
config BOOTLOADER_BOSSA_LEGACY
bool "Legacy"
help
Select the Legacy variant of the BOSSA bootloader. This is defined
for compatibility mode only. The recommendation is use newer
versions like Arduino or Adafruit UF2.
soc: sam0: add support for the BOSSA bootloader This adds a new config option for SAM0 targets that use the BOSSA bootloader. If the CDC ACM driver is also enabled, then the programmer can automatically reset the board into the bootloader for programming. Signed-off-by: Michael Hope <mlhx@google.com>
2020-06-13 21:32:11 +02:00
config BOOTLOADER_BOSSA_ARDUINO
bool "Arduino"
help
Select the Arduino variant of the BOSSA bootloader. Uses 0x07738135
as the magic value to enter the bootloader.
config BOOTLOADER_BOSSA_ADAFRUIT_UF2
bool "Adafruit UF2"
help
Select the Adafruit UF2 variant of the BOSSA bootloader. Uses
0xf01669ef as the magic value to enter the bootloader.
endchoice
kconfig: distribute misc/Kconfig option where they belong Move misc/Kconfig options to where they belong. misc/Kconfig was used as a catch-all, but we are now able to put things in a better place. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-11-02 12:12:07 +01:00
endmenu
aarch32: Add header shims to support old file locations Out-of-tree code can still be using the old file locations. Introduce header shims to include the headers from the new correct location and print a warning message. Add also a new Kconfig symbol to suppress such warning. The shim will go away after two releases, so make sure to adapt your application for the new locations. Signed-off-by: Carlo Caione <ccaione@baylibre.com>
2019-12-17 18:13:47 +01:00
menu "Compatibility"
config COMPAT_INCLUDES
bool "Suppress warnings when using header shims"
default y
help
Suppress any warnings from the pre-processor when including
deprecated header files.
endmenu
build: make non zephyr/ include prefix configurable Add a Kconfig to disable non prefixed includes. By setting `CONFIG_LEGACY_INCLUDE_PATH=n` developers can disable having `include/zephyr` in the search path. This means that includes such as `#include <kernel.h>` will no longer work. Internally, every header should be updated to add the `zephyr/` prefix to the headers. Only then, will developers be able to use this config value for their applications. Signed-off-by: Yuval Peress <peress@google.com>
2022-04-01 05:05:42 +02:00
config LEGACY_INCLUDE_PATH
Kconfig: flag LEGACY_INCLUDE_PATH as deprecated Deprecate the LEGACY_INCLUDE_PATH so that it can be removed down the road. Signed-off-by: Fabio Baltieri <fabiobaltieri@google.com>
2022-08-05 08:49:28 +02:00
bool "Allow for the legacy include paths (without the zephyr/ prefix) (DEPRECATED)"
Kconfig: fix "flag LEGACY_INCLUDE_PATH as deprecated" Commit cd7c44a152bc4469ad7da9e38d58df46655d460d ("Kconfig: flag LEGACY_INCLUDE_PATH as deprecated") forgot to select DEPRECATED when deprecating a Kconfig option. Fix it. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2022-08-19 01:21:40 +02:00
select DEPRECATED
build: make non zephyr/ include prefix configurable Add a Kconfig to disable non prefixed includes. By setting `CONFIG_LEGACY_INCLUDE_PATH=n` developers can disable having `include/zephyr` in the search path. This means that includes such as `#include <kernel.h>` will no longer work. Internally, every header should be updated to add the `zephyr/` prefix to the headers. Only then, will developers be able to use this config value for their applications. Signed-off-by: Yuval Peress <peress@google.com>
2022-04-01 05:05:42 +02:00
help
Kconfig: flag LEGACY_INCLUDE_PATH as deprecated Deprecate the LEGACY_INCLUDE_PATH so that it can be removed down the road. Signed-off-by: Fabio Baltieri <fabiobaltieri@google.com>
2022-08-05 08:49:28 +02:00
DEPRECATED: Allow applications and libraries to use the Zephyr legacy
include path which does not use the zephyr/ prefix. For example, the
build: make non zephyr/ include prefix configurable Add a Kconfig to disable non prefixed includes. By setting `CONFIG_LEGACY_INCLUDE_PATH=n` developers can disable having `include/zephyr` in the search path. This means that includes such as `#include <kernel.h>` will no longer work. Internally, every header should be updated to add the `zephyr/` prefix to the headers. Only then, will developers be able to use this config value for their applications. Signed-off-by: Yuval Peress <peress@google.com>
2022-04-01 05:05:42 +02:00
preferred way to include a Zephyr header is to use <zephyr/kernel.h>,
Kconfig: flag LEGACY_INCLUDE_PATH as deprecated Deprecate the LEGACY_INCLUDE_PATH so that it can be removed down the road. Signed-off-by: Fabio Baltieri <fabiobaltieri@google.com>
2022-08-05 08:49:28 +02:00
but enabling CONFIG_LEGACY_INCLUDE_PATH will allow developers to use
<kernel.h> instead. This (without the zephyr/ prefix) is deprecated
and should be avoided. Eventually, it will not be supported.
Reference in a new issue Copy permalink