T-Kernel 2.0 Getting Started T-Engine フォーラム ダウンロード T-Engine フォーラムの web ページから T-Kernel 2.0 Software Package をダウンロード 必要なソフトウェアや開発環境が全て含まれている 2 Copyright 2011 by T-Engine Forum, All Rights Reserved. 1
ReadMe.txt を確認 T-Kernel 2.0 Software Package を展開 T-Kernel2.0/ReadMe.txt に従ってインストールを開始 ReadMe.txt に従って以下をインストール Cygwin + gcc gcc_setup_guide_cygwin.txt Eclipse eclipse_setup_guide.txt eclipse_guide.txt 事前準備 Windows の環境変数の HOME を削除 Cygwin の環境変数の HOME との競合により Eclipse が正常に動作しない場合がある 3 T-Kernel 2.0 Software Package を展開 1 4 Copyright 2011 by T-Engine Forum, All Rights Reserved. 2
T-Kernel 2.0 Software Package を展開 2 5 T-Kernel 2.0 Software Package を展開 3 6 Copyright 2011 by T-Engine Forum, All Rights Reserved. 3
Cygwin のインストール 7 Cygwin のインストール 1. 管理者の権限のあるユーザとして Windows にログオン 2. develop cygwin_d-1.7.7-1.zip を C: に保存 3. develop cygwin_d-1.7.7-1.zip を展開 4. 展開したディレクトリ中のインストーラ setup.exe を起動 5. [ 次へ (N)> ] 6. [ Install from Local Directory ] を選択して [ 次へ (N)> ] 7. Cygwin におけるルートディレクトリを指定 (C: cygwin) [ Install For ] は All Users を選択 8. [ 次へ (N)> ] 9. [ Local Package Directory ] は cygwin_d-1.7.7-1.zip を展開したディレクトリを指定 10. [ 次へ (N)> ] 11. インストールパッケージの選択画面が表示される 12. [ All () Default ] の Default をクリックして [ Install ] に変更 13. [ 次へ (N)> ] 14. インストールが開始される 15. [ 完了 ] 8 Copyright 2011 by T-Engine Forum, All Rights Reserved. 4
Cygwin のインストール 1 9 Cygwin のインストール 2 10 Copyright 2011 by T-Engine Forum, All Rights Reserved. 5
Cygwin のインストール 3 11 Cygwin のインストール 4 12 Copyright 2011 by T-Engine Forum, All Rights Reserved. 6
Cygwin のインストール 5 13 Cygwin のインストール 6 14 Copyright 2011 by T-Engine Forum, All Rights Reserved. 7
Cygwin のインストール 7 15 Cygwin のインストール 8 16 Copyright 2011 by T-Engine Forum, All Rights Reserved. 8
Cygwin のインストール 9 17 Cygwin のインストール 10 18 Copyright 2011 by T-Engine Forum, All Rights Reserved. 9
Cygwin のインストール 11 19 Cygwin のインストール 12 20 Copyright 2011 by T-Engine Forum, All Rights Reserved. 10
Cygwin の設定 1. Cygwin 起動用のバッチファイル C: cygwin cygwin.bat を編集して以下を追加 set CYGWIN=check_case:strict 2. Cygwin アイコン をダブルクリックして Cygwin を起動 3. /usr/local/bin から /usr/bin/perl にシンボリックリンクを張る $ cd /usr/local/bin $ ln -s /usr/bin/perl 4. Cygwin を exit コマンドで終了 21 Cygwin の設定 1 22 Copyright 2011 by T-Engine Forum, All Rights Reserved. 11
Cygwin の起動 2 23 開発環境のインストール 24 Copyright 2011 by T-Engine Forum, All Rights Reserved. 12
開発環境のインストール 1. Cygwin を起動 2. 開発環境をインストールするディレクトリを作成 $ mkdir /usr/local/tef_em1d 3. 以下を C: cygwin usr local tef_em1d にコピー te.cygwin-i686.arm_2.1.0.1.tar.gz te.cygwin-i686.common.12.tar.gz 4. 以下のコマンドを実行して展開 $ cd /usr/local/tef_em1d $ tar zxpf te.cygwin-i686.arm_2.1.0.1.tar.gz $ tar zxpf te.cygwin-i686.common.12.tar.gz 25 開発環境のインストール 1 26 Copyright 2011 by T-Engine Forum, All Rights Reserved. 13
開発環境のインストール 2 27 開発環境のインストール 3 28 Copyright 2011 by T-Engine Forum, All Rights Reserved. 14
Eclipse のインストール 29 Eclipse のインストール 1. 実際に利用するユーザで Windows にログイン 2. 以下のファイルを インストール先ドライブの適当なフォルダ (C: temp など ) に保存 eclipse-platform-3.2.2-win32.zip NLpack1-eclipse-platform-3.2.1-win32.zip org.eclipse.cdt-3.1.2-win32.x86.zip CDT_NL_3.1.1.zip 3. 各ファイルを 上記の順に C: に展開 Eclipse 本体 Eclipse 本体日本語化パック CDT プラグイン CDT 日本語化パック パス名に空白や日本語が入る場所へはインストールできない プラグインを展開時の上書き確認は無視 ( ライセンス表示用の html) 4. C: eclipse eclipse.exe のショートカットをデスクトップに作成 30 Copyright 2011 by T-Engine Forum, All Rights Reserved. 15
Eclipse のインストール 1 31 Eclipse のインストール 2 32 Copyright 2011 by T-Engine Forum, All Rights Reserved. 16
Eclipse のインストール 3 33 T-Kernel 開発用プラグインの追加 1. 以下のファイルを C: temp などに保存 org.t_engine.te.1.0.0.zip プラットホーム共通部分 org.t_engine.tl.tef_em1d.1.0.0.zip 各機種対応部分 2. 各ファイルを 上記の順に C: に展開 34 Copyright 2011 by T-Engine Forum, All Rights Reserved. 17
T-Kernel 開発用プラグインの追加 35 T-Kernel 2.0 の展開 36 Copyright 2011 by T-Engine Forum, All Rights Reserved. 18
T-Kernel 2.0 ソースコードの展開 1. 以下のファイルを c: cygwin usr local tef_em1d に保存 tkernel_source.tar.gz T-Kernel ソースコード 2. Cygwin を起動 3. tkernel_source.tar.gz を展開 $ cd /usr/local/tef_em1d $ tar zxpf tkernel_source.tar.gz 37 T-Kernel 2.0 ソースコードの展開 1 38 Copyright 2011 by T-Engine Forum, All Rights Reserved. 19
T-Kernel 2.0 ソースコードの展開 2 39 Eclipse の設定 40 Copyright 2011 by T-Engine Forum, All Rights Reserved. 20
Eclipse の設定 Eclipse のワークスペースの設定 ライブラリ構築用ワークスペース カーネル構築用ワークスペース 設定情報ファイル (config) 構築用ワークスペース デバイスドライバ構築用ワークスペース 41 ライブラリ構築用ワークスペースの設定 1 1. Eclipse を起動 2. ワークスペースの欄に以下を指定 c: cygwin usr local tef_em1d tkernel_source lib 3. [ OK ] ようこそ ビューが表示される 4. ワークベンチの表示 ワークベンチ のアイコンをクリック 5. T-Engine 開発パースペクティブを開く メニュー ウインドウ パースペクティブを開く T-Engine 開発 42 Copyright 2011 by T-Engine Forum, All Rights Reserved. 21
ライブラリ構築用ワークスペースの設定 2 6. メニュー ウインドウ 設定 設定 ダイアログを表示 7. T-Engine 開発環境をクリック 以下を設定 Cygwin ディレクトリ C: cygwin 外部ツール te_vcom -b -x -l /dev/ttysn (n = 0, 1, 2,... ) 外部ツール gterm デフォルトのまま 43 ライブラリ構築用ワークスペースの設定 3 8. 一般 左側の [+] マーク 一般 の下にある詳細情報を表示 9. ワークスペースをクリック 以下を設定 自動的にビルドチェックを外す テキスト ファイル エンコードその他 (EUC-JP) 新規テキスト ファイルの行区切り文字その他 (Unix) 44 Copyright 2011 by T-Engine Forum, All Rights Reserved. 22
ライブラリ構築用ワークスペースの設定 1 45 ライブラリ構築用ワークスペースの設定 2 46 Copyright 2011 by T-Engine Forum, All Rights Reserved. 23
ライブラリ構築用ワークスペースの設定 3 47 ライブラリ構築用ワークスペースの設定 4 48 Copyright 2011 by T-Engine Forum, All Rights Reserved. 24
ライブラリ構築用ワークスペースの設定 5 49 ライブラリ構築用ワークスペースの設定 6 50 Copyright 2011 by T-Engine Forum, All Rights Reserved. 25
ライブラリ構築用ワークスペースの設定 7 51 ライブラリ構築用ワークスペースの設定 8 52 Copyright 2011 by T-Engine Forum, All Rights Reserved. 26
ライブラリ構築用ワークスペースの設定 9 53 その他のワークスペースの設定 基本操作はライブラリ用ワークスペースの設定と同じ ワークスペースのディレクトリを変更 カーネル構築用ワークスペース c: cygwin usr local tef_em1d tkernel_source kernel 設定情報ファイル (config) 構築用ワークスペース設定 c: cygwin usr local tef_em1d tkernel_source config デバイスドライバ構築用ワークスペース設定 c: cygwin usr local tef_em1d tkernel_source drv T-Monitor 構築用ワークスペース設定 c: cygwin usr local tef_em1d tkernel_source monitor 54 Copyright 2011 by T-Engine Forum, All Rights Reserved. 27
ワークスペースの切り換え方 1 55 ワークスペースの切り換え方 2 56 Copyright 2011 by T-Engine Forum, All Rights Reserved. 28
Eclipse でのビルド 57 ライブラリのビルド 1 1. ワークスペースの選択 c: cygwin usr local tef_em1d tkernel_source lib 2. T-Engine 開発パースペクティブの選択 設定済なら右上に T-Engine 開発と表示されている メニュー ウインドウ パースペクティブを開く T-Engine 開発 3. 新規プロジェクトダイアログの表示 C/C++ プロジェクトでマウスの右ボタン メニュー 新規 T- Engine C/C++ プロジェクト 4. 以下を設定 プロジェクト名 build 5. [ 終了 ] 58 Copyright 2011 by T-Engine Forum, All Rights Reserved. 29
ライブラリのビルド 1 59 ライブラリのビルド 2 60 Copyright 2011 by T-Engine Forum, All Rights Reserved. 30
ライブラリのビルド 3 61 ライブラリのビルド 2 6. C/C++ プロジェクトから ビルド先ディレクトリを選択 build/tef_em1d 7. プロパティダイアログの表示 マウスの右ボタン メニュー プロパティ 8. 以下を設定 ビルド環境 tef_em1d.1.0.0 プログラムタイプ ( 空欄 ) 9. [ OK ] 62 Copyright 2011 by T-Engine Forum, All Rights Reserved. 31
ライブラリのビルド 4 63 ライブラリのビルド 5 64 Copyright 2011 by T-Engine Forum, All Rights Reserved. 32
ライブラリのビルド 6 65 ライブラリのビルド 3 10. ビルド先ディレクトリを選択 11.make を実行してビルド ツールバー メニュー プロジェクト T-Engine Target の Make all 66 Copyright 2011 by T-Engine Forum, All Rights Reserved. 33
ライブラリのビルド 7 67 ライブラリのビルド 8 68 Copyright 2011 by T-Engine Forum, All Rights Reserved. 34
ライブラリのビルド 9 69 ライブラリのビルド 10 70 Copyright 2011 by T-Engine Forum, All Rights Reserved. 35
T-Kernel 2.0 のビルド 1 1. ワークスペースの選択 ( 切り換え ) c: cygwin usr local tef_em1d tkernel_source kernel 2. T-Engine 開発パースペクティブの選択 設定済なら右上に T-Engine 開発と表示されている メニュー ウインドウ パースペクティブを開く T-Engine 開発 3. 新規プロジェクトダイアログの表示 C/C++ プロジェクト マウスの右ボタン メニュー 新規 T-Engine C/C++ プロジェクト 4. 2 つのプロジェクトを下記の順に生成して設定 プロジェクト名 1 sysmainsmpl テンプレート sysmainsmpl:usermainsmpl 用 sysmain プロジェクト名 2 usermainsmpl テンプレート usermainsmpl: ユーザメインサンプル プログラムタイプ monitor 5. それぞれ [ 終了 ] してプロジェクトを生成 71 T-Kernel 2.0 のビルド 1 72 Copyright 2011 by T-Engine Forum, All Rights Reserved. 36
T-Kernel 2.0 のビルド 2 73 T-Kernel 2.0 のビルド 3 74 Copyright 2011 by T-Engine Forum, All Rights Reserved. 37
T-Kernel 2.0 のビルド 4 75 T-Kernel 2.0 のビルド 5 76 Copyright 2011 by T-Engine Forum, All Rights Reserved. 38
T-Kernel 2.0 のビルド 6 77 T-Kernel 2.0 のビルド 7 78 Copyright 2011 by T-Engine Forum, All Rights Reserved. 39
T-Kernel 2.0 のビルド 8 79 T-Kernel 2.0 のビルド 2 6. C/C++ プロジェクトから ビルド先ディレクトリを選択 sysmainsmpl/build/tef_em1d 7. プロパティダイアログの表示 マウスの右ボタン メニュー プロパティ 8. 以下を設定 ビルド環境 tef_em1d.1.0.0 プログラムタイプ monitor 80 Copyright 2011 by T-Engine Forum, All Rights Reserved. 40
T-Kernel 2.0 のビルド 9 81 T-Kernel 2.0 のビルド 10 82 Copyright 2011 by T-Engine Forum, All Rights Reserved. 41
T-Kernel 2.0 のビルド 3 9. ビルド先ディレクトリを選択 10.make を実行してビルド ツールバー メニュー プロジェクト T-Engine Target の Make all 83 T-Kernel 2.0 のビルド 11 84 Copyright 2011 by T-Engine Forum, All Rights Reserved. 42
T-Kernel 2.0 のビルド 12 85 T-Kernel 2.0 のビルド 13 86 Copyright 2011 by T-Engine Forum, All Rights Reserved. 43
設定情報ファイルのビルド 1 1. ワークスペースの選択 c: cygwin usr local tef_em1d tkernel_source config 2. T-Engine 開発パースペクティブの選択 メニュー ウインドウ パースペクティブを開く T-Engine 開発 3. 新規プロジェクトダイアログの表示 C/C++ プロジェクト マウスの右ボタン メニュー 新規 T-Engine C/C++ プロジェクト 4. 以下を設定 プロジェクト名 launch-ramkernel プログラムタイプ ( 空欄 ) テンプレート ( 未使用 ) 5. [ 終了 ] 87 設定情報ファイルのビルド 2 6. C/C++ プロジェクトから ビルド先ディレクトリを選択 launch-ramkernel/build/tef_em1d 7. プロパティダイアログの表示 マウスの右ボタン メニュー プロパティ 8. 以下を設定 ビルド環境 tef_em1d.1.0.0 プログラムタイプ monitor 88 Copyright 2011 by T-Engine Forum, All Rights Reserved. 44
設定情報ファイルのビルド 3 9. ビルド先ディレクトリを選択 10.make を実行してビルド ツールバー メニュー プロジェクト T-Engine Target の Make all エミュレータの場合 とりあえずは利用しない 89 Eclipse にエミュレータ用の設定を追加 90 Copyright 2011 by T-Engine Forum, All Rights Reserved. 45
エミュレータ対応の Eclipse の設定 1 外部ツール te_vcom の引数を移動 1. T-Engine 開発環境 メニュー ウィンドウ 設定 T-Engine 開発環境 2. te_vcom の引数を削除 ( 移動 ) 旧 : -b -x -l /dev/ttys0 新 : -b 3. [ OK ] 4. メニュー 実行 外部ツール 外部ツール 5. te_vcom の引数を追加 ( 移動 ) 旧 : ${te_te_vcom_para} 新 : ${te_te_vcom_para} -x -l /dev/ttys0 6. [ 適用 ] 91 エミュレータ対応の Eclipse の設定 1 92 Copyright 2011 by T-Engine Forum, All Rights Reserved. 46
エミュレータ対応の Eclipse の設定 2 93 エミュレータ対応の Eclipse の設定 3 94 Copyright 2011 by T-Engine Forum, All Rights Reserved. 47
エミュレータ対応の Eclipse の設定 4 95 エミュレータ対応の Eclipse の設定 5 96 Copyright 2011 by T-Engine Forum, All Rights Reserved. 48
エミュレータ対応の Eclipse の設定 2 QEMU 用の te_vcom の環境を作成 1. 外部プログラムの te_vcom を選択 2. 右クリック 複製 3. te_vcom(1) を選択... コピーされた環境 4. メインの名前を te_vcom_qemu に変更 ( 名前は任意 ) 5. メインの引数を変更 旧 : ${te_te_vcom_para} -x -l /dev/ttys7 新 : ${te_te_vcom_para} -l localhost:10000 6. [ 適用 ] 7. [ 実行 ] 97 エミュレータ対応の Eclipse の設定 7 98 Copyright 2011 by T-Engine Forum, All Rights Reserved. 49
エミュレータ対応の Eclipse の設定 8 99 エミュレータ対応の Eclipse の設定 9 100 Copyright 2011 by T-Engine Forum, All Rights Reserved. 50
エミュレータのインストール 101 エミュレータのインストール 1. インストール先ディレクトリを作成 C: qemu 2. アーカイブに含まれる bin を フォルダごと C: qemu bin にコピー コピー後の内容は以下の通り qemu.bat 起動用バッチファイル qemu-tef_em1d.exe Emulator の本体 SDL.dll 実行時 DLL libz-1.dll 実行時 DLL sd.img SD カードイメージ ( サンプル ) rom.bin T-Kernel ROM イメージ ( サンプル ) 102 Copyright 2011 by T-Engine Forum, All Rights Reserved. 51
エミュレータのインストール 103 エミュレータでのデバッグ 104 Copyright 2011 by T-Engine Forum, All Rights Reserved. 52
エミュレータの実行 1. コマンドプロンプトを実行 2. 以下のコマンドを入力 cd C: qemu bin qemu.bat rom-dbg.bin sd.img 3. QEMU が起動 デバッグコンソールの接続待ち qemu.bat の第 1 引数には rom-dbg.bin を指定してください rom-dbg.bin はダウンロードするパッケージには含まれておりません emulator/tef_em1d/readme.txt の 3. QEMU-tef_em1d 用のシステム作成 を参考に生成してください 105 エミュレータの実行 106 Copyright 2011 by T-Engine Forum, All Rights Reserved. 53
Eclipse との接続 1. Eclipse を起動 Eclipse と Qemu の起動順は逆でも良い 2. 外部ツール te_vcom_qemu を起動 3. 外部ツール gterm を起動 gterm のバージョンが表示される 4. Enter を入力 T-Monitor のプロンプト TM> が表示される 107 Eclipse との接続 1 108 Copyright 2011 by T-Engine Forum, All Rights Reserved. 54
Eclipse との接続 2 109 Eclipse との接続 3 110 Copyright 2011 by T-Engine Forum, All Rights Reserved. 55
Eclipse との接続 4 111 デバッグ用の設定 1. 構成およびデバッグ C/C++ プロジェクトビュー sysmainsmpl/build/tef_em1d/kernelram.sys を選択 マウス右ボタンのメニュー デバッグ 構成およびデバッグ 2. 構成およびデバッグ T-Engine アプリケーションを選択 3. マウス右ボタンのメニュー 新規 メインタブでの設定 実行ファイル build/tef_em1d/kernel-ram.sys 転送ファイル build/tef_em1d/kernel-ram.mot デバッガータブでの設定 始動で停止 usermain 112 Copyright 2011 by T-Engine Forum, All Rights Reserved. 56
デバッグ用の設定 1 113 デバッグ用の設定 2 114 Copyright 2011 by T-Engine Forum, All Rights Reserved. 57
デバッグ用の設定 3 115 デバッグ用の設定 4 116 Copyright 2011 by T-Engine Forum, All Rights Reserved. 58
デバッグ用の設定 5 117 実行 1. [ デバッグ ] プログラムの転送を開始 転送後 自動的に実行を開始 2. usermain の先頭で停止 Eclipse によるソースコードレベルデバッグが可能 ブレークポイントの設定 実行再開 ステップイン ステップオーバー その他 118 Copyright 2011 by T-Engine Forum, All Rights Reserved. 59
実行 1 119 実行 2 120 Copyright 2011 by T-Engine Forum, All Rights Reserved. 60
実行 3 121 デバッグ Eclipse を利用したソースコードレベルデバッグが可能 ブレークポイントの設定 実行再開 ステップイン ステップオーバー その他 122 Copyright 2011 by T-Engine Forum, All Rights Reserved. 61
デバッグ 123 http://www.t-engine.org/ T-Kernel 2.0 Getting Started 124 Copyright 2011 by T-Engine Forum, All Rights Reserved. 62