roadai mobile application user guide

ROADAI MOBILE APPLICATION USER GUIDE

ROADAI – MOBILE APP – USER GUIDE

(2)

1 INSTALLATION OF ROADAI MOBILE APPLICATION ................................................................................. 3

1.1 Dedicated device setup (DPC) ................................................................................................................. 3

1.2 Installation via “Google Play” ................................................................................................................... 3

1.3 Installation via Web-browser .................................................................................................................... 4

1.3.1 Enable “Unknown sources” .......................................................................................................... 4

1.3.2 APK installation ............................................................................................................................. 5

2 LOGGING IN TO ROADAI ............................................................................................................................. 6 3 ROADAI APPLICATION ................................................................................................................................. 7

3.1 User-interface ........................................................................................................................................... 7

3.2 Main menu ................................................................................................................................................ 8

3.3 Settings..................................................................................................................................................... 9

4 DATA COLLECTION .................................................................................................................................... 10 4.1 Share selection ...................................................................................................................................... 11

4.2 Tag selection .......................................................................................................................................... 11

4.3 Tag creation and deselection ................................................................................................................. 12

4.4 Record and create annotations/audio notes .......................................................................................... 12

5 MEDIA BUTTON ........................................................................................................................................... 13 5.1 Pairing via Bluetooth to Satechi media button ....................................................................................... 13

5.2 Create annotations/audio notes with Satechi media button .................................................................. 14

5.3 Sleep-mode ............................................................................................................................................ 14

6 SENSORS..................................................................................................................................................... 15 6.1 Bluetooth pairing & connecting to sensors ............................................................................................ 15

6.2 Live sensor data values view ................................................................................................................. 16

7 POLARIZATION FILTER .............................................................................................................................. 17 7.1 Setup ...................................................................................................................................................... 17

7.2 Calibration .............................................................................................................................................. 18

8 DEVICE DIAGNOSTICS............................................................................................................................... 19 9 DATA TRANSFER ........................................................................................................................................ 21 10 COMMON ISSUES ..................................................................................................................................... 21 11 SUPPORT ................................................................................................................................................... 22


(3)

1 INSTALLATION OF ROADAI MOBILE APPLICATION The RoadAI mobile application can be installed on Android devices through a QR code, “Play Store” or an Android device web-browser which does not require Google account logins.

1.1 Dedicated device setup (DPC) Use the Vaisala RoadAI provisioning installation guide to turn a phone into a dedicated recording device. 1. Use a computer web-browser and navigate to https://setup.vaisala.ai/ 2. Follow the step-by-step setup instructions.

1.2 Installation via “Google Play” 1. Open “Play Store” by tapping the app icon. 2. Search for the “RoadAI” app by Vionice. 3. Tap “Install” to download and install the application.

https://setup.vaisala.ai/


(4)

1.3 Installation via Web-browser Unlike app installation via Google Play, using a web-browser to install the application does not require Google account logins.

1.3.1 Enable “Unknown sources” “Unknown sources” must be enabled to download the RoadAI application with a web-browser. 1. Tap the “Apps” icon on the homescreen and then tap the “Settings” icon. 2. Tap the “SEARCH” button in the settings menu. 3. Search for “Unknown sources” and tap the settings result displayed below. 4. Enable “Unknown sources” by tapping the slider from “OFF” to “ON”. Continue to Chapter 1.3.2


(5)

1.3.2 APK installation 1. Open a web-browser (e.g. pre-installed Internet or Chrome). 2. Type “v.vionice.io” in the address bar of the web-browser and tap “Go” on the device keyboard. 3. Tap “Download” at the bottom of the web-browser. 4. Tap “Open file” to prompt installation of viominer.apk. 5. Tap “INSTALL” and wait for the application to finish installation. 6. Tap “OPEN” to launch the RoadAI application.


(6)

2 LOGGING IN TO ROADAI 1. After installation, tap the “RoadAI” app icon to open the application. 2. Provide your user ID/email and password and tap “Login”.


(7)

3 ROADAI APPLICATION

3.1 User-interface 1. Status bar

❏ Storage buffer - estimated recording time remaining based on available storage. ❏ GPS signal - strength of GPS signal in red/yellow/green. ❏ Power - power consumption of RoadAI app. ❏ Temperature - recording device temperature.

2. Main menu button - to access the main menu features and settings. 3. Share / Tag window - displays the selected “Share” and “Tag” in use. 4. Recording button - to start recording. 5. Camera button - for capturing images. 6. Stop button (while recording) - to stop recording. 7. Marker button (while recording) - for creating annotations and audio notes.


(8)

