系統變量

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

一 綜述

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

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

? 用戶定義變量是用戶自己創建和管理的

系統變量系統架構如下圖所示：

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

二 Internal Variables（內生系統變量）

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

1. 系統信息；2.設備統計信息；3. 小程序變量。

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

三 User Variables（用戶定義變量系統）

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

? 第一步：在系統變量管理界面，右鍵，點擊：創建用戶變量

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

Name: 變量名稱。

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

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

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

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

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

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

Current Value: 該變量當前值。

? 添加到系統后如下圖所示：

四 系統變量數據類型

TSMaster 系統變量主要包含如下數據類型：Int32，UInt32，Int64，UInt64，UInt8 Array，Int32 Array, Int64 Array, double ,double Array, string，如下所示：

其分別代表的意義如下：

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

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

? Int64：有符號 64 位數據類型。

? UInt64：無符號 64 位數據類型。

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

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

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

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

? Double：雙精度數據類型。

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

? string：字符串數據類型。

五 訪問系統變量

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

1. Panel 關聯系統變量

Panel 關聯系統變量流程如上圖所示：

1. 控件關聯變量類型選擇為系統變量（SystemVar）。

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

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

2. 腳本讀寫系統變量

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

? 寫入變量：

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

? 讀取變量：

基于 set_system 和 get_system 函數，賦予了腳本系統跨腳本訪問腳本內部變量的能力。