９）resetの追加

helloを改造して、CLIコマンドにリセットを追加してみよう。

CLIコマンドを追加するには
　（１）CLIタスクヘッダーファイルの参照
　（２）CLIコマンドハンドラの関数プロトタイプの追加
　（３）コマンド宣言配列　cliCmdDefs[]　の追加
　　　　・配列の内容
　　　　　a）コマンドハンドラへのポインタ
　　　　　b）コマンド名
　　　　　c）ヘルプテキスト
　　　　　d）ユーザーレベル
　（４）CLIタスクの初期化
　（５）CLIコマンドハンドラ関数の追加
が必要である。

それではhello_app.cを編集してみよう。
hello_app.cを別名で保管しバックアップしておく。（例えばhello_app_org.c）

（１）CLIタスクヘッダーファイルの参照
ヘッダーファイル"cli_task.h"の#includeを追加する。

#include "dn_common.h"
#include "dn_exe_hdr.h"
#include "dnm_ucli.h"
#include "dnm_local.h"
#include "app_task_cfg.h"
#include "Ver.h"
#include "cli_task.h"

（２）CLIコマンドハンドラの関数プロトタイプの追加
prototypesの下の適当な場所に追加する。

//=========================== prototypes ======================================

//===== locNotifTask
static void        locNotifTask(void* unused);

//===== CLI handlers
dn_error_t cli_resetCmdHandler(char const* arg, INT32U len);

（３）コマンド宣言配列　cliCmdDefs[]　の追加
追加するresetコマンドの宣言をさらにその下に追加する。

//===== CLI handlers
dn_error_t cli_resetCmdHandler(char const* arg, INT32U len);

//=========================== const ===========================================

const dnm_ucli_cmdDef_t cliCmdDefs[] = {
   {&cli_resetCmdHandler,    "reset",       "",            DN_CLI_ACCESS_LOGIN},
   {NULL,                    NULL,          NULL,          DN_CLI_ACCESS_NONE},
};

