Frequently Asked Questions
How to edit AntiGllitch and AntiChattering parameters#5400-0438

Version 1.0.1.1

Information contained in this document is subject to change without prior notice.

FAQ How to edit AntiGlitch and AntiChattering parameters.
Document in Japanese
このドキュメントは AntiGlitch および AntiChattering パラメータをプログラムで編集する方法について記述したドキュメントです。日本語ドキュメントは英語ドキュメントの後にあります。
End of document in JapaneseThis document describes how to edit AntiGlitch and AntiChattering parameters in user application.

1. AntiGlitch and AntiChattering
AntiGlitch and AntiChattering are functions for filtering unexpected signal from digital input signal.
AntiGlitch circuit performs the integration of the digitalized input signal to remove impulsive noise.
AntiChattering circuit sets the edge insensible time to avoid trigger malfunction during the digital
input signal value is within unstable range.
AntiChattering circuit is also effective to remove mechanical switch chattering.

External
DeviceNoise
Skew
SourceSignalDigitalInput
PinDigital
Input
SignalBufferAntiGlitch
CircuitInternal
digitalizedSignal

CircuitOutput ofAntiGlitch
circuitInternalLogic

Output of
AntiChatteringcircuitCamera

Source signal

Digital input signal(Noisy and skewed)

Internal
digitalized signal

Integration ofdigitalized signal

Output ofAntiGlitch circuit

Output ofAntiChattering circuit

Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All rights reserved.

#5400-0438

www.toshiba-teli.co.jp

FAQ How to edit AntiGlitch and AntiChattering parameters.

2. Deciding AntiGlitch and AntiChattering parameter value
The larger AntiGlitch and AntiChattering parameter value, the stronger the noise immunity.
There are no standard values for AntiGlitch and AntiChattering parameters, because the magnitudeand frequency of noise will vary depending on the environment in which the camera is used.
It is a good idea to measure the noise on the trigger signal near the trigger signal input connector of
the camera using an oscilloscope and to select the parameter according to the noise level.
If you cannot measure the noise, please search for appropriate parameter value by trial and error.

3. Editing AntiGlitch and AntiChattering parameters
Camera controlling functions for AntiGlitch and AntiChattering features are added since PkgVer
2.3.0.1 of TeliCamSDK. “GenICam functions” or register direct access functions of TeliCamSDK are
also available for editing AntiGlitch and AntiChattering parameters.

3.1. Using Camera controlling functions
The following APIs are available in TeliCamSDK PkgVer 2.3.0.1 or later.
Methods of TeliCamDNetAPI in the following table are member methods of CameraControl class
TeliCamAPI
GetCamAntiGlitchMinMax
GetCamAntiGlitch
SetCamAntiGlitch
GetCamAntiChatteringMinMax
GetCamAntiChattering
SetCamAntiChattering

TeliCamDNetAPI
GetAntiGlitchMinMax
GetAntiGlitch
SetAntiGlitch
GetAntiChatteringMinMax
GetAntiChattering
SetAntiChattering

RemarsGets range of AntiGlitch value.
Gets AntiGlitch value
Sets AntiGlitch value
Gets range of AntiChattering value
Gets AntiChattering value
Sets AntiChattering value

3.2. Using GenICam functions
The following table shows nodes for editing AntiGlitch and AntiChattering parameters.
FeatureAntiGlitch
AntiChattering

Node name“AntiGlitch”“AntiChattering”

Node typeIFloat
IFloat

Unit
SecondSecondRemarks
Integration time.
Insensitive time.

The following is example code for TeliCamSDK PkgVer 3.0.0.1 or later to read current AntiGlitch
node value and write new value to the node. Codes for handling errors are not contained.
#include "TeliCamAPI.h"..............
CAM_HANDLE hCam = NULL;..............
double dValAntiGlitch = 0.0;
CAM_API_STATUS uiSts = CAM_API_STS_SUCCESS;// Gets AntiGlitch node.
uiSts = GenApi_GetFloatValue(hCam, "AntiGlitch", &dValAntiGlitch);// Writes new value to AntiGlitch node.
dValAntiGlitch = 0.000000090;
uiSts = GenApi_SetFloatValue(hCam, "AntiGlitch", dValAntiGlitch);

Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All rights reserved.

#5400-0438

www.toshiba-teli.co.jp

