EoeSetSlaveEoeIp

配置 EtherCAT 從站之 EtherCAT Ethernet (EoE) 網路設定。欲獲得更多有關 EoE 的資訊，請見 EtherCAT 乙太網路。

語法

KsCommandStatus EoeSetSlaveEoeIp(
     int SlaveId,
     unsigned long long Mac,
     DWORD Ip,
     DWORD Subnet,
     DWORD Gateway,
     DWORD Dns,
     char* DnsName
);

參數

SlaveId：從站陣列的索引。當 EtherCAT 從站裝置啟動時，此索引具有與 SlaveId 相同的值，該值對應於從站裝置在網路中的位置。請注意，在 EtherCAT 進入運行 (Op) 狀態後，加入或移除網路上的任何從站裝置將改變各裝置在網路中的位置 (SlaveId)。儘管如此，從站的索引將保持不變。新增的裝置將排列在陣列的末端。對於更改後的所有從站，索引和 SlaveId 將不再匹配。上述行為模式僅適用於實體裝置；不適用於模擬裝置。詳細資訊請參閱 EnableHotConnect 中的使用案例。

Mac：從站的 MAC 位址。

Ip：從站的 IP 位址。

Subnet：從站的子網路。

Gateway：從站的閘道。

Dns：從站的 DNS。

DnsName：從站的 DNS 名稱。

回傳值

如果此函式執行成功，會回傳 errNoError，否則會傳回錯誤碼。如需更多有關錯誤碼的資訊，請參閱 KsError 清單。

備註

• 若 EtherCAT 從站支援 EoE，且在 RTX64 控制台中，網路與介面 (Network and interfaces) 底下的 管理介面 (Manage interfaces) 中， 裝置 (Device) 設定為 RTX64 虛擬網路介面 (Virtual Network Interface)，在 進階 NAL Properties (Advanced NAL properties) > TCP/IP Stack properties，Filter Name 設定為 KSeoe.rtdll，則從站將在啟動時自動獲取 IP 位址。
• IP、子網路、閘道及 DNS 通常以 "1.2.3.4" 表示，此四值皆在 0–255 的範圍且可以位元儲存，因此 DWORD 值為其位址的 4 位元。

可用的 EtherCAT 狀態

ecatPreOP, ecatSafeOP, ecatOP

範例

Command = WaitForCommand(
              5,
              false,
              EoeSetSlaveEoeIp(
                  0,                 //SlaveID
                  0x093A284FC23C,    //Mac
                  3232261123,        //IP 192.168.100.3
                  4294967040,        //Subnet, 255.255.255.0
                  0,                 //Gateway
                  0,                 //DNS
                  ""                 //DNSName
              )
          );

使用需求

參見

EtherCAT 乙太網路