
프로토콜 리버스 엔지니어링, TLS 상호 인증, H.264 비디오 프로젝션, 터치 입력 주입 및 USB AOA를 통한 센서 데이터 스트리밍을 갖춘 오픈소스 Android Auto 휴대폰 측 구현
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가 강제하는 프로토콜 요구사항; 두 가지 서로 다른 연결 해제 시그니처(HU의 VBUS 차단 vs. 케이블 분리)와 이를 구별하는 방법; 증거 로그; 배제된 원인; 재연결/재시작 동작; 계측 및 로그 레퍼런스; 센서 및 텔레메트리; 외부 연구; 그리고 우선순위가 지정된 TODO. |
docs/research.md | 생태계 조사. Android Auto 리버스 엔지니어링의 역사, 기존 OSS 프로젝트(headunit-revived, aasdk, openauto, AACS…) 비교, 헤드 유닛 측 vs 폰 측, TLS/인증 분석, 그리고 APK 리버스 엔지니어링 노트. |
AGENT.md | 이 저장소에서 작업하는 AI 에이전트/기여자를 위한 지침. |
이 문서들을 최신 상태로 유지하세요 — AGENT.md를 참조하세요.
"HU 수락/거부" = 2026-10-24의 깨끗한 실행에서 검증된 이 헤드 유닛의
SENSOR_START_RESPONSE(27개 요청 / 27개 응답, 불일치 0건). 이전의 2026-10-23 표는 유효하지 않았음 — 응답이 잘못 상관되어 세 칸씩 밀렸음.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을 비디오로, 두 번째를 오디오로 할당합니다. 이는 차량 헤드 유닛(채널 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분 이상 실행이 남은 테스트입니다.