桌面工具開(kāi)發(fā)實(shí)戰(zhàn))
簡(jiǎn)介這是一套基于Qt框架開(kāi)發(fā)的周立功CAN總線通訊測(cè)試軟件源碼面向嵌入式初學(xué)者、CAN協(xié)議學(xué)習(xí)者及工業(yè)通信調(diào)試人員用于快速理解Qt與硬件CAN設(shè)備如周立功USBCAN系列的集成邏輯與交互流程。資源壓縮包大小為4.42MB包含完整可編譯的Qt項(xiàng)目工程文件涵蓋主界面、CAN幀收發(fā)模塊、參數(shù)配置對(duì)話框、報(bào)文解析與日志顯示等核心功能模塊代碼結(jié)構(gòu)清晰、注釋規(guī)范便于二次開(kāi)發(fā)與教學(xué)演示。目前已有174人下載學(xué)習(xí)適合希望掌握Qt跨平臺(tái)GUI開(kāi)發(fā)與底層CAN通信協(xié)同實(shí)現(xiàn)的學(xué)習(xí)者。讀者可直接導(dǎo)入Qt Creator構(gòu)建運(yùn)行獲取完整的CAN通信測(cè)試能力包括波特率設(shè)置、標(biāo)準(zhǔn)/擴(kuò)展幀收發(fā)、實(shí)時(shí)數(shù)據(jù)顯示、報(bào)文過(guò)濾及錯(cuò)誤狀態(tài)監(jiān)控等功能是理解CAN應(yīng)用層軟件設(shè)計(jì)的實(shí)用參考案例。1. 項(xiàng)目緣起一個(gè)桌面CAN工具的開(kāi)發(fā)困境與選擇在嵌入式開(kāi)發(fā)和汽車電子領(lǐng)域CAN總線調(diào)試是繞不開(kāi)的日常工作。無(wú)論是測(cè)試ECU節(jié)點(diǎn)、分析總線負(fù)載還是模擬發(fā)送特定報(bào)文一個(gè)趁手的上位機(jī)工具至關(guān)重要。市面上有Vector的CANoe、周立功的CANTest、PCAN-View等功能強(qiáng)大但價(jià)格不菲且二次開(kāi)發(fā)靈活性受限。幾年前我接手一個(gè)長(zhǎng)期維護(hù)的汽車診斷項(xiàng)目需要開(kāi)發(fā)一個(gè)集成了特定診斷協(xié)議如UDS的、可高度定制的CAN總線監(jiān)控與測(cè)試工具。核心需求很明確需要一個(gè)穩(wěn)定、跨平臺(tái)、界面友好且能與主流CAN卡硬件尤其是國(guó)內(nèi)普及率極高的周立功USBCAN系列深度集成的桌面應(yīng)用程序?;谶@個(gè)背景技術(shù)選型的天平很自然地傾向了Qt。為什么是Qt首先項(xiàng)目要求支持Windows和Linux雙平臺(tái)Qt的“一次編寫到處編譯”特性是剛需。其次CAN工具需要復(fù)雜的界面交互包括實(shí)時(shí)曲線繪制、報(bào)文列表、信號(hào)解析樹(shù)、多窗口布局等Qt Widgets提供了豐富且成熟的控件庫(kù)。再者Qt的信號(hào)與槽機(jī)制天然適合處理硬件數(shù)據(jù)到達(dá)信號(hào)與界面更新槽這種異步事件代碼結(jié)構(gòu)會(huì)非常清晰。最后Qt對(duì)串口、網(wǎng)絡(luò)等I/O有良好的封裝為后續(xù)封裝CAN卡驅(qū)動(dòng)庫(kù)提供了堅(jiān)實(shí)的基礎(chǔ)框架。而硬件方面選擇周立功USBCAN系列幾乎是國(guó)內(nèi)工程師的“默認(rèn)選項(xiàng)”。其市場(chǎng)占有率高文檔和社區(qū)資源相對(duì)豐富價(jià)格也比國(guó)外同類產(chǎn)品親民得多。因此這個(gè)項(xiàng)目的核心命題就變成了如何用Qt框架高效、穩(wěn)定地驅(qū)動(dòng)周立功的CAN卡并構(gòu)建一個(gè)功能完備的上位機(jī)軟件。我將其命名為“ComplexModelCanTool”意在強(qiáng)調(diào)其超越簡(jiǎn)單收發(fā)測(cè)試的復(fù)雜模型處理能力如數(shù)據(jù)庫(kù)加載DBC解析、自動(dòng)化測(cè)試腳本、數(shù)據(jù)記錄回放等。2. 環(huán)境搭建Qt與周立功SDK的融合之道工欲善其事必先利其器。開(kāi)發(fā)環(huán)境搭建是第一步也是最容易踩坑的一步。這里沒(méi)有捷徑必須嚴(yán)格按照官方路徑來(lái)走。2.1 Qt開(kāi)發(fā)環(huán)境的選擇與部署Qt版本的選擇是個(gè)學(xué)問(wèn)。追求穩(wěn)定性和兼容性我選擇了Qt 5.12 LTS版本。這是一個(gè)長(zhǎng)期支持版本bug少第三方庫(kù)兼容性好足夠滿足工業(yè)級(jí)應(yīng)用的需求。雖然Qt 6已經(jīng)發(fā)布但其在模塊拆分和部分API上的改動(dòng)可能會(huì)給依賴一些舊版第三方庫(kù)如某些圖表控件的項(xiàng)目帶來(lái)不必要的麻煩。安裝方式上強(qiáng)烈建議使用官方在線安裝器并配置國(guó)內(nèi)鏡像源以加速下載。在安裝組件時(shí)務(wù)必勾選對(duì)應(yīng)你編譯器版本的Qt套件例如我常用的是MSVC2017 64-bit。同時(shí)一定要勾選Qt Charts模塊這是后續(xù)實(shí)現(xiàn)數(shù)據(jù)可視化如總線負(fù)載率曲線、信號(hào)波形的關(guān)鍵。對(duì)于IDE我選擇Qt Creator它與Qt框架的集成度最高元對(duì)象編譯器moc、用戶界面編譯器uic等工具鏈無(wú)縫銜接調(diào)試Qt項(xiàng)目非常方便。注意避免使用過(guò)于陳舊的VS版本如VS2015搭配新Qt。我曾嘗試用Qt 5.12配置VS2015在編譯一些需要C14/17特性的第三方庫(kù)時(shí)遇到了諸多編譯錯(cuò)誤。如果公司環(huán)境強(qiáng)制要求VS2015那么可能需要回退到Qt 5.9或更早的版本但這會(huì)失去一些新特性和安全更新。2.2 周立功CAN卡驅(qū)動(dòng)與SDK獲取這是整個(gè)項(xiàng)目的硬件基石。務(wù)必前往周立功官網(wǎng)找到對(duì)應(yīng)你硬件型號(hào)如USBCAN-II Pro, USBCAN-E-U等的最新驅(qū)動(dòng)和開(kāi)發(fā)包。通常下載下來(lái)是一個(gè)壓縮包里面會(huì)包含*.dllWindows或*.soLinux動(dòng)態(tài)鏈接庫(kù)文件。*.libWindows或*.aLinux庫(kù)文件。*.h頭文件。說(shuō)明書*.pdf和示例代碼通常是VC6.0或VS的工程。第一步將設(shè)備通過(guò)USB連接電腦安裝驅(qū)動(dòng)。安裝成功后在設(shè)備管理器中應(yīng)能看到對(duì)應(yīng)的設(shè)備。第二步將開(kāi)發(fā)包中的頭文件如ControlCAN.h和庫(kù)文件組織到你的Qt項(xiàng)目目錄中。我習(xí)慣在項(xiàng)目根目錄下創(chuàng)建一個(gè)3rdparty/zhouligong的文件夾里面再分include和lib子目錄將文件分別放入。這樣結(jié)構(gòu)清晰也與項(xiàng)目代碼一起納入了版本控制。2.3 Qt項(xiàng)目工程文件.pro的關(guān)鍵配置Qt使用.pro文件來(lái)管理項(xiàng)目構(gòu)建。要讓項(xiàng)目正確鏈接周立功的庫(kù)需要在.pro文件中添加配置。這是關(guān)鍵一步配置錯(cuò)誤會(huì)導(dǎo)致編譯或運(yùn)行時(shí)找不到符號(hào)。# 指定包含頭文件的路徑 INCLUDEPATH $$PWD/3rdparty/zhouligong/include # 指定庫(kù)文件的路徑 LIBS -L$$PWD/3rdparty/zhouligong/lib # 鏈接具體的庫(kù)文件Windows下 win32 { LIBS -lControlCAN # 鏈接 ControlCAN.lib # 或者使用絕對(duì)路徑 # LIBS $$PWD/3rdparty/zhouligong/lib/ControlCAN.lib } # 如果是MinGW編譯器可能需要鏈接 .a 文件 # 如果是Linux則鏈接 .so 文件 unix:!macx { LIBS -L$$PWD/3rdparty/zhouligong/lib -lControlCAN }此外因?yàn)镃AN卡操作涉及硬件和實(shí)時(shí)數(shù)據(jù)我們通常會(huì)將核心的CAN通信模塊放在一個(gè)獨(dú)立的線程中防止阻塞GUI主線程。因此需要在.pro中啟用線程模塊QT core gui charts concurrent。concurrent模塊提供了高級(jí)的線程API如QtConcurrent::run用起來(lái)比直接使用QThread子類化更簡(jiǎn)潔。3. 核心架構(gòu)設(shè)計(jì)分層與多線程模型一個(gè)健壯的CAN工具軟件不能把所有代碼都堆在界面類里。我采用了典型的分層架構(gòu)將代碼分為硬件驅(qū)動(dòng)層、數(shù)據(jù)模型層、業(yè)務(wù)邏輯層和用戶界面層各司其職降低耦合。3.1 硬件驅(qū)動(dòng)封裝類CanDriver這是與周立功SDK直接對(duì)話的模塊。我創(chuàng)建了一個(gè)CanDriver類其主要職責(zé)是設(shè)備管理枚舉設(shè)備、打開(kāi)設(shè)備、關(guān)閉設(shè)備、初始化CAN控制器設(shè)置波特率、模式、濾波器等。數(shù)據(jù)收發(fā)提供阻塞或非阻塞的報(bào)文發(fā)送和接收接口。狀態(tài)監(jiān)控獲取設(shè)備錯(cuò)誤狀態(tài)、CAN控制器狀態(tài)、接收緩沖區(qū)幀數(shù)等。這個(gè)類的核心是封裝周立功SDK提供的C語(yǔ)言API。例如打開(kāi)設(shè)備的函數(shù)bool CanDriver::openDevice(int deviceType, int deviceIndex, int canIndex) { VCI_OpenDevice(deviceType, deviceIndex, 0); // 調(diào)用SDK函數(shù) // ... 錯(cuò)誤處理 VCI_InitCAN(deviceType, deviceIndex, canIndex, m_canConfig); // 初始化CAN // ... 錯(cuò)誤處理 VCI_StartCAN(deviceType, deviceIndex, canIndex); // 啟動(dòng)CAN // ... 錯(cuò)誤處理 m_isOpened true; return true; }這里的關(guān)鍵點(diǎn)在于錯(cuò)誤處理的完備性。周立功的SDK函數(shù)通常返回一個(gè)狀態(tài)值必須對(duì)每一個(gè)調(diào)用進(jìn)行檢查并將錯(cuò)誤代碼轉(zhuǎn)換為可讀的字符串信息通過(guò)信號(hào)發(fā)射出去供上層界面顯示。3.2 數(shù)據(jù)模型與業(yè)務(wù)邏輯CanManager CanModelCanDriver僅僅負(fù)責(zé)最底層的字節(jié)流交互。向上我們需要一個(gè)CanManager類作為業(yè)務(wù)邏輯的核心。它持有CanDriver實(shí)例并運(yùn)行在一個(gè)獨(dú)立的QThread中。CanManager線程的主循環(huán)大致如下void CanManager::run() { while (m_running) { // 1. 從驅(qū)動(dòng)層讀取一幀或多幀CAN報(bào)文 VCI_CAN_OBJ frames[100]; int count m_driver-receive(frames, 100); if (count 0) { // 2. 將原始數(shù)據(jù)轉(zhuǎn)換為內(nèi)部統(tǒng)一的數(shù)據(jù)結(jié)構(gòu)如CanFrame QVectorCanFrame canFrames; for (int i 0; i count; i) { canFrames.append(convertToCanFrame(frames[i])); } // 3. 發(fā)射信號(hào)將數(shù)據(jù)傳遞給模型層 emit framesReceived(canFrames); } // 4. 處理發(fā)送隊(duì)列如果有 processSendQueue(); // 5. 短暫休眠避免CPU空轉(zhuǎn) QThread::usleep(1000); } }CanModel類繼承自QAbstractTableModel用于在Qt的Model/View框架中管理CAN報(bào)文數(shù)據(jù)。當(dāng)CanManager發(fā)出framesReceived信號(hào)時(shí)CanModel的槽函數(shù)會(huì)被調(diào)用將新的CanFrame數(shù)據(jù)插入到其內(nèi)部容器如QListCanFrame中并調(diào)用beginInsertRows()和endInsertRows()通知視圖如QTableView更新。這種設(shè)計(jì)將數(shù)據(jù)與顯示分離非常高效。3.3 用戶界面設(shè)計(jì)與數(shù)據(jù)綁定界面使用Qt Designer設(shè)計(jì)主窗口包含幾個(gè)核心視圖報(bào)文列表視圖QTableView綁定到CanModel實(shí)時(shí)顯示時(shí)間戳、ID、數(shù)據(jù)長(zhǎng)度、數(shù)據(jù)字節(jié)、周期等信息??梢栽O(shè)置過(guò)濾、高亮特定ID。數(shù)據(jù)可視化視圖QChartView使用Qt Charts模塊將某個(gè)信號(hào)如車速、轉(zhuǎn)速的值隨時(shí)間變化繪制成曲線。發(fā)送面板允許用戶手動(dòng)編輯ID、數(shù)據(jù)選擇發(fā)送方式單次、周期并管理發(fā)送列表。狀態(tài)欄顯示連接狀態(tài)、總線錯(cuò)誤計(jì)數(shù)、幀率等。數(shù)據(jù)綁定的精髓在于正確連接信號(hào)與槽。例如// 在MainWindow構(gòu)造函數(shù)中 m_canManager new CanManager(this); m_canModel new CanModel(this); // 將Manager收到的數(shù)據(jù)信號(hào)連接到Model的插入槽 connect(m_canManager, CanManager::framesReceived, m_canModel, CanModel::appendFrames); // 將Model的數(shù)據(jù)變化信號(hào)連接到TableView的更新 m_ui-tableView-setModel(m_canModel); // 將發(fā)送按鈕的點(diǎn)擊信號(hào)連接到Manager的發(fā)送槽 connect(m_ui-sendButton, QPushButton::clicked, this, MainWindow::onSendButtonClicked);4. 關(guān)鍵功能實(shí)現(xiàn)細(xì)節(jié)與避坑指南有了架構(gòu)接下來(lái)就是填充血肉。以下幾個(gè)功能的實(shí)現(xiàn)細(xì)節(jié)和遇到的坑值得詳細(xì)分享。4.1 實(shí)時(shí)報(bào)文接收與高性能渲染CAN總線數(shù)據(jù)速率可能很高500kbps, 1Mbps這意味著GUI可能每秒需要處理成千上萬(wàn)條報(bào)文更新。如果處理不當(dāng)界面會(huì)卡死。解決方案1批量更新降低頻率。不要在每收到一幀報(bào)文時(shí)就更新一次界面。CanManager的接收線程可以積累一定數(shù)量的報(bào)文比如每100ms或積累100幀然后通過(guò)信號(hào)一次性發(fā)射給CanModel。CanModel也是批量插入數(shù)據(jù)再通知視圖更新。這能極大減少跨線程通信和界面重繪的開(kāi)銷。解決方案2使用委托Delegate進(jìn)行自定義繪制。對(duì)于報(bào)文列表如果只是簡(jiǎn)單文本性能尚可。但如果想根據(jù)ID不同顯示不同背景色或者將數(shù)據(jù)字節(jié)解析為物理值顯示直接在data()函數(shù)中計(jì)算會(huì)拖慢速度。更好的做法是在CanFrame結(jié)構(gòu)體中就計(jì)算好這些“顯示值”如顏色枚舉、解析后的字符串data()函數(shù)只做簡(jiǎn)單的返回。對(duì)于更復(fù)雜的繪制如繪制數(shù)據(jù)字節(jié)的波形預(yù)覽可以繼承QStyledItemDelegate在paint()函數(shù)中實(shí)現(xiàn)但要注意性能。我踩過(guò)的坑最初我在CanModel::data()的Qt::DisplayRole分支中實(shí)時(shí)調(diào)用DBC數(shù)據(jù)庫(kù)解析函數(shù)將CAN ID和數(shù)據(jù)字節(jié)轉(zhuǎn)換為信號(hào)值字符串。當(dāng)報(bào)文速率超過(guò)1000幀/秒時(shí)滾動(dòng)列表變得異常卡頓。后來(lái)改為在CanManager線程中提前完成解析將解析好的字符串存入CanFrame性能問(wèn)題立刻解決。4.2 DBC數(shù)據(jù)庫(kù)解析與信號(hào)提取這是“ComplexModel”中“Model”一詞的重要體現(xiàn)。DBC文件描述了CAN報(bào)文ID與其中包含的多個(gè)信號(hào)如車速、水溫之間的映射關(guān)系包括信號(hào)起始位、長(zhǎng)度、精度、偏移量、單位等。我們需要一個(gè)DbcParser類來(lái)加載和解析DBC文件??梢允褂瞄_(kāi)源庫(kù)如cantoolsPython的C移植版或者自己實(shí)現(xiàn)一個(gè)簡(jiǎn)單的解析器。解析后在內(nèi)存中建立結(jié)構(gòu)Message包含多個(gè)Signal。當(dāng)收到一幀CAN報(bào)文時(shí)CanManager線程會(huì)根據(jù)其ID查找對(duì)應(yīng)的Message定義然后根據(jù)每個(gè)Signal的定義從報(bào)文數(shù)據(jù)字節(jié)中提取出原始值再通過(guò)公式物理值 原始值 * 精度 偏移量計(jì)算出物理值。這個(gè)計(jì)算過(guò)程可以放在工作線程中避免阻塞GUI。關(guān)鍵細(xì)節(jié)字節(jié)序Endianness。DBC文件中用Motorola大端或Intel小端來(lái)定義信號(hào)的字節(jié)序。提取信號(hào)時(shí)必須正確處理。一個(gè)常見(jiàn)的錯(cuò)誤是混淆了這兩種格式導(dǎo)致解析出的數(shù)值完全錯(cuò)誤。我的做法是寫一個(gè)獨(dú)立的、經(jīng)過(guò)充分單元測(cè)試的函數(shù)來(lái)處理位提取確保其正確性。4.3 周期發(fā)送與硬件時(shí)間同步手動(dòng)發(fā)送很簡(jiǎn)單難點(diǎn)在于高精度的周期發(fā)送。例如要求每20ms精確發(fā)送一幀報(bào)文。如果單純?cè)贑anManager線程中用QThread::msleep(20)然后發(fā)送精度會(huì)很差因?yàn)榫€程調(diào)度和系統(tǒng)負(fù)載會(huì)帶來(lái)抖動(dòng)。更優(yōu)的方案是使用硬件定時(shí)發(fā)送如果CAN卡支持。周立功的一些高端型號(hào)如USBCAN-E-U支持在驅(qū)動(dòng)層設(shè)置報(bào)文的發(fā)送周期由硬件FPGA或芯片級(jí)定時(shí)器來(lái)保證精度。這需要調(diào)用特定的SDK函數(shù)如VCI_SetReference配合定時(shí)發(fā)送參數(shù)。這是首選方案。如果硬件不支持則需要在軟件層面優(yōu)化。使用QTimer并設(shè)置其類型為Qt::PreciseTimer。但即使這樣其精度也在毫秒級(jí)且受系統(tǒng)影響。對(duì)于要求不嚴(yán)苛的測(cè)試如100ms周期可以接受。對(duì)于更高要求可以考慮使用多媒體定時(shí)器Windows或高精度時(shí)鐘Linux的clock_nanosleep但這會(huì)犧牲跨平臺(tái)性。另一個(gè)坑時(shí)間戳的同步。接收到的報(bào)文時(shí)間戳是CAN卡硬件產(chǎn)生的還是驅(qū)動(dòng)層收到時(shí)軟件生成的周立功的VCI_CAN_OBJ結(jié)構(gòu)體中有TimeStamp字段但需要查閱具體型號(hào)的手冊(cè)來(lái)確認(rèn)其基準(zhǔn)和單位。在顯示和記錄時(shí)需要統(tǒng)一轉(zhuǎn)換為一個(gè)易讀的格式如自啟動(dòng)后的毫秒數(shù)并注意不同CAN通道之間時(shí)間戳的同步問(wèn)題。4.4 數(shù)據(jù)記錄與回放功能記錄功能看似簡(jiǎn)單直接將收到的CanFrame結(jié)構(gòu)寫入文件即可。但為了效率和可讀性需要考慮文件格式純文本如CSV便于查閱但體積大二進(jìn)制格式體積小、寫入快但需要自定義解析。我選擇了混合格式文件頭用文本記錄DBC文件路徑、開(kāi)始時(shí)間等元數(shù)據(jù)數(shù)據(jù)部分用二進(jìn)制緊湊存儲(chǔ)。寫入策略不應(yīng)在接收線程中同步寫文件。應(yīng)該將待記錄的幀放入一個(gè)線程安全的隊(duì)列如QQueue加QMutex或使用QList和QReadWriteLock由一個(gè)專門的LogWriter線程負(fù)責(zé)從隊(duì)列中取出數(shù)據(jù)并寫入文件。這避免了因磁盤I/O慢而阻塞數(shù)據(jù)接收?;胤趴刂苹胤艜r(shí)需要按照記錄的時(shí)間戳來(lái)模擬實(shí)時(shí)接收。使用一個(gè)定時(shí)器根據(jù)相鄰兩幀的時(shí)間差來(lái)觸發(fā)數(shù)據(jù)發(fā)射。同時(shí)要支持暫停、快進(jìn)、跳轉(zhuǎn)。這里的關(guān)鍵是回放引擎PlaybackEngine也應(yīng)該通過(guò)發(fā)射與CanManager相同的framesReceived信號(hào)來(lái)驅(qū)動(dòng)CanModel和界面更新這樣界面顯示和數(shù)據(jù)分析模塊無(wú)需任何修改就能同時(shí)用于實(shí)時(shí)數(shù)據(jù)和回放數(shù)據(jù)。5. 跨平臺(tái)部署與打包實(shí)戰(zhàn)項(xiàng)目開(kāi)發(fā)主要在Windows下進(jìn)行但最終需要發(fā)布到Linux環(huán)境。Qt的跨平臺(tái)特性在這里大放異彩但仍有細(xì)節(jié)需要注意。5.1 Linux下的驅(qū)動(dòng)與編譯在Linux下周立功提供了.so動(dòng)態(tài)庫(kù)和對(duì)應(yīng)的頭文件。編譯環(huán)節(jié)與Windows類似只需在.pro文件中正確指定Linux下的庫(kù)路徑和名稱。最大的挑戰(zhàn)在于設(shè)備權(quán)限。Linux下USB設(shè)備默認(rèn)通常只有root用戶可訪問(wèn)。為了讓普通用戶能運(yùn)行我們的程序有兩種方法創(chuàng)建udev規(guī)則。在/etc/udev/rules.d/目錄下創(chuàng)建一個(gè)規(guī)則文件如99-usbcan.rules內(nèi)容類似SUBSYSTEMusb, ATTR{idVendor}1234, ATTR{idProduct}5678, MODE0666其中idVendor和idProduct需要通過(guò)lsusb命令查詢周立功CAN設(shè)備的ID。然后重新加載udev規(guī)則或重啟。這樣設(shè)備節(jié)點(diǎn)如/dev/ttyUSB*或/dev/usbcan*的權(quán)限就會(huì)對(duì)所有用戶可讀可寫。程序啟動(dòng)時(shí)提權(quán)不推薦??梢杂胮kexec或sudo啟動(dòng)但這破壞了用戶體驗(yàn)和安全性。5.2 使用CMake構(gòu)建與打包雖然Qt Creator默認(rèn)使用qmake但對(duì)于復(fù)雜項(xiàng)目尤其是需要集成大量第三方庫(kù)如周立功SDK、DBC解析庫(kù)時(shí)CMake是更現(xiàn)代、更強(qiáng)大的選擇。CMake能更好地管理依賴、條件編譯Windows/Linux和安裝規(guī)則?;镜腃MakeLists.txt框架需要包含cmake_minimum_required(VERSION 3.16) project(ComplexModelCanTool LANGUAGES CXX) set(CMAKE_CXX_STANDARD 11) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 查找Qt包必需組件 find_package(Qt5 COMPONENTS Core Gui Widgets Charts Concurrent REQUIRED) # 包含當(dāng)前目錄和頭文件目錄 include_directories(${CMAKE_CURRENT_SOURCE_DIR}) include_directories(${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/zhouligong/include) # 添加源代碼 add_executable(ComplexModelCanTool main.cpp mainwindow.cpp ... ) # 鏈接Qt庫(kù)和周立功庫(kù) target_link_libraries(ComplexModelCanTool Qt5::Core Qt5::Gui Qt5::Widgets Qt5::Charts Qt5::Concurrent) # 平臺(tái)特定的鏈接 if(WIN32) target_link_libraries(ComplexModelCanTool ${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/zhouligong/lib/ControlCAN.lib) elseif(UNIX AND NOT APPLE) target_link_libraries(ComplexModelCanTool ${CMAKE_CURRENT_SOURCE_DIR}/3rdparty/zhouligong/lib/libControlCAN.so) endif()5.3 打包發(fā)布Windows與Linux的差異開(kāi)發(fā)完成后需要將程序打包分發(fā)給最終用戶他們不可能安裝完整的Qt開(kāi)發(fā)環(huán)境。Windows下使用windeployqt工具。這是Qt自帶的部署工具。在Qt命令行環(huán)境中進(jìn)入你的程序編譯輸出目錄包含.exe文件的目錄執(zhí)行windeployqt ComplexModelCanTool.exe它會(huì)自動(dòng)掃描.exe文件依賴的Qt庫(kù)DLL并復(fù)制到當(dāng)前目錄。但是它不會(huì)復(fù)制周立功的ControlCAN.dll你必須手動(dòng)將這個(gè)dll復(fù)制到.exe同級(jí)目錄。此外如果程序使用了Qt插件如圖像格式插件、SQL驅(qū)動(dòng)插件可能需要通過(guò)--qmldir等參數(shù)來(lái)確保它們也被部署。最后可以使用Inno Setup或NSIS等工具制作安裝程序。Linux下情況更復(fù)雜一些。理論上也可以使用linuxdeployqt類似的工具但實(shí)踐中更常見(jiàn)的方式是將程序依賴的Qt庫(kù).so文件打包。可以編寫一個(gè)腳本使用ldd命令遞歸查找所有依賴的.so文件并復(fù)制到一個(gè)lib文件夾中。編寫一個(gè)啟動(dòng)腳本run.sh在運(yùn)行程序前通過(guò)export LD_LIBRARY_PATH./lib:$LD_LIBRARY_PATH來(lái)指定庫(kù)的搜索路徑。同樣需要將周立功的libControlCAN.so文件放入lib目錄。將整個(gè)文件夾包含可執(zhí)行文件、lib目錄、啟動(dòng)腳本、必要的資源文件打包成tar.gz分發(fā)給用戶。避坑提示在Linux下打包時(shí)務(wù)必在與目標(biāo)系統(tǒng)glibc版本相近的環(huán)境中編譯和打包。如果你在Ubuntu 22.04glibc 2.35下編譯打包的程序可能無(wú)法在CentOS 7glibc 2.17上運(yùn)行會(huì)報(bào)“找不到版本GLIBC_2.33”之類的錯(cuò)誤。解決方法是使用老版本的系統(tǒng)進(jìn)行編譯或者使用Docker容器構(gòu)建。6. 調(diào)試技巧與性能優(yōu)化開(kāi)發(fā)過(guò)程中調(diào)試CAN通信問(wèn)題需要一些特殊手段。技巧1善用周立功自帶的CANTest工具。在開(kāi)發(fā)初期不要急于寫代碼。先用官方的CANTest工具連接設(shè)備發(fā)送和接收?qǐng)?bào)文確認(rèn)硬件、驅(qū)動(dòng)、連線、波特率設(shè)置全部正確。這能幫你快速定位問(wèn)題是出在硬件層還是軟件層。技巧2在代碼中增加詳盡的日志輸出。在CanDriver類的每個(gè)關(guān)鍵函數(shù)打開(kāi)、初始化、發(fā)送、接收入口和出口以及錯(cuò)誤分支都使用qDebug()或?qū)懭肴罩疚募敵鲈敿?xì)信息如函數(shù)名、參數(shù)、返回碼。當(dāng)通信異常時(shí)這些日志是無(wú)價(jià)之寶。技巧3模擬數(shù)據(jù)注入。為了在不連接真實(shí)CAN總線的情況下測(cè)試界面和邏輯我實(shí)現(xiàn)了一個(gè)“模擬驅(qū)動(dòng)”模式。創(chuàng)建一個(gè)SimulatedCanDriver類它繼承自與CanDriver相同的接口但內(nèi)部使用一個(gè)定時(shí)器隨機(jī)生成CAN報(bào)文數(shù)據(jù)。通過(guò)在代碼中切換CanManager使用的驅(qū)動(dòng)實(shí)例就能無(wú)縫地在真實(shí)硬件和模擬數(shù)據(jù)之間切換極大方便了UI和業(yè)務(wù)邏輯的調(diào)試。性能優(yōu)化點(diǎn)減少內(nèi)存分配在高速接收路徑上CanManager::run循環(huán)避免頻繁的new/delete或QVector/QList的擴(kuò)容。可以預(yù)分配一個(gè)固定大小的VCI_CAN_OBJ數(shù)組循環(huán)使用。使用移動(dòng)語(yǔ)義當(dāng)將數(shù)據(jù)從CanManager線程傳遞到CanModel時(shí)如果CanFrame結(jié)構(gòu)體較大應(yīng)使用std::move或Qt的隱式共享類來(lái)避免深拷貝。界面渲染優(yōu)化對(duì)于報(bào)文列表如果行數(shù)過(guò)多如超過(guò)10萬(wàn)行考慮啟用QTableView的setUniformRowHeights(true)并合理使用setViewMode。對(duì)于實(shí)時(shí)曲線設(shè)置QChart的animationOptions為QChart::NoAnimation并限制顯示的數(shù)據(jù)點(diǎn)數(shù)量如只顯示最近1000個(gè)點(diǎn)否則滾動(dòng)和更新會(huì)非??D。7. 擴(kuò)展思考從工具到平臺(tái)當(dāng)基礎(chǔ)功能穩(wěn)定后這個(gè)“ComplexModelCanTool”可以朝著更平臺(tái)化的方向發(fā)展這也是我后續(xù)迭代的思路。插件化架構(gòu)將核心功能模塊如DBC解析器、報(bào)文發(fā)送器、圖形分析器、腳本引擎設(shè)計(jì)為插件。主程序只提供插件管理框架和基本UI。這樣不同的團(tuán)隊(duì)或項(xiàng)目可以開(kāi)發(fā)自己的專用插件而無(wú)需修改主程序代碼。Qt本身對(duì)插件QPluginLoader有很好的支持。集成腳本引擎集成一個(gè)輕量級(jí)的腳本引擎如Lua或JavaScriptQt的QJSEngine。用戶可以通過(guò)編寫腳本實(shí)現(xiàn)復(fù)雜的自動(dòng)化測(cè)試流程例如收到某ID報(bào)文后等待100ms再發(fā)送一組特定報(bào)文并檢查總線響應(yīng)。這大大提升了工具的靈活性。網(wǎng)絡(luò)透明化將CAN數(shù)據(jù)通過(guò)TCP/UDP協(xié)議轉(zhuǎn)發(fā)出去。這樣可以在一臺(tái)機(jī)器上連接CAN卡而多臺(tái)機(jī)器上的分析工具甚至是用Python、C#寫的工具都能同時(shí)接收到實(shí)時(shí)數(shù)據(jù)流便于分布式測(cè)試和數(shù)據(jù)分析。與持續(xù)集成CI結(jié)合將工具的命令行版本集成到CI/CD流水線中。例如在每晚構(gòu)建后自動(dòng)運(yùn)行一組CAN總線通信測(cè)試用例工具根據(jù)預(yù)定義的腳本執(zhí)行測(cè)試并生成測(cè)試報(bào)告通過(guò)/失敗實(shí)現(xiàn)自動(dòng)化驗(yàn)證。回過(guò)頭看從最初一個(gè)簡(jiǎn)單的收發(fā)測(cè)試需求到構(gòu)建出一個(gè)支持復(fù)雜模型、具備良好架構(gòu)和擴(kuò)展性的桌面工具整個(gè)過(guò)程是對(duì)Qt框架應(yīng)用、硬件交互、多線程編程和軟件設(shè)計(jì)的一次全面鍛煉。最深的體會(huì)是前期在架構(gòu)和分層上多花一分心思后期在添加功能和排查問(wèn)題上就能省去十分力氣。尤其是在處理像CAN這種實(shí)時(shí)數(shù)據(jù)流時(shí)清晰的數(shù)據(jù)流邊界和線程模型是保證軟件穩(wěn)定和響應(yīng)迅速的生命線。本文還有配套的精品資源點(diǎn)擊獲取