在RK（瑞芯微）平臺(tái)開發(fā)中，時(shí)鐘（CLK）子系統(tǒng)是SOC的“心臟”——CPU變頻、DDR數(shù)據(jù)傳輸、以太網(wǎng)通信、LCD顯示等所有組件的穩(wěn)定運(yùn)行，都依賴精準(zhǔn)的時(shí)鐘信號(hào)。但時(shí)鐘樹復(fù)雜、配置參數(shù)多、調(diào)試踩坑頻繁，一直是開發(fā)者的痛點(diǎn)。

今天這篇文章，從核心知識(shí)、實(shí)操調(diào)試步驟到常見問題解決方案，幫你系統(tǒng)掌握RK平臺(tái)CLK開發(fā)，少走彎路！

一、RK平臺(tái)CLK核心知識(shí)：搞懂這些不迷路

時(shí)鐘子系統(tǒng)的核心是“精準(zhǔn)分配與控制”，需先掌握3大核心模塊：基礎(chǔ)框架、GPIO輸出時(shí)鐘、PLL展頻（降EMI關(guān)鍵）。

1.基礎(chǔ)框架：時(shí)鐘樹與關(guān)鍵組件

RK平臺(tái)時(shí)鐘以“樹狀結(jié)構(gòu)”（時(shí)鐘樹）分配，從源頭（晶振/ PLL）到終端（外設(shè)），依賴4類關(guān)鍵組件：

組件	作用	關(guān)鍵細(xì)節(jié)
晶振（Oscillator）	時(shí)鐘源頭，提供基礎(chǔ)頻率（如24M無源晶振）	所有PLL的輸入基準(zhǔn)，信號(hào)質(zhì)量直接影響后續(xù)時(shí)鐘穩(wěn)定性
PLL（鎖相環(huán)）	對(duì)晶振頻率倍頻，生成高頻時(shí)鐘（如CPU、DDR所需）	RK主流PLL分工明確：- APLL：獨(dú)占給CPU（隨CPU變頻調(diào)整）- DPLL：獨(dú)占給DDR- GPLL：總線/外設(shè)備份（常設(shè)594M/1200M）- CPLL/NPLL：LCDC/GMAC獨(dú)占
Divider（分頻器）	對(duì)PLL輸出頻率分頻，適配不同外設(shè)需求（如200M→50M）	支持整數(shù)分頻（如/ 2）和小數(shù)分頻（如I2S/UART需精準(zhǔn)頻率）
MUX（多路選擇器）	選擇時(shí)鐘來源（如外設(shè)可從GPLL或CPLL取時(shí)鐘）	寄存器配置選擇路徑，需注意“父時(shí)鐘與子時(shí)鐘的兼容性”
GATING（時(shí)鐘門控）	控制時(shí)鐘開關(guān)，降低功耗（設(shè)備不工作時(shí)關(guān)閉時(shí)鐘）	有引用計(jì)數(shù)機(jī)制：子時(shí)鐘打開時(shí)自動(dòng)打開父時(shí)鐘；所有子時(shí)鐘關(guān)閉才關(guān)父時(shí)鐘

此外，總線時(shí)鐘分“高速”和“低速”兩類，需根據(jù)外設(shè)需求選擇：

?高速總線（PERI）：ACLK_PERI（100-300M，如EMMC/USB/GMAC）、HCLK_PERI（37-150M）

?低速總線（BUS）：ACLK_BUS（100-300M，如I2C/I2S/SPI）、PCLK_BUS（50-150M）

2. GPIO輸出時(shí)鐘：降成本的關(guān)鍵設(shè)計(jì)

很多場(chǎng)景下，可通過SOC的GPIO輸出時(shí)鐘替代外部晶振（如WiFi、攝像頭），減少外圍電路成本。但需滿足3個(gè)前提：

（1）核心配置條件

1.IOMUX配置：GPIO必須支持“CLK輸出”功能（需查芯片TRM確認(rèn)）；

