2019年10月14日

[arm]Armv8-MのTrustZone

nRF9160で気になっていたのが、TrustZoneだ。
Cortex-AのTrustZoneを知らないので比較できないのだが、この記事によるとGCCから扱えるようだ。

https://www.lobaro.com/using-the-armv8-m-trustzone-with-gcc/


Introduction & Motivation

Cortex-M33プロセッサにはARM TrustZoneと呼ばれる機能がある。
この記事では、GNU ARM GCC compilerとCMSE(Cortex M Security Extensions)を使ってTrustZoneついての私見を述べる。

これはARMv8-MならnRF9160じゃなくてもいいし、GCC以外のコンパイラでもいい。

 

Secure & Non Secure CPU Operationg States

今まではThreadモード(通常モード)とHandlerモード(割込みモード)だけだったが、ARMv8-Mになるとsecure / non-secureという属性が加わる。

電源を入れたときはsecureモードで始まる。このときはメモリも周辺機能も全部使える。これは今までのM3やM4などと同じ。

TrustZoneの考え方は、セキュリティ関連のコードやデータをデバイス内の小さな特定領域に隠すということだ。その領域は"secure"と呼ばれ、そうじゃないところは"non-secure"と呼ばれる。メモリ、割込み、周辺機器をsecure/non-secureに分割するのはユーザが決める。電源ON時のコードはその分割をする処理から始めるのが普通だ。nRF9160のコード例(Secure Partition Managerと呼ぶらしい)では、FLASHの256KBをsecureに、768KBをnon-secureに割り当てている。

CPUは実行関係のレジスタ(スタックポインタとSystem Control Block)として2つのバンク(secure/non-secure)を持つ。今のCPU動作がsecureかnon-secureかというのは、どっちのバンクを使っているかということと同じ意味である。バンクのメカニズムはハードウェアで2回実装されている一部の周辺機器(SysTickなど)でも同様です【私:2回(twice)って何??】。secureなプログラムは常にどちら側にもアクセスできる。non-secureなスタックポインタとnon-secureなベクタアドレスの配置を設定した後、secureなブートコードはnon-secureなベクタテーブルの関数ポインタを使用する。そして、CPUはnon-secureなファームウェアとして動作し始める。

non-secureファームウェアは、secureファームウェアの存在を認識してはならない。TrustZoneがない時代と同じように普通に開発して、普通にnon-secureなメモリ領域とリンクするようにする。CPUがnon-secureに動き始めると、security exceptionが発生しない限りsecureなコード、データ、周辺機器にに直接アクセスできなくなる。non-secureコードからsecureな機能にアクセスする唯一の正当な方法は、secure側が提供することになる特別なゲートウェイ/エントリー/veneer機能を使うことである。では、ARM GCCとCMSE(Cortex M Security-Extensions)を使ってやってみよう。

 

Non-secure callable(NSC) memory regions and the secure gateway(SG) ASM instruction

non-secureからsecureな機能を呼び出せるようにするため、secureファームウェアのコードに"Non-secure callable(NSC)"といういくつかの小さなFLASH領域を設定しなくてはならない。nRF9160ではSPU(System Protection Unit。PDFのp.257参照)が担当している。

secureメモリの一部をNSCとして指定することにより、最初のOPコードとしてアセンブラの"SG(Secure Gateway)"命令を呼び出すことで、non-secureから呼び出せないという制限を緩和できる。SG命令を実行すると、プログラムはより制限されたsecureメモリ内にある=NSCではないメモリにあるsecure機能実装に分岐する。このようにしてnon-secureコードからsecure機能を呼び出すことで、まずNSCにジャンプし、続けてsecureメモリ内にある実際の機能にジャンプする。こういう過程を経ることにより、secureメモリへのアクセスは残りのsecureメモリから切り離される。詳しいことはこちらを読め:Reasons for introducing the NSC regions

 

Defining non-secure callable functions in secure firmware

幸いなことに、non-secureファームウェアからsecure機能を呼び出す過程はARMv8-Mコンパイラによってプログラマからは隠されている。non-secureファームウェアから呼び出すsecure機能のエントリーポイントはsecureファームウェアの定義をした後でcmse_nonsecure_entry属性をつける。

