树莓派串口通信：Python编程实现硬件互联互通实战81

好的，作为一位中文知识博主，我很乐意为您撰写这篇关于树莓派串口Python编程的知识文章。

亲爱的读者朋友们，大家好！我是你们的知识博主。今天，我们要一起探索树莓派（Raspberry Pi）一个既基础又强大的功能——串口通信。通过Python编程，我们可以让树莓派与各种外部硬件设备进行“对话”，无论是传感器、GPS模块，还是其他微控制器（如Arduino、ESP32），都能实现数据交换与智能控制。这正是开启物联网（IoT）和智能硬件项目大门的关键一步！

本文将以“树莓派串口python编程”为核心，详细介绍从硬件连接、系统配置到Python代码实现的全过程，并提供实用的代码示例和常见问题解决方案。无论你是初学者还是有一定基础的开发者，相信这篇文章都能为你带来清晰的指引。

一、串口通信是什么？为何在树莓派上如此重要？

串口通信，全称串行通信，是一种将数据逐位传输的通信方式。与并行通信相比，它只需要少数几根线（通常是TX、RX和GND），因此硬件连接更为简单，在长距离传输和降低成本方面具有优势。在嵌入式系统和物联网领域，串口通信无处不在。

对树莓派而言，其强大的计算能力与丰富GPIO（通用输入输出）引脚相结合，使其成为一个理想的嵌入式开发平台。串口功能作为GPIO引脚的一部分，使得树莓派能够方便地与各种支持串口通信的外部模块进行交互，极大地拓展了其应用场景，例如：
连接GPS模块获取定位信息。
与温湿度、PM2.5等传感器模块进行数据交互。
控制其他微控制器，实现更复杂的自动化系统。
通过蓝牙模块（如HC-05/06）进行无线通信。
调试其他设备，输出日志信息。

二、硬件准备与连接：让树莓派与外部设备“握手”

在开始编程之前，我们需要准备好以下硬件并进行正确的连接：
树莓派： 任何型号的树莓派都可以，本文以树莓派3B+或4B为例。
外部串口设备： 例如一个带有串口接口的Arduino开发板、GPS模块、USB转TTL模块等。
杜邦线（跳线）： 用于连接树莓派与外部设备。
电源： 为树莓派和外部设备供电。

核心连接原则：
TX (Transmit) 连接到 RX (Receive)： 树莓派的TX引脚（GPIO 14）需要连接到外部设备的RX引脚，反之亦然，树莓派的RX引脚（GPIO 15）连接到外部设备的TX引脚。记住这个“交叉连接”是关键！
GND (Ground) 连接到 GND： 树莓派的GND引脚需要连接到外部设备的GND引脚，确保共地，这是稳定通信的基础。
VCC (Power)： 外部设备通常需要单独供电，请根据设备要求连接其VCC到树莓派的3.3V或5V引脚，或者提供独立的外部电源。注意电压匹配，避免损坏设备！

树莓派GPIO引脚示意（常用串口引脚）：

物理引脚 | GPIO编号 | 功能

--------|----------|----------

8 | GPIO14 | TXD (发送)

10 | GPIO15 | RXD (接收)

6, 9, 14, 20, 25, 30, 34, 39 | GND | 地线

连接示例：

树莓派 GPIO14 (TX) -----> 外部设备 RX

树莓派 GPIO15 (RX) <----- 外部设备 TX

树莓派 GND -----> 外部设备 GND

三、系统配置：解锁树莓派的串口功能

默认情况下，树莓派的硬件串口（通常是`/dev/ttyS0`或`/dev/ttyAMA0`）可能被用于系统控制台输出或蓝牙功能。为了让我们的Python程序能够访问它，我们需要进行一些配置。

步骤：

打开树莓派配置工具：

sudo raspi-config

进入接口选项：

在配置界面中，选择 `3 Interface Options` (或 `5 Interfacing Options`)。

配置串口：

选择 `P6 Serial Port`。

系统会询问两个问题：

a. `Would you like a login shell to be accessible over serial?` (是否通过串口启用登录Shell？)

请选择 `No`。 这是因为如果启用，串口将被系统占用，我们的程序就无法使用了。

b. `Would you like the serial port hardware to be enabled?` (是否启用串口硬件？)

请选择 `Yes`。 这将启用树莓派的硬件串口功能。

完成并重启：

退出 `raspi-config`，系统会提示是否重启。请选择 `Yes` 进行重启，使配置生效。

（可选）检查串口设备名：

重启后，你可以通过以下命令查看串口设备是否存在：

ls -l /dev/ttyS*

或者

ls -l /dev/ttyAMA*

