# # Internal function for retrieving component properties from a component target. # function(__component_get_property var component_target property) get_property(val TARGET ${component_target} PROPERTY ${property}) set(${var} "${val}" PARENT_SCOPE) endfunction() # # Internal function for setting component properties on a component target. As with build properties, # set properties are also keeped track of. # function(__component_set_property component_target property val) cmake_parse_arguments(_ "APPEND" "" "" ${ARGN}) if(__APPEND) set_property(TARGET ${component_target} APPEND PROPERTY ${property} "${val}") else() set_property(TARGET ${component_target} PROPERTY ${property} "${val}") endif() # Keep track of set component properties __component_get_property(properties ${component_target} __COMPONENT_PROPERTIES) if(NOT property IN_LIST properties) __component_set_property(${component_target} __COMPONENT_PROPERTIES ${property} APPEND) endif() endfunction() # # Given a component name or alias, get the corresponding component target. # function(__component_get_target var name_or_alias) # Look at previously resolved names or aliases idf_build_get_property(component_names_resolved __COMPONENT_NAMES_RESOLVED) list(FIND component_names_resolved ${name_or_alias} result) if(NOT result EQUAL -1) # If it has been resolved before, return that value. The index is the same # as in __COMPONENT_NAMES_RESOLVED as these are parallel lists. idf_build_get_property(component_targets_resolved __COMPONENT_TARGETS_RESOLVED) list(GET component_targets_resolved ${result} target) set(${var} ${target} PARENT_SCOPE) return() endif() idf_build_get_property(component_targets __COMPONENT_TARGETS) # Assume first that the paramters is an alias. string(REPLACE "::" "_" name_or_alias "${name_or_alias}") set(component_target ___${name_or_alias}) if(component_target IN_LIST component_targets) set(${var} ${component_target} PARENT_SCOPE) set(target ${component_target}) else() # assumption is wrong, try to look for it manually unset(target) foreach(component_target ${component_targets}) __component_get_property(_component_name ${component_target} COMPONENT_NAME) if(name_or_alias STREQUAL _component_name) # There should only be one component of the same name if(NOT target) set(target ${component_target}) else() message(FATAL_ERROR "Multiple components with name '${name_or_alias}' found.") return() endif() endif() endforeach() set(${var} ${target} PARENT_SCOPE) endif() # Save the resolved name or alias if(target) idf_build_set_property(__COMPONENT_NAMES_RESOLVED ${name_or_alias} APPEND) idf_build_set_property(__COMPONENT_TARGETS_RESOLVED ${target} APPEND) endif() endfunction() # # Called during component registration, sets basic properties of the current component. # macro(__component_set_properties) __component_get_property(type ${component_target} COMPONENT_TYPE) # Fill in the rest of component property __component_set_property(${component_target} SRCS "${sources}") __component_set_property(${component_target} INCLUDE_DIRS "${__INCLUDE_DIRS}") if(type STREQUAL LIBRARY) __component_set_property(${component_target} PRIV_INCLUDE_DIRS "${__PRIV_INCLUDE_DIRS}") endif() __component_set_property(${component_target} LDFRAGMENTS "${__LDFRAGMENTS}") __component_set_property(${component_target} EMBED_FILES "${__EMBED_FILES}") __component_set_property(${component_target} EMBED_TXTFILES "${__EMBED_TXTFILES}") __component_set_property(${component_target} REQUIRED_IDF_TARGETS "${__REQUIRED_IDF_TARGETS}") endmacro() # # Add a component to process in the build. The components are keeped tracked of in property # __COMPONENT_TARGETS in component target form. # function(__component_add component_dir prefix) # For each component, two entities are created: a component target and a component library. The # component library is created during component registration (the actual static/interface library). # On the other hand, component targets are created early in the build # (during adding component as this function suggests). # This is so that we still have a target to attach properties to up until the component registration. # Plus, interface libraries have limitations on the types of properties that can be set on them, # so later in the build, these component targets actually contain the properties meant for the # corresponding component library. idf_build_get_property(component_targets __COMPONENT_TARGETS) get_filename_component(abs_dir ${component_dir} ABSOLUTE) get_filename_component(base_dir ${abs_dir} NAME) set(component_name ${base_dir}) # The component target has three underscores as a prefix. The corresponding component library # only has two. set(component_target ___${prefix}_${component_name}) # If a component of the same name has not been added before If it has been added # before just override the properties. As a side effect, components added later # 'override' components added earlier. if(NOT component_target IN_LIST component_targets) if(NOT TARGET ${component_target}) add_custom_target(${component_target} EXCLUDE_FROM_ALL) endif() idf_build_set_property(__COMPONENT_TARGETS ${component_target} APPEND) endif() set(component_lib __${prefix}_${component_name}) set(component_dir ${abs_dir}) set(component_alias ${prefix}::${component_name}) # The 'alias' of the component library, # used to refer to the component outside # the build system. Users can use this name # to resolve ambiguity with component names # and to link IDF components to external targets. # Set the basic properties of the component __component_set_property(${component_target} COMPONENT_LIB ${component_lib}) __component_set_property(${component_target} COMPONENT_NAME ${component_name}) __component_set_property(${component_target} COMPONENT_DIR ${component_dir}) __component_set_property(${component_target} COMPONENT_ALIAS ${component_alias}) __component_set_property(${component_target} __PREFIX ${prefix}) # Set Kconfig related properties on the component __kconfig_component_init(${component_target}) endfunction() # # Given a component directory, get the requirements by expanding it early. The expansion is performed # using a separate CMake script (the expansion is performed in a separate instance of CMake in scripting mode). # function(__component_get_requirements error requires_var priv_requires_var component_dir) idf_build_get_property(idf_path IDF_PATH) idf_build_get_property(build_properties_file BUILD_PROPERTIES_FILE) idf_build_get_property(idf_target IDF_TARGET) # This function assumes that the directory has been checked to contain a component, thus # no check is performed here. execute_process(COMMAND "${CMAKE_COMMAND}" -D "IDF_PATH=${idf_path}" -D "IDF_TARGET=${idf_target}" -D "COMPONENT_DIR=${component_dir}" -D "BUILD_PROPERTIES_FILE=${build_properties_file}" -D "CMAKE_BUILD_EARLY_EXPANSION=1" -P "${idf_path}/tools/cmake/scripts/component_get_requirements.cmake" RESULT_VARIABLE result ERROR_VARIABLE error ) if(NOT result EQUAL 0) set(error "${error}" PARENT_SCOPE) return() endif() string(REGEX REPLACE ";" "\\\\;" _output "${error}") string(REGEX REPLACE "\n" ";" _output "${_output}") list(REVERSE _output) if(_output) list(GET _output 1 _output) string(REGEX MATCH "\(.*\):::\(.*\)" _output "${_output}") string(REPLACE ":" ";" requires "${CMAKE_MATCH_1}") string(REPLACE ":" ";" priv_requires "${CMAKE_MATCH_2}") endif() set(${requires_var} ${requires} PARENT_SCOPE) set(${priv_requires_var} ${priv_requires} PARENT_SCOPE) endfunction() # __component_add_sources, __component_check_target # # Utility macros for component registration. Adds source files and checks target requirements # respectively. macro(__component_add_sources sources) set(sources "") if(__SRCS) if(__SRC_DIRS) message(WARNING "SRCS and SRC_DIRS are both specified; ignoring SRC_DIRS.") endif() foreach(src ${__SRCS}) get_filename_component(src "${src}" ABSOLUTE BASE_DIR ${COMPONENT_DIR}) list(APPEND sources ${src}) endforeach() else() if(__SRC_DIRS) foreach(dir ${__SRC_DIRS}) get_filename_component(abs_dir ${dir} ABSOLUTE BASE_DIR ${COMPONENT_DIR}) if(NOT IS_DIRECTORY ${abs_dir}) message(FATAL_ERROR "SRC_DIRS entry '${dir}' does not exist.") endif() file(GLOB dir_sources "${abs_dir}/*.c" "${abs_dir}/*.cpp" "${abs_dir}/*.S") if(dir_sources) foreach(src ${dir_sources}) get_filename_component(src "${src}" ABSOLUTE BASE_DIR ${COMPONENT_DIR}) list(APPEND sources "${src}") endforeach() else() message(WARNING "No source files found for SRC_DIRS entry '${dir}'.") endif() endforeach() endif() if(__EXCLUDE_SRCS) foreach(src ${__EXCLUDE_SRCS}) get_filename_component(src "${src}" ABSOLUTE) list(REMOVE_ITEM source "${src}") endforeach() endif() endif() list(REMOVE_DUPLICATES sources) endmacro() macro(__component_check_target) if(__REQUIRED_IDF_TARGETS) idf_build_get_property(idf_target IDF_TARGET) if(NOT idf_target IN_LIST __REQUIRED_IDF_TARGETS) message(FATAL_ERROR "Component ${COMPONENT_NAME} only supports targets: ${__REQUIRED_IDF_TARGETS}") endif() endif() endmacro() # idf_component_get_property # # @brief Retrieve the value of the specified component property # # @param[out] var the variable to store the value of the property in # @param[in] component the component name or alias to get the value of the property of # @param[in] property the property to get the value of # # @param[in, optional] GENERATOR_EXPRESSION (option) retrieve the generator expression for the property # instead of actual value function(idf_component_get_property var component property) cmake_parse_arguments(_ "GENERATOR_EXPRESSION" "" "" ${ARGN}) __component_get_target(component_target ${component}) if(__GENERATOR_EXPRESSION) set(val "$") else() __component_get_property(val ${component_target} ${property}) endif() set(${var} "${val}" PARENT_SCOPE) endfunction() # idf_component_set_property # # @brief Set the value of the specified component property related. The property is # also added to the internal list of component properties if it isn't there already. # # @param[in] component component name or alias of the component to set the property of # @param[in] property the property to set the value of # @param[out] value value of the property to set to # # @param[in, optional] APPEND (option) append the value to the current value of the # property instead of replacing it function(idf_component_set_property component property val) cmake_parse_arguments(_ "APPEND" "" "" ${ARGN}) __component_get_target(component_target ${component}) if(__APPEND) __component_set_property(${component_target} ${property} "${val}" APPEND) else() __component_set_property(${component_target} ${property} "${val}") endif() endfunction() # idf_component_register # # @brief Register a component to the build, creating component library targets etc. # # @param[in, optional] SRCS (multivalue) list of source files for the component # @param[in, optional] SRC_DIRS (multivalue) list of source directories to look for source files # in (.c, .cpp. .S); ignored when SRCS is specified. # @param[in, optional] EXCLUDE_SRCS (multivalue) used to exclude source files for the specified # SRC_DIRS # @param[in, optional] INCLUDE_DIRS (multivalue) public include directories for the created component library # @param[in, optional] PRIV_INCLUDE_DIRS (multivalue) private include directories for the created component library # @param[in, optional] LDFRAGMENTS (multivalue) linker script fragments for the component # @param[in, optional] REQUIRES (multivalue) publicly required components in terms of usage requirements # @param[in, optional] PRIV_REQUIRES (multivalue) privately required components in terms of usage requirements # or components only needed for functions/values defined in its project_include.cmake # @param[in, optional] REQUIRED_IDF_TARGETS (multivalue) the list of IDF build targets that the component only supports # @param[in, optional] EMBED_FILES (multivalue) list of binary files to embed with the component # @param[in, optional] EMBED_TXTFILES (multivalue) list of text files to embed with the component function(idf_component_register) set(options) set(single_value) set(multi_value SRCS SRC_DIRS EXCLUDE_SRCS INCLUDE_DIRS PRIV_INCLUDE_DIRS LDFRAGMENTS REQUIRES PRIV_REQUIRES REQUIRED_IDF_TARGETS EMBED_FILES EMBED_TXTFILES) cmake_parse_arguments(_ "${options}" "${single_value}" "${multi_value}" ${ARGN}) if(NOT __idf_component_context) message(FATAL_ERROR "Called idf_component_register from a non-component directory.") endif() __component_check_target() __component_add_sources(sources) # Create the final target for the component. This target is the target that is # visible outside the build system. __component_get_target(component_target ${COMPONENT_ALIAS}) __component_get_property(component_lib ${component_target} COMPONENT_LIB) # Use generator expression so that users can append/override flags even after call to # idf_build_process idf_build_get_property(include_directories INCLUDE_DIRECTORIES GENERATOR_EXPRESSION) idf_build_get_property(compile_options COMPILE_OPTIONS GENERATOR_EXPRESSION) idf_build_get_property(c_compile_options C_COMPILE_OPTIONS GENERATOR_EXPRESSION) idf_build_get_property(cxx_compile_options CXX_COMPILE_OPTIONS GENERATOR_EXPRESSION) idf_build_get_property(common_reqs ___COMPONENT_REQUIRES_COMMON) include_directories("${include_directories}") add_compile_options("${compile_options}") add_c_compile_options("${c_compile_options}") add_cxx_compile_options("${cxx_compile_options}") # Unfortunately add_definitions() does not support generator expressions. A new command # add_compile_definition() does but is only available on CMake 3.12 or newer. This uses # add_compile_options(), which can add any option as the workaround. # # TODO: Use add_compile_definitions() once minimum supported version is 3.12 or newer. idf_build_get_property(compile_definitions COMPILE_DEFINITIONS GENERATOR_EXPRESSION) add_compile_options("${compile_definitions}") list(REMOVE_ITEM common_reqs ${component_lib}) link_libraries(${common_reqs}) idf_build_get_property(sdkconfig_h SDKCONFIG_HEADER) get_filename_component(sdkconfig_h ${sdkconfig_h} DIRECTORY) # The contents of 'sources' is from the __component_add_sources call if(sources OR __EMBED_FILES OR __EMBED_TXTFILES) add_library(${component_lib} STATIC ${sources}) __component_set_property(${component_target} COMPONENT_TYPE LIBRARY) target_include_directories(${component_lib} PUBLIC ${__INCLUDE_DIRS}) target_include_directories(${component_lib} PRIVATE ${__PRIV_INCLUDE_DIRS}) target_include_directories(${component_lib} PUBLIC ${sdkconfig_h}) set_target_properties(${component_lib} PROPERTIES OUTPUT_NAME ${COMPONENT_NAME}) __ldgen_add_component(${component_lib}) else() add_library(${component_lib} INTERFACE) __component_set_property(${component_target} COMPONENT_TYPE CONFIG_ONLY) target_include_directories(${component_lib} INTERFACE ${__INCLUDE_DIRS}) target_include_directories(${component_lib} INTERFACE ${sdkconfig_h}) endif() # Alias the static/interface library created for linking to external targets. # The alias is the :: name. __component_get_property(component_alias ${component_target} COMPONENT_ALIAS) add_library(${component_alias} ALIAS ${component_lib}) # Perform other component processing, such as embedding binaries and processing linker # script fragments foreach(file ${__EMBED_FILES}) target_add_binary_data(${component_lib} "${file}" "BINARY") endforeach() foreach(file ${__EMBED_TXTFILES}) target_add_binary_data(${component_lib} "${file}" "TEXT") endforeach() if(__LDFRAGMENTS) __ldgen_add_fragment_files("${__LDFRAGMENTS}") endif() # Add the component to built components idf_build_set_property(__BUILD_COMPONENTS ${component_lib} APPEND) idf_build_set_property(BUILD_COMPONENTS ${component_alias} APPEND) # Make the COMPONENT_LIB variable available in the component CMakeLists.txt set(COMPONENT_LIB ${component_lib} PARENT_SCOPE) # COMPONENT_TARGET is deprecated but is made available with same function # as COMPONENT_LIB for compatibility. set(COMPONENT_TARGET ${component_lib} PARENT_SCOPE) endfunction() # # Deprecated functions # # register_component # # Compatibility function for registering 3.xx style components. macro(register_component) spaces2list(COMPONENT_SRCS) spaces2list(COMPONENT_SRCDIRS) spaces2list(COMPONENT_ADD_INCLUDEDIRS) spaces2list(COMPONENT_PRIV_INCLUDEDIRS) spaces2list(COMPONENT_REQUIRES) spaces2list(COMPONENT_PRIV_REQUIRES) spaces2list(COMPONENT_ADD_LDFRAGMENTS) spaces2list(COMPONENT_EMBED_FILES) spaces2list(COMPONENT_EMBED_TXTFILES) spaces2list(COMPONENT_SRCEXCLUDE) idf_component_register(SRCS "${COMPONENT_SRCS}" SRC_DIRS "${COMPONENT_SRCDIRS}" INCLUDE_DIRS "${COMPONENT_ADD_INCLUDEDIRS}" PRIV_INCLUDE_DIRS "${COMPONENT_PRIV_INCLUDEDIRS}" REQUIRES "${COMPONENT_REQUIRES}" PRIV_REQUIRES "${COMPONENT_PRIV_REQUIRES}" LDFRAGMENTS "${COMPONENT_ADD_LDFRAGMENTS}" EMBED_FILES "${COMPONENT_EMBED_FILES}" EMBED_TXTFILES "${COMPONENT_EMBED_TXTFILES}" EXCLUDE_SRCS "${COMPONENT_SRCEXCLUDE}") endmacro() # require_idf_targets # # Compatibility function for requiring IDF build targets for 3.xx style components. function(require_idf_targets) set(__REQUIRED_IDF_TARGETS "${ARGN}") __component_check_target() endfunction() # register_config_only_component # # Compatibility function for registering 3.xx style config components. macro(register_config_only_component) register_component() endmacro() # component_compile_options # # Wrapper around target_compile_options that passes the component name function(component_compile_options) target_compile_options(${COMPONENT_LIB} PRIVATE ${ARGV}) endfunction() # component_compile_definitions # # Wrapper around target_compile_definitions that passes the component name function(component_compile_definitions) target_compile_definitions(${COMPONENT_LIB} PRIVATE ${ARGV}) endfunction()