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 |
參見