西門子斷路器SIEMENS授權代理商

工具：Standard PID Control，浮動許可證
6ES7830-2AA22-0YX0

功能塊：Standard PID Control 標準函數塊，單一許可證
6ES7860-2AA21-0YX0

功能塊：標準功能塊 Standard PID Control，單一授權，不帶軟件或文檔 學完本章后，您將可以使用API 提供以下功能： ? 用戶用于選擇網絡接口的選擇器 (頁 15) ? 按 IP 地址插入 CPU 的方法 (頁 16) ?顯示和信任 TLS 證書的方法 (頁 20) ? 輸入的 CPU 的設備信息 (頁 22) ? 用于更改 CPU 操作模式的按鈕 (頁23) 先決條件 要開發您的應用程序，必須滿足以下先決條件。運行您的應用程序的用戶也必須滿足這些 先決條件： ? 您通過網絡接口將CPU 連接到您的編程設備。 ? 您知道 CPU 的 IP 地址。 ? 您可以對網絡上的 CPU 執行 ping操作并驗證它是否響應。 2.2.1 創建使用 API 的項目 使用 Microsoft Visual Studio t 以及SIMATIC Automation Tool API (頁 49) 開發應用程序。 您的應用程序和 SIMATICAutomation Tool API.dll 文件必須位于同一文件夾中創建使用 API 的項目 該 API 由西門子使用Microsoft Visual Studio 2017 和 .NET Framework 4.8 開發。使用這 些版本以及該 API開發 64 位 (x64) 應用程序。本文檔中的所有代碼示例均采用 C# 編程語 言。 要創建可以使用 SIMATICAutomation Tool API 的項目，請按照下列步驟操作： 1. 在 Visual Studio 中，創建一個新項目，即Visual C# Windows 窗體應用程序。將其命名 為“我的應用程序”(My Application)。 2.從“解決方案平臺”(Solutions Platforms) 下拉列表中，選擇“組態管理器”(ConfigurationManager)。 3. 在“組態管理器”(Configuration Manager) 中，單擊“平臺”(Platform)下拉列表并創建一 個新平臺。 4. 從“新建項目平臺”(New Project Platform)對話框，為新平臺選擇“x64”。單擊“確 定”(OK)，關閉“組態管理器”(Configuration Manager)。 5.在項目屬性中，將目標框架設置為 .NET Framework 4.8。 說明 SIMATIC Automation Tool API使用 .NET Framework 4.8。如果您的編程設備上沒有此框 架，則安裝程序會安裝此框架。 設置項目以使用 API要設置項目以使用 API，請按照下列步驟操作： 1. 運行 SAT SDK File Extractor，將 API文件和文件夾復制到默認位置。您可以從“開 始”(Start) 菜單中訪問 Siemens Automation 組中的 SAT SDKFile Extractor。 2. 打開解壓縮文件的位置，并將“Bin”文件夾的內容復制到 \bin\x64\Debug 文件夾中。3. 在項目中添加對 bin\x64\Debug\SIMATICAutomationToolAPI.dll 的引用。 4. 在文件Form1.cs 中，添加以下語句： using Siemens.Automation.AutomationTool.API;應用程序可通過此語句使用 API dll。您將通過 API 類別和接口在程序中創建對象。 5. 在窗體中添加“關閉”(Close)按鈕，以便用戶可以關閉應用程序。 6. 構建您的解決方案并驗證它是否成功構建。 為用戶提供一種選擇網絡接口的方法要讀取和顯示網絡接口，并使用戶能夠選擇接口，請按照以下步驟操作： 1. 使用文本標簽（如“網絡接口”）向窗體添加 ComboBox。2. 將 ComboBox 命名為“SelectNetworkInterface”。 3. 向 Form1.cs 中的 publicpartial class Form1 類別輸入網絡的全局變量： namespace MyApplication { publicpartial class Form1 : Form { public Network Net = new Network();請注意，“Network (頁 87)”是 API 提供的類別。 4. 在 Form1 類別中為全局輔助方法設置一個區域：#region 輔助方法 #endregion 5. 在輔助方法的 #region 中添加一個全局空方法： private voidClearCPUStatus() { } 稍后您將向此方法添加代碼。每當用戶選擇網絡接口時，應用程序將清除任何現有的 CPU狀態信息。雙擊窗體上的 ComboBox 控件以添加允許用戶選擇網絡接口的方法。在方法中插入如 下所示的代碼： privatevoid SelectNetworkInterface_SelectedIndexChanged(object sender,EventArgs e) { Result res =Net.SetCurrentNetworkInterface((string)SelectNetworkInterface.SelectedItem); } 此時，編譯您的項目并驗證它是否已成功編譯。測試下拉框以確保它顯示可用的網絡接口。確認可以選擇每個網絡接口。根據需要添加其它錯誤檢查。 如果您對自己的工作感到滿意，請轉到通過 IP 地址連接到網絡上的 CPU(頁 16)。 2.2.3 通過 IP 地址連接到網絡上的 CPU 如果網絡接口使用 S7-1200 或 S7-1500 CPU連接到網絡，則下一步是使用戶能夠連接到 網絡上的 CPU。隨后，該 CPU 將成為設備指令的連接設備。如果您根據提供的示例程序實現您的應用程序，則必須執行以下任務： 1. 接受并驗證 IP 地址的輸入內容。 2. 將 IP地址的設備插入設備集合。在此示例中，設備集合將是單個設備的集合。 3. 從與輸入的地址對應的網絡設備中讀取數據。 4. 確認 IP地址處的設備是 S7-1200 或 S7-1500 CPU。 5. 顯示 CPU 的設備信息。 本章節將指導您完成每項任務的窗體設計和編程。 說明此任務序列假定之前的每項任務都已成功。在您的應用程序中，執行驗證和錯誤檢查。只 有前一項任務成功后，才能繼續執行下一任務。 提供輸入IP 地址的文本框 用戶在文本框中輸入 CPU 的 IP 地址。要為您的用戶提供此文本框，請按照以下步驟操 作： 1.在您的窗體上放置一個帶有相應標簽的文本框控件，例如“IP 地址：”(IP Address:)。 2.將文本框命名為“InsertDeviceIPAddress”。 3. 確保文本框足夠寬，能夠容納 IPv4 地址。 4.將以下全局聲明添加到 Form1.cs 中的 public partial class Form1 類別。于 在接受來自可用網絡接口的選定接口 (頁 15) 中添加的公共網絡聲明后添加這些聲明： publicIProfinetDeviceCollection Devices; public ICPU CurrentCPU;請注意，“IProfinetDeviceCollection (頁 96)”是 API 提供的類別，“ICPU (頁 146)”是接口。本教程應用程序在所有示例中均使用 Devices 集合和 CurrentCPU 對象。 5. 在輔助方法區域中，添加名為ParseIP 的 IP 地址解析器方法。ParseIP 會將基于文 本的 IP 地址轉換為無符號整數實現處理輸入的 IP 地址的按鈕您需要為用戶提供輸入 IP 地址后可單擊的按鈕。該按鈕嘗試通過 IP 地址連接到網絡上的 CPU。要實現此按鈕，請按以下步驟操作：1. 在窗體上放置一個按鈕并將其命名為“InsertDevice”。 2. 為按鈕編寫單擊事件： public voidInsertDevice_Click(object sender, EventArgs e) 3. 在輔助方法的 #region (頁15) 中，添加一個全局空方法： private void UpdateCPUStatus() { } 稍后您將向此方法添加代碼。4. 在 InsertDevice_Click 方法內，添加代碼以清除任何現有設備數據并清除 CPU 狀 態： CurrentCPU= null; ClearCPUStatus(); 5. 調用您的 ParseIP 方法，將輸入的 IP 地址從文本轉換為 32位大端無符號整數： uint ipAddress = ParseIP(InsertDeviceIPAddress.Text);在整個應用程序中，根據需要添加錯誤檢查。為簡單起見，本教程省略了典型的錯誤處理 代碼。 使用 IP 地址以連接至 CPU現在您的窗體上有一個帶標簽的文本框和相應的按鈕，下面編寫代碼以查找網絡上的 CPU。找到 CPU 后，您的應用程序可以從 CPU讀取設備信息。 API 提供了設備集合類別，IProfinetDeviceCollection (頁 96)。您將把 CPU 插入集合 (Devices)，以便可以在 CPU 上執行后續設備操作。Network (頁 87) 類別的ScanNetworkDevices (頁 90) 方法用于將 CPU 輸入集合。將設備轉換為 CPU（ICPU (頁 146)類別）并保存引用。應用程序通過 CurrentCPU 在 CPU 上執行所有設備操作： CurrentCPU = Devices[0]as ICPU; 5. 更新設備的狀態： UpdateCPUStatus(); 6. 同樣，添加對返回的操作結果的適當錯誤檢查。 7.構建解決方案并驗證代碼是否可編譯。 在設備集合中成功插入 S7-1200 或 S7-1500 CPU 后，您的下一個任務是 顯示CPU 信息 (頁 22)。顯示和信任 TLS 證書 如果您的應用程序將支持可通過 TLS V1.3 及更高版本的證書實現安全PG/PC 通信的 CPU，則必須創建相應的機制，使用戶能夠顯示并設置 TLS 證書的信任等級。ICPU 證書提供顯示證書的方法：ICPU.CertificateStore.ShowDialog() 和設置證書信任等級的方法：ICPU.SetTrustCertificateStore()。 選擇證書信任等級提供一個方框，用戶可通過此框選擇證書信任等級。此框允許客戶選擇“從不”(Never)、 “始終”(Always)或“需要選擇”(Selection needed)。*后一項為默認設置，將通過組合框完 成此選項的設置。要實現設置，請按以下步驟操作：1. 在窗體上放置一個組合框并將其命名為“TrustTLSCertificate”。 2.向項目集合添加三個項目：“從不”(Never)、“始終”(Always) 和“需要選擇”(Selection needed)。 3.雙擊組合框并將以下代碼添加到 SelectedIndexChanged 方法 顯示 CPU 信息此時在應用程序中，您已實現連接到網絡上 CPU 的控件。既然您的應用程序已成功建立 此連接，接下來添加控件和邏輯以顯示有關設備的信息：添加 CPU 設備信息的標簽 將標簽控件添加到您的窗體中，并對每個標簽進行描述： 窗體上的文本 標簽控件名稱 設備：DeviceName 訂貨號： ArticleNumber 操作模式： OperatingMode 將每個標簽控件的 AutoSize設置為 FALSE，并將寬度設置得足夠大，以容納每個字段的*大預期文本在之前的任務中，您創建了兩個空幫助方法：ClearCPUStatus (頁 15) 和 UpdateCPUStatus(頁 16)。您的下一個任務是為這些方法添加代碼以獲取 CPU 設備信 息： 1. 將以下代碼插入 ClearCPUStatus()：DeviceName.Text = string.Empty; ArticleNumber.Text = string.Empty;OperatingMode.Text = string.Empty; 請注意，當用戶尚未連接到 CPU時，每個字段*初顯示“...”。 2. 在 UpdateCPUStatus() 中，插入以下代碼： DeviceName.Text =CurrentCPU.Name; ArticleNumber.Text = CurrentCPU.ArticleNumber;OperatingMode.Text = CurrentCPU.OperatingMode == OperatingState.Run? "RUN" : "STOP"; 回想一下，CurrentCPU 包含您在通過 IP 地址連接到網絡上的 CPU (頁16)中從設備 讀取的設備信息。當用戶單擊“插入設備”(Insert Device) 按鈕時， InsertDevice_Click方法將調用 ClearCPUStatus 方法和 UpdateCPUStatus 方法。 3.在繼續下一步之前編譯并測試您的程序：更改 CPU 的操作模式 (頁 23) 2.2.6 更改 CPU 的操作模式到目前為止，您已完成以下任務： ? 接受來自可用網絡接口的選定接口 (頁 15) ? 通過 IP 地址連接到網絡上的 CPU (頁16) ? 顯示 CPU 信息 (頁 22) 此示例程序的下一個任務是添加按鈕控件和邏輯以更改操作模式