Python-serial 模块使用方法

PySerial 官方说明  pySerial API — pySerial 3.4 documentation      https://pyserial.readthedocs.io/en/latest/pyserial_api.html 

def get_com_list(self):
    com_dev_list = tuple(serial.tools.list_ports.comports())
    if not com_dev_list:
        log.info('there\'s no com')
        self.__com_list = []
    else:
        self.__com_list = ['/dev/' + i.name for i in com_dev_list]
        # log.debug('com_name_list:{}'.format(self.__com_list))
    return self.__com_list

 

Python中有专门的串口操作模块pySerial,使用非常简单。

pySerial的资源网址https://pypi.python.org/pypi/pyserial,

github资源和一些使用教程的网址:https://github.com/pyserial/pyserial

串口操作文档http://pythonhosted.org/pyserial/

 

Python串口操作简单介绍

class serial.Serial

__init__(port=Nonebaudrate=9600bytesize=EIGHTBITSparity=PARITY_NONEstopbits=STOPBITS_ONE

timeout=Nonexonxoff=False,rtscts=Falsewrite_timeout=Nonedsrdtr=Falseinter_byte_timeout=None)

 

port:如COM1,COM2,COM3,COM4......如果port设置为0对应的为COM1

baudrate:设置波特率

bytesize:数据位

stopbits:停止位

timeout:超时时间

  • timeout = None: 长时间等待
  • timeout = 0: 不阻塞形式 (读完之后就返回)
  • timeout = x: x秒后超时 (float allowed)

1)

ser=serial.Serial("/dev/ttyUSB0",9600,timeout=0.5) #使用USB连接串行口

ser=serial.Serial("/dev/ttyAMA0",9600,timeout=0.5) #使用树莓派的GPIO口连接串行口

ser=serial.Serial(1,9600,timeout=0.5)#winsows系统使用com1口连接串行口

ser=serial.Serial("com1",9600,timeout=0.5)#winsows系统使用com1口连接串行口

ser=serial.Serial("/dev/ttyS1",9600,timeout=0.5)#Linux系统使用com1口连接串行口

print ser.name#打印设备名称

print ser.port#打印设备名

ser.open() #打开端口

s = ser.read(10)#从端口读10个字节

ser.write("hello")#向端口些数据

ser.close()#关闭端口

        data = ser.read(20) #是读20个字符

        data = ser.readline() #是读一行,以/n结束,要是没有/n就一直读,阻塞。

        data = ser.readlines()和ser.xreadlines()#都需要设置超时时间

        ser.baudrate = 9600 #设置波特率

        ser.isOpen() #看看这个串口是否已经被打开

 

2)、获得串行口状态

串行口的属性:

name:设备名字

portstr:已废弃,用name代替

port:读或者写端口

baudrate:波特率

bytesize:字节大小

parity:校验位

stopbits:停止位

timeout:读超时设置

writeTimeout:写超时

xonxoff:软件流控

rtscts:硬件流控

dsrdtr:硬件流控

interCharTimeout:字符间隔超时

 

属性的使用方法:

ser=serial.Serial("/dev/ttyAMA0",9600,timeout=0.5)

 

ser.open()

 

print ser.name

print ser.port

print ser.baudrate#波特率

print ser.bytesize#字节大小

print ser.parity#校验位N-无校验,E-偶校验,O-奇校验

print ser.stopbits#停止位

print ser.timeout#读超时设置

print ser.writeTimeout#写超时

print ser.xonxoff#软件流控

print ser.rtscts#硬件流控

print ser.dsrdtr#硬件流控

print ser.interCharTimeout#字符间隔超时

 

ser.close()

 

 

3)、设置串行口状态

 

需要用的常量

 

bytesize:FIVE BITS、SIXBITS、SEVENBITS、EIGHTBITS

parity: PARITY_NONE, PARITY_EVEN, PARITY_ODD, PARITY_MARK, PARITY_SPACE

stopbits: STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO

异常:

ValueError:参数错误

SerialException:找不到设备或不能配置

 

ser.baudrate=9600#设置波特率

 

ser.bytesize=8#字节大小

ser.bytesize=serial.EiGHTBITS#8位数据位

 

ser.parity=serial.PARITY_EVEN#偶校验

ser.parity=serial.PARITY_NONE#无校验

ser.parity=serial.PARITY_ODD#奇校验

 

