AES processing functions

Processing functions. More...

Functions
HAL_StatusTypeDef	HAL_CRYP_AESECB_Encrypt (CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout)
	Encrypt pPlainData in AES ECB encryption mode. The cypher data are available in pCypherData. More...
HAL_StatusTypeDef	HAL_CRYP_AESECB_Decrypt (CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout)
	Decrypt pCypherData in AES ECB decryption mode with key derivation, the decyphered data are available in pPlainData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCBC_Encrypt (CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout)
	Encrypt pPlainData in AES CBC encryption mode with key derivation. The cypher data are available in pCypherData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCBC_Decrypt (CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout)
	Decrypt pCypherData in AES ECB decryption mode with key derivation, the decyphered data are available in pPlainData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCTR_Encrypt (CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout)
	Encrypt pPlainData in AES CTR encryption mode. The cypher data are available in pCypherData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCTR_Decrypt (CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout)
	Decrypt pCypherData in AES CTR decryption mode, the decyphered data are available in pPlainData. More...
HAL_StatusTypeDef	HAL_CRYP_AESECB_Encrypt_IT (CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData)
	Encrypt pPlainData in AES ECB encryption mode using Interrupt, the cypher data are available in pCypherData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCBC_Encrypt_IT (CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData)
	Encrypt pPlainData in AES CBC encryption mode using Interrupt, the cypher data are available in pCypherData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCTR_Encrypt_IT (CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData)
	Encrypt pPlainData in AES CTR encryption mode using Interrupt, the cypher data are available in pCypherData. More...
HAL_StatusTypeDef	HAL_CRYP_AESECB_Decrypt_IT (CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData)
	Decrypt pCypherData in AES ECB decryption mode using Interrupt, the decyphered data are available in pPlainData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCTR_Decrypt_IT (CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData)
	Decrypt pCypherData in AES CTR decryption mode using Interrupt, the decyphered data are available in pPlainData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCBC_Decrypt_IT (CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData)
	Decrypt pCypherData in AES CBC decryption mode using Interrupt, the decyphered data are available in pPlainData. More...
HAL_StatusTypeDef	HAL_CRYP_AESECB_Encrypt_DMA (CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData)
	Encrypt pPlainData in AES ECB encryption mode using DMA, the cypher data are available in pCypherData. More...
HAL_StatusTypeDef	HAL_CRYP_AESECB_Decrypt_DMA (CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData)
	Decrypt pCypherData in AES ECB decryption mode using DMA, the decyphered data are available in pPlainData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCBC_Encrypt_DMA (CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData)
	Encrypt pPlainData in AES CBC encryption mode using DMA, the cypher data are available in pCypherData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCBC_Decrypt_DMA (CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData)
	Decrypt pCypherData in AES CBC decryption mode using DMA, the decyphered data are available in pPlainData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCTR_Encrypt_DMA (CRYP_HandleTypeDef *hcryp, uint8_t *pPlainData, uint16_t Size, uint8_t *pCypherData)
	Encrypt pPlainData in AES CTR encryption mode using DMA, the cypher data are available in pCypherData. More...
HAL_StatusTypeDef	HAL_CRYP_AESCTR_Decrypt_DMA (CRYP_HandleTypeDef *hcryp, uint8_t *pCypherData, uint16_t Size, uint8_t *pPlainData)
	Decrypt pCypherData in AES CTR decryption mode using DMA, the decyphered data are available in pPlainData. More...

Detailed Description

Processing functions.

  ==============================================================================
                      ##### AES processing functions #####
  ==============================================================================
    [..]  This section provides functions allowing to:
      (+) Encrypt plaintext using AES algorithm in different chaining modes
      (+) Decrypt cyphertext using AES algorithm in different chaining modes
    [..]  Three processing functions are available:
      (+) Polling mode
      (+) Interrupt mode
      (+) DMA mode

Function Documentation

HAL_CRYP_AESCBC_Decrypt()

HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pCypherData,
		uint16_t	Size,
		uint8_t *	pPlainData,
		uint32_t	Timeout
	)

Decrypt pCypherData in AES ECB decryption mode with key derivation, the decyphered data are available in pPlainData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pCypherData	Pointer to the cyphertext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pPlainData	Pointer to the plaintext buffer
Timeout	Specify Timeout value

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES() API instead (usage recommended).

Return values

HAL

status

Definition at line 678 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_KEYDERIVATION_DECRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CBC;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES(hcryp, pCypherData, Size, pPlainData, Timeout);
}

HAL_CRYP_AESCBC_Decrypt_DMA()

HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt_DMA	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pCypherData,
		uint16_t	Size,
		uint8_t *	pPlainData
	)

Decrypt pCypherData in AES CBC decryption mode using DMA, the decyphered data are available in pPlainData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pCypherData	Pointer to the cyphertext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pPlainData	Pointer to the plaintext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_DMA() API instead (usage recommended).

pPlainData and pCypherData buffers must be 32-bit aligned to ensure a correct DMA transfer to and from the IP.

Return values

HAL

status

Definition at line 1047 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_KEYDERIVATION_DECRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CBC;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_DMA(hcryp, pCypherData, Size, pPlainData);
}

HAL_CRYP_AESCBC_Decrypt_IT()

HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt_IT	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pCypherData,
		uint16_t	Size,
		uint8_t *	pPlainData
	)

Decrypt pCypherData in AES CBC decryption mode using Interrupt, the decyphered data are available in pPlainData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pCypherData	Pointer to the cyphertext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pPlainData	Pointer to the plaintext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_IT() API instead (usage recommended).

Return values

HAL

status

Definition at line 860 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_KEYDERIVATION_DECRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CBC;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_IT(hcryp, pCypherData, Size, pPlainData);
}

HAL_CRYP_AESCBC_Encrypt()

HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pPlainData,
		uint16_t	Size,
		uint8_t *	pCypherData,
		uint32_t	Timeout
	)

Encrypt pPlainData in AES CBC encryption mode with key derivation. The cypher data are available in pCypherData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pPlainData	Pointer to the plaintext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pCypherData	Pointer to the cyphertext buffer
Timeout	Specify Timeout value

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES() API instead (usage recommended).

Return values

HAL

status

Definition at line 585 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_ENCRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CBC;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES(hcryp, pPlainData, Size, pCypherData, Timeout);
}

HAL_CRYP_AESCBC_Encrypt_DMA()

HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt_DMA	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pPlainData,
		uint16_t	Size,
		uint8_t *	pCypherData
	)

Encrypt pPlainData in AES CBC encryption mode using DMA, the cypher data are available in pCypherData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pPlainData	Pointer to the plaintext buffer
Size	Length of the plaintext buffer, must be a multiple of 16.
pCypherData	Pointer to the cyphertext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_DMA() API instead (usage recommended).

pPlainData and pCypherData buffers must be 32-bit aligned to ensure a correct DMA transfer to and from the IP.

Return values

HAL

status

Definition at line 954 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_ENCRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CBC;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_DMA(hcryp, pPlainData, Size, pCypherData);
}

HAL_CRYP_AESCBC_Encrypt_IT()

HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt_IT	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pPlainData,
		uint16_t	Size,
		uint8_t *	pCypherData
	)

Encrypt pPlainData in AES CBC encryption mode using Interrupt, the cypher data are available in pCypherData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pPlainData	Pointer to the plaintext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pCypherData	Pointer to the cyphertext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_IT() API instead (usage recommended).

Return values

HAL

status

Definition at line 769 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_ENCRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CBC;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_IT(hcryp, pPlainData, Size, pCypherData);
}

HAL_CRYP_AESCTR_Decrypt()

HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pCypherData,
		uint16_t	Size,
		uint8_t *	pPlainData,
		uint32_t	Timeout
	)

Decrypt pCypherData in AES CTR decryption mode, the decyphered data are available in pPlainData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pCypherData	Pointer to the cyphertext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pPlainData	Pointer to the plaintext buffer
Timeout	Specify Timeout value

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES() API instead (usage recommended).

