在嵌入式開發(fā)中，我們經(jīng)常需要在系統(tǒng)啟動的早期階段（U-Boot）識別硬件版本或配置。本文將詳細(xì)介紹如何在U-Boot中為RK3588平臺添加SARADC（Successive Approximation Register Analog-to-Digital Converter）檢測功能，通過讀取ADC電壓值來區(qū)分不同的硬件版本，并將結(jié)果存入環(huán)境變量，為后續(xù)的啟動流程提供依據(jù)。

核心思路與應(yīng)用場景

為什么需要在U-Boot中做ADC檢測？

U-Boot作為引導(dǎo)加載程序，運(yùn)行在操作系統(tǒng)內(nèi)核之前，擁有極高的硬件訪問權(quán)限。在這個階段進(jìn)行ADC檢測，可以實(shí)現(xiàn)：

?硬件版本自動識別：通過讀取主板上由電阻分壓網(wǎng)絡(luò)決定的ADC引腳電壓，U-Boot可以判斷出當(dāng)前硬件的具體型號或版本。

?動態(tài)配置加載：根據(jù)識別出的硬件版本，U-Boot可以加載不同的設(shè)備樹（Device Tree）、啟動參數(shù)或執(zhí)行特定的初始化腳本，實(shí)現(xiàn)“一鏡像適配多硬件”的目標(biāo)。

?故障診斷：檢測關(guān)鍵電源電壓或傳感器狀態(tài)，在啟動早期發(fā)現(xiàn)硬件異常。

第一步：配置SARADC設(shè)備樹(DTS)

要在U-Boot中使用SARADC，首先需要確保其設(shè)備樹節(jié)點(diǎn)已正確配置并啟用。

文件路徑:u-boot/arch/arm/dts/rk3588-u-boot.dtsi

/* 在 rk3588-u-boot.dtsi 文件中找到并確認(rèn) saradc 節(jié)點(diǎn) */&saradc { /*  * u-boot, dm-pre-reloc; 是一個關(guān)鍵屬性，  * 它告訴 U-Boot 的驅(qū)動模型（Driver Model）  * 在 relocation（重定位）之前就初始化這個設(shè)備。  * 因?yàn)槲覀円?board_init_f 階段（重定位前）讀取ADC，  * 所以必須添加此屬性。  */  u-boot, dm-pre-reloc;  status ="okay";};

代碼解讀:

?&saradc:引用主設(shè)備樹中定義的saradc節(jié)點(diǎn)。

?u-boot, dm-pre-reloc;:核心配置。確保SARADC驅(qū)動在U-Boot早期階段（內(nèi)存重定位前）就被初始化，這樣我們才能在board_init_f或board_init_r中調(diào)用其功能。

?status = "okay";:啟用這個設(shè)備節(jié)點(diǎn)。

第二步：編寫ADC檢測邏輯

接下來，我們在板級初始化文件中添加實(shí)際的檢測代碼。

文件路徑:u-boot/arch/arm/mach-rockchip/board.c

