プログラムコマンドでの記録

プログラムコマンドやスマートTP、WINCAPSIIIでログを記録するタイミングを操作できるログは、制御ログ、サーボログ、トレースログです。これらのログはリングバッファと呼ばれるメモリ領域を使用してログを記録します。リングバッファは一定の容量を持ち、一番古いデータに新しいデータを書き込み更新しています。

記録開始時	バッファサイズを超えた時

コマンドの種類

下記の3つのコマンドにより、プログラムの指定部分のログを残すことができます。

クリアログコマンド

リングバッファに保持されているデータを削除し、ログの記録を開始します。
記録したログデータを取得する場合は、下記の、スタ―トログコマンドやストップログコマンドの実行が必要になります。

各ログのクリアログコマンドは、以下の通りです。

制御ログ/サーボログ	ClearLog
	SysLog.Ctrl.Clear
トレースログ	SysLog.Trace.Clear

スタートログコマンド

ログデータの取得を開始します。

このコマンドを実行するとクリアログコマンドで開始した記録からログデータの取得を開始します。

スタートログコマンド実行前に、クリアログコマンドが実行されていない場合は、リングバッファに保持されているデータの削除を行ってから、ログデータの取得を開始します。この場合は、スタートログコマンドの実行時に、ログの記録とログデータの取得が同時に開始されます。

各ログのスタートログコマンドは以下の通りです。

制御ログ/サーボログ	StartLog
	SysLog.Ctrl.Start
トレースログ	SysLog.Trace.Start

ストップログコマンド

ログの記録停止を指定します。このコマンド位置でリングバッファへの記録を停止します。

各ログのストップログコマンドは以下の通りです。

制御ログ/サーボログ	StopLog
	SysLog.Ctrl.Stop
トレースログ	SysLog.Trace.Stop

取得の対象となるログデータについて

クリアログコマンドで記録が開始されますが、ログデータの取得はされません。設定したパラメータ、スタートログコマンド、ストップログコマンドによって、取得できるログデータが異なります。

ログデータの取得開始と終了のタイミングによる違いを図と共に説明します。

下図の水色の線がログの記録で、赤色の線が取得できるログデータになります。

1. スタートログコマンドから、あらかじめパラメータで設定した時間までのログ

記録の開始: クリアログコマンドの実行

ログデータ取得の開始: スタートログコマンドの実行

ログデータ取得の終了: パラメータ [制御ログ記録時間] で設定した時間が経過

クリアログコマンドなどにより記録を開始したあと、スタートログコマンドを実行して、ログデータの取得を開始します。その後、ストップログコマンドを実行する前に、パラメータによって設定した記録時間が経過した場合、その時点でのログデータを取得できます。

2. スタートログコマンドから、ストップログコマンドまでのログ

記録の開始: クリアログコマンドの実行

ログデータ取得の開始: スタートログコマンドの実行

ログデータ取得の終了: ストップログコマンドの実行

クリアログコマンドなどにより記録を開始したあと、スタートログコマンドを実行して、ログデータの取得を開始します。その後、パラメータによって設定した記録時間が経過する前に、ストップログコマンドを実行した場合、その時点でのログデータを取得できます。

3. ストップログコマンドまたはエラー発生時から、あらかじめパラメータで設定した時間まで遡ったログ

記録の開始: クリアログコマンドの実行

ログデータ取得の開始: なし

ログデータ取得の終了: ストップログコマンドの実行またはエラー発生

クリアログコマンドなどにより記録を開始したあと、スタートログコマンドを実行していなかった場合、ストップログコマンドを実行またはエラーが発生したときからパラメータで設定した時間分の記録を遡り、ログデータを取得できます。

エラーなどによって記録が停止しても、リングバッファが記録を保持しているため、エラー発生直前の記録まで遡ってログデータを取得することができます。

ただし、記録の開始からログデータ取得の終了までの時間が、設定時間より短い場合は、記録を開始した時点までしか遡ることができません。

ログ停止タイミング

ログのリングバッファへの記録は、下記のタイミングで停止します。

• スタートログコマンドから、あらかじめパラメータで設定した時間経過時
• ストップログコマンド実行時
• エラーが発生したとき