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

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

為什么需要在U-Boot中做ADC檢測(cè)？

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

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

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

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

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

要在U-Boot中使用SARADC，首先需要確保其設(shè)備樹(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; 是一個(gè)關(guān)鍵屬性，  * 它告訴 U-Boot 的驅(qū)動(dòng)模型（Driver Model）  * 在 relocation（重定位）之前就初始化這個(gè)設(shè)備。  * 因?yàn)槲覀円?board_init_f 階段（重定位前）讀取ADC，  * 所以必須添加此屬性。  */  u-boot, dm-pre-reloc;  status ="okay";};

代碼解讀:

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

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

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

第二步：編寫(xiě)ADC檢測(cè)邏輯

接下來(lái)，我們?cè)诎寮?jí)初始化文件中添加實(shí)際的檢測(cè)代碼。

文件路徑: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)的最高等級(jí) unsignedintadc_value;// 存儲(chǔ)原始ADC讀數(shù) (0-4095 for 12-bit) unsignedintvoltage_mv;// 轉(zhuǎn)換后的電壓值 (mV) /* 2. 定義電壓區(qū)間與硬件版本的對(duì)應(yīng)關(guān)系 */ /* 這是一個(gè)典型的電阻分壓網(wǎng)絡(luò)設(shè)計(jì)，不同的電阻組合產(chǎn)生不同的電壓。   你需要根據(jù)自己的硬件原理圖來(lái)修改這兩個(gè)數(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è)備樹(shù)中的節(jié)點(diǎn)名，3 是要讀取的通道號(hào) */ if(adc_channel_single_shot("saradc",3, &adc_value) ==0) {   /* 4. 將ADC原始值轉(zhuǎn)換為電壓值 (mV) */   /*     計(jì)算公式：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ù)電壓值查找匹配的硬件等級(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. 將檢測(cè)結(jié)果存入U(xiǎn)-Boot環(huán)境變量 */   /* 環(huán)境變量 SBCID 可以在后續(xù)的啟動(dòng)腳本中被讀取和使用 */   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");  }}/** 將檢測(cè)函數(shù)注冊(cè)到U-Boot的初始化序列中。* board_init_r 是一個(gè)合適的位置，它在設(shè)備初始化完成后、* 環(huán)境變量初始化后、啟動(dòng)倒計(jì)時(shí)開(kāi)始前執(zhí)行。*/// 注意：具體的注冊(cè)方式可能因U-Boot版本而異，// 請(qǐng)查閱你所用U-Boot版本的板級(jí)文件，找到合適的位置調(diào)用 sbc_id_detection();// 例如，在 board_r.c 的某個(gè)初始化函數(shù)中添加：// sbc_id_detection();

代碼解讀:

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

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

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

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

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

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

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

# 在 U-Boot 啟動(dòng)腳本中，可以這樣使用 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 會(huì)使用 $fdtfile 變量來(lái)加載正確的設(shè)備樹(shù)# run bootcmd

第四步：uboot 命令行中查看

bdinfo

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

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

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

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

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

下一步

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

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

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