ser.stopbits=1#停止位

ser.timeout=0.5#读超时设置

ser.writeTimeout=0.5#写超时

ser.xonxoff#软件流控

ser.rtscts#硬件流控

ser.dsrdtr#硬件流控

ser.interCharTimeout#字符间隔超时

 

4)、Readline方法的使用

        是读一行,以/n结束,要是没有/n就一直读,阻塞。

 

        使用readline()时应该注意:打开串口时应该指定超时,否则如果串口没有收到新行,则会一直等待。如果没有超时,readline会报异常。

 

5)、serial.Serial类——原生端口

class serial.Serial 

{

    __init__(port=None, baudrate=9600, bytesize=EIGHTBITS,parity=PARITY_NONE, stopbits=STOPBITS_ONE, timeout=None, xonxoff=False, rtscts=False, writeTimeout=None, dsrdtr=False, interCharTimeout=None)

 

    #其中:

    # bytesize:FIVEBITS、SIXBITS、SEVENBITS、EIGHTBITS

    # parity: PARITY_NONE, PARITY_EVEN, PARITY_ODD, PARITY_MARK, PARITY_SPACE

    # stopbits: STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO

    #异常:

    #ValueError:参数错误

    #SerialException:找不到设备或不能配置

 

    open():打开串口

 

    close():立即关闭串口

 

    __del__():析构函数

 

    read(size=1):从串口读size个字节。如果指定超时,则可能在超时后返回较少的字节;如果没有指定超时,则会一直等到收完指定的字节数。

 

    write(data):发送data,并返回发送字节数。如果bytes和bytearray可用(python 2.6以上),则接受其作为参数;否则接受str作为参数。

    #异常:SerialTimeoutException——配置了写超时并发生超时时发生此异常。

 

    inWaiting():返回接收缓存中的字节数

 

    flush():等待所有数据写出。

 

    flushInput():丢弃接收缓存中的所有数据

 

    flushOutput():终止当前写操作,并丢弃发送缓存中的数据。

 

    sendBreadk(duration=0.25):发送BREAK条件,并于duration时间之后返回IDLE

 

    setBreak(level=True):根据level设置break条件。

 

    setRTS(level=True)

 

    setDTR(level=True)

 

    getCTS()

 

    getDSR()

 

    getRI()

 

    getCD()

 

    #只读属性:

    name:设备名字

    portstr:已废弃,用name代替

    port:读或者写端口

    baudrate:波特率

    bytesize:字节大小

    parity:校验位

    stopbits:停止位

    timeout:读超时设置

    writeTimeout:写超时

    xonxoff:软件流控

    rtscts:硬件流控

    dsrdtr:硬件流控

    interCharTimeout:字符间隔超时

 

    #端口设置可以被读入字典,也可从字典加载设置:

    getSettingDict():返回当前串口设置的字典

    applySettingDict(d):应用字典到串口设置

 

    #对提供io库的系统(python 2.6或以上),Serial从io.RawIOBase派生。对其它系统,从FileLike派生。

 

    #异常:

    exception serial.SerialException

    exception serial.SerialTimeoutException

 #常量:

    serial.VERSION:pyserial版本

 

    #模块函数和属性:

    serial.device(number)

 

    serial.serial_for_url(url, *args, **kwargs)

 

    serial.protocol_handler_packages()

 

    serial.to_bytes(sequence):接收一个字符串或整数列表sequence,返回bytes实例

}

Python串口操作简单介绍

class serial.Serial

__init__(port=Nonebaudrate=9600bytesize=EIGHTBITSparity=PARITY_NONEstopbits=STOPBITS_ONE

timeout=Nonexonxoff=False,rtscts=Falsewrite_timeout=Nonedsrdtr=Falseinter_byte_timeout=None)

 

port:如COM1,COM2,COM3,COM4......如果port设置为0对应的为COM1

baudrate:设置波特率

bytesize:数据位

stopbits:停止位

timeout:超时时间

  • timeout = None: 长时间等待
  • timeout = 0: 不阻塞形式 (读完之后就返回)
  • timeout = x: x秒后超时 (float allowed)

1)

ser=serial.Serial("/dev/ttyUSB0",9600,timeout=0.5) #使用USB连接串行口

ser=serial.Serial("/dev/ttyAMA0",9600,timeout=0.5) #使用树莓派的GPIO口连接串行口

