こなた

Konata は、Onikiri2-Kanata/Gem5-O3PipeView 形式の命令パイプラインビジュアライザーです。
ASPLOS 2018 学習 gem5 チュートリアルプレゼンテーションはこちら
ここでは、Onikiri2-Kanata 形式について説明します。 Gem5-O3PipeView よりも詳細なパイプラインの動作を表現できます。

インストール

Konata を起動するには 2 つの方法があります。事前に構築されたバイナリの起動に失敗した場合は、2 番目の方法を試してください。

アーカイブを抽出し、実行可能ファイル (konata.exe または konata) を起動します。
- 事前に構築されたバイナリはここから入手できます。
このリポジトリから起動します。
1. https://nodejs.orgからnode.jsをインストールします
2. このリポジトリのクローンを作成します。
3. install.bat (Windows) または install.sh (Linux/MacOS) を起動します。
4. konata.vbs (Windows) または konata.sh (Linux/MacOS) から Konata を起動します。

使用法

基本

O3 CPU モデルを使用して gem5 からトレースログを生成する

以下のフラグを指定して gem5 を実行します。
この例は http://www.m5sim.org/Visualization からのものです。

 $ ./build/ARM/gem5.opt 
    --debug-flags=O3PipeView 
    --debug-start=<first tick of interest> 
    --debug-file=trace.out 
    configs/example/se.py 
    --cpu-type=detailed 
    --caches -c <path to binary> 
    -m <last cycle of interest>

生成された「trace.out」をKonataにロードします。
- ウィンドウ内のメニューから、またはドラッグ＆ドロップを使用して
以下のようにO3CPUAllとO3PipeViewを使用すると、Konata はより詳細な CPU ログを表示し、命令間の依存関係を視覚化します。
```
 --debug-flags=O3PipeView,O3CPUAll
```

キーボード

マウスホイールを上、キーを上: 上にスクロール
マウスホイールを下、キーを下: 下にスクロールします
Ctrl + マウスホイールを上に、「+」キー、Ctrl + 上にキー: ズームイン
Ctrl + マウスホイールを下、キー「-」、Ctrl + キーを下: ズームアウト
ctrl + f、F3、shift+F3: 文字列を検索します
F1、ctrl+shift+p: コマンドパレットを開く

ヒント

右側のペインでパイプラインを見逃した場合は、右クリックメニューの「位置の調整」をクリックしてパイプラインに移動できます。
次のように 2 つのトレースを視覚的に比較できます。
1. 2 つのトレースファイルをロードする
2. 右クリックして「学校の同期」と「透過モード」を選択します
3. 右クリックして配色を選択します
4. 別のタブに移動し、透明モードで位置を調整します
Konata を起動できない場合は、次のランタイムをインストールしてみてください (または、同じランタイムを使用しているため、最新の Google Chrome をインストールしてみてください)。
```
 sudo apt install 
    libgconf-2-4 
    libgtk-3-0 
    libxss1 
    libnss3 
    libasound2 
    libx11-xcb1 
    libcanberra-gtk3-module 
    libgbm-dev
```
O3CPUAllモードでは、Konata は[sn:<serial number>]を追跡することで、trace.out の各行を各命令に関連付けます。上記のシリアル情報でカスタムログを出力すると、Konata はカスタムログを表示します。

発達

次のように依存ランタイムをインストールするか、ソースツリーに含まれる Dockerfile を使用します

 # Install node.js/npm
sudo apt install nodejs

# Install electron/electron-packager
# Since electron is huge, they are installed globally.
npm -g install electron
npm -g install electron-packager

# Run and build
make init   # Setup libraries
make        # Run Konata
make pack   # Build & pack Konata for Windows/Linux/Mac

ライセンス

このアプリケーションは 3 条項 BSD ライセンスに基づいてリリースされています。LICENSE.md を参照してください。このアプリケーションには、THIRD-PARTY-LICENSES.md に示されているライセンスに従って、ELECTRON と多くのサードパーティパッケージがバンドルされています。

拡大する

追加情報