Chat application for DisasterRadio
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.
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.
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
On my Huawei M5 tablet the path looks like
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.
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
To match with the licenses used in the disaster.radio project, this source code is licensed under the GNU GENERAL PUBLIC LICENSE Version 3
|Scan screen||Scan screen menu|
|Chat room menu||Setup username|