PMX PythonLib FactoryReset()
『PMX Library for Python』のFactoryReset()関数について解説します。
【解説】
FactoryResetコマンドは、サーボに保存されているROM領域のデータを工場出荷時のデータに書き換えるコマンドです。
変更の際は、誤動作を避けるためにシリアル番号でサーボを指定して処理を実行します。前述のSystemREADコマンドでサーボのシリアル番号を取得してから使用してください。
なお、ID、通信速度、バリティ、応答時間はFactoryResetコマンドの対象外です。こちらを変更する場合はSystemWRITEコマンドを使用してください。
FactoryResetコマンドは、サーボのトルクスイッチが「Free」の状態でのみ実行可能です。その他の状態で実行すると、ステータスエラーとして「モードエラー」が返りコマンドは実行されません。
※FactoryResetコマンドは、処理に時間がかかります。次のパケットは、実行後に約1000ms待ってから送ってください。
【構文】
status = FactoryReset(ID, serialNum)
【例】
|
1 2 3 4 |
flag = pmx.FactoryReset(ServoID, serialNum=None) # サーボのFactoryResetコマンドの処理が完了するまで待つ time.sleep(1.0) |
【パラメータ】
引数1：ID（int型）
第一引数の「ID」はサーボIDです。「ID」は、命令の対象になるサーボを指定しています。「ID」を0に指定すると、ID0のサーボを指定することができます。
引数2：serialNum（int型(符号なし4バイトデータ)）
第二引数の「serialNum」はシリアル番号です。SystemREAD()関数、またはgetSerialNumber()関数を使用してサーボから読み出します。serialNum=Noneとすると、SystemWRITE()関数内でシリアル番号を読み出します。また、引数のデフォルトでNoneが代入されていますのでSystemWRITE()関数内でシリアル番号を読み出す場合は、省略することができます。
【戻り値】
戻り値1：status（int型）
戻り値は、サーボとの通信状態とサーボの状態が正常かどうかのステータスを足したものが返ってきます。データが0であれば問題ありません。0以外の場合は、なんらかの問題が発生していますので、ステータス部がエラーの場合はオンラインマニュアルの『5.エラー状態』を、通信部がエラーの場合は『ComError』を参照してください。