Skip to content
ManDrake-hubPublic

About

Use an ESP32-S3 with round TFT display as navigation companion using BLE on Android with Google Maps

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

Repository files navigation

Navigator

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).


Repository layout

.
├── Embdedded_Navigate/        # ESP32 firmware (PlatformIO)
└── Android_Navigate/          # Android app (Gradle)

ESP32 firmware (PlatformIO)

Tooling

  • VS Code (Microsoft) + PlatformIO
  • Python 3
  • Board: esp32-s3-devkitc-1
  • Libraries: TFT_eSPI, NimBLE-Arduino

Main config: Embdedded_Navigate/platformio.ini

Display / Pinout (TFT_eSPI)

Config file: Embdedded_Navigate/lib/TFT_eSPI_Setup/User_Setup.h

Driver & resolution:

  • GC9A01_DRIVER
  • 240 × 240

Pins (current setup):

  • TFT_MOSI = 11
  • TFT_SCLK = 10
  • TFT_CS = 9
  • TFT_DC = 8
  • TFT_RST = 14
  • TFT_MISO = 12 (optional)
  • Backlight: TFT_BL = 2 (ON = HIGH)
  • SPI: 40 MHz

BLE

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

Build / Flash

Open Embdedded_Navigate/ in VS Code:

  • PIO: Build
  • PIO: Upload
  • PIO: Monitor (baud: 115200)

Android app

What it does

  • 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.

Permissions

Manifest includes:

  • POST_NOTIFICATIONS
  • Legacy BLE (maxSdk 30): BLUETOOTH, BLUETOOTH_ADMIN
  • Android 12+: BLUETOOTH_SCAN, BLUETOOTH_CONNECT
  • RECEIVE_BOOT_COMPLETED (optional auto-start)

Fullscreen / Insets

MainActivity applies proper WindowInsets padding to avoid overlapping system bars.

How to run

  1. Install the app from Android Studio (or Gradle).
  2. Open the app:
    • Request BLE / Notification permissions
    • Enable Notification Listener (opens Android settings)
    • Start BLE (Foreground)
  3. Start navigation in Google Maps: frames will be generated and sent to the ESP32.

BLE protocol (frames)

Firmware supports:

  • command: ping → replies pong
  • update frame: starts with u; followed by key=value pairs 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: dist
  • street (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


Notification parsing notes

  • 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).

Quick troubleshooting

  • ESP32 not found

    • check it is advertising (NavigatorDisplay)
    • ensure BLE is enabled and SCAN/CONNECT permissions are granted
  • 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: ...)

Support

If this project helped you and you’d like to support it ❤️:

Donate with PayPal


Screenshots

Navigator Bridge - main screen Google Maps notification ESP32 display (GC9A01A)

License

See LICENSE.

About

Use an ESP32-S3 with round TFT display as navigation companion using BLE on Android with Google Maps

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages