DiPlay
English

Choose a method

A saved network password only records configuration. Check discovery, the first video frame, audio and reconnection separately before calling a setup working.

If USB works but wireless fails on the same build, prioritize pairing and radio checks. If both fail, check startup, permissions and decoding before changing Wi-Fi channels.

MethodRequirementsWhat to check
Built-in car hotspotAPK-compatible Android; actual firmware test neededCar hotspot enabled; exact SSID/password saved; Bluetooth pairing
Wi-Fi DirectAndroid 7.0+; firmware support requiredPermissions, Location on older Android, actual radio/channel behavior
Same LAN / Existing Wi-FiAndroid 7.0+; car and iPhone on the same external networkSaved network credentials, Bluetooth pairing, multicast discovery and no client isolation
USBAndroid 7.0+; data port/cable and correct USB rolesA useful comparison when wireless fails

Built-in hotspot setup

0.2.22 — Fixes 0.2.21 car-hotspot interface selection on DiLink 3.0/4.0 and fast/stuttering Wi-Fi music. Clear an old Hotspot interface workaround if no longer needed. Music clock checks on a test head unit do not validate every firmware.

  1. Turn on the car hotspot. Choose 5 GHz if available; do not use iPhone Personal Hotspot.
  2. In DiPlay Settings → Connection → Connection setup → Built-in car hotspot, save the exact name and password. Update them if the car settings change.
  3. Enable Bluetooth and Wi-Fi on the iPhone, pair with the car, tap Connect phone, then accept CarPlay prompts. You do not need to join the hotspot manually first.

Radio and version caveats

A 5 GHz station capability does not prove a 5 GHz Wi-Fi Direct group can be created. Firmware may reject group channels. Keep a supported fallback instead of changing country codes or driver properties.

Android 10 getNetworkName crashes were reported in #15/#44/#79. Current source avoids the problematic getter; #79 maintainer says fixed in 0.2.8, while the reporter has verified a custom build only.

The old Local hotspot option was removed in 0.2.6. Follow the current saved-hotspot flow if you are using an older tutorial. No ADB or car internet subscription is required for hotspot connection setup.

Wireless startup can choose a free AirPlay port; Wi-Fi Direct handles unknown security reports, busy channels and bounded 5 GHz to 2.4 GHz fallback (PR #121/#143). Wi-Fi Direct packet loss, device-specific microphone input and reconnect problems still need hardware investigation; no universal fix is claimed.

Stuck preparing CarPlay: which connection checks apply?

Enable iPhone Bluetooth, Wi-Fi and Siri; allow CarPlay and select the correct paired phone. Car hotspot needs its actual name/password; Wi-Fi Direct needs working head-unit P2P and permissions; only existing Wi-Fi needs both devices on a reachable LAN. Then try re-pairing, normal restarts or USB. Start the hotspot manually if needed; try an English name if a non-English name stalls.

Stuck preparing CarPlay: which connection checks apply?
Original fault report; the interface and version may differ. #580 View original report

Find where wireless connection stops

Wireless adds MIUI 13 Bluetooth permissions, an immediate Bluetooth-off prompt and failure-specific recovery tips. Enter the actual second hotspot name ending in _5G when it exists. Wheel-key service recovery waits before re-enabling; hotspot-start reports give the cause.

  1. Check which mode is selected: car hotspot, Wi-Fi Direct or Same LAN. Their network requirements differ; do not mix instructions from different modes.
  2. For car hotspot mode, turn the hotspot on manually and check that its current name and password match the saved settings. For Same LAN, check that both devices can communicate on the same network.
  3. If preparation still stalls, compare USB with the same APK and phone. Record the stage and full error before changing pairing or several settings at once.

Version notes for this guide

0.2.13 — 0.2.13 adds firmware-dependent Android 9 Wi-Fi Direct using actual group credentials. Requested channels remain unverified on Android 9; Android 10+ verifies frequency. Cleanup retains persistent profiles (PR #282).

0.2.12 — Same LAN supports open, WPA2-Personal and WPA2/WPA3 mixed networks; WPA3-only, enterprise and captive portals are outside its current scope. Allow multicast discovery. A contributor tested a standalone build on a 2022 Han DM-i / DiLink 4.0 / Android 10 / firmware 21.1.21.2401160.1; that is not a vehicle test of the complete signed 0.2.12 release.

Full updates, older version details and their validation limits are now collected in the version history. Follow the links below for the complete notes.

Reported setups

The following are source reports, not a universal affected-car list. Unknown fields remain unknown.

BYD Song Pro · DiLink 3.0 · Android 10

iPhone 14 Pro Max / iOS 27.0 · DiPlay 0.2.0
Reported incompatible

Bluetooth pairs but CarPlay startup crashes with getNetworkName error. AI-generated cause in the report is not accepted as proof. Do not generalize this to all DiLink 3.

View original report
Last verified: 2026-10-01

Related GitHub issues

Closed does not necessarily mean fixed. The source is authoritative for later updates.

Your next step

Sources

View source details (5)