あるハードウェアエンジニアが、プロンプト1つ、回路図、ユーザーマニュアル、そして121GWハンドヘルドマルチメーターに接続したデバッガーケーブルをClaude Codeに渡しました。1日足らずで、エージェントはこのメーターのアプリケーションファームウェア全体を読みやすいプレーンなC言語で再構築し、自ら書いたエミュレーターで検証したうえで、実機で起動する90KBのバイナリを生成しました。このバイナリは10Vの基準電圧を9.9998Vと測定し、オートレンジも正常に動作し、Bluetooth経由で公式のWindows用コンパニオンアプリにライブデータを送信します。一方でこの実行は、自律エージェントの最大の弱点も浮き彫りにしました。監督なしで放置すると、Claude Codeは誰も頼んでいない検証に数千トークンを費やしたのです。
目標はアセンブリではなくプレーンなC
121GWは、STMicroelectronics製のSTM32マイクロコントローラーと、実際の測定を担うチップであるHyconのHY3131アナログフロントエンドで動作します。ファームウェアはもともとIARツールチェーンでコンパイルされており、出荷時のバイナリは124KBです。
コミュニティの貢献者がすでに、このメーターのファームウェアを手書きのARM Thumb-2アセンブリでオープンソース移植し、macOS、Windows、Linux向けのデスクトップエミュレーターも合わせて公開していました。これは、Claudeが検証を監督しながらローカルAIモデルを使い、およそ48時間で作られたものです。このビルドは実機で問題なく動作し、オートレンジもほぼ瞬時に完了します。しかしアセンブリはコミュニティが拡張するには難しい言語です。今回のプロジェクトの目的は異なり、バイナリをバニラなC言語にデコンパイルし、誰でも改変して再コンパイルできるようにすることでした。C++、Python、Rustは明示的に除外されています。
ハードウェアの準備
エージェントが繰り返し書き込みとテストを行えるように、エンジニアは5ピンのSWDケーブル(SWDはチップのデバッグ・書き込みインターフェース)でST-LINK/V2プログラマーを接続しました。メーター純正の書き込み用ヘッダーは基板の上端にあり、電池のバネは背面ケースを閉じたときにしか接触しないため、分解したメーターは電源を失ってしまいます。そこで、書き込み用パッドにL字型の5ピンヘッダーをはんだ付けし、ケースの両側に小さな切り欠きを削って、完全に組み立てた状態のメーターからピンが突き出るようにしました。メーターは単3電池で動作し続け、デバッガーを接続したままダイヤルを手で回せます。
注意点が1つあります。導体ピンが露出するとメーターのCAT高電圧安全規格は無効になるため、この改造は専用のベンチ用機にのみ施すべきで、通常の業務に使うメーターには決して行ってはいけません。
まず全データをバックアップ
Claude CodeはST-LINK経由でSTM32CubeProgrammerのコマンドラインツールを操作しました。チップの読み出し保護がレベル0、つまりメモリを制限なく読み出せる状態であることを確認し、ブートチェーンを次のように整理しました。
| 領域 | 役割 | サイズ |
|---|---|---|
| STシステムブートローダー(ROM、0x1FFFF000) | 工場出荷時のブートローダー。変更不可 | 約8KB |
| カスタムブートローダー(フラッシュ、0x08000000) | FAT形式のmicroSDカードを読み込み、ユーザーがファームウェアを更新 | 24KBパーティション、コードは20.3KB(20,212バイト) |
| アプリケーション | マルチメーターのファームウェア、バージョン2.05 | 124KB |
エージェントはフラッシュ、システムブートローダーROM、EEPROM、オプションバイトをそれぞれ別のバイナリファイルにダンプしました。中でも重要なのがEEPROMのコピーです。ここには各メーター固有の工場校正定数が格納されており、消去してしまうと二度と再現できません。デバッグリンク経由の読み出しが破損している可能性を排除するため、フラッシュは2回ダンプしてチェックサムを比較しました。
エージェントの設定
セッションではClaude Opus 3.5モデルを使い、effort設定はHighにしました(デフォルトのmediumでもなく、トークン消費がはるかに速い最大設定でもありません)。エンタープライズ向けプランではなく、通常の月額サブスクリプションで実行しています。コマンド実行前にモデルが戦略を示すようにプランモードを有効にし、クラウドのサンドボックスではなくローカル実行を選んだため、エージェントはファイルシステムとハードウェアのツールチェーンに完全にアクセスできました。
プロンプトには、ハードウェア、ST-LINKの接続、3つのファームウェア領域、そして2段階の目標を記述しました。まずプレーンなC言語にリバースエンジニアリングし、次に再コンパイルして同一の動作を確認してからオープンソース化する、という流れです。回路図、ユーザーマニュアル、HY3131のデータシートも添付しました。そして決定的に重要だったのが、「推測せずに質問すること」とエージェントに指示した1行でした。

