TwinCAT HMI EventGird和Line控件的使用方法

第1頁TwinCATHMITwinCATHMIEventGird和Line控件的使用方法作者：余洋職務(wù)：技術(shù)工程師公司：BECKHOFF中國郵箱：yang.yu@日期：2023-08-29摘要：TwinCATHMI中有很多控件，其中EventGird和EventLine可以為用戶提供TwinCAT項目中自定義的報警、報錯、消息等等提示。除此之外，還可以自定義篩選規(guī)則，篩選或確認(rèn)自定義提示，自由度非常高。此文檔講解了如何安裝HMIEventLogger拓展包、自定義TwinCAT事件、編寫PLC相關(guān)程序以及調(diào)試EventGird控件。附件：序號文件名備注1TwinCATHMIEventGirdTest.tnzip例程歷史版本：免責(zé)聲明：我們已對本文檔描述的內(nèi)容做測試。但是差錯在所難免，無法保證絕對正確并完全滿足您的使用需求。本文檔的內(nèi)容可能隨時更新，如有改動，恕不事先通知，也歡迎您提出改進(jìn)建議。參考信息：目錄1. 軟硬件版本 31.1. 控制硬件 31.2. 控制軟件 32. 準(zhǔn)備工作 33. TwinCAT項目配置 43.1. 自定義TwinCAT事件 43.2. 編寫PLC程序 64. 配置EventGird控件 114.1. Fliter 114.2. Columns 125. 使用EventGird控件 136. 使用EventLine控件 137. 常見問題 16軟硬件版本控制硬件測試電腦（Windows11專業(yè)版）控制軟件TwinCAT3（文檔測試版本為v3.1.4024.47）TwinCATHMI開發(fā)組件TE2000Beckhoff.TwinCAT.HMI.EventLoggerNuget安裝包準(zhǔn)備工作在使用EventGird控件之前需要安裝相關(guān)安裝包，TwinCAT3和TE2000開發(fā)環(huán)境是必須的。在安裝完TE2000之后，自帶的Beckhoff.TwinCAT.HMI.Controls組件中會有EventGird控件：但是想要使用它，必須安裝Beckhoff.TwinCAT.HMI.EventLogger這個額外的拓展組件，安裝此組件最簡單的方式是右鍵Packages或者在TwinCAT最上方的工具選擇Nuget包管理器—管理解決方案的Nuget包。進(jìn)入Nuget包管理器之后選擇合適的程序包源，有網(wǎng)絡(luò)狀態(tài)可以選進(jìn)行全網(wǎng)搜索已發(fā)布的Nuegt包。如果編程電腦無法聯(lián)網(wǎng)，可以在Github上下載獨(dú)立的EventLogger包，放至自定義位置之后再自定義一個包源名稱就可以選擇安裝了。TwinCAT項目配置自定義TwinCAT事件TwinCATHMIEventGird的消息提示源于TcEventlogger相關(guān)接口，自定義事件必須在TwinCAT以TMC文件的形式編輯。首先來到TwinCATSystem選擇TypeSystem，所有TwinCAT的系統(tǒng)變量，接口，事件和函數(shù)都在此處。接著選中EventClasses，右鍵灰色處選擇New進(jìn)入TMC編輯器新建一個自定義的事件：下一步是在TMC編輯器里面自定義事件內(nèi)容，首先修改事件名，這個可以根據(jù)自己的想法隨意修改：在此事件中，可以新增各種子事件，默認(rèn)情況會自帶一個，點擊Events可以新增或者刪除事件：在子事件中，可以修改事件名，修改事件等級和顯示的事件內(nèi)容：完成所有的自定義設(shè)置之后，便可關(guān)閉TMC編輯器，選擇TwinCAT中的SaveAll即可。這樣一來，自定義TwinCAT事件的步驟就完成了編寫PLC程序編輯完自定義TwinCAT事件之后，還需要編寫相關(guān)的PLC程序才能對事件進(jìn)行監(jiān)控和其他操作。第一步是添加對應(yīng)的功能塊庫文件：Tc3_EventLogger。接下來聲明相對應(yīng)的功能塊并且調(diào)用其中的方法。PLC程序的聲明和調(diào)用如下所示：首先，必須聲明功能塊FB_TcEventLogger這個功能塊，可以理解為這個功能塊就代表了TwinCAT3EventLogger本體。其他的功能塊都是基于它的。其次，例程中還聲明了其他兩個消息以及警報功能塊。以及聲明了各種觸發(fā)的引腳。在程序中，第一步是進(jìn)行初始化，當(dāng)bIsInitalized被置為TRUE時，分別調(diào)用fbMessage和fbAlarm中的方法CreateEX進(jìn)行創(chuàng)建。以下是fbMessage.CreateEx方法的詳細(xì)說明：這個方法一共有兩個輸入引腳：stEventEntry和ipSourceInfo。前者是用戶自己編輯的TwinCAT事件，也就是上一章節(jié)講述的TMC編輯器中的配置步驟，這里填的是自定義事件的名字，而ipSouceInfo，本質(zhì)上是一個接口，這里默認(rèn)情況就填0即可。以下是fbAlarm.CreateEx方法的詳細(xì)說明：這個方法和之前的fbMessage.CreateEx非常類似，僅僅是多出了一個BOOL輸入引腳，其含定義為“是否需要強(qiáng)制確認(rèn)警報”，指的是警報功能是否需要用戶在解除警報之前進(jìn)行確認(rèn)。如果警報需要強(qiáng)制確認(rèn)，用戶必須采取行動，如輸入代碼或按下按鈕，對應(yīng)的是Comfirm方法。這里開放用戶可以手動確認(rèn)來消除警報，所以選擇TRUE。當(dāng)bMessage被置為TRUE時，TwinCAT發(fā)送創(chuàng)建的消息，用的方法為fbMessage.Send。功能塊fbMessage本身是沒有這個方法的，但是它繼承了FB_TcEventBase并且實現(xiàn)了I_TcMessage接口。在I_TcMessage中定義了Send方法：這個方法僅有一個輸入引腳，當(dāng)該值為0時，選用的是當(dāng)前的時間戳；當(dāng)改制不為0時，選用外部時間戳。在本例程中，都使用本地時間戳，所以填0即可。同理，當(dāng)bAlarm被置為TRUE時，調(diào)用fbAlarm.Raise方法，其用法于Send一模一樣，這里就不贅述了。最后，當(dāng)bClearAlarm被置為TRUE時，調(diào)用fbAlarm.Clear方法：此方法中有兩個輸入引腳：前者是之前的時間戳，后者是一個BOOL變量。如果為TRUE，那Conform狀態(tài)被重置，如果為FALSE，那么confirm狀態(tài)不變。例程中清除報警>確認(rèn)報警，所以此引腳被置為TRUE。配置EventGird控件在TwinCATHMI中新建一個EventGird控件，簡單的屬性與其他普通控件基本一致，用戶可以做參考和類比，這里也不贅述了。有兩個比較重要的屬性是EventGird特有的：Fliter顧名思義，這個屬性就是改列表的過濾設(shè)置，在此可以設(shè)置錯誤的觸發(fā)條件：addclause：添加語句Deleteclause：刪除語句And/Or：語句的邏輯組合方式Path：過濾的方式（如事件來源、名稱、嚴(yán)重等級、ID、觸發(fā)事件、復(fù)位事件、事件類型、事件ID、事件內(nèi)容、報警狀態(tài)、確認(rèn)的狀態(tài)等等）Operator：語句中的運(yùn)算符Value：事件輸出的內(nèi)容Columns該屬性可以設(shè)置在EventGird中顯示事件的哪些信息：Type：這里可以修改事件的類型，有兩種選項：Column和CustomColumn。前者有默認(rèn)的內(nèi)容：比如事件類型，觸發(fā)時間，是否被確認(rèn)等等。后者可以顯示自定義的內(nèi)容。ColumnName：這里可以修改ColumnName，如果是系統(tǒng)默認(rèn)的選項（Type選擇Column），內(nèi)容名稱可以選擇上述提到的事件類型，觸發(fā)時間，是否被確認(rèn)。而自定義選項（Type選擇Column）可以用關(guān)鍵字“params::”（寫的時候無引號）+參數(shù)名來引用參數(shù)，如：Width：該設(shè)置可以更改顯示內(nèi)容在每一行中占有的寬度。使用EventGird控件如圖所示，控件中有12個小按鈕或者顯示框，接下來依次講解一下這些子控件：（1）開啟/關(guān)閉顯示警報（警告、錯誤、關(guān)鍵性錯誤等等）（2）開啟/關(guān)閉顯示消息（3）（4）開啟/關(guān)閉顯示消息類型的事件內(nèi)容（5）開啟/關(guān)閉顯示警告類型的事件內(nèi)容（6）開啟/關(guān)閉顯示錯誤類型的事件內(nèi)容（7）開啟/關(guān)閉顯示關(guān)鍵性錯誤類型的事件內(nèi)容（8）配置過濾器也同樣可以在控件運(yùn)行時操作（9）配置事件顯示的內(nèi)容也同樣可以在控件運(yùn)行時操作（10）確認(rèn)選中的警報（11）確認(rèn)所有警報（12）顯示事件的內(nèi)容區(qū)域使用EventLine控件EventLine是EventGird是精簡版，沒有配置各種事件的按鈕，只有事件內(nèi)容的顯示。也就是說，它的作用是僅僅顯示TwinCATEventlogger所產(chǎn)生的內(nèi)容。使用之前編寫好PLC程序（和EventGird一致），然后將改控件拖動到界面當(dāng)中即可：EventLine有一個特殊的屬性設(shè)置。當(dāng)顯示內(nèi)容大于消息欄的長度時，可以選擇自動滾動播放，設(shè)置路徑為：Text——TextOverflow。改屬性一共有三種選項：（1）Ellipsis：超出消息欄長度的事件內(nèi)容會被截斷。（2）：MarqueeLeftToRight：事件內(nèi)容從左往右進(jìn)行滾動。（3）：MarqueeRightToLeft：事件內(nèi)容從右往左進(jìn)行滾動（下方的MarqueeSpeed則是用來設(shè)置滾動的速度）：常見問題可以在TwinCATEvent中編輯帶有中文的內(nèi)容嗎？在Text當(dāng)中可以。EventLine和EventGird有什么區(qū)別？接口都是TwinCAT3EventLogger，沒有區(qū)別，只不過更加簡潔。EventGird和TwinCAT3軟件底下的錯誤列表有什么關(guān)系？可以理解為是精簡版，EventGird顯示的內(nèi)容一定會同時也在ErrorList下方產(chǎn)生，ErrorList還帶一些系統(tǒng)的報錯或提示：

上海（中國區(qū)總部）中國上海市靜安區(qū)汶水路299弄9號（市北智匯園）電話 北京分公司北京市西城區(qū)新街口北大街3號新街高和大廈407室電話 郵箱:beijing@ 廣州分公司廣州市天河區(qū)珠江新