Skip to content
Chat application to be used with
Java
Branch: master
Clone or download

Latest commit

beegee-tokyo Fix message notifications and sound.
Add time stamp to chat window.
Remove trailing whitespaces from incoming messages.
Fix crash on app close
Latest commit a684fbe Mar 5, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea
app
documents
fastlane/metadata/android/en-US
gradle/wrapper
maps
.gitignore
LICENSE
README.md
build.gradle
gradle.properties
gradlew
gradlew.bat
settings.gradle

README.md

Chat application for DisasterRadio

disaster.radio
a resilient communications network.

This app connects over BLE to a nearby LoRa node that runs the DisasterRadio firmware.
disaster.radio is a collaborative project between Sudo Mesh and Secure Scuttlebutt, with additional support from the Internet Society and Institute For the Future
Except where otherwise noted, this app is licensed under a GNU General Public License v3 license.

Get it on F-Droid Get it on Google Play

Using the app

To be able to use the Android app to connect to a DisasterRadio LoRa node, the node must run the DisasterRadio firmware. Please check the Github repo how to create and flash a DisasterRadio version that supports BLE.

I created a fork of the original code that supports BLE and runs on the Sparkfun ESP32 LoRa board and on the Adafruit ESP32 Huzzah board connected to a Circuitrocks Alora RFM1262 LoRa board.

Using the maps

The maps view is based on OpenStreetMap osmdroid API. By default the app will load the required maps online based on usage. To use an offline map, you have to create a map that is compatible with OSM. You can use e.g. Mobile Atlas Creator (MOBAC) and create a map covering the region you need. At the moment only one map is supported. Read the osmdroid Wiki which map formats are supported, how to create a map and where to store it on your phone. The Wiki says to put the maps into /sdcard/osmdroid/. If you have a phone without SD card just put it into /osmdroid into the phone folder you see when opening the phone on your PC. On my Samsung Galaxy J2 Core the Windows path looks like
Computer\SM-J260Y\Phone\osmdroid.
On my Huawei M5 tablet the path looks like
Computer\ThisIsMine\Internal storage\osmdroid.
A sample map for Philippines, Metro Manila, Sucat road can be found in the maps folder. As DisasterRadio is designed to communicate in cases where none of the usual communication means are available, it is recommended that you create a map of your region in advance and save it on your phone.

Credits

The sources are based on Kai Morich SimpleBluetoothLeTerminal
Thank you Kai for making his very well working code public domain.
REMARK: Kai published his code under MIT license.

The design of the chat box is taken from the Android Chat Tutorial of scaledrone
Thank you scaledrone for writing this nice tutorial

The maps view is based on OpenStreetMap osmdroid API. -REMARK_ osmdroid is published under Apache License 2.0

Build the app

The source code is using AndroidX framework. Minimum SDK version is 19 (KitKat), so it will not work on older phones. But that should not be a problem, as BLE is only supported on newer phones.
The code was made using Android Studio Version 3.5.3

License

To match with the licenses used in the disaster.radio project, this source code is licensed under the GNU GENERAL PUBLIC LICENSE Version 3

Images

Scan screen Scan screen menu
alt text alt text
About Chat room
alt text alt text
Chat room menu Setup username
alt text alt text
You can’t perform that action at this time.