# Copyright (c) 2020-2021 ARM Limited. All rights reserved. # SPDX-License-Identifier: Apache-2.0 # This is the boilerplate for Mbed OS cmake_minimum_required(VERSION 3.19.0 FATAL_ERROR) cmake_policy(VERSION 3.16...3.22) # Setup build type (target type, tests/unit tests/real build) ---------------------------------------------------------------------------------- # This block sets up the following variables for all subdirs to use: # - MBED_OS_IS_STANDALONE: True if Mbed OS is the top-level project. False if Mbed is being built as part of an application. # - MBED_IS_NATIVE_BUILD: True if we are building for the host machine. False if we are building for a microcontroller # - MBED_OS_ENABLE_TESTS: True if we are building *any* internal Mbed OS tests at all. Enabled by -DBUILD_TESTING=TRUE (which is enabled by default when standalone). # - BUILD_GREENTEA_TESTS: True to build greentea on-target tests. False to build host UNITTESTS. if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR) # We are the top level project, so tests or unittests are being built. set(MBED_OS_IS_STANDALONE TRUE) else() # Not the top level project set(MBED_OS_IS_STANDALONE FALSE) endif() if(CMAKE_CROSSCOMPILING) set(MBED_IS_NATIVE_BUILD FALSE) else() set(MBED_IS_NATIVE_BUILD TRUE) endif() if(MBED_IS_NATIVE_BUILD) # Pick up some include files that are needed later list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/tools/cmake) endif() if(MBED_IS_NATIVE_BUILD) # Pick up some include files that are needed later list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/tools/cmake) include(mbed_create_distro) else() # Grab the Mbed configs for this target include(${MBED_CONFIG_PATH}/mbed_config.cmake) include(mbed_set_linker_script) endif() # Set up options for testing option(BUILD_TESTING "Whether to enable CTest tests in this project" ${MBED_OS_IS_STANDALONE}) # This option is also created by include(CTest) but we need it here earlier on. if(MBED_OS_IS_STANDALONE AND BUILD_TESTING) set(MBED_OS_ENABLE_TESTS TRUE) option(BUILD_GREENTEA_TESTS "Build greentea tests instead of unit tests" ${CMAKE_CROSSCOMPILING}) endif() if(MBED_OS_IS_STANDALONE) # For standalong builds, look for mbed-config.cmake in the top level mbed os dir set(MBED_CONFIG_PATH ${CMAKE_CURRENT_BINARY_DIR} CACHE STRING "") endif() if(MBED_IS_NATIVE_BUILD) # Pick up some include files that are needed later list(APPEND CMAKE_MODULE_PATH ${CMAKE_CURRENT_LIST_DIR}/tools/cmake) include(mbed_create_distro) else() # Grab the Mbed configs for this target include(${MBED_CONFIG_PATH}/mbed_config.cmake) include(mbed_set_linker_script) endif() # Print build type if(MBED_OS_ENABLE_TESTS) if(BUILD_GREENTEA_TESTS) message(STATUS "Mbed: Compiling Greentea on-target tests for ${MBED_TARGET}") else() message(STATUS "Mbed: Compiling host UNITTESTS for native execution") endif() else() message(STATUS "Mbed: Not building any Mbed OS tests.") endif() # Create core Mbed OS targets and set up build flags ---------------------------------------------------------------------------------- project(mbed-os) # Add all paths to the list files within Mbed OS list(APPEND CMAKE_MODULE_PATH "${mbed-os_SOURCE_DIR}/platform/FEATURE_EXPERIMENTAL_API/FEATURE_PSA/TARGET_TFM/TARGET_TFM_LATEST/scripts;${mbed-os_SOURCE_DIR}/targets/TARGET_Cypress/scripts;${mbed-os_SOURCE_DIR}/targets/TARGET_NXP/scripts;${mbed-os_SOURCE_DIR}/targets/TARGET_NUVOTON/scripts/" ) add_subdirectory(extern) if(MBED_OS_IS_STANDALONE) include(CTest) if((NOT BUILD_GREENTEA_TESTS) AND BUILD_TESTING) # Building unit tests only. add_definitions(-DUNITTEST) add_subdirectory(UNITTESTS) endif() endif() # These targets are made visible here so their source files which # are spread in different directories can be referenced and can be linked against # by libraries that depend on them. add_library(mbed-device_key INTERFACE) add_library(mbed-rtos INTERFACE) # Collects source files and flags that are in mbed-os but not mbed-baremetal add_library(mbed-core INTERFACE) # Collects source files and flags common to mbed-baremetal and mbed-os # Validate selected C library type # The C library type selected has to match the library that the target can support if(NOT MBED_IS_NATIVE_BUILD) if(${MBED_C_LIB} STREQUAL "small") if(NOT "small" IN_LIST MBED_TARGET_SUPPORTED_C_LIBS) if("std" IN_LIST MBED_TARGET_SUPPORTED_C_LIBS) message(WARNING "We noticed that target.c_lib is set to `${MBED_C_LIB}`." " As the ${MBED_TARGET} target does not support a small C library for the ${MBED_TOOLCHAIN} toolchain," " we are using the standard C library instead." ) set(MBED_C_LIB "std" CACHE STRING "") endif() endif() elseif(NOT ${MBED_C_LIB} IN_LIST MBED_TARGET_SUPPORTED_C_LIBS) message(FATAL_ERROR "Invalid `target.c_lib` ('${MBED_C_LIB}') for '${MBED_TARGET}' target." "\nPossible value(s): ${MBED_TARGET_SUPPORTED_C_LIBS}" ) endif() # Validate selected printf library set(MBED_PRINTF_LIB_TYPES std minimal-printf) if(NOT ${MBED_PRINTF_LIB} IN_LIST MBED_PRINTF_LIB_TYPES) message(FATAL_ERROR "Invalid printf library type '${MBED_PRINTF_LIB}'. Possible values:\n ${MBED_PRINTF_LIB_TYPES}" ) endif() mbed_set_cpu_core_definitions(mbed-core) if(${MBED_TOOLCHAIN_FILE_USED}) mbed_set_profile_options(mbed-core ${MBED_TOOLCHAIN}) mbed_set_c_lib(mbed-core ${MBED_C_LIB}) mbed_set_printf_lib(mbed-core ${MBED_PRINTF_LIB}) target_compile_features(mbed-core INTERFACE c_std_11 cxx_std_14 ) endif() target_compile_definitions(mbed-core INTERFACE TARGET_NAME=${MBED_TARGET} ) # Add MBED_TEST_MODE for backward compatibility with Greentea tests written for use with Mbed CLI 1 if(MBED_OS_ENABLE_TESTS) if(NOT BUILD_GREENTEA_TESTS) target_compile_definitions(${PROJECT_NAME} INTERFACE MBED_TEST_MODE ) endif() endif() # We need to generate a "response file" to pass to the C preprocessor when we preprocess the linker # script, because of path length limitations on Windows. We set the response file and bind the path # to a global property here. The MBED_TARGET being built queries this global property when it sets # the linker script. # # We must set this global property before the targets subdirectory is added to the project. This is # required because the MBED_TARGET depends on the response file. If the path to the response file # is not defined when the target requests it the config definitions will not be passed to CPP. # # TODO: Remove this and find a more idiomatic way of passing compile definitions to CPP without # using response files or global properties. mbed_generate_options_for_linker(mbed-core RESPONSE_FILE_PATH) set_property(GLOBAL PROPERTY COMPILE_DEFS_RESPONSE_FILE ${RESPONSE_FILE_PATH}) # Add compile definitions for backward compatibility with the toolchain # supported. New source files should instead check for __GNUC__ and __clang__ # for the GCC_ARM and ARM toolchains respectively. if(${MBED_TOOLCHAIN} STREQUAL "GCC_ARM") target_compile_definitions(mbed-core INTERFACE TOOLCHAIN_GCC_ARM TOOLCHAIN_GCC ) elseif(${MBED_TOOLCHAIN} STREQUAL "ARM") target_compile_definitions(mbed-core INTERFACE TOOLCHAIN_ARM ) endif() endif() if(MBED_IS_NATIVE_BUILD) # Fix issue on Windows with object files hitting a limit for number of sections if(CMAKE_SYSTEM_NAME STREQUAL "Windows") add_compile_options(-Wa,-mbig-obj) endif() endif() # Generate target config header and include it in all files if(NOT MBED_IS_NATIVE_BUILD) mbed_write_target_config_header(${CMAKE_CURRENT_BINARY_DIR}/mbed-target-config.h MBED_TARGET_DEFINITIONS MBED_CONFIG_DEFINITIONS) target_compile_options(mbed-core INTERFACE -include ${CMAKE_CURRENT_BINARY_DIR}/mbed-target-config.h) endif() # Include mbed.h and config from generate folder target_include_directories(mbed-core INTERFACE ${CMAKE_CURRENT_SOURCE_DIR} ) # Recurse to subdirs ---------------------------------------------------------------------------------- # Include targets/ first, because any post-build hook needs to be defined # before other parts of Mbed OS can add greentea tests which require # mbed_set_post_build(). add_subdirectory(targets) add_subdirectory(cmsis) add_subdirectory(drivers) add_subdirectory(hal) add_subdirectory(platform) add_subdirectory(rtos) add_subdirectory(storage) add_subdirectory(events) add_subdirectory(connectivity) # The directories below contain optional target libraries add_subdirectory(drivers/device_key EXCLUDE_FROM_ALL) add_subdirectory(drivers/usb EXCLUDE_FROM_ALL) add_subdirectory(features EXCLUDE_FROM_ALL) add_subdirectory(cmsis/CMSIS_5/CMSIS/RTOS2 EXCLUDE_FROM_ALL) add_subdirectory(cmsis/device/rtos EXCLUDE_FROM_ALL) # Create top-level targets ---------------------------------------------------------------------------------- if(NOT MBED_IS_NATIVE_BUILD) # Ensure the words that make up the Mbed target name are separated with a hyphen, lowercase, and with the `mbed-` prefix. string(TOLOWER ${MBED_TARGET} MBED_TARGET_CONVERTED) string(REPLACE "_" "-" MBED_TARGET_CONVERTED ${MBED_TARGET_CONVERTED}) string(PREPEND MBED_TARGET_CONVERTED "mbed-") endif() if(NOT MBED_IS_NATIVE_BUILD) # Core Mbed OS library # mbed-baremetal contains baremetal sources + target sources + target compile flags. # mbed-os will be a superset of mbed-baremetal, also containing the RTOS sources and RTOS flags. # Note that many different source files will compile differently depending on if the RTOS is in use. # So, it's needed to compile the core sources twice, once for RTOS and once for non-RTOS. mbed_create_distro(mbed-baremetal mbed-core ${MBED_TARGET_CONVERTED}) mbed_create_distro(mbed-os mbed-core mbed-rtos ${MBED_TARGET_CONVERTED}) endif() # Ninja requires to be forced for response files if ("${CMAKE_GENERATOR}" MATCHES "Ninja") # known issue ARMClang and Ninja with response files for windows # https://gitlab.kitware.com/cmake/cmake/-/issues/21093 # This gets fixed in newer cmake version # https://gitlab.kitware.com/cmake/cmake/-/merge_requests/6484 if((CMAKE_HOST_SYSTEM_NAME MATCHES "Windows") AND ((${CMAKE_VERSION} VERSION_GREATER_EQUAL "3.22.0") OR (NOT CMAKE_CXX_COMPILER_ID MATCHES "ARMClang"))) set(CMAKE_NINJA_FORCE_RESPONSE_FILE 1 CACHE INTERNAL "") endif() endif()