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_NUCLEO_F334R8/stm32f3xx_hal_i2c_ex.h@122:f9eeca106725, 2016-07-07 (annotated)

Committer:
Kojto
Date:
Thu Jul 07 14:34:11 2016 +0100
Revision:
122:f9eeca106725
Parent:
92:4fc01daae5a5
Child:
123:b0220dba8be7
Release 122 of the mbed library



Changes:

- new targets - Nucleo L432KC, Beetle, Nucleo F446ZE, Nucleo L011K4

- Thread safety addition - mbed API should contain a statement about thread safety

- critical section API addition

- CAS API (core_util_atomic_incr/decr)

- DEVICE_ are generated from targets.json file, device.h deprecated

- Callback replaces FunctionPointer to provide std like interface

- mbed HAL API docs improvements

- toolchain - prexif attributes with MBED_

            - add new attributes - packed, weak, forcedinline, align

- target.json - contains targets definitions

- ST - L1XX - Cube update to 1.5

     - SPI clock selection fix (clock from APB domain)

     - F7 - Cube update v1.4.0

     - L0 -  baudrate init fix

     - L1 - Cube update v1.5

     - F3 - baudrate init fix, 3 targets CAN support

     - F4 - Cube update v1.12.0, 3 targets CAN support

     - L4XX - Cube update v1.5.1

     - F0 - update Cube to v1.5.0

     - L4 - 2 targets (L476RG/VG) CAN support

- NXP - pwm clock fix for KSDK2 MCU

      - LPC2368 - remove ARM toolchain support - due to regression

      - KSDK2 - fix SPI , I2C address and repeat start

- Silabs - some fixes backported from mbed 3

