Janek Mann / mbed-src-openwear

mbed library sources modified for open wear

Dependents:   openwear-lifelogger-example

Fork of mbed-src by mbed official

targets/cmsis/TARGET_STM/TARGET_STM32F407VG/stm32f4xx_hal_i2c_ex.c@310:6188e0254baa, 2014-09-16 (annotated)

Committer:
janekm
Date:
Tue Sep 16 22:42:01 2014 +0000
Revision:
310:6188e0254baa
Parent:
297:ec1b66a3d094 
N/A

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 133:d4dda5c437f0 1 /**
mbed_official 133:d4dda5c437f0 2 ******************************************************************************
mbed_official 133:d4dda5c437f0 3 * @file stm32f4xx_hal_i2c_ex.c
mbed_official 133:d4dda5c437f0 4 * @author MCD Application Team
mbed_official 242:7074e42da0b2 5 * @version V1.1.0RC2
mbed_official 242:7074e42da0b2 6 * @date 14-May-2014
mbed_official 133:d4dda5c437f0 7 * @brief I2C Extension HAL module driver.
mbed_official 133:d4dda5c437f0 8 * This file provides firmware functions to manage the following
mbed_official 133:d4dda5c437f0 9 * functionalities of I2C extension peripheral:
mbed_official 133:d4dda5c437f0 10 * + Extension features functions
mbed_official 133:d4dda5c437f0 11 *
mbed_official 133:d4dda5c437f0 12 @verbatim
mbed_official 133:d4dda5c437f0 13 ==============================================================================
mbed_official 133:d4dda5c437f0 14 ##### I2C peripheral extension features #####
mbed_official 133:d4dda5c437f0 15 ==============================================================================
mbed_official 133:d4dda5c437f0 16
mbed_official 242:7074e42da0b2 17 [..] Comparing to other previous devices, the I2C interface for STM32F427xx/437xx/
mbed_official 242:7074e42da0b2 18 429xx/439xx devices contains the following additional features :
mbed_official 133:d4dda5c437f0 19
mbed_official 133:d4dda5c437f0 20 (+) Possibility to disable or enable Analog Noise Filter
mbed_official 133:d4dda5c437f0 21 (+) Use of a configured Digital Noise Filter
mbed_official 133:d4dda5c437f0 22
mbed_official 133:d4dda5c437f0 23 ##### How to use this driver #####
mbed_official 133:d4dda5c437f0 24 ==============================================================================
mbed_official 133:d4dda5c437f0 25 [..] This driver provides functions to configure Noise Filter
mbed_official 133:d4dda5c437f0 26 (#) Configure I2C Analog noise filter using the function HAL_I2C_AnalogFilter_Config()
mbed_official 133:d4dda5c437f0 27 (#) Configure I2C Digital noise filter using the function HAL_I2C_DigitalFilter_Config()
mbed_official 133:d4dda5c437f0 28
mbed_official 133:d4dda5c437f0 29 @endverbatim
mbed_official 133:d4dda5c437f0 30 ******************************************************************************
mbed_official 133:d4dda5c437f0 31 * @attention
mbed_official 133:d4dda5c437f0 32 *
mbed_official 133:d4dda5c437f0 33 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
mbed_official 133:d4dda5c437f0 34 *
mbed_official 133:d4dda5c437f0 35 * Redistribution and use in source and binary forms, with or without modification,
mbed_official 133:d4dda5c437f0 36 * are permitted provided that the following conditions are met:
mbed_official 133:d4dda5c437f0 37 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 133:d4dda5c437f0 38 * this list of conditions and the following disclaimer.
mbed_official 133:d4dda5c437f0 39 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 133:d4dda5c437f0 40 * this list of conditions and the following disclaimer in the documentation
mbed_official 133:d4dda5c437f0 41 * and/or other materials provided with the distribution.
mbed_official 133:d4dda5c437f0 42 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 133:d4dda5c437f0 43 * may be used to endorse or promote products derived from this software
mbed_official 133:d4dda5c437f0 44 * without specific prior written permission.
mbed_official 133:d4dda5c437f0 45 *
mbed_official 133:d4dda5c437f0 46 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 133:d4dda5c437f0 47 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 133:d4dda5c437f0 48 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 133:d4dda5c437f0 49 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 133:d4dda5c437f0 50 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 133:d4dda5c437f0 51 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 133:d4dda5c437f0 52 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 133:d4dda5c437f0 53 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 133:d4dda5c437f0 54 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 133:d4dda5c437f0 55 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 133:d4dda5c437f0 56 *
mbed_official 133:d4dda5c437f0 57 ******************************************************************************
mbed_official 133:d4dda5c437f0 58 */
mbed_official 133:d4dda5c437f0 59
mbed_official 133:d4dda5c437f0 60 /* Includes ------------------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 61 #include "stm32f4xx_hal.h"
mbed_official 133:d4dda5c437f0 62
mbed_official 133:d4dda5c437f0 63 /** @addtogroup STM32F4xx_HAL_Driver
mbed_official 133:d4dda5c437f0 64 * @{
mbed_official 133:d4dda5c437f0 65 */
mbed_official 133:d4dda5c437f0 66
mbed_official 133:d4dda5c437f0 67 /** @defgroup I2CEx
mbed_official 133:d4dda5c437f0 68 * @brief I2C HAL module driver
mbed_official 133:d4dda5c437f0 69 * @{
mbed_official 133:d4dda5c437f0 70 */
mbed_official 133:d4dda5c437f0 71
mbed_official 133:d4dda5c437f0 72 #ifdef HAL_I2C_MODULE_ENABLED
mbed_official 133:d4dda5c437f0 73
mbed_official 133:d4dda5c437f0 74 #if defined(STM32F427xx) || defined(STM32F437xx) || defined(STM32F429xx)|| defined(STM32F439xx) || defined(STM32F401xC) || defined(STM32F401xE)
mbed_official 133:d4dda5c437f0 75 /* Private typedef -----------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 76 /* Private define ------------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 77 /* Private macro -------------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 78 /* Private variables ---------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 79 /* Private function prototypes -----------------------------------------------*/
mbed_official 133:d4dda5c437f0 80 /* Private functions ---------------------------------------------------------*/
mbed_official 133:d4dda5c437f0 81
mbed_official 133:d4dda5c437f0 82 /** @defgroup I2CEx_Private_Functions
mbed_official 133:d4dda5c437f0 83 * @{
mbed_official 133:d4dda5c437f0 84 */
mbed_official 133:d4dda5c437f0 85
mbed_official 133:d4dda5c437f0 86
mbed_official 133:d4dda5c437f0 87 /** @defgroup I2CEx_Group1 Extension features functions
mbed_official 133:d4dda5c437f0 88 * @brief Extension features functions
mbed_official 133:d4dda5c437f0 89 *
mbed_official 133:d4dda5c437f0 90 @verbatim
mbed_official 133:d4dda5c437f0 91 ===============================================================================
mbed_official 133:d4dda5c437f0 92 ##### Extension features functions #####
mbed_official 133:d4dda5c437f0 93 ===============================================================================
mbed_official 133:d4dda5c437f0 94 [..] This section provides functions allowing to:
mbed_official 133:d4dda5c437f0 95 (+) Configure Noise Filters
mbed_official 133:d4dda5c437f0 96
mbed_official 133:d4dda5c437f0 97 @endverbatim
mbed_official 133:d4dda5c437f0 98 * @{
mbed_official 133:d4dda5c437f0 99 */
mbed_official 133:d4dda5c437f0 100
mbed_official 133:d4dda5c437f0 101 /**
mbed_official 133:d4dda5c437f0 102 * @brief Configures I2C Analog noise filter.
mbed_official 242:7074e42da0b2 103 * @param hi2c: pointer to a I2C_HandleTypeDef structure that contains
mbed_official 133:d4dda5c437f0 104 * the configuration information for the specified I2Cx peripheral.
mbed_official 242:7074e42da0b2 105 * @param AnalogFilter: new state of the Analog filter.
mbed_official 133:d4dda5c437f0 106 * @retval HAL status
mbed_official 133:d4dda5c437f0 107 */
mbed_official 133:d4dda5c437f0 108 HAL_StatusTypeDef HAL_I2CEx_AnalogFilter_Config(I2C_HandleTypeDef *hi2c, uint32_t AnalogFilter)
mbed_official 133:d4dda5c437f0 109 {
mbed_official 133:d4dda5c437f0 110 uint32_t tmp = 0;
mbed_official 133:d4dda5c437f0 111
mbed_official 133:d4dda5c437f0 112 /* Check the parameters */
mbed_official 133:d4dda5c437f0 113 assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
mbed_official 133:d4dda5c437f0 114 assert_param(IS_I2C_ANALOG_FILTER(AnalogFilter));
mbed_official 133:d4dda5c437f0 115
mbed_official 133:d4dda5c437f0 116 tmp = hi2c->State;
mbed_official 133:d4dda5c437f0 117 if((tmp == HAL_I2C_STATE_BUSY) || (tmp == HAL_I2C_STATE_BUSY_TX) || (tmp == HAL_I2C_STATE_BUSY_RX))
mbed_official 133:d4dda5c437f0 118 {
mbed_official 133:d4dda5c437f0 119 return HAL_BUSY;
mbed_official 133:d4dda5c437f0 120 }
mbed_official 133:d4dda5c437f0 121
mbed_official 133:d4dda5c437f0 122 hi2c->State = HAL_I2C_STATE_BUSY;
mbed_official 133:d4dda5c437f0 123
mbed_official 133:d4dda5c437f0 124 /* Disable the selected I2C peripheral */
mbed_official 133:d4dda5c437f0 125 __HAL_I2C_DISABLE(hi2c);
mbed_official 133:d4dda5c437f0 126
mbed_official 133:d4dda5c437f0 127 /* Reset I2Cx ANOFF bit */
mbed_official 133:d4dda5c437f0 128 hi2c->Instance->FLTR &= ~(I2C_FLTR_ANOFF);
mbed_official 133:d4dda5c437f0 129
mbed_official 133:d4dda5c437f0 130 /* Disable the analog filter */
mbed_official 133:d4dda5c437f0 131 hi2c->Instance->FLTR |= AnalogFilter;
mbed_official 133:d4dda5c437f0 132
mbed_official 133:d4dda5c437f0 133 __HAL_I2C_ENABLE(hi2c);
mbed_official 133:d4dda5c437f0 134
mbed_official 133:d4dda5c437f0 135 hi2c->State = HAL_I2C_STATE_READY;
mbed_official 133:d4dda5c437f0 136
mbed_official 133:d4dda5c437f0 137 return HAL_OK;
mbed_official 133:d4dda5c437f0 138 }
mbed_official 133:d4dda5c437f0 139
mbed_official 133:d4dda5c437f0 140 /**
mbed_official 133:d4dda5c437f0 141 * @brief Configures I2C Digital noise filter.
mbed_official 242:7074e42da0b2 142 * @param hi2c: pointer to a I2C_HandleTypeDef structure that contains
mbed_official 133:d4dda5c437f0 143 * the configuration information for the specified I2Cx peripheral.
mbed_official 242:7074e42da0b2 144 * @param DigitalFilter: Coefficient of digital noise filter between 0x00 and 0x0F.
mbed_official 133:d4dda5c437f0 145 * @retval HAL status
mbed_official 133:d4dda5c437f0 146 */
mbed_official 133:d4dda5c437f0 147 HAL_StatusTypeDef HAL_I2CEx_DigitalFilter_Config(I2C_HandleTypeDef *hi2c, uint32_t DigitalFilter)
mbed_official 133:d4dda5c437f0 148 {
mbed_official 133:d4dda5c437f0 149 uint16_t tmpreg = 0;
mbed_official 133:d4dda5c437f0 150 uint32_t tmp = 0;
mbed_official 133:d4dda5c437f0 151
mbed_official 133:d4dda5c437f0 152 /* Check the parameters */
mbed_official 133:d4dda5c437f0 153 assert_param(IS_I2C_ALL_INSTANCE(hi2c->Instance));
mbed_official 133:d4dda5c437f0 154 assert_param(IS_I2C_DIGITAL_FILTER(DigitalFilter));
mbed_official 133:d4dda5c437f0 155
mbed_official 133:d4dda5c437f0 156 tmp = hi2c->State;
mbed_official 133:d4dda5c437f0 157 if((tmp == HAL_I2C_STATE_BUSY) || (tmp == HAL_I2C_STATE_BUSY_TX) || (tmp == HAL_I2C_STATE_BUSY_RX))
mbed_official 133:d4dda5c437f0 158 {
mbed_official 133:d4dda5c437f0 159 return HAL_BUSY;
mbed_official 133:d4dda5c437f0 160 }
mbed_official 133:d4dda5c437f0 161
mbed_official 133:d4dda5c437f0 162 hi2c->State = HAL_I2C_STATE_BUSY;
mbed_official 133:d4dda5c437f0 163
mbed_official 133:d4dda5c437f0 164 /* Disable the selected I2C peripheral */
mbed_official 133:d4dda5c437f0 165 __HAL_I2C_DISABLE(hi2c);
mbed_official 133:d4dda5c437f0 166
mbed_official 133:d4dda5c437f0 167 /* Get the old register value */
mbed_official 133:d4dda5c437f0 168 tmpreg = hi2c->Instance->FLTR;
mbed_official 133:d4dda5c437f0 169
mbed_official 133:d4dda5c437f0 170 /* Reset I2Cx DNF bit [3:0] */
mbed_official 133:d4dda5c437f0 171 tmpreg &= ~(I2C_FLTR_DNF);
mbed_official 133:d4dda5c437f0 172
mbed_official 133:d4dda5c437f0 173 /* Set I2Cx DNF coefficient */
mbed_official 133:d4dda5c437f0 174 tmpreg |= DigitalFilter;
mbed_official 133:d4dda5c437f0 175
mbed_official 133:d4dda5c437f0 176 /* Store the new register value */
mbed_official 133:d4dda5c437f0 177 hi2c->Instance->FLTR = tmpreg;
mbed_official 133:d4dda5c437f0 178
mbed_official 133:d4dda5c437f0 179 __HAL_I2C_ENABLE(hi2c);
mbed_official 133:d4dda5c437f0 180
mbed_official 133:d4dda5c437f0 181 hi2c->State = HAL_I2C_STATE_READY;
mbed_official 133:d4dda5c437f0 182
mbed_official 133:d4dda5c437f0 183 return HAL_OK;
mbed_official 133:d4dda5c437f0 184 }
mbed_official 133:d4dda5c437f0 185
mbed_official 133:d4dda5c437f0 186 /**
mbed_official 133:d4dda5c437f0 187 * @}
mbed_official 133:d4dda5c437f0 188 */
mbed_official 133:d4dda5c437f0 189
mbed_official 133:d4dda5c437f0 190 /**
mbed_official 133:d4dda5c437f0 191 * @}
mbed_official 133:d4dda5c437f0 192 */
mbed_official 133:d4dda5c437f0 193 #endif /* STM32F427xx || STM32F429xx || STM32F437xx || STM32F439xx || STM32F401xC || STM32F401xE */
mbed_official 133:d4dda5c437f0 194
mbed_official 133:d4dda5c437f0 195 #endif /* HAL_I2C_MODULE_ENABLED */
mbed_official 133:d4dda5c437f0 196 /**
mbed_official 133:d4dda5c437f0 197 * @}
mbed_official 133:d4dda5c437f0 198 */
mbed_official 133:d4dda5c437f0 199
mbed_official 133:d4dda5c437f0 200 /**
mbed_official 133:d4dda5c437f0 201 * @}
mbed_official 133:d4dda5c437f0 202 */
mbed_official 133:d4dda5c437f0 203
mbed_official 133:d4dda5c437f0 204 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/