試助手從零實(shí)現(xiàn)：串口通信與App Designer實(shí)戰(zhàn))
簡(jiǎn)介本資源是一套基于MATLAB開(kāi)發(fā)的串口調(diào)試助手完整源碼及配套實(shí)踐教程面向嵌入式初學(xué)者、自動(dòng)化專(zhuān)業(yè)學(xué)生及MATLAB工程實(shí)踐者旨在解決硬件設(shè)備如Arduino、樹(shù)莓派與PC端串口通信調(diào)試門(mén)檻高、GUI開(kāi)發(fā)復(fù)雜等實(shí)際問(wèn)題。壓縮包共8個(gè)文件7.21MB包含核心MATLAB源碼.m、GUI界面文件.fig、配置文件.ini、日志記錄.log、說(shuō)明文檔.txt及可執(zhí)行程序.exe其中.m與.fig文件構(gòu)成可運(yùn)行的圖形化調(diào)試界面支持波特率設(shè)置、數(shù)據(jù)收發(fā)、定時(shí)輪詢(xún)與錯(cuò)誤處理等完整功能。已有1194人學(xué)習(xí)下載資源附帶詳細(xì)串口通信知識(shí)點(diǎn)解析涵蓋Serial對(duì)象創(chuàng)建、fopen/fwrite/fgets調(diào)用規(guī)范、GUIDE界面回調(diào)邏輯及timer定時(shí)讀取機(jī)制特別適合從零掌握MATLAB串口通信開(kāi)發(fā)流程并可直接修改源碼適配不同硬件協(xié)議。1. MATLAB串口調(diào)試助手先搞清它能干什么做嵌入式、儀器控制、硬件調(diào)試的兄弟多半都有過(guò)這種經(jīng)歷手邊沒(méi)有趁手的串口工具要么打開(kāi)SSCOM、XCOM這種老牌小軟件要么自己拿Python的pyserial臨時(shí)拼一個(gè)。但如果你恰好是MATLAB的重度用戶項(xiàng)目里已經(jīng)在用MATLAB做信號(hào)處理、數(shù)據(jù)分析和可視化那再開(kāi)一個(gè)串口調(diào)試助手直接用MATLAB寫(xiě)一套源代碼其實(shí)是很順理成章的事。我最初做這個(gè)項(xiàng)目就是為了在采集傳感器數(shù)據(jù)的同時(shí)直接在MATLAB里完成濾波、FFT分析和波形繪制省掉“串口工具導(dǎo)出文件 - 再導(dǎo)入MATLAB”這一步體驗(yàn)完全不一樣。這套MATLAB串口調(diào)試助手本質(zhì)上是一個(gè)帶圖形界面的串口通信工具核心功能包括掃描可用串口、配置波特率/數(shù)據(jù)位/校驗(yàn)位/停止位、打開(kāi)關(guān)閉串口、實(shí)時(shí)接收數(shù)據(jù)并顯示、按幀解析數(shù)據(jù)、手動(dòng)發(fā)送指令、自動(dòng)發(fā)送、數(shù)據(jù)保存為文件、實(shí)時(shí)繪圖。聽(tīng)起來(lái)和市面上現(xiàn)成的串口調(diào)試助手差不多但用MATLAB源碼實(shí)現(xiàn)的好處是你可以完全掌控協(xié)議解析邏輯能直接調(diào)用MATLAB強(qiáng)大的數(shù)值計(jì)算與繪圖工具箱還能把收到的數(shù)據(jù)立刻喂給算法模型去做處理。適合誰(shuí)來(lái)參考如果你是學(xué)生、工程師正在做單片機(jī)/嵌入式項(xiàng)目或者需要控制程控電源、溫控器、下位機(jī)等串口設(shè)備同時(shí)對(duì)MATLAB有一定基礎(chǔ)那這篇內(nèi)容會(huì)很對(duì)胃口。即使你只是對(duì)串口通信原理感興趣也可以跟著源碼把機(jī)制弄清楚。我會(huì)從底層原理講到界面實(shí)現(xiàn)最后把調(diào)試中常見(jiàn)的坑翻出來(lái)逐個(gè)說(shuō)明盡量讓你能照著代碼敲出一個(gè)能用的工具而不是給你一個(gè)只能看不能用的半成品。2. 串口通信核心參數(shù)與MATLAB串口對(duì)象配置2.1 串口通信的關(guān)鍵參數(shù)你到底在配什么串口通信UART/RS232/RS485之所以看起來(lái)簡(jiǎn)單是因?yàn)樗且粭l“按位傳輸”的物理鏈路。發(fā)送方和接收方必須約定好“每個(gè)數(shù)據(jù)包的節(jié)奏”否則收到的就是一堆亂碼。這個(gè)節(jié)奏由四個(gè)基礎(chǔ)參數(shù)決定波特率、數(shù)據(jù)位、停止位、校驗(yàn)位。波特率表示每秒傳輸多少個(gè)符號(hào)bit/s常見(jiàn)的有9600、115200、460800等。它決定了每一位的持續(xù)時(shí)間。發(fā)送方和接收方波特率必須一致差一點(diǎn)點(diǎn)都會(huì)導(dǎo)致采樣錯(cuò)誤。比如你設(shè)9600設(shè)備設(shè)9600但兩邊晶振都有誤差長(zhǎng)時(shí)間傳輸就會(huì)積累出幀偏移。數(shù)據(jù)位通常是8位代表一個(gè)數(shù)據(jù)字節(jié)也有7位用于ASCII通信。停止位是標(biāo)識(shí)一個(gè)數(shù)據(jù)幀結(jié)束的電平持續(xù)時(shí)間常見(jiàn)的是1位或2位。校驗(yàn)位用來(lái)做簡(jiǎn)易差錯(cuò)檢測(cè)可選None、Odd、Even。現(xiàn)在的多數(shù)設(shè)備都是“8N1”也就是8個(gè)數(shù)據(jù)位、無(wú)校驗(yàn)、1位停止位這個(gè)組合在MATLAB里配置最省事。除這四個(gè)參數(shù)之外還有一個(gè)容易被忽略的流控Flow Controlnone、hardware、software。單片機(jī)設(shè)備大多不用流控但如果你接的是老式調(diào)制解調(diào)器或某些儀器可能要用硬件流控RTS/CTS或軟件流控XON/XOFF。MATLAB的serialport對(duì)象支持配置FlowControl默認(rèn)是none。在動(dòng)手寫(xiě)代碼前第一件事就是去查設(shè)備手冊(cè)確認(rèn)這幾個(gè)參數(shù)。千萬(wàn)別想當(dāng)然我見(jiàn)過(guò)一個(gè)兄弟把儀器的停止位配錯(cuò)折騰了整整一天最后發(fā)現(xiàn)就是一位之差。2.2 用serialport還是serial這是一個(gè)問(wèn)題MATLAB里有兩套串口接口老版的serial屬于Instrument Control Toolbox的舊接口配合fopen/fread/fprintf使用以及新版推薦的serialport從R2019b起引入采用面向?qū)ο箫L(fēng)格配置和讀取都更簡(jiǎn)潔。如果你還沒(méi)開(kāi)始寫(xiě)建議直接使用serialport不要再用serial。兩者的區(qū)別可以這樣理解serial是老式的“命令式”驅(qū)動(dòng)需要先f(wàn)open打開(kāi)用fread/fscanf讀數(shù)據(jù)用fwrite/fprintf寫(xiě)數(shù)據(jù)用fclose關(guān)閉還要操心BufferSize、BytesAvailableFcn等屬性。而serialport則是“對(duì)象式”的創(chuàng)建對(duì)象時(shí)參數(shù)一次性寫(xiě)入讀取用read寫(xiě)入用write配置readAsync和callback函數(shù)也更容易還支持自動(dòng)檢測(cè)設(shè)備斷開(kāi)。從MATLAB R2021b開(kāi)始官方已經(jīng)很少再推薦serial接口雖然它還能用但新功能都不往上面加了。如果你看到網(wǎng)上老教程還在用serial可以看但要清楚那是歷史遺留寫(xiě)法。我現(xiàn)在的代碼模板是這樣創(chuàng)建serialport對(duì)象的% 創(chuàng)建串口對(duì)象 s serialport(COM3, 115200); % 配置數(shù)據(jù)位默認(rèn)8可不寫(xiě) s.DataBits 8; % 校驗(yàn)位可以是 none / odd / even s.Parity none; % 停止位可以是 1 / 1.5 / 2 s.StopBits 1; % 關(guān)閉流控 s.FlowControl none; % 設(shè)置讀取超時(shí) s.Timeout 2;在創(chuàng)建對(duì)象時(shí)如果該串口已被其他程序占用MATLAB會(huì)直接報(bào)錯(cuò)。這也是很多人遇到的第一個(gè)坑。后面我會(huì)專(zhuān)門(mén)說(shuō)排查方法。2.3 數(shù)據(jù)讀取的三種方式以及回調(diào)函數(shù)怎么設(shè)計(jì)serialport對(duì)象讀取數(shù)據(jù)主要有三種方式阻塞讀取、輪詢(xún)讀取、異步回調(diào)讀取。阻塞讀取就是直接調(diào)用read或readline讀不夠指定字節(jié)數(shù)就一直等直到超時(shí)。這種方式適合在腳本里用比如測(cè)試時(shí)抓一幀數(shù)據(jù)。輪詢(xún)讀取是在循環(huán)里不斷查詢(xún)可讀字節(jié)數(shù)再手動(dòng)read適合簡(jiǎn)單的命令行腳本。異步回調(diào)讀取是最適合圖形界面GUI的方式它通過(guò)配置BytesAvailableFcnMode可以是byte或terminator和BytesAvailableFcnCount來(lái)觸發(fā)回調(diào)函數(shù)當(dāng)串口緩沖區(qū)內(nèi)累積到指定字節(jié)數(shù)或收到指定結(jié)束符時(shí)MATLAB會(huì)自動(dòng)調(diào)用回調(diào)函數(shù)處理數(shù)據(jù)。以接收“以換行符0x0A結(jié)尾的一幀數(shù)據(jù)”為例可以這樣配置s.BytesAvailableFcnMode terminator; s.Terminator LF; % 也可以寫(xiě)成 char(10) s.BytesAvailableFcn onSerialData;回調(diào)函數(shù)onSerialData的簽名必須是兩個(gè)輸入?yún)?shù)function onSerialData(src, ~) % src是serialport對(duì)象 data readline(src); % 處理data disp(data); endreadline會(huì)一直讀到終止符包含終止符并返回文本行。如果是二進(jìn)制幀則建議用byte模式設(shè)置ByteAvailableFcnCount等于一幀長(zhǎng)度再用read讀取指定字節(jié)數(shù)。這兩種模式我在實(shí)際項(xiàng)目里都用過(guò)文本協(xié)議用terminator非常方便二進(jìn)制協(xié)議用byte模式更穩(wěn)。回調(diào)函數(shù)的執(zhí)行頻率取決于數(shù)據(jù)量和數(shù)據(jù)處理速度如果處理太慢回調(diào)可能會(huì)錯(cuò)過(guò)數(shù)據(jù)或者造成界面卡頓這點(diǎn)在繪圖時(shí)尤其明顯后面一起說(shuō)。3. 源代碼實(shí)現(xiàn)從零搭建一個(gè)可用版本3.1 界面布局用App Designer快速搭一個(gè)能看的GUIMATLAB里做GUI有兩套主流方案老式GUIDE已不推薦和App Designer。App Designer從R2016a開(kāi)始引入界面更現(xiàn)代代碼結(jié)構(gòu)更清晰強(qiáng)烈建議用它。這個(gè)串口調(diào)試助手的界面不需要花哨能實(shí)現(xiàn)功能為主。我建議這樣分區(qū)串口配置面板串口選擇下拉框、刷新按鈕、波特率下拉框、數(shù)據(jù)位/校驗(yàn)位/停止位下拉框、打開(kāi)/關(guān)閉串口按鈕。接收數(shù)據(jù)顯示區(qū)一個(gè)多行文本框TextArea用來(lái)顯示字符數(shù)據(jù)配合一個(gè)“清空顯示”按鈕。發(fā)送區(qū)域一個(gè)單行文本框輸入要發(fā)送的內(nèi)容一個(gè)“發(fā)送”按鈕一個(gè)發(fā)送模式選擇文本/HEX。可選區(qū)域一個(gè)“自動(dòng)發(fā)送”復(fù)選框和間隔時(shí)間輸入框“保存數(shù)據(jù)”按鈕實(shí)時(shí)繪圖區(qū)域用UIAxes繪制。用App Designer創(chuàng)建后代碼會(huì)自動(dòng)生成類(lèi)的骨架。我們需要在startupFcn里掃描串口、填充下拉框。掃描串口可以直接用serialportlist函數(shù)function startupFcn(app) app.PortDropDown.Items serialportlist(available); app.BaudRateDropDown.Items [1200, 2400, 4800, 9600, 19200, 38400, 115200, 460800]; app.BaudRateDropDown.Value 115200; app.BaudRateDropDown.Items [1200,2400,4800,9600,19200,38400,115200,460800]; % 默認(rèn)選擇115200 app.BaudRateDropDown.Value 115200; end注意一點(diǎn)serialportlist(available)返回的是當(dāng)前未被占用的端口列表。如果你希望看到所有存在的端口不管是否被占用可以用serialportlist(all)。但打開(kāi)時(shí)如果端口被占用還是會(huì)報(bào)錯(cuò)所以用available更省心。界面布局還有個(gè)容易被忽略的點(diǎn)App Designer的UIAxes繪圖性能會(huì)比普通figure的axes慢一些因?yàn)榈讓邮褂昧薈anvas渲染。如果你對(duì)繪圖實(shí)時(shí)性要求極高可以用figureaxes的組合在回調(diào)里更新繪圖句柄。但作為串口調(diào)試助手UIAxes足夠用。后續(xù)如果發(fā)現(xiàn)繪圖卡頓再改也不遲。3.2 核心代碼打開(kāi)/關(guān)閉串口與數(shù)據(jù)收發(fā)打開(kāi)串口的邏輯是從下拉框讀取用戶選擇的端口號(hào)和參數(shù)創(chuàng)建serialport對(duì)象并配置回調(diào)。關(guān)閉串口則是delete對(duì)象并清空句柄同時(shí)把“關(guān)閉”按鈕狀態(tài)改回“打開(kāi)”。我寫(xiě)了一個(gè)類(lèi)中的私有函數(shù)來(lái)處理function openSerial(app) if ~isempty(app.s) delete(app.s); app.s []; end port app.PortDropDown.Value; baud str2double(app.BaudRateDropDown.Value); dataBits str2double(app.DataBitsDropDown.Value); parity app.ParityDropDown.Value; % none/odd/even stopBits str2double(app.StopBitsDropDown.Value); try app.s serialport(port, baud); app.s.DataBits dataBits; app.s.Parity lower(parity); % 小寫(xiě) app.s.StopBits stopBits; app.s.Timeout 2; % 接收回調(diào) app.s.BytesAvailableFcnMode terminator; app.s.Terminator LF; app.s.BytesAvailableFcn app.onReceiveData; app.OpenButton.Text 關(guān)閉串口; app.StatusLabel.Text sprintf(已打開(kāi): %s %d, port, baud); catch ME app.StatusLabel.Text 打開(kāi)失敗: ME.message; app.OpenButton.Text 打開(kāi)串口; app.s []; end end這里我把回調(diào)綁定到app.onReceiveData意味著回調(diào)函數(shù)是App類(lèi)的方法。App Designer中如果方法用“private”訪問(wèn)級(jí)別就可以在屬性中用app.func語(yǔ)法引用。回調(diào)里需要讀取數(shù)據(jù)并追加到TextArea同時(shí)做HEX/文本顯示轉(zhuǎn)換。接收文本數(shù)據(jù)function onReceiveData(app, src, ~) % 因?yàn)樵O(shè)定了terminator模式可以用readline讀取一行 line readline(src); uploadTime datetime(now, Format, HH:mm:ss.SSS); % 在文本框中追加顯示 displayText sprintf([%s] %s, uploadTime, line); app.ReceiveTextArea.Value char(strcat(string(app.ReceiveTextArea.Value), ... string(newline), string(displayText))); % 把最新數(shù)據(jù)存起來(lái)供后續(xù)解析或保存 app.lastLine char(line); end如果你收到的是二進(jìn)制幀則不建議用readline而是設(shè)成byte模式app.s.BytesAvailableFcnMode byte; app.s.BytesAvailableFcnCount frameLen; % 已知幀長(zhǎng) app.s.BytesAvailableFcn app.onReceiveBinary;然后在回調(diào)里用read固定字節(jié)數(shù)function onReceiveBinary(app, src, ~) data read(src, app.frameLen, uint8); % 處理 data end發(fā)送數(shù)據(jù)比較簡(jiǎn)單發(fā)送文本和HEX兩種模式。文本模式直接writeHEX模式需要先把用戶輸入的十六進(jìn)制字符串轉(zhuǎn)成字節(jié)數(shù)組function sendData(app, str, isHex) if isempty(app.s) return; end if isHex % 去除空格 cleanStr strrep(str, , ); if mod(length(cleanStr), 2) ~ 0 uialert(app.UIFigure, HEX字符串長(zhǎng)度必須為偶數(shù), 輸入錯(cuò)誤); return; end bytes uint8(hex2dec(reshape(cleanStr, 2, []))); write(app.s, bytes, uint8); else write(app.s, str, char); end endHEX發(fā)送有一個(gè)細(xì)節(jié)如果用戶輸入AA BB CC你應(yīng)該先去掉所有空格再判斷字符個(gè)數(shù)是否為偶數(shù)然后每?jī)蓚€(gè)字符轉(zhuǎn)一個(gè)字節(jié)。使用reshape(cleanStr, 2, [])可以將長(zhǎng)度為偶數(shù)的字符數(shù)組變成N行2列再用hex2dec轉(zhuǎn)換為十進(jìn)制值最后轉(zhuǎn)uint8。注意hex2dec每行最多能轉(zhuǎn)換的位數(shù)有限但對(duì)于一幀幾十字節(jié)的數(shù)據(jù)沒(méi)問(wèn)題。如果想批量發(fā)送也可以改用循環(huán)。3.3 數(shù)據(jù)解析如何應(yīng)對(duì)可變長(zhǎng)或不規(guī)則的幀很多設(shè)備發(fā)送的并不是一行一行的文本而是一組十六進(jìn)制字節(jié)比如幀頭0xAA、幀頭0x55、命令字、數(shù)據(jù)長(zhǎng)度、數(shù)據(jù)、校驗(yàn)和、幀尾0x0A。如果只按行接收就不能正確處理。這里我推薦兩個(gè)方法基于“幀長(zhǎng)固定”的解析通過(guò)BytesAvailableFcnCount 幀長(zhǎng)每次回調(diào)讀取固定字節(jié)數(shù)然后解析。適合所有幀長(zhǎng)度一致的情況比如有些模塊每次返回8字節(jié)狀態(tài)幀。基于幀頭幀尾的緩沖解析在terminator模式下無(wú)法處理得改成“byte”模式每次讀取所有可用字節(jié)然后放入一個(gè)持久化緩沖數(shù)組中在緩沖區(qū)內(nèi)查找?guī)^幀尾并提取完整幀。這種方式更通用。我實(shí)際用的解析函數(shù)大概是這樣偽代碼邏輯function parseBinaryFrame(app, bytes) % 將新數(shù)據(jù)追加到內(nèi)部緩沖區(qū) app.buffer [app.buffer, bytes]; while true startIdx find(app.buffer app.frameHeader, 1); if isempty(startIdx) app.buffer []; % 沒(méi)有幀頭則清空 break; end if length(app.buffer) startIdx 2 break; % 長(zhǎng)度字段還沒(méi)收全 end dataLen app.buffer(startIdx 2); frameLen 4 dataLen 1; % 假設(shè)幀頭(2)長(zhǎng)度(1)數(shù)據(jù)(dataLen)校驗(yàn)(1)幀尾(1) if length(app.buffer) startIdx frameLen - 1 break; % 等待完整幀 end frame app.buffer(startIdx:startIdx frameLen - 1); if frame(end) app.frameTail % 校驗(yàn)和驗(yàn)證假設(shè)校驗(yàn)和為除幀尾外所有字節(jié)的和的低8位 checksum mod(sum(frame(1:end-2)), 256); if checksum frame(end-1) % 解析成功提取數(shù)據(jù)部分 parsedData frame(4:end-2); % 更新界面調(diào)用上位數(shù)據(jù)處理函數(shù) app.parseData(parsedData); else disp(校驗(yàn)和錯(cuò)誤); end end % 緩沖區(qū)向前移動(dòng) app.buffer app.buffer(startIdxframeLen:end); end end這里只是一個(gè)簡(jiǎn)化版寫(xiě)法真實(shí)設(shè)備可能還有“數(shù)據(jù)小端/大端”的問(wèn)題需要你用typecast函數(shù)轉(zhuǎn)換。比如收到兩個(gè)字節(jié)表示一個(gè)int16如果設(shè)備是大端模式那就需要先swapbytes再typecast為int16。這些細(xì)節(jié)建議在解析函數(shù)里專(zhuān)門(mén)做一層“字節(jié)序轉(zhuǎn)換”不要散落在主流程里。3.4 數(shù)據(jù)保存與實(shí)時(shí)繪圖把接收到的數(shù)據(jù)記錄到文件最簡(jiǎn)單的方式是用fopen/fprintf在回調(diào)里逐行寫(xiě)入。但如果回調(diào)頻率很高建議累積到一定數(shù)量再批量寫(xiě)入避免頻繁打開(kāi)關(guān)閉文件。通常做法是打開(kāi)串口時(shí)初始化一個(gè)文件句柄關(guān)閉串口時(shí)關(guān)閉它。function startLog(app, filename) app.logFid fopen(filename, a); if app.logFid -1 error(無(wú)法創(chuàng)建日志文件); end end function stopLog(app) if app.logFid ~ -1 fclose(app.logFid); app.logFid -1; end end在onReceiveData回調(diào)中把收到的行加上時(shí)間戳寫(xiě)入文件。為了性能我一般不會(huì)每行都flush而是利用fprintf默認(rèn)的緩沖機(jī)制關(guān)閉時(shí)fclose就會(huì)寫(xiě)盤(pán)。實(shí)時(shí)繪圖則可以使用animatedline對(duì)象它比重復(fù)plot更新更高效。舉個(gè)例子在App類(lèi)里初始化app.plotLine animatedline(app.UIAxes, Color, b, LineWidth, 1);在回調(diào)中更新x now; % 或用計(jì)數(shù)器 y str2double(line); % 假設(shè)收到的是數(shù)值 addpoints(app.plotLine, x, y); drawnow limitrate;drawnow limitrate是MATLAB提供的一種降低繪圖刷新頻率的方法它最多每秒刷新20次左右可以防止界面被繪圖拖垮。如果數(shù)據(jù)量很大比如采樣率1kHz以上建議只繪制最新N個(gè)點(diǎn)或者先存入數(shù)組每隔一定時(shí)間批量更新一次避免每次回調(diào)都重新繪制。4. 實(shí)操中常見(jiàn)的坑與排查技巧4.1 打不開(kāi)串口、端口號(hào)沒(méi)顯示這是出現(xiàn)頻率最高的問(wèn)題。常見(jiàn)原因有三個(gè)串口被其他軟件占用。比如設(shè)備廠商的配置工具、SSCOM、XCOM甚至上一個(gè)沒(méi)被正確關(guān)閉的MATLAB程序。MATLAB里如果上一次運(yùn)行打開(kāi)了serialport對(duì)象但沒(méi)有delete對(duì)象還留在工作區(qū)端口就仍然被占用。排查方法是執(zhí)行clear all或close或者用instrfind清理instrfindall delete(instrfindall)端口號(hào)變化。USB轉(zhuǎn)串口設(shè)備在不同電腦、不同USB口插拔后COM號(hào)會(huì)變。可以在Windows設(shè)備管理器里查看“端口(COM和LPT)”確認(rèn)當(dāng)前端口號(hào)。或者在MATLAB里用serialportlist(all)看所有端口。權(quán)限不足Linux。在Linux下普通用戶可能沒(méi)有/dev/ttyUSB0的讀寫(xiě)權(quán)限。需要加用戶到dialout組或用sudo運(yùn)行MATLAB。不建議長(zhǎng)期用sudo正確做法是sudo usermod -a -G dialout 你的用戶名然后重新登錄。如果MATLAB報(bào)錯(cuò)“Unable to connect to the serial port: Port is not available”八成是上面三種情況之一。注意serialportlist(available)只會(huì)列出未被占用的端口當(dāng)你的設(shè)備被其他軟件占用它可能完全不顯示容易誤以為驅(qū)動(dòng)沒(méi)裝好。4.2 數(shù)據(jù)亂碼、顯示異常亂碼問(wèn)題要區(qū)分是“顯示亂碼”還是“傳輸數(shù)據(jù)本身錯(cuò)誤”。如果是顯示亂碼比如接收框里出現(xiàn)方塊或問(wèn)號(hào)先檢查是不是編碼問(wèn)題。很多下位機(jī)發(fā)送的是GBK編碼的中文MATLAB默認(rèn)使用UTF-8解讀字符串必然亂碼。簡(jiǎn)單的處理方式在帶字符集轉(zhuǎn)換中用native2unicode和unicode2native轉(zhuǎn)換。收到字節(jié)數(shù)組后可以嘗試line char(native2unicode(line, GBK))。如果只是簡(jiǎn)單ASCII那就不會(huì)有亂碼。如果是“數(shù)據(jù)對(duì)不上”比如發(fā)0xAA收到0xC2 0xAA這通常是因?yàn)榘讯M(jìn)制字節(jié)用文本方式打開(kāi)了或者發(fā)送端和接收端的數(shù)據(jù)位數(shù)不一致。還有一個(gè)很隱蔽的問(wèn)題串口調(diào)試助手里的“HEX顯示”與“HEX發(fā)送”需要分別設(shè)置。如果你只設(shè)置了HEX發(fā)送但接收顯示為文本打印出來(lái)的就是不可讀字符。我的建議是調(diào)試底層協(xié)議時(shí)一律用HEX顯示模式方便核對(duì)幀格式確認(rèn)無(wú)誤后再切換文本模式。另外檢查一下串口線是否完整。現(xiàn)在很多USB轉(zhuǎn)TTL模塊只有TX、RX、GND三根線有的模塊需要短接RTS/CTS才可通信。如果收發(fā)雙方共地沒(méi)接好會(huì)出現(xiàn)數(shù)據(jù)偶爾丟字節(jié)、亂碼頻率很高的情況。信號(hào)地沒(méi)接是串口通信“玄學(xué)故障”的頭號(hào)原因。4.3 回調(diào)不觸發(fā)或界面卡死回調(diào)用terminator模式不觸發(fā)常見(jiàn)是下位機(jī)發(fā)的換行符不是LF而是CR或者是CRLF。MATLAB中串口終止符默認(rèn)為L(zhǎng)F如果數(shù)據(jù)以回車(chē)符結(jié)尾自然讀不到一行。解決辦法是把Terminator設(shè)置為CR/LF或者設(shè)置成CR甚至設(shè)置成char(13)。如果你不確定可以在“byte”模式下read所有數(shù)據(jù)然后手動(dòng)解析。界面卡死的原因多半是回調(diào)函數(shù)里做了太重的工作比如在回調(diào)里執(zhí)行plot或者在回調(diào)中用了uialert這是非常影響性能的。App Designer的回調(diào)運(yùn)行在UI線程上如果數(shù)據(jù)處理耗時(shí)過(guò)長(zhǎng)界面會(huì)像死掉一樣。避免方法回調(diào)里只做數(shù)據(jù)入隊(duì)和簡(jiǎn)單解析復(fù)雜的處理放到timer或者后臺(tái)任務(wù)。MATLAB從R2019a開(kāi)始支持parfeval和backgroundPool可以把數(shù)據(jù)處理放到后臺(tái)線程。但是要注意UIAxes和控件操作不能在非UI線程中執(zhí)行所以最終更新界面必須回到UI線程。我的方案是回調(diào)里先解析數(shù)值存到一個(gè)隊(duì)列再用uialarm或者timer定時(shí)刷新界面。4.4 保存文件失敗、數(shù)據(jù)丟失保存數(shù)據(jù)時(shí)文件如果被Excel或其他程序打開(kāi)fopen會(huì)返回-1日志寫(xiě)不進(jìn)去。打開(kāi)串口時(shí)最好先設(shè)置好日志文件路徑并給用戶明確提示。另外如果程序異常退出fclose可能未執(zhí)行數(shù)據(jù)緩沖在內(nèi)存里丟掉了。可以在App的CloseRequestFcn里統(tǒng)一清理function closeRequest(app) stopLog(app); if ~isempty(app.s) delete(app.s); end delete(app.UIFigure); end數(shù)據(jù)丟失還有一個(gè)原因是回調(diào)讀取不及時(shí)。當(dāng)接收速率很高比如單片機(jī)以1Mbps往上傳數(shù)據(jù)而MATLAB回調(diào)里每處理一行就更新TextAreaTextArea的內(nèi)容會(huì)越來(lái)越大導(dǎo)致回調(diào)越來(lái)越慢最終Buffer溢出。解決思路TextArea只保留最近N行比如2000行超過(guò)就截?cái)唷Ｊ褂肁pp.component維護(hù)一個(gè)固定大小數(shù)組。或者直接不用TextArea顯示改用繪圖和表格顯示處理后的結(jié)果。我在項(xiàng)目里就是用循環(huán)數(shù)組保留最近5000幀界面只顯示最新一幀的幾個(gè)關(guān)鍵數(shù)值這樣即使跑幾小時(shí)也不卡。5. 擴(kuò)展思路與個(gè)人經(jīng)驗(yàn)5.1 從“串口調(diào)試助手”升級(jí)成“自動(dòng)化測(cè)試平臺(tái)”當(dāng)你有了這套源碼它就不只是一個(gè)調(diào)試工具完全可以演變成一個(gè)自動(dòng)化測(cè)試平臺(tái)。我后來(lái)在這個(gè)基礎(chǔ)上加了“測(cè)試用例腳本”功能把發(fā)送指令和預(yù)期響應(yīng)的對(duì)照表放在Excel里用readtable讀進(jìn)來(lái)程序自動(dòng)逐條向設(shè)備發(fā)送指令比對(duì)返回值并把PASS/FAIL結(jié)果輸出到報(bào)告。本質(zhì)上就是把原來(lái)手動(dòng)點(diǎn)按鈕的流程變成批量執(zhí)行腳本化的過(guò)程。具體做法也很簡(jiǎn)單在App Designer里增加一個(gè)“測(cè)試模式”測(cè)試腳本可以是一個(gè)結(jié)構(gòu)體數(shù)組每個(gè)元素包含指令、等待時(shí)間、預(yù)期響應(yīng)、容差等字段。發(fā)送后啟動(dòng)一個(gè)計(jì)時(shí)器去接收數(shù)據(jù)收到后通過(guò)回調(diào)里的解析邏輯與預(yù)期比對(duì)。如果設(shè)備返回的是數(shù)值可以用assert或自定義判據(jù)。最終生成報(bào)告我一般用table保存結(jié)果再用writetable輸出CSV用起來(lái)非常順手。再進(jìn)一步你還能結(jié)合MATLAB的Instrument Control Toolbox支持的其他接口比如GPIB、TCP/IP、Modbus做一個(gè)統(tǒng)一的上位機(jī)平臺(tái)。串口只是其中一種通信方式。當(dāng)你的設(shè)備需要切換USB轉(zhuǎn)串口和以太網(wǎng)通信時(shí)這套架構(gòu)只需要把serialport換成tcpclient上層邏輯完全復(fù)用。我建議寫(xiě)代碼時(shí)盡量把底層通信封裝成獨(dú)立類(lèi)暴露open、close、send、onDataReceived這幾個(gè)方法后續(xù)擴(kuò)展會(huì)省很多事。5.2 個(gè)人心得什么情況下別用MATLAB做串口工具M(jìn)ATLAB做串口調(diào)試助手確實(shí)方便但它也有短板。啟動(dòng)慢、內(nèi)存占用高、打包成獨(dú)立exe后首次運(yùn)行需要安裝運(yùn)行時(shí)MCR這些都是客觀存在的。如果你只是臨時(shí)抓個(gè)數(shù)據(jù)、看個(gè)波形那用MATLAB沒(méi)問(wèn)題。如果你要做一個(gè)需要分發(fā)給幾十個(gè)同事、或者部署在嵌入式設(shè)備旁邊長(zhǎng)期運(yùn)行的通用小工具那還是老老實(shí)實(shí)用Pythonpyserial PyQt或者現(xiàn)有的串口助手吧。MATLAB的優(yōu)勢(shì)在于“數(shù)據(jù)處理 協(xié)議解析 可視化”的緊密集成而不是極致的輕量和響應(yīng)速度。用MATLAB做串口工具還有一個(gè)隱性問(wèn)題串口通信對(duì)實(shí)時(shí)性要求高M(jìn)ATLAB是腳本語(yǔ)言回調(diào)之間還可能因?yàn)槔L圖、文件I/O等操作造成延遲抖動(dòng)。如果你的應(yīng)用是高速閉環(huán)控制那MATLAB并不合適。但它特別適合“數(shù)據(jù)記錄 離線分析”的場(chǎng)合比如你給設(shè)備發(fā)一個(gè)指令然后采集幾千幀響應(yīng)數(shù)據(jù)存下來(lái)做系統(tǒng)辨識(shí)或性能評(píng)估這種場(chǎng)景MATLAB就是王炸。最后再分享一個(gè)小技巧在調(diào)試過(guò)程中如果你的數(shù)據(jù)量很大又不想讓TextArea被刷爆可以在回調(diào)里加一個(gè)計(jì)數(shù)每隔50行才更新一次界面顯示。這樣既可以看到數(shù)據(jù)流動(dòng)又不會(huì)拖慢程序。但重要的、需要記錄的關(guān)鍵幀一定不能丟要用日志文件存下來(lái)。說(shuō)實(shí)話我剛開(kāi)始做這個(gè)項(xiàng)目時(shí)也交過(guò)很多學(xué)費(fèi)比如回調(diào)里直接繪圖導(dǎo)致UI卡死、波特率配置錯(cuò)誤導(dǎo)致數(shù)據(jù)全亂、沒(méi)接GND導(dǎo)致通信不穩(wěn)定等等。后來(lái)我養(yǎng)成了一個(gè)習(xí)慣先寫(xiě)一個(gè)最簡(jiǎn)單的收發(fā)測(cè)試腳本確認(rèn)串口鏈路穩(wěn)定再開(kāi)始搭建界面。這個(gè)習(xí)慣建議你也保留能幫你省下大量排查時(shí)間。本文還有配套的精品資源點(diǎn)擊獲取 MATLAB串口調(diào)試助手從零實(shí)現(xiàn)：串口通信與App Designer實(shí)戰(zhàn)
簡(jiǎn)介本資源是一套基于MATLAB開(kāi)發(fā)的串口調(diào)試助手完整源碼及配套實(shí)踐教程面向嵌入式初學(xué)者、自動(dòng)化專(zhuān)業(yè)學(xué)生及MATLAB工程實(shí)踐者旨在解決硬件設(shè)備如Arduino、樹(shù)莓派與PC端串口通信調(diào)試門(mén)檻高、GUI開(kāi)發(fā)復(fù)雜等實(shí)際問(wèn)題。壓縮包共8個(gè)文件7.21MB包含核心MATLAB源碼.m、GUI界面文件.fig、配置文件.ini、日志記錄.log、說(shuō)明文檔.txt及可執(zhí)行程序.exe其中.m與.fig文件構(gòu)成可運(yùn)行的圖形化調(diào)試界面支持波特率設(shè)置、數(shù)據(jù)收發(fā)、定時(shí)輪詢(xún)與錯(cuò)誤處理等完整功能。已有1194人學(xué)習(xí)下載資源附帶詳細(xì)串口通信知識(shí)點(diǎn)解析涵蓋Serial對(duì)象創(chuàng)建、fopen/fwrite/fgets調(diào)用規(guī)范、GUIDE界面回調(diào)邏輯及timer定時(shí)讀取機(jī)制特別適合從零掌握MATLAB串口通信開(kāi)發(fā)流程并可直接修改源碼適配不同硬件協(xié)議。1. MATLAB串口調(diào)試助手先搞清它能干什么做嵌入式、儀器控制、硬件調(diào)試的兄弟多半都有過(guò)這種經(jīng)歷手邊沒(méi)有趁手的串口工具要么打開(kāi)SSCOM、XCOM這種老牌小軟件要么自己拿Python的pyserial臨時(shí)拼一個(gè)。但如果你恰好是MATLAB的重度用戶項(xiàng)目里已經(jīng)在用MATLAB做信號(hào)處理、數(shù)據(jù)分析和可視化那再開(kāi)一個(gè)串口調(diào)試助手直接用MATLAB寫(xiě)一套源代碼其實(shí)是很順理成章的事。我最初做這個(gè)項(xiàng)目就是為了在采集傳感器數(shù)據(jù)的同時(shí)直接在MATLAB里完成濾波、FFT分析和波形繪制省掉“串口工具導(dǎo)出文件 - 再導(dǎo)入MATLAB”這一步體驗(yàn)完全不一樣。這套MATLAB串口調(diào)試助手本質(zhì)上是一個(gè)帶圖形界面的串口通信工具核心功能包括掃描可用串口、配置波特率/數(shù)據(jù)位/校驗(yàn)位/停止位、打開(kāi)關(guān)閉串口、實(shí)時(shí)接收數(shù)據(jù)并顯示、按幀解析數(shù)據(jù)、手動(dòng)發(fā)送指令、自動(dòng)發(fā)送、數(shù)據(jù)保存為文件、實(shí)時(shí)繪圖。聽(tīng)起來(lái)和市面上現(xiàn)成的串口調(diào)試助手差不多但用MATLAB源碼實(shí)現(xiàn)的好處是你可以完全掌控協(xié)議解析邏輯能直接調(diào)用MATLAB強(qiáng)大的數(shù)值計(jì)算與繪圖工具箱還能把收到的數(shù)據(jù)立刻喂給算法模型去做處理。適合誰(shuí)來(lái)參考如果你是學(xué)生、工程師正在做單片機(jī)/嵌入式項(xiàng)目或者需要控制程控電源、溫控器、下位機(jī)等串口設(shè)備同時(shí)對(duì)MATLAB有一定基礎(chǔ)那這篇內(nèi)容會(huì)很對(duì)胃口。即使你只是對(duì)串口通信原理感興趣也可以跟著源碼把機(jī)制弄清楚。我會(huì)從底層原理講到界面實(shí)現(xiàn)最后把調(diào)試中常見(jiàn)的坑翻出來(lái)逐個(gè)說(shuō)明盡量讓你能照著代碼敲出一個(gè)能用的工具而不是給你一個(gè)只能看不能用的半成品。2. 串口通信核心參數(shù)與MATLAB串口對(duì)象配置2.1 串口通信的關(guān)鍵參數(shù)你到底在配什么串口通信UART/RS232/RS485之所以看起來(lái)簡(jiǎn)單是因?yàn)樗且粭l“按位傳輸”的物理鏈路。發(fā)送方和接收方必須約定好“每個(gè)數(shù)據(jù)包的節(jié)奏”否則收到的就是一堆亂碼。這個(gè)節(jié)奏由四個(gè)基礎(chǔ)參數(shù)決定波特率、數(shù)據(jù)位、停止位、校驗(yàn)位。波特率表示每秒傳輸多少個(gè)符號(hào)bit/s常見(jiàn)的有9600、115200、460800等。它決定了每一位的持續(xù)時(shí)間。發(fā)送方和接收方波特率必須一致差一點(diǎn)點(diǎn)都會(huì)導(dǎo)致采樣錯(cuò)誤。比如你設(shè)9600設(shè)備設(shè)9600但兩邊晶振都有誤差長(zhǎng)時(shí)間傳輸就會(huì)積累出幀偏移。數(shù)據(jù)位通常是8位代表一個(gè)數(shù)據(jù)字節(jié)也有7位用于ASCII通信。停止位是標(biāo)識(shí)一個(gè)數(shù)據(jù)幀結(jié)束的電平持續(xù)時(shí)間常見(jiàn)的是1位或2位。校驗(yàn)位用來(lái)做簡(jiǎn)易差錯(cuò)檢測(cè)可選None、Odd、Even。現(xiàn)在的多數(shù)設(shè)備都是“8N1”也就是8個(gè)數(shù)據(jù)位、無(wú)校驗(yàn)、1位停止位這個(gè)組合在MATLAB里配置最省事。除這四個(gè)參數(shù)之外還有一個(gè)容易被忽略的流控Flow Controlnone、hardware、software。單片機(jī)設(shè)備大多不用流控但如果你接的是老式調(diào)制解調(diào)器或某些儀器可能要用硬件流控RTS/CTS或軟件流控XON/XOFF。MATLAB的serialport對(duì)象支持配置FlowControl默認(rèn)是none。在動(dòng)手寫(xiě)代碼前第一件事就是去查設(shè)備手冊(cè)確認(rèn)這幾個(gè)參數(shù)。千萬(wàn)別想當(dāng)然我見(jiàn)過(guò)一個(gè)兄弟把儀器的停止位配錯(cuò)折騰了整整一天最后發(fā)現(xiàn)就是一位之差。2.2 用serialport還是serial這是一個(gè)問(wèn)題MATLAB里有兩套串口接口老版的serial屬于Instrument Control Toolbox的舊接口配合fopen/fread/fprintf使用以及新版推薦的serialport從R2019b起引入采用面向?qū)ο箫L(fēng)格配置和讀取都更簡(jiǎn)潔。如果你還沒(méi)開(kāi)始寫(xiě)建議直接使用serialport不要再用serial。兩者的區(qū)別可以這樣理解serial是老式的“命令式”驅(qū)動(dòng)需要先f(wàn)open打開(kāi)用fread/fscanf讀數(shù)據(jù)用fwrite/fprintf寫(xiě)數(shù)據(jù)用fclose關(guān)閉還要操心BufferSize、BytesAvailableFcn等屬性。而serialport則是“對(duì)象式”的創(chuàng)建對(duì)象時(shí)參數(shù)一次性寫(xiě)入讀取用read寫(xiě)入用write配置readAsync和callback函數(shù)也更容易還支持自動(dòng)檢測(cè)設(shè)備斷開(kāi)。從MATLAB R2021b開(kāi)始官方已經(jīng)很少再推薦serial接口雖然它還能用但新功能都不往上面加了。如果你看到網(wǎng)上老教程還在用serial可以看但要清楚那是歷史遺留寫(xiě)法。我現(xiàn)在的代碼模板是這樣創(chuàng)建serialport對(duì)象的% 創(chuàng)建串口對(duì)象 s serialport(COM3, 115200); % 配置數(shù)據(jù)位默認(rèn)8可不寫(xiě) s.DataBits 8; % 校驗(yàn)位可以是 none / odd / even s.Parity none; % 停止位可以是 1 / 1.5 / 2 s.StopBits 1; % 關(guān)閉流控 s.FlowControl none; % 設(shè)置讀取超時(shí) s.Timeout 2;在創(chuàng)建對(duì)象時(shí)如果該串口已被其他程序占用MATLAB會(huì)直接報(bào)錯(cuò)。這也是很多人遇到的第一個(gè)坑。后面我會(huì)專(zhuān)門(mén)說(shuō)排查方法。2.3 數(shù)據(jù)讀取的三種方式以及回調(diào)函數(shù)怎么設(shè)計(jì)serialport對(duì)象讀取數(shù)據(jù)主要有三種方式阻塞讀取、輪詢(xún)讀取、異步回調(diào)讀取。阻塞讀取就是直接調(diào)用read或readline讀不夠指定字節(jié)數(shù)就一直等直到超時(shí)。這種方式適合在腳本里用比如測(cè)試時(shí)抓一幀數(shù)據(jù)。輪詢(xún)讀取是在循環(huán)里不斷查詢(xún)可讀字節(jié)數(shù)再手動(dòng)read適合簡(jiǎn)單的命令行腳本。異步回調(diào)讀取是最適合圖形界面GUI的方式它通過(guò)配置BytesAvailableFcnMode可以是byte或terminator和BytesAvailableFcnCount來(lái)觸發(fā)回調(diào)函數(shù)當(dāng)串口緩沖區(qū)內(nèi)累積到指定字節(jié)數(shù)或收到指定結(jié)束符時(shí)MATLAB會(huì)自動(dòng)調(diào)用回調(diào)函數(shù)處理數(shù)據(jù)。以接收“以換行符0x0A結(jié)尾的一幀數(shù)據(jù)”為例可以這樣配置s.BytesAvailableFcnMode terminator; s.Terminator LF; % 也可以寫(xiě)成 char(10) s.BytesAvailableFcn onSerialData;回調(diào)函數(shù)onSerialData的簽名必須是兩個(gè)輸入?yún)?shù)function onSerialData(src, ~) % src是serialport對(duì)象 data readline(src); % 處理data disp(data); endreadline會(huì)一直讀到終止符包含終止符并返回文本行。如果是二進(jìn)制幀則建議用byte模式設(shè)置ByteAvailableFcnCount等于一幀長(zhǎng)度再用read讀取指定字節(jié)數(shù)。這兩種模式我在實(shí)際項(xiàng)目里都用過(guò)文本協(xié)議用terminator非常方便二進(jìn)制協(xié)議用byte模式更穩(wěn)。回調(diào)函數(shù)的執(zhí)行頻率取決于數(shù)據(jù)量和數(shù)據(jù)處理速度如果處理太慢回調(diào)可能會(huì)錯(cuò)過(guò)數(shù)據(jù)或者造成界面卡頓這點(diǎn)在繪圖時(shí)尤其明顯后面一起說(shuō)。3. 源代碼實(shí)現(xiàn)從零搭建一個(gè)可用版本3.1 界面布局用App Designer快速搭一個(gè)能看的GUIMATLAB里做GUI有兩套主流方案老式GUIDE已不推薦和App Designer。App Designer從R2016a開(kāi)始引入界面更現(xiàn)代代碼結(jié)構(gòu)更清晰強(qiáng)烈建議用它。這個(gè)串口調(diào)試助手的界面不需要花哨能實(shí)現(xiàn)功能為主。我建議這樣分區(qū)串口配置面板串口選擇下拉框、刷新按鈕、波特率下拉框、數(shù)據(jù)位/校驗(yàn)位/停止位下拉框、打開(kāi)/關(guān)閉串口按鈕。接收數(shù)據(jù)顯示區(qū)一個(gè)多行文本框TextArea用來(lái)顯示字符數(shù)據(jù)配合一個(gè)“清空顯示”按鈕。發(fā)送區(qū)域一個(gè)單行文本框輸入要發(fā)送的內(nèi)容一個(gè)“發(fā)送”按鈕一個(gè)發(fā)送模式選擇文本/HEX。可選區(qū)域一個(gè)“自動(dòng)發(fā)送”復(fù)選框和間隔時(shí)間輸入框“保存數(shù)據(jù)”按鈕實(shí)時(shí)繪圖區(qū)域用UIAxes繪制。用App Designer創(chuàng)建后代碼會(huì)自動(dòng)生成類(lèi)的骨架。我們需要在startupFcn里掃描串口、填充下拉框。掃描串口可以直接用serialportlist函數(shù)function startupFcn(app) app.PortDropDown.Items serialportlist(available); app.BaudRateDropDown.Items [1200, 2400, 4800, 9600, 19200, 38400, 115200, 460800]; app.BaudRateDropDown.Value 115200; app.BaudRateDropDown.Items [1200,2400,4800,9600,19200,38400,115200,460800]; % 默認(rèn)選擇115200 app.BaudRateDropDown.Value 115200; end注意一點(diǎn)serialportlist(available)返回的是當(dāng)前未被占用的端口列表。如果你希望看到所有存在的端口不管是否被占用可以用serialportlist(all)。但打開(kāi)時(shí)如果端口被占用還是會(huì)報(bào)錯(cuò)所以用available更省心。界面布局還有個(gè)容易被忽略的點(diǎn)App Designer的UIAxes繪圖性能會(huì)比普通figure的axes慢一些因?yàn)榈讓邮褂昧薈anvas渲染。如果你對(duì)繪圖實(shí)時(shí)性要求極高可以用figureaxes的組合在回調(diào)里更新繪圖句柄。但作為串口調(diào)試助手UIAxes足夠用。后續(xù)如果發(fā)現(xiàn)繪圖卡頓再改也不遲。3.2 核心代碼打開(kāi)/關(guān)閉串口與數(shù)據(jù)收發(fā)打開(kāi)串口的邏輯是從下拉框讀取用戶選擇的端口號(hào)和參數(shù)創(chuàng)建serialport對(duì)象并配置回調(diào)。關(guān)閉串口則是delete對(duì)象并清空句柄同時(shí)把“關(guān)閉”按鈕狀態(tài)改回“打開(kāi)”。我寫(xiě)了一個(gè)類(lèi)中的私有函數(shù)來(lái)處理function openSerial(app) if ~isempty(app.s) delete(app.s); app.s []; end port app.PortDropDown.Value; baud str2double(app.BaudRateDropDown.Value); dataBits str2double(app.DataBitsDropDown.Value); parity app.ParityDropDown.Value; % none/odd/even stopBits str2double(app.StopBitsDropDown.Value); try app.s serialport(port, baud); app.s.DataBits dataBits; app.s.Parity lower(parity); % 小寫(xiě) app.s.StopBits stopBits; app.s.Timeout 2; % 接收回調(diào) app.s.BytesAvailableFcnMode terminator; app.s.Terminator LF; app.s.BytesAvailableFcn app.onReceiveData; app.OpenButton.Text 關(guān)閉串口; app.StatusLabel.Text sprintf(已打開(kāi): %s %d, port, baud); catch ME app.StatusLabel.Text 打開(kāi)失敗: ME.message; app.OpenButton.Text 打開(kāi)串口; app.s []; end end這里我把回調(diào)綁定到app.onReceiveData意味著回調(diào)函數(shù)是App類(lèi)的方法。App Designer中如果方法用“private”訪問(wèn)級(jí)別就可以在屬性中用app.func語(yǔ)法引用。回調(diào)里需要讀取數(shù)據(jù)并追加到TextArea同時(shí)做HEX/文本顯示轉(zhuǎn)換。接收文本數(shù)據(jù)function onReceiveData(app, src, ~) % 因?yàn)樵O(shè)定了terminator模式可以用readline讀取一行 line readline(src); uploadTime datetime(now, Format, HH:mm:ss.SSS); % 在文本框中追加顯示 displayText sprintf([%s] %s, uploadTime, line); app.ReceiveTextArea.Value char(strcat(string(app.ReceiveTextArea.Value), ... string(newline), string(displayText))); % 把最新數(shù)據(jù)存起來(lái)供后續(xù)解析或保存 app.lastLine char(line); end如果你收到的是二進(jìn)制幀則不建議用readline而是設(shè)成byte模式app.s.BytesAvailableFcnMode byte; app.s.BytesAvailableFcnCount frameLen; % 已知幀長(zhǎng) app.s.BytesAvailableFcn app.onReceiveBinary;然后在回調(diào)里用read固定字節(jié)數(shù)function onReceiveBinary(app, src, ~) data read(src, app.frameLen, uint8); % 處理 data end發(fā)送數(shù)據(jù)比較簡(jiǎn)單發(fā)送文本和HEX兩種模式。文本模式直接writeHEX模式需要先把用戶輸入的十六進(jìn)制字符串轉(zhuǎn)成字節(jié)數(shù)組function sendData(app, str, isHex) if isempty(app.s) return; end if isHex % 去除空格 cleanStr strrep(str, , ); if mod(length(cleanStr), 2) ~ 0 uialert(app.UIFigure, HEX字符串長(zhǎng)度必須為偶數(shù), 輸入錯(cuò)誤); return; end bytes uint8(hex2dec(reshape(cleanStr, 2, []))); write(app.s, bytes, uint8); else write(app.s, str, char); end endHEX發(fā)送有一個(gè)細(xì)節(jié)如果用戶輸入AA BB CC你應(yīng)該先去掉所有空格再判斷字符個(gè)數(shù)是否為偶數(shù)然后每?jī)蓚€(gè)字符轉(zhuǎn)一個(gè)字節(jié)。使用reshape(cleanStr, 2, [])可以將長(zhǎng)度為偶數(shù)的字符數(shù)組變成N行2列再用hex2dec轉(zhuǎn)換為十進(jìn)制值最后轉(zhuǎn)uint8。注意hex2dec每行最多能轉(zhuǎn)換的位數(shù)有限但對(duì)于一幀幾十字節(jié)的數(shù)據(jù)沒(méi)問(wèn)題。如果想批量發(fā)送也可以改用循環(huán)。3.3 數(shù)據(jù)解析如何應(yīng)對(duì)可變長(zhǎng)或不規(guī)則的幀很多設(shè)備發(fā)送的并不是一行一行的文本而是一組十六進(jìn)制字節(jié)比如幀頭0xAA、幀頭0x55、命令字、數(shù)據(jù)長(zhǎng)度、數(shù)據(jù)、校驗(yàn)和、幀尾0x0A。如果只按行接收就不能正確處理。這里我推薦兩個(gè)方法基于“幀長(zhǎng)固定”的解析通過(guò)BytesAvailableFcnCount 幀長(zhǎng)每次回調(diào)讀取固定字節(jié)數(shù)然后解析。適合所有幀長(zhǎng)度一致的情況比如有些模塊每次返回8字節(jié)狀態(tài)幀。基于幀頭幀尾的緩沖解析在terminator模式下無(wú)法處理得改成“byte”模式每次讀取所有可用字節(jié)然后放入一個(gè)持久化緩沖數(shù)組中在緩沖區(qū)內(nèi)查找?guī)^幀尾并提取完整幀。這種方式更通用。我實(shí)際用的解析函數(shù)大概是這樣偽代碼邏輯function parseBinaryFrame(app, bytes) % 將新數(shù)據(jù)追加到內(nèi)部緩沖區(qū) app.buffer [app.buffer, bytes]; while true startIdx find(app.buffer app.frameHeader, 1); if isempty(startIdx) app.buffer []; % 沒(méi)有幀頭則清空 break; end if length(app.buffer) startIdx 2 break; % 長(zhǎng)度字段還沒(méi)收全 end dataLen app.buffer(startIdx 2); frameLen 4 dataLen 1; % 假設(shè)幀頭(2)長(zhǎng)度(1)數(shù)據(jù)(dataLen)校驗(yàn)(1)幀尾(1) if length(app.buffer) startIdx frameLen - 1 break; % 等待完整幀 end frame app.buffer(startIdx:startIdx frameLen - 1); if frame(end) app.frameTail % 校驗(yàn)和驗(yàn)證假設(shè)校驗(yàn)和為除幀尾外所有字節(jié)的和的低8位 checksum mod(sum(frame(1:end-2)), 256); if checksum frame(end-1) % 解析成功提取數(shù)據(jù)部分 parsedData frame(4:end-2); % 更新界面調(diào)用上位數(shù)據(jù)處理函數(shù) app.parseData(parsedData); else disp(校驗(yàn)和錯(cuò)誤); end end % 緩沖區(qū)向前移動(dòng) app.buffer app.buffer(startIdxframeLen:end); end end這里只是一個(gè)簡(jiǎn)化版寫(xiě)法真實(shí)設(shè)備可能還有“數(shù)據(jù)小端/大端”的問(wèn)題需要你用typecast函數(shù)轉(zhuǎn)換。比如收到兩個(gè)字節(jié)表示一個(gè)int16如果設(shè)備是大端模式那就需要先swapbytes再typecast為int16。這些細(xì)節(jié)建議在解析函數(shù)里專(zhuān)門(mén)做一層“字節(jié)序轉(zhuǎn)換”不要散落在主流程里。3.4 數(shù)據(jù)保存與實(shí)時(shí)繪圖把接收到的數(shù)據(jù)記錄到文件最簡(jiǎn)單的方式是用fopen/fprintf在回調(diào)里逐行寫(xiě)入。但如果回調(diào)頻率很高建議累積到一定數(shù)量再批量寫(xiě)入避免頻繁打開(kāi)關(guān)閉文件。通常做法是打開(kāi)串口時(shí)初始化一個(gè)文件句柄關(guān)閉串口時(shí)關(guān)閉它。function startLog(app, filename) app.logFid fopen(filename, a); if app.logFid -1 error(無(wú)法創(chuàng)建日志文件); end end function stopLog(app) if app.logFid ~ -1 fclose(app.logFid); app.logFid -1; end end在onReceiveData回調(diào)中把收到的行加上時(shí)間戳寫(xiě)入文件。為了性能我一般不會(huì)每行都flush而是利用fprintf默認(rèn)的緩沖機(jī)制關(guān)閉時(shí)fclose就會(huì)寫(xiě)盤(pán)。實(shí)時(shí)繪圖則可以使用animatedline對(duì)象它比重復(fù)plot更新更高效。舉個(gè)例子在App類(lèi)里初始化app.plotLine animatedline(app.UIAxes, Color, b, LineWidth, 1);在回調(diào)中更新x now; % 或用計(jì)數(shù)器 y str2double(line); % 假設(shè)收到的是數(shù)值 addpoints(app.plotLine, x, y); drawnow limitrate;drawnow limitrate是MATLAB提供的一種降低繪圖刷新頻率的方法它最多每秒刷新20次左右可以防止界面被繪圖拖垮。如果數(shù)據(jù)量很大比如采樣率1kHz以上建議只繪制最新N個(gè)點(diǎn)或者先存入數(shù)組每隔一定時(shí)間批量更新一次避免每次回調(diào)都重新繪制。4. 實(shí)操中常見(jiàn)的坑與排查技巧4.1 打不開(kāi)串口、端口號(hào)沒(méi)顯示這是出現(xiàn)頻率最高的問(wèn)題。常見(jiàn)原因有三個(gè)串口被其他軟件占用。比如設(shè)備廠商的配置工具、SSCOM、XCOM甚至上一個(gè)沒(méi)被正確關(guān)閉的MATLAB程序。MATLAB里如果上一次運(yùn)行打開(kāi)了serialport對(duì)象但沒(méi)有delete對(duì)象還留在工作區(qū)端口就仍然被占用。排查方法是執(zhí)行clear all或close或者用instrfind清理instrfindall delete(instrfindall)端口號(hào)變化。USB轉(zhuǎn)串口設(shè)備在不同電腦、不同USB口插拔后COM號(hào)會(huì)變。可以在Windows設(shè)備管理器里查看“端口(COM和LPT)”確認(rèn)當(dāng)前端口號(hào)。或者在MATLAB里用serialportlist(all)看所有端口。權(quán)限不足Linux。在Linux下普通用戶可能沒(méi)有/dev/ttyUSB0的讀寫(xiě)權(quán)限。需要加用戶到dialout組或用sudo運(yùn)行MATLAB。不建議長(zhǎng)期用sudo正確做法是sudo usermod -a -G dialout 你的用戶名然后重新登錄。如果MATLAB報(bào)錯(cuò)“Unable to connect to the serial port: Port is not available”八成是上面三種情況之一。注意serialportlist(available)只會(huì)列出未被占用的端口當(dāng)你的設(shè)備被其他軟件占用它可能完全不顯示容易誤以為驅(qū)動(dòng)沒(méi)裝好。4.2 數(shù)據(jù)亂碼、顯示異常亂碼問(wèn)題要區(qū)分是“顯示亂碼”還是“傳輸數(shù)據(jù)本身錯(cuò)誤”。如果是顯示亂碼比如接收框里出現(xiàn)方塊或問(wèn)號(hào)先檢查是不是編碼問(wèn)題。很多下位機(jī)發(fā)送的是GBK編碼的中文MATLAB默認(rèn)使用UTF-8解讀字符串必然亂碼。簡(jiǎn)單的處理方式在帶字符集轉(zhuǎn)換中用native2unicode和unicode2native轉(zhuǎn)換。收到字節(jié)數(shù)組后可以嘗試line char(native2unicode(line, GBK))。如果只是簡(jiǎn)單ASCII那就不會(huì)有亂碼。如果是“數(shù)據(jù)對(duì)不上”比如發(fā)0xAA收到0xC2 0xAA這通常是因?yàn)榘讯M(jìn)制字節(jié)用文本方式打開(kāi)了或者發(fā)送端和接收端的數(shù)據(jù)位數(shù)不一致。還有一個(gè)很隱蔽的問(wèn)題串口調(diào)試助手里的“HEX顯示”與“HEX發(fā)送”需要分別設(shè)置。如果你只設(shè)置了HEX發(fā)送但接收顯示為文本打印出來(lái)的就是不可讀字符。我的建議是調(diào)試底層協(xié)議時(shí)一律用HEX顯示模式方便核對(duì)幀格式確認(rèn)無(wú)誤后再切換文本模式。另外檢查一下串口線是否完整。現(xiàn)在很多USB轉(zhuǎn)TTL模塊只有TX、RX、GND三根線有的模塊需要短接RTS/CTS才可通信。如果收發(fā)雙方共地沒(méi)接好會(huì)出現(xiàn)數(shù)據(jù)偶爾丟字節(jié)、亂碼頻率很高的情況。信號(hào)地沒(méi)接是串口通信“玄學(xué)故障”的頭號(hào)原因。4.3 回調(diào)不觸發(fā)或界面卡死回調(diào)用terminator模式不觸發(fā)常見(jiàn)是下位機(jī)發(fā)的換行符不是LF而是CR或者是CRLF。MATLAB中串口終止符默認(rèn)為L(zhǎng)F如果數(shù)據(jù)以回車(chē)符結(jié)尾自然讀不到一行。解決辦法是把Terminator設(shè)置為CR/LF或者設(shè)置成CR甚至設(shè)置成char(13)。如果你不確定可以在“byte”模式下read所有數(shù)據(jù)然后手動(dòng)解析。界面卡死的原因多半是回調(diào)函數(shù)里做了太重的工作比如在回調(diào)里執(zhí)行plot或者在回調(diào)中用了uialert這是非常影響性能的。App Designer的回調(diào)運(yùn)行在UI線程上如果數(shù)據(jù)處理耗時(shí)過(guò)長(zhǎng)界面會(huì)像死掉一樣。避免方法回調(diào)里只做數(shù)據(jù)入隊(duì)和簡(jiǎn)單解析復(fù)雜的處理放到timer或者后臺(tái)任務(wù)。MATLAB從R2019a開(kāi)始支持parfeval和backgroundPool可以把數(shù)據(jù)處理放到后臺(tái)線程。但是要注意UIAxes和控件操作不能在非UI線程中執(zhí)行所以最終更新界面必須回到UI線程。我的方案是回調(diào)里先解析數(shù)值存到一個(gè)隊(duì)列再用uialarm或者timer定時(shí)刷新界面。4.4 保存文件失敗、數(shù)據(jù)丟失保存數(shù)據(jù)時(shí)文件如果被Excel或其他程序打開(kāi)fopen會(huì)返回-1日志寫(xiě)不進(jìn)去。打開(kāi)串口時(shí)最好先設(shè)置好日志文件路徑并給用戶明確提示。另外如果程序異常退出fclose可能未執(zhí)行數(shù)據(jù)緩沖在內(nèi)存里丟掉了。可以在App的CloseRequestFcn里統(tǒng)一清理function closeRequest(app) stopLog(app); if ~isempty(app.s) delete(app.s); end delete(app.UIFigure); end數(shù)據(jù)丟失還有一個(gè)原因是回調(diào)讀取不及時(shí)。當(dāng)接收速率很高比如單片機(jī)以1Mbps往上傳數(shù)據(jù)而MATLAB回調(diào)里每處理一行就更新TextAreaTextArea的內(nèi)容會(huì)越來(lái)越大導(dǎo)致回調(diào)越來(lái)越慢最終Buffer溢出。解決思路TextArea只保留最近N行比如2000行超過(guò)就截?cái)唷Ｊ褂肁pp.component維護(hù)一個(gè)固定大小數(shù)組。或者直接不用TextArea顯示改用繪圖和表格顯示處理后的結(jié)果。我在項(xiàng)目里就是用循環(huán)數(shù)組保留最近5000幀界面只顯示最新一幀的幾個(gè)關(guān)鍵數(shù)值這樣即使跑幾小時(shí)也不卡。5. 擴(kuò)展思路與個(gè)人經(jīng)驗(yàn)5.1 從“串口調(diào)試助手”升級(jí)成“自動(dòng)化測(cè)試平臺(tái)”當(dāng)你有了這套源碼它就不只是一個(gè)調(diào)試工具完全可以演變成一個(gè)自動(dòng)化測(cè)試平臺(tái)。我后來(lái)在這個(gè)基礎(chǔ)上加了“測(cè)試用例腳本”功能把發(fā)送指令和預(yù)期響應(yīng)的對(duì)照表放在Excel里用readtable讀進(jìn)來(lái)程序自動(dòng)逐條向設(shè)備發(fā)送指令比對(duì)返回值并把PASS/FAIL結(jié)果輸出到報(bào)告。本質(zhì)上就是把原來(lái)手動(dòng)點(diǎn)按鈕的流程變成批量執(zhí)行腳本化的過(guò)程。具體做法也很簡(jiǎn)單在App Designer里增加一個(gè)“測(cè)試模式”測(cè)試腳本可以是一個(gè)結(jié)構(gòu)體數(shù)組每個(gè)元素包含指令、等待時(shí)間、預(yù)期響應(yīng)、容差等字段。發(fā)送后啟動(dòng)一個(gè)計(jì)時(shí)器去接收數(shù)據(jù)收到后通過(guò)回調(diào)里的解析邏輯與預(yù)期比對(duì)。如果設(shè)備返回的是數(shù)值可以用assert或自定義判據(jù)。最終生成報(bào)告我一般用table保存結(jié)果再用writetable輸出CSV用起來(lái)非常順手。再進(jìn)一步你還能結(jié)合MATLAB的Instrument Control Toolbox支持的其他接口比如GPIB、TCP/IP、Modbus做一個(gè)統(tǒng)一的上位機(jī)平臺(tái)。串口只是其中一種通信方式。當(dāng)你的設(shè)備需要切換USB轉(zhuǎn)串口和以太網(wǎng)通信時(shí)這套架構(gòu)只需要把serialport換成tcpclient上層邏輯完全復(fù)用。我建議寫(xiě)代碼時(shí)盡量把底層通信封裝成獨(dú)立類(lèi)暴露open、close、send、onDataReceived這幾個(gè)方法后續(xù)擴(kuò)展會(huì)省很多事。5.2 個(gè)人心得什么情況下別用MATLAB做串口工具M(jìn)ATLAB做串口調(diào)試助手確實(shí)方便但它也有短板。啟動(dòng)慢、內(nèi)存占用高、打包成獨(dú)立exe后首次運(yùn)行需要安裝運(yùn)行時(shí)MCR這些都是客觀存在的。如果你只是臨時(shí)抓個(gè)數(shù)據(jù)、看個(gè)波形那用MATLAB沒(méi)問(wèn)題。如果你要做一個(gè)需要分發(fā)給幾十個(gè)同事、或者部署在嵌入式設(shè)備旁邊長(zhǎng)期運(yùn)行的通用小工具那還是老老實(shí)實(shí)用Pythonpyserial PyQt或者現(xiàn)有的串口助手吧。MATLAB的優(yōu)勢(shì)在于“數(shù)據(jù)處理 協(xié)議解析 可視化”的緊密集成而不是極致的輕量和響應(yīng)速度。用MATLAB做串口工具還有一個(gè)隱性問(wèn)題串口通信對(duì)實(shí)時(shí)性要求高M(jìn)ATLAB是腳本語(yǔ)言回調(diào)之間還可能因?yàn)槔L圖、文件I/O等操作造成延遲抖動(dòng)。如果你的應(yīng)用是高速閉環(huán)控制那MATLAB并不合適。但它特別適合“數(shù)據(jù)記錄 離線分析”的場(chǎng)合比如你給設(shè)備發(fā)一個(gè)指令然后采集幾千幀響應(yīng)數(shù)據(jù)存下來(lái)做系統(tǒng)辨識(shí)或性能評(píng)估這種場(chǎng)景MATLAB就是王炸。最后再分享一個(gè)小技巧在調(diào)試過(guò)程中如果你的數(shù)據(jù)量很大又不想讓TextArea被刷爆可以在回調(diào)里加一個(gè)計(jì)數(shù)每隔50行才更新一次界面顯示。這樣既可以看到數(shù)據(jù)流動(dòng)又不會(huì)拖慢程序。但重要的、需要記錄的關(guān)鍵幀一定不能丟要用日志文件存下來(lái)。說(shuō)實(shí)話我剛開(kāi)始做這個(gè)項(xiàng)目時(shí)也交過(guò)很多學(xué)費(fèi)比如回調(diào)里直接繪圖導(dǎo)致UI卡死、波特率配置錯(cuò)誤導(dǎo)致數(shù)據(jù)全亂、沒(méi)接GND導(dǎo)致通信不穩(wěn)定等等。后來(lái)我養(yǎng)成了一個(gè)習(xí)慣先寫(xiě)一個(gè)最簡(jiǎn)單的收發(fā)測(cè)試腳本確認(rèn)串口鏈路穩(wěn)定再開(kāi)始搭建界面。這個(gè)習(xí)慣建議你也保留能幫你省下大量排查時(shí)間。本文還有配套的精品資源點(diǎn)擊獲取