Return values

HAL

status

Definition at line 709 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_DECRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CTR;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES(hcryp, pCypherData, Size, pPlainData, Timeout);
}

HAL_CRYP_AESCTR_Decrypt_DMA()

HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt_DMA	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pCypherData,
		uint16_t	Size,
		uint8_t *	pPlainData
	)

Decrypt pCypherData in AES CTR decryption mode using DMA, the decyphered data are available in pPlainData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pCypherData	Pointer to the cyphertext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pPlainData	Pointer to the plaintext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_DMA() API instead (usage recommended).

pPlainData and pCypherData buffers must be 32-bit aligned to ensure a correct DMA transfer to and from the IP.

Return values

HAL

status

Definition at line 1078 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_DECRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CTR;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_DMA(hcryp, pCypherData, Size, pPlainData);
}

HAL_CRYP_AESCTR_Decrypt_IT()

HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt_IT	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pCypherData,
		uint16_t	Size,
		uint8_t *	pPlainData
	)

Decrypt pCypherData in AES CTR decryption mode using Interrupt, the decyphered data are available in pPlainData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pCypherData	Pointer to the cyphertext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pPlainData	Pointer to the plaintext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_IT() API instead (usage recommended).

Return values

HAL

status

Definition at line 890 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_DECRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CTR;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_IT(hcryp, pCypherData, Size, pPlainData);
}

HAL_CRYP_AESCTR_Encrypt()

HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pPlainData,
		uint16_t	Size,
		uint8_t *	pCypherData,
		uint32_t	Timeout
	)

Encrypt pPlainData in AES CTR encryption mode. The cypher data are available in pCypherData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pPlainData	Pointer to the plaintext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pCypherData	Pointer to the cyphertext buffer
Timeout	Specify Timeout value

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES() API instead (usage recommended).

Return values

HAL

status

Definition at line 616 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_ENCRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CTR;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES(hcryp, pPlainData, Size, pCypherData, Timeout);
}

HAL_CRYP_AESCTR_Encrypt_DMA()

HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt_DMA	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pPlainData,
		uint16_t	Size,
		uint8_t *	pCypherData
	)

Encrypt pPlainData in AES CTR encryption mode using DMA, the cypher data are available in pCypherData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pPlainData	Pointer to the plaintext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pCypherData	Pointer to the cyphertext buffer.

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_DMA() API instead (usage recommended).

pPlainData and pCypherData buffers must be 32-bit aligned to ensure a correct DMA transfer to and from the IP.

Return values

HAL

status

Definition at line 985 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_ENCRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CTR;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_DMA(hcryp, pPlainData, Size, pCypherData);
}

HAL_CRYP_AESCTR_Encrypt_IT()

HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt_IT	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pPlainData,
		uint16_t	Size,
		uint8_t *	pCypherData
	)

Encrypt pPlainData in AES CTR encryption mode using Interrupt, the cypher data are available in pCypherData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pPlainData	Pointer to the plaintext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pCypherData	Pointer to the cyphertext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_IT() API instead (usage recommended).

Return values

HAL

status

Definition at line 800 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_ENCRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_CTR;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_IT(hcryp, pPlainData, Size, pCypherData);
}

HAL_CRYP_AESECB_Decrypt()

HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pCypherData,
		uint16_t	Size,
		uint8_t *	pPlainData,
		uint32_t	Timeout
	)

Decrypt pCypherData in AES ECB decryption mode with key derivation, the decyphered data are available in pPlainData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pCypherData	Pointer to the cyphertext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pPlainData	Pointer to the plaintext buffer
Timeout	Specify Timeout value

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES() API instead (usage recommended).

Return values

HAL

status

Definition at line 647 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_KEYDERIVATION_DECRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_ECB;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES(hcryp, pCypherData, Size, pPlainData, Timeout);
}

HAL_CRYP_AESECB_Decrypt_DMA()

HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt_DMA	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pCypherData,
		uint16_t	Size,
		uint8_t *	pPlainData
	)

Decrypt pCypherData in AES ECB decryption mode using DMA, the decyphered data are available in pPlainData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pCypherData	Pointer to the cyphertext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pPlainData	Pointer to the plaintext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_DMA() API instead (usage recommended).

pPlainData and pCypherData buffers must be 32-bit aligned to ensure a correct DMA transfer to and from the IP.

Return values

HAL

status

Definition at line 1016 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_KEYDERIVATION_DECRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_ECB;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_DMA(hcryp, pCypherData, Size, pPlainData);
}

HAL_CRYP_AESECB_Decrypt_IT()

HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt_IT	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pCypherData,
		uint16_t	Size,
		uint8_t *	pPlainData
	)

Decrypt pCypherData in AES ECB decryption mode using Interrupt, the decyphered data are available in pPlainData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pCypherData	Pointer to the cyphertext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pPlainData	Pointer to the plaintext buffer.

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_IT() API instead (usage recommended).

Return values

HAL

status

Definition at line 830 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_KEYDERIVATION_DECRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_ECB;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_IT(hcryp, pCypherData, Size, pPlainData);
}

HAL_CRYP_AESECB_Encrypt()

HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pPlainData,
		uint16_t	Size,
		uint8_t *	pCypherData,
		uint32_t	Timeout
	)

Encrypt pPlainData in AES ECB encryption mode. The cypher data are available in pCypherData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pPlainData	Pointer to the plaintext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pCypherData	Pointer to the cyphertext buffer
Timeout	Specify Timeout value

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES() API instead (usage recommended).

Return values

HAL

status

Definition at line 554 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_ENCRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_ECB;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES(hcryp, pPlainData, Size, pCypherData, Timeout);
}

HAL_CRYP_AESECB_Encrypt_DMA()

HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt_DMA	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pPlainData,
		uint16_t	Size,
		uint8_t *	pCypherData
	)

Encrypt pPlainData in AES ECB encryption mode using DMA, the cypher data are available in pCypherData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pPlainData	Pointer to the plaintext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pCypherData	Pointer to the cyphertext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_DMA() API instead (usage recommended).

pPlainData and pCypherData buffers must be 32-bit aligned to ensure a correct DMA transfer to and from the IP.

Return values

HAL

status

Definition at line 921 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_ENCRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_ECB;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_DMA(hcryp, pPlainData, Size, pCypherData);
}

HAL_CRYP_AESECB_Encrypt_IT()

HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt_IT	(	CRYP_HandleTypeDef *	hcryp,
		uint8_t *	pPlainData,
		uint16_t	Size,
		uint8_t *	pCypherData
	)

Encrypt pPlainData in AES ECB encryption mode using Interrupt, the cypher data are available in pCypherData.

Parameters

hcryp	pointer to a CRYP_HandleTypeDef structure that contains the configuration information for CRYP module
pPlainData	Pointer to the plaintext buffer
Size	Length of the plaintext buffer in bytes, must be a multiple of 16.
pCypherData	Pointer to the cyphertext buffer

Note

This API is provided only to maintain compatibility with legacy software. Users should directly resort to generic HAL_CRYPEx_AES_IT() API instead (usage recommended).

Return values

HAL

status

Definition at line 739 of file stm32l4xx_hal_cryp.c.

{
  /* Re-initialize AES IP with proper parameters */
  if (HAL_CRYP_DeInit(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }
  hcryp->Init.OperatingMode = CRYP_ALGOMODE_ENCRYPT;
  hcryp->Init.ChainingMode = CRYP_CHAINMODE_AES_ECB;
  hcryp->Init.KeyWriteFlag = CRYP_KEY_WRITE_ENABLE;
  if (HAL_CRYP_Init(hcryp) != HAL_OK)
  {
    return HAL_ERROR;
  }

  return HAL_CRYPEx_AES_IT(hcryp, pPlainData, Size, pCypherData);
}