應用筆記 | TSMaster——圖形編輯面板功能模塊簡介

圖形編輯面板

TSMaster 圖形編輯面板讓用戶能夠開發(fā)自己的圖形窗口，用于處理報文的收發(fā)，信號解析顯示等功能。

一 工具欄

1. 模式選擇按鈕，主要包含如下模式：

1）按下狀態(tài)時候，當前 Panel 處于編輯模式下，用戶可以增加刪除控件，編輯控件屬性的。

2）彈起狀態(tài)，當前 Panel 處于測試運行模式，顯示的是該面板實際運行時的狀態(tài)，用戶不可進行編輯。

3）灰色狀態(tài)，當前 Panel 處于運行狀態(tài)。意味著當前 TSMaster 處于設(shè)備連接運行狀態(tài)。如果用戶想重新編輯界面，必須斷開 TSMaster 連接，才可以進入編輯狀態(tài)。

2. 層疊控制

當出現(xiàn)控件層疊情況時，把控件移動到前面和把控件移動到后面。

3. 對齊控件

控件對齊分為兩步：

1）首先選擇需要對齊的多個控件：按住 Ctrl 鍵，鼠標點擊多個按鈕，則選中多個控件。如下所示：

2）選擇頂部菜單欄的對齊按鈕，如下所示：

對齊選項有：

? Align Left：左對齊

? Align Right：右對齊

? Align Top：上對齊

? Align Buttom：下對齊

? Center Horizontally：以中間模塊為準水平對齊

? Center Vertically：以中間模塊為準垂直對齊

? Distribute Horizontally:：橫向均勻排布

以最左邊和最右邊一個控件的坐標為準，計算控件之間間隔的平均值，然后在橫向上均勻排列。

? Distribute Vertically:：縱向均勻排布

以最上面和最下面一個控件的坐標為準，計算控件之間間隔的平均值，然后在縱向上均勻排列。

4.新建 Panel

創(chuàng)建全新的 Panel，此操作將刪除 Panel 所有現(xiàn)有的控件。

5. 加載配置

載入現(xiàn)有 Panel 配置文件。

6. 存儲配置

存儲當前 Panel 的配置文件。

7.Panel 參數(shù)配置

主要包含如下參數(shù)配置：

? Feature Enable：是否使能 Panel

? Layout：Panel 內(nèi)部控件整體布局

? Design Time：設(shè)計時是否顯示鏈接標簽和控件名稱

? Refresh Rate：配置 Panel 數(shù)據(jù)的刷新時間。推薦刷新時間為 300ms。如果電腦配置較高，可以配置更高的刷新率

二 控件基本操作

1. 添加控件

2. 刪除控件

直接 Delete 鍵，或者右鍵，快捷菜單選擇刪除。

3. 移動控件

控件都會有自己所在的容器，在容器范圍內(nèi)，想調(diào)整位置，直接選中控件，左鍵按住，移動即可。如下所示：

4.移動到容器外面

TSMaster 不支持直接拖拽到容器外面，如果要把控件移出容易，可以采用剪切（Ctrl+X）+ 粘貼（Ctrl+V）的方式可以把控件移動到容器外面。

5.顯示控件類型名

在設(shè)計時（Design Time）階段，默認是顯示控件的名稱（這個名稱是控件的唯一 ID，是系統(tǒng)默認分配的，不能修改，在運行時不可見）的，如下圖所示：

如果在設(shè)計階段不想看到控件的唯一名稱，可以到 Settings 界面中進行設(shè)置，如下所示：

6.顯示控件關(guān)聯(lián)的變量鏈接

在設(shè)計時（Design Time）階段，用戶可以設(shè)置顯示當前控件所關(guān)聯(lián)的變量(CAN/LIN 信號或者系統(tǒng)變量等)，便于設(shè)計者清晰的知道當前該控件所關(guān)聯(lián)的信號值，如下圖所示：

