香橙派Orange Pi 4開發板在Ubuntu系統下怎樣使用python控制GPIO

# 香橙派Orange Pi 4開發板在Ubuntu系統下怎樣使用Python控制GPIO

## 前言
Orange Pi 4作為一款高性能開源開發板，搭載瑞芯微RK3399六核處理器，廣泛應用于物聯網和嵌入式開發場景。本文將詳細介紹在Ubuntu系統下通過Python語言操作GPIO的方法，涵蓋環境配置、庫安裝和實際代碼示例。

---

## 一、準備工作
### 1. 硬件準備
- Orange Pi 4開發板
- 5V/3A電源適配器
- MicroSD卡（建議16GB以上）
- 杜邦線、LED、電阻等外圍元件

### 2. 軟件準備
- Ubuntu 20.04/22.04 LTS鏡像
- 燒錄工具（如BalenaEtcher）
- SSH客戶端（可選）

---

## 二、系統安裝與配置
### 1. 燒錄Ubuntu鏡像
1. 從官網下載適配的Ubuntu鏡像
2. 使用燒錄工具寫入MicroSD卡
3. 插入開發板并啟動

### 2. 基礎環境配置
```bash
# 更新軟件源
sudo apt update
sudo apt upgrade -y

# 安裝必要工具
sudo apt install -y python3-pip git build-essential

三、GPIO控制方案選擇

Orange Pi 4支持多種GPIO控制方式，推薦以下兩種方案：

方案1：使用WiringOP庫

# 克隆倉庫
git clone https://github.com/orangepi-xunlong/wiringOP.git
cd wiringOP

# 編譯安裝
sudo ./build clean
sudo ./build

方案2：使用GPIO Zero庫（推薦）

pip3 install gpiozero

四、Python控制GPIO實戰

1. 引腳編號說明

Orange Pi 4采用40Pin標準接口，支持兩種編號方式： - 物理引腳號：板載印刷的1-40編號 - BCM編號：Broadcom芯片定義的GPIO編號

2. 點亮LED示例

硬件連接：

• GPIO17（物理引腳11） → 220Ω電阻 → LED正極
• LED負極 → GND

代碼實現：

import time
from gpiozero import LED

led = LED(17)  # 使用BCM編號

while True:
    led.on()
    time.sleep(1)
    led.off()
    time.sleep(1)

3. 按鍵輸入檢測

硬件連接：

• GPIO27（物理引腳13） → 按鍵 → 3.3V
• 10KΩ下拉電阻 → GND

代碼實現：

from gpiozero import Button

button = Button(27)

def pressed():
    print("Button pressed!")

button.when_pressed = pressed

五、進階應用

1. PWM控制

from gpiozero import PWMLED
from time import sleep

led = PWMLED(17)

while True:
    for brightness in [0, 0.2, 0.4, 0.6, 0.8, 1]:
        led.value = brightness
        sleep(0.5)

2. 多線程控制

import threading
from gpiozero import LED

led1 = LED(17)
led2 = LED(27)

def blink(led, interval):
    while True:
        led.toggle()
        time.sleep(interval)

t1 = threading.Thread(target=blink, args=(led1, 0.5))
t2 = threading.Thread(target=blink, args=(led2, 1.0))
t1.start()
t2.start()

六、常見問題解決

1. GPIO權限問題：

   sudo usermod -aG gpio $USER
   sudo reboot
   

2. 引腳復用沖突：

   • 檢查/sys/kernel/debug/gpio確認引腳狀態
   • 使用gpioinfo工具查看

3. 庫導入錯誤：

   pip3 install --upgrade gpiozero
   

結語

通過本文介紹的方法，開發者可以快速實現Python對Orange Pi 4 GPIO的控制。建議結合官方文檔深入理解GPIO特性，并注意電氣安全規范。更多高級功能如I2C、SPI等協議控制可參考相關擴展庫實現。

附錄：
- Orange Pi 4官方Wiki
- GPIO Zero文檔 “`

文章特點： 1. 采用分層式結構，從基礎到進階 2. 包含實際可執行的代碼片段 3. 提供兩種主流控制方案 4. 加入故障排查章節 5. 使用標準的Markdown格式 6. 字數控制在約1050字范圍 7. 包含硬件連接示意圖（文字描述）