# Some IDF-specific functions and functions include(crosstool_version_check) # # Set some variables used by rest of the build # # Note at the time this macro is expanded, the config is not yet # loaded and the toolchain and project are not yet set # macro(idf_set_global_variables) # Note that CONFIG_xxx is not available when this function is called set_default(EXTRA_COMPONENT_DIRS "") # PROJECT_PATH has the path to the IDF project (top-level cmake directory) # # (cmake calls this CMAKE_SOURCE_DIR, keeping old name for compatibility.) set(PROJECT_PATH "${CMAKE_SOURCE_DIR}") # Note: "main" is no longer a component... # set_default(COMPONENT_DIRS "${PROJECT_PATH}/components ${EXTRA_COMPONENT_DIRS} ${IDF_PATH}/components") spaces2list(COMPONENT_DIRS) spaces2list(COMPONENTS) # Tell cmake to drop executables in the top-level build dir set(EXECUTABLE_OUTPUT_PATH "${CMAKE_BINARY_DIR}") # path to idf.py tool set(IDFTOOL ${PYTHON} "${IDF_PATH}/tools/idf.py") endmacro() # Add all the IDF global compiler & preprocessor options # (applied to all components). Some are config-dependent # # If you only want to set options for a particular component, # don't call or edit this function. TODO DESCRIBE WHAT TO DO INSTEAD # function(idf_set_global_compiler_options) add_definitions(-DESP_PLATFORM) add_definitions(-DHAVE_CONFIG_H) if(CONFIG_OPTIMIZATION_LEVEL_RELEASE) add_compile_options(-Os) else() add_compile_options(-Og) endif() add_c_compile_options(-std=gnu99) add_cxx_compile_options(-std=gnu++11 -fno-rtti) if(CONFIG_CXX_EXCEPTIONS) add_cxx_compile_options(-fexceptions) else() add_cxx_compile_options(-fno-exceptions) endif() # Default compiler configuration add_compile_options(-ffunction-sections -fdata-sections -fstrict-volatile-bitfields -mlongcalls -nostdlib) # Default warnings configuration add_compile_options( -Wall -Werror=all -Wno-error=unused-function -Wno-error=unused-but-set-variable -Wno-error=unused-variable -Wno-error=deprecated-declarations -Wextra -Wno-unused-parameter -Wno-sign-compare) add_c_compile_options( -Wno-old-style-declaration ) # Stack protection if(NOT BOOTLOADER_BUILD) if(CONFIG_STACK_CHECK_NORM) add_compile_options(-fstack-protector) elseif(CONFIG_STACK_CHECK_STRONG) add_compile_options(-fstack-protector-strong) elseif(CONFIG_STACK_CHECK_ALL) add_compile_options(-fstack-protector-all) endif() endif() if(CONFIG_OPTIMIZATION_ASSERTIONS_DISABLED) add_definitions(-DNDEBUG) endif() # Always generate debug symbols (even in Release mode, these don't # go into the final binary so have no impact on size) add_compile_options(-ggdb) add_compile_options("-I${CMAKE_BINARY_DIR}") # for sdkconfig.h # Enable ccache if it's on the path if(NOT CCACHE_DISABLE) find_program(CCACHE_FOUND ccache) if(CCACHE_FOUND) message(STATUS "ccache will be used for faster builds") set_property(GLOBAL PROPERTY RULE_LAUNCH_COMPILE ccache) endif() endif() endfunction() # Verify the IDF environment is configured correctly (environment, toolchain, etc) function(idf_verify_environment) if(NOT CMAKE_PROJECT_NAME) message(FATAL_ERROR "Internal error, IDF project.cmake should have set this variable already") endif() # Check toolchain is configured properly in cmake if(NOT ( ${CMAKE_SYSTEM_NAME} STREQUAL "Generic" AND ${CMAKE_C_COMPILER} MATCHES xtensa)) message(FATAL_ERROR "Internal error, toolchain has not been set correctly by project") endif() # # Warn if the toolchain version doesn't match # # TODO: make these platform-specific for diff toolchains gcc_version_check("5.2.0") crosstool_version_check("1.22.0-80-g6c4433a") endfunction() # idf_add_executable # # Calls add_executable to add the final project executable # Adds .map & .bin file targets # Sets up flash-related targets function(idf_add_executable) set(exe_target ${PROJECT_NAME}.elf) spaces2list(MAIN_SRCS) add_executable(${exe_target} "${MAIN_SRCS}") add_map_file(${exe_target}) endfunction() # add_map_file # # Set linker args for 'exe_target' to generate a linker Map file function(add_map_file exe_target) get_filename_component(basename ${exe_target} NAME_WE) set(mapfile "${basename}.map") target_link_libraries(${exe_target} "-Wl,--gc-sections -Wl,--cref -Wl,--Map=${mapfile} -Wl,--start-group") set_property(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}" APPEND PROPERTY ADDITIONAL_MAKE_CLEAN_FILES "${CMAKE_CURRENT_BINARY_DIR}/${mapfile}") # add size targets, depend on map file, run idf_size.py add_custom_target(size DEPENDS ${exe_target} COMMAND ${PYTHON} ${IDF_PATH}/tools/idf_size.py ${mapfile} ) add_custom_target(size-files DEPENDS ${exe_target} COMMAND ${PYTHON} ${IDF_PATH}/tools/idf_size.py --files ${mapfile} ) add_custom_target(size-components DEPENDS ${exe_target} COMMAND ${PYTHON} ${IDF_PATH}/tools/idf_size.py --archives ${mapfile} ) endfunction() # component_compile_options # # Wrapper around target_compile_options that passes the component name function(component_compile_options) target_compile_options(${COMPONENT_NAME} PRIVATE ${ARGV}) endfunction() # component_compile_definitions # # Wrapper around target_compile_definitions that passes the component name function(component_compile_definitions) target_compile_definitions(${COMPONENT_NAME} PRIVATE ${ARGV}) endfunction() # idf_get_git_revision # # Set global IDF_VER to the git revision of ESP-IDF. # # Running git_describe() here automatically triggers rebuilds # if the ESP-IDF git version changes function(idf_get_git_revision) git_describe(IDF_VER "${IDF_PATH}") add_definitions(-DIDF_VER=\"${IDF_VER}\") git_submodule_check("${IDF_PATH}") set(IDF_VER ${IDF_VER} PARENT_SCOPE) endfunction()