我之前出过一篇关于STM32设置为I2C从机的博客,现在应粉丝要求,出一篇HAL库版本的I2C从机编程。
基于官方库版本的可以看下我之前发的文章:STM32设置为I2C从机模式
1 硬件连接
测试方法:用一个USB转I2C的工具接到STM32的I2C引脚上,通过上位机工具进行读写操作。如果没有这个工具,也可以用另外一组I2C作为主机或者其他设备测试通讯,同时也可以借助示波器或者逻辑分析仪来辅助调试。
硬件连接:
STM32这边使用硬件I2C1(PB6、PB7),并外接上拉电阻。
本次测试中使用的USB转I2C的工具如下图所示:
2 软件编程
2.1 步骤分解
1、初始化I2C配置
注:除了最后的HAL_I2C_EnableListen_IT()函数,其他代码都可以用STM32CubeMX自动生成
参考代码:
static void MX_I2C1_Init(void)
{
hi2c1.Instance = I2C1; // 配置I2C1
hi2c1.Init.ClockSpeed = 100000; // 时钟频率:100k
hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2; // 占空比:1/2
hi2c1.Init.OwnAddress1 = 0x80; // 本机地址:0x80(若作为从设备则是从机地址)
hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT; // 地址模式:7位
hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE; // 禁止双地址
hi2c1.Init.OwnAddress2 = 0; // 第二地址
hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE; // 禁止广播
hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE; // 禁止时钟拉伸
if (HAL_I2C_Init(&hi2c1) != HAL_OK) // I2C1初始化
{
Error_Handler();
}
HAL_I2C_EnableListen_IT(&hi2c1); // 使能I2C1的侦听中断
}
2、初始化I2C引脚和中断
参考代码:
注:这个代码可以用STM32CubeMX自动生成
void HAL_I2C_MspInit(I2C_HandleTypeDef* hi2c)
{
GPIO_InitTypeDef GPIO_InitStruct = {0};
if(hi2c->Instance==I2C1)
{
// 配置GPIO
__HAL_RCC_GPIOB_CLK_ENABLE();
GPIO_InitStruct.Pin = GPIO_PIN_6|GPIO_PIN_7;
GPIO_InitStruct.Mode = GPIO_MODE_AF_OD;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF4_I2C1;
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
// 配置I2C中断
/* Peripheral clock enable */
__HAL_RCC_I2C1_CLK_ENABLE();
/* I2C1 interrupt Init */
HAL_NVIC_SetPriority(I2C1_EV_IRQn, 0, 0); // 事件中断(必须有)
HAL_NVIC_EnableIRQ(I2C1_EV_IRQn);
HAL_NVIC_SetPriority(I2C1_ER_IRQn, 0, 0); // 错误中断(非必须)
HAL_NVIC_EnableIRQ(I2C1_ER_IRQn);
}
}
3、配置I2C中断服务函数
参考代码:
注:这个代码可以用STM32CubeMX自动生成
// I2C1事件中断服务函数(必须有)
void I2C1_EV_IRQHandler(void)
{
HAL_I2C_EV_IRQHandler(&hi2c1);
}
// I2C1错误中断服务函数(非必须)
void I2C1_ER_IRQHandler(void)
{
HAL_I2C_ER_IRQHandler(&hi2c1);
}
4、配置I2C从机回调处理函数
参考代码:
static uint8_t ram[256]; // 模拟I2C从机数据寄存器(主机读写的数据都放在这块内存)
uint8_t offset; // 从机寄存器当前偏移地址
static uint8_t first_byte_state = 1; // 是否收到第1个字节,也就是偏移地址(0:已收到,1:没有收到)
// 侦听完成回调函数(完成一次完整的i2c通信以后会进入该函数)
void HAL_I2C_ListenCpltCallback(I2C_HandleTypeDef *hi2c)
{
// 完成一次通信,清除状态
first_byte_state = 1;
offset = 0;
HAL_I2C_EnableListen_IT(hi2c); // slave is ready again
}
// I2C设备地址回调函数(地址匹配上以后会进入该函数)
void HAL_I2C_AddrCallback(I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, uint16_t AddrMatchCode)
{
if(TransferDirection == I2C_DIRECTION_TRANSMIT)
{// 主机发送,从机接收
if(first_byte_state)
{// 准备接收第1个字节数据
HAL_I2C_Slave_Seq_Receive_IT(hi2c, &offset, 1, I2C_NEXT_FRAME); // 每次第1个数据均为偏移地址
}
}
else
{// 主机接收,从机发送
HAL_I2C_Slave_Seq_Transmit_IT(hi2c, &ram[offset], 1, I2C_NEXT_FRAME); // 打开中断并把ram[]里面对应的数据发送给主机
}
}
// I2C数据接收回调函数(在I2C完成一次接收时会关闭中断并调用该函数,因此在处理完成后需要手动重新打开中断)
void HAL_I2C_SlaveRxCpltCallback(I2C_HandleTypeDef *hi2c)
{
if(first_byte_state)
{// 收到的第1个字节数据(偏移地址)
first_byte_state = 0;
}
else
{// 收到的第N个字节数据
offset++; // 每收到一个数据,偏移+1
}
// 打开I2C中断接收,下一个收到的数据将存放到ram[offset]
HAL_I2C_Slave_Seq_Receive_IT(hi2c, &ram[offset], sizeof(ram), I2C_NEXT_FRAME); // 接收数据存到ram[]里面对应的位置
}
// I2C数据发送回调函数(在I2C完成一次发送后会关闭中断并调用该函数,因此在处理完成后需要手动重新打开中断)
void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *hi2c)
{
offset++; // 每发送一个数据,偏移+1
HAL_I2C_Slave_Seq_Transmit_IT(hi2c, &ram[offset], sizeof(ram), I2C_NEXT_FRAME); // 打开中断并把ram[]里面对应的数据发送给主机
}
2.2 测试用例
1、测试方法
使用USB转I2C的工具接入到MCU的I2C上面,然后使用上位机工具进行读写操作,最后通过串口把I2C通讯过程中的几个重要节点打印出来,验证结果是否正确。
2、测试程序
其实和上面讲解的代码是一样的,只是初始化时先把ram[]赋初值。
参考测试代码:
#include "stm32f1xx_hal.h"
static uint8_t ram[256]; // 模拟I2C从机数据寄存器(主机读写的数据都放在这块内存)
uint8_t offset; // 从机寄存器当前偏移地址
static uint8_t first_byte_state = 1; // 是否收到第1个字节,也就是偏移地址(0:已收到,1:没有收到)
// 侦听完成回调函数(完成一次完整的i2c通信以后会进入该函数)
void HAL_I2C_ListenCpltCallback(I2C_HandleTypeDef *hi2c)
{
// 完成一次通信,清除状态
first_byte_state = 1;
offset = 0;
HAL_I2C_EnableListen_IT(hi2c); // slave is ready again
}
// I2C设备地址回调函数(地址匹配上以后会进入该函数)
void HAL_I2C_AddrCallback(I2C_HandleTypeDef *hi2c, uint8_t TransferDirection, uint16_t AddrMatchCode)
{
if(TransferDirection == I2C_DIRECTION_TRANSMIT)
{// 主机发送,从机接收
if(first_byte_state)
{// 准备接收第1个字节数据
HAL_I2C_Slave_Seq_Receive_IT(hi2c, &offset, 1, I2C_NEXT_FRAME); // 每次第1个数据均为偏移地址
}
}
else
{// 主机接收,从机发送
HAL_I2C_Slave_Seq_Transmit_IT(hi2c, &ram[offset], 1, I2C_NEXT_FRAME); // 打开中断并把ram[]里面对应的数据发送给主机
}
}
// I2C数据接收回调函数(在I2C完成一次接收时会关闭中断并调用该函数,因此在处理完成后需要手动重新打开中断)
void HAL_I2C_SlaveRxCpltCallback(I2C_HandleTypeDef *hi2c)
{
if(first_byte_state)
{// 收到的第1个字节数据(偏移地址)
first_byte_state = 0;
}
else
{// 收到的第N个字节数据
offset++; // 每收到一个数据,偏移+1
}
// 打开I2C中断接收,下一个收到的数据将存放到ram[offset]
HAL_I2C_Slave_Seq_Receive_IT(hi2c, &ram[offset], sizeof(ram), I2C_NEXT_FRAME); // 接收数据存到ram[]里面对应的位置
}
// I2C数据发送回调函数(在I2C完成一次发送后会关闭中断并调用该函数,因此在处理完成后需要手动重新打开中断)
void HAL_I2C_SlaveTxCpltCallback(I2C_HandleTypeDef *hi2c)
{
offset++; // 每发送一个数据,偏移+1
HAL_I2C_Slave_Seq_Transmit_IT(hi2c, &ram[offset], sizeof(ram), I2C_NEXT_FRAME); // 打开中断并把ram[]里面对应的数据发送给主机
}
// 测试用例:初始化把ram设置为从0到255的数
void i2c_test(void)
{
for (uint16_t i = 0; i < 256; i++)
{
ram[i] = i;
}
}
3 运行测试
3.1 I2C连续写入
通过上位机工具写入:
通过逻辑分析仪抓取波形:
3.2 I2C连续读取
通过上位机工具连续读取256字节:
通过逻辑分析仪抓取波形:
3.3 I2C单次读写测试
通过上位机工具读取原值,再写入新值,最后再读取新值:
通过逻辑分析仪抓取波形:
4 总结
通过上位机工具的测试以及逻辑分析仪的解析,STM32的硬件I2C从机通信正常且稳定,读写速度测试了100k和400k,没有发现问题,至此测试完成。
好了,关于STM32如何设置从机模式就介绍到这里,如果你们有什么问题,欢迎评论区留言。
需要完整源码工程的同学可以自行下载:源码下载地址
如果这篇文章能够帮到你,就…懂的。