https://github.com/ykasidit/bluetooth_gnss
Bluetooth GNSS app on Google Play Store
https://github.com/ykasidit/bluetooth_gnss
android bluetooth gnss ntrip rtk
Last synced: 3 months ago
JSON representation
Bluetooth GNSS app on Google Play Store
- Host: GitHub
- URL: https://github.com/ykasidit/bluetooth_gnss
- Owner: ykasidit
- License: gpl-2.0
- Created: 2020-10-17T02:00:31.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-11-15T06:34:36.000Z (7 months ago)
- Last Synced: 2025-11-15T08:26:19.377Z (7 months ago)
- Topics: android, bluetooth, gnss, ntrip, rtk
- Language: Java
- Homepage: https://play.google.com/store/apps/details?id=com.clearevo.bluetooth_gnss&hl=en&gl=US
- Size: 2.45 MB
- Stars: 105
- Watchers: 11
- Forks: 27
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: COPYING
Awesome Lists containing this project
README
Bluetooth GNSS
--------------
Connect your Android phone to external Bluetooth GPS, GLONASS, Galileo and BeiDou receivers and use the received location in your android phone via the mock location provider.
Official app is available on Google Play as [Bluetooth GNSS](https://play.google.com/store/apps/details?id=com.clearevo.bluetooth_gnss&hl=en&gl=US).
This project is maintained in open spirit and evolves gradually as time and energy allow outside my main work.
If it contributes to your organization’s research or company’s products, you’re welcome to [sponsor or support its development via GitHub Sponsors](https://github.com/sponsors/ykasidit).
Every gesture helps sustain independent engineering and open innovation. 🌞
Build instructions
-----------
* Install the the [Flutter SDK](https://flutter.dev/docs/get-started/install) as per official instructions including the 'Android setup' and make sure that the Android SDK is installed.
* Make sure the flutter sdk version matches that in pubspec.yaml:
`flutter downgrade v`
* In this folder run:
`flutter pub get`
* Install Rust - follow instructions in:
`https://rustup.rs/`
* Install flutter_rust_bridge: match that of flutter_rust_bridge in pubspec.yaml - see https://cjycode.com/flutter_rust_bridge/quickstart)
example:
```
rustup install 1.90
rustup default 1.90
cargo install flutter_rust_bridge_codegen --version 2.11.1
```
* If you modify the rust code or upgrade versions in above then you need to update update with:
`flutter_rust_bridge_codegen generate`
You might need below if above faces issues:
```
flutter_rust_bridge_codegen integrate
```
You might have to restore `main.dart` after above `generate` command:
`git checkout lib/main.dart`
* If you don't already have an android signing key, create one as per:
* Create the file `key.properties` in parent of this folder and add your keystore information:
```
storeFile=/path/to/keystore.jks
storePassword=*********
keyAlias=bluetooth_gnss
keyPassword=**********
```
* Connect an android phone with adb working
`adb devices`
* Try build and run the app in debug mode:
`flutter run`
If all went well, you would see the app now run in your connected phone.
* Try build a release android installer (apk) file:
`flutter build apk`
If all went well, it would create the apk file in the folder:
`build/app/outputs/flutter-apk/app-release.apk`
* Develop in Android studio:
- Open android studio, and choose 'Projects' > 'Open' to this folder (or File > Open... menu) and you can edit the source code then run 'main.dart' from there. This is suitable for editing the dart files in the lib folder.
- UI changes to main.dart can be seen immediately (hot-reload) on phone but function changes or java/engine part changes won't, you need to 'stop' then 'run' main.dart again for the changes to take effect.
- Auto-completion of java code (in the android subfolder) and running of the java unit-tests won't work as this Android Studio is run in a 'flutter' project mode.
- To edit the engine part and run the java unit tests, simply open the 'android' subfolder of this folder in a new Android Studio instance: File > Open ... choose: bluetooth_gnss > android. After Android Studio is ready, then you can try run some tests like browse on the left panel to libecodroidgnss_parse > java > (test) and right click on 'test_nmea_parse' > Run.
* Use the `flutter build apk` command when you want to build a release apk file.
Regen icons
------------
`dart run flutter_launcher_icons`
Initiate connection using external intent
-----------------------------------------
I'm using [Tasker](https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm) to send the intent, but other methods are possible
### Configure the task
On the `TASKS` tab, create a new task (e.g. _Connect GPS_) and add the action _Send Intent_. It is configured as follows:
* Action: `bluetooth.CONNECT`
* Cat: `Default`
* Mime Type: `text/plain`
* Data: _<empty>_
* Extra: _<see json string below>_
* Package: `com.clearevo.bluetooth_gnss`
* Class: _<empty>_
* Target: `Broadcast Receiver`
**json string in Extra field**
Add this string without newlines. All values are optional. Note that `config` is without double quotes
```
config: {
"bdaddr": "%bt_address",
"secure": false,
"reconnect": true,
"log_bt_rx": true,
"disable_ntrip": true,
"extra": {
"ntrip_user": "taskeruser",
"ntrip_mountpoint": "taskermount",
"ntrip_host": "taskerhost",
"ntrip_port": "2000",
"ntrip_pass": "taskerpass"
}
}
```
**Example**
If you only want to override the bluetooth address, you can send this as extra:
```
config: {bdaddr:"%bt_address"}
```
If you don't use the BT Connection Event (see below) but the BT Connection state, you have to use the real address of your device:
```
config: {bdaddr: "00:11:22:33:44:55:66"}
```
If you want to disable ntrip as well:
```
config: {bdaddr: "00:11:22:33:44:55:66", disable_ntrip: true}
```
### Configure the event
On the `PROFILES` tab, you can use a state change or a event. In this example, I'm using the [BT Connection event](https://tasker.joaoapps.com/userguide/en/help/eh_bt_connect_disconnect.html) with the following conditions:
* `%bt_connected EQ true`
* `$bt_address EQ 00:11:22:33:44:55:66`, the bluetooth address of the GPS receiver
This will trigger the event only when my GPS receiver is connected. You can add multiple devices here, which is why I choose this method: in the action, the variable `%bt_address` will be available as well and I'll use that to pass to Bluetooth GNSS.
Special thanks
--------------
- Thanks to Geoffrey Peck from Australia for his tests, observations and suggestions.
- Thanks to Peter Mousley from Australia for his expert advice, tests, code review, guidance and code contribution.
- Thanks to [Auric Goldfinger](https://github.com/auricgoldfinger) for his great contribution in developing the auto connect on boot feature and the detailed readme merged into above.
- Thanks to everyone who provided comments/suggestions on the [bluetooth_gnss project issues page on github](https://github.com/ykasidit/bluetooth_gnss/issues).
Authors
--------
- [Kasidit Yusuf](https://github.com/ykasidit)
- [Auric Goldfinger](https://github.com/auricgoldfinger)
- For the most up-to-date list, run `git shortlog -sne` in this git repo.
Copyright and License
---------------------
Copyright (C) 2019 Kasidit Yusuf and all respective project source code contributors.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .