I2C基础复习

一、I2C 基础详解I2CInter-Integrated Circuit集成电路总线是一种半双工、同步、多主多从的串行通信协议由 Philips现 NXP于 1982 年发明广泛用于 MCU 与低速外设如传感器、EEPROM、RTC、OLED 屏之间的通信。1. 核心引脚I2C 仅需 2 根双向信号线且均需上拉电阻通常 4.7kΩ ~ 10kΩ引脚全称功能SDASerial Data串行数据线用于传输数据/地址SCLSerial Clock串行时钟线由主设备产生控制通信节奏2. 通信协议核心时序I2C 通信由起始信号开始停止信号结束中间包含地址、数据和应答位起始信号SSCL 为高电平时SDA 从高变低启动通信。停止信号PSCL 为高电平时SDA 从低变高结束通信。数据传输SCL 低电平时SDA 可变化SCL 高电平时SDA 必须稳定采样数据。应答位ACK/NACK每传输 8 位数据后接收方拉低 SDA 发送 ACK确认否则发送 NACK非确认。3. 地址模式7 位地址最常用从机地址占 7 位第 8 位是读写位0写1读。10 位地址扩展地址空间分两个字节传输第一个字节高 5 位固定为11110。4. 时钟速度模式模式时钟速度典型应用标准模式100 kHz通用低速外设快速模式400 kHz传感器、EEPROM快速模式1 MHz高速需求场景高速模式3.4 MHz极少用需特殊硬件二、Linux 应用层 I2C 实现基于 i2c-dev 驱动Linux 内核提供了i2c-dev驱动将 I2C 总线抽象为/dev/i2c-X设备文件X 为总线号应用层通过ioctl即可控制 I2C 通信。步骤 1准备环境确保系统加载了i2c-dev驱动lsmod|grepi2c_dev若未加载执行sudomodprobe i2c_dev查看可用的 I2C 总线i2cdetect-l# 列出所有 I2C 总线扫描总线上的从设备以总线 0 为例sudoi2cdetect-y0# 扫描 /dev/i2c-0 上的设备步骤 2代码实现一步一步以下是完整的应用层 I2C 通信代码以MPU6050 陀螺仪/加速度计从机地址0x68WHO_AM_I 寄存器0x75返回值应为0x68为例包含打开设备、写寄存器、读寄存器、组合读写等步骤。#includestdio.h#includestdlib.h#includestring.h#includefcntl.h#includeunistd.h#includesys/ioctl.h#includelinux/i2c-dev.h#defineI2C_DEV_PATH/dev/i2c-0// 需根据实际硬件修改如 /dev/i2c-1#defineMPU6050_ADDR0x68// MPU6050 从机地址#defineWHO_AM_I_REG0x75// WHO_AM_I 寄存器地址// 步骤 1打开 I2C 设备文件inti2c_open(constchar*dev_path){intfdopen(dev_path,O_RDWR);if(fd0){perror(Failed to open I2C device);return-1;}returnfd;}// 步骤 2设置从机地址inti2c_set_addr(intfd,uint8_taddr){if(ioctl(fd,I2C_SLAVE,addr)0){perror(Failed to set I2C slave address);return-1;}return0;}// 步骤 3向从机写单个寄存器inti2c_write_reg(intfd,uint8_treg,uint8_tdata){uint8_tbuf[2]{reg,data};// 第一个字节是寄存器地址第二个是数据if(write(fd,buf,2)!2){perror(Failed to write I2C register);return-1;}return0;}// 步骤 4从从机读单个寄存器inti2c_read_reg(intfd,uint8_treg,uint8_t*data){// 先写寄存器地址告诉从机要读哪个寄存器if(write(fd,reg,1)!1){perror(Failed to write register address);return-1;}// 再读数据if(read(fd,data,1)!1){perror(Failed to read I2C register);return-1;}return0;}// 步骤 5组合读写更高效使用 I2C_RDWR 一次完成inti2c_read_reg_combined(intfd,uint8_treg,uint8_t*data){structi2c_msgmsgs[2];uint8_treg_buf[1]{reg};// 第一条消息写寄存器地址msgs[0].addrMPU6050_ADDR;msgs[0].flags0;// 0写msgs[0].len1;msgs[0].bufreg_buf;// 第二条消息读数据msgs[1].addrMPU6050_ADDR;msgs[1].flagsI2C_M_RD;// I2C_M_RD读msgs[1].len1;msgs[1].bufdata;// 执行组合传输structi2c_rdwr_ioctl_dataioctl_data{.msgsmsgs,.nmsgs2// 消息数量};if(ioctl(fd,I2C_RDWR,ioctl_data)0){perror(Failed to do combined I2C transfer);return-1;}return0;}intmain(){intfd;uint8_twho_am_i;// 1. 打开 I2C 设备fdi2c_open(I2C_DEV_PATH);if(fd0)returnEXIT_FAILURE;// 2. 设置从机地址MPU6050if(i2c_set_addr(fd,MPU6050_ADDR)0){close(fd);returnEXIT_FAILURE;}// 3. 方法 1分两次读写 WHO_AM_I 寄存器printf( 方法 1分两次读写 \n);if(i2c_read_reg(fd,WHO_AM_I_REG,who_am_i)0){close(fd);returnEXIT_FAILURE;}printf(WHO_AM_I (方法 1): 0x%02X\n,who_am_i);// 4. 方法 2组合读写 WHO_AM_I 寄存器推荐printf(\n 方法 2组合读写 \n);if(i2c_read_reg_combined(fd,WHO_AM_I_REG,who_am_i)0){close(fd);returnEXIT_FAILURE;}printf(WHO_AM_I (方法 2): 0x%02X\n,who_am_i);// 验证结果MPU6050 的 WHO_AM_I 应为 0x68if(who_am_i0x68){printf(\n✅ MPU6050 验证成功\n);}else{printf(\n❌ MPU6050 验证失败\n);}// 5. 关闭 I2C 设备close(fd);returnEXIT_SUCCESS;}三、代码关键步骤解析打开设备open(/dev/i2c-0, O_RDWR)以读写模式打开 I2C 总线设备文件。设置从机地址ioctl(fd, I2C_SLAVE, addr)告诉内核接下来要通信的从机地址。分两次读写先write寄存器地址告诉从机要访问的寄存器。再read数据从指定寄存器读取。缺点两次系统调用效率较低且可能被其他进程打断。组合读写推荐使用struct i2c_msg定义多个消息写地址读数据。通过ioctl(fd, I2C_RDWR, ...)一次完成所有消息传输原子性强效率高。四、编译与运行编译gcc i2c_test.c-oi2c_test运行需 root 权限因操作硬件设备sudo./i2c_test五、注意事项设备节点选择需根据实际硬件修改I2C_DEV_PATH可通过i2cdetect -l查看总线号。从机地址7 位地址直接使用如0x68不要左移i2c-dev会自动处理读写位。若不确定从机地址可用i2cdetect -y X扫描。硬件连接确保 SDA/SCL 正确连接且共地。必须接上拉电阻4.7kΩ ~ 10kΩ否则通信不稳定。权限问题若无法打开设备可尝试临时修改权限sudochmod666/dev/i2c-0RK3588的 I2C 驱动层实现一、RK3588 I2C 硬件基础RK3588 集成了9 个 I2C 控制器I2C0 ~ I2C8支持以下核心特性通信模式标准模式100 kHz、快速模式400 kHz、快速模式1 MHz。硬件 FIFO发送/接收各 32 字节降低 CPU 中断频率。DMA 支持大数据量传输时可启用 DMA进一步减少 CPU 占用。多从机支持通过 7 位/10 位地址寻址多个从设备。硬件纠错支持总线错误检测如仲裁丢失、ACK 缺失。二、Linux I2C 驱动整体架构Linux I2C 驱动分为三层与 SPI 框架类似但更细化I2C 主机控制器驱动i2c_adapter负责直接操作 RK3588 的 I2C 硬件寄存器处理时序、FIFO、DMA、中断等。对应源码drivers/i2c/busses/i2c-rockchip.c瑞芯微官方通用 I2C 驱动。I2C 设备驱动i2c_driver挂在主机控制器下的具体外设驱动如 EEPROM、传感器、OLED 屏等。通过i2c_msg与主机驱动交互不直接操作硬件。用户态接口i2c-dev将 I2C 总线抽象为/dev/i2c-X设备文件应用层通过ioctl通信对应上一篇应用层代码。三、RK3588 I2C 主机驱动深度分析i2c-rockchip.c我们以 Linux 5.10 内核源码为例分析核心实现。1. 关键数据结构// drivers/i2c/busses/i2c-rockchip.cstructrockchip_i2c{structi2c_adapteradap;// 指向 I2C 主机适配器对象void__iomem*regs;// I2C 寄存器基地址ioremap 后的虚拟地址structclk*clk;// I2C 外设时钟SCLK_I2Cxstructclk*pclk;// APB 总线时钟PCLK_I2Cxstructcompletioncomplete;// 用于同步等待传输完成conststructrockchip_i2c_data*data;// RK3588 芯片特定数据u32 fifo_len;// FIFO 深度RK3588 为 32u8*tx_buf;// 发送缓冲区指针u8*rx_buf;// 接收缓冲区指针inttx_len;// 剩余发送长度intrx_len;// 剩余接收长度intmsg_len;// 当前消息总长度bool use_dma;// 是否使用 DMA 传输// ... 其他成员如错误状态、DMA 描述符等};2. 驱动初始化与probe函数驱动通过platform_driver框架注册与设备树匹配后执行probestaticconststructof_device_idrockchip_i2c_of_match[]{{.compatiblerockchip,rk3588-i2c,.datark3588_i2c_data},// ... 其他芯片兼容项};MODULE_DEVICE_TABLE(of,rockchip_i2c_of_match);staticstructplatform_driverrockchip_i2c_driver{.proberockchip_i2c_probe,.removerockchip_i2c_remove,.driver{.namerockchip-i2c,.of_match_tablerockchip_i2c_of_match,},};module_platform_driver(rockchip_i2c_driver);rockchip_i2c_probe核心流程分配i2c_adapteradapdevm_i2c_alloc_adapter(pdev-dev,sizeof(structrockchip_i2c));i2ci2c_get_adapdata(adap);i2c-adapadap;获取硬件资源寄存器地址映射i2c-regsdevm_platform_ioremap_resource(pdev,0);时钟获取与使能i2c-clkdevm_clk_get(pdev-dev,i2c);i2c-pclkdevm_clk_get(pdev-dev,pclk);clk_prepare_enable(i2c-clk);clk_prepare_enable(i2c-pclk);中断申请retdevm_request_irq(pdev-dev,irq,rockchip_i2c_isr,0,dev_name(pdev-dev),i2c);初始化i2c_adapter接口adap-algorockchip_i2c_algo;// 核心算法结构体含 master_xferadap-dev.parentpdev-dev;adap-dev.of_nodepdev-dev.of_node;snprintf(adap-name,sizeof(adap-name),Rockchip I2C%d,pdev-id);其中rockchip_i2c_algo定义了核心传输函数staticconststructi2c_algorithmrockchip_i2c_algo{.master_xferrockchip_i2c_xfer,// 核心传输函数.functionalityrockchip_i2c_func,// 支持的功能如 I2C_FUNC_I2C};硬件初始化复位 I2C 控制器配置 FIFO 阈值清空 FIFO。从设备树读取clock-frequency如 400kHz并配置时钟分频器。注册i2c_adapterretdevm_i2c_add_adapter(pdev-dev,adap);3. 核心传输函数rockchip_i2c_xfer这是 I2C 主机驱动的“心脏”负责处理设备驱动提交的i2c_msg数组。流程概览staticintrockchip_i2c_xfer(structi2c_adapter*adap,structi2c_msg*msgs,intnum){structrockchip_i2c*i2ci2c_get_adapdata(adap);intret;// 1. 初始化同步完成量reinit_completion(i2c-complete);// 2. 遍历所有 i2c_msg一次传输可能包含多个消息for(inti0;inum;i){structi2c_msg*msgmsgs[i];// 配置从机地址、读写方向rockchip_i2c_set_addr(i2c,msg-addr,msg-flagsI2C_M_RD);// 选择传输方式DMA 或 PIOif(i2c-use_dmamsg-leni2c-fifo_len){retrockchip_i2c_dma_xfer(i2c,msg);// DMA 模式大数据量}else{retrockchip_i2c_pio_xfer(i2c,msg);// PIO 模式小数据量}// 等待传输完成通过中断唤醒wait_for_completion_timeout(i2c-complete,msecs_to_jiffies(1000));}returnnum;// 返回成功传输的消息数量}PIO 模式实现小数据量无 DMAstaticintrockchip_i2c_pio_xfer(structrockchip_i2c*i2c,structi2c_msg*msg){i2c-tx_bufmsg-buf;i2c-rx_bufmsg-buf;i2c-tx_len(msg-flagsI2C_M_RD)?0:msg-len;i2c-rx_len(msg-flagsI2C_M_RD)?msg-len:0;i2c-msg_lenmsg-len;// 使能中断TX FIFO 空、RX FIFO 满、传输完成、错误rockchip_i2c_enable_irq(i2c,ROCKCHIP_I2C_INT_TX|ROCKCHIP_I2C_INT_RX|ROCKCHIP_I2C_INT_DONE|ROCKCHIP_I2C_INT_ERR);// 启动传输写起始信号 从机地址rockchip_i2c_start_xfer(i2c);return0;}4. 中断处理函数rockchip_i2c_isr当 FIFO 可写/可读、传输完成或发生错误时触发中断staticirqreturn_trockchip_i2c_isr(intirq,void*dev_id){structrockchip_i2c*i2cdev_id;u32 statusreadl_relaxed(i2c-regsROCKCHIP_I2C_INTR_STAT);// 1. 处理错误中断仲裁丢失、ACK 缺失等if(statusROCKCHIP_I2C_INT_ERR){rockchip_i2c_handle_error(i2c,status);gotoout;}// 2. 处理发送 FIFO 空中断填充数据到 TX FIFOif(statusROCKCHIP_I2C_INT_TX){rockchip_i2c_fill_tx_fifo(i2c);}// 3. 处理接收 FIFO 满中断从 RX FIFO 读取数据if(statusROCKCHIP_I2C_INT_RX){rockchip_i2c_read_rx_fifo(i2c);}// 4. 处理传输完成中断if(statusROCKCHIP_I2C_INT_DONE){complete(i2c-complete);// 唤醒等待队列}out:writel_relaxed(status,i2c-regsROCKCHIP_I2C_INTR_STAT);// 清除中断标志returnIRQ_HANDLED;}四、RK3588 I2C 设备树配置DTSRK3588 的 I2C 节点定义在arch/arm64/boot/dts/rockchip/rk3588.dtsi中用户需在板级 DTS如rk3588-evb.dts中启用并配置具体参数。1. 控制器节点示例rk3588.dtsi片段i2c0: i2cfeb00000 { compatible rockchip,rk3588-i2c, rockchip,rk3399-i2c; reg 0x0 0xfeb00000 0x0 0x1000; // 寄存器物理地址 interrupts GIC_SPI 96 IRQ_TYPE_LEVEL_HIGH; // 中断号 clocks cru SCLK_I2C0, cru PCLK_I2C0; // 时钟源 clock-names i2c, pclk; pinctrl-names default; pinctrl-0 i2c0m0_xfer; // 引脚复用配置 #address-cells 1; #size-cells 0; status disabled; // 默认禁用板级 DTS 中启用 };2. 板级 DTS 配置启用 I2C0 并挂载 EEPROMi2c0 { status okay; // 启用 I2C0 clock-frequency 400000; // 配置时钟为 400kHz快速模式 // I2C EEPROM 子节点AT24C02从机地址 0x50 eeprom50 { compatible atmel,24c02; reg 0x50; // 从机地址7 位 status okay; }; };3. 引脚复用配置pinctrlRK3588 的 I2C 引脚需配置为 I2C 功能在rk3588-pinctrl.dtsi中定义i2c0m0_xfer: i2c0m0-xfer { m0 { rockchip,pins 1 RK_PA0 1 pcfg_pull_none, // I2C0_SDA 1 RK_PA1 1 pcfg_pull_none; // I2C0_SCL }; };注意I2C 引脚需外部接上拉电阻4.7kΩ ~ 10kΩpcfg_pull_none表示不使用内部上拉避免与外部上拉冲突。五、关键调试与验证方法1. 检查 I2C 总线与设备# 列出所有 I2C 总线i2cdetect-l# 扫描 I2C0 上的从设备需 root 权限sudoi2cdetect-y0# 读取 EEPROM从机地址 0x50的所有寄存器sudoi2cdump-y00x50# 向 EEPROM 的 0x00 寄存器写入 0xAAsudoi2cset-y00x50 0x00 0xAA2. 查看内核日志# 查看 I2C 驱动相关日志dmesg|grepi2c3. 硬件验证逻辑分析仪/示波器抓取 SDA/SCL 波形验证起始/停止信号是否正确。从机地址、读写位、ACK 位是否正常。时钟频率是否符合配置如 400kHz。上拉电阻检查确保 SDA/SCL 空闲时为高电平3.3V 或 1.8V取决于 RK3588 的 IO 域。六、总结RK3588 的 I2C 驱动层核心在于主机驱动i2c-rockchip.c通过platform_driver匹配设备树初始化硬件实现master_xfer接口支持 PIO/DMA 双模式。设备树配置控制器寄存器、时钟、引脚复用以及挂载的具体 I2C 设备。中断与同步通过中断处理 FIFO 数据使用completion同步传输流程。