株式会社 DTS インサイト ARM-AN-225A ADS から RVDS3.0 への移行について本ドキュメントはARM 社の提供する Application Note 171 Migrating from ADS to RVDS 3.0 (ARM DAI 171A) の内容に基づき作成されたも

Size: px

Start display at page:

Download "株式会社 DTS インサイト ARM-AN-225A ADS から RVDS3.0 への移行について本ドキュメントはARM 社の提供する Application Note 171 Migrating from ADS to RVDS 3.0 (ARM DAI 171A) の内容に基づき作成されたも"

なおのえ
5 years ago
Views:

1 ADS から RVDS3.0 への移行について本ドキュメントはARM 社の提供する Application Note 171 Migrating from ADS to RVDS 3.0 (ARM DAI 171A) の内容に基づき作成されたものです内容につきましては全て上記ドキュメントをマスターといたしておりますのでご使用の際には必ず上記ドキュメントを参照の上本ドキュメントは参考資料として用いる形をお取りくださいますようお願い申し上げます - 1 -

2 1. Introduction スコープツール構造の変更 RVDS3.x の主な機能台のマシンに複数のツールバージョンをインストールするソースコードの変更 C および C++ ソースコードの変更インラインアセンブラ ( asm) ライブラリ呼び出しの変更データの変更 C++ コードの変更アセンブラソースコードの変更リンカ入力ファイルの変更 ARM アーキテクチャ 6 以降のサポート makefile の変更全てのビルドツールに影響のある変更 POSIX スタイルスイッチの使用 C および C++ コンパイラオプションの変更コンパイラの呼び出しデフォルト動作の変更非推奨化および廃止されたコンパイラオプションリンカ使用法の変更 IDE プロジェクトファイルの変更デバッグにおける変更リファレンスおよびさらなる情報

