LPCXpresso IDE上で、TOPPERS/ASPアプリケーションをマネージド・プロジェクトとして扱うためのスケルトン・プロジェクト

																							2011/May/6

** 概要

TOPPERS/ASPは、プロジェクトの管理をMakefileで行うことを前提にしている。この前提をASPカーネルのアプリから
切り離そうとするとハードルがハードルが高くなりすぎるため、Makefileで一度プロジェクトをコンフィギュレートした
あと、LPCXpresso IDEで管理を引き継ぐ形式のプロジェクト・スケルトンを作成した。

スケルトン化することで、TOPPERS/ASPアプリをLPCXpressoで動かす際の敷居を低くした。

** 使い方
このスケルトン・プロジェクトはLPCXpresso IDEからエクスポートしたzipファイルとして配布している。次の手順で
ビルドできる(Linux環境)。
  1. zipファイルのままLPCXpresso IDEからインポートする。
  2. 同時にインポートしたcmsisプロジェクトとsubsystemsをビルドする。
  3. LPCXpresso IDEからプロジェクトをビルドする。
  4. ステップ3で失敗したら、コマンドラインから、 config_project スクリプトを動かす（それも失敗したら後の節参照）
  
  
** プロジェクト名の変更
LPCXpresso上でプロジェクトの名前をrenameすると、関連するパスやデバッグ・コンフィギュレーションの名前も
IDEが同時に変更する。コマンドラインから変更すると、多くの環境整備を手作業でやり直すことになるので、推奨しない。

プロジェクト名を変えてもDebug Configurationは改名されない。新しい名前のプロジェクトでデバッグを開始すると、
プロジェクト名にコンフィギュレーションと、.launchを連結したコンフィグレーション・ファイルが生成されるので、
それと使うとよい。

自動生成されるコンフィギュレーション・ファイルは、プログラム起動時に main() 関数にブレークポイントを設定
するが、TOPPERS/ASPアプリケーションにはmain()関数はない。代わりに sta_ker() 関数にブレーク・ポイントを
設定するとよい。

** プロジェクト構成の変更
単にアプリケーションが使用するファイルを増やした時には、特別な作業は必要ない。IDEが自動的に登録する。

cfgファイルを書き換えてセマフォやタスクを変更した場合には、コマンドラインから make depend を実行する。

さらに大規模な変更、例えば .cfg ファイルの名前を変更するなどをした場合は kernel/configure スクリプトを
実行しなおす。kernel/configure　スクリプトの使い方については、kernel/doc 以下の文書を参照されたい。

なお、このプロジェクトのコンフィギュレーションは、以下の手順で再実行できる

kernel/configure -T lpcxpresso1768_gcc -A blink_cmsis

** configure_projectに失敗する場合。
あらかじめ以下のコマンドを実行して、TOPPERS/ASPのコンフィギュレータやキャラクタ端末を動かすための準備をしておく。

sudo apt-get install doxygen g++ libboost-all-dev lv ckermit
echo 'set line /dev/ttyUSB0' > ~/.kermrc
echo 'set speed 57600' >> ~/.kermrc
echo 'set parity none' >> ~/.kermrc
echo 'set flow-control none' >> ~/.kermrc
echo 'set carrier-watch off' >> ~/.kermrc

** その他の課題
まだ詰めの甘いところが残っているはずである。不具合やおかしな点は、TOPPERS/ASP for LPCプロジェクトの掲示板で
お知らせいただきたい。

以上
