【产出】 > 在树莓派上开启 I2C、SPI 和硬件串口,用
i2cdetect找到传感器地址,分清"串口控制台"和"串口硬件"两个开关,并知道树莓派 5 的串口和老型号有什么不同。
【版本】 > 按树莓派官方 Configuration 文档和硬件文档编写,适用于 Raspberry Pi OS Bookworm 及以后版本;树莓派 5 的串口差异单独说明。
一、用 raspi-config 开启接口
sudo raspi-config
| 接口 | 菜单路径 |
|---|---|
| I2C | 3 Interface Options → I5 I2C |
| SPI | 3 Interface Options → I4 SPI |
| 串口 | 3 Interface Options → I6 Serial Port |
每一项选 Yes,再按 <OK>、<Finish>。官方说明:开启 I2C 或 SPI 后,系统会打开对应接口,并在开机时加载相应的内核模块。
有桌面的话,也可以在"树莓派配置"工具(新版叫 Control Centre)的 Interfaces 标签页里直接打开开关。
二、I2C:接线和查找设备地址
| 信号 | GPIO | 物理引脚 |
|---|---|---|
| SDA | GPIO2 | 3 |
| SCL | GPIO3 | 5 |
官方硬件文档说明:GPIO2 和 GPIO3 上焊有固定的 1.8 kΩ 上拉电阻,接到 3.3 V。所以大多数 I2C 模块直接接上就能用,不需要再加上拉电阻;模块自带上拉时,总上拉阻值会变小,一般也没有问题。
【注意】 > 树莓派 GPIO 是 3.3 V 电平,不耐受 5 V。模块要用 3.3 V 供电,或者通过电平转换接入。接 5 V 的 I2C 模块,可能把它板上的 5 V 上拉直接加到树莓派的 SDA / SCL 上,损坏芯片。
查找设备地址(i2c-tools 工具包,系统一般已预装,没有的话 sudo apt install i2c-tools):
i2cdetect -y 1
输出是一张地址表,有设备的位置会显示十六进制地址,例如常见的 BME280 温湿度传感器显示 76 或 77,SSD1306 OLED 屏显示 3c。全是 -- 说明没有检测到设备,先检查接线和供电。
三、SPI
开启后会出现 /dev/spidev0.0 和 /dev/spidev0.1,分别对应片选 CE0 和 CE1:
ls /dev/spidev*
SPI 常用于显示屏、ADC 模块、LoRa 模块等,接线时 MOSI、MISO、SCLK、CE 不要接错,具体引脚用 pinout 命令查看。
四、串口:两个开关不要搞混
进入 I6 Serial Port 后会依次问两个问题:
- "Would you like a login shell to be accessible over serial?" —— 是否通过串口提供登录控制台。
- "Would you like the serial port hardware to be enabled?" —— 是否开启串口硬件。第二个问题只在第一个回答 No 时才会出现。
要接 GPS 模块、单片机、传感器等外部串口设备时:第一个选 No,第二个选 Yes,然后重启。
如果第一个选了 Yes,系统会把串口当成登录终端,开机日志和登录提示会不断发给你的外设,同时占用这个串口,你自己的程序就读不到正常数据了。
五、树莓派 5 的串口不一样
| 树莓派 5 / 500 / CM5 | |
|---|---|
| 可用 UART | UART0–UART4,以及调试用的 UART10,全部是 PL011,默认都关闭 |
| mini UART | 没有 |
| 主串口 | UART10,在板上三针调试接口,设备节点 /dev/ttyAMA10,/dev/serial0 指向它 |
所以在树莓派 5 上,GPIO14 / GPIO15 默认不是主串口。要在 40 针排针上用串口,需要在 /boot/firmware/config.txt 里打开额外的 UART,例如:
dtoverlay=uart0-pi5
重启后生效。每个 overlay 的可选参数可以用 dtoverlay -h uart0-pi5 查看。
【注意】 > 所有 UART 都是 3.3 V 电平,接 5 V 设备(例如部分 USB 转 TTL 模块的 5 V 档、老式单片机)可能损坏树莓派。USB 转 TTL 模块要拨到 3.3 V 档。
六、Python 读写示例
I2C(smbus2 库,pip install smbus2):
from smbus2 import SMBus
with SMBus(1) as bus: # 1 对应 /dev/i2c-1
chip_id = bus.read_byte_data(0x76, 0xD0)
print(hex(chip_id)) # BME280 应返回 0x60
串口(pyserial 库,pip install pyserial):
import serial
with serial.Serial('/dev/serial0', 9600, timeout=1) as ser:
print(ser.readline())
【提示】 > 用
pip装库之前先建好 Python 虚拟环境。新版 Raspberry Pi OS 不允许直接往系统 Python 里装包,会报externally-managed-environment错误。
参考资料
- 树莓派官方配置文档(raspi-config、UART):https://www.raspberrypi.com/documentation/computers/configuration.html
- 树莓派官方硬件文档(GPIO 电气参数、I2C 上拉):https://www.raspberrypi.com/documentation/computers/raspberry-pi.html
评价 (0)