在嵌入式開(kāi)發(fā)中，ADC（模數(shù)轉(zhuǎn)換）是連接模擬世界與數(shù)字系統(tǒng)的關(guān)鍵橋梁，而U-Boot作為嵌入式領(lǐng)域的經(jīng)典引導(dǎo)程序，其ADC子系統(tǒng)的設(shè)計(jì)堪稱分層架構(gòu)與通用化設(shè)計(jì)的典范。本文將從架構(gòu)、流程、數(shù)據(jù)流到實(shí)戰(zhàn)開(kāi)發(fā)，全方位拆解U-Boot ADC Uclass的設(shè)計(jì)精髓，幫你吃透這一核心子系統(tǒng)。

一、架構(gòu)概覽：三層架構(gòu)，職責(zé)分明

U-Boot的ADC子系統(tǒng)基于DM（Driver Model）驅(qū)動(dòng)模型構(gòu)建，采用清晰的三層架構(gòu)，讓不同層級(jí)各司其職：

?應(yīng)用層：開(kāi)發(fā)者只需調(diào)用標(biāo)準(zhǔn)化API（如adc_channel_single_shot），無(wú)需關(guān)注底層硬件細(xì)節(jié)；

?Uclass層（核心）：封裝統(tǒng)一接口、通道合法性檢查、電源管理、超時(shí)處理等通用邏輯，是整個(gè)子系統(tǒng)的“中樞”；

?驅(qū)動(dòng)層：針對(duì)不同硬件（如瑞芯微saradc）實(shí)現(xiàn)寄存器操作、硬件初始化等專屬邏輯；

?硬件層：ADC外設(shè)的物理寄存器與模擬采樣電路。

核心數(shù)據(jù)結(jié)構(gòu)：撐起整個(gè)子系統(tǒng)的骨架

1.平臺(tái)數(shù)據(jù)結(jié)構(gòu)adc_uclass_platdata

存儲(chǔ)ADC的核心配置信息，包括數(shù)據(jù)格式、精度掩碼、超時(shí)時(shí)間、電源信息等，是Uclass層與驅(qū)動(dòng)層交互的關(guān)鍵：

