2005-2009 CONTEC CO., LTD. All rights reserved.
1
MATLAB 対応データ収録用ライブラリ
ML-DAQ セットアップ＆リファレンスガイド
2005-2009 CONTEC CO., LTD. All rights reserved.
2
１．はじめに......................................................................................................................................................................... 3
２．ML-DAQのセットアップ............................................................................................................................................ 4
２－１．デバイスドライバのインストール............................................................................................................. 4
２－２．診断プログラムによるテスト..................................................................................................................... 4
２－３．ML-DAQのセットアップ............................................................................................................................... 5
３．ML-DAQリファレンス................................................................................................................................................6
３－１．第１０章 関数リファレンス......................................................................................................................... 6
３－２．第１１章 基本プロパティリファレンス.................................................................................................... 7
３－３．第１２章 デバイス固有のプロパティリファレンス............................................................................. 8
４．同期制御の方法 ........................................................................................................................................................ 9
４－１．AI開始トリガ（マスタ）とAO開始トリガ（スレーブ）の同期.............................................................. 9
４－２．AO開始トリガ（マスタ）とAI開始トリガ（スレーブ）の同期..............................................................9
４－３．AIクロック（マスタ）とAOクロック（スレーブ）の同期.......................................................................10
４－３．AOクロック（マスタ）とAIクロック（スレーブ）の同期.......................................................................10
５．ML-DAQバージョンアップ履歴...........................................................................................................................11
2005-2009 CONTEC CO., LTD. All rights reserved.
3
１．はじめに
ML-DAQ は、弊社のアナログ入出力ボードを The MathWorks 社の MATLAB で使用するためのライブ
ラリです。各機能は、MATLAB の Data Acquisition Toolbox で統一されたインターフェイスに合
わせて提供されます。本セットアップガイドは、ML-DAQ をご使用いただくまでの手順と、
Data Acquisition Toolbox User's Guide Version 2 日本語版(daqug.pdf)の補足説明が記述さ
れています。
2005-2009 CONTEC CO., LTD. All rights reserved.
4
２．ML-DAQのセットアップ
２－１．デバイスドライバのインストール
MATLAB で ML-DAQ を使用する前に、デバイスドライバのインストールを行い、ハードウェアを使
用可能な状態にしておく必要があります。なお、デバイスドライバのインストールは、管理者権
限でログインして行ってください。
1. http://www.contec.co.jp/apipac/
より、
Windows版 高機能アナログ入出力ドライバ API-AIO(WDM)をダウンロードします。
ダウンロードするファイルは実行環境(ランタイム)です。
2. ダウンロードしたファイルを、適当な場所で解凍します。
3. <解凍先フォルダ>\Inf\Wdm\Aio\Setup.exe を実行して、デバイスドライバをインストール
します。
4. OS をシャットダウンし、ハードウェアを PCI スロットまたはカードバススロットに実装し
ます。カードバスや PC カードの場合は、OS を起動したままデバイスをプラグインします。
5. パソコンの電源を ON にして、Windows を起動します。
6. Windows が起動すると、自動的にハードウェアウィザードが起動します。
7. Windows XP の場合、ウィザードの開始画面で[ソフトウェアを自動的にインストールする（推
奨）]を選択します。Windows Vista や Windows 2000 の場合、インストールは自動的に行わ
れます。
２－２．診断プログラムによるテスト
デバイスのインストールが正しく行われているかどうかを、診断プログラムにより確認できます。
1. スタートメニューから、[ファイル名を指定して実行]を選択し、CAIODIAG.EXE と入力し診
断プログラムを起動します。
2. 診断プログラム中で[診断レポート]をクリックすると、診断結果がレポートで表示されま
す。
3. 診断レポートで、API-AIO(WDM)のバージョンが最新かどうか、エラー等が発生していない
かを確認してください。
2005-2009 CONTEC CO., LTD. All rights reserved.
5
２－３．ML-DAQのセットアップ
1. ダウンロードした MWCONTEC.DLL を以下の場所へコピーします。
$MATLAB\toolbox\daq\daq\private\
($MATLAB は、MATLAB のインストールディレクトリになります)
2. MATLAB を起動します。
3. コマンドウィンドウから以下のコマンドを実行し、アダプタの登録を行います。
>> rehash toolboxcache
>> daqregister('contec')
'mwcontec.dll' successfully registered.と表示されていれば、セットアップ完了です。
4. コマンドウィンドウから以下のコマンドを実行し、デバイスが使用可能である事を確認し
ます。
>> daqhwinfo('contec')
・
・
BoardNames: {'ADA16-32/2(PCI)F'}
・
使用可能なデバイス一覧が、BoardNames に表示されます。
2005-2009 CONTEC CO., LTD. All rights reserved.
6
３．ML-DAQリファレンス
Data Acquisition Toolbox の使い方については、MATLAB 統合環境内の HELP もしくは、PDF 形式
のユーザーズガイドを参考にしてください。ここでは、Data Acquisition Toolbox User's Guide
Version 2 日本語版(daqug.pdf)についての補足説明を行います。
３－１．第１０章 関数リファレンス
P10-10.addchannel
備考 チャネル追加時の規則
・ hwch に与える数値はアクセスするハードウェアに依存します。
Contec のハードウェアに対してはチャネルは"ゼロベース"（0 で始まる）です。
・ 一部の Contec デバイスにおいて、追加されるチャネルは必ず昇順でなければなりませ
ん 。 (AIO-160802L-LPE, AI-1616L-LPE, AO-1604L-LPE, ADA16-8/2(LPCI)L,
ADAI16-8/2(LPCI)L, ADA16-8/2(CB)L, AD16-64(LPCI)LA, AD16-16(LPCI)L,
ADI16-16(LPCI)L, AIO-160802AY-USB, AI-1608AY-USB)
P10-15.addline
備考 ラインを追加するときの規則
・ Contec のハードウェアに対しては、ライン ID は" ゼロベース"（0 で始まる）です。
P10-18.analoginput
引数 'adaptor' Contec 製アダプタでは、'contec'を指定します。
ID Contec 製アダプタでは、'AIO000'等のデバイス名文字列を指定します。
P10-21.analogoutput
引数 'adaptor' Contec 製アダプタでは、'contec'を指定します。
ID Contec 製アダプタでは、'AIO000'等のデバイス名文字列を指定します。
P10-34.daqhwinfo
引数 'adaptor' Contec 製アダプタでは、'contec'を指定します。
P10-47.daqregister
引数 'adaptor' Contec 製アダプタでは、'contec'を指定します。
説明 daqregister('adaptor') は、adaptor によって指定されたハードウェアドライバ
アダプタを登録します。Contec 製のアダプタを指定する場合は、adaptor にフルパス
2005-2009 CONTEC CO., LTD. All rights reserved.
7
名を与えなければなりません。
daqregister('adaptor','unload’) は、adaptor によって指定されたハードウェアド
ライバアダプタを抹消します。Contec 製のアダプタを指定する場合は、adaptor にフ
ルパス名を与えなければなりません。
P10-55.digitalio
引数 'adaptor' Contec 製アダプタでは、'contec'を指定します。
ID Contec 製アダプタでは、'AIO000'等のデバイス名文字列を指定します。
３－２．第１１章 基本プロパティリファレンス
P11-23.ChannelSkewMode
値 Contec
{Minimum} チャネルスキューはサポートされている最小値。
Equisample チャネルスキューは[( サンプリングレート × チャネル数)]-1 で
与えられます。
Manual チャネルスキューは ChannelSkew で与えられます。
P11-24.ClockSource
値 Contec
{Internal} ハードウェア内部のクロックを使用。
External 外部サンプルクロック。
Software コンピュータクロックを使用。
P11-24.InputType
値 Contec
Differential チャネルは差動入力に設定される。
{SingleEnded} チャネルはシングルエンド入力に設定される。
2005-2009 CONTEC CO., LTD. All rights reserved.
8
P11-94.TriggerCondition
値 Contec
つぎのトリガ条件は、TriggerType が HwDigital の時に使用されます。
{PositiveEdge} ディジタル信号の正のエッジ( 立ち上がり) を検出したときに
トリガが発生。
NegativeEdge ディジタル信号の負のエッジ( 立ち下がり) を検出したときに
トリガが発生。
つぎのトリガ条件は、TriggerType が HwAnalog の時に使用されます。
{Both} アナログ信号が指定した値の範囲を通過するとき、
正または負の勾配を有している場合にトリガが発生。
Rising アナログ信号が指定した値の範囲を通過するとき、
正の勾配を有している場合にトリガが発生。
Falling アナログ信号が指定した値の範囲を通過するとき、
負の勾配を有している場合にトリガが発生。
Leaving アナログ信号が指定した値の範囲から外れるときにトリガが発生。
Entering アナログ信号が指定した値の範囲に入るときにトリガが発生。
P11-104.TriggerType
値 Contec
HwDigital トリガソースは外部ディジタル信号。プリトリガデータは確保されません。
HwAnalog トリガソースは外部アナログ信号（AI のみ)。
P11-101.TriggerRepeat
AI-1608AY-USB では、TriggerType が HwDigital または HwAnalog の時にトリガを複数回設定
することはできません。TriggerRepeat = 0 としてください。
３－３．第１２章 デバイス固有のプロパティリファレンス
P12-3.プロパティ - ベンダ別
Contec プロパティ
プロパティ名 説明
OutOfDataMode アナログ出力サブシステムによって定義された値の定義方法を指定。
（デバイスオブジェクト：AO）
2005-2009 CONTEC CO., LTD. All rights reserved.
9
４．同期制御の方法
CONTEC 製 F シリーズマルチファンクションデバイスをご使用の場合、アナログ入力とアナログ
出力の同期スタート、アナログ入力とアナログ出力の同期クロック機能を使用することができま
す。
サポートデバイス：AIO-163202F-PE、ADA16-32/2(PCI)F、ADA16-32/2(CB)F
４－１．AI開始トリガ（マスタ）とAO開始トリガ（スレーブ）の同期
AI の開始トリガ信号を、ハードウェア内部で AO の開始トリガに接続し、AI と AO を同時にスタ
ートさせる方法です。
<サンプルコード>
ai = analoginput('contec', 'AIO000') 'AI オブジェクトの生成
ao = analogoutput('contec', 'AIO000') 'AO オブジェクトの生成
addchannel(ai, 0) 'チャネルの追加
addchannel(ao, 0) 'チャネルの追加
data = sin(linspace(0.2*pi, 8000))'; '出力データの作成
putdata(ao, data) '出力データのセット
ao.TriggerType = 'HwSync' 'ハードウェア同期トリガを使用
ao.TriggerCondition = 'AiStart' 'AI の開始信号に同期
start(ao) '先に AO を開始
start(ai) 'AI の開始
４－２．AO開始トリガ（マスタ）とAI開始トリガ（スレーブ）の同期
AO の開始トリガ信号を、ハードウェア内部で AI の開始トリガに接続し、AO と AI を同時にスタ
ートさせる方法です。
<サンプルコード>
ai = analoginput('contec', 'AIO000') 'AI オブジェクトの生成
ao = analogoutput('contec', 'AIO000') 'AO オブジェクトの生成
addchannel(ai, 0) 'チャネルの追加
addchannel(ao, 0) 'チャネルの追加
data = sin(linspace(0.2*pi, 8000))'; '出力データの作成
putdata(ao, data) '出力データのセット
ai.TriggerType = 'HwSync' 'ハードウェア同期トリガを使用
ai.TriggerCondition = 'AoStart' 'AO の開始信号に同期
2005-2009 CONTEC CO., LTD. All rights reserved.
10
start(ai) '先に AI を開始
start(ao) 'AO の開始
４－３．AIクロック（マスタ）とAOクロック（スレーブ）の同期
AI のクロック信号を、ハードウェア内部で AO のクロック信号に接続し、AI と AO 変換タイミン
グを同期させる方法です。
<サンプルコード>
ai = analoginput('contec', 'AIO000') 'AI オブジェクトの生成
ao = analogoutput('contec', 'AIO000') 'AO オブジェクトの生成
addchannel(ai, 0) 'チャネルの追加
addchannel(ao, 0) 'チャネルの追加
data = sin(linspace(0.2*pi, 8000))'; '出力データの作成
putdata(ao, data) '出力データのセット
ao.ClockSource = 'HwSync' '同期クロック
ao.ClockCondition = 'AiClock' 'AI のクロックと同期
start(ao) '先に AO を開始
start(ai) 'AI の開始
４－３．AOクロック（マスタ）とAIクロック（スレーブ）の同期
AO のクロック信号を、ハードウェア内部で AI のクロック信号に接続し、AO と AI 変換タイミン
グを同期させる方法です。
<サンプルコード>
ai = analoginput('contec', 'AIO000') 'AI オブジェクトの生成
ao = analogoutput('contec', 'AIO000') 'AO オブジェクトの生成
addchannel(ai, 0) 'チャネルの追加
addchannel(ao, 0) 'チャネルの追加
data = sin(linspace(0.2*pi, 8000))'; '出力データの作成
putdata(ao, data) '出力データのセット
ai.ClockSource = 'HwSync' '同期クロック
ai.ClockCondition = 'AoClock' 'AO のクロックと同期
start(ai) '先に AI の開始
start(ao) 'AO を開始
2005-2009 CONTEC CO., LTD. All rights reserved.
11
５．ML-DAQバージョンアップ履歴
・Ver1.44 2009/10/09
AI-1204Z-PCI で、10MHz のサンプルレートが設定できない不具合を修正しました。
特定の PC（Intel Core 2 Quad CPU Q9650 3.00GHz）で動作しない問題を修正しました。
・Ver1.41 2009/07/03
trigger(ao)関数でエラーが発生することがある不具合を修正しました。
・Ver1.40 2008/11/14
アナログ入力とアナログ出力の同期スタート、
アナログ入力とアナログ出力の同期クロック機能に対応しました。（F シリーズ専用機能）
タイムアウトメッセージが発生する事がある不具合を修正しました。
・Ver1.30 2008/03/28
AI-1204Z-PCI に対応しました。
・Ver1.22c 2007/10/19 (mwcontec.dll の変更はありません)
AIO-121601E3-PE, AIO-121601UE3-PE, AIO-161601E3-PE, AIO-161601UE3-PE に対応しました。
Windows Vista に対応しました。
・Ver1.22 2007/4/9
外部トリガ＋リピート使用時に、取得データが異常値となる不具合を修正しました。
Simulink を使用して、アナログ入力とデジタル入力を同時に使用すると正常に動作しない不
具合を修正しました。
・Ver1.21 2006/11/13
USB ターミナル使用時、条件によりサンプリングクロックエラーが発生する不具合を
修正しました。
・Ver1.20b 2006/7/20 (mwcontec.dll の変更はありません)
AIO-160802L-LPE, AI-1616L-LPE, AO-1604L-LPE, AIO-160802AY-USB
に対応しました。
・Ver1.20a 2006/4/14 (mwcontec.dll の変更はありません)
AIO-163202F-PE, AIO-1608AY-USB, DA16-16(LPCI)L, DA16-8(LPCI)L
2005-2009 CONTEC CO., LTD. All rights reserved.
12
に対応しました。
・Ver1.20 2005/11/11
AD12-16(PCI)EV, AD12-16U(PCI)EV, AD16-16(PCI)EV, AD16-16U(PCI)EV, AD16-64(LPCI)LA
に対応しました。
・Ver1.10 2005/09/09
ADAI16-8/2(LPCI)L, ADI16-16(LPCI)L, DAI16-4(LPCI)L に対応しました。
・Ver1.00 2005/05/24
ADA16-32/2(PCI)F, ADA16-8/2(LPCI)L, AD16-16(LPCI)L, DA16-4(LPCI)L, AD16-32/2(PCI)F,
ADA16-8/2(LPCI)に対応しました。
-
1
-
2
-
3
-
4
-
5
-
6
-
7
-
8
-
9
-
10
-
11
-
12
