Python 官方文档:入门教程 => 点击学习
目录 前言安装pyserialpyserial大致概括整体流程硬件连接例子(简单版) 详细使用serial初始化参数发包收包收包 检查包并解包python struct模块结语
这几年,自己也做了一些嵌入式机器人。在整个开发的过程中,调通信通常会花费一段比较长的时间,串口通信就是这样的一个部分。
而现在在百度上进行搜索,发现对python串口通信的博客讲解,都有点太笼统了,这其中,应该与Python在处理硬件底层速度较慢导致用的人少有关系。
这里把python串口通信的部分进行一下个人使用过程中的总结。既是自我总结,也让未来开发更快。
python进行串口通信,依赖的包就是pyserial
,因此,本文是基于这个包进行总结。
总结过程中难免有理解不到位,或者错误的地方,欢迎大家提出问题并一起交流
pip安装
python -m pip install pyserial# 或者直接pip安装pip install pyserial
conda安装
conda install pyserial#orconda install -c conda-forge pyserial
对于串口通信,我们的大致流程如下:
硬件连接
发包
收包
首先需要将串口设备与电脑相连,并查看自己的串口的端口号是多少
串口的端口号就是将你的串口命名,让程序或者系统能够快捷的寻找
对于windows设备
打开设备管理器 -> 端口 -> 寻找你的设备号
对于windows来说,串口设备端口号一般都是COMn
,这里COM8使用CH340串口芯片来进行通信
对于Linux设备(这里以ubuntu为例)
ls /dev/ttyUSB*
返回的就是你所有串口设备的设备号,如果你具有多个设备,则可以通过拔插之后,查看哪个设备增删来确定你的设备名
问题
找到了设备的端口号之后,就可以使用python来进行通信了。
我贴一个csdn上搜python串口通信的的第一个博客的代码例子。
代码来源:
Https://blog.csdn.net/weixin_43217958/article/details/109782000
import serial#导入串口通信库from time import sleepser = serial.Serial()def port_open_recv():#对串口的参数进行配置 ser.port='com3' ser.baudrate=9600 ser.bytesize=8 ser.stopbits=1 ser.parity="N"#奇偶校验位 ser.open() if(ser.isOpen()): print("串口打开成功!") else: print("串口打开失败!")#isOpen()函数来查看串口的开闭状态def port_close(): ser.close() if(ser.isOpen()): print("串口关闭失败!") else: print("串口关闭成功!")def send(send_data): if(ser.isOpen()): ser.write(send_data.encode('utf-8'))#编码 print("发送成功",send_data) else: print("发送失败!")if __name__ == '__main__': port_open_recv() while True: a=input("输入要发送的数据:") send(a) sleep(0.5)#起到一个延时的效果,这里如果不加上一个while True,程序执行一次就自动跳出了
但是,这个例子,并不适合直接拿来到嵌入式中进一步开发,因为一些重要的参数和解包的方法并没有说明出来,并且在python中,涉及一些数据类型的转换也是比较复杂的(也是让我无数次抓狂的地方😡)。
针对串口通信,我们可以将其分为发包和收包。而想要比较方便的使用python来实现通信,我们需要使用到python一个非常强大的功能包struct
,使用的讲解流程,我将按照官网参数文档介绍
- > 例子
这样的顺序来解释。
class serial.Serial
init(port=None, baudrate=9600, bytesize=EIGHTBITS, parity=PARITY_NONE, stopbits=STOPBITS_ONE, timeout=None, xonxoff=False, rtscts=False, write_timeout=None, dsrdtr=False, inter_byte_timeout=None, exclusive=None)
参数
None
FIVEBITS
, SIXBITS
, SEVENBITS
, EIGHTBITS
PARITY_NONE
, PARITY_EVEN
, PARITY_ODD
,PARITY_MARK
, PARITY_SPACE
STOPBITS_ONE
, STOPBITS_ONE_POINT_FIVE
, STOPBITS_TWO
异常退出
ValueErro
,比如波特率设置SerialException
说明
当我们初始化串口的时候,open()
函数会被调用,串口就会被打开。
timeout
参数会影响到read()
函数的使用,这个timeout
参数非常重要,直接影响到我们对串口数据的读取。
timeout
=None
: 一直等待,直到设置的接收字节数满后退出
timeout
=0
: 非阻塞模式,在任何情况下都立即返回,返回零或更多,最多为请求的字节数
timeout
=x
:当请求的字节数可用时,将timeout设置为x秒(允许浮动)立即返回,否则等待超时到期,并返回在此之前收到的所有字节。
而对于wrtie()
(发包函数)而言,默认为阻塞,除非设置了write_timeout。
针对硬件流控制而言,这个得观察嵌入式设备了,我之前使用STM32和python通信的时候使用过一次,得需要结合硬件连接和原理图说明,但是我并没有完全搞透,且其他时候用的也比较少,这里就不展开叙述了。
在嵌入式中,我们使用发包,一般是将我们的状态数据,或者是控制指令通过转码为符合设备的通信协议的格式后,将其发出。
因此,我们在编写发包函数前,需要先熟读通信协议,并理解我们需要发送什么样的指令,一般协议是16进制的一串数据。
pyserial
中发包函数为write()
write(data):
参数
: 需要发送的数据
返回值
: 写入的字节数
返回值类型
: int
异常值返回
– 如果为端口配置了写入超时并且超过了时间。
将字节数据写入端口。这应该是字节类型(或兼容的,如bytearray
,memoryview
)。必须对Unicode字符串进行编码(例如“hello”.encode(“utf-8”)。
下面是参考实例
# Usart Libraryimport serialimport structimport binascii# Init serial portUsart = serial.Serial(port = '/dev/ttyUSB0', # 串口baudrate=115200, # 波特率timeout = 0.001 )# 判断串口是否打开成功if Usart.isOpen(): print("open success")else: print("open failed") # 使用优雅的方式发送串口数据# 这里的数据可以根据你的需求进行修改send_data = [0xA4,0x03,0x08,0x23,0xD2] #需要发送的串口包send_data=struct.pack("%dB"%(len(send_data)),*send_data) #解析成16进制print(send_data)Usart.write(send_data) #发送
针对收包,我们一般流程就是 收包
-> 检查包
-> 解包
,先查看官网中收包的函数文档
read(size=1)
参数
: size – 读取字节数
返回值
: 串口读取得到的字节
返回值类型
: bytes
从串行端口读取字节。如果设置了超时,则返回的字符数可能少于请求的字符数。如果没有超时,它将阻塞,直到读取请求的字节数。
read_until(expected=LF, size=None)
参数
: expected
– 预期需要的字节。 size
– 读多少字节。返回值
: 串口读取到的字节数
返回值类型
: bytes
读取数据,直到找到预期的序列(默认为“\n”)、超过大小或超时。如果设置了超时,则返回的字符可能少于请求的字符。如果没有超时,它将阻塞,直到读取请求的字节数。
in_waiting()
获得input buffer中缓存字节数
返回值类型
: int
我们首先需要从串口中读取缓存数据
# Usart Libraryimport serialimport structimport binascii# Init serial portUsart = serial.Serial(port = '/dev/ttyUSB0', # 串口baudrate=115200, # 波特率timeout = 0.001 )# 由于后续使用read在未收全数据的时候,会按照一个timeout周期时间读取数据 # 波特率115200返回数据时间大概是1ms,9600下大概是10ms # 所以读取时间设置0.001s# 判断串口是否打开成功if Usart.isOpen(): print("open success")else: print("open failed")# ----读取串口数据-----------------------------------try: count = serial.inWaiting() if count > 0: # 初始化数据 Read_buffer = [] # 接收数据至缓存区 Read_buffer=serial.read(40) # 我们需要读取的是40个寄存器数据,即40个字节 # Read_data()# 前面两行可以注释,换成后面这个函数except KeyboardInterrupt: if serial != None: print("close serial port") serial.close() #--------------------------------------------------------
这里如果没有在0.001s的时间内读到40字节的包,就会退出。因此我们需要结合通信协议来判断我们收到的包是否正确。
这里根据我之前使用的一款IMU(GY-95T)为例子,来演示用状态机判断包是否正确。
同时在函数中,我也将解包函数放入,后面再说明
def Read_data(self): ''' Author: Liu Yuxiang Time: 2022.12.13 description: 读取串口数据 ''' # 初始化数据 counter = 0 Recv_flag = 0 Read_buffer = [] # 接收数据至缓存区 Read_buffer=serial.read(40) # 我们需要读取的是40个寄存器数据,即40个字节 # 状态机判断收包数据是否准确 while(1): # 第1帧是否是帧头ID 0xA4 if (counter == 0): if(Read_buffer[0] != 0xA4): break # 第2帧是否是读功能码 0x03 elif (counter == 1): if(Read_buffer[1] != 0x03): counter=0 break # 第3帧判断起始帧 elif (counter == 2): if(Read_buffer[2] < 0x2c): start_reg=Read_buffer[2] else: counter=0 # 第4帧判断帧有多少数量 elif (counter == 3): if((start_reg+Read_buffer[3]) < 0x2C): # 最大寄存器为2C 大于0x2C说明数据肯定错了 len=Read_buffer[3] else: counter=0 break else: if(len+5==counter): #print('Recv done!') Recv_flag=1 # 收包完毕 if(Recv_flag): Recv_flag = 0 sum = 0 #print(Read_buffer) # Read_buffer中的是byte数据字节流,用struct包解包 data_inspect = str(binascii.b2a_hex(Read_buffer)) # data是将数据转化为原本的按照16进制的数据 try: # 如果接收数据无误,则执行数据解算操作 for i in range(2,80,2): # 根据手册,检验所有帧之和低八位是否等于末尾帧sum += int(data_inspect[i:i+2],16) if (str(hex(sum))[-2:] == data_inspect[80:82]): # 如果数据检验没有问题,则进入解包过程 #print('the Rev data is right') # 数据低八位在前,高八位在后 #print(Read_buffer[4:-1]) unpack_data = struct.unpack(',Read_buffer[4:-1]) # 切片并将其解析为我们所需要的数据,切出我们所需要的数据部分```比如:ACC_X = unpack_data[0]/2048 * 9.8 # unit m/s^2 ACC_Y = unpack_data[1]/2048 * 9.8ACC_Z = unpack_data[2]/2048 * 9.8``` except: print("Have Error in receiving data!!") counter=0 break else: counter += 1 # 遍历整个接收数据的buffer
而解包函数,最关键的就是unpack_data = struct.unpack('
这一行代码的含义就是将Read_buffer[4:-1]
的这部分数据按照小端的顺序,解析成hhhhhhhhhBhhhhhhhh
的排列顺序,h代表short
类型,B代表unsigned char
类型。
具体怎么根据你的情况使用,就可以看一下python的struct
模块。
tips:
一个byte
=8bit
\xa4 这样一个数据代表了16bit
Python没有专门处理字节的数据类型。但由于b'str'
可以表示字节即bytes
,所以,字节数组=二进制str。在C语言中,我们可以很方便地用struct、uNIOn来处理字节,以及字节和int,float的转换。
而在python中却会比较的麻烦,但是python是提供了struct
模块来解决bytes
和其他二进制数据类型的转换
struct模块的两个函数,struct.unpack
和struct.pack
函数
struct.pack(format, v1, v2, …)
Return a bytes object containing the values v1, v2, … packed according to the format string format. The arguments must match the values required by the format exactly.
struct.unpack(format, buffer)
Unpack from the buffer buffer (presumably packed by
pack(format, ...)
) according to the format string format. The result is a tuple even if it contains exactly one item. The buffer’s size in bytes must match the size required by the format, as reflected bycalcsize()
.https://docs.python.org/3/library/struct.html#module-struct
format也就是你需要将后面的数据转换为什么类型的数据,而这个format主要有两部分组成,指定打包数据的方式+数据转换后的类型,具体的表格参考如下:
format可用于指示打包数据的字节顺序、大小和对齐方式,如下表所示:
Character | Byte order | Size | Alignment |
---|---|---|---|
@ | native | native | native |
= | native | standard | none |
< | little-endian | standard | none |
> | big-endian | standard | none |
! | network (= big-endian) | standard | none |
大端(big-endian) | 小端(little-endian) |
---|---|
较低的有效字节存放在较高的存储器地址中,较高的有效字节存放在较低的存储器地址 | 较高的有效字节存放在较高的存储器地址中,较低的有效字节存放在较低的存储器地址 |
比如数据是0x1234
低字节是0x12 高字节是0x34
小端读出来0x34 0x12 大端读出来就是0x12 0x34
而第二个部分也就是后面的数据要转换成什么类型。
Format | C Type | Python type | Standard size(byte) | Notes |
---|---|---|---|---|
x | pad byte | no value | (7) | |
c | char | bytes of length 1 | 1 | |
b | signed char | integer | 1 | (1), (2) |
B | unsigned char | integer | 1 | (2) |
? | _Bool | bool | 1 | (1) |
h | short | integer | 2 | (2) |
H | unsigned short | integer | 2 | (2) |
i | int | integer | 4 | (2) |
I | unsigned int | integer | 4 | (2) |
l | long | integer | 4 | (2) |
L | unsigned long | integer | 4 | (2) |
q | long long | integer | 8 | (2) |
Q | unsigned long long | integer | 8 | (2) |
n | ssize_t | integer | (3) | |
N | size_t | integer | (3) | |
e | (6) | float | 2 | (4) |
f | float | float | 4 | (4) |
d | double | float | 8 | (4) |
s | char[] | bytes | (9) | |
p | char[] | bytes | (8) | |
P | void* | integer | (5) |
这么说会有点抽象,
用具体的例子来看就是
import structstruct.pack('>I', 10240099)>>> b'\x00\x9c@c'
意思就是说,使用>
代表的字节顺序即big-endian
(网络序),来将后面的数据转化成I
代表的数据类型(4字节无符号整型)
(官网例子)>>>from struct import *>>>pack(">bhl", 1, 2, 3)b'\x01\x00\x02\x00\x00\x00\x03'>>>unpack('>bhl', b'\x01\x00\x02\x00\x00\x00\x03')(1, 2, 3)>>>calcsize('>bhl')7
这里和前面的例子是一个道理,使用>
对齐的方式,来将后面三个数据依次打包成b
,h
,l
所代表的数据,解包也是这样,将一串byte
数据按照>
对齐格式转换成b
h
l
对对应的数据。
注意:可以使用b4这样的写法来代表有一个数组
计算所选择的数据格式有多少字节
struct.calcsize(format)
Return the size of the struct (and hence of the bytes object produced by
pack(format, ...)
) corresponding to the format string format.
差不多这样就可以比较优雅的利用python接收和读取串口数据了。如有问题,欢迎评论区提出。
来源地址:https://blog.csdn.net/scarecrow_sun/article/details/129260063
--结束END--
本文标题: python+嵌入式——串口通信篇(收发解包)
本文链接: https://lsjlt.com/news/402453.html(转载时请注明来源链接)
有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341
2024-03-01
2024-03-01
2024-03-01
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
回答
回答
回答
回答
回答
回答
回答
回答
回答
回答
0