了解如何在 OrangePi Zero 上使用 GPIO（通用输入输出）接口非常重要。以下是用中文整理的详细指南，包括概念、准备工作和操作步骤：

1. 什么是 GPIO？

GPIO（General Purpose Input/Output）是开发板上的可编程引脚，可用软件控制其作为输入（如读取按钮状态、传感器数据）或输出（如控制 LED、继电器）。
注意：OrangePi Zero 使用 3.3V 电平，直接连接 5V 设备可能损坏板子！

2. 准备工作

a) 硬件确认

• OrangePi Zero 板载一个 13x2 排针（26引脚），其中部分为可编程 GPIO。
• 参考官方引脚图（必须核对！）：
  OrangePi Zero 官方引脚图

b) 系统与软件

• 操作系统：推荐使用官方的 Armbian 或 Orange Pi OS。
• 库/工具：
  • 命令行工具：gpiod（gpioset, gpioget）
  • Python：gpiod 或 RPi.GPIO（需适配）
  • WiringOP：类似树莓派的库（需单独安装）。

3. 操作步骤（以 Armbian 为例）

a) 启用 GPIO 驱动

默认通常已启用，无需额外操作。如权限不足，将用户加入 gpio 组：

sudo usermod -aG gpio $(whoami)
# 退出重新登录生效

b) 识别 GPIO 编号

关键点：系统使用芯片内部的 GPIO 编号（如 GPIOA1），而非物理引脚号。
映射关系：

1. 查官方引脚图，确认物理引脚号（如 Pin7）。
2. 找到对应的 GPIO 组（如 PA07）。
3. 转换为 Linux GPIO 编号（需查表或计算）。

捷径：直接使用 gpioinfo 查看可用引脚：

sudo apt install gpiod
gpioinfo  # 列出所有 GPIO 及当前状态

c) 命令行控制（gpiod）

• 设置引脚为输出（控制 LED）：

  gpioset 0 16=1  # 将 GPIO16 (示例) 设为高电平
  gpioset 0 16=0  # 设为低电平

• 读取引脚输入（读取按钮）：

  gpioget 0 16   # 读取 GPIO16 的值

d) Python 控制（使用 gpiod 库）

安装库：

sudo apt install python3-libgpiod

示例代码：控制 LED 闪烁

import gpiod
import time

# 设置使用的 GPIO 编号（根据实际修改）
LED_PIN = 16

# 获取 GPIO 芯片
chip = gpiod.Chip('gpiochip0')

# 请求 LED 引脚为输出
led_line = chip.get_line(LED_PIN)
led_line.request(consumer="LED", type=gpiod.LINE_REQ_DIR_OUT)

try:
    while True:
        led_line.set_value(1)  # LED 亮
        time.sleep(1)
        led_line.set_value(0)  # LED 灭
        time.sleep(1)
except KeyboardInterrupt:
    led_line.set_value(0)  # 退出前关闭 LED
finally:
    led_line.release()  # 释放 GPIO

4. 常用 GPIO 功能

• 基础 I/O：如上所示。
• PWM（脉宽调制）：控制电机、调光 LED（需支持 PWM 的引脚）。
• I²C/SPI/UART：连接传感器/外设（需启用系统支持）。
• 中断检测：高效响应按键事件。

5. 注意事项

1. 避免短路：连接电路前务必断开电源。
2. 静电防护：接触板子前触摸接地金属。
3. 电压匹配：所有信号必须 ≤ 3.3V！使用电平转换器连接 5V 设备。
4. 驱动能力：单个 GPIO 驱动电流有限（通常 <10mA），驱动大功率设备需晶体管/MOSFET。
5. 复用功能：部分 GPIO 可能被系统占用（如 UART、LED），需在配置文件中禁用。

6. 扩展学习

• 官方文档：Orange Pi Zero Wiki
• WiringOP：适配 Orange Pi 的 GPIO 库（类似树莓派），参考 WiringOP GitHub
• 进阶：学习设备树（Device Tree）配置，自定义 GPIO 功能。

开始操作前务必确认您的 OrangePi Zero 的 GPIO 映射关系！ 不同硬件版本可能存在差异。如有问题，建议从控制一个简单的 LED 开始测试。