1. 項(xiàng)目概述為什么高通8155平臺(tái)的開源代碼如此重要最近有不少做車機(jī)系統(tǒng)開發(fā)的朋友在后臺(tái)問我有沒有高通8155平臺(tái)最新的開源代碼和編譯方法。這確實(shí)是個(gè)好問題也是當(dāng)前智能座艙開發(fā)領(lǐng)域的一個(gè)核心痛點(diǎn)。高通驍龍8155芯片作為第三代驍龍汽車數(shù)字座艙平臺(tái)的主力幾乎成了中高端智能汽車的“標(biāo)配”大腦。從理想、小鵬到蔚來再到傳統(tǒng)車企的新能源車型你都能看到它的身影。對(duì)于開發(fā)者而言拿到這塊芯片對(duì)應(yīng)的開源代碼意味著你能真正深入底層去定制啟動(dòng)引導(dǎo)程序、內(nèi)核驅(qū)動(dòng)甚至是系統(tǒng)服務(wù)。這不僅僅是技術(shù)探索更是實(shí)現(xiàn)差異化功能、優(yōu)化性能、解決特定硬件兼容性問題的關(guān)鍵。比如你想為自家車型的8155平臺(tái)增加一個(gè)獨(dú)特的開機(jī)動(dòng)畫或者優(yōu)化某個(gè)外設(shè)如特定型號(hào)的攝像頭或麥克風(fēng)的驅(qū)動(dòng)性能沒有底層代碼的支持幾乎是寸步難行。然而高通平臺(tái)的代碼獲取和編譯環(huán)境搭建歷來以“門檻高、資料散、坑點(diǎn)多”著稱。官方文檔往往面向大型OEM客戶對(duì)獨(dú)立開發(fā)者或小團(tuán)隊(duì)不夠友好。網(wǎng)上的資料又新舊混雜用著老版本的代碼去配新版本的工具鏈編譯報(bào)錯(cuò)能讓人排查到懷疑人生。今天我就結(jié)合自己最近一次成功拉取和編譯8155平臺(tái)AOSPAndroid Open Source Project底層代碼的實(shí)際經(jīng)歷把整個(gè)流程、關(guān)鍵配置和踩過的那些“坑”系統(tǒng)地梳理出來。目標(biāo)就一個(gè)讓你能對(duì)照著這份指南在Linux環(huán)境下把代碼下下來、環(huán)境配起來、鏡像編出來。2. 環(huán)境準(zhǔn)備與關(guān)鍵概念澄清在動(dòng)手之前我們必須把幾個(gè)關(guān)鍵概念和準(zhǔn)備工作理清楚這能避免后續(xù)90%的困惑。2.1 理解“開源代碼”的范疇BSP與AOSP當(dāng)我們說“高通8155平臺(tái)開源代碼”時(shí)通常指的是兩個(gè)部分的組合高通提供的BSPBoard Support Package這是芯片原廠提供的、與具體硬件平臺(tái)強(qiáng)相關(guān)的代碼包。它包括Bootloader如U-Boot或高通專用的ABL負(fù)責(zé)硬件初始化、加載內(nèi)核。內(nèi)核Kernel經(jīng)過高通深度定制和優(yōu)化的Linux內(nèi)核包含了8155芯片所有外設(shè)GPU、DSP、ISP、音頻編解碼器、各種總線接口等的驅(qū)動(dòng)。廠商閉源組件Proprietary Blobs一些涉及核心IP或協(xié)議的二進(jìn)制庫文件比如圖形庫、DSP固件、基帶相關(guān)模塊等。這部分不開源但編譯時(shí)需要。谷歌的AOSPAndroid Open Source Project這是Android系統(tǒng)的開源主體包含了系統(tǒng)框架、原生應(yīng)用、系統(tǒng)服務(wù)等。對(duì)于8155這樣的車規(guī)級(jí)平臺(tái)高通通常會(huì)提供一個(gè)基于特定Android版本的BSP參考代碼。我們的工作就是將高通的BSP代碼與對(duì)應(yīng)版本的AOSP代碼進(jìn)行整合與編譯。注意高通代碼的獲取通常需要與高通簽訂協(xié)議并獲得訪問權(quán)限訪問CodeAurora Forum 現(xiàn)已遷移至 高通開發(fā)者網(wǎng)絡(luò) 的特定區(qū)域。本文假設(shè)你已具備合法的獲取途徑重點(diǎn)講解獲取后的編譯方法。公開渠道無法直接下載完整的專有BSP。2.2 編譯主機(jī)環(huán)境搭建一個(gè)純凈、高效的Linux編譯環(huán)境是成功的第一步。我強(qiáng)烈推薦使用Ubuntu 20.04 LTS這是Android官方長(zhǎng)期兼容的版本社區(qū)資源也最豐富?；A(chǔ)系統(tǒng)配置# 更新系統(tǒng)并安裝基礎(chǔ)編譯工具 sudo apt update sudo apt upgrade -y sudo apt install -y git-core gnupg flex bison build-essential zip curl zlib1g-dev gcc-multilib g-multilib libc6-dev-i386 libncurses5 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig python3 # 安裝Repo工具谷歌用于管理AOSP倉庫的工具 mkdir -p ~/.bin curl https://storage.googleapis.com/git-repo-downloads/repo ~/.bin/repo chmod arx ~/.bin/repo # 將 ~/.bin 加入PATH環(huán)境變量如果尚未加入 echo export PATH$HOME/.bin:$PATH ~/.bashrc source ~/.bashrc磁盤空間要求這是新手最容易低估的一點(diǎn)。完整下載8155平臺(tái)的AOSPBSP代碼并完成一次完整編譯你需要準(zhǔn)備至少300GB的可用磁盤空間。我建議直接分配500GB以上。代碼倉庫本身大約80-100GB編譯輸出目錄out/在首次編譯時(shí)可能會(huì)達(dá)到150-200GB。內(nèi)存與CPU編譯過程極其消耗資源。建議主機(jī)擁有至少32GB物理內(nèi)存和8核以上CPU。16GB內(nèi)存可以編譯但可能會(huì)頻繁使用Swap導(dǎo)致速度極慢。使用SSD硬盤能顯著提升編譯速度。3. 代碼下載與倉庫同步實(shí)戰(zhàn)環(huán)境就緒后我們進(jìn)入最核心的步驟獲取代碼。這里以高通通常提供的基于Android 12S的8155 BSP為例。3.1 初始化AOSP主干代碼首先我們需要拉取對(duì)應(yīng)版本的AOSP主干代碼。高通BSP通常會(huì)指定一個(gè)具體的AOSP版本和分支。# 1. 創(chuàng)建一個(gè)工作目錄并進(jìn)入 mkdir -p ~/aosp_sa8155_android12 cd ~/aosp_sa8155_android12 # 2. 初始化Repo倉庫指定分支。這里以 android-12.1.0_r27一個(gè)常見的Tag為例。 # -b 指定分支--depth1 只拉取最新提交節(jié)省時(shí)間和空間。 repo init -u https://android.googlesource.com/platform/manifest -b android-12.1.0_r27 --depth1 # 3. 同步代碼庫。這是一個(gè)漫長(zhǎng)的過程取決于你的網(wǎng)絡(luò)速度可能需要數(shù)小時(shí)。 # -j4 表示使用4個(gè)線程同步可以根據(jù)你的網(wǎng)絡(luò)和CPU調(diào)整如 -j8。 repo sync -c --no-tags --no-clone-bundle -j4實(shí)操心得repo sync過程極易因網(wǎng)絡(luò)問題中斷。建議使用穩(wěn)定的網(wǎng)絡(luò)并可以編寫一個(gè)簡(jiǎn)單的重試腳本。如果中斷重新執(zhí)行repo sync即可Repo工具支持?jǐn)帱c(diǎn)續(xù)傳。3.2 集成高通BSP代碼包AOSP主干代碼拉取完成后你的目錄里還缺少高通硬件相關(guān)的代碼。這時(shí)你需要將高通提供的BSP代碼包集成進(jìn)來。高通通常會(huì)提供一個(gè)manifest XML文件和一個(gè)vendor補(bǔ)丁包。假設(shè)你獲得的BSP包解壓后有一個(gè)qcom-manifest.xml和一個(gè)vendor_qcom的目錄。# 1. 將高通的manifest文件復(fù)制到 .repo/local_manifests/ 目錄下 # 如果沒有這個(gè)目錄就創(chuàng)建它。 mkdir -p .repo/local_manifests cp /path/to/your/bsp/qcom-manifest.xml .repo/local_manifests/ # 2. 再次執(zhí)行 repo sync這次會(huì)拉取高通特定的硬件倉庫如 kernel/msm, vendor/qcom 等。 repo sync -c --no-tags --no-clone-bundle -j4 # 3. 應(yīng)用高通提供的vendor補(bǔ)丁如果有的話。 # 通常BSP包里會(huì)有一個(gè)腳本比如 apply_patches.sh運(yùn)行它即可。 cd /path/to/your/bsp ./apply_patches.sh ~/aosp_sa8155_android12關(guān)鍵點(diǎn)解析.repo/local_manifests/目錄下的XML文件擁有最高優(yōu)先級(jí)它會(huì)覆蓋或補(bǔ)充主manifest中的項(xiàng)目定義。通過這種方式高通將其私有的硬件代碼倉庫“注入”到了你的AOSP代碼樹中。3.3 驗(yàn)證代碼樹結(jié)構(gòu)同步完成后你的代碼樹應(yīng)該包含以下關(guān)鍵目錄device/qcom/高通平臺(tái)設(shè)備相關(guān)的配置特別是device/qcom/sa8155/或類似目錄這里存放著8155特定設(shè)備的編譯配置、啟動(dòng)腳本、分區(qū)表等。kernel/msm-5.4/或kernel/msm-5.10/高通定制化的Linux內(nèi)核源代碼。vendor/qcom/包含大量的閉源二進(jìn)制庫和頭文件。hardware/qcom/高通硬件抽象層HAL的實(shí)現(xiàn)。使用ls -la檢查這些目錄是否存在是驗(yàn)證代碼下載是否成功的第一步。4. 編譯配置與構(gòu)建過程詳解代碼到位接下來就是配置和編譯。這是最考驗(yàn)?zāi)托暮图?xì)心的環(huán)節(jié)。4.1 構(gòu)建環(huán)境初始化AOSP使用source和lunch命令來初始化編譯環(huán)境。# 1. 進(jìn)入代碼根目錄 cd ~/aosp_sa8155_android12 # 2. 導(dǎo)入編譯環(huán)境變量和命令 source build/envsetup.sh # 3. 選擇編譯目標(biāo)。這是最關(guān)鍵的一步 lunch執(zhí)行l(wèi)unch后會(huì)列出一個(gè)菜單。對(duì)于8155平臺(tái)目標(biāo)通常包含sa8155字樣。例如qssi_sa8155-userdebug這是最常見的用于開發(fā)的版本帶有root調(diào)試權(quán)限。qssi_sa8155-user用戶版本無調(diào)試權(quán)限。sa8155_auto-userdebug可能針對(duì)車載IVI車載信息娛樂系統(tǒng)的特定變體。我們選擇qssi_sa8155-userdebug輸入對(duì)應(yīng)的編號(hào)或全名。4.2 理解QSSIQualcomm Single System Image這里出現(xiàn)了一個(gè)重要概念QSSI。這是高通在Android 10之后引入的架構(gòu)旨在將系統(tǒng)鏡像System Image和供應(yīng)商鏡像Vendor Image分離編譯。qssi目標(biāo)編譯出的system.img是通用的可以與不同硬件平臺(tái)的vendor.img組合。這提升了系統(tǒng)通用性和OTA效率。對(duì)于開發(fā)者我們通常需要同時(shí)編譯qssi目標(biāo)和具體的設(shè)備目標(biāo)。4.3 開始編譯配置完成后使用mmake的封裝命令開始編譯。首次編譯耗時(shí)極長(zhǎng)在32核64GB內(nèi)存的機(jī)器上可能也需要2-4小時(shí)。# 使用 -j 參數(shù)指定并行編譯任務(wù)數(shù)通常設(shè)置為CPU核心數(shù)的1-1.5倍。 # 例如對(duì)于16核CPU m -j24 # 或者使用全速編譯 m編譯過程會(huì)輸出大量日志。你可以重點(diǎn)關(guān)注是否有[ERROR]出現(xiàn)。更常見的是一些[WARNING]通?？梢院雎浴２瓤訉?shí)錄編譯失敗最常見的原因內(nèi)存不足OOM編譯內(nèi)核或某些大型模塊時(shí)可能因內(nèi)存不足被系統(tǒng)殺死進(jìn)程。癥狀是編譯突然停止并伴有Killed信息。解決方案是增加Swap空間或增加物理內(nèi)存。# 創(chuàng)建一個(gè)32GB的Swap文件如果已有Swap可跳過 sudo fallocate -l 32G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile # 永久生效需寫入 /etc/fstabJava版本不匹配Android 12需要OpenJDK 11。確保你的默認(rèn)Java版本正確。sudo apt install openjdk-11-jdk sudo update-alternatives --config java # 選擇Java 11文件系統(tǒng)大小寫敏感在Windows WSL或某些Mac分區(qū)上編譯可能會(huì)因?yàn)槲募到y(tǒng)大小寫不敏感導(dǎo)致奇怪錯(cuò)誤。務(wù)必在Linux原生EXT4分區(qū)上進(jìn)行編譯。BSP與AOSP版本不匹配這是最致命的問題。務(wù)必確認(rèn)你下載的高通BSP manifest文件指定的AOSP分支與你repo init時(shí)使用的分支完全一致。4.4 編譯輸出與鏡像文件編譯成功后所有生成的鏡像文件位于out/target/product/sa8155/具體路徑可能因lunch目標(biāo)略有不同。你需要關(guān)注的核心鏡像有boot.img包含內(nèi)核和初始RAM磁盤。system.img系統(tǒng)分區(qū)鏡像。vendor.img供應(yīng)商分區(qū)鏡像。userdata.img用戶數(shù)據(jù)分區(qū)鏡像。super.imgAndroid 10動(dòng)態(tài)分區(qū)鏡像可能包含了system、vendor、product等的組合。vbmeta.imgAVBAndroid Verified Boot元數(shù)據(jù)鏡像。此外目錄下還會(huì)有flashall.batWindows或flashall.shLinux腳本用于一鍵刷機(jī)。但刷機(jī)有風(fēng)險(xiǎn)務(wù)必確認(rèn)鏡像與你的開發(fā)板完全匹配。5. 內(nèi)核的單獨(dú)編譯與調(diào)試有時(shí)我們只需要修改內(nèi)核驅(qū)動(dòng)或配置不需要編譯整個(gè)Android。高通平臺(tái)的內(nèi)核可以單獨(dú)編譯。5.1 配置與編譯獨(dú)立內(nèi)核# 1. 進(jìn)入內(nèi)核源碼目錄 cd ~/aosp_sa8155_android12/kernel/msm-5.4 # 請(qǐng)根據(jù)實(shí)際目錄調(diào)整 # 2. 設(shè)置交叉編譯工具鏈和環(huán)境變量 # AOSP已經(jīng)自帶了工具鏈通常路徑如下 export ARCHarm64 export SUBARCHarm64 export CROSS_COMPILE/path/to/your/aosp/prebuilts/gcc/linux-x86/aarch64/aarch64-linux-android-4.9/bin/aarch64-linux-android- # 3. 使用高通提供的默認(rèn)配置 make sa8155-perf_defconfig # 具體defconfig名稱需參考BSP文檔常見的有 sa8155-perf, sa8155_auto 等 # 4. 編譯內(nèi)核 make -j24編譯完成后會(huì)在arch/arm64/boot/下生成Image.gz-dtb文件這就是壓縮的內(nèi)核鏡像。5.2 將新內(nèi)核集成到Boot鏡像僅有內(nèi)核文件還不夠需要將其打包成Android可用的boot.img。# 回到AOSP根目錄 cd ~/aosp_sa8155_android12 # 重新初始化環(huán)境如果已初始化可跳過 source build/envsetup.sh lunch qssi_sa8155-userdebug # 使用AOSP的mkbootimg工具重新打包boot.img # 首先將新編譯的內(nèi)核復(fù)制到設(shè)備樹目錄假設(shè)位置 cp kernel/msm-5.4/arch/arm64/boot/Image.gz-dtb device/qcom/sa8155-kernel/ # 然后重新編譯bootimage。這會(huì)使用新的內(nèi)核文件。 m bootimage新的boot.img將生成在out/target/product/sa8155/目錄下你可以單獨(dú)刷寫這個(gè)鏡像來測(cè)試內(nèi)核改動(dòng)。6. 常見問題排查與解決技巧在實(shí)際操作中你幾乎一定會(huì)遇到各種問題。這里我整理了一個(gè)速查表涵蓋了最常見的一些錯(cuò)誤和解決方法。問題現(xiàn)象可能原因排查步驟與解決方案repo sync失敗報(bào)錯(cuò)fatal: unable to access...網(wǎng)絡(luò)問題無法訪問googlesource.com。1. 檢查網(wǎng)絡(luò)連接和代理設(shè)置。2. 嘗試更換國內(nèi)鏡像源如清華源修改repo init的-u參數(shù)為鏡像地址。3. 使用repo sync --no-clone-bundle。lunch菜單中沒有sa8155相關(guān)選項(xiàng)。1. BSP代碼未成功集成。2. 環(huán)境未正確初始化。1. 檢查.repo/local_manifests/下是否有高通的manifest文件。2. 重新執(zhí)行source build/envsetup.sh。3. 檢查device/qcom/目錄下是否存在sa8155子目錄。編譯中途報(bào)錯(cuò)ninja: build stopped: subcommand failed.這是編譯失敗的通用提示需要向上查看具體錯(cuò)誤。1. 查看錯(cuò)誤日志的最后幾十行尋找第一個(gè)[ERROR]。2. 常見原因依賴缺失、文件沖突、Python/Java版本不對(duì)、權(quán)限問題。編譯報(bào)錯(cuò)關(guān)于dex2oat或soong。通常是資源內(nèi)存/磁盤不足。1. 使用free -h和df -h檢查內(nèi)存和磁盤空間。2. 增加Swap空間。3. 嘗試用m -jN減少并行任務(wù)數(shù)N小一些。刷機(jī)后設(shè)備無法啟動(dòng)卡在開機(jī)Logo。1. 鏡像不匹配如userdebug刷成了user。2. 內(nèi)核或設(shè)備樹不兼容。3.vbmeta.img驗(yàn)證失敗。1.最安全使用高通提供的原廠鏡像恢復(fù)。2. 嘗試只刷寫boot.img和system.img保留原vendor.img。3. 刷機(jī)時(shí)使用fastboot flash vbmeta vbmeta.img --disable-verification禁用AVB驗(yàn)證僅用于開發(fā)測(cè)試。修改了device/或vendor/下的文件但編譯后未生效。編譯系統(tǒng)可能沒有檢測(cè)到更改。1. 執(zhí)行m installclean清理之前編譯的對(duì)應(yīng)模塊產(chǎn)物再重新編譯。2. 或者更徹底地刪除out/target/product/sa8155/目錄下相關(guān)文件再m。編譯時(shí)提示找不到某個(gè)命令或工具。編譯環(huán)境依賴未安裝完整。根據(jù)錯(cuò)誤提示使用apt search查找并安裝對(duì)應(yīng)的包。例如缺少libssl-dev、python3-xxx等。獨(dú)家技巧高效調(diào)試編譯錯(cuò)誤單模塊編譯如果你只修改了某個(gè)App或服務(wù)比如packages/apps/Car/Media可以直接在根目錄執(zhí)行mma來編譯當(dāng)前目錄及其依賴。這比全量編譯快得多。查看詳細(xì)日志編譯失敗時(shí)在輸出中會(huì)有一個(gè)路徑指向一個(gè)verbose.log.gz文件。解壓并查看這個(gè)文件里面有最詳細(xì)的編譯命令和錯(cuò)誤信息。使用CCache如果你需要頻繁清理并重新編譯設(shè)置CCache可以極大加速后續(xù)編譯。在~/.bashrc中添加export USE_CCACHE1 export CCACHE_EXEC/usr/bin/ccache ccache -M 50G # 設(shè)置緩存大小為50GB之后source ~/.bashrc并重啟終端。7. 進(jìn)階定制化開發(fā)與燒錄指南成功編譯出原生鏡像只是第一步。真正的開發(fā)工作始于定制化。7.1 添加一個(gè)系統(tǒng)級(jí)應(yīng)用假設(shè)你要為車機(jī)添加一個(gè)名為MyVehicleApp的系統(tǒng)應(yīng)用。創(chuàng)建應(yīng)用目錄在packages/apps/下創(chuàng)建MyVehicleApp/。編寫Android.mk或Android.bp這是AOSP的構(gòu)建腳本?，F(xiàn)在推薦使用Soong構(gòu)建系統(tǒng)Android.bp。// packages/apps/MyVehicleApp/Android.bp android_app { name: MyVehicleApp, srcs: [src/**/*.java], resource_dirs: [res], certificate: platform, // 使用平臺(tái)簽名成為系統(tǒng)應(yīng)用 privileged: true, // 如果需要特權(quán)權(quán)限 optimize: { enabled: false, // 開發(fā)時(shí)可關(guān)閉優(yōu)化便于調(diào)試 }, }將應(yīng)用加入產(chǎn)品配置編輯你的設(shè)備配置文件例如device/qcom/sa8155/device.mk或device/qcom/sa8155/sa8155.mk添加PRODUCT_PACKAGES \ MyVehicleApp重新編譯系統(tǒng)鏡像執(zhí)行m或m systemimage。你的應(yīng)用就會(huì)被集成到system.img中。7.2 修改系統(tǒng)屬性與默認(rèn)配置系統(tǒng)屬性定義在system.prop或default.prop中。你可以在設(shè)備樹的rootdir目錄下找到或創(chuàng)建它們。例如在device/qcom/sa8155/rootdir/vendor/etc/init/hw/init.qcom.rc中可以設(shè)置屬性并觸發(fā)服務(wù)。7.3 燒錄鏡像到開發(fā)板警告此操作會(huì)擦除開發(fā)板上所有數(shù)據(jù)請(qǐng)務(wù)必先備份重要數(shù)據(jù)并確認(rèn)鏡像與硬件完全匹配。通常使用高通提供的fastboot工具進(jìn)行燒錄。將開發(fā)板進(jìn)入fastboot模式通常通過按住特定按鍵上電。通過USB將開發(fā)板連接至主機(jī)。在主機(jī)終端進(jìn)入鏡像所在目錄cd out/target/product/sa8155/執(zhí)行刷機(jī)腳本Linux./flashall.sh或者更穩(wěn)妥地分步刷入fastboot flash boot boot.img fastboot flash system system.img fastboot flash vendor vendor.img fastboot flash userdata userdata.img fastboot flash vbmeta vbmeta.img --disable-verification # 開發(fā)階段禁用驗(yàn)證 fastboot reboot刷機(jī)完成后設(shè)備會(huì)自動(dòng)重啟。第一次啟動(dòng)首次刷機(jī)或清理數(shù)據(jù)后會(huì)較慢因?yàn)橄到y(tǒng)需要進(jìn)行初始化。整個(gè)過程走下來從環(huán)境搭建到鏡像燒錄雖然步驟繁多但每一步都有其明確的邏輯。關(guān)鍵在于保持耐心仔細(xì)閱讀每一步的輸出信息遇到錯(cuò)誤時(shí)善用搜索引擎和官方文檔盡管高通的公開文檔有時(shí)不盡如人意。最好的學(xué)習(xí)方式就是在成功編譯出基礎(chǔ)鏡像后嘗試做一些小的定制修改比如替換一個(gè)開機(jī)動(dòng)畫、預(yù)裝一個(gè)自己的應(yīng)用在實(shí)踐中去理解整個(gè)AOSP高通BSP的構(gòu)建體系是如何運(yùn)作的。這遠(yuǎn)比只看文檔要來得深刻。