树莓派5全方位实战教程：从GPIO编程到家庭NAS服务器

树莓派5（Raspberry Pi 5）于2023年9月正式发布，作为单板计算机领域的标杆产品，它带来了显著的性能提升和丰富的硬件特性。无论你是电子爱好者、嵌入式开发者，还是希望搭建家庭服务器的极客，树莓都是一个理想的入门平台。本将从硬件规格、开发环境搭建、GPIO编程、实际项目部署四个层面，带你全面掌握树莓派5的使用法。

一、树莓派5硬件规格解析

树莓派5搭载 Broadcom BCM2712 四核 ARM Cortex-A76 处理器，主频 2.4GHz，相比树莓派4提升约2-3倍。GPU 升级为 VideoCore VII，支持 OpenGL ES 3.1 和 Vulkan 1.2。内存可选 4GB 或 8GB LPDDR4X，满足不同场景需求。

接口是树莓派5最的亮点之一：新增 PCIe 2.0 x1 接口可外接 NVMe SSD 或网卡；双 USB 3.0 + 双 USB 2.0 提供丰富的外设扩展能力；双 4Kp60 HDMI 输出支持双屏显示；千兆以太网（带 PoE 支持）保障络传输；蓝牙 5.0 + Wi-Fi 6（双频 802.11ac）提供稳定的无线连接。此外，树莓派5首次引入专用电源管理芯片（RP1 I/O控制器），带来了更稳定的 5V/5A 供电和更丰富的GPIO引脚。

二、开发环境搭建

树莓派官方推荐使用 Raspberry Pi Imager 安装操作系统。它支持 Raspberry Pi OS（基于 Debian）、Ubuntu Server、LibreELEC 等多种发行版。首次启动建议通过 HDMI 连接显示器，并使用键盘鼠标完成初始配置。

对于无头（Headless）部署，可在系统镜像烧录后，在 boot 分区创建 wpa_supplicant.conf 和 ssh 文件以启用 Wi-Fi 和 SSH 远程访问：

# wpa_supplicant.conf
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=CN

network={
    ssid="你的WiFi名称"
    psk="你的WiFi password"
    key_mgmt=WPA-PSK
}

通过 SSH 连接后，推荐执行 sudo raspi-config 进行基础配置：扩展文件系统、启用 I2C/SPI/串口、设置 GPU 内存分配（64MB 对于无显示器环境足够了）。

三、GPIO 编程入门

树莓派40-pin GPIO 引脚是与外部世界交互的桥梁。树莓派5使用 RP1 芯片管理 GPIO，操作方式与旧版本兼容但性能更优。下面我们通过 Python 实现常见的 GPIO 操作。

1. 环境准备

Raspberry Pi OS 预装了 RPi.GPIO 和 gpiozero 两个常用库。如果缺失，可通过以下命令安装：

sudo apt update
sudo apt install python3-gpiozero python3-rpi.gpio

2. LED 闪烁示例

#!/usr/bin/env python3
"""LED 闪烁控制 - 使用 gpiozero"""
from gpiozero import LED
from signal import pause

led = LED(27)  # BCM 编号，对应 GPIO27

# 闪烁模式
led.blink(on_time=0.5, off_time=0.5)
print("LED 闪烁中... Ctrl+C 退出")
pause()

# 使用 RPi.GPIO 的方案：
# import RPi.GPIO as GPIO
# import time
# GPIO.setmode(GPIO.BCM)
# GPIO.setup(27, GPIO.OUT)
# try:
#     while True:
#         GPIO.output(27, GPIO.HIGH)
#         time.sleep(0.5)
#         GPIO.output(27, GPIO.LOW)
#         time.sleep(0.5)
# except KeyboardInterrupt:
#     GPIO.cleanup()

3. 按钮输入与中断

#!/usr/bin/env python3
"""按钮控制 LED - 带硬件中断"""
from gpiozero import LED, Button
from signal import pause

led = LED(27)
btn = Button(17, pull_up=True, bounce_time=0.1)

# 按下点亮，松开熄灭
btn.when_pressed = led.on
btn.when_released = led.off

print("按下按钮控制 LED，Ctrl+C 退出")
pause()

4.I2C 传感器读取（BMP280 温湿度传感器）

连接 BMP280 传感器到 I2C 总线（SDA=Pin3, SCL=Pin5），通过以下代码读取环境数据：

#!/usr/bin/env python3
"""BMP280 温湿度传感器读取"""
import smbus2
import time

bus = smbus2.SMBus(1)  # 树莓派5 使用 I2C bus 1
BMP280_ADDR = 0x76

def read_bmp280():
    # 读取校准参数（简化版）
    # 实际项目建议使用 Adafruit_BMP280 库
    data = bus.read_i2c_block_data(BMP280_ADDR, 0xF7, 6)
    # 计算压力和温度的原始值
    adc_p = (data[0] << 12) | (data[1] << 4) | (data[2] >> 4)
    adc_t = (data[3] << 12) | (data[4] << 4) | (data[5] >> 4)
    return adc_p, adc_t

while True:
    p, t = read_bmp280()
    print(f"Pressure raw: {p}, Temperature raw: {t}")
    time.sleep(2)

四、实际项目：家庭 NAS 服务器

利用树莓派5的 USB 3.0 和千兆以太网接口，可以搭建一个低功耗的家庭 NAS 服务器，实现文件共享、自动下载和媒体中心功能。

1. 系统准备

# 安装必要软件
sudo apt update
sudo apt install -y samba samba-common-bin minidlna transmission-daemon

# 连接并挂载 USB 硬盘
sudo fdisk -l  # 查看磁盘设备名
sudo mkdir /mnt/data
sudo mount /dev/sda1 /mnt/data

# 设置开机自动挂载
echo '/dev/sda1 /mnt/data ext4 defaults,noatime 0 0' | sudo tee -a /etc/fstab

2. Samba 共享配置

# 编辑 /etc/samba/smb.conf，末尾添加：[Shared]
# path = /mnt/data
# browseable = yes
# read only = no
# guest ok = yes
# create mask = 0664
# directory mask = 0775

sudo systemctl restart smbd

3. 自动下载机

使用 Transmission 作为 BT 下载引擎，通过 Web 界面远程管理。编辑 /etc/transmission-daemon/settings.json，修改下载目录指向 /mnt/data/downloads，然后通过 http://树莓派IP:9091 即可访问管理界面。

五、进阶技巧与最佳实践

散热管理：树莓派5在全负载运行时温度较高，建议安装官方主动散热器或第三方散热外壳。可通过 vcgencmd measure_temp 实时监测温度。当温度超过80°C时，系统会自动降频，影响性能。

使用 UPS 不间断电源：对于重要服务场景，可使用 Geekworm X728 等 UPS 扩展板实现断电检测和有序关机，避免文件系统损坏。

系统可靠性：建议将 SD 卡作为启动盘，数据存储于外接 USB SSD/HDD。树莓派5支持USB启动，甚至可以直接从 NVMe SSD（通过 HAT 扩展板）启动，大幅提升 IO 性能。

监控与运维：利用 htop、iotop、nethogs 等工具实时监控系统资源。可以安装 Grafana + Prometheus 搭建可视化监控面板。

六、总结

树莓派5凭借强大的硬件性能和丰富的接口选项，已经成为入门嵌入式开发和搭建家庭服务的首选平台。从简单的 LED 控制到复杂的媒体服务器，树莓派提供了无限的创造可能。随着社区生态的完善和硬件成本的持续下降，它将继续在教育、工业控制、智能家居等领域发挥关键作用。动手尝试吧，下一个属于你的智能项目就在此时启程！