//some c file of secure firmware project defining veneer gateway functions
(ソース例は原文を見よう)

GCCでコンパイルするときにはオプションとして"-mcmse"がいる。

// GCC COMPILER flags used during secure side building
arm-none-eabi-gcc -o secureFirmware.elf -mcmse [...]

関数本体は通常secureメモリの.textセクションに配置される。が、SGと分岐する命令は.gnu.sgstubsセクション(GCCの場合。GCC以外は違う名前かもしれない)。

NSC領域の小さなredirect機能は、SGを実行して分岐する処理しかやらないので、"veneer"機能や"SG stubs"などと呼ばれる【私:blogでは"SG stups"と書いてあったけど、typoよね? それと、ここまでfunctionを「機能」と書いてきたけど、C言語の関数という意味で使われたりもする? redirect functionってなんだろう? non-secureからsecureに遷移するってこと?】。secureファームウェアのリンカスクリプトファイルは、non-secureファームウェアにジャンプする前にsecureブートプロセスの一部のNSCとして宣言するveneerコードをsecure領域に配置しなくてはならない。

// Linkerscript Section for TrustZone Secure Gateway veneers
(リンカスクリプトは原文を見よう)

【私:何が言いたいのかわからなかった。リンカスクリプトの見方が分かってない。】

 

Calling secure functions from non-secure firmware (NS->S)

通常、secureファームウェアはnon-secureファームウェアイメージから独立して開発&FLASH書込みされる。secureファームウェアの機能を使うために、secure側の関数を呼び出せるように書かれたヘッダファイル(.h)はnon-secureソースファイル側でincludeする。加えて、non-secureファームウェアはsecureメモリのNSC部分の前にveneerエントリーポイントスタブがどこにあるかを知っていないといけない【私:「NSC部分の前に」はbeforeだから時間的に前。FLASHのsecureとnon-secureの設定を行う前に決定していないといけない、という意味か?】。これは特殊なオブジェクトファイル(CMSE_importLib.o)とアドレス情報を必要としているnon-secureファームウェアをリンクすることで解決する【私:done、は、何とかしてくれる、くらいの意味だろうか?】。このオブジェクトファイルは以下のcmseリンカオプションを使用してsecureファームウェアがリンクされる間に生成されなくてはならない【私:CMSE_importLib.oはここで生成されているのだろうか?】。

// GCC LINKER flags used during SECURE side linking
arm-none-eabi-gcc -Xlinker --cmse-implib -Xlinker --out-implib=CMSE_importLib.o -Xlinker --sort-section=alignment [...]

オプション"-in-implib=CMSE_importLib.o"は、過去バージョン(TrustZone未対応)で既に定義された同じメモリに展開されるオブジェクトファイルを新しいバージョン(TrustZone対応)でも維持できるようにする【私:-in-implibではなく-out-implibの間違いでは?】。こうすることで(過去バージョンで作成済みのimport libにリンクされている可能性がある)non-secureイメージの更新をせずにsecureイメージに追加できるようになる。

.hファイルを使用してCMSE_importLib.oオブジェクトをリンクするために、non-secureファームウェアはControlCriticalIO()関数を呼び出す【私:the example aboveは、たぶん「原文を見よう」のコードだ。】。

// GCC LINKER flags used during non-secure side linking
arm-none-eabi-gcc -o non-secureFirmware.elf CMSE_importLib.o [...]

 

Calling non-secure (callback) functions from secure firmware (S->NS)

どのようにしてTrustZoneが2つの隔離されたファームウェアをgatewayやveneer機能で接続するのかを見てみよう。これはsecureファームウェアがnon-secureファームウェアから呼び出される機能を許可しているからだ。

もう1つの方向、すなわちsecureファームウェアからnon-secure関数を呼び出す場合、なんらかの方法でsecureコードにnon-secure関数のアドレスが与えられたならば、実行することができる。通常、これはsecure gateway functionが引数にnon-secureコールバックポインタを与えることで行われる。

(サンプルは原文を見よう)

