3、驱动库与初始化：Python库安装与模块初始化流程

好，咱们直接进入正题。这一节要聊的是控制模块的“开机第一件事”——驱动库安装和初始化流程。说白了，就是让树莓派或者你的主控板，知道怎么跟外挂的模块打招呼。

我个人习惯，拿到一个新模块，第一件事不是急着写业务逻辑，而是先把底层通信打通。你想想看，I2C地址对不对？SPI模式选没选对？GPIO引脚有没有冲突？这些基础问题不解决，后面写再多代码也是白搭。

3.1 三大Python库的安装与导入

在嵌入式Linux环境下，Python之所以好用，就是因为它有现成的库。咱们这节课主要用三个：RPi.GPIO、smbus 和 spidev。一个一个说。

3.1.1 RPi.GPIO —— 管脚控制的“老黄牛”

这个库是树莓派GPIO控制的事实标准。安装很简单：

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

或者用pip：

pip3 install RPi.GPIO

导入的时候，我建议你养成好习惯：

import RPi.GPIO as GPIO

嗯，这里要注意。不同版本的树莓派，引脚编号可能不一样。我个人习惯用BCM编号，也就是Broadcom芯片的原始编号。为什么？因为这样写出来的代码，换板子时改动最小。

3.1.2 smbus —— I2C通信的“翻译官”

I2C设备通信，靠的就是smbus库。安装命令：

sudo apt-get install python3-smbus

或者：

pip3 install smbus-cffi

导入时，我一般这样写：

import smbus
bus = smbus.SMBus(1)  # 树莓派3B+及以后版本，I2C总线编号为1

这里有个坑，我踩过。早期树莓派（比如Rev 1）的I2C总线编号是0，后来都改成1了。如果你用的是旧板子，记得改成 SMBus(0)。我曾经因为这个问题，排查了整整一个下午——明明设备地址是对的，就是读不到数据。

3.1.3 spidev —— SPI高速通信的“赛车手”

SPI比I2C快，适合传感器数据采集、显示屏刷新这类场景。安装：

sudo apt-get install python3-spidev

或者：

pip3 install spidev

导入示例：

import spidev
spi = spidev.SpiDev()
spi.open(0, 0)  # 总线0，片选0
spi.max_speed_hz = 1000000  # 1MHz

3.2 模块初始化流程

库装好了，接下来就是初始化。我总结了一个“三步走”流程，你可以直接套用：

1. 硬件使能 —— 打开对应的外设接口（I2C、SPI、GPIO）
2. 设备探测 —— 确认模块是否在线，地址是否正确
3. 参数配置 —— 写入寄存器，设置工作模式

举个例子，初始化一个I2C温度传感器（比如LM75）：

import smbus
import time

# 第一步：创建总线对象
bus = smbus.SMBus(1)

# 第二步：设备地址（LM75默认地址是0x48）
device_address = 0x48

# 第三步：探测设备是否存在
try:
    # 读取设备ID寄存器（如果有的话）
    data = bus.read_byte_data(device_address, 0x07)
    print(f"设备探测成功，ID寄存器值: {hex(data)}")
except OSError as e:
    print(f"设备未响应: {e}")
    exit(1)

# 第四步：配置工作模式（比如设置精度、转换速率）
bus.write_byte_data(device_address, 0x01, 0x60)  # 配置寄存器
print("模块初始化完成")

你看，逻辑很清晰。先确认设备在不在，再配置它。别一上来就读写数据，万一地址错了，程序直接崩。

3.3 设备地址与寄存器映射

这部分是重点，也是很多新手容易懵的地方。我尽量讲得直白些。

设备地址，就是模块在总线上的“门牌号”。I2C总线上可以挂多个设备，每个设备有唯一的7位或10位地址。比如常见的OLED显示屏地址是0x3C，温湿度传感器SHT30是0x44。

寄存器映射，就是模块内部的功能分区。每个寄存器有固定的地址，你往里面写数据，就是告诉模块“你要干什么”。

我画了一张图，帮你理解这个关系：

这张图想表达什么？主控通过I2C总线，根据设备地址找到对应的模块。然后，通过读写模块内部的寄存器，来控制它的行为。说白了，寄存器就是模块的“控制面板”。

举个例子，假设你有一个电机驱动模块（比如DRV8833），它的寄存器映射可能是这样的：

你看，每个寄存器都有明确的用途。你往0x00写0x01，电机就正转；写0x02，就反转。往0x01写128，电机就以50%的占空比运行。

3.4 避坑指南

最后，分享几个我踩过的坑，你遇到了可以少走弯路：

• 地址冲突：I2C总线上两个设备地址一样，谁也通信不了。解决办法是检查模块的地址引脚（A0/A1/A2），通过硬件跳线改地址。
• 寄存器写保护：有些模块的寄存器需要先解锁才能写。比如先写一个特定值到0xAA寄存器，才能修改配置。数据手册里一般会写，别漏看。
• 初始化顺序：有些模块必须先复位再配置，否则配置不生效。我遇到过一块IMU（惯性测量单元），必须先写复位寄存器，等100ms，再写配置，顺序错了数据全是乱的。

好了，这一节的内容就到这。驱动库装好、初始化流程走通、寄存器映射搞清楚，你的模块就算“活”过来了。接下来，就可以开始真正的参数调优了。

可可精品资料库