Senior Design: Sound Monitor / STM32L4xx_HAL_Driver

L4 HAL Drivers

Inc/stm32l4xx_hal_i2c.h@0:80ee8f3b695e, 2015-11-02 (annotated)

Committer:
EricLew
Date:
Mon Nov 02 19:37:23 2015 +0000
Revision:
0:80ee8f3b695e
Errors are with definitions of LCD and QSPI functions. I believe all .h and .c files are  uploaded, but there may need to be certain functions called.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
EricLew 0:80ee8f3b695e 1 /**
EricLew 0:80ee8f3b695e 2 ******************************************************************************
EricLew 0:80ee8f3b695e 3 * @file stm32l4xx_hal_i2c.h
EricLew 0:80ee8f3b695e 4 * @author MCD Application Team
EricLew 0:80ee8f3b695e 5 * @version V1.1.0
EricLew 0:80ee8f3b695e 6 * @date 16-September-2015
EricLew 0:80ee8f3b695e 7 * @brief Header file of I2C HAL module.
EricLew 0:80ee8f3b695e 8 ******************************************************************************
EricLew 0:80ee8f3b695e 9 * @attention
EricLew 0:80ee8f3b695e 10 *
EricLew 0:80ee8f3b695e 11 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
EricLew 0:80ee8f3b695e 12 *
EricLew 0:80ee8f3b695e 13 * Redistribution and use in source and binary forms, with or without modification,
EricLew 0:80ee8f3b695e 14 * are permitted provided that the following conditions are met:
EricLew 0:80ee8f3b695e 15 * 1. Redistributions of source code must retain the above copyright notice,
EricLew 0:80ee8f3b695e 16 * this list of conditions and the following disclaimer.
EricLew 0:80ee8f3b695e 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
EricLew 0:80ee8f3b695e 18 * this list of conditions and the following disclaimer in the documentation
EricLew 0:80ee8f3b695e 19 * and/or other materials provided with the distribution.
EricLew 0:80ee8f3b695e 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
EricLew 0:80ee8f3b695e 21 * may be used to endorse or promote products derived from this software
EricLew 0:80ee8f3b695e 22 * without specific prior written permission.
EricLew 0:80ee8f3b695e 23 *
EricLew 0:80ee8f3b695e 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
EricLew 0:80ee8f3b695e 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
EricLew 0:80ee8f3b695e 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
EricLew 0:80ee8f3b695e 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
EricLew 0:80ee8f3b695e 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
EricLew 0:80ee8f3b695e 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
EricLew 0:80ee8f3b695e 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
EricLew 0:80ee8f3b695e 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
EricLew 0:80ee8f3b695e 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
EricLew 0:80ee8f3b695e 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
EricLew 0:80ee8f3b695e 34 *
EricLew 0:80ee8f3b695e 35 ******************************************************************************
EricLew 0:80ee8f3b695e 36 */
EricLew 0:80ee8f3b695e 37
EricLew 0:80ee8f3b695e 38 /* Define to prevent recursive inclusion -------------------------------------*/
EricLew 0:80ee8f3b695e 39 #ifndef __STM32L4xx_HAL_I2C_H
EricLew 0:80ee8f3b695e 40 #define __STM32L4xx_HAL_I2C_H
EricLew 0:80ee8f3b695e 41
EricLew 0:80ee8f3b695e 42 #ifdef __cplusplus
EricLew 0:80ee8f3b695e 43 extern "C" {
EricLew 0:80ee8f3b695e 44 #endif
EricLew 0:80ee8f3b695e 45
EricLew 0:80ee8f3b695e 46 /* Includes ------------------------------------------------------------------*/
EricLew 0:80ee8f3b695e 47 #include "stm32l4xx_hal_def.h"
EricLew 0:80ee8f3b695e 48
EricLew 0:80ee8f3b695e 49 /** @addtogroup STM32L4xx_HAL_Driver
EricLew 0:80ee8f3b695e 50 * @{
EricLew 0:80ee8f3b695e 51 */
EricLew 0:80ee8f3b695e 52
EricLew 0:80ee8f3b695e 53 /** @addtogroup I2C
EricLew 0:80ee8f3b695e 54 * @{
EricLew 0:80ee8f3b695e 55 */
EricLew 0:80ee8f3b695e 56
EricLew 0:80ee8f3b695e 57 /* Exported types ------------------------------------------------------------*/
EricLew 0:80ee8f3b695e 58 /** @defgroup I2C_Exported_Types I2C Exported Types
EricLew 0:80ee8f3b695e 59 * @{
EricLew 0:80ee8f3b695e 60 */
EricLew 0:80ee8f3b695e 61
EricLew 0:80ee8f3b695e 62 /** @defgroup I2C_Configuration_Structure_definition I2C Configuration Structure definition
EricLew 0:80ee8f3b695e 63 * @brief I2C Configuration Structure definition
EricLew 0:80ee8f3b695e 64 * @{
EricLew 0:80ee8f3b695e 65 */
EricLew 0:80ee8f3b695e 66 typedef struct
EricLew 0:80ee8f3b695e 67 {
EricLew 0:80ee8f3b695e 68 uint32_t Timing; /*!< Specifies the I2C_TIMINGR_register value.
EricLew 0:80ee8f3b695e 69 This parameter calculated by referring to I2C initialization
EricLew 0:80ee8f3b695e 70 section in Reference manual */
EricLew 0:80ee8f3b695e 71
EricLew 0:80ee8f3b695e 72 uint32_t OwnAddress1; /*!< Specifies the first device own address.
EricLew 0:80ee8f3b695e 73 This parameter can be a 7-bit or 10-bit address. */
EricLew 0:80ee8f3b695e 74
EricLew 0:80ee8f3b695e 75 uint32_t AddressingMode; /*!< Specifies if 7-bit or 10-bit addressing mode is selected.
EricLew 0:80ee8f3b695e 76 This parameter can be a value of @ref I2C_addressing_mode */
EricLew 0:80ee8f3b695e 77
EricLew 0:80ee8f3b695e 78 uint32_t DualAddressMode; /*!< Specifies if dual addressing mode is selected.
EricLew 0:80ee8f3b695e 79 This parameter can be a value of @ref I2C_dual_addressing_mode */
EricLew 0:80ee8f3b695e 80
EricLew 0:80ee8f3b695e 81 uint32_t OwnAddress2; /*!< Specifies the second device own address if dual addressing mode is selected
EricLew 0:80ee8f3b695e 82 This parameter can be a 7-bit address. */
EricLew 0:80ee8f3b695e 83
EricLew 0:80ee8f3b695e 84 uint32_t OwnAddress2Masks; /*!< Specifies the acknowledge mask address second device own address if dual addressing mode is selected
EricLew 0:80ee8f3b695e 85 This parameter can be a value of @ref I2C_own_address2_masks */
EricLew 0:80ee8f3b695e 86
EricLew 0:80ee8f3b695e 87 uint32_t GeneralCallMode; /*!< Specifies if general call mode is selected.
EricLew 0:80ee8f3b695e 88 This parameter can be a value of @ref I2C_general_call_addressing_mode */
EricLew 0:80ee8f3b695e 89
EricLew 0:80ee8f3b695e 90 uint32_t NoStretchMode; /*!< Specifies if nostretch mode is selected.
EricLew 0:80ee8f3b695e 91 This parameter can be a value of @ref I2C_nostretch_mode */
EricLew 0:80ee8f3b695e 92
EricLew 0:80ee8f3b695e 93 }I2C_InitTypeDef;
EricLew 0:80ee8f3b695e 94
EricLew 0:80ee8f3b695e 95 /**
EricLew 0:80ee8f3b695e 96 * @}
EricLew 0:80ee8f3b695e 97 */
EricLew 0:80ee8f3b695e 98
EricLew 0:80ee8f3b695e 99 /** @defgroup HAL_state_structure_definition HAL state structure definition
EricLew 0:80ee8f3b695e 100 * @brief HAL State structure definition
EricLew 0:80ee8f3b695e 101 * @{
EricLew 0:80ee8f3b695e 102 */
EricLew 0:80ee8f3b695e 103
EricLew 0:80ee8f3b695e 104 typedef enum
EricLew 0:80ee8f3b695e 105 {
EricLew 0:80ee8f3b695e 106 HAL_I2C_STATE_RESET = 0x00, /*!< I2C not yet initialized or disabled */
EricLew 0:80ee8f3b695e 107 HAL_I2C_STATE_READY = 0x01, /*!< I2C initialized and ready for use */
EricLew 0:80ee8f3b695e 108 HAL_I2C_STATE_BUSY = 0x02, /*!< I2C internal process is ongoing */
EricLew 0:80ee8f3b695e 109 HAL_I2C_STATE_MASTER_BUSY_TX = 0x12, /*!< Master Data Transmission process is ongoing */
EricLew 0:80ee8f3b695e 110 HAL_I2C_STATE_MASTER_BUSY_RX = 0x22, /*!< Master Data Reception process is ongoing */
EricLew 0:80ee8f3b695e 111 HAL_I2C_STATE_SLAVE_BUSY_TX = 0x32, /*!< Slave Data Transmission process is ongoing */
EricLew 0:80ee8f3b695e 112 HAL_I2C_STATE_SLAVE_BUSY_RX = 0x42, /*!< Slave Data Reception process is ongoing */
EricLew 0:80ee8f3b695e 113 HAL_I2C_STATE_MEM_BUSY_TX = 0x52, /*!< Memory Data Transmission process is ongoing */
EricLew 0:80ee8f3b695e 114 HAL_I2C_STATE_MEM_BUSY_RX = 0x62, /*!< Memory Data Reception process is ongoing */
EricLew 0:80ee8f3b695e 115 HAL_I2C_STATE_TIMEOUT = 0x03, /*!< Timeout state */
EricLew 0:80ee8f3b695e 116 HAL_I2C_STATE_ERROR = 0x04 /*!< Reception process is ongoing */
EricLew 0:80ee8f3b695e 117 }HAL_I2C_StateTypeDef;
EricLew 0:80ee8f3b695e 118
EricLew 0:80ee8f3b695e 119 /**
EricLew 0:80ee8f3b695e 120 * @}
EricLew 0:80ee8f3b695e 121 */
EricLew 0:80ee8f3b695e 122
EricLew 0:80ee8f3b695e 123 /** @defgroup I2C_Error_Code_definition I2C Error Code definition
EricLew 0:80ee8f3b695e 124 * @brief I2C Error Code definition
EricLew 0:80ee8f3b695e 125 * @{
EricLew 0:80ee8f3b695e 126 */
EricLew 0:80ee8f3b695e 127 #define HAL_I2C_ERROR_NONE ((uint32_t)0x00000000) /*!< No error */
EricLew 0:80ee8f3b695e 128 #define HAL_I2C_ERROR_BERR ((uint32_t)0x00000001) /*!< BERR error */
EricLew 0:80ee8f3b695e 129 #define HAL_I2C_ERROR_ARLO ((uint32_t)0x00000002) /*!< ARLO error */
EricLew 0:80ee8f3b695e 130 #define HAL_I2C_ERROR_AF ((uint32_t)0x00000004) /*!< ACKF error */
EricLew 0:80ee8f3b695e 131 #define HAL_I2C_ERROR_OVR ((uint32_t)0x00000008) /*!< OVR error */
EricLew 0:80ee8f3b695e 132 #define HAL_I2C_ERROR_DMA ((uint32_t)0x00000010) /*!< DMA transfer error */
EricLew 0:80ee8f3b695e 133 #define HAL_I2C_ERROR_TIMEOUT ((uint32_t)0x00000020) /*!< Timeout error */
EricLew 0:80ee8f3b695e 134 #define HAL_I2C_ERROR_SIZE ((uint32_t)0x00000040) /*!< Size Management error */
EricLew 0:80ee8f3b695e 135 /**
EricLew 0:80ee8f3b695e 136 * @}
EricLew 0:80ee8f3b695e 137 */
EricLew 0:80ee8f3b695e 138
EricLew 0:80ee8f3b695e 139 /** @defgroup I2C_handle_Structure_definition I2C handle Structure definition
EricLew 0:80ee8f3b695e 140 * @brief I2C handle Structure definition
EricLew 0:80ee8f3b695e 141 * @{
EricLew 0:80ee8f3b695e 142 */
EricLew 0:80ee8f3b695e 143 typedef struct
EricLew 0:80ee8f3b695e 144 {
EricLew 0:80ee8f3b695e 145 I2C_TypeDef *Instance; /*!< I2C registers base address */
EricLew 0:80ee8f3b695e 146
EricLew 0:80ee8f3b695e 147 I2C_InitTypeDef Init; /*!< I2C communication parameters */
EricLew 0:80ee8f3b695e 148
EricLew 0:80ee8f3b695e 149 uint8_t *pBuffPtr; /*!< Pointer to I2C transfer buffer */
EricLew 0:80ee8f3b695e 150
EricLew 0:80ee8f3b695e 151 uint16_t XferSize; /*!< I2C transfer size */
EricLew 0:80ee8f3b695e 152
EricLew 0:80ee8f3b695e 153 __IO uint16_t XferCount; /*!< I2C transfer counter */
EricLew 0:80ee8f3b695e 154
EricLew 0:80ee8f3b695e 155 DMA_HandleTypeDef *hdmatx; /*!< I2C Tx DMA handle parameters */
EricLew 0:80ee8f3b695e 156
EricLew 0:80ee8f3b695e 157 DMA_HandleTypeDef *hdmarx; /*!< I2C Rx DMA handle parameters */
EricLew 0:80ee8f3b695e 158
EricLew 0:80ee8f3b695e 159 HAL_LockTypeDef Lock; /*!< I2C locking object */
EricLew 0:80ee8f3b695e 160
EricLew 0:80ee8f3b695e 161 __IO HAL_I2C_StateTypeDef State; /*!< I2C communication state */
EricLew 0:80ee8f3b695e 162
EricLew 0:80ee8f3b695e 163 __IO uint32_t ErrorCode; /* I2C Error code */
EricLew 0:80ee8f3b695e 164
EricLew 0:80ee8f3b695e 165 }I2C_HandleTypeDef;
EricLew 0:80ee8f3b695e 166 /**
EricLew 0:80ee8f3b695e 167 * @}
EricLew 0:80ee8f3b695e 168 */
EricLew 0:80ee8f3b695e 169
EricLew 0:80ee8f3b695e 170 /**
EricLew 0:80ee8f3b695e 171 * @}
EricLew 0:80ee8f3b695e 172 */
EricLew 0:80ee8f3b695e 173 /* Exported constants --------------------------------------------------------*/
EricLew 0:80ee8f3b695e 174
EricLew 0:80ee8f3b695e 175 /** @defgroup I2C_Exported_Constants I2C Exported Constants
EricLew 0:80ee8f3b695e 176 * @{
EricLew 0:80ee8f3b695e 177 */
EricLew 0:80ee8f3b695e 178
EricLew 0:80ee8f3b695e 179 /** @defgroup I2C_addressing_mode I2C addressing mode
EricLew 0:80ee8f3b695e 180 * @{
EricLew 0:80ee8f3b695e 181 */
EricLew 0:80ee8f3b695e 182 #define I2C_ADDRESSINGMODE_7BIT ((uint32_t)0x00000001)
EricLew 0:80ee8f3b695e 183 #define I2C_ADDRESSINGMODE_10BIT ((uint32_t)0x00000002)
EricLew 0:80ee8f3b695e 184 /**
EricLew 0:80ee8f3b695e 185 * @}
EricLew 0:80ee8f3b695e 186 */
EricLew 0:80ee8f3b695e 187
EricLew 0:80ee8f3b695e 188 /** @defgroup I2C_dual_addressing_mode I2C dual addressing mode
EricLew 0:80ee8f3b695e 189 * @{
EricLew 0:80ee8f3b695e 190 */
EricLew 0:80ee8f3b695e 191 #define I2C_DUALADDRESS_DISABLE ((uint32_t)0x00000000)
EricLew 0:80ee8f3b695e 192 #define I2C_DUALADDRESS_ENABLE I2C_OAR2_OA2EN
EricLew 0:80ee8f3b695e 193 /**
EricLew 0:80ee8f3b695e 194 * @}
EricLew 0:80ee8f3b695e 195 */
EricLew 0:80ee8f3b695e 196
EricLew 0:80ee8f3b695e 197 /** @defgroup I2C_own_address2_masks I2C own address2 masks
EricLew 0:80ee8f3b695e 198 * @{
EricLew 0:80ee8f3b695e 199 */
EricLew 0:80ee8f3b695e 200 #define I2C_OA2_NOMASK ((uint8_t)0x00)
EricLew 0:80ee8f3b695e 201 #define I2C_OA2_MASK01 ((uint8_t)0x01)
EricLew 0:80ee8f3b695e 202 #define I2C_OA2_MASK02 ((uint8_t)0x02)
EricLew 0:80ee8f3b695e 203 #define I2C_OA2_MASK03 ((uint8_t)0x03)
EricLew 0:80ee8f3b695e 204 #define I2C_OA2_MASK04 ((uint8_t)0x04)
EricLew 0:80ee8f3b695e 205 #define I2C_OA2_MASK05 ((uint8_t)0x05)
EricLew 0:80ee8f3b695e 206 #define I2C_OA2_MASK06 ((uint8_t)0x06)
EricLew 0:80ee8f3b695e 207 #define I2C_OA2_MASK07 ((uint8_t)0x07)
EricLew 0:80ee8f3b695e 208 /**
EricLew 0:80ee8f3b695e 209 * @}
EricLew 0:80ee8f3b695e 210 */
EricLew 0:80ee8f3b695e 211
EricLew 0:80ee8f3b695e 212 /** @defgroup I2C_general_call_addressing_mode I2C general call addressing mode
EricLew 0:80ee8f3b695e 213 * @{
EricLew 0:80ee8f3b695e 214 */
EricLew 0:80ee8f3b695e 215 #define I2C_GENERALCALL_DISABLE ((uint32_t)0x00000000)
EricLew 0:80ee8f3b695e 216 #define I2C_GENERALCALL_ENABLE I2C_CR1_GCEN
EricLew 0:80ee8f3b695e 217 /**
EricLew 0:80ee8f3b695e 218 * @}
EricLew 0:80ee8f3b695e 219 */
EricLew 0:80ee8f3b695e 220
EricLew 0:80ee8f3b695e 221 /** @defgroup I2C_nostretch_mode I2C nostretch mode
EricLew 0:80ee8f3b695e 222 * @{
EricLew 0:80ee8f3b695e 223 */
EricLew 0:80ee8f3b695e 224 #define I2C_NOSTRETCH_DISABLE ((uint32_t)0x00000000)
EricLew 0:80ee8f3b695e 225 #define I2C_NOSTRETCH_ENABLE I2C_CR1_NOSTRETCH
EricLew 0:80ee8f3b695e 226 /**
EricLew 0:80ee8f3b695e 227 * @}
EricLew 0:80ee8f3b695e 228 */
EricLew 0:80ee8f3b695e 229
EricLew 0:80ee8f3b695e 230 /** @defgroup I2C_Memory_Address_Size I2C Memory Address Size
EricLew 0:80ee8f3b695e 231 * @{
EricLew 0:80ee8f3b695e 232 */
EricLew 0:80ee8f3b695e 233 #define I2C_MEMADD_SIZE_8BIT ((uint32_t)0x00000001)
EricLew 0:80ee8f3b695e 234 #define I2C_MEMADD_SIZE_16BIT ((uint32_t)0x00000002)
EricLew 0:80ee8f3b695e 235 /**
EricLew 0:80ee8f3b695e 236 * @}
EricLew 0:80ee8f3b695e 237 */
EricLew 0:80ee8f3b695e 238
EricLew 0:80ee8f3b695e 239 /** @defgroup I2C_ReloadEndMode_definition I2C ReloadEndMode definition
EricLew 0:80ee8f3b695e 240 * @{
EricLew 0:80ee8f3b695e 241 */
EricLew 0:80ee8f3b695e 242 #define I2C_RELOAD_MODE I2C_CR2_RELOAD
EricLew 0:80ee8f3b695e 243 #define I2C_AUTOEND_MODE I2C_CR2_AUTOEND
EricLew 0:80ee8f3b695e 244 #define I2C_SOFTEND_MODE ((uint32_t)0x00000000)
EricLew 0:80ee8f3b695e 245 /**
EricLew 0:80ee8f3b695e 246 * @}
EricLew 0:80ee8f3b695e 247 */
EricLew 0:80ee8f3b695e 248
EricLew 0:80ee8f3b695e 249 /** @defgroup I2C_StartStopMode_definition I2C StartStopMode definition
EricLew 0:80ee8f3b695e 250 * @{
EricLew 0:80ee8f3b695e 251 */
EricLew 0:80ee8f3b695e 252 #define I2C_NO_STARTSTOP ((uint32_t)0x00000000)
EricLew 0:80ee8f3b695e 253 #define I2C_GENERATE_STOP I2C_CR2_STOP
EricLew 0:80ee8f3b695e 254 #define I2C_GENERATE_START_READ (uint32_t)(I2C_CR2_START | I2C_CR2_RD_WRN)
EricLew 0:80ee8f3b695e 255 #define I2C_GENERATE_START_WRITE I2C_CR2_START
EricLew 0:80ee8f3b695e 256 /**
EricLew 0:80ee8f3b695e 257 * @}
EricLew 0:80ee8f3b695e 258 */
EricLew 0:80ee8f3b695e 259
EricLew 0:80ee8f3b695e 260 /** @defgroup I2C_Interrupt_configuration_definition I2C Interrupt configuration definition
EricLew 0:80ee8f3b695e 261 * @brief I2C Interrupt definition
EricLew 0:80ee8f3b695e 262 * Elements values convention: 0xXXXXXXXX
EricLew 0:80ee8f3b695e 263 * - XXXXXXXX : Interrupt control mask
EricLew 0:80ee8f3b695e 264 * @{
EricLew 0:80ee8f3b695e 265 */
EricLew 0:80ee8f3b695e 266 #define I2C_IT_ERRI I2C_CR1_ERRIE
EricLew 0:80ee8f3b695e 267 #define I2C_IT_TCI I2C_CR1_TCIE
EricLew 0:80ee8f3b695e 268 #define I2C_IT_STOPI I2C_CR1_STOPIE
EricLew 0:80ee8f3b695e 269 #define I2C_IT_NACKI I2C_CR1_NACKIE
EricLew 0:80ee8f3b695e 270 #define I2C_IT_ADDRI I2C_CR1_ADDRIE
EricLew 0:80ee8f3b695e 271 #define I2C_IT_RXI I2C_CR1_RXIE
EricLew 0:80ee8f3b695e 272 #define I2C_IT_TXI I2C_CR1_TXIE
EricLew 0:80ee8f3b695e 273
EricLew 0:80ee8f3b695e 274 /**
EricLew 0:80ee8f3b695e 275 * @}
EricLew 0:80ee8f3b695e 276 */
EricLew 0:80ee8f3b695e 277
EricLew 0:80ee8f3b695e 278
EricLew 0:80ee8f3b695e 279 /** @defgroup I2C_Flag_definition I2C Flag definition
EricLew 0:80ee8f3b695e 280 * @{
EricLew 0:80ee8f3b695e 281 */
EricLew 0:80ee8f3b695e 282 #define I2C_FLAG_TXE I2C_ISR_TXE
EricLew 0:80ee8f3b695e 283 #define I2C_FLAG_TXIS I2C_ISR_TXIS
EricLew 0:80ee8f3b695e 284 #define I2C_FLAG_RXNE I2C_ISR_RXNE
EricLew 0:80ee8f3b695e 285 #define I2C_FLAG_ADDR I2C_ISR_ADDR
EricLew 0:80ee8f3b695e 286 #define I2C_FLAG_AF I2C_ISR_NACKF
EricLew 0:80ee8f3b695e 287 #define I2C_FLAG_STOPF I2C_ISR_STOPF
EricLew 0:80ee8f3b695e 288 #define I2C_FLAG_TC I2C_ISR_TC
EricLew 0:80ee8f3b695e 289 #define I2C_FLAG_TCR I2C_ISR_TCR
EricLew 0:80ee8f3b695e 290 #define I2C_FLAG_BERR I2C_ISR_BERR
EricLew 0:80ee8f3b695e 291 #define I2C_FLAG_ARLO I2C_ISR_ARLO
EricLew 0:80ee8f3b695e 292 #define I2C_FLAG_OVR I2C_ISR_OVR
EricLew 0:80ee8f3b695e 293 #define I2C_FLAG_PECERR I2C_ISR_PECERR
EricLew 0:80ee8f3b695e 294 #define I2C_FLAG_TIMEOUT I2C_ISR_TIMEOUT
EricLew 0:80ee8f3b695e 295 #define I2C_FLAG_ALERT I2C_ISR_ALERT
EricLew 0:80ee8f3b695e 296 #define I2C_FLAG_BUSY I2C_ISR_BUSY
EricLew 0:80ee8f3b695e 297 #define I2C_FLAG_DIR I2C_ISR_DIR
EricLew 0:80ee8f3b695e 298 /**
EricLew 0:80ee8f3b695e 299 * @}
EricLew 0:80ee8f3b695e 300 */
EricLew 0:80ee8f3b695e 301
EricLew 0:80ee8f3b695e 302 /**
EricLew 0:80ee8f3b695e 303 * @}
EricLew 0:80ee8f3b695e 304 */
EricLew 0:80ee8f3b695e 305
EricLew 0:80ee8f3b695e 306 /* Exported macros -----------------------------------------------------------*/
EricLew 0:80ee8f3b695e 307
EricLew 0:80ee8f3b695e 308 /** @defgroup I2C_Exported_Macros I2C Exported Macros
EricLew 0:80ee8f3b695e 309 * @{
EricLew 0:80ee8f3b695e 310 */
EricLew 0:80ee8f3b695e 311
EricLew 0:80ee8f3b695e 312 /** @brief Reset I2C handle state.
EricLew 0:80ee8f3b695e 313 * @param __HANDLE__: specifies the I2C Handle.
EricLew 0:80ee8f3b695e 314 * @retval None
EricLew 0:80ee8f3b695e 315 */
EricLew 0:80ee8f3b695e 316 #define __HAL_I2C_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_I2C_STATE_RESET)
EricLew 0:80ee8f3b695e 317
EricLew 0:80ee8f3b695e 318 /** @brief Enable the specified I2C interrupt.
EricLew 0:80ee8f3b695e 319 * @param __HANDLE__: specifies the I2C Handle.
EricLew 0:80ee8f3b695e 320 * @param __INTERRUPT__: specifies the interrupt source to enable.
EricLew 0:80ee8f3b695e 321 * This parameter can be one of the following values:
EricLew 0:80ee8f3b695e 322 * @arg I2C_IT_ERRI: Errors interrupt enable
EricLew 0:80ee8f3b695e 323 * @arg I2C_IT_TCI: Transfer complete interrupt enable
EricLew 0:80ee8f3b695e 324 * @arg I2C_IT_STOPI: STOP detection interrupt enable
EricLew 0:80ee8f3b695e 325 * @arg I2C_IT_NACKI: NACK received interrupt enable
EricLew 0:80ee8f3b695e 326 * @arg I2C_IT_ADDRI: Address match interrupt enable
EricLew 0:80ee8f3b695e 327 * @arg I2C_IT_RXI: RX interrupt enable
EricLew 0:80ee8f3b695e 328 * @arg I2C_IT_TXI: TX interrupt enable
EricLew 0:80ee8f3b695e 329 *
EricLew 0:80ee8f3b695e 330 * @retval None
EricLew 0:80ee8f3b695e 331 */
EricLew 0:80ee8f3b695e 332
EricLew 0:80ee8f3b695e 333 #define __HAL_I2C_ENABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR1 |= (__INTERRUPT__))
EricLew 0:80ee8f3b695e 334
EricLew 0:80ee8f3b695e 335 /** @brief Disable the specified I2C interrupt.
EricLew 0:80ee8f3b695e 336 * @param __HANDLE__: specifies the I2C Handle.
EricLew 0:80ee8f3b695e 337 * @param __INTERRUPT__: specifies the interrupt source to disable.
EricLew 0:80ee8f3b695e 338 * This parameter can be one of the following values:
EricLew 0:80ee8f3b695e 339 * @arg I2C_IT_ERRI: Errors interrupt enable
EricLew 0:80ee8f3b695e 340 * @arg I2C_IT_TCI: Transfer complete interrupt enable
EricLew 0:80ee8f3b695e 341 * @arg I2C_IT_STOPI: STOP detection interrupt enable
EricLew 0:80ee8f3b695e 342 * @arg I2C_IT_NACKI: NACK received interrupt enable
EricLew 0:80ee8f3b695e 343 * @arg I2C_IT_ADDRI: Address match interrupt enable
EricLew 0:80ee8f3b695e 344 * @arg I2C_IT_RXI: RX interrupt enable
EricLew 0:80ee8f3b695e 345 * @arg I2C_IT_TXI: TX interrupt enable
EricLew 0:80ee8f3b695e 346 *
EricLew 0:80ee8f3b695e 347 * @retval None
EricLew 0:80ee8f3b695e 348 */
EricLew 0:80ee8f3b695e 349 #define __HAL_I2C_DISABLE_IT(__HANDLE__, __INTERRUPT__) ((__HANDLE__)->Instance->CR1 &= (~(__INTERRUPT__)))
EricLew 0:80ee8f3b695e 350
EricLew 0:80ee8f3b695e 351 /** @brief Check whether the specified I2C interrupt source is enabled or not.
EricLew 0:80ee8f3b695e 352 * @param __HANDLE__: specifies the I2C Handle.
EricLew 0:80ee8f3b695e 353 * @param __INTERRUPT__: specifies the I2C interrupt source to check.
EricLew 0:80ee8f3b695e 354 * This parameter can be one of the following values:
EricLew 0:80ee8f3b695e 355 * @arg I2C_IT_ERRI: Errors interrupt enable
EricLew 0:80ee8f3b695e 356 * @arg I2C_IT_TCI: Transfer complete interrupt enable
EricLew 0:80ee8f3b695e 357 * @arg I2C_IT_STOPI: STOP detection interrupt enable
EricLew 0:80ee8f3b695e 358 * @arg I2C_IT_NACKI: NACK received interrupt enable
EricLew 0:80ee8f3b695e 359 * @arg I2C_IT_ADDRI: Address match interrupt enable
EricLew 0:80ee8f3b695e 360 * @arg I2C_IT_RXI: RX interrupt enable
EricLew 0:80ee8f3b695e 361 * @arg I2C_IT_TXI: TX interrupt enable
EricLew 0:80ee8f3b695e 362 *
EricLew 0:80ee8f3b695e 363 * @retval The new state of __INTERRUPT__ (TRUE or FALSE).
EricLew 0:80ee8f3b695e 364 */
EricLew 0:80ee8f3b695e 365 #define __HAL_I2C_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->CR1 & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)
EricLew 0:80ee8f3b695e 366
EricLew 0:80ee8f3b695e 367 /** @brief Check whether the specified I2C flag is set or not.
EricLew 0:80ee8f3b695e 368 * @param __HANDLE__: specifies the I2C Handle.
EricLew 0:80ee8f3b695e 369 * @param __FLAG__: specifies the flag to check.
EricLew 0:80ee8f3b695e 370 * This parameter can be one of the following values:
EricLew 0:80ee8f3b695e 371 * @arg I2C_FLAG_TXE: Transmit data register empty
EricLew 0:80ee8f3b695e 372 * @arg I2C_FLAG_TXIS: Transmit interrupt status
EricLew 0:80ee8f3b695e 373 * @arg I2C_FLAG_RXNE: Receive data register not empty
EricLew 0:80ee8f3b695e 374 * @arg I2C_FLAG_ADDR: Address matched (slave mode)
EricLew 0:80ee8f3b695e 375 * @arg I2C_FLAG_AF: Acknowledge failure received flag
EricLew 0:80ee8f3b695e 376 * @arg I2C_FLAG_STOPF: STOP detection flag
EricLew 0:80ee8f3b695e 377 * @arg I2C_FLAG_TC: Transfer complete (master mode)
EricLew 0:80ee8f3b695e 378 * @arg I2C_FLAG_TCR: Transfer complete reload
EricLew 0:80ee8f3b695e 379 * @arg I2C_FLAG_BERR: Bus error
EricLew 0:80ee8f3b695e 380 * @arg I2C_FLAG_ARLO: Arbitration lost
EricLew 0:80ee8f3b695e 381 * @arg I2C_FLAG_OVR: Overrun/Underrun
EricLew 0:80ee8f3b695e 382 * @arg I2C_FLAG_PECERR: PEC error in reception
EricLew 0:80ee8f3b695e 383 * @arg I2C_FLAG_TIMEOUT: Timeout or Tlow detection flag
EricLew 0:80ee8f3b695e 384 * @arg I2C_FLAG_ALERT: SMBus alert
EricLew 0:80ee8f3b695e 385 * @arg I2C_FLAG_BUSY: Bus busy
EricLew 0:80ee8f3b695e 386 * @arg I2C_FLAG_DIR: Transfer direction (slave mode)
EricLew 0:80ee8f3b695e 387 *
EricLew 0:80ee8f3b695e 388 * @retval The new state of __FLAG__ (TRUE or FALSE).
EricLew 0:80ee8f3b695e 389 */
EricLew 0:80ee8f3b695e 390 #define I2C_FLAG_MASK ((uint32_t)0x0001FFFF)
EricLew 0:80ee8f3b695e 391 #define __HAL_I2C_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & ((__FLAG__) & I2C_FLAG_MASK)) == ((__FLAG__) & I2C_FLAG_MASK)))
EricLew 0:80ee8f3b695e 392
EricLew 0:80ee8f3b695e 393 /** @brief Clear the I2C pending flags which are cleared by writing 1 in a specific bit.
EricLew 0:80ee8f3b695e 394 * @param __HANDLE__: specifies the I2C Handle.
EricLew 0:80ee8f3b695e 395 * @param __FLAG__: specifies the flag to clear.
EricLew 0:80ee8f3b695e 396 * This parameter can be any combination of the following values:
EricLew 0:80ee8f3b695e 397 * @arg I2C_FLAG_ADDR: Address matched (slave mode)
EricLew 0:80ee8f3b695e 398 * @arg I2C_FLAG_AF: Acknowledge failure received flag
EricLew 0:80ee8f3b695e 399 * @arg I2C_FLAG_STOPF: STOP detection flag
EricLew 0:80ee8f3b695e 400 * @arg I2C_FLAG_BERR: Bus error
EricLew 0:80ee8f3b695e 401 * @arg I2C_FLAG_ARLO: Arbitration lost
EricLew 0:80ee8f3b695e 402 * @arg I2C_FLAG_OVR: Overrun/Underrun
EricLew 0:80ee8f3b695e 403 * @arg I2C_FLAG_PECERR: PEC error in reception
EricLew 0:80ee8f3b695e 404 * @arg I2C_FLAG_TIMEOUT: Timeout or Tlow detection flag
EricLew 0:80ee8f3b695e 405 * @arg I2C_FLAG_ALERT: SMBus alert
EricLew 0:80ee8f3b695e 406 *
EricLew 0:80ee8f3b695e 407 * @retval None
EricLew 0:80ee8f3b695e 408 */
EricLew 0:80ee8f3b695e 409 #define __HAL_I2C_CLEAR_FLAG(__HANDLE__, __FLAG__) ((__HANDLE__)->Instance->ICR = ((__FLAG__) & I2C_FLAG_MASK))
EricLew 0:80ee8f3b695e 410
EricLew 0:80ee8f3b695e 411 /** @brief Enable the specified I2C peripheral.
EricLew 0:80ee8f3b695e 412 * @param __HANDLE__: specifies the I2C Handle.
EricLew 0:80ee8f3b695e 413 * @retval None
EricLew 0:80ee8f3b695e 414 */
EricLew 0:80ee8f3b695e 415 #define __HAL_I2C_ENABLE(__HANDLE__) (SET_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))
EricLew 0:80ee8f3b695e 416
EricLew 0:80ee8f3b695e 417 /** @brief Disable the specified I2C peripheral.
EricLew 0:80ee8f3b695e 418 * @param __HANDLE__: specifies the I2C Handle.
EricLew 0:80ee8f3b695e 419 * @retval None
EricLew 0:80ee8f3b695e 420 */
EricLew 0:80ee8f3b695e 421 #define __HAL_I2C_DISABLE(__HANDLE__) (CLEAR_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))
EricLew 0:80ee8f3b695e 422
EricLew 0:80ee8f3b695e 423 /**
EricLew 0:80ee8f3b695e 424 * @}
EricLew 0:80ee8f3b695e 425 */
EricLew 0:80ee8f3b695e 426
EricLew 0:80ee8f3b695e 427 /* Include I2C HAL Extended module */
EricLew 0:80ee8f3b695e 428 #include "stm32l4xx_hal_i2c_ex.h"
EricLew 0:80ee8f3b695e 429
EricLew 0:80ee8f3b695e 430 /* Exported functions --------------------------------------------------------*/
EricLew 0:80ee8f3b695e 431 /** @addtogroup I2C_Exported_Functions
EricLew 0:80ee8f3b695e 432 * @{
EricLew 0:80ee8f3b695e 433 */
EricLew 0:80ee8f3b695e 434
EricLew 0:80ee8f3b695e 435 /** @addtogroup I2C_Exported_Functions_Group1 Initialization and de-initialization functions
EricLew 0:80ee8f3b695e 436 * @{
EricLew 0:80ee8f3b695e 437 */
EricLew 0:80ee8f3b695e 438 /* Initialization and de-initialization functions******************************/
EricLew 0:80ee8f3b695e 439 HAL_StatusTypeDef HAL_I2C_Init(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 440 HAL_StatusTypeDef HAL_I2C_DeInit (I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 441 void HAL_I2C_MspInit(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 442 void HAL_I2C_MspDeInit(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 443 /**
EricLew 0:80ee8f3b695e 444 * @}
EricLew 0:80ee8f3b695e 445 */
EricLew 0:80ee8f3b695e 446
EricLew 0:80ee8f3b695e 447 /** @addtogroup I2C_Exported_Functions_Group2 Input and Output operation functions
EricLew 0:80ee8f3b695e 448 * @{
EricLew 0:80ee8f3b695e 449 */
EricLew 0:80ee8f3b695e 450 /* IO operation functions ****************************************************/
EricLew 0:80ee8f3b695e 451 /******* Blocking mode: Polling */
EricLew 0:80ee8f3b695e 452 HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout);
EricLew 0:80ee8f3b695e 453 HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout);
EricLew 0:80ee8f3b695e 454 HAL_StatusTypeDef HAL_I2C_Slave_Transmit(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout);
EricLew 0:80ee8f3b695e 455 HAL_StatusTypeDef HAL_I2C_Slave_Receive(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout);
EricLew 0:80ee8f3b695e 456 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);
EricLew 0:80ee8f3b695e 457 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);
EricLew 0:80ee8f3b695e 458 HAL_StatusTypeDef HAL_I2C_IsDeviceReady(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Trials, uint32_t Timeout);
EricLew 0:80ee8f3b695e 459
EricLew 0:80ee8f3b695e 460 /******* Non-Blocking mode: Interrupt */
EricLew 0:80ee8f3b695e 461 HAL_StatusTypeDef HAL_I2C_Master_Transmit_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
EricLew 0:80ee8f3b695e 462 HAL_StatusTypeDef HAL_I2C_Master_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
EricLew 0:80ee8f3b695e 463 HAL_StatusTypeDef HAL_I2C_Slave_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
EricLew 0:80ee8f3b695e 464 HAL_StatusTypeDef HAL_I2C_Slave_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
EricLew 0:80ee8f3b695e 465 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);
EricLew 0:80ee8f3b695e 466 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);
EricLew 0:80ee8f3b695e 467
EricLew 0:80ee8f3b695e 468 /******* Non-Blocking mode: DMA */
EricLew 0:80ee8f3b695e 469 HAL_StatusTypeDef HAL_I2C_Master_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
EricLew 0:80ee8f3b695e 470 HAL_StatusTypeDef HAL_I2C_Master_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
EricLew 0:80ee8f3b695e 471 HAL_StatusTypeDef HAL_I2C_Slave_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
EricLew 0:80ee8f3b695e 472 HAL_StatusTypeDef HAL_I2C_Slave_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
EricLew 0:80ee8f3b695e 473 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);
EricLew 0:80ee8f3b695e 474 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);
EricLew 0:80ee8f3b695e 475 /**
EricLew 0:80ee8f3b695e 476 * @}
EricLew 0:80ee8f3b695e 477 */
EricLew 0:80ee8f3b695e 478
EricLew 0:80ee8f3b695e 479 /** @addtogroup I2C_IRQ_Handler_and_Callbacks IRQ Handler and Callbacks
EricLew 0:80ee8f3b695e 480 * @{
EricLew 0:80ee8f3b695e 481 */
EricLew 0:80ee8f3b695e 482 /******* I2C IRQHandler and Callbacks used in non blocking modes (Interrupt and DMA) */
EricLew 0:80ee8f3b695e 483 void HAL_I2C_EV_IRQHandler(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 484 void HAL_I2C_ER_IRQHandler(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 485 void HAL_I2C_MasterTxCpltCallback(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 486 void HAL_I2C_MasterRxCpltCallback(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 487 void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 488 void HAL_I2C_SlaveRxCpltCallback(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 489 void HAL_I2C_MemTxCpltCallback(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 490 void HAL_I2C_MemRxCpltCallback(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 491 void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 492 /**
EricLew 0:80ee8f3b695e 493 * @}
EricLew 0:80ee8f3b695e 494 */
EricLew 0:80ee8f3b695e 495
EricLew 0:80ee8f3b695e 496 /** @addtogroup I2C_Exported_Functions_Group3 Peripheral State and Errors functions
EricLew 0:80ee8f3b695e 497 * @{
EricLew 0:80ee8f3b695e 498 */
EricLew 0:80ee8f3b695e 499 /* Peripheral State and Errors functions *************************************/
EricLew 0:80ee8f3b695e 500 HAL_I2C_StateTypeDef HAL_I2C_GetState(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 501 uint32_t HAL_I2C_GetError(I2C_HandleTypeDef *hi2c);
EricLew 0:80ee8f3b695e 502
EricLew 0:80ee8f3b695e 503 /**
EricLew 0:80ee8f3b695e 504 * @}
EricLew 0:80ee8f3b695e 505 */
EricLew 0:80ee8f3b695e 506
EricLew 0:80ee8f3b695e 507 /**
EricLew 0:80ee8f3b695e 508 * @}
EricLew 0:80ee8f3b695e 509 */
EricLew 0:80ee8f3b695e 510
EricLew 0:80ee8f3b695e 511 /* Private constants ---------------------------------------------------------*/
EricLew 0:80ee8f3b695e 512 /** @defgroup I2C_Private_Constants I2C Private Constants
EricLew 0:80ee8f3b695e 513 * @{
EricLew 0:80ee8f3b695e 514 */
EricLew 0:80ee8f3b695e 515
EricLew 0:80ee8f3b695e 516 /**
EricLew 0:80ee8f3b695e 517 * @}
EricLew 0:80ee8f3b695e 518 */
EricLew 0:80ee8f3b695e 519
EricLew 0:80ee8f3b695e 520 /* Private macros ------------------------------------------------------------*/
EricLew 0:80ee8f3b695e 521 /** @defgroup I2C_Private_Macro I2C Private Macros
EricLew 0:80ee8f3b695e 522 * @{
EricLew 0:80ee8f3b695e 523 */
EricLew 0:80ee8f3b695e 524
EricLew 0:80ee8f3b695e 525 #define IS_I2C_ADDRESSING_MODE(MODE) (((MODE) == I2C_ADDRESSINGMODE_7BIT) || \
EricLew 0:80ee8f3b695e 526 ((MODE) == I2C_ADDRESSINGMODE_10BIT))
EricLew 0:80ee8f3b695e 527
EricLew 0:80ee8f3b695e 528 #define IS_I2C_DUAL_ADDRESS(ADDRESS) (((ADDRESS) == I2C_DUALADDRESS_DISABLE) || \
EricLew 0:80ee8f3b695e 529 ((ADDRESS) == I2C_DUALADDRESS_ENABLE))
EricLew 0:80ee8f3b695e 530
EricLew 0:80ee8f3b695e 531 #define IS_I2C_OWN_ADDRESS2_MASK(MASK) (((MASK) == I2C_OA2_NOMASK) || \
EricLew 0:80ee8f3b695e 532 ((MASK) == I2C_OA2_MASK01) || \
EricLew 0:80ee8f3b695e 533 ((MASK) == I2C_OA2_MASK02) || \
EricLew 0:80ee8f3b695e 534 ((MASK) == I2C_OA2_MASK03) || \
EricLew 0:80ee8f3b695e 535 ((MASK) == I2C_OA2_MASK04) || \
EricLew 0:80ee8f3b695e 536 ((MASK) == I2C_OA2_MASK05) || \
EricLew 0:80ee8f3b695e 537 ((MASK) == I2C_OA2_MASK06) || \
EricLew 0:80ee8f3b695e 538 ((MASK) == I2C_OA2_MASK07))
EricLew 0:80ee8f3b695e 539
EricLew 0:80ee8f3b695e 540 #define IS_I2C_GENERAL_CALL(CALL) (((CALL) == I2C_GENERALCALL_DISABLE) || \
EricLew 0:80ee8f3b695e 541 ((CALL) == I2C_GENERALCALL_ENABLE))
EricLew 0:80ee8f3b695e 542
EricLew 0:80ee8f3b695e 543 #define IS_I2C_NO_STRETCH(STRETCH) (((STRETCH) == I2C_NOSTRETCH_DISABLE) || \
EricLew 0:80ee8f3b695e 544 ((STRETCH) == I2C_NOSTRETCH_ENABLE))
EricLew 0:80ee8f3b695e 545
EricLew 0:80ee8f3b695e 546 #define IS_I2C_MEMADD_SIZE(SIZE) (((SIZE) == I2C_MEMADD_SIZE_8BIT) || \
EricLew 0:80ee8f3b695e 547 ((SIZE) == I2C_MEMADD_SIZE_16BIT))
EricLew 0:80ee8f3b695e 548
EricLew 0:80ee8f3b695e 549
EricLew 0:80ee8f3b695e 550 #define IS_TRANSFER_MODE(MODE) (((MODE) == I2C_RELOAD_MODE) || \
EricLew 0:80ee8f3b695e 551 ((MODE) == I2C_AUTOEND_MODE) || \
EricLew 0:80ee8f3b695e 552 ((MODE) == I2C_SOFTEND_MODE))
EricLew 0:80ee8f3b695e 553
EricLew 0:80ee8f3b695e 554 #define IS_TRANSFER_REQUEST(REQUEST) (((REQUEST) == I2C_GENERATE_STOP) || \
EricLew 0:80ee8f3b695e 555 ((REQUEST) == I2C_GENERATE_START_READ) || \
EricLew 0:80ee8f3b695e 556 ((REQUEST) == I2C_GENERATE_START_WRITE) || \
EricLew 0:80ee8f3b695e 557 ((REQUEST) == I2C_NO_STARTSTOP))
EricLew 0:80ee8f3b695e 558
EricLew 0:80ee8f3b695e 559
EricLew 0:80ee8f3b695e 560 #define I2C_RESET_CR2(__HANDLE__) ((__HANDLE__)->Instance->CR2 &= (uint32_t)~((uint32_t)(I2C_CR2_SADD | I2C_CR2_HEAD10R | I2C_CR2_NBYTES | I2C_CR2_RELOAD | I2C_CR2_RD_WRN)))
EricLew 0:80ee8f3b695e 561
EricLew 0:80ee8f3b695e 562 #define IS_I2C_OWN_ADDRESS1(ADDRESS1) ((ADDRESS1) <= (uint32_t)0x000003FF)
EricLew 0:80ee8f3b695e 563 #define IS_I2C_OWN_ADDRESS2(ADDRESS2) ((ADDRESS2) <= (uint16_t)0x00FF)
EricLew 0:80ee8f3b695e 564
EricLew 0:80ee8f3b695e 565 #define I2C_MEM_ADD_MSB(__ADDRESS__) ((uint8_t)((uint16_t)(((uint16_t)((__ADDRESS__) & (uint16_t)(0xFF00))) >> 8)))
EricLew 0:80ee8f3b695e 566 #define I2C_MEM_ADD_LSB(__ADDRESS__) ((uint8_t)((uint16_t)((__ADDRESS__) & (uint16_t)(0x00FF))))
EricLew 0:80ee8f3b695e 567
EricLew 0:80ee8f3b695e 568 #define I2C_GENERATE_START(__ADDMODE__,__ADDRESS__) (((__ADDMODE__) == I2C_ADDRESSINGMODE_7BIT) ? (uint32_t)((((uint32_t)(__ADDRESS__) & (I2C_CR2_SADD)) | (I2C_CR2_START) | (I2C_CR2_AUTOEND)) & (~I2C_CR2_RD_WRN)) : \
EricLew 0:80ee8f3b695e 569 (uint32_t)((((uint32_t)(__ADDRESS__) & (I2C_CR2_SADD)) | (I2C_CR2_ADD10) | (I2C_CR2_START)) & (~I2C_CR2_RD_WRN)))
EricLew 0:80ee8f3b695e 570 /**
EricLew 0:80ee8f3b695e 571 * @}
EricLew 0:80ee8f3b695e 572 */
EricLew 0:80ee8f3b695e 573
EricLew 0:80ee8f3b695e 574 /* Private Functions ---------------------------------------------------------*/
EricLew 0:80ee8f3b695e 575 /** @defgroup I2C_Private_Functions I2C Private Functions
EricLew 0:80ee8f3b695e 576 * @{
EricLew 0:80ee8f3b695e 577 */
EricLew 0:80ee8f3b695e 578 /* Private functions are defined in stm32l4xx_hal_i2c.c file */
EricLew 0:80ee8f3b695e 579 /**
EricLew 0:80ee8f3b695e 580 * @}
EricLew 0:80ee8f3b695e 581 */
EricLew 0:80ee8f3b695e 582
EricLew 0:80ee8f3b695e 583 /**
EricLew 0:80ee8f3b695e 584 * @}
EricLew 0:80ee8f3b695e 585 */
EricLew 0:80ee8f3b695e 586
EricLew 0:80ee8f3b695e 587 /**
EricLew 0:80ee8f3b695e 588 * @}
EricLew 0:80ee8f3b695e 589 */
EricLew 0:80ee8f3b695e 590
EricLew 0:80ee8f3b695e 591 #ifdef __cplusplus
EricLew 0:80ee8f3b695e 592 }
EricLew 0:80ee8f3b695e 593 #endif
EricLew 0:80ee8f3b695e 594
EricLew 0:80ee8f3b695e 595
EricLew 0:80ee8f3b695e 596 #endif /* __STM32L4xx_HAL_I2C_H */
EricLew 0:80ee8f3b695e 597
EricLew 0:80ee8f3b695e 598 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
EricLew 0:80ee8f3b695e 599