Getting Started mbed Exporters

Mbed OS 2 and Mbed OS 5

This is the handbook for Mbed OS 2. If you’re working with Mbed OS 5, please see the new handbook.

Congratulations! You are one of the elite few who have chosen the path of ultimate power! You have chosen to take your code to an offline toolchain. This means you will acquire the power of traditional debug including, single step, break points, and oh so much more. But be careful, with great power comes greater responsibility.

You are leaving the online tools and their enhanced ease of use. With this step into the void you are now taking your destiny into your own hands. We have done our best to make the offline tools experience seamless and easy, unfortunately this is not always the case. Some toolchains and some boards will have issues. This page is our attempt at documenting those extra configuration options and providing the necessary details.

Now, go forth, be productive, and use the force, we believe in you!

-The mbed team.

First check out Exporting to offline toolchains

Then review the following special cases:

Keil uVision

The exporters are currently configured to use Keil MDK v4. MCUs released after Dec 2014 may not have device svd and flash programing algorithms provided with the installation. You will need to obtain these and install in the proper directory and then select in the project file.

  • Nordic Platforms using SoftDevices
    • Download nordic nrf51_SDK.
    • Install the nrf51_sdk and integrate with uVision when prompted
    • Right click on the project -> Options for Target... -> Utilities tab -> Configure Flash Menu Command Settings button -> Add button -> select nrf51xxx -> click Add -> Click OK -> click OK. Now you should be able to flash to the nrf51822 target.
  • Maxim Platforms
    • Download the MAX32600 Flash Algorithm.
    • Copy the file to directory: C:\Keil\ARM\Flash assuming the default install path was chosen.
  • LPCXpresso824-MAX and Switch Science mbed LPC824 Platforms


Makefiles are created and to build you will need make installed and part of your path. Also you will need an arm-gcc compiler and linker.

  • Nordic Platforms using SoftDevices
    • Windows
      • GCC exports targeting the NRF51822 also require some programs from the Nordic nrf51_SDK. Please download and install it from the nordic website to enable offline compiles with make on windows.
    • Linux
      • Need to install xxxx

Kinetis Design Studio (KDS)

Freescale KDS now ships with the GCC ARM Embedded toolchain. You may need to update a linker flag depending on the version of tools installed. Make the change in : C++ Build -> Settings -> Tool Settings

Open this dialog using [Alt] + Enter or [Option] + Enter

Any file extension that is .s needs to be changed to .S (lowercase to uppercase)

KDS >= 3.0


KDS < 3.0



The mbed libraries contain CMSIS startup files. When importing the generated project file it is required to un-check 'migrate to current infrastructure' box.