Repository navigation
Troubleshooting
- App not installed on update: the installed copy was signed with another key. Uninstall once, reinstall.
- Update never shows: check the unit has internet; Settings → General → About → Check for updates. Want the newest builds first? Turn on Beta updates there.
- The update dialog has no Update button on a 600 px screen: fixed on 2026-10-15, the notes now scroll inside it. Update once by downloading the APK.
- Dashwheel crashed: it offers to send the error at the next start, once parked.
- Bluetooth adapter: pair it in Android's Bluetooth settings first, then allow Bluetooth when asked.
- An ELM327 takes one connection: unpair it from the phone or the unit's own Bluetooth app if they grab it.
- OBD dies when the phone connects to the unit: on QF units the phone and the adapter share one Bluetooth radio, and a phone whose Android Auto keeps trying to start wirelessly jams it. Turn wireless Android Auto off on the phone (or deny Android Auto the Nearby devices permission), or let the phone hold the adapter (OBD through this phone in the companion). Dashwheel then restarts the module by itself with root or the unit's ADB; the adapter is back about a minute later.
- The head unit refuses your Bluetooth adapter (some Joying units only take their own devices): use a USB OBD cable instead, see Car Data (OBD and CANbox).
- USB adapter not found: tap OBD and pick it at the top of the list. In Settings → Diagnostics → OBD adapter, OBD reached through must be Automatic or USB.
- Tyre pressures went blank after plugging in a USB TPMS receiver: fixed on 2026-10-12, Dashwheel no longer takes the receiver for an OBD cable.
- The Car problems tile shows the adapter's raw replies: include them in an issue.
- Weather unavailable (no internet connection): the unit is offline, check its Wi-Fi or hotspot. Nothing to do with root.
- Map data server not answering: OpenStreetMap's Overpass servers are down; Dashwheel tries four of them and the tiles come back by themselves. Roads read on your drives are kept, and Settings → Driving → Speed limits on the unit downloads the area around the car ahead of time. You can set your own in Map and route servers.
Grant Notification access to Dashwheel (one switch covers all three). Start playback or navigation so there's a notification to read.
Turn on Settings → Accessibility → Dashwheel. After an update that added key features, turn it off and on again.
Wait ~10 s: a watch reopens it. Apps that block screen capture always show black. Check Settings → Head unit → Unit tools → Google Maps inside a tile says Set up (Root and PMPatch3).
Settings → Head unit → The head unit's top bar → Hide it over app windows (opt-in: it misplaced windows on some units).
A wheel button that sends you somewhere, a look you can't leave, a stuck split or another launcher: from the paired phone, Companion → Tools tab → Rescue puts it right without touching the car's screen. See Phone Link and Companion.
Older QF firmware keeps its home screen as a floating window. Since 2026-10-20 Dashwheel forgets the window the unit remembered, gives the NAVI key back to the unit, opens the map beside it in a window instead of a split, and grows the dashboard back by itself (root, Shizuku or the unit's ADB). Update Dashwheel.
With root, Dashwheel unplugs and replugs the unit's TPMS box by itself: see Car Data.
See Second Screen Setup and Pairing.
A screen that feels nothing in one upright strip: Settings → General → Expert → Lab → Dead touch strip. Slide a finger across the screen once, check the strip found in red, save: the Settings side bar then grows past it.
It failed to start twice in a row. Tap Retry on the dashboard; if it comes back, send the crash report it offers.
Settings → General → About → Unit log sends the unit's log to the phone, to share as a bug report. No phone linked? Save the unit's log here writes it to the unit's Download → Dashwheel folder, to copy to a USB stick. It includes how the unit started and what Dashwheel read from Waze and Maps (their screens and their tiles), every screen opened since the unit started, the unit's own launcher settings and which app it holds as its home screen. A copy is kept the moment the unit finishes starting, and a report too big for the phone link drops old log lines, never its summary.
Fixed on 2026-10-10: update Dashwheel.
Fixed on 2026-10-10: the search goes back onto its tile, where the keyboard works. For the voice prompt, give Waze the microphone permission once.
From a computer on the same network as the unit: adb connect <unit-ip>:5555 (or the unit's own port), then adb logcat -s <Tag>. Useful tags: Obd, EmbeddedApp, DockShell, RomPopups, HeadUnitPhone, SecondScreen, DisplayLink, StreamDisplay.
Still stuck? Open an issue with your unit model, firmware, Dashwheel version and what you see.
Dashwheel is free to use. Enjoying it? ☕ Buy me a coffee on Ko-fi · Releases · Issues
Getting started
- Installation and Updates
- Root and PMPatch3
- How to Root Your Head Unit
- Supported Head Units
- Tested Hardware
- Troubleshooting
Dashboard
Car
Road
Phone and screens
More