# shihabal3amri/diplay architecture

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

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

## Overview

DiPlay is an Android app that provides wired and wireless CarPlay for compatible BYD head units. The main flow is user configuration, connection orchestration and transport setup, then AirPlay session handling and media delivery; optional branches provide BYD HUD/navigation features and parked video. The map includes documented capabilities whose implementation was not sampled, but omits uncertain wiring. Relationships are based on the README or cited source-index references and excerpts.

Main entry points: [`shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt) (Connection controller), [`shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlaySession.kt`](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlaySession.kt) (AirPlay session), [`common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt`](https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt) (Projection host), [`common/src/main/java/com/shilapi/xcertplay/DiPlayActivity.kt`](https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/DiPlayActivity.kt) (App interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and settings"]
  node_appui["App interface<br/>[DiPlayActivity.kt]"]
  node_host["Projection host"]
  node_settings[("Saved settings")]
  node_diagnostics[("Diagnostic export")]
end

subgraph group_connect["Connection and transport"]
  node_controller["Connection controller"]
  node_hotspot["Wireless networking"]
  node_vpn["NCM network bridge"]
  node_wired["Wired device transport<br/>[Iap2UsbMuxHost.kt]"]
  node_lockdown["Pairing and TLS"]
end

subgraph group_projection["CarPlay projection"]
  node_session["AirPlay session<br/>[AirPlaySession.kt]"]
  node_engine["Media engine"]
  node_media["Audio and video output"]
  node_identity["Accessory identity<br/>[AirPlayIdentity.kt]"]
  node_mfi["MFi authentication"]
end

subgraph group_vehicle["Vehicle features"]
  node_hud["BYD navigation output"]
  node_battery["Vehicle status<br/>[BydBattery.kt]"]
  node_video["Parked video<br/>[VideoInCar.kt]"]
end

node_driver(("Driver"))
node_iphone(("iPhone"))
node_headunit(("BYD head unit"))

node_driver -->|"configures"| node_appui
node_appui -.->|"opens projection"| node_host
node_appui -->|"saves options"| node_settings
node_host -->|"starts connection"| node_controller
node_host -->|"loads configuration"| node_settings
node_controller -->|"starts wireless"| node_hotspot
node_controller -->|"attaches network"| node_vpn
node_controller -->|"opens USB link"| node_wired
node_controller -->|"pairs wired device"| node_lockdown
node_controller -->|"creates session"| node_session
node_vpn -->|"serves AirPlay"| node_session
node_session -->|"dispatches streams"| node_engine
node_engine -->|"delivers media"| node_media
node_controller -->|"loads identity"| node_identity
node_controller -->|"selects authentication"| node_mfi
node_iphone -->|"sends projection"| node_session
node_session -->|"reports location"| node_iphone
node_session -->|"forwards guidance"| node_hud
node_hud -->|"outputs navigation"| node_headunit
node_controller -->|"provides vehicle status"| node_battery
node_session -->|"supports parked playback"| node_video
node_host -.->|"exports diagnostics"| node_diagnostics
node_hotspot -->|"connects wirelessly"| node_headunit
node_wired -->|"connects by USB"| node_iphone

click node_appui "https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/DiPlayActivity.kt"
click node_host "https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt"
click node_settings "https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/AirPlayPersistence.kt"
click node_controller "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt"
click node_hotspot "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/network/WirelessHotspotManager.kt"
click node_vpn "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/network/CarPlayVpnService.kt"
click node_wired "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/transport/Iap2UsbMuxHost.kt"
click node_lockdown "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/transport/LockdownTlsEngineFactory.kt"
click node_session "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlaySession.kt"
click node_engine "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/CarPlayMediaEngine.kt"
click node_media "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/media/AndroidMediaSink.kt"
click node_identity "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlayIdentity.kt"
click node_mfi "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/mfi/MfiAuthenticationClient.kt"
click node_hud "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/hud/BydNavigationOutputs.kt"
click node_battery "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/hud/BydBattery.kt"
click node_video "https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/VideoInCar.kt"
click node_diagnostics "https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/DiagnosticExportStore.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_appui,node_host,node_settings,node_diagnostics toneBlue
class node_controller,node_hotspot,node_vpn,node_wired,node_lockdown toneAmber
class node_session,node_engine,node_media,node_identity,node_mfi toneMint
class node_hud,node_battery,node_video toneRose
class node_driver,node_iphone,node_headunit toneIndigo
```

## Components

### App and settings

- [App interface](https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/DiPlayActivity.kt): `common/src/main/java/com/shilapi/xcertplay/DiPlayActivity.kt`
- [Projection host](https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt): `common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt`
- [Saved settings](https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/AirPlayPersistence.kt): `common/src/main/java/com/shilapi/xcertplay/AirPlayPersistence.kt`
- [Diagnostic export](https://github.com/shihabal3amri/diplay/blob/main/common/src/main/java/com/shilapi/xcertplay/DiagnosticExportStore.kt): `common/src/main/java/com/shilapi/xcertplay/DiagnosticExportStore.kt`

### Connection and transport

- [Connection controller](https://github.com/shihabal3amri/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/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/network/WirelessHotspotManager.kt): `shared/src/main/java/com/shilapi/xcertplay/network/WirelessHotspotManager.kt`
- [NCM network bridge](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/network/CarPlayVpnService.kt): `shared/src/main/java/com/shilapi/xcertplay/network/CarPlayVpnService.kt`
- [Wired device transport](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/transport/Iap2UsbMuxHost.kt): `shared/src/main/java/com/shilapi/xcertplay/transport/Iap2UsbMuxHost.kt`
- [Pairing and TLS](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/transport/LockdownTlsEngineFactory.kt): `shared/src/main/java/com/shilapi/xcertplay/transport/LockdownTlsEngineFactory.kt`

### CarPlay projection

- [AirPlay session](https://github.com/shihabal3amri/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/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/CarPlayMediaEngine.kt): `shared/src/main/java/com/shilapi/xcertplay/airplay/CarPlayMediaEngine.kt`
- [Audio and video output](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/media/AndroidMediaSink.kt): `shared/src/main/java/com/shilapi/xcertplay/media/AndroidMediaSink.kt`
- [Accessory identity](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlayIdentity.kt): `shared/src/main/java/com/shilapi/xcertplay/airplay/AirPlayIdentity.kt`
- [MFi authentication](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/mfi/MfiAuthenticationClient.kt): `shared/src/main/java/com/shilapi/xcertplay/mfi/MfiAuthenticationClient.kt`

### Vehicle features

- [BYD navigation output](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/hud/BydNavigationOutputs.kt): `shared/src/main/java/com/shilapi/xcertplay/hud/BydNavigationOutputs.kt`
- [Vehicle status](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/hud/BydBattery.kt): `shared/src/main/java/com/shilapi/xcertplay/hud/BydBattery.kt`
- [Parked video](https://github.com/shihabal3amri/diplay/blob/main/shared/src/main/java/com/shilapi/xcertplay/airplay/VideoInCar.kt): `shared/src/main/java/com/shilapi/xcertplay/airplay/VideoInCar.kt`

### Other components

- **Driver**
- **iPhone**
- **BYD head unit**

## Connections

- Driver → App interface: configures
- App interface → Projection host: opens projection (evidence: `common/src/main/java/com/shilapi/xcertplay/DiPlayActivity.kt`)
- App interface → Saved settings: saves options (evidence: `common/src/main/java/com/shilapi/xcertplay/DiPlayActivity.kt`)
- Projection host → Connection controller: starts connection (evidence: `common/src/main/java/com/shilapi/xcertplay/CarPlayHostActivity.kt`)
- Projection host → Saved settings: loads configuration (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 → NCM network bridge: attaches network (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- Connection controller → Wired device transport: opens USB link (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- Connection controller → Pairing and TLS: pairs wired device (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- Connection controller → AirPlay session: creates session (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- NCM network bridge → AirPlay session: serves AirPlay (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/AirPlaySession.kt`)
- Media engine → Audio and video output: delivers media (evidence: `shared/src/main/java/com/shilapi/xcertplay/airplay/CarPlayMediaEngine.kt`)
- Connection controller → Accessory identity: loads identity (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- Connection controller → MFi authentication: selects authentication (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- iPhone → AirPlay session: sends projection
- AirPlay session → iPhone: reports location
- AirPlay session → BYD navigation output: forwards guidance (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- BYD navigation output → BYD head unit: outputs navigation
- Connection controller → Vehicle status: provides vehicle status (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- AirPlay session → Parked video: supports parked playback (evidence: `shared/src/main/java/com/shilapi/xcertplay/orchestration/CarPlayController.kt`)
- Projection host → Diagnostic export: exports diagnostics
- Wireless networking → BYD head unit: connects wirelessly
- Wired device transport → iPhone: connects by USB
