系統(tǒng)變量

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

一 綜述

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

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

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

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

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

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

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

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

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

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

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

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

? 第二步：設(shè)置用戶變量的屬性

Name: 變量名稱。

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

Comment: 對(duì)變量增加一些評(píng)論和描述。

Data Type: 變量類型，包括整形和 Float 等類型。詳細(xì)可展開(kāi)查看。

ReadOnly: 該變量是否只讀，如果是只讀的，用戶無(wú)法對(duì)其進(jìn)行修改。

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

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

Current Value: 該變量當(dāng)前值。

? 添加到系統(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：有符號(hào) 32 位類型，可以涵蓋住 Int8，Int16 等類型。

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

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

? UInt64：無(wú)符號(hào) 64 位數(shù)據(jù)類型。

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

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

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

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

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

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

? string：字符串?dāng)?shù)據(jù)類型。

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

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

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

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

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

2. 雙擊展開(kāi)變量選擇面板。

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

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

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

? 寫(xiě)入變量：

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

? 讀取變量：

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