WriteSlaveAlias

將別名位址寫入 EtherCAT 從站。

語法

KsCommandStatus WriteSlaveAlias(
     int SlaveId,
     WORD Alias
);

參數

SlaveId：即從站索引 (Slave Index)。此索引是 KINGSTAR 主站於 EtherCAT 網路啟動時，根據實體連接順序自動指派的。直接連線到主站的第一個裝置會被指派為索引 0 (Index 0)，接著是索引 1、索引 2，依此類推。即使新增、移除或重新連線裝置，這些索引在從站陣列中也會保持一致。請參閱 熱插拔 (HotConnect)、修復與重啟 中的使用案例以了解更多詳細資訊。

Alias：欲使用的的別名位址。請見 SlaveStatus 結構中的 AliasAddress。

回傳值

回傳 KsCommandStatus 結構。

備註

一些 EtherCAT 從站不開放變更別名位址，若主站對從站寫入一個從站無法接受的值，則從站可能會顯示錯誤並拒絕啟動。

可用的 EtherCAT 狀態

ecatInit, ecatPreOP, ecatSafeOP, ecatOP

範例

const WORD newAlias = 5;
WaitForCommand(3, TRUE, WriteSlaveAlias(0, newAlias));

使用需求

參見

ReadSlaveAlias