サポートの概要

IAR EW の統合は以下のように提供されます。

• プロジェクトのインポート機能とオプションの抽出機能は、ツールチェーン (EWARM、EW430、EWSTM8 など) に依存します。詳細については、以下のツールチェーンのセクションを参照してください。

IAR Embedded Workbench プロジェクトのテストを容易にするために、以下のコンポーネントが提供されます。 

• C-SPY シミュレーターで単体テストおよびアプリケーション テストを開始するためのテスト コンフィギュレーション
  • Run IAR EW Tests (Batch Template) - EW によって生成されたバッチ スクリプト ('.cspy.bat') を使用してシミュレーターを使用。
  • Run IAR EW Application with Mem Monitoring (Batch Template) - EW によって生成されたバッチ スクリプト ('.cspy.bat') を使用してシミュレーターを使用。
• テスト コンフィギュレーションに関連付けられたテスト フロー。統合されたテスト結果の読み込みが組込まれています。
  • Build and run tests on IAR C-SPY Simulator
  • Build and run tests on IAR C-SPY Simulator using EW-generated batch scripts (.cspy.bat)
  • Build and run application on IAR C-SPY Simulator
  • Build and run application on IAR C-SPY Simulator using EW-generated batch scripts (.cspy.bat)
• 以下のパブリッシュされたプロパティは、IAR 固有のテスト コンフィギュレーション/テスト フローで利用することができます。
  • "Target architecture" (arch) 「Batch Template ではないテスト コンフィギュレーション」で使用される。
  • "C-SPY execution backend options" (bkend_opts) ターゲット上でテスト バイナリを正しく実行するために必要とされる。 「Batch Template ではないテスト コンフィギュレーション」で使用される。
  • "Original IAR EW project folder name" (prj_dir_name) プロジェクト ファイルの直接の親フォルダーの名前。デフォルトはプロジェクト名。EW 生成のバッチ スクリプトの場所を指定するために設定しなければならない。Batch Template テスト コンフィギュレーションで使用される。
  • "Original IAR EW project name" (prj_name) Eclipse プロジェクト名が元の名前と一致しない場合に備えて用意されているプロパティ。Batch Template テスト コンフィギュレーションで使用される。
  • "IAR EW project Build Configuration (leave empty for EW < 7.0)" (bld_cfg) 使用する EW プロジェクト ビルド構成 (たとえば "Debug" または "Release")。IAR C-SPY シミュレーターで実行するアプリケーションのために使用する EW 生成のバッチ スクリプトの場所を指定するために、最近のバージョンの EW では設定する必要がある (なぜなら、最近のバージョンの場合、EW 生成のバッチ スクリプト名に EW プロジェクト ビルド構成の名前が含まれるため)。古いバージョンの EW の場合は空白のままになる。Batch Template テスト コンフィギュレーションで使用される。

各ツールチェーンのセクションで、さらにテスト コンフィギュレーションについて説明しています。それらのテスト コンフィギュレーションは手動で構成されます。EW 生成 C-SPY バッチ スクリプトを利用できない場合や他の問題のあるケースのために、あくまでバックアップ的な解決方法として提供されたものです。可能な場合は必ず前述の Batch Template テスト コンフィギュレーションを使用してください。

[Generate Unit Tests] や [Generate Stubs] などの標準的なテスト コンフィギュレーションも IAR プロジェクトに対して使用できますし、コード品質を確保するために使用が推奨されます。

要件

• コンパイラおよび C-SPY 実行可能ファイルが PATH 変数に追加されていること。
• ランタイム ライブラリのビルド用コンフィギュレーション ファイルに EW_DIR 環境変数があり、EW インストール ディレクトリを指していること。
• "Build and run tests on IAR C-SPY Simulator" および "Build and run application on IAR C-SPY Simulator" テスト フローは、EW_DIR 環境変数に EW インストール ディレクトリが設定されていること、およびシミュレーターのバック エンド オプションが手動で用意されることを必要とします。そのために、テスト フローのプロパティを編集します。
• 最近のバージョンの EW の場合、"Build and run tests on IAR C-SPY Simulator using EW-generated batch script template" および "Build and run application on IAR C-SPY Simulator using EW-generated batch script template" テスト フローに EW プロジェクト ビルド構成の名前を設定する必要があります ("IAR EW project Build Configuration" テスト フロー プロパティを使用)。
• C/C++test ランタイム ライブラリ機能の選択/構成によっては、IAR の C/C++ ランタイム ライブラリ (DLib) 構成が特定の要件を満たさなければならない場合があります。特に、テスト結果をファイル チャネルで転送する場合 (デフォルト) および 事後条件/アサーションでメッセージを出力する場合は、DLib に stdio 互換の FILE および printf インターフェイスがなければなりません。つまり、"Full" "Semihosted" DLib コンフィギュレーションを使用するか、適切な機能を有効化した "Custom" コンフィギュレーションを使用する必要があります。

既知の制限事項 

• EW には環境セットアップ スクリプトが付属していません。そのため、EW のインストーラーによって設定された環境変数を使用するか、他の方法で環境をセットアップする必要があります。

• IAR メモリ属性 (例えば '__data'、'__data20'、'__tiny'、'__near_func') に関する IAR 拡張は、完全にはサポートされていません。この制限により、解析の最中にパース エラーやインストゥルメントされたコードのコンパイル エラーなどのエラーが発生する可能性があります。また、元のコードのメモリ属性とは別のメモリ属性がコードに含まれているかのように解析される場合があります。

• サポートされない IAR C++ 拡張アルゴリズム:
  • クラス テンプレートの部分特殊化マッチング 関数テンプレートのパラメーター推論
  • 関数テンプレートのパラメーター推論
  これらの拡張は、IAR メモリ タイプ属性 (例えば '__code' 、 '__data'、'__data20'、'__near_func') と C++ テンプレートを組み合わせた使用に関係します。特に IAR ARM コンパイラの場合、この問題は、テンプレート パラメーターに置き換わるタイプの不正なメモリ タイプ属性につながる可能性があります。 この制限はEC++ には影響しません (なぜならこのモードではテンプレートは使用できないからです)。このセクションで説明した IAR のテンプレート関連 C++ 拡張は、IAR DLIB ヘッダーで広範に使用されているため、C/C++test は IAR STL ヘッダーを使用しているコードを解析できないか、誤って解析する可能性があります。 
• (カバレッジ ビューなどで) C/C++test がレポートする関数シグニチャから IAR タイプ属性に関する部分が抜けている場合があります。 例えば、 void f(int __data16 *) と という 2 つの異なる関数のカバレッジvoid f(int __data24 *)が、同じ f(int *) というシグニチャで表示される場合があります。
• 一部の特殊な状況では、IAR 言語拡張が無効化されていると、C/C++test が解析対象コードを解析できない可能性があります。この制限を回避するには、IAR 言語拡張を有効にします。IAR 言語拡張を有効にするには、EW 内のプロジェクト設定で行うか、プロジェクトの C/C++test コンパイラ オプションに -e コンパイル オプションを追加します。
  1. プロジェクトを選択し、[プロジェクト] > [プロパティ] > [Parasoft] > [C/C++test] > [ビルド設定] をクリックします。
  2. [コンパイラ オプション] フィールドに -e を入力し、[適用] をクリックします。
• C/C++test にあらかじめ用意されている IAR コンパイラ構成を使用した場合、C/C++test は元のプロジェクトまたはビルドで使用されている C++ モードにかかわらず、EEC++ (Extended Embedded C++) モードで C++ コードを解析します。この制限は、C/C++test の EWSTM8 サポートには影響しません。この制限を回避するには、次の操作を行って、C/C++test IAR コンパイラ構成を修正します。
  1. カスタム コンパイラ コンフィギュレーションを作成します (カスタム コンパイラ コンフィギュレーションの詳細については 「カスタム コンパイラを使用するテストの設定」を参照)。
  2. gui.properties ファイルの cppCompilerCmdLine= で始まる行を探し、--eec++ オプションを必要なオプションに変更します。この行は、例えば次のように見えます。
     cppCompilerCmdLine=$(exe) $(filtered_opts) --eec++
