Vladimir Vana / mbed

pro vyuku PSS v Jecne

TARGET_NUCLEO_F103RB/stm32f1xx_hal_i2c.h@0:23d1f73bf130, 2017-09-24 (annotated)

Committer:
vladvana
Date:
Sun Sep 24 12:31:52 2017 +0000
Revision:
0:23d1f73bf130
podklady pro cviceni z PSS

Who changed what in which revision?

UserRevisionLine numberNew contents of line
vladvana 0:23d1f73bf130 1 /**
vladvana 0:23d1f73bf130 2 ******************************************************************************
vladvana 0:23d1f73bf130 3 * @file stm32f1xx_hal_i2c.h
vladvana 0:23d1f73bf130 4 * @author MCD Application Team
vladvana 0:23d1f73bf130 5 * @version V1.0.0
vladvana 0:23d1f73bf130 6 * @date 15-December-2014
vladvana 0:23d1f73bf130 7 * @brief Header file of I2C HAL module.
vladvana 0:23d1f73bf130 8 ******************************************************************************
vladvana 0:23d1f73bf130 9 * @attention
vladvana 0:23d1f73bf130 10 *
vladvana 0:23d1f73bf130 11 * <h2><center>&copy; COPYRIGHT(c) 2014 STMicroelectronics</center></h2>
vladvana 0:23d1f73bf130 12 *
vladvana 0:23d1f73bf130 13 * Redistribution and use in source and binary forms, with or without modification,
vladvana 0:23d1f73bf130 14 * are permitted provided that the following conditions are met:
vladvana 0:23d1f73bf130 15 * 1. Redistributions of source code must retain the above copyright notice,
vladvana 0:23d1f73bf130 16 * this list of conditions and the following disclaimer.
vladvana 0:23d1f73bf130 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
vladvana 0:23d1f73bf130 18 * this list of conditions and the following disclaimer in the documentation
vladvana 0:23d1f73bf130 19 * and/or other materials provided with the distribution.
vladvana 0:23d1f73bf130 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
vladvana 0:23d1f73bf130 21 * may be used to endorse or promote products derived from this software
vladvana 0:23d1f73bf130 22 * without specific prior written permission.
vladvana 0:23d1f73bf130 23 *
vladvana 0:23d1f73bf130 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
vladvana 0:23d1f73bf130 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
vladvana 0:23d1f73bf130 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
vladvana 0:23d1f73bf130 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
vladvana 0:23d1f73bf130 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
vladvana 0:23d1f73bf130 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
vladvana 0:23d1f73bf130 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
vladvana 0:23d1f73bf130 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
vladvana 0:23d1f73bf130 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
vladvana 0:23d1f73bf130 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
vladvana 0:23d1f73bf130 34 *
vladvana 0:23d1f73bf130 35 ******************************************************************************
vladvana 0:23d1f73bf130 36 */
vladvana 0:23d1f73bf130 37
vladvana 0:23d1f73bf130 38 /* Define to prevent recursive inclusion -------------------------------------*/
vladvana 0:23d1f73bf130 39 #ifndef __STM32F1xx_HAL_I2C_H
vladvana 0:23d1f73bf130 40 #define __STM32F1xx_HAL_I2C_H
vladvana 0:23d1f73bf130 41
vladvana 0:23d1f73bf130 42 #ifdef __cplusplus
vladvana 0:23d1f73bf130 43 extern "C" {
vladvana 0:23d1f73bf130 44 #endif
vladvana 0:23d1f73bf130 45
vladvana 0:23d1f73bf130 46 /* Includes ------------------------------------------------------------------*/
vladvana 0:23d1f73bf130 47 #include "stm32f1xx_hal_def.h"
vladvana 0:23d1f73bf130 48
vladvana 0:23d1f73bf130 49 /** @addtogroup STM32F1xx_HAL_Driver
vladvana 0:23d1f73bf130 50 * @{
vladvana 0:23d1f73bf130 51 */
vladvana 0:23d1f73bf130 52
vladvana 0:23d1f73bf130 53 /** @addtogroup I2C
vladvana 0:23d1f73bf130 54 * @{
vladvana 0:23d1f73bf130 55 */
vladvana 0:23d1f73bf130 56
vladvana 0:23d1f73bf130 57 /* Exported types ------------------------------------------------------------*/
vladvana 0:23d1f73bf130 58 /** @defgroup I2C_Exported_Types I2C Exported Types
vladvana 0:23d1f73bf130 59 * @{
vladvana 0:23d1f73bf130 60 */
vladvana 0:23d1f73bf130 61
vladvana 0:23d1f73bf130 62 /** @defgroup I2C_Configuration_Structure_definition I2C Configuration Structure definition
vladvana 0:23d1f73bf130 63 * @brief I2C Configuration Structure definition
vladvana 0:23d1f73bf130 64 * @{
vladvana 0:23d1f73bf130 65 */
vladvana 0:23d1f73bf130 66 typedef struct
vladvana 0:23d1f73bf130 67 {
vladvana 0:23d1f73bf130 68 uint32_t ClockSpeed; /*!< Specifies the clock frequency.
vladvana 0:23d1f73bf130 69 This parameter must be set to a value lower than 400kHz */
vladvana 0:23d1f73bf130 70
vladvana 0:23d1f73bf130 71 uint32_t DutyCycle; /*!< Specifies the I2C fast mode duty cycle.
vladvana 0:23d1f73bf130 72 This parameter can be a value of @ref I2C_duty_cycle_in_fast_mode */
vladvana 0:23d1f73bf130 73
vladvana 0:23d1f73bf130 74 uint32_t OwnAddress1; /*!< Specifies the first device own address.
vladvana 0:23d1f73bf130 75 This parameter can be a 7-bit or 10-bit address. */
vladvana 0:23d1f73bf130 76
vladvana 0:23d1f73bf130 77 uint32_t AddressingMode; /*!< Specifies if 7-bit or 10-bit addressing mode is selected.
vladvana 0:23d1f73bf130 78 This parameter can be a value of @ref I2C_addressing_mode */
vladvana 0:23d1f73bf130 79
vladvana 0:23d1f73bf130 80 uint32_t DualAddressMode; /*!< Specifies if dual addressing mode is selected.
vladvana 0:23d1f73bf130 81 This parameter can be a value of @ref I2C_dual_addressing_mode */
vladvana 0:23d1f73bf130 82
vladvana 0:23d1f73bf130 83 uint32_t OwnAddress2; /*!< Specifies the second device own address if dual addressing mode is selected
vladvana 0:23d1f73bf130 84 This parameter can be a 7-bit address. */
vladvana 0:23d1f73bf130 85
vladvana 0:23d1f73bf130 86 uint32_t GeneralCallMode; /*!< Specifies if general call mode is selected.
vladvana 0:23d1f73bf130 87 This parameter can be a value of @ref I2C_general_call_addressing_mode */
vladvana 0:23d1f73bf130 88
vladvana 0:23d1f73bf130 89 uint32_t NoStretchMode; /*!< Specifies if nostretch mode is selected.
vladvana 0:23d1f73bf130 90 This parameter can be a value of @ref I2C_nostretch_mode */
vladvana 0:23d1f73bf130 91
vladvana 0:23d1f73bf130 92 }I2C_InitTypeDef;
vladvana 0:23d1f73bf130 93
vladvana 0:23d1f73bf130 94 /**
vladvana 0:23d1f73bf130 95 * @}
vladvana 0:23d1f73bf130 96 */
vladvana 0:23d1f73bf130 97
vladvana 0:23d1f73bf130 98 /** @defgroup HAL_state_structure_definition HAL state structure definition
vladvana 0:23d1f73bf130 99 * @brief HAL State structure definition
vladvana 0:23d1f73bf130 100 * @{
vladvana 0:23d1f73bf130 101 */
vladvana 0:23d1f73bf130 102
vladvana 0:23d1f73bf130 103 typedef enum
vladvana 0:23d1f73bf130 104 {
vladvana 0:23d1f73bf130 105 HAL_I2C_STATE_RESET = 0x00, /*!< I2C not yet initialized or disabled */
vladvana 0:23d1f73bf130 106 HAL_I2C_STATE_READY = 0x01, /*!< I2C initialized and ready for use */
vladvana 0:23d1f73bf130 107 HAL_I2C_STATE_BUSY = 0x02, /*!< I2C internal process is ongoing */
vladvana 0:23d1f73bf130 108 HAL_I2C_STATE_BUSY_TX = 0x12, /*!< Data Transmission process is ongoing */
vladvana 0:23d1f73bf130 109 HAL_I2C_STATE_BUSY_RX = 0x22, /*!< Data Reception process is ongoing */
vladvana 0:23d1f73bf130 110 HAL_I2C_STATE_MEM_BUSY_TX = 0x32, /*!< Memory Data Transmission process is ongoing */
vladvana 0:23d1f73bf130 111 HAL_I2C_STATE_MEM_BUSY_RX = 0x42, /*!< Memory Data Reception process is ongoing */
vladvana 0:23d1f73bf130 112 HAL_I2C_STATE_TIMEOUT = 0x03, /*!< I2C timeout state */
vladvana 0:23d1f73bf130 113 HAL_I2C_STATE_ERROR = 0x04 /*!< I2C error state */
vladvana 0:23d1f73bf130 114
vladvana 0:23d1f73bf130 115 }HAL_I2C_StateTypeDef;
vladvana 0:23d1f73bf130 116
vladvana 0:23d1f73bf130 117 /**
vladvana 0:23d1f73bf130 118 * @}
vladvana 0:23d1f73bf130 119 */
vladvana 0:23d1f73bf130 120
vladvana 0:23d1f73bf130 121 /** @defgroup I2C_handle_Structure_definition I2C handle Structure definition
vladvana 0:23d1f73bf130 122 * @brief I2C handle Structure definition
vladvana 0:23d1f73bf130 123 * @{
vladvana 0:23d1f73bf130 124 */
vladvana 0:23d1f73bf130 125 typedef struct
vladvana 0:23d1f73bf130 126 {
vladvana 0:23d1f73bf130 127 I2C_TypeDef *Instance; /*!< I2C registers base address */
vladvana 0:23d1f73bf130 128
vladvana 0:23d1f73bf130 129 I2C_InitTypeDef Init; /*!< I2C communication parameters */
vladvana 0:23d1f73bf130 130
vladvana 0:23d1f73bf130 131 uint8_t *pBuffPtr; /*!< Pointer to I2C transfer buffer */
vladvana 0:23d1f73bf130 132
vladvana 0:23d1f73bf130 133 uint16_t XferSize; /*!< I2C transfer size */
vladvana 0:23d1f73bf130 134
vladvana 0:23d1f73bf130 135 __IO uint16_t XferCount; /*!< I2C transfer counter */
vladvana 0:23d1f73bf130 136
vladvana 0:23d1f73bf130 137 DMA_HandleTypeDef *hdmatx; /*!< I2C Tx DMA handle parameters */
vladvana 0:23d1f73bf130 138
vladvana 0:23d1f73bf130 139 DMA_HandleTypeDef *hdmarx; /*!< I2C Rx DMA handle parameters */
vladvana 0:23d1f73bf130 140
vladvana 0:23d1f73bf130 141 HAL_LockTypeDef Lock; /*!< I2C locking object */
vladvana 0:23d1f73bf130 142
vladvana 0:23d1f73bf130 143 __IO HAL_I2C_StateTypeDef State; /*!< I2C communication state */
vladvana 0:23d1f73bf130 144
vladvana 0:23d1f73bf130 145 __IO uint32_t ErrorCode; /* I2C Error code */
vladvana 0:23d1f73bf130 146
vladvana 0:23d1f73bf130 147 }I2C_HandleTypeDef;
vladvana 0:23d1f73bf130 148 /**
vladvana 0:23d1f73bf130 149 * @}
vladvana 0:23d1f73bf130 150 */
vladvana 0:23d1f73bf130 151
vladvana 0:23d1f73bf130 152 /**
vladvana 0:23d1f73bf130 153 * @}
vladvana 0:23d1f73bf130 154 */
vladvana 0:23d1f73bf130 155 /* Exported constants --------------------------------------------------------*/
vladvana 0:23d1f73bf130 156
vladvana 0:23d1f73bf130 157 /** @defgroup I2C_Exported_Constants I2C Exported Constants
vladvana 0:23d1f73bf130 158 * @{
vladvana 0:23d1f73bf130 159 */
vladvana 0:23d1f73bf130 160
vladvana 0:23d1f73bf130 161 /** @defgroup I2C_Error_Codes I2C Error Codes
vladvana 0:23d1f73bf130 162 * @{
vladvana 0:23d1f73bf130 163 */
vladvana 0:23d1f73bf130 164
vladvana 0:23d1f73bf130 165 #define HAL_I2C_ERROR_NONE ((uint32_t)0x00) /*!< No error */
vladvana 0:23d1f73bf130 166 #define HAL_I2C_ERROR_BERR ((uint32_t)0x01) /*!< BERR error */
vladvana 0:23d1f73bf130 167 #define HAL_I2C_ERROR_ARLO ((uint32_t)0x02) /*!< ARLO error */
vladvana 0:23d1f73bf130 168 #define HAL_I2C_ERROR_AF ((uint32_t)0x04) /*!< AF error */
vladvana 0:23d1f73bf130 169 #define HAL_I2C_ERROR_OVR ((uint32_t)0x08) /*!< OVR error */
vladvana 0:23d1f73bf130 170 #define HAL_I2C_ERROR_DMA ((uint32_t)0x10) /*!< DMA transfer error */
vladvana 0:23d1f73bf130 171 #define HAL_I2C_ERROR_TIMEOUT ((uint32_t)0x20) /*!< Timeout error */
vladvana 0:23d1f73bf130 172
vladvana 0:23d1f73bf130 173 /**
vladvana 0:23d1f73bf130 174 * @}
vladvana 0:23d1f73bf130 175 */
vladvana 0:23d1f73bf130 176
vladvana 0:23d1f73bf130 177
vladvana 0:23d1f73bf130 178
vladvana 0:23d1f73bf130 179 /** @defgroup I2C_duty_cycle_in_fast_mode I2C Duty Cycle
vladvana 0:23d1f73bf130 180 * @{
vladvana 0:23d1f73bf130 181 */
vladvana 0:23d1f73bf130 182 #define I2C_DUTYCYCLE_2 ((uint32_t)0x00000000)
vladvana 0:23d1f73bf130 183 #define I2C_DUTYCYCLE_16_9 I2C_CCR_DUTY
vladvana 0:23d1f73bf130 184 /**
vladvana 0:23d1f73bf130 185 * @}
vladvana 0:23d1f73bf130 186 */
vladvana 0:23d1f73bf130 187
vladvana 0:23d1f73bf130 188 /** @defgroup I2C_addressing_mode I2C addressing mode
vladvana 0:23d1f73bf130 189 * @{
vladvana 0:23d1f73bf130 190 */
vladvana 0:23d1f73bf130 191 #define I2C_ADDRESSINGMODE_7BIT ((uint32_t)0x00004000)
vladvana 0:23d1f73bf130 192 #define I2C_ADDRESSINGMODE_10BIT (I2C_OAR1_ADDMODE | ((uint32_t)0x00004000))
vladvana 0:23d1f73bf130 193 /**
vladvana 0:23d1f73bf130 194 * @}
vladvana 0:23d1f73bf130 195 */
vladvana 0:23d1f73bf130 196
vladvana 0:23d1f73bf130 197 /** @defgroup I2C_dual_addressing_mode I2C dual addressing mode
vladvana 0:23d1f73bf130 198 * @{
vladvana 0:23d1f73bf130 199 */
vladvana 0:23d1f73bf130 200 #define I2C_DUALADDRESS_DISABLE ((uint32_t)0x00000000)
vladvana 0:23d1f73bf130 201 #define I2C_DUALADDRESS_ENABLE I2C_OAR2_ENDUAL
vladvana 0:23d1f73bf130 202 /**
vladvana 0:23d1f73bf130 203 * @}
vladvana 0:23d1f73bf130 204 */
vladvana 0:23d1f73bf130 205
vladvana 0:23d1f73bf130 206 /** @defgroup I2C_general_call_addressing_mode I2C general call addressing mode
vladvana 0:23d1f73bf130 207 * @{
vladvana 0:23d1f73bf130 208 */
vladvana 0:23d1f73bf130 209 #define I2C_GENERALCALL_DISABLE ((uint32_t)0x00000000)
vladvana 0:23d1f73bf130 210 #define I2C_GENERALCALL_ENABLE I2C_CR1_ENGC
vladvana 0:23d1f73bf130 211 /**
vladvana 0:23d1f73bf130 212 * @}
vladvana 0:23d1f73bf130 213 */
vladvana 0:23d1f73bf130 214
vladvana 0:23d1f73bf130 215 /** @defgroup I2C_nostretch_mode I2C nostretch mode
vladvana 0:23d1f73bf130 216 * @{
vladvana 0:23d1f73bf130 217 */
vladvana 0:23d1f73bf130 218 #define I2C_NOSTRETCH_DISABLE ((uint32_t)0x00000000)
vladvana 0:23d1f73bf130 219 #define I2C_NOSTRETCH_ENABLE I2C_CR1_NOSTRETCH
vladvana 0:23d1f73bf130 220 /**
vladvana 0:23d1f73bf130 221 * @}
vladvana 0:23d1f73bf130 222 */
vladvana 0:23d1f73bf130 223
vladvana 0:23d1f73bf130 224 /** @defgroup I2C_Memory_Address_Size I2C Memory Address Size
vladvana 0:23d1f73bf130 225 * @{
vladvana 0:23d1f73bf130 226 */
vladvana 0:23d1f73bf130 227 #define I2C_MEMADD_SIZE_8BIT ((uint32_t)0x00000001)
vladvana 0:23d1f73bf130 228 #define I2C_MEMADD_SIZE_16BIT ((uint32_t)0x00000010)
vladvana 0:23d1f73bf130 229 /**
vladvana 0:23d1f73bf130 230 * @}
vladvana 0:23d1f73bf130 231 */
vladvana 0:23d1f73bf130 232
vladvana 0:23d1f73bf130 233 /** @defgroup I2C_Interrupt_configuration_definition I2C Interrupt configuration definition
vladvana 0:23d1f73bf130 234 * @{
vladvana 0:23d1f73bf130 235 */
vladvana 0:23d1f73bf130 236 #define I2C_IT_BUF I2C_CR2_ITBUFEN
vladvana 0:23d1f73bf130 237 #define I2C_IT_EVT I2C_CR2_ITEVTEN
vladvana 0:23d1f73bf130 238 #define I2C_IT_ERR I2C_CR2_ITERREN
vladvana 0:23d1f73bf130 239 /**
vladvana 0:23d1f73bf130 240 * @}
vladvana 0:23d1f73bf130 241 */
vladvana 0:23d1f73bf130 242
vladvana 0:23d1f73bf130 243 /** @defgroup I2C_Flag_definition I2C Flag definition
vladvana 0:23d1f73bf130 244 * @brief I2C Interrupt definition
vladvana 0:23d1f73bf130 245 * - 0001XXXX : Flag control mask for SR1 Register
vladvana 0:23d1f73bf130 246 * - 0010XXXX : Flag control mask for SR2 Register
vladvana 0:23d1f73bf130 247 * @{
vladvana 0:23d1f73bf130 248 */
vladvana 0:23d1f73bf130 249 #define I2C_FLAG_SMBALERT ((uint32_t)0x00018000)
vladvana 0:23d1f73bf130 250 #define I2C_FLAG_TIMEOUT ((uint32_t)0x00014000)
vladvana 0:23d1f73bf130 251 #define I2C_FLAG_PECERR ((uint32_t)0x00011000)
vladvana 0:23d1f73bf130 252 #define I2C_FLAG_OVR ((uint32_t)0x00010800)
vladvana 0:23d1f73bf130 253 #define I2C_FLAG_AF ((uint32_t)0x00010400)
vladvana 0:23d1f73bf130 254 #define I2C_FLAG_ARLO ((uint32_t)0x00010200)
vladvana 0:23d1f73bf130 255 #define I2C_FLAG_BERR ((uint32_t)0x00010100)
vladvana 0:23d1f73bf130 256 #define I2C_FLAG_TXE ((uint32_t)0x00010080)
vladvana 0:23d1f73bf130 257 #define I2C_FLAG_RXNE ((uint32_t)0x00010040)
vladvana 0:23d1f73bf130 258 #define I2C_FLAG_STOPF ((uint32_t)0x00010010)
vladvana 0:23d1f73bf130 259 #define I2C_FLAG_ADD10 ((uint32_t)0x00010008)
vladvana 0:23d1f73bf130 260 #define I2C_FLAG_BTF ((uint32_t)0x00010004)
vladvana 0:23d1f73bf130 261 #define I2C_FLAG_ADDR ((uint32_t)0x00010002)
vladvana 0:23d1f73bf130 262 #define I2C_FLAG_SB ((uint32_t)0x00010001)
vladvana 0:23d1f73bf130 263 #define I2C_FLAG_DUALF ((uint32_t)0x00100080)
vladvana 0:23d1f73bf130 264 #define I2C_FLAG_SMBHOST ((uint32_t)0x00100040)
vladvana 0:23d1f73bf130 265 #define I2C_FLAG_SMBDEFAULT ((uint32_t)0x00100020)
vladvana 0:23d1f73bf130 266 #define I2C_FLAG_GENCALL ((uint32_t)0x00100010)
vladvana 0:23d1f73bf130 267 #define I2C_FLAG_TRA ((uint32_t)0x00100004)
vladvana 0:23d1f73bf130 268 #define I2C_FLAG_BUSY ((uint32_t)0x00100002)
vladvana 0:23d1f73bf130 269 #define I2C_FLAG_MSL ((uint32_t)0x00100001)
vladvana 0:23d1f73bf130 270 #define I2C_FLAG_MASK ((uint32_t)0x0000FFFF)
vladvana 0:23d1f73bf130 271 /**
vladvana 0:23d1f73bf130 272 * @}
vladvana 0:23d1f73bf130 273 */
vladvana 0:23d1f73bf130 274
vladvana 0:23d1f73bf130 275 /**
vladvana 0:23d1f73bf130 276 * @}
vladvana 0:23d1f73bf130 277 */
vladvana 0:23d1f73bf130 278
vladvana 0:23d1f73bf130 279 /* Exported macros -----------------------------------------------------------*/
vladvana 0:23d1f73bf130 280
vladvana 0:23d1f73bf130 281 /** @defgroup I2C_Exported_Macros I2C Exported Macros
vladvana 0:23d1f73bf130 282 * @{
vladvana 0:23d1f73bf130 283 */
vladvana 0:23d1f73bf130 284
vladvana 0:23d1f73bf130 285 /** @brief Reset I2C handle state
vladvana 0:23d1f73bf130 286 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 287 * @retval None
vladvana 0:23d1f73bf130 288 */
vladvana 0:23d1f73bf130 289 #define __HAL_I2C_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_I2C_STATE_RESET)
vladvana 0:23d1f73bf130 290
vladvana 0:23d1f73bf130 291 /** @brief Enable the specified I2C interrupts.
vladvana 0:23d1f73bf130 292 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 293 * @param __INTERRUPT__: specifies the interrupt source to enable.
vladvana 0:23d1f73bf130 294 * This parameter can be one of the following values:
vladvana 0:23d1f73bf130 295 * @arg I2C_IT_BUF: Buffer interrupt enable
vladvana 0:23d1f73bf130 296 * @arg I2C_IT_EVT: Event interrupt enable
vladvana 0:23d1f73bf130 297 * @arg I2C_IT_ERR: Error interrupt enable
vladvana 0:23d1f73bf130 298 * @retval None
vladvana 0:23d1f73bf130 299 */
vladvana 0:23d1f73bf130 300 #define __HAL_I2C_ENABLE_IT(__HANDLE__, __INTERRUPT__) (SET_BIT((__HANDLE__)->Instance->CR2, (__INTERRUPT__)))
vladvana 0:23d1f73bf130 301
vladvana 0:23d1f73bf130 302 /** @brief Disable the specified I2C interrupts.
vladvana 0:23d1f73bf130 303 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 304 * @param __INTERRUPT__: specifies the interrupt source to disable.
vladvana 0:23d1f73bf130 305 * This parameter can be one of the following values:
vladvana 0:23d1f73bf130 306 * @arg I2C_IT_BUF: Buffer interrupt enable
vladvana 0:23d1f73bf130 307 * @arg I2C_IT_EVT: Event interrupt enable
vladvana 0:23d1f73bf130 308 * @arg I2C_IT_ERR: Error interrupt enable
vladvana 0:23d1f73bf130 309 * @retval None
vladvana 0:23d1f73bf130 310 */
vladvana 0:23d1f73bf130 311 #define __HAL_I2C_DISABLE_IT(__HANDLE__, __INTERRUPT__) (CLEAR_BIT((__HANDLE__)->Instance->CR2, (__INTERRUPT__)))
vladvana 0:23d1f73bf130 312
vladvana 0:23d1f73bf130 313 /** @brief Checks if the specified I2C interrupt source is enabled or disabled.
vladvana 0:23d1f73bf130 314 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 315 * @param __INTERRUPT__: specifies the I2C interrupt source to check.
vladvana 0:23d1f73bf130 316 * This parameter can be one of the following values:
vladvana 0:23d1f73bf130 317 * @arg I2C_IT_BUF: Buffer interrupt enable
vladvana 0:23d1f73bf130 318 * @arg I2C_IT_EVT: Event interrupt enable
vladvana 0:23d1f73bf130 319 * @arg I2C_IT_ERR: Error interrupt enable
vladvana 0:23d1f73bf130 320 * @retval The new state of __INTERRUPT__ (TRUE or FALSE).
vladvana 0:23d1f73bf130 321 */
vladvana 0:23d1f73bf130 322 #define __HAL_I2C_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->CR2 & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
vladvana 0:23d1f73bf130 323
vladvana 0:23d1f73bf130 324 /** @brief Checks whether the specified I2C flag is set or not.
vladvana 0:23d1f73bf130 325 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 326 * @param __FLAG__: specifies the flag to check.
vladvana 0:23d1f73bf130 327 * This parameter can be one of the following values:
vladvana 0:23d1f73bf130 328 * @arg I2C_FLAG_SMBALERT: SMBus Alert flag
vladvana 0:23d1f73bf130 329 * @arg I2C_FLAG_TIMEOUT: Timeout or Tlow error flag
vladvana 0:23d1f73bf130 330 * @arg I2C_FLAG_PECERR: PEC error in reception flag
vladvana 0:23d1f73bf130 331 * @arg I2C_FLAG_OVR: Overrun/Underrun flag
vladvana 0:23d1f73bf130 332 * @arg I2C_FLAG_AF: Acknowledge failure flag
vladvana 0:23d1f73bf130 333 * @arg I2C_FLAG_ARLO: Arbitration lost flag
vladvana 0:23d1f73bf130 334 * @arg I2C_FLAG_BERR: Bus error flag
vladvana 0:23d1f73bf130 335 * @arg I2C_FLAG_TXE: Data register empty flag
vladvana 0:23d1f73bf130 336 * @arg I2C_FLAG_RXNE: Data register not empty flag
vladvana 0:23d1f73bf130 337 * @arg I2C_FLAG_STOPF: Stop detection flag
vladvana 0:23d1f73bf130 338 * @arg I2C_FLAG_ADD10: 10-bit header sent flag
vladvana 0:23d1f73bf130 339 * @arg I2C_FLAG_BTF: Byte transfer finished flag
vladvana 0:23d1f73bf130 340 * @arg I2C_FLAG_ADDR: Address sent flag
vladvana 0:23d1f73bf130 341 * Address matched flag
vladvana 0:23d1f73bf130 342 * @arg I2C_FLAG_SB: Start bit flag
vladvana 0:23d1f73bf130 343 * @arg I2C_FLAG_DUALF: Dual flag
vladvana 0:23d1f73bf130 344 * @arg I2C_FLAG_SMBHOST: SMBus host header
vladvana 0:23d1f73bf130 345 * @arg I2C_FLAG_SMBDEFAULT: SMBus default header
vladvana 0:23d1f73bf130 346 * @arg I2C_FLAG_GENCALL: General call header flag
vladvana 0:23d1f73bf130 347 * @arg I2C_FLAG_TRA: Transmitter/Receiver flag
vladvana 0:23d1f73bf130 348 * @arg I2C_FLAG_BUSY: Bus busy flag
vladvana 0:23d1f73bf130 349 * @arg I2C_FLAG_MSL: Master/Slave flag
vladvana 0:23d1f73bf130 350 * @retval The new state of __FLAG__ (TRUE or FALSE).
vladvana 0:23d1f73bf130 351 */
vladvana 0:23d1f73bf130 352 #define __HAL_I2C_GET_FLAG(__HANDLE__, __FLAG__) ((((uint8_t)((__FLAG__) >> 16)) == 0x01)?((((__HANDLE__)->Instance->SR1) & ((__FLAG__) & I2C_FLAG_MASK)) == ((__FLAG__) & I2C_FLAG_MASK)): \
vladvana 0:23d1f73bf130 353 ((((__HANDLE__)->Instance->SR2) & ((__FLAG__) & I2C_FLAG_MASK)) == ((__FLAG__) & I2C_FLAG_MASK)))
vladvana 0:23d1f73bf130 354
vladvana 0:23d1f73bf130 355 /** @brief Clears the I2C pending flags which are cleared by writing 0 in a specific bit.
vladvana 0:23d1f73bf130 356 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 357 * @param __FLAG__: specifies the flag to clear.
vladvana 0:23d1f73bf130 358 * This parameter can be any combination of the following values:
vladvana 0:23d1f73bf130 359 * @arg I2C_FLAG_SMBALERT: SMBus Alert flag
vladvana 0:23d1f73bf130 360 * @arg I2C_FLAG_TIMEOUT: Timeout or Tlow error flag
vladvana 0:23d1f73bf130 361 * @arg I2C_FLAG_PECERR: PEC error in reception flag
vladvana 0:23d1f73bf130 362 * @arg I2C_FLAG_OVR: Overrun/Underrun flag (Slave mode)
vladvana 0:23d1f73bf130 363 * @arg I2C_FLAG_AF: Acknowledge failure flag
vladvana 0:23d1f73bf130 364 * @arg I2C_FLAG_ARLO: Arbitration lost flag (Master mode)
vladvana 0:23d1f73bf130 365 * @arg I2C_FLAG_BERR: Bus error flag
vladvana 0:23d1f73bf130 366 * @retval None
vladvana 0:23d1f73bf130 367 */
vladvana 0:23d1f73bf130 368 #define __HAL_I2C_CLEAR_FLAG(__HANDLE__, __FLAG__) (__HANDLE__)->Instance->SR1 = (((__HANDLE__)->Instance->SR1) & (~((__FLAG__) & I2C_FLAG_MASK)))
vladvana 0:23d1f73bf130 369
vladvana 0:23d1f73bf130 370 /** @brief Clears the I2C ADDR pending flag.
vladvana 0:23d1f73bf130 371 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 372 * @retval None
vladvana 0:23d1f73bf130 373 */
vladvana 0:23d1f73bf130 374 #define __HAL_I2C_CLEAR_ADDRFLAG(__HANDLE__) \
vladvana 0:23d1f73bf130 375 do{ \
vladvana 0:23d1f73bf130 376 __IO uint32_t tmpreg; \
vladvana 0:23d1f73bf130 377 tmpreg = (__HANDLE__)->Instance->SR1; \
vladvana 0:23d1f73bf130 378 tmpreg = (__HANDLE__)->Instance->SR2; \
vladvana 0:23d1f73bf130 379 UNUSED(tmpreg); \
vladvana 0:23d1f73bf130 380 }while(0)
vladvana 0:23d1f73bf130 381
vladvana 0:23d1f73bf130 382 /** @brief Clears the I2C STOPF pending flag.
vladvana 0:23d1f73bf130 383 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 384 * @retval None
vladvana 0:23d1f73bf130 385 */
vladvana 0:23d1f73bf130 386 #define __HAL_I2C_CLEAR_STOPFLAG(__HANDLE__) \
vladvana 0:23d1f73bf130 387 do{ \
vladvana 0:23d1f73bf130 388 __IO uint32_t tmpreg; \
vladvana 0:23d1f73bf130 389 tmpreg = (__HANDLE__)->Instance->SR1; \
vladvana 0:23d1f73bf130 390 tmpreg = (__HANDLE__)->Instance->CR1 |= I2C_CR1_PE; \
vladvana 0:23d1f73bf130 391 UNUSED(tmpreg); \
vladvana 0:23d1f73bf130 392 }while(0)
vladvana 0:23d1f73bf130 393
vladvana 0:23d1f73bf130 394 /** @brief Enable the specified I2C peripheral.
vladvana 0:23d1f73bf130 395 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 396 * @retval None
vladvana 0:23d1f73bf130 397 */
vladvana 0:23d1f73bf130 398 #define __HAL_I2C_ENABLE(__HANDLE__) (SET_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))
vladvana 0:23d1f73bf130 399
vladvana 0:23d1f73bf130 400 /** @brief Disable the specified I2C peripheral.
vladvana 0:23d1f73bf130 401 * @param __HANDLE__: specifies the I2C Handle.
vladvana 0:23d1f73bf130 402 * @retval None
vladvana 0:23d1f73bf130 403 */
vladvana 0:23d1f73bf130 404 #define __HAL_I2C_DISABLE(__HANDLE__) (CLEAR_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))
vladvana 0:23d1f73bf130 405
vladvana 0:23d1f73bf130 406 /**
vladvana 0:23d1f73bf130 407 * @}
vladvana 0:23d1f73bf130 408 */
vladvana 0:23d1f73bf130 409
vladvana 0:23d1f73bf130 410 /* Exported functions --------------------------------------------------------*/
vladvana 0:23d1f73bf130 411 /** @addtogroup I2C_Exported_Functions
vladvana 0:23d1f73bf130 412 * @{
vladvana 0:23d1f73bf130 413 */
vladvana 0:23d1f73bf130 414
vladvana 0:23d1f73bf130 415 /** @addtogroup I2C_Exported_Functions_Group1 Initialization and de-initialization functions
vladvana 0:23d1f73bf130 416 * @{
vladvana 0:23d1f73bf130 417 */
vladvana 0:23d1f73bf130 418
vladvana 0:23d1f73bf130 419 /* Initialization/de-initialization functions ********************************/
vladvana 0:23d1f73bf130 420 HAL_StatusTypeDef HAL_I2C_Init(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 421 HAL_StatusTypeDef HAL_I2C_DeInit (I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 422 void HAL_I2C_MspInit(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 423 void HAL_I2C_MspDeInit(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 424
vladvana 0:23d1f73bf130 425 /**
vladvana 0:23d1f73bf130 426 * @}
vladvana 0:23d1f73bf130 427 */
vladvana 0:23d1f73bf130 428
vladvana 0:23d1f73bf130 429 /** @addtogroup I2C_Exported_Functions_Group2 Input and Output operation functions
vladvana 0:23d1f73bf130 430 * @{
vladvana 0:23d1f73bf130 431 */
vladvana 0:23d1f73bf130 432
vladvana 0:23d1f73bf130 433 /* IO operation functions ****************************************************/
vladvana 0:23d1f73bf130 434
vladvana 0:23d1f73bf130 435 /******* Blocking mode: Polling */
vladvana 0:23d1f73bf130 436 HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout);
vladvana 0:23d1f73bf130 437 HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout);
vladvana 0:23d1f73bf130 438 HAL_StatusTypeDef HAL_I2C_Slave_Transmit(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout);
vladvana 0:23d1f73bf130 439 HAL_StatusTypeDef HAL_I2C_Slave_Receive(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout);
vladvana 0:23d1f73bf130 440 HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout);
vladvana 0:23d1f73bf130 441 HAL_StatusTypeDef HAL_I2C_Mem_Read(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout);
vladvana 0:23d1f73bf130 442 HAL_StatusTypeDef HAL_I2C_IsDeviceReady(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Trials, uint32_t Timeout);
vladvana 0:23d1f73bf130 443
vladvana 0:23d1f73bf130 444 /******* Non-Blocking mode: Interrupt */
vladvana 0:23d1f73bf130 445 HAL_StatusTypeDef HAL_I2C_Master_Transmit_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 446 HAL_StatusTypeDef HAL_I2C_Master_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 447 HAL_StatusTypeDef HAL_I2C_Slave_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 448 HAL_StatusTypeDef HAL_I2C_Slave_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 449 HAL_StatusTypeDef HAL_I2C_Mem_Write_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 450 HAL_StatusTypeDef HAL_I2C_Mem_Read_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 451
vladvana 0:23d1f73bf130 452 /******* Non-Blocking mode: DMA */
vladvana 0:23d1f73bf130 453 HAL_StatusTypeDef HAL_I2C_Master_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 454 HAL_StatusTypeDef HAL_I2C_Master_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 455 HAL_StatusTypeDef HAL_I2C_Slave_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 456 HAL_StatusTypeDef HAL_I2C_Slave_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 457 HAL_StatusTypeDef HAL_I2C_Mem_Write_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 458 HAL_StatusTypeDef HAL_I2C_Mem_Read_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size);
vladvana 0:23d1f73bf130 459 /**
vladvana 0:23d1f73bf130 460 * @}
vladvana 0:23d1f73bf130 461 */
vladvana 0:23d1f73bf130 462
vladvana 0:23d1f73bf130 463 /** @addtogroup IRQ_Handler_and_Callbacks IRQ Handler and Callbacks
vladvana 0:23d1f73bf130 464 * @{
vladvana 0:23d1f73bf130 465 */
vladvana 0:23d1f73bf130 466 /******* I2C IRQHandler and Callbacks used in non blocking modes (Interrupt and DMA) */
vladvana 0:23d1f73bf130 467 void HAL_I2C_EV_IRQHandler(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 468 void HAL_I2C_ER_IRQHandler(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 469 void HAL_I2C_MasterTxCpltCallback(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 470 void HAL_I2C_MasterRxCpltCallback(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 471 void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 472 void HAL_I2C_SlaveRxCpltCallback(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 473 void HAL_I2C_MemTxCpltCallback(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 474 void HAL_I2C_MemRxCpltCallback(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 475 void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 476
vladvana 0:23d1f73bf130 477 /**
vladvana 0:23d1f73bf130 478 * @}
vladvana 0:23d1f73bf130 479 */
vladvana 0:23d1f73bf130 480
vladvana 0:23d1f73bf130 481
vladvana 0:23d1f73bf130 482 /** @addtogroup I2C_Exported_Functions_Group3 Peripheral State and Errors functions
vladvana 0:23d1f73bf130 483 * @{
vladvana 0:23d1f73bf130 484 */
vladvana 0:23d1f73bf130 485
vladvana 0:23d1f73bf130 486 /* Peripheral State and Errors functions *************************************/
vladvana 0:23d1f73bf130 487 HAL_I2C_StateTypeDef HAL_I2C_GetState(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 488 uint32_t HAL_I2C_GetError(I2C_HandleTypeDef *hi2c);
vladvana 0:23d1f73bf130 489
vladvana 0:23d1f73bf130 490 /**
vladvana 0:23d1f73bf130 491 * @}
vladvana 0:23d1f73bf130 492 */
vladvana 0:23d1f73bf130 493
vladvana 0:23d1f73bf130 494 /**
vladvana 0:23d1f73bf130 495 * @}
vladvana 0:23d1f73bf130 496 */
vladvana 0:23d1f73bf130 497
vladvana 0:23d1f73bf130 498 /* Private constants ---------------------------------------------------------*/
vladvana 0:23d1f73bf130 499 /** @defgroup I2C_Private_Constants I2C Private Constants
vladvana 0:23d1f73bf130 500 * @{
vladvana 0:23d1f73bf130 501 */
vladvana 0:23d1f73bf130 502 #define I2C_STANDARD_MODE_MAX_CLK ((uint32_t)100000) /* Standard Clock Up to 100kHz */
vladvana 0:23d1f73bf130 503 #define I2C_FAST_MODE_MAX_CLK ((uint32_t)400000) /* Fast Clock up to 400kHz */
vladvana 0:23d1f73bf130 504 /**
vladvana 0:23d1f73bf130 505 * @}
vladvana 0:23d1f73bf130 506 */
vladvana 0:23d1f73bf130 507
vladvana 0:23d1f73bf130 508 /* Private macros ------------------------------------------------------------*/
vladvana 0:23d1f73bf130 509 /** @defgroup I2C_Private_Macro I2C Private Macros
vladvana 0:23d1f73bf130 510 * @{
vladvana 0:23d1f73bf130 511 */
vladvana 0:23d1f73bf130 512 #define IS_I2C_ADDRESSING_MODE(ADDRESS) (((ADDRESS) == I2C_ADDRESSINGMODE_7BIT) || \
vladvana 0:23d1f73bf130 513 ((ADDRESS) == I2C_ADDRESSINGMODE_10BIT))
vladvana 0:23d1f73bf130 514
vladvana 0:23d1f73bf130 515 #define IS_I2C_DUAL_ADDRESS(ADDRESS) (((ADDRESS) == I2C_DUALADDRESS_DISABLE) || \
vladvana 0:23d1f73bf130 516 ((ADDRESS) == I2C_DUALADDRESS_ENABLE))
vladvana 0:23d1f73bf130 517
vladvana 0:23d1f73bf130 518 #define IS_I2C_GENERAL_CALL(CALL) (((CALL) == I2C_GENERALCALL_DISABLE) || \
vladvana 0:23d1f73bf130 519 ((CALL) == I2C_GENERALCALL_ENABLE))
vladvana 0:23d1f73bf130 520
vladvana 0:23d1f73bf130 521 #define IS_I2C_MEMADD_SIZE(SIZE) (((SIZE) == I2C_MEMADD_SIZE_8BIT) || \
vladvana 0:23d1f73bf130 522 ((SIZE) == I2C_MEMADD_SIZE_16BIT))
vladvana 0:23d1f73bf130 523
vladvana 0:23d1f73bf130 524 #define IS_I2C_NO_STRETCH(STRETCH) (((STRETCH) == I2C_NOSTRETCH_DISABLE) || \
vladvana 0:23d1f73bf130 525 ((STRETCH) == I2C_NOSTRETCH_ENABLE))
vladvana 0:23d1f73bf130 526
vladvana 0:23d1f73bf130 527 #define IS_I2C_OWN_ADDRESS1(ADDRESS1) (((ADDRESS1) & (uint32_t)(0xFFFFFC00)) == 0)
vladvana 0:23d1f73bf130 528
vladvana 0:23d1f73bf130 529 #define IS_I2C_OWN_ADDRESS2(ADDRESS2) (((ADDRESS2) & (uint32_t)(0xFFFFFF01)) == 0)
vladvana 0:23d1f73bf130 530
vladvana 0:23d1f73bf130 531 #define IS_I2C_CLOCK_SPEED(SPEED) (((SPEED) > 0) && ((SPEED) <= I2C_FAST_MODE_MAX_CLK))
vladvana 0:23d1f73bf130 532
vladvana 0:23d1f73bf130 533 #define IS_I2C_DUTY_CYCLE(CYCLE) (((CYCLE) == I2C_DUTYCYCLE_2) || \
vladvana 0:23d1f73bf130 534 ((CYCLE) == I2C_DUTYCYCLE_16_9))
vladvana 0:23d1f73bf130 535
vladvana 0:23d1f73bf130 536 #define I2C_FREQ_RANGE(__PCLK__) ((__PCLK__)/1000000)
vladvana 0:23d1f73bf130 537 #define I2C_RISE_TIME(__FREQRANGE__, __SPEED__) (((__SPEED__) <= I2C_STANDARD_MODE_MAX_CLK) ? ((__FREQRANGE__) + 1) : ((((__FREQRANGE__) * 300) / 1000) + 1))
vladvana 0:23d1f73bf130 538
vladvana 0:23d1f73bf130 539 #define I2C_SPEED_STANDARD(__PCLK__, __SPEED__) (((((__PCLK__)/((__SPEED__) << 1)) & I2C_CCR_CCR) < 4)? 4:((__PCLK__) / ((__SPEED__) << 1)))
vladvana 0:23d1f73bf130 540 #define I2C_SPEED_FAST(__PCLK__, __SPEED__, __DUTYCYCLE__) (((__DUTYCYCLE__) == I2C_DUTYCYCLE_2)? ((__PCLK__) / ((__SPEED__) * 3)) : (((__PCLK__) / ((__SPEED__) * 25)) | I2C_DUTYCYCLE_16_9))
vladvana 0:23d1f73bf130 541 #define I2C_SPEED(__PCLK__, __SPEED__, __DUTYCYCLE__) (((__SPEED__) <= 100000)? (I2C_SPEED_STANDARD((__PCLK__), (__SPEED__))) : \
vladvana 0:23d1f73bf130 542 ((I2C_SPEED_FAST((__PCLK__), (__SPEED__), (__DUTYCYCLE__)) & I2C_CCR_CCR) == 0)? 1 : \
vladvana 0:23d1f73bf130 543 ((I2C_SPEED_FAST((__PCLK__), (__SPEED__), (__DUTYCYCLE__))) | I2C_CCR_FS))
vladvana 0:23d1f73bf130 544
vladvana 0:23d1f73bf130 545 #define I2C_MEM_ADD_MSB(__ADDRESS__) ((uint8_t)((uint16_t)(((uint16_t)((__ADDRESS__) & (uint16_t)(0xFF00))) >> 8)))
vladvana 0:23d1f73bf130 546 #define I2C_MEM_ADD_LSB(__ADDRESS__) ((uint8_t)((uint16_t)((__ADDRESS__) & (uint16_t)(0x00FF))))
vladvana 0:23d1f73bf130 547
vladvana 0:23d1f73bf130 548 #define I2C_7BIT_ADD_WRITE(__ADDRESS__) ((uint8_t)((__ADDRESS__) & (~I2C_OAR1_ADD0)))
vladvana 0:23d1f73bf130 549 #define I2C_7BIT_ADD_READ(__ADDRESS__) ((uint8_t)((__ADDRESS__) | I2C_OAR1_ADD0))
vladvana 0:23d1f73bf130 550
vladvana 0:23d1f73bf130 551 #define I2C_10BIT_ADDRESS(__ADDRESS__) ((uint8_t)((uint16_t)((__ADDRESS__) & (uint16_t)(0x00FF))))
vladvana 0:23d1f73bf130 552 #define I2C_10BIT_HEADER_WRITE(__ADDRESS__) ((uint8_t)((uint16_t)((uint16_t)(((uint16_t)((__ADDRESS__) & (uint16_t)(0x0300))) >> 7) | (uint16_t)(0xF0))))
vladvana 0:23d1f73bf130 553 #define I2C_10BIT_HEADER_READ(__ADDRESS__) ((uint8_t)((uint16_t)((uint16_t)(((uint16_t)((__ADDRESS__) & (uint16_t)(0x0300))) >> 7) | (uint16_t)(0xF1))))
vladvana 0:23d1f73bf130 554 /**
vladvana 0:23d1f73bf130 555 * @}
vladvana 0:23d1f73bf130 556 */
vladvana 0:23d1f73bf130 557
vladvana 0:23d1f73bf130 558 /* Private Fonctions ---------------------------------------------------------*/
vladvana 0:23d1f73bf130 559 /** @defgroup I2C_Private_Functions I2C Private Functions
vladvana 0:23d1f73bf130 560 * @{
vladvana 0:23d1f73bf130 561 */
vladvana 0:23d1f73bf130 562 /* Private functions are defined in stm32f1xx_hal_i2c.c file */
vladvana 0:23d1f73bf130 563 /**
vladvana 0:23d1f73bf130 564 * @}
vladvana 0:23d1f73bf130 565 */
vladvana 0:23d1f73bf130 566
vladvana 0:23d1f73bf130 567 /**
vladvana 0:23d1f73bf130 568 * @}
vladvana 0:23d1f73bf130 569 */
vladvana 0:23d1f73bf130 570
vladvana 0:23d1f73bf130 571 /**
vladvana 0:23d1f73bf130 572 * @}
vladvana 0:23d1f73bf130 573 */
vladvana 0:23d1f73bf130 574
vladvana 0:23d1f73bf130 575 #ifdef __cplusplus
vladvana 0:23d1f73bf130 576 }
vladvana 0:23d1f73bf130 577 #endif
vladvana 0:23d1f73bf130 578
vladvana 0:23d1f73bf130 579
vladvana 0:23d1f73bf130 580 #endif /* __STM32F1xx_HAL_I2C_H */
vladvana 0:23d1f73bf130 581
vladvana 0:23d1f73bf130 582 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/