对于树莓派3B+及更新型号，默认的GPIO串口通常是`/dev/ttyS0`（mini UART）。对于旧型号或特殊配置，可能是`/dev/ttyAMA0`（PL011 UART）。在我们的Python程序中，需要指定正确的串口设备名。

（可选）添加用户到`dialout`组：

为了避免在运行Python脚本时出现权限问题（`Permission denied`），建议将当前用户（默认为`pi`）添加到`dialout`用户组：

sudo usermod -a -G dialout pi

添加后需要重启树莓派才能生效。

四、Python库安装：`pyserial`

在Python中进行串口通信，最常用和最强大的库就是 `pyserial`。它提供了跨平台的串口访问接口，使得我们可以在树莓派、PC等不同系统上用统一的方式编写串口程序。

安装 `pyserial`：

打开终端，执行以下命令安装：

pip install pyserial

如果你同时安装了Python2和Python3，请确保使用 `pip3` 安装到Python3环境中：

pip3 install pyserial

五、Python编程实践：核心代码解析与示例

现在，我们已经万事俱备，可以开始编写Python代码了！

1. 串口初始化与基本参数

```python
import serial
import time
# 定义串口参数
SERIAL_PORT = '/dev/ttyS0' # 树莓派GPIO串口设备名，根据你的型号和配置修改
BAUD_RATE = 9600 # 波特率，需与外部设备保持一致
TIMEOUT = 1 # 读取超时时间（秒），0表示非阻塞，None表示一直等待
try:
# 实例化一个串口对象
# 注意：这里的 parity, stopbits, bytesize 参数一般保持默认即可，
# 除非你的外部设备有特殊要求。
ser = (
port=SERIAL_PORT,
baudrate=BAUD_RATE,
timeout=TIMEOUT,
parity=serial.PARITY_NONE, # 校验位：无
stopbits=serial.STOPBITS_ONE, # 停止位：1位
bytesize= # 数据位：8位
)
print(f"串口 {SERIAL_PORT} 以 {BAUD_RATE} 波特率打开成功！")
# 检查串口是否已打开
if ():
print("串口已打开")
else:
print("串口打开失败")
# ... 后续进行发送和接收操作 ...
except as e:
print(f"串口打开失败: {e}")
except FileNotFoundError:
print(f"错误: 串口设备 {SERIAL_PORT} 未找到，请检查设备名或系统配置。")
except Exception as e:
print(f"发生未知错误: {e}")
finally:
# 在程序结束时确保关闭串口，释放资源
if 'ser' in locals() and ():
()
print("串口已关闭。")
```

参数说明：
`port`: 串口设备的文件路径，例如 `/dev/ttyS0`。
`baudrate`: 波特率，即每秒传输的位数，必须与外部设备保持一致。常见的有9600、19200、38400、115200等。
`timeout`: 读取操作的超时时间。如果设置为`None`，则会一直等待直到读取到数据；设置为`0`表示非阻塞，会立即返回；设置为正数，表示等待指定秒数。
`parity`: 校验位。`serial.PARITY_NONE`（无校验）、`serial.PARITY_EVEN`（偶校验）、`serial.PARITY_ODD`（奇校验）。
`stopbits`: 停止位。`serial.STOPBITS_ONE`（1位）、`serial.STOPBITS_ONE_FIVE`（1.5位）、`serial.STOPBITS_TWO`（2位）。
`bytesize`: 数据位。``、``、``、``。

2. 数据发送

通过 `()` 方法向串口发送数据。非常重要的一点是，发送的数据必须是字节串（bytes）类型，而不是普通字符串（string）类型。 你可以使用字符串的 `.encode()` 方法将其转换为字节串。

```python
# 发送数据示例
data_to_send = "Hello from Raspberry Pi!" # 注意：许多设备要求以换行符结束
(('utf-8')) # 将字符串编码为字节串发送
print(f"已发送: {()}")
```

3. 数据接收

`pyserial` 提供了多种接收数据的方法：
`(size)`: 读取指定字节数的数据。
`()`: 读取一行数据，直到遇到换行符``。返回字节串。
`ser.read_until(expected=LF, size=None)`: 读取直到遇到指定的字节序列，或达到指定字节数。
`ser.in_waiting`: 返回输入缓冲区的字节数，可以用来判断是否有数据可读。

接收到的数据同样是字节串，通常需要使用 `.decode()` 方法将其解码为可读的字符串。

```python
# 接收数据示例
# 方式一：读取指定字节数
# if ser.in_waiting > 0:
# received_data_bytes = (ser.in_waiting) # 读取所有可用的字节
# received_data_str = ('utf-8')
# print(f"收到 (指定字节数): {()}")
# 方式二：读取一行数据（直到遇到换行符）
if ser.in_waiting > 0:
received_data_bytes = ()
received_data_str = ('utf-8').strip() # 去掉首尾空白，特别是换行符
print(f"收到 (按行): {received_data_str}")
```