- Renesas - RZ_A1H - SystemCoreClockUpdate addition

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 86:04dd9b1680ae 1 /**
bogdanm 86:04dd9b1680ae 2 ******************************************************************************
bogdanm 86:04dd9b1680ae 3 * @file stm32f3xx_hal_i2c_ex.h
bogdanm 86:04dd9b1680ae 4 * @author MCD Application Team
Kojto 122:f9eeca106725 5 * @version V1.2.1
Kojto 122:f9eeca106725 6 * @date 29-April-2015
bogdanm 92:4fc01daae5a5 7 * @brief Header file of I2C HAL Extended module.
bogdanm 86:04dd9b1680ae 8 ******************************************************************************
bogdanm 86:04dd9b1680ae 9 * @attention
bogdanm 86:04dd9b1680ae 10 *
Kojto 122:f9eeca106725 11 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
bogdanm 86:04dd9b1680ae 12 *
bogdanm 86:04dd9b1680ae 13 * Redistribution and use in source and binary forms, with or without modification,
bogdanm 86:04dd9b1680ae 14 * are permitted provided that the following conditions are met:
bogdanm 86:04dd9b1680ae 15 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 86:04dd9b1680ae 16 * this list of conditions and the following disclaimer.
bogdanm 86:04dd9b1680ae 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 86:04dd9b1680ae 18 * this list of conditions and the following disclaimer in the documentation
bogdanm 86:04dd9b1680ae 19 * and/or other materials provided with the distribution.
bogdanm 86:04dd9b1680ae 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 86:04dd9b1680ae 21 * may be used to endorse or promote products derived from this software
bogdanm 86:04dd9b1680ae 22 * without specific prior written permission.
bogdanm 86:04dd9b1680ae 23 *
bogdanm 86:04dd9b1680ae 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 86:04dd9b1680ae 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 86:04dd9b1680ae 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 86:04dd9b1680ae 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 86:04dd9b1680ae 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 86:04dd9b1680ae 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 86:04dd9b1680ae 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 86:04dd9b1680ae 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 86:04dd9b1680ae 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 86:04dd9b1680ae 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 86:04dd9b1680ae 34 *
bogdanm 86:04dd9b1680ae 35 ******************************************************************************
bogdanm 86:04dd9b1680ae 36 */
bogdanm 86:04dd9b1680ae 37
bogdanm 86:04dd9b1680ae 38 /* Define to prevent recursive inclusion -------------------------------------*/
bogdanm 86:04dd9b1680ae 39 #ifndef __STM32F3xx_HAL_I2C_EX_H
bogdanm 86:04dd9b1680ae 40 #define __STM32F3xx_HAL_I2C_EX_H
bogdanm 86:04dd9b1680ae 41
bogdanm 86:04dd9b1680ae 42 #ifdef __cplusplus
bogdanm 86:04dd9b1680ae 43 extern "C" {
bogdanm 86:04dd9b1680ae 44 #endif
bogdanm 86:04dd9b1680ae 45
bogdanm 86:04dd9b1680ae 46 /* Includes ------------------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 47 #include "stm32f3xx_hal_def.h"
bogdanm 86:04dd9b1680ae 48
bogdanm 86:04dd9b1680ae 49 /** @addtogroup STM32F3xx_HAL_Driver
bogdanm 86:04dd9b1680ae 50 * @{
bogdanm 86:04dd9b1680ae 51 */
bogdanm 86:04dd9b1680ae 52
Kojto 122:f9eeca106725 53 /** @addtogroup I2CEx I2CEx
bogdanm 86:04dd9b1680ae 54 * @{
bogdanm 86:04dd9b1680ae 55 */
bogdanm 86:04dd9b1680ae 56
bogdanm 86:04dd9b1680ae 57 /* Exported types ------------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 58 /* Exported constants --------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 59
bogdanm 92:4fc01daae5a5 60 /** @defgroup I2CEx_Exported_Constants I2C Extended Exported Constants
bogdanm 86:04dd9b1680ae 61 * @{
bogdanm 86:04dd9b1680ae 62 */
bogdanm 86:04dd9b1680ae 63
bogdanm 92:4fc01daae5a5 64 /** @defgroup I2CEx_Analog_Filter I2C Extended Analog Filter
bogdanm 86:04dd9b1680ae 65 * @{
bogdanm 86:04dd9b1680ae 66 */
Kojto 122:f9eeca106725 67 #define I2C_ANALOGFILTER_ENABLE ((uint32_t)0x00000000)
Kojto 122:f9eeca106725 68 #define I2C_ANALOGFILTER_DISABLE I2C_CR1_ANFOFF
bogdanm 86:04dd9b1680ae 69 /**
bogdanm 86:04dd9b1680ae 70 * @}
bogdanm 86:04dd9b1680ae 71 */
bogdanm 86:04dd9b1680ae 72
Kojto 122:f9eeca106725 73 /** @defgroup I2CEx_FastModePlus I2C Extended Fast Mode Plus
bogdanm 86:04dd9b1680ae 74 * @{
bogdanm 86:04dd9b1680ae 75 */
Kojto 122:f9eeca106725 76 #if defined(SYSCFG_CFGR1_I2C_PB6_FMP)
Kojto 122:f9eeca106725 77 #define I2C_FASTMODEPLUS_PB6 ((uint32_t)SYSCFG_CFGR1_I2C_PB6_FMP) /*!< Enable Fast Mode Plus on PB6 */
Kojto 122:f9eeca106725 78 #endif /* SYSCFG_CFGR1_I2C_PB6_FMP */
Kojto 122:f9eeca106725 79
Kojto 122:f9eeca106725 80 #if defined(SYSCFG_CFGR1_I2C_PB7_FMP)
Kojto 122:f9eeca106725 81 #define I2C_FASTMODEPLUS_PB7 ((uint32_t)SYSCFG_CFGR1_I2C_PB7_FMP) /*!< Enable Fast Mode Plus on PB7 */
Kojto 122:f9eeca106725 82 #endif /* SYSCFG_CFGR1_I2C_PB7_FMP */
Kojto 122:f9eeca106725 83
Kojto 122:f9eeca106725 84 #if defined(SYSCFG_CFGR1_I2C_PB8_FMP)
Kojto 122:f9eeca106725 85 #define I2C_FASTMODEPLUS_PB8 ((uint32_t)SYSCFG_CFGR1_I2C_PB8_FMP) /*!< Enable Fast Mode Plus on PB8 */
Kojto 122:f9eeca106725 86 #endif /* SYSCFG_CFGR1_I2C_PB8_FMP */
Kojto 122:f9eeca106725 87
Kojto 122:f9eeca106725 88 #if defined(SYSCFG_CFGR1_I2C_PB9_FMP)
Kojto 122:f9eeca106725 89 #define I2C_FASTMODEPLUS_PB9 ((uint32_t)SYSCFG_CFGR1_I2C_PB9_FMP) /*!< Enable Fast Mode Plus on PB9 */
Kojto 122:f9eeca106725 90 #endif /* SYSCFG_CFGR1_I2C_PB9_FMP */
Kojto 122:f9eeca106725 91
Kojto 122:f9eeca106725 92 #if defined(SYSCFG_CFGR1_I2C1_FMP)
Kojto 122:f9eeca106725 93 #define I2C_FASTMODEPLUS_I2C1 ((uint32_t)SYSCFG_CFGR1_I2C1_FMP) /*!< Enable Fast Mode Plus on I2C1 pins */
Kojto 122:f9eeca106725 94 #endif /* SYSCFG_CFGR1_I2C1_FMP */
Kojto 122:f9eeca106725 95
Kojto 122:f9eeca106725 96 #if defined(SYSCFG_CFGR1_I2C2_FMP)
Kojto 122:f9eeca106725 97 #define I2C_FASTMODEPLUS_I2C2 ((uint32_t)SYSCFG_CFGR1_I2C2_FMP) /*!< Enable Fast Mode Plus on I2C2 pins */
Kojto 122:f9eeca106725 98 #endif /* SYSCFG_CFGR1_I2C2_FMP */
Kojto 122:f9eeca106725 99
Kojto 122:f9eeca106725 100 #if defined(SYSCFG_CFGR1_I2C3_FMP)
Kojto 122:f9eeca106725 101 #define I2C_FASTMODEPLUS_I2C3 ((uint32_t)SYSCFG_CFGR1_I2C3_FMP) /*!< Enable Fast Mode Plus on I2C3 pins */
Kojto 122:f9eeca106725 102 #endif /* SYSCFG_CFGR1_I2C3_FMP */
bogdanm 86:04dd9b1680ae 103 /**
bogdanm 86:04dd9b1680ae 104 * @}
bogdanm 86:04dd9b1680ae 105 */
bogdanm 86:04dd9b1680ae 106
bogdanm 86:04dd9b1680ae 107 /**
bogdanm 86:04dd9b1680ae 108 * @}
bogdanm 86:04dd9b1680ae 109 */
bogdanm 86:04dd9b1680ae 110
bogdanm 86:04dd9b1680ae 111 /* Exported macro ------------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 112 /* Exported functions --------------------------------------------------------*/
bogdanm 86:04dd9b1680ae 113
bogdanm 92:4fc01daae5a5 114 /** @addtogroup I2CEx_Exported_Functions I2C Extended Exported Functions
bogdanm 92:4fc01daae5a5 115 * @{
bogdanm 92:4fc01daae5a5 116 */
bogdanm 92:4fc01daae5a5 117
bogdanm 92:4fc01daae5a5 118 /** @addtogroup I2CEx_Exported_Functions_Group1 Extended features functions
Kojto 122:f9eeca106725 119 * @brief Extended features functions
bogdanm 92:4fc01daae5a5 120 * @{
bogdanm 92:4fc01daae5a5 121 */
bogdanm 92:4fc01daae5a5 122
bogdanm 86:04dd9b1680ae 123 /* Peripheral Control functions ************************************************/
Kojto 122:f9eeca106725 124 HAL_StatusTypeDef HAL_I2CEx_ConfigAnalogFilter(I2C_HandleTypeDef *hi2c, uint32_t AnalogFilter);
Kojto 122:f9eeca106725 125 HAL_StatusTypeDef HAL_I2CEx_ConfigDigitalFilter(I2C_HandleTypeDef *hi2c, uint32_t DigitalFilter);
bogdanm 86:04dd9b1680ae 126 HAL_StatusTypeDef HAL_I2CEx_EnableWakeUp (I2C_HandleTypeDef *hi2c);
bogdanm 86:04dd9b1680ae 127 HAL_StatusTypeDef HAL_I2CEx_DisableWakeUp (I2C_HandleTypeDef *hi2c);
Kojto 122:f9eeca106725 128 void HAL_I2CEx_EnableFastModePlus(uint32_t ConfigFastModePlus);
Kojto 122:f9eeca106725 129 void HAL_I2CEx_DisableFastModePlus(uint32_t ConfigFastModePlus);
Kojto 122:f9eeca106725 130
Kojto 122:f9eeca106725 131 /* Private constants ---------------------------------------------------------*/
Kojto 122:f9eeca106725 132 /** @defgroup I2CEx_Private_Constants I2C Extended Private Constants
Kojto 122:f9eeca106725 133 * @{
Kojto 122:f9eeca106725 134 */
bogdanm 86:04dd9b1680ae 135
bogdanm 86:04dd9b1680ae 136 /**
bogdanm 86:04dd9b1680ae 137 * @}
bogdanm 86:04dd9b1680ae 138 */
bogdanm 86:04dd9b1680ae 139
Kojto 122:f9eeca106725 140 /* Private macros ------------------------------------------------------------*/
Kojto 122:f9eeca106725 141 /** @defgroup I2CEx_Private_Macro I2C Extended Private Macros
Kojto 122:f9eeca106725 142 * @{
Kojto 122:f9eeca106725 143 */
Kojto 122:f9eeca106725 144 #define IS_I2C_ANALOG_FILTER(FILTER) (((FILTER) == I2C_ANALOGFILTER_ENABLE) || \
Kojto 122:f9eeca106725 145 ((FILTER) == I2C_ANALOGFILTER_DISABLE))
Kojto 122:f9eeca106725 146
Kojto 122:f9eeca106725 147 #define IS_I2C_DIGITAL_FILTER(FILTER) ((FILTER) <= 0x0000000F)
Kojto 122:f9eeca106725 148
Kojto 122:f9eeca106725 149
Kojto 122:f9eeca106725 150 #if defined(SYSCFG_CFGR1_I2C1_FMP) && defined(SYSCFG_CFGR1_I2C2_FMP) && defined(SYSCFG_CFGR1_I2C3_FMP)
Kojto 122:f9eeca106725 151 #define IS_I2C_FASTMODEPLUS(__CONFIG__) ((((__CONFIG__) & I2C_FASTMODEPLUS_PB6) == I2C_FASTMODEPLUS_PB6) || \
Kojto 122:f9eeca106725 152 (((__CONFIG__) & I2C_FASTMODEPLUS_PB7) == I2C_FASTMODEPLUS_PB7) || \
Kojto 122:f9eeca106725 153 (((__CONFIG__) & I2C_FASTMODEPLUS_PB8) == I2C_FASTMODEPLUS_PB8) || \
Kojto 122:f9eeca106725 154 (((__CONFIG__) & I2C_FASTMODEPLUS_PB9) == I2C_FASTMODEPLUS_PB9) || \
Kojto 122:f9eeca106725 155 (((__CONFIG__) & I2C_FASTMODEPLUS_I2C1) == I2C_FASTMODEPLUS_I2C1) || \
Kojto 122:f9eeca106725 156 (((__CONFIG__) & I2C_FASTMODEPLUS_I2C2) == I2C_FASTMODEPLUS_I2C2) || \
Kojto 122:f9eeca106725 157 (((__CONFIG__) & I2C_FASTMODEPLUS_I2C3) == I2C_FASTMODEPLUS_I2C3))
Kojto 122:f9eeca106725 158 #elif defined(SYSCFG_CFGR1_I2C1_FMP) && defined(SYSCFG_CFGR1_I2C2_FMP)
Kojto 122:f9eeca106725 159 #define IS_I2C_FASTMODEPLUS(__CONFIG__) ((((__CONFIG__) & I2C_FASTMODEPLUS_PB6) == I2C_FASTMODEPLUS_PB6) || \
Kojto 122:f9eeca106725 160 (((__CONFIG__) & I2C_FASTMODEPLUS_PB7) == I2C_FASTMODEPLUS_PB7) || \
Kojto 122:f9eeca106725 161 (((__CONFIG__) & I2C_FASTMODEPLUS_PB8) == I2C_FASTMODEPLUS_PB8) || \
Kojto 122:f9eeca106725 162 (((__CONFIG__) & I2C_FASTMODEPLUS_PB9) == I2C_FASTMODEPLUS_PB9) || \
Kojto 122:f9eeca106725 163 (((__CONFIG__) & I2C_FASTMODEPLUS_I2C1) == I2C_FASTMODEPLUS_I2C1) || \
Kojto 122:f9eeca106725 164 (((__CONFIG__) & I2C_FASTMODEPLUS_I2C2) == I2C_FASTMODEPLUS_I2C2))
Kojto 122:f9eeca106725 165 #elif defined(SYSCFG_CFGR1_I2C1_FMP)
Kojto 122:f9eeca106725 166 #define IS_I2C_FASTMODEPLUS(__CONFIG__) ((((__CONFIG__) & I2C_FASTMODEPLUS_PB6) == I2C_FASTMODEPLUS_PB6) || \
Kojto 122:f9eeca106725 167 (((__CONFIG__) & I2C_FASTMODEPLUS_PB7) == I2C_FASTMODEPLUS_PB7) || \
Kojto 122:f9eeca106725 168 (((__CONFIG__) & I2C_FASTMODEPLUS_PB8) == I2C_FASTMODEPLUS_PB8) || \
Kojto 122:f9eeca106725 169 (((__CONFIG__) & I2C_FASTMODEPLUS_PB9) == I2C_FASTMODEPLUS_PB9) || \
Kojto 122:f9eeca106725 170 (((__CONFIG__) & I2C_FASTMODEPLUS_I2C1) == I2C_FASTMODEPLUS_I2C1))
Kojto 122:f9eeca106725 171 #endif /* SYSCFG_CFGR1_I2C1_FMP && SYSCFG_CFGR1_I2C2_FMP && SYSCFG_CFGR3_I2C1_FMP */
Kojto 122:f9eeca106725 172 /**
Kojto 122:f9eeca106725 173 * @}
Kojto 122:f9eeca106725 174 */
Kojto 122:f9eeca106725 175
Kojto 122:f9eeca106725 176 /* Private Functions ---------------------------------------------------------*/
Kojto 122:f9eeca106725 177 /** @defgroup I2CEx_Private_Functions I2C Extended Private Functions
Kojto 122:f9eeca106725 178 * @{
Kojto 122:f9eeca106725 179 */
Kojto 122:f9eeca106725 180 /* Private functions are defined in stm32f3xx_hal_i2c_ex.c file */
bogdanm 86:04dd9b1680ae 181 /**
bogdanm 86:04dd9b1680ae 182 * @}
bogdanm 86:04dd9b1680ae 183 */
bogdanm 86:04dd9b1680ae 184
bogdanm 92:4fc01daae5a5 185 /**
bogdanm 92:4fc01daae5a5 186 * @}
bogdanm 92:4fc01daae5a5 187 */
bogdanm 92:4fc01daae5a5 188
bogdanm 92:4fc01daae5a5 189 /**
bogdanm 92:4fc01daae5a5 190 * @}
bogdanm 92:4fc01daae5a5 191 */
bogdanm 92:4fc01daae5a5 192
Kojto 122:f9eeca106725 193 /**
Kojto 122:f9eeca106725 194 * @}
Kojto 122:f9eeca106725 195 */
Kojto 122:f9eeca106725 196
Kojto 122:f9eeca106725 197 /**
Kojto 122:f9eeca106725 198 * @}
Kojto 122:f9eeca106725 199 */
Kojto 122:f9eeca106725 200
Kojto 122:f9eeca106725 201
bogdanm 86:04dd9b1680ae 202 #ifdef __cplusplus
bogdanm 86:04dd9b1680ae 203 }
bogdanm 86:04dd9b1680ae 204 #endif
bogdanm 86:04dd9b1680ae 205
bogdanm 86:04dd9b1680ae 206 #endif /* __STM32F3xx_HAL_I2C_EX_H */
bogdanm 86:04dd9b1680ae 207
bogdanm 86:04dd9b1680ae 208
bogdanm 86:04dd9b1680ae 209 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/