
本文详解如何在python中稳定、可靠地向com端口发送单字节数值(如数字21),重点解决因数据类型错误和超时设置不当导致的程序阻塞问题,并提供可立即运行的定时发送示例。
在Python中使用pyserial库向串口(如COM4)发送数据时,一个常见误区是直接传入整数(如ser.write(21))。实际上,serial.Serial.write()方法严格要求输入为bytes类型对象,而非int。若传入整数,会触发TypeError(在较新版本中)或引发未定义行为;而即使强制转换成功,若未配置写操作超时(write_timeout),当目标设备未就绪或响应异常时,write()仍可能无限阻塞——这正是原代码“卡住”的根本原因。
✅ 正确做法:字节化 + 写超时 + 定时循环
首先,将数字转换为单字节bytes对象:bytes([21])(注意方括号,表示含一个元素的列表);其次,显式设置write_timeout=0(非阻塞写)或一个合理正数值(如write_timeout=1),避免写操作挂起;最后,结合time.sleep()实现精确间隔发送。
以下是发送数字 21 到 COM4、每秒一次、持续5秒的完整可运行代码:
import serial
import time
# 配置串口:指定 write_timeout(非 timeout!)
ser = serial.Serial('COM4', 9600, write_timeout=0)
# 构造单字节数据:数字21对应的字节
data_byte = bytes([21])
try:
for i in range(5):
# 执行写入,返回实际发送的字节数(通常为1)
n = ser.write(data_byte)
print(f"第{i+1}次:成功发送 {n} 字节(值:{data_byte[0]})")
time.sleep(1)
finally:
ser.close() # 确保资源释放
print("发送完成")⚠️ 关键注意事项
- timeout ≠ write_timeout:timeout控制read()操作的等待时长,对write()无效;必须使用write_timeout参数。
- write_timeout=0 表示非阻塞模式:若底层无法立即写入(如缓冲区满、设备断开),write()将立即返回0并抛出serial.TimeoutException(需捕获处理);生产环境建议设为1等小正数以兼顾可靠性与响应性。
- 验证接收端:使用com0com创建的虚拟串口对(如COM3↔COM4)时,可在另一端用串口调试工具(如PuTTY、Arduino Serial Monitor)监听COM3,确认是否收到0x15(即十进制21)。
- 权限与端口占用:确保Python进程有串口访问权限,且COM4未被其他程序独占打开。
通过以上修正,即可实现稳定、可控的串口数字发送——不再卡死,精准定时,易于集成到自动化或嵌入式通信场景中。
立即学习“Python免费学习笔记(深入)”;