（４）CLIタスクの初期化
p2_init関数の先頭あたりにCLIタスクの初期化関数を追加する。
int p2_init(void) {
   INT8U           osErr;
   
   //==== initialize helper tasks
   
   cli_task_init(
      "hello",                              // appName
      cliCmdDefs                            // cliCmds
   );

また、CLIポートのopenはコメントアウトしておく。

   // open CLI port
   // dnErr = dnm_ucli_openPort(DN_CLI_PORT_C0, DEFAULT_BAUDRATE);
   // ASSERT(dnErr==DN_ERR_NONE);

（５）CLIコマンドハンドラ関数の追加
cli_resetCmdHandleの関数をinstall a kernel headerの手前あたりに挿入する。

//=========================== CLI handlers ====================================

dn_error_t cli_resetCmdHandler(char const* buf, INT32U len) {
   INT8U      rc;
    
   dnm_ucli_printf("Resetting...\r\n\n");
   OSTimeDly(500);
    
   // send reset to stack
   dnm_loc_resetCmd(&rc);  
    
   return(rc);
}

//=============================================================================
//=========================== install a kernel header =========================
//=============================================================================

以上でソースファイルの編集は終了だ。
hello_app.cに上書き保存してEWARMでビルドしてみよう。
いくつかワーニングが出るかもしれない。
ocfdk_00_hello.binをESPで書き込み、動作を確認しよう。
メインだけ書き直せばよいので、私は以下のようなbatを作成した。

esp -e  1000 237
esp -P ocfdk_00_hello.bin 1000

書き込みがうまくいったら、ターミナルソフトを立ち上げてCLIに接続する。
Enterを押したら > が返ってくるだろうか？
よさげなら help と打ってみよう。


上図のようにCLIコマンドのリストが表示され、リストの最後に"reset"が追加されているはずだ。
それでは reset と打ってみよう。


Resetting...　と表示され、しばらくするとモジュールが再起動する。
最初の"hello"は（４）CLIタスクの初期化　のcli_task_init関数のappNameパラメータの"hello"で、ここを書き換えれば変更できる。
Ver 1.2.0.2 はOCSDKのリリース番号である。

以上と同じ手順で、お好みのCLIコマンドをあなたのアプリケーションに追加することができる。

変更後のソースをこちらに置きました。

コメント

コメントを投稿

このブログの人気の投稿

13）こんどはI2Cで

イメージ
SPIの次はI2Cのネタを書くだろうと思われている方のご期待に沿うべく、I2Cでもやってみよう。 今回もPIC12F1822を使用する。 下図のように接続している。 I2CはSCLとSDAの２本だけで済むので、パッケージが8ピンでも空きピンが使えてデバッグしやすい。計数するパルスはT1CKI(RA5)を出力に設定して、主な処理の途中で出力を反転させた。 mote側のappは02-i2cのi2c_app.cを改造して、CLIコマンドにデバッグ用のコマンドを追加した。 リードコマンド(rddata)とライトコマンド(wrdata)、I2Cアドレス設定コマンド(wraddr)の３つである。 I2Cアドレスの初期値は0x66とした。 CLIから"rddata 2"と打つとカウント値２バイトが読める。 バイト数は32バイトまで設定できるが、３バイト以降は適当な値（0x02からインクリメント）を返すようにしている。 ライトコマンドも受け付けるが、PIC側で受けた値は捨てている。 下図は"rddata 2"を打った時の観測結果である。 Sleepから復帰して再度Sleepするまで約520usecになっている。 SPI改よりもさらに短くなった。 PICのクロックは2MHzに設定している。 PICのSSP割り込み処理の先頭で内部OSCの安定（HFIOHL=1）を待っている。 この時間は上図の左のカーソルからRA5の最初の立ち上がりまでなので、およそ140usecくらいだ。 その後、SSP1IFチェック、SSP1IFフラグクリア、SSP1BUF読み出しまでが最初のRA5=1の間の処理である。 RA5をクリア後、Read ModeとWrite Modeの振り分け、AddressとDataの振り分けを行う。 ここではRead（mote <- PIC）、Address検出なのでRA5をセットしTMR1のカウンター値の読み出し処理を行う。 2番目のRA5=1の部分が、TMR1のカウンター値の読み出し処理時間である。 カウンター値を読むまでにRA5の立ち上がりエッジは2回あるので、カウンター値の最初の値は0x0002になる。 SSP1CON3のAHEN=1
続きを読む

12）非同期パルス

イメージ
毎分数パルスから数十パルスのパルス数を、moteで観測するにはどうすればよいだろうか？ GPIOの入力の変化で数えさせても可能なのだが、変化があるごとにアプリが起動することになるので、わりと電池を食ってしまいそうだ。 外付けの省電力マイコンのタイマーカウンターでカウントさせて、一定時間ごとにシリアル通信から読むのはどうだろう。 Sleepさせておいて、通信する時だけ起こせば消費電力を抑えられそうだ。 そこで手元にPIC12F1822があったので、試してみることにした。 シリアルI/FはSPIとI2Cのどちらにするか迷ったのだが、以前SPIで似たものをやったことがあったのでSPIを使うことにした。 （実はこれが後でやっかいなことになる。） 各信号（SS,SCLK,SDO,SDI）の接続は下図のようになる。 moteがMaster、PICがSlaveになる。 パルスカウントはTMR1を使う。 TMR1のクロック入力T1CKIはシュミットになっているので、バッファなしで大丈夫そうだ。 Sleep中もカウンターは動作するので、その点もクリアしている。 PICのクロックはHFINTOSCの16MHzに設定しておいて、動作確認後に落としていこうと思っていた。 PIC12F1822のProgram Memoryは2KWなので、ASMで組むことにした。 Sleepからの復帰はSSP1の割り込みで行えば良さそうだ。 moteのSPI通信のバイト長は2の倍数なので、4バイト長に設定して後半の2バイトにTMR1の16bitカウンター値を乗せるようにしたいと思った。 moteのFWはappの02-spiをほぼそのまま使用した。 SPI_TX_BUFFER_LENGTHを4に変更するだけで4バイトのSPI通信を1秒ごとに実行してくれる。 PIC側は割り込みサービスでほとんどの処理を行い、mainはSleepのみといった構成になる。 SSP1の割り込みが発生した時点で1バイト目のデータがSSP1BUFに入っているので、フラグをクリアして2バイト目以降を待つ。 2バイト目以降はSSP1STATのBFが1になるのを待って、TMR1Hの値を2バイト目の終了時、TMR1Lの値を3バイト目の終了時にSSP1BUFに書き込めばよいはずだ。 PI
続きを読む

２）OnChipSDKとは

OnChipSDK とは、モート（子機）のFWにオリジナルのアプリケーションを追加したセミカスタムFWを作るためのSDKである。 コンパイラーはIAR社の EWARM のみで、 dustcloudのドキュメント では、評価用EWARMの32KB限定版は使えない（コードが32KBを超える）ので、正式版を買い、さらにデバッガー（i-Jet）もeShopで買えと書いてある。 お試ししたいだけなのに、高いコンパイラを買うなんて無理ですよ。30日期間限定版で試せないんですかね？と前から思っていたので試してみようと思う。 Getting Started の手順に従って準備をしていく。
続きを読む