3.2 Main menu 1. Camera view - tap to move back to camera view. 2. Sensor view - tap to move to sensor values view. 3. Set Reference - displays the last 5 min. of recorded sensor data on a graph. 4. Diagnostics - view diagnostics of the recording device. 5. Auto record - enable to begin recording when device is connected to power source. 6. Sensor - tap to view and connect/disconnect to sensors for data capture. 7. Settings - tap to view settings menu. 8. Help - tap to display support contact information. 9. Legal


(9)

3.3 Settings 1. Summary - displays the username of the account logged in to RoadAI and version of RoadAI application installed on the device. 2. Audio recording - tap audio recording to select “No audio is recorded”, “Audio is recorded only while a button is pressed”, “Audio is always recorded”. 3. units - tap to switch between units of length: international / U.S. customary 4. Dim screen - enable to dim the device display during recording to conserve battery life. 5. Use mobile data - enable to use mobile data to upload recordings and annotations. 6. GPS availability - enable to be prompted of GPS unavailability when starting to record. 7. Real-time location - enable to allow tracking of device location on RoadAI map interface. 8. Logout - tap “LOGOUT” to logout of the RoadAI application. 9. Erase - tap “ERASE” to delete all content which has not yet been uploaded to the cloud. 10. Current share/Video format - displays the current share in use and video recording settings.


(10)

4 DATA COLLECTION The mobile device is placed behind the windshield facing forward with a mount. When the application is active or recording the phone must be connected to a power source at all times. Phone is aligned according to the following principles:

● Horizontally: Camera is pointed straight forward. ● Vertically: Camera is pointed straight forward, slightly towards the ground if needed. If the sky covers too large area of the frame the view becomes underexposed which is not desired.

Car hood can remain visible in camera view. The application must be running in the foreground.

Shares - A share is a workspace made accessible as specified to multiple users or organizations to enable the collection and sharing of data, alternatively referred to as a shared directory or folder.

Tags - Tags are customizable and further add organization to shares by categorizing annotations into groups for later viewing on the map user interface.

Annotations - Annotations are markers that can be created by the user which can include images, bookmarks to videos and audio/audio-to-text notes. Annotations are displayed on the map as red markers, they can be created during the recording process or after by using the map user interface.


(11)

4.1 Share selection A user can record to only one share at a time. 1. To change shares, tap the icon located on the right side of the share name. 2. A menu listing available shares will appear, tap a share to select it.

4.2 Tag selection A user can annotate using only one tag at a time. 1. To change tags, tap the icon located on the right side of the tag name. 2. A menu listing available tags will appear, tap a tag to select it.


(12)

4.3 Tag creation and deselection New tags can be created and existing ones can be deselected. 1. To create a new or deselect a tag, tap the tag field in the lower left corner of the main interface. 2. Tap the text field… To create a new tag, input a new tag name into the text field. To deselect a tag, clear the text field. 3. Click “DONE” to save changes.

4.4 Record and create annotations/audio notes 1. To start recording, tap the video icon, the red stop icon will appear. 2. Annotations and audio notes while recording

To create an annotation, tap the annotation icon, no prompt will follow creation. To create an audio note, press and hold the annotation icon, no prompt will follow creation.

3. To stop recording, tap the stop icon, the grey video icon will reappear.


(13)

5 MEDIA BUTTON The Satechi media button can be used to create annotations/audio notes.

5.1 Pairing via Bluetooth to Satechi media button 1. To pair the Satechi media button with the recording device, press and hold the small pairing button on the back of the Satechi for 3 seconds. 2. A blue LED will begin blinking on the front side, indicating active Bluetooth pairing. 3. Turn on Bluetooth on the mobile device, scan for Bluetooth devices if necessary, connect to “Satechi media button”. Satechi is now usable with RoadAI. 4. Attach the Satechi media button to its mount.


(14)

5.2 Create annotations/audio notes with Satechi media button RoadAI mobile application must be recording in order to use Satechi media button to create annotations/audio notes. 1. To start recording, press the video icon on RoadAI application, the red stop icon will appear. 2. Annotations and audio notes while recording...

To create an annotation, press any button on the Satechi, a sound will be played indicating the creation of an annotation. To create an audio note, hold any button on the Satechi, a sound will be played indicating the creation of an annotation with audio notes.

5.3 Sleep-mode The Satechi media button will automatically enter sleep-mode after 10 minutes to save the battery life of both the button itself and the device used for RoadAI.

To wake the Satechi from sleep-mode, press any media button once, the Satechi will now be usable.

The Satechi media button can be paired with only one device at a time. If the Satechi is paired with a new device, it will lose its connection with the previous device and will need to be re-paired.


(15)

6 SENSORS

