Visual DSP++
インストール＆チュートリアル
第3版

金子システム株式会社

1

ご注意
1.

本資料に記載されている内容は本資料発行時点のものであり、予告なく変更することがあります。
当社製品のご購入およびご使用にあたりましては、当社ホームページを通じて公開される情報を参照ください。

2.

当社から提供する情報の正確性と信頼性には万全を尽くしていますが、誤りがないことを保証するものではありません。当社はその使用に対する責任を一切負いません。その使用によって第三者の特許権、著作権その他知的財産が侵害された場合でも、同様に責任を負いません。

3.

本資料は、当社の書面による事前の明示同意がない限り、いかなる形式でも複製できません。

目次
1

はじめに ............................................................................................................................................3

2

必要なハードウェア ..........................................................................................................................3

3

必要なソフトウェアパッケージ ........................................................................................................4

4

3.1

Visual DSP++のインストール ...................................................................................................4

3.2

Visual DSP++ Update 10.1 のインストール .............................................................................53.3

ライセンスの登録 ......................................................................................................................8Blackfin アプリケーションの作成 .................................................................................................. 11
4.1

Visual DSP++の起動 ...............................................................................................................124.2

プロジェクトの作成 .................................................................................................................13

4.3

セッションの作成とデバッグ...................................................................................................18

5

Test Drive License の登録 ..............................................................................................................236

補足 .................................................................................................................................................25

76.1

Silicon Revision について .......................................................................................................25

6.2

blackfin.h について .................................................................................................................25

更新履歴 ..........................................................................................................................................252

1 はじめに
本書は、Analog Devices 社 Visual DSP++を使ったアプリケーションの開発チュートリアルです。
インストール及び、簡単なサンプルプログラムの構築、デバッグまでを解説します。
Visual DSP++は、Windows 用の高機能統合開発環境(IDE)です。有償ソフトウェアですが、Test
Drive License という 90 日間の無償評価ライセンスがあります。

2 必要なハードウェア
ここでは、以下のハードウェアを使用します。
表 1 ハードウェア一覧
製品名

写真

金子システムACB-BF592
以下よりお求めいただけます。
http://kaneko-sys.co.jp/shop/

Analog Devices
ADZS-HPUSB-ICE

JTAG-ICE

Analog Devices
ADZS-USB-ICE

Analog Devices
ADZS-ICE-100B※JTAG-ICE は、3 種類のいずれかを使います。
※アナログデバイセズ社以外の JTAG-ICE は(たとえば gnICE+)、Visual DSP++で使用することはできません。
3

3 必要なソフトウェアパッケージ
必要なパッケージは、以下の通りです。あらかじめ下記のファイルをダウンロードしてください。
z

Visual DSP++ Release 5.0
商品解説ページ
http://www.analog.com/jp/evaluation/vdsp-pp-sbf/eb.html
ダウンロードページ
http://www.analog.com/jp/content/visualdsp_tools_upgrades/fca.html※Visual DSP++は有償ソフトウェアです。ご使用になるには、アナログデバイセズ株式会社より、ライセンスを購入していただくか、90 日間の評価ライセンスを登録してください。

zVisual DSP++ 5.0 Update 10.1 – September August 2012
http://www.analog.com/jp/content/visualdsp_tools_upgrades/fca.html※2013 年 2 月 4 日時点の最新版です。
※ADSP-BF592 を使用するには、Update 8 以降でなければなりません。

3.1

Visual DSP++のインストール
VisualDSP++5.0.exe をダブルクリックし、インストールしてください。

図 1 Visual DSP++インストーラアイコン

起動すると以下のダイアログが出るので、Setup ボタンをクリックします。

図 2 Visual DSP++インストールダイアログ 1

4

後は指示に従ってインストールしてください。

図 3 Visual DSP++インストールダイアログ 2

3.2

Visual DSP++ Update 10.1 のインストール

次は、Visual DSP++のアップデータを適応させます。
スタートメニューのプログラム → Analog Devices → VisualDSP++ 5.0 → Maintain thisinstallation を選択します。

図 4 Maintain this installation

5

Apply a downloaded Update を選択し、Next ボタンをクリックします。

図 5 Visual DSP++ Setup ダイアログ 1

あらかじめダウンロードした VisualDSP++_5.0_Update10.1.vdu を選択し、Next ボタンをクリックします。

図 6 Visual DSP++ Setup ダイアログ 26選択したファイルのチェックが行われ、問題がない場合は、以下が表示されます。
エラーが出る場合は、ファイル異常の可能性がありますので、再度ダウンロードを試してください。

図 7 Visual DSP++ Setup ダイアログ 3

