Raspberry Pi I2C Sensor Development — 树莓派 I2C 传感器开发

树莓派 I2C 传感器开发实战指南

一、GPIO 引脚速查表（多来源核对） Raspberry Pi 4B / Zero / Zero 2 W / 3B+ 均采用 40-pin GPIO Header，引脚布局完全兼容。 引脚编号规则：USB 口朝下时，Pin 1 在左上角（方焊盘），按书页顺序编号。 来源核对：Raspberry Pi 官方文档 raspberrypi.com、 pinout.xyz、Wevolver Pi 4 Pinout Guide、 Electronics for You GPIO 指南

1.1 通信接口引脚（I2C / SPI / UART） 协议 | 信号 | BCM | GPIO | 物理引脚 | 关键说明 ---|---|---|---|---|--- I2C-1 | SDA | GPIO2 | Pin 3 | 默认 I2C 总线；板载 1.8kΩ 固定上拉 到 3.3V I2C-1 | SCL | GPIO3 | Pin 5 | 同上；同时是唤醒引脚（拉低可唤醒关机状态的 Pi） SPI0 | MOSI | GPIO10 | Pin 19 | 主出从入 SPI0 | MISO | GPIO9 | Pin 21 | 主入从出 SPI0 | SCLK | GPIO11 | Pin 23 | 时钟 SPI0 | CE0 | GPIO8 | Pin 24 | 片选 0 SPI0 | CE1 | GPIO7 | Pin 26 | 片选 1 UART0 | TXD | GPIO14 | Pin 8 | 默认串口控制台；如需他用需先禁用 console UART0 | RXD | GPIO15 | Pin 10 | 默认串口控制台 I2C-0 | ID_SD | GPIO0 | Pin 27 | 保留给 HAT ID EEPROM，不要占用 I2C-0 | ID_SC | GPIO1 | Pin 28 | 保留给 HAT ID EEPROM，不要占用

1.2 电源与通用 GPIO 引脚 物理引脚 | 功能 | 物理引脚 | 功能 ---|---|---|--- 1 | 3.3V | 2 | 5V 4 | 5V | 6 | GND 7 | GPIO4 | 9 | GND 11 | GPIO17 | 12 | GPIO18 (PWM0) 13 | GPIO27 | 14 | GND 15 | GPIO22 | 16 | GPIO23 17 | 3.3V | 18 | GPIO24 20 | GND | 22 | GPIO25 25 | GND | 26 | GPIO7 (CE1) 29 | GPIO5 | 30 | GND 31 | GPIO6 | 32 | GPIO12 (PWM0) 33 | GPIO13 (PWM1) | 34 | GND 35 | GPIO19 (PCM_FS / SPI1) | 36 | GPIO16 (SPI1 CE2) 37 | GPIO26 | 38 | GPIO20 (PCM_DIN / SPI1) 39 | GND | 40 | GPIO21 (PCM_DOUT / SPI1)

1.3 电气特性（必须遵守） 3.3V 逻辑电平：所有 GPIO 通信引脚（SDA/SCL/MOSI/MISO/TX/RX）均为 3.3V，不兼容 5V。直接接 5V 会烧毁 GPIO。 GPIO2/GPIO3 固定上拉：这两个引脚有 ~1.8kΩ 板载上拉电阻 到 3.3V，因此： 不能配置为下拉或浮空输入 非常适合 I2C（I2C 规范要求 SDA/SCL 上拉） 如果当普通 GPIO 用，默认就是高电平 3.3V 电源限制：总输出电流约 800mA，5V 引脚直通 USB 供电。 Zero 系列：Zero / Zero W / Zero 2 W 出厂 不焊排针，需自行焊接或使用带排针版本（WH）。

二、I2C 总线选型：标准 I2C vs 软件 I2C 2.1 标准 I2C（/dev/i2c-1） 使用硬件 I2C 控制器，驱动由 Linux 内核管理。 启用：sudo raspi-config -> Interface Options -> I2C -> Enable 或修改 /boot/config.txt 添加：dtparam=i2c_arm=on 优点：稳定可靠，400kHz 标准速率 缺点：只能使用固定的 GPIO2/GPIO3（pin3/5） 内核管理时钟拉伸、仲裁 无法启用内部上拉（树莓派已带物理上拉，通常够用） Python smbus2 / C ioctl 直接可用 如需其他 GPIO 做 I2C，必须用软件方案 性能瓶颈在 Linux I2C 子系统（~1.3ms/事务） 不是 C 语言 vs Python 的差距

2.2 软件 I2C（Bit-Banging） 通过 GPIO 手动翻转电平模拟 I2C 时序，可使用任意 GPIO。 适用场景： 标准 I2C-1 已被其他设备占用 传感器需要接到非标准引脚（如 GPIO8/9） 需要与 SPI 引脚复用（GPIO8/9 同时也是 SPI0 CE0/MISO） 两种实现方式： 方式 | 实现 | 内部上拉支持 | 性能 | 推荐度 ---|---|---|---|--- 内核 | i2c-gpio overlay | 不支持（重大陷阱） | 一般 | 不推荐 用户态 | gpiod 库 | 支持 | ~50kHz (10us 延时) | 推荐

2.3 性能对比（实测数据） 以 BMI270 读取 12 字节（accel + gyro）为例： 方案 | 单次读取耗时 | 理论最高频率 | 备注 ---|---|---|--- Python + smbus2 (标准 I2C) | ~2-3ms | ~400Hz | 内核 I2C 开销 C + ioctl (标准 I2C) | ~1.3ms | ~700Hz | 与 Python 同数量级 Python + gpiod bit-banging | ~3-4ms | ~250Hz | 10us/bit 延时 C + gpiod bit-banging | ~3-4ms | ~250Hz | 10us/bit 延时 关键结论： C 并不比 Python 快多少，瓶颈在 Linux I2C 内核层（系统调用 + 调度） Bit-banging 的瓶颈是 GPIO 翻转延时（微秒级 sleep），C 和 Python 性能接近 要达到 200Hz 连续采集，必须用标准 I2C（/dev/i2c-1）+ 块读取，且 BMI270 必须接在 pin3/5

三、gpiod 库使用指南 3.1 安装 Python：pip3 install gpiod C：sudo apt install libgpiod-dev

3.2 Python：SMBus 兼容层 用 gpiod 实现一个与 smbus2.SMBus 接口兼容的类，可 monkey-patch 替换原驱动中的 SMBus： ```python import gpiod from gpiod.line import Direction, Value, Bias

class SMBus: """gpiod-based bit-banging I2C compatible with smbus2.SMBus""" def __init__(self, bus=None): self.chip = gpiod.Chip('/dev/gpiochip0') self.scl_pin = 9 # GPIO9 (物理 pin21) self.sda_pin = 8 # GPIO8 (物理 pin24) self.addr = 0

def _delay(self): import time time.sleep(0.00001) # 10us = ~50kHz

def _start(self): # SCL=1 时 SDA 从高变低 ... pass

def _stop(self): # SCL=1 时 SDA 从低变高 ... pass

def write_byte_data(self, addr, reg, value): self.addr = addr self._start() self._write_raw(addr << 1) # ADDR + W self._write_raw(reg) self._write_raw(value) self._stop()

def read_i2c_block_data(self, addr, reg, length): self.addr = addr self._start() self._write_raw(addr << 1) # ADDR + W self._write_raw(reg) self._start() # Repeated START self._write_raw((addr << 1) | 1) # ADDR + R data = [self._read_raw(ack=1) for _ in range(length-1)] data.append(self._read_raw(ack=0)) # 最后字节发 NACK self._stop() return data

def write_i2c_block_data(self,