Repository navigation
Troubleshooting
Back to the README.
After the reboot, plug an iPhone in by cable and check each part on screen:
- Cluster map — a short intro in the cluster, then the phone's map in place of the stock one. A long press of the left steering-wheel roller swaps it for the stock map and back.
- Route guidance — start a route in Apple Maps or Google Maps: the maneuver appears in the cluster's tile with the distance and the street.
- Cover art — play something with artwork: it appears on the cluster's now-playing widget.
- D-pad — drag on the MMI touchpad in a CarPlay list: the selection moves.
The installer's own report is at /tmp/carplay_install.log.
./install.sh: No such file or directory — but the file is right there and
executable. Also : unknown option and install.sh[21]: set:. The scripts have
Windows line endings: download the repository fresh, or see
the vi recipe.
The unit stays on the Audi logo after installing with PDC=1. The parking popup
replaces stock HMI classes, and on firmware it was not checked against the HMI then does
not start. Releases before v1.1.4 let PDC=1 force it onto any firmware. Delete
mod/carplay/PDC from the card and install again without PDC=1: the installer removes
pdc_hook.jar. Over SSH, rm /mnt/app/eso/hmi/lsd/jars/pdc_hook.jar and a reboot do the
same.
M.I.B. says "Nothing to do!". That is M.I.B. V3.6 or later: its Run individual script runs /mod/command.sh, not custom.sh. Copy command.sh from this repository
to /mod/ next to custom.sh.
The M.I.B. script does nothing, or prints "it is all done!" with no install log.
Most often the same line-ending problem. Otherwise check the card: /mod/custom.sh and
/mod/command.sh as copied from this repository (not hand-written — on the unit the card
is /net/mmx/fs/sda0, so a /mod/... path inside a script points nowhere), and the
payload at /mod/carplay/ next to them, not inside them.
mkdir: <name>: Function not implemented. You are under /tmp, which holds no
directories on this unit. Use a path on /mnt/app.
Read-only filesystem. mount -uw /mnt/app and mount -uw /mnt/system first —
the installer does this itself, a manual cp needs it too.
Nothing works and the hook is not in the config. One line should match:
grep libcarplay_hook.so /mnt/system/etc/eso/production/smartphone_integrator.jsonInstallers before 2026-08-31 could skip that edit; re-run the current one.
The cluster keeps its stock map. In order of likelihood:
-
A wireless CarPlay adapter. Not every adapter asks for the cluster's screen;
try the iPhone by cable. Which adapters work is in
Compatibility.
Some adapters bring the cluster map up only in a particular audio or connection
mode, set on the adapter's own web page: one did after switching its audio mode to 3
(#32). Also try an
empty
WIRELESS_MAPfile next toinstall.sh(underscore, not hyphen) and install again — see Installation. - It is switched to the stock map. A long press of the left steering-wheel roller swaps back; the choice is kept across ignition cycles.
- The phone was plugged in before the reboot. Unplug and plug back in.
-
No hardware decoder on this firmware.
ls /mnt/app/armle/lib/libnvss_video.so— without that file the map cannot come up. -
Route guidance is off (
/mnt/app/rgd_disable) or was left out — the map rides on it.
The map shows the phone's standard style although the phone is on satellite. The cluster gets the phone's own instrument-cluster view, and the phone decides its style; there is no way to ask it for satellite.
Switching the cluster layout (Classic ↔ Sport) shows holes or the old plate in the maneuver tile for a second or two. The cluster animates the change on its own clock; it settles by itself.
A grey or white flash when switching navigation apps. That is the phone's own placeholder between apps, shown as it comes.
No maneuver appears at all. In order of likelihood:
- The app. Waze sends no route guidance over CarPlay; Apple Maps and Google Maps do. Try Apple Maps before suspecting the patch.
-
The shim did not take.
ls -l /mnt/app/armle/usr/sbin/mm-ipod— a few hundred bytes (a shell script), not several megabytes. If it is still the binary, the install did not finish. - The phone was plugged in before the reboot. Unplug and plug back in.
-
The off switch is on.
ls /mnt/app/rgd_disable— delete it and reboot.
The street and the distance appear, but the tile stays empty. The renderer and its
shaders belong together: check ls /mnt/app/eso/hmi/lib/shaders/ shows four .bin
files, and reinstall everything from one download.
The maneuver is out of date while standing still. Google Maps stops publishing when the car does not move, and the last maneuver is kept rather than blanked. It updates as soon as the phone says anything.
The tile is empty for a few seconds mid-route. Driving through a waypoint ends one route and starts the next; the tile holds the last maneuver for about four seconds to cover the gap.
The built-in navigation cannot plan a route after a CarPlay route. Fixed on 2026-09-06; on an older build a reboot clears it and an upgrade prevents it.
No cover at all. Check the cluster coding: module 17, Picture_Upload_Download
= active.
Green or magenta bands across the cover when skipping quickly, no cover until the first track change, the first cover of a session missing — all fixed in the 2026-09 builds. Upgrade.
If the unit loops or stays black and nothing answers (no screen, no telnet, VCDS can't reach module 5F), pull the infotainment fuse (20 A) for a few minutes and put it back. A user recovered a looping unit that way when a 30-minute sleep and the three-button reset did not help (#67).
If the HMI does not come up after a reboot, telnet on port 23 still works and does
not depend on the HMI or on sshd. Get in and delete the jars. /mnt/app is read-only
after every boot, so remount it first:
mount -uw /mnt/app
rm -f /mnt/app/eso/hmi/lsd/jars/coverart_hook.jar
rm -f /mnt/app/eso/hmi/lsd/jars/dpad_hook.jar
rm -f /mnt/app/eso/hmi/lsd/jars/rgd_hook.jar
rm -f /mnt/app/eso/hmi/lsd/jars/pdc_hook.jar
syncthen reboot. That alone returns the HMI to stock; the native parts are harmless without
the jars, and uninstall.sh cleans them up afterwards.
If CarPlay itself will not start — the screen stays black or the phone never
connects — put the original mm-ipod back:
mount -uw /mnt/app
cat /mnt/app/armle/usr/sbin/mm-ipod.orig > /mnt/app/armle/usr/sbin/mm-ipod
chmod 755 /mnt/app/armle/usr/sbin/mm-ipodUnplug and replug the phone. Creating /mnt/app/rgd_disable has the same effect
without restoring anything, and is the quicker thing to try first. To take only the
cluster map out of the way: rm /mnt/app/altscreen_inject and replug.