你的浏览器版本过低，可能导致网站不能正常访问！
为了你能正常使用网站功能，请使用这些浏览器。

st-img
chrome st-img
firefox st-img
safari st-img
ie8及以上

NUCLEO_L552ZE_Q+HAL的I2C库（第五篇）

[复制链接]
qbwww 发布时间：2020-3-22 07:29
这个I2C库的资料也整理好了。有需要的看一看吧。这是用cube生成的文件整理的。Hal的库。

  1. /*I2C配置结构定义*/
  2. typedef struct
  3. {
  4. uint32_t Timing;                  /*指定I2C_TIMINGR_register值。该参数通过参考I2C初始化计算得出*/

  6. uint32_t OwnAddress1;         /*指定第一个设备自己的地址。此参数可以是7位或10位地址。*/

  8.   uint32_t AddressingMode;  /*指定是选择7位还是10位寻址模式。此参数可以是I2C_ADDRESSING_MODE*/的值

  10. uint32_t DualAddressMode; /*指定是否选择双重寻址模式。此参数可以是I2C_DUAL_ADDRESSING_MODE*/

  12. uint32_t OwnAddress2;        /*如果选择双寻址模式，则指定第二个设备自己的地址此参数可以是7位地址。*/

  14. uint32_t OwnAddress2Masks;/*如果选择双重寻址模式，则指定确认掩码地址第二个设备自己的地址,此参数可以是I2C_OWN_ADDRESS2_MASKS的值*/

  16. uint32_t GeneralCallMode;   /*指定是否选择常规呼叫模式。此参数可以是I2C_GENERAL_CALL_ADDRESSING_MODE的值*/

  18. uint32_t NoStretchMode;     /*指定是否选择nostretch模式。此参数可以是I2C_NOSTRETCH_MODE的值*/

  20. }I2C_InitTypeDef;


  23. /*HAL状态结构定义
  24. *HALI2C状态值编码遵循下面描述的位图：\n
  25. *                b7-b6错误信息\n
  26. *                00：无错误\n
  27. *                01：中止（正在进行中的用户请求中止）\n
  28. *                10：超时\n
  29. *                11：错误\n
  30. *                b5 外围设备初始化状态\n
  31. *                0：重置（外围设备未初始化）\n
  32. *                1：已完成初始化（已初始化外围设备并准备使用。已调用HALI2CInit函数）\n
  33. *                b4（未使用）\n
  34. *                x：应设置为0\n
  35. *                b3\n
  36. *                0：就绪或忙碌（无监听模式正在进行中）\n
  37. *                1：监听（地址监听模式中的外围设备）\n
  38. *                b2内部过程状态\n
  39. *                0：就绪\n
  40. *                1：忙（外围设备忙于某些配置或内部操作）\n
  41. *                b1接收状态\n
  42. *                0：就绪（无正在进行的接收操作）\n
  43. *                1：忙（正在进行Rx操作）\n
  44. *                b0Tx状态\n
  45. *                0：就绪（没有正在进行的发送操作）\n
  46. *                1：忙（正在进行发送操作）

  48. */
  49. typedef enum
  50. {
  51.         HAL_I2C_STATE_RESET             = 0x00U, /*外围设备尚未初始化*/
  52.         HAL_I2C_STATE_READY             = 0x20U, /*已初始化外围设备并准备使用*/
  53.         HAL_I2C_STATE_BUSY              = 0x24U, /*内部进程正在进行*/
  54.         HAL_I2C_STATE_BUSY_TX           = 0x21U, /*数据传输过程正在进行*/
  55.         HAL_I2C_STATE_BUSY_RX           = 0x22U, /*数据接收过程正在进行*/
  56.         HAL_I2C_STATE_LISTEN            = 0x28U, /*地址监听模式正在进行*/
  57.         HAL_I2C_STATE_BUSY_TX_LISTEN    = 0x29U, /*地址监听模式和数据传输正在进行中*/
  58.         HAL_I2C_STATE_BUSY_RX_LISTEN    = 0x2AU, /*地址监听模式和数据接收正在进行中*/
  59.         HAL_I2C_STATE_ABORT             = 0x60U, /*正在中止用户请求*/
  60.         HAL_I2C_STATE_TIMEOUT           = 0xA0U, /*超时状态*/
  61.         HAL_I2C_STATE_ERROR             = 0xE0U  /*错误*/

  63. }HAL_I2C_StateTypeDef;



  67. /*HAL模式结构定义
  68. *HALI2C模式值编码遵循下面描述的位图：\n
  69. *                b7（未使用）\n
  70. *                x：应设置为0\n
  71. *                b6\n
  72. *                0：无\n
  73. *                1：内存（HALI2C通信处于内存模式）\n
  74. *                b5\n
  75. *                0：无\n
  76. *                1：从站（HALI2C通信处于从站模式）\n
  77. *                b4\n
  78. *                0：无\n
  79. *                1：主机（HALI2C通讯处于主机模式）\n
  80. *                b3-b2-b1-b0（未使用）\n
  81. *                xxxx：应设置为0000

  83. */
  84. typedef enum
  85. {
  86. HAL_I2C_MODE_NONE               =0x00U, /*进行中没有I2C通信*/
  87. HAL_I2C_MODE_MASTER                                =0x10U，/*I2C通讯处于主模式*/
  88. HAL_I2C_MODE_SLAVE                                =0x20U，/*I2C通信处于从模式*/
  89. HAL_I2C_MODE_MEM                                =0x40U  /*I2C通信处于内存模式*/

  91. }HAL_I2C_ModeTypeDef;



  95. /*的I2C错误代码定义*/
  96. ＃定义HAL_I2C_ERROR_NONE                （0x00000000U）        /*没有错误*/
  97. ＃定义HAL_I2C_ERROR_BERR                （0x00000001U）        /*错误错误*/
  98. ＃定义HAL_I2C_ERROR_ARLO                （0x00000002U）        /*ARLO错误*/
  99. ＃定义HAL_I2C_ERROR_AF                        （0x00000004U）        /*ACKF错误*/
  100. ＃定义HAL_I2C_ERROR_OVR                        （0x00000008U）        /*OVR错误*/
  101. ＃定义HAL_I2C_ERROR_DMA                        （0x00000010U）        /*DMA传输错误*/
  102. ＃定义HAL_I2C_ERROR_TIMEOUT                （0x00000020U）        /*超时错误*/
  103. ＃定义HAL_I2C_ERROR_SIZE                （0x00000040U）        /*大小管理错误*/
  104. ＃定义HAL_I2C_ERROR_DMA_PARAM        （0x00000080U）        /*DMA参数错误*/
  105. #if（USE_HAL_I2C_REGISTER_CALLBACKS==1）
  106. #define HAL_I2C_ERROR_INVALID_CALLBACK  (0x00000100U)  /*无效的回调错误*/
  107. #endif/*USE_HAL_I2C_REGISTER_CALLBACKS*/
  108. #define HAL_I2C_ERROR_INVALID_PARAM     (0x00000200U)  /*无效参数错误*/


  111. /*I2C句柄结构定义*/
  112. typedef struct __I2C_HandleTypeDef
  113. {
  114. I2C_TypeDef                                *Instance;                        /*I2C注册基地址*/

  116. I2C_InitTypeDef                        Init;                                /*I2C通讯参数*/

  118. uint8_t                                        *pBuffPtr;                        /*指向I2C传输缓冲区的指针*/

  120. uint16_t                                XferSize;                        /*I2C传输大小*/

  122. __IOuint16_t                        XferCount;                        /*I2C传输计数器*/

  124. __IOuint32_t                        XferOptions;                /*I2C连续传输选项，此参数可以是I2C_XFEROPTIONS的值*/

  126. __IOuint32_t                        PreviousState;                /*I2C通信先前状态*/

  128. HAL_StatusTypeDef（*XferISR）（struct__I2C_HandleTypeDef*hi2c，uint32_tITFlags，uint32_tITSources）;/*I2C传输IRQ处理程序函数指针*/

  130. DMA_HandleTypeDef                *hdmatx;                        /*I2CTxDMA句柄参数*/

  132. DMA_HandleTypeDef                *hdmarx;                        /*I2CRxDMA句柄参数*/

  134. HAL_LockTypeDef                        Lock;                        /*I2C锁定对象*/

  136. __IOHAL_I2C_StateTypeDef         State;                /*I2C通讯状态*/

  138. __IOHAL_I2C_ModeTypeDef                Mode;                /*I2C通讯模式*/

  140. __IOuint32_t                        ErrorCode;                /*I2C错误代码*/

  142. __IOuint32_t                        AddrEventCount;/*I2C地址事件计数器*/

  144. #if（USE_HAL_I2C_REGISTER_CALLBACKS==1）

  146. void (* MasterTxCpltCallback)(struct __I2C_HandleTypeDef *hi2c);         /*I2C主Tx传输完成的回调*/
  147. void (* MasterRxCpltCallback)(struct __I2C_HandleTypeDef *hi2c);    /*I2C主Rx传输完成的回调*/
  148. void (* SlaveTxCpltCallback)(struct __I2C_HandleTypeDef *hi2c);         /*I2C从机Tx传输完成回调*/
  149. void (* SlaveRxCpltCallback)(struct __I2C_HandleTypeDef *hi2c);     /*I2C从Rx传输完成回调*/
  150. void (* ListenCpltCallback)(struct __I2C_HandleTypeDef *hi2c);            /*I2C监听完成回调*/
  151. void (* MemTxCpltCallback)(struct __I2C_HandleTypeDef *hi2c);                  /*I2C内存发送传输完成回调*/
  152. void (* MemRxCpltCallback)(struct __I2C_HandleTypeDef *hi2c);                 /*I2C内存接收传输完成回调*/
  153. void (* ErrorCallback)(struct __I2C_HandleTypeDef *hi2c);                          /*I2C错误回调*/
  154. void (* AbortCpltCallback)(struct __I2C_HandleTypeDef *hi2c);                 /*I2C中止回调*/
  155. void (* AddrCallback)(struct __I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, uint16_t AddrMatchCode); /*I2C从站地址匹配回调*/
  156. void (* MspInitCallback)(struct __I2C_HandleTypeDef *hi2c);                 /*I2CMsp初始化回调*/
  157. void (* MspDeInitCallback)(struct __I2C_HandleTypeDef *hi2c);                 /*I2CMspDeInit回调*/

  159. #endif/*USE_HAL_I2C_REGISTER_CALLBACKS*/
  160. }I2C_HandleTypeDef;


  163. /*HALI2C回调ID枚举定义*/
  164. typedef enum
  165. {
  166. HAL_I2C_MASTER_TX_COMPLETE_CB_ID        =0x00U，        /*I2C主Tx传输完成的回调ID*/
  167. HAL_I2C_MASTER_RX_COMPLETE_CB_ID        =0x01U，        /*I2C主Rx传输完成的回调ID*/
  168. HAL_I2C_SLAVE_TX_COMPLETE_CB_ID                =0x02U，        /*I2C从机Tx传输完成的回调ID*/
  169. HAL_I2C_SLAVE_RX_COMPLETE_CB_ID                =0x03U，        /*I2C从站Rx传输完成的回调ID*/
  170. HAL_I2C_LISTEN_COMPLETE_CB_ID                =0x04U，        /*I2C监听完成回调ID*/
  171. HAL_I2C_MEM_TX_COMPLETE_CB_ID                =0x05U，        /*I2C内存Tx传输回调ID*/
  172. HAL_I2C_MEM_RX_COMPLETE_CB_ID                =0x06U，        /*I2C内存接收传输完成的回调ID*/
  173. HAL_I2C_ERROR_CB_ID                                        =0x07U，        /*I2C错误回调ID*/
  174. HAL_I2C_ABORT_CB_ID                                        =0x08U，        /*I2C中止回调ID*/
  175. HAL_I2C_MSPINIT_CB_ID                                =0x09U，        /*I2CMsp初始化回调ID*/
  176. HAL_I2C_MSPDEINIT_CB_ID                                =0x0AU                /*I2CMspDeInit回调ID*/
  177. }HAL_I2C_CallbackIDTypeDef;

  179. /*HALI2C回调指针定义*/
  180. typedef  void (*pI2C_CallbackTypeDef)(I2C_HandleTypeDef *hi2c); /*指向I2C回调函数的指针*/
  181. typedef  void (*pI2C_AddrCallbackTypeDef)(I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, uint16_t AddrMatchCode); /*指向I2C地址匹配回调函数的指针*/


  184. /*I2C顺序传输选项*/
  185. #define I2C_FIRST_FRAME                 ((uint32_t)I2C_SOFTEND_MODE)
  186. #define I2C_FIRST_AND_NEXT_FRAME        ((uint32_t)(I2C_RELOAD_MODE | I2C_SOFTEND_MODE))
  187. #define I2C_NEXT_FRAME                  ((uint32_t)(I2C_RELOAD_MODE | I2C_SOFTEND_MODE))
  188. #define I2C_FIRST_AND_LAST_FRAME        ((uint32_t)I2C_AUTOEND_MODE)
  189. #define I2C_LAST_FRAME                  ((uint32_t)I2C_AUTOEND_MODE)
  190. #define I2C_LAST_FRAME_NO_STOP          ((uint32_t)I2C_SOFTEND_MODE)


  193. /*I2C寻址模式*/
  194. #define I2C_ADDRESSINGMODE_7BIT         (0x00000001U)
  195. #define I2C_ADDRESSINGMODE_10BIT        (0x00000002U)


  198. /*I2C双寻址模式*/
  199. #define I2C_DUALADDRESS_DISABLE         (0x00000000U)
  200. #define I2C_DUALADDRESS_ENABLE          I2C_OAR2_OA2EN


  203. /*I2C自己地址的2个掩码*/
  204. #define I2C_OA2_NOMASK                  ((uint8_t)0x00U)
  205. #define I2C_OA2_MASK01                  ((uint8_t)0x01U)
  206. #define I2C_OA2_MASK02                  ((uint8_t)0x02U)
  207. #define I2C_OA2_MASK03                  ((uint8_t)0x03U)
  208. #define I2C_OA2_MASK04                  ((uint8_t)0x04U)
  209. #define I2C_OA2_MASK05                  ((uint8_t)0x05U)
  210. #define I2C_OA2_MASK06                  ((uint8_t)0x06U)
  211. #define I2C_OA2_MASK07                  ((uint8_t)0x07U)


  214. /*I2C常规呼叫寻址模式*/
  215. #define I2C_GENERALCALL_DISABLE         (0x00000000U)
  216. #define I2C_GENERALCALL_ENABLE          I2C_CR1_GCEN


  219. /*I2C无拉伸模式*/
  220. #define I2C_NOSTRETCH_DISABLE           (0x00000000U)
  221. #define I2C_NOSTRETCH_ENABLE            I2C_CR1_NOSTRETCH


  224. /*I2C内存地址大小*/
  225. #define I2C_MEMADD_SIZE_8BIT            (0x00000001U)
  226. #define I2C_MEMADD_SIZE_16BIT           (0x00000002U)


  229. /*I2C传输方向主视点*/
  230. #define I2C_DIRECTION_TRANSMIT          (0x00000000U)
  231. #define I2C_DIRECTION_RECEIVE           (0x00000001U)


  234. /*I2C重新加载结束模式*/
  235. #define  I2C_RELOAD_MODE                I2C_CR2_RELOAD
  236. #define  I2C_AUTOEND_MODE               I2C_CR2_AUTOEND
  237. #define  I2C_SOFTEND_MODE               (0x00000000U)


  240. /*I2C启动或停止模式*/
  241. #define  I2C_NO_STARTSTOP               (0x00000000U)
  242. #define  I2C_GENERATE_STOP              (uint32_t)(0x80000000U | I2C_CR2_STOP)
  243. #define  I2C_GENERATE_START_READ        (uint32_t)(0x80000000U | I2C_CR2_START | I2C_CR2_RD_WRN)
  244. #define  I2C_GENERATE_START_WRITE       (uint32_t)(0x80000000U | I2C_CR2_START)


  247. /*I2C中断配置定义*/
  248. #define I2C_IT_ERRI                     I2C_CR1_ERRIE
  249. #define I2C_IT_TCI                      I2C_CR1_TCIE
  250. #define I2C_IT_STOPI                    I2C_CR1_STOPIE
  251. #define I2C_IT_NACKI                    I2C_CR1_NACKIE
  252. #define I2C_IT_ADDRI                    I2C_CR1_ADDRIE
  253. #define I2C_IT_RXI                      I2C_CR1_RXIE
  254. #define I2C_IT_TXI                      I2C_CR1_TXIE


  257. /*I2C标志定义*/
  258. #define I2C_FLAG_TXE                    I2C_ISR_TXE
  259. #define I2C_FLAG_TXIS                   I2C_ISR_TXIS
  260. #define I2C_FLAG_RXNE                   I2C_ISR_RXNE
  261. #define I2C_FLAG_ADDR                   I2C_ISR_ADDR
  262. #define I2C_FLAG_AF                     I2C_ISR_NACKF
  263. #define I2C_FLAG_STOPF                  I2C_ISR_STOPF
  264. #define I2C_FLAG_TC                     I2C_ISR_TC
  265. #define I2C_FLAG_TCR                    I2C_ISR_TCR
  266. #define I2C_FLAG_BERR                   I2C_ISR_BERR
  267. #define I2C_FLAG_ARLO                   I2C_ISR_ARLO
  268. #define I2C_FLAG_OVR                    I2C_ISR_OVR
  269. #define I2C_FLAG_PECERR                 I2C_ISR_PECERR
  270. #define I2C_FLAG_TIMEOUT                I2C_ISR_TIMEOUT
  271. #define I2C_FLAG_ALERT                  I2C_ISR_ALERT
  272. #define I2C_FLAG_BUSY                   I2C_ISR_BUSY
  273. #define I2C_FLAG_DIR                    I2C_ISR_DIR



  277. /*I2C句柄状态*/
  278. #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
  279. #define __HAL_I2C_RESET_HANDLE_STATE(__HANDLE__)                do{                                                   \
  280.                                                                     (__HANDLE__)->State = HAL_I2C_STATE_RESET;       \
  281.                                                                     (__HANDLE__)->MspInitCallback = NULL;            \
  282.                                                                     (__HANDLE__)->MspDeInitCallback = NULL;          \
  283.                                                                   } while(0)
  284. #else
  285. #define __HAL_I2C_RESET_HANDLE_STATE(__HANDLE__)                ((__HANDLE__)->State = HAL_I2C_STATE_RESET)
  286. #endif

  288. /*启用指定的I2C中断。
  289. *__HANDLE__指定I2C句柄。
  290. *__INTERRUPT__指定要启用的中断源。
  291. *此参数可以是下列值之一：
  292. *I2C_IT_ERRI错误中断
  293. *I2C_IT_TCI传输完成中断
  294. *I2C_IT_STOPISTOP检测中断
  295. *I2C_IT_NACKINACK接收中断
  296. *I2C_IT_ADDRI地址匹配中断
  297. *I2C_IT_RXIRX中断
  298. *I2C_IT_TXITX中断
  299. */
  300. #define __HAL_I2C_ENABLE_IT(__HANDLE__, __INTERRUPT__)          ((__HANDLE__)->Instance->CR1 |= (__INTERRUPT__))

  302. /*禁用指定的I2C中断。
  303. *__HANDLE__指定I2C句柄。
  304. *__INTERRUPT__指定要禁用的中断源。
  305. *此参数可以是下列值之一：
  306. *I2C_IT_ERRI错误中断
  307. *I2C_IT_TCI传输完成中断
  308. *I2C_IT_STOPISTOP检测中断
  309. *I2C_IT_NACKINACK接收中断
  310. *I2C_IT_ADDRI地址匹配中断
  311. *I2C_IT_RXIRX中断
  312. *I2C_IT_TXITX中断
  313. */
  314. #define __HAL_I2C_DISABLE_IT(__HANDLE__, __INTERRUPT__)         ((__HANDLE__)->Instance->CR1 &= (~(__INTERRUPT__)))

  316. /*检查是否启用了指定的I2C中断源。
  317. *__HANDLE__指定I2C句柄。
  318. *__INTERRUPT__指定要检查的I2C中断源。
  319. *此参数可以是下列值之一：
  320. *I2C_IT_ERRI错误中断
  321. *I2C_IT_TCI传输完成中断
  322. *I2C_IT_STOPISTOP检测中断
  323. *I2C_IT_NACKINACK接收中断
  324. *I2C_IT_ADDRI地址匹配中断
  325. *I2C_IT_RXIRX中断
  326. *I2C_IT_TXITX中断
  327. */
  328. #define __HAL_I2C_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__)      ((((__HANDLE__)->Instance->CR1 & (__INTERRUPT__)) == (__INTERRUPT__)) ? SET : RESET)

  330. /*检查是否设置了指定的I2C标志。
  331. *__HANDLE__指定I2C句柄。
  332. *__FLAG__指定要检查的标志。
  333. *此参数可以是下列值之一：
  334. *I2C_FLAG_TXE发送数据寄存器为空
  335. *I2C_FLAG_TXIS发送中断状态
  336. *I2C_FLAG_RXNE接收数据寄存器不为空
  337. *I2C_FLAG_ADDR地址匹配（从模式）
  338. *I2C_FLAG_AF收到确认失败标志
  339. *I2C_FLAG_STOPF停止检测标志
  340. *I2C_FLAG_TC传输完成（主模式）
  341. *I2C_FLAG_TCR传输完成重新加载
  342. *I2C_FLAG_BERR总线错误
  343. *I2C_FLAG_ARLO仲裁丢失
  344. *I2C_FLAG_OVR超限/不足
  345. *I2C_FLAG_PECERR接收中的PEC错误
  346. *I2C_FLAG_TIMEOUT超时或低速检测标志
  347. *I2C_FLAG_ALERTSMBus警报
  348. *I2C_FLAG_BUSY总线忙
  349. *I2C_FLAG_DIR传输方向（从模式）
  350. */
  351. #define I2C_FLAG_MASK  (0x0001FFFFU)
  352. #define __HAL_I2C_GET_FLAG(__HANDLE__, __FLAG__) (((((__HANDLE__)->Instance->ISR) & (__FLAG__)) == (__FLAG__)) ? SET : RESET)

  354. /*清除I2C挂起标志，该标志通过在特定位写入1来清除。
  355. *__HANDLE__指定I2C句柄。
  356. *__FLAG__指定要清除的标志。
  357. *此参数可以是以下值的任意组合：
  358. *I2C_FLAG_TXE发送数据寄存器为空
  359. *I2C_FLAG_ADDR地址匹配（从模式）
  360. *I2C_FLAG_AF收到确认失败标志
  361. *I2C_FLAG_STOPF停止检测标志
  362. *I2C_FLAG_BERR总线错误
  363. *I2C_FLAG_ARLO仲裁丢失
  364. *I2C_FLAG_OVR超限/不足
  365. *I2C_FLAG_PECERR接收中的PEC错误
  366. *I2C_FLAG_TIMEOUT超时或低速检测标志
  367. *I2C_FLAG_ALERTSMBus警报
  368. */
  369. #define __HAL_I2C_CLEAR_FLAG(__HANDLE__, __FLAG__) (((__FLAG__) == I2C_FLAG_TXE) ? ((__HANDLE__)->Instance->ISR |= (__FLAG__)) \
  370.                                                                                  : ((__HANDLE__)->Instance->ICR = (__FLAG__)))

  372. /*启用指定的I2C外设。*/
  373. #define __HAL_I2C_ENABLE(__HANDLE__)                            (SET_BIT((__HANDLE__)->Instance->CR1,  I2C_CR1_PE))


  376. /*禁用指定的I2C外设。*/
  377. #define __HAL_I2C_DISABLE(__HANDLE__)                           (CLEAR_BIT((__HANDLE__)->Instance->CR1, I2C_CR1_PE))

  379. /*在从模式下生成一个非确认I2C外设。*/
  380. #define __HAL_I2C_GENERATE_NACK(__HANDLE__)                     (SET_BIT((__HANDLE__)->Instance->CR2, I2C_CR2_NACK))




  385. /*初始化和取消初始化功能**********************************/
  386. HAL_StatusTypeDef HAL_I2C_Init(I2C_HandleTypeDef *hi2c);
  387. HAL_StatusTypeDef HAL_I2C_DeInit(I2C_HandleTypeDef *hi2c);
  388. void HAL_I2C_MspInit(I2C_HandleTypeDef *hi2c);
  389. void HAL_I2C_MspDeInit(I2C_HandleTypeDef *hi2c);

  391. /*回调注册/取消注册功能***********************************/
  392. #if (USE_HAL_I2C_REGISTER_CALLBACKS == 1)
  393. HAL_StatusTypeDef HAL_I2C_RegisterCallback(I2C_HandleTypeDef *hi2c, HAL_I2C_CallbackIDTypeDef CallbackID, pI2C_CallbackTypeDef pCallback);
  394. HAL_StatusTypeDef HAL_I2C_UnRegisterCallback(I2C_HandleTypeDef *hi2c, HAL_I2C_CallbackIDTypeDef CallbackID);

  396. HAL_StatusTypeDef HAL_I2C_RegisterAddrCallback(I2C_HandleTypeDef *hi2c, pI2C_AddrCallbackTypeDef pCallback);
  397. HAL_StatusTypeDef HAL_I2C_UnRegisterAddrCallback(I2C_HandleTypeDef *hi2c);
  398. #endif /* USE_HAL_I2C_REGISTER_CALLBACKS */


  401. /*输入和输出操作函数*/
  402. /*IO操作功能****************************************************/
  403. /*阻止模式：轮询*/
  404. HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout);
  405. HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout);
  406. HAL_StatusTypeDef HAL_I2C_Slave_Transmit(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout);
  407. HAL_StatusTypeDef HAL_I2C_Slave_Receive(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t Timeout);
  408. 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);
  409. 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);
  410. HAL_StatusTypeDef HAL_I2C_IsDeviceReady(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint32_t Trials, uint32_t Timeout);

  412. /*非阻塞模式：中断*/
  413. HAL_StatusTypeDef HAL_I2C_Master_Transmit_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
  414. HAL_StatusTypeDef HAL_I2C_Master_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
  415. HAL_StatusTypeDef HAL_I2C_Slave_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
  416. HAL_StatusTypeDef HAL_I2C_Slave_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
  417. 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);
  418. 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);

  420. HAL_StatusTypeDef HAL_I2C_Master_Seq_Transmit_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions);
  421. HAL_StatusTypeDef HAL_I2C_Master_Seq_Receive_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions);
  422. HAL_StatusTypeDef HAL_I2C_Slave_Seq_Transmit_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions);
  423. HAL_StatusTypeDef HAL_I2C_Slave_Seq_Receive_IT(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions);
  424. HAL_StatusTypeDef HAL_I2C_EnableListen_IT(I2C_HandleTypeDef *hi2c);
  425. HAL_StatusTypeDef HAL_I2C_DisableListen_IT(I2C_HandleTypeDef *hi2c);
  426. HAL_StatusTypeDef HAL_I2C_Master_Abort_IT(I2C_HandleTypeDef *hi2c, uint16_t DevAddress);

  428. /*非阻塞模式：DMA*/
  429. HAL_StatusTypeDef HAL_I2C_Master_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
  430. HAL_StatusTypeDef HAL_I2C_Master_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size);
  431. HAL_StatusTypeDef HAL_I2C_Slave_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
  432. HAL_StatusTypeDef HAL_I2C_Slave_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size);
  433. 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);
  434. 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);

  436. HAL_StatusTypeDef HAL_I2C_Master_Seq_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions);
  437. HAL_StatusTypeDef HAL_I2C_Master_Seq_Receive_DMA(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t XferOptions);
  438. HAL_StatusTypeDef HAL_I2C_Slave_Seq_Transmit_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions);
  439. HAL_StatusTypeDef HAL_I2C_Slave_Seq_Receive_DMA(I2C_HandleTypeDef *hi2c, uint8_t *pData, uint16_t Size, uint32_t XferOptions);


  442. /*在非阻塞模式（中断和DMA）中使用的I2C IRQHandler和回调*/
  443. void HAL_I2C_EV_IRQHandler(I2C_HandleTypeDef *hi2c);
  444. void HAL_I2C_ER_IRQHandler(I2C_HandleTypeDef *hi2c);
  445. void HAL_I2C_MasterTxCpltCallback(I2C_HandleTypeDef *hi2c);
  446. void HAL_I2C_MasterRxCpltCallback(I2C_HandleTypeDef *hi2c);
  447. void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *hi2c);
  448. void HAL_I2C_SlaveRxCpltCallback(I2C_HandleTypeDef *hi2c);
  449. void HAL_I2C_AddrCallback(I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, uint16_t AddrMatchCode);
  450. void HAL_I2C_ListenCpltCallback(I2C_HandleTypeDef *hi2c);
  451. void HAL_I2C_MemTxCpltCallback(I2C_HandleTypeDef *hi2c);
  452. void HAL_I2C_MemRxCpltCallback(I2C_HandleTypeDef *hi2c);
  453. void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2c);
  454. void HAL_I2C_AbortCpltCallback(I2C_HandleTypeDef *hi2c);


  457. /*外围状态，模式和错误功能*********************************/
  458. HAL_I2C_StateTypeDef HAL_I2C_GetState(I2C_HandleTypeDef *hi2c);
  459. HAL_I2C_ModeTypeDef  HAL_I2C_GetMode(I2C_HandleTypeDef *hi2c);
  460. uint32_t             HAL_I2C_GetError(I2C_HandleTypeDef *hi2c);




  465. /*I2C专用宏*/
  466. #define IS_I2C_ADDRESSING_MODE(MODE)    (((MODE) == I2C_ADDRESSINGMODE_7BIT) || \
  467.                                          ((MODE) == I2C_ADDRESSINGMODE_10BIT))

  469. #define IS_I2C_DUAL_ADDRESS(ADDRESS)    (((ADDRESS) == I2C_DUALADDRESS_DISABLE) || \
  470.                                          ((ADDRESS) == I2C_DUALADDRESS_ENABLE))

  472. #define IS_I2C_OWN_ADDRESS2_MASK(MASK)  (((MASK) == I2C_OA2_NOMASK)  || \
  473.                                          ((MASK) == I2C_OA2_MASK01) || \
  474.                                          ((MASK) == I2C_OA2_MASK02) || \
  475.                                          ((MASK) == I2C_OA2_MASK03) || \
  476.                                          ((MASK) == I2C_OA2_MASK04) || \
  477.                                          ((MASK) == I2C_OA2_MASK05) || \
  478.                                          ((MASK) == I2C_OA2_MASK06) || \
  479.                                          ((MASK) == I2C_OA2_MASK07))

  481. #define IS_I2C_GENERAL_CALL(CALL)       (((CALL) == I2C_GENERALCALL_DISABLE) || \
  482.                                          ((CALL) == I2C_GENERALCALL_ENABLE))

  484. #define IS_I2C_NO_STRETCH(STRETCH)      (((STRETCH) == I2C_NOSTRETCH_DISABLE) || \
  485.                                          ((STRETCH) == I2C_NOSTRETCH_ENABLE))

  487. #define IS_I2C_MEMADD_SIZE(SIZE)        (((SIZE) == I2C_MEMADD_SIZE_8BIT) || \
  488.                                          ((SIZE) == I2C_MEMADD_SIZE_16BIT))

  490. #define IS_TRANSFER_MODE(MODE)          (((MODE) == I2C_RELOAD_MODE)   || \
  491.                                          ((MODE) == I2C_AUTOEND_MODE) || \
  492.                                          ((MODE) == I2C_SOFTEND_MODE))

  494. #define IS_TRANSFER_REQUEST(REQUEST)    (((REQUEST) == I2C_GENERATE_STOP)        || \
  495.                                          ((REQUEST) == I2C_GENERATE_START_READ)  || \
  496.                                          ((REQUEST) == I2C_GENERATE_START_WRITE) || \
  497.                                          ((REQUEST) == I2C_NO_STARTSTOP))

  499. #define IS_I2C_TRANSFER_OPTIONS_REQUEST(REQUEST)  (((REQUEST) == I2C_FIRST_FRAME)          || \
  500.                                                    ((REQUEST) == I2C_FIRST_AND_NEXT_FRAME) || \
  501.                                                    ((REQUEST) == I2C_NEXT_FRAME)           || \
  502.                                                    ((REQUEST) == I2C_FIRST_AND_LAST_FRAME) || \
  503.                                                    ((REQUEST) == I2C_LAST_FRAME)           || \
  504.                                                    ((REQUEST) == I2C_LAST_FRAME_NO_STOP)   || \
  505.                                                    IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(REQUEST))

  507. #define IS_I2C_TRANSFER_OTHER_OPTIONS_REQUEST(REQUEST) (((REQUEST) == I2C_OTHER_FRAME)     || \
  508.                                                         ((REQUEST) == I2C_OTHER_AND_LAST_FRAME))

  510. #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)))

  512. #define I2C_GET_ADDR_MATCH(__HANDLE__)            ((uint16_t)(((__HANDLE__)->Instance->ISR & I2C_ISR_ADDCODE) >> 16U))
  513. #define I2C_GET_DIR(__HANDLE__)                   ((uint8_t)(((__HANDLE__)->Instance->ISR & I2C_ISR_DIR) >> 16U))
  514. #define I2C_GET_STOP_MODE(__HANDLE__)             ((__HANDLE__)->Instance->CR2 & I2C_CR2_AUTOEND)
  515. #define I2C_GET_OWN_ADDRESS1(__HANDLE__)          ((uint16_t)((__HANDLE__)->Instance->OAR1 & I2C_OAR1_OA1))
  516. #define I2C_GET_OWN_ADDRESS2(__HANDLE__)          ((uint16_t)((__HANDLE__)->Instance->OAR2 & I2C_OAR2_OA2))

  518. #define IS_I2C_OWN_ADDRESS1(ADDRESS1)             ((ADDRESS1) <= 0x000003FFU)
  519. #define IS_I2C_OWN_ADDRESS2(ADDRESS2)             ((ADDRESS2) <= (uint16_t)0x00FFU)

  521. #define I2C_MEM_ADD_MSB(__ADDRESS__)              ((uint8_t)((uint16_t)(((uint16_t)((__ADDRESS__) & (uint16_t)(0xFF00U))) >> 8U)))
  522. #define I2C_MEM_ADD_LSB(__ADDRESS__)              ((uint8_t)((uint16_t)((__ADDRESS__) & (uint16_t)(0x00FFU))))

  524. #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)) : \
  525.                                                           (uint32_t)((((uint32_t)(__ADDRESS__) & (I2C_CR2_SADD)) | (I2C_CR2_ADD10) | (I2C_CR2_START)) & (~I2C_CR2_RD_WRN)))

  527. #define I2C_CHECK_FLAG(__ISR__, __FLAG__)         ((((__ISR__) & ((__FLAG__) & I2C_FLAG_MASK)) == ((__FLAG__) & I2C_FLAG_MASK)) ? SET : RESET)
  528. #define I2C_CHECK_IT_SOURCE(__CR1__, __IT__)      ((((__CR1__) & (__IT__)) == (__IT__)) ? SET : RESET)

复制代码



赞 收藏 评论0 发布时间：2020-3-22 07:29

举报

0个回答

所属标签

STM32团队

STM32团队

意法半导体微控制器和微处理器拥有广泛的产品线，包含低成本的8位单片机和基于ARM® Cortex®-M0、M0+、M3、M4、M33、M7及A7内核并具备丰富外设选择的32位微控制器及微处理器

最新内容

关于
意法半导体
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
STM32N6 AI生态系统
STM32MCU,MPU高性能GUI
ST ACEPACK电源模块
意法半导体生物传感器
STM32Cube扩展软件包
关注我们
st-img 微信公众号
st-img 手机版