PHung Tung / DISCO-F746_WAV_PLAYER

SPKT

Dependencies:   F746_GUI SD_PlayerSkeleton F746_SAI_IO

SRC_STM32F7/targets/cmsis/TARGET_STM/TARGET_STM32F7/stm32f7xx_hal_i2c_ex.c@0:8ede47d38d10, 2019-06-04 (annotated)

Committer:
phungductung
Date:
Tue Jun 04 21:37:21 2019 +0000
Revision:
0:8ede47d38d10
SPKT

Who changed what in which revision?

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