インストール - Code Composer Studioのソースを表示

== 概要 ==
Code Composer Studio(以降、CCSという)はTexas Instruments社(以降、TI社という)が提供しているIDE(統合開発環境)である。<br>
オープンソースの統合開発環境であるEclipseをベースに作成しているため、Eclipseを使用したことのあるユーザにはユーザーインタフェースがほぼ一緒なので違和感なく使用できる。<br>
<br>
また、CCSにはこれ以外にも大きな特長がある。<br>
<br>
* CCSの特長1 : 無償
*: CCS 7以降で全機能を無償で使用できるようになった。
*: IDEが有償だと製品検討時の実験的な導入ですら手を出しづらいが、CCSは無償なので評価ボードとJTAGエミュレータを用意するだけで試すことができる。
*: <br>
*: MSP430等であれば、JTAGエミュレータ機能を搭載した評価ボードが低価格で用意されているので、製品導入の検討目的だけでなく、電子工作でも手を出しやすい環境が整っている。
<br>
* CCSの特長2 : TI社のマイコン、プロセッサー製品ほぼ全てに対応
*: CCSはTI社のマイコン、プロセッサ製品のほぼ全てに対応している。(※あまりにも古い製品など、対応していない製品も一部ある)
*: 製品毎に異なるIDEだと、その都度インストールの手間が掛かり、ディスク容量も消費してしまう。また、UIも変わってしまうので慣れるのに時間が掛かってしまう。
*: 一方、CCSは製品が変わっても基本的な使い方は同じである。例えば、MSP430の開発に慣れた人がC2000の開発をしても、IDEの使い方を1から習得し直す手間は掛からない。
<br>
* CCSの特長3 : アップデートの頻度が高い
*: 無償になっても比較的高い頻度でアップデートされている。
<br><br>

== ライブラリのインストール ==
CCSの実行に必要な依存関係のライブラリをインストールする。<br>
<br>
==== パッケージ管理システムからインストール ====
* SUSEの場合
*: libncurses5とlibusb-0_1-4のインストールを行う。
*: libncurses5は、テキストユーザインタフェースを作成するためのAPIを提供するライブラリである。
*: libusbは、USBライブラリである。
 # SLES / openSUSE
 sudo zypper install libncurses5 libusb-0_1-4 libpython2_7-1_0 gconf2
<br>
==== ソースコードからインストール ====
SLEDの場合、libncurses5およびlibusb-0_1-4はパッケージ管理システムから提供されていないため、ビルドしてインストールする必要がある。<br>
<br>
===== libusb-0_1-4のインストール =====
libusb-0_1-4のGithubからソースコードをダウンロードする。<br>
 git clone https://github.com/libusb/libusb-compat-0.1.git
 cd libusb-compat-0.1
<br>
configureスクリプトを生成する。<br>
 autoreconf -i
<br>
libusb-0_1-4をビルドおよびインストールする。<br>
 mkdir build && cd build
 
 # 64bit版
 ../configure --prefix=<libusb-0_1-4のインストールディレクトリ>
 make -j $(nproc)
 make install
<br>
 # 32bit版
 export LIBUSB_1_0_SONAME="/usr/lib/libusb-1.0.so.0"; \
 CC="gcc -m32" CXX="g++ -m32" ../configure --prefix=<libusb-0_1-4のインストールディレクトリ>
 make -j $(nproc)
 make install
<br>
~/.profileファイル等に、以下の環境変数を追記する。<br>
 <syntaxhighlight lang="sh">
 # ~/.profileファイル
 
 export PATH="/<libusb-0_1-4のインストールディレクトリ>/bin:$PATH"
 export LD_LIBRARY_PATH="/<libusb-0_1-4のインストールディレクトリ>/lib64:/<libusb-0_1-4のインストールディレクトリ>/lib:$LD_LIBRARY_PATH"
 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:$(pkg-config --variable pc_path pkg-config)"
 export PKG_CONFIG_PATH="/<libusb-0_1-4のインストールディレクトリ>/lib64/pkgconfig:/<libusb-0_1-4のインストールディレクトリ>/lib/pkgconfig:$PKG_CONFIG_PATH"
 </syntaxhighlight>
