SlaveStatus

EtherCAT 从站状态。

名称 类型 定义
Name[64] CHAR 装置名称。
VendorId DWORD 装置的供应商 ID，由 EtherCAT 技术组提供给 EtherCAT 装置制造商。
ProductCode DWORD 装置之产品码。
RevisionNumber DWORD 装置之修订号码。
SerialNumber DWORD 装置之序列号。
SlaveId int 即从站索引 (Slave Index)。此索引是 KINGSTAR 主站于 EtherCAT 网路启动时，根据实体连接顺序自动指派的。直接连线到主站的第一个装置会被指派为索引 0 (Index 0)，接著是索引 1、索引 2，依此类推。即使新增、移除或重新连线装置，这些索引在从站阵列中也会保持一致。请参阅 热插拔 (HotConnect)、修复与重启 中的使用案例以了解更多详细资讯。
SlotId int

用于 IO-Link 装置，插槽 IO-Link 主站的 IO-Link 连接埠，可连接到 EtherCAT 网络，SlotId 是连接模组（IO-Link 从站）的插槽 ID，在 CAN 装置中则是 CAN ID。

对于非模组化装置，该值为 -1。

PhysAddress USHORT PhysAddress 是装置的实体位址，EtherCAT 主站会使用此位址来存取装置。此位址会在主站启动期间设定。其值为 1001 + 从站索引。
AliasAddress USHORT

AliasAddress (亦称作 station alias) 用于识别多个具有相同 供应商 ID (Vendor ID) 和 产品代码 (Product code) 的相同装置。它是一个软体定义的值，储存在装置的 EEPROM 中，可透过工具或 EtherCAT 主站 (使用 WriteSlaveAlias 命令) 写入。您可以为特定的装置设定别名位址，例如 X 轴、Y 轴和 Z 轴。当别名位址变更后，装置必须重新启动电源 (power cycle) 才能使变更生效。

重要：别名位址理应为一个软体定义的值，但有些装置会将它对应至硬体的 DIP 开关，此开关即对应于 ExplicitId。在这种情况下，请勿透过软体变更此值，否则可能会触发装置错误。使用前，请检查您的装置使用者手册以了解 station alias 资讯。

注意：如果某个装置同时支援 AliasAddress 和 ExplicitId，您可以直接使用 ExplicitId 而无须设定 AliasAddress。

ExplicitId USHORT

ExplicitId 是预先设定好的位址，用于区分同一网路上的相同型号装置 (驱动器或 I/O 模组)。您必须在将装置新增至网路之前设定此 ID，设定方式可透过装置上的旋转式 DIP 开关，或是与装置搭售的设置工具。

注意：有些装置会将 ExplicitId 储存在 EEPROM 中。有关撷取 ExplicitId 的详细资讯，请参阅装置的 ESI 档案。
State EthercatState 装置的 EtherCAT 状态。
RequestedState EthercatState 从最新的 RequestState 函式呼叫中读取 EtherCAT 状态。
InputLength int 从装置上读取的输入资料长度。
OutputLength int 传送至装置的输出资料长度。
CycleTime int 从站之循环时间。如果 EtherCAT 网络上的从站无法赶上主站的循环时间，KINGSTAR 自动配置将根据其能力减慢循环时间。
VariableIndexOffset WORD 若使用的是多轴伺服驱动器，且想从其中一个轴读取数据，则可使用此参数来检索该轴的 SDO 物件位址的偏移值。 例如，第一个轴的实际位置在#x6064，若第二轴 在#x6864，则第二轴的偏移值为#x800，此参数只能在轴上使用。