ホーム > 製品情報 > Bleuet de BREW > ユーザーズマニュアル

Bleuet de BREW ユーザーズマニュアル

目次

  1. Bleuet de BREW とは
  2. 動作環境
  3. プロファイルの方法
    1. MOD ファイルのビルド
    2. ログファイルの取得
    3. ログファイルの解析
  4. リファレンス
    1. 操作方法
    2. エラーメッセージ

1. Bleuet de BREW とは

Bleuet de BREW ( ブルーエ・ド・ブリュー ) は、C / C++ 言語で記述されたBREW アプリを構成する、 任意のモジュールについて実行時間とメモリ使用量を計測し、 その結果を GUI で表示してくれる BREW プロファイラです。

2. 動作環境

Windows 環境 Windows XP / 2000
BREW SDK 1.X / 2.X / 3.X
ARM コンパイラ RVCT for BREW 1.2
必須ソフトウェア BREW AppLoader
推奨ソフトウェア Perl ( ActivePerl build 5.6.1.638 推奨)

※ Perl は MOD ファイルの自動転送に必要です。BREW AppLoader で手動転送することも可能です。

3. プロファイルの方法

Bleuet de BREW のフォルダに、ソフィア・クレイドル社から発行されたライセンスファイル licence.dat を格納してから、Bleuet.exe を起動します。

3.1 MOD ファイルのビルド

3.1.1 MOD ファイルの端末への自動転送の設定

メニューバーの [プロジェクト] → [設定] から、[Perl で自動的にコピーする] をチェックし、端末を接続する正しい [COM ポート]を設定します。ただし、Perl がインストールされていることが前提条件になります。

perl自動設定

3.1.2. ELF ファイルの選択

Build pame[ビルド] タブを選択し、ビルド画面を表示します。

[ELF ファイル] 選択ダイアログで、プロファイルするアプリの ELF ファイルを選択します。

ELF ファイルの生成方法は、ARM コンパイラのマニュアルをご覧ください。

3.1.3. プロファイルの種類の選択

[速度][メモリ] の 2 種類があります。

3.1.4. プロファイルする関数の選択

[プロファイル可能な関数:] からプロファイルする関数を選びます。関数を検索することも可能です。

 プロファイル可能な全ての関数を[プロファイルする関数:]に移動します。

 [プロファイルする関数:] の全ての関数を、元のボックスに戻します。

 選択した関数を[プロファイルする関数:]に移動します。

 [プロファイルする関数:] で選択した関数を、元のボックスに戻します。

[VTABLES と veneers] には、選択した ELF ファイル内の VTABLE と、veneer 名が表示されます。

※1. Thumb コードや、単一の機械語で構成される関数など、プロファイルできない関数は、 [プロファイル不能な関数] に表示されます。

※2. 選択する関数が増えると、それだけプロファイルに多くの時間を要します。時間がかかる場合は、プロファイルする関数を減らします。

3.1.5. ビルド

build

プロファイルする関数を選択したら、[ビルド] ボタンを押して、新しい MOD ファイルを生成し、ELF ファイルと同じフォルダに保存します。

[出力メッセージ] ウィンドウが表示され、デコードの状況が表示されます。[プロファイリング結果] タブを選ぶと、このウィンドウは自動的に閉じます。

出力メッセージ

Bleuet de BREW フォルダに生成される [functions.txt] は、プロファイルする関数名と ID が格納されるファイルで、プロファイル結果の表示に使われます。

3.2. ログファイルの取得

ログファイルの取得に必要なものは以下の通りです。

  1. MOD ファイルの実行に必要な MIF ファイルと SIG ファイル
  2. 開発用 BREW 携帯電話とケーブル
  3. BREW AppLoader

3.2.1. MOD ファイルの転送

[Perl で自動的にコピーする]ON の場合、ダイアログが表示されてから MOD ファイルは自動転送されます。 OFF の場合は、BREW AppLoader を使って手動転送します。

MIF ファイルと SIG ファイルは BREW AppLoader を使って手動転送します。

BREW AppLoader

3.2.2. ログファイル

Bleuet de BREW は、プロファイリング情報を生成するために、プロファイルする全て関数の最初と最後に ILOGGER_Printf コードを挿入します。

プロファイリング情報は、端末のアプリケーションフォルダ内の Bleuet.log に保存されます。プロファイルの結果を表示するには、端末の Bleuet.log を PC に転送する必要があります。

不完全なログ情報は記録から自動的に削除されます。

フィルタリングされていないログ情報の出力は、[関数の呼び出し順表示] ボタンを押すと表示されます。

3.3. ログファイルの解析

Result Pane [プロファイル結果] タブを選ぶと、プロファイル結果が表示されます。

3.3.1. ログファイルの選択

[ログファイル]でログファイルを選択すると、プロファイル結果が表示されます。

プロファイル結果は、MOD ファイルのビルド時に生成される [functions.txt] を参照するので、直近にビルドした MOD ファイルだけがプロファイルの対象となります。

3.3.2. プロファイル結果 : [速度]

左上ツリー表示ボックス

[プロファイルする関数] として選択した関数の階層構造が表示されます。

プロファイル結果 グラフ

関数の処理時間の全体に占める割合が表示されます。

テーブル

3.3.3. プロファイル結果 : [メモリ]

左上ツリー表示ボックス

[プロファイルする関数] として選択した関数の階層構造が表示されます。

プロファイル結果 グラフ

関数のメモリ使用量の全体に占める割合が表示されます。

テーブル

4. リファレンス

4.1 操作方法

menu

4.1.1. メニューバー

ファイル

ファイル

project

プロジェクト

[設定] : MOD ファイルの携帯端末への自動転送の設定 ( 携帯端末が接続される COM ポートの設定も必要 )

perl_copy

ヘルプ

help

4.1.2. ビルド パネル

build ELF ファイル プロファイルの種類 プロファイル可能な関数 プロファイルする関数 プロファイル可能な関数 プロファイルする関数 ロードされた関数(合計) Thumb VTABLES プロファイルする関数(合計) プロファイル不能な関数 VTABLES と veneers ビルド 閉じる

4.1.3. プロファイル結果 パネル

result ログファイル プロファイルの種類 プロファイル済み関数 プロファイル結果 関数の呼び出し順 閉じる テーブル

4.2 エラーメッセージ