ser=serial.Serial(1,9600,timeout=0.5)#winsows系统使用com1口连接串行口

ser=serial.Serial("com1",9600,timeout=0.5)#winsows系统使用com1口连接串行口

ser=serial.Serial("/dev/ttyS1",9600,timeout=0.5)#Linux系统使用com1口连接串行口

print ser.name#打印设备名称

print ser.port#打印设备名

ser.open() #打开端口

s = ser.read(10)#从端口读10个字节

ser.write("hello")#向端口些数据

ser.close()#关闭端口

        data = ser.read(20) #是读20个字符

        data = ser.readline() #是读一行,以/n结束,要是没有/n就一直读,阻塞。

        data = ser.readlines()和ser.xreadlines()#都需要设置超时时间

        ser.baudrate = 9600 #设置波特率

        ser.isOpen() #看看这个串口是否已经被打开

 

2)、获得串行口状态

串行口的属性:

name:设备名字

portstr:已废弃,用name代替

port:读或者写端口

baudrate:波特率

bytesize:字节大小

parity:校验位

stopbits:停止位

timeout:读超时设置

writeTimeout:写超时

xonxoff:软件流控

rtscts:硬件流控

dsrdtr:硬件流控

interCharTimeout:字符间隔超时

 

属性的使用方法:

ser=serial.Serial("/dev/ttyAMA0",9600,timeout=0.5)

 

ser.open()

 

print ser.name

print ser.port

print ser.baudrate#波特率

print ser.bytesize#字节大小

print ser.parity#校验位N-无校验,E-偶校验,O-奇校验

print ser.stopbits#停止位

print ser.timeout#读超时设置

print ser.writeTimeout#写超时

print ser.xonxoff#软件流控

print ser.rtscts#硬件流控

print ser.dsrdtr#硬件流控

print ser.interCharTimeout#字符间隔超时

 

ser.close()

 

 

3)、设置串行口状态

 

需要用的常量

 

bytesize:FIVE BITS、SIXBITS、SEVENBITS、EIGHTBITS

parity: PARITY_NONE, PARITY_EVEN, PARITY_ODD, PARITY_MARK, PARITY_SPACE

stopbits: STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO

异常:

ValueError:参数错误

SerialException:找不到设备或不能配置

 

ser.baudrate=9600#设置波特率

 

ser.bytesize=8#字节大小

ser.bytesize=serial.EiGHTBITS#8位数据位

 

ser.parity=serial.PARITY_EVEN#偶校验

ser.parity=serial.PARITY_NONE#无校验

ser.parity=serial.PARITY_ODD#奇校验

 

ser.stopbits=1#停止位

ser.timeout=0.5#读超时设置

ser.writeTimeout=0.5#写超时

ser.xonxoff#软件流控

ser.rtscts#硬件流控

ser.dsrdtr#硬件流控

ser.interCharTimeout#字符间隔超时

 

4)、Readline方法的使用

        是读一行,以/n结束,要是没有/n就一直读,阻塞。

 

        使用readline()时应该注意:打开串口时应该指定超时,否则如果串口没有收到新行,则会一直等待。如果没有超时,readline会报异常。

 

5)、serial.Serial类——原生端口

class serial.Serial 

{

    __init__(port=None, baudrate=9600, bytesize=EIGHTBITS,parity=PARITY_NONE, stopbits=STOPBITS_ONE, timeout=None, xonxoff=False, rtscts=False, writeTimeout=None, dsrdtr=False, interCharTimeout=None)

 

    #其中:

    # bytesize:FIVEBITS、SIXBITS、SEVENBITS、EIGHTBITS

    # parity: PARITY_NONE, PARITY_EVEN, PARITY_ODD, PARITY_MARK, PARITY_SPACE

    # stopbits: STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO

    #异常:

    #ValueError:参数错误

    #SerialException:找不到设备或不能配置

 

    open():打开串口

 

    close():立即关闭串口

 

    __del__():析构函数

 

    read(size=1):从串口读size个字节。如果指定超时,则可能在超时后返回较少的字节;如果没有指定超时,则会一直等到收完指定的字节数。

 

    write(data):发送data,并返回发送字节数。如果bytes和bytearray可用(python 2.6以上),则接受其作为参数;否则接受str作为参数。

