在嵌入式開發(fā)中，I2C總線是連接外設(shè)的“橋梁”——小到傳感器、EEPROM，大到LCD驅(qū)動器、音頻芯片，都離不開它的控制。而瑞芯微（Rockchip）系列芯片作為主流嵌入式方案，其I2C控制器的開發(fā)是很多工程師的必備技能。

今天這篇文章，我們將從I2C硬件原理和數(shù)據(jù)幀講起，再結(jié)合官方《ROCKCHIP I2C開發(fā)指南》，梳理RK平臺I2C開發(fā)的全流程、關(guān)鍵配置和常見問題，幫你快速上手！

一、先搞懂基礎(chǔ)：I2C硬件原理與數(shù)據(jù)幀

在動手開發(fā)前，必須先掌握I2C的“底層邏輯”——硬件結(jié)構(gòu)和數(shù)據(jù)傳輸規(guī)則，否則后續(xù)排查問題會寸步難行。

1. I2C硬件原理：兩條線搞定通信

I2C總線最核心的特點(diǎn)是“簡單”：僅需SDA（串行數(shù)據(jù)線）和SCL（串行時鐘線）兩條線，就能實(shí)現(xiàn)多主多從的通信（RK平臺僅支持主模式）。

關(guān)鍵硬件細(xì)節(jié)：

?總線拓?fù)?/span>：所有設(shè)備的SDA連在一起，SCL連在一起；每個設(shè)備有唯一地址，主設(shè)備（如RK芯片）通過地址識別從設(shè)備（如傳感器）。

?上拉電阻：SDA和SCL必須外接上拉電阻（通常4.7kΩ~10kΩ），因?yàn)?/span>I2C設(shè)備的引腳是開漏輸出——只能拉低電平，無法主動輸出高電平，需通過上拉電阻將總線拉到高電平（Vcc通常為3.3V）。

??RK文檔中提到：“改變上拉電阻大小可調(diào)節(jié)I2C總線的上拉強(qiáng)度”，本質(zhì)是通過電阻值影響總線的上升沿時間（后面會講上升沿的重要性）。

?主從關(guān)系：主設(shè)備負(fù)責(zé)生成SCL時鐘、發(fā)起通信（發(fā)送起始/停止信號）；從設(shè)備被動響應(yīng)，根據(jù)主設(shè)備發(fā)送的地址匹配自身。

2. I2C數(shù)據(jù)幀：通信的“語言規(guī)則”

I2C數(shù)據(jù)以“幀”為單位傳輸，每幀包含固定的結(jié)構(gòu)，主從設(shè)備必須遵循這套規(guī)則才能正常通信。完整幀結(jié)構(gòu)如下（以常用的7位尋址為例）：

[起始信號]→[地址字節(jié)]→[ACK/NACK]→[數(shù)據(jù)字節(jié)1]→[ACK/NACK]→ ... →[數(shù)據(jù)字節(jié)n]→[ACK/NACK]→[停止信號]

各部分詳解：

?起始信號（S）：主設(shè)備拉低SDA（此時SCL為高電平），表示通信開始。

?地址字節(jié)：8位，前7位是從設(shè)備地址，第8位是“讀寫位”——0表示“主→從寫數(shù)據(jù)”，1表示“主←從讀數(shù)據(jù)”。

若用10位尋址，地址字節(jié)分兩部分：第一字節(jié)是固定前綴11110+ 10位地址的高2位，第二字節(jié)是10位地址的低8位。

?ACK/NACK：每傳輸1字節(jié)后，接收方需反饋1位：

?ACK（應(yīng)答）：接收方拉低SDA（表示已接收）；

?NACK（非應(yīng)答）：接收方不拉低SDA（表示未接收或結(jié)束傳輸）。

?數(shù)據(jù)字節(jié)：8位，可連續(xù)傳輸（RK控制器一次最多傳32字節(jié)）。

?停止信號（P）：主設(shè)備拉高SDA（此時SCL為高電平），表示通信結(jié)束。

二、RK平臺I2C開發(fā)核心：控制器、驅(qū)動與流程

掌握基礎(chǔ)后，我們聚焦RK平臺的具體開發(fā)——先了解控制器功能，再區(qū)分驅(qū)動差異，最后梳理開發(fā)流程。

1. RK I2C控制器：支持哪些能力？

RK系列芯片的I2C控制器兼容性強(qiáng)、配置靈活，核心功能如下（文檔V2.2.0版本）：

