107 lines
3.6 KiB
C
107 lines
3.6 KiB
C
#include "i2c.h"
|
|
#include "stdint.h"
|
|
|
|
#define IIC_DEVICE_CNT 2 // C板引出了I2C2和I2C3
|
|
#define MX_IIC_SLAVE_CNT 8 // 最大从机数目,根据需要修改
|
|
|
|
/* i2c 工作模式枚举 */
|
|
typedef enum
|
|
{
|
|
// 基本工作模式
|
|
IIC_BLOCK_MODE = 0, // 阻塞模式
|
|
IIC_IT_MODE, // 中断模式
|
|
IIC_DMA_MODE, // DMA模式
|
|
|
|
} IIC_Work_Mode_e;
|
|
|
|
/* I2C MEM工作模式枚举,这两种方法都是阻塞 */
|
|
typedef enum
|
|
{
|
|
IIC_READ_MEM = 0, // 读取从机内部的寄存器or内存
|
|
IIC_WRITE_MEM, // 写入从机内部的寄存器or内存
|
|
} IIC_Mem_Mode_e;
|
|
|
|
/* Seq传输工作模式枚举,注意HOLD_ON要在IT或DMA下使用 */
|
|
// 必须以IIC_RELEASE为最后一次传输,否则会导致总线占有权无法释放
|
|
typedef enum
|
|
{
|
|
IIC_SEQ_RELEASE, // 完成传输后释放总线占有权,这是默认的传输方式
|
|
IIC_SEQ_HOLDON = 0, // 保持总线占有权不释放,只支持IT和DMA模式
|
|
} IIC_Seq_Mode_e;
|
|
|
|
/* i2c实例 */
|
|
typedef struct iic_temp_s
|
|
{
|
|
I2C_HandleTypeDef *handle; // i2c handle
|
|
uint8_t dev_address; // 暂时只支持7位地址(还有一位是读写位)
|
|
|
|
IIC_Work_Mode_e work_mode; // 工作模式
|
|
uint8_t *rx_buffer; // 接收缓冲区指针
|
|
uint8_t rx_len; // 接收长度
|
|
void (*callback)(struct iic_temp_s *); // 接收完成后的回调函数
|
|
|
|
void *id; // 用于标识i2c instance
|
|
} IICInstance;
|
|
|
|
/* I2C 初始化结构体配置 */
|
|
typedef struct
|
|
{
|
|
I2C_HandleTypeDef *handle; // i2c handle
|
|
uint8_t dev_address; // 暂时只支持7位地址(还有一位是读写位),注意不需要左移
|
|
IIC_Work_Mode_e work_mode; // 工作模式
|
|
void (*callback)(IICInstance *); // 接收完成后的回调函数
|
|
void *id; // 用于标识i2c instance
|
|
} IIC_Init_Config_s;
|
|
|
|
/**
|
|
* @brief IIC初始化
|
|
*
|
|
* @param conf 初始化配置
|
|
* @return IICInstance*
|
|
*/
|
|
IICInstance *IICRegister(IIC_Init_Config_s *conf);
|
|
|
|
/**
|
|
* @brief IIC设置工作模式
|
|
*
|
|
* @param iic 要设置的iic实例
|
|
* @param mode 工作模式
|
|
*/
|
|
void IICSetMode(IICInstance *iic, IIC_Work_Mode_e mode);
|
|
|
|
/**
|
|
* @brief IIC发送数据
|
|
*
|
|
* @param iic iic实例
|
|
* @param data 待发送的数据首地址指针
|
|
* @param size 发送长度
|
|
* @param mode 序列传输模式
|
|
* @note 注意,如果发送结构体,那么该结构体在声明时务必使用#pragma pack(1)进行对齐,并在声明结束后使用#pragma pack()恢复对齐
|
|
*
|
|
*/
|
|
void IICTransmit(IICInstance *iic, uint8_t *data, uint16_t size, IIC_Seq_Mode_e mode);
|
|
|
|
/**
|
|
* @brief IIC接收数据
|
|
*
|
|
* @param iic iic实例
|
|
* @param data 接收数据的首地址指针
|
|
* @param size 接收长度
|
|
* @param mode 序列传输模式
|
|
* @note 注意,如果直接将接收数据memcpy到目标结构体或通过强制类型转换进行逐字节写入,
|
|
* 那么该结构体在声明时务必使用#pragma pack(1)进行对齐,并在声明结束后使用#pragma pack()恢复对齐
|
|
*/
|
|
void IICReceive(IICInstance *iic, uint8_t *data, uint16_t size, IIC_Seq_Mode_e mode);
|
|
|
|
/**
|
|
* @brief IIC读取从机寄存器(内存),只支持阻塞模式,超时默认为1ms
|
|
*
|
|
* @param iic iic实例
|
|
* @param mem_addr 要读取的从机内存地址,目前只支持8位地址
|
|
* @param data 要读取或写入的数据首地址指针
|
|
* @param size 要读取或写入的数据长度
|
|
* @param mode 写入或读取模式: IIC_READ_MEM or IIC_WRITE_MEM
|
|
* @param mem8bit_flag 从机内存地址是否为8位
|
|
*/
|
|
void IICAccessMem(IICInstance *iic, uint16_t mem_addr, uint8_t *data, uint16_t size, IIC_Mem_Mode_e mode, uint8_t mem8bit_flag);
|