    #异常:SerialTimeoutException——配置了写超时并发生超时时发生此异常。

 

    inWaiting():返回接收缓存中的字节数

 

    flush():等待所有数据写出。

 

    flushInput():丢弃接收缓存中的所有数据

 

    flushOutput():终止当前写操作,并丢弃发送缓存中的数据。

 

    sendBreadk(duration=0.25):发送BREAK条件,并于duration时间之后返回IDLE

 

    setBreak(level=True):根据level设置break条件。

 

    setRTS(level=True)

 

    setDTR(level=True)

 

    getCTS()

 

    getDSR()

 

    getRI()

 

    getCD()

 

    #只读属性:

    name:设备名字

    portstr:已废弃,用name代替

    port:读或者写端口

    baudrate:波特率

    bytesize:字节大小

    parity:校验位

    stopbits:停止位

    timeout:读超时设置

    writeTimeout:写超时

    xonxoff:软件流控

    rtscts:硬件流控

    dsrdtr:硬件流控

    interCharTimeout:字符间隔超时

 

    #端口设置可以被读入字典,也可从字典加载设置:

    getSettingDict():返回当前串口设置的字典

    applySettingDict(d):应用字典到串口设置

 

    #对提供io库的系统(python 2.6或以上),Serial从io.RawIOBase派生。对其它系统,从FileLike派生。

 

    #异常:

    exception serial.SerialException

    exception serial.SerialTimeoutException

 #常量:

    serial.VERSION:pyserial版本

 

    #模块函数和属性:

    serial.device(number)

 

    serial.serial_for_url(url, *args, **kwargs)

 

    serial.protocol_handler_packages()

 

    serial.to_bytes(sequence):接收一个字符串或整数列表sequence,返回bytes实例

}


serial 模块使用方法

一、概述
    pyserial模块封装了对串口的访问。
二、特性
    在支持的平台上有统一的接口。
    通过python属性访问串口设置。
    支持不同的字节大小、停止位、校验位和流控设置。
    可以有或者没有接收超时。 
    类似文件的API,例如read和write,也支持readline等。
    支持二进制传输,没有null消除,没有cr-lf转换。
三、版本要求
    python 2.3及以上版本,包括py3k。

四、使用方法和实例

1、导入pyserial模块

import  serial


2、打开串行口


// 打开串口0, 9600,8N1,连接超时0.5秒
import serial
①选择设备
ser=serial.Serial("/dev/ttyUSB0",9600,timeout=0.5) #使用USB连接串行口
ser=serial.Serial("/dev/ttyAMA0",9600,timeout=0.5) #使用树莓派的GPIO口连接串行口
ser=serial.Serial(1,9600,timeout=0.5)                       #winsows系统使用com1口连接串行口
ser=serial.Serial("com1",9600,timeout=0.5)              #winsows系统使用com1口连接串行口
ser=serial.Serial("/dev/ttyS1",9600,timeout=0.5)       #Linux系统使用com1口连接串行口
print ser.name        #打印设备名称
print ser.port           #打印设备名
ser.open()               #打开端口
s = ser.read(10)      #从端口读10个字节
ser.write("hello")     #向端口写数据
ser.close()               #关闭端口
data = ser.read(20) #读20个字符


data = ser.readline() #是读一行,以/n结束,要是没有/n就一直读,阻塞。

data = ser.readlines()  和  ser.xreadlines()     #都需要设置超时时间

ser.baudrate = 9600      #设置波特率

ser.isOpen()                   #看看这个串口是否已经被打开

3、获得串行口状态
串行口的属性:
name:设备名字
portstr:已废弃,用name代替
port:读或者写端口
baudrate:波特率
bytesize:字节大小
parity:校验位
stopbits:停止位
timeout:读超时设置
writeTimeout:写超时
xonxoff:软件流控
rtscts:硬件流控
dsrdtr:硬件流控
interCharTimeout:字符间隔超时
        
①属性

属性的使用方法:
ser=serial.Serial("/dev/ttyAMA0",9600,timeout=0.5)
ser.open()

print ser.name
print ser.port
print ser.baudrate#波特率
print ser.bytesize#字节大小
print ser.parity#校验位N-无校验,E-偶校验,O-奇校验
print ser.stopbits#停止位
print ser.timeout#读超时设置
print ser.writeTimeout#写超时
print ser.xonxoff#软件流控
print ser.rtscts#硬件流控
print ser.dsrdtr#硬件流控
print ser.interCharTimeout#字符间隔超时
ser.close()
4、设置串行口状态
需要用的常量


