HAL HASH Extension Driver

UM1725

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

pOutBuffer: Pointer to the computed digest. Its size must be

20 bytes.

Timeout: Timeout value

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA224_Start_IT

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size, uint8_t * pOutBuffer)

Function Description

Initializes the HASH peripheral in SHA224 mode then processes

pInBuffer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

pOutBuffer: Pointer to the computed digest. Its size must be

20 bytes.

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA256_Start_IT

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size, uint8_t * pOutBuffer)

Function Description

Initializes the HASH peripheral in SHA256 mode then processes

pInBuffer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

pOutBuffer: Pointer to the computed digest. Its size must be

20 bytes.

Return values

HAL status

Function Name

void HAL_HASHEx_IRQHandler (HASH_HandleTypeDef *

hhash)

Function Description

This function handles HASH interrupt request.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

Return values

None

380/900

DOCID025834 Rev 2

UM1725

HAL HASH Extension Driver

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA224_Start_DMA

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size)

Function Description

Initializes the HASH peripheral in SHA224 mode then enables

DMA to control data transfer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA224_Finish

(HASH_HandleTypeDef * hhash, uint8_t * pOutBuffer, uint32_t

Timeout)

Function Description

Returns the computed digest in SHA224.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pOutBuffer: Pointer to the computed digest. Its size must be

28 bytes.

Timeout: Timeout value

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA256_Start_DMA

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size)

Function Description

Initializes the HASH peripheral in SHA256 mode then enables

DMA to control data transfer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA256_Finish

(HASH_HandleTypeDef * hhash, uint8_t * pOutBuffer, uint32_t

Timeout)

Function Description

Returns the computed digest in SHA256.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

DOCID025834 Rev 2

381/900

HAL HASH Extension Driver

UM1725

pOutBuffer: Pointer to the computed digest. Its size must be

32 bytes.

Timeout: Timeout value

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HMACEx_SHA224_Start_DMA

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size)

Function Description

Initializes the HASH peripheral in HMAC SHA224 mode then

enables DMA to control data transfer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HMACEx_SHA256_Start_DMA

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size)

Function Description

Initializes the HASH peripheral in HMAC SHA256 mode then

enables DMA to control data transfer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA224_Start

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size, uint8_t * pOutBuffer, uint32_t Timeout)

Function Description

Initializes the HASH peripheral in SHA224 mode then processes

pInBuffer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

pOutBuffer: Pointer to the computed digest. Its size must be

28 bytes.

Timeout: Specify Timeout value

382/900

DOCID025834 Rev 2

UM1725

HAL HASH Extension Driver

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA256_Start

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size, uint8_t * pOutBuffer, uint32_t Timeout)

Function Description

Initializes the HASH peripheral in SHA256 mode then processes

pInBuffer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

pOutBuffer: Pointer to the computed digest. Its size must be

32 bytes.

Timeout: Specify Timeout value

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA224_Accumulate

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size)

Function Description

Initializes the HASH peripheral in SHA224 mode then processes

pInBuffer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

Return values

HAL status

Function Name

HAL_StatusTypeDef HAL_HASHEx_SHA256_Accumulate

(HASH_HandleTypeDef * hhash, uint8_t * pInBuffer, uint32_t

Size)

Function Description

Initializes the HASH peripheral in SHA256 mode then processes

pInBuffer.

Parameters

hhash: pointer to a HASH_HandleTypeDef structure that

contains the configuration information for HASH module

pInBuffer: Pointer to the input buffer (buffer to be hashed).

Size: Length of the input buffer in bytes. If the Size is not

multiple of 64 bytes, the padding is managed by hardware.

Return values

HAL status

DOCID025834 Rev 2

383/900