透過 EtherCAT ADS (AoE) 同時讀取與寫入數據。
語法
KsCommandStatus AoeReadWriteCommand(
int SlaveId,
int Port,
int IndexGroup,
int IndexOffset,
BYTE* ReadValue,
int ReadLength,
BYTE* WriteValue,
int WriteLength
);參數
SlaveId：即從站索引 (Slave Index)。此索引是 KINGSTAR 主站於 EtherCAT 網路啟動時，根據實體連接順序自動指派的。直接連線到主站的第一個裝置會被指派為索引 0 (Index 0)，接著是索引 1、索引 2，依此類推。即使新增、移除或重新連線裝置，這些索引在從站陣列中也會保持一致。請參閱 熱插拔 (HotConnect)、修復與重啟 中的使用案例以了解更多詳細資訊。
Port：EtherCAT 從站連接埠。
IndexGroup：欲讀取與寫入的物件索引組。
IndexOffset：組內物件的偏移量。
ReadValue：欲讀取值的指標。
ReadLength：欲讀取值的長度（位元）。
WriteValue：欲寫入包含值的緩衝區指標。
WriteLength：欲寫入值的位元長度。
回傳值
返回 KsCommandStatus 結構。
可用的 EtherCAT 狀態
ecatPreOP, ecatSafeOP, ecatOP
範例
複製
BYTE valueRead = 0;
BYTE valueWrite = 1;
AoeReadWriteCommand(1, 0x1070, 0x6060, 0, &valueRead, 1, &valueWrite, 1);使用需求
| RT | Win32 | |
|---|---|---|
| 最低支援版本 | 4.0 | 4.0 |
| 標頭檔 | ksapi.h | ksapi.h |
| 程式庫 | KsApi_Rtss.lib | KsApi.lib |
參見