ライセンス条項とインストールパスを確認した後、Update ボタンを押してアップデートを開始します。

図 8 Visual DSP++ Setup ダイアログ 4

アップデート完了後、アップデートが正しく完了しているか確認を行います。
スタートメニューのプログラム → Analog Devices → VisualDSP++ 5.0 → Manage Licenses を選択します。

図 9 Manage Licenses

7Manage Licenses ダイアログの General タブをクリックし、Visual DSP++ 5.0 Update 10.1 と表示されていれば完了です。

図 10 Manage Licenses ダイアログ

3.3

ライセンスの登録初回のみ、Visual DSP++にライセンスの登録を行う必要があります。

スタートメニューのプログラム → Analog Devices → VisualDSP++ 5.0 → Manage Licenses を選択します。

図 11 Manage Licenses

8

Licenses タブの New ボタンをクリックします。

図 12 Manage Licenses ダイアログ

ここで、Visual DSP++購入時に付属しているシリアル番号又は、アナログデバイセズ社から発行されたTest Drive licenseのシリアル番号を入力します。Test Drive licenseの取得方法は、「5 TestDrive Licenseの登録」を参照してください。

図 13 シリアル番号入力※Node-Locked license と Client license(Floating license)の違いは、以下の通りです。詳細はアナログデバイセズ社にお問い合わせください。
Node-Locked

ライセンス登録した PC のみ使用可能。

licenseClient license

複数の PC で、同じライセンスを使いまわすことができます（ただし、同(Floating時使用は不可）。あらかじめ別の PC にライセンスを登録しておき、ライセlicense)ンスサーバとして機能させる必要があります。
9

サーバ向けライセンス用管理ソフトウェアは、Visual DSP++の CD に同梱されていますが、最新版は Visual DSP++アップデータのページからダウンロードできます。
http://www.analog.com/jp/content/visualdsp_tools_upgrades/fca.html

入力に問題がなければ、以下のように表示されます。Test Drive license はここで終了ですが、Node-Locked license の場合はさらに Validate が必要です。
Validate を行うシリアル番号を選択し、Validate ボタンをクリックすると、必要な案内が表示されるため、その指示に従ってください。

図 14 ライセンス一覧10

4 Blackfin アプリケーションの作成
ここでは、Blackfin アプリケーションの作成からデバッグまでの手順を解説します。
全体的な流れは以下の通りです。
Visual DSP++の起動

プロジェクトの作成

プログラムの入力

ビルド

セッションの選択又は作成

デバッグ

図 15 VisualDSP++ での開発の流れ

11

4.1

Visual DSP++の起動
スタートメニューのプログラム → Analog Devices → VisualDSP++ 5.0 → VisualDSP++

Environment を選択します。

図 16 VisualDSP++ Enviroment

図 17 VisualDSP++ IDE 画面

12

4.2

プロジェクトの作成
メニュー File → New → Project を選択します。

図 18 プロジェクトの作成

Standard application を選択し、Name にプロジェクト名、Directory に作業フォルダを選択し、Next ボタンをクリックします。ここでは、例として blink_led という名前のプロジェクトを作成します。

図 19

Project Wizard ダイアログ（プロジェクト名指定）

13

対象となるプロセッサを選択します。ここでは、ADSP-BF592-A を指定し、Next ボタンをクリックします。

図 20

Project Wizard ダイアログ（プロセッサ選択）

Application Settings では、そのまま Next ボタンをクリックします。

図 21

Project Wizard ダイアログ（アプリケーション設定）

14

Add Startup Code/LDF では、そのまま Next ボタンをクリックします。

図 22

Project Wizard ダイアログ（Startup Code/LDF 設定）

Finish では、内容を確認し、Finish ボタンをクリックして完了します。

図 23

Project Wizard ダイアログ（Finish）

15プロジェクトが追加され、blink_led.c が追加されます。

図 24 Visual DSP++ IDE 画面（プロジェクト追加）

これで、プログラムの入力準備が整いました。実際にプログラムを入力してみます。ここでは、ACB-BF592 の 37 番ピンに接続された LED を点滅させるプログラム例です。

図 25 プログラム入力例
16

/* Blackfin固有定義ファイルのインクルード */#include <blackfin.h>void main(void){
int lc;/* PG15を出力ピンに設定します */*pPORTGIO_DIR = PG15;

while(1){/* PG15を'H'出力に設定します */*pPORTGIO_SET = PG15;/* 一定時間待機 */for(lc = 0; lc < 10000000; lc++);/* PG15を'L'出力に設定します */*pPORTGIO_CLEAR = PG15;/* 一定時間待機 */for(lc = 0; lc < 10000000; lc++);}}プロジェクトをビルドするには、F7 を押すか、メニュー Project → Build Project を選択します。

図 26 ビルド

下部の Build タブのリストに、エラーが表示されなければビルド完了です。

17

4.3

セッションの作成とデバッグ
ビルドが完了すると、No Session Selected のダイアログが表示され、セッションの選択を求められます。セッションとは、Blackfin プロセッサと Visual DSP++を接続することです。ここでは、セッションの作成方法を解説します。

図 27

No Session Selected ダイアログ

ACB-BF592 と ADZS-HSUSB-ICE の接続し、電源を入れます。

図 28 ADZS-HSUSB-ICE 接続例

No Session Selected ダイアログの Select a session or create a new session を選択し、OK を押します。No Session Selected ダイアログが表示されていない場合は、メニューの Session →Session List をクリックします。

図 29

Session メニュー18

New Session ボタンをクリックします。

図 30

Session List ダイアログ

Select Processor では、ADSP-BF592-A を選択し、Next ボタンをクリックします。

図 31 プロセッサ選択

19

Emulator を選択し、Next ボタンをクリックします。

図 32 接続タイプ選択

どの JTAG-ICE で接続するか選択できますので、お使いの JTAG-ICE を選んで Next ボタンをクリックします。

図 33

ICE 選択20

Finish ボタンを押して完了です。

図 34

FinishSession List に、作成した内容が追加されますので、Activate ボタンをクリックし、セッションを開始します。なお、セッションの登録は一度登録すれば保存されます。

図 35

Session List ダイアログ

21

ACB-BF592 との接続に問題がなければ、画面右に逆アセンブラのリストが表示され、デバッグを開始します。デバッグを再開するには、再度 F7 キーを押して、ビルドを行ってください。

図 36 トレース画面

22

5 Test Drive License の登録
テストドライブライセンスとは、Visual DSP++の評価目的として、無償で 90 日間使用できる期間限定ライセンスの事です。アナログデバイセズのサイトから登録でき、Visual DSP++の全機能を使うことができます。
http://www.analog.com/jp/content/visualdsp_software_test_drive/fca.html
Register for a free 90-Day Test Drive をクリックします。

必要事項を入力して、ページ下部の SUBMIT ボタンを押します。

23

登録に問題がなければ、指定したメールアドレスにシリアル番号が送られてきます。

24

6 補足
6.1

Silicon Revision について
シリコンリビジョンとは、Blackfin チップのバージョンの事です。0.0 から始まり、新しいほど数字が大きくなります。新しい ADSP-BF592 では特に目立った問題はありませんが、ADSP-BF53xや ADSP-BF51x などの古いリビジョンでは、DMA の優先順位がコア優先から変更できない、内蔵SRAM のメモリ配置にミスがあるなどの問題があります。具体的な内容は、Analog Devices 社のサイトに IC アノーマリとして公開されており、一度確認されることをお勧めします。
http://www.analog.com/jp/processors-dsp/Blackfin/processors/ic-anomalies/resources/index.html
最近は Blackfin プロセッサのバグもかなり修正されており、どの Blackfin プロセッサでも問題ないのですが、特に理由がなければ、新しいリビジョンのチップを使用してください。
なお、コンパイラに Silicon Revision を指定するのは、これらのバグを回避する対策を指示するためで、any を指定すると全リビジョンに対応しますが、コード又は、データサイズが若干増加するケースがあります。

6.2

blackfin.h について
blackfin.h は、Visual DSP++に付属する Blackfin のレジスタやビット定義、アセンブリ命令などをまとめたヘッダファイル(※1)です。ADSP-BF592 に限らず、全プロセッサに対応します。
ハードウェア・リファレンスに記載されているレジスタ名の先頭に、”p”をつけてポインタとして定義しており、メモリアドレスを意識することなく簡単にレジスタにアクセスできるようになっています。（例：PORTGIO_SET であれば、pPORTGIO_SET。）※1 正確には、プロセッサごとに定義されたヘッダファイルが存在し、それらを再インクルードしています。Visual DSP++は、コンパイル時にプロセッサの識別できるマクロを自動生成するため、blackfin.h をインクルードするだけでどのプロセッサにも対応できる仕組みになっています。

7 更新履歴
版

更新日

更新内容

第1版

2012/02/14

初版発行

第2版

2012/04/04

P18 サンプルコードのコメントを修正
P10 Floating License の説明を追記

第3版

2013/02/04

P5 Visual DSP++商品ページのリンクを更新
全体

Update 10.1 用に修正25