This library implements some hash and cryptographic algorithms.

Dependents:   mBuinoBlinky PB_Emma_Ethernet SLOTrashHTTP Garagem ... more

This library implements the following algorithms :

  • RC4
  • AES (AES-128, AES-192, AES-256)
  • DES
  • Triple DES (EDE)
  • MD2
  • MD4
  • MD5
  • SHA-1
  • SHA-2 (SHA-224, SHA-256, SHA-384, SHA-512)

The hash algorithms have been optimized for the mbed and you should get decent performance. However, I did not optimize the ciphers. Also, I did not test extensively these algorithms : it should work but you may find some bugs. Block ciphers support two modes : ECB and CBC.

Warning

If you are using SHA-384 or SHA-512, be aware that it produces large binary files and the compilation (using the online compiler) takes much longer to execute. It may happen that the compiler stops because it timed-out. In this case, just compile again and it should work.

Computing hash

You can compute the hash of some data in two different ways. The first one is the easiest, each hash algorithm has a static method that takes some data and compute the hash from it.

Computing hash using method 1

#include "Crypto.h"
#include "mbed.h"

static const char msg[] = "mbed is great !";

int main()
{
    uint8_t hash[16];
    MD2::computeHash(hash, (uint8_t*)msg, strlen(msg));
    printf("hash: ");
    for(int i = 0; i < 16; ++i)
        printf("%02x", hash[i]);
    printf("\n");
    
    return 0;
}

The second one is slightly slower (around 2-3% slower) but it allows you to compute the hash of some data in several steps (by calling update method). This is the method you should use if you need to compute the hash from a large source and you don't have enough memory to store it in a single buffer.

Computing hash using method 2

#include "Crypto.h"
#include "mbed.h"

static const char msg[] = "mbed is great !";

int main()
{
    uint8_t hash[16];
    MD2 h;
    h.update((uint8_t*)msg, strlen(msg));
    h.finalize(hash);
    printf("hash: ");
    for(int i = 0; i < 16; ++i)
        printf("%02x", hash[i]);
    printf("\n");
    
    return 0;
}

TODO

  • optimize ciphers
  • add doc
Committer:
feb11
Date:
Thu Sep 12 15:08:51 2013 +0000
Revision:
5:06cd9c8afa0b
change API & small improvements in SHA-2

Who changed what in which revision?

UserRevisionLine numberNew contents of line
feb11 5:06cd9c8afa0b 1 #include "DES.h"
feb11 5:06cd9c8afa0b 2
feb11 5:06cd9c8afa0b 3
feb11 5:06cd9c8afa0b 4 DES::DES(uint8_t *key):
feb11 5:06cd9c8afa0b 5 Cipher()
feb11 5:06cd9c8afa0b 6 {
feb11 5:06cd9c8afa0b 7 // loadKey(key);
feb11 5:06cd9c8afa0b 8 }
feb11 5:06cd9c8afa0b 9
feb11 5:06cd9c8afa0b 10 void DES::encrypt(uint8_t *out, uint8_t *in, uint32_t length)
feb11 5:06cd9c8afa0b 11 {
feb11 5:06cd9c8afa0b 12
feb11 5:06cd9c8afa0b 13 }
feb11 5:06cd9c8afa0b 14
feb11 5:06cd9c8afa0b 15 void DES::decrypt(uint8_t *out, uint8_t *in, uint32_t length)
feb11 5:06cd9c8afa0b 16 {
feb11 5:06cd9c8afa0b 17
feb11 5:06cd9c8afa0b 18 }
feb11 5:06cd9c8afa0b 19
feb11 5:06cd9c8afa0b 20 uint32_t DES::getBlockSize() const
feb11 5:06cd9c8afa0b 21 {
feb11 5:06cd9c8afa0b 22 return 8;
feb11 5:06cd9c8afa0b 23 }
feb11 5:06cd9c8afa0b 24
feb11 5:06cd9c8afa0b 25 CIPHER_TYPE DES::getType() const
feb11 5:06cd9c8afa0b 26 {
feb11 5:06cd9c8afa0b 27 return STREAM_CIPHER;
feb11 5:06cd9c8afa0b 28 }