Microsoft Word - 2stellaris_ccs.doc

Size: px

Start display at page:

Download "Microsoft Word - 2stellaris_ccs.doc"

こうじみやのじょう
5 years ago
Views:

1 Code Composer Studio 概要 Module Topics Code Composer Studio 概要 Code Composer Studio Code Composer Studio v4 概要ワークスペースプロジェクトターゲットコンフィグレーションビルドオプション Lab2 CCS でビルドデバッグを行う CCS の起動オプション演習 GEL ファイルの内容を確認 CCS の設定を確認 Stellaris 1day Workshop CCS 2-1

2 Code Composer Studio Code Composer Studio v4 概要 Code Composer Studio コンパイラ標準ランタイムライブラリ SIM DSK エディタアセンブラリンク.out デバッグ EVM DSP/BIOS コンフィグツール DSP/BIOS ライブラリサードパーティボード CCSは以下のものを含みます : 組み込みエディタ / デバッグ GUI コード生成ツール BIOS: リアルタイムカーネルリアルタイム解析シミュレータ XDS DSP ボードコード生成 Link.cmd エディタ.c /.cpp コンパイラアセンブラ.asm.obj リンカ.out.map 2-2 Stellaris 1day Workshop CCS

3 CCSv4 での作業 1. ワークスペースの作成 2. プロジェクトの作成 3. ターゲットコンフィグレーションの作成 4. プログラミングビルドロードデバッグ CCS v4 はeclipse をベースに TI 独自のカスタマイズを行った統合開発環境です CCS v3.3 以前とは使い方が大分異なりますワークスペースワークスペースとは? CCS プロジェクトを収めるためのワーキングフォルダです! 1 台のPC 上に複数のワークスペースを持つことができます File Switch Workspace で使用するワークスペースを変更できますワークスペース内には異なるプラットフォームのプロジェクトを混在させることが可能ですプロジェクトをクローズしてもワークスペースのプロジェクトビューからそのプロジェクトは消えませんプロジェクトを削除した場合プロジェクトビューから消去されます注意!! 削除でハードディスクからのファイル本体の削除が出来てしまいます CCS v4では従来のCCS(v3 以前 ) とは異なりワークスペースがビューのレイアウトを直接管理することはありません CCS v4ではパースペクティブがビューレイアウトを管理 Stellaris 1day Workshop CCS 2-3

4 プロジェクトプロジェクトとは? プロジェクトは以下を含む : プロジェクトのファイル : ソースライブラリリンカコマンド等プロジェクトの設定 : コンパイラオプション DSP/BIOS リンカプロジェクトビューターゲットコンフィグレーションターゲットコンフィグレーションとは? 使用するボード // エミュレータ // シミュレータ // デバイスを選択プロジェクトごとにターゲットの設定も可能 2-4 Stellaris 1day Workshop CCS

5 CCS の GUI ワークベンチ CCS のウィンドウ全体ビュー種々の情報を閲覧するためのサブウィンドウエディター主にファイルを編集するためのサブウィンドウパースペクティブビューとエディタの組み合わせとレイアウトを管理するデバッグ用 C/C++ プログラミング用にそれぞれパースペクティブがあります CCS の GUI(C/C++ パースペクティブ ) ワークベンチ C/C++ パースペクティブエディタビュービュービュービュー Stellaris 1day Workshop CCS 2-5

6 CCS の GUI(Debug パースペクティブ ) Debug パースペクティブビュービュービュービュービルドオプションコンパイラのビルドオプションコードのパフォーマンスやサイズ等をチューンできる約 100 種類のコンパイラオプション以下に示すリストは非常に良く使用されるオプション : debug optimize オプション説明 -mv7m3 Cortex-M3コードを生成 -mv7a8 Cortex-A8コードを生成 -mv5e ARM9コードを生成 -fr <dir> object/outputの出力先ディレクトリの指定 -fs <dir> アセンブリファイルの出力先ディレクトリの指定 -g シンボリックデバッグをイネーブル -ss アセンブリファイルの出力 (Cソースをコメント付加) -O3 最適化を起動 (-O0, -O1, -O2, -O3) -k アセンブリファイルのみ出力 2-6 Stellaris 1day Workshop CCS

7 プロジェクトの作成と設定変更ヒント : File New CCS Project でプロジェクトを作成ビルド設定の変更は C/C++ Projects ビューで該当プロジェクトを右クリック Build Properties を選択次のスライドビルドオプション -mv7m3 -g -O2 --gcc --define=ccs --define=target_is_tempest_rb1 Stellaris 1day Workshop CCS 2-7

