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
從站陣列的索引。當 EtherCAT 從站裝置啟動時,此索引具有與 SlaveId 相同的值,該值對應於從站裝置在網路中的位置。請注意,在 EtherCAT 進入運行 (Op) 狀態後,加入或移除網路上的任何從站裝置將改變各裝置在網路中的位置 (SlaveId)。儘管如此,從站的索引將保持不變。新增的裝置將排列在陣列的末端。對於更改後的所有從站,索引和 SlaveId 將不再匹配。上述行為模式僅適用於實體裝置;不適用於模擬裝置。詳細資訊請參閱 EnableHotConnect 中的使用案例。
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
參見