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

Compiling the code

  1. Get the code

    From your command-line, import the example:

    $ mbed import https://github.com/ARMmbed/mbed-os-example-blinky
    $ cd mbed-os-example-blinky
    
  2. Compile and program your board:

    Invoke mbed compile, and specify the name of your platform and your installed toolchain (GCC_ARM, ARM, IAR). For example, for the K64F platform and Arm Compiler 5 toolchain:

    ```console
    $ mbed compile --target K64F --toolchain ARM --flash
    ```
    

    The --flash argument automatically flashes the compiled program onto your board if it is connected to your computer.

    Tip: You can get the name of the board plugged into your computer by running mbed detect, and you can get a full list of supported toolchains and targets by running the mbed compile --supported command.

    Note: To build with the Mbed OS bare metal profile, add "requires": ["bare-metal"] to the mbed_app.json file:

       {
           "requires": ["bare-metal"],
           "target_overrides": {
               "*": {
    
  3. Press the board's reset button. The LED blinks.

Example walkthrough

The quick start example blinks the LED on your board on and off. The main thread also takes a snapshot of the device's runtime statistics and displays them over a serial connection to your PC.

Viewing the output

To view the serial output use any terminal client, such as PuTTY or CoolTerm.

The default baud rate, or speed, for this application is set to 9600. You can modify it in the mbed_app.json file. To configure your terminal client to this baud rate, change the speed option when selecting the port.

Tip: You can find more information on the Mbed OS configuration tools and serial communication in Mbed OS in the related links section.

The output transmits the system, CPU, heap and thread information.

Note: If you are building with the Mbed OS bare metal profile, you will not get thread information.

Understanding the output

System information

Mbed OS version: Tip of master is represented by 999999. If you are using a tagged release of Mbed OS, the version will be configured by the OS. For custom releases, you can modify the version manually in platform/mbed_version.h.

CPUID register information:

Bit Field Field Description Values
[31:24] Implementer 0x41 = ARM
[23:20] Variant Major revision 0x0 = Revision 0
[19:16] Architecture 0xC = Baseline Architecture
0xF = Constant (Mainline Architecture)
[15:4] Part Number 0xC20 = Cortex-M0
0xC60 = Cortex-M0+
0xC23 = Cortex-M3
0xC24 = Cortex-M4
0xC27 = Cortex-M7
0xD20 = Cortex-M23
0xD21 = Cortex-M33
[3:0] Revision Minor revision: 0x1 = Patch 1

Compiler ID and version:

Compiler Version tag Version layout
ARM 1 PVVbbbb (P = Major; VV = Minor; bbbb = build number)
GCC_ARM 2 VVRRPP (VV = Version; RR = Revision; PP = Patch)
IAR 3 VRRRPPP (V = Version; RRR = Revision; PPP = Patch)

CPU statistics

Percentage of runtime the device has spent awake.

Heap statistics

  • Current heap size.
  • Maximum size the heap has ever reached (not the maximum size it can reach).

Thread statistics

Provides information on all running threads in the OS:

  • ID.
  • Name.
  • State.
  • Priority.
  • Stack size.
  • Stack space.
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.