Jungo WiDriver: インストール手順

1. x86 32 ビットまたは 64 ビット (x64: AMD64 または Intel EM64T) プロセッサ
2. C、.NET、VB または Delphi をサポートする開発環境
3. Windows XP の場合 SP2 必須
   

1. CD-ROM ドライブに WinDriver の CD を挿入します
   (WinDriver の CD ではなく、ダウンロード版でインストールする場合、ダウンロードしたファイル (WDxxxx.EXE) をダブルクリックして、ステップ 3 へ進んでください)

2. Windows x86 32 ビット OS の場合、WDxxxx.EXE (xxxx はバージョン番号) ファイルを、Windows x64 64 ビット OS の場合、WDxxxxX64.EXE (xxxx はバージョン番号) ファイルをダブルクリックし、Install WinDriver ボタンをクリックします

3. License Agreement を読み、同意する場合は、Yes をクリックします

4. WinDriver をインストールする場所を選択します

5. Setup Type 画面で、以下の何れか1つを選択します:
   • Typical - WinDriver のすべてのモジュールをインストールします (汎用的な WinDriver ツールキット + 特定のチップセットの API)

   • Compact - 汎用的な WinDriver ツールキットのみをインストールします

   • Custom - インストールする WinDriver のモジュールを選択します; インストールする API を選択します
   
   
6. インストーラが必要なファイルをすべてコピーし終わると、クイック スタート ガイドを表示するか選択します

7. コンピュータを再起動します

1. システムのプロパティ ダイアログを開きます:
   スタート | 設定| コントロール パネル | システム
2. 詳細 タブで、環境変数 ボタンをクリックします
3. システム環境変数 ボックスで、WD_BASEDIR 変数を選択し、編集 ... ボタンをクリックするか、変数をダブル クリックします
4. システム変数の編集 ダイアログで、変数値 を新しい WinDriver のディレクトリのフルパスに置き換えて、 OK をクリックし、環境変数 ダイアログで、OK ボタンをクリックし、 更に、システムのプロパティ ダイアログで、OK ボタンをクリックします

ERROR_FILE_NOT_FOUND エラーでインストールに失敗する場合、Windows のレジストリのHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion に RunOnce キーが存在することをご確認ください。Windows Plug-and-Play で INF ファイルを使用してドライバを正しくインストールする際にこのレジストリ キーが必要です。RunOnce キーがない場合、作成し、再度 INF ファイルのインストールをお試しください。

Jungo から取得したライセンスを WinDriver に登録するには、以下の手順に従ってください:

1. DriverWizard GUI を起動します (スタート | プログラム | WinDriver | DriverWizard)

2. ファイル メニューから Registration Options を選択し、Jungo から取得した license string を入力し、Activate License ボタンをクリックします

3. 評価期間中に開発したソース コードを有効にするには:
   • USB 版の場合: ユーザー マニュアルの WDU_Init 関数の説明を参照してください
   • PCI 版の場合: ユーザー マニュアルの WDC_DriverOpen 関数の説明を参照してください
     
     WDC_xxx (デフォルト) ではなく、低レベルな WD_xxx API を使用してる場合、 ユーザー マニュアルの WD_License 関数の説明を参照してください

注意: カーネル上の現在のライセンスをチェックするには、[WinDriver Wizard] を実行して、 [File] メニューから [Registration Options] を選択してください。 現在、カーネルに設定されている有効なライセンスが表示されます。
ライセンス コードには、スペースおよびピリオドなども含まれますのでライセンス登録の際には、電子メールで受け取ったこの文字列を「コピー＆貼り付け」し、手入力によるミスを防いでください。

制限事項: Windows Vista 以降で WinDriver の GUI アプリケーション Driver Wizard を使用する場合、一部、ボタンの文字の表示が崩れる場合があります。 その場合には、画面のテーマを Windows クラシックに設定してください。

