Api.FoeWriteFileFromFile 方法

从本机读取档案,并将其写入装置中。

命名空间IntervalZero.KINGSTAR.Local.Api

组合: IntervalZero.KINGSTAR.Local.Api (于 IntervalZero.KINGSTAR.Local.dll) 版本:4.4.0.0

语法

C#VB
public KsCommandStatus FoeWriteFileFromFile(
       int SlaveId,
       bool BootState,
       string Name,
       uint Password,
       string File
)
Public Function FoeWriteFileFromFile(
       SlaveId As Integer,
       BootState As Boolean,
       Name As String,
       Password As UInteger,
       File As String
) 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 表示无密码。

 

File

型别:string

欲写入装置磁碟的路径档案。

回传值

型别:KsCommandStatus

回传 KsCommandStatus 类别。

备注

EtherCAT 连结正常开启,从站状态将为 Init -> PreOp -> SafeOp -> Op,若在从站状态为 Op 时使用此方法,并设定 BootState true,则从站状态的变更将为 Op -> Init -> Boot,当任务完成,其状态将再次变更为 Init -> PreOp -> SafeOp -> Op。

可用的 EtherCAT 状态

ecatBoot, ecatPreOP, ecatSafeOP, ecatOP

范例

C#
                N/A
            

参见

Api 类别

IntervalZero.KINGSTAR.Local.Api 命名空间