ラベル FreeRTOS の投稿を表示しています。 すべての投稿を表示
ラベル FreeRTOS の投稿を表示しています。 すべての投稿を表示

2017年4月9日

[esp8266][rtos]MQTT publisher

MQTT v3.1の仕様を眺めたり、他のMQTT clientを動かしてwiresharkでログを取ったりしながら、ESP8266 RTOSでMQTT publishだけするアプリを作った。

https://github.com/hirokuma/Esp8266SimpleMqtt

 

仕様は、この辺を読んでいる。
https://www.ibm.com/developerworks/jp/websphere/library/wmq/mqtt31_spec/

ドキュメントとしては、あんまりわかりやすくないと思う。。。
が、日本語で書いてあるので、助かる。

 

これはプロトコルバージョン3なのだけど、wiresharkで見ていたクライアントは4のようで、校正が違っていた。
まあ、気にすまい。

2017年4月4日

[esp8266][rtos]ほどよいMQTT client

せっかくESP8266でSmartConfigすれば外部からWiFi APの設定ができることが分かったので、なにか動くアプリを作りたい。
ただ、今はセンサも何もつないでいないので、定期的にどこかに送信する、程度のことができれば良い。

であれば、MQTT brokerに向かってpublishするだけ、というのが簡単そうな気がする。
ほどよいMQTT client APIがなにかあるだろう。


Pythonではpahoを使っていたが、そのC版をESP8266のRTOS版に移植したものがあった。
baoshi/ESP-RTOS-Paho: Port of Eclipse Paho C client on ESP8266

よさそうなのだけど、ちょっと大きいなぁ。
メモリに制限があるから大きなpublishをすることもないし、QoSも0しか使わないだろうから(publishにQoSあったっけ?)、v3.1くらいの内容であれば自分で実装してもよいかもしれない。

でも、既にできているプロジェクトを取り込むのも勉強になるし。
うーーーーむ。。。

 

そうか、両方やればいいんだ。
自分で作ると柔軟性も拡張性もないがサイズが小さなライブラリができるだろうから、それはそれで使い道があるかもしれない。
その後でPahoを移植したライブラリを組み込めば、あれこれできるようになるので、それもよいことだ。

むかし仕事で作った実装を見るのはさすがに反則だから、ちまちまやっていこう。

2017年3月31日

[esp8266][rtos]RTOS環境のビルド

Bash on Ubuntu on Windowsの動きがあやしかったので、Xubuntu 16.04にESP8266のRTOS環境を作り直した。
以前も同じ作業をしたのだが、別VMになったから、復習も含めて書いておこう。
まあ、Arduino版を使っている人の方が多い気はするんだけどね。。。


今回は、$HOMEの直下にEsp8266というディレクトリを作り、そこで作業した。
ここを読んで、apt installが必要なものは済ませてある。
https://github.com/pfalcon/esp-open-sdk

$ mkdir Esp8266
$ cd Esp8266
$ git clone --recursive https://github.com/pfalcon/esp-open-sdk.git
$ cd esp-open-sdk
$ time make STANDALONE=n

VMをHDD上に作っているし、あまりリソースを割り当てていないせいもあるが、40分くらいかかった。

$ cd ..
$ git clone https://github.com/espressif/ESP8266_RTOS_SDK.git

こちらはcloneするだけだ。

 

次は、環境変数などの設定。
.bashrcなどに置くか、使いたいときだけ設定するのかは個人の自由だ。
私は、使いたいときだけ設定するようにした。

$ mkdir rom

romディレクトリは、ビルド後にESP8266へ焼く物が置かれる場所だ。
SDK環境だとbinという名前なのだけど、binだと「ここに実行ファイルおいたっけ?」といつも思ってしまうので、名前を変えただけだ。

 

そして、HOME/Esp8266の直下にこういうスクリプトファイルを置いた。
私は「compile.sh」という名前にしたが、別にどうでもよい。
コンパイルできる環境変数を設定するためのスクリプトだから、名前は今ひとつだったか。。。

#!/bin/sh
export SDK_PATH=`pwd`/ESP8266_RTOS_SDK
export BIN_PATH=`pwd`/rom
export ESP8266_PATH=`pwd`/esp-open-sdk
export PATH=$ESP8266_PATH/xtensa-lx106-elf/bin:$PATH
export ESP8266_INCLUDE_PATH=$ESP8266_PATH/sdk/include
export ESP8266_LIB_PATH=$ESP8266_PATH/sdk/lib

これは、HOME/Esp8266ディレクトリで使うように`pwd`を使っている。

 

設定はこのくらいだ。
おまけで、こういうスクリプトファイルを作って、オリジナルのgen_misc.shと置き換えている。

ESP8266 RTOSビルド用gen_misc.sh

いつもgen_misc.shするたびにコンソールで答えていくのが面倒なので、自分がよく使う設定を書いただけだ。
うちはWROOM-02なので、各自好きに変更するのもよし、使わないのもよし、だ。


試しにビルドしておこう。

$ source compile.sh
$ cd ESP8266_RTOS_SDK/examples/wps_demo
$ (gen_misc.shを置き換えた)
$ ./gen_misc.sh