"nonsecure_call()"属性は、潜在的なセキュリティリスクを割けるためにnon-secureコードにジャンプする前にバンクじゃないgeneral purposeレジスタをクリアするようsecureコンパイラに指示するために必要だ。そしてまた、ブランチアセンブラ命令の関数ポインタアドレスLSBをクリアする指示にも使われる。こういうことを行って、CPUはsecure状態からnon-secure状態に戻ってくる。

non-secureコールバックはvolatile値のように扱わねばならないので、non-secure割込みによって変更される可能性があるため、関数ポインタは"cb"にコピーが必要となる【私:cbはサンプルコードの中にあるfuncptr_ns型の変数か】。コールバックを実行する前に、ポインタがnon-secureメモリのみを挿しているのかチェックしなくてはならない。secureメモリを挿しているなら、それはセキュリティリスクとなりうる【私:ポインタ変数が4byteだとして、それが全部non-secure側にあるかどうかをチェックするのだろうか?】。

 

Hints and further reading

secure側のリンカスクリプトはveneer関数のセクションを考慮し、non-secure側のリンカスクリプトはsecureファームウェアのメモリ領域を反映しなくてはならない、ということを覚えておこう。archiveファイル(*.a)がnon-secureの呼び出し可能な関数を含んでいるなら、secureファームウェアのリンカオプションとして"whole-archive"を付けなくてはならない。この方法でのみCMSE import libが必要とするveneer関数に含めることができる。

 


けっこうがんばって読んでみたのだが、どうだろうか?
というか・・・私やっぱり英語力ないな。。。
ただ、この人のはGoogle翻訳などできれいに和訳されやすかった。がんばったのは、Google翻訳に通す前に自分でやってみたということについてだ。自信がないときはその後でGoogle翻訳して「ああやっぱり間違ってた」となるのだがね。

 

 

さて、整理しよう。

【NSC】
Non-Secure Callableの略。
non-secure状態からsecure状態に遷移するときに使うsecure側の領域。NSC memory regionsやNSC regionなどという使い方。

【SG】
Secure Gatewayの略。
non-secure状態からsecure状態に遷移したいときに使うアセンブラ命令。

 

まず、Defining non-secure callable functions in secure firmwareのところ。
ControlCriticalIO()という関数をcmse_nonsecure_entry属性つきで作る。
これはnon-secureファームウェアから呼び出されることになるのだが、その前にSGオペコードを呼び出したりなどをやってくれるのだろう。
これをsecureFirmware.elfという名前で生成している。-mcmseオプション付きだとsecure用になるのか。

 

次に出てきたのはリンカスクリプトで、.gnu.sgstubsが載っている。
これは自作が必要なのかもしれない。

 

次はCalling secure functions from non-secure firmwareのところ。
--Xlinkerを使ってリンカに指示している。オプションは--cmse-implib, --out-implib, --sort-section。
--out-implibはファイル名を付けているので、これが生成されるのだろう。

そして最後にCMSE_importLib.oと一緒にリンクしてnon-secureFirmware.elfを生成している。

 

最後の話で、callback_fnをcbにコピーするところがよくわからなかった。
C言語だから、引数は値渡しだよな? ポインタだから、アドレス値を渡しているはずだ。
じゃあ、コピーしなくてもいいんじゃないのかと思ったが、レジスタじゃなくてスタックで渡された場合だろうか。
うーん、答えが出ない。。

 

あと、secureとnon-secureにメモリのパーティションを分ける話があったが、FLASHはいいとして、SRAMの方はどうなってるのだろうか?
nRF9160のSPMを読むと、SRAMも分けるようだ。分けるというか、強制的に分けられるというべきか。だからSRAMについての記述がないのか。

 

nRFのFLASHって、自分で書き換えができたんだっけ?
OTAがあるのは覚えているが、BondingなんかはAPIを使ってしかやってないので、今ひとつ・・・いや全然記憶にない。


むー、もっと調査が必要か。

しかしまあ、しばらく触っていないうちにずいぶん状況が変わってきたな。
特にセキュリティ周り。
nRF51822だとBLEで手一杯だったので考慮しなかったが、nRF9160はTrustZoneがいるくらいのレベルが要求されているのだろう。まあ、nRF9160はBLEじゃなくてインターネット接続と直接接続される前提になっているからかもしれないが。

