NI488.2 API クイックリファレンスカード

クィックリファレンスカード
NI-488.2™ API
ステータスワードの状態（ibsta または Ibsta())*
ニーモニック
タイプ
dev、brd
説明
8000
14
4000
dev、brd
制限時間を超過
END
13
2000
12
1000
dev、brd
brd
END または EOS を検出
SRQI
RQS
CMPL
11
8
800
100
dev
デバイスがサービスを要求
⼊出⼒の完了
LOK
REM
CIC
ATN
7
6
5
4
80
40
20
10
dev、brd
brd
brd
brd
brd
TACS
LACS
DTAS
DCAS
3
2
1
0
8
4
2
1
brd
brd
brd
brd
トーカ
ERR
TIMO
ビット
15
16 進数
GPIB エラー
SRQ ラインがアサートされています
ロックアウト状態
リモート状態
コントローラインチャージ
ATN ラインがアサートされています
リスナ
デバイストリガ状態
デバイスクリア状態
エラーコード（iberr または Iberr())*
ニーモニック
EDVR
ECIC
ENOL
10 進値
意味
0
1
2
GPIB バス上にリスナがありません。
EADR
3
GPIB ボードが正しくアドレス指定されていません。
EARG
ESAC
4
5
関数呼び出しに無効な引数が渡されました。
EABO
6
I/O 処理の有効期限が終了しました（タイムアウト状態）。
ENEB
7
この GPIB ボードは存在しません。
EDMA
8
DMA エラーです。
EOIP
10
非同期 I/O の処理中です。
ECAP
EFSO
EBUS
ESRQ
11
12
14
16
この処理を⾏う機能がありません。
ETAB
20
GPIB 関数の引数で渡された配列 ( 表データ ) に問題があります。
ELCK
EARM
21
22
Ibnotify コールバックが再登録に失敗しました。
EHDL
EWIP
ERST
EPWR
23
26
27
28
システムエラーです。
この関数ではボードが CIC であることが必要です。
GPIB ボードがシステムコントローラではありません。
ファイルシステムエラーです。
GPIB バスエラーです。
SRQ ラインが ON で固定されています。
インタフェースがロックされています。
⼊⼒ハンドルが無効です。
指定された⼊⼒ハンドルは待機中です。
インタフェースのリセットが原因でイベント通知がキャンセルされました。
インタフェースへの電⼒が失われました。
* グローバル関数 Ibsta() および Iberr() を推奨します。詳細については、『NI-488.2 ヘルプ』で「ni4882 および
gpib32」を検索して参照してください。
製品情報の詳細については ni.com/jp を参照してください。
ボードレベルの従来型 NI-488.2
関数
目的
ibask
ibcac
ibcmd (ibcmda)
ソフトウェア構成パラメータについての情報を返します。
アクティブコントローラになります。
ibconfig
ibfind
ibgts
iblck
iblines
ソフトウェア構成パラメータを変更します。
ibln
ibloc
ibnotify
バス上にデバイスが存在するかどうかを調べます。
ibonl
ibppc
ibrd (ibrda)
ibrdf
ibrpp
ibsic
デバイスをオンラインまたはオフラインにします。
GPIB コマンドを（非同期に）送信します。
インタフェースまたはユーザ構成の計測器デスクリプタを開いて、初期化します。
アクティブコントローラからスタンバイに移⾏します。
実⾏中のプロセスの排他的インタフェースロックを取得または解放します。
8 つの GPIB コントロールラインのステータスを返します。
ボードをローカルモードにします。
ユーザのコールバックを呼び出して、1 つまたは複数の GPIB イベントをユーザに通知します。
パラレルポールを構成します。
（非同期で）計測器からデータを読み取り、ユーザバッファに格納します。
計測器からファイルにデータを読み取ります。
パラレルポーリングを⾏います。
IFC（Interface Clear: インタフェースのクリア）をアサートします。
ibstop
ibwait
非同期の⼊出⼒処理を中断します。
ibwrt (ibwrta)
ibwrtf
ユーザバッファのデータを（非同期で）計測器に書き込みます。
GPIB イベントを待機します。
ファイルから計測器にデータを書き込みます。
ボードのオプション（ibconfig）
定数
IbcAUTOPOLL
IbcDMA
IbcEndBitIsNormal
IbcEOS
IbcEOSchar
IbcEOScmp
IbcEOSrd
IbcEOSwrt
IbcEOT
IbcHSCableLength
IbcIRQ
IbcIST
16 進数値
07
12
1A
25
0F
0E
0C
0D
04
1F
09
20
定数
IbcLON
IbcPAD
IbcPP2
IbcPPC
IbcPPollTime
IbcRSV
IbcSAD
IbcSC
IbcSendLLO
IbcSRE
IbcTIMING
IbcTMO
16 進数値
22
01
10
05
19
21
02
0A
17
0B
11
03
デバイスレベルの従来型 NI-488.2
関数
ソフトウェア構成パラメータについての情報を返します。
iblck†
ibloc
ibnotify
ibonl
ibpct
ibppc
ibrd (ibrda)
ibrdf
ibrpp
ibrsp
ibstop
ibtrg
ibwait
実⾏中のプロセスの排他的デバイスロックを取得または解放します。
ibwrt (ibwrta)
ibwrtf
†
目的
ibask
ibclr
ibconfig
ibdev
特定の計測器をクリアします。
ソフトウェア構成パラメータを変更します。
計測器を開いて、初期化します。
ボードをローカルモードにします。
ユーザのコールバックを呼び出して、1 つまたは複数の GPIB イベントをユーザに通知します。
計測器をオンラインまたはオフラインにします。
コントローラ機能を持つ別の GPIB 計測器に制御を渡します。
パラレルポールを構成します。
（非同期で）計測器からデータを読み取り、ユーザバッファに格納します。
計測器からファイルにデータを読み取ります。
パラレルポーリングを⾏います。
シリアルポールを実⾏します。
非同期の⼊出⼒処理を中断します。
選択した計測器をトリガします。
GPIB イベントを待機します。
ユーザバッファのデータを（非同期で）計測器に書き込みます。
ファイルから計測器にデータを書き込みます。
GPIB-ENET/100 インタフェースは、デバイスレベル iblck をサポートしません。
デバイスのオプション（ibconfig）
定数
IbcEOS
IbcEOSchar
IbcEOScmp
IbcEOSrd
IbcEOSwrt
IbcEOT
16 進数値
25
0F
0E
0C
0D
04
定数
IbcPAD
IbcREADDR
IbcSAD
IbcSPollTime
IbcTMO
IbcUnAddr
16 進数値
01
06
02
18
03
1B
マルチラインインタフェースメッセージ
16 進数 10 進数 ASCII メッセージ
16 進数
00
01
02
03
04
05
06
07
08
09
0A
0B
0C
0D
0E
0F
10
11
12
13
14
15
16
17
18
19
1A
1B
1C
1D
1E
1F
20
21
22
23
24
25
26
27
28
29
2A
2B
2C
2D
2E
2F
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
NUL
SOH
STX
ETX
EOT
ENQ
ACK
BEL
BS
HT
LF
VT
FF
CR
SO
SI
DLE
DC1
DC2
DC3
DC4
NAK
SYN
ETB
CAN
EM
SUB
ESC
FS
GS
RS
US
SP
!
"
#
$
%
&
'
(
)
*
+
,
.
/
GTL
SDC
PPC
GET
TCT
LLO
DCL
PPU
SPE
SPD
CFE
MLA0
MLA1
MLA2
MLA3
MLA4
MLA5
MLA6
MLA7
MLA8
MLA9
MLA10
MLA11
MLA12
MLA13
MLA14
MLA15
30
31
32
33
34
35
36
37
38
39
3A
3B
3C
3D
3E
3F
40
41
42
43
44
45
46
47
48
49
4A
4B
4C
4D
4E
4F
50
51
52
53
54
55
56
57
58
59
5A
5B
5C
5D
5E
5F
10 進数
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
ASCII
0
1
2
3
4
5
6
7
8
9
:
;
<
=
>
?
@
A
B
C
D
E
F
G
H
I
J
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
Y
Z
[
\
]
^
_
メッセージ
MLA16
MLA17
MLA18
MLA19
MLA20
MLA21
MLA22
MLA23
MLA24
MLA25
MLA26
MLA27
MLA28
MLA29
MLA30
UNL
MTA0
MTA1
MTA2
MTA3
MTA4
MTA5
MTA6
MTA7
MTA8
MTA9
MTA10
MTA11
MTA12
MTA13
MTA14
MTA15
MTA16
MTA17
MTA18
MTA19
MTA20
MTA21
MTA22
MTA23
MTA24
MTA25
MTA26
MTA27
MTA28
MTA29
MTA30
UNT
マルチラインインタフェースメッセージ（続き）
16 進数 10 進数 ASCII メッセージ
16 進数 10 進数
ASCII
メッセージ
60
96
`
MSA0、PPE
70
112
p
61
97
a
MSA1、
PPE、CFG1
71
113
q
MSA17、
PPD
62
98
b
MSA2、
PPE、CFG2
72
114
r
MSA18、
PPD
63
99
c
MSA3、
PPE、CFG3
73
115
s
MSA19、
PPD
64
100
d
MSA4、
PPE、CFG4
74
116
t
MSA20、
PPD
65
101
e
75
117
u
MSA21、
PPD
66
102
f
MSA5、
PPE、CFG5
MSA6、
PPE、CFG6
76
118
v
MSA22、
PPD
67
103
g
77
119
w
MSA23、
PPD
68
104
h
MSA7、
PPE、CFG7
MSA8、
PPE、CFG8
78
120
x
MSA24、
PPD
69
105
i
79
121
y
MSA25、
PPD
6A
106
j
7A
122
z
MSA26、
PPD
6B
107
k
MSA11、
PPE、
CFG11
7B
123
{
MSA27、
PPD
6C
108
l
MSA12、
PPE、
CFG12
7C
124
|
MSA28、
PPD
6D
109
m
MSA13、
PPE、
CFG13
7D
125
}
MSA29、
PPD
6E
110
n
MSA14、
PPE、
CFG14
7E
126
~
MSA30、
PPD
6F
111
o
MSA15、
PPE、
CFG15
7F
127
DEL
MSA9、
PPE、CFG9
MSA10、
PPE、
CFG10
メッセージの定義
MSA16、
PPD
CFE‡
Configuration Enable（構成モードを選択）
PPD
Parallel Poll Disablel（パラレルポール無効）
CFG‡
Configure（構成）
PPE
Parallel Poll Enable（パラレルポール有効）
DCL
Device Clear（デバイスのクリア）
PPU
GET
Group Execute Trigger（グループトリガ実⾏）
SDC
GTL
Go To Local（ローカルモードへ移⾏）
SPD
LLO
Local Lockout（ローカルのロックアウト）
SPE
Serial Poll Enable（シリアルポール有効）
MLA
My Listen Address（リスンアドレス）
TCT
Take Control（制御権の取得）
MSA
MTA
PPC
My Secondary Address（セカンダリアドレス） UNL
UNT
My Talk Address（トークアドレス）
Parallel Poll Unconfigure（パラレルポール構成
解除）
Selected Device Clear（選択されたデバイスの
クリア）
Serial Poll Disable（シリアルポール無効）
Unlisten（リスン解除）
Untalk（トーク解除）
Parallel Poll Configure（パラレルポールの構成）
‡ このマルチラインインタフェースメッセージは、
IEEE 488.1-2003 仕様の一部で HS488 高速プロトコルをサポートします。
マルチデバイス用 NI-488.2
ルーチン
目的
AllSpoll
DevClear
DevClearList
EnableLocal
全計測器に対してシリアルポールを実⾏します。
EnableRemote
計測器のリモート GPIB プログラミングを有効にします。
FindLstn
GPIB 上でリスン中の計測器を検索します。
FindRQS
PassControl
PPoll
サービスを要求している計測器を判断します。
PPollConfig
PPollUnconfig
RcvRespMsg
ReadStatusByte
Receive
ReceiveSetup
パラレルポール用に計測器を構成します。
単一の計測器をクリアします。
複数の計測器をクリアします。
計測器のフロントパネルからの操作を有効にします（リモートプログラミングモードを解除しま
す）
。
コントローラ機能を持つ別の計測器に制御を渡します。
GPIB バス上でパラレルポーリングを実⾏します。
パラレルポール用に設定された計測器の構成を解除します。
すでにトーカとしてアドレス指定されている計測器からデータを読み取ります。
単一の計測器に対し、シリアルポールを実⾏します。
計測器からデータバイトを読み取ります。
RcvRespMsg の実⾏準備として、計測器をトーカ状態にして、インタフェースをリスナ状態にし
ます。
ResetSys
IEEE 488.2 準拠の計測器をリセットおよび初期化します。
Send
SendCmds
データバイトを計測器に送信します。
SendDataBytes
SendIFC
すでにリスナとしてアドレス指定されている計測器にデータを送信します。
SendList
複数の GPIB 計測器にデータバイトを送信します。
SendLLO
LLO（Local Lockout: ローカルロックアウト）メッセージを全計測器に送信します。
SendDataBytes の実⾏準備として、データを受信できるように計測器を設定します。
GPIB コマンドバイトを送信します。
IFC（Interface Clear: インタフェースのクリア）を送信して、GPIB バスをリセットします。
SendSetup
SetRWLS
TestSRQ
計測器をリモートおよびロックアウト状態にします。
TestSys
IEEE 488.2 準拠の計測器のセルフテストを実⾏します。
Trigger
TriggerList
WaitSRQ
計測器をトリガします。
GPIB SRQ（Service Request: サービス要求）ラインの現在の状態を判断します。
複数の計測器をトリガします。
計測器が GPIB SRQ（Service Request: サービス要求 ) ラインをアサートするまで待機します。
タイムアウト値 (ibconfig IbcTMO)
定数
TNONE
T10us
T30us
T100us
T300us
T1ms
T3ms
T10ms
T30ms
10 進値
0
1
2
3
4
5
6
7
8
最小タイム
アウト値
無効（タイムアウトなし）
10 μs
30 μs
100 μs
300 μs
1 ms
3 ms
10 ms
30 ms
定数
T100ms
T300ms
T1s
T3s
T10s
T30s
T100s
T300s
T1000s
10 進値
9
10
11
12
13
14
15
16
17
最小タイム
アウト値
100 ms
300 ms
1s
3s
10 s
30 s
100 s
300 s
1000 s
National Instruments の商標については、ni.com/trademarks に掲載されている「NI Trademarks and Logo Guidelines」をご覧ください。本書中に
記載されたその他の製品名及び企業名は、それぞれの企業の商標又は商号です。National Instruments の製品を保護する特許については、ソフトウェア
で参照できる特許情報（ヘルプ→特許）、メディアに含まれている patents.txt ファイル、又は ni.com/patents からアクセスできる National
Instruments Patent Notice（英語）のうち、該当するリソースから参照してください。エンドユーザ使用許諾契約（EULA）及び他社製品の法的注意事項
はご使用の NI 製品の Readme ファイルにあります。National Instruments の輸出関連法規遵守に対する方針について、また必要な HTS コード、ECCN
（Export Control Classification Number）、その他の輸出⼊に関する情報の取得方法については、「輸出関連法規の遵守に関する情報」（ni.com/legal/
ja/export-compliance）を参照してください。NI は、本書に記載の情報の正確性について、一切の明⽰又は黙⽰の保証を⾏わず、技術的な誤りについ
て一切の責任を負いません。⽶国政府のお客様へ : 本書に含まれているデータは、⺠間企業の費用により作成されており、⺠間機関用の連邦調達規則
52.227-14 と軍事機関用の国防省連邦調達規則補⾜ 252.227-7014 及び 252.227-7015 に基づく限定権利及び制約付データ権利の条項の適用を受けます。
© 2002–2015 National Instruments. All rights reserved.
370497D-0112
2014 年 10 月