在嵌入式開發(fā)中，ADC（模擬數(shù)字轉(zhuǎn)換器）堪稱“模擬世界與數(shù)字世界的橋梁”——電池電壓檢測(cè)、溫度采集、按鍵識(shí)別，幾乎所有需要感知物理量的場(chǎng)景都離不開它。

今天我們就聚焦RK3576平臺(tái)，從驅(qū)動(dòng)架構(gòu)、核心代碼、實(shí)戰(zhàn)使用三個(gè)維度，徹底講透U-Boot下ADC驅(qū)動(dòng)的實(shí)現(xiàn)邏輯，無論是調(diào)試ADC功能，還是定制化開發(fā)，看完這篇都能落地！

一、先搞懂：RK3576 ADC驅(qū)動(dòng)的整體架構(gòu)

RK3576的ADC驅(qū)動(dòng)基于U-Boot的Driver Model（DM）框架設(shè)計(jì)，核心是“通用框架+芯片專屬驅(qū)動(dòng)”的分層思路，既保證了接口統(tǒng)一，又適配了硬件特性。

1.1核心文件結(jié)構(gòu)

整個(gè)驅(qū)動(dòng)的代碼都集中在u-boot/drivers/adc/目錄下，關(guān)鍵文件就這幾個(gè)：

u-boot/drivers/adc/├── adc-uclass.c     # ADC通用框架（提供統(tǒng)一API，上層調(diào)用不用管底層差異）├── rockchip-saradc-v2.c # RK3576專屬驅(qū)動(dòng)（新版SARADC v2，重點(diǎn)分析這個(gè)）├── rockchip-saradc.c  # 舊版驅(qū)動(dòng)（適配老芯片，RK3576不用）├── Kconfig       # 驅(qū)動(dòng)編譯配置└── Makefile       # 編譯規(guī)則

1.2核心分層邏輯

?上層：ADC通用框架（adc-uclass.c）提供標(biāo)準(zhǔn)化API（比如啟動(dòng)轉(zhuǎn)換、讀取數(shù)據(jù)），開發(fā)者只用調(diào)用這些接口，不用關(guān)心底層硬件；

?下層：rockchip-saradc-v2.c處理RK3576 ADC的硬件細(xì)節(jié)（寄存器操作、時(shí)鐘/復(fù)位配置、時(shí)序控制）。

二、核心代碼拆解：讀懂驅(qū)動(dòng)的“底層邏輯”

想要定制ADC驅(qū)動(dòng)，核心是搞懂3個(gè)關(guān)鍵部分：寄存器定義、驅(qū)動(dòng)初始化、轉(zhuǎn)換與數(shù)據(jù)讀取。

2.1先認(rèn)識(shí)：新版SARADC v2的寄存器

RK3576的SARADC v2寄存器結(jié)構(gòu)更完善，覆蓋了轉(zhuǎn)換控制、時(shí)序配置、中斷、數(shù)據(jù)存儲(chǔ)等全流程，核心寄存器如下（挑關(guān)鍵的講）：

structrockchip_saradc_regs {  u32 conv_con;   // 轉(zhuǎn)換控制（啟動(dòng)轉(zhuǎn)換、選擇通道、模式）  u32 t_pd_soc;   // 上電延時(shí)（配置ADC上電后的穩(wěn)定時(shí)間）  u32 t_das_soc;   // 數(shù)據(jù)采集時(shí)間（決定采樣精度）  u32 end_int_en;  // 轉(zhuǎn)換結(jié)束中斷使能（判斷轉(zhuǎn)換是否完成）  u32 status;    // ADC狀態(tài)寄存器  u32 data0-15;   // 16通道數(shù)據(jù)寄存器（轉(zhuǎn)換結(jié)果存在這里）};

2.2驅(qū)動(dòng)初始化：probe函數(shù)

驅(qū)動(dòng)加載時(shí)首先執(zhí)行probe函數(shù)，核心是完成“時(shí)鐘+復(fù)位”的初始化，為ADC工作做準(zhǔn)備：

staticintrockchip_saradc_probe(structudevice *dev){ structrockchip_saradc_priv *priv = dev_get_priv(dev); structclk clk; intret; // 1. 獲取復(fù)位控制（后續(xù)復(fù)位ADC用）  ret = reset_get_by_name(dev,"saradc-apb", &priv->rst); // 2. 獲取并配置時(shí)鐘（設(shè)置ADC工作時(shí)鐘頻率）  ret = clk_get_by_index(dev,0, &clk);  ret = clk_set_rate(&clk, priv->data->clk_rate); // 3. 等待PLL穩(wěn)定（硬件要求，避免時(shí)鐘不穩(wěn)導(dǎo)致采樣錯(cuò)誤）  mdelay(5);  priv->active_channel =-1;// 初始化當(dāng)前激活通道為-1（無激活） return0;}

核心邏輯：ADC工作前必須先配置時(shí)鐘（保證時(shí)序穩(wěn)定），獲取復(fù)位控制（后續(xù)啟動(dòng)轉(zhuǎn)換前復(fù)位ADC）。

2.3啟動(dòng)通道轉(zhuǎn)換：開始采樣

想要讀取某個(gè)通道的ADC值，第一步是啟動(dòng)該通道的轉(zhuǎn)換，核心函數(shù)rockchip_saradc_start_channel：

static int rockchip_saradc_start_channel(struct udevice *dev, int channel){  struct rockchip_saradc_priv *priv = dev_get_priv(dev);  intval; // 1. 檢查通道是否有效（RK3576最多支持8個(gè)通道） if(channel = priv->data->num_channels) {    pr_err("Requested channel is invalid!");   return-EINVAL;  } // 2. 復(fù)位ADC（保證每次轉(zhuǎn)換的初始狀態(tài)一致）  reset_assert(&priv->rst);  udelay(10);  reset_deassert(&priv->rst); // 3. 配置時(shí)序參數(shù)（上電延時(shí)、數(shù)據(jù)采集時(shí)間）  writel(0x20, &priv->regs->t_pd_soc);  writel(0xc, &priv->regs->t_das_soc); // 4. 使能轉(zhuǎn)換結(jié)束中斷（方便判斷轉(zhuǎn)換完成） val= SARADC2_EN_END_INT <regs->end_int_en); // 5. 啟動(dòng)單次轉(zhuǎn)換（選擇通道+單次模式+啟動(dòng)） val= SARADC2_START | SARADC2_SINGLE_MODE | channel;  writel(val<regs->conv_con);  udelay(100);  priv->active_channel = channel;// 標(biāo)記當(dāng)前激活通道 return0;}

核心邏輯：先復(fù)位清狀態(tài)→配置時(shí)序（保證采樣精度）→使能中斷→啟動(dòng)單次轉(zhuǎn)換，每一步都是為了讓ADC穩(wěn)定輸出數(shù)據(jù)。

2.4讀取轉(zhuǎn)換數(shù)據(jù)：拿到最終值

啟動(dòng)轉(zhuǎn)換后，通過rockchip_saradc_channel_data讀取數(shù)據(jù)，核心是“等中斷+讀寄存器+清標(biāo)志”：

staticintrockchip_saradc_channel_data(structudevice *dev,intchannel,                   unsignedint*data){ structrockchip_saradc_priv*priv =dev_get_priv(dev);  u32 status; // 1. 檢查通道是否匹配（只能讀當(dāng)前激活的通道） if(channel != priv->active_channel) {   pr_err("Requested channel is not active!");   return-EINVAL;  } // 2. 等待轉(zhuǎn)換完成（超時(shí)則返回錯(cuò)誤） if(readl_poll_timeout(&priv->regs->end_int_st, status,             status & SARADC2_EN_END_INT, SARADC_TIMEOUT)) {   pr_err("Wait for end conversion interrupt status timeout!n");   return-ETIMEDOUT;  } // 3. 清除中斷標(biāo)志（避免影響下一次轉(zhuǎn)換） writel(0x1, &priv->regs->end_int_st); // 4. 讀取數(shù)據(jù)并應(yīng)用掩碼（RK3576是12位精度，掩碼過濾無效位）  *data =readl(&priv->regs->data0 + priv->active_channel);  *data &= uc_pdata->data_mask; return0;}

三、一張圖看懂：ADC完整工作流程

把上面的代碼邏輯串起來，RK3576 ADC的工作流程可以總結(jié)為這張圖，一目了然：

四、設(shè)備樹配置：硬件參數(shù)的“入口”

RK3576的ADC硬件參數(shù)都定義在設(shè)備樹arch/arm/dts/rk3576.dtsi里，核心配置如下，改參數(shù)不用動(dòng)驅(qū)動(dòng)，改設(shè)備樹即可：

saradc: adc@2ae00000{  compatible ="rockchip,rk3576-saradc","rockchip,rk3588-saradc";  reg = <0x0?0x2ae00000?0x0?0x10000>;//寄存器基地址  interrupts = ;//中斷號(hào) #io-channel-cells = <1>;  clocks = <&cru CLK_SARADC>, <&cru PCLK_SARADC>;//時(shí)鐘源  clock-names ="saradc","apb_pclk";  resets = <&cru SRST_P_SARADC>;//復(fù)位控制 reset-names ="saradc-apb";  status ="disabled";//默認(rèn)禁用，啟用改"okay"};

關(guān)鍵參數(shù)解讀：

?compatible：驅(qū)動(dòng)匹配標(biāo)識(shí)（RK3576復(fù)用RK3588的驅(qū)動(dòng)）；

?reg：ADC寄存器的物理基地址，驅(qū)動(dòng)通過這個(gè)地址操作硬件；

?clocks：ADC的工作時(shí)鐘和APB時(shí)鐘，決定采樣速率；

?resets：復(fù)位控制器，驅(qū)動(dòng)通過它復(fù)位ADC模塊。

五、實(shí)戰(zhàn)：U-Boot中如何讀取ADC值

驅(qū)動(dòng)最終是為了用，U-Boot提供了通用API，幾行代碼就能讀取ADC值，還能轉(zhuǎn)換成實(shí)際電壓：

unsignedintadc_value;intret;//讀取通道0的ADC值（設(shè)備名對(duì)應(yīng)設(shè)備樹里的saradc@2ae00000）ret = adc_channel_single_shot("saradc@2ae00000",0, &adc_value);if(ret) { printf("ADC read failed:%dn", ret);}else{ printf("ADC value:%dn", adc_value); //轉(zhuǎn)換為電壓（12位精度，參考電壓1.8V → 1LSB =1.8V/4095≈0.439mV） intvoltage = (adc_value *1800) /4095; printf("Voltage:%dmVn", voltage);}

六、新舊版本對(duì)比：為什么RK3576用v2版驅(qū)動(dòng)？

RK3576棄用舊版rockchip-saradc.c，改用rockchip-saradc-v2.c，核心是v2版功能更強(qiáng)大：

七、總結(jié)

RK3576的ADC驅(qū)動(dòng)設(shè)計(jì)，完美體現(xiàn)了U-Boot DM框架的核心思想：分層解耦。

?通用框架層：屏蔽硬件差異，提供統(tǒng)一API，上層應(yīng)用不用改；

?硬件驅(qū)動(dòng)層：專注處理RK3576的硬件細(xì)節(jié)（寄存器、時(shí)鐘、復(fù)位），適配新芯片只需改這層；

這種設(shè)計(jì)不僅讓代碼易維護(hù)、易擴(kuò)展，也給我們開發(fā)帶來啟示：嵌入式驅(qū)動(dòng)開發(fā)，優(yōu)先復(fù)用框架，聚焦硬件差異即可。

如果你的項(xiàng)目中需要調(diào)試RK3576的ADC功能，比如電池檢測(cè)、溫度采集，不妨從這篇文章的思路入手——先看架構(gòu)，再拆代碼，最后結(jié)合設(shè)備樹和實(shí)戰(zhàn)示例，問題往往能迎刃而解。

審核編輯 黃宇