?兼容I2C協(xié)議和SMBus協(xié)議（常見外設(shè)均支持）；

?僅支持主模式（RK芯片作為主設(shè)備，控制外部從設(shè)備）；

?時鐘頻率：軟件可編程，最高支持1000kbps（Fast-mode Plus），部分芯片默認(rèn)支持400kbps（Fast-mode）；

?尋址模式：支持7位地址和10位地址（覆蓋絕大多數(shù)外設(shè)）；

?數(shù)據(jù)傳輸：一次中斷/輪詢最多傳輸32字節(jié)，效率較高。

2.關(guān)鍵注意：RK平臺的兩種I2C驅(qū)動

RK平臺的I2C驅(qū)動因內(nèi)核版本不同分為兩類，配置方式差異較大，必須區(qū)分清楚：

驅(qū)動文件	適用內(nèi)核版本	配置方式	最高頻率
i2c-rk3x.c	Linux 4.19+（如RK356X、RV1126）	設(shè)備樹（DTS）配置	1000kbps
i2c-rockchip.c	Linux 3.10內(nèi)核	代碼中配置i2c_msg結(jié)構(gòu)體	1000kbps

已支持“所有RK芯片+所有內(nèi)核版本”，實(shí)際開發(fā)時需先確認(rèn)所用內(nèi)核版本，再選擇對應(yīng)驅(qū)動。

3. RK I2C開發(fā)流程：三種傳輸模式

RK I2C控制器的核心是“傳輸模式”，不同場景對應(yīng)不同模式，本質(zhì)是通過配置寄存器（如I2C_CON、I2C_CLKDIV）實(shí)現(xiàn)。

模式1：只發(fā)送模式（Transmit only，I2C_CON[1:0] = 2'b00）

適用于“主設(shè)備向從設(shè)備寫數(shù)據(jù)”（如配置傳感器參數(shù)），步驟如下：

1.配置I2C_CLKDIV：設(shè)置SCL時鐘頻率（如400kbps）；

2.配置I2C_CON：選擇“只發(fā)送模式”，并發(fā)送起始信號（S）；

3.向I2C_TXDATA0~TXDATA7寫入要發(fā)送的數(shù)據(jù)；

4.配置I2C_MTXCNT：設(shè)置發(fā)送數(shù)據(jù)的字節(jié)數(shù)；

5.等待“發(fā)送完成中斷”（I2C_IPD[2]）；

6.若有更多數(shù)據(jù)，重復(fù)步驟3~5；若無，配置I2C_CON發(fā)送停止信號（P），結(jié)束傳輸。

模式2：混合模式（Mix mode，I2C_CON[1:0] = 2'b01/11）

適用于“先寫后讀”（如先發(fā)送寄存器地址，再讀取該寄存器的值），步驟如下：

1.配置I2C_CLKDIV：設(shè)置SCL頻率；

2.配置I2C_CON：選擇“混合模式”，發(fā)送起始信號；

3.配置I2C_MRXADDR和I2C_MRXRADDR：設(shè)置從設(shè)備地址和讀取地址；

4.配置I2C_MRXCNT：設(shè)置要讀取的數(shù)據(jù)字節(jié)數(shù)；

5.等待“接收完成中斷”（I2C_IPD[3]）；

6.若有更多數(shù)據(jù)，重復(fù)步驟3~5；若無，發(fā)送停止信號，結(jié)束傳輸。

模式3：只接收模式（Receive only，I2C_CON[1:0] = 2'b10）

適用于“主設(shè)備從從設(shè)備讀數(shù)據(jù)”（如讀取傳感器采集的數(shù)值），步驟如下：

1.配置I2C_CLKDIV：設(shè)置SCL頻率；

2.配置I2C_CON：選擇“只接收模式”，發(fā)送起始信號；

3.配置I2C_MRXCNT：設(shè)置接收數(shù)據(jù)的字節(jié)數(shù)；

4.等待“接收完成中斷”（I2C_IPD[3]）；

5.若有更多數(shù)據(jù)，重復(fù)步驟3~4；若無，發(fā)送停止信號，結(jié)束傳輸。

4.驅(qū)動參數(shù)配置：關(guān)鍵是“時鐘頻率”

I2C通信能否穩(wěn)定，核心是“時鐘頻率配置”——需符合I2C協(xié)議對“上升沿時間（Tr）”和“下降沿時間（Tf）”的要求，否則會出現(xiàn)通信失敗。

