Overview
1. Instrument set up
Before the app can be used with the MARWIS-UMB sensor, the Bluetooth connection between the sensor and the Android device must be established.
1.1 Bluetooth pairing
To pair the MARWIS-UMB sensor with the Android device, activate the Bluetooth connection in the Android device settings and connect the sensor to the power supply.
The device appears as „MARWIS-UMB_nnnn.mmmm“ in the list of available devices (nnnn.mmmm being a placeholder for the serial number of the device).
The PIN for the pairing is 1007
Tap on “OK” to establish the connection to the device.
Note: the device stores the pairing information. After restarting the device, the connection to the Android device is restored automatically.
If the MARWIS app is already running in the background, the Bluetooth connection to the sensor is activated automatically.
Sensor data is read out automatically and the standard sensor channels are displayed.
1.2 Change Bluetooth connection
This refers to the pairing with a new or another Bluetooth device (tablet, smartphone) in case of an existing pairing with a device.
Note: after the first connection has been established, the MARWIS sensor automatically tries to re-establish this Bluetooth connection.
The MARWIS sensor can only be connected to one mobile device!
When changing the mobile device, it is necessary to change the Bluetooth connection currently stored in the MARWIS sensor. To do this, the new mobile device initiates the connection one time.
The following steps must be done:
- Make sure that the previous Bluetooth connection is deactivated or that the mobile device is out of range.
- Make sure that a valid connection is established between your new Bluetooth device and the MARWIS sensor (see Chapter 1.1).
- To initiate the connection, open the MARWIS app and go to the list of available sensors (device connection icon in the upper right corner ). Select the sensor you want to connect.
After initialization, the selected sensor should no longer have a grey background. If the grey background disappeared the previous connection was overwritten and the connection to the selected sensor is the new default connection.
2. App View
2.1 Dashboard view
The dashboard view is used for monitoring/outputting the measured values while you drive. The measured values of all selected channels as well as a „lane“ of the measurement run and its colour which symbolizes the road condition, are displayed.
The view adjusts automatically, depending on the orientation of the tablet/smartphone:
If the Android device is held vertically, the display is split in two. Switch between the measured value display and the map display by using the additional button which appears at the right bottom.
2.2 Measured value view
This view shows the current measured values of the individual sensor channels. Scroll down if there are more values than can be displayed on the screen.
The symbol on the left represents the type of the measured value. Tap on the symbol to see a short description of the respective measured value.
2.3 Map view
The map can be moved or zoomed in/out with the usual gestures.
In the map view there is a coloured lane. It represents the route covered and the different road conditions.
The different colors are assigned to road conditions as follows:
Numerischer-Wert | Bedeutung | Farbe |
---|---|---|
0 | Trocken | Grün |
1 | Feucht | Hellblau |
2 | Nass | Blau |
3 | Eis | Rosarot |
4 | Schnee/Eis | Rot |
5 | Rest-Salz | Grau |
6 | Überfrierende Nässe | Gelb |
8 | Schnee | Rosarot |
99 | Unbestimmt | Hellgrau |
2.4 Status icons
Above the measured values/map there is a status bar with icons: The status-LED on the upper left, uses different colours to indicate different states:
Grey: no Bluetooth connection to sensor
Blue: Bluetooth connection is established, and configuration data is read out
Green: sensor is connected
Yellow: device is ready for operation, but an adjustment may be necessary
On the right side of the status bar are the following icons:
GPS connection
Server connection
Bluetooth connection
The status of the GPS-, server-, or Bluetooth connection is indicated either by a green tick (connection established) or a red cross (no connection). Tap on the server connection icon to have information about the current connection displayed.
Via the Bluetooth connection icon you can access a list of the available MARWIS sensors (with existing Bluetooth-pairing). If a Bluetooth connection is active, the same icon takes you to the device settings of the respective sensor see Chapter 3.3.
3. Settings
3.1 Channel settings
3.1.1 Channel configuration
Find the channel settings of a sensor by tapping on the icon on the bottom right . The first time a connection with a MARWIS sensor is established the list of channels is automatically initialized with default values (height of the water film, road temperature, road condition, friction, ice percent, dew point temperature).
In principle, all channels listed here are read out by the sensor. The checkbox to the left of channel name indicates whether the channel is displayed in the view or not.
Click on the channel symbol and hold to move the channel to another position in the list.
To delete or deactivate a measuring channel, wipe over the respective line to the left or right. This will not delete the channel completely but removes it from the recording of measured values. By clicking on the „add” icon at the top right corner, a channel can be added to the channel list again.
3.1.2 User defined channels
For most applications the standard channels are sufficient. It is possible though, to create further channels. Manage the list of user defined channels via the icon left to the „Add“ icon. The operation of this list of channels is similar to the list of channels described above. When creating a new channel, the individual channel details must be entered manually. The example shows the waterfilm height in „mil“, a US-American unit:
The new channel is created by pressing the „Add“ button. The new channel is then automatically available for the measurement query.
3.2 App-Settings
Global settings for the app can be created using the button in the upper right corner.
Note: The settings colored in light gray in the tables cannot be changed or can only be changed after activation.
The default settings are suitable for most applications.
3.2.1 Device connection
Parameter | Standard-Wert | Beschreibung |
---|---|---|
Geräteverbindung aktiviert | Ein | Die Kommunikation mit dem MARWIS-Sensor ist aktiviert/deaktiviert |
Kommunikations-Timeout | 150ms | Kommunikations-Timeout in Millisekunden für die Bluetooth-Kommunikation mit dem MARWIS-Sensor |
Abfrage-Wiederholungen | 3 | Die Anzahl der Wiederholungen bei Fehlern in der Geräte-Kommunikation |
Heartbeat-Intervall | 2000 | Der Gerätestatus wird im angegebenen Zeitraum kontrolliert (ms) |
Standard Abfrage-Intervall | 5000 | - |
UMB-Geräteadresse | 40961 | Die Standard-UMB-Adresse für den MARWIS-Sensor – wird beim Anlegen der Sensor-Kanäle in der App verwendet |
Android UMB-Adresse | 61441 | Die Standard UMB-Adresse für das Android-Gerät. Lässt sich nicht ändern und ist im Gerät angelegt |
Kanalliste beim Verbindungsaufbau aktualisieren | Aus | Mit der Aktivierung dieser Option, werden alle aktuellen Kanalinformationen gespeichert und beim nächsten Verbindungsaufbau erneut aus dem Sensor gelesen |
Ziel-Gerät | MARWIS-UMB_nnnn.mmmm | Name des gekoppelten MARWIS. Dabei steht nnnn.mmmm für die Seriennummer des Gerätes |
Stations-ID | 0 | Wird aus der Seriennummer generiert. Dieser Wert lässt sich nicht ändern und ist eindeutig für jeden MARWIS |
3.2.2 Server connection
Parameter | Standard-Wert | Beschreibung |
---|---|---|
Server-Verbindung aktiviert | Aus | Die Verbindung zum Server (SmartView, ViewMondo) ist aktiv / nicht aktiv |
ViewMondo Server IP/Namen | - | - |
Server Port | Das TCP Port für die Server-Verbindung | |
Kommunikations-Intervall | 15s | Das Intervall in dem die Daten zum Server übermittelt werden |
Kommunikations-Timeout | 10s | Kommunikations-Timeout für die Kommunikation mit dem Server |
Übertragungs-Intervall | 1000ms | Das Intervall in dem die Messwerte zur Übermittlung bereitgestellt werden |
If a server is to be used for further processing and display of the data, the IP address or DNS name of the server must be entered, and the connection must be set to “Active”.
3.2.3 Data display
Parameter | Standard-Wert | Beschreibung |
---|---|---|
Pfad-Stärke | 10 | Die Pfad-Stärke, die in der Karte eingeblendet (auf Fahrbahn) |
Ausblende-Intervall | 1200s | Das Intervall in Sekunden über das die Straßenzustands-Spur auf der Karte langsam ausgeblendet wird |
Display dauerhaft an lassen | Aus | Display bleibt dauerhaft an |
Fahrbahnzustände übersetzen | Ein | Übersetzung des numerischen Fahrbahnzustand in die entsprechende Zustandsbeschreibung (z.B. Trocken statt 0) |
3.2.4 Firmware update
Parameter | Standard-Wert | Beschreibung |
---|---|---|
Firmware-Aktualisierung aktiviert | Ein | Automatische Überprüfung und Aktualisierung der Firmware |
Firmware URL | https://firmware.lufft-marwis.com/MARWISFirmwareUpdateInfo.xml | Adresse über die Firmware-Updates bezogen werden |
3.3 Device settings
Device specific information and settings can be viewed/edited under
3.3.1 Device information
Parameter | Standard-Wert |
---|---|
Gerätename | MARWIS-UMB |
Gerätebeschreibung | Mobile road sensor |
Software-Version | - |
Hardware-Version | - |
Bootloader-Version | - |
3.3.2 Device configuration
Parameter | Standard-Wert | Beschreibung |
---|---|---|
Aktualisierungsintervall | 1000ms | Intervall, in dem die Messdaten im Gerät ermittelt und von der App abgerufen werden |
Anz. Wert für Mittelwertbildung | 1 | - |
Status-LED aktiviert | Ein | Aktiviert/deaktiviert die Status-LED an der Vorderseite des Sensors |
Bluetooth-Pairing | Ein | Wird dies deaktiviert, werden die Bluetooth-Kopplungsinformationen vom Sensor gelöscht |
Bluetooth Gateway-Funktionalität aktiviert | Aus | - |
Wasserfilmhöhe Feuchte-Schwelle | 10µm | Ab dieser Wasserfilmhöhe wird der Straßenzustand als „feucht“ ausgegeben |
Wasserfilmhöhe Nass-Schwelle | 100µm | Ab dieser Wasserfilmhöhe wird der Straßenzustand als „nass“ ausgegeben |
Rauschunterdrückung | 500ms | Intervall für die Störunterdrückung |
Straßenzustandsmodell | AVG | Modelle zur Berechnung des Fahrbahnzustandes |
Wasserfilmhöhe Algorithmus Einstellungen | Asphalt | Algorithmus zur Bestimmung der Wasserfilmhöhe |
Abgleich-Plausibilitätsprüfung | Ein | - |
Abgleichprofile | - | s. Kapitel 3.3.3 |
Werkseinstellung | - | Reset auf Werkseinstellungen |
Temperatur-Offset | 0,0°C | s. Kapitel 3.3.4 |
Note: all configuration changes are only transferred to the device after they are accepted. A short dialog appears before the transfer and it needs to be confirmed before the changes are accepted. Since configuration changes are only accepted and active after a restart of the MARWIS-UMB, the MARWIS sensor is automatically restarted after writing the configuration.
3.3.3 Adjustment/Calibrations
For the correct adaptation of the sensor to the conditions of the route to be travelled, an adjustment must be carried out during the commissioning of the MARWIS-UMB.
For this purpose, the MARWIS-UMB must be installed on the measuring vehicle in the planned position.
The adjustment must be carried out on a dry road section and at standstill!
By tapping the menu item “Adjustment profile”, a list of the adjustment profiles currently stored in the sensor opens. You can only select profiles with “valid” adjustment data.
By tapping on the pen symbol an adjustment profile can be created or changed. The following dialog opens.
Before you “Start” the adjustment, the name and the duration of the adjustment must be specified. A minimum runtime of 10s is recommended.
Adjustment can only be started if the LED and housing temperature are within the specified range. This is indicated by the device status and the adjacent LED (in case of over/under temperature this is indicated by a yellow/orange LED and the “START” button is disabled).
Tap on “Start” to start the adjustment procedure. You can see the progress of the adjustment now.
Confirm with “OK” to return to the device settings.
To save the adjusted device settings, go to the standard view using the back function as described in chapter 3.3.2. A window opens where you must confirm the acceptance of the change.
After a short time, you get to the standard view and receive the message that the sensor is restarted:
3.3.4 Temperature Offset
The measured road temperature can be adjusted here.
4. Exit the App
The app is designed as a permanently active application (permanent display of measured values during measurement runs). However, measured values are also collected and transmitted to the server if the app is running in the background of the mobile device.
To really exit the application, the app must be closed.
This can be done by pressing the Back key twice.