6.1 Bluetooth pairing & connecting to sensors 1. To connect to a previously paired sensor, power on the sensor, then navigate to the main menu and tap on “Sensor”. 2. Tap on a sensor from the list that appears to connect to it. If a sensor does not appear, re-pair it. 3. To re-pair or pair to a new sensor, power on and enable Bluetooth pairing on the sensor, then tap “BLUETOOTH PAIRING”. 4. Enable “Bluetooth” by tapping the slider from “OFF” to “ON” and select a sensor from “Available devices”, wait for the sensor to pair, after pairing it will appear under “Paired devices” 5. Navigate back to RoadAI, open the main menu and tap on “Sensor”. 6. Tap on the paired sensor from the list to connect.


(16)

6.2 Live sensor data values view 1. To view live sensor data values on the display, navigate to the main menu and tap on “Sensor”. 2. Swipe left to scroll across sensor value windows. 3. Drag and drop sensor value windows to rearrange.


(17)

7 POLARIZATION FILTER The polarization filter is included in the Mobile Data Collection Kit, the hardware setup for Vaisala’s RoadAI service. The purpose of the filter is to improve video quality by removing any reflections from the windshield that may interfere with the smartphone camera. After setup, the polarization filter needs to be calibrated to ensure it functions correctly. Continue to Chapter 7.2

7.1 Setup 1. The polarization filter is delivered in separate packages: one includes the clip and the other contains the lens.

2. Fasten the clip to the lens. Both components have threads, which fit together.

3. Attach the polarization filter on top of the rear smartphone camera. It is recommended that the polarization clip runs over the top edge of the phone.

4. Check for correct placement of the polarization filter. Adjust its positioning if the lens frame is blocking the camera’s view.

The polarization lens is compatible with Samsung Galaxy models: S7, S8, S9, S10e. Vaisala cannot guarantee that the polarization filter is compatible with other devices.


(18)

7.2 Calibration 1. Place a piece of white paper next to windshield under the smartphone to create a reflection for the camera to pickup.

2. Unfasten the lens incrementally, by rotating it counter- clockwise while it is attached to the smartphone, until the reflection disappears. Remove the white paper once calibration has been successful.


(19)

8 DEVICE DIAGNOSTICS Diagnostics ensure recording devices are functioning properly through identifying issues quickly with continuous monitoring. Device specific diagnostics can be viewed on the RoadAI mobile application. Alerts will appear on the recording screen to warn you of any critical errors.

1. To view diagnostics, open the main menu and tap on « Diagnostics ».

Example of a critical error alert.


(20)


(21)

9 DATA TRANSFER RoadAI uploads video files and sensor data in the background. When data upload is in progress information regarding the transfer is displayed in the notification panel of the device. Closing RoadAI does not interrupt the data transfer. Transfer continues until all files have been uploaded. It is recommended to keep the device connected to a power supply during the data upload process. Data upload options: 1. Mobile network - If the device is connected to mobile network, videos are uploaded automatically. The device is simultaneously recording and uploading videos at 5 minute intervals. In order to ensure smooth uploads, the device must have at least ~1 GB of free memory. Once the videos have finished uploading, they are automatically deleted from the device. 1 hour of video equals approximately 7-9 GB, compare this figure with your mobile data plan. 2. WLAN - The other option to upload videos is through WLAN, even if the device is connected to a mobile network, mobile data can be disabled from within RoadAI’s settings. All videos are stored on the device during the recording process. It is important to ensure a memory card of the required size (128 GB recommended) is installed in the device. Once the device is connected to WLAN, videos are uploaded and deleted from the device automatically.

10 COMMON ISSUES RoadAI mobile application is not running ✔ The application is visible on the device display, can be displayed with low brightness. ✖ The application will not run if the device display has been turned off, turn on the display and open RoadAI. Device positioning on the mount is not optimal ✔ The device displays that the camera is aligned horizontally with the road with a clear view. ✖ The camera is tilted upwards, downwards, to the side, the mount or wires are in the camera’s field of view. Improper device positioning can interfere with computer vision detections and camera focus. Device charging is not connected ✔ A charging battery icon is visible in the device notification bar. ✖ An empty battery icon is visible in the device notification bar. The device must be connected to a power supply at all times, even after recording during the upload process for data transfer. Covering the device during data transfer e.g. car trunk, equipment bag, can cause data transfer speeds to diminish. Satechi media button is not connected to the device via Bluetooth ✔ A connected Bluetooth icon is visible in the device notification bar and the Satechi button is functional with RoadAI for creating annotations. ✖ An unconnected or no Bluetooth icon is visible in the notification bar, bluetooth has been turned off or the Satechi button has not been paired with the device. To pair the Satechi button with the device, press and hold the small pairing button on the back of the Satechi until a blue LED is flashing on the front side. Then to connect, turn on Bluetooth on the mobile device, scan for Bluetooth devices if necessary, connect to “Satechi media button”. Satechi is now usable with RoadAI.


(22)

11 SUPPORT If you need any help with the application or have any questions do not hesitate to contact: [email protected]

mailto:[email protected]

roadai mobile application user guide

Documents