mbed - The official Mbed 2 C/C++ SDK provides the softwa…

Users » mbed_official » Code » mbed

mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents: hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_ELMO_F411RE/TOOLCHAIN_GCC_ARM/stm32f4xx_hal_cryp.h@172:65be27845400, 2019-02-20 (annotated)

Committer:: AnnaBridge
Date:: Wed Feb 20 20:53:29 2019 +0000
Revision:: 172:65be27845400
Parent:: 171:3a7713b1edbc

mbed library release version 165

Who changed what in which revision?

User	Revision	Line number	New contents of line
Anna Bridge	160:5571c4ff569f	1	/**
Anna Bridge	160:5571c4ff569f	2	******************************************************************************
Anna Bridge	160:5571c4ff569f	3	* @file stm32f4xx_hal_cryp.h
Anna Bridge	160:5571c4ff569f	4	* @author MCD Application Team
Anna Bridge	160:5571c4ff569f	5	* @brief Header file of CRYP HAL module.
Anna Bridge	160:5571c4ff569f	6	******************************************************************************
Anna Bridge	160:5571c4ff569f	7	* @attention
Anna Bridge	160:5571c4ff569f	8	*
Anna Bridge	160:5571c4ff569f	9	* <h2><center>© COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
Anna Bridge	160:5571c4ff569f	10	*
Anna Bridge	160:5571c4ff569f	11	* Redistribution and use in source and binary forms, with or without modification,
Anna Bridge	160:5571c4ff569f	12	* are permitted provided that the following conditions are met:
Anna Bridge	160:5571c4ff569f	13	* 1. Redistributions of source code must retain the above copyright notice,
Anna Bridge	160:5571c4ff569f	14	* this list of conditions and the following disclaimer.
Anna Bridge	160:5571c4ff569f	15	* 2. Redistributions in binary form must reproduce the above copyright notice,
Anna Bridge	160:5571c4ff569f	16	* this list of conditions and the following disclaimer in the documentation
Anna Bridge	160:5571c4ff569f	17	* and/or other materials provided with the distribution.
Anna Bridge	160:5571c4ff569f	18	* 3. Neither the name of STMicroelectronics nor the names of its contributors
Anna Bridge	160:5571c4ff569f	19	* may be used to endorse or promote products derived from this software
Anna Bridge	160:5571c4ff569f	20	* without specific prior written permission.
Anna Bridge	160:5571c4ff569f	21	*
Anna Bridge	160:5571c4ff569f	22	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Anna Bridge	160:5571c4ff569f	23	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Anna Bridge	160:5571c4ff569f	24	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Anna Bridge	160:5571c4ff569f	25	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Anna Bridge	160:5571c4ff569f	26	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Anna Bridge	160:5571c4ff569f	27	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Anna Bridge	160:5571c4ff569f	28	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Anna Bridge	160:5571c4ff569f	29	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Anna Bridge	160:5571c4ff569f	30	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Anna Bridge	160:5571c4ff569f	31	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Anna Bridge	160:5571c4ff569f	32	*
Anna Bridge	160:5571c4ff569f	33	******************************************************************************
Anna Bridge	160:5571c4ff569f	34	*/
Anna Bridge	160:5571c4ff569f	35
Anna Bridge	160:5571c4ff569f	36	/* Define to prevent recursive inclusion -------------------------------------*/
Anna Bridge	160:5571c4ff569f	37	#ifndef __STM32F4xx_HAL_CRYP_H
Anna Bridge	160:5571c4ff569f	38	#define __STM32F4xx_HAL_CRYP_H
Anna Bridge	160:5571c4ff569f	39
Anna Bridge	160:5571c4ff569f	40	#ifdef __cplusplus
Anna Bridge	160:5571c4ff569f	41	extern "C" {
Anna Bridge	160:5571c4ff569f	42	#endif
Anna Bridge	160:5571c4ff569f	43
Anna Bridge	160:5571c4ff569f	44	/* Includes ------------------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	45	#include "stm32f4xx_hal_def.h"
Anna Bridge	160:5571c4ff569f	46
Anna Bridge	160:5571c4ff569f	47
Anna Bridge	160:5571c4ff569f	48	#if defined(CRYP)
Anna Bridge	160:5571c4ff569f	49
Anna Bridge	160:5571c4ff569f	50	/** @addtogroup STM32F4xx_HAL_Driver
Anna Bridge	160:5571c4ff569f	51	* @{
Anna Bridge	160:5571c4ff569f	52	*/
Anna Bridge	160:5571c4ff569f	53
Anna Bridge	160:5571c4ff569f	54	/** @addtogroup CRYP
Anna Bridge	160:5571c4ff569f	55	* @{
Anna Bridge	160:5571c4ff569f	56	*/
Anna Bridge	160:5571c4ff569f	57
Anna Bridge	160:5571c4ff569f	58	/* Exported types ------------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	59
Anna Bridge	160:5571c4ff569f	60	/** @defgroup CRYP_Exported_Types CRYP Exported Types
Anna Bridge	160:5571c4ff569f	61	* @{
Anna Bridge	160:5571c4ff569f	62	*/
Anna Bridge	160:5571c4ff569f	63
Anna Bridge	160:5571c4ff569f	64	/** @defgroup CRYP_Exported_Types_Group1 CRYP Configuration Structure definition
Anna Bridge	160:5571c4ff569f	65	* @{
Anna Bridge	160:5571c4ff569f	66	*/
Anna Bridge	160:5571c4ff569f	67
Anna Bridge	160:5571c4ff569f	68	typedef struct
Anna Bridge	160:5571c4ff569f	69	{
Anna Bridge	160:5571c4ff569f	70	uint32_t DataType; /*!< 32-bit data, 16-bit data, 8-bit data or 1-bit string.
Anna Bridge	160:5571c4ff569f	71	This parameter can be a value of @ref CRYP_Data_Type */
Anna Bridge	160:5571c4ff569f	72
Anna Bridge	160:5571c4ff569f	73	uint32_t KeySize; /*!< Used only in AES mode only : 128, 192 or 256 bit key length.
Anna Bridge	160:5571c4ff569f	74	This parameter can be a value of @ref CRYP_Key_Size */
Anna Bridge	160:5571c4ff569f	75
Anna Bridge	160:5571c4ff569f	76	uint8_t* pKey; /!< The key used for encryption/decryption /
Anna Bridge	160:5571c4ff569f	77
Anna Bridge	160:5571c4ff569f	78	uint8_t* pInitVect; /*!< The initialization vector used also as initialization
Anna Bridge	160:5571c4ff569f	79	counter in CTR mode */
Anna Bridge	160:5571c4ff569f	80
Anna Bridge	160:5571c4ff569f	81	uint8_t IVSize; /*!< The size of initialization vector.
Anna Bridge	160:5571c4ff569f	82	This parameter (called nonce size in CCM) is used only
Anna Bridge	160:5571c4ff569f	83	in AES-128/192/256 encryption/decryption CCM mode */
Anna Bridge	160:5571c4ff569f	84
Anna Bridge	160:5571c4ff569f	85	uint8_t TagSize; /*!< The size of returned authentication TAG.
Anna Bridge	160:5571c4ff569f	86	This parameter is used only in AES-128/192/256
Anna Bridge	160:5571c4ff569f	87	encryption/decryption CCM mode */
Anna Bridge	160:5571c4ff569f	88
Anna Bridge	160:5571c4ff569f	89	uint8_t* Header; /!< The header used in GCM and CCM modes /
Anna Bridge	160:5571c4ff569f	90
Anna Bridge	160:5571c4ff569f	91	uint32_t HeaderSize; /!< The size of header buffer in bytes /
Anna Bridge	160:5571c4ff569f	92
Anna Bridge	160:5571c4ff569f	93	uint8_t* pScratch; /*!< Scratch buffer used to append the header. It's size must be equal to header size + 21 bytes.
Anna Bridge	160:5571c4ff569f	94	This parameter is used only in AES-128/192/256 encryption/decryption CCM mode */
Anna Bridge	160:5571c4ff569f	95	}CRYP_InitTypeDef;
Anna Bridge	160:5571c4ff569f	96
Anna Bridge	160:5571c4ff569f	97	/**
Anna Bridge	160:5571c4ff569f	98	* @}
Anna Bridge	160:5571c4ff569f	99	*/
Anna Bridge	160:5571c4ff569f	100
Anna Bridge	160:5571c4ff569f	101	/** @defgroup CRYP_Exported_Types_Group2 CRYP State structures definition
Anna Bridge	160:5571c4ff569f	102	* @{
Anna Bridge	160:5571c4ff569f	103	*/
Anna Bridge	160:5571c4ff569f	104
Anna Bridge	160:5571c4ff569f	105
Anna Bridge	160:5571c4ff569f	106	typedef enum
Anna Bridge	160:5571c4ff569f	107	{
Anna Bridge	160:5571c4ff569f	108	HAL_CRYP_STATE_RESET = 0x00U, /!< CRYP not yet initialized or disabled /
Anna Bridge	160:5571c4ff569f	109	HAL_CRYP_STATE_READY = 0x01U, /!< CRYP initialized and ready for use /
Anna Bridge	160:5571c4ff569f	110	HAL_CRYP_STATE_BUSY = 0x02U, /!< CRYP internal processing is ongoing /
Anna Bridge	160:5571c4ff569f	111	HAL_CRYP_STATE_TIMEOUT = 0x03U, /!< CRYP timeout state /
Anna Bridge	160:5571c4ff569f	112	HAL_CRYP_STATE_ERROR = 0x04U /!< CRYP error state /
Anna Bridge	160:5571c4ff569f	113	}HAL_CRYP_STATETypeDef;
Anna Bridge	160:5571c4ff569f	114
Anna Bridge	160:5571c4ff569f	115	/**
Anna Bridge	160:5571c4ff569f	116	* @}
Anna Bridge	160:5571c4ff569f	117	*/
Anna Bridge	160:5571c4ff569f	118
Anna Bridge	160:5571c4ff569f	119	/** @defgroup CRYP_Exported_Types_Group3 CRYP phase structures definition
Anna Bridge	160:5571c4ff569f	120	* @{
Anna Bridge	160:5571c4ff569f	121	*/
Anna Bridge	160:5571c4ff569f	122
Anna Bridge	160:5571c4ff569f	123
Anna Bridge	160:5571c4ff569f	124	typedef enum
Anna Bridge	160:5571c4ff569f	125	{
Anna Bridge	160:5571c4ff569f	126	HAL_CRYP_PHASE_READY = 0x01U, /!< CRYP peripheral is ready for initialization. /
Anna Bridge	160:5571c4ff569f	127	HAL_CRYP_PHASE_PROCESS = 0x02U, /!< CRYP peripheral is in processing phase /
Anna Bridge	160:5571c4ff569f	128	HAL_CRYP_PHASE_FINAL = 0x03U /*!< CRYP peripheral is in final phase
Anna Bridge	160:5571c4ff569f	129	This is relevant only with CCM and GCM modes */
Anna Bridge	160:5571c4ff569f	130	}HAL_PhaseTypeDef;
Anna Bridge	160:5571c4ff569f	131
Anna Bridge	160:5571c4ff569f	132	/**
Anna Bridge	160:5571c4ff569f	133	* @}
Anna Bridge	160:5571c4ff569f	134	*/
Anna Bridge	160:5571c4ff569f	135
Anna Bridge	160:5571c4ff569f	136	/** @defgroup CRYP_Exported_Types_Group4 CRYP handle Structure definition
Anna Bridge	160:5571c4ff569f	137	* @{
Anna Bridge	160:5571c4ff569f	138	*/
Anna Bridge	160:5571c4ff569f	139
Anna Bridge	160:5571c4ff569f	140	typedef struct
Anna Bridge	160:5571c4ff569f	141	{
Anna Bridge	160:5571c4ff569f	142	CRYP_TypeDef Instance; /!< CRYP registers base address */
Anna Bridge	160:5571c4ff569f	143
Anna Bridge	160:5571c4ff569f	144	CRYP_InitTypeDef Init; /!< CRYP required parameters /
Anna Bridge	160:5571c4ff569f	145
Anna Bridge	160:5571c4ff569f	146	uint8_t pCrypInBuffPtr; /!< Pointer to CRYP processing (encryption, decryption,...) buffer */
Anna Bridge	160:5571c4ff569f	147
Anna Bridge	160:5571c4ff569f	148	uint8_t pCrypOutBuffPtr; /!< Pointer to CRYP processing (encryption, decryption,...) buffer */
Anna Bridge	160:5571c4ff569f	149
Anna Bridge	160:5571c4ff569f	150	__IO uint16_t CrypInCount; /!< Counter of inputed data /
Anna Bridge	160:5571c4ff569f	151
Anna Bridge	160:5571c4ff569f	152	__IO uint16_t CrypOutCount; /!< Counter of output data /
Anna Bridge	160:5571c4ff569f	153
Anna Bridge	160:5571c4ff569f	154	HAL_StatusTypeDef Status; /!< CRYP peripheral status /
Anna Bridge	160:5571c4ff569f	155
Anna Bridge	160:5571c4ff569f	156	HAL_PhaseTypeDef Phase; /!< CRYP peripheral phase /
Anna Bridge	160:5571c4ff569f	157
Anna Bridge	160:5571c4ff569f	158	DMA_HandleTypeDef hdmain; /!< CRYP In DMA handle parameters */
Anna Bridge	160:5571c4ff569f	159
Anna Bridge	160:5571c4ff569f	160	DMA_HandleTypeDef hdmaout; /!< CRYP Out DMA handle parameters */
Anna Bridge	160:5571c4ff569f	161
Anna Bridge	160:5571c4ff569f	162	HAL_LockTypeDef Lock; /!< CRYP locking object /
Anna Bridge	160:5571c4ff569f	163
Anna Bridge	160:5571c4ff569f	164	__IO HAL_CRYP_STATETypeDef State; /!< CRYP peripheral state /
Anna Bridge	160:5571c4ff569f	165	}CRYP_HandleTypeDef;
Anna Bridge	160:5571c4ff569f	166
Anna Bridge	160:5571c4ff569f	167	/**
Anna Bridge	160:5571c4ff569f	168	* @}
Anna Bridge	160:5571c4ff569f	169	*/
Anna Bridge	160:5571c4ff569f	170
Anna Bridge	160:5571c4ff569f	171	/**
Anna Bridge	160:5571c4ff569f	172	* @}
Anna Bridge	160:5571c4ff569f	173	*/
Anna Bridge	160:5571c4ff569f	174
Anna Bridge	160:5571c4ff569f	175	/* Exported constants --------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	176	/** @defgroup CRYP_Exported_Constants CRYP Exported Constants
Anna Bridge	160:5571c4ff569f	177	* @{
Anna Bridge	160:5571c4ff569f	178	*/
Anna Bridge	160:5571c4ff569f	179
Anna Bridge	160:5571c4ff569f	180	/** @defgroup CRYP_Key_Size CRYP Key Size
Anna Bridge	160:5571c4ff569f	181	* @{
Anna Bridge	160:5571c4ff569f	182	*/
Anna Bridge	160:5571c4ff569f	183	#define CRYP_KEYSIZE_128B 0x00000000U
Anna Bridge	160:5571c4ff569f	184	#define CRYP_KEYSIZE_192B CRYP_CR_KEYSIZE_0
Anna Bridge	160:5571c4ff569f	185	#define CRYP_KEYSIZE_256B CRYP_CR_KEYSIZE_1
Anna Bridge	160:5571c4ff569f	186	/**
Anna Bridge	160:5571c4ff569f	187	* @}
Anna Bridge	160:5571c4ff569f	188	*/
Anna Bridge	160:5571c4ff569f	189
Anna Bridge	160:5571c4ff569f	190	/** @defgroup CRYP_Data_Type CRYP Data Type
Anna Bridge	160:5571c4ff569f	191	* @{
Anna Bridge	160:5571c4ff569f	192	*/
Anna Bridge	160:5571c4ff569f	193	#define CRYP_DATATYPE_32B 0x00000000U
Anna Bridge	160:5571c4ff569f	194	#define CRYP_DATATYPE_16B CRYP_CR_DATATYPE_0
Anna Bridge	160:5571c4ff569f	195	#define CRYP_DATATYPE_8B CRYP_CR_DATATYPE_1
Anna Bridge	160:5571c4ff569f	196	#define CRYP_DATATYPE_1B CRYP_CR_DATATYPE
Anna Bridge	160:5571c4ff569f	197	/**
Anna Bridge	160:5571c4ff569f	198	* @}
Anna Bridge	160:5571c4ff569f	199	*/
Anna Bridge	160:5571c4ff569f	200
Anna Bridge	160:5571c4ff569f	201	/** @defgroup CRYP_Exported_Constants_Group3 CRYP CRYP_AlgoModeDirection
Anna Bridge	160:5571c4ff569f	202	* @{
Anna Bridge	160:5571c4ff569f	203	*/
Anna Bridge	160:5571c4ff569f	204	#define CRYP_CR_ALGOMODE_DIRECTION 0x0008003CU
Anna Bridge	160:5571c4ff569f	205	#define CRYP_CR_ALGOMODE_TDES_ECB_ENCRYPT 0x00000000U
Anna Bridge	160:5571c4ff569f	206	#define CRYP_CR_ALGOMODE_TDES_ECB_DECRYPT 0x00000004U
Anna Bridge	160:5571c4ff569f	207	#define CRYP_CR_ALGOMODE_TDES_CBC_ENCRYPT 0x00000008U
Anna Bridge	160:5571c4ff569f	208	#define CRYP_CR_ALGOMODE_TDES_CBC_DECRYPT 0x0000000CU
Anna Bridge	160:5571c4ff569f	209	#define CRYP_CR_ALGOMODE_DES_ECB_ENCRYPT 0x00000010U
Anna Bridge	160:5571c4ff569f	210	#define CRYP_CR_ALGOMODE_DES_ECB_DECRYPT 0x00000014U
Anna Bridge	160:5571c4ff569f	211	#define CRYP_CR_ALGOMODE_DES_CBC_ENCRYPT 0x00000018U
Anna Bridge	160:5571c4ff569f	212	#define CRYP_CR_ALGOMODE_DES_CBC_DECRYPT 0x0000001CU
Anna Bridge	160:5571c4ff569f	213	#define CRYP_CR_ALGOMODE_AES_ECB_ENCRYPT 0x00000020U
Anna Bridge	160:5571c4ff569f	214	#define CRYP_CR_ALGOMODE_AES_ECB_DECRYPT 0x00000024U
Anna Bridge	160:5571c4ff569f	215	#define CRYP_CR_ALGOMODE_AES_CBC_ENCRYPT 0x00000028U
Anna Bridge	160:5571c4ff569f	216	#define CRYP_CR_ALGOMODE_AES_CBC_DECRYPT 0x0000002CU
Anna Bridge	160:5571c4ff569f	217	#define CRYP_CR_ALGOMODE_AES_CTR_ENCRYPT 0x00000030U
Anna Bridge	160:5571c4ff569f	218	#define CRYP_CR_ALGOMODE_AES_CTR_DECRYPT 0x00000034U
Anna Bridge	160:5571c4ff569f	219	/**
Anna Bridge	160:5571c4ff569f	220	* @}
Anna Bridge	160:5571c4ff569f	221	*/
Anna Bridge	160:5571c4ff569f	222
Anna Bridge	160:5571c4ff569f	223	/** @defgroup CRYP_Exported_Constants_Group4 CRYP CRYP_Interrupt
Anna Bridge	160:5571c4ff569f	224	* @{
Anna Bridge	160:5571c4ff569f	225	*/
Anna Bridge	160:5571c4ff569f	226	#define CRYP_IT_INI ((uint32_t)CRYP_IMSCR_INIM) /!< Input FIFO Interrupt /
Anna Bridge	160:5571c4ff569f	227	#define CRYP_IT_OUTI ((uint32_t)CRYP_IMSCR_OUTIM) /!< Output FIFO Interrupt /
Anna Bridge	160:5571c4ff569f	228	/**
Anna Bridge	160:5571c4ff569f	229	* @}
Anna Bridge	160:5571c4ff569f	230	*/
Anna Bridge	160:5571c4ff569f	231
Anna Bridge	160:5571c4ff569f	232	/** @defgroup CRYP_Exported_Constants_Group5 CRYP CRYP_Flags
Anna Bridge	160:5571c4ff569f	233	* @{
Anna Bridge	160:5571c4ff569f	234	*/
Anna Bridge	160:5571c4ff569f	235	#define CRYP_FLAG_BUSY 0x00000010U /*!< The CRYP core is currently
Anna Bridge	160:5571c4ff569f	236	processing a block of data
Anna Bridge	160:5571c4ff569f	237	or a key preparation (for
Anna Bridge	160:5571c4ff569f	238	AES decryption). */
Anna Bridge	160:5571c4ff569f	239	#define CRYP_FLAG_IFEM 0x00000001U /!< Input FIFO is empty /
Anna Bridge	160:5571c4ff569f	240	#define CRYP_FLAG_IFNF 0x00000002U /!< Input FIFO is not Full /
Anna Bridge	160:5571c4ff569f	241	#define CRYP_FLAG_OFNE 0x00000004U /!< Output FIFO is not empty /
Anna Bridge	160:5571c4ff569f	242	#define CRYP_FLAG_OFFU 0x00000008U /!< Output FIFO is Full /
Anna Bridge	160:5571c4ff569f	243	#define CRYP_FLAG_OUTRIS 0x01000002U /*!< Output FIFO service raw
Anna Bridge	160:5571c4ff569f	244	interrupt status */
Anna Bridge	160:5571c4ff569f	245	#define CRYP_FLAG_INRIS 0x01000001U /*!< Input FIFO service raw
Anna Bridge	160:5571c4ff569f	246	interrupt status */
Anna Bridge	160:5571c4ff569f	247	/**
Anna Bridge	160:5571c4ff569f	248	* @}
Anna Bridge	160:5571c4ff569f	249	*/
Anna Bridge	160:5571c4ff569f	250
Anna Bridge	160:5571c4ff569f	251	/**
Anna Bridge	160:5571c4ff569f	252	* @}
Anna Bridge	160:5571c4ff569f	253	*/
Anna Bridge	160:5571c4ff569f	254
Anna Bridge	160:5571c4ff569f	255	/* Exported macro ------------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	256	/** @defgroup CRYP_Exported_Macros CRYP Exported Macros
Anna Bridge	160:5571c4ff569f	257	* @{
Anna Bridge	160:5571c4ff569f	258	*/
Anna Bridge	160:5571c4ff569f	259
Anna Bridge	160:5571c4ff569f	260	/** @brief Reset CRYP handle state
AnnaBridge	163:e59c8e839560	261	* @param __HANDLE__ specifies the CRYP handle.
Anna Bridge	160:5571c4ff569f	262	* @retval None
Anna Bridge	160:5571c4ff569f	263	*/
Anna Bridge	160:5571c4ff569f	264	#define __HAL_CRYP_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_CRYP_STATE_RESET)
Anna Bridge	160:5571c4ff569f	265
Anna Bridge	160:5571c4ff569f	266	/**
Anna Bridge	160:5571c4ff569f	267	* @brief Enable/Disable the CRYP peripheral.
AnnaBridge	163:e59c8e839560	268	* @param __HANDLE__ specifies the CRYP handle.
Anna Bridge	160:5571c4ff569f	269	* @retval None
Anna Bridge	160:5571c4ff569f	270	*/
Anna Bridge	160:5571c4ff569f	271	#define __HAL_CRYP_ENABLE(__HANDLE__) ((__HANDLE__)->Instance->CR \|= CRYP_CR_CRYPEN)
Anna Bridge	160:5571c4ff569f	272	#define __HAL_CRYP_DISABLE(__HANDLE__) ((__HANDLE__)->Instance->CR &= ~CRYP_CR_CRYPEN)
Anna Bridge	160:5571c4ff569f	273
Anna Bridge	160:5571c4ff569f	274	/**
Anna Bridge	160:5571c4ff569f	275	* @brief Flush the data FIFO.
AnnaBridge	163:e59c8e839560	276	* @param __HANDLE__ specifies the CRYP handle.
Anna Bridge	160:5571c4ff569f	277	* @retval None
Anna Bridge	160:5571c4ff569f	278	*/
Anna Bridge	160:5571c4ff569f	279	#define __HAL_CRYP_FIFO_FLUSH(__HANDLE__) ((__HANDLE__)->Instance->CR \|= CRYP_CR_FFLUSH)
Anna Bridge	160:5571c4ff569f	280
Anna Bridge	160:5571c4ff569f	281	/**
Anna Bridge	160:5571c4ff569f	282	* @brief Set the algorithm mode: AES-ECB, AES-CBC, AES-CTR, DES-ECB, DES-CBC.
AnnaBridge	163:e59c8e839560	283	* @param __HANDLE__ specifies the CRYP handle.
AnnaBridge	163:e59c8e839560	284	* @param MODE The algorithm mode.
Anna Bridge	160:5571c4ff569f	285	* @retval None
Anna Bridge	160:5571c4ff569f	286	*/
Anna Bridge	160:5571c4ff569f	287	#define __HAL_CRYP_SET_MODE(__HANDLE__, MODE) ((__HANDLE__)->Instance->CR \|= (uint32_t)(MODE))
Anna Bridge	160:5571c4ff569f	288
Anna Bridge	160:5571c4ff569f	289	/** @brief Check whether the specified CRYP flag is set or not.
AnnaBridge	163:e59c8e839560	290	* @param __HANDLE__ specifies the CRYP handle.
AnnaBridge	163:e59c8e839560	291	* @param __FLAG__ specifies the flag to check.
Anna Bridge	160:5571c4ff569f	292	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	293	* @arg CRYP_FLAG_BUSY: The CRYP core is currently processing a block of data
Anna Bridge	160:5571c4ff569f	294	* or a key preparation (for AES decryption).
Anna Bridge	160:5571c4ff569f	295	* @arg CRYP_FLAG_IFEM: Input FIFO is empty
Anna Bridge	160:5571c4ff569f	296	* @arg CRYP_FLAG_IFNF: Input FIFO is not full
Anna Bridge	160:5571c4ff569f	297	* @arg CRYP_FLAG_INRIS: Input FIFO service raw interrupt is pending
Anna Bridge	160:5571c4ff569f	298	* @arg CRYP_FLAG_OFNE: Output FIFO is not empty
Anna Bridge	160:5571c4ff569f	299	* @arg CRYP_FLAG_OFFU: Output FIFO is full
Anna Bridge	160:5571c4ff569f	300	* @arg CRYP_FLAG_OUTRIS: Input FIFO service raw interrupt is pending
Anna Bridge	160:5571c4ff569f	301	* @retval The new state of __FLAG__ (TRUE or FALSE).
Anna Bridge	160:5571c4ff569f	302	*/
Anna Bridge	160:5571c4ff569f	303
Anna Bridge	160:5571c4ff569f	304	#define __HAL_CRYP_GET_FLAG(__HANDLE__, __FLAG__) ((((uint8_t)((__FLAG__) >> 24U)) == 0x01U)?((((__HANDLE__)->Instance->RISR) & ((__FLAG__) & CRYP_FLAG_MASK)) == ((__FLAG__) & CRYP_FLAG_MASK)): \
Anna Bridge	160:5571c4ff569f	305	((((__HANDLE__)->Instance->RISR) & ((__FLAG__) & CRYP_FLAG_MASK)) == ((__FLAG__) & CRYP_FLAG_MASK)))
Anna Bridge	160:5571c4ff569f	306
Anna Bridge	160:5571c4ff569f	307	/** @brief Check whether the specified CRYP interrupt is set or not.
AnnaBridge	163:e59c8e839560	308	* @param __HANDLE__ specifies the CRYP handle.
AnnaBridge	163:e59c8e839560	309	* @param __INTERRUPT__ specifies the interrupt to check.
Anna Bridge	160:5571c4ff569f	310	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	311	* @arg CRYP_IT_INRIS: Input FIFO service raw interrupt is pending
Anna Bridge	160:5571c4ff569f	312	* @arg CRYP_IT_OUTRIS: Output FIFO service raw interrupt is pending
Anna Bridge	160:5571c4ff569f	313	* @retval The new state of __INTERRUPT__ (TRUE or FALSE).
Anna Bridge	160:5571c4ff569f	314	*/
Anna Bridge	160:5571c4ff569f	315	#define __HAL_CRYP_GET_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->MISR & (__INTERRUPT__)) == (__INTERRUPT__))
Anna Bridge	160:5571c4ff569f	316
Anna Bridge	160:5571c4ff569f	317	/**
Anna Bridge	160:5571c4ff569f	318	* @brief Enable the CRYP interrupt.
AnnaBridge	163:e59c8e839560	319	* @param __HANDLE__ specifies the CRYP handle.
AnnaBridge	163:e59c8e839560	320	* @param __INTERRUPT__ CRYP Interrupt.
Anna Bridge	160:5571c4ff569f	321	* @retval None
Anna Bridge	160:5571c4ff569f	322	*/
Anna Bridge	160:5571c4ff569f	323	#define __HAL_CRYP_ENABLE_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->IMSCR) \|= (__INTERRUPT__))
Anna Bridge	160:5571c4ff569f	324
Anna Bridge	160:5571c4ff569f	325	/**
Anna Bridge	160:5571c4ff569f	326	* @brief Disable the CRYP interrupt.
AnnaBridge	163:e59c8e839560	327	* @param __HANDLE__ specifies the CRYP handle.
AnnaBridge	163:e59c8e839560	328	* @param __INTERRUPT__ CRYP interrupt.
Anna Bridge	160:5571c4ff569f	329	* @retval None
Anna Bridge	160:5571c4ff569f	330	*/
Anna Bridge	160:5571c4ff569f	331	#define __HAL_CRYP_DISABLE_IT(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->IMSCR) &= ~(__INTERRUPT__))
Anna Bridge	160:5571c4ff569f	332
Anna Bridge	160:5571c4ff569f	333	/**
Anna Bridge	160:5571c4ff569f	334	* @}
Anna Bridge	160:5571c4ff569f	335	*/
Anna Bridge	160:5571c4ff569f	336
Anna Bridge	160:5571c4ff569f	337	/* Include CRYP HAL Extension module */
Anna Bridge	160:5571c4ff569f	338	#include "stm32f4xx_hal_cryp_ex.h"
Anna Bridge	160:5571c4ff569f	339
Anna Bridge	160:5571c4ff569f	340	/* Exported functions --------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	341	/** @defgroup CRYP_Exported_Functions CRYP Exported Functions
Anna Bridge	160:5571c4ff569f	342	* @{
Anna Bridge	160:5571c4ff569f	343	*/
Anna Bridge	160:5571c4ff569f	344
Anna Bridge	160:5571c4ff569f	345	/** @addtogroup CRYP_Exported_Functions_Group1
Anna Bridge	160:5571c4ff569f	346	* @{
Anna Bridge	160:5571c4ff569f	347	*/
Anna Bridge	160:5571c4ff569f	348	HAL_StatusTypeDef HAL_CRYP_Init(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	349	HAL_StatusTypeDef HAL_CRYP_DeInit(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	350	void HAL_CRYP_MspInit(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	351	void HAL_CRYP_MspDeInit(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	352	/**
Anna Bridge	160:5571c4ff569f	353	* @}
Anna Bridge	160:5571c4ff569f	354	*/
Anna Bridge	160:5571c4ff569f	355
Anna Bridge	160:5571c4ff569f	356	/** @addtogroup CRYP_Exported_Functions_Group2
Anna Bridge	160:5571c4ff569f	357	* @{
Anna Bridge	160:5571c4ff569f	358	*/
Anna Bridge	160:5571c4ff569f	359	/* AES encryption/decryption using polling ***********************************/
Anna Bridge	160:5571c4ff569f	360	HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	361	HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	362	HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	363	HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	364	HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	365	HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	366
Anna Bridge	160:5571c4ff569f	367	/* AES encryption/decryption using interrupt *********************************/
Anna Bridge	160:5571c4ff569f	368	HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	369	HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	370	HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	371	HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	372	HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	373	HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	374
Anna Bridge	160:5571c4ff569f	375	/* AES encryption/decryption using DMA ***************************************/
Anna Bridge	160:5571c4ff569f	376	HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	377	HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	378	HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	379	HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	380	HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	381	HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	382	/**
Anna Bridge	160:5571c4ff569f	383	* @}
Anna Bridge	160:5571c4ff569f	384	*/
Anna Bridge	160:5571c4ff569f	385
Anna Bridge	160:5571c4ff569f	386	/** @addtogroup CRYP_Exported_Functions_Group3
Anna Bridge	160:5571c4ff569f	387	* @{
Anna Bridge	160:5571c4ff569f	388	*/
Anna Bridge	160:5571c4ff569f	389	/* DES encryption/decryption using polling ***********************************/
Anna Bridge	160:5571c4ff569f	390	HAL_StatusTypeDef HAL_CRYP_DESECB_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	391	HAL_StatusTypeDef HAL_CRYP_DESCBC_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	392	HAL_StatusTypeDef HAL_CRYP_DESECB_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	393	HAL_StatusTypeDef HAL_CRYP_DESCBC_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	394
Anna Bridge	160:5571c4ff569f	395	/* DES encryption/decryption using interrupt *********************************/
Anna Bridge	160:5571c4ff569f	396	HAL_StatusTypeDef HAL_CRYP_DESECB_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	397	HAL_StatusTypeDef HAL_CRYP_DESECB_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	398	HAL_StatusTypeDef HAL_CRYP_DESCBC_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	399	HAL_StatusTypeDef HAL_CRYP_DESCBC_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	400
Anna Bridge	160:5571c4ff569f	401	/* DES encryption/decryption using DMA ***************************************/
Anna Bridge	160:5571c4ff569f	402	HAL_StatusTypeDef HAL_CRYP_DESECB_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	403	HAL_StatusTypeDef HAL_CRYP_DESECB_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	404	HAL_StatusTypeDef HAL_CRYP_DESCBC_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	405	HAL_StatusTypeDef HAL_CRYP_DESCBC_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	406	/**
Anna Bridge	160:5571c4ff569f	407	* @}
Anna Bridge	160:5571c4ff569f	408	*/
Anna Bridge	160:5571c4ff569f	409
Anna Bridge	160:5571c4ff569f	410	/** @addtogroup CRYP_Exported_Functions_Group4
Anna Bridge	160:5571c4ff569f	411	* @{
Anna Bridge	160:5571c4ff569f	412	*/
Anna Bridge	160:5571c4ff569f	413	/* TDES encryption/decryption using polling **********************************/
Anna Bridge	160:5571c4ff569f	414	HAL_StatusTypeDef HAL_CRYP_TDESECB_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	415	HAL_StatusTypeDef HAL_CRYP_TDESCBC_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	416	HAL_StatusTypeDef HAL_CRYP_TDESECB_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	417	HAL_StatusTypeDef HAL_CRYP_TDESCBC_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	418
Anna Bridge	160:5571c4ff569f	419	/* TDES encryption/decryption using interrupt ********************************/
Anna Bridge	160:5571c4ff569f	420	HAL_StatusTypeDef HAL_CRYP_TDESECB_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	421	HAL_StatusTypeDef HAL_CRYP_TDESECB_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	422	HAL_StatusTypeDef HAL_CRYP_TDESCBC_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	423	HAL_StatusTypeDef HAL_CRYP_TDESCBC_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	424
Anna Bridge	160:5571c4ff569f	425	/* TDES encryption/decryption using DMA **************************************/
Anna Bridge	160:5571c4ff569f	426	HAL_StatusTypeDef HAL_CRYP_TDESECB_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	427	HAL_StatusTypeDef HAL_CRYP_TDESECB_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	428	HAL_StatusTypeDef HAL_CRYP_TDESCBC_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	429	HAL_StatusTypeDef HAL_CRYP_TDESCBC_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	430	/**
Anna Bridge	160:5571c4ff569f	431	* @}
Anna Bridge	160:5571c4ff569f	432	*/
Anna Bridge	160:5571c4ff569f	433
Anna Bridge	160:5571c4ff569f	434	/** @addtogroup CRYP_Exported_Functions_Group5
Anna Bridge	160:5571c4ff569f	435	* @{
Anna Bridge	160:5571c4ff569f	436	*/
Anna Bridge	160:5571c4ff569f	437	void HAL_CRYP_InCpltCallback(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	438	void HAL_CRYP_OutCpltCallback(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	439	void HAL_CRYP_ErrorCallback(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	440	/**
Anna Bridge	160:5571c4ff569f	441	* @}
Anna Bridge	160:5571c4ff569f	442	*/
Anna Bridge	160:5571c4ff569f	443
Anna Bridge	160:5571c4ff569f	444	/** @addtogroup CRYP_Exported_Functions_Group6
Anna Bridge	160:5571c4ff569f	445	* @{
Anna Bridge	160:5571c4ff569f	446	*/
Anna Bridge	160:5571c4ff569f	447	void HAL_CRYP_IRQHandler(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	448	/**
Anna Bridge	160:5571c4ff569f	449	* @}
Anna Bridge	160:5571c4ff569f	450	*/
Anna Bridge	160:5571c4ff569f	451
Anna Bridge	160:5571c4ff569f	452	/** @addtogroup CRYP_Exported_Functions_Group7
Anna Bridge	160:5571c4ff569f	453	* @{
Anna Bridge	160:5571c4ff569f	454	*/
Anna Bridge	160:5571c4ff569f	455	HAL_CRYP_STATETypeDef HAL_CRYP_GetState(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	456	/**
Anna Bridge	160:5571c4ff569f	457	* @}
Anna Bridge	160:5571c4ff569f	458	*/
Anna Bridge	160:5571c4ff569f	459
Anna Bridge	160:5571c4ff569f	460	/**
Anna Bridge	160:5571c4ff569f	461	* @}
Anna Bridge	160:5571c4ff569f	462	*/
Anna Bridge	160:5571c4ff569f	463
Anna Bridge	160:5571c4ff569f	464	/* Private types -------------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	465	/** @defgroup CRYP_Private_Types CRYP Private Types
Anna Bridge	160:5571c4ff569f	466	* @{
Anna Bridge	160:5571c4ff569f	467	*/
Anna Bridge	160:5571c4ff569f	468
Anna Bridge	160:5571c4ff569f	469	/**
Anna Bridge	160:5571c4ff569f	470	* @}
Anna Bridge	160:5571c4ff569f	471	*/
Anna Bridge	160:5571c4ff569f	472
Anna Bridge	160:5571c4ff569f	473	/* Private variables ---------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	474	/** @defgroup CRYP_Private_Variables CRYP Private Variables
Anna Bridge	160:5571c4ff569f	475	* @{
Anna Bridge	160:5571c4ff569f	476	*/
Anna Bridge	160:5571c4ff569f	477
Anna Bridge	160:5571c4ff569f	478	/**
Anna Bridge	160:5571c4ff569f	479	* @}
Anna Bridge	160:5571c4ff569f	480	*/
Anna Bridge	160:5571c4ff569f	481
Anna Bridge	160:5571c4ff569f	482	/* Private constants ---------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	483	/** @defgroup CRYP_Private_Constants CRYP Private Constants
Anna Bridge	160:5571c4ff569f	484	* @{
Anna Bridge	160:5571c4ff569f	485	*/
Anna Bridge	160:5571c4ff569f	486	#define CRYP_FLAG_MASK 0x0000001FU
Anna Bridge	160:5571c4ff569f	487	/**
Anna Bridge	160:5571c4ff569f	488	* @}
Anna Bridge	160:5571c4ff569f	489	*/
Anna Bridge	160:5571c4ff569f	490
Anna Bridge	160:5571c4ff569f	491	/* Private macros ------------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	492	/** @defgroup CRYP_Private_Macros CRYP Private Macros
Anna Bridge	160:5571c4ff569f	493	* @{
Anna Bridge	160:5571c4ff569f	494	*/
Anna Bridge	160:5571c4ff569f	495
Anna Bridge	160:5571c4ff569f	496	#define IS_CRYP_KEYSIZE(__KEYSIZE__) (((__KEYSIZE__) == CRYP_KEYSIZE_128B) \|\| \
Anna Bridge	160:5571c4ff569f	497	((__KEYSIZE__) == CRYP_KEYSIZE_192B) \|\| \
Anna Bridge	160:5571c4ff569f	498	((__KEYSIZE__) == CRYP_KEYSIZE_256B))
Anna Bridge	160:5571c4ff569f	499
Anna Bridge	160:5571c4ff569f	500
Anna Bridge	160:5571c4ff569f	501	#define IS_CRYP_DATATYPE(__DATATYPE__) (((__DATATYPE__) == CRYP_DATATYPE_32B) \|\| \
Anna Bridge	160:5571c4ff569f	502	((__DATATYPE__) == CRYP_DATATYPE_16B) \|\| \
Anna Bridge	160:5571c4ff569f	503	((__DATATYPE__) == CRYP_DATATYPE_8B) \|\| \
Anna Bridge	160:5571c4ff569f	504	((__DATATYPE__) == CRYP_DATATYPE_1B))
Anna Bridge	160:5571c4ff569f	505
Anna Bridge	160:5571c4ff569f	506
Anna Bridge	160:5571c4ff569f	507	/**
Anna Bridge	160:5571c4ff569f	508	* @}
Anna Bridge	160:5571c4ff569f	509	*/
Anna Bridge	160:5571c4ff569f	510
Anna Bridge	160:5571c4ff569f	511	/* Private functions ---------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	512	/** @defgroup CRYP_Private_Functions CRYP Private Functions
Anna Bridge	160:5571c4ff569f	513	* @{
Anna Bridge	160:5571c4ff569f	514	*/
Anna Bridge	160:5571c4ff569f	515
Anna Bridge	160:5571c4ff569f	516	/**
Anna Bridge	160:5571c4ff569f	517	* @}
Anna Bridge	160:5571c4ff569f	518	*/
Anna Bridge	160:5571c4ff569f	519
Anna Bridge	160:5571c4ff569f	520	#endif /* CRYP */
Anna Bridge	160:5571c4ff569f	521
Anna Bridge	160:5571c4ff569f	522	#if defined (AES)
Anna Bridge	160:5571c4ff569f	523
Anna Bridge	160:5571c4ff569f	524	/** @addtogroup STM32F4xx_HAL_Driver
Anna Bridge	160:5571c4ff569f	525	* @{
Anna Bridge	160:5571c4ff569f	526	*/
Anna Bridge	160:5571c4ff569f	527
Anna Bridge	160:5571c4ff569f	528	/** @addtogroup CRYP
Anna Bridge	160:5571c4ff569f	529	* @{
Anna Bridge	160:5571c4ff569f	530	*/
Anna Bridge	160:5571c4ff569f	531
Anna Bridge	160:5571c4ff569f	532	/* Exported types ------------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	533	/** @defgroup CRYP_Exported_Types CRYP Exported Types
Anna Bridge	160:5571c4ff569f	534	* @{
Anna Bridge	160:5571c4ff569f	535	*/
Anna Bridge	160:5571c4ff569f	536
Anna Bridge	160:5571c4ff569f	537	/**
Anna Bridge	160:5571c4ff569f	538	* @brief CRYP Configuration Structure definition
Anna Bridge	160:5571c4ff569f	539	*/
Anna Bridge	160:5571c4ff569f	540	typedef struct
Anna Bridge	160:5571c4ff569f	541	{
Anna Bridge	160:5571c4ff569f	542	uint32_t DataType; /*!< 32-bit data, 16-bit data, 8-bit data or 1-bit string.
Anna Bridge	160:5571c4ff569f	543	This parameter can be a value of @ref CRYP_Data_Type */
Anna Bridge	160:5571c4ff569f	544
Anna Bridge	160:5571c4ff569f	545	uint32_t KeySize; /*!< 128 or 256-bit key length.
Anna Bridge	160:5571c4ff569f	546	This parameter can be a value of @ref CRYP_Key_Size */
Anna Bridge	160:5571c4ff569f	547
Anna Bridge	160:5571c4ff569f	548	uint32_t OperatingMode; /*!< AES operating mode.
Anna Bridge	160:5571c4ff569f	549	This parameter can be a value of @ref CRYP_AES_OperatingMode */
Anna Bridge	160:5571c4ff569f	550
Anna Bridge	160:5571c4ff569f	551	uint32_t ChainingMode; /*!< AES chaining mode.
Anna Bridge	160:5571c4ff569f	552	This parameter can be a value of @ref CRYP_AES_ChainingMode */
Anna Bridge	160:5571c4ff569f	553
Anna Bridge	160:5571c4ff569f	554	uint32_t KeyWriteFlag; /*!< Allows to bypass or not key write-up before decryption.
Anna Bridge	160:5571c4ff569f	555	This parameter can be a value of @ref CRYP_Key_Write */
Anna Bridge	160:5571c4ff569f	556
Anna Bridge	160:5571c4ff569f	557	uint32_t GCMCMACPhase; /*!< Indicates the processing phase of the Galois Counter Mode (GCM),
Anna Bridge	160:5571c4ff569f	558	Galois Message Authentication Code (GMAC) or Cipher Message
Anna Bridge	160:5571c4ff569f	559	Authentication Code (CMAC) or Counter with Cipher Mode (CCM) when
Anna Bridge	160:5571c4ff569f	560	the latter is applicable.
Anna Bridge	160:5571c4ff569f	561	This parameter can be a value of @ref CRYP_GCM_CMAC_Phase */
Anna Bridge	160:5571c4ff569f	562
Anna Bridge	160:5571c4ff569f	563	uint8_t* pKey; /!< Encryption/Decryption Key /
Anna Bridge	160:5571c4ff569f	564
Anna Bridge	160:5571c4ff569f	565	uint8_t* pInitVect; /*!< Initialization Vector used for CTR, CBC, GCM/GMAC, CMAC,
Anna Bridge	160:5571c4ff569f	566	(and CCM when applicable) modes */
Anna Bridge	160:5571c4ff569f	567
Anna Bridge	160:5571c4ff569f	568	uint8_t* Header; /!< Header used in GCM/GMAC, CMAC (and CCM when applicable) modes /
Anna Bridge	160:5571c4ff569f	569
Anna Bridge	160:5571c4ff569f	570	uint64_t HeaderSize; /!< Header size in bytes /
Anna Bridge	160:5571c4ff569f	571
Anna Bridge	160:5571c4ff569f	572	}CRYP_InitTypeDef;
Anna Bridge	160:5571c4ff569f	573
Anna Bridge	160:5571c4ff569f	574	/**
Anna Bridge	160:5571c4ff569f	575	* @brief HAL CRYP State structures definition
Anna Bridge	160:5571c4ff569f	576	*/
Anna Bridge	160:5571c4ff569f	577	typedef enum
Anna Bridge	160:5571c4ff569f	578	{
Anna Bridge	160:5571c4ff569f	579	HAL_CRYP_STATE_RESET = 0x00U, /!< CRYP not yet initialized or disabled /
Anna Bridge	160:5571c4ff569f	580	HAL_CRYP_STATE_READY = 0x01U, /!< CRYP initialized and ready for use /
Anna Bridge	160:5571c4ff569f	581	HAL_CRYP_STATE_BUSY = 0x02U, /!< CRYP internal processing is ongoing /
Anna Bridge	160:5571c4ff569f	582	HAL_CRYP_STATE_TIMEOUT = 0x03U, /!< CRYP timeout state /
Anna Bridge	160:5571c4ff569f	583	HAL_CRYP_STATE_ERROR = 0x04U, /!< CRYP error state /
Anna Bridge	160:5571c4ff569f	584	HAL_CRYP_STATE_SUSPENDED = 0x05U /!< CRYP suspended /
Anna Bridge	160:5571c4ff569f	585	}HAL_CRYP_STATETypeDef;
Anna Bridge	160:5571c4ff569f	586
Anna Bridge	160:5571c4ff569f	587	/**
Anna Bridge	160:5571c4ff569f	588	* @brief HAL CRYP phase structures definition
Anna Bridge	160:5571c4ff569f	589	*/
Anna Bridge	160:5571c4ff569f	590	typedef enum
Anna Bridge	160:5571c4ff569f	591	{
Anna Bridge	160:5571c4ff569f	592	HAL_CRYP_PHASE_READY = 0x01U, /!< CRYP peripheral is ready for initialization. /
Anna Bridge	160:5571c4ff569f	593	HAL_CRYP_PHASE_PROCESS = 0x02U, /!< CRYP peripheral is in processing phase /
Anna Bridge	160:5571c4ff569f	594	HAL_CRYP_PHASE_START = 0x03U, /*!< CRYP peripheral has been initialized but
Anna Bridge	160:5571c4ff569f	595	GCM/GMAC/CMAC(/CCM) initialization phase has not started */
Anna Bridge	160:5571c4ff569f	596	HAL_CRYP_PHASE_INIT_OVER = 0x04U, /!< GCM/GMAC/CMAC(/CCM) init phase has been carried out /
Anna Bridge	160:5571c4ff569f	597	HAL_CRYP_PHASE_HEADER_OVER = 0x05U, /!< GCM/GMAC/CMAC(/CCM) header phase has been carried out /
Anna Bridge	160:5571c4ff569f	598	HAL_CRYP_PHASE_PAYLOAD_OVER = 0x06U, /!< GCM(/CCM) payload phase has been carried out /
Anna Bridge	160:5571c4ff569f	599	HAL_CRYP_PHASE_FINAL_OVER = 0x07U, /!< GCM/GMAC/CMAC(/CCM) final phase has been carried out /
Anna Bridge	160:5571c4ff569f	600	HAL_CRYP_PHASE_HEADER_SUSPENDED = 0x08U, /!< GCM/GMAC/CMAC(/CCM) header phase has been suspended /
Anna Bridge	160:5571c4ff569f	601	HAL_CRYP_PHASE_PAYLOAD_SUSPENDED = 0x09U, /!< GCM(/CCM) payload phase has been suspended /
Anna Bridge	160:5571c4ff569f	602	HAL_CRYP_PHASE_NOT_USED = 0x0AU /!< Phase is irrelevant to the current chaining mode /
Anna Bridge	160:5571c4ff569f	603	}HAL_PhaseTypeDef;
Anna Bridge	160:5571c4ff569f	604
Anna Bridge	160:5571c4ff569f	605	/**
Anna Bridge	160:5571c4ff569f	606	* @brief HAL CRYP mode suspend definitions
Anna Bridge	160:5571c4ff569f	607	*/
Anna Bridge	160:5571c4ff569f	608	typedef enum
Anna Bridge	160:5571c4ff569f	609	{
Anna Bridge	160:5571c4ff569f	610	HAL_CRYP_SUSPEND_NONE = 0x00U, /!< CRYP peripheral suspension not requested /
Anna Bridge	160:5571c4ff569f	611	HAL_CRYP_SUSPEND = 0x01U /!< CRYP peripheral suspension requested /
Anna Bridge	160:5571c4ff569f	612	}HAL_SuspendTypeDef;
Anna Bridge	160:5571c4ff569f	613
Anna Bridge	160:5571c4ff569f	614
Anna Bridge	160:5571c4ff569f	615	/**
Anna Bridge	160:5571c4ff569f	616	* @brief HAL CRYP Error Codes definition
Anna Bridge	160:5571c4ff569f	617	*/
Anna Bridge	160:5571c4ff569f	618	#define HAL_CRYP_ERROR_NONE 0x00000000U /!< No error /
Anna Bridge	160:5571c4ff569f	619	#define HAL_CRYP_WRITE_ERROR 0x00000001U /!< Write error /
Anna Bridge	160:5571c4ff569f	620	#define HAL_CRYP_READ_ERROR 0x00000002U /!< Read error /
Anna Bridge	160:5571c4ff569f	621	#define HAL_CRYP_DMA_ERROR 0x00000004U /!< DMA error /
Anna Bridge	160:5571c4ff569f	622	#define HAL_CRYP_BUSY_ERROR 0x00000008U /!< Busy flag error /
Anna Bridge	160:5571c4ff569f	623
Anna Bridge	160:5571c4ff569f	624	/**
Anna Bridge	160:5571c4ff569f	625	* @brief CRYP handle Structure definition
Anna Bridge	160:5571c4ff569f	626	*/
Anna Bridge	160:5571c4ff569f	627	typedef struct
Anna Bridge	160:5571c4ff569f	628	{
Anna Bridge	160:5571c4ff569f	629	AES_TypeDef Instance; /!< Register base address */
Anna Bridge	160:5571c4ff569f	630
Anna Bridge	160:5571c4ff569f	631	CRYP_InitTypeDef Init; /!< CRYP initialization parameters /
Anna Bridge	160:5571c4ff569f	632
Anna Bridge	160:5571c4ff569f	633	uint8_t pCrypInBuffPtr; /!< Pointer to CRYP processing (encryption, decryption,...) input buffer */
Anna Bridge	160:5571c4ff569f	634
Anna Bridge	160:5571c4ff569f	635	uint8_t pCrypOutBuffPtr; /!< Pointer to CRYP processing (encryption, decryption,...) output buffer */
Anna Bridge	160:5571c4ff569f	636
Anna Bridge	160:5571c4ff569f	637	uint32_t CrypInCount; /*!< Input data size in bytes or, after suspension, the remaining
Anna Bridge	160:5571c4ff569f	638	number of bytes to process */
Anna Bridge	160:5571c4ff569f	639
Anna Bridge	160:5571c4ff569f	640	uint32_t CrypOutCount; /!< Output data size in bytes /
Anna Bridge	160:5571c4ff569f	641
Anna Bridge	160:5571c4ff569f	642	HAL_PhaseTypeDef Phase; /*!< CRYP peripheral processing phase for GCM, GMAC, CMAC
Anna Bridge	160:5571c4ff569f	643	(or CCM when applicable) modes.
Anna Bridge	160:5571c4ff569f	644	Indicates the last phase carried out to ease
Anna Bridge	160:5571c4ff569f	645	phase transitions */
Anna Bridge	160:5571c4ff569f	646
Anna Bridge	160:5571c4ff569f	647	DMA_HandleTypeDef hdmain; /!< CRYP peripheral Input DMA handle parameters */
Anna Bridge	160:5571c4ff569f	648
Anna Bridge	160:5571c4ff569f	649	DMA_HandleTypeDef hdmaout; /!< CRYP peripheral Output DMA handle parameters */
Anna Bridge	160:5571c4ff569f	650
Anna Bridge	160:5571c4ff569f	651	HAL_LockTypeDef Lock; /!< CRYP locking object /
Anna Bridge	160:5571c4ff569f	652
Anna Bridge	160:5571c4ff569f	653	__IO HAL_CRYP_STATETypeDef State; /!< CRYP peripheral state /
Anna Bridge	160:5571c4ff569f	654
Anna Bridge	160:5571c4ff569f	655	__IO uint32_t ErrorCode; /!< CRYP peripheral error code /
Anna Bridge	160:5571c4ff569f	656
Anna Bridge	160:5571c4ff569f	657	HAL_SuspendTypeDef SuspendRequest; /!< CRYP peripheral suspension request flag /
Anna Bridge	160:5571c4ff569f	658	}CRYP_HandleTypeDef;
Anna Bridge	160:5571c4ff569f	659
Anna Bridge	160:5571c4ff569f	660	/**
Anna Bridge	160:5571c4ff569f	661	* @}
Anna Bridge	160:5571c4ff569f	662	*/
Anna Bridge	160:5571c4ff569f	663
Anna Bridge	160:5571c4ff569f	664
Anna Bridge	160:5571c4ff569f	665	/* Exported constants --------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	666	/** @defgroup CRYP_Exported_Constants CRYP Exported Constants
Anna Bridge	160:5571c4ff569f	667	* @{
Anna Bridge	160:5571c4ff569f	668	*/
Anna Bridge	160:5571c4ff569f	669
Anna Bridge	160:5571c4ff569f	670	/** @defgroup CRYP_Key_Size Key size selection
Anna Bridge	160:5571c4ff569f	671	* @{
Anna Bridge	160:5571c4ff569f	672	*/
Anna Bridge	160:5571c4ff569f	673	#define CRYP_KEYSIZE_128B 0x00000000U /!< 128-bit long key /
Anna Bridge	160:5571c4ff569f	674	#define CRYP_KEYSIZE_256B AES_CR_KEYSIZE /!< 256-bit long key /
Anna Bridge	160:5571c4ff569f	675	/**
Anna Bridge	160:5571c4ff569f	676	* @}
Anna Bridge	160:5571c4ff569f	677	*/
Anna Bridge	160:5571c4ff569f	678
Anna Bridge	160:5571c4ff569f	679	/** @defgroup CRYP_Data_Type AES Data Type selection
Anna Bridge	160:5571c4ff569f	680	* @{
Anna Bridge	160:5571c4ff569f	681	*/
Anna Bridge	160:5571c4ff569f	682	#define CRYP_DATATYPE_32B 0x00000000U /!< 32-bit data type (no swapping) /
Anna Bridge	160:5571c4ff569f	683	#define CRYP_DATATYPE_16B AES_CR_DATATYPE_0 /!< 16-bit data type (half-word swapping) /
Anna Bridge	160:5571c4ff569f	684	#define CRYP_DATATYPE_8B AES_CR_DATATYPE_1 /!< 8-bit data type (byte swapping) /
Anna Bridge	160:5571c4ff569f	685	#define CRYP_DATATYPE_1B AES_CR_DATATYPE /!< 1-bit data type (bit swapping) /
Anna Bridge	160:5571c4ff569f	686	/**
Anna Bridge	160:5571c4ff569f	687	* @}
Anna Bridge	160:5571c4ff569f	688	*/
Anna Bridge	160:5571c4ff569f	689
Anna Bridge	160:5571c4ff569f	690	/** @defgroup CRYP_AES_State AES Enable state
Anna Bridge	160:5571c4ff569f	691	* @{
Anna Bridge	160:5571c4ff569f	692	*/
Anna Bridge	160:5571c4ff569f	693	#define CRYP_AES_DISABLE 0x00000000U /!< Disable AES /
Anna Bridge	160:5571c4ff569f	694	#define CRYP_AES_ENABLE AES_CR_EN /!< Enable AES /
Anna Bridge	160:5571c4ff569f	695	/**
Anna Bridge	160:5571c4ff569f	696	* @}
Anna Bridge	160:5571c4ff569f	697	*/
Anna Bridge	160:5571c4ff569f	698
Anna Bridge	160:5571c4ff569f	699	/** @defgroup CRYP_AES_OperatingMode AES operating mode
Anna Bridge	160:5571c4ff569f	700	* @{
Anna Bridge	160:5571c4ff569f	701	*/
Anna Bridge	160:5571c4ff569f	702	#define CRYP_ALGOMODE_ENCRYPT 0x00000000U /!< Encryption mode /
Anna Bridge	160:5571c4ff569f	703	#define CRYP_ALGOMODE_KEYDERIVATION AES_CR_MODE_0 /!< Key derivation mode /
Anna Bridge	160:5571c4ff569f	704	#define CRYP_ALGOMODE_DECRYPT AES_CR_MODE_1 /!< Decryption /
Anna Bridge	160:5571c4ff569f	705	#define CRYP_ALGOMODE_KEYDERIVATION_DECRYPT AES_CR_MODE /!< Key derivation and decryption /
Anna Bridge	160:5571c4ff569f	706	#define CRYP_ALGOMODE_TAG_GENERATION 0x00000000U /!< GMAC or CMAC authentication tag generation /
Anna Bridge	160:5571c4ff569f	707	/**
Anna Bridge	160:5571c4ff569f	708	* @}
Anna Bridge	160:5571c4ff569f	709	*/
Anna Bridge	160:5571c4ff569f	710
Anna Bridge	160:5571c4ff569f	711	/** @defgroup CRYP_AES_ChainingMode AES chaining mode
Anna Bridge	160:5571c4ff569f	712	* @{
Anna Bridge	160:5571c4ff569f	713	*/
Anna Bridge	160:5571c4ff569f	714	#define CRYP_CHAINMODE_AES_ECB 0x00000000U /!< Electronic codebook chaining algorithm /
Anna Bridge	160:5571c4ff569f	715	#define CRYP_CHAINMODE_AES_CBC AES_CR_CHMOD_0 /!< Cipher block chaining algorithm /
Anna Bridge	160:5571c4ff569f	716	#define CRYP_CHAINMODE_AES_CTR AES_CR_CHMOD_1 /!< Counter mode chaining algorithm /
Anna Bridge	160:5571c4ff569f	717	#define CRYP_CHAINMODE_AES_GCM_GMAC (AES_CR_CHMOD_0 \| AES_CR_CHMOD_1) /!< Galois counter mode - Galois message authentication code /
Anna Bridge	160:5571c4ff569f	718	#define CRYP_CHAINMODE_AES_CMAC AES_CR_CHMOD_2 /!< Cipher message authentication code /
Anna Bridge	160:5571c4ff569f	719	#if defined(AES_CR_NPBLB)
Anna Bridge	160:5571c4ff569f	720	#define CRYP_CHAINMODE_AES_CCM_CMAC AES_CR_CHMOD_2 /!< Counter with Cipher Mode - Cipher message authentication code /
Anna Bridge	160:5571c4ff569f	721	#endif
Anna Bridge	160:5571c4ff569f	722	/**
Anna Bridge	160:5571c4ff569f	723	* @}
Anna Bridge	160:5571c4ff569f	724	*/
Anna Bridge	160:5571c4ff569f	725
Anna Bridge	160:5571c4ff569f	726	/** @defgroup CRYP_Key_Write AES decryption key write-up flag
Anna Bridge	160:5571c4ff569f	727	* @{
Anna Bridge	160:5571c4ff569f	728	*/
Anna Bridge	160:5571c4ff569f	729	#define CRYP_KEY_WRITE_ENABLE 0x00000000U /!< Enable decryption key writing /
Anna Bridge	160:5571c4ff569f	730	#define CRYP_KEY_WRITE_DISABLE 0x00000001U /!< Disable decryption key writing /
Anna Bridge	160:5571c4ff569f	731	/**
Anna Bridge	160:5571c4ff569f	732	* @}
Anna Bridge	160:5571c4ff569f	733	*/
Anna Bridge	160:5571c4ff569f	734
Anna Bridge	160:5571c4ff569f	735	/** @defgroup CRYP_DMAIN DMA Input phase management enable state
Anna Bridge	160:5571c4ff569f	736	* @{
Anna Bridge	160:5571c4ff569f	737	*/
Anna Bridge	160:5571c4ff569f	738	#define CRYP_DMAIN_DISABLE 0x00000000U /!< Disable DMA Input phase management /
Anna Bridge	160:5571c4ff569f	739	#define CRYP_DMAIN_ENABLE AES_CR_DMAINEN /!< Enable DMA Input phase management /
Anna Bridge	160:5571c4ff569f	740	/**
Anna Bridge	160:5571c4ff569f	741	* @}
Anna Bridge	160:5571c4ff569f	742	*/
Anna Bridge	160:5571c4ff569f	743
Anna Bridge	160:5571c4ff569f	744	/** @defgroup CRYP_DMAOUT DMA Output phase management enable state
Anna Bridge	160:5571c4ff569f	745	* @{
Anna Bridge	160:5571c4ff569f	746	*/
Anna Bridge	160:5571c4ff569f	747	#define CRYP_DMAOUT_DISABLE 0x00000000U /!< Disable DMA Output phase management /
Anna Bridge	160:5571c4ff569f	748	#define CRYP_DMAOUT_ENABLE AES_CR_DMAOUTEN /!< Enable DMA Output phase management /
Anna Bridge	160:5571c4ff569f	749	/**
Anna Bridge	160:5571c4ff569f	750	* @}
Anna Bridge	160:5571c4ff569f	751	*/
Anna Bridge	160:5571c4ff569f	752
Anna Bridge	160:5571c4ff569f	753
Anna Bridge	160:5571c4ff569f	754	/** @defgroup CRYP_GCM_CMAC_Phase GCM/GMAC and CMAC processing phase selection
Anna Bridge	160:5571c4ff569f	755	* @{
Anna Bridge	160:5571c4ff569f	756	*/
Anna Bridge	160:5571c4ff569f	757	#define CRYP_GCM_INIT_PHASE 0x00000000U /!< GCM/GMAC (or CCM) init phase /
Anna Bridge	160:5571c4ff569f	758	#define CRYP_GCMCMAC_HEADER_PHASE AES_CR_GCMPH_0 /!< GCM/GMAC or (CCM/)CMAC header phase /
Anna Bridge	160:5571c4ff569f	759	#define CRYP_GCM_PAYLOAD_PHASE AES_CR_GCMPH_1 /!< GCM(/CCM) payload phase /
Anna Bridge	160:5571c4ff569f	760	#define CRYP_GCMCMAC_FINAL_PHASE AES_CR_GCMPH /!< GCM/GMAC or (CCM/)CMAC final phase /
Anna Bridge	160:5571c4ff569f	761	/* Definitions duplication for code readibility's sake:
Anna Bridge	160:5571c4ff569f	762	supported or not supported chain modes are not specified for each phase */
Anna Bridge	160:5571c4ff569f	763	#define CRYP_INIT_PHASE 0x00000000U /!< Init phase /
Anna Bridge	160:5571c4ff569f	764	#define CRYP_HEADER_PHASE AES_CR_GCMPH_0 /!< Header phase /
Anna Bridge	160:5571c4ff569f	765	#define CRYP_PAYLOAD_PHASE AES_CR_GCMPH_1 /!< Payload phase /
Anna Bridge	160:5571c4ff569f	766	#define CRYP_FINAL_PHASE AES_CR_GCMPH /!< Final phase /
Anna Bridge	160:5571c4ff569f	767	/**
Anna Bridge	160:5571c4ff569f	768	* @}
Anna Bridge	160:5571c4ff569f	769	*/
Anna Bridge	160:5571c4ff569f	770
Anna Bridge	160:5571c4ff569f	771	/** @defgroup CRYP_Flags AES status flags
Anna Bridge	160:5571c4ff569f	772	* @{
Anna Bridge	160:5571c4ff569f	773	*/
Anna Bridge	160:5571c4ff569f	774
Anna Bridge	160:5571c4ff569f	775	#define CRYP_FLAG_BUSY AES_SR_BUSY /!< GCM process suspension forbidden /
Anna Bridge	160:5571c4ff569f	776	#define CRYP_FLAG_WRERR AES_SR_WRERR /!< Write Error /
Anna Bridge	160:5571c4ff569f	777	#define CRYP_FLAG_RDERR AES_SR_RDERR /!< Read error /
Anna Bridge	160:5571c4ff569f	778	#define CRYP_FLAG_CCF AES_SR_CCF /!< Computation completed /
Anna Bridge	160:5571c4ff569f	779	/**
Anna Bridge	160:5571c4ff569f	780	* @}
Anna Bridge	160:5571c4ff569f	781	*/
Anna Bridge	160:5571c4ff569f	782
Anna Bridge	160:5571c4ff569f	783	/** @defgroup CRYP_Clear_Flags AES clearing flags
Anna Bridge	160:5571c4ff569f	784	* @{
Anna Bridge	160:5571c4ff569f	785	*/
Anna Bridge	160:5571c4ff569f	786
Anna Bridge	160:5571c4ff569f	787	#define CRYP_CCF_CLEAR AES_CR_CCFC /!< Computation Complete Flag Clear /
Anna Bridge	160:5571c4ff569f	788	#define CRYP_ERR_CLEAR AES_CR_ERRC /!< Error Flag Clear /
Anna Bridge	160:5571c4ff569f	789	/**
Anna Bridge	160:5571c4ff569f	790	* @}
Anna Bridge	160:5571c4ff569f	791	*/
Anna Bridge	160:5571c4ff569f	792
Anna Bridge	160:5571c4ff569f	793	/** @defgroup AES_Interrupts_Enable AES Interrupts Enable bits
Anna Bridge	160:5571c4ff569f	794	* @{
Anna Bridge	160:5571c4ff569f	795	*/
Anna Bridge	160:5571c4ff569f	796	#define CRYP_IT_CCFIE AES_CR_CCFIE /!< Computation Complete interrupt enable /
Anna Bridge	160:5571c4ff569f	797	#define CRYP_IT_ERRIE AES_CR_ERRIE /!< Error interrupt enable /
Anna Bridge	160:5571c4ff569f	798	/**
Anna Bridge	160:5571c4ff569f	799	* @}
Anna Bridge	160:5571c4ff569f	800	*/
Anna Bridge	160:5571c4ff569f	801
Anna Bridge	160:5571c4ff569f	802	/** @defgroup CRYP_Interrupts_Flags AES Interrupts flags
Anna Bridge	160:5571c4ff569f	803	* @{
Anna Bridge	160:5571c4ff569f	804	*/
Anna Bridge	160:5571c4ff569f	805	#define CRYP_IT_WRERR AES_SR_WRERR /!< Write Error /
Anna Bridge	160:5571c4ff569f	806	#define CRYP_IT_RDERR AES_SR_RDERR /!< Read Error /
Anna Bridge	160:5571c4ff569f	807	#define CRYP_IT_CCF AES_SR_CCF /!< Computation completed /
Anna Bridge	160:5571c4ff569f	808	/**
Anna Bridge	160:5571c4ff569f	809	* @}
Anna Bridge	160:5571c4ff569f	810	*/
Anna Bridge	160:5571c4ff569f	811
Anna Bridge	160:5571c4ff569f	812	/**
Anna Bridge	160:5571c4ff569f	813	* @}
Anna Bridge	160:5571c4ff569f	814	*/
Anna Bridge	160:5571c4ff569f	815
Anna Bridge	160:5571c4ff569f	816	/* Exported macros -----------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	817	/** @defgroup CRYP_Exported_Macros CRYP Exported Macros
Anna Bridge	160:5571c4ff569f	818	* @{
Anna Bridge	160:5571c4ff569f	819	*/
Anna Bridge	160:5571c4ff569f	820
Anna Bridge	160:5571c4ff569f	821	/** @brief Reset CRYP handle state.
AnnaBridge	163:e59c8e839560	822	* @param __HANDLE__ specifies the CRYP handle.
Anna Bridge	160:5571c4ff569f	823	* @retval None
Anna Bridge	160:5571c4ff569f	824	*/
Anna Bridge	160:5571c4ff569f	825	#define __HAL_CRYP_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_CRYP_STATE_RESET)
Anna Bridge	160:5571c4ff569f	826
Anna Bridge	160:5571c4ff569f	827	/**
Anna Bridge	160:5571c4ff569f	828	* @brief Enable the CRYP AES peripheral.
Anna Bridge	160:5571c4ff569f	829	* @retval None
Anna Bridge	160:5571c4ff569f	830	*/
Anna Bridge	160:5571c4ff569f	831	#define __HAL_CRYP_ENABLE() (AES->CR \|= AES_CR_EN)
Anna Bridge	160:5571c4ff569f	832
Anna Bridge	160:5571c4ff569f	833	/**
Anna Bridge	160:5571c4ff569f	834	* @brief Disable the CRYP AES peripheral.
Anna Bridge	160:5571c4ff569f	835	* @retval None
Anna Bridge	160:5571c4ff569f	836	*/
Anna Bridge	160:5571c4ff569f	837	#define __HAL_CRYP_DISABLE() (AES->CR &= ~AES_CR_EN)
Anna Bridge	160:5571c4ff569f	838
Anna Bridge	160:5571c4ff569f	839	/**
Anna Bridge	160:5571c4ff569f	840	* @brief Set the algorithm operating mode.
AnnaBridge	163:e59c8e839560	841	* @param __OPERATING_MODE__ specifies the operating mode
Anna Bridge	160:5571c4ff569f	842	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	843	* @arg @ref CRYP_ALGOMODE_ENCRYPT encryption
Anna Bridge	160:5571c4ff569f	844	* @arg @ref CRYP_ALGOMODE_KEYDERIVATION key derivation
Anna Bridge	160:5571c4ff569f	845	* @arg @ref CRYP_ALGOMODE_DECRYPT decryption
Anna Bridge	160:5571c4ff569f	846	* @arg @ref CRYP_ALGOMODE_KEYDERIVATION_DECRYPT key derivation and decryption
Anna Bridge	160:5571c4ff569f	847	* @retval None
Anna Bridge	160:5571c4ff569f	848	*/
Anna Bridge	160:5571c4ff569f	849	#define __HAL_CRYP_SET_OPERATINGMODE(__OPERATING_MODE__) MODIFY_REG(AES->CR, AES_CR_MODE, (__OPERATING_MODE__))
Anna Bridge	160:5571c4ff569f	850
Anna Bridge	160:5571c4ff569f	851
Anna Bridge	160:5571c4ff569f	852	/**
Anna Bridge	160:5571c4ff569f	853	* @brief Set the algorithm chaining mode.
AnnaBridge	163:e59c8e839560	854	* @param __CHAINING_MODE__ specifies the chaining mode
Anna Bridge	160:5571c4ff569f	855	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	856	* @arg @ref CRYP_CHAINMODE_AES_ECB Electronic CodeBook
Anna Bridge	160:5571c4ff569f	857	* @arg @ref CRYP_CHAINMODE_AES_CBC Cipher Block Chaining
Anna Bridge	160:5571c4ff569f	858	* @arg @ref CRYP_CHAINMODE_AES_CTR CounTeR mode
Anna Bridge	160:5571c4ff569f	859	* @arg @ref CRYP_CHAINMODE_AES_GCM_GMAC Galois Counter Mode or Galois Message Authentication Code
Anna Bridge	160:5571c4ff569f	860	* @arg @ref CRYP_CHAINMODE_AES_CMAC Cipher Message Authentication Code (or Counter with Cipher Mode when applicable)
Anna Bridge	160:5571c4ff569f	861	* @retval None
Anna Bridge	160:5571c4ff569f	862	*/
Anna Bridge	160:5571c4ff569f	863	#define __HAL_CRYP_SET_CHAININGMODE(__CHAINING_MODE__) MODIFY_REG(AES->CR, AES_CR_CHMOD, (__CHAINING_MODE__))
Anna Bridge	160:5571c4ff569f	864
Anna Bridge	160:5571c4ff569f	865
Anna Bridge	160:5571c4ff569f	866
Anna Bridge	160:5571c4ff569f	867	/** @brief Check whether the specified CRYP status flag is set or not.
AnnaBridge	163:e59c8e839560	868	* @param __FLAG__ specifies the flag to check.
Anna Bridge	160:5571c4ff569f	869	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	870	* @arg @ref CRYP_FLAG_BUSY GCM process suspension forbidden
Anna Bridge	160:5571c4ff569f	871	* @arg @ref CRYP_IT_WRERR Write Error
Anna Bridge	160:5571c4ff569f	872	* @arg @ref CRYP_IT_RDERR Read Error
Anna Bridge	160:5571c4ff569f	873	* @arg @ref CRYP_IT_CCF Computation Complete
Anna Bridge	160:5571c4ff569f	874	* @retval The state of __FLAG__ (TRUE or FALSE).
Anna Bridge	160:5571c4ff569f	875	*/
Anna Bridge	160:5571c4ff569f	876	#define __HAL_CRYP_GET_FLAG(__FLAG__) ((AES->SR & (__FLAG__)) == (__FLAG__))
Anna Bridge	160:5571c4ff569f	877
Anna Bridge	160:5571c4ff569f	878
Anna Bridge	160:5571c4ff569f	879	/** @brief Clear the CRYP pending status flag.
AnnaBridge	163:e59c8e839560	880	* @param __FLAG__ specifies the flag to clear.
Anna Bridge	160:5571c4ff569f	881	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	882	* @arg @ref CRYP_ERR_CLEAR Read (RDERR) or Write Error (WRERR) Flag Clear
Anna Bridge	160:5571c4ff569f	883	* @arg @ref CRYP_CCF_CLEAR Computation Complete Flag (CCF) Clear
Anna Bridge	160:5571c4ff569f	884	* @retval None
Anna Bridge	160:5571c4ff569f	885	*/
Anna Bridge	160:5571c4ff569f	886	#define __HAL_CRYP_CLEAR_FLAG(__FLAG__) SET_BIT(AES->CR, (__FLAG__))
Anna Bridge	160:5571c4ff569f	887
Anna Bridge	160:5571c4ff569f	888
Anna Bridge	160:5571c4ff569f	889
Anna Bridge	160:5571c4ff569f	890	/** @brief Check whether the specified CRYP interrupt source is enabled or not.
AnnaBridge	163:e59c8e839560	891	* @param __INTERRUPT__ CRYP interrupt source to check
Anna Bridge	160:5571c4ff569f	892	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	893	* @arg @ref CRYP_IT_ERRIE Error interrupt (used for RDERR and WRERR)
Anna Bridge	160:5571c4ff569f	894	* @arg @ref CRYP_IT_CCFIE Computation Complete interrupt
Anna Bridge	160:5571c4ff569f	895	* @retval State of interruption (TRUE or FALSE).
Anna Bridge	160:5571c4ff569f	896	*/
Anna Bridge	160:5571c4ff569f	897	#define __HAL_CRYP_GET_IT_SOURCE(__INTERRUPT__) ((AES->CR & (__INTERRUPT__)) == (__INTERRUPT__))
Anna Bridge	160:5571c4ff569f	898
Anna Bridge	160:5571c4ff569f	899
Anna Bridge	160:5571c4ff569f	900	/** @brief Check whether the specified CRYP interrupt is set or not.
AnnaBridge	163:e59c8e839560	901	* @param __INTERRUPT__ specifies the interrupt to check.
Anna Bridge	160:5571c4ff569f	902	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	903	* @arg @ref CRYP_IT_WRERR Write Error
Anna Bridge	160:5571c4ff569f	904	* @arg @ref CRYP_IT_RDERR Read Error
Anna Bridge	160:5571c4ff569f	905	* @arg @ref CRYP_IT_CCF Computation Complete
Anna Bridge	160:5571c4ff569f	906	* @retval The state of __INTERRUPT__ (TRUE or FALSE).
Anna Bridge	160:5571c4ff569f	907	*/
Anna Bridge	160:5571c4ff569f	908	#define __HAL_CRYP_GET_IT(__INTERRUPT__) ((AES->SR & (__INTERRUPT__)) == (__INTERRUPT__))
Anna Bridge	160:5571c4ff569f	909
Anna Bridge	160:5571c4ff569f	910
Anna Bridge	160:5571c4ff569f	911
Anna Bridge	160:5571c4ff569f	912	/** @brief Clear the CRYP pending interrupt.
AnnaBridge	163:e59c8e839560	913	* @param __INTERRUPT__ specifies the IT to clear.
Anna Bridge	160:5571c4ff569f	914	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	915	* @arg @ref CRYP_ERR_CLEAR Read (RDERR) or Write Error (WRERR) Flag Clear
Anna Bridge	160:5571c4ff569f	916	* @arg @ref CRYP_CCF_CLEAR Computation Complete Flag (CCF) Clear
Anna Bridge	160:5571c4ff569f	917	* @retval None
Anna Bridge	160:5571c4ff569f	918	*/
Anna Bridge	160:5571c4ff569f	919	#define __HAL_CRYP_CLEAR_IT(__INTERRUPT__) SET_BIT(AES->CR, (__INTERRUPT__))
Anna Bridge	160:5571c4ff569f	920
Anna Bridge	160:5571c4ff569f	921
Anna Bridge	160:5571c4ff569f	922	/**
Anna Bridge	160:5571c4ff569f	923	* @brief Enable the CRYP interrupt.
AnnaBridge	163:e59c8e839560	924	* @param __INTERRUPT__ CRYP Interrupt.
Anna Bridge	160:5571c4ff569f	925	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	926	* @arg @ref CRYP_IT_ERRIE Error interrupt (used for RDERR and WRERR)
Anna Bridge	160:5571c4ff569f	927	* @arg @ref CRYP_IT_CCFIE Computation Complete interrupt
Anna Bridge	160:5571c4ff569f	928	* @retval None
Anna Bridge	160:5571c4ff569f	929	*/
Anna Bridge	160:5571c4ff569f	930	#define __HAL_CRYP_ENABLE_IT(__INTERRUPT__) ((AES->CR) \|= (__INTERRUPT__))
Anna Bridge	160:5571c4ff569f	931
Anna Bridge	160:5571c4ff569f	932
Anna Bridge	160:5571c4ff569f	933	/**
Anna Bridge	160:5571c4ff569f	934	* @brief Disable the CRYP interrupt.
AnnaBridge	163:e59c8e839560	935	* @param __INTERRUPT__ CRYP Interrupt.
Anna Bridge	160:5571c4ff569f	936	* This parameter can be one of the following values:
Anna Bridge	160:5571c4ff569f	937	* @arg @ref CRYP_IT_ERRIE Error interrupt (used for RDERR and WRERR)
Anna Bridge	160:5571c4ff569f	938	* @arg @ref CRYP_IT_CCFIE Computation Complete interrupt
Anna Bridge	160:5571c4ff569f	939	* @retval None
Anna Bridge	160:5571c4ff569f	940	*/
Anna Bridge	160:5571c4ff569f	941	#define __HAL_CRYP_DISABLE_IT(__INTERRUPT__) ((AES->CR) &= ~(__INTERRUPT__))
Anna Bridge	160:5571c4ff569f	942
Anna Bridge	160:5571c4ff569f	943	/**
Anna Bridge	160:5571c4ff569f	944	* @}
Anna Bridge	160:5571c4ff569f	945	*/
Anna Bridge	160:5571c4ff569f	946
Anna Bridge	160:5571c4ff569f	947	/* Private macros --------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	948	/** @addtogroup CRYP_Private_Macros CRYP Private Macros
Anna Bridge	160:5571c4ff569f	949	* @{
Anna Bridge	160:5571c4ff569f	950	*/
Anna Bridge	160:5571c4ff569f	951
Anna Bridge	160:5571c4ff569f	952	/**
Anna Bridge	160:5571c4ff569f	953	* @brief Verify the key size length.
AnnaBridge	163:e59c8e839560	954	* @param __KEYSIZE__ Ciphering/deciphering algorithm key size.
Anna Bridge	160:5571c4ff569f	955	* @retval SET (__KEYSIZE__ is a valid value) or RESET (__KEYSIZE__ is invalid)
Anna Bridge	160:5571c4ff569f	956	*/
Anna Bridge	160:5571c4ff569f	957	#define IS_CRYP_KEYSIZE(__KEYSIZE__) (((__KEYSIZE__) == CRYP_KEYSIZE_128B) \|\| \
Anna Bridge	160:5571c4ff569f	958	((__KEYSIZE__) == CRYP_KEYSIZE_256B))
Anna Bridge	160:5571c4ff569f	959
Anna Bridge	160:5571c4ff569f	960	/**
Anna Bridge	160:5571c4ff569f	961	* @brief Verify the input data type.
AnnaBridge	163:e59c8e839560	962	* @param __DATATYPE__ Ciphering/deciphering algorithm input data type.
Anna Bridge	160:5571c4ff569f	963	* @retval SET (__DATATYPE__ is valid) or RESET (__DATATYPE__ is invalid)
Anna Bridge	160:5571c4ff569f	964	*/
Anna Bridge	160:5571c4ff569f	965	#define IS_CRYP_DATATYPE(__DATATYPE__) (((__DATATYPE__) == CRYP_DATATYPE_32B) \|\| \
Anna Bridge	160:5571c4ff569f	966	((__DATATYPE__) == CRYP_DATATYPE_16B) \|\| \
Anna Bridge	160:5571c4ff569f	967	((__DATATYPE__) == CRYP_DATATYPE_8B) \|\| \
Anna Bridge	160:5571c4ff569f	968	((__DATATYPE__) == CRYP_DATATYPE_1B))
Anna Bridge	160:5571c4ff569f	969
Anna Bridge	160:5571c4ff569f	970	/**
Anna Bridge	160:5571c4ff569f	971	* @brief Verify the CRYP AES IP running mode.
AnnaBridge	163:e59c8e839560	972	* @param __MODE__ CRYP AES IP running mode.
Anna Bridge	160:5571c4ff569f	973	* @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid)
Anna Bridge	160:5571c4ff569f	974	*/
Anna Bridge	160:5571c4ff569f	975	#define IS_CRYP_AES(__MODE__) (((__MODE__) == CRYP_AES_DISABLE) \|\| \
Anna Bridge	160:5571c4ff569f	976	((__MODE__) == CRYP_AES_ENABLE))
Anna Bridge	160:5571c4ff569f	977
Anna Bridge	160:5571c4ff569f	978	/**
Anna Bridge	160:5571c4ff569f	979	* @brief Verify the selected CRYP algorithm.
AnnaBridge	163:e59c8e839560	980	* @param __ALGOMODE__ Selected CRYP algorithm (ciphering, deciphering, key derivation or a combination of the latter).
Anna Bridge	160:5571c4ff569f	981	* @retval SET (__ALGOMODE__ is valid) or RESET (__ALGOMODE__ is invalid)
Anna Bridge	160:5571c4ff569f	982	*/
Anna Bridge	160:5571c4ff569f	983	#define IS_CRYP_ALGOMODE(__ALGOMODE__) (((__ALGOMODE__) == CRYP_ALGOMODE_ENCRYPT) \|\| \
Anna Bridge	160:5571c4ff569f	984	((__ALGOMODE__) == CRYP_ALGOMODE_KEYDERIVATION) \|\| \
Anna Bridge	160:5571c4ff569f	985	((__ALGOMODE__) == CRYP_ALGOMODE_DECRYPT) \|\| \
Anna Bridge	160:5571c4ff569f	986	((__ALGOMODE__) == CRYP_ALGOMODE_TAG_GENERATION) \|\| \
Anna Bridge	160:5571c4ff569f	987	((__ALGOMODE__) == CRYP_ALGOMODE_KEYDERIVATION_DECRYPT))
Anna Bridge	160:5571c4ff569f	988
Anna Bridge	160:5571c4ff569f	989	/**
Anna Bridge	160:5571c4ff569f	990	* @brief Verify the selected CRYP chaining algorithm.
AnnaBridge	163:e59c8e839560	991	* @param __CHAINMODE__ Selected CRYP chaining algorithm.
Anna Bridge	160:5571c4ff569f	992	* @retval SET (__CHAINMODE__ is valid) or RESET (__CHAINMODE__ is invalid)
Anna Bridge	160:5571c4ff569f	993	*/
Anna Bridge	160:5571c4ff569f	994	#if defined(AES_CR_NPBLB)
Anna Bridge	160:5571c4ff569f	995	#define IS_CRYP_CHAINMODE(__CHAINMODE__) (((__CHAINMODE__) == CRYP_CHAINMODE_AES_ECB) \|\| \
Anna Bridge	160:5571c4ff569f	996	((__CHAINMODE__) == CRYP_CHAINMODE_AES_CBC) \|\| \
Anna Bridge	160:5571c4ff569f	997	((__CHAINMODE__) == CRYP_CHAINMODE_AES_CTR) \|\| \
Anna Bridge	160:5571c4ff569f	998	((__CHAINMODE__) == CRYP_CHAINMODE_AES_GCM_GMAC) \|\| \
Anna Bridge	160:5571c4ff569f	999	((__CHAINMODE__) == CRYP_CHAINMODE_AES_CCM_CMAC))
Anna Bridge	160:5571c4ff569f	1000	#else
Anna Bridge	160:5571c4ff569f	1001	#define IS_CRYP_CHAINMODE(__CHAINMODE__) (((__CHAINMODE__) == CRYP_CHAINMODE_AES_ECB) \|\| \
Anna Bridge	160:5571c4ff569f	1002	((__CHAINMODE__) == CRYP_CHAINMODE_AES_CBC) \|\| \
Anna Bridge	160:5571c4ff569f	1003	((__CHAINMODE__) == CRYP_CHAINMODE_AES_CTR) \|\| \
Anna Bridge	160:5571c4ff569f	1004	((__CHAINMODE__) == CRYP_CHAINMODE_AES_GCM_GMAC) \|\| \
Anna Bridge	160:5571c4ff569f	1005	((__CHAINMODE__) == CRYP_CHAINMODE_AES_CMAC))
Anna Bridge	160:5571c4ff569f	1006	#endif
Anna Bridge	160:5571c4ff569f	1007
Anna Bridge	160:5571c4ff569f	1008	/**
Anna Bridge	160:5571c4ff569f	1009	* @brief Verify the deciphering key write option.
AnnaBridge	163:e59c8e839560	1010	* @param __WRITE__ deciphering key write option.
Anna Bridge	160:5571c4ff569f	1011	* @retval SET (__WRITE__ is valid) or RESET (__WRITE__ is invalid)
Anna Bridge	160:5571c4ff569f	1012	*/
Anna Bridge	160:5571c4ff569f	1013	#define IS_CRYP_WRITE(__WRITE__) (((__WRITE__) == CRYP_KEY_WRITE_ENABLE) \|\| \
Anna Bridge	160:5571c4ff569f	1014	((__WRITE__) == CRYP_KEY_WRITE_DISABLE))
Anna Bridge	160:5571c4ff569f	1015
Anna Bridge	160:5571c4ff569f	1016	/**
Anna Bridge	160:5571c4ff569f	1017	* @brief Verify the CRYP input data DMA mode.
AnnaBridge	163:e59c8e839560	1018	* @param __MODE__ CRYP input data DMA mode.
Anna Bridge	160:5571c4ff569f	1019	* @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid)
Anna Bridge	160:5571c4ff569f	1020	*/
Anna Bridge	160:5571c4ff569f	1021	#define IS_CRYP_DMAIN(__MODE__) (((__MODE__) == CRYP_DMAIN_DISABLE) \|\| \
Anna Bridge	160:5571c4ff569f	1022	((__MODE__) == CRYP_DMAIN_ENABLE))
Anna Bridge	160:5571c4ff569f	1023
Anna Bridge	160:5571c4ff569f	1024	/**
Anna Bridge	160:5571c4ff569f	1025	* @brief Verify the CRYP output data DMA mode.
AnnaBridge	163:e59c8e839560	1026	* @param __MODE__ CRYP output data DMA mode.
Anna Bridge	160:5571c4ff569f	1027	* @retval SET (__MODE__ is valid) or RESET (__MODE__ is invalid)
Anna Bridge	160:5571c4ff569f	1028	*/
Anna Bridge	160:5571c4ff569f	1029	#define IS_CRYP_DMAOUT(__MODE__) (((__MODE__) == CRYP_DMAOUT_DISABLE) \|\| \
Anna Bridge	160:5571c4ff569f	1030	((__MODE__) == CRYP_DMAOUT_ENABLE))
Anna Bridge	160:5571c4ff569f	1031
Anna Bridge	160:5571c4ff569f	1032	/**
Anna Bridge	160:5571c4ff569f	1033	* @brief Verify the CRYP AES ciphering/deciphering/authentication algorithm phase.
AnnaBridge	163:e59c8e839560	1034	* @param __PHASE__ CRYP AES ciphering/deciphering/authentication algorithm phase.
Anna Bridge	160:5571c4ff569f	1035	* @retval SET (__PHASE__ is valid) or RESET (__PHASE__ is invalid)
Anna Bridge	160:5571c4ff569f	1036	*/
Anna Bridge	160:5571c4ff569f	1037	#define IS_CRYP_GCMCMAC_PHASE(__PHASE__) (((__PHASE__) == CRYP_GCM_INIT_PHASE) \|\| \
Anna Bridge	160:5571c4ff569f	1038	((__PHASE__) == CRYP_GCMCMAC_HEADER_PHASE) \|\| \
Anna Bridge	160:5571c4ff569f	1039	((__PHASE__) == CRYP_GCM_PAYLOAD_PHASE) \|\| \
Anna Bridge	160:5571c4ff569f	1040	((__PHASE__) == CRYP_GCMCMAC_FINAL_PHASE))
Anna Bridge	160:5571c4ff569f	1041
Anna Bridge	160:5571c4ff569f	1042	/**
Anna Bridge	160:5571c4ff569f	1043	* @}
Anna Bridge	160:5571c4ff569f	1044	*/
Anna Bridge	160:5571c4ff569f	1045
Anna Bridge	160:5571c4ff569f	1046	/* Include CRYP HAL Extended module */
Anna Bridge	160:5571c4ff569f	1047	#include "stm32f4xx_hal_cryp_ex.h"
Anna Bridge	160:5571c4ff569f	1048
Anna Bridge	160:5571c4ff569f	1049	/* Exported functions --------------------------------------------------------*/
Anna Bridge	160:5571c4ff569f	1050	/** @addtogroup CRYP_Exported_Functions CRYP Exported Functions
Anna Bridge	160:5571c4ff569f	1051	* @{
Anna Bridge	160:5571c4ff569f	1052	*/
Anna Bridge	160:5571c4ff569f	1053
Anna Bridge	160:5571c4ff569f	1054	/** @addtogroup CRYP_Exported_Functions_Group1 Initialization and deinitialization functions
Anna Bridge	160:5571c4ff569f	1055	* @{
Anna Bridge	160:5571c4ff569f	1056	*/
Anna Bridge	160:5571c4ff569f	1057
Anna Bridge	160:5571c4ff569f	1058	/* Initialization/de-initialization functions ********************************/
Anna Bridge	160:5571c4ff569f	1059	HAL_StatusTypeDef HAL_CRYP_Init(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1060	HAL_StatusTypeDef HAL_CRYP_DeInit(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1061
Anna Bridge	160:5571c4ff569f	1062	/* MSP initialization/de-initialization functions ****************************/
Anna Bridge	160:5571c4ff569f	1063	void HAL_CRYP_MspInit(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1064	void HAL_CRYP_MspDeInit(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1065
Anna Bridge	160:5571c4ff569f	1066	/**
Anna Bridge	160:5571c4ff569f	1067	* @}
Anna Bridge	160:5571c4ff569f	1068	*/
Anna Bridge	160:5571c4ff569f	1069
Anna Bridge	160:5571c4ff569f	1070	/** @addtogroup CRYP_Exported_Functions_Group2 AES processing functions
Anna Bridge	160:5571c4ff569f	1071	* @{
Anna Bridge	160:5571c4ff569f	1072	*/
Anna Bridge	160:5571c4ff569f	1073
Anna Bridge	160:5571c4ff569f	1074	/* AES encryption/decryption processing functions ****************************/
Anna Bridge	160:5571c4ff569f	1075
Anna Bridge	160:5571c4ff569f	1076	/* AES encryption/decryption using polling ***********************************/
Anna Bridge	160:5571c4ff569f	1077	HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	1078	HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	1079	HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	1080	HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	1081	HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	1082	HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData, uint32_t Timeout);
Anna Bridge	160:5571c4ff569f	1083
Anna Bridge	160:5571c4ff569f	1084	/* AES encryption/decryption using interrupt *********************************/
Anna Bridge	160:5571c4ff569f	1085	HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	1086	HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	1087	HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	1088	HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	1089	HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	1090	HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt_IT(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	1091
Anna Bridge	160:5571c4ff569f	1092	/* AES encryption/decryption using DMA ***************************************/
Anna Bridge	160:5571c4ff569f	1093	HAL_StatusTypeDef HAL_CRYP_AESECB_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	1094	HAL_StatusTypeDef HAL_CRYP_AESECB_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	1095	HAL_StatusTypeDef HAL_CRYP_AESCBC_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	1096	HAL_StatusTypeDef HAL_CRYP_AESCBC_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	1097	HAL_StatusTypeDef HAL_CRYP_AESCTR_Encrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pPlainData, uint16_t Size, uint8_t *pCypherData);
Anna Bridge	160:5571c4ff569f	1098	HAL_StatusTypeDef HAL_CRYP_AESCTR_Decrypt_DMA(CRYP_HandleTypeDef hcryp, uint8_t pCypherData, uint16_t Size, uint8_t *pPlainData);
Anna Bridge	160:5571c4ff569f	1099
Anna Bridge	160:5571c4ff569f	1100	/**
Anna Bridge	160:5571c4ff569f	1101	* @}
Anna Bridge	160:5571c4ff569f	1102	*/
Anna Bridge	160:5571c4ff569f	1103
Anna Bridge	160:5571c4ff569f	1104	/** @addtogroup CRYP_Exported_Functions_Group3 Callback functions
Anna Bridge	160:5571c4ff569f	1105	* @{
Anna Bridge	160:5571c4ff569f	1106	*/
Anna Bridge	160:5571c4ff569f	1107	/* CallBack functions ********************************************************/
Anna Bridge	160:5571c4ff569f	1108	void HAL_CRYP_InCpltCallback(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1109	void HAL_CRYP_OutCpltCallback(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1110	void HAL_CRYP_ErrorCallback(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1111
Anna Bridge	160:5571c4ff569f	1112	/**
Anna Bridge	160:5571c4ff569f	1113	* @}
Anna Bridge	160:5571c4ff569f	1114	*/
Anna Bridge	160:5571c4ff569f	1115
Anna Bridge	160:5571c4ff569f	1116	/** @addtogroup CRYP_Exported_Functions_Group4 CRYP IRQ handler
Anna Bridge	160:5571c4ff569f	1117	* @{
Anna Bridge	160:5571c4ff569f	1118	*/
Anna Bridge	160:5571c4ff569f	1119
Anna Bridge	160:5571c4ff569f	1120	/* AES interrupt handling function *******************************************/
Anna Bridge	160:5571c4ff569f	1121	void HAL_CRYP_IRQHandler(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1122
Anna Bridge	160:5571c4ff569f	1123	/**
Anna Bridge	160:5571c4ff569f	1124	* @}
Anna Bridge	160:5571c4ff569f	1125	*/
Anna Bridge	160:5571c4ff569f	1126
Anna Bridge	160:5571c4ff569f	1127	/** @addtogroup CRYP_Exported_Functions_Group5 Peripheral State functions
Anna Bridge	160:5571c4ff569f	1128	* @{
Anna Bridge	160:5571c4ff569f	1129	*/
Anna Bridge	160:5571c4ff569f	1130
Anna Bridge	160:5571c4ff569f	1131	/* Peripheral State functions ************************************************/
Anna Bridge	160:5571c4ff569f	1132	HAL_CRYP_STATETypeDef HAL_CRYP_GetState(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1133	uint32_t HAL_CRYP_GetError(CRYP_HandleTypeDef *hcryp);
Anna Bridge	160:5571c4ff569f	1134
Anna Bridge	160:5571c4ff569f	1135	/**
Anna Bridge	160:5571c4ff569f	1136	* @}
Anna Bridge	160:5571c4ff569f	1137	*/
Anna Bridge	160:5571c4ff569f	1138
Anna Bridge	160:5571c4ff569f	1139	/**
Anna Bridge	160:5571c4ff569f	1140	* @}
Anna Bridge	160:5571c4ff569f	1141	*/
Anna Bridge	160:5571c4ff569f	1142
Anna Bridge	160:5571c4ff569f	1143
Anna Bridge	160:5571c4ff569f	1144	#endif /* AES */
Anna Bridge	160:5571c4ff569f	1145
Anna Bridge	160:5571c4ff569f	1146	/**
Anna Bridge	160:5571c4ff569f	1147	* @}
Anna Bridge	160:5571c4ff569f	1148	*/
Anna Bridge	160:5571c4ff569f	1149
Anna Bridge	160:5571c4ff569f	1150	/**
Anna Bridge	160:5571c4ff569f	1151	* @}
Anna Bridge	160:5571c4ff569f	1152	*/
Anna Bridge	160:5571c4ff569f	1153
Anna Bridge	160:5571c4ff569f	1154	#ifdef __cplusplus
Anna Bridge	160:5571c4ff569f	1155	}
Anna Bridge	160:5571c4ff569f	1156	#endif
Anna Bridge	160:5571c4ff569f	1157
Anna Bridge	160:5571c4ff569f	1158	#endif /* __STM32F4xx_HAL_CRYP_H */
Anna Bridge	160:5571c4ff569f	1159
Anna Bridge	160:5571c4ff569f	1160	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/