AioSetAiFilter

機能

アナログ入力値に対してのフィルタを設定します。

書式

Ret = AioSetAiFilter ( Id ,  AiChannelNo , AiChannelNum , FilterType , FilterValueLow , FilterValueHigh , FilterUnit )

引数

Id [ C, C++： short ] [ Python： ctypes.c_short ]
AioInit 関数で取得したデバイスＩＤを指定します。

AiChannelNo [ C, C++： unsigned short * ] [ Python： ctypes.POINTER(ctypes.c_ushort) ]
チャネル番号を配列に入れて、その配列の先頭アドレスを指定します。

AiChannelNum [ C, C++： unsigned short ] [ Python： ctypes.c_ushort ]
AiChannelNoで指定したチャネル数を指定します。

FilterType [ C, C++： unsigned short * ] [ Python： ctypes.POINTER(ctypes.c_ushort) ]
フィルタタイプを配列に入れて、その配列の先頭アドレスを指定します。

フィルタタイプ

マクロ

値[dec]

フィルタ無効

AIO_PARAM_AI_FILTER_TYPE_DISABLE

0

ローパスフィルタ

AIO_PARAM_AI_FILTER_TYPE_LOW_PASS

1

FilterValueLow [ C, C++:unsigned long long *] [ Python: ctypes.POINTER(ctypes.c_ulonglong) ]
フィルタ下限値の値を配列に入れて、その配列の先頭アドレスを指定します。

フィルタ無効の場合、本引数は使用しません。
ローパスフィルタの場合、本引数の値を指定します。

FilterValueHigh [ C, C++:unsigned long long *] [ Python: ctypes.POINTER(ctypes.c_ulonglong) ]
フィルタ上限値の値を配列に入れて、その配列の先頭アドレスを指定します。

フィルタ無効の場合、本引数は使用しません。
ローパスフィルタの場合、本引数は使用しません。

FilterUnit [ C, C++： unsigned short * ] [ Python： ctypes.POINTER(ctypes.c_ushort) ]
フィルタ設定値の単位を配列に入れて、その配列の先頭アドレスを指定します。

フィルタ下限値、フィルタ上限値共通の単位になります。
フィルタ無効の場合、本引数は使用しません

フィルタ設定値の単位

マクロ

値[dec]

MHz

AIO_PARAM_AI_FILTER_UNIT_MEGA_HZ

1

kHz

AIO_PARAM_AI_FILTER_UNIT_KIRO_HZ

2

Hz

AIO_PARAM_AI_FILTER_UNIT_HZ

3

mHz

AIO_PARAM_AI_FILTER_UNIT_MIRI_HZ

4

戻り値

Ret [ C, C++： long ] [ Python： ctypes.c_long ]

戻り値

内容

0

正常終了

10001

無効なIDが指定されました
関数に指定するIDは、AioInitで取得したIDを使用してください。

10002

ドライバを呼び出せません
始めにAioInit関数を実行しください。

20001

使用しているデバイスではこの関数を使用することができません。

22550

AiChannelTypeの値が使用しているデバイスの範囲外です

22551

AiChannelNoの値が使用しているデバイスの範囲外です

22552

FilterTypeの値が使用しているデバイスの範囲外です

22553

FilterValueLowの値が使用しているデバイスの範囲外です

22554

FilterValueHighの値が使用しているデバイスの範囲外です

22555

FilterUnitの値が使用しているデバイスの範囲外です

初期値

フィルタ無効。（フィルタタイプ=0）

説明

アナログ入力値に対してのフィルタを設定します。

デバイス別仕様

AI-80M1202-PE

設定可能な値は、「フィルタ無効」、または、「ローパスフィルタ 20MHz」です。

使用例

0チャネルに、ローパスフィルタ(AIO_PARAM_AI_FILTER_TYPE_LOW_PASS)、フィルタ下限値=20MHzを設定します。

C, C++

long Ret;
unsigned short AiChannelNo[0];
unsiged short FilterType[0];
unsigned long long FilterValueLow[0];
unsigned long long FilterValueHigh[0];
unsigned short FilterUnit[0];

AiChannelNo[0] = 0;
FilterType[0] = AIO_PARAM_AI_FILTER_TYPE_LOW_PASS;
FilterValueLow[0] = 20;
FilterValueHigh[0] = 0;
FilterUnit[0] = AIO_PARAM_AI_FILTER_UNIT_MEGA_HZ;

Ret = AioSetAiFilter ( Id , &AiChannelNo[0] , 1 , &FilterType[0] , &FilterValueLow[0], &FilterValueHigh[0] , &FilterUnit[0] )
　

Python

Ret = ctypes.c_long()
AiChannelNoType = ctypes.c_ushort() * 1
AiChannelNo = AiChannelNoType()
FilterTypeType = ctypes.c_ushort() * 1
FilterType = FilterTypeType()
FilterValueLowType = ctypes.c_ulong() * 1
FilterValueLow = FilterValueLowType ()
FilterValueHighType = ctypes.c_ulong() * 1
FilterValueHigh = FilterValueHighType()
FilterUnitType = ctypes.c_ushort() * 1
FilterUnit = FilterUnitType()  

AiChannelNo[0] = 0
FilterType[0] = caio.AIO_PARAM_AI_FILTER_TYPE_LOW_PASS
FilterValueLow[0] = 20
FilterValueHigh[0] = 0
FilterUnit[0] = caio.AIO_PARAM_AI_FILTER_UNIT_MEGA_HZ

Ret.value = caio.AioSetAiFilter ( Id , AiChannelNo , 1 , FilterType , FilterValueLow, FilterValueHigh , FilterUnit  )
　

関連項目

AioGetAiFilter