# xiaoxiangyuanxxy/diplay architecture

> Architecture diagram of the GitHub repository xiaoxiangyuanxxy/diplay, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xiaoxiangyuanxxy/diplay
- Repository: https://github.com/xiaoxiangyuanxxy/diplay

## Overview

DiPlay is an Android app that provides wired and wireless CarPlay for compatible BYD head units. The main workflow is to configure a connection, start the connection controller, establish a local accessory session with an iPhone, and render CarPlay media and controls; optional paths provide BYD HUD navigation, map features, and diagnostics. The graph combines sampled call relationships and SOURCE INDEX references with README-documented capabilities. Several subsystems are represented at directory level because their implementation was not sampled.

Main entry points: [`shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt) (Connection controller), [`common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt`](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt) (CarPlay host), [`shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlaySession.kt`](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlaySession.kt) (AirPlay session), [`shared/src/main/java/com/shilapi/xcertplay/network/CarPlayVpnService.kt`](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/network/CarPlayVpnService.kt) (AirPlay listener)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_host["CarPlay host"]
  node_settings["Connection settings"]
  node_session_service["Session service"]
  node_display["CarPlay display<br/>[CarPlayVideo.kt]"]
end

subgraph group_connection["Connection and protocol"]
  node_controller["Connection controller"]
  node_wireless["Wireless networking"]
  node_vpn["AirPlay listener"]
  node_airplay["AirPlay session<br/>[AirPlaySession.kt]"]
  node_media["Media engine"]
  node_transport["Device transport"]
  node_pairing[("Identity and pairing<br/>[PairingStore.kt]")]
  node_mfi["Local authentication"]
end

subgraph group_features["Car capabilities"]
  node_hud["BYD navigation HUD"]
  node_maps["Map features<br/>[MapEmbedService.kt]"]
end

subgraph group_support["Persistence and support"]
  node_diagnostics["Diagnostic export"]
  node_updates["Update checks<br/>[UpdateClient.kt]"]
end

node_driver(("Driver"))
node_iphone(("iPhone"))

node_driver -->|"opens"| node_host
node_host -->|"loads settings"| node_settings
node_host -.->|"starts session"| node_session_service
node_host -.->|"controls connection"| node_controller
node_controller -->|"starts wireless"| node_wireless
node_controller -->|"attaches listener"| node_vpn
node_iphone -->|"connects"| node_vpn
node_vpn -->|"creates session"| node_airplay
node_airplay -->|"dispatches streams"| node_media
node_airplay -->|"uses pairing"| node_pairing
node_controller -->|"authenticates locally"| node_mfi
node_controller -.->|"uses wired transport"| node_transport
node_media -.->|"delivers video"| node_display
node_controller -->|"routes navigation"| node_hud
node_hud -->|"shows guidance"| node_driver
node_host -->|"supports maps"| node_maps
node_driver -->|"exports report"| node_diagnostics
node_driver -.->|"checks updates"| node_updates

click node_host "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt"
click node_settings "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/AirPlayPersistence.kt"
click node_session_service "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/DiPlaySessionService.kt"
click node_controller "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt"
click node_wireless "https://github.com/xiaoxiangyuanxxy/diplay/tree/main/shared/src/main/java/com/shilapi/xcertplay/network"
click node_vpn "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/network/CarPlayVpnService.kt"
click node_airplay "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlaySession.kt"
click node_media "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/CarPlayMediaEngine.kt"
click node_transport "https://github.com/xiaoxiangyuanxxy/diplay/tree/main/shared/src/main/java/com/shilapi/xcertplay/transport"
click node_pairing "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/PairingStore.kt"
click node_mfi "https://github.com/xiaoxiangyuanxxy/diplay/tree/main/shared/src/main/java/com/shilapi/xcertplay/mfi"
click node_display "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/CarPlayVideo.kt"
click node_hud "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/hud/BydNavigationOutputs.kt"
click node_maps "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/MapEmbedService.kt"
click node_diagnostics "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/DiagnosticExportStore.kt"
click node_updates "https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/update/UpdateClient.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_host,node_settings,node_session_service,node_display toneBlue
class node_controller,node_wireless,node_vpn,node_airplay,node_media,node_transport,node_pairing,node_mfi toneAmber
class node_hud,node_maps toneMint
class node_diagnostics,node_updates toneRose
class node_driver,node_iphone toneIndigo
```

## Components

### App experience

- [CarPlay host](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt): `common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt`
- [Connection settings](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/AirPlayPersistence.kt): `common/src/main/java/com/shilapi/xcertplay/AirPlayPersistence.kt`
- [Session service](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/DiPlaySessionService.kt): `common/src/main/java/com/shilapi/xcertplay/DiPlaySessionService.kt`
- [CarPlay display](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/CarPlayVideo.kt): `common/src/main/java/com/shilapi/xcertplay/CarPlayVideo.kt`

### Connection and protocol

- [Connection controller](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt): `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`
- [Wireless networking](https://github.com/xiaoxiangyuanxxy/diplay/tree/main/shared/src/main/java/com/shilapi/xcertplay/network): `shared/src/main/java/com/shilapi/xcertplay/network`
- [AirPlay listener](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/network/CarPlayVpnService.kt): `shared/src/main/java/com/shilapi/xcertplay/network/CarPlayVpnService.kt`
- [AirPlay session](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlaySession.kt): `shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlaySession.kt`
- [Media engine](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/CarPlayMediaEngine.kt): `shared/src/main/java/com/shilapi/xcertplay/airplay/CarPlayMediaEngine.kt`
- [Device transport](https://github.com/xiaoxiangyuanxxy/diplay/tree/main/shared/src/main/java/com/shilapi/xcertplay/transport): `shared/src/main/java/com/shilapi/xcertplay/transport`
- [Identity and pairing](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/PairingStore.kt): `shared/src/main/java/com/shilapi/xcertplay/airplay/PairingStore.kt`
- [Local authentication](https://github.com/xiaoxiangyuanxxy/diplay/tree/main/shared/src/main/java/com/shilapi/xcertplay/mfi): `shared/src/main/java/com/shilapi/xcertplay/mfi`

### Car capabilities

- [BYD navigation HUD](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/hud/BydNavigationOutputs.kt): `shared/src/main/java/com/shilapi/xcertplay/hud/BydNavigationOutputs.kt`
- [Map features](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/MapEmbedService.kt): `common/src/main/java/com/shilapi/xcertplay/MapEmbedService.kt`

### Persistence and support

- [Diagnostic export](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/DiagnosticExportStore.kt): `common/src/main/java/com/shilapi/xcertplay/DiagnosticExportStore.kt`
- [Update checks](https://github.com/xiaoxiangyuanxxy/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/update/UpdateClient.kt): `common/src/main/java/com/shilapi/xcertplay/update/UpdateClient.kt`

### Other components

- **Driver**
- **iPhone**

## Connections

- Driver → CarPlay host: opens
- CarPlay host → Connection settings: loads settings (evidence: `common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt`)
- CarPlay host → Session service: starts session (evidence: `common/src/main/java/com/shilapi/xcertplay/DiPlaySessionService.kt`)
- CarPlay host → Connection controller: controls connection (evidence: `common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt`)
- Connection controller → Wireless networking: starts wireless (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- Connection controller → AirPlay listener: attaches listener (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- iPhone → AirPlay listener: connects
- AirPlay listener → AirPlay session: creates session (evidence: `shared/src/main/java/com/shilapi/xcertplay/network/CarPlayVpnService.kt`)
- AirPlay session → Media engine: dispatches streams (evidence: `shared/src/main/java/com/shilapi/xcertplay/airplay/CarPlayMediaEngine.kt`)
- AirPlay session → Identity and pairing: uses pairing (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- Connection controller → Local authentication: authenticates locally (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- Connection controller → Device transport: uses wired transport (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- Media engine → CarPlay display: delivers video
- Connection controller → BYD navigation HUD: routes navigation (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- BYD navigation HUD → Driver: shows guidance
- CarPlay host → Map features: supports maps (evidence: `common/src/main/java/com/shilapi/xcertplay/MapEmbedService.kt`)
- Driver → Diagnostic export: exports report
- Driver → Update checks: checks updates
