
オープンソースのAndroid Auto電話側実装。プロトコルリバースエンジニアリング、TLS相互認証、H.264ビデオ投影、タッチ入力インジェクション、USB AOAを介したセンサーデータストリーミングを備えています。
Android Auto のスマートフォン側アプリのオープンソース実装です。このアプリはスマートフォン上で動作し、USB 経由で車のヘッドユニットに投影され、Google のプロプライエタリな com.google.android.projection.gearhead APK を置き換えます。
このプロジェクトは初期開発段階です。プロトコルハンドシェイク、映像投影、タッチ入力、車両データのデコードはすべて実機のヘッドユニットに対して動作します。接続の安定性は大幅に改善されています(15〜72分の連続動作を記録)が、まだ実証されたわけではありません — ヘッドユニットがセッション中に USB 電源(VBUS)を切断する現象が観測されています。以下のドキュメントを参照してください。
| ドキュメント | 内容 |
|---|---|
docs/protocol.md | 本実装のための AAP リファレンス。 フレーミング、TLS、チャネルモデル、チャネルごとのメッセージカタログ、センサーの pub-sub モデルとその相関に関する危険性、映像/フォーカス/フロー制御のルール、そして既知の曖昧さと落とし穴のまとめ。まずはここから。 |
docs/connection-stability.md | 接続の信頼性。 HU が強制するプロトコル要件、2つの異なる切断シグネチャ(HU による VBUS 切断 vs. ケーブル抜去)とその見分け方、証拠ログ、除外された原因、再接続/再起動の挙動、計測とログのリファレンス、センサーとテレメトリ、外部調査、そして優先順位付けされた TODO。 |
docs/research.md | エコシステム調査。 Android Auto リバースエンジニアリングの歴史、既存の OSS プロジェクト(headunit-revived、aasdk、openauto、AACS…)の比較、ヘッドユニット側 vs スマートフォン側、TLS/認証の分析、APK リバースエンジニアリングのメモ。 |
AGENT.md | このリポジトリで作業する AI エージェント/コントリビューター向けのガイドライン。 |
これらは常に最新の状態に保ってください — AGENT.md を参照。
「HUが受理/拒否」= このヘッドユニットの検証済み
SENSOR_START_RESPONSE(2026-10-24のクリーンな実行による。27リクエスト / 27レスポンス、不一致ゼロ)。以前の2026-10-23の表は無効 — レスポンスの相関が誤っており、3つずれていた。docs/connection-stability.md§5を参照。
自己責任で使用してください。 本ソフトウェアは「現状のまま」提供され、いかなる種類の保証も伴いません。
USB Plug-in → MainActivity → ProjectionService
↓
UsbAoaTransport (USB AOA accessory mode)
↓
MessageFramer (16KB frame fragmentation)
↓
InBandTls (TLSv1.2 via SSLEngine)
↓
ProtocolEngine (AAP state machine)
↓
┌───────────┼───────────┐
Video Input Audio
(H.264) (touch/keys) (PCM)
av_channel を映像、2 番目を音声として割り当てています。これはカーヘッドユニット(チャネル 1 = 映像)では動作しますが、openauto(チャネル 4 = 音声、映像ではない)では失敗します。修正方法: av_channel 内の stream_type フィールドを解析して VIDEO(3) と AUDIO(1) を区別する。docs/connection-stability.md にあります。VIDEO_FOCUS_NOTIFICATION UNFOCUSED を無視していたため、HU がバックカメラを表示している間も H.264 をディスプレイにストリーミングし続け、カメラ映像を破損させていました。HU がフォーカスを保持している間はフレームを抑制するようになりました。docs §1.8 を参照。02:00:00:00:00:00 を返す)ことが原因です。回避策: adb shell "echo $(adb shell settings get secure bluetooth_address) > /sdcard/Android/data/org.openandroidauto/files/bt_address.txt" で実際のアドレスを設定ファイルに書き込む。ユーザーが BT MAC を手動で入力できる UI 設定画面が必要です。廃止済み。 以前ここにあった表は「ヘッドユニットの USB 受信 バッファが持続的な高スループットでオーバーフローする」と結論づけていました。これは反証されました: 5 KB/s で失敗した一方、170 KB/s はより長く持続し、HU が物理的に VBUS を遮断することが示され(カーネル
vbus:0)、公式アプリは同じケーブルで無期限に動作します。
現在の最良の結果(イベント駆動型ビデオ、2026-10-19):
| ビルド | 継続時間 | 終了 |
|---|---|---|
| 一定 ~15 fps(旧) | 9 秒〜5 分 | HU が USB 電源を遮断 |
| 一定 ~15 fps(旧・最良) | 9 分 32 秒 | HU の切断 |
| イベント駆動 ~0.9 fps | 15.3 分 | ケーブルを手で抜く(HU は正常) |
| イベント駆動 ~0.9 fps | 12.7 分 | ケーブルを手で抜く(HU は正常) |
イベント駆動型映像はスループットを約 10 倍削減し(14.8 → 0.9 fps、5.8 → 0.5 KB/s)、それ以降 HU 起点の切断は見られていません。まだ証明されていません — これまでの全ての実行は手動で終了されました。無人での 30 分以上の実行が未解決のテストです。