Overview

1. Basic Setup

This first chapter will show how to connect to the Marwis device via Bluetooth and how to configure the Marwis device within the Marwis App.

Before you can start the Marwis App, the Bluetooth connection between the Marwis device and the iPad/iPhone must be established, and some basic settings might have to be adjusted in the app settings.

1.1 Bluetooth Pairing

Open “Settings” on your iPad/iPhone and activate Bluetooth. Power on the MARWIS device.

The device will show as “MARWIS-UMB_xxxx.yyyy” (where xxxx.yyyy is the

serial number of the device) in the Bluetooth device list. Pair your iPad/iPhone with the device.

The PIN for pairing is 1007

Note: the device will store the pairing information and automatically reconnect to the iPad/iPhone if the connection was lost and the device is in reach again.

1.2 Marwis App - Settings

In the iOS settings some basic parameters for the Marwis app can be set:

ParameterDefault ValueDescription
Server Connection EnabledOFFConnection to SmartView server enabled / disabled
Server Name/IP Address The host name or IP addess for the SmartView server
TCP Port30100The TCP port for the server connection
Communication Timeout30Communication timeout in seconds for the server connection
Transmission Interval10Interval in seconds in which the data is queued to be sent to the server
Location Change Standby Timeout10Standby timeout in minutes for location change. Data transfer to the server is suspended if the location does not change for the configured time period.
Device Communication Standby Timeout5Standby timeout in minutes for device communication. Data transfer to the server is suspended if there is no Bluetooth connection to the device for the configured amount of time.
Device Connection EnabledONConnection to the Marwis device enabled/disabled.
Communicatio Timeout (ms)750The communication timeout with the MARWIS device in milliseconds
Retries on error3The number of retries for the device communication
Marwis UMB address40961The default UMB address for the MARWIS device – used when adding sensor channels to the configuration
Use Imperial UnitsOffDetermines which UMB sensor channels are set up for polling when the “default sensor channels” for MARWIS are added to the sensor channel configuration
Simple Road Condition Status (Green/Yellow/Red)OffIf switched to “On”, the road condition status shown on the map is simplified to green = ok (dry/damp/wet), Yellow = warning, Red = critical road condition status
Fade Out Interval1200The interval in seconds to fade out the road condition trail on the map
Remove Interval1200The interval after which data is not shown on the road condition trail anymore
Display Overlay coordinates as GCJ-02 (for China)OffIf “On”, the coordinates for displaying the location and track on the map within the app is calculated to “GCJ-02” coordinates (the coordinate system used in China).
Check for Firmware UpdatesONAutomatically check for firmware updates
Firmware Update URLwww.firmware.lufft- marwis.com/M ARWISFirmwa reUpdateInfo.xmlConfiguration file for Marwis firmware updates
Enable CamOffEnable transmission of cam pictures
Auto Capture PictureOffAutomatically capture a picture every xx seconds. Note: pictures will only be transferred if the location is different from the last picture taken
Auto Capture Intervall60Interval in seconds to automatically capture a picture

Usually the default settings are sufficient. If you prefer to use imperial units (°F/mil) over metric units (°C/µm) you might want to set the “Use Imperial Units” to “ON” before continuing your setup.

If a SmartView server is used to process/display the data you need to enter the server host name or ip address and switch “Server Connection Enabled” to “ON”.

1.3 Sensor Channel setup

Start the „Marwis“ App.

If started for the first time, the user is prompted to allow the current location. Please confirm with OK.

As no sensor channels are yet configured, the appropriate dialog is displayed and the user is prompted if the default sensor channels for MARIWS should be added.

Tap “Add” to confirm adding the default sensor channels.

This will add all the default sensor channels for the MARWIS device, with the default Device ID as configured in the Marwis app settings (see above).

If the sensor channels have just been added, the detailed information about the sensor channels is not available yet, indicated by the -?- in the sensor channel list.

Information about each sensor channel is read from the Marwis device after the device is connected the first time.

If the communication with the device is established and the sensor and device configuration could be retrieved, information about the sensor channels, i.e. the device internal name/description and unit for each channel, and the value range for each channel, is updated.

