Api.FoeReadFileToBuffer 方法
从伺服驱动器读取档案并将其储存于使用者应用程式的记忆体空间中。
命名空间:IntervalZero.KINGSTAR.OpcUa.Api
组合: IntervalZero.KINGSTAR.OpcUa.Api (于 IntervalZero.KINGSTAR.OpcUa.Client.dll) 版本:4.4.0.0
语法
public KsCommandStatus FoeReadFileToBuffer(
int SlaveId,
bool BootState,
string Name,
uint Password
)
Public Function FoeReadFileToBuffer(
SlaveId As Integer,
BootState As Boolean,
Name As String,
Password As UInteger
) As KsCommandStatus
参数
SlaveId
型别:int
从站阵列的索引。当 EtherCAT 从站装置启动时,此索引具有与 SlaveId 相同的值,该值对应于从站装置在网路中的位置。请注意,在 EtherCAT 进入运行 (Op) 状态后,加入或移除网路上的任何从站装置将改变各装置在网路中的位置 (SlaveId)。尽管如此,从站的索引将保持不变。新增的装置将排列在阵列的末端。对于更改后的所有从站,索引和 SlaveId 将不再匹配。上述行为模式仅适用于实体装置;不适用于模拟装置。详细资讯请参阅 EnableHotConnect 中的使用案例。
BootState
型别:bool
判定从站是否处于 Bootstrap (Boot) 状态以使用 FoE。Boot 状态可用于更新韧体或配置从站的设定。
true:Boot 状态。
false:正常状态。
Name
型别:string
从装置读取档案名称。
Password
型别:uint
若装置需要密码以存取档案,则需在此设定密码,0 表示无密码。
回传值
回传 KsCommandStatus 类别。
备注
- 当 EtherCAT 连结正常开启,从站状态将为 Init -> PreOp -> SafeOp -> Op,若在从站状态为 Op 时使用此方法,并设定 BootState 为 true,则从站状态的变更将为 Op -> Init -> Boot,当任务完成,其状态将再次变更为 Init -> PreOp -> SafeOp -> Op。
- 此方法只能在 RTX64 中作为指标使用,无法在 RTX64 和 Windows 之间共享。
可用的 EtherCAT 状态
ecatBoot, ecatPreOP, ecatSafeOP, ecatOP
范例
N/A
参见