PDF version - ARM Information Center

®ARMDS-5バージ ョ ン 5.7DS-5 スタートガイドCopyright © 2010, 2011 ARM. All rights reserved.ARM DUI 0478GJ (ID 111511)

ARM DS-5DS-5 スタートガイドCopyright © 2010, 2011 ARM. All rights reserved.リリース 情 報本 書 には 以 下 の 変 更 が 加 え ら れています。変 更 履 歴日 付 発 行 機 密 保 持 ステー タ ス 変 更 点2010 年 6 月 A 非 機 密 扱 い DS-5 初 版2010 年 9 月 B 非 機 密 扱 い DS-5 バージ ョ ン 5.2 改 訂 版2010 年 11 月 C 非 機 密 扱 い DS-5 バージ ョ ン 5.3 改 訂 版2011 年 1 月 D 非 機 密 扱 い DS-5 バージ ョ ン 5.4 改 訂 版2011 年 5 月 E 非 機 密 扱 い DS-5 バージ ョ ン 5.5 改 訂 版2011 年 7 月 F 非 機 密 扱 い DS-5 バージ ョ ン 5.6 改 訂 版2011 年 9 月 G 機 密 DS-5 バージ ョ ン 5.7 改 訂 版著 作 権®または のマー ク が 付 いた 言 葉 およびロ ゴは、 こ の 著 作 権 情 報 で 別 段 に 規 定 さ れてい る 場 合 を 除 き、ARM の EU ま たはその 他 の 国 におけ る 登 録 商 標 および 商 標 です。 本 書 に 記 載 さ れてい る 他 の 製 品 名 は、 各社 の 所 有 する 商 標 です。本 書 に 記 載 さ れてい る 情 報 の 全 部 ま たは 一 部 、 な らびに 本 書 で 紹 介 する 製 品 は、 著 作 権 所 有 者 の 文 書 に よる 事 前 の 許 可 を 得 ない 限 り 、 転 用 ・ 複 製 る こ と を 禁 じ ます。本 書 に 記 載 さ れてい る 製 品 は、 今 後 も 継 続 的 に 開 発 ・ 改 良 の 対 象 と な り ます。 本 書 に 含 まれる 製 品 およびその 利 用 方 法 についての 情 報 は、 ARM が 利 用 者 の 利 益 のために 提 供 する ものです。 し たがって 当 社 では、製 品 の 市 販 性 ま たは 利 用 の 適 切 性 を 含 め、 暗 示 的 ・ 明 示 的 に 関 係 な く 一 切 の 責 任 をいません。本 書 は、 本 製 品 の 利 用 者 をサポー ト する こ と だけを 目 的 と し ています。 本 書 に 記 載 さ れてい る 情 報 の 使用 、 情 報 の 誤 り ま たは 省 略 、 あ るいは 本 製 の 誤 使 用 に よ って 発 生 し たいかな る 損 失 ・ 損 傷 について も、ARM は 一 切 責 任 を 負 いません。ARM と い う 用 語 が 使 用 さ れてい る 場 合 、 "ARM または 必 要 に 応 じてその 子 会 社 " を 指 し ます。機 密 保 持 ステー タ ス本 書 は 非 機 密 扱 いであ り 、 本 書 を 使 用 、 複 製 、 および 開 示 する 権 利 は、 ARM および ARM が 本 書 を 提 供 した 当 事 者 と の 間 で 締 結 し た 契 約 の 条 項 に 基 づいた ラ イ セン スの 制 限 に よ り 異 な り ます。製 品 ステー タ ス本 書 の 情 報 は 最 終 版 であ り 、 開 発 済 み 製 品 に 対 応 し ています。Web アドレスhttp://www.arm.comARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. iiID 111511Non-Confidential

目 次ARM DS-5 DS-5 スタートガイド第 1 章第 2 章第 3 章表 記 規 則 と フ ィ ー ド バ ッ クARM DS-5 の 製 品 概 要2.1 DS-5 について ......................................................................................................... 2-22.2 Eclipse for DS-5 について ....................................................................................... 2-32.3 DS-5 デバッ ガについて ........................................................................................... 2-42.4 リアルタイムシステムモデルについて ................................................................... 2-52.5 ARM コンパイラについて ....................................................................................... 2-62.6 GNU コンパイルツールについて ............................................................................ 2-72.7 ARM Streamline パフォーマンスアナライザについて ............................................ 2-82.8 デバ ッ グハー ド ウ ェ ア 設 定 ユーテ ィ リ テ ィ について .............................................. 2-9ARM DS-5 チュート リアル3.1 Eclipse へのサンプルプ ロジ ェ ク ト のイ ンポー ト ................................................... 3-23.2 Eclipse からの Gnometris プロジ ェ ク ト の 作 成 ...................................................... 3-43.3 コマンドラインからの Gnometris プ ロジ ェ ク ト の 作 成 .......................................... 3-53.4 Gnometris アプ リ ケーシ ョ ンの リ アルタ イムシステムモデルへのロー ド .............. 3-63.5 Gnometris アプリケーシ ョ ンの ARM Linux ターゲッ トへのロード ....................... 3-73.6 SSH 接 続 を 使 用 し た ARM Linux ターゲッ トでの Gnometris の 設 定 および 実 行 ... 3-83.7 ARM Linux ターゲッ ト 上 で 既 に 実 行 されている Gnometris アプ リ ケーシ ョ ンへの 接 続3-143.8 Gnometris のデバッ グ ........................................................................................... 3-183.9 ロード 可 能 なカーネルモジュールのデバッグ ....................................................... 3-203.10 ARM Linux 上 で 動 作 するスレ ッ ド アプ リ ケーシ ョ ンのパフ ォーマンス 解 析 ....... 3-253.11 Android ネイティブ C/C++ アプリケーシ ョ ンおよびライブラリのデバッグ ....... 3-273.12 DS-5 ラ イ センスの 管 理 ......................................................................................... 3-33ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. iiiID 111511Non-Confidential

表 記 規 則 と フ ィ ー ド バ ッ ク本 製 品 に 関 する フ ィ ー ド バ ッ ク本 製 品 についてのご 意 見 やご 提 案 がご ざいま し た ら、 以 下 の 情 報 を 添 えて 購 入 元 までお 寄 せ 下 さ い。• お 名 前 と 会 社 名• 製 品 のシ リ アル 番 号• 製 品 の リ リ ース 情 報• ご 使 用 のプラッ ト フォームの 詳 細 (ハードウェアプラッ ト フォーム、 オペレーテ ィ ングシステムの 種 類 とバージ ョ ンなど)• 問 題 を 再 現 するサ イ ズの 小 さ な 独 立 し たサンプルコー ド• 操 作 の 目 的 と 実 際 の 動 作 に 関 する 詳 し い 説 明• 使 用 し た コ マン ド (コ マン ド ラ イ ンオプシ ョ ン を 含 む)• 問 題 を 例 示 するサンプル 出 力• ツールのバージ ョ ン 情 報 (バージ ョ ン 番 号 、 ビル ド 番 号 を 含 む)内 容 に 関 する フ ィ ー ド バ ッ ク内 容 に 関 するご 意 見 につきましては、 電 子 メールを errata@arm.com まで送 信 し て 下 さ い。 その 際 には、 以 下 の 内 容 を 記 載 し て 下 さ い。• タイトル• 文 書 番 号 (ARM DUI 0478GJ)• オン ラ イ ンでご 覧 の 場 合 は、 該 当 する ト ピ ッ ク 名• PDF 版 の 文 書 を ご 覧 の 場 合 は、 問 題 のあ るページ 番 号• 問 題 点 の 簡 潔 な 説 明ま た、 補 足 すべき 点 や 改 善 すべき 点 についての 全 般 的 なご 提 案 もお 待 ちしております。ARM では、 技 術 情 報 記 事 や FAQ の 拡 充 と 共 に、 ドキュメントに 対 する 更 新 と 訂 正 をARM Information Center にて 定 期 的 に 行 ってお り ます。その 他 の 情 報• ARM Infocenter, http://infocenter.arm.com/help/index.jsp• ARM Technical Support Knowledge Articles,http://infocenter.arm.com/help/topic/com.arm.doc.faqs• サポー ト およびメ ンテナンス ,http://www.arm.com/support/services/support-maintenance.php• ARM 用 語 集 , http://infocenter.arm.com/help/topic/com.arm.doc.aeg0014-/index.htmlARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 1-2ID 111511Non-Confidential

ARM DS-5 の 製 品 概 要2.1 DS-5 についてDS-5 は、 Linux ベースのシ ス テムおよびベア メ タルの 組 み 込 みシ ス テム 用 のプ ロフ ェ ッ シ ョ ナルな ソ フ ト ウ ェ ア 開 発 ソ リ ューシ ョ ンです。 ブー ト コー ド やカーネルの 移 植 から アプ リ ケーシ ョ ンやベア メ タルのデバッ グまで、 開 発 のあ ら ゆる 段 階 をサポー ト し ます。 ま たパフ ォーマン ス 解 析 機 能 も 備 えています。DS-5 には、 以 下 のコ ンポーネン ト が 含 まれています。• DS-5 デバ ッ ガ。• Eclipse for DS-5。 Eclipse Foundation 製 の Eclipse IDE をコンパイルツールとデバ ッ グ ツールに 組 み 込 んだ 統 合 開 発 環 境 (IDE)。• リアルタイムシステムモデル。• ARM Streamline パフォーマンスアナラ イザ。• DS-5 ツールの 使 用 を 開 始 する 上 で 役 立 つ 専 用 のサンプル、 アプ リ ケーシ ョ ン、およびサポート ドキュ メン ト。• ベア メ タル 用 のデバッ グハード ウ ェア 設 定 ユーテ ィ リ テ ィ。• ベア メ タル 組 み 込 みシステの 開 発 用 ARM コンパイラツール。• ブー ト コードおよび ARM Linux アプ リ ケーシ ョ ンの 開 発 用 GNU コンパイルツール2.1.1 関 連 項 目概 念• Eclipse for DS-5 について (2-3 ページ)• DS-5 デバ ッ ガについて (2-4 ページ)• リアルタイムシステムモデルについて (2-5 ページ)• ARM コンパイラについて (2-6 ページ)• GNU コンパイルツールについて (2-7 ページ)• ARM Streamline パフォーマンスアナラ イザについて (2-8 ページ)• デバ ッ グハー ド ウ ェ ア 設 定 ユーテ ィ リ テ ィ について (2-9 ページ) .参 照• ラ イ セン スおよび 製 品 ア ッ プデー ト (4-5 ページ)• マニュアル (4-6 ページ)• サンプル (4-7 ページ) .その 他 の 情 報• DS-5 技 術 情 報 記 事 , http://infocenter.arm.com/help/topic/com.arm.doc.faqs/kiXXwMK1Sxk7vf.htmlARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 2-2ID 111511Non-Confidential

ARM DS-5 の 製 品 概 要2.2 Eclipse for DS-5 についてEclipse for DS-5 は、Eclipse Foundation 製 の Eclipse IDE を ARM ツールのコンパイルとデバ ッ グテ ク ノ ロ ジに 組 み 込 んだ 統 合 開 発 環 境 (IDE) です。 これには、 ARM Linuxターゲッ トの GNU ツールチェーン も 組 み 込 まれています。Eclipse for DS-5 には、 以 下 が 含 まれています。プロジェク トマネージャさ まざまなプロ ジェ ク ト タ ス ク の 実 行 に 使 用 し ます。 プロ ジェ ク ト へのフ ァ イルや 依 存 関 係 の 追 加 と 削 除 、 プ ロ ジ ェ ク ト の イ ンポー ト 、 エ ク スポ ト 、 作 成 、 およびビルドオプシ ョ ンの 管 理 などを 行 う こ とができます。エデ ィ タこれらは、 C/C++ または ARM アセンブ リ 言 語 のソースファ イルの 読 み出 し、 書 き 出 し、 または 修 正 に 使 用 します。パースペク テ ィ ブ と ビ ューこれらは、 特 定 の 種 類 の 環 境 に 合 わせてカ ス タマ イ ズ されたビ ュー、 メニュー、 およびツールバーを 提 供 します。 DS-5 は、 C/C++ パースペクティブ DS-5 デバ ッ グパースペク テ ィ ブを 使 用 し ます。2.2.1 関 連 項 目タスク• 『ARM ® DS-5 : Eclipse の 使 用 』 :— 第 3 章 Eclipse スタートガイド .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 2-3ID 111511Non-Confidential

ARM DS-5 の 製 品 概 要2.4 リアルタイムシステムモデルについてリアルタイムシステムモデル (RTSM) を 使 用 する と 、 実 際 のハー ド ウ ェ ア を 使 用 せずに ソ フ ト ウ ェ ア 開 発 を 行 う こ と がで き ます。 こ のモデルは、 プ ロ グ ラ マの 観 点 から 実 際 のハー ド ウ ェ ア と 同 じ 機 能 動 作 を 行 います。高 速 シ ミ ュ レーシ ョ ン 実 行 を 実 現 する 代 わ り に 絶 対 的 な タ イ ミ ング 精 度 が 犠 牲 になり ます。 そのため、 モデルを 使 用 してソ フ ト ウェアの 機 能 を 確 する こ とはできますが、 サイ クルカ ウ ン ト 、 低 レベルのコ ンポーネン ト イ ン タ ラ ク シ ョ ン、 またはその他 のハード ウ ェア 固 有 の 動 作 については 認 でき ません。DS-5 には、 ARM Linux がブー ト する よ う に 事 前 設 定 さ れた Cortex -A8 RTSM が 含 まれています。2.4.1 関 連 項 目参 照• RealView ® Development Suite リアルタイムシステムモデルユーザガイド ,http://infocenter.arm.com/help/topic/com.arm.doc.dui0424-/ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 2-5ID 111511Non-Confidential