/* 在 board.c 文件的合適位置（如 board_init_r 函數(shù)之前）添加此函數(shù) */voidsbc_id_detection(void){ /* 1. 定義變量 */ intclosest_level =7;// 默認(rèn)的最高等級 unsignedintadc_value;// 存儲原始ADC讀數(shù) (0-4095 for 12-bit) unsignedintvoltage_mv;// 轉(zhuǎn)換后的電壓值 (mV) /* 2. 定義電壓區(qū)間與硬件版本的對應(yīng)關(guān)系 */ /* 這是一個典型的電阻分壓網(wǎng)絡(luò)設(shè)計，不同的電阻組合產(chǎn)生不同的電壓。   你需要根據(jù)自己的硬件原理圖來修改這兩個數(shù)組中的值。 */ constintmin_mv[] = {1640,1430,1220,1000,790, 560, 350, 0}; constintmax_mv[] = {1840,1630,1420,1200,990, 770, 550,250}; /* 3. 讀取ADC通道3的值 */ /* "saradc" 是設(shè)備樹中的節(jié)點(diǎn)名，3 是要讀取的通道號 */ if(adc_channel_single_shot("saradc",3, &adc_value) ==0) {   /* 4. 將ADC原始值轉(zhuǎn)換為電壓值 (mV) */   /*     計算公式：Vout = Vin * (ADC_Value / 2^n)     - Vin (參考電壓) = 1800 mV (根據(jù)瑞芯微文檔)     - n (ADC位數(shù)) = 12 bits, 所以 2^12 = 4096    */    voltage_mv = (adc_value *1800) /4095;   /* 5. 根據(jù)電壓值查找匹配的硬件等級 */   for(inti =0; i 8; i++) {     if(voltage_mv >= min_mv[i] && voltage_mv <= max_mv[i]) {        closest_level = i;       break;// 找到后立即跳出循環(huán)      }    }   /* 6. 將檢測結(jié)果存入U-Boot環(huán)境變量 */   /* 環(huán)境變量 SBCID 可以在后續(xù)的啟動腳本中被讀取和使用 */   env_set_ulong("SBCID", closest_level);      /* 調(diào)試信息，可以在串口終端看到 */   printf("SARADC: Voltage detected: %d mV, SBCID set to %dn", voltage_mv, closest_level);  }else{   /* 7. 處理ADC讀取失敗的情況 */   env_set("SBCID","unknown");   printf("SARADC: Failed to read from channel 3. SBCID set to 'unknown'n");  }}/** 將檢測函數(shù)注冊到U-Boot的初始化序列中。* board_init_r 是一個合適的位置，它在設(shè)備初始化完成后、* 環(huán)境變量初始化后、啟動倒計時開始前執(zhí)行。*/// 注意：具體的注冊方式可能因U-Boot版本而異，// 請查閱你所用U-Boot版本的板級文件，找到合適的位置調(diào)用 sbc_id_detection();// 例如，在 board_r.c 的某個初始化函數(shù)中添加：// sbc_id_detection();

代碼解讀:

1.adc_channel_single_shot(): U-Boot提供的便捷API，用于單次讀取指定ADC設(shè)備和通道的值。

2.電壓換算:根據(jù)瑞芯微手冊，SARADC的參考電壓Vref為1.8V（1800mV）。代碼將12位的ADC讀數(shù)（范圍0-4095）線性換算為實(shí)際電壓。

3.等級匹配:通過for循環(huán)將計算出的電壓值與預(yù)設(shè)的min_mv和max_mv數(shù)組進(jìn)行比較，找到對應(yīng)的硬件等級closest_level。

4.環(huán)境變量:env_set_ulong()將檢測到的等級存入名為SBCID的環(huán)境變量。這個變量非常關(guān)鍵，后續(xù)的啟動腳本（如boot.cmd）就可以通過判斷SBCID的值來執(zhí)行不同的操作。

第三步：如何使用檢測結(jié)果（參考）

檢測結(jié)果SBCID已存入環(huán)境變量，現(xiàn)在你可以在U-Boot的啟動腳本中靈活運(yùn)用它。

文件路徑:u-boot/board/rockchip/your_board/your_board.env(或類似的腳本文件)

# 在 U-Boot 啟動腳本中，可以這樣使用 SBCIDiftest${SBCID}-eq 0;then echo"Detected Board Version A. Loading corresponding Device Tree..."  setenv fdtfile rockchip/rk3588-board-version-a.dtbeliftest${SBCID}-eq 1;then echo"Detected Board Version B. Loading corresponding Device Tree..."  setenv fdtfile rockchip/rk3588-board-version-b.dtbelse echo"Detected unknown board or using default configuration."  setenv fdtfile rockchip/rk3588-board-default.dtbfi# 后續(xù)的 bootcmd 會使用 $fdtfile 變量來加載正確的設(shè)備樹# run bootcmd

第四步：uboot 命令行中查看

bdinfo

關(guān)鍵要點(diǎn)與風(fēng)險預(yù)案

1.時序問題:確保ADC檢測函數(shù)在所有必要驅(qū)動初始化之后調(diào)用。board_init_r是一個安全的選擇。

2.硬件依賴:此方案完全依賴于硬件設(shè)計。分壓電阻的精度、焊接質(zhì)量、以及ADC引腳的電氣連接都會影響檢測結(jié)果。

3.區(qū)間設(shè)計:在設(shè)計min_mv和max_mv數(shù)組時，要考慮到電阻容差和ADC采樣誤差，為每個區(qū)間留出足夠的余量，避免電壓值落在區(qū)間邊界導(dǎo)致誤判。

4.調(diào)試:在開發(fā)階段，可以將printf語句打開，通過串口終端觀察ADC的原始值、換算后的電壓值以及最終的SBCID，這對于調(diào)試硬件和校準(zhǔn)區(qū)間非常有幫助。

下一步

?代碼集成:將上述代碼片段集成到您的U-Boot源碼樹中，并根據(jù)您的具體硬件原理圖，精確調(diào)整min_mv和max_mv數(shù)組的值。

?腳本優(yōu)化:完善您的U-Boot啟動腳本，利用SBCID環(huán)境變量實(shí)現(xiàn)更復(fù)雜的啟動邏輯，例如加載不同的內(nèi)核參數(shù)或根文件系統(tǒng)。

希望這篇文章能幫助您順利完成U-Boot中的ADC檢測功能開發(fā)。