在嵌入式開發(fā)中，GPIO（通用輸入輸出口）是最基礎也最常用的硬件接口——小到控制一顆LED亮滅、讀取一個按鍵狀態(tài)，大到驅動傳感器、控制外設，都離不開GPIO。但對新手來說，“怎么確定GPIO的編號？”“怎么手動控制GPIO電平？”“為什么GPIO用不了？”這些問題常常讓人頭疼。

今天就從GPIO編號計算、用戶空間手動控制、占用沖突排查三個核心環(huán)節(jié)，手把手教新手搞定GPIO調試，全程結合Rockchip平臺實操案例（其他平臺邏輯通用），看完就能上手！

一、先搞懂：GPIO的“編號規(guī)則”是啥？

嵌入式芯片的GPIO通常按“Bank（組）→ Group（子組）→ Pin（引腳）”分層管理，比如常見的“GPIO1_D0”，每個部分都對應具體的數(shù)值，我們需要通過固定公式計算出內核識別的GPIO編號（比如56、125），才能后續(xù)操作。

先明確三個關鍵概念（以Rockchip芯片為例）：

?Bank（主組）：芯片會把GPIO分成多個Bank（如GPIO0、GPIO1、…、GPIO4），每個Bank包含32個引腳（固定），編號范圍[0,4]。

?Group（子組）：每個Bank又分成4個Group，對應字母A/B/C/D，分別對應編號0/1/2/3（比如A=0，B=1，C=2，D=3），每個Group包含8個引腳（固定）。

?X（子組內引腳號）：每個Group里的8個引腳，編號[0,7]（比如D0對應0，D1對應1，…，D7對應7）。

核心公式：計算GPIO編號

已知某個GPIO的“Bank+Group+X”，就能算出內核識別的唯一編號，公式分兩步：

1.計算Group內偏移量：number = Group × 8 + X（因每個Group有8個Pin）；

2.計算最終GPIO編號：pin = Bank × 32 + number（因每個Bank有32個Pin）。

實操案例：GPIO1_D0怎么算？

以開頭提到的“GPIO1_D0”為例，一步步拆解：

1.拆分參數(shù)：

?Bank = 1（GPIO1 →主組編號1）；

?Group = 3（D對應Group 3，A=0/B=1/C=2/D=3）；

?X = 0（D0 →子組內第0個Pin）。

1.計算Group內偏移量：number = 3 × 8 + 0 = 24；

2.計算最終GPIO編號：pin = 1 × 32 + 24 = 56。

??結論：GPIO1_D0對應的內核編號是56，后續(xù)操作都要用這個“56”來指定引腳。

新手注意：別踩這2個計算坑！

?坑1：Group對應錯誤（A=0不是1）！比如GPIO1_A1，Group是0不是1，否則會算錯編號；

?坑2：Bank編號從0開始！比如GPIO0_C3，Bank是0，不是1，每個Bank固定32個Pin，別多算或少算。

二、實操：用sysfs手動控制GPIO

Linux內核提供了sysfs文件系統(tǒng)接口，新手不需要寫驅動，直接通過echo/cat指令就能控制GPIO，步驟超簡單！核心路徑是/sys/class/gpio/，所有操作都圍繞這個目錄下的文件展開。

前提：確認sysfs GPIO已啟用

先檢查系統(tǒng)是否支持sysfs GPIO（大部分嵌入式Linux/Android系統(tǒng)默認開啟）：

#查看sysfs GPIO目錄是否存在 ls /sys/class/gpio/

若能看到export、unexport、gpiochip0等文件/目錄，說明支持；若沒有，需重新編譯內核，開啟CONFIG_GPIO_SYSFS選項。

步驟1：導出GPIO（告訴內核“我要操作這個Pin”）

“導出”是讓內核把指定編號的GPIO暴露到sysfs中，生成對應的控制目錄。比如要操作編號125的GPIO：

#導出GPIO125（echo編號> export） echo 125 > /sys/class/gpio/export

?成功：會在/sys/class/gpio/下生成gpio125目錄，里面包含direction（方向）、value（電平）等文件；

?失敗（報錯“Device or resource busy”）：說明這個GPIO已被其他驅動占用（后面會講怎么排查）。

步驟2：設置GPIO方向（輸入/輸出）

GPIO有兩種工作模式：輸入（in）和輸出（out），需先指定方向：

# 1.設置為輸出模式（echo out > gpioXXX/direction） echo out > /sys/class/gpio/gpio125/direction # 2.若需要設置為輸入模式（比如讀按鍵） # echo in > /sys/class/gpio/gpio125/direction

?驗證方向：cat /sys/class/gpio/gpio125/direction，會輸出out或in。

步驟3：控制GPIO電平（輸出模式）/讀取電平（輸入模式）

情況1：輸出模式（比如控制LED）

GPIO電平只有兩種：高電平（1）和低電平（0），通過value文件控制：

# 1.設置為高電平（echo 1 > value） echo 1 > /sys/class/gpio/gpio125/value # 2.設置為低電平（echo 0 > value） echo 0 > /sys/class/gpio/gpio125/value

?驗證電平：cat /sys/class/gpio/gpio125/value，會輸出1或0。

情況2：輸入模式（比如讀按鍵）

若GPIO接了按鍵（一端接GPIO，一端接地），設置為輸入后，直接讀value即可：

#讀取GPIO輸入電平（按下按鍵可能為0，松開為1，取決于硬件電路） cat /sys/class/gpio/gpio125/value

步驟4：釋放GPIO（不用時清理）

操作完成后，建議“釋放” GPIO，避免占用資源：

#釋放GPIO125（echo編號> unexport） echo 125 > /sys/class/gpio/unexport