2.頻率匹配：優(yōu)先選擇晶振bypass輸出（如24M），信號(hào)質(zhì)量最優(yōu)；若從PLL分頻，需確認(rèn)外設(shè)是否接受信號(hào)抖動(dòng)；

3.驅(qū)動(dòng)能力：部分GPIO輸出波形差，需調(diào)整IO驅(qū)動(dòng)能力寄存器。

（2）主流芯片對(duì)應(yīng)關(guān)系（示例）

芯片型號(hào)	時(shí)鐘名稱	對(duì)應(yīng)GPIO	支持頻率
RK3399	SCLK_TESTOUT	GPIO2_D1/GPIO0_B0	24M、32K
RK3566/8	CLK_MAC0_OUT	GPIO2_C1	24M、25M、50M、125M
RK3588	REFCLKOUT	GPIO0_A0	24M
RK3576	REF_CLK0_OUT	GPIO0_A0	12M、24M、27M等

3. PLL展頻：解決EMI超標(biāo)的“神器”

時(shí)鐘信號(hào)是EMI（電磁干擾）的主要來源——高頻時(shí)鐘能量集中在窄頻段，易超標(biāo)。PLL展頻（SSCG）通過“將能量分散到寬頻段”，降低EMI峰值，是合規(guī)關(guān)鍵。

（1）核心參數(shù)

?調(diào)制速度：30-120KHz（需高于人耳聽覺范圍20KHz，避免噪音）；

?調(diào)制深度：0.1%-4%（深度越大，EMI降得越多，但需兼容外設(shè)頻率容忍度）。

（2）配置邏輯

?非RK3588芯片：需先開啟PLL小數(shù)模式（dsmpd=0），再配置展頻幅度（ssmod_spread）和速率（ssmod_divval）；

?RK3588芯片：?jiǎn)为?dú)配置sscg_en使能，再設(shè)幅度（mrr）、速率（mfr）和模式（center spread最優(yōu)，降抖動(dòng)）。

二、RK平臺(tái)CLK實(shí)操調(diào)試步驟：從查看狀態(tài)到問題定位

調(diào)試時(shí)鐘需按“先看狀態(tài)→再控參數(shù)→最后測(cè)輸出”的流程，以下是關(guān)鍵步驟和命令：

1.第一步：查看時(shí)鐘樹狀態(tài)

先確認(rèn)當(dāng)前時(shí)鐘樹結(jié)構(gòu)、頻率、使能狀態(tài)，定位異常時(shí)鐘：

# 查看所有時(shí)鐘的父時(shí)鐘、當(dāng)前頻率、使能計(jì)數(shù)cat/sys/kernel/debug/clk/clk_summary

關(guān)鍵關(guān)注：

?parent：是否為預(yù)期的父時(shí)鐘（如LCDC時(shí)鐘應(yīng)指向獨(dú)占PLL）；

?rate：當(dāng)前頻率是否符合需求（如百兆以太網(wǎng)需50M）；

?enable count：使能計(jì)數(shù)是否為1（0表示時(shí)鐘未開啟）。

2.第二步：控制時(shí)鐘頻率與使能

通過/sys/kernel/debug/clk/[時(shí)鐘名]/節(jié)點(diǎn)，直接調(diào)整頻率和使能：

# 1. 查看指定時(shí)鐘當(dāng)前頻率（以saradc為例）cat /sys/kernel/debug/clk/clk_saradc/clk_rate# 2. 設(shè)置時(shí)鐘頻率（如設(shè)為24M）echo24000000>/sys/kernel/debug/clk/clk_saradc/clk_rate# 3. 使能時(shí)鐘（kernel <6.1）echo1>/sys/kernel/debug/clk/clk_saradc/clk_enable_count# 3. 使能時(shí)鐘（kernel ≥6.1，需用prepare_enable）echo1>/sys/kernel/debug/clk/clk_saradc/clk_prepare_enable# 4. 關(guān)閉時(shí)鐘echo0>/sys/kernel/debug/clk/clk_saradc/clk_enable_count

3.第三步：GPIO輸出時(shí)鐘調(diào)試（以RK3399為例）

若需用GPIO輸出24M時(shí)鐘（替代外部晶振），步驟如下：

# 1. 設(shè)置測(cè)試時(shí)鐘頻率為24Mecho24000000 > /sys/kernel/debug/clk/clk_testout1_pll_src/clk_rateecho24000000 > /sys/kernel/debug/clk/clk_testout1/clk_rate# 2. 使能測(cè)試時(shí)鐘echo1 > /sys/kernel/debug/clk/clk_testout1/clk_enable_count# 3. 配置GPIO2_D1為CLK輸出功能（IOMUX）io -4 0xff77e004 0x000c0008

其他芯片參考：

?RK3566/8輸出CAM_CLK：io -4 0xfdc60064 0x70001000+echo 27000000 > /sys/kernel/debug/clk/clk_cam0_out/clk_rate

?RK3588輸出REFCLKOUT：io -4 0xfd5f0000 0x000f0001

4.第四步：TEST_CLK_OUT硬件測(cè)試

若需直接測(cè)量時(shí)鐘波形（如確認(rèn)LCDC DCLK），需配置TEST_CLK_OUT引腳：

1.配置MUX：選擇要輸出的時(shí)鐘源（如ACLK_PERI）；

# RK3399配置TEST_CLK源為24M（寄存器CRU_MISC_CON，地址0xff76050c）io-40xff76050c0x00000800

1.配置DIV：設(shè)置分頻比（如1分頻，輸出原頻率）；

# RK3399配置分頻比為1（寄存器CRU_CLKSEL58_CON，地址0xff7601e8）io-40xff7601e80x0f000000

1.使能GATING：打開時(shí)鐘門控；

# RK3399使能TEST_CLK（寄存器CRU_CLKGATE13_CON，地址0xff760334）io-40xff7603340x00000001

1.用示波器測(cè)量TEST_CLK_OUT引腳波形。

5.第五步：PLL展頻調(diào)試（以RK3588 GPLL為例）

若EMI超標(biāo)，需配置PLL展頻：

# 1. 設(shè)置展頻速率30KHz、幅度0.5%、模式為center spreadio-40xfd7c01cc0x00ff000c # 速率30KHzio-40xfd7c01cc0x3f000500 # 幅度0.5%io-40xfd7c01cc0xc0008000 # center spread模式# 2. 使能展頻功能io-40xfd7c01d00x00010001

三、常見問題與解決方案：避坑指南

1. PLL頻率設(shè)置失敗，返回- 1

?現(xiàn)象：調(diào)用clk_set_rate設(shè)置PLL頻率，返回負(fù)數(shù)；

?原因：目標(biāo)頻率不在PLL頻率表格中（如RK3399的rk3399_pll_rates）；

?解決方案：按PLL公式補(bǔ)全頻率表格：

// 公式：VCO=24M*FBDIV/REFDIV（450M~2200M）；FOUT=VCO/POSTDIV1/POSTDIV2// 示例：添加594M頻率（VCO=1188M=24*99/2，F(xiàn)OUT=1188/2/1）RK3036_PLL_RATE(594000000,2,99,2,1,1,0),

2.小數(shù)分頻時(shí)鐘抖動(dòng)大、頻偏超標(biāo)

?現(xiàn)象：I2S/UART用小數(shù)分頻后，信號(hào)抖動(dòng)超外設(shè)容忍范圍；

?原因：未滿足“小數(shù)分頻父時(shí)鐘頻率≥分頻后頻率×20”；

?解決方案：調(diào)整父時(shí)鐘頻率（如分頻后需12M，父時(shí)鐘需≥240M）。

3.以太網(wǎng)時(shí)鐘不精準(zhǔn)，通信丟包

