Python与硬件交互入门：从串口通信到传感器数据读取的实战指南
你好，我是源码库的一名技术博主。今天，我想和你聊聊一个让Python从“虚拟世界”走向“物理世界”的有趣话题——硬件交互。你是否曾想过，用几行Python代码就能读取温湿度传感器的数据，或者控制一个舵机转动？这一切的核心，往往始于一个古老而强大的接口：串口。在物联网、机器人和自动化测试领域，串口通信是最基础、最直接的通信方式之一。本教程将手把手带你入门，解决串口通信的常见坑点，并完成一个真实的传感器数据读取项目。内容基于我的多次实战经验，希望能帮你少走弯路。
一、 准备工作：环境与硬件
在开始写代码之前，我们需要准备好“战场”。硬件方面，你需要一块支持串口（UART）的硬件，比如 Arduino、ESP32、或者一个USB转TTL模块。为了演示，我使用了一个常见的“USB转TTL模块”连接一个“DHT11”温湿度传感器。软件方面，你需要安装Python和一个关键库：pyserial。
踩坑提示：确保你的Python环境是3.x版本，2.x版本可能会遇到编码和库支持问题。
打开你的终端或命令提示符，安装必备库：
pip install pyserial
安装完成后，通过一个简单的命令检查串口：
python -m serial.tools.list_ports
这会列出你电脑上所有可用的串口，记下你的设备端口号，在Windows上通常是COM3、COM4等，在Linux/macOS上是/dev/ttyUSB0或/dev/ttyACM0。
二、 初探串口：建立连接与基础通信
现在，让我们打开Python，尝试与硬件建立第一次“对话”。首先导入serial模块，并创建一个串口对象。这里有几个关键参数：端口（port）、波特率（baudrate）、超时（timeout）。波特率必须与你的硬件设置完全一致，常见的有9600、115200等。
import serial
# 请将 'COM3' 替换为你的实际端口号
ser = serial.Serial(
port='COM3', # 端口
baudrate=9600, # 波特率
timeout=1 # 读超时时间（秒）
)
print(f"串口状态: {ser.is_open}")
print(f"串口信息: {ser}")
如果运行成功，没有抛出异常，恭喜你，连接建立了！实战经验：连接失败最常见的原因是端口被其他程序（如Arduino IDE的串口监视器）占用，或者波特率不匹配。务必先关闭其他可能占用端口的软件。
接下来，我们尝试发送和接收数据。假设你的硬件被编程为：收到字符串“READ”后，回复一行数据。
# 发送数据（需要编码为字节）
ser.write(b'READrn') # 注意：b表示字节，rn是常见的行结束符
# 读取一行数据（直到遇到换行符或超时）
received_data = ser.readline()
print(f"原始字节数据: {received_data}")
print(f"解码后字符串: {received_data.decode('utf-8').strip()}")
踩坑提示：串口通信的本质是字节流（bytes），不是字符串。发送时需要.encode()或直接使用b'...'；接收到的数据也是字节，需要.decode()才能变成可读字符串。编码错误（如‘utf-8’无法解码某些二进制数据）是常见问题，有时需要‘ignore’错误或使用‘latin-1’。
三、 实战项目：读取DHT11传感器数据
理论说得再多，不如动手做一遍。让我们完成一个真实项目：通过串口读取DHT11传感器的温湿度。这里有一个关键点：数据处理逻辑往往依赖于硬件端的程序协议。我假设你的硬件（如Arduino）已经烧录了程序，它会定时通过串口发送格式如“Temp:25.0C, Humi:50.0%”的数据。
我们的Python程序需要持续监听串口，解析出温度和湿度数值。
import serial
import time
import re # 使用正则表达式解析数据
ser = serial.Serial('COM3', 9600, timeout=2)
try:
while True:
if ser.in_waiting > 0: # 检查缓冲区是否有数据
# 读取一行
line_bytes = ser.readline()
try:
line = line_bytes.decode('utf-8').strip()
except UnicodeDecodeError:
print("解码错误，跳过此行")
continue
print(f"原始行: {line}")
# 使用正则表达式匹配数字（整数或小数）
# 寻找类似 “Temp:25.0” 和 “Humi:50.0” 的模式
match_temp = re.search(r"Temp:([d.]+)", line)
match_humi = re.search(r"Humi:([d.]+)", line)
if match_temp and match_humi:
temperature = float(match_temp.group(1))
humidity = float(match_humi.group(1))
print(f"解析成功 -> 温度: {temperature}°C, 湿度: {humidity}%")
else:
print("数据格式不符，解析失败")
time.sleep(0.1) # 短暂休眠，避免CPU占用过高
except KeyboardInterrupt:
print("n用户中断程序")
finally:
ser.close()
print("串口已关闭")
实战经验：
- 稳定性：实际通信中，数据可能不完整或包含乱码（电磁干扰）。因此，
try...except异常处理和数据有效性检查（如解析失败判断）至关重要。 - 协议设计：清晰的通信协议是成功的关键。最好和硬件端约定一个简单协议，比如以特定字符（如‘#’）开始、以换行符结束，方便解析。
- 缓冲区：使用
ser.in_waiting可以避免阻塞，实现非阻塞读取，这在需要同时处理其他任务的程序中非常有用。
四、 进阶技巧与常见问题排查
当你掌握了基础，可能会遇到更复杂的需求。这里分享几个进阶技巧：
1. 处理二进制数据：有些传感器直接输出二进制数据包，而非文本。这时需要按照协议手册，使用struct模块进行解包。
import struct
# 假设协议为：2字节温度（整数，单位0.1°C）+ 2字节湿度（整数，单位0.1%）
data_packet = ser.read(4) # 精确读取4个字节
if len(data_packet) == 4:
temp_raw, humi_raw = struct.unpack('>HH', data_packet) # 大端序，两个无符号短整型
temperature = temp_raw / 10.0
humidity = humi_raw / 10.0
print(f"温度: {temperature}°C, 湿度: {humidity}%")
2. 超时与重试机制：在网络不稳定或硬件响应慢时，加入重试逻辑。
max_retries = 3
for attempt in range(max_retries):
ser.write(b'READrn')
response = ser.readline()
if response:
break
else:
print(f"第{attempt+1}次尝试超时")
else:
print("错误：达到最大重试次数，通信失败")
常见问题排查清单：
- 收不到数据：检查线是否接好（RX接TX，TX接RX，GND接GND）；确认硬件是否上电；确认硬件程序是否正确运行；用串口调试助手（如Putty、Arduino IDE串口监视器）先测试硬件本身是否正常输出。
- 收到乱码：99%的原因是波特率不匹配！请确保Python程序和硬件程序的波特率设置一字不差。其次是数据位、停止位、校验位（默认为8N1，即8数据位、无校验、1停止位）是否一致。
- 权限问题（Linux/macOS）：你可能需要将用户加入
dialout组，或使用sudo运行程序。
五、 总结与展望
通过这篇教程，我们走完了Python串口通信的完整流程：从环境搭建、建立连接、收发数据，到完成一个真实的传感器数据读取项目，并探讨了进阶技巧和排错方法。串口是硬件交互的一扇大门，推开它，你将能连接更广阔的世界——控制电机、读取各种传感器、与嵌入式设备对话。
我的建议是，立即动手。找一个最简单的硬件（比如一个USB转TTL模块，短接其TX和RX引脚可以自发自收进行测试），把上面的代码敲一遍，体验数据流动的乐趣。遇到问题，耐心查看错误信息，利用搜索引擎和社区（如Stack Overflow）。硬件编程的魅力就在于这种与物理世界互动的真实感。希望这篇指南能成为你探索之旅的一块坚实垫脚石。祝你玩得开心！
评论(0)