EnableAliases

启用轴的别名索引与所有函式的 I/O 索引参数。别名索引需第一个设定，使应用程式能有不同于实体 EtherCAT 连结的伺服器顺序。

语法

KsError EnableAliases(
     BOOL Active
);

参数

Active：此参数决定是否使用别名，设置 TRUE 以启用；FALSE 停用别名，预设为 FALSE。

回传值

如果此函式执行成功，会回传 errNoError，否则会传回错误码。如需更多有关错误码的资讯，请参阅 KsError 清单。

备注

获取各驱动器的细节，并使用供应商、产品与别名来识别各驱动器，若驱动器未依正确顺序插入，请重新排列驱动器的列表，并在 KINGSTAR 子系统开始后使用此函式。

可用的 EtherCAT 状态

ecatOP

范例

// Define aliases for axes
#define AxisX 101
#define AxisZ 102
#define AxisC 103

// Apply the aliases
nRet = WriteAxisAlias(1, AxisX);
nRet = WriteAxisAlias(2, AxisZ);
nRet = WriteAxisAlias(0, AxisC);
nRet = EnableAliases(TRUE);

使用需求

参见

GetAliasesStatus

ReadIOAlias

WriteIOAlias