Pyrrha mobile app

This repository contains the Pyrrha solution mobile application that targets Samsung smartphones paired with the sensor device and Samsung watch carried by the firefighters.

Features

The smartphone includes features that allow it to:

1. Discover and pair with a sensor device using Bluetooth Low Energy.
2. Provide real-time information about device readings in the app UI.
3. Relay information up to the IBM Cloud for analysis.
4. Relay information back from the IBM Cloud to the device and companion smartwatch.

The application is built as a Java Android Application.

Setting up the development environment

• Install Android Studio and open this clone repo. The initial Gradle build will fail until we create a properties file, which we'll do later on.
• Review the Samsung-specific setup instructions. You may need to sign up for a Samsung Developer Account to see documentation.
• Add the Samsung Accessory SDKs to use the watch as a consumer and smartphone (smart device) as a consumer
• Add the Samsung device skin for your target device and create a new hardware profile of it with the AVD (Android Virtual Device) Manager. The application has been tested with the Samsung Galaxy A51 and Galaxy XCover Pro. If you can't find configure the skins, take note of their display and screen resolution specs and configure a generic simulator accordingly.
• Copy pyrrha.properties.template to pyrrha.properties and provide your App ID and backend service configuration information. Then sync and rebuild the project.

Run on phone or simulator

1. Now that the project builds locally, you can run it on the simulator. If the app doesn't automatically launch, look for the Pyrrha app icon amongst the phone's apps.
2. When the project launches, you'll need to log into it using an account of a user you set up in App ID.
3. After logging in, the UI for scanning for Prometeo sensors will be shown.

Running on a physical phone

1. You can run the app on a physical Samsung device over USB or over WiFi. You'll need to enable Developer mode. Details are under Running the App.

Continue work and integrate with the Android watch app

• Install Tizen Studio according to the Pyrrha-Watch-App documentation.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting Pyrrha pull requests.

License

This project is licensed under the Apache 2 License - see the LICENSE file for details. Refer to the respective licenses in the code for the IBM, Samsung, and Google libraries and APIs.