Measure values will be acquired for all (active) sensor channels, and will be shown on the main screen:

The “Sensor Channels” display will now show the last sensor value for each channel (if available) or error information (if no value could be retrieved from the device).

2. Detailed description

2.1 Marwis App Settings

2.1.1 Server Connection

The Marwis app primary function is not only to display the measurement data on the iPad/iPhone display, but to transmit this data to a SmartView server for further processing.

The connection to SmartView is configured through the iOS settings / Marwis settings (see chapter 1.1 as well) and the following parameters:

The Marwis app will use the (first) device serial number as an ID for SmartView. In order to connect to the SmartView server, the server must be running, and the Mawis interface must be configured as “active” for SmartView/Collector. Note that the TCP port might have to be forwarded/enabled in your router and/or firewall.

The server dns host name or ip address must be configured, the “server connection enabled” switch must be set to “ON”.

If the SmartView server uses a different TCP port, the appropriate port number must be configured for the Marwis app.

The data collected by the Marwis app will be forwarded to the server in the configured “Communication Interval”.

The “Transmission Interval” controls the interval in which measure values are collected to be forwarded to the server.

If the server connection is interrupted, the data retrieved from the Marwis device is stored/queued within the app and transmitted to the server as soon as the connection could be re-established.

“Location Change Standby Timeout”: if the GPS coordinates for the iPad/IPhone did not change for the specified amount of time (in minutes), data transmission to the server is suspended until the GPS coordinates change again (i.e. the position of the vehicle changes).

“Device Communication Standby Timeout”: if the Bluetooth connection to the device is interrupted for the specified amount of time (in minutes), data transmission to the server is suspended until the Bluetooth connection is re- established.

2.1.2 Device Connection

The following parameters control the (Bluetooth) communication with the Marwis device:

Device Connection Enabled/Disabled: mainly for testing purposes – the device connection should always be enabled.

Communication Timeout: the timeout for the device communication.

Retries on error: the number of times an UMB command will be retried before it is considered a timeout.

Marwis UMB address: the default UMB address for the Marwis device – used when sensor channels are added to the configuration.

Use Imperial Units: controls whether the sensor channels for metric (°C/µm) or imperial (°F/mil) units are added to the sensor channel configuration when the default sensor channels for a Marwis device are configured.

2.1.3 Data Display

The following parameters control how the data is displayed on the main “dashboard” screen of the app

2.1.4 Firmware update

The following parameters control the automatic firmware update for the Marwis device:

If enabled, the Marwis app will check for new device firmware every time the app is started, or once every 6 hours when a server connection is established. The user will be notified if a newer firmware version was found and downloaded from the server. The device firmware is stored on the iPad/iPhone. Every time a connection to a Marwis device is established, the device firmware version is checked against the stored firmware. If the stored firmware is newer, the user is prompted whether the device firmware should be updated or not.

If confirmed, the firmware on the Marwis device is updated via Bluetooth.

2.1.5 Camera Picture Support

Here, transmission of camera pictures taken from the iPhone/iPad camera can be activated.

If camera transfer has been enabled, a camera icon  will be shown on the dashboard display next to the help () icon.

Tapping this camera icon will grab a picture and transmit it to the server.

If “Auto Capture Picture” is enabled, a picture will be taken in the configured capture interval. Note that the (automatically captured) picture will only be transferred to the server, if the location of the picture is different from the last picture.

If a picture is taken and transferred to the server (or, better, queued for transfer to the server), a small version of the picture is shown on the dashboard display (lower middle area).

If a picture is taken, but not transferred to the server, the picture is NOT shown

– instead only the frame around the picture is visible – to indicate that the picture was not automatically transferred because the location did not change.

2.2 Dashboard Display

The main display of the app is the “dashboard display”. It shows the last retrieved sensor values (for up to 5 sensor channels) and a map with a trail indicating the road condition value.

2.2.1 Measurement Values

On the left hand side the current measurement values for the configured sensor channels (see below) are displayed.

A symbol on the left side indicates the type of measurement value. Tapping on a symbol will display a short description for the measurement type.

2.2.2 Status Icons