うまくいくと、rom/upgrade/user1.4096.new.6.binができているので、それをESP8266へ焼けばよかろう。

ただ、ESP8266のWPSはAPによってうまくいかないものがあったので、正しく動くかどうかは保証できん。
それに、デフォルトだとうちのUSBシリアル変換ではアクセスできないbpsでログが出てくるので、うまくいったかどうかわからん。
試す場合は、その辺に気をつけるのがよかろう。

[esp8266][rtos][bow]RTOS SDKを更新しようとしてあきらめる

久しぶりに休暇を取ったので、ESP8266のRTOS版で遊んでみよう。
と思ったが、インストールしてから長いこと放置しているので、RTOSの部分が古くなっているかもしれない。
更新しておこう。

環境は、Windows10 64bitのBash on Ubuntu on Windowsだ。


RTOS SDKは、昔はEspressifからダウンロードしていたのだが、今ではgithubで管理されている。
espressif/ESP8266_RTOS_SDK: Latest ESP8266 SDK based on FreeRTOS

Non-OS版はコンパイラも一緒になっていたのだが、RTOS版ではgcc推奨になっていて、それはesp-open-sdkと呼ばれているようだ。
pfalcon/esp-open-sdk: Free and open (as much as possible) integrated SDK for ESP8266/ESP8285 chips

だから、この2つを更新する必要があろう。


まずはesp-open-sdkから。
https://github.com/pfalcon/esp-open-sdk#building

さて、STANDALONEはyだったかnだったか。。。
http://hiro99ma.blogspot.com/2016/12/esp8266esp-open-sdkstandalonen.html
ここを見ると、nでやっているように見える。

 

が、不安が。
当時の私はSTANDALONE=nの方がライセンス的に大丈夫そうだ、という判断をしているのだが、その翻訳は正しかったのだろうか?

To build the bare Xtensa toolchain and leave ESP8266 SDK separate

この一文の「separate」だけで判断していなかっただろうか。
ちゃんと英文を読もう。

Build

プロジェクトは2つのビルドモードがある。

  1. バイナリも含め提供されるベンダのIoT SDKから切り離す。ライセンスもクリアで、ベンダのSDKアップデートにも対応しやすくなる。
  2. 完全にツールチェーンがマージされたベンダのSDKファイルからも分離する。このモードはソフトウェアのビルドを容易にする(-Iや-Lなどを追加せずに済む)。しかし、ビルドしたものの再配布はライセンスがクリアではなく、ベンダが提供する新しいバージョンのIoT SDKリリースが行われると複雑になる。このモードはローカルビルドとしてデフォルトだ。(以下略)

というわけで、1がSTANDALONE=nだと思う。
2はデフォルトと書いてあって、makeの引数無しはSTANDALNE=yだからだ。

 

では、git pullしてmakeしなおそうと思ったが、よくわからんエラーが。。。

fatal: index file open failed: Input/output error

不思議なことに、このエラー自体はフォルダを移動したりしているうちに直った。
どうも、BoWはファイル周りがまだ弱いような気がする。

もう一度git pullすると、今度は「examples/blinky/Makefile」がどうのこうのと。
git statusしてみると、Changesの方にdeletedでずらずらファイルが並んでいる。
そこにexamples/blinky/Makefileも入っているのだが、実際にはファイルがある。。。
そして、Untrackedの方にはexamples/が入っているのだ。
もう、何が何だか。。。

では、examplesをexamples_にリネームしよう。

$ mv examples/ examples_
mv: cannot move 'examples/' to 'examples_': No such file or directory

はあ?

$ mv examples/ examples_
$

2回同じことをやったら動いた。
これ、BoWでgo言語をやったときにも出てきたな。
これをしても、まだexmaples/blinky/Makefileがどうのこうのというから、BoWが原因で起きているような気がする。

 

気がする程度ではあるが、不安な環境でやるような作業でもないので、VMのLinuxでやろう。。。

2016年8月21日

[FreeRTOS]音を鳴らす

せっかくなので、音も鳴らしてみた(github)。

うちにあったのは、京セラの圧電スピーカだった。
圧電なんとかって、全部ブザーかと思っていたのだが、電池をつないでなるのがブザーで、ちゃんと制御せんといかんのがスピーカーだとか。

これを、片方をNUCLEOのPWM/D9に、片方をGNDに突っ込んだ。
電気的によいのかはわからないが、音は出る。

 

まあ、細かいことはさておき、PWMで周波数を変えるとちゃんと音程が変わったので、満足だ。
音だけのアップロードをどうやってよいかわからないので、ファイルを置いた。
動画さえ入れれば、YouTubeでもよいらしいが。。。
https://drive.google.com/open?id=0B2_3hJpJ5Ui2cHhuM0FLbV94OG8

イメージはこの音なのだが、まあだいたいこんなもんだろう。
人造人間キカイダー ギルの笛の音 - YouTube

 

今回は、SW入力でON/OFFするタスクと、音程を制御するタスクの構成にした。
PWMなので、OFFのときはPWMを止めればよいのだが、そうすると音程タスクの方で音楽が進んでしまうので、Suspended状態にすることにした。
スケジューラ開始前にもSuspendしているが、ちゃんと止まっているようだ。
たぶん期待通りだと思うが、時間計測をしていないので、どの辺で停止したのかよくわかっていない。

