預設變數

系統變數 - 預設通訊協定允許建立指向關於下列 HMI 系統變數的標記:

 

通訊協定編輯器設定

從通訊協定編輯器對話的 PLC 型號清單選取預設。

 

標記編輯器設定

路徑:專案檢視> 組態 > 按兩下 標記

  1. 要新增標記,按一下+:將新增新的一行。
  2. 驅動程式清單中選擇系統變數:將顯示標記定義對話方塊。

元素 描述

記憶體類型

代表標記所參照的系統變數。 

下列部分顯示可能系統變數的完整清單,按照類別分組。

警報變數
變數名稱 描述 資料類型
Alarm not acknowledged

未確認的警報待處理時為真

(未觸發未確認<>0) 或 (已觸發未確認<>0)

布林值

唯讀

Alarm triggered

至少一個警報已觸發時為真

(已觸發已確認<>0) 或 (已觸發<>0) 或 (已觸發未確認<>0)

布林值

唯讀

Number of missed alarm events 警報超過事件佇列。佇列長度在 engineconfig.xml 檔案中定義。

整數

唯讀

Number of not triggered acknowledged 警報條件不再有效;警報已確認

整數

唯讀

Number of not triggered not acknowledged 警報條件不再作用;等待確認

整數

唯讀

Number of triggered acknowledged 警報條件作用中;警報已確認

整數

唯讀

Number of triggered alarms 警報作用中:無需確認

整數

唯讀

Number of triggered not acknowledged 警報條件作用中;等待確認

整數

唯讀

警報器變數
變數名稱 描述 資料類型
Buzzer Setup

0 = 已停用

1 = 已啟用(在發生任何觸控螢幕事件時警報器發出可聽的音效)

2 = 警報器狀態由警報器控制系統變數或「專案內容」中的觸控警報器內容控制

 

觸控螢幕上的警報器(設定=1)在 Linux 平台上無法使用。或者參閱「觸控警報器」內容。

整數

Buzzer Control

0 = 警報器關閉

1 = 警報器開啟

2 = 警報器閃爍

整數

Buzzer Off Time 選擇閃爍後的關閉時長(毫秒)。預設 = 1000。範圍:100-5000

整數

Buzzer On Time 選擇閃爍後的開啟時長(毫秒)。預設 = 1000。範圍:100-5000

整數

通訊變數
變數名稱 描述 資料類型
Protocol Communication Status

摘要通訊協定狀態。

0 = 無通訊協定執行,通訊協定驅動器可能尚未妥善下載到 HMI 裝置

1 = 通訊協定已載入且開啟,無通訊錯誤

2 = 至少一個通訊的通訊協定回報一個錯誤

整數

唯讀

Protocol Error Message

通訊錯誤,具有錯誤來源。

例如:「[xxxx]」,其中「xxxx」是通訊協定的縮寫、錯誤來源。

如有多個錯誤來源,則會出現多個縮寫詞。無錯誤回報時則空白。

字串

唯讀

Protocol Error Count 上次重設後發生通訊錯誤的次數。以重設通訊協定錯誤數動作重設數值,參閱主手冊的「系統動作」

整數

唯讀

資料庫變數
變數名稱 描述 資料類型
Database link error message

上次偵測到的錯誤描述

字串

唯讀

Database link status

0 = 未定義(尚未初始化)

1 = 線上 (就緒)

2 = 離線 (無法使用)

3 = 傳輸進行中

4 = 錯誤

整數

唯讀

Database link error count 錯誤計數器。每一個錯誤後新增者

整數

唯讀

每個資料庫變數皆為一個陣列,其中索引選擇資料連結連線(範圍 1-10)
變數僅在任何資料庫連接器動作執行時才會更新

日光節約時間變數
變數名稱 描述 資料類型
Standard Offset 設定標準時間時相對於 GMT 的位移(單位為分鐘,例如:-8x60 = -480 分鐘)

整數

唯讀

Standard Week 標準時間開始時的週別(例如:第 1 = 1)

整數

唯讀

Standard Month 標準時間開始時的月份。範圍:0–11。(例如:11 月 = 10)

整數

唯讀

Standard Day 標準時間開始時的星期(例如:星期日 = 0)

整數

唯讀

Standard Hour 標準時間開始時的小時(例如:02 = 2)

整數

唯讀

Standard Minute 標準時間開始時的分鐘(例如:00 = 0)

整數

唯讀

DST Offset 設定 DLS 時間時相對於 GMT 的位移(單位為分鐘)

整數

唯讀

DST Week DLS 時間開始時的週別

整數

唯讀

DST Month DLS 時間開始時的月份。範圍:0-11

整數

唯讀

DST Day DLS 時間開始時的星期

整數

唯讀

DST Hour DLS 時間開始時的小時

整數

唯讀

DST Minute DLS 時間開始時的分鐘

整數

唯讀

所有變數為唯讀:無法用來更新系統時鐘。

裝置變數
變數名稱 描述 資料類型
Available System Memory 可用 RAM 記憶體(位元組)

uint64

唯讀

Backlight Time 自裝置生產開始後顯示背光小時內的啟動時間