8 リンカオプション実行ファイルの指定メモリマップファイルの指定メモリ配置はリンカコマンドファイルにより設定しますリンカコマンドファイルはプロジェクトに追加します TI ARM CGT C データ型型サイズ説明 char, signed char 8 ビット ASCII unsigned char 8 ビット ASCII short 16 ビット 2 s complement unsigned short 16 ビット binary int, signed int 32 ビット 2 s complement unsigned int 32 ビット binary long, signed long 32 ビット 2 s complement unsigned long 32 ビット binary enum 32 ビット 2 s complement float 32 ビット IEEE 32-bit double 64 ビット IEEE 64-bit long double 64 ビット IEEE 64-bit pointers 32 ビット binary 2-8 Stellaris 1day Workshop CCS

9 GEL スクリプト GEL: General Extension Language C スタイルの文法非常に多くのデバッガコマンドが GEL 関数として用意されている自作の関数も記述可能 GEL のメニューアイテムを作成する Stellaris 1day Workshop CCS 2-9

$Lab2 CCS でビルドデバッグを行う Lab2 CCS でビルドデバッグを行う volatile unsigned long g_ulcount; unsigned long plusone(unsigned long in) { return(++in); } void main(void) { g_ulcount = 1; Code Composer Studio (CCS)$

10 Lab2 CCS でビルドデバッグを行う Lab2 CCS でビルドデバッグを行う volatile unsigned long g_ulcount; unsigned long plusone(unsigned long in) { return(++in); } void main(void) { g_ulcount = 1; Code Composer Studio (CCS) を使ってみる while(g_ulcount){ g_ulcount = plusone(g_ulcount); } } ハードウェアをセットアッププロジェクトを作成しビルドする変数メモリコードを確認プログラムを実行 (run) 停止(halt), ステップ実行ブレークポイントメモリに格納された結果を表示 CCS の起動 1. CCSv4 を起動しますウィンドウズのスタートメニューすべてのプログラム Texas Instruments Code Composer Studio v4 Code Composer Studio v4 をクリックして CCSv4 を起動してください起動するとワークスペースを選択するウィンドウが現れますので C:\stellaris_1day を選択し OK してください 2-10 Stellaris 1day Workshop CCS

11 最初の起動時には以下のような Welcome ビューが現れますここではさまざまな資料をご紹介していますトップメニューの Help Welcome から開けますので評価 / 開発時にご活用下さい右上のをクリックし workbench を開いてくださいまた後の作業のためにデスクトップにアイコンを作っておくと起動しやすいでしょう Stellaris 1day Workshop CCS 2-11

$Location: フィールドが自動的に < ワークスペース >\< プロジェクト名 > となることに注目してください新しいプロジェクトを作成すると同名のフォルダがワークスペースに作成されます 2-12 Stellaris 1day$

12 2. プロジェクトを作成します 1)CCS のメインメニュー File New CCS Project をクリックしてください 2)Project name: フィールドに lab2 と入力し Next をクリックしてください Location: フィールドが自動的に < ワークスペース >\< プロジェクト名 > となることに注目してください新しいプロジェクトを作成すると同名のフォルダがワークスペースに作成されます 2-12 Stellaris 1day Workshop CCS

13 3) プロジェクトタイプを選択しますがデフォルトのままでかまいません Next をクリックしてください 4) 依存関係のある他のプロジェクトを選択しますまだワークスペース内に他のプロジェクトはなく今回はシンプルなソフトウェアを作成しますのでそのまま Next をクリックしてください Stellaris 1day Workshop CCS 2-13

すると以下のプルダウンメニューが適した内容に変更されます下図のように設定されていることを確認し Finish

14 5) プロジェクトの設定を行います Device Variant: の右のプルダウンメニューから使用する評価キットに搭載されている Stellaris デバイスを選択してくださいすると以下のプルダウンメニューが適した内容に変更されます下図のように設定されていることを確認し Finish をクリックしてください 6) プロジェクトが作成されると下図のようにプロジェクトビューにいま作成したプロジェクトが現れます 2-14 Stellaris 1day Workshop CCS

3. 新規 C ソースファイルを作成します CCS のメインメニュー File New Source File をクリックしてくださいすると下図のようなウィンドウが現れます拡張子が.c であればファイル名はどんなものでもかまいませんがここでは例として lab2.c とします Source File: フィールドに lab2.

