Skip to content
Mbed Crypto example for Mbed OS 5
Branch: master
Clone or download
Latest commit 58ee0a9 Aug 30, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add github issue template Nov 29, 2018
getting-started Add guards for Mbed Crypto version Aug 30, 2019
tests Remove mbed-crypto example Aug 30, 2019 add contributing + license files Apr 15, 2019
LICENSE add contributing + license files Apr 15, 2019 Update to be correct for the example Aug 30, 2019

Running Mbed Crypto examples on Mbed OS

This repository contains a set of examples demonstrating the compilation and use of Mbed Crypto on Mbed OS.

List of examples contained within this repository:

  • Example code snippets for using the library, with documentation.



The following are the steps required to install the application:

  • Clone the repository and deploy the Mbed OS project: mbed import
  • Change your current directory: cd mbed-os-example-mbed-crypto/getting-started


To compile the example program use mbed compile while specifying the target platform and the compiler. For example, in order to compile using the ARM GCC compiler and a K64F target platform use: mbed compile -m K64F -t GCC_ARM.

Once the compilation is completed successfully a binary file will be created: ./BUILD/K64F/GCC_ARM/getting-started.bin

Program your board

  1. Connect your Mbed device to the computer over USB.
  2. Copy the binary file (getting-started.bin) to the Mbed device.


  1. Connect to the Mbed Device using a serial client application of your choice.
  2. Press the reset button on the Mbed device to run the program.

The expected output from the first successful execution of the example program should be as follows:

-- Begin Mbed Crypto Getting Started --

Import an AES key...    Imported a key
Sign a message...       Signed a message
Encrypt with cipher...  Encrypted plaintext
Decrypt with cipher...  Decrypted ciphertext
Hash a message...       Hashed a message
Verify a hash...        Verified a hash
Generate random...      Generated random data
Derive a key (HKDF)...  Derived key
Authenticate encrypt... Authenticated and encrypted
Authenticate decrypt... Authenticated and decrypted
Generate a key pair...  Exported a public key

-- End Mbed Crypto Getting Started --


If you have problems, you can review the documentation for suggestions on what could be wrong and how to fix it.

License and contributions

The software is provided under Apache-2.0 license. Contributions to this project are accepted under the same license. Please see for more info.

This project contains code from other projects. The original license text is included in those source files. They must comply with our license guide.

You can’t perform that action at this time.