今までインターネットとは距離を置くことでセキュリティのことは放置してきたのだが、そういう時代ではなくなったのだな。。。

2019年9月28日

gitのrebase

gitを使っている。

gitの説明って、だいたいコマンドラインで行われている。
コマンドを覚えるのが面倒なのでツールで済ませてしまいたいのだが、ずっと使っていてわかった。
なんだかんだで、コマンドラインでやらないと細かいことがやりづらいのだ。

いつか「gitの困ったときだけ使うGUIツール」みたいなのを作ろうかと考えていたのだけど、コマンドラインには叶わんのだよなぁ。。。

 

さて、gitを自分だけで使う分にはそこまで気を配らないのだが、チームで使うとなるとそうもいかん。
気にするのは、こんなところだろうか。

  • 自分に変なことが起きないようにする
  • 相手に変なことが起きないようにする

まあ、他に何があるんだっていわれそうだが、まずはこの2点に気を配るだろう。

 

GitHubでgitを使っているので、本体のリポジトリをforkして、branchを作って作業して、pull requestして本体にマージ、という流れにしている。
作業しているbranchは自分のものだから、好き勝手にいじっても問題が無い。
これで「相手に変なことが起きないようにする」は解決だ。
Pull Requestしてコンフリクトすることもあるだろうけど、そこはそこで解決すればいいだけのことだ。

 

ああ、「相手に」という意味では、commit履歴というものがある。
branchをつくって、今日の分、みたいな感じでcommitしていると、本体にマージしたときもその履歴が残ってしまう。
まあ、Pull RequestのマージでSquashというやり方もあるのだろうけど、1つにまとめていいかどうかPull Requestする人が悩むこともあるだろう。
そうならないように、Pull Requestする段階できれいな履歴にしておきたい。

 

で、ここからが本題だ。

いままで、私はbranchで作業したcommit履歴をまとめるために、別のbranchを作ってsquashさせていた。
これでよいときもあるのだが、単にこことここだけまとめたい、という場合もある。

そうなると、たぶんrebaseを使うはずだ。
rebaseすると、pushするときにforceで行うことになるが、まあ自分のbranchだから問題なかろう。
一度Pull Requestして修正するときも、rebaseしてpush forceしてしまえば履歴がきれいだし。


git rebase HEAD~2 と指定すると、直近のcommit履歴2つが出てくる。
上から古い順番で並んでいる。

ここでpickのところをsquashとかsとか書き換えると、commitがまとめられる。
では、sにした行の上にまとめられるのか、下にまとめられるのか。

試そう。

$ git log --oneline
741e4b2 (HEAD -> master) second
48697ff first

$ git rebase master
Current branch master is up to date.

あれ?? ダメなの??
じゃあ、branchを作って。。。

$ git checkout –b rb
$ 編集
$ git add xxxx
$ git commit
$ 編集
$ git add xxxx
$ git commit
$ git log --oneline
12d8146 (HEAD -> rb) forth
3ef2f57 third
741e4b2 (master) second
48697ff first

$ git rebase HEAD~2
Current branch rb is up to date.

うーん、rebase、つまりre-baseで、基点を変更するコマンドだ。
だから、masterが最新で、そこから延びただけだったら使えないのだろうか?

$ git rebase –i HEAD~2

あ、出てきた。

pick 3ef2f57 third
pick 12d8146 forth

これを、こうする。

s 3ef2f57 third
pick 12d8146 forth

You can fix this with 'git rebase --edit-todo' and then run 'git rebase --continue'.
Or you can abort the rebase with 'git rebase --abort'.

怒られた。

pick 3ef2f57 third
s 12d8146 forth

これはOKで、続けてcommit logの入力を促す画面になる。

$ git log --oneline
354f949 (HEAD -> rb) third and forth
741e4b2 (master) second
48697ff first

 

つまり、上にまとめられる、と覚えておけば良かろうか。
よくないのかもしれないが、私にはそれで事足りそうだ。

2019年9月14日

[thingy:91]いろいろ調べる

勢いでThingy:91を買ったものの、詳細を全然知らない。
ユーザーズガイドで調べよう。


