正文

剛開始在配置reset-gpios = <&gpio2 RK_PB4 GPIO_ACTIVE_HIGH>時，我會疑惑：GPIO_ACTIVE_HIGH只是個“標記”嗎？能不能隨便寫成GPIO_ACTIVE_LOW，或者干脆不寫？

答案是：絕對不能隨便寫！它直接決定驅(qū)動對GPIO的控制邏輯，寫錯會導致設備功能異常。

GPIO_ACTIVE_HIGH不是“隨便的標記”

GPIO_ACTIVE_HIGH（或GPIO_ACTIVE_LOW）是Linux設備樹中定義的GPIO有效電平標識，本質(zhì)是告訴內(nèi)核和驅(qū)動：這個GPIO在什么電平狀態(tài)下代表“有效”（比如復位觸發(fā)、使能激活）。

• GPIO_ACTIVE_HIGH：高電平有效；
• GPIO_ACTIVE_LOW：低電平有效。

它不是“可有可無的參數(shù)”，而是DTS與驅(qū)動之間的**“約定規(guī)則”**——驅(qū)動會根據(jù)這個標識，決定如何控制GPIO電平，實現(xiàn)對應的硬件功能。

決定驅(qū)動的控制邏輯

驅(qū)動在獲取reset-gpios對應的GPIO后，會嚴格遵循GPIO_ACTIVE_HIGH/LOW的約定來操作GPIO，具體影響體現(xiàn)在3個方面：

1. 驅(qū)動對“有效狀態(tài)”的判斷邏輯

驅(qū)動中通常會用“邏輯值1代表有效，0代表無效”來編寫代碼，而GPIO_ACTIVE_HIGH/LOW會決定“邏輯值1”對應實際的高電平還是低電平。

大致過程是這樣的：GPIO_ACTIVE_HIGH/LOW會被內(nèi)核解析并存儲在gpio_desc中，驅(qū)動調(diào)用 gpiod_set_value() 時：若配置為GPIO_ACTIVE_HIGH，驅(qū)動傳入1則內(nèi)核設置 GPIO 為高電平，傳入0為低電平；若配置為GPIO_ACTIVE_LOW，驅(qū)動傳入1則內(nèi)核自動設置為低電平（有效電平），傳入0為高電平。驅(qū)動無需關心 “有效電平是高還是低”，只需按 “邏輯值”（1 = 有效，0 = 無效）調(diào)用接口，內(nèi)核會自動完成電平轉換。換言之，gpiod_set_value() 設置的是“邏輯值”而非“物理值”。

簡單說：驅(qū)動只關心“邏輯上是否有效”，而GPIO_ACTIVE_HIGH/LOW會把“邏輯有效”轉換成“實際電平”，驅(qū)動無需硬編碼電平高低，實現(xiàn)了“邏輯與硬件的解耦”。

2. 驅(qū)動對GPIO初始狀態(tài)的設置

驅(qū)動在申請GPIO時，會結合GPIO_ACTIVE_HIGH/LOW設置初始電平，避免設備上電后處于異常狀態(tài)：

比如某設備要求“復位引腳默認拉高（無效），需要復位時拉低（有效）”，若DTS配置reset-gpios = <&gpio2 RK_PB4 GPIO_ACTIVE_LOW>，驅(qū)動申請GPIO時會：

#GPIOD_OUT_HIGH → 初始輸出高電平（無效狀態(tài)），符合設備要求reset_gpio= devm_gpiod_get(dev,"reset", GPIOD_OUT_HIGH);

若誤將DTS寫成GPIO_ACTIVE_HIGH，驅(qū)動會初始輸出低電平（有效狀態(tài)），導致設備上電后一直處于復位狀態(tài)，無法正常啟動。

3. 驅(qū)動對中斷觸發(fā)方式的適配（若GPIO用作中斷）

如果GPIO不僅是復位控制，還兼作中斷引腳（比如設備復位完成后觸發(fā)中斷），GPIO_ACTIVE_HIGH/LOW會影響驅(qū)動對中斷觸發(fā)邊沿的配置：