1. テーマの設定画面を開きます:
   [スタート] - [設定] - [コントロール パネル] - [個人設定] - [テーマ]
2. [テーマ] コンボボックスから [Windows クラシック] を選択し、[OK] ボタンをクリックします。

• Windows CE (別名 Windows Embedded Compact) 4.x - 7.x (Windows Mobile を含む) が起動する x86 / MIPS / ARMターゲット プラットフォーム

• Windows 8 Developer Preview / 7 / Server 2008 / Vista / Server 2003 / XP ホスト開発プラットフォーム

• Windows CE 4.x - 5.x (Windows Mobile を含む) の場合: 対応するターゲット SDK と Microsoft eMbedded Visual C++ または Microsoft Visual Studio 2005 / 2008 またはターゲット プラットフォームに対応する BSP (Board Support Package) と Microsoft Platform Builder

  Windows CE 6.x の場合: 対応するターゲット SDK または Windows CE 6.0 plugin と Microsoft Visual Studio 2005 / 2008

  Windows CE 7.x の場合: Windows CE 7 plugin と Microsoft Visual Studio 2008

• Linux カーネル 2.6.x またはそれ以降と以下のプロセッサ アーキテクチャ:
  32 ビット x86 プロセッサ
  または、
  64 ビット x86 プロセッサ
  または、
  PowerPC 32 ビットまたは 64 ビット
  

• GCC コンパイラ
  
  注意: GCC コンパイラのバージョンは、起動してる Linux カーネルのビルドに使用したコンパイラと同じバージョンを使用してください。
  

• C をサポートする 32 ビットまたは 64 ビット開発環境
  
  
• 開発 PC: glibc2.3.x
  
  
• GUI WinDriver アプリケーション (DriverWizard、Debug Monitor) の起動用に libstdc++.so.5 が必要

Linux では、カーネル自体をコンパイルした同じヘッダ ファイルでカーネル モジュールをコンパイルする必要があります。 WinDriver は、カーネル モジュールをインストールするので、インストール時に Linux カーネルのヘッダ ファイルでコンパイルする必要があります。

このため、WinDriver for Linux をインストールする前に、マシンに Linux ソース コードとファイル versions.h がインストールされていることを確認してください:

Linux カーネル ソース コードのインストール

• Linux をインストールしていない場合、ご使用の Linux ディストリビューションのインストール手順に従って、カーネルのソース コードのインストールします

• すでにマシンに Linux をインストールしてある場合、Linux ソース コードがインストールされているか確認します。 /usr/src ディレクトリで 'linux' を検索します。 ソース コードがインストールされていない場合、ご使用の Linux ディストリビューションのインストール手順に従って、ソース コードをインストールするか、Linux を再インストーしてソース コードをインストールします

version.h のインストール

• 初めて Linux カーネル ソース コードをコンパイルする際に、ファイル version.h を作成します。 version.h. ファイルなしでカーネルをコンパイルするディストリビューションがあります。このファイルが存在するか、/usr/src/linux/include/linux/ 以下を確認します。ファイルが存在しない場合、以下の手順を実行します:
  1. スーパーユーザーになります:
     /$ su
  2. Linux のソース ディレクトリへ移動します:
     /$ cd /usr/src/linux
  3. 以下を入力します:
     /$ make xconfig
  4. Save and Exit を選択して、設定を保存します
  5. 以下を入力します:
     /$ make dep.

対象の開発マシンで Debian ディストリビューション (例: Ubuntu など) が起動、または Red Hat Package Manager (RPM) ユーティリティ (例: Fedora などの Red Hat ディストリビューション) を持つ場合、Debian または RPM 形式の WinDriver のインストール パッケージ (それぞれ別々のモジュール) を使用して、WinDriver を自動的にインストールできます。その他の Linux ディストリビューションの場合には、手動で WinDriver をインストールしてください。

以下の手順で Debian または RPM の WinDriver インストール パッケージの一つを使用して WinDriver をインストールします:

