概述
I2C 常用在某些型号的传感器和 MCU 的连接，速率要求不高，距离很短，使用简便。
I2C的通信基础知识请参见《基础通信协议之 IIC详细讲解 - 知乎》。
PY32F003 可以复用出一个 I2C 接口（PA3：SCL，PA2：SDA），可以和 DMA 配合完成 I2C 的主从通信。厂家的数据手册对 I2C 接口简述如下图。
要完成 I2C 的通信实验需要两个 MCU。这里现尝试着配置好 I2C 的从机，下一篇再配置 I2C 的主机，并完成两者的通信实验。
代码实现的步骤
1. 在 py32f0xx_hal_conf.h 文件中增加对 I2C 的引用
在 Exported constances 一节中将 #define HAL_I2C_MODULE_ENABLED 的注释打开，打开对 I2C 功能的引用函数。打开后的代码节选如下。
/* Exported constants --------------------------------------------------------*/
/* ########################## Module Selection ############################## */
/**
* @brief This is the list of modules to be used in the HAL driver
*/
#define HAL_MODULE_ENABLED
#define HAL_RCC_MODULE_ENABLED
#define HAL_ADC_MODULE_ENABLED
//#define HAL_CRC_MODULE_ENABLED
//#define HAL_COMP_MODULE_ENABLED
#define HAL_FLASH_MODULE_ENABLED
#define HAL_GPIO_MODULE_ENABLED
//#define HAL_IWDG_MODULE_ENABLED
//#define HAL_WWDG_MODULE_ENABLED
#define HAL_TIM_MODULE_ENABLED
#define HAL_DMA_MODULE_ENABLED
#define HAL_LPTIM_MODULE_ENABLED
#define HAL_PWR_MODULE_ENABLED
#define HAL_I2C_MODULE_ENABLED
#define HAL_UART_MODULE_ENABLED
//#define HAL_SPI_MODULE_ENABLED
//#define HAL_RTC_MODULE_ENABLED
//#define HAL_LED_MODULE_ENABLED
//#define HAL_EXTI_MODULE_ENABLED
#define HAL_CORTEX_MODULE_ENABLED
/* ########################## Oscillator Values adaptation ####################*/2. 在 main.h 中添加 I2C 相关的函数声明
/** ----------------------------------------------------------------------------
* @name : HAL_StatusTypeDef app_i2c_init(void);
* @brief : i2c 初始化
* @param :
* @retval : HAL_OK: 写入成功; 其它: 错误
* @remark : 上级函数必须检查操作返回值, 只有 HAL_OK 时才可继续操作
*** ----------------------------------------------------------------------------
*/
HAL_StatusTypeDef app_i2c_init(void);
/** ----------------------------------------------------------------------------
* @brief : i2c 测试使用的三个函数, 接收/发送/等待
* @param :
* @retval :
* @remark :
*** ----------------------------------------------------------------------------
*/
HAL_StatusTypeDef app_i2c_receive(void);
HAL_StatusTypeDef app_i2c_transmit(void);
void app_i2c_wait(void);3. 在 app_i2c.c 中实现这些函数
在 Application/User 组中增加一个 app_i2c.c 文件。
/**
******************************************************************************
* @file app_i2c.c
* @brief I2C functions.
******************************************************************************
* @copyright
*
* Copyright (c) 2023 CuteModem Intelligence.
* All rights reserved.
*
* This software is licensed under terms that can be found in the LICENSE file
* in the root directory of this software component.
* If no LICENSE file comes with this software, it is provided AS-IS.
*
******************************************************************************
*/
#include "main.h"
#define EXDATA_LEN 15 // 数据长度
#define I2C_ADDRESS 0xA0 // 本机地址0xA0
#define I2C_SPEEDBPS 100000 // 通讯速度100K
#define I2C_DUTYCYCLE I2C_DUTYCYCLE_16_9 // 占空比
I2C_HandleTypeDef I2cHandle;
uint8_t mI2cTxBuf[EXDATA_LEN] = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15};
uint8_t mI2cRxBuf[EXDATA_LEN] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
HAL_StatusTypeDef app_i2c_init(void)
{
HAL_StatusTypeDef cfg_res = HAL_OK;
I2cHandle.Instance = I2C; // I2C
I2cHandle.Init.ClockSpeed = I2C_SPEEDBPS; // I2C 通讯速度
I2cHandle.Init.DutyCycle = I2C_DUTYCYCLE; // I2C 占空比
I2cHandle.Init.OwnAddress1 = I2C_ADDRESS; // I2C 地址
I2cHandle.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE; // 禁止广播呼叫
I2cHandle.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE; // 允许时钟延长
cfg_res = HAL_I2C_Init(&I2cHandle); //I2C初始化
if (cfg_res != HAL_OK) return cfg_res;
return cfg_res;
}
HAL_StatusTypeDef app_i2c_receive(void)
{
/*I2C从机中断方式接收*/
while (HAL_I2C_Slave_Receive_IT(&I2cHandle, (uint8_t *)mI2cRxBuf, EXDATA_LEN) != HAL_OK)
{
Error_Handler();
}
return HAL_OK;
}
HAL_StatusTypeDef app_i2c_transmit(void)
{
/*I2C从机中断方式发送*/
while (HAL_I2C_Slave_Transmit_IT(&I2cHandle, (uint8_t *)mI2cTxBuf, EXDATA_LEN) != HAL_OK)
{
Error_Handler();
}
return HAL_OK;
}
void app_i2c_wait(void)
{
/* 判断当前I2C状态, 等待I2C状态就绪 */
while (HAL_I2C_GetState(&I2cHandle) != HAL_I2C_STATE_READY);
}
首先定义了4个常量。
- 交换数据的长度 EXDATA_LEN（Exchange Data Length）
- 本机的 I2C 地址为 0xA0
- I2C 的通信速率定为 100Kbps
- 高速模式下 I2C 总线的占空比为 9/16
接着定义了 mI2CTxBuf 和 mI2CRxBuf 两个缓冲区变量，长度为 EXDATA_LEN
初始化函数很简单，这里设置了“禁止广播呼叫”
接收、发送函数都使用了中断式模式，并使用了等待方式，一直到发送/接收完毕才会返回
等待函数就是循环读 I2C 的 State 标志，直到 I2C 空闲为止
4. 在 py32f0xx_hal_msp.c 增加 i2c 的外设初始化
static DMA_HandleTypeDef HdmaCh1;
static DMA_HandleTypeDef HdmaCh2;
...
...
/**
* -----------------------------------------------------------------------
* @name : void HAL_I2C_MspInit(I2C_HandleTypeDef* hi2c)
* @brief : 初始化I2C相关MSP
* @param : [in] *hi2c, I2C handler pointer
* @retval : void
* @remark :
* -----------------------------------------------------------------------
*/
void HAL_I2C_MspInit(I2C_HandleTypeDef *hi2c)
{
GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_SYSCFG_CLK_ENABLE(); //SYSCFG时钟使能
__HAL_RCC_DMA_CLK_ENABLE(); //DMA时钟使能
__HAL_RCC_I2C_CLK_ENABLE(); //I2C时钟使能
__HAL_RCC_GPIOA_CLK_ENABLE(); //GPIOA时钟使能
/**I2C GPIO Configuration
PA3 : I2C1_SCL
PA2 : I2C1_SDA
*/
GPIO_InitStruct.Pin = GPIO_PIN_3 | GPIO_PIN_2;
GPIO_InitStruct.Mode = GPIO_MODE_AF_OD; //推挽方式
GPIO_InitStruct.Pull = GPIO_PULLUP; //上拉
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF12_I2C; //复用为I2C
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); //GPIO初始化
/*复位I2C*/
__HAL_RCC_I2C_FORCE_RESET();
__HAL_RCC_I2C_RELEASE_RESET();
/* I2C1 interrupt Init */
HAL_NVIC_SetPriority(I2C1_IRQn, 0, 0); //中断优先级设置
HAL_NVIC_EnableIRQ(I2C1_IRQn); //使能I2C中断
//DMA配置
HAL_SYSCFG_DMA_Req(9); //DMA1_MAP选择为IIC_TX
HAL_SYSCFG_DMA_Req(0xA00); //DMA2_MAP选择为IIC_RX
/* Configure the DMA handler for Transmission process */
HdmaCh1.Instance = DMA1_Channel1; // 选择DMA通道1
HdmaCh1.Init.Direction = DMA_MEMORY_TO_PERIPH; // 方向为从存储器到外设
HdmaCh1.Init.PeriphInc = DMA_PINC_DISABLE; // 禁止外设地址增量
HdmaCh1.Init.MemInc = DMA_MINC_ENABLE; // 使能存储器地址增量
HdmaCh1.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE; // 外设数据宽度为8位
HdmaCh1.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE; // 存储器数据宽度位8位
HdmaCh1.Init.Mode = DMA_NORMAL; // 禁止循环模式
HdmaCh1.Init.Priority = DMA_PRIORITY_VERY_HIGH; // 通道优先级为"很高"
HAL_DMA_Init(&HdmaCh1); // 初始化DMA通道1
__HAL_LINKDMA(hi2c, hdmatx, HdmaCh1); // DMA1 关联 IIC_TX
/* Configure the DMA handler for Transmission process */
HdmaCh2.Instance = DMA1_Channel2; // 选择DMA通道1
HdmaCh2.Init.Direction = DMA_PERIPH_TO_MEMORY; // 方向为从外设到存储
HdmaCh2.Init.PeriphInc = DMA_PINC_DISABLE; // 禁止外设地址增量
HdmaCh2.Init.MemInc = DMA_MINC_ENABLE; // 使能存储器地址增量
HdmaCh2.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE; // 外设数据宽度为8位
HdmaCh2.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE; // 存储器数据宽度位8位
HdmaCh2.Init.Mode = DMA_NORMAL; // 禁止循环模式
HdmaCh2.Init.Priority = DMA_PRIORITY_HIGH; // 通道优先级为高
HAL_DMA_Init(&HdmaCh2); // 初始化DMA通道1
__HAL_LINKDMA(hi2c, hdmarx, HdmaCh2); // DMA1 关联 IIC_RX
HAL_NVIC_SetPriority(DMA1_Channel1_IRQn, 1, 1); // 中断优先级设置
HAL_NVIC_EnableIRQ(DMA1_Channel1_IRQn); // 使能DMA通道1中断
HAL_NVIC_SetPriority(DMA1_Channel2_3_IRQn, 0, 1); // 中断优先级设置
HAL_NVIC_EnableIRQ(DMA1_Channel2_3_IRQn); // 使能DMA通道2_3中断
}
指定 PA3 管脚为 I2C_SCL， PA2 管脚为 I2C_SDA。
为 I2C 分配高优先级
使用 HAL_SYSCFG_DMA_Req() 把 DMA1 的通道1和通道2分别映射到 I2C 的 TX 和 RX
配置 DMA1 的两个通道，注意收发通道的方向，TX 是内存->外设，RX是外设->内存；
HdmaChx.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE;
HdmaChx.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE;
是因为收发的都是 uint8_t 型的数据，是BYTE（字节）型的，也是因为PY32F003 的 I2C DMA 的收发缓冲区是单字节的。
本实验中着重考察 I2C 的通信，所以把 HdmaChx.Init.Priority 设置得都比较高，应用中不一定设置那么高的优先级，这个要看应用的需求。
5. 在 py32f0xx_hal_it.c 中增加对 I2C 和 DMA 的中断服务程序
#include "main.h"
#include "py32f0xx_it.h"
extern UART_HandleTypeDef UartHandle;
extern TIM_HandleTypeDef htim16;
extern TIM_HandleTypeDef htim1;
extern ADC_HandleTypeDef hadcdma;
/* Add for I2C functionalities */
extern I2C_HandleTypeDef I2cHandle;
...
...
void DMA1_Channel1_IRQHandler(void)
{
HAL_DMA_IRQHandler(I2cHandle.hdmatx);
}
void DMA1_Channel2_3_IRQHandler(void)
{
HAL_DMA_IRQHandler(I2cHandle.hdmarx);
}
void I2C1_IRQHandler(void)
{
HAL_I2C_EV_IRQHandler(&I2cHandle);
HAL_I2C_ER_IRQHandler(&I2cHandle);
}
...
...
注意 DMA1_Channel1 是为 TX 服务的，因此执行的是 HAL_DMA_IRQHandler(I2CHandler.hdmatx)，注意是hdma"t"x；DMA2_Channl2_3 是为 RX 服务的，因此执行的是 HAL_DMA_IRQHandler(I2CHandle.hdmarx)，注意是hdma“r”x。
不要忘记了 I2C_IRQHander() 中把 EV 和 ER 两个都放进去。
编译和运行
按照上述步骤，编译没有告警和错误；F8 下载到开发板。由于还没有主机通信，只能看到串口的输出，并且串口收发正常。LED 灯没有闪烁，说明正在等待和主机完成通信。
今天先到这里啦，等主机（Master）板子的代码写好，两台 MCU 做通信实验。