ARM DS-5 の 製 品 概 要2.5 ARM コンパイラについてDS-5 には、 ARM ® コ ンパイ ラ ツールのデ ィ ス ト リ ビ ューシ ョ ンが 含 まれています。これらのツールは、 DS-5 サンプルディ レク ト リ で 使 用 できるサンプルなど、 ベア メタル 組 み 込 みシ ス テムに 適 し たアプ リ ケーシ ョ ンやラ イ ブ ラ リ ビル ド に 使 用 で き ます。ARM コンパイラツールは、tools_directory にあ り ます。 こ れ ら のツールを 使 用 し て、コマンド ラインまたは Eclipse の 中 から アプ リ ケーシ ョ ンをビル ド でき ます。表 2-1 ARM コンパイラツールツールarmararmasmarmccarmlinkfromelf説 明ライブラリアン。ELF 形 式 のオブジ ェ ク ト フ ァ イルをアーカ イ ブやラ イ ブ ラ リ にま と めて 保 存 する ために 使 用 し ます。 こ れに よ り 、 複数 の ELF ファルの 代 わりにライブラリやアーカイブをリンカに 渡 すこ と がで き ます。 アーカ イ ブをサー ド パーテ ィ に 配 布 し て、 アプ リケーシ ョ ンの 開 発 に 使 し て も ら う こ と も で き ます。アセンブラ。 ARM および Thumb ® アセンブ リ 言 語 による ソースファイルをアセンブルします。コンパイラ。 C コード と C++ コードをコンパイルします。 インラインアセンブ ラおよび 組 み 込 みアセンブ ラ をサポー ト し てお り 、NEON ベク トル 化 コンパイラも 含 まれています。リンカ。1 つま たは 複 数 のオブジ ェ ク ト フ ァ イルの 内 容 と 、 1 つまたは 複 数 のオブジ ェ ク ト ラ イ ブ ラ リ か ら 選 択 された 部 分 を 結 合 し、 実行 可 能 プ ロ グ ラ ム を 生 成 し ます。イメージ 変 換 ユーティリティ。 逆 アセンブリおよびコードサイズやデータ サ イ ズなど、 入 力 イ メ ージに 関 する テキ ス ト 情 報 を 生 成 することもできす。2.5.1 関 連 項 目タスク• 『ARM ® DS-5 : Eclipse の 使 用 』 :— 新 しい C プロジェク ト または C++ プロジェク トの 作 成 (4-4 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 2-6ID 111511Non-Confidential

ARM DS-5 の 製 品 概 要2.6 GNU コンパイルツールについてDS-5 には、 GNU コ ンパイルツールのデ ィ ス ト リ ビ ューシ ョ ンが 含 まれています。これらのツールは、 DS-5 サンプルディ レク ト リ で 使 用 できる ARM Linux のサンプルディス ト リビューションなど、 ARM Linux ターゲットに 適 したアプリーションやライ ブ ラ リ のビル ド に 使 用 で き ます。 以 下 の 項 目 のビル ド には 適 し ていません。• ベア メ タル ARM ターゲッ ト• ARM Linux 以 外 のオペレーテ ィ ングシ ス テムが 動 作 する ARM ターゲッ ト• 非 ARM ターゲッ ト。GNU コンパイルツールは、tools_directory にあ り ます。 こ れ ら のツールを 使 用 し て、コマンド ラインまたは Eclipse の 中 から アプ リ ケーシ ョ ンをビル ド でき ます。表 2-2 GNU コンパイルツールツールarm-none-linux-gnueabi-ararm-none-linux-gnueabi-asarm-none-linux-gnueabi-gccarm-none-linux-gnueabi-g++arm-none-linux-gnueabi-ld説 明GNU ライブラリアン。GNU アセンブラGNU C コンパイラGNU C++ コンパイラGNU リンカ『Getting Started with the GNU Compilation Tools』 は、 documents_directory\gcc にあ り ます。2.6.1 関 連 項 目タスク• Eclipse からの Gnometris プロジェク トの 作 成 (3-4 ページ)• コマンド ラインからの Gnometris プロジェク トの 作 成 (3-5 ページ)• 『ARM ® DS-5 : Eclipse の 使 用 』:— 新 しい C プロジェク ト または C++ プロジェク トの 作 成 (4-4 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 2-7ID 111511Non-Confidential

ARM DS-5 の 製 品 概 要2.8 デバ ッ グハー ド ウ ェ ア 設 定 ユーテ ィ リ テ ィ についてデバ ッ グハー ド ウ ェ ア 設 定 ユーテ ィ リ テ ィ は、 開 発 プ ラ ッ ト フ ォーム と PC の 間 のイン タ フ ェース と な るデバ ッ グハー ド ウ ェ アユニ ッ ト への 接 続 に 使 用 し ます。 以 下 のユーテ ィ リ テ ィ が 用 意 されています。ARM デバ ッ グハー ド ウ ェ ア Config IPデバ ッ グハー ド ウ ェ アユニ ッ ト 上 の IP アドレスの 設 定 に 使 用 します。デバ ッ グハー ド ウ ェ ア 更 新 ツールデバ ッ グハー ド ウ ェ アユニ ッ ト 上 のハー ド ウ ェ ア と デバイ スの 更 新 に 使用 します。デバ ッ グハー ド ウ ェ ア 設 定デバ ッ グハー ド ウ ェ アユニ ッ ト の 設 定 に 使 用 し ます。2.8.1 関 連 項 目参 照• ARM ® DSTREAM と RVI :デバッグハードウェア 設 定 ユーティリティの 使 用 ,http://infocenter.arm.com/help/topic/com.arm.doc.dui0498-/index.html :ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 2-9ID 111511Non-Confidential

第 3 章ARM DS-5 チュート リアル以 下 の 各 チ ュー ト リ アルでは、 ARM ® DS-5 ツールを 使 用 して、 アプ リ ケーシ ョ ンを実 行 およびデバッ グする 方 法 について 説 明 し ます。タスク• Eclipse へのサンプルプロ ジェ ク ト のイ ンポー ト (3-2 ページ)• Eclipse からの Gnometris プロジェク トの 作 成 (3-4 ページ)• コマンド ラインからの Gnometris プロジェク トの 作 成 (3-5 ページ)• Gnometris アプ リ ケーシ ョ ンの リ アルタ イムシステムモデルへのロード(3-6 ページ)• Gnometris アプ リ ケーシ ョ ンの ARM Linux ターゲッ トへのロード (3-7 ページ)— SSH 接 続 を 使 用 し た ARM Linux ターゲッ ト での Gnometris の 設 定 および 実行 (3-8 ページ)— ARM Linux ターゲッ ト 上 で 既 に 実 行 されている Gnometris アプ リ ケーシ ョンへの 接 続 (3-14 ページ) .• Gnometris のデバッ グ (3-18 ページ)• ロード 可 能 なカーネルモジュールのデバッグ (3-20 ページ)• ARM Linux 上 で 動 作 する ス レ ッ ド アプ リ ケーシ ョ ンのパフ ォーマン ス 解 析(3-25 ページ)• Android ネイティブ C/C++ アプ リ ケーシ ョ ンおよびラ イブラ リ のデバッグ(3-27 ページ)• DS-5 ライセンスの 管 理 (3-33 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-1ID 111511Non-Confidential

ARM DS-5 チュート リアル3.1 Eclipse へのサン プルプ ロジ ェ ク ト のイ ンポー トこのマニュアルに 記 載 されている 多 くのタスクでは、 DS-5 付 属 のサンプルプ ロ ジ ェクトを 使 用 しています。Eclipse でサンプルプロジェクトを 使 用 するには、 まずそれらのプロジェクトをインポー ト する 必 要 があ り ます。1. Eclipse を 起 動 し ます。• Windows 環 境 では、 [スタート] → [すべてのプ ロ グ ラ ム] → [ARMDS-5] → [Eclipse for DS-5] を 選 択 し ます。• Linux 環 境 では、 Unix bash シェルで 「eclipse」 と 入 力 します。2. サンプルプロジェク ト 用 の 新 しいワークスペースを 作 成 して、 実 際 に 使 用 してい る プ ロ ジ ェ ク ト か ら 分 離 する こ と をお 勧 め し ます。 こ れには、 以 のいずれかの 方 法 を 使 用 し ます。• Eclipse の 起 動 時 に 新 し いワー ク スペースデ ィ レ ク ト リ を 作 成 し ます。• Eclipse が 既 に 開 いている 場 合 、 メ イ ン メ ニ ューから [File] → [SwitchWorkspace] → [Other] を 選 択 し ます。3. [Help] メニューから [Cheat Sheet...] を 選 択 し ます。4. [ARM -Eclipse for DS-5] グループを 展 開 します。5. ARM チー ト シー ト の リ ス ト か ら [Automatically Import the DS-5 ExampleProjects into the Current Workspace] を 選 択 します。6. [OK] をクリ ックします。7. チー ト シー ト の 手 順 に 従 って、 すべての DS-5 サンプルプロジェ ク ト をワークスペースにインポート します。サンプルがイ ンポー ト された ら、 必 要 に 応 じ て 残 り のチー ト シー ト の 手 順 に 従 い、作 業 セ ッ ト をオンに し ます。3.1.1 関 連 項 目タスク• Eclipse からの Gnometris プロジェク トの 作 成 (3-4 ページ)• コマンド ラインからの Gnometris プロジェク トの 作 成 (3-5 ページ)• Gnometris アプ リ ケーシ ョ ンの リ アルタ イムシステムモデルへのロード(3-6 ページ)• Gnometris アプ リ ケーシ ョ ンの ARM Linux ターゲッ トへのロード (3-7 ページ)• Gnometris のデバッ グ (3-18 ページ)• 『ARM ® DS-5 : Eclipse の 使 用 』:— Eclipse の 起 動 (3-3 ページ)— 作 業 セ ッ ト の 作 成 (3-16 ページ)— 作 業 セ ッ ト の 表 示 で ト ッ プレベルの 要 素 を 変 更 する (3-19 ページ)— 作 業 セ ッ ト の 選 択 解 除 (3-20 ページ)— インポート ウィザードの 使 用 (3-35 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-2ID 111511Non-Confidential

ARM DS-5 チュート リアル概 念• Eclipse for DS-5 について (2-3 ページ)• サンプル (4-7 ページ)• 『ARM ® DS-5 : Eclipse の 使 用 』:— 作 業 セ ッ ト について (3-15 ページ) .参 照• サンプル (4-7 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-3ID 111511Non-Confidential

ARM DS-5 チュート リアル3.2 Eclipse からの Gnometris プ ロジ ェ ク ト の 作 成Gnometris は、 ターゲッ ト 上 で 実 行 およびデバッグできる ARM ® Linux アプ リ ケーションです。 用 意 されているプロジェクトには、Gnometris アプ リ ケーシ ョ ンのイメージバイナリが 含 まれていません。 イメージを 成 するためには、 プロジェク トをビルドする 必 要 があ り ます。プロジェク ト をビルドするには1. ARM Web サイ ト または DS-5 インストールメディアからオプションのパッケージ Linux_distribution_example.zip をダウンロード します。 このパッケージには、サンプル Linux デ ィ ス ト リ ビ ューシ ョ ンプ ロ ジ ェ ク ト と 、 それ と 互 換 性 のあ るヘッダおよびライブリが 含 まれています。2. gnometris および distribution の 両 方 のサンプルプ ロ ジ ェ ク ト を、 関 連 する ZIPアーカイブフ ァ イルから Eclipse にインポート します。3. [Project Explorer] ビューで gnometris プロジェク ト を 選 択 します。4. [Project] メニューから、[Build Project] を 選 択 し ます。Gnometris サンプルには、 このプロジェク ト をビルドするための Makefile が 含 まれています。 Makefile は、 通 常 の メ イ クルールであ る clean、 all、 および rebuildを 提 供 し ます。Gnometris プ ロ ジ ェ ク ト を ビル ド する と 、 以 下 のアプ リ ケーシ ョ ンが 生 成 さ れます。• デバ ッ グ 情 報 のないス ト リ ッ プバージ ョ ンのアプ リ ケーシ ョ ン。 これはターゲッ トにダウンロードするためのバージョンです。• 大 きいサイ ズのバージ ョ ンのアプ リ ケーシ ョ ンには、 ソース レベルでのデバ ッグ 時 にデバッ ガによ って 使 用 されるすべてのデバッ グ 情 報 が 含 まれます。3.2.1 関 連 項 目タスク• Eclipse へのサンプルプロ ジェ ク ト のイ ンポー ト (3-2 ページ)• コマンド ラインからの Gnometris プロジェク トの 作 成 (3-5 ページ)• Gnometris アプ リ ケーシ ョ ンの リ アルタ イムシステムモデルへのロード(3-6 ページ)• Gnometris アプ リ ケーシ ョ ンの ARM Linux ターゲッ トへのロード (3-7 ページ)• Gnometris のデバッ グ (3-18 ページ)• 『ARM ® DS-5 : Eclipse の 使 用 』:— 第 4 章 プロジェク トの 使 用 .参 照• サンプル (4-7 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-4ID 111511Non-Confidential

ARM DS-5 チュート リアル3.3 コマンドラインからの Gnometris プ ロジ ェ ク ト の 作 成Gnometris は、 ターゲッ ト 上 で 実 行 およびデバッグできる ARM ® Linux アプ リ ケーションです。 用 意 されているプロジェクトには、Gnometris アプ リ ケーシ ョ ンのイメージバイナリが 含 まれていません。プロジェク ト をビルドするには1. ARM Web サイ ト または DS-5 インストールメディアからオプションのパッケージ Linux_distribution_example.zip をダウンロード します。 このパッケージには、サンプル Linux デ ィ ス ト リ ビ ューシ ョ ンプ ロ ジ ェ ク ト と 、 それ と 互 換 性 のあ るヘッダおよびライブリが 含 まれています。2. gnometris および distribution の 両 方 のサンプルプ ロ ジ ェ ク ト を、 関 連 する ZIPアーカ イ ブフ ァ イ ルか ら 作 業 デ ィ レ ク ト リ に 抽 出 し ます。3. DS-5 Command Prompt コマンド ラインコンソールまたは Unix bash シェルを 開きます。4. ...\ARMLinux\gnometris に 移 動 し ます。5. プロンプトで、 「make」 と 入 力 します。 Gnometris サンプルには、 このプロジェクトをビルドするための Makefile が 含 まれています。 Makefile は、 通 常 の メ イ クルールであ る clean、 all、 および rebuild を 提 供 します。Gnometris プ ロ ジ ェ ク ト を ビル ド する と 、 以 下 のアプ リ ケーシ ョ ンが 生 成 さ れます。• デバ ッ グ 情 報 のないス ト リ ッ プバージ ョ ンのアプ リ ケーシ ョ ン。 これはターゲッ トにダウンロードするためのバージョンです。• 大 きいサイ ズのバージ ョ ンのアプ リ ケーシ ョ ンには、 ソース レベルでのデバ ッグ 時 にデバッ ガによ って 使 用 されるすべてのデバッ グ 情 報 が 含 まれます。3.3.1 関 連 項 目タスク• Eclipse からの Gnometris プロジェク トの 作 成 (3-4 ページ)• Gnometris アプ リ ケーシ ョ ンの リ アルタ イムシステムモデルへのロード(3-6 ページ)• Gnometris アプ リ ケーシ ョ ンの ARM Linux ターゲッ トへのロード (3-7 ページ)• Gnometris のデバッ グ (3-18 ページ) .参 照• サンプル (4-7 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-5ID 111511Non-Confidential

ARM DS-5 チュート リアル3.4 Gnometris アプリケーシ ョ ンのリアルタ イムシステムモデルへのロードGnometris アプ リ ケーシ ョ ンは、 ARM Linux で 動 作 する リアルタイムシステムモデル(RTSM) にロードするこ とができます。 RTSM を 使 用 する と、 ハード ウェアターゲットを 使 用 せずに、 ホストワークステーション 上 でアプリケーショの 開 発 およびデバ ッ グを 実 行 でき ます。事 前 設 定 済 みの RTSM 接 続 を 使 用 し て、 自 動 的 に Linux をブート し、gdbserver を 起 動し た 後 、 アプ リ ケーシ ョ ン を 起 動 する こ と がで き ます。Gnometris をロードするには1. Eclipse を 起 動 し ます。2. [Project Explorer] ビューをク リ ッ クします。3. gnometris プロジェク ト フォルダを 展 開 します。4. 起 動 フ ァ イ ル gnometris-RTSM-example.launch を 右 ク リ ッ ク し ます。5. コンテキスト メニューで、 [Debug As] を 選 択 します。6. サブ メ ニューで gnometris-RTSM-example エン ト リ を 選 択 します。7. デバ ッ グには、 DS-5 デバ ッ グパースペク テ ィ ブが 必 要 です。 [ConfirmPerspective Switch] ダイアログボッ クスが 表 示 された 場 合 は、 [Yes] をクリ ックしてパースペクティブを 切 り 替 えます。3.4.1 関 連 項 目タスク• Eclipse へのサンプルプロ ジェ ク ト のイ ンポー ト (3-2 ページ)• Eclipse からの Gnometris プロジェク トの 作 成 (3-4 ページ)• コマンド ラインからの Gnometris プロジェク トの 作 成 (3-5 ページ)• Gnometris のデバッ グ (3-18 ページ)• 『ARM ® DS-5 :デバッガの 使 用 』:— RTSM モデルへの 接 続 の 設 定 (3-3 ページ) .参 照• マニュアル (4-6 ページ)• サンプル (4-7 ページ)• 『ARM ® DS-5 :デバッガの 使 用 』:— [Debug Configurations] - [Connection] タブ (11-78 ページ)— [Debug Configurations] - [Files] タブ (11-83 ページ)— [Debug Configurations] - [Debugger] タブ (11-88 ページ)— [Debug Configurations] - [Environment] タブ (11-96 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-6ID 111511Non-Confidential

ARM DS-5 チュート リアル3.5 Gnometris アプリケーシ ョ ンの ARM Linux ターゲッ トへのロードGnometris アプ リ ケーシ ョ ンは、 ARM ® Linux で 動 作 する ターゲ ッ ト に ロー ド する ことができます。DS-5 には 事 前 設 定 済 みの ターゲ ッ ト 接 続 設 定 が 用 意 さ れ、 それに よ ってサポー ト 対象 の ARM アーキテクチャベースのプラ ッ ト フォーム 上 で 動 作 する gdbserver にデバッガが 接 続 されます。アプ リ ケーシ ョ ンをロードするには1. ターゲッ トの IP アドレスを 取 得 します。 これには、 Linux コンソールでifconfig アプ リ ケーシ ョ ンを 使 用 します。 IP アドレスは、 inet addr で 指 定 されています。2. ターゲッ ト 上 で、 適 切 な Linux デ ィ ス ト リ ビ ューシ ョ ン を 起 動 し ます。3. Eclipse を 起 動 し ます。4. アプ リ ケーシ ョ ン と 関 連 のファ イルを ARM Linux ターゲッ トに 転 送 し、 アプリケーシ ョ ン を 実 行 し た 後 、 デバ ッ ガに 接 続 し ます。 それを 実 行 する に、 方 法 がいくつかあります。• ビーグルボードで、 DS-5 に 付 属 の リモートシステムエクスプローラ(RSE) を 使 用 してセキュアシェル (SSH) 接 続 を 行 う こ とで、 ターゲット を 設 定 し、 アプ リ ケーシ ョ ン を 実 行 で き ます。 アプ リ ケーシ ョ ンが 実 行さ れる と 、 デバ ッ ガを 実 行 中 の ターゲ ッ ト に 接 続 で き ます。• 他 のターゲ ッ ト については、 PuTTY などの 外 部 のファイル 転 送 ユーティ リティを 使 用 できます。3.5.1 関 連 項 目タスク• SSH 接 続 を 使 用 し た ARM Linux ターゲッ ト での Gnometris の 設 定 および 実 行(3-8 ページ)• ARM Linux ターゲッ ト 上 で 既 に 実 行 されている Gnometris アプ リ ケーシ ョ ンへの接 続 (3-14 ページ)• Gnometris のデバッ グ (3-18 ページ) .参 照• マニュアル (4-6 ページ)• サンプル (4-7 ページ)• 『ARM ® DS-5 :デバッガの 使 用 』:— [Debug Configurations] - [Connection] タブ (11-78 ページ)— [Debug Configurations] - [Files] タブ (11-83 ページ)— [Debug Configurations] - [Debugger] タブ (11-88 ページ)— [Debug Configurations] - [Environment] タブ (11-96 ページ)— DSTREAM ユニッ ト の 接 続 ,http://infocenter.arm.com/help/topic/com.arm.doc.dui0481-/I1004916.html.ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-7ID 111511Non-Confidential

ARM DS-5 チュート リアル3.6 SSH 接 続 を 使 用 し た ARM Linux ターゲッ トでの Gnometris の 設 定 および 実 行一 部 の ターゲ ッ ト では、 DS-5 に 付 属 の リモートシステムエクスプローラ (RSE) を使 用 し てセキュアシェル (SSH) 接 続 を 行 う こ とができます。ARM Linux ターゲッ トへの Linux SSH 接 続 を 設 定 し、 Gnometris アプ リ ケーシ ョ ンを実 行 する には1. [Remote Systems] ビューを DS-5 デバ ッ グパースペク テ ィ ブに 追 加 し ます。a. DS-5 パースペク テ ィ ブで 作 業 し ている こ と を 確 認 し ます。 パースペクテ ィ ブを 変 更 するには、 パースペ ク テ ィ ブツールバーを 使 用 する か、 メ インニューで [ウ ィンド ウ] → [パースペクティブを 開 く] → [DS-5Debug] を 選 択 します。b. [Window] →[Show View] →[Other...] を 選 択 して [Show View] ダイアログボックスを 開 きます。c. [Remote Systems] グループの [Remote Systems] ビューを 選 択 します。d. [OK] をクリ ックします。2. [Remote Systems] ビューで、 SSH を 使 用 した リ モー ト ターゲッ ト への Linux 接続 を 設 定 し ます。a. [Remote Systems] ビューツールバーで、 [Define a connection to remotesystem] をクリ ックします。b. [Select Remote System Type] ダイアログボッ クスで [General] グループを展 開 し、 [Linux] を 選 択 し ます。c. [Next] をク リ ックします。図 3-1 接 続 タ イ プの 選 択d. [Remote Linux System Connection] の [Host name] フィールドに、 リモートのターゲット IP ア ド レ ス ま たは 名 前 を 入 力 し ます。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-8ID 111511Non-Confidential

ARM DS-5 チュート リアルe. [Next] をク リ ックします。f. SSH プロ ト コルのファイルアクセスを 選 択 します。図 3-2 接 続 情 報 の 定 義g. [Next] をク リ ックします。h. Linux システムのシェルプロセスを 選 択 します。図 3-3 フ ァ イルシステムの 定 義ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-9ID 111511Non-Confidential

ARM DS-5 チュート リアルi. [Next] をク リ ックします。j. SSH シ ェルを 選 択 し ます。図 3-4 プロセスの 定 義k. [Next] をク リ ックします。l. SSH ターミナルを 選 択 します。図 3-5 シ ェ ルサービスの 定 義ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-10ID 111511Non-Confidential

ARM DS-5 チュート リアルm. [Finish] をクリ ックします。図 3-6 タ ー ミ ナルサービスの 定 義3. [Remote Systems] ビ ューで、 以 下 の よ う に 操 作 し ます。a. Linux ターゲッ ト を 右 ク リ ッ ク し、 コンテキス ト メニューで [Connect]を 選 択 し ます。b. [Enter Password] ダイアログボッ クスで、 必 要 に 応 じてユーザー ID とパスワードを 入 力 します。c. [OK] をクリ ックしてダイアログボックスを 閉 じます。d. ストリップバージョンの Gnometris アプ リ ケーシ ョ ン gnometris とlibgames-support.so ライブラ リをローカルファイルシステムからターゲットファイルシステムにコピーします。e. ターゲ ッ ト 上 のフ ァ イ ルに 実 行 パー ミ ッ シ ョ ンがあ る こ と を 確 認 し ます。これには、 各 ファイルを 右 ク リ ッ クしてコンテキス ト メニューの[Properties] を 選 択 し、 必 要 に 応 じてチェッ クボッ クスを 変 更 します。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-11ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-7 [Remote Systems] ビ ューでのフ ァ イルのプロパテ ィ の 変 更4. ターゲ ッ ト に 接 続 さ れてい る ター ミ ナルシ ェルを 開 き、 こ のアプ リ ケーシ ョ ンを 使 用 して gdbserver に 接 続 し ます。a. [Remote Systems] ビューで、 [SSH Terminal] を 右 ク リ ッ ク し ます。b. [Launch Terminal] を 選 択 してター ミ ナルシェルを 開 きます。c. ターミナルシェルで、gnometris アプ リ ケーシ ョ ンをコピーしたディ レ ク トリ に 移 動 し、 以 下 の コ マン ド を 実 行 し ます。export DISPLAY=ip:0.0gdbserver :port gnometris各 パラ メ ータには 以 下 の 意 味 があ り ます。ipGnometris ゲームに 表 示 する ホス ト の IP アドレスport gdbserver と アプ リ ケーシ ョ ン 間 の 接 続 ポー ト ( 例 : 5000)注ターゲ ッ ト でデ ィ スプレ イ が 使 用 で き る 場 合 、export DISPLAY の 指 定 は 必 要ありません。3.6.1 関 連 項 目タスク• ARM Linux ターゲッ ト 上 で 既 に 実 行 されている Gnometris アプ リ ケーシ ョ ンへの接 続 (3-14 ページ)• Gnometris のデバッ グ (3-18 ページ) .参 照• サンプル (4-7 ページ)ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-12ID 111511Non-Confidential

ARM DS-5 チュート リアル• 『ARM ® DS-5 :デバッガの 使 用 』:— [Debug Configurations] - [Connection] タブ (11-78 ページ)— [Debug Configurations] - [Files] タブ (11-83 ページ)— [Debug Configurations] - [Debugger] タブ (11-88 ページ)— DSTREAM ユニッ ト の 接 続 ,http://infocenter.arm.com/help/topic/com.arm.doc.dui0481-/I1004916.html.ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-13ID 111511Non-Confidential

ARM DS-5 チュート リアル3.7 ARM Linux ターゲッ ト 上 で 既 に 実 行 されている Gnometris アプリケーシ ョ ンへの接 続ARM Linux ターゲッ ト 上 で 既 に 実 行 されている Gnometris アプ リ ケーシ ョ ンにデバッガを 接 続 するには1. [Run] メニューから [Debug Configurations...] を 選 択 し ます。2. コンフィギュレーションツリーから [DS-5 Debugger] を 選 択 し、 [New] をクリ ッ ク し て 新 し い コ ン フ ィ ギ ュ レーシ ョ ン を 作 成 し ます。 ま たは、 既 存 の DS-5デバ ッ ガ コ ン フ ィ ギ ュ レーシ ョ ン を 選 択 し、 ツールバーで [Duplicate] をクリックします。3. [Name] フ ィ ール ド に、 新 しいコ ンフ ィ ギ ュ レーシ ョ ンの 適 切 な 名 前 を 入 力 します。4. [Connection] タブをク リ ックしてターゲッ ト と 接 続 オプショ ンを 表 示 します。5. [Select target] パネルで、 以 下 の よ う に 操 作 し ます。a. 必 要 なプ ラ ッ ト フ ォーム ( 例 : [beagleboard.org - OMAP_3530]) を 選 択します。b. デバ ッ グ 操 作 について、 [Connect to already running gdbserver] を 選 択 します。6. [Connections] パネルで、 gdbserver とアプリケーションの 間 の 接 続 について、 以下 のよ う に 設 定 し ます。a. ターゲッ トの IP アドレスを 入 力 します。b. ポー ト 番 号 を 入 力 します。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-14ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-8 ビーグルボー ド の 一 般 的 な 接 続 構 成7. [Files] タブをク リ ッ クしてファイルオプショ ンを 表 示 します。8. [Files] パネルで、 以 下 の よ う に 操 作 し ます。a. [Load symbols from file] を 選 択 し、 デバッグ 情 報 が 格 納 されているアプリ ケーシ ョ ン イ メージを 選 択 し ます。 以 下 に 例 を 示 し ます。H:\workspace\gnometris\gnometris.b. [Add a new resource to the list] をクリ ックし、 別 のファイルエント リを 追加 します。c. [Load symbols from file] を 選 択 し、 Gnometris アプ リ ケーシ ョ ンが 必 要 とする 共 有 ラ イ ブ ラ リ を 選 択 し ます。 以 下 に 例 を 示 し ます。H:\workspace\gnometris\libgames-support.so。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-15ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-9 ビーグルボー ド の 一 般 的 な フ ァ イル 選 択9. [Debugger] タブをク リ ックしてコンフィギュレーショ ンのデバッグのオプシ ョ ン を 表 示 し ます。10. [Run] コ ン ト ロールパネルで、 以 下 の よ う に 操 作 し ます。a. [Debug from symbol] を 選 択 し ます。b. 表 示 さ れる フ ィ ール ド に、 「main」 と 入 力 し ます。11. [Host working directory] パネルで、 [Use default] を 選 択 します。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-16ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-10 ビーグルボー ド の 一 般 的 なデバ ッ ガ 設 定12. [Debug] をクリ ックしてデバッガを 開 始 し、main() 関 数 まで 実 行 し ます。13. デバ ッ グには、 DS-5 デバ ッ グパースペク テ ィ ブが 必 要 です。 [ConfirmPerspective Switch] ダイアログボッ クスが 表 示 された 場 合 は、 [Yes] をクリ ックしてパースペクティブを 切 り 替 えます。3.7.1 関 連 項 目タスク• Gnometris のデバッ グ (3-18 ページ) .参 照• サンプル (4-7 ページ)• 『ARM ® DS-5 :デバッガの 使 用 』:— [Debug Configurations] - [Connection] タブ (11-78 ページ)— [Debug Configurations] - [Files] タブ (11-83 ページ)— [Debug Configurations] - [Debugger] タブ (11-88 ページ)— DSTREAM ユニッ ト の 接 続 ,http://infocenter.arm.com/help/topic/com.arm.doc.dui0481-/I1004916.html.ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-17ID 111511Non-Confidential

ARM DS-5 チュート リアル3.8 Gnometris のデバッ グGnometris アプ リ ケーシ ョ ンをデバッグするには1. ターゲッ トに 接 続 されているこ と、 Gnometris が 動 作 しているこ と、 およびデバッガが main() 関 数 で 待 機 し てい る こ と を 確 認 し ます。2. [Project Explorer] ビューで、 Gnometris ディレク ト リを 開 いてすべてのソースファイルのリストを 表 示 します。3. ファイル blockops-noclutter.cpp をク リ ックして 開 きます。4. blockops-noclutter.c ファイルで、BlockOps::rotateBlock() という 行 を 探 し、C/C++ エデ ィ タ の 左 側 にあ る 垂 直 バーを ク リ ッ ク し てブレー ク ポ イ ン ト を 追 加し ます。 エデ ィ タの 垂 直 バーの 中 にマーカが 設 定 されます。 ブレーク ポイ ン トビ ューが 更 新 さ れて 新 し い 情 報 が 表 示 さ れます。5. デバ ッ グ 制 御 ビ ューで [Continue] をクリ ックしてプログラムを 引 き 続 き 実 行します。6. ターゲッ ト で、 新 しい Gnometris ゲーム を 開 始 し ます。 ブ ロ ッ ク に 到 達 し た ら、上 向 き カー ソ ルキーを 押 し てブレー ク ポ イ ン ト に 到 達 さ せます。7. レジス タビューを 選 択 して、 レジス タの 値 を 表 示 し ます。8. 逆 アセンブ リ ビューを 選 択 して、 逆 アセンブ リ 命 令 を 表 示 します。 このビューの 左 側 にあ る 垂 直 バーを ク リ ッ ク し て、 個 別 の 命 令 にブレー ク ポ イ ン ト を 設 定する こ と もできます。9. デバ ッ グ 制 御 ビ ューで、 [Step Over Source Line] をクリ ックしてソースファイルの 次 の 行 に 移 動 し ます。 ソース コード のステ ッ プが 進 む と 同 時 に、 すべてのビューが 更 新 されます。10. 履 歴 ビ ューを 選 択 し て、 現 在 のデバ ッ グセ ッ シ ョ ンで 生 成 さ れたすべてのデバ ッ グ コ マン ド の リ ス ト を 表 示 し ます。 コ マン ド ( 複 数 可 ) を 選 択 し [Exportsthe selected lines as a script] をクリックして、 後 で 使 用 できるようにスクリプトファイルを 作 成 します。3.8.1 関 連 項 目タスク• Eclipse へのサンプルプロ ジェ ク ト のイ ンポー ト (3-2 ページ)• Eclipse からの Gnometris プロジェク トの 作 成 (3-4 ページ)• コマンド ラインからの Gnometris プロジェク トの 作 成 (3-5 ページ)• Gnometris アプ リ ケーシ ョ ンの リ アルタ イムシステムモデルへのロード(3-6 ページ) .• Gnometris アプ リ ケーシ ョ ンの ARM Linux ターゲッ トへのロード (3-7 ページ) .• 『ARM ® DS-5 :デバッガの 使 用 』:— gdbserver を 使 用 した Linux ターゲッ トへの 接 続 の 設 定 (3-5 ページ) .• 『ARM ® DS-5 : Eclipse の 使 用 』:— [Remote Systems] ビュー (6-3 ページ) .参 照• サンプル (4-7 ページ)ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-18ID 111511Non-Confidential

ARM DS-5 チュート リアル• 『ARM ® DS-5 :デバッガの 使 用 』:— C/C++ エデ ィ タ (11-13 ページ)— [Debug Control] ビュー (11-22 ページ)— [Registers] ビュー (11-46 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-19ID 111511Non-Confidential

ARM DS-5 チュート リアル3.9 ロード 可 能 なカーネルモジュールのデバッグDS-5 を 使 用 してロード 可 能 なカーネルモジュールを 開 発 し、 デバッグすることができます。 ロード 可 能 なモジュールは、 頻 繁 にカーネルをコンパイルすることなく、開 発 時 に 実 行 中 のカーネル と の 間 で 動 的 に 挿 入 および 削 除 で き る モジ ュールです。DS-5 では、 簡 単 なキャ ラ ク タデバイ ス ド ラ イバの 例 と して、 ターゲッ ト 上 でコ ンパイル、 実 行 、 およびデバ ッ グで き る modex.c を 用 意 しています。 また Windows ユーザに 対 し ては、 DS-5 が 提 供 する Linux デ ィ ス ト リ ビ ューシ ョ ンプ ロ ジ ェ ク ト に 相 当 する ビル ド 済 みイ メ ージバ イナ リ が 提 供 さ れています。 ま たは、 カーネルやモジ ュールのコ ンパイルの 詳 細 については、kernel_module サンプルに 付 属 の readme.html を 参 照してください。3.9.1 前 提 条 件モジ ュールをデバ ッ グする には、 その 前 に 以 下 の 条 件 を 満 たす 必 要 があ り ます。• カーネルソース コードが 展 開 され、 ターゲッ ト と まった く 同 じカーネルバージョンに 対 してカーネルがコンパイルされていること。• ターゲッ ト とまったく 同 じカーネルバージ ョ ンに 対 して、 ロード 可 能 なモジュールがコンパイルされていること。注こ れら の イ メ ージは、 いずれも 必 ずデバ ッ グ 情 報 と と も にコ ンパ イルし て く だ さ い。デバ ッ ガがモジ ュールをデバ ッ グする 際 、 両 方 の イ メ ージのン タ イ ム 情 報 が 必 要 です。3.9.2 手 順ロード 可 能 なモジュール modex.c をデバッグするには1. デバッ ガを ターゲ ッ ト に 接 続 し ます。 デバイ ス ド ラ イバのサンプルに、 事 前 設定 済 みの 起 動 フ ァ イルが 用 意 さ れています。a. [Run] メニューから [Debug Configurations...] を 選 択 し ます。b. コンフィギュレーションツリーで、 [DS-5 Debugger] を 展 開 し ます。c. module-beagle-example エン ト リ を 選 択 します。d. [Connection] タブには、 [Debug Hardware Address] フ ィールドを 除 くほと んどの 接 続 設 定 が 含 まれています。 デバ ッ ガ と デバ ッ グハー ド ウ ェ アエージェ ン ト 間 の 接 続 に 使 用 する、 IP ア ド レスまたは 名 前 を 入 力 します。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-20ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-11 Linux カーネルモジ ュール 構 成 用 の 一 般 的 な 接 続e. [Files] タブには、 Linux カーネルとモジュールに 関 するデバッ グ 情 報 をロードするためのデバッガ 設 定 が 含 まれています。 例 えば、 以 下 の 図 に 示すよ うに [Application on host to download] フィールドを 無 視 し、 カーネルイメージとモジュールイメージの 両 方 を 選 択 します。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-21ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-12 Linux カーネルモジ ュール 構 成 用 の 一 般 的 な フ ァ イル 選 択f. [Run] コン ト ロールパネルの [Debugger] タブで、 [Connect only] を 選択 します。g. [Debug] を ク リ ッ ク し て ターゲ ッ ト にデバ ッ ガを 接 続 し ます。2. ターミナルシェルを 設 定 し、 ターゲッ トに 接 続 します。 これには DS-5 に 付 属の リモートシステムエクスプローラ (RSE) を 使 用 できます。3. RSE を 使 用 し、 コ ンパ イル 済 みのモジ ュールを ターゲ ッ ト に コ ピーし ます。a. ホス ト ワークステーションの .../linux_system/kernel_module/stripped ディレク ト リに 移 動 します。b. モジュール modex.ko をターゲッ トの 書 き 込 み 可 能 なディレク ト リにドラッグアンド ド ロ ップします。4. ター ミ ナルシ ェルで、 モジ ュールを 挿 入 し ます。a. モジ ュールの 場 所 に 移 動 し ます。b. 以 下 の コ マン ド を 実 行 し ます。insmod modex.ko[Modules] ビューで、 ロード 済 みのモジュールの 詳 細 が 更 新 されて 表 示 されます。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-22ID 111511Non-Confidential

ARM DS-5 チュート リアル5. モジ ュールをデバ ッ グする 必 要 に 応 じ て、 ブレー ク ポ イ ン ト を 設 定 し、 実 行し、 ステップ 実 行 します。6. モジ ュールの ソース コー ド を 変 更 するにはa. モジ ュールを 削 除 し ます。 以 下 に 例 を 示 し ます。rmmod modexb. モジュールを 再 コンパイルします。c. 手 順 3、 4、 5 を 必 要 に 応 じて 繰 り 返 し ます。注モジュールを 挿 入 および 削 除 する と、 デバッガはターゲッ ト を 停 止 し、 デバッグ 情報 と 既 存 のブレー ク ポ イ ン ト の メ モ リ 位 置 を 自 動 的 に 解 決 し ます。 し たがって、ソース コー ド を 再 コ ンパ イルする 際 に、 デバ ッ ガを 停 止 し て 再 接 続 する 必 要 はあ りません。便 利 な ター ミ ナルシ ェルコ マン ド :lsmodinsmodrmmodロー ド 済 みのすべてのモジ ュールに 関 する 情 報 が 表 示 さ れます。ロード 可 能 なモジュールを 挿 入 します。モジュールを 削 除 します。便 利 な DS-5 デバ ッ ガ コ マン ドinfo os-modulesinfo os-loginfo os-versioninfo processesset os-log-capture接 続 後 に ロー ド さ れた OS モジュールの リ ス ト を 表 示 します。OS ロ グバ ッ フ ァ の 内 容 を 表 示 し ます。OS のバージ ョ ンの 内 容 を 表 示 し ます。各 プロセスの ID、 現 在 の 状 態 、 および 関 連 する ス タ ッ ク フ レーム情 報 を 示 す 一 覧 を 表 示 し ます。オペレーテ ィ ングシステム (OS) のログメ ッセージのキャプチャとコンソールへの 出 力 を 制 御 します。接 続 後 に ロー ド さ れた OS モジュールは、 [Modules] ビューに 表 示 されます。3.9.3 関 連 項 目タスク• 『ARM ® DS-5 :デバッガの 使 用 』:— Linux カーネルへの 接 続 の 設 定 (3-8 ページ)— 第 4 章 実 行 制 御— 第 5 章 ターゲッ トの 検 査 .概 念• 『ARM ® DS-5 :デバッガの 使 用 』:— Linux カーネルのデバッ グについて (6-11 ページ)— Linux カーネルモジュールのデバッ グについて (6-13 ページ)— ARM Linux の 問 題 と 解 決 法 (12-2 ページ)— ターゲ ッ ト 接 続 の 問 題 と 解 決 法 (12-4 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-23ID 111511Non-Confidential

ARM DS-5 チュート リアル参 照• サンプル (4-7 ページ)• 『ARM ® DS-5 :デバッガの 使 用 』:— [Breakpoints] ビュー (11-9 ページ)— [Commands] ビュー (11-19 ページ)— [Debug Control] ビュー (11-22 ページ)— [Modules] ビュー (11-43 ページ) .• 『ARM ® DS-5 :デバッガコマンドリファレンス』:— info os-log (2-104 ページ)— info os-modules (2-105 ページ)— info os-version (2-106 ページ)— info processes (2-107 ページ)— set os (2-166 ページ)— show os (2-194 ページ) .• 『ARM ® DS-5 : Eclipse の 使 用 』:— [Terminals] ビュー (6-8 ページ) .• DSTREAM ユニッ ト の 接 続 , http://infocenter.arm.com/help/topic/com.arm.doc.dui0481-/I1004916.html.ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-24ID 111511Non-Confidential

ARM DS-5 チュート リアル3.10 ARM Linux 上 で 動 作 するスレ ッ ド アプ リ ケーシ ョ ンのパフ ォーマンス 解 析ARM Streamline は、 グ ラ フ ィ カルなパフ ォーマン ス 解 析 ツールです。 シ ス テム レベル、 プ ロ セス レベル、 およびス レ ッ ド レベルで 問 題 のあ る 領 域 に 加 、 アプ リ ケーシ ョ ンのホ ッ ト ス ポ ッ ト を 強 調 表 示 し た タ イ ム ラ イ ン と 解 析 レポー ト を 出 力 し ます。3.10.1 前 提 条 件解 析 データ を キ ャ プチャする には、 その 前 に 以 下 の 条 件 を 満 た し てい る 必 要 があ ります。1. ターゲッ トの IP アドレスがあらかじめ 取 得 されているこ と。 これには、 Linuxコンソールで ifconfig アプ リ ケーシ ョ ンを 使 用 します。 IP アドレスは、 inetaddr で 指 定 されています。2. ARM Linux カーネルが Streamline 用 に 設 定 されている こ と。3. スレッ ドアプリケーショ ンがターゲッ トにコピーされているこ と。4. gator デーモンが ターゲ ッ ト 上 で 動 作 し てい る こ と 。3.10.2 手 順データ を キ ャ プチ ャする には1. Eclipse を 起 動 し ます。2. ターミナルシェルを 起 動 し、 ターゲッ トに 接 続 します。 これにはリモートシステムエクスプローラ (RSE) に 付 属 の ター ミ ナルシ ェルを 使 用 する こ と がで きます。3. ターミナルシェルで、threads アプ リ ケーシ ョ ンをコピーしたディ レ ク ト リ に 移動 します。4. C/C++ パースペク テ ィ ブで 作 業 し ている こ と を 確 認 し ます。5. ターゲッ ト 接 続 を 作 成 します。a. Streamline キャプチャデータビューで、 [Change capture options...] ツールバーア イ コ ン を 選 択 し ます。b. [Name] フ ィ ール ド に、 新 しいコ ンフ ィ ギ ュ レーシ ョ ンの 適 切 な 名 前 を 入力 します。c. [Connection] パネルに、 ホス ト ワークステーシ ョ ンと ターゲッ ト 間 の 接続 に 使 用 する、 IP ア ド レ ス ま たは 名 前 と それに 対 応 する ポー ト 番 号 を 入力 します。d. [Capture] パネルで、 デフ ォル ト の 設 定 をそのま ま 使 用 する か、 必 要 に 応じてカスタマイズします。e. [Program Images] パネルで[Add Program...] または [Add program fromWorkspace...] を ク リ ッ ク して、 アプ リ ケーシ ョ ンイ メージを 選 択 するためのダイアログボッ ク スを 表 示 し ます。f. スレッドアプリケーションに 移 動 し、 [Open] または [OK] をクリ ックしてダイアログボックスを 閉 じます。g. [Apply] を ク リ ッ ク し て 設 定 を 保 存 し ます。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-25ID 111511Non-Confidential

ARM DS-5 チュート リアルh. データ のキ ャ プチ ャ を 開 始 するには、 Streamline キャプチャデータビューで [Start capture] ツールバーアイ コンをク リ ッ ク します。6. ター ミ ナルシ ェルで、 以 下 の コ マン ド を 実 行 し て ス レ ッ ド アプ リ ケーシ ョ ン を実 行 し ます。./threads7. ス レ ッ ド アプ リ ケーシ ョ ンの 実 行 が 終 了 し た 後 、 Eclipse の C/C++ パースペクティブに 戻 ります。8. Streamline キャプチャデータビューで、 レポートをク リ ックしてグラフィカルデータ を 解 析 し ます。図 3-13 Streamline キャプチャデータファイルデータ のキ ャ プチ ャ を 停 止 する と 、 Streamline 解 析 データ フ ァ イルが 自 動 的 に 生 成 されます。 ま た 既 存 の 解 析 フ ァ イ ルをダブル ク リ ッ ク し てエデ ィ に 表 示 する こ と も できます。図 3-14 Streamline 解 析 デー タ フ ァ イル3.10.3 関 連 項 目概 念• ARM Streamline パフォーマンスアナラ イザについて (2-8 ページ) .参 照• マニュアル (4-6 ページ)• サンプル (4-7 ページ)• 『ARM ® DS-5 : Eclipse の 使 用 』:— [Terminals] ビュー (6-8 ページ)• ARM ® DS-5 ARM Streamline の 使 用 ,http://infocenter.arm.com/help/topic/com.arm.doc.dui0482-/index.html。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-26ID 111511Non-Confidential

ARM DS-5 チュート リアル3.11 Android ネイティブ C/C++ アプリケーシ ョ ンおよびライブラリのデバッグこのチュート リアルでは、 NDK (Native Development Kit) に 付 属 の hello-neon アプ リケーシ ョ ンのデバ ッ グ 方 法 について 説 明 し ます。 こ こ では、 ターゲ ッ ト と し てAndroid SDK Platform 2.2 と Android エミュレータを 使 用 します。Android ツールのイ ン ス ト ール 方 法 は、 こ こ では 説 明 し ません。 詳 細 については、Android Developers の Web サイ ト を 参 照 してください。注Android 開 発 キットを 使 用 する 場 合 は、それらの 契 約 条 件 に 従 います。3.11.1 前 提 条 件ネイティブ C/C++ コードが 含 まれた Android パッケージをデバッグするには、 以 下 の条 件 を 満 たしている 必 要 があ り ます。1. Android SDK (Software Development Kit) がダウンロード されインス ト ールされている こ と。 これによ り、 Java アプ リ ケーシ ョ ンをネイテ ィブの C/C++ コードに 組 み 込 んで、 .apk というファイル 拡 張 子 の 付 いた Android パッケージにビルドするこ とができます。2. Android NDK がダウンロード されてインス ト ールされている こ と。 AndroidNDK は Android SDK のコンパニオンツールです。 アプリケーショ ンで 特 に 高 いパフォーマンスが 求 められる 部 分 を C 言 語 や C++ 言 語 などのネ イ テ ィ ブ コー ドでビルド します。注Windows 環 境 では、 make パッケージを 含 む cygwin をダウンロード してインストールする 必 要 があります。 これにより、 Android NDK の 内 側 でス ク リ プ ト を実 行 で き ます。3. DS-5 の arm_directory\gdbserver\...\android に 用 意 された Android バージ ョ ン をコピーして、 関 連 の Android NDK ツールチェーンディ レ ク ト リ にある gdbserverのバージ ョ ンを 更 新 して く ださい。 このチュー ト リ アルでは、...\toolchains\arm-eabi-4.4.0\prebuilt ディレク ト リを 使 用 します。4. Eclipse plug-in for Android をセッ ト アップします。a. Eclipse を 起 動 し ます。b. ADT (Android Development Tools) Eclipse プラグインをインス トールします。c. [Window] →[Preferences] → [Android] を 選 択 し、 [Browse...] をクリックして Android SDK のインス トール 先 を 設 定 します。d. [Window] →[Android SDK と AVD マネージャ] を 選 択 し、 [AndroidSDK and AVD Manager] ダイアログボックスを 開 きます。e. [Available packages] グループを 展 開 し、 必 要 に 応 じ て SDK プラッ トフォームを 追 加 します。 例 えば、 Android SDK Platform Android 2.2 を 使 用します。f. 新 しい AVD (Android Virtual Device) を 作 成 し ます。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-27ID 111511Non-Confidential

ARM DS-5 チュート リアル5. Android NDK スクリプトファイル ndk-gdb で、 デバッ グに DS-5 を 使 用 する よ うに 編 集 し ます。 Android NDK には、 デバッ ガを 起 動 する 前 に、 ターゲ ッ ト でgdbserver とアプリケーションを 実 行 するスクリプトファイルが 含 まれています。 こ のス ク リ プ ト フ ァ イルは、 デフ ォル ト ではデバ ッ グに DS-5 を 使 用 し ません。 こ の 動 作 を 変 更 する には、 以 下 に 示 すよ う に 最 終 行 を コ メ ン ト ア ウ ト する 必 要 があ り ます。#$GDBCLIENT -x `native_path $GDBSETUP`3.11.2 手 順アプ リ ケーシ ョ ンをデバッグするには1. Android NDK に 付 属 のス ク リ プ ト を 使 用 し て、 hello-neon ソースファイルをデバッグ 情 報 と ともにビルドします。 このチュート リアルでは、...\toolchains\arm-eabi-4.4.0\prebuilt ディレク ト リを 使 用 します。 以 下 に 例 を示 します。./ndk-build -C samples/hello-neon NDK_TOOLCHAIN=arm-eabi-4.4.0 NDK_DEBUG=12. Eclipse を 起 動 し ます。3. 新 しい Android プロジェク ト を 作 成 します。a. [File] → [New] →[Project...] を 選 択 し ます。b. [Android] グループを 展 開 し、 [Android Project] を 選 択 します。c. [Next] をク リ ックします。d. 適 切 なプロジェクト 名 を 入 力 します。 例 えば、「HelloNeon」 と 指 定 します。e. [Create project from your existing source] を 選 択 し、hello-neon フォルダを見 つけ ます。f. 表 示 さ れるデフ ォル ト のデ ィ レ ク ト リ にプ ロ ジ ェ ク ト を 作 成 する 場 合 は、[Use default location] オプシ ョ ン をオンのま まに し ます。 ま たは、 こ のオプシ ョ ンをオフにして、 適 切 なプロジェ ク ト ディ レ ク ト リ を 参 照 します。g. 必 要 な ビル ド ターゲ ッ ト を 選 択 し ます。 例 えば、 [Android 2.2] を 選 択 します。h. 適 切 なアプ リ ケーシ ョ ン 名 を 入 力 し ます。 例 えば、 「Hello, Neon」 と 指 定します。i. 適 切 なパ ッ ケージ 名 を 入 力 し ます。 例 えば、 「com.example.neon」 と 指 定 します。j. 適 切 なアクテ ィ ビテ ィ 名 を 入 力 します。 例 えば、 「HelloNeon」 と 指 定 します。k. [Finish] をクリ ックします。4. アプ リ ケーシ ョ ンが、 デバッグ 情 報 と と もにビルド される こ と を 確 認 して くださ い。 こ れは 以 下 の 方 法 で 行 います。a. AndroidManifest.xml ファイルを 開 きます。b. [Application] タブをク リ ッ クします。c. [Debuggable] フ ィールドで、 [true] を 選 択 し ます。d. 変 更 を 保 存 してフ ァ イルを 閉 じ ます。5. Android プロジェク ト をク リーンアップしてリ ビルドします。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-28ID 111511Non-Confidential

ARM DS-5 チュート リアル6. こ のアプ リ ケーシ ョ ンが 既 に ターゲ ッ ト に イ ン ス ト ール さ れてい る 場 合 は、 アン イ ン ス ト ールする 必 要 があ り ます。 以 下 に 例 を 示 し ます。path\adb uninstall com.example.neon7. アプ リ ケーシ ョ ンをインス ト ールし ます。 以 下 に 例 を 示 し ます。path\adb install samples/hello-neon/bin/HelloNeon.apk8. ndk-gdb スクリプトを 実 行 してアプリケーションと gdbserver を 起 動 し ます。 以下 に 例 を 示 し ます。./ndk-gdb --project=samples/hello-neon --verbose --port=5000 --start --force--adb=adbス ク リ プ ト フ ァ イル と コマン ド ラ イ ンオプシ ョ ンの 使 用 方 法 の 詳 細 については、 Android NDK のマニュアルを 参 照 して く ださい。9. gdbserver TCP 接 続 を 使 用 し て、 DS-5 をアプ リ ケーシ ョ ンに 接 続 し ます。a. [Run] メニューから [Debug Configurations...] を 選 択 し ます。b. コンフィギュレーションツリーから [DS-5 Debugger] を 選 択 し、 [New]を ク リ ッ ク し て 新 し い コ ン フ ィ ギ ュ レーシ ョ ン を 作 成 し ます。 ま たは、 既存 の DS-5 デバ ッ ガ コ ン フ ィ ギ ュ レーシ ョ ン を 選 択 し、 ツールバーで[Duplicate] をクリ ックします。c. [Name] フ ィ ール ド に、 新 しいコ ンフ ィ ギ ュ レーシ ョ ンの 適 切 な 名 前 を 入力 します。d. [Connection] タブを ク リ ッ ク し、 以 下 の 図 に 示 すよ う に、 DS-5 デバ ッ ガターゲッ ト 接 続 を 設 定 します。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-29ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-15 Android アプ リ ケーシ ョ ンの 一 般 的 な 接 続 構 成e. [Files] タブをク リ ッ クし、app_process バイナリ ファイルと libc.so 共 有 ライブラ リ を 選 択 します。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-30ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-16 Android アプ リ ケーシ ョ ンの 一 般 的 な フ ァ イル 選 択f. [Run] コン ト ロールパネルの [Debugger] タブをク リ ックし、 [Connectonly] を 選 択 し ます。g. [Execute debugger commands] を 選 択 し、 対 応 するテキス ト ボッ ク スに「sharedlibrary」 と 入 力 し てすべての 共 有 ラ イ ブ ラ リ のデバ ッ グ 情 報 をデバッガにロードします。h. [Paths] パネルで、 デバ ッ ガが ソース コー ド を 表 示 する と きに 使 用 する、ホ ス ト 上 の 共 有 ラ イ ブ ラ リ の 検 索 デ ィ レ ク ト リ を 指 定 し ます。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-31ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-17 Android アプ リ ケーシ ョ ンの 一 般 的 なデバ ッ グ 接 続 設 定i. [Debug] をクリ ックしてターゲッ トに 接 続 します。10. デバ ッ グには、 DS-5 デバ ッ グパースペク テ ィ ブが 必 要 です。 [ConfirmPerspective Switch] ダイアログボッ クスが 表 示 された 場 合 は、 [Yes] をクリ ックしてパースペクティブを 切 り 替 えます。11. アプリ ケーシ ョ ンをデバッグする 必 要 に 応 じて、 ブレークポイン ト を 設 定 し、実 行 し、 ス テ ッ プ 実 行 し ます。3.11.3 関 連 項 目参 照• 『ARM ® DS-5 : Eclipse の 使 用 』 :— 新 機 能 の イ ン ス ト ール (3-41 ページ)— プロジェク トへの 新 しいソースファイルの 追 加 (4-16 ページ)— リンクされたリソース (3-11 ページ) .その 他 の 情 報• DS-5 技 術 情 報 記 事 , http://infocenter.arm.com/help/topic/com.arm.doc.faqs/kiXXwMK1Sxk7vf.html• 「Android Developers」 , http://developer.android.com。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-32ID 111511Non-Confidential

ARM DS-5 チュート リアル3.12 DS-5 ラ イ センスの 管 理DS-5 のライセンスは、 Eclipse の [Help] メニューで [ARM License Manager...] を選 択 し て 管 理 する こ と がで き ます。インストールされているライセンスが、[ARM License Manager] ダイアログボックスに 表 示 されます。•図 3-18 ラ イ センスの 表 示 と 編 集• 新 しいライセンスを 請 求 するには、 [Obtain License...] をク リ ックし、 ダイアロ グボ ッ ク スの 手 順 に 従 います。図 3-19 新 し いラ イ センスの 取 得• 新 しいライセンスをインス トールするには、 [Add License...] をクリ ックします。 ラ イ セン ス フ ァ イ ルが、 %APPDATA%\ARM\DS-5\licenses フォルダ (Windows の場 合 ) および $HOME/.ds-5/licenses フォルダ (Linux の 場 合 ) にコ ピーされます。サーバ ラ イ セン スは、 ホ ス ト と ポー ト のフ ィ ール ド に 別 々に 入 力 する こ と も、[Host] フ ィールドに port@host と い う 形 式 で 完 全 な 文 字 列 を 貼 り 付 け る こ と もできます。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-33ID 111511Non-Confidential

ARM DS-5 チュート リアル図 3-20 新 し いラ イ センスの 追 加• ライセンスをアンインストールし、 ファイルを DS-5 ライセンスフォルダから削 除 する には、 [Delete License] をク リ ックします。3.12.1 関 連 項 目参 照• ラ イ セン スおよび 製 品 ア ッ プデー ト (4-5 ページ)• ARM ® DS-5 ライセンス 管 理 ガイド ,http://infocenter.arm.com/help/topic/com.arm.doc.dui0577-/index.html。その 他 の 情 報• ARM Self-Service Portal, http://silver.arm.com/ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 3-34ID 111511Non-Confidential

第 4 章ARM DS-5 のインス トールおよびサンプル以 下 の 各 ト ピ ッ ク では、 イ ン ス ト ールおよびラ イセン ス 要 件 について 説 明 し ます。また ARM ® DS-5 に 付 属 のマニュ アル と サンプルについて も 説 明 し ます。参 照• システム 要 件 (4-2 ページ)• インストールディレク ト リ (4-4 ページ)• ラ イ セン スおよび 製 品 ア ッ プデー ト (4-5 ページ)• マニュアル (4-6 ページ)• サンプル (4-7 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 4-1ID 111511Non-Confidential

ARM DS-5 のインス トールおよびサンプル4.1 システム 要 件DS-5 を イ ン ス ト ールし て 使 用 する には、 少 な く と も 2GHz のデュ アルコ アプロセ ッサ (またはそれと 同 等 のプロセッサ) および 2GB の RAM と い う 仕 様 満 たす 必 要 があ り ます。 大 き な イ メ ージをデバ ッ グする 場 合 、 シ ミ ュ レー ト さ れた 大 き な メ モ リマ ッ プを 持 つモデルを 使 用 する 場 合 、 ま たは ARM Streamline パフォーマンスアナライザを 使 用 する 場 合 は、 4GB 以 上 の RAM を 使 用 してパフォーマンスを 改 善 する こ とが 推 奨 されます。フルインス トールには、 約 1.5 GB のハー ド デ ィ ス ク の 空 き 領 域 が 必 要 です。4.1.1 サポー ト されているプ ラ ッ ト フ ォームDS-5 は、 特 に 断 り のない 限 り 、 以 下 のプ ラ ッ ト フ ォーム (および Service Pack) の 32ビッ トおよび 64 ビッ トバージョンでサポートされています。• Windows XP Professional Service Pack 3 (32 ビットのみ)• Windows 7 Professional• Windows 7 Enterprise• Windows Server 2003 (ARM コンパイラのみ)• Windows Server 2008 (ARM コンパイラのみ)• Red Hat Enterprise Linux 5 Desktop および Workstation オプシ ョ ン、 Standard4.1.2 DS-5 要 件Android アプ リ ケーシ ョ ンおよび ARM Linux アプ リ ケーシ ョ ンのデバッグには、 ターゲッ ト 上 で gdbserver を 使 用 で き る 必 要 があ り ます。 推 奨 さ れる gdbserver のバージ ョンは 7.0 です。 DS-5 の install_directory\arm ディレク ト リには、 ARMv4T 、ARMv5T 、および Thumb ® -2 アーキテ ク チャ 用 にビル ド さ れた 実 行 可 能 フ ァ イルが付 属 し ています。 gdbserver 6.8 よ り 前 のバージ ョ ン を 使 用 し た 場 合 、 DS-5 デバ ッ ガが 信 頼 でき るマルチス レ ッ ド のデバッ グをサポー ト でき ません。DS-5 デバ ッ ガは、 ARM Linux カーネルバージ ョ ン 2.6.28 ~ 2.6.36 のデバッ グをサポー ト し ます。 その 他 のカーネルバージ ョ ンで も 動 作 する 可 能 性 はあ り ますが、 動作 確 認 は さ れていません。 ARM Streamline パフォーマンスアナラ イザで 使 用 できるARM Linux カーネルのバージ ョ ンは、 2.6.32 以 上 です。 対 称 型 マルチプ ロ セシング(SMP) システムでアプリ ケーシ ョ ンをデバッグするには、 バージ ョ ン 2.6.36 以 降 のARM Linux カーネルが 必 要 です。ARM Linux カーネルおよびベア メ タルのデバッ グには、 DSTREAM または RVI ユニッ ト と 最 新 のファームウェアを 使 用 して DS-5 ターゲ ッ ト を 接 続 する 必 要 あ り ます。 デバ ッ グハー ド ウ ェ ア 設 定 ユーテ ィ リ テ ィ を 使 用 し て、 現 在 イ ン ス ト ール さ れているファームウェアのバージ ョ ンを 確 認 し、 必 要 に 応 じて 更 新 してください。 更新 されたファームウェアは、install_directory/sw/debughw/firmware ディレク ト リにあります。4.1.3 関 連 項 目参 照• デバ ッ グハー ド ウ ェ ア 設 定 ユーテ ィ リ テ ィ について (2-9 ページ)• インストールディレク ト リ (4-4 ページ)• ラ イ セン スおよび 製 品 ア ッ プデー ト (4-5 ページ)ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 4-2ID 111511Non-Confidential

ARM DS-5 のインス トールおよびサンプル• ARM ® DSTREAM :ハードウェアの 設 定 ,http://infocenter.arm.com/help/topic/com.arm.doc.dui0481-/• ARM ® の RVI と RVT :ハードウェアの 設 定 , http://infocenter.arm.com/help/topic/dui0515-/• DS-5 技 術 情 報 記 事 , http://infocenter.arm.com/help/topic/com.arm.doc.faqs/kiXXwMK1Sxk7vf.html.ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 4-3ID 111511Non-Confidential

ARM DS-5 のインス トールおよびサンプル4.2 インストールディレクト リサンプルコードやマニュアルを 含 んださまざまなディ レク ト リ が DS-5 にインス トールされています。 DS-5 のマニュアルでは、 必 要 に 応 じてこれらディ レ ク ト リ を 参 照しています。イ ン ス ト ール、 サンプル、 およびマニュ アルの 主 なデ ィ レ ク ト リ を、 以 下 の 表 に 示します。 表 に 示 した install_directory は、 デフ ォル ト のイ ン ス ト ールデ ィ レ ク ト リ です。 別 の イ ン ス ト ールデ ィ レ ク ト リ を 指 定 し た 場 合 、 パス 名 は 選 択 し たデ ィ レ ク トリに 対 応 します。ディレクトリ Windows Linuxinstall_directory C:\Program Files\DS-5 ~/ds-5表 4-1 DS-5 のデフ ォル ト デ ィ レ ク ト リarm_directory install_directory\arm\... install_directory/arm/...examples_directory install_directory\examples\... install_directory/examples/...tools_directory install_directory\bin\... install_directory/bin/...documents_directory install_directory\documents\... install_directory/documents/...4.2.1 関 連 項 目参 照• マニュアル (4-6 ページ)• サンプル (4-7 ページ) .ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 4-4ID 111511Non-Confidential

ARM DS-5 のインス トールおよびサンプル4.3 ライセンスおよび 製 品 アップデートDS-5 は ラ イ セン ス 供 与 に よ って 提 供 さ れる 製 品 であ り 、 FLEXnet ライセンス 管 理 ソフトウェアを 使 用 して、 特 定 の Edition に 対 応 する 機 能 が 有 効 にな り ます。表 4-2 DS-5 の EditionApplicationEditionLinux EditionProfessionalEditionEclipse for DS-5 X X XGNU コンパイルツール X X XLinux アプ リ ケーシ ョ ンのデバッグ X X XARM Streamline パフォーマンスアナラ イザ X X XCortex -A8 リアルタイムシステムモデル X X Xカーネル 空 間 デバ ッ グおよび ト レース X Xベア メ タルデバッ グ と ト レース X XARM コンパイラツールチェーンXラ イ セン スの 請 求 、 ま たは 最 新 の DS-5 製 品 情 報 およびア ッ プデー ト の 入 手 は、 ARMSelf-Service Portal にアクセスして ください。ライセンス 管 理 ソフトウェアにアクセスするには、Eclipse for DS-5 で、 [Help] メニューの [ARM License Manager...] を 選 択 し ます。4.3.1 関 連 項 目タスク• DS-5 ライセンスの 管 理 (3-33 ページ) .参 照• ARM ® DS-5 ライセンス 管 理 ガイド ,http://infocenter.arm.com/help/topic/com.arm.doc.dui0577-/index.htmlその 他 の 情 報• ARM Self-Service Portal, http://silver.arm.com/ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 4-5ID 111511Non-Confidential

ARM DS-5 のインス トールおよびサンプル4.4 マニュアルDS-5 の 付 属 マニュ アルは 以 下 のもので 構 成 されています。• 『ARM ® DS-5 : DS-5 スタートガイド』 ( 本 書 )• 『ARM ® DS-5 : デバ ッ ガの 使 用 』• 『ARM ® DS-5 :デバッガコマンドリファレンス』• 『ARM ® DS-5 : Eclipse の 使 用 』• 『ARM ® DSTREAM : ハー ド ウ ェ アの 設 定 』• 『ARM ® DSTREAM : システムおよびインタフェースデザイン リ ファレンス』• 『ARM ® の RVI と RVT : ハー ド ウ ェ アの 設 定 』• 『ARM ® の RVI と RVT :システムおよびインタフェースデザインリファレンス』• 『ARM ® の DSTREAM と RVI :デバッグハードウェア 設 定 ユーティリティの 使用 』• 『ARM ® Streamline Performance Analyzer Using ARM Streamline』DS-5 のマニュアルにアクセスするには1. Eclipse を 起 動 し ます。• Windows 環 境 では、 [スタート] → [すべてのプログラム] → [ARMDS-5] → [Eclipse for DS-5] を 選 択 し ます。• Linux 環 境 では、 Unix bash シェルで 「eclipse」 と 入 力 します。2. [Help] メニューから [Help Contents] を 選 択 します。サンプルの 使 用 方 法 に 関 するマニュアルは、 examples_directory\docs にあ り ます。GNU コンパイルツールの 使 用 方 法 に 関 するマニュアルは、documents_directory\gcc にあります。4.4.1 関 連 項 目参 照• インストールディレク ト リ (4-4 ページ)• サンプル (4-7 ページ)• ARM Web サイ トに 関 するマニュアル ,http://infocenter.arm.com/help/topic/com.arm.doc.subset.swdev.ds5。ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 4-6ID 111511Non-Confidential

ARM DS-5 のインス トールおよびサンプル4.5 サンプルDS-5 には、 使 用 を 開 始 する 上 で 役 立 つサンプルが 用 意 さ れています。• ベア メ タルソ フ ト ウ ェア 開 発 のサンプル。 armcc マネージビルダ、 ベア メ タルデバ ッ グ、 パフ ォーマン スの 最 適 化 、 および 測 定 方 法 を 示 し ます。 フ ァ イルは、アーカイブフ ァ イル examples_directory\Bare-metal_examples.zip にあ り ます。• サポー ト されているボードのベア メ タルのサンプルプロジェ ク ト 。 オンチップRAM へのボー ド 接 続 および 基 本 的 なデバ ッ グ を 示 し ます。 フ ァ イル、 アーカイブファイル examples_directory\Bare-metal_boards_examples.zip にあ り ます。• ARM Linux のサンプル。 単 純 な C/C++ コンソールアプリケーション、 共 有 ライブラ リ、 およびマルチスレッ ドアプリ ケーシ ョ ンのビルド、 デバッグ、 およびパフォーマンス 解 析 を 示 します。 これらのサンプルは、 ARM Linux をブートする よ う に 事 前 設 定 さ れた リアルタイムシステムモデル (RTSM) の 上 で 動 作 します。 ファ イルは、 アーカイブファ イル examples_directory\Linux_examples.zip にあります。• サンプルを 実 行 するためのソースフ ァ イル、 ラ イブラ リ、 およびビルド 済 みイメージが 入 ったオプションのパッケージ。 これらは、 ARM Web サイ ト DS-5 のダウンロードページ ま たは DS-5 インストールメディアからダウンロードできます。— ARM Linux サンプルの 再 ビルドに 使 用 されるヘッダファ イルと ラ イブラ リを 提 供 する Linux ディスト リビューションプロジェク ト。 ファイルは、アーイブフ ァ イル examples_directory\Linux_distribution_example.zip にあ ります。— DS-5 向 けに 設 定 されたビーグルボード 用 の Linux SD カード イ メージ。ファイルは、 アーカイブファイル examples_directory\beagle.zip にあ り ます。— DS-5 向 けに 設 定 された、 BeagleBoard-xM 用 の Linux SD カード イ メージ。ファイルは、 アーカイブファイル examples_directory\beaglexm.zip にあ り ます。これらのサンプルを 作 業 ディレク ト リに 抽 出 し、 コマンド ラインからビルドするか、インポート 用 ウィザードを 使 用 して Eclipse にインポート します。 DS-5 で 提 供 されるすべてのサンプルに 事 前 設 定 の Eclipse 起 動 ス ク リ プ ト が 用 意 さ れてい る ので、 ターゲッ ト 上 でサンプルコードのロード とデバッグが 容 易 に 実 行 できます。各 サンプルには、 サンプルコー ド のビル ド 、 実 行 、 デバ ッ グの 手 順 に 関 する 説 明 が用 意 さ れています。 説 明 には、 メ イ ン イ ンデ ッ ク ス であ るexamples_directory\docs\index.html. からアクセスできます。4.5.1 関 連 項 目タスク• Eclipse へのサンプルプロ ジェ ク ト のイ ンポー ト (3-2 ページ)概 念• リアルタイムシステムモデルについて (2-5 ページ) .参 照• マニュアル (4-6 ページ)ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 4-7ID 111511Non-Confidential

ARM DS-5 のインス トールおよびサンプル• インストールディレク ト リ (4-4 ページ)• 『Eclipse の 使 用 』 :— Welcome 画 面 の 使 用 (3-4 ページ) .その 他 の 情 報• ARM Development Studio 5 (DS-5 ) , http://www.arm.com/products/tools/software-tools/ds-5ARM DUI 0478GJ Copyright © 2010, 2011 ARM. All rights reserved. 4-8ID 111511Non-Confidential