structadc_uclass_platdata{ intdata_format;          // 數(shù)據(jù)格式（BIN/2S補(bǔ)碼） unsignedintdata_mask;      // 數(shù)據(jù)掩碼（決定ADC精度） unsignedintdata_timeout_us;   // 單通道超時(shí)時(shí)間 unsignedintmultidata_timeout_us; // 多通道超時(shí)時(shí)間 unsignedintchannel_mask;     // 可用通道掩碼 structudevice*vdd_supply;    // VDD電源調(diào)節(jié)器 // 省略部分字段...};

2.驅(qū)動(dòng)操作接口adc_ops

定義驅(qū)動(dòng)層需實(shí)現(xiàn)的核心回調(diào)函數(shù)，是Uclass層與驅(qū)動(dòng)層的“契約”：

structadc_ops { int(*start_channel)(structudevice *dev,intchannel); int(*start_channels)(structudevice *dev,unsignedintchannel_mask); int(*channel_data)(structudevice *dev,intchannel,unsignedint*data); // 省略部分接口...};

二、核心流程：從初始化到單次采樣的完整鏈路

1.初始化流程：設(shè)備樹(shù)到硬件就緒

ADC設(shè)備的初始化圍繞設(shè)備樹(shù)解析展開(kāi)，核心是平臺(tái)數(shù)據(jù)的填充與硬件初始化：

2.單次采樣：最常用的核心流程

adc_channel_single_shot是最常用的ADC采樣API，其完整流程堪稱“通用化設(shè)計(jì)”的典范：

關(guān)鍵設(shè)計(jì)亮點(diǎn)：超時(shí)與輪詢的通用化

adc_channel_data函數(shù)實(shí)現(xiàn)了“驅(qū)動(dòng)層返回狀態(tài)+ Uclass層處理輪詢/超時(shí)”的解耦設(shè)計(jì)，讓所有驅(qū)動(dòng)復(fù)用同一套邏輯：

intadc_channel_data(structudevice *dev,intchannel,unsignedint*data){ structadc_uclass_platdata*uc_pdata =dev_get_uclass_platdata(dev); conststructadc_ops*ops =dev_get_driver_ops(dev); unsignedinttimeout_us = uc_pdata->data_timeout_us; intret; // 通道合法性檢查  ret =check_channel(dev, channel, CHECK_NUMBER, __func__); if(ret)   returnret; // 輪詢讀?。候?qū)動(dòng)只需返回-EBUSY表示硬件忙 do{    ret = ops->channel_data(dev, channel, data);   if(!ret || ret != -EBUSY)     break;   sdelay(5);// 短延時(shí)，非udelay  }while(timeout_us--); returnret;}

三、數(shù)據(jù)流：從模擬信號(hào)到電壓值的完整轉(zhuǎn)換

ADC的核心是“模擬信號(hào)→數(shù)字值→電壓值”的轉(zhuǎn)換，其數(shù)據(jù)流路徑清晰且通用：

實(shí)戰(zhàn)：從原始值到電壓的計(jì)算

拿到ADC原始值后，需結(jié)合參考電壓計(jì)算實(shí)際電壓（以12位ADC為例）：

unsignedintadc_value;intvdd_uv, ret;//1. 讀取ADC原始值ret = adc_channel_single_shot("saradc@2ae00000",0, &adc_value);if(ret) { printf("ADC讀取失敗:%dn", ret); return;}//2. 獲取參考電壓（如1.8V）ret = adc_vdd_value(dev, &vdd_uv);//3. 轉(zhuǎn)換為電壓（12位ADC最大值4095）intvoltage_uv = ((u64)adc_value * vdd_uv) /4095;printf("電壓值：%duV（%dmV）n", voltage_uv, voltage_uv /1000);

注意：需用64位運(yùn)算防止乘法溢出，避免精度損失！

四、多通道采樣：優(yōu)雅的降級(jí)策略

U-Boot ADC子系統(tǒng)對(duì)多通道采樣做了人性化設(shè)計(jì)：優(yōu)先使用硬件多通道（高效），若硬件不支持則自動(dòng)降級(jí)為單通道逐個(gè)采樣（兼容），且對(duì)上層應(yīng)用完全透明：

intadc_channels_single_shot(constchar*name,unsignedintchannel_mask,              structadc_channel *channels){ structudevice*dev; intret;  ret =uclass_get_device_by_name(UCLASS_ADC, name, &dev); if(ret)   returnret; // 策略1：嘗試硬件多通道  ret =adc_start_channels(dev, channel_mask); if(ret)   gototry_manual;  ret =adc_channels_data(dev, channel_mask, channels); if(ret)   returnret; return0;try_manual: // 策略2：降級(jí)為單通道逐個(gè)采樣 if(ret != -ENOSYS)   returnret; return_adc_channels_single_shot(dev, channel_mask, channels);}

五、開(kāi)發(fā)者實(shí)戰(zhàn)指南：避坑+最佳實(shí)踐

1.驅(qū)動(dòng)開(kāi)發(fā)：聚焦硬件，別重復(fù)造輪子

?channel_data只需返回狀態(tài)：硬件忙返回-EBUSY，就緒則返回原始值，超時(shí)/輪詢交給Uclass層；

?必須填充uclass_platdata：尤其是data_mask（精度）、channel_mask（有效通道）、data_timeout_us（超時(shí)時(shí)間）；

?示例：正確的驅(qū)動(dòng)層channel_data實(shí)現(xiàn)

staticintgood_channel_data(structudevice *dev,intchannel,unsignedint*data){ structrockchip_saradc_regs*regs = priv->regs; // 僅檢查硬件狀態(tài)，不做循環(huán)/延時(shí) if(!(readl(®s->status) & DATA_READY))   return-EBUSY;  *data =readl(®s->data); return0;}

2.應(yīng)用開(kāi)發(fā)：細(xì)節(jié)決定成敗

?設(shè)備名稱要匹配：需與設(shè)備樹(shù)中ADC節(jié)點(diǎn)的名稱一致（如saradc@2ae00000）；

?電壓計(jì)算防溢出：優(yōu)先用u64類型做乘法，再做除法；

?區(qū)分sdelay和udelay：sdelay是循環(huán)延時(shí)，非微秒級(jí)延時(shí)，精準(zhǔn)延時(shí)需用udelay。

3.設(shè)備樹(shù)配置：電源與通道

adc@2ae00000 {  compatible ="rockchip,saradc-v2";  reg = <0x2ae00000?0x100>; // 電源配置  vdd-supply = <&adc_vdd_reg>;  vdd-microvolts = <1800000>;// 1.8V參考電壓 // 有效通道（0-3）  channel_mask = <0x0F>;};

六、Uclass設(shè)計(jì)的核心思想：通用化與解耦

U-Boot ADC Uclass的設(shè)計(jì)堪稱嵌入式驅(qū)動(dòng)設(shè)計(jì)的典范，核心思想可總結(jié)為：

總結(jié)

U-Boot ADC Uclass通過(guò)分層架構(gòu)、通用化接口、優(yōu)雅的降級(jí)策略，實(shí)現(xiàn)了“一次開(kāi)發(fā)，多硬件兼容”的目標(biāo)。對(duì)于開(kāi)發(fā)者而言，無(wú)需關(guān)注底層硬件差異，只需調(diào)用標(biāo)準(zhǔn)化API即可完成ADC采樣；對(duì)于驅(qū)動(dòng)開(kāi)發(fā)者，只需實(shí)現(xiàn)硬件專屬邏輯，復(fù)用Uclass層的通用能力。

這種“通用邏輯上提，硬件邏輯下沉”的設(shè)計(jì)思路，不僅是U-Boot驅(qū)動(dòng)模型的核心，更是嵌入式系統(tǒng)設(shè)計(jì)的通用準(zhǔn)則。掌握這一設(shè)計(jì)思想，無(wú)論是開(kāi)發(fā)新的ADC驅(qū)動(dòng)，還是理解其他Uclass子系統(tǒng)（如I2C、SPI），都能觸類旁通。

審核編輯 黃宇