このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。

icdevice

デバイスオブジェクトを作成する

このページをすべて展開する

    説明

    icdevice を使用して MATLAB® デバイス オブジェクトを作成します。

    作成

    構文

    obj = icdevice(driver,hwobj)
    obj = icdevice(driver,rsrcname)
    obj = icdevice(driver)
    obj = icdevice(___,Name,Value)

    説明

    obj = icdevice(driver,hwobj) はデバイス オブジェクト obj を作成します。機器固有の情報は、MATLAB インターフェイス機器ドライバー driver で定義され、文字列として指定されます。機器との通信は、インターフェース オブジェクト hwobj を介して行われます。インターフェース オブジェクトは、シリアル ポート、GPIB、VISA、TCPIP、または UDP オブジェクトになります。driver が存在しないか、hwobj が無効な場合、デバイス オブジェクトは作成されません。

    デバイス オブジェクトは、VXIプラグ アンド プレイ および Interchangeable Virtual Instrument (IVI®) ドライバーでも使用できます。これらのドライバを使用するには、まず、基礎となる VXIプラグ アンド プレイ または IVI ドライバ用の MATLAB 計測器ドライバ ラッパーが必要です。MATLAB 計測器ドライバ ラッパーがまだ存在しない場合は、 makemid または midedit を使用して作成できます。MATLAB 計測器ドライバ ラッパーを作成するには、makemid または midedit を 1 回だけ使用する必要があることに注意してください。

    例

    obj = icdevice(driver,rsrcname) は、MATLAB 計測器ドライバ driver を使用して、デバイス オブジェクト obj を作成します。指定された driver は MATLAB VXIプラグ アンド プレイ 計測器ドライバまたは MATLAB IVI 計測器ドライバである必要があり、文字列として指定されます。機器との通信は、rsrcname によって文字列として指定されたリソースを通じて行われます。たとえば、すべての VXIプラグ アンド プレイ と多くの IVI ドライバでは、 rsrcname の VISA リソース名が必要です。

    例

    obj = icdevice(driver) は、MATLAB 計測器ドライバ driver を使用して、デバイス オブジェクト obj を構築します。指定された driver は MATLAB IVI 計測器ドライバである必要があり、基礎となる IVI ドライバは論理名を使用して参照される必要があります。

    obj = icdevice(___,Name,Value) は、前の構文の入力引数に加えて、1 つ以上の名前と値の引数を使用してデバイス オブジェクト obj を構築します。名前と値の引数は、set 関数でサポートされている任意の形式 (名前と値の文字ベクトルのペア、構造体、名前と値のセル配列のペア) にすることができます。大文字と小文字を区別せずにプロパティ名を指定したり、プロパティ名の補完機能を利用したりすることもできます。たとえば、次のコマンドはすべて有効かつ同等です。

    d = icdevice('tektronix_tds210',g,'ObjectVisibility','on');
d = icdevice('tektronix_tds210',g,'objectvisibility','on');
d = icdevice('tektronix_tds210',g,'ObjectVis','on');

    メモ

    IVI-C または VXIプラグ アンド プレイ ドライバーを使用してコードを展開する場合、コードを実行すると、MATLAB プロンプトで次のコードを実行して指定されたフォルダーに追加のファイルが生成されます。

    fullfile(tempdir,'ICTDeploymentFiles',sprintf('R%s',version('-release')))

    サポートされているすべてのプラットフォームで、MATLABPrototypeFor<driverName>.m という名前のファイルが生成されます。ここで、<driverName> は IVI-C または VXIプラグ アンド プレイ ドライバーの名前です。Windows® 上の 64 ビット MATLAB では、<driverName>_thunk_pcwin64.dll という名前の 2 番目のファイルが生成されます。デプロイされたアプリケーションまたは共有ライブラリを作成するときに、これらの生成されたファイルを手動で含めます。icdevice 関数を使用する場合は、デプロイされたアプリケーションまたは共有ライブラリに MDD ファイルも手動で含めることを忘れないでください。追加ファイルの追加に関する詳細については、MATLAB Compiler™ のドキュメントを参照してください。

    例

    すべて折りたたむ

    MATLAB インターフェイス オブジェクトと MATLAB インターフェイス インストルメント ドライバーを使用して、MCC GPIB ボードに接続された Tektronix® TDS 210 オシロスコープのデバイス オブジェクトを作成します。

    g = gpib('mcc',0,2);
d = icdevice('tektronix_tds210',g);

    機器に接続します。

    connect(d);

    構成可能なオシロスコープの設定を一覧表示します。

    props = set(d);

    オシロスコープの現在の構成を取得します。

    values = get(d);

    機器から取り外して清掃してください。

    disconnect(d);
delete([d g]);

    MATLAB VXIプラグ アンド プレイ 計測器ドライバーを使用して、Tektronix TDS 210 オシロスコープのデバイス オブジェクトを作成します。

    この例では、'tktds5k' VXIプラグ アンド プレイ ドライバーがシステムにインストールされていることを前提としています。

    この最初の手順は、tktds5k 用の MATLAB VXIプラグ アンド プレイ 計測器ドライバーがシステムに存在しない場合にのみ必要です。

    makemid('tktds5k','Tktds5kMATLABDriver');

    VXIプラグ アンド プレイ ドライバーを使用するデバイス オブジェクトを構築します。計測器は GPIB プライマリ アドレス 2 に配置されていると想定されます。

    d = icdevice('Tktds5kMATLABDriver','GPIB0::2::INSTR');

    機器に接続します。

    connect(d);

    構成可能なオシロスコープの設定を一覧表示します。

    props = set(d);

    オシロスコープの現在の構成を取得します。

    values = get(d);

    機器から取り外して清掃してください。

    disconnect(d);
delete(d);

    ヒント

    いつでも、instrhelp 関数を使用して、デバイス オブジェクトに関連付けられているプロパティと関数の完全なリストを表示できます。

    instrhelp icdevice

    デバイス オブジェクトを作成すると、次のプロパティ値が自動的に構成されます。

    • Interface は、機器との通信に使用するインターフェースを指定します。インターフェース オブジェクトを使用して作成されたデバイス オブジェクトの場合は、そのインターフェース オブジェクトになります。VXIプラグ アンド プレイおよび IVI-C の場合、これはドライバー セッションへのセッション ハンドルです。MATLAB 計測器ドライバの場合、これはドライバのデフォルトの COM インターフェイスへのハンドルです。

    • LogicalName は IVI 論理名です。IVI 以外のドライバーの場合は空です。

    • Name は、計測器タイプと計測器ドライバの名前を連結して生成されます。

    • RsrcName は、VXIプラグ アンド プレイ および IVI ドライバーの完全な VISA リソース名です。MATLAB インターフェース ドライバーの場合、RsrcName は空の文字ベクトルです。

    • Type は、計測器の種類です (わかっている場合) (たとえば、scope または multimeter)。

    計測器と通信するには、connect 関数を使用してデバイス オブジェクトを計測器に接続する必要があります。デバイス オブジェクトが構築されると、オブジェクトの Status プロパティは closed になります。デバイス オブジェクトが connect 関数を使用して計測器に接続されると、 Status プロパティが open に設定されます。

    メモ

    ICDEVICE は、Mac プラットフォーム上で名前またはパスに非 ASCII 文字が含まれる MDD を開くことができません。

    メモ

    関数で使用できるオプションのリストを取得するには、MATLAB コマンド ラインで関数を入力した後に Tab キーを押します。リストが展開され、スクロールしてプロパティまたは値を選択できます。この高度なタブ補完機能の使用方法については、Using Tab Completion for Functions を参照してください。

    バージョン履歴

    R2006a より前に導入

    参考

    |