Skip to content
sameerampereraPublic

About

Google Maps turn-by-turn navigation on TVS Raider bike cluster.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Disha

Disha

Disha (දිශා) · "directions" in Sinhala

Google Maps turn-by-turn navigation on your TVS SmartXonnect cluster.

The next turn, how far to it, and how long to go, on the bike's own screen, with your phone in your pocket.

Release Android Java Status

Disha Find bike screen listing nearby Bluetooth devices      Disha dashboard while connected to the bike      Disha connected to the bike while Google Maps navigation runs

Why Disha

TVS Connect, the official app, can show directions on the cluster, but its maps are often not accurate enough. Wrong turns, missing roads, and routes that do not match what Google Maps would take. Most riders already trust Google Maps, so Disha was built to put Google Maps' directions on the cluster instead.

  • Works with the Google Maps you already use. No separate maps, no downloads, no account. Start a trip in Google Maps and Disha follows it.
  • Starts by itself. When you start navigation in Google Maps, Disha connects to the bike on its own. Switch the ignition off and on, and it reconnects within seconds.
  • Keeps your rides. Every ride is recorded from the bike's own speed and odometer: distance, time, average and top speed.
  • Nothing leaves your phone. Disha has no internet permission at all.

Get started

  1. Install it: download Disha.apk from Releases and open it. Allow Install unknown apps when Android asks.
  2. Complete the setup list. Disha shows what is still missing, each with a Fix button:
    • Bluetooth & notifications — lets the app talk to the bike
    • Read Google Maps — needed to see the turn arrows
    • Run with screen off — stops the phone pausing navigation
  3. Find your bike: switch the ignition on, tap Find bike, and pick it from the list. Likely bikes are marked with a star. Disha remembers it.
  4. Ride: start navigation in Google Maps. The directions show up on the cluster.

Important

Disha is in beta. It has been tested on the TVS Raider. It may work on other SmartXonnect bikes, but that is not tested or guaranteed, and support for other bikes is not planned. If something looks wrong, please open an issue and attach the log (Share log in the app).

How it works

  1. Google Maps shows an ongoing notification while it navigates: the road, the distance to the next turn, the time and distance left, and the turn arrow as a picture.
  2. Disha reads that notification (this is the Read Google Maps permission). It reads the text for the numbers, and works out the turn from the shape of the arrow picture.
  3. It sends the update to the cluster over Bluetooth LE, in the same format TVS's own app uses, and keeps repeating it so the cluster keeps the navigation panel open.
  4. The bike sends back its speed and odometer about three times a second. Disha uses those to record rides.

Bikes and phones

BikeBuilt for the TVS Raider with SmartXonnect. Other SmartXonnect bikes may work, but are not supported.
PhoneAndroid 9 or newer, with Bluetooth LE.
Google MapsSet to English. Disha reads Maps' words, so other languages are not understood yet.

Tried it on another bike? You are welcome to say how it went in an issue, but fixes for other bikes are not planned.

Privacy and permissions

Disha has no internet permission. It cannot send anything anywhere. There is no account, no cloud and no analytics. Everything stays on your phone:

  • Your bike and your rides are saved inside the app.
  • The log is kept on the phone, and leaves it only when you tap Share log.
Every permission, and why
BIND_NOTIFICATION_LISTENER_SERVICETo read Google Maps' navigation notification. Disha ignores every other app's notifications.
BLUETOOTH_SCAN, BLUETOOTH_CONNECTTo find the bike and talk to it.
BLUETOOTH, BLUETOOTH_ADMIN, ACCESS_FINE_LOCATIONThe same, on older Android versions, which need location permission for any Bluetooth scan. Disha never reads your location.
FOREGROUND_SERVICE, FOREGROUND_SERVICE_CONNECTED_DEVICETo keep the link to the bike alive while you ride with the screen off.
POST_NOTIFICATIONSFor the notification Android requires while the link is running.
REQUEST_IGNORE_BATTERY_OPTIMIZATIONSTo ask Android not to pause Disha with the screen off.
RECEIVE_BOOT_COMPLETEDTo start waiting for the bike again after the phone restarts.

Building from source

Needs only Java 17 or newer. No Android Studio, no Gradle.

tools/fetch.sh                  # downloads the Android build tools, once
./build.sh 0.1.0-beta.1 1       # version name, version code

The signed APK is written to Disha.apk. The keystore password is read from DISHA_KS_PASS, or asked for.

Disclaimer

Disha is an independent, unofficial project. It is not affiliated with, endorsed by, or connected to TVS Motor Company or Google in any way. TVS, TVS Connect, SmartXonnect and Raider are trademarks of TVS Motor Company. Google Maps is a trademark of Google LLC. These names are used only to describe what Disha works with.

Use it at your own risk. Keep your eyes on the road, and do not handle your phone while riding.

About

Google Maps turn-by-turn navigation on TVS Raider bike cluster.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages