mbed | Mbed

Users » mbed_official » Code » mbed

Dependents: hello SerialTestv11 SerialTestv12 Sierpinski ... more

TARGET_NUCLEO_F303K8/stm32f3xx_hal_def.h@109:9296ab0bfc11, 2015-10-29 (annotated)

Committer:: Kojto
Date:: Thu Oct 29 08:40:18 2015 +0000
Revision:: 109:9296ab0bfc11
Child:: 122:f9eeca106725

Release 109  of the mbed library



Changes:

- new platforms - NUCLEO_F042K6, WIZNWIKI_W7500ECO

- MTS targets - bootloaders update to 0.1.1

- STM F7 - RTC enable fixes

- STM F4 - i2c pending stop before start fix

- STM all targets - analogout normalization fix

Who changed what in which revision?

User	Revision	Line number	New contents of line
Kojto	109:9296ab0bfc11	1	/**
Kojto	109:9296ab0bfc11	2	******************************************************************************
Kojto	109:9296ab0bfc11	3	* @file stm32f3xx_hal_def.h
Kojto	109:9296ab0bfc11	4	* @author MCD Application Team
Kojto	109:9296ab0bfc11	5	* @version V1.1.0
Kojto	109:9296ab0bfc11	6	* @date 12-Sept-2014
Kojto	109:9296ab0bfc11	7	* @brief This file contains HAL common defines, enumeration, macros and
Kojto	109:9296ab0bfc11	8	* structures definitions.
Kojto	109:9296ab0bfc11	9	******************************************************************************
Kojto	109:9296ab0bfc11	10	* @attention
Kojto	109:9296ab0bfc11	11	*
Kojto	109:9296ab0bfc11	12	* <h2><center>© COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
Kojto	109:9296ab0bfc11	13	*
Kojto	109:9296ab0bfc11	14	* Redistribution and use in source and binary forms, with or without modification,
Kojto	109:9296ab0bfc11	15	* are permitted provided that the following conditions are met:
Kojto	109:9296ab0bfc11	16	* 1. Redistributions of source code must retain the above copyright notice,
Kojto	109:9296ab0bfc11	17	* this list of conditions and the following disclaimer.
Kojto	109:9296ab0bfc11	18	* 2. Redistributions in binary form must reproduce the above copyright notice,
Kojto	109:9296ab0bfc11	19	* this list of conditions and the following disclaimer in the documentation
Kojto	109:9296ab0bfc11	20	* and/or other materials provided with the distribution.
Kojto	109:9296ab0bfc11	21	* 3. Neither the name of STMicroelectronics nor the names of its contributors
Kojto	109:9296ab0bfc11	22	* may be used to endorse or promote products derived from this software
Kojto	109:9296ab0bfc11	23	* without specific prior written permission.
Kojto	109:9296ab0bfc11	24	*
Kojto	109:9296ab0bfc11	25	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Kojto	109:9296ab0bfc11	26	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Kojto	109:9296ab0bfc11	27	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Kojto	109:9296ab0bfc11	28	* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Kojto	109:9296ab0bfc11	29	* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Kojto	109:9296ab0bfc11	30	* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Kojto	109:9296ab0bfc11	31	* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Kojto	109:9296ab0bfc11	32	* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Kojto	109:9296ab0bfc11	33	* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Kojto	109:9296ab0bfc11	34	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Kojto	109:9296ab0bfc11	35	*
Kojto	109:9296ab0bfc11	36	******************************************************************************
Kojto	109:9296ab0bfc11	37	*/
Kojto	109:9296ab0bfc11	38
Kojto	109:9296ab0bfc11	39	/* Define to prevent recursive inclusion -------------------------------------*/
Kojto	109:9296ab0bfc11	40	#ifndef __STM32F3xx_HAL_DEF
Kojto	109:9296ab0bfc11	41	#define __STM32F3xx_HAL_DEF
Kojto	109:9296ab0bfc11	42
Kojto	109:9296ab0bfc11	43	#ifdef __cplusplus
Kojto	109:9296ab0bfc11	44	extern "C" {
Kojto	109:9296ab0bfc11	45	#endif
Kojto	109:9296ab0bfc11	46
Kojto	109:9296ab0bfc11	47	/* Includes ------------------------------------------------------------------*/
Kojto	109:9296ab0bfc11	48	#include "stm32f3xx.h"
Kojto	109:9296ab0bfc11	49
Kojto	109:9296ab0bfc11	50	/* Exported types ------------------------------------------------------------*/
Kojto	109:9296ab0bfc11	51
Kojto	109:9296ab0bfc11	52	/**
Kojto	109:9296ab0bfc11	53	* @brief HAL Status structures definition
Kojto	109:9296ab0bfc11	54	*/
Kojto	109:9296ab0bfc11	55	typedef enum
Kojto	109:9296ab0bfc11	56	{
Kojto	109:9296ab0bfc11	57	HAL_OK = 0x00,
Kojto	109:9296ab0bfc11	58	HAL_ERROR = 0x01,
Kojto	109:9296ab0bfc11	59	HAL_BUSY = 0x02,
Kojto	109:9296ab0bfc11	60	HAL_TIMEOUT = 0x03
Kojto	109:9296ab0bfc11	61	} HAL_StatusTypeDef;
Kojto	109:9296ab0bfc11	62
Kojto	109:9296ab0bfc11	63	/**
Kojto	109:9296ab0bfc11	64	* @brief HAL Lock structures definition
Kojto	109:9296ab0bfc11	65	*/
Kojto	109:9296ab0bfc11	66	typedef enum
Kojto	109:9296ab0bfc11	67	{
Kojto	109:9296ab0bfc11	68	HAL_UNLOCKED = 0x00,
Kojto	109:9296ab0bfc11	69	HAL_LOCKED = 0x01
Kojto	109:9296ab0bfc11	70	} HAL_LockTypeDef;
Kojto	109:9296ab0bfc11	71
Kojto	109:9296ab0bfc11	72	/* Exported macro ------------------------------------------------------------*/
Kojto	109:9296ab0bfc11	73	#ifndef HAL_NULL
Kojto	109:9296ab0bfc11	74	#define HAL_NULL (void *) 0
Kojto	109:9296ab0bfc11	75	#endif
Kojto	109:9296ab0bfc11	76
Kojto	109:9296ab0bfc11	77	#define HAL_MAX_DELAY 0xFFFFFFFF
Kojto	109:9296ab0bfc11	78
Kojto	109:9296ab0bfc11	79	#define HAL_IS_BIT_SET(REG, BIT) (((REG) & (BIT)) != RESET)
Kojto	109:9296ab0bfc11	80	#define HAL_IS_BIT_CLR(REG, BIT) (((REG) & (BIT)) == RESET)
Kojto	109:9296ab0bfc11	81
Kojto	109:9296ab0bfc11	82	#define __HAL_LINKDMA(__HANDLE__, __PPP_DMA_FIELD_, __DMA_HANDLE_) \
Kojto	109:9296ab0bfc11	83	do{ \
Kojto	109:9296ab0bfc11	84	(__HANDLE__)->__PPP_DMA_FIELD_ = &(__DMA_HANDLE_); \
Kojto	109:9296ab0bfc11	85	(__DMA_HANDLE_).Parent = (__HANDLE__); \
Kojto	109:9296ab0bfc11	86	} while(0)
Kojto	109:9296ab0bfc11	87
Kojto	109:9296ab0bfc11	88	/** @brief Reset the Handle's State field.
Kojto	109:9296ab0bfc11	89	* @param __HANDLE__: specifies the Peripheral Handle.
Kojto	109:9296ab0bfc11	90	* @note This macro can be used for the following purpose:
Kojto	109:9296ab0bfc11	91	* - When the Handle is declared as local variable; before passing it as parameter
Kojto	109:9296ab0bfc11	92	* to HAL_PPP_Init() for the first time, it is mandatory to use this macro
Kojto	109:9296ab0bfc11	93	* to set to 0 the Handle's "State" field.
Kojto	109:9296ab0bfc11	94	* Otherwise, "State" field may have any random value and the first time the function
Kojto	109:9296ab0bfc11	95	* HAL_PPP_Init() is called, the low level hardware initialization will be missed
Kojto	109:9296ab0bfc11	96	* (i.e. HAL_PPP_MspInit() will not be executed).
Kojto	109:9296ab0bfc11	97	* - When there is a need to reconfigure the low level hardware: instead of calling
Kojto	109:9296ab0bfc11	98	* HAL_PPP_DeInit() then HAL_PPP_Init(), user can make a call to this macro then HAL_PPP_Init().
Kojto	109:9296ab0bfc11	99	* In this later function, when the Handle's "State" field is set to 0, it will execute the function
Kojto	109:9296ab0bfc11	100	* HAL_PPP_MspInit() which will reconfigure the low level hardware.
Kojto	109:9296ab0bfc11	101	* @retval None
Kojto	109:9296ab0bfc11	102	*/
Kojto	109:9296ab0bfc11	103	#define __HAL_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = 0)
Kojto	109:9296ab0bfc11	104
Kojto	109:9296ab0bfc11	105	#if (USE_RTOS == 1)
Kojto	109:9296ab0bfc11	106	#error " USE_RTOS should be 0 in the current HAL release "
Kojto	109:9296ab0bfc11	107	#else
Kojto	109:9296ab0bfc11	108	#define __HAL_LOCK(__HANDLE__) \
Kojto	109:9296ab0bfc11	109	do{ \
Kojto	109:9296ab0bfc11	110	if((__HANDLE__)->Lock == HAL_LOCKED) \
Kojto	109:9296ab0bfc11	111	{ \
Kojto	109:9296ab0bfc11	112	return HAL_BUSY; \
Kojto	109:9296ab0bfc11	113	} \
Kojto	109:9296ab0bfc11	114	else \
Kojto	109:9296ab0bfc11	115	{ \
Kojto	109:9296ab0bfc11	116	(__HANDLE__)->Lock = HAL_LOCKED; \
Kojto	109:9296ab0bfc11	117	} \
Kojto	109:9296ab0bfc11	118	}while (0)
Kojto	109:9296ab0bfc11	119
Kojto	109:9296ab0bfc11	120	#define __HAL_UNLOCK(__HANDLE__) \
Kojto	109:9296ab0bfc11	121	do{ \
Kojto	109:9296ab0bfc11	122	(__HANDLE__)->Lock = HAL_UNLOCKED; \
Kojto	109:9296ab0bfc11	123	}while (0)
Kojto	109:9296ab0bfc11	124	#endif /* USE_RTOS */
Kojto	109:9296ab0bfc11	125
Kojto	109:9296ab0bfc11	126	#if defined ( __GNUC__ )
Kojto	109:9296ab0bfc11	127	#ifndef __weak
Kojto	109:9296ab0bfc11	128	#define __weak __attribute__((weak))
Kojto	109:9296ab0bfc11	129	#endif /* __weak */
Kojto	109:9296ab0bfc11	130	#ifndef __packed
Kojto	109:9296ab0bfc11	131	#define __packed __attribute__((__packed__))
Kojto	109:9296ab0bfc11	132	#endif /* __packed */
Kojto	109:9296ab0bfc11	133	#endif /* __GNUC__ */
Kojto	109:9296ab0bfc11	134
Kojto	109:9296ab0bfc11	135
Kojto	109:9296ab0bfc11	136	/* Macro to get variable aligned on 4-bytes, for __ICCARM__ the directive "#pragma data_alignment=4" must be used instead */
Kojto	109:9296ab0bfc11	137	#if defined (__GNUC__) /* GNU Compiler */
Kojto	109:9296ab0bfc11	138	#ifndef __ALIGN_END
Kojto	109:9296ab0bfc11	139	#define __ALIGN_END __attribute__ ((aligned (4)))
Kojto	109:9296ab0bfc11	140	#endif /* __ALIGN_END */
Kojto	109:9296ab0bfc11	141	#ifndef __ALIGN_BEGIN
Kojto	109:9296ab0bfc11	142	#define __ALIGN_BEGIN
Kojto	109:9296ab0bfc11	143	#endif /* __ALIGN_BEGIN */
Kojto	109:9296ab0bfc11	144	#else
Kojto	109:9296ab0bfc11	145	#ifndef __ALIGN_END
Kojto	109:9296ab0bfc11	146	#define __ALIGN_END
Kojto	109:9296ab0bfc11	147	#endif /* __ALIGN_END */
Kojto	109:9296ab0bfc11	148	#ifndef __ALIGN_BEGIN
Kojto	109:9296ab0bfc11	149	#if defined (__CC_ARM) /* ARM Compiler */
Kojto	109:9296ab0bfc11	150	#define __ALIGN_BEGIN __align(4)
Kojto	109:9296ab0bfc11	151	#elif defined (__ICCARM__) /* IAR Compiler */
Kojto	109:9296ab0bfc11	152	#define __ALIGN_BEGIN
Kojto	109:9296ab0bfc11	153	#endif /* __CC_ARM */
Kojto	109:9296ab0bfc11	154	#endif /* __ALIGN_BEGIN */
Kojto	109:9296ab0bfc11	155	#endif /* __GNUC__ */
Kojto	109:9296ab0bfc11	156
Kojto	109:9296ab0bfc11	157	#ifdef __cplusplus
Kojto	109:9296ab0bfc11	158	}
Kojto	109:9296ab0bfc11	159	#endif
Kojto	109:9296ab0bfc11	160
Kojto	109:9296ab0bfc11	161	#endif /* ___STM32F3xx_HAL_DEF */
Kojto	109:9296ab0bfc11	162
Kojto	109:9296ab0bfc11	163	/********************** (C) COPYRIGHT STMicroelectronics *END OF FILE**/