麒麟KY-RTI分佈模擬技術:第五章 Qt程式設計
第五章 Qt程式設計
本章講述瞭如何基於Qt Creator設計控制檯程式和圖形介面程式。控制檯程式相當於4.3節的聊天程式;圖形介面程式相當於4.4節的時間管理程式。圖形介面程式近似於真實模擬專案,講述瞭如何設計模擬專案,如何週期性地推進模擬,如何通過Qt臨界區和pthread訊號量實現主執行緒和回撥執行緒之間的同步等功能。
5.1 控制檯程式
本節說明如何開發一個Qt控制檯程式,其結果表明將基於KY-RTI開發的GNU C++程式移植到Qt非常方便。
5.1.1需求分析
本專案需要基於Qt Creator開發一個相當於4.3節的Qt聊天程式。
5.1.2專案設計
基於Qt Creator先實現一個Qt程式框架,然後把4.3節的GNU C++聊天程式程式碼移植到Qt程式。
5.1.3專案開發
下面以銀河麒麟作業系統中的Qt Creator為例。
第1步
圖5.1 啟動Qt Creator
第2步:選擇“Qt Console Application”建立一個控制檯專案。點選“Choose”繼續。
圖5.2 建立控制檯專案
第3步:設定專案名稱為“QtChatConsole”、儲存目錄為“/home/lbq”,點選“Next”繼續,直至專案生成。
圖5.3 設計專案名和目錄
圖5.4是專案生成後的介面。到目前為止,本專案有1個QtChatConsole.pro工程檔案和1個main.cpp原始碼檔案。
圖5.4 預設生成的Qt控制檯專案
第4步:新增HLA回撥檔案。使用者應根據自己的目錄適當修改。
(1)將RTI-1.3NGv6/Linux-x86_64-opt-mt/apps/chat目錄下的HwFederateAmbassador.cpp、HwFederateAmbassador.hh兩個檔案拷貝到該工程目錄下。這兩個檔案是4.3節聊天程式的原始檔。
cd /home/lbq/RTI-1.3NGv6/Linux-x86_64-opt-mt/apps/chat
cp HwFederateAmbassador.cpp HwFederateAmbassador.hh /home/lbq/QtChatConsole/
(2)在圖5.4中,選擇根節點“QtChatConsole”,按右鍵,新增已有檔案。將HwFederateAmbassador.cpp、HwFederateAmbassador.hh新增到本專案。
第5步:修改main.cpp。
將RTI-1.3NGv6/Linux-x86_64-opt-mt/apps/chat目錄下的Chat.cpp程式碼貼上到main.cpp,並做簡單修改,區別只在於第1、123-126這幾行語句。
表5.1 main.cpp
|
5.1.4編譯執行
5.1.4.1編譯
編譯之前,需要修改工程檔案。雙擊“QtChatConsole.pro”,開啟該檔案。在檔案末尾新增如下內容:
INCLUDEPATH += /home/lbq/RTI-1.3NGv6/Linux-x86_64-opt-mt/include
LIBS += -L/home/lbq/RTI-1.3NGv6/Linux-x86_64-opt-mt/lib -lRTI-NG -lfedtime -lMid -lMidUtil -lbz2mid -lpthread
DEFINES += RTI_USES_STD_FSTREAM
通過下列兩種編譯方式,生成可執行程式QtChatConsole。
(1)由Qt Creator構建(Build)。Qt Creator在構建專案時,會將生成的可執行程式和臨時檔案預設儲存到/home/lbq/build-QtChatConsole-Desktop-Debug目錄,而不是原始碼目錄。
(2)在原始碼目錄手動構建,執行如下命令。
qmake
make
5.1.4.2測試執行
執行程式:
(1)啟動KY-RTI。
(2)在圖5.4中,點選2次執行按鈕,啟動2個介面;或者啟動2個命令列介面,執行程式。如下圖所示。
問題:左圖liu傳送一個“hello”,但是右圖zhang卻沒有收到。
圖5.5 開啟tick開關後執行控制檯程式
原因:當程式執行時,會預設生成RTI.rid檔案。該檔案中打開了tick開關,然而本程式並沒有呼叫tick服務來接收回調,因此無法收到應答。
解決:將RTI.rid檔案中的“;; UsingTickSwitch On”改為“;; UsingTickSwitch Off”。若沒有RTI.rid,則執行程式後會自動生成該檔案。
重新啟動程式後,執行正常。
圖5.6 關閉tick開關後執行控制檯程式
5.2 圖形程式
本節說明如何從專案需求開始,從頭設計和開發一個Qt圖形介面的HLA時間管理程式,功能相當於4.4節的GNU C++時間管理程式。整個專案分為4個階段:需求分析、專案設計、程式碼設計、編譯執行。其中,需求分析階段與HLA/RTI關係不大,甚至整個專案的設計框架與HLA/RTI關係也不大。模擬應用的需求千千萬,Qt的設計模式也多樣化,不同的模擬應用可採用不同的設計模式;HLA/RTI服務於模擬應用,用於系統中的不同模擬成員之間的資料通訊。HLA/RTI為模擬應用提供支援,而不是模擬應用反過來受HLA/RTI的制約,希望使用者通過本程式的設計過程能夠體會到這一點。現有的一些HLA/RTI程式碼自動生成工具實際上就是給使用者設計系統制定了一個約束框架,不管什麼型別的模擬專案都裝到一個套子裡,使得使用者設計程式缺乏較強的靈活性,也不利於基於HLA/RTI移植已有的非HLA/RTI專案。
5.2.1需求分析
本模擬專案的名稱為“TimeManagementExample”,當然也可以叫做像“星球大戰”、“世界末日”之類的響亮名字。名稱規定了不是“TimeManagementExample”的程式不屬於本專案。對HLA/RTI程式來說,聯邦名稱為“TimeManagementExample”,不是該名字的模擬成員不屬於本專案。
每個模擬成員擁有3架飛機,但其中只有1架飛機會起飛,飛機的x、y座標為隨機數(不考慮合理性),飛機每隔1秒釋出自己的二維態勢資訊。
要求採用圖形介面顯示模擬結果。
5.2.2專案設計
本專案所有模擬成員的功能相同,因此只需要開發一個Qt程式即可。在多次啟動該可執行程式後,多個模擬成員之間通過KY-RTI進行資料通訊。本專案的聯邦名稱為“TimeManagementExample”,模擬成員之間的通訊資料通過tracer.fed進行定義,包括一個plane物件類和xPos、yPos兩個屬性。另外,模擬週期為1秒,每個模擬成員週期性地釋出飛機起飛後的位置資訊,並接收其他飛機的位置資訊。
Qt圖形程式包含2個圖形介面。一個圖形介面負責當程式啟動執行時,輸入模擬成員名稱;另一個圖形介面用來接收其他模擬成員的飛機位置資訊;由於接收的位置資訊會累積很多,所以當超過1000條資訊時清空1次(在實際專案中可儲存到資料庫)。
時間間隔採用Qt定時器來設計,定時器每隔1秒中斷1次。
圖5.7 模擬成員的2個圖形介面示意圖
5.2.3程式碼設計
第1步:啟動Qt Creator,選擇“New Project”建立一個Qt專案。
圖5.8 啟動Qt Creator
第2步:選擇“Qt Widgets Application”建立一個圖形程式。點選“Choose”繼續。
圖5.9 建立圖形介面程式
第3步:設定專案名稱“QtTimeManagement”和儲存的目錄“/home/lbq”,點選“Next”繼續,中間過程選擇預設選項,直至專案生成。圖5.10是專案生成後的介面。
圖5.10 預設生成的圖形程式介面
程式執行後的圖形介面如下圖所示。該介面為主介面,可作為“專案設計”階段確定的介面2,後面需要再設計介面1來輸入模擬成員名稱,另外還需要完善主介面。
圖5.11 執行生成的圖形介面程式
第4步:建立介面1,用於輸入模擬成員名。
(1)右鍵點選圖5.10中的“Forms”,新建一個窗體。後面過程可參考下列幾幅圖,類名設定為NameDialog。
圖5.12 選擇窗體型別
圖5.13 選擇對話方塊模板
圖5.14 設定類名
(2)為新建的NameDialog窗體新增QLabel、QLineEdit、QPushButton共3個控制元件,設定QLabel為“請輸入模擬成員名稱”並調整字型大小。編輯框的變數名預設設定為lineEdit。
圖5.15 設定介面1中的控制元件
(3)為OK按鈕新增Click事件。與介面1相關的namedialog.h和namedialog.cpp就設計完成,分別如表5.2和表5.3所示。
表5.2 namedialog.h
|
表5.3 namedialog.cpp
|
第5步:設計介面2。
(1)刪除MainWindow主介面窗體中的選單、工具條、狀態列,新增1個QLabel和1個QListWidget控制元件,分別用於顯示模擬成員名和顯示接收到的飛機態勢資訊。
圖5.16 設定介面2中的控制元件
(2)新增定時器。到目前為止,整個程式的程式碼框架就已經完成,該框架本身與HLA/RTI並沒有太大關係。執行程式結果如下圖所示。左圖為介面1,右圖為介面2,右圖中的資料為程式設計的假想資料。
圖5.17 基於假想資料的程式執行結果
程式由5個原始檔組成,除了表5.2和表5.3表示的namedialog.h、namedialog.cpp外,還有3個檔案main.cpp、mainwindow.h、mainwindow.cpp,參見表5.4、表5.5、表5.6。
表5.4 main.cpp
|
表5.5 mainwindow.h
|
表5.6 mainwindow.cpp
|
第6步:以上步驟構成的系統是靜態的,當啟動多次時,每個模擬成員都是獨立執行,模擬成員之間不能進行資料通訊。因此,需要加入HLA/RTI程式碼將模擬成員變成動態的,實現相互間的通訊。在已有的模擬系統中加入HLA/RTI程式碼,基本方法是:
(1)刪除已有程式中的通訊程式碼(例如TCP/IP程式碼)。對本例而言,沒有這部分內容。
(2)在程式的初始化部分新增建立聯邦執行、加入聯邦執行、公佈和訂購服務、註冊物件示例等;如果採用時間管理,則還要設定相關的時間管理標識(是否為受限成員、管控成員)。
對於本例而言,初始化部分為MainDialog類的建構函式;因此,在該建構函式中完成這些工作,需要新增的程式碼可參考4.4節時間管理示例的TimeManagement.cpp。
(3)MainWindow::onTimerOut()函式每秒執行1次,在一個模擬週期內主要處理2件事。一是該模擬週期內收到回撥後應該採取的動作;二是將自己下一步的態勢釋出出去。對於本例而言,一是將收到的其他飛機的態勢資訊顯示出來;而是呼叫HLA的updateAttributeValues服務更新飛機的下一步位置,並將模擬時間請求推進到下一步。當然,依照模擬模型不同,如果每個模擬週期只更新自己的當前態勢資訊,也未嘗不可;但這樣的訊息在HLA中應定義為RO(Receive Order)訊息而不是TSO(Time Stamp Order)訊息。
(4)添加回調檔案。
(a)將RTI-1.3NGv6/Linux-x86_64-opt-mt/apps/time-notick目錄下的HwFederateAmbassador.cpp、HwFederateAmbassador.hh兩個檔案拷貝到該工程目錄下。
cd /home/lbq/RTI-1.3NGv6/Linux-x86_64-opt-mt/apps/time-notick
cp HwFederateAmbassador.cpp HwFederateAmbassador.hh /home/lbq/QtTimeManagement/
(b)在圖5.4中,選擇根節點“QtTimeManagement”,按右鍵,新增已有檔案。將HwFederateAmbassador.cpp、HwFederateAmbassador.hh新增到本專案。
至此,整個程式碼設計完成。整個程式包括namedialog.h、mainwindow.h、HwFederateAmbassador.h 3個.h檔案,以及main.cpp、namedialog.cpp、mainwindow