Elijah Orr / mbed-renbed

Fork of the official mbed C/C SDK provides the software platform and libraries to build your applications for RenBED.

Dependents:   1-RenBuggyTimed RenBED_RGB RenBED_RGB_PWM RenBED_RGB

Fork of mbed by mbed official

TARGET_DISCO_L053C8/stm32l0xx_hal_i2c_ex.h@99:dbbf35b96557, 2015-05-13 (annotated)

Committer:
Kojto
Date:
Wed May 13 08:08:21 2015 +0200
Revision:
99:dbbf35b96557
Release 99 of the mbed library



Changes:

 - new targets - MAXWSNENV, DISCO_L053C8

 - STM32F4xx - ST Cube driver

 - KSDK mcu - SPI timing fix

 - Nordic - update to softdevice s130

Who changed what in which revision?

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