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.
Prerequisites
- Install Mbed CLI
Import
The following are the steps required to install the application:
- Clone the repository:
git clone https://github.com/ARMmbed/mbed-os-example-mbed-crypto.git - Navigate to the "getting-started" example:
cd mbed-os-example-mbed-crypto/getting-started - Deploy the Mbed OS project:
mbed deploy
Compile
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
- Connect your Mbed device to the computer over USB.
- Copy the binary file (
getting-started.bin) to the Mbed device.
Run
- Connect to the Mbed Device using a serial client application of your choice.
- 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 --
Troubleshooting
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 contributing.md 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.

Formed in 2009, the Archive Team (not to be confused with the archive.org Archive-It Team) is a rogue archivist collective dedicated to saving copies of rapidly dying or deleted websites for the sake of history and digital heritage. The group is 100% composed of volunteers and interested parties, and has expanded into a large amount of related projects for saving online and digital history.

