差分

このページの2つのバージョン間の差分を表示します。

--- tabuchi:xafsm2-remote [2021/02/24 04:52] – [1. 使用可能なコマンド一覧] mtab
+++ tabuchi:xafsm2-remote [2023/12/26 05:28] (現在) – [2.1 状態変化等の告知や、情報提供のために発生するイベント] mtab
@@ 行 24: / 行 24: @@
 XafsM2 が発生する[[#XafsM2 が発生するイベント|イベント]]を確認するようにして下さい。
+以下の記述で "[...]" はコマンドに渡すパラメータですが、"([...])" の様に "()" がついている場合は、
+そのパラメータが無くても良いことを表します。\\
+また スラッシュ記号("/") は、"or" の意味で用いています。
 ==== - リモート動作全体に関連するコマンド ====
 ^ コマンド名 ^ 引数 ^ 説明 ^
@@ 行 52: / 行 54: @@
 ^ 測定準備/ブロック設定 ^ ^ ^
 | SetBlockNum   | [数値(ブロック数)] | 測定ブロックの数を指定する。 |
+| GetBlockNum   | 無し | 設定されている測定ブロック数を返す。 |
 | SetBlockUnit  | [数値] | ブロックの始点/終点指定の数字の単位を指定する。0 : eV, 1 : keV, 2 : A, 3 : deg |
 | SetBlock      | [行番号][始点][終点][刻み幅][時間]([刻み数]) | 測定ブロックの1行を設定する。\\ [行番号]は 0 始まり。始点/終点の数値の単位は SetBlockUnit で指定されたもの。\\ [刻み数]は無くても良い。[刻み数]があった場合は[刻み幅]が無視されて\\ ([終点]-[始点])/[刻み数] の値が刻み幅になる。 |
@@ 行 60: / 行 63: @@
 ^ 測定準備/検出器選択 ^ ^ ^
 | SelectXafsMeasMode | [数値] | 測定ブロック設定の上の「測定モード」ボタンを押したのと同様に\\ あらかじめ決められた検出器選択を行う。\\ 指定する数値は 0 から。左端のボタンが 0。|
-| SetXafsSensor | [引数1][引数2][引数3][引数4] | [引数1]の値によって[引数2]以下の有無や扱いが変化する。\\ ・[引数1] = 0 / I0 : [引数2]だけが有効。\\ 　[引数2] : 数字なら選択リストから選択。\\ 　　　　　文字列ならその文字列を ID とする検出器を選択("S001"等)。\\ ・[引数1] = 1 / I1 :   [引数3]までが有効。\\ 　[引数2] : 数字なら選択リストから選択。\\ 　　　　　文字列ならその文字列を ID とする検出器を選択("S001"等)。\\ 　[引数3] = 0 : 不使用、1 : 使用\\ ・[引数1] = 2 / F : [引数3]までが有効。\\ 　[引数2] : 何番目(0, 1, 2...)の蛍光検出器かの指定。\\ 　[引数3] = 0 : 不使用、1 : 使用\\ ・[引数1] = 3, 4 / A1, A2 : [引数4]まで有効。\\ 　[引数2] : 数字なら選択リストから選択。\\ 　　　　　文字列ならその文字列を ID とする検出器を選択("S001"等)。\\ 　[引数3] = 0 : 不使用、1 : 使用 \\ 　[引数4] = 数字 : リストから表示パタンを選択。 |
+| SetXafsSensor | [引数1][引数2][引数3][引数4] | [引数1]の値によって[引数2]以下の有無や扱いが変化する。\\ ・[引数1] = 0 / I0 : [引数2]だけが有効。\\ 　[引数2] : 数字なら選択リストから選択。\\ 　　　　　文字列ならその文字列を ID とする検出器を選択("S001"等)。\\ ・[引数1] = 1 / I1 :   [引数3]までが有効。\\ 　[引数2] : 数字なら選択リストから選択。\\ 　　　　　文字列ならその文字列を ID とする検出器を選択("S001"等)。\\ 　[引数3] = 0 : 不使用、1 : 使用\\ ・[引数1] = 2 / F : [引数3]までが有効。\\ 　[引数2] : 何番目(0, 1, 2...)の蛍光検出器かの指定。\\ 　[引数3] = 0 : 不使用、1 : 使用\\ ・[引数1] = 3, 4 / A1, A2 : [引数4]まで有効。\\ 　[引数2] : 数字なら選択リストから選択。\\ 　　　　　文字列ならその文字列を ID とする検出器を選択("S001"等)。\\ 　[引数3] = 0 : 不使用、1 : 使用 \\ 　[引数4] = 数字 : リストから表示パタンを選択 |
 ^ 測定準備/バックグラウンド ^ ^ ^
 | SetMeasDarkTime | [時間(秒)] | バックグラウンド測定時間を設定する。 |
@@ 行 71: / 行 74: @@
 | SetXafsFileFolder | [文字列] | DataRoot の下に [文字列]という名前のフォルダを作る。 |
 | SetXafsFileDir | [文字列] | SetXafsFileFolder と同じ動作。 |
+| SetXafsMeasComment | [文字列] | コメント文字列を設定 |
+^ 自動試料交換 ^ ^ ^
+| SetAutoModeEnable | [数値] | 自動試料交換モードを On にする: 1, しない: 0 |
+| SelectChanger | [数値]/[文字列(id)] | 試料交換に使用するチェンジャを選択する |
+| SetAutoModeParams | [文字列] | 自動交換する試料の指定/設定 |
+| MoveSHolderTo | [文字列] | 特殊ホルダーを、名前のついた特定の位置に移動する |
 ^ 測定準備/その他 ^ ^ ^
 | SetXafsRpt | [数値] | XAFS測定の繰り返し回数を設定する。 |
+| SetXafsFinishMode | [数値] | XAFS測定終了時に分光器の角度をどこに持っていくかの設定。0: 原位置復帰、1:その場に停止 |
+| GetXafsFinishMode | 無し | Finish Mode の設定値確認 |
 ==== - XafsM2 から情報を取得するためのコマンド ====
@@ 行 104: / 行 114: @@
 | _EvSelectedAtom    | [原子番号] [原子名] | 測定対象の原子が選択された時に発生する。 |
 | _EvNewEnergy       | [数値]eV | ステップXAFS測定の際に、新しいエネルギー店に移動した時に発生する。 |
+| _EvSetDwellTimeMs  | [数値] | 測定時間が設定された時にその時間を告知。単位は[ms]。 |
 | _EvDataFileName    | [ファイル名] | Quick XAFS の結果を記録する[ファイル名]を告知する為に発生する。\\ 情報としては _EvNewFileStart と重複するが HiPic2Stars との連携の為に発生する。 |
 | _EvExecLog         | [状態名] [状態番号] | ExecLog 的な状態変化の通知 |
+| _EvGetValue0       | 無し | 計測前に準備が必要な計測器のために GetValue0 を発信したことを告知 |
+| _EvGetValue        | 無し | 計測器に計測開始を支持する GetValue を発信したことを告知 |
+| _EvFinishedGetValue | 無し | 全計測器の計測終了を確認したことを告知 |
+| _EvReadValue       | 無し | 計測器に測定値を尋ねたことを告知 |
+| _EvCheckingI0Start | 無し | I0確認を開始したことを告知 |
+| _EvCheckingI0End   | 無し | I0確認が終了したことを告知 |
+| _EvNewSScanStart   | [数値] | 1軸スキャンを開始(1)したことを告知。多分、終了(0)も告知 |
+| _EvNewSScanPos     | [数値] | 1軸スキャン中にその軸の位置が変化したことを告知 |
+| _EvMovingCurTh     |       | 分光器の主軸θが移動中であることを告知 |
+| _EvChangerMoving   |       | 試料交換機が移動中であることの告知 |
@@ 行 113: / 行 136: @@
 ^ イベント名 ^ 付随する値 ^ 発生理由 / 意味 ^
+| _EvErrStartXAFSMeas | XAFS測定が開始できなかった時にウインドウ下部に表示される理由を示すメッセージと同等のもの(日本語化されていない) |
 | _EvMeasNoDisorder | Er:[ドライバ名] [計測番号] [一つ前の計測番号] | 連続した計測の計測番号の差が 1 になっていない時に発生。 |
 | _ErWrongXafsMeasID | Er:[ドライバ名] [送信した計測ID] [受信した計測ID] | 計測時にドライバに渡した計測ID と違う ID を付与された\\ データが返ってきた時に発生。|
 | _EvAllCountsAreTheSameAsOldOnes | Er: | 全チャンネルの計測値が、一つ前の回の計測値と\\ 同じだった時に発生。 |
 | _EvSendNack | Er:Data-Wait-Timeout | データ転送待ちがタイムアウトしたためにドライバに\\  NACK を送った時に発生。 |
+| _EvErrRemote | | リモートコマンドのやり取りでなにか不具合が起こったことの通知 | |
+| _EvErrChangerMove | | 試料交換機を指定位置に移動できなかったことの告知 | |