i2c.h 4.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115
  1. /******************************************************************************
  2. * Copyright (C) 2021, Xiaohua Semiconductor Co., Ltd. All rights reserved.
  3. *
  4. * This software component is licensed by XHSC under BSD 3-Clause license
  5. * (the "License"); You may not use this file except in compliance with the
  6. * License. You may obtain a copy of the License at:
  7. * opensource.org/licenses/BSD-3-Clause
  8. *
  9. ******************************************************************************/
  10. /******************************************************************************
  11. * @file i2c.h
  12. *
  13. * @brief Header file for I2C functions
  14. *
  15. * @author MADS Team
  16. *
  17. ******************************************************************************/
  18. #ifndef __I2C_H__
  19. #define __I2C_H__
  20. #include "ddl.h"
  21. /**
  22. *******************************************************************************
  23. ** \defgroup I2cGroup Inter-Integrated Circuit (I2C)
  24. **
  25. **
  26. ******************************************************************************/
  27. //@{
  28. /******************************************************************************/
  29. /* Global pre-processor symbols/macros ('#define') */
  30. /******************************************************************************/
  31. /******************************************************************************
  32. * Global type definitions
  33. ******************************************************************************/
  34. /**
  35. ******************************************************************************
  36. ** \brief I2C功能配置
  37. *****************************************************************************/
  38. typedef enum en_i2c_func
  39. {
  40. I2cModule_En = 6u, ///<I2C模块使能
  41. I2cStart_En = 5u, ///<开始信号
  42. I2cStop_En = 4u, ///<结束信号
  43. I2cAck_En = 2u, ///<应答信号
  44. I2cHlm_En = 0u, ///<高速使能
  45. }en_i2c_func_t;
  46. /**
  47. ******************************************************************************
  48. ** \brief I2C模式配置
  49. *****************************************************************************/
  50. typedef enum en_i2c_mode
  51. {
  52. I2cMasterMode = 0x40u, ///<I2C主机模式
  53. I2cSlaveMode = 0x44u, ///<I2C从机模式
  54. }en_i2c_mode_t;
  55. /**
  56. ******************************************************************************
  57. ** \brief I2C初始化配置结构
  58. *****************************************************************************/
  59. typedef struct stc_i2c_cfg
  60. {
  61. uint32_t u32Pclk; ///<Pclk 设置(Hz)
  62. uint32_t u32Baud; ///<I2C通信波特率(Hz)
  63. en_i2c_mode_t enMode; ///<I2C主从模式配置
  64. uint8_t u8SlaveAddr; ///<从机地址配置(如果需要)
  65. boolean_t bGc; ///<广播地址使能(如果需要)
  66. }stc_i2c_cfg_t;
  67. /******************************************************************************
  68. * Global variable declarations ('extern', definition in C source)
  69. *****************************************************************************/
  70. /******************************************************************************
  71. * Global function prototypes (definition in C source)
  72. *****************************************************************************/
  73. //I2C初始化函数
  74. en_result_t I2C_Init(M0P_I2C_TypeDef* I2Cx,stc_i2c_cfg_t *pstcI2CCfg);
  75. //设置波特率配置寄存器
  76. en_result_t I2C_SetBaud(M0P_I2C_TypeDef* I2Cx,uint8_t u8Tm);
  77. //I2C功能设置函数
  78. en_result_t I2C_SetFunc(M0P_I2C_TypeDef* I2Cx,en_i2c_func_t enFunc);
  79. //I2C功能清除函数
  80. en_result_t I2C_ClearFunc(M0P_I2C_TypeDef* I2Cx,en_i2c_func_t enFunc);
  81. //获取中断标记SI
  82. boolean_t I2C_GetIrq(M0P_I2C_TypeDef* I2Cx);
  83. //清除中断标记SI
  84. en_result_t I2C_ClearIrq(M0P_I2C_TypeDef* I2Cx);
  85. //获取状态
  86. uint8_t I2C_GetState(M0P_I2C_TypeDef* I2Cx);
  87. //字节写函数
  88. en_result_t I2C_WriteByte(M0P_I2C_TypeDef* I2Cx,uint8_t u8Data);
  89. //字节读函数
  90. uint8_t I2C_ReadByte(M0P_I2C_TypeDef* I2Cx);
  91. //@} // I2cGroup
  92. #ifdef __cplusplus
  93. #endif
  94. #endif /* __I2C_H__ */
  95. /******************************************************************************
  96. * EOF (not truncated)
  97. *****************************************************************************/