Einstein Filho / Mbed 2 deprecated MANGUEBAJA2019_BOX

Mangue Baja Box

Dependencies:   mbed

mbed/TARGET_NUCLEO_F103RB/stm32f10x_i2c.h@0:0dee8840a1c0, 2019-07-29 (annotated)

Committer:
einsteingustavo
Date:
Mon Jul 29 20:38:00 2019 +0000
Revision:
0:0dee8840a1c0
Mangue Baja Box

Who changed what in which revision?

UserRevisionLine numberNew contents of line
einsteingustavo 0:0dee8840a1c0 1 /**
einsteingustavo 0:0dee8840a1c0 2 ******************************************************************************
einsteingustavo 0:0dee8840a1c0 3 * @file stm32f10x_i2c.h
einsteingustavo 0:0dee8840a1c0 4 * @author MCD Application Team
einsteingustavo 0:0dee8840a1c0 5 * @version V3.6.1
einsteingustavo 0:0dee8840a1c0 6 * @date 05-March-2012
einsteingustavo 0:0dee8840a1c0 7 * @brief This file contains all the functions prototypes for the I2C firmware
einsteingustavo 0:0dee8840a1c0 8 * library.
einsteingustavo 0:0dee8840a1c0 9 *******************************************************************************
einsteingustavo 0:0dee8840a1c0 10 * Copyright (c) 2014, STMicroelectronics
einsteingustavo 0:0dee8840a1c0 11 * All rights reserved.
einsteingustavo 0:0dee8840a1c0 12 *
einsteingustavo 0:0dee8840a1c0 13 * Redistribution and use in source and binary forms, with or without
einsteingustavo 0:0dee8840a1c0 14 * modification, are permitted provided that the following conditions are met:
einsteingustavo 0:0dee8840a1c0 15 *
einsteingustavo 0:0dee8840a1c0 16 * 1. Redistributions of source code must retain the above copyright notice,
einsteingustavo 0:0dee8840a1c0 17 * this list of conditions and the following disclaimer.
einsteingustavo 0:0dee8840a1c0 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
einsteingustavo 0:0dee8840a1c0 19 * this list of conditions and the following disclaimer in the documentation
einsteingustavo 0:0dee8840a1c0 20 * and/or other materials provided with the distribution.
einsteingustavo 0:0dee8840a1c0 21 * 3. Neither the name of STMicroelectronics nor the names of its contributors
einsteingustavo 0:0dee8840a1c0 22 * may be used to endorse or promote products derived from this software
einsteingustavo 0:0dee8840a1c0 23 * without specific prior written permission.
einsteingustavo 0:0dee8840a1c0 24 *
einsteingustavo 0:0dee8840a1c0 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
einsteingustavo 0:0dee8840a1c0 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
einsteingustavo 0:0dee8840a1c0 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
einsteingustavo 0:0dee8840a1c0 28 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
einsteingustavo 0:0dee8840a1c0 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
einsteingustavo 0:0dee8840a1c0 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
einsteingustavo 0:0dee8840a1c0 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
einsteingustavo 0:0dee8840a1c0 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
einsteingustavo 0:0dee8840a1c0 33 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
einsteingustavo 0:0dee8840a1c0 34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
einsteingustavo 0:0dee8840a1c0 35 *******************************************************************************
einsteingustavo 0:0dee8840a1c0 36 */
einsteingustavo 0:0dee8840a1c0 37
einsteingustavo 0:0dee8840a1c0 38 /* Define to prevent recursive inclusion -------------------------------------*/
einsteingustavo 0:0dee8840a1c0 39 #ifndef __STM32F10x_I2C_H
einsteingustavo 0:0dee8840a1c0 40 #define __STM32F10x_I2C_H
einsteingustavo 0:0dee8840a1c0 41
einsteingustavo 0:0dee8840a1c0 42 #ifdef __cplusplus
einsteingustavo 0:0dee8840a1c0 43 extern "C" {
einsteingustavo 0:0dee8840a1c0 44 #endif
einsteingustavo 0:0dee8840a1c0 45
einsteingustavo 0:0dee8840a1c0 46 /* Includes ------------------------------------------------------------------*/
einsteingustavo 0:0dee8840a1c0 47 #include "stm32f10x.h"
einsteingustavo 0:0dee8840a1c0 48
einsteingustavo 0:0dee8840a1c0 49 /** @addtogroup STM32F10x_StdPeriph_Driver
einsteingustavo 0:0dee8840a1c0 50 * @{
einsteingustavo 0:0dee8840a1c0 51 */
einsteingustavo 0:0dee8840a1c0 52
einsteingustavo 0:0dee8840a1c0 53 /** @addtogroup I2C
einsteingustavo 0:0dee8840a1c0 54 * @{
einsteingustavo 0:0dee8840a1c0 55 */
einsteingustavo 0:0dee8840a1c0 56
einsteingustavo 0:0dee8840a1c0 57 /** @defgroup I2C_Exported_Types
einsteingustavo 0:0dee8840a1c0 58 * @{
einsteingustavo 0:0dee8840a1c0 59 */
einsteingustavo 0:0dee8840a1c0 60
einsteingustavo 0:0dee8840a1c0 61 /**
einsteingustavo 0:0dee8840a1c0 62 * @brief I2C Init structure definition
einsteingustavo 0:0dee8840a1c0 63 */
einsteingustavo 0:0dee8840a1c0 64
einsteingustavo 0:0dee8840a1c0 65 typedef struct
einsteingustavo 0:0dee8840a1c0 66 {
einsteingustavo 0:0dee8840a1c0 67 uint32_t I2C_ClockSpeed; /*!< Specifies the clock frequency.
einsteingustavo 0:0dee8840a1c0 68 This parameter must be set to a value lower than 400kHz */
einsteingustavo 0:0dee8840a1c0 69
einsteingustavo 0:0dee8840a1c0 70 uint16_t I2C_Mode; /*!< Specifies the I2C mode.
einsteingustavo 0:0dee8840a1c0 71 This parameter can be a value of @ref I2C_mode */
einsteingustavo 0:0dee8840a1c0 72
einsteingustavo 0:0dee8840a1c0 73 uint16_t I2C_DutyCycle; /*!< Specifies the I2C fast mode duty cycle.
einsteingustavo 0:0dee8840a1c0 74 This parameter can be a value of @ref I2C_duty_cycle_in_fast_mode */
einsteingustavo 0:0dee8840a1c0 75
einsteingustavo 0:0dee8840a1c0 76 uint16_t I2C_OwnAddress1; /*!< Specifies the first device own address.
einsteingustavo 0:0dee8840a1c0 77 This parameter can be a 7-bit or 10-bit address. */
einsteingustavo 0:0dee8840a1c0 78
einsteingustavo 0:0dee8840a1c0 79 uint16_t I2C_Ack; /*!< Enables or disables the acknowledgement.
einsteingustavo 0:0dee8840a1c0 80 This parameter can be a value of @ref I2C_acknowledgement */
einsteingustavo 0:0dee8840a1c0 81
einsteingustavo 0:0dee8840a1c0 82 uint16_t I2C_AcknowledgedAddress; /*!< Specifies if 7-bit or 10-bit address is acknowledged.
einsteingustavo 0:0dee8840a1c0 83 This parameter can be a value of @ref I2C_acknowledged_address */
einsteingustavo 0:0dee8840a1c0 84 }I2C_InitTypeDef;
einsteingustavo 0:0dee8840a1c0 85
einsteingustavo 0:0dee8840a1c0 86 /**
einsteingustavo 0:0dee8840a1c0 87 * @}
einsteingustavo 0:0dee8840a1c0 88 */
einsteingustavo 0:0dee8840a1c0 89
einsteingustavo 0:0dee8840a1c0 90
einsteingustavo 0:0dee8840a1c0 91 /** @defgroup I2C_Exported_Constants
einsteingustavo 0:0dee8840a1c0 92 * @{
einsteingustavo 0:0dee8840a1c0 93 */
einsteingustavo 0:0dee8840a1c0 94
einsteingustavo 0:0dee8840a1c0 95 #define IS_I2C_ALL_PERIPH(PERIPH) (((PERIPH) == I2C1) || \
einsteingustavo 0:0dee8840a1c0 96 ((PERIPH) == I2C2))
einsteingustavo 0:0dee8840a1c0 97 /** @defgroup I2C_mode
einsteingustavo 0:0dee8840a1c0 98 * @{
einsteingustavo 0:0dee8840a1c0 99 */
einsteingustavo 0:0dee8840a1c0 100
einsteingustavo 0:0dee8840a1c0 101 #define I2C_Mode_I2C ((uint16_t)0x0000)
einsteingustavo 0:0dee8840a1c0 102 #define I2C_Mode_SMBusDevice ((uint16_t)0x0002)
einsteingustavo 0:0dee8840a1c0 103 #define I2C_Mode_SMBusHost ((uint16_t)0x000A)
einsteingustavo 0:0dee8840a1c0 104 #define IS_I2C_MODE(MODE) (((MODE) == I2C_Mode_I2C) || \
einsteingustavo 0:0dee8840a1c0 105 ((MODE) == I2C_Mode_SMBusDevice) || \
einsteingustavo 0:0dee8840a1c0 106 ((MODE) == I2C_Mode_SMBusHost))
einsteingustavo 0:0dee8840a1c0 107 /**
einsteingustavo 0:0dee8840a1c0 108 * @}
einsteingustavo 0:0dee8840a1c0 109 */
einsteingustavo 0:0dee8840a1c0 110
einsteingustavo 0:0dee8840a1c0 111 /** @defgroup I2C_duty_cycle_in_fast_mode
einsteingustavo 0:0dee8840a1c0 112 * @{
einsteingustavo 0:0dee8840a1c0 113 */
einsteingustavo 0:0dee8840a1c0 114
einsteingustavo 0:0dee8840a1c0 115 #define I2C_DutyCycle_16_9 ((uint16_t)0x4000) /*!< I2C fast mode Tlow/Thigh = 16/9 */
einsteingustavo 0:0dee8840a1c0 116 #define I2C_DutyCycle_2 ((uint16_t)0xBFFF) /*!< I2C fast mode Tlow/Thigh = 2 */
einsteingustavo 0:0dee8840a1c0 117 #define IS_I2C_DUTY_CYCLE(CYCLE) (((CYCLE) == I2C_DutyCycle_16_9) || \
einsteingustavo 0:0dee8840a1c0 118 ((CYCLE) == I2C_DutyCycle_2))
einsteingustavo 0:0dee8840a1c0 119 /**
einsteingustavo 0:0dee8840a1c0 120 * @}
einsteingustavo 0:0dee8840a1c0 121 */
einsteingustavo 0:0dee8840a1c0 122
einsteingustavo 0:0dee8840a1c0 123 /** @defgroup I2C_acknowledgement
einsteingustavo 0:0dee8840a1c0 124 * @{
einsteingustavo 0:0dee8840a1c0 125 */
einsteingustavo 0:0dee8840a1c0 126
einsteingustavo 0:0dee8840a1c0 127 #define I2C_Ack_Enable ((uint16_t)0x0400)
einsteingustavo 0:0dee8840a1c0 128 #define I2C_Ack_Disable ((uint16_t)0x0000)
einsteingustavo 0:0dee8840a1c0 129 #define IS_I2C_ACK_STATE(STATE) (((STATE) == I2C_Ack_Enable) || \
einsteingustavo 0:0dee8840a1c0 130 ((STATE) == I2C_Ack_Disable))
einsteingustavo 0:0dee8840a1c0 131 /**
einsteingustavo 0:0dee8840a1c0 132 * @}
einsteingustavo 0:0dee8840a1c0 133 */
einsteingustavo 0:0dee8840a1c0 134
einsteingustavo 0:0dee8840a1c0 135 /** @defgroup I2C_transfer_direction
einsteingustavo 0:0dee8840a1c0 136 * @{
einsteingustavo 0:0dee8840a1c0 137 */
einsteingustavo 0:0dee8840a1c0 138
einsteingustavo 0:0dee8840a1c0 139 #define I2C_Direction_Transmitter ((uint8_t)0x00)
einsteingustavo 0:0dee8840a1c0 140 #define I2C_Direction_Receiver ((uint8_t)0x01)
einsteingustavo 0:0dee8840a1c0 141 #define IS_I2C_DIRECTION(DIRECTION) (((DIRECTION) == I2C_Direction_Transmitter) || \
einsteingustavo 0:0dee8840a1c0 142 ((DIRECTION) == I2C_Direction_Receiver))
einsteingustavo 0:0dee8840a1c0 143 /**
einsteingustavo 0:0dee8840a1c0 144 * @}
einsteingustavo 0:0dee8840a1c0 145 */
einsteingustavo 0:0dee8840a1c0 146
einsteingustavo 0:0dee8840a1c0 147 /** @defgroup I2C_acknowledged_address
einsteingustavo 0:0dee8840a1c0 148 * @{
einsteingustavo 0:0dee8840a1c0 149 */
einsteingustavo 0:0dee8840a1c0 150
einsteingustavo 0:0dee8840a1c0 151 #define I2C_AcknowledgedAddress_7bit ((uint16_t)0x4000)
einsteingustavo 0:0dee8840a1c0 152 #define I2C_AcknowledgedAddress_10bit ((uint16_t)0xC000)
einsteingustavo 0:0dee8840a1c0 153 #define IS_I2C_ACKNOWLEDGE_ADDRESS(ADDRESS) (((ADDRESS) == I2C_AcknowledgedAddress_7bit) || \
einsteingustavo 0:0dee8840a1c0 154 ((ADDRESS) == I2C_AcknowledgedAddress_10bit))
einsteingustavo 0:0dee8840a1c0 155 /**
einsteingustavo 0:0dee8840a1c0 156 * @}
einsteingustavo 0:0dee8840a1c0 157 */
einsteingustavo 0:0dee8840a1c0 158
einsteingustavo 0:0dee8840a1c0 159 /** @defgroup I2C_registers
einsteingustavo 0:0dee8840a1c0 160 * @{
einsteingustavo 0:0dee8840a1c0 161 */
einsteingustavo 0:0dee8840a1c0 162
einsteingustavo 0:0dee8840a1c0 163 #define I2C_Register_CR1 ((uint8_t)0x00)
einsteingustavo 0:0dee8840a1c0 164 #define I2C_Register_CR2 ((uint8_t)0x04)
einsteingustavo 0:0dee8840a1c0 165 #define I2C_Register_OAR1 ((uint8_t)0x08)
einsteingustavo 0:0dee8840a1c0 166 #define I2C_Register_OAR2 ((uint8_t)0x0C)
einsteingustavo 0:0dee8840a1c0 167 #define I2C_Register_DR ((uint8_t)0x10)
einsteingustavo 0:0dee8840a1c0 168 #define I2C_Register_SR1 ((uint8_t)0x14)
einsteingustavo 0:0dee8840a1c0 169 #define I2C_Register_SR2 ((uint8_t)0x18)
einsteingustavo 0:0dee8840a1c0 170 #define I2C_Register_CCR ((uint8_t)0x1C)
einsteingustavo 0:0dee8840a1c0 171 #define I2C_Register_TRISE ((uint8_t)0x20)
einsteingustavo 0:0dee8840a1c0 172 #define IS_I2C_REGISTER(REGISTER) (((REGISTER) == I2C_Register_CR1) || \
einsteingustavo 0:0dee8840a1c0 173 ((REGISTER) == I2C_Register_CR2) || \
einsteingustavo 0:0dee8840a1c0 174 ((REGISTER) == I2C_Register_OAR1) || \
einsteingustavo 0:0dee8840a1c0 175 ((REGISTER) == I2C_Register_OAR2) || \
einsteingustavo 0:0dee8840a1c0 176 ((REGISTER) == I2C_Register_DR) || \
einsteingustavo 0:0dee8840a1c0 177 ((REGISTER) == I2C_Register_SR1) || \
einsteingustavo 0:0dee8840a1c0 178 ((REGISTER) == I2C_Register_SR2) || \
einsteingustavo 0:0dee8840a1c0 179 ((REGISTER) == I2C_Register_CCR) || \
einsteingustavo 0:0dee8840a1c0 180 ((REGISTER) == I2C_Register_TRISE))
einsteingustavo 0:0dee8840a1c0 181 /**
einsteingustavo 0:0dee8840a1c0 182 * @}
einsteingustavo 0:0dee8840a1c0 183 */
einsteingustavo 0:0dee8840a1c0 184
einsteingustavo 0:0dee8840a1c0 185 /** @defgroup I2C_SMBus_alert_pin_level
einsteingustavo 0:0dee8840a1c0 186 * @{
einsteingustavo 0:0dee8840a1c0 187 */
einsteingustavo 0:0dee8840a1c0 188
einsteingustavo 0:0dee8840a1c0 189 #define I2C_SMBusAlert_Low ((uint16_t)0x2000)
einsteingustavo 0:0dee8840a1c0 190 #define I2C_SMBusAlert_High ((uint16_t)0xDFFF)
einsteingustavo 0:0dee8840a1c0 191 #define IS_I2C_SMBUS_ALERT(ALERT) (((ALERT) == I2C_SMBusAlert_Low) || \
einsteingustavo 0:0dee8840a1c0 192 ((ALERT) == I2C_SMBusAlert_High))
einsteingustavo 0:0dee8840a1c0 193 /**
einsteingustavo 0:0dee8840a1c0 194 * @}
einsteingustavo 0:0dee8840a1c0 195 */
einsteingustavo 0:0dee8840a1c0 196
einsteingustavo 0:0dee8840a1c0 197 /** @defgroup I2C_PEC_position
einsteingustavo 0:0dee8840a1c0 198 * @{
einsteingustavo 0:0dee8840a1c0 199 */
einsteingustavo 0:0dee8840a1c0 200
einsteingustavo 0:0dee8840a1c0 201 #define I2C_PECPosition_Next ((uint16_t)0x0800)
einsteingustavo 0:0dee8840a1c0 202 #define I2C_PECPosition_Current ((uint16_t)0xF7FF)
einsteingustavo 0:0dee8840a1c0 203 #define IS_I2C_PEC_POSITION(POSITION) (((POSITION) == I2C_PECPosition_Next) || \
einsteingustavo 0:0dee8840a1c0 204 ((POSITION) == I2C_PECPosition_Current))
einsteingustavo 0:0dee8840a1c0 205 /**
einsteingustavo 0:0dee8840a1c0 206 * @}
einsteingustavo 0:0dee8840a1c0 207 */
einsteingustavo 0:0dee8840a1c0 208
einsteingustavo 0:0dee8840a1c0 209 /** @defgroup I2C_NCAK_position
einsteingustavo 0:0dee8840a1c0 210 * @{
einsteingustavo 0:0dee8840a1c0 211 */
einsteingustavo 0:0dee8840a1c0 212
einsteingustavo 0:0dee8840a1c0 213 #define I2C_NACKPosition_Next ((uint16_t)0x0800)
einsteingustavo 0:0dee8840a1c0 214 #define I2C_NACKPosition_Current ((uint16_t)0xF7FF)
einsteingustavo 0:0dee8840a1c0 215 #define IS_I2C_NACK_POSITION(POSITION) (((POSITION) == I2C_NACKPosition_Next) || \
einsteingustavo 0:0dee8840a1c0 216 ((POSITION) == I2C_NACKPosition_Current))
einsteingustavo 0:0dee8840a1c0 217 /**
einsteingustavo 0:0dee8840a1c0 218 * @}
einsteingustavo 0:0dee8840a1c0 219 */
einsteingustavo 0:0dee8840a1c0 220
einsteingustavo 0:0dee8840a1c0 221 /** @defgroup I2C_interrupts_definition
einsteingustavo 0:0dee8840a1c0 222 * @{
einsteingustavo 0:0dee8840a1c0 223 */
einsteingustavo 0:0dee8840a1c0 224
einsteingustavo 0:0dee8840a1c0 225 #define I2C_IT_BUF ((uint16_t)0x0400)
einsteingustavo 0:0dee8840a1c0 226 #define I2C_IT_EVT ((uint16_t)0x0200)
einsteingustavo 0:0dee8840a1c0 227 #define I2C_IT_ERR ((uint16_t)0x0100)
einsteingustavo 0:0dee8840a1c0 228 #define IS_I2C_CONFIG_IT(IT) ((((IT) & (uint16_t)0xF8FF) == 0x00) && ((IT) != 0x00))
einsteingustavo 0:0dee8840a1c0 229 /**
einsteingustavo 0:0dee8840a1c0 230 * @}
einsteingustavo 0:0dee8840a1c0 231 */
einsteingustavo 0:0dee8840a1c0 232
einsteingustavo 0:0dee8840a1c0 233 /** @defgroup I2C_interrupts_definition
einsteingustavo 0:0dee8840a1c0 234 * @{
einsteingustavo 0:0dee8840a1c0 235 */
einsteingustavo 0:0dee8840a1c0 236
einsteingustavo 0:0dee8840a1c0 237 #define I2C_IT_SMBALERT ((uint32_t)0x01008000)
einsteingustavo 0:0dee8840a1c0 238 #define I2C_IT_TIMEOUT ((uint32_t)0x01004000)
einsteingustavo 0:0dee8840a1c0 239 #define I2C_IT_PECERR ((uint32_t)0x01001000)
einsteingustavo 0:0dee8840a1c0 240 #define I2C_IT_OVR ((uint32_t)0x01000800)
einsteingustavo 0:0dee8840a1c0 241 #define I2C_IT_AF ((uint32_t)0x01000400)
einsteingustavo 0:0dee8840a1c0 242 #define I2C_IT_ARLO ((uint32_t)0x01000200)
einsteingustavo 0:0dee8840a1c0 243 #define I2C_IT_BERR ((uint32_t)0x01000100)
einsteingustavo 0:0dee8840a1c0 244 #define I2C_IT_TXE ((uint32_t)0x06000080)
einsteingustavo 0:0dee8840a1c0 245 #define I2C_IT_RXNE ((uint32_t)0x06000040)
einsteingustavo 0:0dee8840a1c0 246 #define I2C_IT_STOPF ((uint32_t)0x02000010)
einsteingustavo 0:0dee8840a1c0 247 #define I2C_IT_ADD10 ((uint32_t)0x02000008)
einsteingustavo 0:0dee8840a1c0 248 #define I2C_IT_BTF ((uint32_t)0x02000004)
einsteingustavo 0:0dee8840a1c0 249 #define I2C_IT_ADDR ((uint32_t)0x02000002)
einsteingustavo 0:0dee8840a1c0 250 #define I2C_IT_SB ((uint32_t)0x02000001)
einsteingustavo 0:0dee8840a1c0 251
einsteingustavo 0:0dee8840a1c0 252 #define IS_I2C_CLEAR_IT(IT) ((((IT) & (uint16_t)0x20FF) == 0x00) && ((IT) != (uint16_t)0x00))
einsteingustavo 0:0dee8840a1c0 253
einsteingustavo 0:0dee8840a1c0 254 #define IS_I2C_GET_IT(IT) (((IT) == I2C_IT_SMBALERT) || ((IT) == I2C_IT_TIMEOUT) || \
einsteingustavo 0:0dee8840a1c0 255 ((IT) == I2C_IT_PECERR) || ((IT) == I2C_IT_OVR) || \
einsteingustavo 0:0dee8840a1c0 256 ((IT) == I2C_IT_AF) || ((IT) == I2C_IT_ARLO) || \
einsteingustavo 0:0dee8840a1c0 257 ((IT) == I2C_IT_BERR) || ((IT) == I2C_IT_TXE) || \
einsteingustavo 0:0dee8840a1c0 258 ((IT) == I2C_IT_RXNE) || ((IT) == I2C_IT_STOPF) || \
einsteingustavo 0:0dee8840a1c0 259 ((IT) == I2C_IT_ADD10) || ((IT) == I2C_IT_BTF) || \
einsteingustavo 0:0dee8840a1c0 260 ((IT) == I2C_IT_ADDR) || ((IT) == I2C_IT_SB))
einsteingustavo 0:0dee8840a1c0 261 /**
einsteingustavo 0:0dee8840a1c0 262 * @}
einsteingustavo 0:0dee8840a1c0 263 */
einsteingustavo 0:0dee8840a1c0 264
einsteingustavo 0:0dee8840a1c0 265 /** @defgroup I2C_flags_definition
einsteingustavo 0:0dee8840a1c0 266 * @{
einsteingustavo 0:0dee8840a1c0 267 */
einsteingustavo 0:0dee8840a1c0 268
einsteingustavo 0:0dee8840a1c0 269 /**
einsteingustavo 0:0dee8840a1c0 270 * @brief SR2 register flags
einsteingustavo 0:0dee8840a1c0 271 */
einsteingustavo 0:0dee8840a1c0 272
einsteingustavo 0:0dee8840a1c0 273 #define I2C_FLAG_DUALF ((uint32_t)0x00800000)
einsteingustavo 0:0dee8840a1c0 274 #define I2C_FLAG_SMBHOST ((uint32_t)0x00400000)
einsteingustavo 0:0dee8840a1c0 275 #define I2C_FLAG_SMBDEFAULT ((uint32_t)0x00200000)
einsteingustavo 0:0dee8840a1c0 276 #define I2C_FLAG_GENCALL ((uint32_t)0x00100000)
einsteingustavo 0:0dee8840a1c0 277 #define I2C_FLAG_TRA ((uint32_t)0x00040000)
einsteingustavo 0:0dee8840a1c0 278 #define I2C_FLAG_BUSY ((uint32_t)0x00020000)
einsteingustavo 0:0dee8840a1c0 279 #define I2C_FLAG_MSL ((uint32_t)0x00010000)
einsteingustavo 0:0dee8840a1c0 280
einsteingustavo 0:0dee8840a1c0 281 /**
einsteingustavo 0:0dee8840a1c0 282 * @brief SR1 register flags
einsteingustavo 0:0dee8840a1c0 283 */
einsteingustavo 0:0dee8840a1c0 284
einsteingustavo 0:0dee8840a1c0 285 #define I2C_FLAG_SMBALERT ((uint32_t)0x10008000)
einsteingustavo 0:0dee8840a1c0 286 #define I2C_FLAG_TIMEOUT ((uint32_t)0x10004000)
einsteingustavo 0:0dee8840a1c0 287 #define I2C_FLAG_PECERR ((uint32_t)0x10001000)
einsteingustavo 0:0dee8840a1c0 288 #define I2C_FLAG_OVR ((uint32_t)0x10000800)
einsteingustavo 0:0dee8840a1c0 289 #define I2C_FLAG_AF ((uint32_t)0x10000400)
einsteingustavo 0:0dee8840a1c0 290 #define I2C_FLAG_ARLO ((uint32_t)0x10000200)
einsteingustavo 0:0dee8840a1c0 291 #define I2C_FLAG_BERR ((uint32_t)0x10000100)
einsteingustavo 0:0dee8840a1c0 292 #define I2C_FLAG_TXE ((uint32_t)0x10000080)
einsteingustavo 0:0dee8840a1c0 293 #define I2C_FLAG_RXNE ((uint32_t)0x10000040)
einsteingustavo 0:0dee8840a1c0 294 #define I2C_FLAG_STOPF ((uint32_t)0x10000010)
einsteingustavo 0:0dee8840a1c0 295 #define I2C_FLAG_ADD10 ((uint32_t)0x10000008)
einsteingustavo 0:0dee8840a1c0 296 #define I2C_FLAG_BTF ((uint32_t)0x10000004)
einsteingustavo 0:0dee8840a1c0 297 #define I2C_FLAG_ADDR ((uint32_t)0x10000002)
einsteingustavo 0:0dee8840a1c0 298 #define I2C_FLAG_SB ((uint32_t)0x10000001)
einsteingustavo 0:0dee8840a1c0 299
einsteingustavo 0:0dee8840a1c0 300 #define IS_I2C_CLEAR_FLAG(FLAG) ((((FLAG) & (uint16_t)0x20FF) == 0x00) && ((FLAG) != (uint16_t)0x00))
einsteingustavo 0:0dee8840a1c0 301
einsteingustavo 0:0dee8840a1c0 302 #define IS_I2C_GET_FLAG(FLAG) (((FLAG) == I2C_FLAG_DUALF) || ((FLAG) == I2C_FLAG_SMBHOST) || \
einsteingustavo 0:0dee8840a1c0 303 ((FLAG) == I2C_FLAG_SMBDEFAULT) || ((FLAG) == I2C_FLAG_GENCALL) || \
einsteingustavo 0:0dee8840a1c0 304 ((FLAG) == I2C_FLAG_TRA) || ((FLAG) == I2C_FLAG_BUSY) || \
einsteingustavo 0:0dee8840a1c0 305 ((FLAG) == I2C_FLAG_MSL) || ((FLAG) == I2C_FLAG_SMBALERT) || \
einsteingustavo 0:0dee8840a1c0 306 ((FLAG) == I2C_FLAG_TIMEOUT) || ((FLAG) == I2C_FLAG_PECERR) || \
einsteingustavo 0:0dee8840a1c0 307 ((FLAG) == I2C_FLAG_OVR) || ((FLAG) == I2C_FLAG_AF) || \
einsteingustavo 0:0dee8840a1c0 308 ((FLAG) == I2C_FLAG_ARLO) || ((FLAG) == I2C_FLAG_BERR) || \
einsteingustavo 0:0dee8840a1c0 309 ((FLAG) == I2C_FLAG_TXE) || ((FLAG) == I2C_FLAG_RXNE) || \
einsteingustavo 0:0dee8840a1c0 310 ((FLAG) == I2C_FLAG_STOPF) || ((FLAG) == I2C_FLAG_ADD10) || \
einsteingustavo 0:0dee8840a1c0 311 ((FLAG) == I2C_FLAG_BTF) || ((FLAG) == I2C_FLAG_ADDR) || \
einsteingustavo 0:0dee8840a1c0 312 ((FLAG) == I2C_FLAG_SB))
einsteingustavo 0:0dee8840a1c0 313 /**
einsteingustavo 0:0dee8840a1c0 314 * @}
einsteingustavo 0:0dee8840a1c0 315 */
einsteingustavo 0:0dee8840a1c0 316
einsteingustavo 0:0dee8840a1c0 317 /** @defgroup I2C_Events
einsteingustavo 0:0dee8840a1c0 318 * @{
einsteingustavo 0:0dee8840a1c0 319 */
einsteingustavo 0:0dee8840a1c0 320
einsteingustavo 0:0dee8840a1c0 321 /*========================================
einsteingustavo 0:0dee8840a1c0 322
einsteingustavo 0:0dee8840a1c0 323 I2C Master Events (Events grouped in order of communication)
einsteingustavo 0:0dee8840a1c0 324 ==========================================*/
einsteingustavo 0:0dee8840a1c0 325 /**
einsteingustavo 0:0dee8840a1c0 326 * @brief Communication start
einsteingustavo 0:0dee8840a1c0 327 *
einsteingustavo 0:0dee8840a1c0 328 * After sending the START condition (I2C_GenerateSTART() function) the master
einsteingustavo 0:0dee8840a1c0 329 * has to wait for this event. It means that the Start condition has been correctly
einsteingustavo 0:0dee8840a1c0 330 * released on the I2C bus (the bus is free, no other devices is communicating).
einsteingustavo 0:0dee8840a1c0 331 *
einsteingustavo 0:0dee8840a1c0 332 */
einsteingustavo 0:0dee8840a1c0 333 /* --EV5 */
einsteingustavo 0:0dee8840a1c0 334 #define I2C_EVENT_MASTER_MODE_SELECT ((uint32_t)0x00030001) /* BUSY, MSL and SB flag */
einsteingustavo 0:0dee8840a1c0 335
einsteingustavo 0:0dee8840a1c0 336 /**
einsteingustavo 0:0dee8840a1c0 337 * @brief Address Acknowledge
einsteingustavo 0:0dee8840a1c0 338 *
einsteingustavo 0:0dee8840a1c0 339 * After checking on EV5 (start condition correctly released on the bus), the
einsteingustavo 0:0dee8840a1c0 340 * master sends the address of the slave(s) with which it will communicate
einsteingustavo 0:0dee8840a1c0 341 * (I2C_Send7bitAddress() function, it also determines the direction of the communication:
einsteingustavo 0:0dee8840a1c0 342 * Master transmitter or Receiver). Then the master has to wait that a slave acknowledges
einsteingustavo 0:0dee8840a1c0 343 * his address. If an acknowledge is sent on the bus, one of the following events will
einsteingustavo 0:0dee8840a1c0 344 * be set:
einsteingustavo 0:0dee8840a1c0 345 *
einsteingustavo 0:0dee8840a1c0 346 * 1) In case of Master Receiver (7-bit addressing): the I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED
einsteingustavo 0:0dee8840a1c0 347 * event is set.
einsteingustavo 0:0dee8840a1c0 348 *
einsteingustavo 0:0dee8840a1c0 349 * 2) In case of Master Transmitter (7-bit addressing): the I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED
einsteingustavo 0:0dee8840a1c0 350 * is set
einsteingustavo 0:0dee8840a1c0 351 *
einsteingustavo 0:0dee8840a1c0 352 * 3) In case of 10-Bit addressing mode, the master (just after generating the START
einsteingustavo 0:0dee8840a1c0 353 * and checking on EV5) has to send the header of 10-bit addressing mode (I2C_SendData()
einsteingustavo 0:0dee8840a1c0 354 * function). Then master should wait on EV9. It means that the 10-bit addressing
einsteingustavo 0:0dee8840a1c0 355 * header has been correctly sent on the bus. Then master should send the second part of
einsteingustavo 0:0dee8840a1c0 356 * the 10-bit address (LSB) using the function I2C_Send7bitAddress(). Then master
einsteingustavo 0:0dee8840a1c0 357 * should wait for event EV6.
einsteingustavo 0:0dee8840a1c0 358 *
einsteingustavo 0:0dee8840a1c0 359 */
einsteingustavo 0:0dee8840a1c0 360
einsteingustavo 0:0dee8840a1c0 361 /* --EV6 */
einsteingustavo 0:0dee8840a1c0 362 #define I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED ((uint32_t)0x00070082) /* BUSY, MSL, ADDR, TXE and TRA flags */
einsteingustavo 0:0dee8840a1c0 363 #define I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED ((uint32_t)0x00030002) /* BUSY, MSL and ADDR flags */
einsteingustavo 0:0dee8840a1c0 364 /* --EV9 */
einsteingustavo 0:0dee8840a1c0 365 #define I2C_EVENT_MASTER_MODE_ADDRESS10 ((uint32_t)0x00030008) /* BUSY, MSL and ADD10 flags */
einsteingustavo 0:0dee8840a1c0 366
einsteingustavo 0:0dee8840a1c0 367 /**
einsteingustavo 0:0dee8840a1c0 368 * @brief Communication events
einsteingustavo 0:0dee8840a1c0 369 *
einsteingustavo 0:0dee8840a1c0 370 * If a communication is established (START condition generated and slave address
einsteingustavo 0:0dee8840a1c0 371 * acknowledged) then the master has to check on one of the following events for
einsteingustavo 0:0dee8840a1c0 372 * communication procedures:
einsteingustavo 0:0dee8840a1c0 373 *
einsteingustavo 0:0dee8840a1c0 374 * 1) Master Receiver mode: The master has to wait on the event EV7 then to read
einsteingustavo 0:0dee8840a1c0 375 * the data received from the slave (I2C_ReceiveData() function).
einsteingustavo 0:0dee8840a1c0 376 *
einsteingustavo 0:0dee8840a1c0 377 * 2) Master Transmitter mode: The master has to send data (I2C_SendData()
einsteingustavo 0:0dee8840a1c0 378 * function) then to wait on event EV8 or EV8_2.
einsteingustavo 0:0dee8840a1c0 379 * These two events are similar:
einsteingustavo 0:0dee8840a1c0 380 * - EV8 means that the data has been written in the data register and is
einsteingustavo 0:0dee8840a1c0 381 * being shifted out.
einsteingustavo 0:0dee8840a1c0 382 * - EV8_2 means that the data has been physically shifted out and output
einsteingustavo 0:0dee8840a1c0 383 * on the bus.
einsteingustavo 0:0dee8840a1c0 384 * In most cases, using EV8 is sufficient for the application.
einsteingustavo 0:0dee8840a1c0 385 * Using EV8_2 leads to a slower communication but ensure more reliable test.
einsteingustavo 0:0dee8840a1c0 386 * EV8_2 is also more suitable than EV8 for testing on the last data transmission
einsteingustavo 0:0dee8840a1c0 387 * (before Stop condition generation).
einsteingustavo 0:0dee8840a1c0 388 *
einsteingustavo 0:0dee8840a1c0 389 * @note In case the user software does not guarantee that this event EV7 is
einsteingustavo 0:0dee8840a1c0 390 * managed before the current byte end of transfer, then user may check on EV7
einsteingustavo 0:0dee8840a1c0 391 * and BTF flag at the same time (ie. (I2C_EVENT_MASTER_BYTE_RECEIVED | I2C_FLAG_BTF)).
einsteingustavo 0:0dee8840a1c0 392 * In this case the communication may be slower.
einsteingustavo 0:0dee8840a1c0 393 *
einsteingustavo 0:0dee8840a1c0 394 */
einsteingustavo 0:0dee8840a1c0 395
einsteingustavo 0:0dee8840a1c0 396 /* Master RECEIVER mode -----------------------------*/
einsteingustavo 0:0dee8840a1c0 397 /* --EV7 */
einsteingustavo 0:0dee8840a1c0 398 #define I2C_EVENT_MASTER_BYTE_RECEIVED ((uint32_t)0x00030040) /* BUSY, MSL and RXNE flags */
einsteingustavo 0:0dee8840a1c0 399
einsteingustavo 0:0dee8840a1c0 400 /* Master TRANSMITTER mode --------------------------*/
einsteingustavo 0:0dee8840a1c0 401 /* --EV8 */
einsteingustavo 0:0dee8840a1c0 402 #define I2C_EVENT_MASTER_BYTE_TRANSMITTING ((uint32_t)0x00070080) /* TRA, BUSY, MSL, TXE flags */
einsteingustavo 0:0dee8840a1c0 403 /* --EV8_2 */
einsteingustavo 0:0dee8840a1c0 404 #define I2C_EVENT_MASTER_BYTE_TRANSMITTED ((uint32_t)0x00070084) /* TRA, BUSY, MSL, TXE and BTF flags */
einsteingustavo 0:0dee8840a1c0 405
einsteingustavo 0:0dee8840a1c0 406
einsteingustavo 0:0dee8840a1c0 407 /*========================================
einsteingustavo 0:0dee8840a1c0 408
einsteingustavo 0:0dee8840a1c0 409 I2C Slave Events (Events grouped in order of communication)
einsteingustavo 0:0dee8840a1c0 410 ==========================================*/
einsteingustavo 0:0dee8840a1c0 411
einsteingustavo 0:0dee8840a1c0 412 /**
einsteingustavo 0:0dee8840a1c0 413 * @brief Communication start events
einsteingustavo 0:0dee8840a1c0 414 *
einsteingustavo 0:0dee8840a1c0 415 * Wait on one of these events at the start of the communication. It means that
einsteingustavo 0:0dee8840a1c0 416 * the I2C peripheral detected a Start condition on the bus (generated by master
einsteingustavo 0:0dee8840a1c0 417 * device) followed by the peripheral address. The peripheral generates an ACK
einsteingustavo 0:0dee8840a1c0 418 * condition on the bus (if the acknowledge feature is enabled through function
einsteingustavo 0:0dee8840a1c0 419 * I2C_AcknowledgeConfig()) and the events listed above are set :
einsteingustavo 0:0dee8840a1c0 420 *
einsteingustavo 0:0dee8840a1c0 421 * 1) In normal case (only one address managed by the slave), when the address
einsteingustavo 0:0dee8840a1c0 422 * sent by the master matches the own address of the peripheral (configured by
einsteingustavo 0:0dee8840a1c0 423 * I2C_OwnAddress1 field) the I2C_EVENT_SLAVE_XXX_ADDRESS_MATCHED event is set
einsteingustavo 0:0dee8840a1c0 424 * (where XXX could be TRANSMITTER or RECEIVER).
einsteingustavo 0:0dee8840a1c0 425 *
einsteingustavo 0:0dee8840a1c0 426 * 2) In case the address sent by the master matches the second address of the
einsteingustavo 0:0dee8840a1c0 427 * peripheral (configured by the function I2C_OwnAddress2Config() and enabled
einsteingustavo 0:0dee8840a1c0 428 * by the function I2C_DualAddressCmd()) the events I2C_EVENT_SLAVE_XXX_SECONDADDRESS_MATCHED
einsteingustavo 0:0dee8840a1c0 429 * (where XXX could be TRANSMITTER or RECEIVER) are set.
einsteingustavo 0:0dee8840a1c0 430 *
einsteingustavo 0:0dee8840a1c0 431 * 3) In case the address sent by the master is General Call (address 0x00) and
einsteingustavo 0:0dee8840a1c0 432 * if the General Call is enabled for the peripheral (using function I2C_GeneralCallCmd())
einsteingustavo 0:0dee8840a1c0 433 * the following event is set I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED.
einsteingustavo 0:0dee8840a1c0 434 *
einsteingustavo 0:0dee8840a1c0 435 */
einsteingustavo 0:0dee8840a1c0 436
einsteingustavo 0:0dee8840a1c0 437 /* --EV1 (all the events below are variants of EV1) */
einsteingustavo 0:0dee8840a1c0 438 /* 1) Case of One Single Address managed by the slave */
einsteingustavo 0:0dee8840a1c0 439 #define I2C_EVENT_SLAVE_RECEIVER_ADDRESS_MATCHED ((uint32_t)0x00020002) /* BUSY and ADDR flags */
einsteingustavo 0:0dee8840a1c0 440 #define I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED ((uint32_t)0x00060082) /* TRA, BUSY, TXE and ADDR flags */
einsteingustavo 0:0dee8840a1c0 441
einsteingustavo 0:0dee8840a1c0 442 /* 2) Case of Dual address managed by the slave */
einsteingustavo 0:0dee8840a1c0 443 #define I2C_EVENT_SLAVE_RECEIVER_SECONDADDRESS_MATCHED ((uint32_t)0x00820000) /* DUALF and BUSY flags */
einsteingustavo 0:0dee8840a1c0 444 #define I2C_EVENT_SLAVE_TRANSMITTER_SECONDADDRESS_MATCHED ((uint32_t)0x00860080) /* DUALF, TRA, BUSY and TXE flags */
einsteingustavo 0:0dee8840a1c0 445
einsteingustavo 0:0dee8840a1c0 446 /* 3) Case of General Call enabled for the slave */
einsteingustavo 0:0dee8840a1c0 447 #define I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED ((uint32_t)0x00120000) /* GENCALL and BUSY flags */
einsteingustavo 0:0dee8840a1c0 448
einsteingustavo 0:0dee8840a1c0 449 /**
einsteingustavo 0:0dee8840a1c0 450 * @brief Communication events
einsteingustavo 0:0dee8840a1c0 451 *
einsteingustavo 0:0dee8840a1c0 452 * Wait on one of these events when EV1 has already been checked and:
einsteingustavo 0:0dee8840a1c0 453 *
einsteingustavo 0:0dee8840a1c0 454 * - Slave RECEIVER mode:
einsteingustavo 0:0dee8840a1c0 455 * - EV2: When the application is expecting a data byte to be received.
einsteingustavo 0:0dee8840a1c0 456 * - EV4: When the application is expecting the end of the communication: master
einsteingustavo 0:0dee8840a1c0 457 * sends a stop condition and data transmission is stopped.
einsteingustavo 0:0dee8840a1c0 458 *
einsteingustavo 0:0dee8840a1c0 459 * - Slave Transmitter mode:
einsteingustavo 0:0dee8840a1c0 460 * - EV3: When a byte has been transmitted by the slave and the application is expecting
einsteingustavo 0:0dee8840a1c0 461 * the end of the byte transmission. The two events I2C_EVENT_SLAVE_BYTE_TRANSMITTED and
einsteingustavo 0:0dee8840a1c0 462 * I2C_EVENT_SLAVE_BYTE_TRANSMITTING are similar. The second one can optionally be
einsteingustavo 0:0dee8840a1c0 463 * used when the user software doesn't guarantee the EV3 is managed before the
einsteingustavo 0:0dee8840a1c0 464 * current byte end of transfer.
einsteingustavo 0:0dee8840a1c0 465 * - EV3_2: When the master sends a NACK in order to tell slave that data transmission
einsteingustavo 0:0dee8840a1c0 466 * shall end (before sending the STOP condition). In this case slave has to stop sending
einsteingustavo 0:0dee8840a1c0 467 * data bytes and expect a Stop condition on the bus.
einsteingustavo 0:0dee8840a1c0 468 *
einsteingustavo 0:0dee8840a1c0 469 * @note In case the user software does not guarantee that the event EV2 is
einsteingustavo 0:0dee8840a1c0 470 * managed before the current byte end of transfer, then user may check on EV2
einsteingustavo 0:0dee8840a1c0 471 * and BTF flag at the same time (ie. (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_BTF)).
einsteingustavo 0:0dee8840a1c0 472 * In this case the communication may be slower.
einsteingustavo 0:0dee8840a1c0 473 *
einsteingustavo 0:0dee8840a1c0 474 */
einsteingustavo 0:0dee8840a1c0 475
einsteingustavo 0:0dee8840a1c0 476 /* Slave RECEIVER mode --------------------------*/
einsteingustavo 0:0dee8840a1c0 477 /* --EV2 */
einsteingustavo 0:0dee8840a1c0 478 #define I2C_EVENT_SLAVE_BYTE_RECEIVED ((uint32_t)0x00020040) /* BUSY and RXNE flags */
einsteingustavo 0:0dee8840a1c0 479 /* --EV4 */
einsteingustavo 0:0dee8840a1c0 480 #define I2C_EVENT_SLAVE_STOP_DETECTED ((uint32_t)0x00000010) /* STOPF flag */
einsteingustavo 0:0dee8840a1c0 481
einsteingustavo 0:0dee8840a1c0 482 /* Slave TRANSMITTER mode -----------------------*/
einsteingustavo 0:0dee8840a1c0 483 /* --EV3 */
einsteingustavo 0:0dee8840a1c0 484 #define I2C_EVENT_SLAVE_BYTE_TRANSMITTED ((uint32_t)0x00060084) /* TRA, BUSY, TXE and BTF flags */
einsteingustavo 0:0dee8840a1c0 485 #define I2C_EVENT_SLAVE_BYTE_TRANSMITTING ((uint32_t)0x00060080) /* TRA, BUSY and TXE flags */
einsteingustavo 0:0dee8840a1c0 486 /* --EV3_2 */
einsteingustavo 0:0dee8840a1c0 487 #define I2C_EVENT_SLAVE_ACK_FAILURE ((uint32_t)0x00000400) /* AF flag */
einsteingustavo 0:0dee8840a1c0 488
einsteingustavo 0:0dee8840a1c0 489 /*=========================== End of Events Description ==========================================*/
einsteingustavo 0:0dee8840a1c0 490
einsteingustavo 0:0dee8840a1c0 491 #define IS_I2C_EVENT(EVENT) (((EVENT) == I2C_EVENT_SLAVE_TRANSMITTER_ADDRESS_MATCHED) || \
einsteingustavo 0:0dee8840a1c0 492 ((EVENT) == I2C_EVENT_SLAVE_RECEIVER_ADDRESS_MATCHED) || \
einsteingustavo 0:0dee8840a1c0 493 ((EVENT) == I2C_EVENT_SLAVE_TRANSMITTER_SECONDADDRESS_MATCHED) || \
einsteingustavo 0:0dee8840a1c0 494 ((EVENT) == I2C_EVENT_SLAVE_RECEIVER_SECONDADDRESS_MATCHED) || \
einsteingustavo 0:0dee8840a1c0 495 ((EVENT) == I2C_EVENT_SLAVE_GENERALCALLADDRESS_MATCHED) || \
einsteingustavo 0:0dee8840a1c0 496 ((EVENT) == I2C_EVENT_SLAVE_BYTE_RECEIVED) || \
einsteingustavo 0:0dee8840a1c0 497 ((EVENT) == (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_DUALF)) || \
einsteingustavo 0:0dee8840a1c0 498 ((EVENT) == (I2C_EVENT_SLAVE_BYTE_RECEIVED | I2C_FLAG_GENCALL)) || \
einsteingustavo 0:0dee8840a1c0 499 ((EVENT) == I2C_EVENT_SLAVE_BYTE_TRANSMITTED) || \
einsteingustavo 0:0dee8840a1c0 500 ((EVENT) == (I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_DUALF)) || \
einsteingustavo 0:0dee8840a1c0 501 ((EVENT) == (I2C_EVENT_SLAVE_BYTE_TRANSMITTED | I2C_FLAG_GENCALL)) || \
einsteingustavo 0:0dee8840a1c0 502 ((EVENT) == I2C_EVENT_SLAVE_STOP_DETECTED) || \
einsteingustavo 0:0dee8840a1c0 503 ((EVENT) == I2C_EVENT_MASTER_MODE_SELECT) || \
einsteingustavo 0:0dee8840a1c0 504 ((EVENT) == I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED) || \
einsteingustavo 0:0dee8840a1c0 505 ((EVENT) == I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED) || \
einsteingustavo 0:0dee8840a1c0 506 ((EVENT) == I2C_EVENT_MASTER_BYTE_RECEIVED) || \
einsteingustavo 0:0dee8840a1c0 507 ((EVENT) == I2C_EVENT_MASTER_BYTE_TRANSMITTED) || \
einsteingustavo 0:0dee8840a1c0 508 ((EVENT) == I2C_EVENT_MASTER_BYTE_TRANSMITTING) || \
einsteingustavo 0:0dee8840a1c0 509 ((EVENT) == I2C_EVENT_MASTER_MODE_ADDRESS10) || \
einsteingustavo 0:0dee8840a1c0 510 ((EVENT) == I2C_EVENT_SLAVE_ACK_FAILURE))
einsteingustavo 0:0dee8840a1c0 511 /**
einsteingustavo 0:0dee8840a1c0 512 * @}
einsteingustavo 0:0dee8840a1c0 513 */
einsteingustavo 0:0dee8840a1c0 514
einsteingustavo 0:0dee8840a1c0 515 /** @defgroup I2C_own_address1
einsteingustavo 0:0dee8840a1c0 516 * @{
einsteingustavo 0:0dee8840a1c0 517 */
einsteingustavo 0:0dee8840a1c0 518
einsteingustavo 0:0dee8840a1c0 519 #define IS_I2C_OWN_ADDRESS1(ADDRESS1) ((ADDRESS1) <= 0x3FF)
einsteingustavo 0:0dee8840a1c0 520 /**
einsteingustavo 0:0dee8840a1c0 521 * @}
einsteingustavo 0:0dee8840a1c0 522 */
einsteingustavo 0:0dee8840a1c0 523
einsteingustavo 0:0dee8840a1c0 524 /** @defgroup I2C_clock_speed
einsteingustavo 0:0dee8840a1c0 525 * @{
einsteingustavo 0:0dee8840a1c0 526 */
einsteingustavo 0:0dee8840a1c0 527
einsteingustavo 0:0dee8840a1c0 528 #define IS_I2C_CLOCK_SPEED(SPEED) (((SPEED) >= 0x1) && ((SPEED) <= 400000))
einsteingustavo 0:0dee8840a1c0 529 /**
einsteingustavo 0:0dee8840a1c0 530 * @}
einsteingustavo 0:0dee8840a1c0 531 */
einsteingustavo 0:0dee8840a1c0 532
einsteingustavo 0:0dee8840a1c0 533 /**
einsteingustavo 0:0dee8840a1c0 534 * @}
einsteingustavo 0:0dee8840a1c0 535 */
einsteingustavo 0:0dee8840a1c0 536
einsteingustavo 0:0dee8840a1c0 537 /** @defgroup I2C_Exported_Macros
einsteingustavo 0:0dee8840a1c0 538 * @{
einsteingustavo 0:0dee8840a1c0 539 */
einsteingustavo 0:0dee8840a1c0 540
einsteingustavo 0:0dee8840a1c0 541 /**
einsteingustavo 0:0dee8840a1c0 542 * @}
einsteingustavo 0:0dee8840a1c0 543 */
einsteingustavo 0:0dee8840a1c0 544
einsteingustavo 0:0dee8840a1c0 545 /** @defgroup I2C_Exported_Functions
einsteingustavo 0:0dee8840a1c0 546 * @{
einsteingustavo 0:0dee8840a1c0 547 */
einsteingustavo 0:0dee8840a1c0 548
einsteingustavo 0:0dee8840a1c0 549 void I2C_DeInit(I2C_TypeDef* I2Cx);
einsteingustavo 0:0dee8840a1c0 550 void I2C_Init(I2C_TypeDef* I2Cx, I2C_InitTypeDef* I2C_InitStruct);
einsteingustavo 0:0dee8840a1c0 551 void I2C_StructInit(I2C_InitTypeDef* I2C_InitStruct);
einsteingustavo 0:0dee8840a1c0 552 void I2C_Cmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 553 void I2C_DMACmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 554 void I2C_DMALastTransferCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 555 void I2C_GenerateSTART(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 556 void I2C_GenerateSTOP(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 557 void I2C_AcknowledgeConfig(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 558 void I2C_OwnAddress2Config(I2C_TypeDef* I2Cx, uint8_t Address);
einsteingustavo 0:0dee8840a1c0 559 void I2C_DualAddressCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 560 void I2C_GeneralCallCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 561 void I2C_ITConfig(I2C_TypeDef* I2Cx, uint16_t I2C_IT, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 562 void I2C_SendData(I2C_TypeDef* I2Cx, uint8_t Data);
einsteingustavo 0:0dee8840a1c0 563 uint8_t I2C_ReceiveData(I2C_TypeDef* I2Cx);
einsteingustavo 0:0dee8840a1c0 564 void I2C_Send7bitAddress(I2C_TypeDef* I2Cx, uint8_t Address, uint8_t I2C_Direction);
einsteingustavo 0:0dee8840a1c0 565 uint16_t I2C_ReadRegister(I2C_TypeDef* I2Cx, uint8_t I2C_Register);
einsteingustavo 0:0dee8840a1c0 566 void I2C_SoftwareResetCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 567 void I2C_NACKPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_NACKPosition);
einsteingustavo 0:0dee8840a1c0 568 void I2C_SMBusAlertConfig(I2C_TypeDef* I2Cx, uint16_t I2C_SMBusAlert);
einsteingustavo 0:0dee8840a1c0 569 void I2C_TransmitPEC(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 570 void I2C_PECPositionConfig(I2C_TypeDef* I2Cx, uint16_t I2C_PECPosition);
einsteingustavo 0:0dee8840a1c0 571 void I2C_CalculatePEC(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 572 uint8_t I2C_GetPEC(I2C_TypeDef* I2Cx);
einsteingustavo 0:0dee8840a1c0 573 void I2C_ARPCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 574 void I2C_StretchClockCmd(I2C_TypeDef* I2Cx, FunctionalState NewState);
einsteingustavo 0:0dee8840a1c0 575 void I2C_FastModeDutyCycleConfig(I2C_TypeDef* I2Cx, uint16_t I2C_DutyCycle);
einsteingustavo 0:0dee8840a1c0 576
einsteingustavo 0:0dee8840a1c0 577 /**
einsteingustavo 0:0dee8840a1c0 578 * @brief
einsteingustavo 0:0dee8840a1c0 579 ****************************************************************************************
einsteingustavo 0:0dee8840a1c0 580 *
einsteingustavo 0:0dee8840a1c0 581 * I2C State Monitoring Functions
einsteingustavo 0:0dee8840a1c0 582 *
einsteingustavo 0:0dee8840a1c0 583 ****************************************************************************************
einsteingustavo 0:0dee8840a1c0 584 * This I2C driver provides three different ways for I2C state monitoring
einsteingustavo 0:0dee8840a1c0 585 * depending on the application requirements and constraints:
einsteingustavo 0:0dee8840a1c0 586 *
einsteingustavo 0:0dee8840a1c0 587 *
einsteingustavo 0:0dee8840a1c0 588 * 1) Basic state monitoring:
einsteingustavo 0:0dee8840a1c0 589 * Using I2C_CheckEvent() function:
einsteingustavo 0:0dee8840a1c0 590 * It compares the status registers (SR1 and SR2) content to a given event
einsteingustavo 0:0dee8840a1c0 591 * (can be the combination of one or more flags).
einsteingustavo 0:0dee8840a1c0 592 * It returns SUCCESS if the current status includes the given flags
einsteingustavo 0:0dee8840a1c0 593 * and returns ERROR if one or more flags are missing in the current status.
einsteingustavo 0:0dee8840a1c0 594 * - When to use:
einsteingustavo 0:0dee8840a1c0 595 * - This function is suitable for most applications as well as for startup
einsteingustavo 0:0dee8840a1c0 596 * activity since the events are fully described in the product reference manual
einsteingustavo 0:0dee8840a1c0 597 * (RM0008).
einsteingustavo 0:0dee8840a1c0 598 * - It is also suitable for users who need to define their own events.
einsteingustavo 0:0dee8840a1c0 599 * - Limitations:
einsteingustavo 0:0dee8840a1c0 600 * - If an error occurs (ie. error flags are set besides to the monitored flags),
einsteingustavo 0:0dee8840a1c0 601 * the I2C_CheckEvent() function may return SUCCESS despite the communication
einsteingustavo 0:0dee8840a1c0 602 * hold or corrupted real state.
einsteingustavo 0:0dee8840a1c0 603 * In this case, it is advised to use error interrupts to monitor the error
einsteingustavo 0:0dee8840a1c0 604 * events and handle them in the interrupt IRQ handler.
einsteingustavo 0:0dee8840a1c0 605 *
einsteingustavo 0:0dee8840a1c0 606 * @note
einsteingustavo 0:0dee8840a1c0 607 * For error management, it is advised to use the following functions:
einsteingustavo 0:0dee8840a1c0 608 * - I2C_ITConfig() to configure and enable the error interrupts (I2C_IT_ERR).
einsteingustavo 0:0dee8840a1c0 609 * - I2Cx_ER_IRQHandler() which is called when the error interrupt occurs.
einsteingustavo 0:0dee8840a1c0 610 * Where x is the peripheral instance (I2C1, I2C2 ...)
einsteingustavo 0:0dee8840a1c0 611 * - I2C_GetFlagStatus() or I2C_GetITStatus() to be called into I2Cx_ER_IRQHandler()
einsteingustavo 0:0dee8840a1c0 612 * in order to determine which error occurred.
einsteingustavo 0:0dee8840a1c0 613 * - I2C_ClearFlag() or I2C_ClearITPendingBit() and/or I2C_SoftwareResetCmd()
einsteingustavo 0:0dee8840a1c0 614 * and/or I2C_GenerateStop() in order to clear the error flag and source,
einsteingustavo 0:0dee8840a1c0 615 * and return to correct communication status.
einsteingustavo 0:0dee8840a1c0 616 *
einsteingustavo 0:0dee8840a1c0 617 *
einsteingustavo 0:0dee8840a1c0 618 * 2) Advanced state monitoring:
einsteingustavo 0:0dee8840a1c0 619 * Using the function I2C_GetLastEvent() which returns the image of both status
einsteingustavo 0:0dee8840a1c0 620 * registers in a single word (uint32_t) (Status Register 2 value is shifted left
einsteingustavo 0:0dee8840a1c0 621 * by 16 bits and concatenated to Status Register 1).
einsteingustavo 0:0dee8840a1c0 622 * - When to use:
einsteingustavo 0:0dee8840a1c0 623 * - This function is suitable for the same applications above but it allows to
einsteingustavo 0:0dee8840a1c0 624 * overcome the limitations of I2C_GetFlagStatus() function (see below).
einsteingustavo 0:0dee8840a1c0 625 * The returned value could be compared to events already defined in the
einsteingustavo 0:0dee8840a1c0 626 * library (stm32f10x_i2c.h) or to custom values defined by user.
einsteingustavo 0:0dee8840a1c0 627 * - This function is suitable when multiple flags are monitored at the same time.
einsteingustavo 0:0dee8840a1c0 628 * - At the opposite of I2C_CheckEvent() function, this function allows user to
einsteingustavo 0:0dee8840a1c0 629 * choose when an event is accepted (when all events flags are set and no
einsteingustavo 0:0dee8840a1c0 630 * other flags are set or just when the needed flags are set like
einsteingustavo 0:0dee8840a1c0 631 * I2C_CheckEvent() function).
einsteingustavo 0:0dee8840a1c0 632 * - Limitations:
einsteingustavo 0:0dee8840a1c0 633 * - User may need to define his own events.
einsteingustavo 0:0dee8840a1c0 634 * - Same remark concerning the error management is applicable for this
einsteingustavo 0:0dee8840a1c0 635 * function if user decides to check only regular communication flags (and
einsteingustavo 0:0dee8840a1c0 636 * ignores error flags).
einsteingustavo 0:0dee8840a1c0 637 *
einsteingustavo 0:0dee8840a1c0 638 *
einsteingustavo 0:0dee8840a1c0 639 * 3) Flag-based state monitoring:
einsteingustavo 0:0dee8840a1c0 640 * Using the function I2C_GetFlagStatus() which simply returns the status of
einsteingustavo 0:0dee8840a1c0 641 * one single flag (ie. I2C_FLAG_RXNE ...).
einsteingustavo 0:0dee8840a1c0 642 * - When to use:
einsteingustavo 0:0dee8840a1c0 643 * - This function could be used for specific applications or in debug phase.
einsteingustavo 0:0dee8840a1c0 644 * - It is suitable when only one flag checking is needed (most I2C events
einsteingustavo 0:0dee8840a1c0 645 * are monitored through multiple flags).
einsteingustavo 0:0dee8840a1c0 646 * - Limitations:
einsteingustavo 0:0dee8840a1c0 647 * - When calling this function, the Status register is accessed. Some flags are
einsteingustavo 0:0dee8840a1c0 648 * cleared when the status register is accessed. So checking the status
einsteingustavo 0:0dee8840a1c0 649 * of one Flag, may clear other ones.
einsteingustavo 0:0dee8840a1c0 650 * - Function may need to be called twice or more in order to monitor one
einsteingustavo 0:0dee8840a1c0 651 * single event.
einsteingustavo 0:0dee8840a1c0 652 *
einsteingustavo 0:0dee8840a1c0 653 */
einsteingustavo 0:0dee8840a1c0 654
einsteingustavo 0:0dee8840a1c0 655 /**
einsteingustavo 0:0dee8840a1c0 656 *
einsteingustavo 0:0dee8840a1c0 657 * 1) Basic state monitoring
einsteingustavo 0:0dee8840a1c0 658 *******************************************************************************
einsteingustavo 0:0dee8840a1c0 659 */
einsteingustavo 0:0dee8840a1c0 660 ErrorStatus I2C_CheckEvent(I2C_TypeDef* I2Cx, uint32_t I2C_EVENT);
einsteingustavo 0:0dee8840a1c0 661 /**
einsteingustavo 0:0dee8840a1c0 662 *
einsteingustavo 0:0dee8840a1c0 663 * 2) Advanced state monitoring
einsteingustavo 0:0dee8840a1c0 664 *******************************************************************************
einsteingustavo 0:0dee8840a1c0 665 */
einsteingustavo 0:0dee8840a1c0 666 uint32_t I2C_GetLastEvent(I2C_TypeDef* I2Cx);
einsteingustavo 0:0dee8840a1c0 667 /**
einsteingustavo 0:0dee8840a1c0 668 *
einsteingustavo 0:0dee8840a1c0 669 * 3) Flag-based state monitoring
einsteingustavo 0:0dee8840a1c0 670 *******************************************************************************
einsteingustavo 0:0dee8840a1c0 671 */
einsteingustavo 0:0dee8840a1c0 672 FlagStatus I2C_GetFlagStatus(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG);
einsteingustavo 0:0dee8840a1c0 673 /**
einsteingustavo 0:0dee8840a1c0 674 *
einsteingustavo 0:0dee8840a1c0 675 *******************************************************************************
einsteingustavo 0:0dee8840a1c0 676 */
einsteingustavo 0:0dee8840a1c0 677
einsteingustavo 0:0dee8840a1c0 678 void I2C_ClearFlag(I2C_TypeDef* I2Cx, uint32_t I2C_FLAG);
einsteingustavo 0:0dee8840a1c0 679 ITStatus I2C_GetITStatus(I2C_TypeDef* I2Cx, uint32_t I2C_IT);
einsteingustavo 0:0dee8840a1c0 680 void I2C_ClearITPendingBit(I2C_TypeDef* I2Cx, uint32_t I2C_IT);
einsteingustavo 0:0dee8840a1c0 681
einsteingustavo 0:0dee8840a1c0 682 #ifdef __cplusplus
einsteingustavo 0:0dee8840a1c0 683 }
einsteingustavo 0:0dee8840a1c0 684 #endif
einsteingustavo 0:0dee8840a1c0 685
einsteingustavo 0:0dee8840a1c0 686 #endif /*__STM32F10x_I2C_H */
einsteingustavo 0:0dee8840a1c0 687 /**
einsteingustavo 0:0dee8840a1c0 688 * @}
einsteingustavo 0:0dee8840a1c0 689 */
einsteingustavo 0:0dee8840a1c0 690
einsteingustavo 0:0dee8840a1c0 691 /**
einsteingustavo 0:0dee8840a1c0 692 * @}
einsteingustavo 0:0dee8840a1c0 693 */
einsteingustavo 0:0dee8840a1c0 694
einsteingustavo 0:0dee8840a1c0 695 /**
einsteingustavo 0:0dee8840a1c0 696 * @}
einsteingustavo 0:0dee8840a1c0 697 */
einsteingustavo 0:0dee8840a1c0 698
einsteingustavo 0:0dee8840a1c0 699 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
einsteingustavo 0:0dee8840a1c0 700