VisualAppletsの概要を掴んでいただくために、この章ではこのツールについて簡単にご紹介します。 VisualAppletsを使用して画像処理アプリケーションを作成するために必要なすべての手順が説明されています。 FPGAやその他のハードウェア固有の知識を必要とせず、どれほど迅速にアプリケーションを実現でき、いかに簡単であるかを学ぶことができます。
-
WindowsのメニューまたはデスクトップにあるVisualAppletsのプログラムアイコンをクリックしてVisualAppletsを起動します。 まず、プロジェクトが読み込まれていないメインウィンドウが開きます。
これで、すぐに最初のかたちの実装を開始できます。 最初のステップは、新しいプロジェクトの開始です。
-
→ ( Ctrl+N )をクリックするか、[ファイル]アイコンバーの新規アイコンを使用します。 プロジェクト名、ターゲットハードウェアプラットフォーム、およびターゲットランタイムを指定できる[新しいプロジェクト]ウィンドウが開きます。 開発の現段階でこれらの設定がわからない場合は、プロジェクトに名前を付けてデフォルト設定を使用してください。 これらの設定は後からいつでも変更できます。
-
ここでは例に従って、次の設定を使用してください。
-
プロジェクト名： "helloWorld"
-
ハードウェアプラットフォーム： imaFlex CXP-12 Quadフレームグラバー
-
ターゲットランタイム： Microsoft Windows 64-bitシステム
-
-
をクリックして設定を確定します。
VisualAppletsによって新しいプロジェクトが開始されます。 プログラムウィンドウの中央に空のデザインウィンドウが表示されます。 （ハードウェアプラットフォームとしてmicroEnable 5を選択した場合は、必須の2つの制御オペレーターであるApplet Propertiesと Board Statusが空のデザインに自動的に挿入されます。） 右側のProject Infoタブには、プロジェクト名、ターゲットハードウェア、ターゲットプラットフォームなど、現在のプロジェクトに関する情報が表示されます。
VisualAppletsでは、画像処理演算はオペレーターによって表現されます。 これらのオペレーターはすべて、VisualAppletsデザインウィンドウの右側にあるオペレーターライブラリにあります。 ドラッグアンドドロップを使用すると、オペレーターをデザインウィンドウに非常に簡単に配置できます。デザイン内のオペレーターのインスタンスは、モジュールと呼ばれます。 オペレーターには入力ポートと出力ポートを含めることができます。 デザイン内のオペレーター（つまりモジュール）は、これらのポートを使用して接続できます。 モジュール間の接続はリンクと呼ばれ、デザインウィンドウ内では矢印で表現されます。 これらのモジュールとリンクは画像（または信号）処理パイプラインを表現しており、したがって処理の順序はモジュールの順序によって決まります。
最初のかたちでは、次の3つのオペレーターが必要になります。
-
mE5-MA-VCLライブラリのオペレーターCameraGrayAreaBase
-
MemoryライブラリのオペレーターImageBuffer
-
mE5-MA-VCLライブラリのオペレーターDmaToPC
デザインでこれらのオペレーターを使用するには：
-
ライブラリからオペレーターを見つけ、以下のようにデザインウィンドウにドラッグします。
次のステップは、リンクを介してデザイン内のモジュールを接続することです。
ポートをクリックすると新しいリンクが開始され、ターゲットポートをもう一度クリックすると完了します。
-
カメラモジュールとバッファーモジュールを接続するには、カメラモジュールの出力ポートをクリックし、次にバッファーモジュールの入力ポートをクリックします。
-
同様の方法で、バッファモジュールをDMAモジュールに接続します。
デザインを保存します。デザインを初めて保存する場合、[保存] ダイアログにデザインファイルの名前としてプロジェクト名が表示されます。
![[注]](../common/images/admon/note.png) |
ファイル名とプロジェクト名 |
|---|---|
|
デザインを初めて保存する場合、または [名前を付けて保存...] オプションを使用する場合、 [保存]/[名前を付けて保存...] ダイアログにデザインファイルの名前としてプロジェクト名が表示されます。 |
これで最初のデザインが完成しました。 次のステップでは、個々のモジュールとリンクの設定を指定する必要があります （そうしないと、デザインにはプリセットのデフォルトPropertyが使用されます）。
-
モジュールをパラメータ化するには、モジュールをダブルクリックします。 モジュールのすべてのPropertyが一覧表示されるダイアログウィンドウが開きます。
-
デザインに必要なPropertyを設定します。現在作成しているこの最初のサンプルアプレットでは、単に モジュールの名前を「Camera」、「Buffer」、「DMA」に変更します。
-
をクリックします。
-
をクリックしてPropertyウィンドウを閉じます。
-
デザインを保存します。
|
Operator Parameters |
|---|---|
|
パラメータは常にオペレーター固有であるため、設定オプションはオペレーターによって異なります。 |
次のステップは、デザインのリンクのPropertyを編集することです。 現在作成しているサンプルアプレットでは、リンクのPropertyを変更する必要はありません。 デフォルト設定をそのまま使用できます。
ただし、デザインのリンクをパラメータ化する必要がある場合は、次のように進めます。
-
パラメータ化するリンクをダブルクリックします。
-
希望する設定を入力します。
-
をクリックします。
-
をクリックしてPropertyウィンドウを閉じます。
これで、単純な画像取り込みである最初のアプリケーションの実装が完了しました。 VisualAppletsのDesign Rules Check (DRC) 機能を使用して、デザインにエラーがないか確認します。
-
→ ( Ctrl+F7 ) をクリックするか、 ビルドアイコンバーのアイコン Design Rules Check Level 1 を使用します。
-
右側の Project Info ウィンドウで、DRC Log タブに切り替えます。
次の図に示すように、ここでDRC解析結果が表示されます。
![[重要]](../common/images/admon/important.png) |
重要 |
|---|---|
|
DRCでエラーが検出された場合は、次のステップに進む前に修正する必要があります。 検出されたエラーはリンク形式で一覧表示されます。 一覧表示されたエラーのいずれかをクリックすると、デザインウィンドウで対応するモジュールまたはリンクがハイライト表示されます。 |
DRCが正常に完了したら、デザインを保存します。
-
→ ( Ctrl+S ) をクリックするか、FileアイコンバーのSaveアイコンを使用します。
以下の場合、ビルド設定を編集する必要があります。
-
microEnable 5 marathonプラットフォーム用のデザインを作成する場合。
-
Xilinx Vivadoを使用する場合。
-
バージョン9.2より新しいXilinx ISEを使用する場合。
特定の環境に合わせてビルド設定を行うには、次の手順に従います。
-
メニューの → をクリックします。
Build Settingsダイアログが開きます。
-
Addボタンをクリックします。
-
これらのビルド設定のターゲットハードウェアプラットフォーム（フレームグラバー）を選択し、OKで確定します。
-
新しく作成するビルド設定に名前を付けます。
-
Active configurationオプションを有効にします（名前を入力したフィールドのすぐ後ろにあります）。
-
Precondition Checkを有効にしたままにします。
-
Xilinx Build Flowの下で、使用するXilinx Tool（Xilinx ISEまたはXilinx Vivado）を選択します。
-
Use system environment insteadオプションを無効にします。
-
ファイルシステムからXilinx設定バッチファイルを選択します。バッチファイルはXilinxのインストールフォルダにあります。
-
ISE: \Xilinx\<version_number>\ISE_DS\settings64.bat.
-
Vivado: \Xilinx\Vivado\<version_number>\settings64.bat.
microEnable 5プラットフォーム用のアプレットを開発する際には、64ビットWindowsオペレーティングシステムの使用をお勧めします。 使用しているオペレーティングシステムに一致するバッチファイル（例：64ビットWindows OS用のファイルである「settings64.bat」）を選択してください。
-
-
他の設定はすべてそのままにしておきます。
-
OKをクリックします。
ビルド設定オプションの詳細については、'Build Settings'セクションを参照してください。
最後のステップは、デザインからアプレットをビルドすることです。
|
ビルドの前提条件 |
|---|---|
|
ビルドプロセスは、XILINXツールのインストールが正しく行われている場合にのみ実行できます。 XILINXツールのインストールの詳細については、Installing the Xilinx Toolchainセクションを参照してください。 microEnable 5 marathonフレームグラバー用のデザインを作成する場合、 またはバージョン9.2より新しいXilinx ISEバージョンを使用する場合は、 続行する前にビルド設定を定義する必要があります。'Configuring the Build Settings 'セクションを参照してください。 |
ビットストリーム（*.hapファイル）を作成するには：
-
→ （ F7 ）をクリックするか、Buildツールバーの「Build」アイコンを使用します。
Buildダイアログボックスが開きます。
-
Xilinx configurationの下で、使用するビルドコンフィギュレーションを選択します（Build Settingsダイアログボックスで定義したコンフィギュレーションの中から選択します）。
-
Startをクリックして、ビットストリームの生成を開始します。
VisualAppletsがXilinxツールを使用してアプリケーションをFPGAビットストリーム、つまり「プログラム」または「アプレット」に変換します。
|
ビルド時間が長くなる場合があります |
|---|---|
|
配置配線（Place and Route）プロセスの所要時間は、デザインの複雑さによって異なります。 非常に複雑なデザインの場合、ビルドに数時間かかることがあります。 |
ビルドが正常に完了すると、アプレットが完全に生成されます。
アプレットファイル（*.hapファイル）の名前は、デザインファイル（*.va）の名前と同じになります。 プロジェクト名はアプレットファイル（*.hap file）の名前には影響しません。
これでVisualAppletsでの作業が完了し、実際のFPGAハードウェアでアプレットを使用できるようになります。
VisualAppletsのデザインをハードウェアで実行する方法については、「Running Your Applet on Hardware」セクションを参照してください。
|
前提条件： |
|---|---|
|
アプレットを実行する方法は、使用しているフレームグラバーの世代によって異なります。
microEnable 5 marathon: microEnable 5 marathonフレームグラバーを使用する場合、 アプレットを選択して起動する前に、ファームウェアフラッシャーツールを使用して*.hapファイル（アプレット）をフレームグラバーにロードする必要があります（「Flashing the Applet on the Frame Grabber (Only mE5)」を参照）。
imaFlex: imaFlexプラットフォームの場合、ローカルファイルシステムからアプレット（*.hapファイル）を直接選択して、フレームグラバー上で起動できます。
次のことが可能です：
-
ツールであるmicroDiagnostics（Framegrabber SDKに含まれています）を使用して、アプレットの画像処理結果を直接確認およびテストする（https://docs.baslerweb.com/frame-grabbers/managing-applets-micro-diagnosticsを参照）。
-
アプリケーションプログラミングインターフェイス（API）を介してアプレットを起動する（「Accessing the Applet via SDK」を参照）。
microEnable 5 marathonフレームグラバーを使用している場合は、新しいアプレットをフレームグラバーに書き込む（フラッシュする）必要があります。
imaFlexフレームグラバーで新しいアプレットを使用する場合は、このセクションをスキップしてください。
To flash your frame grabber:
-
microDiagnosticsツールを起動します。
-
使用するフレームグラバーを選択します。
-
Flash Selected Board(s) ボタンをクリックします。新しいウィンドウが開きます。
-
VisualAppletsで作成した *.hap ファイルを保存しているディレクトリに移動し、ファイルを選択します。
-
Open をクリックし、Yes をクリックして確認します。
-
新しいファームウェアのインストールが完了するまで待ちます。 microDiagnosticsに対応するメッセージが表示されます。
-
メッセージに記載されている指示に従ってください。
特定のフレームグラバーのフラッシュ方法の詳細については、お使いのフレームグラバーのユーザーマニュアル（Flashing Applets onto marathon Frame Grabbers）を参照してください。
To test your applet and to set some first parameters, you can use the tool microDisplay:
-
VisualAppletsで作成した
*.hapファイルをFramegrabber SDKのインストールディレクトリに保存します：[Framegrabber SDK installation directory]/Hardware Applets. -
VisualAppletsから直接 → ( F5 ) をクリックするか、WindowsのスタートメニューからmicroDisplayツールを起動します。
-
I want to… ダイアログで、Load Applet を選択します。
-
Load Hardware Applet ダイアログの Board で、使用するフレームグラバーを選択します。 選択したボードで使用可能なすべてのアプレットがすぐに表示されます。
microEnable 5では、アプレットは1つのみ（ボードのフラッシュに使用したアプレット）使用可能です。
-
選択してください
*.hap使用するファイルです。 -
次のボタンをクリックします Load 選択したアプレット（
*.hapファイル）をフレームグラバーに読み込みます。 -
Load Hardware Applet ダイアログを閉じます。
-
microDisplayプログラムウィンドウのパラメータパネルを使用して、フレームグラバーを設定します。
複数台のカメラを使用する場合は、まず設定するポートを選択します。 使用するすべてのポートを設定してください。
画像高さや画像幅など、必要に応じてパラメータを設定します。 設定するには、値を直接右クリックして Edit を選択します。
使用する特定のマニュアル動作モード（トリガー設定など）を設定します。
-
Grab and display an infinite number of frames ボタンをクリックして、フレームグラバーでの画像取り込みを開始します。
取り込まれた画像がmicroDisplayに表示されます。
-
取り込みを停止するには、microDisplayの Stop ボタンをクリックします。
独自のソフトウェア (SDK) でアプレットの使用を開始するには:
-
Framegrabber APIで、次の呼び出しを使用します。
Fg_Init関数の呼び出しによるアプレットの開始。の場所へのパスを指定します。
*.hapファイルの場所へのパスを指定します。
|
カメラの起動 |
|---|---|
|
カメラインターフェースの種類によっては、カメラを制御するためにGenICamエクスプローラーツールも起動すると便利な場合があります。 詳細については、Framegrabber SDK documentationを参照してください。 |
最初のVisualAppletsデザインの実装に成功しました。 VisualAppletsについてより詳細なステップバイステップの導入をご希望の場合は、Basics and Examplesを読むことをお勧めします。
また、 From Empty Design to Running Appletのチュートリアルトピックをご覧いただくか、 Overviewのチュートリアルトピックから始めることもできます。
プログラムの機能の詳細については、Basic Functionalityにあるこのユーザーマニュアルの次の章を読み進めてください。 ここでは、VisualAppletsのすべての機能について詳しく説明しています。The User Interface of VisualAppletsの章では、VisualAppletsのユーザーインターフェースオプションについて習得できます。
ユーザーマニュアルに記載されているすべての情報は、VisualAppletsから直接アクセスすることもできます。 プログラム内のボタンをクリックすると、ユーザーマニュアルのそれぞれの説明に自動的にジャンプします。
ガイド付きツールの導入をご希望の場合は、BaslerがVisualAppletsのワークショップやコーチングを提供しています。 お気軽にBasler Salesまでお問い合わせください。
前へ