▲ ツールチェーンと参照元を確認するClaude Code
エージェントが自ら決めたこと
Claude Codeはまずワークステーションの調査から始めました。プロジェクトアーカイブ用のドライブ全体をスキャンして2017年12月ごろの古い121GWソースのスナップショットを見つけ、それをベースにするか、参照用にするか、まったく使わないかを尋ねてきました。エンジニアは、ダンプしたバイナリだけから作業するクリーンルーム方式を選びました。この発見は有用でしたが、同時に不安を感じさせるものでもありました。ローカルアクセスを持つエージェントは、作業ディレクトリやコンテナに閉じ込めない限り、到達できるあらゆるドライブを歩き回る可能性があるのです。
続いてエージェントは、IDA Proではなく、GCC、CMake、Ninja、ヘッドレスのGhidra 11(無料の逆アセンブラー兼デコンパイラー)というツールチェーンと、セットアップ、バイナリ取得、静的解析、C言語での再構築、等価性検証というロードマップを提案し、エンジニアが承認しました。工場出荷時のROMブートローダーについては、決して変更できないコードをデコンパイルするのではなく、文書化するだけにとどめるよう提案しました。Ghidra(432MB)、Temurin OpenJDK 21(192MB)、Pythonパッケージのダウンロード前には許可を求め、その後Ninja 1.12.1とARM CMSIS 5.9.0のヘッダーをインストールし、計画をREADME.mdとmemory-map.mdにコミットしました。
マイルストーン2: ブートローダー
57分後、約57,000トークン(セッション上限の41%)を使った時点で、Claude Codeはブートローダーの234関数すべてをC言語で再構築していました。すぐに書き込むのではなく、STM32F102とそのレジスタ、SDカードをモデル化したエミュレーションハーネスを作成し、通常の電源投入、ブラウンアウト、更新モード、破損したSDファイルなど10のシナリオを実行して、クロックサイクル単位でオリジナルと一致することを確認しました。特定のセクター読み出しでブートローダーが512バイトのステータスワードを無視するといった癖も意図的に残しています。等価性とは、奇妙な挙動まで再現することだという原則に基づくものです。生成されたlcd.cなどのファイルは、ごく普通のすっきりしたC言語として読めます。
マイルストーン3: アプリケーション
Ghidraは124KBのアプリケーション内に794の関数を特定しました。エージェントはまず40関数をユニットテスト付きでコミットし、次に、電源投入時の更新シーケンスでピンPG9に対応する物理ボタンはどれかを尋ねてきました。その後、HY3131ドライバー、RMS演算、測定値のスケーリング、EEPROMの校正値保存、ピークホールドのルーチンを1サイクルあたり15 ~ 20関数ずつ進め、検証済みの関数は132に達しました。この間にセッション使用量は86%から98%へと上昇し、レート制限の警告が表示されました。エンジニアは上限まで実行させたうえで、使用量を監視して95%で一時停止するというルールを付けて、夜通し作業を続けるよう指示しました。
翌朝の報告
朝になると、エージェントはアプリケーション全体の再構築とコミットが完了したと報告しました。エミュレーション中に生成したビルドのサイズは144,460バイトと報告されています。
| 指標 | 結果 |
|---|---|
| 把握した関数 | 796 |
| C言語で再構築 | 691 |
| 標準ライブラリ(FATファイルシステムなど)と照合 | 64 |
| 割り込みハンドラー | 41 |
| 等価性テストの合格 | 591件中591件 |
| シミュレーション実行時間 | 40秒以上 |
再構築した各ルーチンは、同一の擬似乱数による初期状態から実行し、オリジナルのRAMと周辺機器への書き込みと比較しました。ハーネスは意図的なエラーも注入し、比較が逸脱を検出できることを証明しています。シミュレーションでは起動、起動画面、ディスプレイ駆動、キー押下が再現されました。
その過程でエージェントは本物のバグも発見しました。1msの起動カウントダウンをvolatile修飾子なしのタイトループでポーリングしていたため、GCCがこれを古いレジスタ値の読み出しに最適化してしまっていたのです。エージェントはこれを修正し、文書化されていないいくつかの挙動はそのまま残し、残作業を列挙しました。ブートローダー、オプションバイト、EEPROMに触れずにアプリパーティションだけを書き込むこと、ハードコードされたRAMアドレスを適切なC言語のグローバル変数に変換すること、オープンソースライセンスを選ぶことです。
書き込みと、慎重すぎるエージェントのコスト
ST-LINK経由でapp.binを書き込むよう求められたClaude Codeは、単純に書き込みませんでした。651,400トークンのコンテキストを圧縮したうえで、長い事前チェックを開始したのです。ターゲット電圧の確認、既存セクターの読み出し、ブートローダー、EEPROM、周辺機器設定の再検証、バイナリの再ビルド、メモリマップの再確認と続き、およそ4,600トークン、さらに5,800トークンを消費しました。ファイルをSDカードに載せれば数秒で済んだはずです。
次にエージェントは自分のクロック初期化コードを逆アセンブルし、2つ目の本物の問題を見つけました。GCCの出力はオリジナルのIARビルドより高速に実行されるため、外部水晶振動子が安定する前にCPUがクロック切り替えに到達し、起動時にハングしていたのです。この診断と修正には11分以上と8,700トークンを要しました。エンジニアが「はい、修正版を書き込む」を選ぶと、実際の書き込みは約22秒で終わり、LCDが点灯しました。