OSを使っていると、音程を制御するのは楽だった。
音程の設定をして、流したいだけの間vTaskDelay()するだけだからだ。
改めて、OSは楽をするためだけに導入するものだ、と認識した。

 

しかし、こういう単調な音は、テストしている間がきつかった。
何かが破壊されてしまいそうだったよ。。。

2016年8月20日

[nrf52]HRSサンプルのFreeRTOS版は何をしているのか

私のイメージでは、になるが、OSがあるんだったら機能ごとなどにタスク分けして使うもんじゃなかろうか、と思っている。
そうでなければ、OSのフレームワークを使うことで便利になる何かがあるはず。

nRF5 SDK v11.0.0のHRSサンプルは後者のようだ。


まず、普通のHRSサンプルではmain()から呼んでいる処理を、タスク側で呼ぶようにしている。
main()でやるのは、セマフォやタスクの生成とスケジューラの開始だ。

それ以外の構成は、普通のHRSサンプルとそれほど変わらない。
DFUなんかは外してあるが、わざとなのか、単に入れなかっただけか。
DFUが入ることでRTOSの邪魔になる、あるいはRTOSがDFUの邪魔になるというのは、ないと思う。
だから、DFUが入っていないサンプルにFreeRTOSを突っ込んだのではなかろうか。

 

タスクは1つだけで、通常やっているのはxSemaphoreTake()とintern_softdevice_events_execute()。
Takeで待ち合わせ状態になり、誰かがGiveすると解除になるようだ。
なんだっけ、TakeがPで、GiveがVか。

intern_softdevice_events_execute()は初めて見たが、softdevice_handler.cが持っている。
中でm_ble_evt_handler()などが見えるので、これが自分のところのon_ble_evt()を呼び出す契機になるのか。

ただ、GAPというかAdvertisingはなさそうだ。
経路が違うのかな?
いや、ble_advertising.cにon_ble_evt()があるので、m_ble_evt_handler()で呼び分けられているのか。

タスクになったからといって、on_ble_evt()などに違いはなさそうに見える。


大きく違うのは、タイマハンドラか。
xTimerCreate()を使っているが、これはSoftware Timersという分類になっている。
今まで、タスクからDelayやDelayUntilを呼んで定期処理にしていたが、こっちはタイマサービスのコンテキストで呼び出すから、そういうAPIは呼んだらいかん。

サンプルでも、やっているのはnRF5 SDKのAPIを使っているだけだ。
うーん、じゃああまりサンプルとしてはRTOSの魅力を出せていないけれど、サンプルにそれを求めるのは酷か。

 

ちょっと気にしているのは、キューに突っ込んだりすると割込禁止にしていたので、BLEとして影響があるんじゃなかろうか、というところだ。
SoftDeviceとOSって、相性が悪いと思うのだよねぇ。。。
無線チップが別になっていれば、うちはうち、よそはよそ、でよいのかもしれんが。

[勉]FreeRTOS (9) - 完

ぐだぐだになりそうなので、ここでFreeRTOS編を終わらせることにした。

おおざっぱなブロック図は、こちら。
Vcc1が3.3Vではダメなのだけど、NUCLEOは5Vも出ているのでそれを使うことにした。

image

 

NUCLEOの接続は、こう。
「VOL」は、ポテンショメーターでADCし、「EN」はPWM出力している。

image

 

タスク構成は、こうなっているはず。

image

 

ソースはこちら。
Src/main.cくらいしか変更しておらず、あとはSTM32CubeF4の出力を使っている。


だいたい期待通りに動作していると思う。

めんどくさいことをしていないというのもあるが、FreeRTOSはこの程度であればあまり苦も無く使えた。
そう思って本番で使うと苦労するのかもしれんけど、使ってみてもよいかな、と思わせてくれる。

ESP8266のRTOS版もFreeRTOSを使っているのだけど、いまはV7.5.2ベースみたいだ。
NonOS版だと、Linuxのread()みたいに、受信サイズがたまるまで待たせる、という処理が書けなかったので、やってみたい気もする。
まあ、また今度だ。

[勉]FreeRTOS (8)

ADCで値が取れるようになったので、ちょっと寄り道して、ログを出力するルートを変更しておきたい。

今はVolTaskからUARTドライバを呼び出して直接出力させているのだが、これをUartTask経由で出せるようにしたいのだ。
そうしないと、各タスクがログを好き勝手に出してしまって、何が何だかわからなくなりそうだからだ。

目標としては、こういう感じだ。

image


このイメージになりそうなので、間にキューを置いている。
キュー制御用API関数の使い方

タスク生成と同じようにしてキューを生成し、ハンドル値をグローバル変数にとっておいて、各タスクはそのハンドルを使って書いたり読んだりするようだ。
あれ、ハンドルはみんなで使うようだけど、排他はいらないのかい?

こちらを読むと、MUTEXを使わずにキューで処理するやり方が書いてあるので、キューであれば排他はいらないようだ。
排他制御(MUTEX)の使い方

