Python 研究 - pyserial 用法

python中pyserial模塊使用方法
一、概述
    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實例
}