模块

import serial.tools.list_ports as seials

方法

获取所有串口设备

• serials.comports()
  • 功能：获取所有串口设备
  • 参数：无
  • 返回值：所有可使用的串口设备，以列表的形式返回

配置串口

• serial.Serial(“COMx”, Baudrate)
  • 功能：配置串口参数
  • 参数
    • COMx：串口号
    • Baudrate：波特率
  • 返回值：串口对象

ser = serial.Serial("COM8", 115200)

获得串口号

• ser.name
  • 功能：获得串口号
  • 返回值：串口号

活动串口状态

• ser.isOpen()
  • 功能：活动串口状态
  • 参数：无
  • 返回值：若是打开状态则返回True，反之为False

读串口数据

• ser.read(time)
  • 功能：读取串口数据
  • 参数
    • time：延时时间，多长时间读一次，单位秒 目前不确定
  • 返回值：读到的数据，bytes的格式

写入串口数据

• ser.write(str.encode(‘utf-8’))
  • 功能：向串口发送数据
  • 参数
    • str：要发送的字符串
  • 返回值：发出的字节数

write_len = ser.write("ABCDEFG".encode('utf-8'))
print("串口发出{}个字节。".format(write_len))

关闭串口

• ser.close()
  • 功能：关闭串口
  • 参数：无
  • 返回值：无

示例

获得数字数据并打印出来

import serial
import serial.tools.list_ports as serials

ports_list = list(serials.comports())
if len(ports_list) <= 0:
    print("无串口设备。")
else:
    print("可用的串口设备如下：")
    # 打印出所有可用的设备信息
    for comport in ports_list:
        print(list(comport)[0], list(comport)[1])
	
    # 打开检测到的com口，将波特率配置为115200，其余参数使用默认值
    ser = serial.Serial(list(comport)[0], 115200)
    if ser.isOpen():
        print("打开串口成功。")
        print(ser.name)

        # 读取串口输入信息并输出。
        while True:
            com_input = ser.read(1)
            # 如果读取结果非空，则输出
            if com_input:
                val = int.from_bytes(com_input, byteorder = 'big')
                if val!=13 and val!=10:
                    print(chr(val), end = '')
                else:
                    print('\n', end = '')
    else:
        print("打开串口失败。")

• 在print(list(comport)[0], list(comport)[1])中list(comport)[0]仅表示COM口，而list(comport)[1]则会显示设备来源

• val = int.from_bytes(com_input, byteorder = 'big')是将获得的bytes转换为int类型，但该int型是ASCII码，要想获得原始数据还得继续转换

• if val!=13 and val!=10:单片机发送一个数据以后会发送一个结束标志位，在Windows下编码为\r\n，ASCII码表示即为13 10

  • 在不同操作系统下结束位编码不同

    \n: UNIX 系统行末结束符

    \r: MAC OS 系统行末结束符

• print(chr(val), end = '')目的是让多位数显示在同一行，end=''是取消自动换行的

• chr(val)是将ASCII码转为原始数据

其他

配置串口有很多参数可选，但一般值需要配置串口号和波特率