なんでだろう?
xQueueSend()の中身であるxQueueGenericSend()を見ると、かなり最初の方でtaskENTER_CRITICAL()を呼んでいる。
つまり、誰か最初に呼んだ人がディスパッチ禁止にするわけだ。
キューを使うときはタスク間通信が主で、だったら排他がいるから自動でやっておくか、というところか。
ディスパッチ禁止は移植対象で、ARMの場合はBASEPRIをいじって割込みを禁止させるみたい。

おおざっぱだけど、割り込み処理用にAPIが別にあるものは、内部でディスパッチ禁止処理を行うようになっていると思っていてよいのだろう。

 

受ける方のxQueueRecive()はタイムアウトを指定できて、無限にしておくとキューにたまるまでは待ってくれるようだ。

変更したプロジェクトは、こちら。
案外、あっさりと動いてくれた。

今頃気付いたが、FreeRTOSはドライバレベルについてはOSで面倒を見ないから、別マイコンに移植するつもりがあるなら自分でやることになるんだな。
まあ、最近は他のマイコンに載せるといっても同系列のマイコンだったりするので、そこに時間を掛けるよりもさっさと作れてしまうほうがありがたいかも。

2016年8月19日

[勉]FreeRTOS (7)

さて、FreeRTOSで定周期処理をやろう。

 

タスク制御用API関数とタスクの作り方 - 電子工作室

こちらによると、vTaskDelay()で処理中に待たせる方法と、vTaskDelayUntil()でタスク自体を一定周期で起動する方法があるらしい。

vTaskDelay()は、その場でtick分待つだけなので、間に割込みされても、その分は気付かず、また戻ってきてから待つことになる。
それに対してvTaskDelayUntil()は、呼び出す周期を設定するようになっているので、割り込みされようとカウントしてくれるらしい。

「今から1秒寝ます!」と、「1秒ごとに目覚ましが鳴るので、それまで寝ます!」の違いか。
だいたいは後者の方が同じタイミングになって良いけど、その前の処理は次のタイミングの前に終わっていてほしい、というのはあるな。


1秒おきにA0ポートをADCして、2ビット落とした値をUART出力させるようにした(github)。

いやあ、ここまでに時間がかなりかかった。
ADCは連続モードで最初に開始させて、あとは取得するだけにしようとしたのだが、

  • 連続モードにしても1回しか変換してくれない
  • 値が変

と2つ問題があった。
どちらもFreeRTOSではなく、STM32の使い方だ。

前者は、おそらくEnd Of Conversion Selectionの設定だと思う。
リファレンスもではCONTビットを立てればよいように書かれていたのだが、デフォルトの「single channel conversion」のままだと、そちらが優先されて終わってしまうようなのだ。
ドキュメントで見落としたかな?

image

後者は・・・単純な設定ミスだ。
A0の設定をしていたつもりで、ずっとA1の方を設定していたので、オープンにしたままのA1から読み取っても毎回不定になっていたというだけだ。
いやぁ、ミステリー小説にありそうな、大元から違っている、というトリックですな。

 

1秒ちょうどか確認したいけど、TeraTermのログでは1秒くらいだけど、このくらいだとよくわからんですな。
もうちょっと処理がゴチャゴチャしていて、遅延しそうってくらいにならんとわからんだろうから、今回は深追いすまい。

[勉]FreeRTOS (6)

Arduinoでモーターを動かせたので、その回路をそのままNUCLEO-F411REで使ってみよう。
NUCLEOはArduinoと同じピン配置のコネクタを持っているので、そのまま移し替えられるはずだ。

D9はPC7、A0はPA0だ。
PA0はAnalog_GPIOだとして、PC7はどれにすればよいのだ?

image

STM32では、PWMはタイマの項目になるらしい。
http://visualgdb.com/tutorials/arm/stm32/pwm/

Duty比は、PeriodとPulseで決まるらしい。

image

この設定だと、こうなった。

image

93.028 ÷ (93.028 + 139.97) = 40%くらい

200 ÷ 500 = 40%

おお、比率はあってる。
プリスケーラの40000は、まねしただけなのだけど、どういう関係なのだ?

STM32F4 PWM tutorial with TIMERs - STM32F4 Discovery
タイマのtickが、デフォルト周波数 / (prescaler+1)になる。
TIM3は、APB1につながっているので、デフォルト周波数はAPB1のものになろう。

image

などと探すまでも無く、Clock ConfigurationにTimer clocksが載っていた。
今は84MHzになっている。

image

tick = 84MHz / (40001) = 2100Hzくらい

PWM周波数=tick / (Period+1)なので、

pwm = 2100くらい / 501 = 4.19Hzくらい

4.19Hzは239msecくらいだ。
93.028 + 139.97は233msecくらいで、5msecくらい違うのだが、誤差の範囲でよいのか?
tick換算すると10tickくらいになってしまうのだが。

値が適当すぎたので、もうちょっと計算しやすい値にしよう。

image

tick = APB1 / (Prescaler+1) = 84MHz / 8400 = 10kHz
PWM = tick / (Counter Period+1) = 10kHz / 500 = 20Hz
周期 = 1 / 20Hz = 50msec
Duty比 = Pulse / (Counter Period+1) = 200 / 500 = 40%

で、1周期50msec、Hなのは50msecの40%で20msecになるはず!

image