15 3. 新規 C ソースファイルを作成します CCS のメインメニュー File New Source File をクリックしてくださいすると下図のようなウィンドウが現れます拡張子が.c であればファイル名はどんなものでもかまいませんがここでは例として lab2.c とします Source File: フィールドに lab2.c と入力し Finish をクリックしてくださいするとプロジェクトビューのツリーに lab2.c が追加されエディタが現れます 4. コードを記述しますここでは CCS の使い方を確認するためにプログラムとしてはあまり意味のないものですが簡単なルーチンを記述していただきます 1) 以下のコードを記述してください volatile unsigned long g_ulcount; unsigned long plusone(unsigned long in) { return(++in); } void main(void) { g_ulcount = 1; } while(g_ulcount){ g_ulcount = plusone(g_ulcount); } Stellaris 1day Workshop CCS 2-15

c を StellarisWare から追加します割込み処理の詳細については次章で紹介しますのでここではリセット処理のために必要とだけ覚えておいてくださいプロジェクトに既存のファイルを追加するにはプロジェクトを右クリック Add Files

16 2) 記述を加えるとエディタのファイル名の横に * がつくことに注目してくださいこれはこのファイルに変更が加わりまだセーブされていないことを示していますすべて記述が終わりましたらをクリックしセーブしてください 5. startup_ccs.c をプロジェクトに追加します割込みベクタを記述してある startup_ccs.c を StellarisWare から追加します割込み処理の詳細については次章で紹介しますのでここではリセット処理のために必要とだけ覚えておいてくださいプロジェクトに既存のファイルを追加するにはプロジェクトを右クリック Add Files to Project をクリックします startup_ccs.c は例えば C:\StellarisWare\boards\ek-lm3s9b92\blinky 評価キット名などサンプルのフォルダにありますので追加してください CCSv4 では既存のファイルを Add Files to Project にて追加すると追加したプロジェクトのフォルダにコピーを作ります 2-16 Stellaris 1day Workshop CCS

ccxml と入力し Finish をクリックしてくださいするとプロジェクトビューのツリーに TargetConfiguration.ccxml が追加されターゲットコンフィグレーションをセットアップするビューが現れます 7.

17 6. ターゲットコンフィグレーションを作成しますメニューから File New Target Configuration file をクリックしてくださいすると下図のようなウィンドウが現れます拡張子が.ccxml であればファイル名はどんなものでもかまいませんここでは例として TargetConfiguration.ccxml とします File name: フィールドに TargetConfiguration.ccxml と入力し Finish をクリックしてくださいするとプロジェクトビューのツリーに TargetConfiguration.ccxml が追加されターゲットコンフィグレーションをセットアップするビューが現れます 7. ターゲットコンフィグレーションの内容を修正します 1)Stellaris 評価キット用に設定を行いますまず Connection プルダウンメニューから Stellaris In-Circuit Debug Interface を選択してくださいこのプルダウンメニューでは Emulator や Simulator の選択を行いますたとえば実機を使わず Cortex-M3 コアのみのシミュレータにて作業を行う場合には Texas Instruments Simulator を選択しますこのワークショップでは実機を使います Stellaris 1day Workshop CCS 2-17

2)Device プルダウンメニューからお使いの評価キットに搭載されている Stellaris デバイスを探しチェックボックスにチェックを入れてください以上でターゲットコンフィグレーションの設定は終了です同じビューにある Save ボタンをクリックし保存してください 8.

18 2)Device プルダウンメニューからお使いの評価キットに搭載されている Stellaris デバイスを探しチェックボックスにチェックを入れてください以上でターゲットコンフィグレーションの設定は終了です同じビューにある Save ボタンをクリックし保存してください 8. プロジェクトをビルドし実行可能ファイルを作成しますプロジェクトのビルドを行うには CCS のメニュー Project Build Active Project( またはツールバーのボタン ) をクリックしますビルドを行いエラーがないことを確認してくださいエラーがなく実行可能ファイル lab2.out が出来上がると下図のように Build complete for project lab2 というメッセージが Console ビューに表示されますエラーがある場合は赤い文字でエラーの内容が Console ビューに表示されますので表示された内容を参考にプログラムを修正してください 2-18 Stellaris 1day Workshop CCS

をクリックしてください右図のようにデバッガの起動およびプログラムのロードの進行状況を示すウィンドウが現れます 2) デバッガの起動およびロードが問題なく完了すると下図のように CCS のビュー構成がデバッグ

