簡(jiǎn)介這是一款面向嵌入式開發(fā)者、物聯(lián)網(wǎng)工程師及硬件調(diào)試人員的專業(yè)串口調(diào)試與程序下載工具將串口通信、數(shù)據(jù)監(jiān)控和固件更新集成于一體。軟件支持自定義波特率、數(shù)據(jù)位、停止位及校驗(yàn)方式可靈活匹配不同設(shè)備并提供文本或十六進(jìn)制數(shù)據(jù)查看、指令發(fā)送等功能有助于快速完成設(shè)備調(diào)試、參數(shù)配置與固件部署。資源包共包含188個(gè)文件壓縮包大小39.81MB文件構(gòu)成上以exe主程序和dll運(yùn)行組件為核心附有txt說明文檔、png界面或流程示意圖、xls參數(shù)記錄表以及bin固件示例、json配置、gain等輔助文件結(jié)構(gòu)較為完整適合在嵌入式開發(fā)、生產(chǎn)測(cè)試和設(shè)備維護(hù)場(chǎng)景中直接參考或部署使用。目前已有1290人學(xué)習(xí)下載。內(nèi)容預(yù)覽中可見多種示例固件和配置文件便于理解實(shí)際燒錄與串口工具協(xié)作方式也能作為初學(xué)者熟悉串口通信流程和固件更新機(jī)制的實(shí)用參考資料。 前陣子調(diào)一塊STM32板子手里同時(shí)開著串口調(diào)試助手、固件下載工具、波形查看軟件三個(gè)窗口來回切換得手忙腳亂。串口數(shù)據(jù)剛抓到一組異常波形想切到下載工具重新燒一版程序又擔(dān)心串口被占用導(dǎo)致下載失敗等下載完了切回調(diào)試助手發(fā)現(xiàn)剛才的日志被清空了關(guān)鍵數(shù)據(jù)沒存下來。這種痛點(diǎn)攢了幾次我終于下定決心把平時(shí)常用的串口調(diào)試和固件下載功能整合到一起從零寫一個(gè)自己的工具——串口調(diào)試下載助手v2.0。這篇文章就把這個(gè)工具從需求分析、技術(shù)選型到編碼實(shí)現(xiàn)、踩坑修復(fù)的完整過程拆開來講給同樣在做嵌入式上位機(jī)開發(fā)的朋友一些參考。1. 為什么放著現(xiàn)成的 sscom、XCOM 不用非要自己折騰一個(gè)1.1 現(xiàn)成串口工具讓我抓狂的幾個(gè)瞬間市面上成熟的串口調(diào)試助手并不少sscom、XCOM、友善串口調(diào)試助手這些我都用過功能確實(shí)穩(wěn)定但用久了就會(huì)發(fā)現(xiàn)幾個(gè)共性痛點(diǎn)。第一個(gè)痛點(diǎn)是調(diào)試和下載分離。調(diào)試板子時(shí)我要開一個(gè)串口助手要燒錄固件時(shí)又要切換到專門的 ISP 下載工具兩個(gè)軟件都要指定同一個(gè)串口。串口被調(diào)試助手占著下載工具就打不開設(shè)備必須先把調(diào)試助手關(guān)掉再打開下載工具燒完再反過來操作一遍。一次兩次還能忍天天這么來回切效率損失非常大。第二個(gè)痛點(diǎn)是日志管理太弱。很多調(diào)試助手的接收區(qū)是個(gè)純文本框數(shù)據(jù)量大了以后翻不到前面想回看某段報(bào)文的上下文基本靠運(yùn)氣。有的工具雖然有保存功能但格式是一整塊純文本粘進(jìn) txt沒有時(shí)間戳、沒有收發(fā)方向標(biāo)識(shí)后期排查問題很難還原現(xiàn)場(chǎng)。第三個(gè)痛點(diǎn)是定制能力為零。做設(shè)備調(diào)試時(shí)我經(jīng)常需要按自定義協(xié)議組幀發(fā)送比如幀頭校驗(yàn)、CRC 計(jì)算、連續(xù)發(fā)送 N 幀、收到特定應(yīng)答后自動(dòng)執(zhí)行下一步動(dòng)作。這些邏輯在現(xiàn)成工具里做不了純手點(diǎn)按鈕又慢又容易出錯(cuò)。這時(shí)候你會(huì)發(fā)現(xiàn)通用工具做得再好也覆蓋不了自己的特定工作流。1.2 v2.0 給自己的定位正因?yàn)檫@些痛點(diǎn)我倒騰了 v1.0 的驗(yàn)證版功能很薄就是把串口收發(fā)和最基本的 Hex 顯示做了做得還挺粗糙。但就是這版原型讓我確認(rèn)了一件事自己寫工具可以完全按照自己的使用習(xí)慣來設(shè)計(jì)不受通用軟件的功能邊界限制。v2.0 就是在 v1.0 基礎(chǔ)上重新規(guī)劃后的正式版本。它給自己的定位非常明確面向嵌入式開發(fā)調(diào)試場(chǎng)景的桌面小工具核心功能只有兩個(gè)——串口調(diào)試、串口 ISP 下載再圍繞這兩個(gè)核心補(bǔ)上協(xié)議分析、波形顯示、日志管理等輔助能力。它不追求大而全不跟通用串口助手拼功能數(shù)量而是把調(diào)試 下載這個(gè)組合場(chǎng)景做到順手。這個(gè)定位也決定了后續(xù)所有設(shè)計(jì)決策凡是兩個(gè)核心功能需要的能力就認(rèn)真做凡是偏離這個(gè)場(chǎng)景的復(fù)雜功能一律砍掉。比如我刻意沒有去實(shí)現(xiàn)網(wǎng)絡(luò)調(diào)試助手里常見的 TCP/UDP 透?jìng)鞴δ懿皇且驗(yàn)殡y而是因?yàn)槲移綍r(shí)用不到做了反而稀釋了工具的重點(diǎn)。2. 技術(shù)棧選型和整體架構(gòu)設(shè)計(jì)2.1 為什么選 Qt 6 C 而不是 Python 或其他方案一說到寫個(gè)串口小工具很多人第一反應(yīng)是 Python 加 pyserial開發(fā)速度快幾十行代碼就能跑起來。我 v1.0 其實(shí)也用 Python 驗(yàn)證過但到了 v2.0 我放棄了原因很實(shí)際。最核心的問題是下載固件時(shí)對(duì)時(shí)序和穩(wěn)定性的要求。ISP 下載過程中擦除、編程、校驗(yàn)每一環(huán)都有超時(shí)控制命令與命令之間的間隔、等待芯片應(yīng)答的時(shí)間窗口都需要精確控制。Python 的 GIL 和垃圾回收機(jī)制在極端情況下會(huì)讓某個(gè)操作卡一下這一卡可能就超過芯片 Bootloader 的超時(shí)閾值導(dǎo)致下載失敗。串口調(diào)試場(chǎng)景里偶爾丟幾幀還能忍下載固件時(shí)失敗一次就要重新擦除重來代價(jià)完全不同。C 配合 Qt 6 是更穩(wěn)妥的選擇。Qt 的 QSerialPort 模塊封裝得很好跨平臺(tái)能力也強(qiáng)底層用 C 寫性能和時(shí)序可控性都更有保障UI 開發(fā)用 Qt Widgets 或 QML 都比較成熟。再加上 QCustomPlot 這樣的開源繪圖庫(kù)波形顯示也不需要自己從零造輪子。也有朋友建議過用 Electron 加 Node.jsWeb 技術(shù)做界面確實(shí)好看但串口訪問這塊還是需要走 Native 模塊而且打包體積、內(nèi)存占用都比 Qt 方案大不少對(duì)一個(gè)桌面工具來說沒必要。2.2 整體模塊劃分與線程模型v2.0 的工程結(jié)構(gòu)按功能拆成了幾個(gè)相對(duì)獨(dú)立的模塊。串口通信模塊負(fù)責(zé)底層收發(fā)基于 QSerialPort 封裝協(xié)議解析模塊負(fù)責(zé)按自定義幀格式解析收到的數(shù)據(jù)同時(shí)處理 Hex 與字符串的轉(zhuǎn)換波形顯示模塊基于 QCustomPlot 實(shí)現(xiàn)把解析后的數(shù)值渲染成曲線固件下載模塊獨(dú)立實(shí)現(xiàn)一套 ISP 協(xié)議狀態(tài)機(jī)不跟串口調(diào)試模塊搶資源界面層負(fù)責(zé)把上面這些模塊組合起來。這里最值得展開說的是線程模型。串口數(shù)據(jù)接收是高頻事件如果直接在 UI 線程里處理數(shù)據(jù)量一大界面就會(huì)卡。我最初的寫法是在 QSerialPort 的 readyRead 信號(hào)里直接讀數(shù)據(jù)、追加到文本框?qū)崪y(cè)下來 115200 波特率下連續(xù)接收幾百 KB 數(shù)據(jù)時(shí)界面已經(jīng)能感覺到明顯延遲。后來改成標(biāo)準(zhǔn)的 QThread Worker 模式串口讀寫放在一個(gè)獨(dú)立的 QThread 里讀到的數(shù)據(jù)通過信號(hào)發(fā)給 UI 線程更新顯示UI 線程的發(fā)送操作也通過信號(hào)槽轉(zhuǎn)給串口線程去寫。中間用 Qt 的 QueuedConnection 做跨線程通信數(shù)據(jù)用 QByteArray 傳遞。改完之后再跑大數(shù)據(jù)量接收測(cè)試界面流暢度提升很明顯。這是做這類工具一定要提前考慮的架構(gòu)問題如果一開始就把收發(fā)邏輯直接寫死在 UI 層后面再改線程模型會(huì)非常痛苦。3. 串口調(diào)試模塊從能發(fā)能收到好用看得清3.1 數(shù)據(jù)接收與顯示的細(xì)節(jié)處理串口調(diào)試模塊最基礎(chǔ)的能力就是能發(fā)能收但真正用起來要處理的細(xì)節(jié)比想象中多。接收數(shù)據(jù)這塊我實(shí)現(xiàn)了 ASCII 和 Hex 兩種顯示模式而且支持混合模式下對(duì)收發(fā)的方向做顏色區(qū)分。實(shí)現(xiàn)原理不復(fù)雜在 append 數(shù)據(jù)時(shí)給文本片段加一個(gè)顏色屬性發(fā)送數(shù)據(jù)顯示成一種顏色接收數(shù)據(jù)顯示成另一種顏色。這樣回看日志時(shí)一眼就能分辨哪些是主機(jī)發(fā)出去的、哪些是設(shè)備返回的不需要靠?jī)?nèi)容猜測(cè)。接收區(qū)有一個(gè)繞不開的問題數(shù)據(jù)量大了之后QPlainTextEdit 會(huì)越來越卡。原因是文本控件持有的 block 數(shù)量太多每次刷新都要重排。解決辦法是給 QPlainTextEdit 設(shè)置 setMaximumBlockCount比如限制在 5000 到 10000 行超過之后自動(dòng)丟棄最老的內(nèi)容。這樣既保證了滾動(dòng)查看近期數(shù)據(jù)的流暢性又不會(huì)因?yàn)闊o限增長(zhǎng)把內(nèi)存吃光。有個(gè)小技巧是在自動(dòng)滾動(dòng)到底部和手動(dòng)滾動(dòng)查看歷史之間做切換——如果用戶正在往上翻看歷史數(shù)據(jù)就不要強(qiáng)行把滾動(dòng)條拽到底這個(gè)邏輯判斷一下 scrollbar 的位置就能實(shí)現(xiàn)看似不起眼用起來差別很大。接收數(shù)據(jù)的時(shí)間戳是另一個(gè)實(shí)用功能。每收到一包數(shù)據(jù)就插入一行時(shí)間戳格式精確到毫秒。因?yàn)榇跊]有內(nèi)置時(shí)間信息調(diào)試時(shí)序問題、分析設(shè)備響應(yīng)慢的根因時(shí)毫秒級(jí)時(shí)間戳能提供關(guān)鍵線索。我在 v2.0 里把時(shí)間戳做成可配置項(xiàng)默認(rèn)開啟想關(guān)也能關(guān)保持日志干凈。3.2 發(fā)送功能與自動(dòng)動(dòng)作發(fā)送功能看起來簡(jiǎn)單其實(shí)就是把輸入框里的內(nèi)容寫到串口但做得順手需要幾個(gè)配套能力。ASCII 和 Hex 的輸入模式切換是第一層。Hex 模式下輸入AA BB CC發(fā)送時(shí)轉(zhuǎn)成三個(gè)字節(jié)ASCII 模式下輸入什么發(fā)什么。最關(guān)鍵的是收發(fā)模式要獨(dú)立配置不要接收設(shè)成 Hex發(fā)送也跟著 Hex實(shí)際調(diào)試中經(jīng)常出現(xiàn)接收看 Hex、發(fā)送寫 ASCII 的組合場(chǎng)景。第二層是定時(shí)發(fā)送。這個(gè)功能做起來很簡(jiǎn)單一個(gè) QTimer 按設(shè)定間隔觸發(fā)發(fā)送就行。但它非常實(shí)用特別是在調(diào)試設(shè)備的心跳包、周期上報(bào)邏輯時(shí)。需要注意定時(shí)發(fā)送的間隔設(shè)置不能低于串口實(shí)際傳輸耗時(shí)比如一串 20 字節(jié)的數(shù)據(jù)在 9600 波特率下大約需要 20ms你把定時(shí)間隔設(shè)成 10ms底層緩沖區(qū)就會(huì)堆積發(fā)出去的幀會(huì)黏包設(shè)備端根本解析不了。合理做法是間隔設(shè)置大于單幀傳輸時(shí)間必要時(shí)還可以在發(fā)送前清空發(fā)送緩沖區(qū)保證定時(shí)發(fā)包的邊界干凈。第三層是協(xié)議組幀。這部分是我覺得比通用工具順手很多的地方。界面里放一個(gè)簡(jiǎn)單的幀格式配置區(qū)可以定義幀頭、長(zhǎng)度、地址、數(shù)據(jù)區(qū)、CRC 校驗(yàn)位。發(fā)送時(shí)工具自動(dòng)填充長(zhǎng)度和 CRC不需要我每次手動(dòng)算好再粘貼進(jìn)去。比如要用 Modbus RTU 協(xié)議讀寄存器我只需要把從站地址、功能碼 03、寄存器地址、寄存器數(shù)量填好工具自動(dòng)追加 CRC16 校驗(yàn)一條合法的 Modbus 幀就發(fā)出去了。這個(gè)能力對(duì)日常調(diào)試的幫助非常大省去了大量重復(fù)計(jì)算。3.3 數(shù)據(jù)可視化把串口數(shù)據(jù)變成波形串口助手只能看文本但很多場(chǎng)景下我們真正想看到的是傳感器數(shù)值的變化趨勢(shì)比如 PID 調(diào)節(jié)時(shí)反饋值的波動(dòng)、電機(jī)轉(zhuǎn)速的階躍響應(yīng)。這些看文本數(shù)組很難形成直覺波形圖一眼就明白了。v2.0 的波形顯示模塊基于 QCustomPlot 實(shí)現(xiàn)。用法是定期把解析出來的浮點(diǎn)數(shù)值追加到 QCustomPlot 的 graph 數(shù)據(jù)里然后調(diào)用 replot 重繪。這里有一個(gè)性能陷阱如果每收到一個(gè)點(diǎn)就立刻 replot高頻數(shù)據(jù)下 UI 線程會(huì)被拖垮波形圖也容易閃爍。合理做法是開一個(gè) 30ms 左右的定時(shí)器集中把這段時(shí)間內(nèi)收到的點(diǎn)追加進(jìn)去再重繪一次。這樣既保證了波形連續(xù)性又不會(huì)讓重繪開銷失控。解析數(shù)據(jù)時(shí)還要注意字節(jié)序問題。比如設(shè)備上報(bào)兩個(gè)字節(jié)代表一個(gè) int16 的傳感器值是高位在前還是低位在前必須跟設(shè)備的協(xié)議約定對(duì)齊。有的設(shè)備還支持 float 格式上傳那就屬于小端浮點(diǎn)解析邏輯要額外處理。我在這塊做成了可配置的規(guī)則允許設(shè)置數(shù)據(jù)長(zhǎng)度、字節(jié)序、縮放系數(shù)適配不同設(shè)備的上報(bào)格式。4. 下載助手串口 ISP 下載的原理與實(shí)現(xiàn)4.1 ISP 下載到底是怎么回事很多剛開始做嵌入式開發(fā)的朋友對(duì) ISP 下載的理解就是點(diǎn)一下燒錄按鈕程序就進(jìn)去了但對(duì)底層發(fā)生了什么其實(shí)沒有完整概念。寫下載助手之前有必要把這個(gè)機(jī)制拆清楚。STM32 系列芯片內(nèi)部有一段系統(tǒng)存儲(chǔ)器System Memory出廠時(shí)固件里就燒錄了一段 Bootloader 程序。當(dāng)我們把 BOOT0 引腳拉高、BOOT1 引腳拉低然后復(fù)位芯片芯片就會(huì)從系統(tǒng)存儲(chǔ)器啟動(dòng)運(yùn)行這段 Bootloader。這段 Bootloader 支持通過 USART 接收命令實(shí)現(xiàn)讀芯片信息、擦除 Flash、寫入 Flash、跳轉(zhuǎn)運(yùn)行等功能。這就是串口 ISP 下載的底層原理。換個(gè)好理解的說法芯片出廠時(shí)自帶了急救系統(tǒng)你只要把啟動(dòng)開關(guān)撥到急救模式它就開始從串口聽命令允許你重寫它的主程序存儲(chǔ)區(qū)。我自己做的下載助手本質(zhì)上就是把 PC 端命令收發(fā)的這套邏輯實(shí)現(xiàn)完整讓 PC 能跟芯片里的 Bootloader 對(duì)話。4.2 下載流程的關(guān)鍵步驟與實(shí)現(xiàn)實(shí)現(xiàn) ISP 下載核心是走通一套命令交互流程。以 STM32F1 系列為例常用的關(guān)鍵命令包括命令命令碼功能GET0x00獲取 Bootloader 版本和支持的命令列表GET ID0x02讀取芯片 PIDERASE0x43擦除 Flash支持整片擦除WRITE MEMORY0x31寫入數(shù)據(jù)到指定地址READ MEMORY0x11從指定地址讀取數(shù)據(jù)GO0x21跳轉(zhuǎn)到指定地址運(yùn)行完整的下載流程是這樣的第一步是握手。PC 發(fā)送 0x7F芯片 Bootloader 如果在線會(huì)回復(fù)一個(gè)確認(rèn)字節(jié) 0x79。這一步做的是線上握手確認(rèn)芯片確實(shí)處于 ISP 模式波特率、串口連接都沒問題。第二步是讀取版本和芯片 ID。發(fā)送 GET 命令獲取 Bootloader 版本發(fā)送 GET ID 命令讀取芯片 PID。這一步的主要作用是校驗(yàn)確認(rèn)當(dāng)前連接的確實(shí)是目標(biāo)型號(hào)防止固件文件跟芯片型號(hào)不匹配導(dǎo)致寫進(jìn)去跑不了。第三步是擦除。寫入固件之前必須先擦除原來的內(nèi)容否則 Flash 寫入會(huì)失敗。F1 系列支持整片擦除一條命令就行F4 系列按扇區(qū)擦除需要發(fā)多條命令。這里有一個(gè)很實(shí)際的效率考慮如果只升級(jí)一小段代碼按扇區(qū)擦除比重寫整片要快得多。第四步是寫入。把 Hex 或 Bin 文件解析成二進(jìn)制數(shù)據(jù)按 256 字節(jié)一頁切分逐頁發(fā)送 WRITE MEMORY 命令。每寫完一頁芯片會(huì)返回應(yīng)答PC 端收到應(yīng)答后再寫下一頁。第五步是校驗(yàn)。校驗(yàn)的方式可以是多少讀回部分?jǐn)?shù)據(jù)和原文件比對(duì)也可以在寫入前對(duì)每頁數(shù)據(jù)做校驗(yàn)和計(jì)算。校驗(yàn)通過后把 BOOT0 拉回低電平復(fù)位芯片芯片就會(huì)從用戶 Flash 啟動(dòng)下載流程完成。下面是一個(gè)簡(jiǎn)化的偽代碼流程展示核心命令交互邏輯// 簡(jiǎn)化版 ISP 下載流程 bool FwDownloader::download(const QByteArray firmware) { // 1. 握手發(fā)送 0x7F等待 0x79 應(yīng)答 serial-write(\x7F); if (readAck() ! 0x79) return false; // 2. 獲取版本和芯片 ID sendCommand(0x00); // GET sendCommand(0x02); // GET ID uint16_t pid readPid(); if (pid ! expectedPid) return false; // 3. 整片擦除 sendCommand(0x43); sendCommand(0xFF); if (readAck() ! 0x79) return false; // 4. 按頁寫入 for (int addr 0; addr firmware.size(); addr 256) { if (!writePage(addr, firmware.mid(addr, 256))) { return false; } } // 5. 跳轉(zhuǎn)到用戶程序 sendCommand(0x21); sendCommand(0x08, 0x00, 0x00, 0x00); // 用戶 Flash 起始地址 return true; }4.3 實(shí)際下載中踩過的坑實(shí)現(xiàn)下載助手的過程中我踩過幾個(gè)非常典型的坑每一個(gè)都值得拿出來講。第一個(gè)坑是握手時(shí)序。第一次實(shí)現(xiàn)時(shí)我發(fā)送完 0x7F 后立刻等待應(yīng)答經(jīng)常超時(shí)。后來排查發(fā)現(xiàn)芯片從復(fù)位到 Bootloader 完全啟動(dòng)需要一點(diǎn)時(shí)間復(fù)位信號(hào)釋放后立刻發(fā) 0x7F 往往發(fā)早了。解決辦法是復(fù)位引腳拉低后保持一段時(shí)間我設(shè)了 100ms 左右再拉高然后延時(shí) 200ms 左右再發(fā)握手命令。這個(gè)時(shí)序要根據(jù)具體板子的復(fù)位電路微調(diào)但核心思路是一致的要給芯片留足啟動(dòng)時(shí)間。第二個(gè)坑是 USB 轉(zhuǎn)串口芯片的緩沖延遲。PC 端用 USB 轉(zhuǎn)串口芯片比如 CH340、CP2102跟設(shè)備通信時(shí)數(shù)據(jù)會(huì)經(jīng)過 USB 層的緩沖不是每個(gè)字節(jié)都立刻送達(dá)。下載過程中如果 PC 發(fā)送命令后立刻等待字節(jié)級(jí)應(yīng)答容易因?yàn)榫彌_延遲而誤判超時(shí)。解決辦法是把應(yīng)答等待的超時(shí)時(shí)間放寬到幾百毫秒同時(shí)用 readAll 一次把緩沖區(qū)里的數(shù)據(jù)都讀出來再解析而不是逐字節(jié)等。第三個(gè)坑是寫入過程中的校驗(yàn)。通信出錯(cuò)、波特率不匹配、信號(hào)干擾都可能導(dǎo)致某頁寫進(jìn)去的數(shù)據(jù)是錯(cuò)的。如果下載工具不做任何校驗(yàn)芯片可能帶病運(yùn)行問題排查時(shí)非常頭疼。我在每一頁寫入后增加了一個(gè)簡(jiǎn)單的校驗(yàn)和比對(duì)PC 端計(jì)算發(fā)送數(shù)據(jù)的校驗(yàn)和寫入后發(fā)送校驗(yàn)命令讀取芯片端計(jì)算結(jié)果兩邊一致才繼續(xù)下一頁。這樣下載的可靠性提高了一大截。5. 穩(wěn)定性與兼容性的血淚經(jīng)驗(yàn)5.1 串口熱插拔與丟失問題串口調(diào)試工具用得多了一定會(huì)遇到串口號(hào)消失或者設(shè)備被占用的場(chǎng)景。USB 轉(zhuǎn)串口設(shè)備拔掉再插回去系統(tǒng)可能分配一個(gè)新的 COM 口號(hào)如果工具沒做熱插拔檢測(cè)用戶就得自己手動(dòng)重新選擇串口非常影響體驗(yàn)。我的處理辦法是在界面里維護(hù)一個(gè)串口列表刷新的邏輯用 QSerialPortInfo::availablePorts 定時(shí)掃描當(dāng)前系統(tǒng)里可用的串口發(fā)現(xiàn)新設(shè)備加入就把新串口加到下拉框里設(shè)備拔出就從下拉框里移除。掃描間隔設(shè) 1 到 2 秒就夠太頻繁沒必要。還有個(gè)細(xì)節(jié)是如果當(dāng)前正在使用的串口被拔掉了要彈提示并且自動(dòng)把打開狀態(tài)復(fù)位防止后續(xù)寫入報(bào)一堆錯(cuò)誤。設(shè)備被占用是另一個(gè)高頻問題。打開串口失敗時(shí)QSerialPort 會(huì)返回 PermissionError原因通常是該串口已經(jīng)被另一個(gè)軟件占用。遇到這種情況我做的處理是彈一個(gè)清晰的中文提示告訴用戶串口被占用請(qǐng)關(guān)閉其他串口工具而不是只顯示一個(gè)冷冰冰的錯(cuò)誤碼。這個(gè)小細(xì)節(jié)能幫用戶省不少排查時(shí)間。5.2 不同 USB 轉(zhuǎn)串口芯片的行為差異做下載助手之后我意識(shí)到不同品牌的 USB 轉(zhuǎn)串口芯片在行為上差異很大。CH340 成本最低驅(qū)動(dòng)裝好后用起來沒問題但在持續(xù)高速傳輸時(shí)的穩(wěn)定性不如 FT232CP2102 介于兩者之間多數(shù)場(chǎng)景下夠用FT232 最穩(wěn)但價(jià)格也最貴。我平時(shí)測(cè)試用 CH340 居多但遇到下載反復(fù)失敗的板子換一根 FT232 的線往往能直接解決。這確實(shí)是一個(gè)容易忽略的硬件因素。寫軟件時(shí)能做的兼容性工作主要是兩塊。一個(gè)是超時(shí)時(shí)間不要寫死做成可配置項(xiàng)默認(rèn)值給一個(gè)比較寬容的區(qū)間因?yàn)椴煌酒瑯蚪訋淼难舆t差別很大。另一個(gè)是在通信出錯(cuò)時(shí)給出更友好的提示比如發(fā)送數(shù)據(jù)超時(shí)可嘗試降低波特率。5.3 配置保存與日志管理頻繁使用的工具每次打開都要重新選一遍波特率、重新勾選 Hex 模式體驗(yàn)會(huì)非常差。v2.0 里的做法是用 QSettings 把界面配置自動(dòng)保存到本地關(guān)閉時(shí)寫、啟動(dòng)時(shí)讀。串口號(hào)、波特率、數(shù)據(jù)位、校驗(yàn)方式、Hex 顯示開關(guān)、定時(shí)發(fā)送間隔、窗口位置大小這些都保存下來。重新打開工具界面恢復(fù)成上次關(guān)閉時(shí)的樣子省去了每次重新配置的麻煩。日志方面我實(shí)現(xiàn)了兩種保存方式。一種是手動(dòng)保存當(dāng)前接收區(qū)內(nèi)容為 txt 文件另一種是實(shí)時(shí)記錄模式和自動(dòng)輪轉(zhuǎn)模式把帶時(shí)間戳的收發(fā)數(shù)據(jù)按日期存到日志目錄單文件超過設(shè)定大小自動(dòng)滾動(dòng)到下一個(gè)文件。后者在長(zhǎng)時(shí)間跑穩(wěn)定性測(cè)試時(shí)非常有用跑一個(gè)晚上第二天直接看日志文件不需要一直盯著屏幕。6. 這個(gè)工具后續(xù)還能怎么擴(kuò)展v2.0 做下來最深的體會(huì)是這種個(gè)人工具最值錢的地方不是功能多而是跟自己的工作流貼合緊密。每次被現(xiàn)有工具卡住產(chǎn)生要是它能這樣就好了的念頭時(shí)就是給自己工具加功能的最好時(shí)機(jī)。我目前已經(jīng)在計(jì)劃中的擴(kuò)展方向有三個(gè)。第一個(gè)是網(wǎng)絡(luò)透?jìng)靼汛跀?shù)據(jù)轉(zhuǎn)發(fā)到 TCP 服務(wù)端這樣調(diào)試設(shè)備時(shí)人不用守在設(shè)備旁邊遠(yuǎn)程也能看到串口數(shù)據(jù)。第二個(gè)是更完整的 Modbus 協(xié)議解析目前只做了基礎(chǔ)組幀后續(xù)想把設(shè)備返回的寄存器數(shù)據(jù)直接解析成可讀的工程值并顯示成表格。第三個(gè)是支持自定義腳本把一些固定的調(diào)試動(dòng)作寫成 Lua 腳本自動(dòng)執(zhí)行相當(dāng)于給工具加上輕量級(jí)的自動(dòng)化能力。如果這篇文章能幫你搞清楚串口工具內(nèi)部的幾個(gè)關(guān)鍵機(jī)制或者說服你也動(dòng)手寫一個(gè)符合自己習(xí)慣的小工具那這篇分享就算值了。工具不在于大順手才是關(guān)鍵。本文還有配套的精品資源點(diǎn)擊獲取