19.54ms + 29.311ms = 48.9msecくらいなので、ちょっと短いか。。。
元が内蔵16MHzだと、そこまで精度が出ないということか?

image

最大4%くらいか。
短い方に振れると、50msecが48msecくらいになるな。
うん、こんなもんとしておこう。

ここまでのソースは、こちら。


機器の構成は、こうなる。

image

SWはチャタリングするし、ポテンショメーターも値がバタバタするので、ヒステリシスを持たせたい。

 

今はタスクの先頭でPWM開始を行っているだけだが、SW2つとADCもここに集めてしまって、input/output用タスクにした方がよいだろうか。

あるいは、ここはタスク間通信で制御要求されたものをoutputするだけにして、inputは別タスクにした方がよいだろうか。

inputのごとにそれぞれタスクを作るというやり方もある。

image

 

タスクが多くなるとメモリも使うし、ディスパッチが増えて効率が悪くなる。
かといって1つのタスクに機能を詰め込むと、OS使ってるのにわかりづらい…となってしまう。
難しいねぇ。

このくらいだったらどれでもよさそうなので、SWとVOLをタスク分けしてみようか。
SWは同じタイミングで全部読み取りたいけど、VOLとはタイミングを変えたいのだ。
1つにまとめてもできるけど、まあ、分けた方がきれいな気がする。

私の設計って、いつもながら適当よね。。。

 

というわけで、次回は定周期で値を読み取るタスクにしていこう。

2016年8月18日

[勉]FreeRTOS (5)

そろそろ本業が開始できるようになってFreeRTOSシリーズを打ち切る、という状況になってほしいのだが。。。
もうちょっとやります。


http://www.freertos.org/RTOS-idle-task.html

自分が作ったタスクが1つでも、その1つがSuspended状態になったら誰かが表に出てくることになる。
その誰かがIdleタスクだろう。

vTaskStartScheduler()を呼ぶと、その中で自動的に生成している。
一番優先度が低いので、普通は動かずにReady状態になっている。

さっきは「誰かが表に出てくる」と書いたが、どうやらタスクが削除されてメモリを解放するという役割を負っているようだ。
前回のvTaskDelete()が、それらしい。

2つくらいやり方があるようなので、興味があれば見てみるとよいだろう。
tasks.cも一緒に追った方がわかりやすそうだ。

 

タスクについては、これで一周したようだ。
タスクと似たようなものとしてコルーチン(Co-Routine)もあるようだけど、そっちはいいや。
タスクとコルーチンの違いの説明に「very small devices」とあるけど、ARMは小さくないと思うのだ。
いるときが出てきたら、読もう。


タスクの次は、何を読もうか?
使いたいとしたら、こういうところか。

  • タイマ処理
  • タスク間通信
  • メモリのこと
  • 排他
  • 割込み

盛りだくさんだけど、タスクが1つだったらOS使わなくてよいだろうし、タスクが複数だったらタスク間の通信がいるし、メモリも動的にとったり共有したりするし、そしたら排他もいるし、と、全部いるはずだ。

[勉]FreeRTOS (4)

前のサンプルで気になったのだが、osDelay()はタスクが動いていると見なされるのだろうか?
見なすのであれば、それよりも優先度の低いタスクにはディスパッチしないはずだ。

defaultTaskをosPriorityHigh、uartTaskをosPriorityNormalにしたところ、どちらも動いたが、StartDefaultTask()でosDelay()をコメントアウトするとUARTログが出なくなった。

ということは、osDelay()は優先度の高いタスクが「ちょっと今なら別タスクが動いてもいいよ」というときにも使えるということだろう。
あるいは、優先度が高くてもosDelay()が入るとディスパッチされる可能性がある、ということになる。


タスクの状態は4つある。

  • Running
    • ちょうど今、動いている
  • Ready
    • 動こうと思えば動けるのだが、他のタスクが動いているので待っている
  • Blocked
    • 何かの要因によって待たされている(vTaskDelay()など)
    • この状態の時、プロセッサの資源は消費しない
  • Suspended
    • Blockedに似ている
    • 直接Runningになることはできないが、vTaskResume()でReadyになることはできる


(説明図)

vTaskSuspend()を呼ぶとどの状態からでもSuspendedになりそうだが、Running状態にならないと実行自体できないんじゃなかろうか?
あるいは、タスク名を指定して実行とかができるとか?

まあ、これは疑問のまま残しておこう。


http://www.freertos.org/implementing-a-FreeRTOS-task.html

タスクの実装なのだが、vTaskDelete()などがSTM32CubeF4で作った方には出てこなかった。

コメントの箇所を読んでみると、returnさせようとしちゃいかん、さもなくばexitせよ、などと書かれている。
exitといっても、exit()ではなく、vTaskDelete()で後片付けをしてから抜けろよ、ということらしい。

 

arm - STM32 freertos thread is not working - Stack Overflow
ここのコメントに、osThreadDef()なんかはFreeRTOSの提供物じゃないよ、と書かれていた。
grepすると、確かに無い。
STM32CubeF4だと、Source/CMSIS_RTOS/cmsis_os.hの中にあった。

便利でよかったのだけど、標準じゃ無いなら、FreeRTOSを使ってみるという観点からすると困るな。
ひとまず、今のサンプルを置き換えた。

