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.
- Install Mbed CLI
The following are the steps required to install the application:
- Clone the repository and deploy the Mbed OS project:
mbed import https://github.com/ARMmbed/mbed-os-example-mbed-crypto
- Change your current directory:
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:
Program your board
- Connect your Mbed device to the computer over USB.
- Copy the binary file (
getting-started.bin) to the Mbed device.
- 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 --
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.