Mistake on this page?
Report an issue in GitHub or email us

Build profiles

Arm Mbed OS defines three collections of toolchain flags used during the build. These are build profiles. The three build profiles are develop, debug and release. Keil Studio Cloud uses the release build profile for deploying programs (build and flash) and the debug build profile for debugging. When building from Mbed CLI, you may select the build profile by passing your desired build profile, by name or path, to the --profile argument.

Develop

  • Small and fast code.
  • Full error information. For example, asserts have file name and line number.
  • Hard to follow code flow when using a debugger.
  • Chip goes to sleep when idle:
    • Debugger is likely to drop connection.
    • Breaks the local file system on the Arm Mbed interface on some boards.

Debug

  • Largest and slowest performance.
  • Full error information. For example, asserts have file name and line number.
  • Easy to step through code with a debugger.
  • Disabled sleep mode.

Note: The debug profile uses optimization flags that may cause unwanted behavior during debugging (such as out-of-order jumps and optimized-out variables). If this occurs, you can set the compiler to the lowest possible optimization setting (for example, change -Og to -O0 for GCC). See your toolchain's documentation for more information.

Release

  • Smallest code size and still fast.
  • Minimal error information.
  • Chip goes to sleep when going idle:
    • Debugger is likely to drop connection.
    • Breaks the local file system on the Mbed interface on some boards.

User-defined build profile

As mentioned above, the build profile defines the set of flags that is passed to the underlying compiler suite. You can also create a custom or user-defined build profile using a JSON file according to the build profile format mentioned in JSON build profile format.

These flags stored in the JSON file are merged with other JSON files of the same structure when multiple --profile arguments are passed on the command line.

JSON build profile format

The build profiles are JSON files with the root object containing key-value pairs for each supported toolchain, such as GCC_ARM. Each key is a toolchain name and every value contains a mapping from a flag type to a list of flags that should be passed to the corresponding part of the compiler suite.

The required flag types are:

Key Description
asm Flags for the Assembler
c Flags for the C Compiler
common Flags for both the C and C++ Compilers
cxx Flags for the C++ Compiler
ld Flags for the Linker

Example

An example of a build profile:

{
    "GCC_ARM": {
        "common": ["-c", "-Wall", "-Wextra",
                   "-Wno-unused-parameter", "-Wno-missing-field-initializers",
                   "-fmessage-length=0", "-fno-exceptions", "-fno-builtin",
                   "-ffunction-sections", "-fdata-sections", "-funsigned-char",
                   "-MMD", "-fno-delete-null-pointer-checks",
                   "-fomit-frame-pointer", "-Os"],
        "asm": ["-x", "assembler-with-cpp"],
        "c": ["-std=gnu99"],
        "cxx": ["-std=gnu++98", "-fno-rtti", "-Wvla"],
        "ld": ["-Wl,--gc-sections", "-Wl,--wrap,main", "-Wl,--wrap,_malloc_r",
               "-Wl,--wrap,_free_r", "-Wl,--wrap,_realloc_r",
               "-Wl,--wrap,_calloc_r", "-Wl,--wrap,exit", "-Wl,--wrap,atexit"]
    },
    "ARM": {
        "common": ["-c", "--gnu", "-Otime", "--split_sections",
                   "--apcs=interwork", "--brief_diagnostics", "--restrict",
                   "--multibyte_chars", "-O3"],
        "asm": [],
        "c": ["--md", "--no_depend_system_headers", "--c99", "-D__ASSERT_MSG"],
        "cxx": ["--cpp", "--no_rtti", "--no_vla"],
        "ld": []
    },
    "IAR": {
        "common": [
            "--no_wrap_diagnostics", "non-native end of line sequence", "-e",
            "--diag_suppress=Pa050,Pa084,Pa093,Pa082", "-Oh"],
        "asm": [],
        "c": ["--vla"],
        "cxx": ["--guard_calls", "--no_static_destruction"],
        "ld": ["--skip_dynamic_initialization", "--threaded_lib"]
    }
}

In the above example, you can tell that:

  • GCC_ARM, ARM and IAR compiler suites are supported.
  • The ARM C and C++ compilers use optimization level -O3.
  • The IAR linker skips dynamic initialization.

And so on.

Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.