[勉]FreeRTOS (3)

前回の、ほぼ素のままのソースをビルドした結果を残しておこう。

text    data     bss     dec     hex filename
11336      16   17328   28680    7008 build/FreeRTOS1.elf

BSS、こんなに??
17KB近く使ってるじゃないか。。。

NUCLEOに載っているF411RETは、SRAMが128KBもあるので、まだ余裕があるといえばあるのだが、FreeRTOSとはいえ使いすぎじゃ無いか?

 

いや、待て。
新規プロジェクト生成直後で、FreeRTOS無しの場合を見ておこう。

text    data     bss     dec     hex filename
4812      12    1572    6396    18fc build/original.elf

ほぼ空なのに1.5KBも使っているのが気になるが、けっこうなサイズをFreeRTOSが確保することがわかった。
1.5KBも、ヒープサイズで0x200、スタックサイズとして0x400確保ししているためのようだ(STM32F411RETx_FLASH.ldの_Min_Heap_Sizeと_Min_Stack_Sizeだろう)。

 

FreeRTOSを使う場合も、ヒープとスタックは同じだけ確保している。
ただ、別途FreeRTOS用のヒープ領域を0x3c00確保しているので、もしFreeRTOS以外でヒープを使わないのであれば、Min_Heap_Sizeは0にしてよいのかもしれない(FreeRTOSが立ち上がるところで使うかもしれないので、断言はできんが。。)。

スタックもタスクごとに持たないとダメなんじゃなかろうか?
OSが無いなら、今実行しているメインスレッドのスタックと、割込みで実行するときのスタックがあれば済むだろうけど、メインスレッドのところが複数タスクになるので、それぞれのタスクでスタックを持っておかないとダメだろう、という考えだ。

FreeRTOSConfig.hにconfigMINIMAL_STACK_SIZEという定義があったから、これがスタックサイズなのだろう。
128だった。
その下にconfigTOTAL_HEAP_SIZEが15360で定義してあり、イコール0x3C00だ。

そういう感じで、configファイルに定義したものが反映されていくようだ。


FreeRTOS - Quick start guide

ソースを取ってきて、Demoでも動かしてみよう、くらいしか書かれてない。。。
それ以外はリンク先をいろいろ見るようだが、PDFを売っているようなので本来はそっちを読んでほしいのだろう。

 

しかたないので、main.cを見ていく。
タスク生成しているのは、これだろう。

osThreadDef(defaultTask, StartDefaultTask, osPriorityNormal, 0, 128);
defaultTaskHandle = osThreadCreate(osThread(defaultTask), NULL);

defaultTaskHandleはosThreadId型なのでわかるし、StartDefaultTask()も関数があるのでわかる。
では、このヘッダにも定義がないdefaultTaskというのは何だ?

あー、osThreadDefはマクロだ。

