使用GD32F103C8T6开发板的标准库实现硬件I2C协议通信(附源码下载地址)

jingshaoqi_ccc2026-02-04 15:14

代码说明：

  1. 该I2C驱动实现了完整的硬件I2C配置，包括GPIO引脚设置、时钟配置和模式配置
  2. 包含全面的异常处理机制，能够检测和处理超时、NACK、总线忙、仲裁丢失等异常情况
  3. 提供了多种I2C操作函数，包括单字节读写和多字节读写操作
  4. 实现了超时检测机制，防止程序在异常情况下无限等待
  5. 主函数中包含了完整的测试流程，通过LED指示不同的通信状态
  6. 代码模块化设计，将I2C驱动分为头文件和实现文件，便于维护和复用
cpp 复制代码 
//i2c_deriver.h


#ifndef __I2C_DRIVER_H
#define __I2C_DRIVER_H

#include "gd32f10x.h"

// I2C配置参数
#define I2C_PERIPH              I2C0
#define I2C_SPEED               100000
#define I2C_SCL_PIN             GPIO_PIN_6
#define I2C_SDA_PIN             GPIO_PIN_7
#define I2C_GPIO_PORT           GPIOB
#define I2C_TIMEOUT             0xFFFFF

// I2C状态码定义
typedef enum {
    I2C_OK = 0,
    I2C_ERROR_TIMEOUT,
    I2C_ERROR_NACK,
    I2C_ERROR_BUS_BUSY,
    I2C_ERROR_ARBITRATION_LOST,
    I2C_ERROR_UNKNOWN
} i2c_status_t;

// 函数声明
i2c_status_t i2c_master_init(void);
i2c_status_t i2c_master_write(uint8_t device_addr, uint8_t reg_addr, uint8_t *data, uint16_t length);
i2c_status_t i2c_master_read(uint8_t device_addr, uint8_t reg_addr, uint8_t *data, uint16_t length);
i2c_status_t i2c_master_write_byte(uint8_t device_addr, uint8_t data);
i2c_status_t i2c_master_read_byte(uint8_t device_addr, uint8_t *data);
void i2c_deinit(void);

#endif /* __I2C_DRIVER_H */
cpp 复制代码 
//i2c_driver.c

#include "i2c_driver.h"

/**
 * @brief I2C超时检查函数
 * @param flag: 要检查的标志位
 * @param timeout: 超时计数
 * @return i2c_status_t: 操作状态
 */
static i2c_status_t i2c_wait_flag_timeout(uint32_t flag, uint32_t timeout)
{
    while(!i2c_flag_get(I2C_PERIPH, flag)) {
        if((timeout--) == 0) {
            return I2C_ERROR_TIMEOUT;
        }
    }
    return I2C_OK;
}

/**
 * @brief I2C主模式初始化
 * @return i2c_status_t: 初始化状态
 */
i2c_status_t i2c_master_init(void)
{
    uint32_t timeout = I2C_TIMEOUT;
    
    // 使能GPIO和I2C时钟
    rcu_periph_clock_enable(RCU_GPIOB);
    rcu_periph_clock_enable(RCU_I2C0);
    
    // 配置I2C引脚
    gpio_init(I2C_GPIO_PORT, GPIO_MODE_AF_OD, GPIO_OSPEED_50MHZ, I2C_SCL_PIN);
    gpio_init(I2C_GPIO_PORT, GPIO_MODE_AF_OD, GPIO_OSPEED_50MHZ, I2C_SDA_PIN);
    
    // 复位I2C
    i2c_deinit(I2C_PERIPH);
    
    // 配置I2C参数
    i2c_clock_config(I2C_PERIPH, I2C_SPEED, I2C_DTCY_2);
    i2c_mode_addr_config(I2C_PERIPH, I2C_I2CMODE_ENABLE, I2C_ADDFORMAT_7BITS, 0x00);
    i2c_ack_config(I2C_PERIPH, I2C_ACK_ENABLE);
    
    // 使能I2C
    i2c_enable(I2C_PERIPH);
    
    // 等待I2C就绪
    while(!i2c_flag_get(I2C_PERIPH, I2C_FLAG_I2CBSY)) {
        if((timeout--) == 0) {
            return I2C_ERROR_TIMEOUT;
        }
    }
    
    return I2C_OK;
}

/**
 * @brief I2C主发送数据
 * @param device_addr: 设备地址
 * @param reg_addr: 寄存器地址
 * @param data: 数据指针
 * @param length: 数据长度
 * @return i2c_status_t: 发送状态
 */