釋放后，/sys/class/gpio/gpio125目錄會被刪除。

三、關鍵：查看GPIO占用與復用（排錯核心）

新手最常遇到的問題：“導出GPIO時提示忙（busy）”“設置電平沒反應”，本質是GPIO被占用——可能被其他驅動（如UART、SPI、I2C）復用，或已被其他進程導出。

下面兩個debug命令，能幫你快速定位問題！

1.用debug/gpio查看GPIO占用狀態(tài)

內核提供了/sys/kernel/debug/gpio文件，能直觀看到所有GPIO的“是否占用、方向、電平”：

#查看GPIO整體狀態(tài) cat /sys/kernel/debug/gpio

輸出解讀（重點看這幾列）：

GPIOs 32-63, platform/pinctrl, gpio1: gpio-56 ( |gpio1-d0 ) out hi # GPIO56（GPIO1_D0），輸出高電平，未被其他驅動占用 gpio-57 ( |spi1_cs0 ) out lo # GPIO57被SPI1_CS0驅動占用（復用為SPI片選） GPIOs 64-95, platform/pinctrl, gpio2: gpio-125 ( |export ) out hi # GPIO125已被export（我們手動導出的），輸出高電平

關鍵信息提取：

?若某GPIO后面跟著“|xxx”（如|spi1_cs0）：說明被xxx驅動復用，無法再作為普通GPIO使用；

?若某GPIO后面是“|export”：說明已被手動導出，需先unexport才能重新操作；

?out hi/out lo：輸出模式下的電平；in hi/in lo：輸入模式下的當前電平。

2.用pinmux-pins查看Pin腳復用詳情

如果想知道某個GPIO “還能復用成什么功能”，或“當前復用功能是誰”，需要看pinmux-pins文件（路徑因芯片不同略有差異，Rockchip平臺通常在/sys/kernel/debug/pinctrl/pinctrl-rockchip-pinctrl/下）：

#查看Pin腳復用情況（Rockchip平臺示例路徑） cat /sys/kernel/debug/pinctrl/pinctrl-rockchip-pinctrl/pinmux-pins

輸出解讀（重點看GPIO1_D0對應的Pin）：

Pin 56 (gpio1-d0): rockchip,pins@10000000 10000000.pinctrl:gpio1-d0 (GPIO function) Pin 57 (gpio1-d1): rockchip,pins@10000000 10000000.pinctrl:spi1-cs0 (SPI1_CS0 function)

關鍵信息提取：

?Pin 56：對應GPIO1_D0，當前復用為“GPIO function”（普通GPIO功能），可用；

?Pin 57：對應GPIO1_D1，當前復用為“SPI1_CS0 function”（SPI片選功能），不可作為普通GPIO；

?若想修改復用功能：需在設備樹（DTS）中修改對應Pin的pinmux配置，重新編譯設備樹。

四、新手常見問題&解決方案

問題現(xiàn)象	可能原因	解決方案
導出GPIO報錯“Device or resource busy”	1. GPIO已被其他驅動復用（如UART）；2. GPIO已被其他進程export	1.用debug/gpio看是否有“
設置電平后硬件沒反應	1. GPIO編號算錯；2.方向設置錯誤（輸入模式下無法改電平）；3.硬件電路問題（如LED正負極接反）	1.重新核對Bank/Group/X，計算編號；2.確認direction是out；3.用萬用表測GPIO引腳電平，排除硬件問題
輸入模式下讀不到正確電平	1.方向沒設為in；2.硬件沒上拉/下拉電阻（按鍵懸空時電平不穩(wěn)定）	1.重新設置direction為in；2.在設備樹中開啟GPIO的上拉/下拉（如bias-pull-up）
找不到/sys/kernel/debug/gpio	內核沒開啟CONFIG_DEBUG_FS選項	重新編譯內核，開啟CONFIG_DEBUG_FS，并掛載debugfs：mount -t debugfs debugfs /sys/kernel/debug

五、實戰(zhàn)案例：用GPIO控制一顆LED

光說不練假把式，我們以“控制GPIO1_D0（編號56）接的LED亮滅”為例，走一遍完整流程：

1.硬件連接

?LED正極→串聯(lián)1kΩ電阻→ GPIO1_D0（Pin56）；

?LED負極→接地（GND）。

2.軟件操作（Linux系統(tǒng)）

# 1.計算GPIO編號：GPIO1_D0 → 56（前面已算過） # 2.導出GPIO56 echo 56 > /sys/class/gpio/export # 3.設置為輸出模式 echo out > /sys/class/gpio/gpio56/direction # 4.點亮LED（高電平，因LED正極接GPIO） echo 1 > /sys/class/gpio/gpio56/value # 5. 5秒后熄滅LED sleep 5 echo 0 > /sys/class/gpio/gpio56/value # 6.釋放GPIO56 echo 56 > /sys/class/gpio/unexport

??效果：執(zhí)行指令后，LED先亮5秒，然后熄滅，完美！

六、總結：GPIO調試核心流程

新手調試GPIO，記住“先算編號→再查占用→后操作”的三步法：

1.算編號：根據“GPIOx_YY”拆分Bank/Group/X，用公式pin=Bank×32 + Group×8 + X計算；

2.查占用：用cat /sys/kernel/debug/gpio看是否被占用，用pinmux-pins看復用功能；

3.操作：sysfs三步曲（export→設direction→控value），不用時unexport。

GPIO是嵌入式開發(fā)的“敲門磚”，只要掌握今天的方法，無論是控制LED、讀按鍵，還是后續(xù)調試傳感器，都能舉一反三。如果在實操中遇到問題，歡迎在評論區(qū)留言，一起交流解決！