const osThreadDef_t os_thread_def_##name = \
{ #name, (thread), (priority), (instances), (stacksz)  }

ここだと、

const osThreadDef_t os_thread_def_defaultTask =
{ "defaultTask", StartDefaultTask, osPriorityNormal, 0, 128 };

defaultTaskHandle = osThreadCreate(&os_thread_def_defaultTask, NULL);

となる。
マクロで#を使うと、ダブルクォーテーションで展開されるんだな。

そしてosKernelStart()でカーネルが起動される、と。
main()はその後どうするかというと、無限ループになっている。
タイマ割込でラウンドロビンするのであれば、ここはWFIで寝かしてしまってもよいのだろうか?

__WFI()を入れてみたが、見て目には変わらないようだ。
ロジアナで点滅間隔を見てみるくらいしないとわからないかもね。

image

10msec間隔にしたが、まあこんなものか。
じゃあ、WFIした方がよいのかな?

あ、nRF5 SDKのサンプルを見ると、whileループしているのは同じだが、ループに入るとエラーハンドラが呼ばれるようになっている。
つまり、OSを終了しないと呼ばれないから、何があってもあまり関係ないということか。。。

開始するとIDLEタスクが作られているようだから、何もしていないときに無限ループで待つのではなく、IDLEタスクが実行されるだけか。

INCLUDE_xTaskGetIdleTaskHandleが1だと、IDLEタスクのハンドラを取得できるらしいが、IDLEタスクの関数を見ても何をやってるのかさっぱりわからん。。。


では、まねしてみよう。

まずはタスクを追加する。
今回は、UART2に送信を行うタスクにする(github)。

osThreadDef(uartTask, StartUartTask, osPriorityNormal, 0, 128);
osThreadCreate(osThread(uartTask), NULL);

名前が違うだけで、やっていることは同じですな。

起動されるタスクは、こう(github)。

void StartUartTask(void const * argument)
{
  /* Infinite loop */
  for(;;)
  {
    HAL_UART_Transmit(&huart2, "Hello!\r\n", 8, 200);
    osDelay(500);
  }
}

"Hello!"の出力を、500msec間隔で行うだけだ。
これで動いた。

uITRONだと、configurationファイルを書いてコンパイルするけど、FreeRTOSはヘッダファイルに書いてソースで作るだけのようだ。
これを静的にできるようになったのがV9なのかな?

2016年8月17日

[勉]FreeRTOS (2)

前回は概要をさらっただけなので、今回はもう少し中身を見ていこう。

 

私が持っている、STM32F411REが搭載されてNUCLEO-F411REを使おうかと思ったのだが・・・。

STM32Cube BSP with FreeRTOS for STM32 ARM Cortex-M
STM32CubeMX

なんと、FreeRTOS対応のSTM32Cubeがあるんだと!
「テスト開始!」っていわれて解答用紙を見たら、既に答が書いてあった気分だ。

まあ、移植する作業からやるつもりもなかったし、よしとしよう。


ステップ1は、STのホームページからSTM32Cubeをダウンロードする。
今の最新は、4.16.0だ。

あれ、STM32CubeMXはEclipseのプラグインのようだ。
以前はスタンドアローンだった気がするのだが、記憶違いか。。。

ああ、STM32Cubeは、F1とかF4でまたダウンロード先が分かれているんだ。
私はSTM32CubeF4ということになる。
この辺、ちょっと紛らわしいな。。。

STM32CubeF4を解凍すると、こっちはプロジェクトやらドキュメントやらの一式だった。
STM32CubeMXはインストーラが入っていた。Windows, Linux, Macの全部が入っているようだ。

まずは、STM32CubeMXをインストールする。


ステップ2では、STM32CubeMXを起動する。
"Help > New Libraries Manager"を選択すると、ダイアログが表示させる。
Firmware Packageの一覧が表示されるので、私は「STM32CubeF4 Releases」の一番上(1.13.0)をチェックして"Install Now"。

なんかエラーが出た。

image

よくわからないので、左下の"From Local..."で、先ほどダウンロードしたSTM32CubeF4のzipファイルを指定する。

そうすると、もごもごやってインストールされる。


ステップ3は、プロジェクトの作成。

CubeMXの画面に戻って、左から"New Project"をクリック。
そうするとダイアログが表示される。
手順ではMCUから順番に選択していくのだが、今回はNUCLEOなのでBoard Selectorタブで選ぶ。

image

UARTが出てこないけど、そういうのは設定済みでよいのか。
まあ、CubeMXで設定できるだろう。


ステップ4は、ピンの設定。
ステップ5は、周辺の設定。
ステップは8まであるのだが、あとはCubeMXの使い方になっていくので、ここでは省略する。

Pinoutタブの項目には最初からFreeRTOSが入っているので、これをチェックすればうまいことやってくれるのだろう。

image

 

プロジェクトの設定をしてからソース生成してもらうのだが、その辺りは自分の環境に合わせよう。
私はGCCでやりたいので、ToolchainをSW4STM32にして、Makefileに変換するスクリプトを作ってくれている方がいるので、それを使うことにした。

変換して出てきたMakefileは、Windowsのコマンドプロンプトではうまくいかなかったが、cygwinでは通った。
Windowsの時に何かコマンドが見つからなかったようなのだが、まあいいや。


これで、ビルドできる環境だけは整った。
ただ、実際に何か動かさないと、ビルドできても動くかどうかわからない。。。

自動生成されたソースはいろいろあるが、ユーザ用はここだろう。

image

その4つのソースファイルのうち、下2つは初期関係なので省略。
main.cはいろいろ書けるようになっているが、タスクを起動する様子がうかがえるので、StartDefaultTask()にLEDを点滅する処理を書けば、そこまで動いているか確認できそうな雰囲気がある。

/* StartDefaultTask function */
void StartDefaultTask(void const * argument)
{

  /* USER CODE BEGIN 5 */
  /* Infinite loop */
  for(;;)
  {
    osDelay(1);
  }
  /* USER CODE END 5 */
}

使っているBlogエディタが、プラグインに対応できていないので、ソースコードはそのままだ。
見にくくて済まない。。。

まあ、このソースを見た感じでは、osDelay(1)が1msecか1secかわからないけど待つだけだろう。
コメントでBEGIN~ENDがあるのは、その間にユーザコードを埋め込むようにしておかないと、CubeMXで設定を変更して自動生成し直したときに消えてしまうのだ。

void StartDefaultTask(void const * argument)
{

  /* USER CODE BEGIN 5 */
  /* Infinite loop */
  for(;;)
  {
    HAL_GPIO_TogglePin(LD2_GPIO_Port, LD2_Pin);
    osDelay(1);
  }
  /* USER CODE END 5 */
}

さあ、どうなる?
・・・
・・・・・
NUCLEOをWindows10がMass Storageとして認識しなくなってる。。。
いや、ドライブとしては見えているけど、ファイルシステムが見えていないのかな?
NUCLOEは、たしかFAT12だったと思う。

どうも、Anniversary Updateを行ってから接続できなくなったという情報が多い。
うーん、ST-Link Utilityからだったら焼けるだろうか?

焼けた。
けど、LEDは点灯しっぱなし。


eclipse + GDB OpenOCD Debuggingでやってみる。
たぶんOpenOCDは、ねむいさんスペシャルだったと思う。

一発目は、Config optionsがどーたらこーたらというエラーになった。
たしかに何も設定していない。
こちらを見ながら、-sと-fを指定。

image

意外なことに、これで動いた。
main()の頭で止まる。
ステップして動く。
おお、動いているじゃないか!

では、StartDefaultTask()にブレークを張ってrun。。。来てるじゃないか!
ステップ実行してLEDは、点灯。
osDelay(1)。
またステップ実行してLEDは、消灯。
動いてるじゃないか!

ということは、osDelay(1)は1msecで、速すぎてわからなかったというだけか。
では、1000くらいにして焼き直すと。。。おお、点滅している!
点滅しているぞ!

こういう「開通おめでたう」みたいなときが、一番楽しいですな。


今回は、STM32F411が搭載されたNUCLEOと、STM32CubeMXを使って、FreeRTOSのタスクが1つ動くテンプレートをそのまま使ってLED点滅をさせるところまで動かせた。

大したことをさせていないからだとは思うが、思ったよりもあっさり動いた。
FreeRTOSが動いたことよりも、CubeMXのソースを使ってeclipse+OpenOCDでデバッグまでできることが確認できたことの方が私としてはよかった。

あまり深入りするつもりはないのだが、さすがにテンプレートそのままでは「動かせた」というのはおこがましいので、せめて自分でタスクをもう1つつくって両方動いてくれることを確認したいところだ。

[勉]FreeRTOS (1)

組み込み向けのOSというと、RTOSが思いつく。
そうではないOSは、Linuxだったり、自作だったりすると思う。

RTOSの有名どころは、こういうところか。

ThreadXなんて知らなかったのだけど、最近ニュースに出ていたFuchsiaの記事で出ていたのでね。
ARMに絞れば、RTXもある。

eCosというのもあったなぁ、とWikipediaを見たら、あれはずいぶん前に終わってしまったのですな。
でも、本家では昨年の年末にニュースが出ているので、メンテナンスは続けられているようだ。

 

とまあ、調べていけばきりがないほど出てくるRTOSだが、私がよく使っているNordicのマイコンがFreeRTOSをサポートしているので、それを見ていこう(RTXはまだexperimental扱い)。

Nordicの人も、多くの場合RTOSは使わなくて済むとことが多かった、と書かれているように、SoftDeviceとSDKがあるとあまり使いたいと思う気持ちはない。
ただ、nRF52くらいまでいくと、あれこれ考えるくらいだったらタスク分けしてしまえ、と思うかもしれないしね。


まず、バージョンから確認しておこう。

  • 2016/05/25 V9.0.0
  • 2016/03/30 V8.2.3
  • 2015/08/14 V8.2.2
  • 2015/03/24 V8.2.1
  • 2015/01/16 V8.2.0

このくらいでいいかな。
リリースノートはこちらだ。テキストでちょっと読みにくいが、V9系になって大きく追加されたのは、これららしい。

  • tasks, semaphores, queues, timers and event groups can now be created using statically allocated memory, so without any calls to pvPortMalloc()
    • タスクなどが静的に作れるようになりました?
  • Added the xTaskAbortDelay() API function which allows one task to force another task to immediately leave the Blocked state, even if the event the blocked task is waiting for has not occurred, or the blocked task's timeout has not expired.
    • タスクの待ち状態が解除されなくても強制的にディスパッチするAPIができましたよ?

まあ、V8系を知っていないと意味がない情報だが、どのバージョンを使いたいかの指針にはなるかも(V9のアップデート情報はここにあった)。
V9.0.0で「All ARM Cortex-M3/4F/7 ports」とCortex-M移植が進んでいるようだから、私はV9の方を使いたいかもしれん。
ただ、NordicのnRF5 SDK v11.0.0では、V8.2.1をベースに移植したものだった。


では、ホームページに書いてある特徴を列挙しよう。

  • 12年もやってる
  • RTOSのマーケットリーダーだ!
  • 商用でもプロプライエタリなソースコードの公開をせずに無料で使える
  • IP infringementリスクがない(?)

使う側としての特徴も書かれている。

  • バイナリイメージは6K~12KBくらい
  • 機能いっぱい
  • カーネル部分はCソース3ファイルだけとシンプル
  • サポートフォーラムがある

他にもいろいろ書かれているのだが、まあよかろう。


さて、あとは使い方なのだが、一から調べたくないので先人の資料を読む。

FreeRTOSの全体構成 - 電子工作室

  • 移植するファイルはportable/ にまとまっている
  • 環境設定はFreeRTOSConfig.h

 

では、V8.2.1を見てみよう。

image

Plusは追加機能のサンプルなのかな。
こちらには「Free commercial licenses」とあるので、マークがついているものは特定のユーザに限っては商用利用無料ということだろうか。

NordicのnRF5 SDK v11.0.0も同じような構成だが、少し違う。

  • FreeRTOS-Plusがない
  • portableフォルダが2つあり、上層にはコンパイラとCMSIS、下層にはMemMangだけがある
    • マイコン差分は上層のportableにあるようだ。

 

Nordicのサンプルを見比べて使い方を把握しようと思ったのだが、DFUに対応していないなどちょっと違いがある。
いきなりNordicチップだとよくわからないので、手頃そうなSTM32F4のボードを使ってみるか。
何が手頃かというと、LEDが付いていて、OSのHello Wolrd的な「タスクでLED点滅」をやりやすいのだ。