granicus.if.org Git - esp-idf/blob - Kconfig

   1 #
   2 # For a description of the syntax of this configuration file,
   3 # see kconfig/kconfig-language.txt.
   4 #
   5 mainmenu "Espressif IoT Development Framework Configuration"
   6
   7
   8 menu "SDK tool configuration"
   9 config TOOLPREFIX
  10     string "Compiler toolchain path/prefix"
  11     default "xtensa-esp32-elf-"
  12     help
  13         The prefix/path that is used to call the toolchain. The default setting assumes
  14         a crosstool-ng gcc setup that is in your PATH.
  15
  16 config PYTHON
  17     string "Python 2 interpreter"
  18     default "python"
  19     help
  20         The executable name/path that is used to run python. On some systems Python 2.x
  21         may need to be invoked as python2.
  22 endmenu
  23
  24 source "$COMPONENT_KCONFIGS_PROJBUILD"
  25
  26 menu "Compiler options"
  27
  28 choice OPTIMIZATION_COMPILER
  29     prompt "Optimization Level"
  30     default OPTIMIZATION_LEVEL_DEBUG
  31     help
  32         This option sets compiler optimization level (gcc -O argument).
  33
  34         - for "Release" setting, -Os flag is added to CFLAGS.
  35         - for "Debug" setting, -Og flag is added to CFLAGS.
  36
  37         "Release" with -Os produces smaller & faster compiled code but it
  38         may be harder to correlated code addresses to source files when debugging.
  39
  40         To add custom optimization settings, set CFLAGS and/or CPPFLAGS
  41         in project makefile, before including $(IDF_PATH)/make/project.mk. Note that
  42         custom optimization levels may be unsupported.
  43
  44 config OPTIMIZATION_LEVEL_DEBUG
  45     bool "Debug (-Og)"
  46 config OPTIMIZATION_LEVEL_RELEASE
  47     bool "Release (-Os)"
  48 endchoice
  49
  50 choice OPTIMIZATION_ASSERTION_LEVEL
  51     prompt "Assertion level"
  52     default OPTIMIZATION_ASSERTIONS_ENABLED
  53     help
  54         Assertions can be:
  55         - Enabled. Failure will print verbose assertion details. This is the default.
  56
  57         - Set to "silent" to save code size (failed assertions will abort() but user
  58           needs to use the aborting address to find the line number with the failed assertion.)
  59
  60         - Disabled entirely (not recommended for most configurations.) -DNDEBUG is added
  61           to CPPFLAGS in this case.
  62
  63 config OPTIMIZATION_ASSERTIONS_ENABLED
  64     prompt "Enabled"
  65     bool
  66     help
  67         Enable assertions. Assertion content and line number will be printed on failure.
  68
  69 config OPTIMIZATION_ASSERTIONS_SILENT
  70     prompt "Silent (saves code size)"
  71     bool
  72     help
  73         Enable silent assertions. Failed assertions will abort(), user needs to
  74         use the aborting address to find the line number with the failed assertion.
  75
  76 config OPTIMIZATION_ASSERTIONS_DISABLED
  77     prompt "Disabled (sets -DNDEBUG)"
  78     bool
  79     help
  80         If assertions are disabled, -DNDEBUG is added to CPPFLAGS.
  81
  82 endchoice # assertions
  83
  84 endmenu # Optimization level
  85
  86 menu "Component config"
  87 source "$COMPONENT_KCONFIGS"
  88 endmenu