• 若GPIO_ACTIVE_HIGH→ 驅(qū)動可能配置“上升沿觸發(fā)中斷”（有效電平到來時觸發(fā)）；
• 若GPIO_ACTIVE_LOW→ 驅(qū)動可能配置“下降沿觸發(fā)中斷”。

寫錯會導致中斷無法觸發(fā)，驅(qū)動收不到設備的狀態(tài)反饋。

寫錯有什么后果？

GPIO_ACTIVE_HIGH/LOW配置錯誤，不是“小問題”，而是會直接導致設備故障，常見后果有3種：

1. 設備無法正常復位/啟動

比如某設備的復位邏輯是“低電平復位，高電平工作”（即GPIO_ACTIVE_LOW），若DTS寫成GPIO_ACTIVE_HIGH：

• 驅(qū)動觸發(fā)復位時會輸出高電平 → 設備無法進入復位狀態(tài)；
• 驅(qū)動釋放復位時輸出低電平 → 設備一直被復位，無法啟動。

2. 設備功能異常

比如某傳感器的使能引腳是“高電平使能（GPIO_ACTIVE_HIGH）”，若DTS寫成GPIO_ACTIVE_LOW：

• 驅(qū)動想“使能傳感器”（邏輯值1）→ 實際輸出低電平 → 傳感器未被使能，無法采集數(shù)據(jù)；
• 驅(qū)動想“關閉傳感器”（邏輯值0）→ 實際輸出高電平 → 傳感器一直工作，耗電增加甚至數(shù)據(jù)錯亂。

3. 硬件損壞（極端情況）

部分設備對復位/使能電平的時序和極性要求嚴格，比如電源芯片的使能引腳若長期處于錯誤電平，可能導致芯片過流、燒毀；電機驅(qū)動的使能引腳錯誤，可能導致電機誤啟動，引發(fā)機械故障。

如何正確配置？

GPIO_ACTIVE_HIGH/LOW的配置不能憑“感覺”，必須嚴格匹配硬件手冊和設備邏輯，步驟如下：

1. 查硬件手冊：確認設備的有效電平

這是最核心的一步！打開設備的datasheet（比如傳感器、芯片的手冊），找到復位/使能引腳的描述：

• 比如手冊寫“Reset pin: Active Low” → 必須配置GPIO_ACTIVE_LOW；
• 若寫“Enable pin: High level enable” → 配置GPIO_ACTIVE_HIGH。

2. 確認GPIO與設備的電路連接

即使設備手冊要求“低電平復位”，若硬件電路中GPIO與設備復位引腳之間加了反向器（比如GPIO輸出高電平時，設備復位引腳實際是低電平），則需反向配置：

• 設備要求低電平復位 + 反向器 → DTS配置GPIO_ACTIVE_HIGH（GPIO拉高=設備復位）。

3. 驅(qū)動中驗證：通過接口讀取有效電平配置

驅(qū)動中可通過gpiod_is_active_low()接口，驗證DTS配置的有效電平是否正確：

if(gpiod_is_active_low(reset_gpio)) {  dev_info(dev,"Reset GPIO is active lown");}else{  dev_info(dev,"Reset GPIO is active highn");}

若打印信息與硬件邏輯不符，說明DTS配置錯誤，需修正。

總結

GPIO_ACTIVE_HIGH不是“隨便填的參數(shù)”，而是DTS、驅(qū)動、硬件三者之間的“電平約定”。

• 對DTS來說，它是硬件邏輯的“文字描述”；
• 對驅(qū)動來說，它是控制GPIO的“邏輯依據(jù)”；
• 對硬件來說，它是確保功能正常的“電平規(guī)則”。

（完）

本人專注 Linux 驅(qū)動 & Linux/Android BSP 開發(fā)調(diào)試，可接外包項目/技術支持/問題定位。有需求或交個朋友可加微信：【Chen_WeChat2025】。