第一步：明確協(xié)議時序要求

I2C協(xié)議對不同模式的時序有嚴(yán)格規(guī)定（文檔中表格整理）：

參數(shù)	標(biāo)準(zhǔn)模式（100kbps）	快速模式（400kbps）	高速模式（1000kbps）	單位
SCL頻率	≤100	≤400	≤1000	kHz
上升沿Tr	≤1000	≤300	≤120	ns
下降沿Tf	≤300	≤300	≤300	ns

注：Tr和Tf需用示波器測量，若超過最大值，需調(diào)整上拉電阻（如減小電阻值縮短上升沿）。

第二步：兩種驅(qū)動的配置示例

?i2c-rk3x.c（DTS配置）：

配置在設(shè)備樹中，關(guān)鍵參數(shù)是clock-frequency（時鐘頻率）、i2c-scl-rising-time-ns（SCL上升沿時間）。

示例（配置I2C1為400kbps）：

&i2c1 {  status ="okay";  i2c-scl-rising-time-ns = <265>; //示波器實(shí)測上升沿265ns  i2c-scl-falling-time-ns = <11>; //下降沿通常不變，可默認(rèn)  clock-frequency = <400000>;   //400kbps（Fast-mode）   // 掛載從設(shè)備（如 ES8316 音頻芯片）  es8316: es8316@10 {    compatible ="everest,es8316";    reg = <0x10>; //從設(shè)備地址0x10    // 其他外設(shè)參數(shù)...  };};

?i2c-rockchip.c（代碼配置）：

在代碼中配置i2c_msg結(jié)構(gòu)體的scl_rate成員，示例（配置200kbps）：

structi2c_msg xfer_msg;xfer_msg[0].addr = client->addr; // 從設(shè)備地址xfer_msg[0].len = num;      // 數(shù)據(jù)長度xfer_msg[0].flags = client->flags;// 讀寫標(biāo)志（0=寫，1=讀）xfer_msg[0].buf = buf;      // 數(shù)據(jù)緩存xfer_msg[0].scl_rate =200*1000; //200kbps 時鐘頻率

5. RK I2C如何使用？內(nèi)核態(tài)/用戶態(tài)/工具

（1）內(nèi)核態(tài)使用（推薦，適合產(chǎn)品化）

RK I2C內(nèi)核態(tài)開發(fā)遵循Linux標(biāo)準(zhǔn)I2C接口，參考內(nèi)核文檔Documentation/i2c/writing-clients，核心是：

?注冊I2C客戶端驅(qū)動（i2c_driver）；

?使用i2c_master_send()（寫數(shù)據(jù)）和i2c_master_recv()（讀數(shù)據(jù)）接口。

（2）用戶態(tài)使用（適合調(diào)試）

通過/dev/i2c-%d設(shè)備節(jié)點(diǎn)直接訪問，步驟：

1.打開設(shè)備節(jié)點(diǎn)：int fd = open("/dev/i2c-1", O_RDWR);；

2.設(shè)置從設(shè)備地址：ioctl(fd, I2C_SLAVE, 0x10);（0x10為從設(shè)備地址）；

3.讀寫數(shù)據(jù)：用read()/write()函數(shù)直接讀寫。

??參考內(nèi)核文檔Documentation/i2c/dev-interface。

（3）I2C工具（快速調(diào)試必備）

I2C-tools是開源工具集，需交叉編譯后使用，支持命令行調(diào)試：

?下載地址：

https://www.kernel.org/pub/software/utils/i2c-tools/

或git clone git://git.kernel.org/pub/scm/utils/i2c-tools/i2c-tools.git

?核心工具：

?i2cdetect：掃描I2C總線及掛載的設(shè)備（如i2cdetect -y 1掃描總線1）；

?i2cdump：讀取從設(shè)備所有寄存器的值（如i2cdump -f -y 1 0x10）；

?i2cget：讀取單個寄存器（如i2cget -y 1 0x10 0x01讀地址0x10的0x01寄存器）；

?i2cset：寫入單個寄存器（如i2cset -y 1 0x10 0x01 0x55寫0x55到0x01寄存器）。

（4）GPIO模擬I2C（不推薦）

RK內(nèi)核支持用GPIO模擬I2C，但效率低，僅適合臨時調(diào)試。配置示例（DTS）：

i2c@4{  compatible ="i2c-gpio";  gpios = <&gpio5?9GPIO_ACTIVE_HIGH>,// SDA 引腳      <&gpio5?8GPIO_ACTIVE_HIGH>;// SCL 引腳  i2c-gpio,delay-us = <2>;// 約 100kbps 頻率 #address-cells =<1>; #size-cells =<0>;  status ="okay";  // 掛載從設(shè)備（如 GT9xx 觸摸屏）  gt9xx: gt9xx@14{    compatible ="goodix,gt9xx";    reg = <0x14>;   // 其他外設(shè)參數(shù)...  };};

三、RK I2C常見問題：從錯誤碼到波形Debug

開發(fā)中難免遇到問題，文檔中整理了兩類驅(qū)動的常見錯誤，我們按“錯誤類型”分類梳理，方便排查。

1. NACK錯誤：從設(shè)備無應(yīng)答

現(xiàn)象：

?i2c-rk3x.c：調(diào)用傳輸接口返回-6（-ENXIO）；

?i2c-rockchip.c：調(diào)用傳輸接口返回-11（-EAGAIN）。

原因與解決：

1.I2C地址錯誤：確認(rèn)從設(shè)備地址（如文檔中ES8316是0x10，GT9xx是0x14），注意地址是否需要左移（7位地址通常需左移1位，加讀寫位）；

2.從設(shè)備未正常工作：檢查從設(shè)備供電（如是否上電）、上電時序是否正確；

3.時序不匹配：從設(shè)備需要停止信號（P），但主設(shè)備發(fā)送了重復(fù)起始信號（Sr），需修改傳輸流程；

4.總線干擾：用示波器測量，若實(shí)際是ACK波形卻報(bào)NACK，需排查外部干擾（如布線是否靠近強(qiáng)電）。

2.超時錯誤：日志提示“timeout”

根據(jù)日志中ipd的值，對應(yīng)不同問題：

（1）日志：timeout, ipd: 0x00, state: 1

?問題：I2C控制器異常，無法發(fā)送起始信號；

?原因：

a.SCL/SDA引腳復(fù)用錯誤（IOMUX配置錯）；

b.上拉電壓不對（如3.3V上拉變成1.8V）；

c.引腳被外設(shè)拉低（電壓異常）；

d.I2C時鐘未開啟或時鐘源過小；

e.同時配置了CON_START和CON_STOP位（寄存器配置沖突）。

（2）日志：timeout, ipd: 0x10, state: 1

?問題：控制器正常，但CPU無法響應(yīng)I2C中斷；

?原因：

a.CPU0被阻塞（RK I2C中斷默認(rèn)在CPU0，用cat /proc/interrupts查看）；

b.I2C中斷位被關(guān)閉（檢查中斷使能寄存器）。

（3）日志：timeout, ipd: 0x80, state: 1或scl was hold by slave

?問題：SCL被從設(shè)備拉低（總線卡死）；

?排查方法：

a.排除法：若外設(shè)少，逐個斷開外設(shè)，復(fù)現(xiàn)問題定位“元兇”；

b.硬件檢測：在SCL總線串入電阻（如220Ω，約上拉電阻的1/20），測量電阻兩端壓差——電壓更低的一端對應(yīng)拉低SDA/SCL的設(shè)備；

c.波形驗(yàn)證：用示波器抓取波形，對比不同從設(shè)備的低電平，與故障時的低電平匹配的即為問題設(shè)備。

3.終極Debug：抓取I2C波形

若以上方法無法解決，最有效的方式是抓取故障時的I2C波形：

1.在代碼中“卡住CPU”：在出錯位置加while(1)，避免發(fā)起新的I2C任務(wù)；

2.用示波器測量SDA和SCL引腳：觀察是否有起始信號、地址字節(jié)、ACK信號；

3.對比協(xié)議要求：若波形缺失（如無起始信號），檢查控制器配置；若有NACK，檢查從設(shè)備地址或狀態(tài)。

四、RK I2C開發(fā)知識腦圖

最后，用一張腦圖總結(jié)全文核心，方便大家收藏回顧：

寫在最后

RK平臺的I2C開發(fā)，核心是“理解協(xié)議+區(qū)分驅(qū)動+重視時序”——只要掌握了硬件原理和數(shù)據(jù)幀規(guī)則，再結(jié)合官方文檔配置驅(qū)動、排查問題，就能快速搞定絕大多數(shù)場景。

如果大家在開發(fā)中遇到具體問題，歡迎在評論區(qū)交流；也可以收藏本文，遇到問題時對照腦圖和排查步驟，效率會更高！