以下の各機能はアナライザーをコントロールするために使われます。
Run()
アナライザーをランするか、レコーディングを開始します
Parameters: none
Return: S_OK = success, E_FAIL =
unsuccessful
Stop()
アナライザーもしくはレコーディングを停止します
Parameters: none
Return: S_OK = success, E_FAIL = unsuccessful
Record()
レコーディングを開始します
Parameters: none
Return: S_OK = success, E_FAIL =
unsuccessful
RecordPause()
レコーディングをポーズします。アナライザーは動作を継続しますが、データはWAVファイルに保存されますParameters:
none
Return: S_OK = success, E_FAIL =
unsuccessful
RecordResume()
ポーズしたレコーディングを再開します
Parameters: none
Return: S_OK = success, E_FAIL =
unsuccessful
FileStep( int numFFTSteps )
現在のファイル位置で指定した回数のFFTを実行します(Post-Processモードのみ)
Parameters: numFFTSteps:
1 or more
Return: S_OK = success, E_FAIL =
unsuccessful
Analyzer Configuration(アナライザー構成)
SetMode( long mode )
モードをセットします
Parameters: mode: 0 = Real-Time, 1 =
Recorder, 2 = Post-Process
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
ChannelEnable( long channel )
有効チャンネルを指定します
Parameters: channel = 0 - 15
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
ChannelDisable( long channel )
無効にするチャンネルを指定します
Parameters: channel = 0 - 15
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
RecordEnable( long channel )
レコーディングするチャンネルを指定します(前述ChannelEnable()で有効にしておかなければなりません)
Parameters: channel = 0 - 15
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
RecordEnable( long channel )
指定したチャンネルのレコーディングを無効にします
Parameters: channel = 0 - 15
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
LoadConfig( BSTR cfg_filename
)
指定した定義ファイル(.cfg)をロードします
Parameters: cfg_filename
= filename of the configuration file. Full path or just filename if file
located in /cfg folder
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
SaveConfig( BSTR cfg_filename
)
現在の設定値を指定した定義ファイル(.cfg)に保存します
Parameters: cfg_filename
= filename of the configuration file.
Return: S_OK = success, E_FAIL = unsuccessful,
E_INVALIDARG = invalid parameter
SetAverageSize( long channel, long size)
指定したチャンネルにアベレージサイズをセットします
Parameters: channel = 0 - 15; size =
average size 1 - 10000 (free run mode), 0 = Off, 1 = Fast, 2 = Medium, 3 =
Slow, 4 = Forever (SLM mode)
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
ResetAverage( long channel)
指定したチャンネルのアベレージ値をリセットします
Parameters: channel = 0 - 15
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
SetPeakHold( long channel_ext,
long peak_hold_type )
指定したチャンネルのピークホールドタイプをセットします
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels; peak_hold_type: 0 = Off, 1 = Fast, 2 = Medium, 3 = Slow, 4
= Forever
Return: S_OK = success, E_FAIL = unsuccessful,
E_INVALIDARG = invalid parameter
ResetPeakHold( long channel_ext
)
指定したチャンネルのピークホールドをリセットします
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
SetOverlapPercentage( long channel, long overlap_percent
)
指定したチャンネルのoverlap percentage値をセットします
Parameters: channel = 0 - 15; overlap_percent = 1 - 99
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
SetCompensationFile( long channel, BSTR comp_filename
)
指定したチャンネルのtransducer compensation ファイルをセットします
Parameters: channel = 0 - 15; comp_filename = filename of the transducer file.
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
SetMarkerFreq( long channel_ext,
long marker, float freqHz )
指定したチャンネルのマーカに周波数をセットします
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels; marker = 1 -
8, freqHz = frequency in Hz
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
ResetOverloadCount( )
すべてのチャンネルのオーバーロード検知をリセットします
Parameters: none
Return: S_OK = success, E_FAIL =
unsuccessful
DataLoggingEnable()
data loggingを有効にします
Parameters: none
Return: S_OK = success, E_FAIL =
unsuccessful
DataLoggingDisable()
data loggingを無効にします
Parameters: none
Return: S_OK = success, E_FAIL =
unsuccessful
LoadCalibrationFile( long channel, BSTR cal_filename
)
指定したチャンネルのキャリブレーションファイル(.cal)をロードします
Parameters: channel = 0 - 15; cal_filename = filename of the calibration file.
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
SaveCalibrationFile( long channel, BSTR cal_filename
)
指定したチャンネルのキャリブレーションファイル(.cal)を保存します
Parameters: channel = 0 - 15; cal_filename = filename of the calibration file.
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
FileOpen( long channel, BSTR wav_filename)
指定したチャンネルでWAVファイルを開きます
Parameters: channel = 0 - 15; wav_filename = full path to wave file
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
FileSave( long channel, BSTR wav_filename)
指定したチャンネルのWAVファイルを保存します
Parameters: channel = 0 - 15; wav_filename = full path to wave file
Return: S_OK = success, E_FAIL = unsuccessful,
E_INVALIDARG = invalid parameter
FileClose( long channel )
指定したチャンネルのWAVファイルを閉じます
Parameters: channel = 0 - 15
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
File Positioning(ファイル位置コントロール)
FileRewind( long channel )
指定したチャンネルのWAVファイルの頭(スタート位置)に移動します
Parameters: channel = 0 - 15
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
FileForward( long channel )
指定したチャンネルのWAVファイルの最終端(ストップ位置)に移動します
Description: Go to the end of the wave file
on the specified channel
Parameters: channel = 0 - 15
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
FileGoToTime( long channel, float seconds)
指定したチャンネルのWAVファイルの指定時間に移動します
Parameters: channel = 0 - 15; seconds =
file position in seconds
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
FileGoToSample( long channel, unsigned long sample)
指定したチャンネルのサンプル位置に移動します
Description:
Go to a sample position on the specified channel
Parameters:
channel = 0 - 15; sample = file position in samples
Return:
S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
FilePlaySegmentTime( long channel, float start_seconds,
float stop_seconds)
指定したチャンネルの指定したタイムセグメントを再生します
Parameters: channel = 0 - 15; start_seconds = segment start time; stop_seconds
= segment stop time
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
FilePlaySegmentSample( long channel, unsigned long start_sample, unsigned long stop_sample)
指定したチャンネルの指定したサンプルを再生します
Parameters: channel = 0 - 15; start_sample = segment start sample position; stop_sample = segment stop sample position
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
FileFilterSegmentTime( long channel, float start_seconds,
float stop_seconds)
指定したチャンネルの指定したタイムセグメントをフィルタ処理します
Parameters: channel = 0 - 15; start_seconds = segment start time; stop_seconds
= segment stop time
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
FileFilterSegmentSample( long channel, unsigned long start_sample, unsigned long stop_sample)
指定したチャンネルの指定したサンプルをフィルタ処理します
Description: Filter the specified time
segment for the selected channel
Parameters: channel = 0 - 15; start_sample = segment start sample position; stop_sample = segment stop sample position
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
FileProcessSegmentTime( long channel, float start_seconds,
float stop_seconds)
指定したチャンネルの指定したタイムセグメントにスペクトラデータを処理します
Parameters: channel = 0 - 15; start_seconds = segment start time; stop_seconds
= segment stop time
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
FileProcessSegmentSample( long channel, unsigned long start_sample, unsigned long stop_sample)
指定したチャンネルの指定したサンプルにスペクトラデータを処理します
Description: Process the spectral data for
the specified time segment for the selected channel
Parameters: channel = 0 - 15; start_sample = segment start sample position; stop_sample = segment stop sample position
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
RunGenerator()
シグナルジェネレータをスタートします
Parameters: none
Return: S_OK = success, E_FAIL =
unsuccessful
StopGenerator()
シグナルジェネレータをストップします
Parameters: none
Return: S_OK = success, E_FAIL =
unsuccessful
SetGeneratorSignalType( long channel_sig,
long signal_type )
指定したチャンネルに信号のフォーム/タイプをセットします
Parameters: channel = 0 - 1; signal_type - as follows:
0 = White Noise
1 = Pink Noise
2 = Noise Burst
3 = 1 kHz Tone
4 = Multiple Tones
5 = Tone Burst
6 = IMD Tones
7 = Freq Sweep
8 = Level Sweep
9 = Sawtooth
10 = Triangular
11 = Pulse
12 = Squarewave
13 = User Defined wave file
14 = DTMF
15 = Digital Zero
16 = Frequency Step
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
SetGeneratorLevel( long channel_sig,
float volts )
指定したチャンネルの信号レベルをセットします
Parameters: channel = 0 - 1; volts = rms voltage level
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
Note: このコマンドを使用すると、出力単位がボルトに変わります
SetGeneratorFreq( long channel_sig, float freqHz )
シグナルタイプをマルチトーンに設定し、指定された周波数で1つのトーンのみを有効にします。 マルチトーンのレベルは 0 dBFS に設定されます
(出力レベルを設定するには SetGeneratorLeve() を使用します)
Parameters: channel_sig = 0 - 1; freqHz = frequency in Hz
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
Note: このコマンドを使用すると、信号の種類が Multiple Tones に変更されます
LoadGeneratorMultiToneFile( long channel_sig, BSTR toneFilename )
ディスクから.tonesファイルをロードします-これにより、トーンのセットを変更できます
Parameters: channel_sig = 0 - 1; toneFilename = name of .tones file
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
Note: このコマンドを使用すると、信号の種類が Multiple Tones に変更されます
Digital Input and Output Lines
SpectraDAQ-200ハードウェアモジュールには、リレーなどの外部機器を制御および読み取るためのデジタル入力および出力ラインがあります。 これらの関数を使用すると、これらの行の状態を読み書きできます。 3つの入力ラインと3つの出力ラインがあります。
GetDigitalInputLineState( DWORD *state )
デジタル入力ラインの現在の状態を取得します
Parameters: state = pointer to value to receive the current state of the digital input lines
Return: S_OK = success, E_FAIL = unsuccessful
SetDigitalOutputLineState( DWORD state )
デジタル出力ラインの現在の状態を設定します
Parameters: state = value containing the new state to set the output lines
Return: S_OK = success, E_FAIL = unsuccessful