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