4. 综合示例：循环发送与接收

这是一个更完整的示例，演示了如何在一个循环中持续发送数据并尝试接收响应。

```python
import serial
import time
SERIAL_PORT = '/dev/ttyS0'
BAUD_RATE = 9600
TIMEOUT = 1 # 读取超时时间，单位秒
try:
ser = (
port=SERIAL_PORT,
baudrate=BAUD_RATE,
timeout=TIMEOUT
)
print(f"串口 {SERIAL_PORT} 以 {BAUD_RATE} 波特率打开成功！")
count = 0
while True:
# 1. 发送数据
message = f"Hello RPi World! Count: {count}"
(('utf-8'))
print(f"已发送: {()}")
# 2. 尝试接收响应
# 这里使用 readline()，假设对方会发送以换行符结束的数据
# 如果对方不发送换行符，可以使用 (num_bytes) 或 ser.read_until()
if ser.in_waiting > 0: # 检查是否有数据在缓冲区
received_bytes = ()
try:
received_str = ('utf-8').strip()
print(f"收到响应: {received_str}")
except UnicodeDecodeError:
print(f"收到非UTF-8编码数据: {received_bytes}")
else:
print("未收到响应或响应为空。")
count += 1
(2) # 每2秒发送一次
except as e:
print(f"串口通信错误: {e}")
except FileNotFoundError:
print(f"错误: 串口设备 {SERIAL_PORT} 未找到。")
except KeyboardInterrupt:
print("程序被用户中断。")
except Exception as e:
print(f"发生未知错误: {e}")
finally:
if 'ser' in locals() and ():
()
print("串口已关闭。")
```

六、常见问题与故障排除

串口通信过程中，你可能会遇到各种问题。以下是一些常见的故障及排查方法：

`Permission denied: '/dev/ttyS0'`：

原因：当前用户没有足够的权限访问串口设备。

解决：将用户添加到 `dialout` 用户组并重启。参考本文“系统配置”部分的第5点。

`FileNotFoundError: [Errno 2] No such file or directory: '/dev/ttyS0'`：

原因：串口设备路径错误，或者串口功能未在 `raspi-config` 中启用，或者系统重启后仍未生效。

解决：检查 `/dev/ttyS0` 或 `/dev/ttyAMA0` 是否存在，确保 `raspi-config` 配置正确并已重启。

无法收到数据/收到乱码：

原因：

波特率不匹配：这是最常见的问题。发送方和接收方的波特率必须完全一致。
TX/RX接反：再次检查物理连接，确保树莓派TX连接外部RX，树莓派RX连接外部TX。
共地问题：确保两设备GND已连接。
数据格式问题：发送的是字节串吗？接收后正确解码了吗？
外部设备未发送数据或发送格式不正确：检查外部设备的程序或配置。
超时设置：`timeout` 值可能太短，导致数据还没来得及完全接收就被截断或跳过。

解决：逐一排查以上可能性。尤其要仔细检查波特率和TX/RX连接。

树莓派上 `/dev/ttyS0` 被蓝牙占用：

原因：在某些树莓派型号上，GPIO串口可能会被默认分配给蓝牙模块。

解决：可以在 `/boot/` 中添加一行 `dtoverlay=miniuart-bt` 来强制将蓝牙分配到mini UART，将PL011 UART（`/dev/ttyAMA0`）释放给GPIO。或者，更简单的，如果你不需要蓝牙，在 `raspi-config` 中禁用蓝牙功能。

发送数据后无响应：

原因：

外部设备未接收到数据（上述问题）。
外部设备接收到数据但未处理或未发送响应。
外部设备处理了但响应发送格式不对。

解决：通过逻辑分析仪或USB转TTL模块连接到串口线路上，监听数据流，辅助调试。

七、总结与展望

通过本文的详细讲解，相信你已经掌握了在树莓派上使用Python进行串口通信的基本方法和技巧。从硬件连接、系统配置到Python代码的编写与调试，我们一步步解决了可能遇到的问题。

串口通信是嵌入式开发中极其重要的技能，它打开了树莓派与广阔硬件世界互联的大门。掌握了这一技能，你就可以自由地连接各种传感器、执行器，搭建自己的智能家居系统、数据采集站、机器人控制平台等等。

现在，是时候拿起你的树莓派和外设，动手实践了！祝你在探索和创造的道路上，玩得开心，收获满满！如果你有任何疑问或遇到其他问题，欢迎在评论区留言交流。我们下期再见！

2025-10-01

---

上一篇：Python编程工具怎么选？IDE、编辑器、Jupyter，一篇搞懂，效率翻倍！

下一篇：中小学生Python编程全攻略：零基础入门到创意实践，赋能AI时代未来人才