不帶正負號的整數

唯讀

Battery LED

啟用/停用低電池 LED 指示燈 (如適用)

0 = 已停用

1 = 已啟用

在 Linux 平台上不可用(在"HMI 裝置功能"中尋找您裝置的平台)

整數

Display Brightness

返回並調整亮度。

當設定為低光線(0..3) 時,背光會保持較高亮度 8 秒鐘,讓使用者可進行調整然後關閉。

即使設定為 0 時背光仍然是開啟的,且背光時間計數器增加。範圍:0-255

整數

External Timeout

顯示背光會自動關閉的非操作時間。使用者一觸摸螢幕,背光即會自動開啟

-1 =

關閉背光並停用觸控(關閉顯示螢幕)背光時間計數器停止。

需要 BSP v1.0.324 或更高版本。

-2 =

關閉背光但不停用觸控。如果按下觸控,事件不會傳遞到應用程式,但螢幕保護程式將會結束,且背光重新開啟。

需要 BSP v1.0.324 或更高版本。

0 = 開啟背光(開啟顯示螢幕)
1..n =

用於關閉背光的逾時(螢幕保護程式計時器)

逾時數值上捨入為一分鐘的倍數(60、120、180 等)。

"HMI 裝置功能"

整數

Flash Free Space 內部快閃記憶體中的可用空間

uint64

唯讀

Manufacturer Code 可識別 HMI 的代碼

短整數

唯讀

Server RAM Usage 用於 HMI 的當前 RAM 記憶體 (以位元組計)

uint64

唯讀

System Font List 系統字型清單

字串

唯讀

System Mode

執行階段作業狀態

1 = 開機

2 = 設定模式

3 = 作業模式

4 = 重新開機

5 = 關機

整數

System UpTime 自單位生產後系統開機的時間 (小時)

不帶正負號的整數

唯讀

傾印資訊變數
變數名稱 描述 資料類型
Dump Error Message 在傾印作業過程中發生任何錯誤時傳回錯誤訊息

字串

唯讀

Dump Archive Status

0 = 初始預設狀態
1 = 作業已觸發
2 = 作業已成功完成
3 = 作業已完成但有錯誤

整數

唯讀

Dump Recipe Status

0 = 初始預設狀態
1 = 作業已觸發
2 = 作業已成功完成
3 = 作業已完成但有錯誤

整數

唯讀

Dump Trend Status

0 = 初始預設狀態
1 = 作業已觸發
2 = 作業已成功完成
3 = 作業已完成但有錯誤

整數

唯讀

Reset Recipe Status

0 = 初始預設狀態
1 = 作業已觸發
2 = 作業已成功完成
3 = 作業已完成但有錯誤

整數

唯讀

Restore Recipe Status

0 = 初始預設狀態
1 = 作業已觸發
2 = 作業已成功完成
3 = 作業已完成但有錯誤

整數

唯讀

網路變數
變數名稱 描述 資料類型
Gateway

裝置主要 HMI 介面的閘道位址

字串

唯讀

IP Address

裝置主要 HMI 介面的 IP 位址

字串

唯讀

Mac ID HMI 主要乙太網路介面的 Mac ID

字串

唯讀

Network Adapter Parameters 可用於讀取或更新網路配接器參數的 JSON 字串

字串

Network Status

包含寫入配接器參數所需的最近作業結果。它在每一個寫入作業後更新。

  • 空白字串表示沒有錯誤
  • 上次錯誤描述

字串

唯讀

Subnet Mask HMI 主要乙太網路介面的子網路遮罩

字串

唯讀

PLC 變數
變數名稱 描述 資料類型
Get CopyCodesysProject Action Status

提供 CopyCodesysProject 動作狀態。

0 = 未呼叫的動作

1 = 進行中的動作

2 = 完成的動作

3 = 已中止的動作 (CHK 檔案遺失)

4 = 已中止的動作 (PRJ 檔案遺失)

5 = 已中止的動作 (SDB 檔案遺失)

6 = 已中止的動作 (找到數個 CHK 檔案)

7 = 已中止的動作 (找到數個 PRJ 檔案)

8 = 已中止的動作 (找到數個 SDB 檔案)

9 = 已中止的動作(檔案名稱不一致)

10 = 已中止的動作 (無法建立目錄)

11 = 已中止的動作 (複製失敗)

12 = 已中止的動作 (不存在 Codesys 模組)

整數

唯讀

PLC Status

提供內部 PLC 狀態。

0 = 執行模式

1 = 停止模式

2 = 由檔案重新載入

3 = 重設暖

4 = 重設冷

5 = 重設硬

整數

PLC 系統變數是指 CODESYS V2 內部 PLC

螢幕變數
變數名稱 描述 資料類型
X Screen resolution 顯示水平螢幕大小(像素)

整數

唯讀

Y Screen resolution

顯示垂直螢幕大小(像素)

整數

唯讀

SD 卡變數
變數名稱 描述 資料類型
SD Card FreeSpace

卡上可用空間(位元組)

uint64

唯讀

SD Card Name SD 卡的名稱

字串

唯讀

SD Card Size 插入插槽的卡大小(位元組)

uint64

唯讀

SD Card Status

0 = SD 卡未插入

1 = SD 卡已插入

整數

唯讀

伺服器變數
變數名稱 描述 資料類型
Page name 目前頁面的名稱

字串

唯讀

Project Name 目前專案的名稱

字串

唯讀

Project load time 專案載入至JMobile HMI Runtime 的日期,同系統日期格式 (毫秒)

uint64

唯讀

Last operating mode start time

裝置開始作業模式後所耗秒數

uint64

唯讀

所有變數指的是伺服器,而非 HMI Client

時間變數
變數名稱 描述 資料類型
Day Of Month 範圍:1-31

整數

Day Of Week

範圍:0 = 週日,..,6 = 週六

整數

Hour 範圍:0-23

整數

Minute 範圍:0-59

整數

Month

範圍:1-12

整數

Second

範圍:0-59

整數

System Time 與 UTC 時間相同。亦可設定為此變數的日期/時間 不帶正負號的整數
Year 本年 整數

以 UTC 格式表示的系統時間

USB 磁碟機變數
變數名稱 描述 資料類型
USB Drive FreeSpace 可用的空間(位元組)

uint64

唯讀

USB Drive Name

USB 裝置的名稱

字串

唯讀

USB Drive Size 插入 USB 連接埠的裝置之大小(位元組)

uint64

唯讀

USB Drive Status

0 = USB 磁碟機已拔出

1 = USB 磁碟機已插入

整數

唯讀

版本變數
變數名稱 描述 資料類型
Main OS version 主要作業系統的版本

字串

唯讀

Runtime version

執行階段的版本

字串

唯讀

Project name 專案名稱

字串

唯讀

Project version 專案版本

字串

 

Project GUID 專案 GUID (唯一識別碼)

字串

唯讀

虛擬 Com 切換變數
變數名稱 描述 資料類型
VCS status

提供 VCS 服務狀態。

0 = 服務已啟用

1 = 以交插模式連接的用戶

2 = 以專屬模式連接的用戶

3 = 服務已停用 (預設)

不帶正負號的位元組

唯讀

VCS disable

提供 VCS 服務手動覆寫。

0 = VCS 服務已啟用

1 = VCS 服務已停用 (預設)

布林值

VCS port 在 HMI 上以 VCS 服務提供當前聆聽 TCP 埠 不帶正負號的短整數

 

資料類型

每一個系統變數都有一個特定資料類型,描述於上面表格中。

下列表格顯示任何用於系統變數的資料類型詳細資訊。

資料類型 記憶體空間 限制
短整數 16-位元資料 -32768 ...32767
整數 32-位元資料 -2.1e9 ...2.1e9
不帶正負號的位元組 8-位元資料 0 ...255
不帶正負號的短整數 16-位元資料 0 ...65535
不帶正負號的整數 32-位元資料 0 ...4.2e9
uint64 64-位元資料 0 ...1.8e19
字串 包含由所選代碼定義的字元代碼的元素陣列

陣列大小

如有字串標記時,此屬性代表字串標記中可用的最大位元組數。

注意:如果在「標記編輯器」中將編碼屬性設定為 UTF-8 或 Latin 1,則位元組數量與字串字元數量對應。
如果將「編碼」屬性設定為 UCS-2BE,UCS-2LE,UTF-16BE 或 UTF-16LE,則一個字元需要 2 個位元組。

轉換

要套用於標記的轉換。

取決於所選的資料類型,允許清單會顯示一個或多個轉換類型。

描述
Inv bits

inv:反轉標記的所有位元。

範例:
1001 → 0110(以二進位格式)
9 → 6(以十進位格式)

Negate

neg:設定標記值的相反值。

範例:
25.36 → -25.36

AB -> BA

swapnibbles:交換位元組的半位元組。

範例:
15D4 → 514D(以十六進位格式)
5588 → 20813(以十進位格式)

ABCD -> CDAB

swap2:交換一個字組的位元組。

範例:
19ACC → CC9A(以十六進位格式)
39628 → 52378(以十進位格式)

ABCDEFGH -> GHEFCDAB

swap4:交換二個字組的位元組。

範例:
32FCFF54 → 54FFFC32(以十六進位格式)
855441236 → 1426062386(以十進位格式)

ABC...NOP -> OPM...DAB

swap8:交換長字組的位元組。

範例:
142.366 → -893553517.588905(以十進位格式)
0 10000000110 0001110010111011011001000101101000011100101011000001

1 10000011100 1010101000010100010110110110110010110110000100111101
(以二進位格式)

BCD

bcd:將位元組分隔為二個半位元組,並以十進位讀取(從 0 到 9)

範例:
23 → 17(以十進位格式)
0001 0111 = 23
0001 = 1 (第一個半位元組)
0111 = 7(第二個半位元組)

選擇轉換,然後按一下 +。所選的項目會新增至已設定清單。

如果設定了更多的轉換,則會依順序套用這些轉換(從已設定清單的頂部到底部)。

使用箭號按鈕以排序已設定的轉換。