FAQ How to edit AntiGlitch and AntiChattering parameters.
Code for reading and writing AntiGlitch node value is same as code for reading and writing
AntiChattering node value except node name.
The following is example code for reading current AntiGlitch node value and writing new value to thenode. Codes for handling errors are not contained in this example.
#include "TeliCamAPI.h"..............
CAM_HANDLE hCam = NULL;..............
double dValAntiGlitch = 0.0;
CAM_NODE_HANDLE hNode = NULL;// Gets AntiGlitch node.
CAM_API_STATUS uiSts = Nd_GetNode(hCam, "AntiGlitch", &hNode);// Gets AntiGlitch node value.
uiSts = Nd_GetFloatValue(hCam, hNode, &dValAntiGlitch);// Writes new value to AntiGlitch node.
dValAntiGlitch = 0.000000090;
uiSts = Nd_SetFloatValue(hCam, hNode, dValAntiGlitch);

3.3. Using register direct access functions
The following table shows registers for editing AntiGlitch and AntiChattering parameters.
Use Cam_ReadReg() and Cam_WriteReg() for accessing these registers.
FeatureAntiGlitch
AntiGlitch Max.
AntiGlitch Min.
AntiChattering
AntiChattering Max.
AntiChattering Min.

Address
0x0021F3DC
0x0021F3D80x0021F3D40x0021F3FC0x0021F3F80x0021F3F4

Type
int (32bit)
int (32bit)
int (32bit)
int (32bit)
int (32bit)
int (32bit)

Unit
1 / 100,000,000 sec
1 / 100,000,000 sec
1 / 100,000,000 sec
1 / 100,000,000 sec
1 / 100,000,000 sec
1 / 100,000,000 sec

Remarks
Integration time.
Read-Only.
Read-Only.
Insensitive time.
Read-Only.
Read-Only.

Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All rights reserved.

#5400-0438

www.toshiba-teli.co.jp

FAQ How to edit AntiGlitch and AntiChattering parameters.
Document in Japanese

1. AntiGlitch 機能と AntiChattering 機能
AntiGlitch 機能と AntiChattering 機能は、外部トリガを使用した撮像しているときに、意図しないタイミングに撮像されないようデジタル入力信号から不要なノイズなどを除去する機能です。
AntiGlitch 回路はデジタル化した入力信号を積算することによりパルス状のノイズを除去します。
AntiChattering 回路はエッジを受け付けない期間を設け、デジタル入力信号電圧が不定領域のときに発生するチャタリングによる誤動作を防ぎます。
AntiChattering 回路はデジタル入力信号に含まれるメカニカルスイッチのチャタリングの除去にも有効に機能します。
ノイズ
外部デバイス

なまり原信号

デジタル入力ピン

デジタル入力信号

バッファ

AntiGlitch
回路

内部二値化信号

内部論理回路回路

AntiGlitch

回路出力

AntiChatterin

カメラ

回路出力

原信号

デジタル入力信号(ノイズ、なまり有り)

内部二値化信号

内部二値化信号の積算

AntiGlitch 回路出力

AntiChattering 回路出力

Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All rights reserved.

#5400-0438

www.toshiba-teli.co.jp

FAQ How to edit AntiGlitch and AntiChattering parameters.

2. AntiGlitch と AntiChattering のパラメータの選定
AntiGlitch と AntiChattering は共にパラメータの値を大きくするとノイズ除去効果が高まります。
トリガ信号にのるノイズの規模と頻度はカメラが使用されている環境によってさまざまに変わる
ため、AntiGlitch と AntiChattering のパラメータには標準的な値はありません。
カメラのトリガ信号入力コネクタにできる限り近い位置でトリガ信号にのるノイズをオシロスコープ等で測定し、ノイズののり方に応じてパラメータを選定するのが望ましい方法です。
トリガ信号にのるノイズが測定できない場合は試行錯誤で適切な設定値を探してください。

3. AntiGlitch と AntiChattering のパラメータの編集
パッケージバージョン 2.3.0.1 の TeliCamSDK から AntiGlitch と AntiChattering のパラメータ編集用のカメラ制御関数が追加されました。GenICam 関数又はレジスタ直接アクセス関数を使用するでも AntiGlitch と AntiChattering のパラメータを編集することができます。

