ファームウェアOTAとブートローダの設計ノート
要点: ファームウェアの更新経路は、初号機を出荷する前にブートローダと一緒に設計します。フラッシュの配置、イメージの署名と検証の方法、更新失敗時のロールバック、途中で電源が落ちたときの挙動を決め、各障害ケースを実機でテストします。機器が市場に出てからこれらの決定を変えると、高くつきます。
1.0 更新経路が設計上の決定である理由
更新機構は後から足せる機能に見えます。実際には、ほかのほぼすべてに制約を課します。アプリケーションが使えるフラッシュ容量、メモリマップの配置、どの鍵がありどこに保管するか、生産ラインが最初のイメージをどう書き込むか、です。あるブートローダを載せて出荷したら、それは通常、安全には置き換えられない唯一のコードになります。初日に対応していないことには、おそらくこの先も対応しません。
そのため更新経路はアーキテクチャの一部として扱い、メモリマップや通信プロトコルと同じ文書に書き、アプリケーションの開発が進む前にレビューします。
2.0 最初に答えるべき問い
| 問い | 重要な理由 | 主な選択肢 |
|---|---|---|
| 新しいイメージはどうやって機器に届くか | 転送方式、分割、再開処理が決まる | BLE、USB、UART、Wi-Fi/セルラー、SDカード、デバッガのみ |
| ダウンロード中の新イメージはどこに置くか | フラッシュ容量の配分が決まる | 内蔵の第2スロット、外付けフラッシュ、RAM(小さなイメージのみ) |
| イメージをどう認証するか | 自分たちがビルドしていないコードの実行を防ぐ | イメージとヘッダへの署名。ハッシュだけでは完全性であって真正性ではない |
| 古いイメージを再インストールできるか | ダウングレード攻撃とサポート方針 | 単調増加のバージョンカウンタ、許可リスト、明示的なダウングレードフラグ |
| 新しいイメージが動かなかったらどうなるか | 市場の機器が動かなくなる | テスト起動の後に確定、ウォッチドッグによる切り戻し |
| 署名鍵は誰が持つか | リリース手順とアクセス管理 | HSMまたはオフラインのマシン。ビルドサーバ上の作業コピーには置かない |
| 工場では何を書き込むか | ラインでの書き込みと初回起動 | ブートローダ+署名付きアプリケーション+プロビジョニングデータ |
まだ答えが出ていない項目は、担当者付きの未決事項として記録してください。「とりあえず何でも受け付ける」ように書いたブートローダは出荷しないでください。市場に出てから制限を厳しくすることはできません。
3.0 電源断に耐える2スロット構成
ブートローダ分を確保した後、アプリケーションが内蔵フラッシュの半分未満に収まるなら、2つのスロットとスクラッチ領域の構成にします。ブートローダは、検証していないスロットのコードを決して実行しません。
3.1 フラッシュ配置
| 領域 | 内容 | 書き込む主体 |
|---|---|---|
| ブートローダ | 書き換えない第1段のコード、検証用公開鍵 | 工場のみ |
| スロット0(プライマリ) | 実行中のイメージ | スワップ時のブートローダ、または工場 |
| スロット1(セカンダリ) | ダウンロードした候補イメージ | アプリケーションの更新クライアント |
| スクラッチ/スワップ状態 | リセット後にスワップを再開するための進捗マーカー | ブートローダ |
| 設定/データ | キャリブレーション値、ペアリング鍵、ユーザーデータ | アプリケーション。更新後も保持が必要 |
データ領域はどちらのスロットにも含めず、バージョン付きの形式にします。データの配置を変える更新には移行処理が必要で、ロールバックした場合でも古いイメージがそのデータを読めなければなりません。
3.2 更新シーケンス
- 更新クライアントがイメージを分割して受信し、スロット1に書き込む。スロットを保留状態にする前に、長さとハッシュを検証する。
- 次のリセット時に、ブートローダがスロット1のイメージのヘッダ、バージョン、署名を確認する。
- 有効であれば、ブートローダはスロットをスワップする(対応する部品ではスロット1から直接起動する)。セクタごとに進捗をスクラッチ領域に記録し、中断されたスワップを次の起動時に続行できるようにする。
- 新しいイメージはテスト状態で動作し、自己診断を行う。周辺回路の初期化、通信リンクの確立、データ領域の読み出しを確認する。
- 診断に合格したら、アプリケーションがイメージを確定済みにする。確定前にリセットされた場合やウォッチドッグが働いた場合、ブートローダは前のイメージに戻す。
これはMCUbootなどのオープンソースのブートローダが採用しているモデルで、スワップと切り戻しの詳細はその設計文書が良い参考になります。特定のブートローダを必須とはしません。部品によってはベンダー製や小規模な自作のブートローダの方が合います。実装が何であれ、上記のシーケンスが満たされているかを確認します。
3.3 シングルスロット構成と外付けフラッシュ構成
内蔵フラッシュが2スロット分に足りない場合は、候補イメージを外付けフラッシュに置き、ブートローダがそれをコピーする方法があります。これでも機能しますが、コピー処理は再開可能でなければならず、外付けチップは改ざんされやすいため、コピー前に外付けフラッシュの内容を改めて検証する必要があります。切り戻し用イメージを持たないシングルスロット構成は、有線インタフェースで常に機器を復旧でき、その手順が文書化されている場合に限って採用すべきです。
4.0 署名と鍵
完全性チェック(CRC、SHA-256)で分かるのは破損です。誰がイメージをビルドしたかは分かりません。それにはイメージとヘッダに対する署名が必要で、アプリケーションから上書きできない領域にブートローダが保持する公開鍵で検証します。
設計書に書き込む実務上のポイント:
- 署名用の秘密鍵は通常のビルド環境の外に置く。リリースビルドは、記録を残す別工程で署名する。
- 鍵の更新に備える。ブートローダに複数の公開鍵を持たせるか、署名付きイメージで信頼する鍵を更新する手順を文書化する。
- 開発用と量産用の鍵を分ける。開発ボードが誤って量産用の署名付きイメージを受け付けないようにし、量産機は開発用の署名付きイメージを決して受け付けないようにする。
- バージョン番号はアプリケーション内だけでなく署名付きヘッダにも入れ、ブートローダがロールバック防止の方針を強制できるようにする。
NIST SP 800-193は、プラットフォームファームウェアのレジリエンスを保護・検知・復旧の観点で説明しており、小さな機器でも有用なチェックリストになります。IETFのRFC 9019は、IoT機器向けのファームウェア更新アーキテクチャと関係する役割を説明しています。
5.0 転送と再開
転送方式が何であれ、更新プロトコルには同じ性質が必要です。
- オフセット付きの分割転送。リンクが切れても最初からではなく途中から再開できる。
- イメージ全体のハッシュを最初に送り、最後のブロックの後に照合する。
- 「イメージ受信完了」を「今すぐ再起動」とは別の明示的な手順にし、再起動のタイミングをホストが決められるようにする。
- ホスト向けの明確なエラーコード:イメージ種別の誤り、バージョン拒否、容量不足、検証失敗。
BLEでは、スループットはスマートフォンとネゴシエーションした接続パラメータとMTUで決まり、どちらも機種によって異なります。テストできる最悪のケースを前提に設計し、ユーザーには進捗を表示してください。機器プロトコル設計全般については、BLE・USBによる機器通信の関連ノートを参照してください。
6.0 出荷前に実施するテストケース
| ケース | 期待される結果 |
|---|---|
| ダウンロード中の電源断 | 旧イメージがそのまま動作し、ダウンロードが正常に再開または最初からやり直しになる |
| スワップ中の電源断(複数のタイミング) | 次の起動時にスワップが再開し、最終的に有効なイメージ1つで動作する |
| 破損したイメージ(1バイト変更) | スワップ前に拒否され、ホストにエラーが通知される |
| 誤った鍵で署名したイメージ | 拒否される |
| 古いバージョンのイメージ | 拒否される、または文書化したダウングレード規則の下でのみ受け付ける |
| 確定しない新イメージ | リセットまたはウォッチドッグの後に切り戻される |
| データ形式を変更した新イメージ | データが移行され、ロールバック後もデータを読める |
| 工場で書き込んだ機器の初回更新 | ラインのイメージとプロビジョニングで正常に動作する |
電源断のテストには、制御可能な電源か電源ラインのリレーと、ダウンロードとスワップの各フェーズの境目で電源を切り、各ポイントをループで繰り返し、サイクルごとにどのイメージで起動したかをログに残すスクリプトが必要です。遮断ポイントとサイクル数は、結果と一緒にテスト記録に残します。
7.0 引き渡し資料に含めるもの
- フラッシュ配置表と、スロットサイズの根拠。
- イメージヘッダの形式、署名手順、鍵の保管に関するメモ。
- メッセージ形式とエラーコードを含む更新プロトコルの説明。
- 上記のテスト一覧と、実施したハードウェアでの結果。
- ブートローダと初期イメージの工場での書き込み手順。
新しい機器のファームウェアを計画中の場合や、既存の機器に更新経路を追加したい場合は、組込みファームウェアのページで進め方を説明しています。更新配信のサーバ側はWeb・クラウド・デバイス管理のページで扱っています。案件の内容はプロジェクトのご相談フォームからお知らせください。
参考資料
- MCUboot design documentation: https://docs.mcuboot.com/design.html
- NIST SP 800-193, Platform Firmware Resiliency Guidelines: https://csrc.nist.gov/pubs/sp/800/193/final
- IETF RFC 9019, A Firmware Update Architecture for Internet of Things: https://datatracker.ietf.org/doc/html/rfc9019
よくあるご質問
出荷済みの製品にOTA更新を追加できますか?
それらの機器にすでに載っているブートローダ次第です。何らかのインタフェースで新しいアプリケーションイメージを受け付けられるなら、通常はアプリケーションに更新クライアントを追加し、その経路で配信できます。受け付けられない場合、市場にある機器は有線接続でしか更新できず、改善した設計は新規生産分から適用になります。
アプリケーション用のスロットは2つ丸ごと必要ですか?
2スロットにすると復旧の仕組みが最も単純になりますが、アプリケーションに使える容量は半分になります。候補イメージを外付けフラッシュに置く方法や、圧縮イメージを使う方法がよくある代替案です。アプリケーションがスロットに収まらなくなってから気づくのではなく、早い段階で書き出したフラッシュ容量の配分をもとに決めてください。
更新の保護はCRCチェックで十分ですか?
CRCやハッシュで分かるのは転送中の破損です。イメージが貴社のものであることは証明できないため、更新インタフェースにアクセスできれば誰でも自分のコードを書き込めてしまいます。ブートローダが署名を検証すればこの穴は塞がり、その周辺の鍵管理はアルゴリズムと同じくらい重要です。
更新中の電源断はどうテストしますか?
スクリプトで行います。制御可能な電源やリレーで、ダウンロード中とスワップ中のさまざまなタイミングで電源を何度も遮断し、各サイクルの後に機器が有効なイメージで起動することを確認します。結果は引き渡し資料に含め、次の担当者が再実行できるようにします。
おすすめのブートローダは?
部品、フラッシュ容量の配分、セキュリティ要件に合うものです。MCUbootは多くのマイコンで使える文書の充実したオープンソースの選択肢で、ベンダー製ブートローダの方が合う場合もあります。2.0節の問いに照らして比較し、選んだ理由を書き残します。