Below the measurement values 3 icons indicate the status of the

  • a) Bluetooth connection
  • b) Server connection
  • c) GPS Signal quality

The Bluetooth and server connection status is indicated with a red cross (no connection) or a green arrow (connected). The GPS signal quality is indicated by the number of curves around the antenna symbol (the more curves the better the signal quality).

Tapping on one of these icons will show a short description.

Below the Bluetooth status icon are 3 small symbols located:

  • Status LED: The status LED indicates the status of the MARWIS device. Gray = no connection
    Blue = Bluetooth connection is established and configuration data is being read from the device
    Green = normal operation
    Yellow = device is operational but adjustment might be needed (see below)
    red = there is a problem with the device. purple = firmware update in progress
  • small gear symbol – tapping this leads to the configuration display for the sensor channels (see below)
  • small circle with a question mark – display online help for the app (requires internet connection).

2.2.3 Map Display

On the right hand side of the display the map with a color trail of the route taken is shown.

The map can be moved/zoomed with the usual pinching and swiping gestures.

The color mapping for the trail on the map depends on the app setting “Simple Road Condition Status (Green/Yellow/Red)”

If this is active, the mapping is as follows:

Numerical valueMeaningColor
0 DryGreen
1 DampGreen
2 WetGreen
3 IceRed
4 Snow/IceRed
5 Chemically wetGreen
6FreezingYellow
7 CriticalYellow
8 SnowRed
> 8UnknownLight-Gray

If this is not active, the color assignment is as follows:

Numerical valueMeaningColor
0 DryLight gray
1 DampLight blue
2 WetDark Blue
3 IceRosy
4 Snow/IceRed
5 Chemically wetDark Gray
6FreezingYellow
7 CriticalRosy
8 SnowRed
> 8UnknownLight Gray

The trail will “fade out” (i.e. the color will become more opaque) over the configured “Fade Out Interval”, and the data will be removed from the tail after the configured “Remove Interval”.

Below the map are 2 icons and a segment control to select the map type. The left of these icons – the curve – clears the path trail from the display.

The small arrow indicates whether the map “follows” the current position (i.e. the map automatically moves with the vehicle so that the current position is always in the center of the map) or not. If the arrow is gray (disabled) the map follows the position (and therefore is disabled). If it is blue, the map is not centered to the current position and tapping on the arrow will re-center the map.

The segment control allows to switch the map display between (road) map, satellite images and hybrid (road map and satellite images).

Note that the satellite images cause higher data transfer from the map server.

2.3 Sensor Configuration

Tapping on the small gear icon on the dashboard display will open the “Sensor Channels” screen.

Here sensor channels can be added, removed, or configured in detail.

2.3.1 Adding sensor channels

There is a button with a “+” symbol on the upper right corner of the screen.

If no sensor channels have been configured yet, tapping this button will prompt the user if the default sensor channels for a Marwis device should be added.

If this is confirmed by the user, following sensor channels are added:

If the user does not confirm adding the default channels, or if there are already sensor channels configured, an inactive “New Sensor Channel” with the default device ID and sensor channel 0 is added to be configured manually.

2.3.2 Deleting a sensor channel

Swiping on a sensor channel in the list from right to left will show a red “Delete” button on the right hand side. Tapping the button will prompt the user to confirm the removal of the sensor channel from the configuration.

2.3.3 Sensor Channel Configuration

Tapping on a sensor channel in the “Sensor Channels” list will show the configuration details for each channel:

The Name, Unit, and #Decimals attributes are used for displaying the sensor information on the main app screen – as is the display position and display icon settings. The UMB device id (address) and channel are used for the device communication and for forwarding the data to the SmartView3 server. If needed, other UMB devices or other sensor channels of a MARWIS device can be added to the sensor channels configuration. Only sensor channels that have a “Display Position” assigned will be displayed on the main app screen. However, all values for all active sensor channels will be transmitted (if configured) to the SmartView server. The sensor channel which has been assigned the “Road Condition” icon is used to display the road condition trail on the map display. Note that only those “Display Positions” can be selected that do not already have a sensor assigned. If a new sensor channel is added to the default sensor channels, all display positions are occupied so that no selection is offered: