Messages Mode

The Massages Mode presents data received from a unit in the form of a table where each message with all parameters available is listed. Messages received from a unit for any period of time can be viewed. Besides, they can be exported to the most widespread formats.

You can view not only basic messages from units (with coordinated, parameters, speed), but also SMS messages received from unit, commands sent to unit, and registered events.

Messages Window Layout

Choose messages on the main menu to open the Messages Mode. In this mode the workspace can be divided into four sections:

  • in the left top corner you can set parameters of your request;
  • in the bottom left part there are some tabs that help to manage the messages: statistics, export/import messages, message parameters description;
  • in the top right section there is the map;
  • at the right bottom there are messages themselves.

Vertical sizes of the messages panel and the map are adjustable. To control them, click on the splitter between them and holding the mouse button, drag in a required direction.

Request Messages from Server

  The request is formulated in the top left corner of the window. You specify the following parameters:

  1. Select a unit for execution. The dropdown list contains not all units available to you, but only the units from the work list.

  2. Specify the period of time to show messages for.

  3. Select message type from the dropdown list (each type is described in detail below):

  4. At the end press the Execute button. A table will be generated in the right part of the window. To clear table (and map), press Clear.

Data Messages

If you request data messages, the table of messages will contain information about time, speed, coordinates, location, as well as parameters. You will also get messages about assigning/removing drivers (they contain the text 'ID=…'). Besides, resultant information will be given in statistics. You can observe messages in different ways. They can be presented in the form of a table or as a chart, play the track or just examine the statistics.

The way to display parameters can be one of the following:

  • raw data - all parameters are displayed in one column, in one line in their initial form;
  • sensor values - each parameters has its individual column in the table, and the values are given according to the calculation table.

The table of messages has the following columns:

  • Time when the message was received.
  • Speed registered at that point. It is calculated as the distance traveled between the previous message and the current one divided on time between these two messages.
  • Coordinates: latitude and longitude, in the brackets the number of satellited locked is displayed.
  • Location: country, city, street (if available). If address information is not available, the coordinates are displayed
  • Parameters (if available) can be given in one row (if raw data is selected) or separate column for each parameter (if sensors values is selected).
  • Image (if available): the button to display a picture made by unit and sent with the message.

Red rows in the table mean alarm messages registered by the system.


In the Statistics panel the general information about the request is given:

  • Total messages: the number of messages for the whole period;
  • Total time: the interval between the first and the last message in the selected period;
  • Distance: the distance traveled by the unit within the indicated time interval (calculated by coordinates);
  • Average speed: the average of all speed values registered during the period;
  • Maximum speed: the maximum speed registered.

Using the Map

The track for the chosen period is displayed on the map. It is generated together with the table. Click on any message in the table to move to this point on the map. The map is centered by this point and a red marker is set there.

By default, track color is blue, but you can adjust settings to paint the track depending on speed or sensor value. This is set in unit properties dialog on the Advanced tab.

Besides, to get information about track points, hover mouse cursor over and see information in a tooltip (time, speed, coordinates, altitude, sensor values). Note that messages are searched in the radius of 50 pixels from the cursor.

:!: Note:
If after using the Messages Mode you switch to the Map Mode or Reports Mode, map layout and all track lines are preserved. To remove unnecessary graphics, go back to the Messages Mode and press the Clear button. More...


Except the text mode that is the table, some data can be presented in the graphical form. To switch between the modes, use and buttons correspondingly.

In the graphical mode, parameters charts are available. When you switch to the graphical mode, the Chart legend panel opens on the left. There you tick parameters to be displayed in the chart. Several parameters can be selected simultaneously. Then the chart will contain several curves. For your convenience they will by drawn with different colors.

The chart can be zoomed with the help of a mouse. Select the necessary section holding the left mouse button. Place the mouse pointer over a point to get the precise value at the point in a tooltip. To reset chart, press .

SMS Messages

SMS messages can be sent by unit while executing a command, generating an alarm or in other cases which depend on device type. A table generated for this request will consist of three columns: time when message was received, message text, and SIM card number embedded into unit.

