How webbug-dev/mst2-cluster-nav-android-auto works
This is a MIB2 Standard head-unit mod that puts Android Auto or CarPlay maps in the instrument cluster and converts phone route guidance into the cluster’s native arrows, lanes, ETA and street display. The principal flow is phone stream into SAL, decode and stock display capture; route data travels to the HMI datapool, which feeds the cluster’s navigation display. README relationships describe some runtime stages not shown in sampled source; those edges are cited to the README, and unsampled internals are represented at their known source paths.
Main entry points: PhoneLink.java Phone link · aa.c SAL receiver · Activator.java HMI startup · Datapool.java Navigation datapool
Components 18
Head-unit video
- SAL receiver
native/src/sal/aa.c - Stream decode
native/src/sal/decode.c - Display capture
native/src/dm/dm.c
Phone protocols
- Android Auto protocol
native/src/sal/aa_proto.c - CarPlay route hook
native/src/common/route.c - CarPlay transport
native/src/ipod/ipod.c
HMI integration
- HMI startup
hmi/src/mst2/clusternav/Activator.java - Phone link
hmi/src/mst2/clusternav/PhoneLink.java - Android Auto service
hmi/src/mst2/clusternav/ClusterAndroidAuto.java - CarPlay service
hmi/src/mst2/clusternav/ClusterCarPlay.java - Map ownership
hmi/src/mst2/clusternav/KombiMap.java
Route guidance
- Guidance snapshot
hmi/src/mst2/clusternav/Guidance.java - Lane symbols
hmi/src/mst2/clusternav/Lanes.java - Maneuver display
hmi/src/mst2/clusternav/Maneuvers.java - Navigation datapool
hmi/src/mst2/clusternav/Datapool.java
Other components
- Android phone
- CarPlay phone
- Instrument cluster
Connections 21
- Android phone → SAL receiver: sends video
- Android phone → SAL receiver: sends route
- SAL receiver → Android Auto protocol: processes protocol
native/src/sal/aa.c - SAL receiver → Stream decode: provides stream
- Stream decode → Display capture: renders display
- Display capture → Instrument cluster: sends MOST video
- CarPlay phone → CarPlay transport: sends route
- CarPlay transport → CarPlay route hook: dispatches guidance
- HMI startup → Phone link: starts listener
hmi/src/mst2/clusternav/Activator.java - HMI startup → Android Auto service: installs service
hmi/src/mst2/clusternav/Activator.java - HMI startup → CarPlay service: installs service
hmi/src/mst2/clusternav/Activator.java - Phone link → Guidance snapshot: parses route
hmi/src/mst2/clusternav/PhoneLink.java - Phone link → Navigation datapool: publishes guidance
hmi/src/mst2/clusternav/PhoneLink.java - Phone link → Android Auto service: sets ownership
hmi/src/mst2/clusternav/PhoneLink.java - Phone link → CarPlay service: sets ownership
hmi/src/mst2/clusternav/PhoneLink.java - Phone link → Map ownership: sets video state
hmi/src/mst2/clusternav/PhoneLink.java - Guidance snapshot → Lane symbols: contains lane data
hmi/src/mst2/clusternav/Guidance.java - Navigation datapool → Instrument cluster: writes BAP guidance
hmi/src/mst2/clusternav/Datapool.java - CarPlay route hook → Phone link: forwards guidance
- Android Auto protocol → Phone link: sends navigation state
- Maneuver display → Navigation datapool: supplies maneuver data