Api.FoeWriteFileFromBuffer 方法
从本机缓冲区读取档案,并将其写入装置中。
命名空间:IntervalZero.KINGSTAR.Local.Api
组合: IntervalZero.KINGSTAR.Local.Api (于 IntervalZero.KINGSTAR.Local.dll) 版本:4.4.0.0
语法
public KsCommandStatus FoeWriteFileFromBuffer(
int SlaveId,
bool BootState,
string Name,
uint Password,
byte[] Buffer
)
Public Function FoeWriteFileFromBuffer(
SlaveId As Integer,
BootState As Boolean,
Name As String,
Password As UInteger,
Buffer As Byte()
) As KsCommandStatus
参数
SlaveId
型别:int
即从站索引 (Slave Index)。此索引是 KINGSTAR 主站于 EtherCAT 网路启动时,根据实体连接顺序自动指派的。直接连线到主站的第一个装置会被指派为索引 0 (Index 0),接著是索引 1、索引 2,依此类推。即使新增、移除或重新连线装置,这些索引在从站阵列中也会保持一致。请参阅 热插拔 (HotConnect)、修复与重启 中的使用案例以了解更多详细资讯。
BootState
型别:bool
判定从站是否处于 Bootstrap (Boot) 状态以使用 FoE。Boot 状态可用于更新韧体或配置从站的设定。
true:Boot 状态。
false:正常状态。
Name
型别:string
欲写入装置的档案名称。
Password
型别:uint
若装置需要密码以存取档案,则需在此设定密码,0 表示无密码。
Buffer
型别:byte[]
包含欲写入档案的缓冲区。
回传值
回传 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
参见