構成

nRF9160とnRF52840が載っている。

nRF9160 : LTE-M/NB-IoTモデム

  • Cortex-M33
  • FLASH : 1MB
  • RAM : 256KB

nRF52840 : BLE / NFC

  • Cortex-M4F
  • FLASH : 1MB
  • RAM : 256KB
  • USB

 

なるほど、だからSWDのスイッチがあるのか。
firmwareも、モデムとApplicationに分かれていたが、nRF9160とnRF52840だろう。

ちなみに、Applicationのzipを解答すると、hexファイルたちとzipファイルが入っていた。
zipファイルはモデムのfirmwareだ。

firmwareの焼き方もnrfjprogでやる方法が書かれているのだが、ファイルは<hex>としか書かれていない。
全部焼けば良いのだろうか?
ちょっと怖いので、もう少し後にしよう。


user-programmable LED

たぶん、一番目だって光っているLEDのことだろう。
どういう光り方をしているのか気になる。

  • オレンジ点滅 : 電源ON直後?
  • シアン点滅 : SIMで接続済み?
  • 紫点滅 : GPS検索中
  • 緑点滅 : GPS確定

 

うーん。
いま、青点滅しているように見える。
これがシアンか?
白色のように点滅しているときもあるが、これが紫だろうか。

nRF ConnectでLTEを見ているのだが、アンテナ4本中1本しか立っていない。
室内で窓から遠いので、弱いのか。
だったら、GPSはとても無理だろう。

 

ちなみに、ここでは「点滅」と書いたが、英語ではbreathingになっている。
点滅というよりも、ぼわぼわした明滅だな。


書かれているのは、このくらいだ。

あとはハードウェアの細かいところとか。

[thingy:91]やはりJ-Linkじゃないとだめなのか

nRF Connectのv3.2.0を立ち上げると、Programmerというものがあった。

image

 

こいつならfirmwareを焼くことができる!と思ったのだが・・・

image

 

LTE Monitorは使えるから、Thingy:91をUSB接続してCOMポート経由でアクセスすることはできている。
ということは、やはりJ-Linkじゃないとダメなのか・・・。

 

まだnrfjprogで焼くという手段は残っているので、あきらめるのはもう少し先だ。

[thingy91]LPC-Link2が使えそうだ

さて、私が持っているJ-Link LITE CortexMはThingy:91につなげそうにない。
ならば、J-Link Baseを購入するしかないか。。。

 

とJ-Link Baseの情報を探していると、こちらのサイトが見つかった。

超便利 最強デバッガ J-Link
http://idken.net/posts/2017-08-31-jlink/

この記事の下の方に「各種評価ボードのデバッガをJ-Link OB(On Board)化する」という章がある。
評価ボードをJ-Link OBなるものにできるとか。
そういえば、昔NXPのLPC-Link2を買った記憶がある。

 

https://www.segger.com/products/debug-probes/j-link/models/other-j-links/lpc-link-2/

書いてある通りに、LPCScryptをダウンロードしてインストールし、Firmwareのbinファイルをダウンロードし、インストールしたディレクトリのprobe_firmware/LPCLink2のbinファイルを置き換え、scripts/program_JLink.cmdを実行した。
LCP-Link2はJP1を外してUSBに接続すれば良い。
指示通りにやると焼けた。

 

あとは、Thingy:91とLPC-Link2のJ7を接続し、nrfjprogを実行。

nrfjprog --memrd 0 --n 1024 -f nrf91

おー、でてきたでてきた。

 

さて、firmwareを焼いてみたいものの、どれを焼くと良いのだろうか?
mfwnrf9160101.zipとthingy91fwv022.zipがダウンロードできて、前者はModem Firmware and modem DFU tool (nRF9160 LTE-M/NB-IoT/GPS modem)、後者は単にFirmware for Thingy:91と紹介されている。

展開すると、HEXやらBINが複数あるのだ。
アップデートの説明に飛んだが、よくわからん。

ユーザーズガイドのPDFを読むか。

[thingy91]LTE Deviceの登録

Thingy:91には手持ちのJ-Link LITEが使えなさそうだったので、先にeSIMのアクティベートをやることにした。