1. Linux マシンの CD ドライブに WinDriver CD を挿入します。または、インストール ファイルをダウンロードします。

2. WinDriver のインストール ファイルから対象の開発マシン用の関連するディストリビューション パッケージを展開します。
   • Debian 32-bit - windriver-11.0.0-1.i386.deb
   • Debian 64-bit - windriver-11.0.0-1.x86_64.deb
   • RPM 32-bit - windriver-11.0.0-2.i386.rpm
   • RPM 64-bit - windriver-11.0.0-2.x86_64.rpm
3. 選択したパッケージのインストール ソフトウェアを使用して、展開したパッケージをインストールします。
   • 多くのマシンでは、*.deb ファイル (Debian) と *.rpm ファイル (RPM) は既に関連するインストール ソフトウェアと関連付けられているので、パッケージ ファイルをダブルクリックして、インストール手順に従うだけです。
   • root 権限でコマンドラインからパッケージをインストールすることもできます ? 例:
     • 32-bit Debian パッケージをインストールする場合 ?
       $ sudo dpkg ?i windriver-11.0.0-1.i386.deb
     • 64-bit RPM パッケージをインストールする場合 ?
       $ sudo rpm ?i ?scripts windriver-11.0.0-2.x86_64.rpm
   パッケージ インストールは、/usr/local/WinDriver 製品ディレクトリを作成します。

1. Linux マシンの CD ドライブに WinDriver CD を挿入します。または、インストール ファイルをダウンロードします。

2. インストールするディレクトリに移動します (home ディレクトリの場合、以下のように入力します):
   /$ cd ~

   注意: インストール ディレクトリへのパスにはスペースを含めないでください。

3. ファイル WDxxxxLN.tgz を展開します (xxxx はバージョン番号):
   ~$ tar xvzf /<file location>/WDxxxxLN.tgz
   例:
   
   • CD の場合:
     ~$ tar xvzf /mnt/cdrom/LINUX/WDxxxxLN.tgz
     
   • ダウンロード ファイルの場合:
     ~$ tar xvzf /home/username/WDxxxxLN.tgz

4. WinDriver redist/ ディレクトリに移動します (tar で WinDriver/ ディレクトリが作成されます):
   ~$ cd WinDriver/redist

5. WinDriver のインストール:
   1. ~/WinDriver/redist$ ./configure --disable-usb-support
      注意: configure スクリプトで、起動中のカーネル ベースの makefile を作成します。 インストールした他のカーネル ソース ベースでも configure スクリプトにフラグ
      --with-kernel-source=<path>
      を付けて、configure スクリプトを 起動できます。 <path> はカーネル ソース ディレクトリへのフルパスです。デフォルトのカーネル ソース ディレクトリは /usr/src/linux です。
   2. ~/WinDriver/redist$ make
   3. スーパー ユーザーになります:
      ~/WinDriver/redist$ su
   4. ドライバをインストールします:
      ~/WinDriver/redist# make install

6. symbolic link を作成すると、簡単に DriverWizard GUI を起動できます
   ~/WinDriver$ ln -s ~/WinDriver/wizard/wdwizard/ usr/bin/wdwizard

7. ファイル wdwizard の read (読み取り) / execute (実行) 権限を変更します。一般ユーザーがこのプグラムにアクセスできます。

8. デバイスからハードウェアへアクセスするユーザーに応じて、デバイス ファイル /dev/windrvr6 へのユーザーおよびグループ id を変更し、read (読み取り) / write (書き込み) 権限を指定します。
   
   udev ファイル システムを持つ Linux 2.6.x カーネルを使用してる場合、/etc/udev/permissions.d/50-udev.permissions ファイルを編集して、権限を変更します。たとえば、以下の行を追加して、read (読み取り) / write (書き込み) 権限を提供します:
   windrvr6:root:root:0666
   
   または、以下のように chmod コマンドを使用します。
   chmod /dev/windrvr6 666

9. WD_BASEDIR 環境変数を定義し、WinDriver ディレクトリの場所を示すように設定します (インストール中に選択した WinDriver のディレクトリの場所を示します)。この変数を WinDriver のサンプルおよび DriverWizard で生成されたコードの make およびソース ファイルで使用し、DriverWizard で生成されたプロジェクトを保存するデフォルトのディレクトリにも使用します。この変数を定義しない場合、WinDriver の makefile を使用して、サンプルおよび DriverWizard で生成されたコードをビルドする際に、定義するように要求されます。
   注意: WinDriver のインストール後、 WinDriver のディレクトリの名前 / 場所を変更する場合、WD_BASEDIR 環境変数の値を変更し、新しい WinDriver のディレクトリの場所を指すように設定する必要があります。
   
   
10. WinDriver を使用して、ハードウェアにアクセスし、ドライバ コードを生成できます!

Jungo から取得したライセンスを WinDriver に登録するには、以下の手順に従ってください:

1. DriverWizard GUI を起動します:
   ~/WinDriver/wizard$ ./wdwizard
2. File メニューから Registration Options を選択し、Jungo から取得した license string を入力します
3. Activate License ボタンをクリックします
4. 評価期間中に開発したソース コードを有効にするには:
   • USB 版の場合: ユーザー マニュアルの WDU_Init 関数の説明を参照してください
   • PCI 版の場合: ユーザー マニュアルの WDC_DriverOpen 関数の説明を参照してください
     
     WDC_xxx (デフォルト) ではなく、低レベルな WD_xxx API を使用してる場合、 ユーザー マニュアルの WD_License 関数の説明を参照してください

Linux のハードウェア アクセスの制限事項

注意:
/dev/windrvr6 は、ユーザー プログラムに直接ハードウェア アクセスを指定するので、マルチ ユーザーの Linux システムでは、カーネルの安定性に問題が生じる場合があります。 DriverWizard およびデバイス ファイル /dev/windrvr6 へのアクセスを trusted ユーザーに制限してください。

セキュリティ上、WinDriver のインストール スクリプトは、自動的に /dev/windrvr6 および DriverWizard の実行ファイル (wdwizard) の権限を変更しません。

• CPU と OS:
  32 ビット Mac OS X 10.5.x またはそれ以降が起動する x86 または x86_64 プラットフォーム
  64 ビット Mac OS X 10.6.x またはそれ以降が起動する x86_64 プラットフォーム
  Mac OS X 10.5.x が起動する PowerPC (PPC) プラットフォーム
• Xcode:
  Mac OS X version 10.6 の場合 - Xcode version 3.2
  Mac OS X version 10.5 の場合 - Xcode version 3.1 または 3.2

注意:
Mac OS X のドライバのインストールは、必ず root 権限を持ったユーザーで行ってください。

1. Mac OS X 開発マシンの CD ドライブに WinDriver の CD を挿入するか、またはダウンロードしたインストール パッケージを任意の場所にコピーしてください。



2. インストール パッケージ - WDxxxxMAC.pkg (xxxx はバージョン番号) - をダブルクリックして、次のインストール手順に進みます。

注意:
次の手順は、インストールの一部として自動的に行われます:


• WinDriver のカーネル モジュール - WinDriver.kext - を /System/Library/Extensions にインストールします
• WinDriver API のフレームワーク - WDAPI.framework - を /Library/Frameworks へインストールします
• DriverWizard (wdwizard.app> や Debug Monitor (wddebug_gui.app) など、WinDriver の GUI アプリケーションを OS の /Applications フォルダーにコピーします

以下の手順は、登録版ユーザーのみです

Jungo から取得したライセンスを WinDriver に登録するには、以下の手順に従ってください:

1. /Applications/wdwizard.app をダブルクリックするか、コマンドライン プロンプトから以下のコマンドを実行して DriverWizard を起動します:
   $ /Applications/wdwizard.app/Contents/MacOSX/wdwizard
2. File メニューから Registration Options を選択し、Jungo から取得した license string を入力します
3. Activate License ボタンをクリックします
4. 評価期間中に開発したソース コードを有効にするには、ユーザー マニュアルの WDC_DriverOpen 関数の説明を参照してください。
   WDC_xxx (デフォルト) ではなく、低レベルな WD_xxx API を使用してる場合、 ユーザー マニュアルの WD_License 関数の説明を参照してください

• Solaris 8 / 9 / 10 / OpenSolaris
  Solaris 8 の場合、update #3 またはそれ以降を使用することを推奨します (Sun から入手可能)
• SPARC プラットファームの場合、64 ビットまたは 32 ビット
  または
  x86 プラットフォームの場合、32 ビット カーネル
• 開発環境 - C (GCC など)
  
  注意:
  GCC 以外の開発環境の場合、コンピュータに libgcc がインストールされていることを確認してください。以下のサイトからダウンロードできます: http://www.sunfreeware.com
  libgcc の場所に LD_LIBRARY_PATH を設定します。以下のようになります:
  LD_LIBRARY_PATH= /usr/local/lib:/usr/local/lib/sparcv9

WinDriver をインストールする際に、カーネル モジュールの windrvr6 をインストールするので、root でログインまたは root 権限で、system administrator として WinDriver のインストールを行ってください。

1. Solaris マシンの CD ドライブに CD を挿入または、ダウンロードしたインストール ファイルをコピーします

2. ディレクトリを移動します (例、home ディレクトリの場合):
   /$ cd ~

3. ファイル WDxxxSL.tgz (x86) / WDxxxSLS32.tgz (SPARC 32 ビット) / WDxxxSLS64.tgz (SPARC 64 ビット) をコピーします (`xxx' は、バージョン番号を表します):
   ~$ cp /home/username /WDxxxSL.tgz /

4. ファイルを展開します:
   ~$ gunzip -c WDxxxSL.tgz | tar xvf -

5. WinDriver ディレクトリに移動します
   

6. WinDriver/install_windrvr インストール スクリプトを使用して WinDriver をインストールします :
   ~WinDriver# ./install_windrvr
   
   WinDriver を使用して、PCI デバイスをハンドルするには、 インストール コマンドで対象の PCI デバイスの Vendor および Device ID を指定します (<vid> は、デバイスの Vendor ID を表し、 <did> は、デバイスの Device ID を表します):
   ~WinDriver# ./install_windrvr<vid>,<did>
       [<vid>,<did> ...]
   
   例えば、WinDriver を使用して PLX 9030 と 9054 デバイスをハンドルするには、 以下のように実行します:
   ~WinDriver# ./install_windrvr 10b5,9030
       10b5,9054

7. libgcc パッケージをインストールします。以下の Web サイトからダウンロード可能です:
   http://www.sunfreeware.com

8. 以下の環境変数を追加します:
   
   • SPARC 32-bit および x86 プラットフォームの場合:
     LD_LIBRARY_PATH=/usr/local/bin
   • SPARC 64-bit プラットフォームの場合:
     LD_LIBRARY_PATH=/usr/local/lib:/usr/local/lib/sparcv9
   
   

   以下の 3 つのステップはオプションです:

9. Symbolic Link を作成して、DriverWizard GUI を簡単に起動します:
   ~/WinDriver# ln -s ~/WinDriver/wizard/wdwizard /usr/bin/wdwizard

10. 一般ユーザーがアクセスできるように、ファイル wdwizard の read (読み取り) / execute (実行) 権限を変更します

11. デバイスからハードウェアへアクセスするユーザーに応じて、デバイス ファイル /dev/windrvr6 へのユーザーおよびグループ id を変更し、read (読み取り) / write (書き込み) 権限を指定します。

12. WinDriver を使用して、ハードウェアにアクセスし、ドライバ コードを生成できます!

Jungo から取得したライセンスを WinDriver に登録するには、以下の手順に従ってください:

1. DriverWizard GUI を起動します:
   ~/WinDriver/wizard$ ./wdwizard

2. File メニューから Registration Options を選択し、Jungo から取得した license string を入力します
3. Activate License ボタンをクリックします

4. 評価期間中に開発したソース コードを有効にするには、ユーザー マニュアルの WDC_DriverOpen 関数の説明を参照してください
   
   WDC_xxx (デフォルト) ではなく、低レベルな WD_xxx API を使用してる場合、 ユーザー マニュアルの WD_License 関数の説明を参照してください
   

Solaris のハードウェア アクセスの制限事項

注意:
/dev/windrvr6 は、ユーザー プログラムに直接ハードウェア アクセスを指定するので、マルチ ユーザーの Linux システムでは、カーネルの安定性に問題が生じる場合があります。 DriverWizard およびデバイス ファイル /dev/windrvr6 へのアクセスを trusted ユーザーに制限してください。

セキュリティ上、WinDriver のインストール スクリプトは、自動的に /dev/windrvr6 および DriverWizard の実行ファイル (wdwizard) の権限を変更しません。

• Windows ホスト開発プラットフォーム

• Tornado II IDE

• 対象のプラットフォーム - DriverBuilder に対応する CPU/BSP の組合せと互換性のある BSP (Board Support Package) を持つプロセッサ

  最新のリストは、以下のサイトを参照してください:
  http://www.xlsoft.com/jp/products/windriver/db-vxworks.html
  

  BSP 互換の詳細は、WindRiver Systems support にお問合せください。

• 注意: WinDriver for Windows v5.22 もインストールする必要があります。

DriverBuilder for VxWorks のインストールは以下のようになります。 DriverBuilder 開発環境は、Tornado 2 for Windows でのみ動作します (x86 プラットフォームの場合)。 DriverBuilder の v5.x およびそれ以降を使用して生成されたドライバは、Intel x86 BSPs (pc486, pcPentium および pcPentiumPro), PPC 821/860 with MBX821/860 および PPC 750 (IBM PPC 604) with MCP750 で動作します。最新のリストは以下のサイトを参照してください:
http://www.jungo.com/db-vxworks.html#platforms

インストール:

1. DriverBuilder for VxWorks をダウンロードします

2. DriverBuilder の root ディレクトリに移動します。 例:
   \> c:\

3. ダウンロードしたファイルを展開します:
   \> unzip -d DBXXXVX.zip c:\ (`xxx' はバージョン番号を表します。 例、500)
   注意:
   

   展開すると DriverBuilder ディレクトリが作成され、そのディレクトリに DriverBuilder のインストールに必要なファイルがすべてあります。 v5.00 以前の場合、DriverBuilder ディレクトリは自動的に作成されないので、手動で作成する必要があります。例:
   \> c:\cd_vxworks そして、ファイルを展開します:
   \> unzip -d DBxxxVX.zip c:\db_vxworks

注意:
WinDriver の場合、VxWorks のサンプルは .out 拡張子を持ちます。例、 pci_diag.out これらのプログラムを実行するには、Windsh を使用してロードし、ルーティン xxx_main を実行します。 例:

wddebug.out : wddebug_main pci_diag.out : pci_diag_main

TIP!
DriverBuilder は、Jungo WinDriver 製品のラインアップの1つです。 WinDriver Windows をダウンロードして工数を削減し、グラフィカルな開発環境を使用して、素早くハードウェアの診断を行い、コードを自動的に生成できます。以下の手順に従ってください:

1. DriverBuilder for VxWorks をダウンロードしインストールします

2. WinDriver for Windows をダウンロードしインストールします。 このステップを省略しないでください

3. デスクトップの DriverWizard のショートカットを作成します (C:\WinDriver\wizard\wdwizard.exe)。簡単に GUI DriverWizard を起動し、ドライバの開発を行います