树莓派SMBus实战：用Python精准操控EEPROM的硬核指南

当你的树莓派需要记住一些重要数据——比如传感器校准参数、设备配置信息或者简单的键值对——AT24C系列EEPROM芯片是个可靠的选择。但要让这块小芯片乖乖听话，你得先搞定SMBus协议那些"严苛"的规矩。本文将带你用Python的smbus2库，从硬件连线的物理层一路杀到数据校验的应用层，完整实现EEPROM的读写控制。

1. 硬件准备：当树莓派遇见AT24Cxx

AT24C32是常见的I2C接口EEPROM芯片，32Kbit容量（相当于4KB），足够存储大量配置数据。硬件连接简单到令人发指：

• 树莓派引脚：
  • 3.3V → EEPROM VCC
  • GND → EEPROM GND
  • GPIO2 (SDA) → EEPROM SDA
  • GPIO3 (SCL) → EEPROM SCL

注意：树莓派的I2C引脚需要上拉电阻，但大多数EEPROM模块已经内置了4.7kΩ电阻，直接连接即可。

在通电前，务必确认EEPROM的地址引脚(A0-A2)连接方式。以AT24C32为例，其7位I2C地址格式为0b1010(A2)(A1)(A0)。如果所有地址引脚接地，设备地址就是0x50（左移一位后为0xA0）。

python复制# 地址验证代码片段
def check_eeprom_address(bus):
    for addr in range(0x50, 0x58):  # AT24Cxx可能的地址范围
        try:
            bus.write_quick(addr)
            return addr
        except IOError:
            continue
    raise ValueError("未检测到EEPROM设备")

2. 软件环境配置：从内核到Python层

树莓派默认禁用I2C接口，需要手动开启：

bash复制# 终端操作
sudo raspi-config
# 选择 Interfacing Options → I2C → Enable

接着安装必要的Python库：

bash复制pip install smbus2 RPi.GPIO

为什么选择smbus2而不是smbus？ 老旧的smbus库存在诸多限制：

• 仅支持7位地址
• 缺乏PEC校验功能
• 错误处理机制不完善

smbus2则完整实现了SMBus 3.0规范，特别适合对可靠性要求高的场景。其核心API分为三类：

1. 基础操作：write_quick, read_byte, write_byte
2. 复合操作：read_word_data, write_word_data
3. 块传输：read_block_data, write_block_data

3. SMBus协议的精髓：比I2C更严格的游戏规则

虽然SMBus基于I2C，但它制定了更严苛的规范：

在EEPROM操作中，这些差异会带来实际影响。例如，当我们需要写入一个16位数据时：

python复制def write_word_safe(bus, addr, reg, value):
    """符合SMBus规范的16位数据写入"""
    try:
        # 先写高字节，再写低字节（大端序）
        bus.write_word_data(addr, reg, ((value & 0xFF) << 8) | (value >> 8))
        # SMBus要求10ms内完成写入
        time.sleep(0.01)  
    except IOError as e:
        if e.errno == 121:  # Remote I/O error
            print("写入失败：设备未响应")
        elif e.errno == 5:   # Input/output error
            print("写入失败：总线冲突")

关键提示：AT24C系列有5ms的写周期等待时间，连续写入时必须遵守，否则会导致数据损坏。

4. 实战EEPROM操作：从字节到页面的读写艺术

4.1 单字节操作

最基本的读写单元，适合存储开关状态或模式标志：

python复制def byte_ops_demo(bus, addr):
    # 写入魔术字
    bus.write_byte_data(addr, 0x00, 0xAA)
    # 读取验证
    magic = bus.read_byte_data(addr, 0x00)
    print(f"读取到的魔术字: {hex(magic)}")

4.2 多字节页写入

AT24C32的页大小为32字节，高效写入的秘诀在于：

1. 确保不跨页边界
2. 使用块写入减少I2C事务

python复制def page_write(bus, addr, start_reg, data):
    if len(data) > 32:
        raise ValueError("单次写入不能超过32字节")
    if (start_reg % 32) + len(data) > 32:
        raise ValueError("不能跨页写入")
    
    # SMBus块写入格式：长度字节+数据
    bus.write_i2c_block_data(addr, start_reg, data)
    time.sleep(0.01)  # 等待写入完成

4.3 带PEC校验的安全传输

在电磁环境复杂的场景中，启用数据包错误检查：

python复制from smbus2 import SMBus, i2c_msg

def read_with_pec(bus, addr, reg, length):
    """带CRC校验的读取"""
    msg = i2c_msg.read(addr, length+1)  # 额外1字节用于PEC
    bus.i2c_rdwr(msg)
    data = list(msg)
    pec = data.pop()
    # 这里应添加CRC验证逻辑
    return bytes(data)

5. 高级技巧：EEPROM变成持久化字典

结合Python的魔法方法，我们可以把EEPROM包装成类字典对象：

python复制class EEPROMDict:
    def __init__(self, bus, addr=0x50, page_size=32):
        self.bus = bus
        self.addr = addr
        self.page_size = page_size
    
    def __setitem__(self, key, value):
        if not isinstance(key, int) or not 0 <= key < 4096:
            raise KeyError("地址必须在0-4095范围内")
        if isinstance(value, int):
            self.bus.write_byte_data(self.addr, key, value)
        elif isinstance(value, bytes):
            self._write_block(key, value)
    
    def __getitem__(self, key):
        if isinstance(key, slice):
            return self._read_block(key.start, key.stop-key.start)
        return self.bus.read_byte_data(self.addr, key)
    
    def _write_block(self, addr, data):
        for i in range(0, len(data), self.page_size):
            chunk = data[i:i+self.page_size]
            self.bus.write_i2c_block_data(
                self.addr, 
                addr + i, 
                list(chunk)
            )
            time.sleep(0.01)

使用示例：

python复制eeprom = EEPROMDict(SMBus(1))
eeprom[0x100] = b"Hello, EEPROM!"  # 写入字符串
print(eeprom[0x100:0x10F])  # 读取15字节

6. 避坑指南：那些年我踩过的SMBus坑

时钟拉伸问题：某些EEPROM在写入期间会拉低SCL线（时钟拉伸），而树莓派的硬件I2C对此支持有限。解决方法：

• 降低时钟频率到10kHz
• 使用软件I2C（bit-banging）

python复制# 设置低速模式
bus = SMBus(1)  # I2C1
bus.frequency = 10000  # 10kHz

地址冲突排查：当多个I2C设备共存时，地址冲突会导致诡异问题。用这个命令扫描总线：

bash复制i2cdetect -y 1

电源干扰处理：如果发现数据随机错误，尝试：

1. 在VCC和GND之间添加0.1μF去耦电容
2. 缩短连接线长度
3. 使用屏蔽双绞线

在完成所有实验后，建议用这个测试脚本验证EEPROM的完整性：

python复制def stress_test(eeprom, rounds=100):
    pattern = os.urandom(32)  # 随机测试数据
    for i in range(rounds):
        addr = random.randint(0, 4000)
        eeprom[addr:addr+32] = pattern
        read_back = eeprom[addr:addr+32]
        assert read_back == pattern, f"验证失败 @ {addr}"
    print(f"通过{rounds}轮压力测试")