Sent Commands

Commands sent to the unit by user(s) are displayed for this request. There is a special button in the monitoring panel to send commands to units. The resulting table includes:

  • time when command was sent;
  • user name from which the command was sent (if there is a dash in this cell, it means you have no access to this user, and its login is hidden);
  • command name;
  • parameters - for those commands which require additional parameters (like message to driver, input activation/deactivation, report period, custom message, etc.);
  • time when the command was executed (if execution failed, this cell is empty);
  • channel (gsm, csd, tcp, udp).

Registered Events

Different types of events can be registered in unit history automatically or manually.

Automatic registration is adjusted with the help of notifications (delivery method must be Register event for unit, Register as violation or Register unit status. In such a manner you can control geofence visits, connection loss, idling, service intervals, etc.

Manually an event can be registered in the special registrar in the monitoring panel. In such a manner you can register fuel fillings, maintenance, unit statuses, and any custom event.

Traffic counter reset and routes statuses can be also saved as events.

In the table you see:

  • time when the event was detected (automatic registration) or registered (manually by user);
  • type: event (traffic counter reset, events from notifications, some custom events, route control statuses), violation (violations from notifications, some custom events), maintenance (registered manually).
  • event text which is taken from notification text or from description entered while registering manually.

Deleting Messages

Deleting a message can be applied when you think the message is invalid and can badly affect reports, tracks, etc. Deleting messages is available only if you have manage access to the unit.

In the last column of the table tick messages to be deleted (one or more). Then press the Delete button and confirm your intentions. If the checkbox at the head of the table is ticked, all messages on the current page will be selected.

After the operation, the newly deleted messages still remain on the table, however, the delete checkbox for such messages is replaced with a gray sign which indicates that the messages are deleted. Next time when you load messages, the deleted messages will be completely removed from the table.

:!: Note:
Deleting last incoming message or last message with position (valid coordinates) is impossible. That is why the delete checkbox for these messages is always dimmed.

Table Management

Table's content is adjustable. It is possible to hide and show back any column. To choose columns to be displayed, place the cursor over table's header. Near each column name there is a button to show the dropdown list where you can choose what to display. Note that all columns cannot be hidden simultaneously.

The width of the columns is also customisable. To change it, drag column edge with the mouse in the required direction.

To reset columns width, push Set column auto width button in such a way that A letter appeared there. To save columns width when moving to other page of messages, make the button inactive .

If there are many messages, they are presented in several pages. Use navigation panel (blue arrows) to move through the pages, or enter page number manually and press <enter> to display the page.

Set the number of messages to be displayed on one page: 25, 50, 100, 500, 1000.

Export/Import Messages

  Open the Export messages tab in the left section of the window. Select destination format and push Export. Depending on your browser configuration settings, you will be offered to open or save the file. The resulting file can be compressed. For this, leave the flag Compress file.

The supported formats are:

  • OziExplorer track(.plt): Ozi Explorer format that stores track as a list of coordinates of track's points;
  • NMEA messages (.txt): National Marine Electronics Association text file, communications protocol used in sea navigation equipment;
  • Google Earth (.kml): an XML-based format used in Google Earth to transmit three-dimensional geospatial data;
  • Wialon messages (.wln): a format to be used with Wialon software.
  • Wialon binary messages (.wlb): a binary format to be used with Wialon software.

  Select the Import messages tab in the left section of the window.

The supported formats are:

  • Raw GPRMC navigator logs in format defined by NMEA 0183 specification - searched in files with extension .txt or .log.
  • Wialon messages - searched in files with extension .wln.
  • Wialon binary messages - searched in files with extension .wlb.

Push Browse to define a file (or an archive) to import messages from and push the Import button.

:!: Hint.
To simplify and accelerate the process you may first compress files with ZIP or GZIP. After upload process is completed, files will be unpacked and processed on server.

Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon   |   Copyright © 2002-2020 Gurtam