mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

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

Committer:
mbed_official
Date:
Mon Nov 03 10:45:07 2014 +0000
Revision:
382:ee426a420dbb
Parent:
targets/cmsis/TARGET_STM/TARGET_DISCO_L053C8/stm32l0xx_hal_i2c_ex.c@376:cb4d9db17537
Child:
489:119543c9f674
Synchronized with git revision d54467eb07f62efd9ccdf44f1ede7fe1c1b0cf83

Full URL: https://github.com/mbedmicro/mbed/commit/d54467eb07f62efd9ccdf44f1ede7fe1c1b0cf83/

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 376:cb4d9db17537 1 /**
mbed_official 376:cb4d9db17537 2 ******************************************************************************
mbed_official 376:cb4d9db17537 3 * @file stm32l0xx_hal_i2c_ex.c
mbed_official 376:cb4d9db17537 4 * @author MCD Application Team
mbed_official 376:cb4d9db17537 5 * @version V1.1.0
mbed_official 376:cb4d9db17537 6 * @date 18-June-2014
mbed_official 376:cb4d9db17537 7 * @brief Extended I2C HAL module driver.
mbed_official 376:cb4d9db17537 8 *
mbed_official 376:cb4d9db17537 9 * This file provides firmware functions to manage the following
mbed_official 376:cb4d9db17537 10 * functionalities of the Inter Integrated Circuit (I2C) peripheral:
mbed_official 376:cb4d9db17537 11 * + Extended Control methods
mbed_official 376:cb4d9db17537 12 *
mbed_official 376:cb4d9db17537 13 @verbatim
mbed_official 376:cb4d9db17537 14 ==============================================================================
mbed_official 376:cb4d9db17537 15 ##### I2C peripheral extended features #####
mbed_official 376:cb4d9db17537 16 ==============================================================================
mbed_official 376:cb4d9db17537 17
mbed_official 376:cb4d9db17537 18 [..] Comparing to other previous devices, the I2C interface for STM32L0XX
mbed_official 376:cb4d9db17537 19 devices contains the following additional features
mbed_official 376:cb4d9db17537 20
mbed_official 376:cb4d9db17537 21 (+) Possibility to disable or enable Analog Noise Filter
mbed_official 376:cb4d9db17537 22 (+) Use of a configured Digital Noise Filter
mbed_official 376:cb4d9db17537 23 (+) Disable or enable wakeup from Stop mode
mbed_official 376:cb4d9db17537 24
mbed_official 376:cb4d9db17537 25 ##### How to use this driver #####
mbed_official 376:cb4d9db17537 26 ==============================================================================
mbed_official 376:cb4d9db17537 27 [..] This driver provides functions to configure Noise Filter
mbed_official 376:cb4d9db17537 28
mbed_official 376:cb4d9db17537 29 @endverbatim
mbed_official 376:cb4d9db17537 30 ******************************************************************************
mbed_official 376:cb4d9db17537 31 * @attention
mbed_official 376:cb4d9db17537 32 *
mbed_official 376:cb4d9db17537 33 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 376:cb4d9db17537 34 *
mbed_official 376:cb4d9db17537 35 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 376:cb4d9db17537 36 * are permitted provided that the following conditions are met:
mbed_official 376:cb4d9db17537 37 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 376:cb4d9db17537 38 * this list of conditions and the following disclaimer.
mbed_official 376:cb4d9db17537 39 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 376:cb4d9db17537 40 * this list of conditions and the following disclaimer in the documentation
mbed_official 376:cb4d9db17537 41 * and/or other materials provided with the distribution.
mbed_official 376:cb4d9db17537 42 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 376:cb4d9db17537 43 * may be used to endorse or promote products derived from this software
mbed_official 376:cb4d9db17537 44 * without specific prior written permission.
mbed_official 376:cb4d9db17537 45 *
mbed_official 376:cb4d9db17537 46 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 376:cb4d9db17537 47 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 376:cb4d9db17537 48 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 376:cb4d9db17537 49 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 376:cb4d9db17537 50 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 376:cb4d9db17537 51 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 376:cb4d9db17537 52 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 376:cb4d9db17537 53 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 376:cb4d9db17537 54 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 376:cb4d9db17537 55 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 376:cb4d9db17537 56 *
mbed_official 376:cb4d9db17537 57 ******************************************************************************
mbed_official 376:cb4d9db17537 58 */
mbed_official 376:cb4d9db17537 59
mbed_official 376:cb4d9db17537 60 /* Includes ------------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 61 #include "stm32l0xx_hal.h"
mbed_official 376:cb4d9db17537 62
mbed_official 376:cb4d9db17537 63 /** @addtogroup STM32L0xx_HAL_Driver
mbed_official 376:cb4d9db17537 64 * @{
mbed_official 376:cb4d9db17537 65 */
mbed_official 376:cb4d9db17537 66
mbed_official 376:cb4d9db17537 67 /** @defgroup I2CEx
mbed_official 376:cb4d9db17537 68 * @brief I2C HAL module driver
mbed_official 376:cb4d9db17537 69 * @{
mbed_official 376:cb4d9db17537 70 */
mbed_official 376:cb4d9db17537 71
mbed_official 376:cb4d9db17537 72 #ifdef HAL_I2C_MODULE_ENABLED
mbed_official 376:cb4d9db17537 73
mbed_official 376:cb4d9db17537 74 /* Private typedef -----------------------------------------------------------*/
mbed_official 376:cb4d9db17537 75 /* Private define ------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 76 /* Private macro -------------------------------------------------------------*/
mbed_official 376:cb4d9db17537 77 /* Private variables ---------------------------------------------------------*/
mbed_official 376:cb4d9db17537 78 /* Private function prototypes -----------------------------------------------*/
mbed_official 376:cb4d9db17537 79 /* Private functions ---------------------------------------------------------*/
mbed_official 376:cb4d9db17537 80
mbed_official 376:cb4d9db17537 81 /** @defgroup I2CEX_Private_Functions
mbed_official 376:cb4d9db17537 82 * @{
mbed_official 376:cb4d9db17537 83 */
mbed_official 376:cb4d9db17537 84
mbed_official 376:cb4d9db17537 85
mbed_official 376:cb4d9db17537 86 /** @defgroup I2CEX_Group1 Peripheral Control methods
mbed_official 376:cb4d9db17537 87 * @brief management functions
mbed_official 376:cb4d9db17537 88 *
mbed_official 376:cb4d9db17537 89 @verbatim
mbed_official 376:cb4d9db17537 90 ===============================================================================
mbed_official 376:cb4d9db17537 91 ##### Peripheral Control methods #####
mbed_official 376:cb4d9db17537 92 ===============================================================================
mbed_official 376:cb4d9db17537 93 [..] This section provides functions allowing to:
mbed_official 376:cb4d9db17537 94 (+) Configure Noise Filters
mbed_official 376:cb4d9db17537 95
mbed_official 376:cb4d9db17537 96 @endverbatim
mbed_official 376:cb4d9db17537 97 * @{
mbed_official 376:cb4d9db17537 98 */
mbed_official 376:cb4d9db17537 99
mbed_official 376:cb4d9db17537 100 /**
mbed_official 376:cb4d9db17537 101 * @brief Configures I2C Analog noise filter.
mbed_official 376:cb4d9db17537 102 * @param hi2c : pointer to a I2C_HandleTypeDef structure that contains
mbed_official 376:cb4d9db17537 103 * the configuration information for the specified I2Cx peripheral.
mbed_official 376:cb4d9db17537 104 * @param AnalogFilter : new state of the Analog filter.
mbed_official 376:cb4d9db17537 105 * @retval HAL status
mbed_official 376:cb4d9db17537 106 */
mbed_official 376:cb4d9db17537 107 HAL_StatusTypeDef HAL_I2CEx_AnalogFilter_Config(I2C_HandleTypeDef *hi2c, uint32_t AnalogFilter)
mbed_official 376:cb4d9db17537 108 {
mbed_official 376:cb4d9db17537 109 /* Check the parameters */
mbed_official 376:cb4d9db17537 110 assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
mbed_official 376:cb4d9db17537 111 assert_param(IS_I2C_ANALOG_FILTER(AnalogFilter));
mbed_official 376:cb4d9db17537 112
mbed_official 376:cb4d9db17537 113 if((hi2c->State == HAL_I2C_STATE_BUSY) || (hi2c->State == HAL_I2C_STATE_MASTER_BUSY_TX) || (hi2c->State == HAL_I2C_STATE_MASTER_BUSY_RX)
mbed_official 376:cb4d9db17537 114 || (hi2c->State == HAL_I2C_STATE_SLAVE_BUSY_TX) || (hi2c->State == HAL_I2C_STATE_SLAVE_BUSY_RX))
mbed_official 376:cb4d9db17537 115 {
mbed_official 376:cb4d9db17537 116 return HAL_BUSY;
mbed_official 376:cb4d9db17537 117 }
mbed_official 376:cb4d9db17537 118
mbed_official 376:cb4d9db17537 119 /* Process Locked */
mbed_official 376:cb4d9db17537 120 __HAL_LOCK(hi2c);
mbed_official 376:cb4d9db17537 121
mbed_official 376:cb4d9db17537 122 hi2c->State = HAL_I2C_STATE_BUSY;
mbed_official 376:cb4d9db17537 123
mbed_official 376:cb4d9db17537 124 /* Disable the selected I2C peripheral */
mbed_official 376:cb4d9db17537 125 __HAL_I2C_DISABLE(hi2c);
mbed_official 376:cb4d9db17537 126
mbed_official 376:cb4d9db17537 127 /* Reset I2Cx ANOFF bit */
mbed_official 376:cb4d9db17537 128 hi2c->Instance->CR1 &= ~(I2C_CR1_ANFOFF);
mbed_official 376:cb4d9db17537 129
mbed_official 376:cb4d9db17537 130 /* Set analog filter bit*/
mbed_official 376:cb4d9db17537 131 hi2c->Instance->CR1 |= AnalogFilter;
mbed_official 376:cb4d9db17537 132
mbed_official 376:cb4d9db17537 133 __HAL_I2C_ENABLE(hi2c);
mbed_official 376:cb4d9db17537 134
mbed_official 376:cb4d9db17537 135 hi2c->State = HAL_I2C_STATE_READY;
mbed_official 376:cb4d9db17537 136
mbed_official 376:cb4d9db17537 137 /* Process Unlocked */
mbed_official 376:cb4d9db17537 138 __HAL_UNLOCK(hi2c);
mbed_official 376:cb4d9db17537 139
mbed_official 376:cb4d9db17537 140 return HAL_OK;
mbed_official 376:cb4d9db17537 141 }
mbed_official 376:cb4d9db17537 142
mbed_official 376:cb4d9db17537 143 /**
mbed_official 376:cb4d9db17537 144 * @brief Configures I2C Digital noise filter.
mbed_official 376:cb4d9db17537 145 * @param hi2c : pointer to a I2C_HandleTypeDef structure that contains
mbed_official 376:cb4d9db17537 146 * the configuration information for the specified I2Cx peripheral.
mbed_official 376:cb4d9db17537 147 * @param DigitalFilter : Coefficient of digital noise filter between 0x00 and 0x0F.
mbed_official 376:cb4d9db17537 148 * @retval HAL status
mbed_official 376:cb4d9db17537 149 */
mbed_official 376:cb4d9db17537 150 HAL_StatusTypeDef HAL_I2CEx_DigitalFilter_Config(I2C_HandleTypeDef *hi2c, uint32_t DigitalFilter)
mbed_official 376:cb4d9db17537 151 {
mbed_official 376:cb4d9db17537 152 uint32_t tmpreg = 0;
mbed_official 376:cb4d9db17537 153
mbed_official 376:cb4d9db17537 154 /* Check the parameters */
mbed_official 376:cb4d9db17537 155 assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
mbed_official 376:cb4d9db17537 156 assert_param(IS_I2C_DIGITAL_FILTER(DigitalFilter));
mbed_official 376:cb4d9db17537 157
mbed_official 376:cb4d9db17537 158 if((hi2c->State == HAL_I2C_STATE_BUSY) || (hi2c->State == HAL_I2C_STATE_MASTER_BUSY_TX) || (hi2c->State == HAL_I2C_STATE_MASTER_BUSY_RX)
mbed_official 376:cb4d9db17537 159 || (hi2c->State == HAL_I2C_STATE_SLAVE_BUSY_TX) || (hi2c->State == HAL_I2C_STATE_SLAVE_BUSY_RX))
mbed_official 376:cb4d9db17537 160 {
mbed_official 376:cb4d9db17537 161 return HAL_BUSY;
mbed_official 376:cb4d9db17537 162 }
mbed_official 376:cb4d9db17537 163
mbed_official 376:cb4d9db17537 164 /* Process Locked */
mbed_official 376:cb4d9db17537 165 __HAL_LOCK(hi2c);
mbed_official 376:cb4d9db17537 166
mbed_official 376:cb4d9db17537 167 hi2c->State = HAL_I2C_STATE_BUSY;
mbed_official 376:cb4d9db17537 168
mbed_official 376:cb4d9db17537 169 /* Disable the selected I2C peripheral */
mbed_official 376:cb4d9db17537 170 __HAL_I2C_DISABLE(hi2c);
mbed_official 376:cb4d9db17537 171
mbed_official 376:cb4d9db17537 172 /* Get the old register value */
mbed_official 376:cb4d9db17537 173 tmpreg = hi2c->Instance->CR1;
mbed_official 376:cb4d9db17537 174
mbed_official 376:cb4d9db17537 175 /* Reset I2Cx DNF bits [11:8] */
mbed_official 376:cb4d9db17537 176 tmpreg &= ~(I2C_CR1_DFN);
mbed_official 376:cb4d9db17537 177
mbed_official 376:cb4d9db17537 178 /* Set I2Cx DNF coefficient */
mbed_official 376:cb4d9db17537 179 tmpreg |= DigitalFilter << 8;
mbed_official 376:cb4d9db17537 180
mbed_official 376:cb4d9db17537 181 /* Store the new register value */
mbed_official 376:cb4d9db17537 182 hi2c->Instance->CR1 = tmpreg;
mbed_official 376:cb4d9db17537 183
mbed_official 376:cb4d9db17537 184 __HAL_I2C_ENABLE(hi2c);
mbed_official 376:cb4d9db17537 185
mbed_official 376:cb4d9db17537 186 hi2c->State = HAL_I2C_STATE_READY;
mbed_official 376:cb4d9db17537 187
mbed_official 376:cb4d9db17537 188 /* Process Unlocked */
mbed_official 376:cb4d9db17537 189 __HAL_UNLOCK(hi2c);
mbed_official 376:cb4d9db17537 190
mbed_official 376:cb4d9db17537 191 return HAL_OK;
mbed_official 376:cb4d9db17537 192 }
mbed_official 376:cb4d9db17537 193
mbed_official 376:cb4d9db17537 194 /**
mbed_official 376:cb4d9db17537 195 * @brief Enables I2C wakeup from stop mode.
mbed_official 376:cb4d9db17537 196 * @param hi2c : pointer to a I2C_HandleTypeDef structure that contains
mbed_official 376:cb4d9db17537 197 * the configuration information for the specified I2Cx peripheral.
mbed_official 376:cb4d9db17537 198 * @retval HAL status
mbed_official 376:cb4d9db17537 199 */
mbed_official 376:cb4d9db17537 200 HAL_StatusTypeDef HAL_I2CEx_EnableWakeUp (I2C_HandleTypeDef *hi2c)
mbed_official 376:cb4d9db17537 201 {
mbed_official 376:cb4d9db17537 202 /* Check the parameters */
mbed_official 376:cb4d9db17537 203 assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
mbed_official 376:cb4d9db17537 204
mbed_official 376:cb4d9db17537 205 if((hi2c->State == HAL_I2C_STATE_BUSY) || (hi2c->State == HAL_I2C_STATE_MASTER_BUSY_TX) || (hi2c->State == HAL_I2C_STATE_MASTER_BUSY_RX)
mbed_official 376:cb4d9db17537 206 || (hi2c->State == HAL_I2C_STATE_SLAVE_BUSY_TX) || (hi2c->State == HAL_I2C_STATE_SLAVE_BUSY_RX))
mbed_official 376:cb4d9db17537 207 {
mbed_official 376:cb4d9db17537 208 return HAL_BUSY;
mbed_official 376:cb4d9db17537 209 }
mbed_official 376:cb4d9db17537 210
mbed_official 376:cb4d9db17537 211 /* Process Locked */
mbed_official 376:cb4d9db17537 212 __HAL_LOCK(hi2c);
mbed_official 376:cb4d9db17537 213
mbed_official 376:cb4d9db17537 214 hi2c->State = HAL_I2C_STATE_BUSY;
mbed_official 376:cb4d9db17537 215
mbed_official 376:cb4d9db17537 216 /* Disable the selected I2C peripheral */
mbed_official 376:cb4d9db17537 217 __HAL_I2C_DISABLE(hi2c);
mbed_official 376:cb4d9db17537 218
mbed_official 376:cb4d9db17537 219 /* Enable wakeup from stop mode */
mbed_official 376:cb4d9db17537 220 hi2c->Instance->CR1 |= I2C_CR1_WUPEN;
mbed_official 376:cb4d9db17537 221
mbed_official 376:cb4d9db17537 222 __HAL_I2C_ENABLE(hi2c);
mbed_official 376:cb4d9db17537 223
mbed_official 376:cb4d9db17537 224 hi2c->State = HAL_I2C_STATE_READY;
mbed_official 376:cb4d9db17537 225
mbed_official 376:cb4d9db17537 226 /* Process Unlocked */
mbed_official 376:cb4d9db17537 227 __HAL_UNLOCK(hi2c);
mbed_official 376:cb4d9db17537 228
mbed_official 376:cb4d9db17537 229 return HAL_OK;
mbed_official 376:cb4d9db17537 230 }
mbed_official 376:cb4d9db17537 231
mbed_official 376:cb4d9db17537 232
mbed_official 376:cb4d9db17537 233 /**
mbed_official 376:cb4d9db17537 234 * @brief Disables I2C wakeup from stop mode.
mbed_official 376:cb4d9db17537 235 * @param hi2c : pointer to a I2C_HandleTypeDef structure that contains
mbed_official 376:cb4d9db17537 236 * the configuration information for the specified I2Cx peripheral.
mbed_official 376:cb4d9db17537 237 * @retval HAL status
mbed_official 376:cb4d9db17537 238 */
mbed_official 376:cb4d9db17537 239 HAL_StatusTypeDef HAL_I2CEx_DisableWakeUp (I2C_HandleTypeDef *hi2c)
mbed_official 376:cb4d9db17537 240 {
mbed_official 376:cb4d9db17537 241 /* Check the parameters */
mbed_official 376:cb4d9db17537 242 assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
mbed_official 376:cb4d9db17537 243
mbed_official 376:cb4d9db17537 244 if((hi2c->State == HAL_I2C_STATE_BUSY) || (hi2c->State == HAL_I2C_STATE_MASTER_BUSY_TX) || (hi2c->State == HAL_I2C_STATE_MASTER_BUSY_RX)
mbed_official 376:cb4d9db17537 245 || (hi2c->State == HAL_I2C_STATE_SLAVE_BUSY_TX) || (hi2c->State == HAL_I2C_STATE_SLAVE_BUSY_RX))
mbed_official 376:cb4d9db17537 246 {
mbed_official 376:cb4d9db17537 247 return HAL_BUSY;
mbed_official 376:cb4d9db17537 248 }
mbed_official 376:cb4d9db17537 249
mbed_official 376:cb4d9db17537 250 /* Process Locked */
mbed_official 376:cb4d9db17537 251 __HAL_LOCK(hi2c);
mbed_official 376:cb4d9db17537 252
mbed_official 376:cb4d9db17537 253 hi2c->State = HAL_I2C_STATE_BUSY;
mbed_official 376:cb4d9db17537 254
mbed_official 376:cb4d9db17537 255 /* Disable the selected I2C peripheral */
mbed_official 376:cb4d9db17537 256 __HAL_I2C_DISABLE(hi2c);
mbed_official 376:cb4d9db17537 257
mbed_official 376:cb4d9db17537 258 /* Enable wakeup from stop mode */
mbed_official 376:cb4d9db17537 259 hi2c->Instance->CR1 &= ~(I2C_CR1_WUPEN);
mbed_official 376:cb4d9db17537 260
mbed_official 376:cb4d9db17537 261 __HAL_I2C_ENABLE(hi2c);
mbed_official 376:cb4d9db17537 262
mbed_official 376:cb4d9db17537 263 hi2c->State = HAL_I2C_STATE_READY;
mbed_official 376:cb4d9db17537 264
mbed_official 376:cb4d9db17537 265 /* Process Unlocked */
mbed_official 376:cb4d9db17537 266 __HAL_UNLOCK(hi2c);
mbed_official 376:cb4d9db17537 267
mbed_official 376:cb4d9db17537 268 return HAL_OK;
mbed_official 376:cb4d9db17537 269 }
mbed_official 376:cb4d9db17537 270
mbed_official 376:cb4d9db17537 271 /**
mbed_official 376:cb4d9db17537 272 * @}
mbed_official 376:cb4d9db17537 273 */
mbed_official 376:cb4d9db17537 274
mbed_official 376:cb4d9db17537 275 /**
mbed_official 376:cb4d9db17537 276 * @}
mbed_official 376:cb4d9db17537 277 */
mbed_official 376:cb4d9db17537 278
mbed_official 376:cb4d9db17537 279 #endif /* HAL_I2C_MODULE_ENABLED */
mbed_official 376:cb4d9db17537 280 /**
mbed_official 376:cb4d9db17537 281 * @}
mbed_official 376:cb4d9db17537 282 */
mbed_official 376:cb4d9db17537 283
mbed_official 376:cb4d9db17537 284 /**
mbed_official 376:cb4d9db17537 285 * @}
mbed_official 376:cb4d9db17537 286 */
mbed_official 376:cb4d9db17537 287
mbed_official 376:cb4d9db17537 288 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/