在設(shè)計時階段，打開和關(guān)閉該關(guān)聯(lián)信號的顯示，跟打開和關(guān)閉控件名稱的顯示操作是一樣的，如下圖所示：

三 UI事件

TSMaster 提供了豐富的 Panel 界面。通過關(guān)聯(lián)變量，可以實現(xiàn)變量值的修改，或者變量值修改過后在 UI 界面上呈現(xiàn)，這些都比較好理解。如果用戶要實現(xiàn)按下按鍵過后，TSMaster 軟件發(fā)送一串報文，則需要配合 C 腳本實現(xiàn) UI 事件機制。

UI 事件機制

Panel 的事件機制架構(gòu)圖如下圖所示：

Panel 事件機制的實現(xiàn)，簡單來說可以概括如下：Panel 中用戶輸入（按下按鍵，輸入數(shù)值等）->改變關(guān)聯(lián)的小程序變量的值->觸發(fā) C 腳本中數(shù)值變化事件->在事件中執(zhí)行用戶想執(zhí)行的代碼即可。下面以按鍵發(fā)送報文為例講解 UI 事件的添加過程。

四 釋疑

1.為啥 DBC 解析是對的，Panel 上控件顯示不對？

問題描述：

為什么信號值 DBC 解析出來是 12%，但是儀表盤上總是顯示 1.0（100%）

查看信號定義，因為信號值定義的范圍是 0—100，單位為”%”,解析出來的信號值為12%，代表信號值為 12，然后單位是字符串”%”，并不是信號值是 0.12。因此，儀表盤的范圍應該是 0—100，跟信號定義中的范圍是一致的。如果儀表盤的范圍設(shè)置為 0—1,則當信號值顯示為 12%的時候，儀表盤當然會顯示到最大值 1。

解決辦法：

設(shè)置儀表控件屬性，調(diào)整該控件的顯示范圍跟信號的范圍一樣。從 0-1 調(diào)整為 0-100，調(diào)整過后，儀表盤顯示正常。

2. 添加了 DBC，為啥通過 Panel 關(guān)聯(lián)信號的時候看不到任何信號？

問題描述：

加載了示例數(shù)據(jù)庫：TOSUN_Hardware_Synthesize

可以看到，有報文，有信號等。

在面板中，添加 InputOutputBox，選擇關(guān)聯(lián)一個 CAN 信號，結(jié)果界面如下：

此時如果用單存顯示控件，如 Progressbar 等關(guān)聯(lián)信號，是可以看到信號的。

原因分析：

InputBox 是輸入信號，這種信號從邏輯上來說需要被修改并發(fā)送到總線上，因此必須關(guān)聯(lián)到一個發(fā)送節(jié)點的 CAN 信號上。然后我們繼續(xù)看這個數(shù)據(jù)庫：

可見，節(jié)點數(shù)量為 0，也就是沒有任何發(fā)送和接收節(jié)點。這種情況下是無法啟動 RBS仿真的，因為沒有發(fā)生節(jié)點，也就看不到任何跟發(fā)送節(jié)點相關(guān)的信號了。

解決辦法：

添加發(fā)送節(jié)點，并把報文和信號關(guān)聯(lián)到發(fā)送節(jié)點上，就可以看到信號了。

3.Panel 中看不到滾動條

在設(shè)計 Panel 的時候，出現(xiàn)看不到窗體看不到滾動條（垂直+水平）的情況。如果窗體面積很大，超出了屏幕顯示范圍，就會出現(xiàn)一部分窗體被遮擋的情況。如下所示：

原因分析：

電腦屏幕設(shè)置了縮放，造成控件內(nèi)部不能正確計算相對屏幕的尺寸，因此無法正確顯示滾動條。查看電腦設(shè)置如下：

解決方案：

關(guān)閉屏幕縮放，設(shè)置縮放為 100%，重啟軟件，即可重新看到窗體的滾動條。

可以看到，在窗體上重新出現(xiàn)了滾動條（垂直+水平），如下所示：