i2c_status_t i2c_master_write(uint8_t device_addr, uint8_t reg_addr, uint8_t *data, uint16_t length)
{
    i2c_status_t status;
    uint32_t timeout = I2C_TIMEOUT;
    
    // 检查总线是否空闲
    if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_I2CBSY)) {
        return I2C_ERROR_BUS_BUSY;
    }
    
    // 发送起始信号
    i2c_start_on_bus(I2C_PERIPH);
    status = i2c_wait_flag_timeout(I2C_FLAG_SBSEND, timeout);
    if(status != I2C_OK) return status;
    
    // 发送设备地址(写)
    i2c_master_addressing(I2C_PERIPH, device_addr, I2C_TRANSMITTER);
    status = i2c_wait_flag_timeout(I2C_FLAG_ADDSEND, timeout);
    if(status != I2C_OK) {
        // 检查是否收到NACK
        if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_AERR)) {
            i2c_flag_clear(I2C_PERIPH, I2C_FLAG_AERR);
            return I2C_ERROR_NACK;
        }
        return status;
    }
    i2c_flag_clear(I2C_PERIPH, I2C_FLAG_ADDSEND);
    
    // 发送寄存器地址
    status = i2c_wait_flag_timeout(I2C_FLAG_TBE, timeout);
    if(status != I2C_OK) return status;
    i2c_data_transmit(I2C_PERIPH, reg_addr);
    status = i2c_wait_flag_timeout(I2C_FLAG_BTC, timeout);
    if(status != I2C_OK) return status;
    
    // 发送数据
    for(uint16_t i = 0; i < length; i++) {
        status = i2c_wait_flag_timeout(I2C_FLAG_TBE, timeout);
        if(status != I2C_OK) return status;
        i2c_data_transmit(I2C_PERIPH, data[i]);
        status = i2c_wait_flag_timeout(I2C_FLAG_BTC, timeout);
        if(status != I2C_OK) return status;
    }
    
    // 发送停止信号
    i2c_stop_on_bus(I2C_PERIPH);
    
    // 等待停止信号完成
    timeout = I2C_TIMEOUT;
    while(I2C_CTL0(I2C_PERIPH) & 0x0200) {
        if((timeout--) == 0) {
            return I2C_ERROR_TIMEOUT;
        }
    }
    
    return I2C_OK;
}

/**
 * @brief I2C主接收数据
 * @param device_addr: 设备地址
 * @param reg_addr: 寄存器地址
 * @param data: 数据指针
 * @param length: 数据长度
 * @return i2c_status_t: 接收状态
 */
i2c_status_t i2c_master_read(uint8_t device_addr, uint8_t reg_addr, uint8_t *data, uint16_t length)
{
    i2c_status_t status;
    uint32_t timeout = I2C_TIMEOUT;
    
    // 检查总线是否空闲
    if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_I2CBSY)) {
        return I2C_ERROR_BUS_BUSY;
    }
    
    // 第一阶段：发送寄存器地址
    // 发送起始信号
    i2c_start_on_bus(I2C_PERIPH);
    status = i2c_wait_flag_timeout(I2C_FLAG_SBSEND, timeout);
    if(status != I2C_OK) return status;
    
    // 发送设备地址(写)
    i2c_master_addressing(I2C_PERIPH, device_addr, I2C_TRANSMITTER);
    status = i2c_wait_flag_timeout(I2C_FLAG_ADDSEND, timeout);
    if(status != I2C_OK) {
        if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_AERR)) {
            i2c_flag_clear(I2C_PERIPH, I2C_FLAG_AERR);
            return I2C_ERROR_NACK;
        }
        return status;
    }
    i2c_flag_clear(I2C_PERIPH, I2C_FLAG_ADDSEND);
    
    // 发送寄存器地址
    status = i2c_wait_flag_timeout(I2C_FLAG_TBE, timeout);
    if(status != I2C_OK) return status;
    i2c_data_transmit(I2C_PERIPH, reg_addr);
    status = i2c_wait_flag_timeout(I2C_FLAG_BTC, timeout);
    if(status != I2C_OK) return status;
    
    // 第二阶段：读取数据
    // 发送重复起始信号
    i2c_start_on_bus(I2C_PERIPH);
    status = i2c_wait_flag_timeout(I2C_FLAG_SBSEND, timeout);
    if(status != I2C_OK) return status;
    
    // 发送设备地址(读)
    i2c_master_addressing(I2C_PERIPH, device_addr, I2C_RECEIVER);
    status = i2c_wait_flag_timeout(I2C_FLAG_ADDSEND, timeout);
    if(status != I2C_OK) {
        if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_AERR)) {
            i2c_flag_clear(I2C_PERIPH, I2C_FLAG_AERR);
            return I2C_ERROR_NACK;
        }
        return status;
    }
    i2c_flag_clear(I2C_PERIPH, I2C_FLAG_ADDSEND);
    
    // 接收数据
    for(uint16_t i = 0; i < length; i++) {
        // 最后一个字节前关闭ACK
        if(i == (length - 1)) {
            i2c_ack_config(I2C_PERIPH, I2C_ACK_DISABLE);
        }
        
        status = i2c_wait_flag_timeout(I2C_FLAG_RBNE, timeout);
        if(status != I2C_OK) return status;
        data[i] = i2c_data_receive(I2C_PERIPH);
    }
    
    // 重新使能ACK
    i2c_ack_config(I2C_PERIPH, I2C_ACK_ENABLE);
    
    // 发送停止信号
    i2c_stop_on_bus(I2C_PERIPH);
    
    // 等待停止信号完成
    timeout = I2C_TIMEOUT;
    while(I2C_CTL0(I2C_PERIPH) & 0x0200) {
        if((timeout--) == 0) {
            return I2C_ERROR_TIMEOUT;
        }
    }
    
    return I2C_OK;
}

