Navigation “companion display” system made of:
- ESP32-S3 + round TFT (GC9A01A 240×240) rendering turn/distance/street.
- Android app that:
- reads navigation notifications (Google Maps) via Notification Listener
- converts them into a compact text frame
- sends frames over BLE to the ESP32 using Nordic UART Service (NUS).
Note: the listener matches both Google Maps and Waze, but Waze is currently log-only (no frames are produced yet).
.
├── Embdedded_Navigate/ # ESP32 firmware (PlatformIO)
└── Android_Navigate/ # Android app (Gradle)
- VS Code (Microsoft) + PlatformIO
- Python 3
- Board:
esp32-s3-devkitc-1 - Libraries:
TFT_eSPI,NimBLE-Arduino
Main config: Embdedded_Navigate/platformio.ini
Config file: Embdedded_Navigate/lib/TFT_eSPI_Setup/User_Setup.h
Driver & resolution:
GC9A01_DRIVER240 × 240
Pins (current setup):
TFT_MOSI = 11TFT_SCLK = 10TFT_CS = 9TFT_DC = 8TFT_RST = 14TFT_MISO = 12(optional)- Backlight:
TFT_BL = 2(ON =HIGH) - SPI:
40 MHz
Advertising name: NavigatorDisplay
Nordic UART Service (NUS)
- Service UUID:
6E400001-B5A3-F393-E0A9-E50E24DCCA9E - RX (Write):
6E400002-B5A3-F393-E0A9-E50E24DCCA9E - TX (Notify):
6E400003-B5A3-F393-E0A9-E50E24DCCA9E
Open Embdedded_Navigate/ in VS Code:
- PIO: Build
- PIO: Upload
- PIO: Monitor (baud:
115200)
- Simple UI with:
- button to enable Notification Listener
- request BLE/notification permissions
- start BLE foreground service
- Foreground Service to keep BLE connection alive.
- NotificationListenerService to read navigation notifications.
Manifest includes:
POST_NOTIFICATIONS- Legacy BLE (maxSdk 30):
BLUETOOTH,BLUETOOTH_ADMIN - Android 12+:
BLUETOOTH_SCAN,BLUETOOTH_CONNECT RECEIVE_BOOT_COMPLETED(optional auto-start)
MainActivity applies proper WindowInsets padding to avoid overlapping system bars.
- Install the app from Android Studio (or Gradle).
- Open the app:
- Request BLE / Notification permissions
- Enable Notification Listener (opens Android settings)
- Start BLE (Foreground)
- Start navigation in Google Maps: frames will be generated and sent to the ESP32.
Firmware supports:
- command:
ping→ repliespong - update frame: starts with
u;followed bykey=valuepairs separated by;
Example:
u;seq=12;turn=right;dist_m=240;street=Via Roma;exit=2
Supported keys (firmware):
seq(sequence number)turn(maneuver type)dist_m(distance in meters) — alias:diststreet(street/destination label)exit(exit number, e.g. roundabout)spd_limit(speed limit) — alias:speed_limit,limit(supported by firmware; currently not filled by the app)screen=nav|status(switch screen)gps=0|1(GPS fix flag)
Supported turn values (main ones):
straight, left, right, uturn, roundabout, arrive, keep_left, keep_right, exit_left, exit_right, ramp_left, ramp_right, merge, none
- The app currently parses Google Maps (Italian phrasing) and rate-limits/deduplicates outgoing frames.
- Waze notifications are currently logged only (frame generation is not implemented yet).
-
ESP32 not found
- check it is advertising (
NavigatorDisplay) - ensure BLE is enabled and
SCAN/CONNECTpermissions are granted
- check it is advertising (
-
No navigation data on the display
- make sure Notification Listener is enabled
- test with Google Maps (Waze is log-only)
- check Logcat + ESP32 serial monitor (
BLE RX raw: ...)
If this project helped you and you’d like to support it ❤️:
See LICENSE.


