做Android底層開發的同學，肯定繞不開“燈光控制”——手機屏幕背光、按鍵燈、呼吸燈，這些功能的底層實現都依賴Light HAL。今天就以Rockchip（瑞芯微）Android 15平臺為例，用最通俗的語言拆解Light HAL的核心邏輯，新手也能看懂！

一、先搞懂：什么是Light HAL？

在開始看代碼前，先理清3個核心概念，避免越看越懵：

1. HAL是什么？

HAL（硬件抽象層）是Android系統“Framework層”和“硬件驅動”之間的橋梁。Framework層負責上層邏輯（比如APP調“調亮屏幕”），驅動負責直接操作硬件，HAL則把驅動接口封裝成標準形式，讓Framework不用關心不同廠商的硬件差異。

2. Light HAL的作用？

專門負責“燈光類硬件”的控制，比如：

?屏幕背光（BACKLIGHT）的亮度調節；

?按鍵燈（BUTTONS）的開關；

?通知燈（NOTIFICATIONS）的呼吸/常亮效果；

?電池燈（BATTERY）的顏色/閃爍控制。

3. AIDL版HAL？

Android 10+后，HAL逐漸從舊的HIDL遷移到AIDL（Android接口定義語言），核心是用Binder通信，讓HAL服務以“進程”形式運行，更穩定、權限控制更清晰。

二、核心代碼拆解：Rockchip Light HAL文件全解析

瑞芯微的Light HAL代碼都在light_aidl目錄下，核心文件就5個，我們逐個講清楚作用：

1.頭文件：Lights.h（定義“骨架”）

// 關鍵代碼片段classBacklightPath{public: intphysic_id;   // 顯示屏物理ID（多屏場景用） charbacklight_path[128];// 背光驅動的sysfs路徑};classLights:publicBnLights { // Framework調用的核心接口：設置燈光狀態（比如調亮度） ndk::ScopedAStatussetLightState(intid,constHwLightState& state)override; // Framework調用的核心接口：獲取設備支持的燈光類型 ndk::ScopedAStatusgetLights(std::vector* types)override;private: // 輔助函數：添加支持的燈光類型（比如“背光”“按鍵燈”） voidaddLight(intconstordinal, LightTypeconsttype); // 存儲支持的燈光列表  std::vector _lights; // 存儲多屏背光的路徑（瑞芯微多屏方案的核心）  std::vector _backlights;};

新手理解：這個文件就像“設計圖”，定義了兩個核心：

?BacklightPath：解決多屏設備的背光路徑問題（比如平板/工控機有多個屏幕）；

?Lights類：實現了Android標準的BnLights接口，對外暴露“設置燈光”和“獲取燈光”兩個核心方法，是整個HAL的骨架。

2.實現文件：Lights.cpp（填充“血肉”）

這是核心邏輯文件，所有燈光控制的實際操作都在這里，新手重點看3個核心函數：

（1）getDriverPath：定義燈光的驅動路徑