?現(xiàn)象：百兆以太網(wǎng)（需50M）/千兆以太網(wǎng)（需125M）丟包、ping不通；

?原因：PLL輸出時(shí)鐘精度不足，或未使用獨(dú)立時(shí)鐘源；

?解決方案：

a.確認(rèn)PLL頻率精準(zhǔn)（如GMAC獨(dú)占CPLL，設(shè)為50M/125M）；

b.若仍不精準(zhǔn)，改用外部晶振（需硬件支持）。

4. LCD顯示異常（花屏、閃屏）

?現(xiàn)象：LCD無顯示或顯示異常，排查后是DCLK問題；

?原因：LCDC未獨(dú)占指定PLL（如RK3399雙顯需VOP0綁定VPLL、VOP1綁定CPLL）；

?解決方案：在DTS中配置獨(dú)占PLL：

// RK3399 VOP0（HDMI）綁定VPLL&vopb_rk_fb { assigned-clocks = <&cru?DCLK_VOP0_DIV>; assigned-clock-parents = <&cru?PLL_VPLL>;};

5.展頻后DDR死機(jī)、USB測(cè)試失敗

?現(xiàn)象：打開PLL展頻后，DDR崩潰、USB 2.0頻率測(cè)試不通過；

?原因：展頻幅度過大，超出DDR/USB PHY的容忍范圍；

?解決方案：

a.降低展頻幅度（如從2%降至0.5%）；

b.DDR展頻需在LOADER階段配置（避免運(yùn)行中調(diào)整時(shí)鐘）；

c.USB需確認(rèn)PHY彈性buffer大?。?/span>buffer小則幅度需更小）。

6.時(shí)鐘被誤關(guān)閉，外設(shè)無法啟動(dòng)

?現(xiàn)象：外設(shè)（如I2C）啟動(dòng)失敗，clk_summary顯示時(shí)鐘enable count為0；

?原因：時(shí)鐘未配置“常開”屬性，初始化后被系統(tǒng)關(guān)閉；

?解決方案：

a.kernel <6.1：添加CLK_IGNORE_UNUSEDflag；

GATE(PCLK_PMUGRF_PMU,"pclk_pmugrf_pmu","pclk_pmu_src", CLK_IGNORE_UNUSED, RK3399_PMU_CLKGATE_CON(1),1, GFLAGS),

a.kernel ≥6.1：添加CLK_IS_CRITICALflag，或在bootargs加clk_gate.always_on=1。

四、總結(jié)與注意事項(xiàng)

1.芯片差異是關(guān)鍵：不同RK芯片（如RK3588 vs RK3328）的時(shí)鐘方案、寄存器地址差異大，調(diào)試前務(wù)必參考對(duì)應(yīng)芯片的TRM和官方指南；

2.優(yōu)先軟件調(diào)試，再動(dòng)硬件：先通過sys/debug節(jié)點(diǎn)調(diào)整時(shí)鐘，確認(rèn)邏輯正確后，再固化到DTS或驅(qū)動(dòng)；

3.展頻需謹(jǐn)慎：展頻雖降EMI，但可能影響敏感外設(shè)（如以太網(wǎng)、CAN），需充分做穩(wěn)定性測(cè)試；

4.文檔參考：遇到問題可查閱瑞芯微官方文檔：

?《Rockchip Clock開發(fā)指南》（時(shí)鐘子系統(tǒng)框架）；

?《Rockchip Gpio Output Clocks》（GPIO輸出時(shí)鐘配置）；

?《Rockchip PLL展頻功能詳細(xì)說明》（EMI優(yōu)化）。

時(shí)鐘子系統(tǒng)雖復(fù)雜，但掌握“基礎(chǔ)框架→調(diào)試工具→問題定位”的邏輯后，就能輕松應(yīng)對(duì)。如果本文對(duì)你有幫助，歡迎點(diǎn)贊、轉(zhuǎn)發(fā)，評(píng)論區(qū)交流你的調(diào)試踩坑經(jīng)歷！