https://www.nordicsemi.com/Software-and-Tools/Prototyping-platforms/Nordic-Thingy-91/GetStarted

YouTubeで手順を紹介してくれているようだが、英語が聞き取れないのでUnboxing step by stepの方を読む。

 

 

nRF Cloudのサイトを開いて、私はNordic Devのアカウントを持っていたのでそれでSIGN IN。
プラスアイコンをクリックして、LTE deviceを選択。
SIMの表面に3行の文字列があるが、上2行がICCID。PUKはeSIMの台紙に波線っぽいスクラッチがあるので削ると出てくる。

それを入力して、チェックボックスをONにしてボタンをクリック(チェックボックスに気付かず、ずっと失敗していた・・・)。
うまくいくと住所などの入力になるので、適当に打ち込む。

 

その後に、IMEIとPINを入力してデバイスを登録するらしいのだが・・・うまくいかない。

・・・あれ? Thingy:91のLEDが青点滅から緑点滅に変わっている?
もう一度IMEIとPINを入力してボタンを押すとうまくいった。

青点滅の時

image

 

緑点滅のとき

image

 

単に時間が足りてなかったとかか。

 

もしかしたら日本向けにFirmwareのアップデートがいるのかと思ってあせった。
どうやらFirmwareのアップデートにはJTAGデバッガが必要っぽいからねぇ。

J-Linkの限界

Thingy:91も届いたことだし、JLinkでつないでみよう。
J-Linkといっても、J-Link LITEだがね。

最初はnrfjprogのバージョンが古くてfamilyオプションのnrf91に対応できなかった。
バージョンを上げてつないでみると。。。

 

image

 

えっ?
J-Linkってそんな制限があるの??

 

Firmwareの更新で済めば良いのだが・・・ダメだった。。。

image

 

J-Linkのサポートするデバイスとしては、nRF9610も入っている。

https://www.segger.com/downloads/supported-devices.php

ということは、J-LinkじゃなくてJ-Link LITEがサポートしていないのだろうか。
Thingy:91にはSWD Selectというスイッチがあって、nRF91とnRF52が選べるようだ(今はnRF91)が、せっかくだからnRF91で使えるようになっておきたいじゃないか。

先にeSIMのアクティベートをやるか。

Nordic Thingy:91到着

NordicのThingy:91が届いた。

箱は小さい。

image

 

SIMが入ってるんだ!
eSIMで、フルサイズのように見えるけど内側に切れ目のようなものが入っていて、nano SIMサイズまで小さくできるようだ。この方式はいいですな。

image

image

 

 

一応、搭載されているnRF9160の技適を確認。
よし。

image 

2019年9月7日

Zephyr v2.0.0

Zephyrのv2.0.0がリリースされたようだ。

https://github.com/zephyrproject-rtos/zephyr/releases/tag/zephyr-v2.0.0

rc2まで動かしていたのだが、CCCD定義用マクロの引数の数が変わっていたのだけ気付いた。

そんな感じで、v1とは互換がないところがあるかもしれないので、アップデートの際はご注意を。

2019年9月1日

[zephyr?]%lluがうまくいかない

Zephyrでuint64_tを扱うことがあった。

64bitの値を文字列にして渡したい。
あまり考えず、

char str[20];
snprintf(str, sizeof(str), “%” PRIu64, val64);

みたいな感じで書いた。

そうするとですな、文字列で”%lu”になってしまうのだ。

 

gccは、gcc-arm-none-eabi-8-2019-q3-updateを使っている。
ターゲットはnRF51822なので、Cortex-M0だ。

ここら辺を見ると%lluのようだから、最初のlだけ消えている・・・?
%luはうまくいくので、全部がダメなわけではないのだよなぁ。
コンパイラかと思っていたのだが、sprintf.cがあるのでZephyrの方かもしれない。

 

CONFIGを見ていると、CONFIG_MINIMAL_LIBC_LL_PRINTFというのがあった。
これをyesにすると、64bitも扱えるようになった。
まあ、普通はいらないよねぇ。。。今回も64bitで扱うけど、実際は32bitも使わないし。。。