Component : Software

Software implementation of the Symmetric Cryptography interface. More...

Collaboration diagram for Component : Software:

Modules
	Cipher : AES
	Software implementation of the AES algorithm.
	Cipher : DES
	Software implementation of the DES algorithm.
	Internals
	Internal Functions of the Symmetric Cryptography component.
	Compile Switch
	Compile switches used to find the optimum trade-off between performance, memory footprint and supported features.

Data Structures
struct	phCryptoSym_Sw_DataParams_t
	Data structure for Symmetric Crypto Software layer implementation. More...

Functions
phStatus_t	phCryptoSym_Sw_Init (phCryptoSym_Sw_DataParams_t *pDataParams, uint16_t wSizeOfDataParams, void *pKeyStoreDataParams)
	Initialize the CryptoSym with Software as sub-component. More...

Detailed Description

Software implementation of the Symmetric Cryptography interface.

This implementation was designed to optimize the footprint of crypto libraries used in embedded systems. The following standards are implemented:

• Federal Information Processing Standards Publication 197: AES 128, 192 and 256
• Federal Information Processing Standards Publication 46-3: DES
• NIST Special Publication 800-67 Recommendation for the Triple Data Encryption Algorithm (TDEA) Block Cipher
• NIST Special Publication 800-38B: CMAC
• NIST Special Publication 800-38A: CBC and ECB mode
• NIST Special Publication 800-38A: CMC-MAC

Hints for compiling the library:

• Carefully read the section on compile switches in order to find the optimum balance between speed and memory utilization.
• Using the appropriate compile switches either AES or DES can be removed from the built completely.

Architecture of the Software Component:

• The DES algorithm is implemented in the DES Core block
• The AES algorithm is implemented in the AES Core block
• The Internal block implements generic encrypt and decrypt functions. This offers the possibility to implement modes of operations without consideration of currently selected key type or key size.
• The Internal block in addition implements helper functions for CMAC calculations.

Function Documentation

phCryptoSym_Sw_Init()

phStatus_t phCryptoSym_Sw_Init	(	phCryptoSym_Sw_DataParams_t *	pDataParams,
		uint16_t	wSizeOfDataParams,
		void *	pKeyStoreDataParams
	)

Initialize the CryptoSym with Software as sub-component.

Returns

Status code

Return values

PH_ERR_SUCCESS	Operation successful.
PH_ERR_INVALID_DATA_PARAMS	If the input size do not match the DataParams size of this component. If any of the DataParams are null.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	wSizeOfDataParams	[In] Specifies the size of the data parameter structure.
[in]	pKeyStoreDataParams	[In] Pointer to a key store structure (can be null).