▲ 再構築ファームウェアの実機初起動
エージェントはすぐに、頼まれてもいない書き込み後の診断を始めました。プログラムカウンターのサンプリング、RAMの読み出し、動作中のLCDレジスタの検査と続き、さらに2,700トークンの冗長なチェックを費やしたところでエンジニアが中断させました。ログは、修正版ビルドとフラッシュの完全一致と、バージョン2.05を表示する正常な起動を確認していました。
ベンチでの結果
デバッガーを外し、メーター単体でテストしました。
| テスト | 結果 |
|---|---|
| 抵抗と導通(プローブを指で触れる) | 応答良好、ADCループが動作 |
| 抵抗のオートレンジ | 工場出荷時と同じ通常の速さで安定 |
| 10V精密基準電圧 | 9.9998V |
| 10kΩ精密抵抗 | 合格 |
| 内部温度 | 26.6℃ |
| Bluetooth Low Energy | Windows用コンパニオンアプリが即座に接続、ライブ測定値はLCDと一致 |
Bluetoothの結果は特筆に値します。コンパニオンアプリが動作するには、パケットのフレーミング、パラメーターの書式、パースのすべてが正確でなければならないからです。
最終的にコンパイルされたapp.binは90KBで、工場出荷時イメージの124KB、コミュニティ版アセンブリビルドの約142KBと比べて小さくなっています。SDカードと電源投入時のブートローダー用ボタン操作という通常の手順での書き込みも成功しました。
リポジトリの中身
出力ディレクトリには、main.c、measure.c、hy3131_tables.cといったモジュール化されたCソースが収められています。最後のファイルには、バイナリ構造から復元した校正テーブルとレジスタ定義が詰まっています。Markdown形式のアーキテクチャ文書は、チップのレジスタ、周辺機器インターフェース、メモリ境界、ディスパッチマップを記述しています。エージェントは自身の解析のためにHY3131のPDFデータシートをプレーンテキストに変換し、LCDガラスのレイアウトをセグメント定義付きで抽出しました。この深さの文書を手作業で作れば、エンジニアが数週間から数か月かかってもおかしくありません。コードベース全体はGitHubで公開される予定で、コミュニティが監査と拡張を行えるようになります。
組み込み開発者にとっての意味
この実験は、ローカルツールにアクセスできるエージェントが、中規模の商用ファームウェアイメージについて、デコンパイル、再構築、検証のループ全体を1つのプロンプトから処理できるようになったことを示唆しています。これは組み込み開発のやり方の大きな転換に見え、ソフトウェアを学ぶ学生が適応すべき理由でもあります。同時にこの実行は限界も示しています。ハードウェアの改造、ダイヤル操作、結果の判断、そして繰り返しエージェントに停止を指示することは、依然として人間の仕事でした。物理的なレンジ切り替えの自動テストには、サーボやステッピングモーターの治具が必要になるでしょう。
今回の実行から得られる実践的な教訓は次のとおりです。
- 実験的なものを書き込む前に、フラッシュ、EEPROM、オプションバイト、システムROMをバイト単位でバックアップし、2回ダンプしてチェックサムを比較する
- 複雑な多段階の作業にはHighのeffortとプランモードを使い、回路図やマニュアルを添付し、推測せず質問するようエージェントに指示する
- 見えるドライブをすべて読まれたくなければ、エージェントを作業ディレクトリやコンテナに閉じ込める
- エージェントを無人で動かす前に、トークンのしきい値や自動一時停止を設定する。上限なしのエージェントは予想外の請求を生みかねない
- 速度とコストが重要な場面では、余計な検証ループなしに書き込みなどの操作を直接実行するよう明示的に指示し、マイルストーンに達したら中断する
- コンパイラー間の移植ではタイミングの差を想定し、割り込みと共有する変数にはvolatileを付け、発振器の安定を待つ明示的なウェイトを追加する
- 精密基準器、内部温度センサー、メーカーのコンパニオンソフトで結果を検証し、バイナリサイズをオリジナルと比較する
こうした使い方をすれば、エージェントはファームウェアのリバースエンジニアリングの単純作業の大半を肩代わりしてくれます。制約なしに使えば、手作業なら数秒で確認できることの検証に予算を費やしてしまいます。


