Api.CoeWriteSdoObject 方法

透過 CoE (CANopen over EtherCAT) 寫入 SDO 物件值。各模組的模組表均不相同,可從各模組的使用手冊中取得。此方法須經過多次週期才可完成。

命名空間IntervalZero.KINGSTAR.Local.Api

組合: IntervalZero.KINGSTAR.Local.Api (於 IntervalZero.KINGSTAR.Local.dll) 版本:4.4.0.0

語法

C#VB
public KsCommandStatus CoeWriteSdoObject(
       int SlaveId,
       int ObIndex,
       int ObSubIndex,
       bool CompleteAccess,
       byte[] Value
)
Public Function CoeWriteSdoObject(
       SlaveId As Integer,
       ObIndex As Integer,
       ObSubIndex As Integer,
       CompleteAccess As Boolean,
       Value As Byte()
) As KsCommandStatus

參數

SlaveId

型別:int

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

 

ObIndex

型別:int

物件的 CANopen 索引。請參見裝置說明書以取得此值。

 

ObSubIndex

型別:int

物件的 CANopen 子索引。請參見裝置說明書以取得此值。

 

CompleteAccess

型別:bool

TRUE:寫入所有子索引。FALSE:寫入單一子索引。

 

Value

型別:byte[]

包含欲寫入物件的資料的緩衝區。

回傳值

型別:KsCommandStatus

回傳 KsCommandStatus 類別。

備註

用於驅動器關閉時更新驅動器設定,請詳閱驅動器的說明書以得知 SDO 的使用時機與方式。若在驅動器啟動時呼叫此方法,依各驅動器的反應不同,可能會發生錯誤。

可用的 EtherCAT 狀態

ecatPreOP, ecatSafeOP, ecatOP

範例

C#
                N/A
            

參見

Api 類別

IntervalZero.KINGSTAR.Local.Api 命名空間