系統(tǒng)變量

本文給大家介紹TSMaster的一個重要概念—系統(tǒng)變量。系統(tǒng)變量可以用于監(jiān)測信號、傳遞信息，還可以用于自動化以及測試等眾多領域，TSMaster幾乎所有的功能都和系統(tǒng)變量有關。

一 綜述

用戶在使用 Panel，腳本，標定，診斷或者其他擴展功能的時候，能夠直接訪問的變量被定義為系統(tǒng)變量。根據(jù)系統(tǒng)變量生成的原理，主要分為兩個類型：Internal Variable(內生系統(tǒng)變量)和User Variable(用戶自定義系統(tǒng)變量)。他們的主要區(qū)別是：

? 內生系統(tǒng)變量是系統(tǒng)自動生成，自動釋放的，用戶不能直接對其進行增刪操作；

? 用戶定義變量是用戶自己創(chuàng)建和管理的

系統(tǒng)變量系統(tǒng)架構如下圖所示：

用戶要查看當前可用的系統(tǒng)變量，需要根據(jù)路徑 Simulation->System Variable 打開系統(tǒng)變量管理界面，如下圖所示：

二 Internal Variables（內生系統(tǒng)變量）

內生系統(tǒng)變量是跟隨系統(tǒng)自動生成，自動釋放的。常見的內生系統(tǒng)變量如下圖所示：

1. 系統(tǒng)信息；2.設備統(tǒng)計信息；3. 小程序變量。

以設備統(tǒng)計信息為例，如果添加了 CAN1 設備，才會動態(tài)生成 StaticsCAN1 相關的統(tǒng)計信息；如果刪除 CAN1 設備，這些統(tǒng)計信息會消失。隨著 TSMaster 軟件系統(tǒng)的升級，后續(xù)會增加更多的這種動態(tài)生成和加載的數(shù)據(jù)類型。

三 User Variables（用戶定義變量系統(tǒng)）

這種類型的變量是用戶自定義的，用戶可以進行增刪等操作。新增用戶變量流程如下所示：

? 第一步：在系統(tǒng)變量管理界面，右鍵，點擊：創(chuàng)建用戶變量

? 第二步：設置用戶變量的屬性

Name: 變量名稱。

Category: 變量所屬分組，便于用戶管理變量，同名變量可能用于不同的應用程序中。

Comment: 對變量增加一些評論和描述。

Data Type: 變量類型，包括整形和 Float 等類型。詳細可展開查看。

ReadOnly: 該變量是否只讀，如果是只讀的，用戶無法對其進行修改。

Minimun Value: 該變量允許的最小值。

Maximum Value: 該變量允許的最大值。

Current Value: 該變量當前值。

? 添加到系統(tǒng)后如下圖所示：

四 系統(tǒng)變量數(shù)據(jù)類型

TSMaster 系統(tǒng)變量主要包含如下數(shù)據(jù)類型：Int32，UInt32，Int64，UInt64，UInt8 Array，Int32 Array, Int64 Array, double ,double Array, string，如下所示：

其分別代表的意義如下：

? Int32：有符號 32 位類型，可以涵蓋住 Int8，Int16 等類型。

? UInt32：無符號 32 位類型，可以一并涵蓋住 UInt8，UInt16 等數(shù)據(jù)類型。

? Int64：有符號 64 位數(shù)據(jù)類型。

? UInt64：無符號 64 位數(shù)據(jù)類型。

? UInt8 Array：無符號 8 位數(shù)組，也就是最常用的 Byte 數(shù)組。對于數(shù)據(jù)類型的數(shù)據(jù)，在賦值的時候，數(shù)組元素之間通過’;’隔開，如下所示，其等同于數(shù)組定義為：

UInt8 Var6[5] = {12,34,56,78,90};

? Int32 Array：整型32位數(shù)組類型，數(shù)組元素之間通過’;’隔開。

? Int64 Array：整型64位數(shù)組類型，數(shù)組元素之間通過’;’隔開。

? Double：雙精度數(shù)據(jù)類型。

? double Array：雙精度數(shù)組類型，數(shù)組元素之間通過’;’隔開。

? string：字符串數(shù)據(jù)類型。

五 訪問系統(tǒng)變量

無論是內生變量，還是用戶定義變量，其訪問方式是完全一樣的。主要介紹兩種應用場景：1. Panel 關聯(lián)系統(tǒng)變量；2. 通過腳本讀寫系統(tǒng)變量。

1. Panel 關聯(lián)系統(tǒng)變量

Panel 關聯(lián)系統(tǒng)變量流程如上圖所示：

1. 控件關聯(lián)變量類型選擇為系統(tǒng)變量（SystemVar）。

2. 雙擊展開變量選擇面板。

3. 在面板上選擇內置系統(tǒng)變量和用戶定義系統(tǒng)變量即可。

2. 腳本讀寫系統(tǒng)變量

如上圖所示，簡單來說，系統(tǒng)變量的訪問主要用到兩類函數(shù)，這兩類函數(shù)位于小程序Function 的 APP 目錄下面。

? 寫入變量：

關于函數(shù)參數(shù)等，單擊選中該函數(shù)過后，右上角會呈現(xiàn)該函數(shù)的使用說明，如下圖所示：

? 讀取變量：

基于 set_system 和 get_system 函數(shù)，賦予了腳本系統(tǒng)跨腳本訪問腳本內部變量的能力。