OpenSensorHub (OSH) can be deployed on an Android device (e.g. phone or tablet). This allows all sensors on the Android phone (as well as BlueTooth connected sensors) to be sent to and managed by an OSH hub. In this initial version, all observations are sent in real time to an OSH deployed on a computer or cloud though a transactional SOS service (SOS-T).
The instructions below provide the means for adding the OSH app to your phone or tablet, setting up real-time streaming of sensor data (e.g. location, orientation, and video) to an already established OSH-Cloud hub, and immediate visualization of this data on a web client.
NOTE: a more recent version allows for a fully functional OSH node to be deployed and accessed on the Android phone or tablet, thereby enabling greater functionality such as observation storage, access to real-time or archived observations, and on-demand processing. As the instructions for the newer version are completed, we will put a link HERE.
Allow 3rd party applications to be installed
Security on the device may be set to prevent one from loading unregistered apps on your phone. This is a setting that you can change or allow for this app. This may differ between phone models, we have found this setting in different locations depending on phone manufacturers and OS versions..
Go to Settings then Security and it will either be Device Administration or Unknown Sources.
Go to Settings then Application Notifications and choose Install Unknown Applications.
Go to Settings then Apps and notifications then advanced then Special app access then Install unknown apps then set allow for Chrome and Drive.
Download OSH app
Be sure your phone or tablet is connected to the internet and go to http://bit.ly/osh-apk
Select Download, open with Google Drive, and select OK for access.
Open OSH App
Allow OSH Hub access to Location and Camera.
Setup OSH app
Give your device a unique name.
Select the Menu in the top right corner. Choose Settings, then General.
Enter the SOS Endpoint URL. For SCIRA use: http://scira.georobotix.io:8181/sensorhub/sos
Select the following Sensors from the sensor list:
- orientation quaternions
- GPS location
- Video Data
- Codec: JPEG
Start Sensor Hub
Now you can select Start Sensor Hub. The Run Name does not need to be anything specific and you can use the pre-filled Run Name.
If everything worked according to plan you should see the video on your screen and the three sensor data reads in green (note, if GPS is red, then you might be inside, or you don’t have location services turned on, or you need to wait a moment later for the GPS to lock on). If you have troubles, email email@example.com … note: screen shots and a good explanation of your problem helps 🙂
Seeing results in client (dashboard)
You should be able to immediately see your location and video feed in the OSH Common Operating Picture client. Whenever this client is open, it will automatically find all Android phones being supported by the OSH hub and will add them to the Entity list.
NOTE: This is the first time we have opened the OSH Cloud node and client to outside parties to insert new sensors. Certainly there may be issues with regard to installing OSH on everyone’s phones and with integration into the client. Please work with us on this experiment. We have currently just setup a modestly powered OSH Cloud instance, so if you begin to see performance issues, please try to note the time and let us know. We can adjust. Let’s begin.
For the SCIRA project, go to http://scira.georobotix.io:8181/ to open the client.
Open the Smart Hubs branch of the Entities tree. Look to see if your phone is listed. If not, close the client and restart (email us if it continues not to show up).
With a “right mouse” or “two-finger” click, bring up menu on Smart Hubs and select Show Icons. Then click on the Zoom to Selected button at the bottom right so that it is green. Then when you click on your phone, the map should go to your [hones location (assuming your phone is sending GPS location).
Now with a “right mouse” click on your particular phone, you select Video Feed on the menu.
At this point you should see a new window displaying the real-time video from your phone, along with the location and orientation icon.