-I $(CPPTEST_INCLUDE_DIR) $(input) -o $(output)
gui.properties ファイルに cppCompilationModeOption= で始まる行がある場合、--eec++ オプションも必要な値に変更する必要があります。この行は、例えば次のように見えます。
     сppCompilationModeOption=--eec++
  3. cpp.psrc ファイルを次のように変更します。
     

     edgtk.preprocessorCommand で始まる行および edgtk.gccAutoconfiguratorCommand で始まる行を探し、--eec++ コンパイラ オプションを必要な値に変更します。これらの行は、例えば次のように見えます。
     edgtk.preprocessorCommand {exe} --preprocess=nl {out} {opts} --eec++ {in}
edgtk.gccAutoconfiguratorCommand {exe} --preprocess=nl {tmpout} {opts} --eec++ --silent --predef_macros {out} {in}

• コンパイラ プラグマ ディレクティブのサポートは限定的です。解析の際、プラグマ ディレクティブを含むソース コードを解析することができ、通常はソース コードにディレクティブが保持されますが、解釈されません。一部の特殊な状況では、プラグマ ディレクティブを含むソース コードは、それらのディレクティブが存在しないか、別の場所にあるかのように解析されます。このため、解析中にエラーが発生したり、解析結果が不正確になる場合があります。 動的解析および C++ ファイルを含むプロジェクトの場合、コンパイラ ヘッダー ファイル内で使用されているプラグマ ディレクティブ (inline または function_effects など) に関する警告メッセージが C/C++test のコンソールに出力される場合があります。たいていの場合、これらの警告はテスト対象コードの最適化レベルが元のプロジェクトに含まれる同じコードの最適化レベルと異なっていることを表しており、無視することができます。
• IAR コンパイラにはいくつかの C++ モードがあり (例えば EC++、EEC++、C++ など)、コマンド ライン オプションでモードを有効化できます。C++ モードを有効にすると、コンパイラ コマンド ラインに存在するすべてのソース ファイルが、ファイル拡張子にかかわらず C++ ファイルとして扱われ、有効化されたモードでコンパイルされます。C++ モード選択オプションを含む .bdf ファイルから C/C++test プロジェクトを作成した場合、C/C++test はコンパイラのインストール ディレクトリから他のディレクトリ (bin または inc など) も選択し、それらのディレクトリをリンクされたフォルダーとして扱う場合があります。結果として、解析スコープに余分なファイルが含まれ、パフォーマンスの問題を引き起こしたり、C/C++test コンソールに予期しないメッセージが表示されることがあります。この問題を回避するには、C/C++test プロジェクトから不要なリンクされたフォルダーを削除します。また、C/C++test が .bdf ファイルから新規プロジェクトを作成する際に、余分なディレクトリを選択するのを回避することもできます。例えば、GUI で次の操作を行います。
  1. メイン メニューの [ファイル] > [新規] > [プロジェクト] > [ビルド データ ファイルからプロジェクトを作成] をクリックします。
  2. .bdf ファイルを選択し、設定を確認します。
  3. [次へ] をクリックし、プロジェクトのコンテンツを展開して不要なフォルダーを見つけます。
  4. フォルダーを右クリックし、コンテキスト メニューの [Remove folder(s)] をクリックします。
• 以下のキーワードはサポートされません。
  • 特別な IAR ビルトイン演算子 __no_alloc_str() および __no_alloc_str16()
  • __as_get_base()、__as_get_bounds()、および __as_make_bounds() のような特別な C-RUN 演算子
  これらの IAR 拡張キーワードを使用するコードを解析すると、解析中にパース エラーが発生します。 
• 以下のキーワードは部分的にサポートされます。
  • 特別な IAR キーワード __no_alloc および __no_alloc16 キーワード
  これらの IAR 拡張キーワードを使用するコードを解析すると、パース エラーやインストゥルメント コードのコンパイル エラーといったエラーが解析中に起こる可能性があります。 
• サポート対象アーキテクチャ固有の既知の制限については、以下のツールチェーン固有のセクションを参照してください。