第6頁TTwinCATHMI使用EcDiagnostics控件顯示實時拓撲作者：李坤峰職務：助理技術支持工程師郵箱：kunfeng.li@日期：2022-6-24摘要：TwinCATHMI可以通過安裝NuGet程序包實現多種功能，此文檔主要介紹如何使用EcDiagnostics程序包和控件，在HMI畫面上顯示實時拓撲，并且實現簡單調試。附件：序號文件名備注歷史版本：免責聲明：我們已對本文檔描述的內容做測試。但是差錯在所難免，無法保證絕對正確并完全滿足您的使用需求。本文檔的內容可能隨時更新，如有改動，恕不事先通知，也歡迎您提出改進建議。參考信息：目錄1. 軟硬件版本 31.1. 硬件型號 31.2. 控制軟件 32. 準備工作 32.1. 軟件安裝 32.2. 網絡接線 33. 操作步驟 33.1. 創建TwinCATHMI項目 33.2. 安裝EcDiagnostics程序包 43.3. 在界面上添加EcDiagnostics控件 53.4. 配置TcHmiEcDiagnostics中Device 63.5. 在線預覽 74. Diagnostics功能與控制測試 84.1. Diagnostics界面功能 84.2. MasterView與SlaveView 94.3. Diagnostics控制測試 115. 常見問題 125.1. 控制器中是否需要安裝TF2000？ 125.2. 控制器需不需要確保處于運行模式？ 125.3. 控制器切換運行模式時Diagnostics控件報錯。 13

軟硬件版本硬件型號控制器型號為：CX5130一臺。模塊有：EK1200、EK1100、EK1110以及EL系列輸入輸出模塊等?？刂栖浖{試電腦軟件版本為4024.29，TE2000版本為1.12.756.1?？刂破鬈浖姹緸?024.12。準備工作軟件安裝在調試電腦中安裝TE2000Function作為開發環境，如不發布在控制器中，則控制器無需安裝TF2000運行環境等。網絡接線搭建控制器與模塊的拓撲網絡，將調試電腦與控制器之間用網線連接起來。操作步驟創建TwinCATHMI項目首先在開始頁選擇創建NewTwinCATHMIProject。填寫好項目名稱后點擊確定創建項目。安裝EcDiagnostics程序包想要在HMI中實時顯示拓撲網絡，就需要用到一個名為EcDiagnostics的控件，而在Desktop工具箱中的看不到所需要的EcDiagnostics控件。因為這一控件在原始的TwinCATHMIProject中沒有安裝，需要手動在NuGet管理器中安裝需要的程序包。右鍵TwinCATHMIProject，點擊管理NuGet程序包。在這一界面中，可以安裝、管理和更新NuGet程序包。新安裝NuGet程序包需要在瀏覽選項卡中搜索，輸入EcDiagnostics后就可以搜索到這兩個程序包，EcDiagnosticsControl就是我們需要的控件，選中之后在右側窗口中選擇最新版本進行安裝，此時系統會自動下載并安裝好這兩個程序包，因為EcDiagnostics是EcDiagnosticsControl的Server，同樣是必不可少的。此時可以看到在左側的Server下，就多出了名為TcHmiEcDiagnostics的Server，并且圖標為綠色。在界面上添加EcDiagnostics控件安裝完程序包之后，回到Desktop中，此時在右側的工具箱中就新增了一個名為EcDiagnostics的控件。選中后拖拽到畫布中，添加控件。添加完控件之后，在控件的屬性中，可以看到在Common一欄中有一個device，這里填寫的Device名稱就是對應的TcHmiEcDiagnostics中的配置名稱。配置TcHmiEcDiagnostics中Device想要在EcDiagnostics中實時顯示控制器的拓撲信息，我們需要在TcHmiEcDiagnostics中進行配置，雙擊左側的TcHmiEcDiagnostics進入TwinCATHMIServerConfigutation界面，在這可以配置需要監視的Device，選中并展開EtherCATDevices，可以看到已經存在了一個Device1。此時可以選擇修改或者新建，但是要注意的是一定要將名字與剛剛提到的控件屬性中的Device對應起來，這里為了方便演示，選擇直接修改Device1。 展開Device1后，確認Enabled狀態為TRUE，點擊TargetNetId后的小框，這里可以快速的選擇已經保存路由表信息的控制器，選擇當前連接的控制器后，在MasterNetId的右側小框中也是采用同樣的方法選擇要監視的Device。完成選擇之后點擊Accept，保存配置，此時可以到Diagnostics選項卡中觀察到目標Device的運行情況。在線預覽完成以上所有的配置之后，就可以啟動在線預覽實時觀察目標控制器Device的拓撲和狀態，通過點擊畫布右側的L型按鈕即可進入在線預覽。Diagnostics功能與控制測試Diagnostics界面功能在實時預覽的Diagnostics控件當中，我們對Device擁有非常多的監視和控制功能。首先在界面上第一眼可以觀察到就是最左側控制器的HostName與狀態，跟控制器上的燈相同，也是綠色表示RUNMODE，藍色表示ConfigMode。在控制器與模塊的上方有一條線，同樣也是用顏色表示其狀態，綠色為OP狀態，黃色為PreOP狀態，通過這樣的方式可以直觀的判斷控制器與模塊的狀態。判斷耦合器之間的連接情況，同樣十分簡單直觀，當模塊之間連接正常時，網口之間使用一條綠色的網線連接，在通訊出錯，如手動拔出EK1110與EK1100之間的網線，則會以紅至黑的漸變色表示通訊出錯，并且丟失后續的模塊狀態。MasterView與SlaveViewDiagnostics不僅可以通過主要界面觀察和監視狀態變化，還可以通過MasterView和SlaveView監視更多更詳細的信息。點擊控制器圖案，即可進入MasterView界面。在該界面中我們可以看到控制器的各項信息以及網絡中的通訊狀態，甚至可以在SyncUnits中實時選擇和更改當前生效的報文分組。在這一界面中，選擇當前所需分配的分組，選中后即可生效，此處選中SyncUnit1，回到主界面后可以看到EL1904與EL2904被用藍色的邊框高亮。點擊任意一個模塊，就可以進入一個分區的SlaveView，可以看到這個分區內所有模塊的狀態。這其中有非常詳細的信息，可以與Devices下的EtherCAT與Oline界面相媲美，這里就不過多展開，可以自行研究。Diagnostics控制測試在SlaveView中，在界面的最下方可以監視和控制模塊各個通道的值，與FreeRun模式相同，此處可以實時的監視或更改通道的值，此處以EL2008為例。在EL2008的Channel1的監視中，可以監視波形和更改Value。在Preparedvalue中選擇True，點擊Apply，就能實時修改通道的值為true，Demo上的小燈也隨之亮起，這一點與FreeRun模式無異，此處也就不過多展開，也請各位自行測試。常見問題控制器中是否需要安裝TF2000？經過測試，如無需將HMI界面發布在控制器中，僅由調試電腦在線預覽，無需在控制器中安裝TF2000。控制器需不需要確保處于運行模式？經過測試，控制器無論處于RUNMODE或者ConfigMODE都可以成功獲取到Device狀態，但前提是控制器中應有程序，在測試中將控制器BOOT文件夾內容全部刪除，無法讀取到Device狀態。控制器切換運行模式時Diagnostics控件報錯。在控制器切換運行模式時，Diagnostics控件會獲取不到目標Device狀態，產生報錯，在控制器切換模式完成后，又將恢復功能。

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