3.1. カメラ制御関数を使用する場合
パッケージバージョン 2.3.0.1 の TeliCamSDK から以下の関数が使用できます。
この表に記載した TeliCamDNetAPI のメソッドは CameraControl クラスのメソッドです。
TeliCamAPI
TeliCamDNetAPI
処理内容
GetCamAntiGlitchMinMax
GetAntiGlitchMinMax
AntiGlitich 設定範囲取得
GetCamAntiGlitch
GetAntiGlitch
AntiGlitich 設定値取得
SetCamAntiGlitch
SetAntiGlitch
AntiGlitich 値設定
GetCamAntiChatteringMinMax GetAntiChatteringMinMax AntiChattering 設定範囲取得
GetCamAntiChattering
GetAntiChattering
AntiChattering 設定値取得
SetCamAntiChattering
SetAntiChattering
AntiChattering 値設定

3.2. GenICam 関数を使用する場合
以下のテーブルに AntiGlitch と AntiChattering のパラメータ編集に使用するノードを示します。
機能
ノード名
ノード型
値の単位
備考
AntiGlitch“AntiGlitch”
IFloat秒
積分時間
AntiChattering“AntiChattering”
IFloat秒
エッジ非受付期間
以下のコードは PkgVer3.0.0.1 以降の TeliCamSDK で AntiGlitch ノードの現在の値を読み取り、新しい値に書き換えるコード例です。このコード例ではエラー処理のコードは省略しています。
#include "TeliCamAPI.h"..............
CAM_HANDLE hCam = NULL;..............
double dValAntiGlitch = 0.0;
CAM_API_STATUS uiSts = CAM_API_STS_SUCCESS;// AntiGlitch ノード値の取得
uiSts = GenApi_GetFloatValue(hCam, "AntiGlitch", &dValAntiGlitch);// AntiGlitch ノード値の書き換え
dValAntiGlitch = 0.000000090;
uiSts = GenApi_SetFloatValue(hCam, "AntiGlitch", dValAntiGlitch);
AntiGlitch ノードを読み書きするコードは AntiChattering ノードを読み書きするコードとほぼ同じで、使用するノード名のみが異なります。

Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All rights reserved.

#5400-0438

www.toshiba-teli.co.jp

FAQ How to edit AntiGlitch and AntiChattering parameters.
以下のコード例は PkgVer2.3.0.1 以前の TeliCamSDK 用のコードです。PkgVer3.0.0.1 以降でも使用できます。
#include "TeliCamAPI.h"..............
CAM_HANDLE hCam = NULL;..............
double dValAntiGlitch = 0.0;
CAM_NODE_HANDLE hNode = NULL;// AntiGlitch ノードの取得
CAM_API_STATUS uiSts = Nd_GetNode(hCam, "AntiGlitch", &hNode);// AntiGlitch ノード値の取得
uiSts = Nd_GetFloatValue(hCam, hNode, &dValAntiGlitch);// AntiGlitch ノード値の書き換え
dValAntiGlitch = 0.000000090;
uiSts = Nd_SetFloatValue(hCam, hNode, dValAntiGlitch);

3.3. レジスタ直接アクセス関数を使用する場合
以下のテーブルに AntiGlitch と AntiChattering のパラメータ編集に使用するレジスタを示します。
レジスタアクセスには ReadReg()関数と Cam_WriteReg()関数を使用してください。
機能アドレス型
値の単位
備考
AntiGlitch
0x0021F3DC
int (32bit) 1 / 100,000,000 sec 積分時間
AntiGlitch 最大値
0x0021F3D8
int (32bit) 1 / 100,000,000 sec Read-Only.
AntiGlitch 最小値
0x0021F3D4
int (32bit) 1 / 100,000,000 sec Read-Only.
AntiChattering
0x0021F3FC
int (32bit) 1 / 100,000,000 sec エッジ非受付期間
AntiChattering 最大値 0x0021F3F8int (32bit) 1 / 100,000,000 sec Read-Only.
AntiChattering 最小値 0x0021F3F4int (32bit) 1 / 100,000,000 sec Read-Only.
End of document in Japanese

Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All rights reserved.

#5400-0438

www.toshiba-teli.co.jp

FAQ How to edit AntiGlitch and AntiChattering parameters.

4. Others
4.1. Revision History
Date
2016/07/12
2018/11/14

Version
1.0.0
1.0.1

Description
Created the initial version
Added chapter2, section 3.1, and sample code for PkgVer3.0.0.1 or later.

4.2. Disclaimer
The disclaimer of this document including example code is described in “License Agreement
TeliCamSDK Eng.pdf” in TeliCamSDK installation folder.
Make sure to read this Agreement carefully before using it.
Refer to TeliCamSDK installation folder/Documents/License folder

Copyright © 2016-2018 TOSHIBA TELI CORPORATION, All rights reserved.

#5400-0438

www.toshiba-teli.co.jp