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 乙太网路