19 9. デバッガを起動し作成した実行可能ファイルをターゲットにロードします 1) 作成した実行可能ファイルをターゲット上で実行させるためにデバッガを起動しロードします Stellaris 用のターゲットコンフィグレーションではロードを行うと自動的にチップ内蔵の Flash メモリにプログラムが書き込まれます Target Debug Active Project ( またはツールバーのボタン ) をクリックしてください右図のようにデバッガの起動およびプログラムのロードの進行状況を示すウィンドウが現れます 2) デバッガの起動およびロードが問題なく完了すると下図のように CCS のビュー構成がデバッグパースペクティブにかわりプログラムは main 関数の先頭まで実行したところで停止しますエディタの行の左にあるマークはプログラムが停止している行を示します Stellaris 1day Workshop CCS 2-19

を選択し右クリック Add Watch Expression をクリックしてくださいすると下図のように Watch

20 10. グローバル変数 g_ulcount を Watch ビューに追加します実行するに従いグローバル変数 g_ulcount が変化する様子を確認するために Watch ビューに追加しますエディタ上で g_ulcount を選択し右クリック Add Watch Expression をクリックしてくださいすると下図のように Watch ビューが表示され g_ulcount の現在の値が表示されます 2-20 Stellaris 1day Workshop CCS

Breakepoint をクリックしてくださいブレークポイントが設定されると設定された行にマークが表示されますブレークポイントの設定 / 解除はエディ

21 11. ブレークポイントを設定しますプログラムの動作を確認するためにいったん停止させたい行へブレークポイントを設定しますここでは g_ulcount 変数に plusone 関数の戻り値を代入する行にブレークポイントを設定してみましょう下図のようにエディタで停止させたい行にカーソルを移動し右クリック Toggle Breakepoint をクリックしてくださいブレークポイントが設定されると設定された行にマークが表示されますブレークポイントの設定 / 解除はエディタの左側 ( マークが現れたあたり ) をダブルクリックすることでも可能です 11. プログラムを実行します Stellaris 1day Workshop CCS 2-21

再度プログラムを実行します何回かプログラムを実行してみてください実行のたびに pulsone 関数が処理され g_ulcount 変数の値が増えていくことが確認できると思います 13.

22 デバッグビューのボタンをクリックしプログラムを実行してください設定したブレークポイントの行で停止したでしょうか? ブレークポイントは設定した行を実行する直前で止まりますので Watch ビューにて1が代入されたことが確認できると思います 12. 再度プログラムを実行します何回かプログラムを実行してみてください実行のたびに pulsone 関数が処理され g_ulcount 変数の値が増えていくことが確認できると思います 13. メモリビューにて g_ulcount 変数の値を確認します組込みプログラミングではアドレスを直に指定しメモリの内容を確認したいこともあるでしょうここでは g_ulcount 変数を題材にメモリビューを使ってみます View Memory 新しく表示されたメモリビュー内の Enter location here というフィールドに g_ulcount 変数のアドレスを入力し Enter キーを押してください右図のように連続したメモリ空間のイメージで内容が表示されます 2-22 Stellaris 1day Workshop CCS

23 メモリビューでは表示の仕方をプルダウンメニューで変えることができます変数の型に合わせるなど見やすい表示を活用してください 14. 実行サイクル数を表示します Stellaris の CPU Cortex-M3 コアの持つ機能と CCS のブレークポイント機能を組み合わせ実行にかかったサイクル数を表示させることができます 1) ブレークポイントビューを表示します View Breakpoints 下図のようにボタンから Count Event をクリックするとカウントするイベント選択ウィンドウが現れます 2) イベント選択ウィンドウから Clock Cycles を選択してください Stellaris 1day Workshop CCS 2-23

下図のようにブレークポイントビューに Count Event の表示が追加されます何度か実行し Count が増える様子を確認してください

にチェックを入れると実行時に Count をクリアしてからサイクル数を確認することができますブレークポイントビューの Count

何度か実行し動作の違いを確認してくださいまた単に Count 値をクリアするには Name 列の Count Event をクリックした後

24 下図のようにブレークポイントビューに Count Event の表示が追加されます何度か実行し Count が増える様子を確認してください上図に表示されている Count Event 行を右クリックでプロパティを開くと右図の表示が出ます Reset Count on Run にチェックを入れると実行時に Count をクリアしてからサイクル数を確認することができますブレークポイントビューの Count Event の行を右クリックプロパティから下図のように Reset Count on Run をチェックし OK してください何度か実行し動作の違いを確認してくださいまた単に Count 値をクリアするには Name 列の Count Event をクリックした後同じ行の他の部分をクリックしてください 15. 最適化オプションを変えサイクル数の違いを確認します 2-24 Stellaris 1day Workshop CCS