/**
 * @brief I2C主发送单字节数据
 * @param device_addr: 设备地址
 * @param data: 数据
 * @return i2c_status_t: 发送状态
 */
i2c_status_t i2c_master_write_byte(uint8_t device_addr, uint8_t data)
{
    return i2c_master_write(device_addr, 0x00, &data, 1);
}

/**
 * @brief I2C主接收单字节数据
 * @param device_addr: 设备地址
 * @param data: 数据指针
 * @return i2c_status_t: 接收状态
 */
i2c_status_t i2c_master_read_byte(uint8_t device_addr, uint8_t *data)
{
    return i2c_master_read(device_addr, 0x00, data, 1);
}

/**
 * @brief I2C去初始化
 */
void i2c_deinit(void)
{
    i2c_disable(I2C_PERIPH);
    rcu_periph_clock_disable(RCU_I2C0);
}
cpp 复制代码 
//main.c


#include "i2c_driver.h"

/**
 * @brief I2C超时检查函数
 * @param flag: 要检查的标志位
 * @param timeout: 超时计数
 * @return i2c_status_t: 操作状态
 */
static i2c_status_t i2c_wait_flag_timeout(uint32_t flag, uint32_t timeout)
{
    while(!i2c_flag_get(I2C_PERIPH, flag)) {
        if((timeout--) == 0) {
            return I2C_ERROR_TIMEOUT;
        }
    }
    return I2C_OK;
}

/**
 * @brief I2C主模式初始化
 * @return i2c_status_t: 初始化状态
 */
i2c_status_t i2c_master_init(void)
{
    uint32_t timeout = I2C_TIMEOUT;
    
    // 使能GPIO和I2C时钟
    rcu_periph_clock_enable(RCU_GPIOB);
    rcu_periph_clock_enable(RCU_I2C0);
    
    // 配置I2C引脚
    gpio_init(I2C_GPIO_PORT, GPIO_MODE_AF_OD, GPIO_OSPEED_50MHZ, I2C_SCL_PIN);
    gpio_init(I2C_GPIO_PORT, GPIO_MODE_AF_OD, GPIO_OSPEED_50MHZ, I2C_SDA_PIN);
    
    // 复位I2C
    i2c_deinit(I2C_PERIPH);
    
    // 配置I2C参数
    i2c_clock_config(I2C_PERIPH, I2C_SPEED, I2C_DTCY_2);
    i2c_mode_addr_config(I2C_PERIPH, I2C_I2CMODE_ENABLE, I2C_ADDFORMAT_7BITS, 0x00);
    i2c_ack_config(I2C_PERIPH, I2C_ACK_ENABLE);
    
    // 使能I2C
    i2c_enable(I2C_PERIPH);
    
    // 等待I2C就绪
    while(!i2c_flag_get(I2C_PERIPH, I2C_FLAG_I2CBSY)) {
        if((timeout--) == 0) {
            return I2C_ERROR_TIMEOUT;
        }
    }
    
    return I2C_OK;
}

/**
 * @brief I2C主发送数据
 * @param device_addr: 设备地址
 * @param reg_addr: 寄存器地址
 * @param data: 数据指针
 * @param length: 数据长度
 * @return i2c_status_t: 发送状态
 */
i2c_status_t i2c_master_write(uint8_t device_addr, uint8_t reg_addr, uint8_t *data, uint16_t length)
{
    i2c_status_t status;
    uint32_t timeout = I2C_TIMEOUT;
    
    // 检查总线是否空闲
    if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_I2CBSY)) {
        return I2C_ERROR_BUS_BUSY;
    }
    
    // 发送起始信号
    i2c_start_on_bus(I2C_PERIPH);
    status = i2c_wait_flag_timeout(I2C_FLAG_SBSEND, timeout);
    if(status != I2C_OK) return status;
    
    // 发送设备地址(写)
    i2c_master_addressing(I2C_PERIPH, device_addr, I2C_TRANSMITTER);
    status = i2c_wait_flag_timeout(I2C_FLAG_ADDSEND, timeout);
    if(status != I2C_OK) {
        // 检查是否收到NACK
        if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_AERR)) {
            i2c_flag_clear(I2C_PERIPH, I2C_FLAG_AERR);
            return I2C_ERROR_NACK;
        }
        return status;
    }
    i2c_flag_clear(I2C_PERIPH, I2C_FLAG_ADDSEND);
    
    // 发送寄存器地址
    status = i2c_wait_flag_timeout(I2C_FLAG_TBE, timeout);
    if(status != I2C_OK) return status;
    i2c_data_transmit(I2C_PERIPH, reg_addr);
    status = i2c_wait_flag_timeout(I2C_FLAG_BTC, timeout);
    if(status != I2C_OK) return status;
    
    // 发送数据
    for(uint16_t i = 0; i < length; i++) {
        status = i2c_wait_flag_timeout(I2C_FLAG_TBE, timeout);
        if(status != I2C_OK) return status;
        i2c_data_transmit(I2C_PERIPH, data[i]);
        status = i2c_wait_flag_timeout(I2C_FLAG_BTC, timeout);
        if(status != I2C_OK) return status;
    }
    
    // 发送停止信号
    i2c_stop_on_bus(I2C_PERIPH);
    
    // 等待停止信号完成
    timeout = I2C_TIMEOUT;
    while(I2C_CTL0(I2C_PERIPH) & 0x0200) {
        if((timeout--) == 0) {
            return I2C_ERROR_TIMEOUT;
        }
    }
    
    return I2C_OK;
}

/**
 * @brief I2C主接收数据
 * @param device_addr: 设备地址
 * @param reg_addr: 寄存器地址
 * @param data: 数据指针
 * @param length: 数据长度
 * @return i2c_status_t: 接收状态
 */
