Python中pyserial 實現(xiàn)模擬串口通信的示例詳解
在嵌入式系統(tǒng)開發(fā)、工業(yè)自動化和物聯(lián)網(wǎng)(IoT)設(shè)備調(diào)試中,串口通信是一種基礎(chǔ)且重要的技術(shù)。Python通過 pyserial
庫提供了強(qiáng)大的串口通信支持,使得開發(fā)者能夠快速實現(xiàn)串口數(shù)據(jù)的發(fā)送與接收。本文將詳細(xì)介紹如何使用 Python 模擬串口通信,并通過實際代碼示例演示其核心功能和應(yīng)用場景。
一、串口通信的基本概念
1.1 什么是串口通信?
串口通信(Serial Communication)是一種通過串行接口傳輸數(shù)據(jù)的通信方式。它通過一根數(shù)據(jù)線逐位傳輸數(shù)據(jù),常用于設(shè)備間的點對點通信。常見的應(yīng)用場景包括:
- 與嵌入式設(shè)備(如 STM32、Arduino)交互。
- 工業(yè)設(shè)備的調(diào)試與監(jiān)控。
- GPS 模塊、傳感器等外設(shè)的數(shù)據(jù)采集。
1.2 串口通信的關(guān)鍵參數(shù)
- 波特率(Baud Rate):數(shù)據(jù)傳輸速率,單位為 bit/s。常見值如 9600、115200。
- 數(shù)據(jù)位(Data Bits):每幀數(shù)據(jù)的位數(shù),通常為 7 或 8 位。
- 停止位(Stop Bits):每幀數(shù)據(jù)的結(jié)束標(biāo)志,通常為 1 或 2 位。
- 校驗位(Parity):用于錯誤檢測,可選無校驗(None)、奇校驗(Odd)、偶校驗(Even)等。
- 超時時間(Timeout):讀取數(shù)據(jù)時等待的最長時間。
二、Python 串口通信的核心庫:pyserial
2.1 安裝 pyserial
使用 pip
安裝 pyserial
庫:
pip install pyserial
2.2 核心功能
- 打開/關(guān)閉串口:通過
Serial
類管理串口連接。 - 數(shù)據(jù)發(fā)送:使用
write()
方法發(fā)送字節(jié)數(shù)據(jù)。 - 數(shù)據(jù)接收:使用
read()
、readline()
等方法接收數(shù)據(jù)。 - 串口參數(shù)配置:靈活設(shè)置波特率、數(shù)據(jù)位、校驗位等。
三、Python 模擬串口通信的完整示例
3.1 列出可用的串口設(shè)備
在開始通信前,可以先查詢系統(tǒng)中可用的串口設(shè)備:
import serial.tools.list_ports ports = list(serial.tools.list_ports.comports()) for port in ports: print(f"設(shè)備名: {port.device}, 描述: {port.description}")
運(yùn)行結(jié)果(以 Windows 為例):
設(shè)備名: COM1, 描述: 通信端口 (COM1)
設(shè)備名: COM3, 描述: com0com - serial port emulator (COM3)
設(shè)備名: COM4, 描述: com0com - serial port emulator (COM4)
3.2 配置并打開串口
以下代碼演示如何配置串口參數(shù)并打開串口:
import serial # 配置串口參數(shù) ser = serial.Serial( port="COM3", # 串口號(需根據(jù)實際設(shè)備修改) baudrate=115200, # 波特率 bytesize=serial.EIGHTBITS, # 數(shù)據(jù)位:8 位 parity=serial.PARITY_NONE, # 校驗位:無校驗 stopbits=serial.STOPBITS_ONE, # 停止位:1 位 timeout=0.5 # 讀取超時時間(秒) ) # 檢查串口是否成功打開 if ser.is_open: print(f"串口 {ser.port} 已成功打開") else: print(f"無法打開串口 {ser.port}")
3.3 發(fā)送數(shù)據(jù)到串口
通過 write()
方法向串口發(fā)送數(shù)據(jù)。注意,發(fā)送的數(shù)據(jù)必須是字節(jié)格式(bytes
):
def send_data(ser, data): if ser.is_open: ser.write(data.encode('utf-8')) # 將字符串編碼為字節(jié) print(f"發(fā)送數(shù)據(jù): {data}") else: print("串口未打開,無法發(fā)送數(shù)據(jù)") # 示例:發(fā)送 "Hello, Serial!" 到串口 send_data(ser, "Hello, Serial!")
3.4 從串口接收數(shù)據(jù)
接收數(shù)據(jù)的方式有多種,以下是常見的兩種方法:
方法一:讀取指定字節(jié)數(shù)
def read_fixed_bytes(ser, num_bytes): if ser.in_waiting >= num_bytes: # 檢查緩沖區(qū)是否有足夠數(shù)據(jù) data = ser.read(num_bytes) # 讀取指定字節(jié)數(shù) print(f"接收到數(shù)據(jù)({len(data)} 字節(jié)): {data.decode('utf-8')}") else: print("緩沖區(qū)數(shù)據(jù)不足,未讀取到完整數(shù)據(jù)") # 示例:讀取 10 字節(jié)數(shù)據(jù) read_fixed_bytes(ser, 10)
方法二:讀取一行數(shù)據(jù)(直到換行符)
def read_line(ser): if ser.in_waiting > 0: # 檢查是否有數(shù)據(jù)可讀 line = ser.readline() # 讀取一行數(shù)據(jù) print(f"接收到一行數(shù)據(jù): {line.decode('utf-8').strip()}") else: print("未接收到數(shù)據(jù)") # 示例:讀取一行數(shù)據(jù) read_line(ser)
3.5 完整的收發(fā)示例
以下代碼演示了一個完整的串口通信流程,包括發(fā)送數(shù)據(jù)和循環(huán)接收響應(yīng):
import serial import time # 配置串口 ser = serial.Serial( port="COM3", baudrate=9600, timeout=1 ) # 發(fā)送數(shù)據(jù)并接收響應(yīng) def communicate(): if not ser.is_open: print("串口未打開,無法通信") return while True: # 發(fā)送數(shù)據(jù) command = input("請輸入要發(fā)送的數(shù)據(jù)(輸入 'exit' 退出): ") if command.lower() == 'exit': break ser.write(command.encode('utf-8')) # 接收響應(yīng) time.sleep(0.5) # 等待設(shè)備響應(yīng) if ser.in_waiting > 0: response = ser.readline().decode('utf-8').strip() print(f"設(shè)備響應(yīng): {response}") else: print("未收到設(shè)備響應(yīng)") # 關(guān)閉串口 ser.close() print("串口已關(guān)閉") if __name__ == "__main__": communicate()
四、常見問題與解決方案
4.1 串口未找到或無法打開
- 原因:串口號錯誤或設(shè)備未連接。
- 解決方法:使用
serial.tools.list_ports
查詢可用串口,確認(rèn)設(shè)備是否正常連接。
4.2 數(shù)據(jù)接收不完整
- 原因:波特率設(shè)置不一致,或讀取操作未等待足夠時間。
- 解決方法:確保發(fā)送端和接收端的波特率一致,并適當(dāng)增加
timeout
或time.sleep()
的等待時間。
4.3 編碼錯誤
- 原因:數(shù)據(jù)解碼時使用的字符集與實際數(shù)據(jù)不匹配。
- 解決方法:嘗試使用
utf-8
、latin-1
等不同編碼方式,或直接處理字節(jié)數(shù)據(jù)(bytes
)。
五、實際應(yīng)用場景示例
5.1 與 STM32 通信
假設(shè) STM32 通過串口返回溫度傳感器數(shù)據(jù),Python 可以實時讀取并顯示:
while True: if ser.in_waiting > 0: data = ser.readline().decode('utf-8').strip() print(f"當(dāng)前溫度: {data} ℃") time.sleep(0.1)
5.2 模擬設(shè)備調(diào)試
通過 pyserial
模擬設(shè)備響應(yīng),無需真實硬件即可測試上位機(jī)邏輯:
# 模擬設(shè)備響應(yīng) if command == "GET_STATUS": ser.write(b"Status: OK\r\n") elif command == "GET_VERSION": ser.write(b"Version: 1.0.0\r\n")
六、總結(jié)
通過 pyserial
庫,Python 能夠高效地實現(xiàn)串口通信,適用于調(diào)試硬件設(shè)備、開發(fā)上位機(jī)程序等多種場景。本文通過詳細(xì)代碼示例,演示了串口的配置、數(shù)據(jù)發(fā)送與接收的核心操作,并提供了常見問題的解決方案。掌握這些技能后,開發(fā)者可以更輕松地與嵌入式設(shè)備、傳感器或其他串口設(shè)備進(jìn)行交互,提升開發(fā)效率和調(diào)試能力。
擴(kuò)展學(xué)習(xí):
- 探索
pyserial
的高級功能,如異步通信(asyncio
集成)。 - 結(jié)合 GUI 框架(如 PyQt)開發(fā)串口調(diào)試工具。
- 使用
pySerial-asyncio
實現(xiàn)非阻塞串口通信。
到此這篇關(guān)于Python中pyserial 實現(xiàn)模擬串口通信的示例詳解的文章就介紹到這了,更多相關(guān)Python 模擬串口通信內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Pycharm主題切換(禁用)導(dǎo)致UI界面顯示異常的解決方案
這篇文章主要介紹了Pycharm主題切換(禁用)導(dǎo)致UI界面顯示異常的原因分析和解決方案,文中通過圖文結(jié)合的方式給大家介紹的非常詳細(xì),需要的朋友可以參考下2024-06-06python filecmp.dircmp實現(xiàn)遞歸比對兩個目錄的方法
這篇文章主要介紹了python filecmp.dircmp實現(xiàn)遞歸比對兩個目錄的方法,本文通過實例代碼給大家介紹的非常詳細(xì),大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-05-05