25 ここまで簡単なプログラムをビルドしロード実行する手順を見てきましたがビルドオプションはデフォルトのオプションを使用してきましたここでは最適化オプションを変更ビルドしプログラムの変化を確認しますまずいったんデバッガを終了しますデバッガの終了はデバッガビューのボタンをクリックしてくださいするとデバッガ終了とともに C/C++ パースペクティブに戻ります次にビルドオプションを変更しますプロジェクトビューの lab2 プロジェクトを右クリックし Build Properties を開いてください Stellaris 1day Workshop CCS 2-25

ビルドプロパティではコード生成ツールに渡すさまざまなオプションや環境変数などを設定できますここでは下図のように Tool Settings タブの TMS470 Compiler Basic Options から最適化オプションを変更してください最適化オプションはなし <0<1<2<3 という順序でより強く最適化を行うようになります 16.

26 ビルドプロパティではコード生成ツールに渡すさまざまなオプションや環境変数などを設定できますここでは下図のように Tool Settings タブの TMS470 Compiler Basic Options から最適化オプションを変更してください最適化オプションはなし <0<1<2<3 という順序でより強く最適化を行うようになります 16. 最適化オプションの効果を確認します最適化オプションを変えるごとにビルドロード実行しサイクル数に違いが現れることを確認してください最適化オプションを弱くするとサイクル数が増え強くするとサイクル数を減らすことができる様子が確認できると思います以上で lab2 は終了ですお疲れ様でした時間に余裕のある方はオプション演習をご覧下さい 2-26 Stellaris 1day Workshop CCS

ccxml をダブルクリックしターゲットコンフィグレーションビューを開いてくださいそして左下の Advanced タブをクリックするとより詳細な情報が表示されますさらに Stellaris の CPU CORTEX_M3_0

27 オプション演習 GEL ファイルの内容を確認 17. 自動的に読み込まれる GEL ファイルのパスを確認しますターゲットコンフィグレーションではデバッガ起動時に自動的に読み込む GEL ファイルの設定がされていますプロジェクトビューの lab2 ツリーから TargetConfiguration.ccxml をダブルクリックしターゲットコンフィグレーションビューを開いてくださいそして左下の Advanced タブをクリックするとより詳細な情報が表示されますさらに Stellaris の CPU CORTEX_M3_0 をクリックすると下図のように自動的に読み込まれる GEL ファイルのパスが表示されますここにユーザー独自の GEL ファイルを指定することも可能です 18. GEL ファイルの内容を確認しますデバッガ起動時には自動的に読み込まれている GEL ファイルの内容を表示確認することができます 1) デバッガを起動しますプログラムをロードせずにデバッガのみ起動する際にはボタンからプルダウンメニューを開き Lanch TI Debugger をクリックしてください Stellaris 1day Workshop CCS 2-27

28 2) デバッグビューの Stellaris In-Circuit Debug Interface を右クリック Open GEL Files View をクリックしてくださいすると下図のように GEL Files ビューが表示されたとえば lm3s9b92.gel をダブルクリックするとエディタに表示されます 2-28 Stellaris 1day Workshop CCS

29 CCS の設定を確認 19. CCS の設定を開きます CCS のメインメニュー Window Preferences をクリックすると CCS 全体のさまざまなオプションを設定できますたとえば下図のように General workspace ではプロジェクトに変更があったとき自動的にビルドを実行させるか否かなど CCS の動作をコントロールできます 20. 使いやすい設定を行いますたくさんの項目がありますので時間の許す限りご覧下さいオプション演習は以上ですお疲れ様でした Stellaris 1day Workshop CCS 2-29

1. 新規プロジェクト作成の準備新規プロジェクトのためのフォルダを用意してそこにプロジェクトを作成します [ 新しいフォルダー ] をクリックして希望のフォルダに新しいフォルダを作成しますこの例では TrST_F401N_BlinkLD2 というフォルダを作成しました TrST_F401N_Bl

1. 新規プロジェクト作成の準備新規プロジェクトのためのフォルダを用意してそこにプロジェクトを作成します [ 新しいフォルダー ] をクリックして希望のフォルダに新しいフォルダを作成しますこの例では TrST_F401N_BlinkLD2 というフォルダを作成しました TrST_F401N_Bl NUCLEO-F401RE の TrueSTUDIO プロジェクト構築方法 V001 2014/09/24 Atollic TrueSTUDIO for ARM Lite を使用して NUCLEO-F401RE のプロジェクトを新規に作成する方法について説明しますまたビルドとデバッグについても説明しています目次 1. 新規プロジェクト作成の準備... 2 2. 新規プロジェクトの作成... 3