constchar*getDriverPath(LightType type){ switch(type) {   caseLightType:     return"/sys/class/backlight/backlight/brightness";// 背光驅動路徑   caseLightType:     return"/sys/class/leds/button-backlight/brightness";// 按鍵燈路徑   // 通知燈/電池燈等指向LED驅動目錄   caseLightType:   caseLightType:     return"/sys/class/leds";   default:     return"/not_supported";  }}

新手理解：Android控制硬件的核心是操作sysfs（虛擬文件系統），比如想調背光，本質就是往/sys/class/backlight/backlight/brightness文件里寫數字（0-255），這個函數就是給不同燈光“找對應的文件路徑”。

（2）write_int：往驅動文件寫值（操作硬件）

staticintwrite_int(constchar* path,intvalue){ intfd =open(path, O_RDWR);// 打開驅動文件 if(fd >=0) {   charbuf[20];   snprintf(buf,sizeof(buf),"%dn", value);// 把亮度值轉成字符串   write(fd, buf,strlen(buf));// 寫入文件（真正調亮度的操作）   close(fd);   return0;  }else{   ALOGE("打開文件失敗：%s",strerror(errno));   return-errno;  }}

新手理解：這是最底層的硬件操作函數，比如Framework要求“把背光調到100”，最終就是這個函數往背光路徑里寫“100”，驅動收到后就會調屏幕亮度。

（3）setLightState：處理Framework的調用請求

ndk::ScopedAStatusLights::setLightState(int id,constHwLightState& state) { // 1. 根據id找到對應的燈光類型（比如是背光還是按鍵燈） // 2. 找到該燈光的驅動路徑 // 3. 調用setLightFromType，最終調用write_int寫值到驅動 // 4. 返回操作結果（成功/失?。?/span>}

新手理解：Framework層調用Light HAL時，直接調用這個函數，它是“上層請求”和“底層操作”的中轉站。

3.入口文件：main.cpp（啟動HAL服務）

int main() { //1. 初始化Binder線程池（AIDL通信的基礎） ABinderProcess_setThreadPoolMaxThreadCount(0); //2. 創建Lights實例（真正處理燈光邏輯的對象）  std::shared_ptr<Lights> lights = ndk::SharedRefBase::make(); //3. 把HAL服務注冊到系統的ServiceManager（Framework能找到這個服務）  const std::string instance = std::string() +Lights::descriptor+"/default"; AServiceManager_addService(lights->asBinder().get(), instance.c_str()); //4. 進入線程池，等待Framework的調用（常駐進程） ABinderProcess_joinThreadPool(); returnEXIT_FAILURE;}

新手理解：這個文件是HAL服務的“啟動入口”，就像你開餐館，main.cpp就是“開門營業”的操作：

?初始化通信（Binder線程池）；

?準備好廚師（Lights實例）；

?告訴顧客（Framework）“我在這營業”（注冊服務）；

?坐等顧客下單（等待Framework調用）。

4.配置文件：lights-rockchip.xml（聲明HAL服務）

<manifestversion="1.0"type="device"> <halformat="aidl">   <name>android.hardware.lightname>   <version>2version>   <fqname>ILights/defaultfqname> hal>manifest>

新手理解：這個文件是“給系統看的說明書”，告訴Android系統：“我是Light HAL服務，版本是2，接口名是ILights/default”，系統會通過這個文件校驗HAL的兼容性，確保Framework能正確調用。

5.啟動配置：lights-rockchip.rc（系統啟動HAL）

service vendor.light-rockchip/vendor/bin/hw/android.hardware.lights-service.rockchip  class hal usersystem groupsystem  shutdown critical

新手理解：Android開機后，init進程會掃描這個文件，然后自動啟動Light HAL服務：

?class hal：屬于HAL類服務，系統啟動時會批量啟動；

?user system：以system用戶運行（保證能讀寫驅動文件）；

?shutdown critical：關鍵服務，崩潰會重啟，關機要等它退出。

Light HAL服務完整啟動流程圖

用流程圖直觀展示系統開機后，HAL服務如何啟動，一看就懂：

三、整體運行流程：從“調亮度”到“硬件響應”

新手最容易懵的是“代碼怎么串起來的”，用“調屏幕亮度”舉例子，先看流程圖，再看步驟：

對應流程圖，完整流程拆解（7步）：

1.系統開機：init進程掃描lights-rockchip.rc，啟動android.hardware.lights-service.rockchip可執行文件；

2.啟動HAL服務：執行main.cpp，創建Lights實例，注冊服務到ServiceManager，等待調用；

3.上層發起請求：比如設置里調亮度，Framework層找到“ILights/default”服務，調用setLightState；

4.HAL處理請求：setLightState根據燈光id找到背光驅動路徑；

5.底層操作：調用write_int往/sys/class/backlight/backlight/brightness寫亮度值；

6.驅動響應：內核驅動收到文件寫入操作，控制屏幕背光硬件調亮度；

7.返回結果：HAL把操作結果返回給Framework，整個流程結束。

四、避坑指南

1.路徑錯誤：驅動路徑寫錯（比如多屏場景背光路徑不對），會導致“調亮度沒反應”，重點查getDriverPath和display_settings.xml；

2.權限問題：HAL服務運行用戶不是system，會導致打不開驅動文件，查lights-rockchip.rc的user/group；

3.接口兼容：lights-rockchip.xml的版本和接口名不對，Framework找不到服務，重點核對name/version/fqname；

4.多屏場景：瑞芯微多屏設備要注意BacklightPath的物理ID，否則只會調其中一個屏幕。

五、總結

Rockchip Light HAL的核心邏輯其實很簡單：

?用Lights.h定義接口骨架；

?用Lights.cpp實現硬件操作邏輯；

?用main.cpp啟動并注冊HAL服務；

?用rc/xml配置服務啟動和系統識別；

?本質是“把Framework的請求轉成往sysfs文件寫值”。

對新手來說，先搞懂“sysfs操作硬件”這個核心，再順著“Framework→HAL→驅動”的鏈路看代碼，就不會亂。建議先改改背光路徑、調個亮度值，動手比只看代碼更易理解！