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:即从站索引 (Slave Index)。此索引是 KINGSTAR 主站于 EtherCAT 网路启动时,根据实体连接顺序自动指派的。直接连线到主站的第一个装置会被指派为索引 0 (Index 0),接著是索引 1、索引 2,依此类推。即使新增、移除或重新连线装置,这些索引在从站阵列中也会保持一致。请参阅 热插拔 (HotConnect)、修复与重启 中的使用案例以了解更多详细资讯。
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
)
);
使用需求
| RT | Win32 | |
|---|---|---|
| 最低支援版本 | 4.0 | 4.0 |
| 标头档 | ksapi.h | ksapi.h |
| 程式库 | KsApi_Rtss.lib | KsApi.lib |
参见