AimBot/Gimbal
14
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

第一次提交

Browse Source
This commit is contained in:
李傲琦
2026-05-29 17:36:34 +08:00
commit 5b3333125d
1318 changed files with 722705 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
bsp/iic/bsp_iic.c
+151
View File
@@ -0,0 +1,151 @@
#include "bsp_iic.h"
#include "memory.h"
#include "stdlib.h"
static uint8_t idx = 0; // 配合中断以及初始化
static IICInstance *iic_instance[IIC_DEVICE_CNT] = {NULL};
IICInstance *IICRegister(IIC_Init_Config_s *conf)
{
if (idx >= MX_IIC_SLAVE_CNT) // 超过最大实例数
while (1) // 酌情增加允许的实例上限,也有可能是内存泄漏
;
// 申请到的空间未必是0, 所以需要手动初始化
IICInstance *instance = (IICInstance *)malloc(sizeof(IICInstance));
instance = (IICInstance *)malloc(sizeof(IICInstance));
memset(instance, 0, sizeof(IICInstance));
instance->dev_address = conf->dev_address << 1; // 地址左移一位,最低位为读写位
instance->callback = conf->callback;
instance->work_mode = conf->work_mode;
instance->handle = conf->handle;
instance->id = conf->id;
iic_instance[idx++] = instance;
return instance;
}
void IICSetMode(IICInstance *iic, IIC_Work_Mode_e mode)
{ // HAL自带重入保护,不需要手动终止或等待传输完成
if (iic->work_mode != mode)
{
iic->work_mode = mode; // 如果不同才需要修改
}
}
void IICTransmit(IICInstance *iic, uint8_t *data, uint16_t size, IIC_Seq_Mode_e seq_mode)
{
if (seq_mode != IIC_SEQ_RELEASE && seq_mode != IIC_SEQ_HOLDON)
while (1)
; // 未知传输模式, 程序停止
// 根据不同的工作模式进行不同的传输
switch (iic->work_mode)
{
case IIC_BLOCK_MODE:
if (seq_mode != IIC_SEQ_RELEASE)
while (1)
; // 阻塞模式下不支持HOLD ON模式!!!只能传输完成后立刻释放总线
HAL_I2C_Master_Transmit(iic->handle, iic->dev_address, data, size, 100); // 默认超时时间100ms
break;
case IIC_IT_MODE:
if (seq_mode == IIC_SEQ_RELEASE)
HAL_I2C_Master_Seq_Transmit_IT(iic->handle, iic->dev_address, data, size, I2C_OTHER_AND_LAST_FRAME);
else if (seq_mode == IIC_SEQ_HOLDON)
HAL_I2C_Master_Seq_Transmit_IT(iic->handle, iic->dev_address, data, size, I2C_OTHER_FRAME);
break;
case IIC_DMA_MODE:
if (seq_mode == IIC_SEQ_RELEASE)
HAL_I2C_Master_Seq_Transmit_DMA(iic->handle, iic->dev_address, data, size, I2C_OTHER_AND_LAST_FRAME);
else if (seq_mode == IIC_SEQ_HOLDON)
HAL_I2C_Master_Seq_Transmit_DMA(iic->handle, iic->dev_address, data, size, I2C_OTHER_FRAME);
break;
default:
while (1)
; // 未知传输模式, 程序停止
}
}
void IICReceive(IICInstance *iic, uint8_t *data, uint16_t size, IIC_Seq_Mode_e seq_mode)
{
if (seq_mode != IIC_SEQ_RELEASE && seq_mode != IIC_SEQ_HOLDON)
while (1)
; // 未知传输模式, 程序停止,请检查指针越界
// 初始化接收缓冲区地址以及接受长度, 用于中断回调函数
iic->rx_buffer = data;
iic->rx_len = size;
switch (iic->work_mode)
{
case IIC_BLOCK_MODE:
if (seq_mode != IIC_SEQ_RELEASE)
while (1)
; // 阻塞模式下不支持HOLD ON模式!!!
HAL_I2C_Master_Receive(iic->handle, iic->dev_address, data, size, 100); // 默认超时时间100ms
break;
case IIC_IT_MODE:
if (seq_mode == IIC_SEQ_RELEASE)
HAL_I2C_Master_Seq_Receive_IT(iic->handle, iic->dev_address, data, size, I2C_OTHER_AND_LAST_FRAME);
else if (seq_mode == IIC_SEQ_HOLDON)
HAL_I2C_Master_Seq_Receive_IT(iic->handle, iic->dev_address, data, size, I2C_OTHER_FRAME);
break;
case IIC_DMA_MODE:
if (seq_mode == IIC_SEQ_RELEASE)
HAL_I2C_Master_Seq_Receive_DMA(iic->handle, iic->dev_address, data, size, I2C_OTHER_AND_LAST_FRAME);
else if (seq_mode == IIC_SEQ_HOLDON)
HAL_I2C_Master_Seq_Receive_DMA(iic->handle, iic->dev_address, data, size, I2C_OTHER_FRAME);
break;
default:
while (1)
; // 未知传输模式, 程序停止
break;
}
}
void IICAccessMem(IICInstance *iic, uint16_t mem_addr, uint8_t *data, uint16_t size, IIC_Mem_Mode_e mem_mode, uint8_t mem8bit_flag)
{
uint16_t bit_flag = mem8bit_flag ? I2C_MEMADD_SIZE_8BIT : I2C_MEMADD_SIZE_16BIT;
if (mem_mode == IIC_WRITE_MEM)
{
HAL_I2C_Mem_Write(iic->handle, iic->dev_address, mem_addr, bit_flag, data, size, 100);
}
else if (mem_mode == IIC_READ_MEM)
{
HAL_I2C_Mem_Read(iic->handle, iic->dev_address, mem_addr, bit_flag, data, size, 100);
}
else
{
while (1)
; // 未知模式, 程序停止
}
}
/**
* @brief IIC接收完成回调函数
*
* @param hi2c handle
*/
void HAL_I2C_MasterRxCpltCallback(I2C_HandleTypeDef *hi2c)
{
// 如果是当前i2c硬件发出的complete,且dev_address和之前发起接收的地址相同,同时回到函数不为空, 则调用回调函数
for (uint8_t i = 0; i < idx; i++)
{
if (iic_instance[i]->handle == hi2c && hi2c->Devaddress == iic_instance[i]->dev_address)
{
if (iic_instance[i]->callback != NULL) // 回调函数不为空
iic_instance[i]->callback(iic_instance[i]);
return;
}
}
}
/**
* @brief 内存访问回调函数,仅做形式上的封装,仍然使用HAL_I2C_MasterRxCpltCallback
*
* @param hi2c handle
*/
void HAL_I2C_MemRxCpltCallback(I2C_HandleTypeDef *hi2c)
{
HAL_I2C_MasterRxCpltCallback(hi2c);
}
bsp/iic/bsp_iic.h
+106
View File
@@ -0,0 +1,106 @@
#include "i2c.h"
#include "stdint.h"
#define IIC_DEVICE_CNT 1 // MC02只有1个I2C接口可用，
#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);
bsp/iic/bsp_iic.md
+19
View File
@@ -0,0 +1,19 @@
# bsp iic
> 预计增加模拟iic
## 注意事项
使用时写入地址，不需要左移！！！
cubemx未配置dma时请勿使用dma传输，其行为是未定义的。
## 总线机制详解
关于I2C的序列传输,Restart condition和总线仲裁,请看:
https://blog.csdn.net/NeoZng/article/details/128496694
https://blog.csdn.net/NeoZng/article/details/128486366
使用序列通信则在单次通信后不会释放总线,继续占用直到调用传输函数时传入`IIC_RELEASE`参数. 这个功能只在一条总线上挂载多个主机的时候有用.