bytesize:FIVE BITS、SIXBITS、SEVENBITS、EIGHTBITS
parity: PARITY_NONE, PARITY_EVEN, PARITY_ODD, PARITY_MARK, PARITY_SPACE
stopbits: STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO
异常:
ValueError:参数错误
SerialException:找不到设备或不能配置
ser.baudrate=9600#设置波特率

ser.bytesize=8#字节大小
ser.bytesize=serial.EiGHTBITS#8位数据位

ser.parity=serial.PARITY_EVEN#偶校验
ser.parity=serial.PARITY_NONE#无校验
ser.parity=serial.PARITY_ODD#奇校验

ser.stopbits=1               #停止位
ser.timeout=0.5             #读超时设置
ser.writeTimeout=0.5    #写超时
ser.xonxoff#软件流控
ser.rtscts#硬件流控
ser.dsrdtr#硬件流控
ser.interCharTimeout#字符间隔超时

5、Readline方法的使用

        是读一行,以/n结束,要是没有/n就一直读,阻塞。


       使用readline()时应该注意:打开串口时应该指定超时,否则如果串口没有收到新行,则会一直等待。如果没有超时,readline会报异常。
6、serial.Serial类——原生端口
class serial.Serial 
{
    __init__(port=None, baudrate=9600, bytesize=EIGHTBITS,parity=PARITY_NONE, stopbits=STOPBITS_ONE, timeout=None, xonxoff=False, rtscts=False, writeTimeout=None, dsrdtr=False, interCharTimeout=None)
}
    #其中:
    # bytesize:FIVEBITS、SIXBITS、SEVENBITS、EIGHTBITS
    # parity: PARITY_NONE, PARITY_EVEN, PARITY_ODD, PARITY_MARK, PARITY_SPACE
    # stopbits: STOPBITS_ONE, STOPBITS_ONE_POINT_FIVE, STOPBITS_TWO
    #异常:
    #ValueError:参数错误
    #SerialException:找不到设备或不能配置

    open():打开串口

    close():立即关闭串口

    __del__():析构函数

    read(size=1):从串口读size个字节。如果指定超时,则可能在超时后返回较少的字节;如果没有指定超时,则会一直等到收完指定的字节数。

    write(data):发送data,并返回发送字节数。如果bytes和bytearray可用(python 2.6以上),则接受其作为参数;否则接受str作为参数。
    #异常:SerialTimeoutException——配置了写超时并发生超时时发生此异常。

    inWaiting():返回接收缓存中的字节数

    flush():等待所有数据写出。

    flushInput():丢弃接收缓存中的所有数据

    flushOutput():终止当前写操作,并丢弃发送缓存中的数据。

    sendBreadk(duration=0.25):发送BREAK条件,并于duration时间之后返回IDLE

    setBreak(level=True):根据level设置break条件。

    setRTS(level=True)

    setDTR(level=True)

    getCTS()

    getDSR()

    getRI()

    getCD()

    #只读属性:
    name:设备名字
    portstr:已废弃,用name代替
    port:读或者写端口
    baudrate:波特率
    bytesize:字节大小
    parity:校验位
    stopbits:停止位
    timeout:读超时设置
    writeTimeout:写超时
    xonxoff:软件流控
    rtscts:硬件流控
    dsrdtr:硬件流控
    interCharTimeout:字符间隔超时

    #端口设置可以被读入字典,也可从字典加载设置:
    getSettingDict():返回当前串口设置的字典
    applySettingDict(d):应用字典到串口设置

    #对提供io库的系统(python 2.6或以上),Serial从io.RawIOBase派生。对其它系统,从FileLike派生。

    #异常:
    exception serial.SerialException
    exception serial.SerialTimeoutException

    #常量:
    serial.VERSION:pyserial版本

    #模块函数和属性:
    serial.device(number)

    serial.serial_for_url(url, *args, **kwargs)

    serial.protocol_handler_packages()

    serial.to_bytes(sequence):接收一个字符串或整数列表sequence,返回bytes实例
}

 

  • 22
    点赞
  • 142
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 3
    评论
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

EmbededCoder

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值