3 1. Introduction 1.1 スコープ当アプリケーションノートは ARM Developer Suite(ADS)v1.x のユーザが最新の RealView Development Suite(RVDS)3.x に開発プラットフォームを移行する際の補助となることを目的としていますこのドキュメントは RVDS2.x ツールチェインを考慮していませんがここでのいくつかの変更点は 2.x にも適用されることがありますこのドキュメントは ARM ツールシンタックスやその他の特性を熟知されていることを想定しています特定のシンタックスに関する説明が必要な場合は適切なツールチェインとともに提供されるドキュメントを参照してください注 : 本ドキュメントはその機能が同等な ADS プロジェクトのビルド動作を阻害しない限り RVDS の新機能 ( リンカフィードバックなど ) の使用方法については触れません 1.2 ツール構造の変更 RVDS では ARM および Thumb の設定において C および C++ コンパイラの別々のコンポーネントではなく単一の実行形式 armcc の形をとります旧 makefile との互換を保つために以前の名前も認識可能ですがビルド環境を新しいネーミング構造に変えるよう促されますこれはこのドキュメントの項で触れます RealView Debugger(RVD) は AXD または armsd よりも推奨サポートされるデバッガです RealView ICE(RVI) は Multi-ICE よりも JTAG デバッグコントロールユニットとして推奨されます RealView Trace(RVT) はトレースキャプチャユニットとして Multi-Trace の置き換えとして推奨されます RVT を使用するには RVI が必要です 1.3 RVDS3.x の主な機能全てのユーザにおいて RVDS が ADS 以上のコードサイズとパフォーマンスの改善による利益をもたらします ARM アーキテクチャ 6 以降を実装したプロセッサの開発者はこれらのアーキテクチャバージョンが ADS ではサポートされていないためあたらしいツールチェインに移行する必要があります RVDS で生成されたコードは ARM アーキテクチャ用 ABI をサポートしており RVDS オブジェクトコードと他の ABI 準拠ツールチェインのユーザとシェアすることが可能ですこれは例えば RVDS を使って Linux アプリケーションの開発を行いそれらの伝統的な GNU ベースの開発環境を使用するなどのことを可能にしますこのトピックは別の ARM 社のウェブサイトからダウンロード可能な Application Note(#150) に記載されています : ABI に関するドキュメントは以下の ARM 社のウェブサイトからダウンロード可能です : コンパイラおよびアセンブラオプション--apcs /adsabi は削除されたことに注意してください詳細については 3.3 章リンカ使用法の変更を参照してください - 3 -

4 1.4 1 台のマシンに複数のツールバージョンをインストールする ADS ではバージョンが異なっても 1 台のマシンには 1 つのソフトウェアのみインストール可能でした RVDS では複数のバージョンをインストールすることができ 1 つの ADS( 全バージョン可 ) がインストールされたマシン上にもそれが可能となります ARM は異なったバージョンの開発ツールを切り替えて使用することのできるユーティリティを提供していますこの SuiteSwitcher ユーティリティは ARM ウェブサイト内のテクニカルサポートダウンロードセクションにあります :

5 2. ソースコードの変更このセクションでは ADS のかわりに RVDS 3.0 でビルドを行うために必要とされる可能性のあるソースコードの変更について述べます 2.1 C および C++ ソースコードの変更一般的なルールでは ANSI C および ISO C++ スタンダード準拠のソースコードは変更する必要がありません ADS は完全な ISO C++ サポートを行っていませんでしたので以前サポートされていなかった機能を使用できるようにするために ADS C++ ソースを再確認することは有効でしょうしかしこれは要求事項ではありません一部の ARM ツールに特化した機能は変更または廃止されており変更が必要となる可能性がありますインラインアセンブラ ( asm) C コンパイラはビルトインインラインアセンブラを実装していますしかしながらこれは ARM アーキテクチャ V6 以降の命令セットには対応していません全てのインラインアセンブラコードを可能な限り組み込みアセンブラに移行するかコンパイラ組み込み関数を利用するようにすることを推奨します注 :Thumb のインラインアセンブラはサポートされなくなっていますそのような ADS からのコードは修正が必要です注 : マシンレジスタの直接参照はコンパイルエラーになります例インラインアセンブリコードの組み込みアセンブラへの移行 const int Q_Flag=0x ; /* Q flag is bit 27 of PSR */ /* Inline Assembly Example */ int Clear_Q_flag (void){ int old_psr, new_psr, result; asm { MRS old_psr, CPSR BIC new_psr, old_psr, #Q_Flag AND result, old_psr, #Q_Flag MSR CPSR_f, new_psr return result; /* Embedded Assembly Example */ asm int Clear_Q_flag (void){ MRS r0, CPSR BIC r1, r0, # cpp( Q_Flag ) AND r0, r0, # cpp( Q_Flag ) MSR CPSR_f, r1 BX lr - 5 -

6 例インラインアセンブリコードのコンパイラ組み込み関数への移行 /* Inline Assembly Example */ inline int current_sp(void) { int temp; asm { mov temp, sp return temp; current_sp(); /* Compiler Intrinsic Example */ current_sp(); ライブラリ呼び出しの変更 ADS 1.x では浮動小数点引数を使用しない最適化されたバージョンの printf および scanf ファミリ関数を使用していました RVDS 3.x ではこれらの関数の特定の引数のタイプによって最適化された複数のバリアントがありますもしこれらの関数をリターゲットされていたなら各バリアントをサポートするリターゲットコードを修正する必要があります ARM 社のウェブサイト内テクニカルサポートセクションの "How do the ARM Compilers handle printf, sprintf, fprintf, and scanf : または弊社 FAQ ARM コンパイラは printf,sprintf,fprintf,scanf をどのように扱いますか : を参照してください注 : 以下のコンパイラオプションを選択するとこの最適化を RVCT で無効にできます : --library_interface=aeabi_clib 一部の rt_* から始まるライブラリ関数は ABI にあわせて aeabi_* の形にリネームされましたこれらの関数をリターゲットしている場合関数名を変更する必要がありますこのような関数を ABI ネーミング規約をサポートするように再実装するソースを変更する必要がありますこのような関数の一例 ( 完全なリストではありません ) を表 2.1 に示します ADS のネーミング rt_memcpy_w rt_div0 rt_sdiv rt_udiv rt_errno_addr rt_fp_status_addr 表 2.1 ライブラリ関数の ABI リネーム例 RVDS のネーミング aeabi_memcpy4 aeabi_idiv0 aeabi_idiv aeabi_uidiv aeabi_errno_addr aeabi_fp_status_addr - 6 -

7 2.1.3 データの変更 ADS では全ての初期化された ( RW ) データは ELF 出力ファイル内の RW セクションに配置されました RVDS ではデフォルトでそのようなデータは 8 バイト以上のサイズを持つ場合のみ ELF 出力中の RW セクションにおかれそうでない場合は.bss(ZI) セクションに配置されますこれはスタートアップ時のスキャッタローディング実行にかかる時間を短くしますしかしコンパイラによるそのようなデータに対する配置を想定するようなコードが含まれていた場合システムの処理に影響を与える可能性があります注 : コンパイラオプションによって ADS の振る舞いに戻すことができます : --bss_threshould=0 ARM 社のウェブサイト内テクニカルサポートセクションの 'Placement of small global ZI data (<= 8 bytes) in memory': または弊社 FAQ RVCTv2.1 以降で RVCTv2.0.1 では ZI セクションに配置されていた変数が RW セクションに配置されます : を参照してくださいコンパイラでは同様にメモリマップされた read-only のペリフェラルの定義に一般的に用いられる volatile const のデータタイプの扱いが変更されています RVCT は ISO C スタンダードによって指定されているようにそのようなデータを RW または ZI( 先述のデータのサイズに依存して ) セクションに配置します ADS ではこのようなデータを RO セクションに配置していましたこの場合も配置を想定するようなコードが含まれていた場合システムの処理に影響を与える可能性があります C++ コードの変更 ADS と RVDS の C++ オブジェクトには互換性がありませんそのため全ての ADS の C++ オブジェクトは他の RVDS C++ オブジェクトコードとリンクをするために RVDS C++ コンパイラでリコンパイルする必要があります RVCT は ADS では行われていなかった完全 ISO C++ サポートを提供しますそのため以前サポートされていなかったより効果的な機能を再実装することができるかどうか全ての C++ コードにおいて調査することを推奨します C++ ネームマングリングスキームは変更されておりそのためマングリングされた C++ シンボル名を直接参照しようとする全てのコードは更新する必要があるでしょうもし C++ に特化したライブラリコードの呼び出しをするような初期化コードを用いている場合 ABI 準拠のネーミングをサポートするよう修正する必要があるでしょう例えば cpp_initialize should の呼び出しは cpp_initialize_aeabi に変更します - 7 -

8 2.2 アセンブラソースコードの変更 ADS で書かれた良いアセンブラのコードは RVDS でもアセンブルすることができます全てのパブリックインターフェイスにおいてスタックが 8 バイトアラインされなければならない ABI の要求事項の一つに注意してくださいオブジェクトにおいて 8 バイトアライメントが保持されていれば RVDS のアセンブラは生成されたオブジェクトファイルに対し正しくビルド属性をセットするでしょうそうでなければこのような不整合はリンク時にエラーを発生させる可能性がありますこの場合ソースコードを変える必要があります解決方法は通常関数の出入り口で追加のレジスタを push/pop することです注 :Pre-UAL( 古い ) アセンブリコードもサポートされますしかしながらディスアセンブリツールは統合アセンブラ言語 (UAL) を出力するでしょう UAL の変更点の詳細については RVDS 3.0 Assembler Guide 内のセクション 2.2 を参照してください例 ABI および UAL をサポートするアセンブラソースへの変更 AREA ADSexample, CODE CODE32 IMPORT foo start MOV r0, #0x10 MOV r1, #3 BL subroutine stop MOV r0, #0x18 LDR r1, =0x20026 SWI 0x subroutine STMFD r13!, {r4, lr BL foo LDMFD r13!, {r4, pc AREA RVDSexample, CODE ARM IMPORT foo Start MOV r0, #0x10 MOV r1, #3 BL subroutine stop MOV r0, #0x18 LDR r1, =0x20026 SVC 0x subroutine PUSH {r4, lr ; 8-byte stack ; alignment BL foo POP {r4, pc - 8 -

9 2.3 リンカ入力ファイルの変更セクションで述べている通り ADS と RVDS で生成した C++ オブジェクトには互換性がなくユーザは ADS が生成した C++ オブジェクトを RVDS でビルドしたオブジェクトとともに使用したい場合はそれらをリコンパイルする必要があります ADS 用スキャッタ定義ファイルは RVDS でも動作しますがルートリージョンに配置されるべき C ライブラリコードを明示的に参照している場合これらのリージョンの定義が例 2.4 に示すように変わっていることに注意してください例スキャッタ定義ファイルの変更 ; ADS Example LOAD <base_address> { ROOT <base_address> { main.o (+RO) * (Region$$Table) * (ZISection$$Table) ; RVDS Example LOAD <base_address> { ROOT <base_address> { * (InRoot$$Sections) 2.4 ARM アーキテクチャ 6 以降のサポートコンパイラから ARM アーキテクチャ 6 以降の命令を生成させたい場合ビルドコマンドにおいて適切な--cpu オプションを使用するだけでかまいませんアセンブラを使用する場合はそのような命令を使用するようにアセンブリコードを修正し且つ適切な--cpu オプションを使用してくださいリンク時新しいアーキテクチャをサポートするようにビルドされたオブジェクトとリンクする場合アーキテクチャに固有な命令を使用していなくともリンカはアーキテクチャをサポートするライブラリコードを使用しますこれによってもしそのようなアーキテクチャをサポートしていないターゲットで動作させると未定義命令例外が発生することがありますこのような状況が発生した場合各オブジェクト ( ユーザ定義ライブラリ内のものも含む ) が新しいアーキテクチャ用にビルドされているかどうかを確認するためにチェックする必要があるでしょうこの属性を設定する唯一の方法はオブジェクトの初期ビルド時に--cpu オプションを指定する事である点に注意してください - 9 -

10 3. makefile の変更このセクションでは RVDS に移行を行う際に変更が必要となる可能性のあるコマンドラインオプションについて述べます 3.1 全てのビルドツールに影響のある変更 POSIX スタイルスイッチの使用 RVDS では現在マルチキャラクタコンパイラオプションを 2 つのハイフンで指定する POSIX フォーマットを使用していますツールはこれらが付けられていない場合ワーニングを返します例えば ADS オプションの-cpu は --cpu に変更する必要があります限定タグに続くシングルキャラクタスイッチは依然 1 つのハイフンによって指定されることに注意してください例えば最適化設定 -O2(-O< 最適化レベル >) は RVDS では 1 つのハイフンのみを要求します 3.2 C および C++ コンパイラオプションの変更コンパイラの呼び出し下位互換性を保つための実行形式ラッパーを提供している 3.0 リリースにおいて厳密に必要とはされていないうちに別々のコンパイラを呼び出さないようにすることを推奨します表 3.1 に従ってコマンドを変更すべきです表 3.1 コンパイラ呼び出しの変更 ADS 方式 RVDS 方式暗黙の RVDS でのデフォルト armcc armcc --c90 --arm tcc armcc -thumb --c90 armcpp armcc -cpp --arm tcpp armcc -thumb --cpp デフォルト動作の変更デバッグテーブル生成 (-g) が有効の場合 ADS のデフォルトの最適化レベルは-O0 であり無効の場合は-O2 でした RVDS ではこの変更についてワーニングが発生しますがデフォルトの最適化レベルは常に-O2 です Warning: C3010W: -g defaults to -O2 if no optimisation level is specified 非推奨化および廃止されたコンパイラオプション今後サポートされないまた可能であればそれらの RVDS における代替のコンパイラオプションの詳細については RVDS 3.0 Compiler and Libraries Guide の Table E-2 を参照してください

11 3.3 リンカ使用法の変更リンカはオブジェクトの関数インターフェースにおける 8 バイトスタックアライメントを含む ABI 互換性をより厳密にチェックする事に注意してください 8 バイトスタックアライメントを保持しないオブジェクトのリンク時に以下のリンカエラーが発生します : Error: L6238E: foo.o(.text) contains invalid call from '~PRES8' function to 'REQ8' function コンパイラおよびアセンブラオプション--apcs /adsabi は RVDS コンパイラに ADS プロシジャコールスタンダードと互換なオブジェクトを生成させますが RVDS3.0 以降はサポートされません ARM は ADS のコードを RVDS で全てリビルドすることを強く推奨していますこの項目に関する詳細な解説は ARM 社の FAQ エントリ内 "Are legacy ADS objects/libraries compatible with RVCT2.x? : または弊社 FAQ RVCT2.x と ADS で生成したオブジェクトやライブラリの互換性はありますか : を参照してください注 :ADS でビルドされた C++ オブジェクトは RVDS でビルドされたものと互換性がありません 3.4 IDE プロジェクトファイルの変更 ADS と RVDS の両方においてそれぞれ MetroWerks 社の CodeWarrior IDE を提供しており ADS のプロジェクトを RVDS でインポートすることはできますが逆はできませんユーザは手作業で上記のセクション毎にコンパイラオプションを手作業で対応させる必要がある可能性があります同様にプロジェクトマネージメント他の機能において Eclipse フレームワークユーティリティを RVDS とともに使うこともできます Eclipse についてはを参照してください ARM がフレームワークに対して行ったインテグレーションについてはを参照してください ARM は CodeWarrior プロジェクト (.mcp) を Eclipse やその他のビルド環境にインポートすることができるよう makefile にポーティングするのを補助する mcp2make ユーティリティを提供していますこれは ARM 社の web サイト内ダウンロードセクションから取得できます : デバッグにおける変更 AXD は ADS とともに提供されるデバッガで JTAG 接続では Multi-ICE が推奨されるソリューションでしたトレースが必要な場合 Multi-Trace が推奨されるソリューションでした RVDS では推奨されるデバッガは RVI および RVT と接続する RVD です RVI と Multi-ICE の両方 ( および RVT と Multi-Trace) がボードに対し同じ接続信号を要求するのでターゲットハードウェアでは変更が不要であるべきです

12 もし AXD のデバッグセッションで使用していた AXD スクリプトがあれば RVD のフォーマットにスクリプトを変換するのを補助する axd2rvd という名前のユーティリティが RVDS とともに提供されます axd2rvd -I axd.txt -O rvd.txt また RVD 3.0 User Guide 内 appendix C.3 'Comparison of RealView Debugger and AXD commands' または appendix D.1 'Comparison of RealView Debugger and armsd commands' も参考になります注 :AXD およびコマンドラインデバッガ armsd は非推奨となり将来のツールバージョンではサポートされない予定です

13 4. リファレンスおよびさらなる情報 ARM ツールの追加情報は関連する RVCT 3.0 ドキュメンテーションで見つけることができます : RVCT 3.0 Compiler and Libraries Guide (ARM DUI 0205G) RVCT 3.0 Linker and Utilities Guide (ARM DUI 0206G) RVCT 3.0 Developer Guide (ARM DUI 0203G) RVD 3.0 User Guide (ARM DUI 0153H) RVD 3.0 Essentials Guide (ARM DUI 0181H) ARM アーキテクチャの ABI の完全なドキュメンテーションは以下で参照できます : ARM 社 web サイト内 ARM Software Tools FAQ のページ : - 以上

インテル(R) Visual Fortran コンパイラ 10.0

インテル(R) Visual Fortran コンパイラ 10.0 インテル (R) Visual Fortran コンパイラー 10.0 日本語版スペシャルエディション入門ガイド目次概要インテル (R) Visual Fortran コンパイラーの設定はじめに検証用ソースファイル適切なインストールの確認コンパイラーの起動 ( コマンドライン ) コンパイル ( 最適化オプションなし ) 実行 / プログラムの検証コンパイル ( 最適化オプションあり ) 実行

株式会社 DTS インサイト ARM-AN-225A ADS から RVDS3.0 への移行について 本ドキュメントはARM 社の提供する Application Note 171 Migrating from ADS to RVDS 3.0 (ARM DAI 171A) の内容に基づき作成されたも

株式会社 DTS インサイト ARM-AN-225A ADS から RVDS3.0 への移行について本ドキュメントはARM 社の提供する Application Note 171 Migrating from ADS to RVDS 3.0 (ARM DAI 171A) の内容に基づき作成されたも