MPLAB® Harmony Crypto Library

The Cryptographic Library includes functions to perform encryption, decryption, hashing, authentication, and compression within the embedded application. Random number generation (RNG) functions are also provided.

Block Ciphers

The library provides DES, 3DES, and AES for block cipher needs. Depending on the algorithm in use, CBC and CTR modes are supported.

Public Key Cryptography

The library provides RSA and Elliptic Curve Cryptography (ECC) for Public Key Cryptography, and Diffie-Hellman (DH) for key agreement arrangements.

Hash Functions

The library provides MD5, SHA, SHA-256, SHA-384, and SHA-512 for hashing. These functions do not require keys or initialization vectors (IV).

Random Number Generation Functions

The library provides functions to generate either a single pseudo-random number, or a block of such numbers

Library Interface

The Library Interface routines are divided into various sub-sections, which address one of the blocks or the overall operation of the Cryptographic (Crypto) Library module.

Library Interface Section	Description
General Functions	Provides an error string function, which takes an error and converts it into human-readable text.
Compression Functions	Provides Huffman compression and decompression functions.
MD5 Functions	Provides data add, finalize, and initialize MD5 functions.
Random Number Generator Functions	Provides get, initialize, and block generate RNG functions.
AES Encryption/Decryption Functions	Provides AES encryption and decryption functions.
ECC Encryption/Decryption Functions	Provides ECC encryption and decryption functions.
RSA Encryption/Decryption Functions	Provides RSA encryption and decryption functions.
Triple DES Encryption/Decryption Functions	Provides 3DES encryption and decryption functions.
HMAC Hash Functions	Provides HMAC data add, finalize, and set key Hash functions.
SHA Hash Functions	Provides SHA data add, finalize, and initialize Hash functions.
SHA256 Hash Functions	Provides SHA256 data add, finalize, and initialize Hash functions.
SHA384 Hash Functions	Provides SHA384 data add, finalize, and initialize Hash functions.
SHA512 Hash Functions	Provides SHA512 data add, finalize, and initialize Hash functions.

• MC_CRYPTO_API_H Macro

• CRYPT_HUFFMAN_Compress Function

• CRYPT_HUFFMAN_DeCompress Function

• CRYPT_MD5_CTX Structure

• CRYPT_RNG_BlockGenerate Function

• CRYPT_RNG_CTX Structure

• CRYPT_RNG_DeInitialize Function

• CRYPT_RNG_Get Function

• CRYPT_RNG_Initialize Function

• CRYPT_AES_CBC_Decrypt Function

• CRYPT_AES_CBC_Encrypt Function

• CRYPT_AES_CTR_Encrypt Function

• CRYPT_AES_CTX Structure

• CRYPT_AES_DIRECT_Decrypt Function

• CRYPT_AES_DIRECT_Encrypt Function

• CRYPT_AES_GCM_Decrypt Function

• CRYPT_AES_GCM_Encrypt Function

• CRYPT_AES_GCM_SetKey Function

• CRYPT_AES_IvSet Function

• CRYPT_AES_KeySet Function

• CRYPT_ECC_CTX Structure

• CRYPT_ECC_DHE_KeyMake Function

• CRYPT_ECC_DHE_SharedSecretMake Function

• CRYPT_ECC_DSA_HashSign Function

• CRYPT_ECC_DSA_HashVerify Function

• CRYPT_ECC_Free Function

• CRYPT_ECC_Initialize Function

• CRYPT_ECC_KeySizeGet Function

• CRYPT_ECC_PrivateImport Function

• CRYPT_ECC_PublicExport Function

• CRYPT_ECC_PublicImport Function

• CRYPT_ECC_SignatureSizeGet Function

• CRYPT_SHA384_CTX Structure

• CRYPT_RSA_EncryptSizeGet Function

• CRYPT_RSA_Free Function

• CRYPT_RSA_Initialize Function

• CRYPT_RSA_PrivateDecrypt Function

• CRYPT_RSA_PrivateKeyDecode Function

• CRYPT_RSA_PublicEncrypt Function

• CRYPT_RSA_PublicKeyDecode Function

• CRYPT_TDES_CBC_Decrypt Function

• CRYPT_TDES_CBC_Encrypt Function

• CRYPT_TDES_CTX Structure

• CRYPT_TDES_IvSet Function

• CRYPT_TDES_KeySet Function

• CRYPT_HMAC_CTX Structure

• CRYPT_HMAC_DataAdd Function

• CRYPT_HMAC_Finalize Function

• CRYPT_HMAC_SetKey Function

• CRYPT_SHA_CTX Structure

• CRYPT_SHA_DataAdd Function

• CRYPT_SHA_DataSizeSet Function

• CRYPT_SHA_Finalize Function

• CRYPT_SHA_Initialize Function

• CRYPT_SHA224_DataAdd Function

• CRYPT_SHA224_Finalize Function

• CRYPT_SHA224_Initialize Function

• CRYPT_SHA256_CTX Structure

• CRYPT_SHA256_DataAdd Function

• CRYPT_SHA256_DataSizeSet Function

• CRYPT_SHA256_Finalize Function

• CRYPT_SHA256_Initialize Function

• CRYPT_SHA384_CTX Structure

• CRYPT_SHA384_DataAdd Function

• CRYPT_SHA384_Finalize Function

• CRYPT_SHA384_Initialize Function

• CRYPT_SHA512_CTX Structure

• CRYPT_SHA512_DataAdd Function

• CRYPT_SHA512_Finalize Function

• CRYPT_SHA512_Initialize Function