A tiny Android Auto screen for your bike or car. MiniNav runs on the Waveshare ESP32-S3 2.8" touch display, connects to your phone over WiFi and shows Google Maps from Android Auto. No app on the phone, no Bluetooth, no extra hardware.
Step-by-step guide with diagrams: https://mininavdevice.github.io/MiniNav/ (hardware, one-click flashing, phone setup, connecting, riding, printing the case, troubleshooting). Building from source has its own page: docs/build-from-source.html.
Android Auto runs on the phone: the phone draws the Maps screen and streams it as video to a car's screen (the head unit), which only displays it. MiniNav plays the part of that car screen. Android Auto has a hidden developer option, Start headunit server, that lets a head unit connect to the phone over WiFi (TCP 5277); MiniNav connects, completes the Android Auto handshake (TLS), receives the H.264 map video and decodes it on the ESP32-S3.
- Joins your phone's hotspot (recommended, the phone keeps its mobile data) or runs its own WiFi.
- Day/night themes follow Android Auto's night mode.
- Optional full screen: hides Android Auto's app bar so the map fills the display.
- Optional touch: taps go to Android Auto (launcher, app lists).
- Built-in demo drive that works without a phone.
- Flips the picture when the board is turned over.
| Item | Notes |
|---|---|
| Waveshare ESP32-S3-Touch-LCD-2.8 | ESP32-S3R8, 16 MB flash, 8 MB PSRAM, 320x240 ST7789 LCD, CST3530 touch, QMI8658 IMU. Buy on Robu.in |
| USB-C data cable | Flashing and power |
| Android phone | Android Auto installed |
| 3D-printed case | Optional: front frame with BOOT button + back panel with strap slits, in docs/case/. No printer? Printing services such as Robu.in print it for about ₹100-200 |
Open the install guide in Chrome or Edge, either online at https://mininavdevice.github.io/MiniNav/
or docs/index.html from a clone, plug the board in and click Install MiniNav. Nothing to install. The firmware file is
docs/flash/MiniNav.bin (one image for address 0x0, not the 0x1000 some flashers default to) if you prefer another flasher.
Only needed to change WiFi names and passwords or other options.
Needs ESP-IDF v5.4.2.
git clone https://github.com/MiniNavDevice/MiniNav.git
cd MiniNav
tools/fetch_lovyangfx.sh # display library, once
source ~/esp/esp-idf/export.sh
idf.py build
idf.py -p <port> -b 921600 flash # e.g. /dev/cu.usbmodem101, /dev/ttyACM0, COM5If flashing can't connect: hold BOOT, tap RESET, release BOOT, then flash again.
After changing the code, python3 tools/make_web_firmware.py refreshes the files the guide's Install
button flashes (docs/flash/MiniNav.bin and MiniNav.bin.js).
- Android Auto settings: tap Version 10 times to unlock developer settings.
- Three-dot menu → Start headunit server.
- Android Auto battery usage → Unrestricted.
- Hotspot: name MiniNavHotspot, password mininav123, 2.4 GHz. (Or join the board's own WiFi MiniNav, password mininav123.)
Change names and passwords with idf.py menuconfig → MiniNav (Android Auto minimap).
| Do | Result |
|---|---|
| Tap Touch / Full screen / Theme on the connection screen | Change settings (saved) |
| Press BOOT | Day / night theme |
| Double-press BOOT | Touch on / off |
| Hold BOOT 1 s | Demo drive on / off |
| Option | Default |
|---|---|
| Access point name / password / channel | MiniNav / mininav123 / 6 |
| Phone hotspot name / password | MiniNavHotspot / mininav123 |
| Video density (bigger labels when higher) | 200 dpi |
| Hide Android Auto's app bar | on |
| Right-hand drive | on |
- Touch reaches Android Auto's launcher and lists, but not the Maps view itself.
- If the screen sticks at "Version", restart the phone's headunit server (three-dot menu → Stop, then Start headunit server).
main/app_main.cpp start-up, inputs, serial console
main/board.cpp display, connection screen, BOOT button, touch, IMU
main/net.cpp WiFi (access point + phone hotspot)
main/aap.cpp Android Auto protocol: framing, TLS, channels, input
main/video.cpp H.264 decoder, crop and scale to the LCD
main/demo.cpp built-in demo clip (main/demo.h264)
tools/ helper scripts (display library fetch, dev tools)
docs/ the guide website (GitHub Pages): web flasher (flash/), case STLs (case/)
- Android Auto protocol details follow Open Headunit;
main/aap_cert.his its published reference head-unit certificate. - Display: LovyanGFX. Decoder: Espressif
esp_h264. - UI font: Nunito (SIL Open Font License,
tools/fonts/OFL.txt). - MiniNav is licensed under the GNU AGPL-3.0 (
LICENSE).
Not affiliated with Google. Android Auto is a trademark of Google LLC.