検証状況¶
要点
- どの機能が実車で確かめられていて、どれがシミュレータや計算の上の値なのかの一覧です。
- ほかのページの数値を使う前に、ここで該当の行を確認してください。
- 根拠は開発者本人の記録で、第三者による再現確認ではありません。
どの機能が実車で確かめられていて、どれがまだ計算上の値なのかを一覧にします。 ほかのページの数値を使う前に、ここで該当の行を確認してください。
この表の出どころ
根拠は、上位側の PROGRESS.md(「現在の状態」と「実機で確かめること」)、2026-11-09 までの作業記録
(git show 4921671:surge_mk2/PROGRESS.md)、ファーム側の CLAUDE.md(「現在の状態」。書き込みと実機確認の状況は上位の PROGRESS.md を正としている)、
ソースコード中のコメントです。確認した版: 上位 7c7054e(2026-11-15)、ファーム fc6956c(2026-11-15)。
これらは開発者本人の記録であり、第三者による再現確認ではありません。
記録が無いものは「確認できず」と書き、「未検証」とは区別しています。
凡例: 【実機確認】【シム/ホスト検証】【未検証】【確認できず】
STM32 ファームウェア¶
実機に書き込んだ記録があるのは fb65b6f(2026-11-01)までです。それより後の変更(自動停止の予想進路と車体の内側の点の除外、TC の作り直し、過速度ガードの分離)は
書き込みの記録がありません(PROGRESS.md「現在の状態」)。
| 機能 | 状態 | 根拠・注記 |
|---|---|---|
| 車速 PI + 目標車速のランプ | 【実機確認】 | 実機の周回走行の土台として使われており、ファーム側の未検証リストにも載っていない。ゲインは Pi が送る(vehicle.toml [dynamics]) |
| 車速 PI の加速度フィードフォワード | 【未検証】 | ファーム CLAUDE.md が「走行で検証できていない」と明記 |
| ローンチコントロール | 【未検証】 | 同上 |
| TC・ABS・片輪浮き対策 | 【シム/ホスト検証】 | 目標スリップ率は校正 7、ゲインは校正 8(tools/calib)で決める形。TC は 2026-11-09 に止めない PI(TractionLimiter)へ作り直したが、書き込みの記録が無く、校正 8 も録り直していない(PROGRESS.md は TC のゲインを「旧い数値最適化の値のまま」とする。スリップ制御) |
| 前進中の車速 PI の減速に ABS を掛ける | 【未検証】 | 2026-11-01 に書き込み済み。ARM・駆動・走行での確認が残っている(PROGRESS.md「実機で確かめること」) |
| 過速度ガード(指令の上限の 1 割上で正トルクを止める) | 【未検証】 | 2026-11-09 の分離は書き込みの記録が無い |
| トルクベクタリング(荷重比例の配分) | 【未検証】 | 実機未検証と明記。今は上位の設定(tv_enable = 0)で無効。旧方式(ヨーレート PI)はループゲインが小さすぎるなどの理由で作り直した(理由) |
| ステアのリンク換算(非線形) | 【未検証】 | 換算の係数は実機の校正値(校正 2)。ファーム CLAUDE.md は「走行で検証できていない」に入れている |
| 自動停止(LiDAR 主・超音波補助) | 【未検証】 | 予想進路(2026-11-02)と車体の内側の点の除外は書き込みの記録も無い。遅延(LiDAR 1 回転+MD のトルクの遅れ)は通しでは未実測 |
再 ARM の規則(rearm_required) |
【未検証】 | フェイルセーフの後、ARM を一度下ろすまで走らない。ファーム CLAUDE.md が未検証と明記(安全層) |
MD 異常のデバウンス、LIMITS パケット、省電力化(超音波・LiDAR の PWM 停止) |
【未検証】 | ファーム CLAUDE.md |
| 後輪の位置保持(サイドブレーキ) | 【実機確認】 | ファーム CLAUDE.md |
| ブレーキホールドへの移行条件 | 【未検証】 | しきい値は机上値 |
| LiDAR 給電の ARM 連動 | 【実機確認】 | ファーム CLAUDE.md |
| ハートビート断による緊急停止ラッチ | 【実機確認】(運用上) | surge-io を再起動すると E-Stop がラッチし、ボタン 2 を押すまで戻らない、という運用の注意が tools/deploy.sh と docs/development.md にある。計画的な試験の記録は確認できず |
| ブレーキ灯のしきい値 | 【実機確認】 | 実機の周回記録(最高 2.8 m/s・262 秒)に当てて決めた(vehicle.h のコメント) |
| 緊急制動表示(ESS)のしきい値 | 【未検証】 | 縮小した値で、未実測プレースホルダー |
ステレオの点による自動停止(STEREO_OBS、v0.31) |
【シム/ホスト検証】 | 2026-11-15 にコミット(fc6956c)。しきい値は実走行の記録 2 本をファームの判定に通して決めた(tools/fwsim/stereo_replay)。書き込みの記録は無く、実機で止めたときの停止距離と誤検知は未確認(安全層) |
ウィンカーの点滅の仕方(winker_mode、v0.30) |
【確認できず】 | 2026-11-13 に追加。実機で確かめた記録は見当たらない |
上位(Raspberry Pi)¶
Pi 側は、2026-11-06 までの変更を Pi で走らせています(記録 surge_20261106_135218 まで)。2026-11-09 の変更は Pi に反映した記録がありません(PROGRESS.md)。
| 機能 | 状態 | 根拠・注記 |
|---|---|---|
経路選択走行/レーシングライン走行(slam2d_route / slam2d_raceline) |
【実機確認】 | 2026-10-13 の記録で 5.3〜5.9 s/周(周長 14.7 m のコースでは 5.77〜5.89 s、走行中の学習あり)。11 月は 2026-11-02 に slam2d_route で 27 周(1 周 7.4〜7.7 s)、2026-11-06 に 2 本(1 本目は 26 周を衝突・スタックなし、最良 7.70 s・平均 7.85 s。2 本目は障害物を置く前で最良 7.53 s・平均 7.76 s、途中から置いた障害物にも衝突なし)。走行ごとに地図が違うので、周回時間はそのまま比べられない。MPC 追従も使用 |
走行中のグリップ学習(grip_learn) |
【実機確認】(動作)/効果は【確認できず】 | 初版は実機で誤検出し 1 周 5.7 s → 13.1 s に悪化。2026-10-29 に作り直した版は 2026-11-06 の実機の走行で使い、横の学習値は 4.39〜4.74 m/s² で収束した。作り直した版でタイムが縮んだかの集計は確認できず。コードの既定は「切」 |
| アンダーステア勾配 \(K\) の学習 | 【実機確認】(動作) | 2026-11-06 の実機で使用。1 本の走行の中で \(K\) が下がり続けた現象は、加減速中の標本を外す修正の後は収まった(PROGRESS.md は「原因が分かっていないこと」に挙げている) |
| 障害物の回避(Frenet 格子・Hybrid A* の迂回) | 【実機確認】(静止物) | 2026-11-06 の記録で、周ごとに位置を変えた障害物を衝突なしで通過(Hybrid A* の迂回 2 回)。動く他車の追い抜きの実機の記録は確認できず |
| 2026-10-31〜11-01 の修正(舵の見張り・odom の手押し・解除後の再特定・車体内の点のマスク) | 【未検証】 | Pi へは反映済み。ARM・駆動・走行での確認が残っている。舵が追従しない現象の原因(ステア MD のファーム・エンコーダ)は調べていない(PROGRESS.md) |
| 2026-11-09 の変更(解除後に経路に沿って止める・経路への合流・止まった姿勢からの再特定・遮られたときの自己位置・LiDAR のノイズ除去) | 【未検証】 | Pi に反映した記録が無く、実機では確かめていない(PROGRESS.md) |
| 地図作成・凍結地図での追従の処理時間 | 【実機確認】 | Pi 5 の実測: 地図作成 1 スキャン平均 16.5 ms・p99 105 ms・最大 133 ms、凍結地図 平均 8.2 ms |
駐車(park_to_point) |
【シム/ホスト検証】 | シムで 42/48 成功・衝突 0/48(センサ誤差あり)。Hybrid A* と毎周期の局所地図を C に書き直してからは、実機ではまだ走らせていない(PROGRESS.md) |
| 反射型(FTG・Disparity Extender) | 【シム/ホスト検証】+【実機確認】(動作) | 周回時間の比較はシムの値(LiDAR で空いている方向へ) |
LiDAR の強化学習モデル(e2e_lidar) |
【シム/ホスト検証】+【実機確認】(動作) | シムで学習。シムでの新しい学習は止めている(PROGRESS.md、強化学習) |
カメラ模倣学習(cam_e2e) |
【実機確認】(周回、カメラ 1 台の頃) | 2026-10-30 の記録で、v7 は約 1 m/s で約 2 周を接触なし、v9 は平均 2.25 m/s で約 7 周走った後、コース上の人に衝突した(このモードは障害物では止まらない)。2026-11-13 に入力を左右 2 台に変え、旧いモデルは消した。左右 2 台の版は Mac のテストまでで、記録・学習・Pi への反映はまだ(模倣学習) |
E2E 融合(e2e_fusion) |
【シム/ホスト検証】 | 2026-11-11 に追加。2026-11-13 に画像の入力を左右 2 台に変え、旧いモデル(v1・v2)は消した。以下の数値はカメラ 1 台の頃のモデルのもの。学習に使っていない記録 3 本での開ループ評価のみ(経路誤差は最初の 2 m で 0.07〜0.17 m)。Pi へ未反映で、実走していない。入力を伏せた評価では、画像を伏せると経路誤差が約 3 倍になり、点群を伏せてもほぼ変わらない(E2E 融合) |
| 前方ステレオ: 取付・同期・校正(段階 0〜2) | 【実機確認】 | 2026-11-12。左右の時刻差は最大 67 µs(同期した組)、校正は基線 76.2 mm・平行化後の縦ずれ中央値 0.29 px で合格。既知の距離の壁(0.5/1.0/1.5 m)で距離は ±1〜3 %(PROGRESS.md、stereo_plan.md) |
前方ステレオ: 照合(stereo_node、段階 4) |
【実機確認】(静止) | Pi に反映。撮影から scan/stereo まで中央値 47 ms、電流 +156 mA で合格。11-13 に ARM して組が途切れないことを確かめたが、駆動用バッテリーの電圧不足でモータは起動しておらず、走行中は未確認 |
| 前方ステレオ: 自動運転のモードで使う(段階 5) | 【未検証】 | 方針を決めただけで、作っていない |
| カメラの前後配置の削除(後方カメラ・バックミラーなど) | 【確認できず】 | 2026-11-13 にコードから消した。PROGRESS.md は「Pi 未反映」 |
| カメラ系(セグメンテーション、白線) | 【実機確認】(動作) | 動作の記録はあるが、周回性能の記録は確認できなかった(カメラで道を見る) |
| 再 ARM のルール(E-Stop・通信途絶の後は ARM を入れ直すまで走らない) | 【未検証】 | Pi 側(io_node の _update_rearm_latch)とファーム側(rearm_required)の両方に実装がある。実機で確かめた記録は確認できず(安全層) |
計測で得た車両パラメータ¶
vehicle.toml の値は、2026-10-18 に作り直した車両の校正(docs/calibration.md)の結果です。
前輪エンコーダ(校正 1)は 2026-10-18 の記録、ステア・車速・後輪の空転・タイヤ・TC/ABS・加減速の上限(校正 2・3・5〜9)は 2026-10-20 に反映した値、
遅延(校正 4)は 2026-11-06 の記録の値です。11 月の校正の記録は、遅延のほかには確認できませんでした。
| 量 | 値 | 注記 |
|---|---|---|
横の上限([limits] a_lat_m_s2) |
約 4.1 m/s² | 旧旋回試験の μ 0.42 × g と同じ値で、2026-10-20 の反映でも変わっていない。走行中の学習の出発点(新しい地図はこの 0.85 倍から)。実機の走行中の学習では 2026-10-13 に約 6.7 m/s²、2026-11-06 に 4.39〜4.74 m/s² に収束した |
車体の利得(speed_plant_gain) |
約 12.6 (m/s²)/(N·m) | 校正 5(2026-10-20 反映)。旧解析の 21.5 は、PI を通した応答に記録時のゲインを既知として当てはめた誤り |
転がり抵抗の減速度(rolling_resistance) |
約 0.29 m/s² | 校正 5 |
スキャン完了 → STM32 が指令を受理(control_latency_s) |
約 3.9 ms | 校正 4(2026-11-06)。通信の待ちを減らした後に測り直し、12.1 ms から下がった |