i2c_status_t i2c_master_read(uint8_t device_addr, uint8_t reg_addr, uint8_t *data, uint16_t length)
{
    i2c_status_t status;
    uint32_t timeout = I2C_TIMEOUT;
    
    // 检查总线是否空闲
    if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_I2CBSY)) {
        return I2C_ERROR_BUS_BUSY;
    }
    
    // 第一阶段：发送寄存器地址
    // 发送起始信号
    i2c_start_on_bus(I2C_PERIPH);
    status = i2c_wait_flag_timeout(I2C_FLAG_SBSEND, timeout);
    if(status != I2C_OK) return status;
    
    // 发送设备地址(写)
    i2c_master_addressing(I2C_PERIPH, device_addr, I2C_TRANSMITTER);
    status = i2c_wait_flag_timeout(I2C_FLAG_ADDSEND, timeout);
    if(status != I2C_OK) {
        if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_AERR)) {
            i2c_flag_clear(I2C_PERIPH, I2C_FLAG_AERR);
            return I2C_ERROR_NACK;
        }
        return status;
    }
    i2c_flag_clear(I2C_PERIPH, I2C_FLAG_ADDSEND);
    
    // 发送寄存器地址
    status = i2c_wait_flag_timeout(I2C_FLAG_TBE, timeout);
    if(status != I2C_OK) return status;
    i2c_data_transmit(I2C_PERIPH, reg_addr);
    status = i2c_wait_flag_timeout(I2C_FLAG_BTC, timeout);
    if(status != I2C_OK) return status;
    
    // 第二阶段：读取数据
    // 发送重复起始信号
    i2c_start_on_bus(I2C_PERIPH);
    status = i2c_wait_flag_timeout(I2C_FLAG_SBSEND, timeout);
    if(status != I2C_OK) return status;
    
    // 发送设备地址(读)
    i2c_master_addressing(I2C_PERIPH, device_addr, I2C_RECEIVER);
    status = i2c_wait_flag_timeout(I2C_FLAG_ADDSEND, timeout);
    if(status != I2C_OK) {
        if(i2c_flag_get(I2C_PERIPH, I2C_FLAG_AERR)) {
            i2c_flag_clear(I2C_PERIPH, I2C_FLAG_AERR);
            return I2C_ERROR_NACK;
        }
        return status;
    }
    i2c_flag_clear(I2C_PERIPH, I2C_FLAG_ADDSEND);
    
    // 接收数据
    for(uint16_t i = 0; i < length; i++) {
        // 最后一个字节前关闭ACK
        if(i == (length - 1)) {
            i2c_ack_config(I2C_PERIPH, I2C_ACK_DISABLE);
        }
        
        status = i2c_wait_flag_timeout(I2C_FLAG_RBNE, timeout);
        if(status != I2C_OK) return status;
        data[i] = i2c_data_receive(I2C_PERIPH);
    }
    
    // 重新使能ACK
    i2c_ack_config(I2C_PERIPH, I2C_ACK_ENABLE);
    
    // 发送停止信号
    i2c_stop_on_bus(I2C_PERIPH);
    
    // 等待停止信号完成
    timeout = I2C_TIMEOUT;
    while(I2C_CTL0(I2C_PERIPH) & 0x0200) {
        if((timeout--) == 0) {
            return I2C_ERROR_TIMEOUT;
        }
    }
    
    return I2C_OK;
}

/**
 * @brief I2C主发送单字节数据
 * @param device_addr: 设备地址
 * @param data: 数据
 * @return i2c_status_t: 发送状态
 */
i2c_status_t i2c_master_write_byte(uint8_t device_addr, uint8_t data)
{
    return i2c_master_write(device_addr, 0x00, &data, 1);
}

/**
 * @brief I2C主接收单字节数据
 * @param device_addr: 设备地址
 * @param data: 数据指针
 * @return i2c_status_t: 接收状态
 */
i2c_status_t i2c_master_read_byte(uint8_t device_addr, uint8_t *data)
{
    return i2c_master_read(device_addr, 0x00, data, 1);
}

/**
 * @brief I2C去初始化
 */
void i2c_deinit(void)
{
    i2c_disable(I2C_PERIPH);
    rcu_periph_clock_disable(RCU_I2C0);
}

代码下载地址： https://gitee.com/gd_15/gd32f103_i2c_driver.git

相关推荐
qq_25814297-npl2 小时前
三开门冰箱的接水盒（也称为储水盒或接水盘）正常情况下不会满水
单片机
宵时待雨2 小时前
STM32笔记归纳6：中断
笔记·stm32·嵌入式硬件
华清远见成都中心2 小时前
GPIO（通用输入输出）面试中高频问题
单片机·面试·职场和发展
来自晴朗的明天2 小时前
8、2N7002 MOS 管电平转换电路
单片机·嵌入式硬件·硬件工程
恒锐丰小吕2 小时前
屹晶微 EG3013S 低压60V半桥驱动芯片技术解析
嵌入式硬件·硬件工程
全栈游侠3 小时前
STM32F103XX 01-存储器和总线架构
stm32·嵌入式硬件·架构
恒锐丰小吕4 小时前
屹晶微 EG2124A 中压260V三相半桥驱动芯片技术解析
嵌入式硬件·硬件工程
来自晴朗的明天4 小时前
5、CBMV321 分压式电压跟随器电路
单片机·嵌入式硬件·硬件工程
羽获飞5 小时前
从零开始学嵌入式之STM32——7.STM32的系统架构
stm32·单片机·嵌入式硬件
热门推荐
01GitHub 镜像站点02OpenCode 入门教程：介绍 · 安装 · 配置第三方 API (如 Claude)032025 年大语言模型发展回顾：关键突破、意外转折与 2026 年展望04一文了解国产算子编程语言 TileLang，TileLang 对国产开源生态的影响与启示05Claude Code Skills 实用使用手册06Clawdbot 中文汉化版 接入微信、飞书07Vue-skills的中文文档08在Trae中使用Pencil MCP09Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services10UV安装并设置国内源