<br>
==== libncurses5のインストール ====
[https://invisible-island.net/ncurses/announce.html libncurses5の公式Webサイト]にアクセスして、libncurses5のソースコードをダウンロードする。<br>
または、<code>wget</code>コマンドを実行して、libncurses5のソースコードをダウンロードする。<br>
 wget https://invisible-mirror.net/archives/ncurses/ncurses-5.x.tar.gz
<br>
ダウンロードしたファイルを解凍する。<br>
 tar ncurses-5.x.tar.gz
 cd ncurses-5.x
<br>
ビルドディレクトリを作成する。<br>
 mkdir build && cd build
<br>
libncurses5をビルドおよびインストールする。<br>
<u>(1)から順に(4)までビルドおよびインストールする。</u><br>
 (1) 32bit版 ワイド文字対応
 ../configure \
 CC="/<GCC6.5以前のインストールディレクトリ>/bin/gcc -m32"         \
 CXX="/<GCC6.5以前のインストールディレクトリ>/bin/g++ -m32"        \
 --bindir=/<libncurses5のインストールディレクトリ>/baselibs-32bit \
 --libdir=/<libncurses5のインストールディレクトリ>/lib            \
 --with-shared --with-cxx-shared --with-normal --with-ticlib --with-debug \
 --without-progs --without-tests --without-manpages \
 --enable-widec --enable-pc-files                   \
 --program-suffix="w"                               \
 --prefix=<libncurses5のインストールディレクトリ>           \
 CPPFLAGS="-P"
 
 make -j $(nproc)
 
 # pkgconfファイルは強制的に/usr/lib/pkgconfigディレクトリにインストールされるため、
 # スーパーユーザ権限で実行する
 sudo make install.libs
 
 # pkgconfigファイルをインストールディレクトリに移動する
 mkdir /<libncurses5のインストールディレクトリ>/lib/pkgconfig
 sudo mv \
         /usr/lib/pkgconfig/formw.pc      \
         /usr/lib/pkgconfig/menuw.pc      \
         /usr/lib/pkgconfig/ncurses++w.pc \
         /usr/lib/pkgconfig/ncursesw.pc   \
         /usr/lib/pkgconfig/panelw.pc     \
         /usr/lib/pkgconfig/ticw.pc       \
         /<libncurses5のインストールディレクトリ>/lib/pkgconfig
 
 # スーパーユーザでインストールしているため、オーナーを一般ユーザに変更する
 sudo chown -R $USER:$(id -gn) <libncurses5のインストールディレクトリ>
 
 # 不要なファイルを削除する
 rm -rf /<libncurses5のインストールディレクトリ>/include
 rm -rf /<libncurses5のインストールディレクトリ>/share
<br>
 (2) 32bit版 非ワイド文字
 ../configure \
 CC="/<GCC6.5以前のインストールディレクトリ>/bin/gcc -m32"  \
 CXX="/<GCC6.5以前のインストールディレクトリ>/bin/g++ -m32" \
 --prefix=<libncurses5のインストールディレクトリ>                 \
 --bindir=/<libncurses5のインストールディレクトリ>/baselibs-32bit \
 --libdir=/<libncurses5のインストールディレクトリ>/lib            \
 --with-shared --with-cxx-shared --with-normal --with-ticlib --with-debug --with-termlib --disable-widec --enable-pc-files \
 --without-progs --without-tests --without-manpages \
 CPPFLAGS="-P"
 
 make -j $(nproc)
 
 # pkgconfファイルは強制的に/usr/lib/pkgconfigディレクトリにインストールされるため、
 # スーパーユーザ権限で実行する
 sudo make install.libs
 
 # pkgconfigファイルをインストールディレクトリに移動する
 mkdir /<libncurses5のインストールディレクトリ>/lib/pkgconfig
 sudo mv \
         /usr/lib/pkgconfig/form.pc      \
         /usr/lib/pkgconfig/form_g.pc    \
         /usr/lib/pkgconfig/menu.pc      \
         /usr/lib/pkgconfig/menu_g.pc    \
         /usr/lib/pkgconfig/ncurses.pc   \
         /usr/lib/pkgconfig/ncurses_g.pc \
         /usr/lib/pkgconfig/ncurses++.pc \
         /usr/lib/pkgconfig/panel.pc     \
         /usr/lib/pkgconfig/panel_g.pc   \
         /usr/lib/pkgconfig/tic.pc       \
         /usr/lib/pkgconfig/tic_g.pc     \
         /usr/lib/pkgconfig/tinfo.pc     \
         /usr/lib/pkgconfig/tinfo_g.pc   \
         /<libncurses5のインストールディレクトリ>/lib/pkgconfig
 
 # スーパーユーザでインストールしているため、オーナーを一般ユーザに変更する
 sudo chown -R $USER:$(id -gn) <libncurses5のインストールディレクトリ>
 
 # 不要なファイルを削除する
 rm -rf /<libncurses5のインストールディレクトリ>/include
 rm -rf /<libncurses5のインストールディレクトリ>/share
<br>
 (3) 64bit版 ワイド文字対応
 ../configure \
 CC="/<GCC6.5以前のインストールディレクトリ>/bin/gcc"     \
 CXX="/<GCC6.5以前のインストールディレクトリ>/bin/g++"    \
 --prefix=<libncurses5のインストールディレクトリ>        \
 --libdir=/<libncurses5のインストールディレクトリ>/lib64 \
 --with-shared --with-cxx-shared --with-normal  --with-ticlib --with-debug \
 --without-progs --without-tests --without-manpages \
 --enable-widec --enable-pc-files                   \
 CPPFLAGS="-P"
 
 # pkgconfファイルは強制的に/usr/lib/pkgconfigディレクトリにインストールされるため、
 # スーパーユーザ権限で実行する
 sudo make install.libs
 
 # pkgconfigファイルをインストールディレクトリに移動する
 mkdir /<libncurses5のインストールディレクトリ>/lib64/pkgconfig
 sudo mv \
         /usr/lib/pkgconfig/formw.pc      \
         /usr/lib/pkgconfig/menuw.pc      \
         /usr/lib/pkgconfig/ncurses++w.pc \
         /usr/lib/pkgconfig/ncursesw.pc   \
         /usr/lib/pkgconfig/panelw.pc     \
         /usr/lib/pkgconfig/ticw.pc       \
         /<libncurses5のインストールディレクトリ>/lib64/pkgconfig
 
 # スーパーユーザでインストールしているため、オーナーを一般ユーザに変更する
 sudo chown -R $USER:$(id -gn) <libncurses5のインストールディレクトリ>
 
 # 不要なファイルを削除する
 rm -rf /<libncurses5のインストールディレクトリ>/include
 rm -rf /<libncurses5のインストールディレクトリ>/share
<br>
 (4) 64bit版 非ワイド文字
 ../configure \
 CC="/<GCC6.5以前のインストールディレクトリ>/bin/gcc"     \
 CXX="/<GCC6.5以前のインストールディレクトリ>/bin/g++"    \
 --prefix=<libncurses5のインストールディレクトリ>        \
 --libdir=/<libncurses5のインストールディレクトリ>/lib64 \
 --with-shared --with-cxx-shared --with-normal --with-ticlib --with-debug --with-termlib \
 --without-tests --without-manpages              \
 --disable-widec --enable-pc-files               \
 CPPFLAGS="-P"
 
 make -j $(nproc)
 
 # pkgconfファイルは強制的に/usr/lib/pkgconfigディレクトリにインストールされるため、
 # スーパーユーザ権限で実行する
 sudo make install.libs
 
 # pkgconfigファイルをインストールディレクトリに移動する
 mkdir /<libncurses5のインストールディレクトリ>/lib64/pkgconfig
 sudo mv \
         /usr/lib/pkgconfig/form.pc      \
         /usr/lib/pkgconfig/form_g.pc    \
         /usr/lib/pkgconfig/menu.pc      \
         /usr/lib/pkgconfig/menu_g.pc    \
         /usr/lib/pkgconfig/ncurses.pc   \
         /usr/lib/pkgconfig/ncurses_g.pc \
         /usr/lib/pkgconfig/ncurses++.pc \
         /usr/lib/pkgconfig/panel.pc     \
         /usr/lib/pkgconfig/panel_g.pc   \
         /usr/lib/pkgconfig/tic.pc       \
         /usr/lib/pkgconfig/tic_g.pc     \
         /usr/lib/pkgconfig/tinfo.pc     \
         /usr/lib/pkgconfig/tinfo_g.pc   \
         /<libncurses5のインストールディレクトリ>/lib64/pkgconfig
 
 
 # スーパーユーザでインストールしているため、オーナーを一般ユーザに変更する
 sudo chown -R $USER:$(id -gn) <libncurses5のインストールディレクトリ>
<br>
~/.profileファイル等に、以下の環境変数を追記する。<br>
 <syntaxhighlight lang="sh">
 export PATH="/<libncurses5のインストールディレクトリ>/bin:/<libncurses5のインストールディレクトリ>/baselibs-32bit/bin:$PATH"
 export LD_LIBRARY_PATH="/<libncurses5のインストールディレクトリ>/lib64:/<libncurses5のインストールディレクトリ>/lib:$LD_LIBRARY_PATH"
 export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:$(pkg-config --variable pc_path pkg-config)"
 export PKG_CONFIG_PATH="/<llibncurses5のインストールディレクトリ>/lib64/pkgconfig:/<llibncurses5のインストールディレクトリ>/lib/pkgconfig:$PKG_CONFIG_PATH"
 </syntaxhighlight>
<br><br>

== CCSのインストール ==
# インストーラのダウンロード
#: まず、CCSのインストーラを[http://software-dl.ti.com/ccs/esd/documents/ccs_downloads.html こちらのWebサイト]からダウンロードする。
#: Windowsの場合はWindows 64bitをダウンロード、Linuxの場合はLinux 64bitをダウンロードする。
# アンチウイルスソフトの無効化
#: インストーラを実行する前に、使用しているPCのアンチウイルスソフトを一時的に無効化する。
#: 無効化する理由は、アンチウイルスソフトがCCSのインストール処理に悪影響を与える恐れがあるためである。インストールが完了したら有効に戻す。
# インストーラの実行
#: 上記でダウンロードしたファイルを解凍して、以下のファイルを実行する。
#* Windowsの場合 : ccs_setup_xxx.exeファイルを実行する。
#* Linuxの場合 : ccs_setupファイルを実行する。
#: <br>
#: 実行するとインストール開始直前の初期チェックが行われる。
# CCSのインストール
#: [License Agreement]画面では、[I accept ...]ボタンにチェックを入力して[Next]ボタンを押下する。
#: [Choose Installation Location]画面では、CCSをインストールするフォルダを選択することができる。[Next]ボタンを押下する。
#: [Processor Support]画面では、MSP430を始めとするTI製品のコンパイラ等を選択してインストールすることができる。
#: 使用する製品にチェックを入力する。もし迷う場合は全てにチェックしても構わない。[Next]ボタンを押下する。
#: [Select Debug Probes]画面では、サードパーティ製のJTAGエミュレータをインストールするかどうかを選択することができる。
#: もし迷う場合は、全てにチェックを入力する。[Finish]ボタンを押下する。
#: [Finish]ボタンを押下するとインストールが始まる。
#: Windowsの場合、インストール中にセキュリティに関するウインドウが表示されることがある。
#: (インストール時にチェックした項目によっては表示されないこともある)
#: (もし、[Windowsセキュリティの重要な警告]画面が表示された時は、[アクセスを許可する]ボタンを押下する)
#: ([Windowsセキュリティ]画面が表示された時は、[インストール]ボタンを押下する)
# Code Composer Studioのインストールの完了
#: インストール完了後、[Launch ...]ボタンにチェックを入力したまま[Finish]ボタンを押下すると、CCSが起動する。
# Linuxの場合は、/<<nowiki>Code</nowiki> Composer Studioのインストールディレクトリ>/ccs/install_scriptsディレクトリに移動して、専用デバイスドライバをインストールする必要がある。
#: <code>sudo ./install_drivers.sh</code>
<br><br>

== 注意事項 ==
CCS 9.2.0および9.3.0にはバグがあり、スーパーユーザ権限でインストールした場合、一般ユーザとして実行すると、<br>
プロジェクトでターゲットを構成したり、特定のデバイスファミリ(C2000、Hercules)を使用して新しいターゲット構成ファイルを作成しようとすると、次のエラーで失敗する。<br>
<br>
 # ターゲット構成ファイルの作成：
 
 インクルードまたはインスタンスxmlファイルの解析に問題があります。
 /opt/ti/ccs930/ccs/ccs_base/common/targetdb/../Modules/C2000/C2000_FPU32_Registers.xml(そのようなファイルまたはディレクトリはありません)
<br>
 # 新しいプロジェクトでの接続の構成：
 
 ファイルの解析エラー：
 (0, 0)での致命的なエラー : 例外が発生しました！type : RuntimeException, メッセージ : プライマリドキュメントエンティティを開けませんでした。
 Id=/opt/ti/ccs930/ccs/ccs_base/common/targetdb/../Modules/C2000/C2000_FPU32_Registers.xml
<br>
 # ファイルの解析中：
 /opt/ti/ccs930/ccs/ccs_base/common/targetdb/../Modules/C2000/C2000_FPU32_Registers.xml
<br>
これは、インストールツリー内のいくつかのサポートファイルの権限が不適切に設定されているために起きる。<br>
これを修正するには、CCSのインストールディレクトリにあるccsディレクトリ下の全てのディレクトリとファイルに対して、全てのユーザの読み込み権限と実行権限を付加する。<br>
 cd /opt/ti/ccs930/ccs
 sudo chmod -R go+rX *
<br><br>

== プロジェクトの作成 ==
==== はじめに ====
まず、プロジェクトを保管するワークスペース向けのディレクトリを作成する。<br>
<u>なお、ディレクトリのパスのに全角文字がある場合、CCSのコンパイラ等のツールが動作しない可能性があることに注意する。</u><br>
<br>
Code Composer Studioの起動後、上記で作成したワークスペースを指定する。<br>
<br>
次に、ワークスペース内にプロジェクトを作成する。
作成方法は、以下に示すように2通りある。<br>
* 新規作成する方法
* ライブラリのサンプルプロジェクトをインポートして作成する方法
<br>
初心者の場合は、サンプルプロジェクトをインポートして作成する方がよい。<br>
これは、サンプルプロジェクトは最初からライブラリがプロジェクト内に組み込まれているためである。<br>
<br>
新規作成は、ライブラリを使用せずに1から設計者がソースコードを記述する場合や古いバージョンのライブラリを使用する場合等に選択する。<br>
<br>
==== 作成 ====
Code Composer Studioの起動後、[File]メニューバー - [New] - [CCS Project]を選択する。<br>
[New CCS Project]画面が表示されるので、プロジェクトの各種設定を行う。<br>
<br>
まず、[Target:]プルダウンから使用するマイコンのファミリーとマイコンの型番を選択する。<br>
<br>
次に、[Connection:]プルダウンから使用するデバッガを指定する。<br>
LaunchPadボードの場合は、<u>TI MSP430 USB X [Default]</u>を選択する。<br>
<u>何を指定すればよいか不明の場合は、デバッガを接続した状態で[Identify]ボタンを押下して、デバッガとPCの接続確認を確認する。</u><br>
もし、選択が間違っている場合や未接続の場合はエラーが出力される。<br>
<br>
最後に、[Finish]ボタンを押下する。<br>
<br>
==== サンプルプロジェクトの使用 ====
サンプルプロジェクトを使用する場合、Resource Explorerツールを使用する。<br>
<br>
[View]メニューバー - [Resource Explorer]を選択する。<br>
Resource Explorerでは、サンプルプロジェクト以外にもマイコン、LaunchPadボード、ライブラリのドキュメント等の開発時に必要な資料が1通り存在する。<br>
もし、サンプルソースコード等が必要な場合は、Resource Explorerを使用して探す方がよい。<br>
<br>
Resource Explorerの起動後、使用するサンプルソースコードをインポートする。<br>
[MSP430 microcontrollers] - [Embedded Software] - [MSP430Ware] - [Devices] - [MSP430ファミリー名] - [MSP430の型番] - <br>
[Peripheral Examples] - [Driver Library] - [Example Projects] -> [サンプルソースコードの種類] - [サンプルソースコードのプロジェクト名]に保存されている。<br>
<br>
使用するサンプルプロジェクト名にマウスオーバーして、プロジェクト名の右側にある点をクリックして、[Import to CCS IDE]を選択する。<br>
これにより、ワークスペースにサンプルプロジェクトがインポートされる。<br>
<br>
なお、プロジェクトがローカルに存在しない旨のエラーが出力される場合は。[Install]を選択する。<br>
<br>
また、インポートしたサンプルプロジェクトは、プロジェクト名やファイル名を適当にリネームして使用する。<br>
<br>
<u>※備考</u><br>
<u>Resource Explorerには、多くのサンプルプロジェクトが存在しているため、様々なサンプルプロジェクトをインポートしてMSPの動作確認をすることができる。</u><br>
<br><br>


__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Windows10]][[カテゴリ:MSP430]]