Wiatag 1.3: User Guide
Wiatag 1.3: User Guide
Wiatag 1.3: User Guide
WiaTag 1.3
User Guide
date: October 10, 2016
WiaTag 1.3 User Guide
Table of Contents
Overview 4
Creating a Unit for WiaTag 5
Unit Creation From the Monitoring System 5
Unit Creation From the Application 6
Starting Application and Choosing Mode 7
User Modes 7
Active 7
Standard 8
Lite 8
Custom 8
Main Screen 9
Top Block 9
Central Block 10
Bottom Block 10
GPS Connection 10
Internet Connection 10
Service Status 10
Other 10
Latest Data 11
Actions Menu 12
Scan QR code 12
Send Photo 12
Sending from Camera 12
Sending from Library 12
Send Position 13
Send SOS 13
Custom Statuses 14
Template Creating 14
Status Sending 14
Template Deleting 15
Settings 16
Connection Settings 16
Server 16
Unit Properties 16
Operation Mode 17
Data Collection 17
Data Sending 18
-2-
WiaTag 1.3 User Guide
Start/Stop by Event 18
Data Settings 19
Location Source 19
Messages Filtration 19
Additional Parameters 20
Main Screen 21
Administrative Settings 21
User Mode 21
Admin password 21
Custom Statuses 21
Remote Control 21
Visible Settings 24
Notifications 24
Photo Quality 25
Debug Mode 25
Power Save Mode 25
Clear Black Box 25
Reset 26
NFC Reader 26
Other 26
Measurement System 26
Contact us 26
Help 26
-3-
WiaTag 1.3 User Guide
Overview
WiaTag is an application used for tracking unit's location.
WiaTag can be installed on Android based mobile devices, such as cell phones, laptops, netbooks, etc.
Location is tracked mainly using GPS, therefore a device should possess GPS receiver.
WiaTag is compatible with GPS and GLONASS tracking systems Wialon Hosting and Wialon Local. Position
data is sent from mobile device to the server of tracking system to be stored. Besides position data
(coordinates, course, speed. etc.), images, alarm messages, and custom statuses can also be sent to the
server.
Data received from a mobile device can be processed by a tracking system and presented in different forms
such as tracks of traveled routes on the map, notifications, etc.
-4-
WiaTag 1.3 User Guide
The fields to be filled in upon unit's creation are described in the documentation on Wialon Hosting and Wialon
Local. So, let's just observe how to fill in the fields directly connected with the application operation. Firstly, in
the 'Device type' field choose 'WiaTag' option. Then indicate a unique ID. Note that both numeric and
alphabetic values can be used for it (for example, mobile device's IMEI code). The indicated identifier is used
in WiaTag for a unit connection. Moreover, if you would like to use a password for a connection, then it is
necessary to indicate one in the 'Device access password' field.
The list of units created in the monitoring system for the work with WiaTag is available in the application after
an authorization. To authorize, tap the 'Log in' at the bottom of a unit connection screen and choose the
monitoring system used. Then choose a user from the list (the list contains all the users authorized from this
device in any mobile application of Wialon system) or authorize as another user (corresponding button at the
bottom of the screen). Afterwards, we get to the list of units any of which can be chosen to work with WiaTag.
-5-
WiaTag 1.3 User Guide
-6-
WiaTag 1.3 User Guide
User Modes
After connecting to the monitoring system it is necessary to choose a user mode: Active, Standard, Lite, or
custom one. Each mode has its own parameters of data collecting and sending.
Active
This mode provides you with a possibility to receive the most detailed track of unit's movements and
ensures the highest accuracy of position data. This mode provides relatively high battery and traffic
consumption comparing to the other modes.
Data collection: continuous.
Data sending: continuous.
Maximum accuracy value: 30 meters.
-7-
WiaTag 1.3 User Guide
Standard
This mode provides you with a possibility to receive a detailed track of unit's movements with 5
minutes delay and ensures relatively high accuracy of position data. Moderate battery and traffic
consumption is considered to be an advantage of the mode.
Data collection: smart mode.
Data sending: by timeout (5 minutes).
Maximum accuracy value: 50 meters.
L ite
Data collection: by timeout (5 minutes).
Data sending: by timeout (5 minutes).
Maximum accuracy value: 1000 meters.
Custom
-8-
WiaTag 1.3 User Guide
Main Screen
An interface of the application's main screen could be conditionally divided into 3 blocks: top, central, and
bottom one.
Top Block
The top block contains 3 buttons:
-9-
WiaTag 1.3 User Guide
C entral B l ock
Central part of the screen is occupied by the block where you can view unit's latest data or (upon indicating
the corresponding settings) send unit's current status (use a horizontal slide to switch from latest data
viewing to current state sending). Latest data receiving and current status sending requires availability of
GPS and Internet connection as well as starting unit's location determination service.
B ottom B l ock
Upon the first launch of the application a unit's location determination service is stopped. To start it, tap the
corresponding button at the top of the block. The further activity of the application depends on the settings
used, availability of GPS connection (to generate location messages) as well as connection with Internet and
server (to send messages from clipboard or black box). State of data collecting and sending parameters is
shown in the bottom block:
GPS Co n n e ctio n
Shows the availability of GPS connection
In te rn e t Co n n e ctio n
Shows the availability of Internet connection.
Se rvice Sta tu s
Shows whether location determination service is started or stopped.
ATTENTION!
Stopping of the service may be restricted by an administrator.
Other
Tap the '+' button in the bottom block in order to open the actions menu. Note that implementation of any
action from this menu requires the availability of Internet connection.
- 10 -
WiaTag 1.3 User Guide
Latest Data
Latest data is taken from received messages. Latest data is
refreshed automatically upon receiving new messages. The
latest data block may contain up to 4 items on your choice:
Time — date and time of receiving the message;
Speed — unit's speed (in km/h);
Altitude — elevation of a unit above the sea level (in
meters);
Course — direction of movement (in degrees). It can
take on the values from 0 to 360 degrees, where 0° is
a course strictly northward, and then the value
increases clockwise;
Position — geographical latitude and longitude of
unit's location;
Accuracy — accuracy of location data (in meters). In
other words, accuracy is a radius (drawn around a
current location point) within which a unit can be
situated.
- 11 -
WiaTag 1.3 User Guide
Actions Menu
This menu contains a list of actions available for a chosen user mode:
S can QR code
Scan QR code in order a message containing 'qr' parameter to be sent to the server. This message is stored
in the data base of the system and afterwards can be used for the monitoring purposes.
S end P hoto
Se n d in g fro m Ca me ra
Choose this item in order to take a picture and send it.
Se n d in g fro m L ib ra ry
Choose this item in order to send an image stored in the memory of your mobile device.
- 12 -
WiaTag 1.3 User Guide
S end P osi ti on
S end S OS
Alarm message (SOS) can be sent in case a critical situation occurs. In the monitoring system's data
message it has the following view: 'SOS=1'. Note that unit's location info is send to the server along with the
alarm message. Unit's location is detected by the system at the moment of SOS sending. In case of failure to
detect current location, the latest known location will be sent.
- 13 -
WiaTag 1.3 User Guide
Custom Statuses
WiaTag application supports creating and sending of custom statuses. A user can create any number of
custom statuses templates, for example, 'Template 1' can obtain such values as 'Free', 'Busy', 'Away', and
'Template 2' — 'Private', 'Business', 'Unified', etc. Template creating is done in the corresponding section of
the application settings. Template sending is done on the main screen of the application.
Name — indicate template's name;
Parameter name — indicate parameter's name;
Values — add the necessary number of values (max 6) and give a name for each of them.
S tatus S endi ng
- 14 -
WiaTag 1.3 User Guide
Custom statuses appear in the tracking system as data messages containing parameter's name and value.
Sent parameters (both alarms and custom statuses) can be used in the tracking system to adjust
notifications (notification type should be 'Message parameter control'). You can be notified on receiving
custom statuses by e-mail, SMS, online popup message. Moreover, you can register received statuses in
unit's database and generate reports on them
To delete a template, go to the Settings>Administrative settings>Custom statuses, choose a template you
would like to delete, tap the corresponding button in the bottom, and confirm your action in the appeared
dialog.
- 15 -
WiaTag 1.3 User Guide
Settings
User settings menu serves to configure parameters influencing the work of both the application and the
location determination service. A number of settings available to a user is indicated in the 'Visible settings'
item of the 'Administrative settings' section.
ATTENTION!
Access to the settings can be restricted by the password of administrator.
Server
Host
Port
Unique ID
Unit's unique ID is an identification code used to recognize your mobile device in the tracking system. It
can be the same as IMEI code of the mobile device or any other identifier.
Password
Indicate a password if it should be used for a unit access. Note that an indicated password should be
duplicated in the interface of a monitoring system (corresponding field of a unit properties dialog),
otherwise unit's data will not be registered on the server.
Bind unit
Here choose a unit to bind your application to.
- 16 -
WiaTag 1.3 User Guide
Chosen configuration of the operation mode may influence the consumption of traffic and battery. Operation
mode is defined by 3 parameters. Depending on the goals of tracking you can choose settings for data
collection, data sending, and starting/stopping by event.Further there is an information on each setting.
Da ta Co lle ctio n
Motion Detection
If smart mode has been chosen, then it is necessary to indicate motion detection parameters. Further
there are some recommendations on their usage:
Activity recognition — can be used on devices having the corresponding configuration. That is why
the efficiency of this method should be tested for each device individually.
Accelerometer — can be applicable for those who travel by foot.The negative side is that the
beginning of motion can be often detected upon shaking device while standing still.
Wi-Fi — can be applicable for those who uses Wi-Fi upon reaching any checkpoint. The algorithm is
the following: Wi-Fi connection is available — a unit stands still, Wi-Fi is not available — a unit is on
the move. This method is not considered to be a high accuracy one because of the large amount of
Wi-Fi networks in a city's infrastructure.
GSM — in this case a motion is detected considering location of cellular base stations. The
algorithm is the following: a device determines location of cellular base stations and repeats the
action after a period of time. If location of cellular base stations is changed, then motion is detected.
Note that some imprecision can take place upon determining base stations location. Therefore it is
not considered to be a high accuracy method. The efficiency of this method should be tested for
each device individually.
- 17 -
WiaTag 1.3 User Guide
The indicated time shows the regularity of motion detections.
Da ta Se n d in g
Data can be sent continuously, by timeout, or manually.
In the first case ('Continuous' option), location data is sent to the server constantly (upon arriving to the
black box and upon the Internet availability). The battery is consumed actively using this method,
therefore it is recommended to use it if you have the possibility to charge your battery any time.
In the third case ('Manual' option), all collected location data messages are stored in the black box, and
if necessary a user unloads the black box manually.
Timeout
This parameter is relevant only if data sending by timeout is chosen above. Timeout value should be no
less than 5 minutes.
Work in Roaming
Depending on this checkbox state, the mobile device sends data in roaming or not.
Auto Startup
Mark this checkbox to automatically launch WiaTag after your mobile device has been rebooted.
- 18 -
WiaTag 1.3 User Guide
Automatically launch WiaTag service when the charger is connected and stop it when the charger is
disconnected.
Work by Schedule
The service can be automatically started or stopped according to a schedule. Created schedule
intervals are displayed only upon choosing this option. Schedules can be edited or deleted. Further,
there is a guide on how to create a schedule.
Add Schedule
L o ca tio n So u rce
This option allows to choose the method for determining unit's location. It can be Google Fused
(default), GPS, Wi- Fi and mobile networks, or GPS+Wi- Fi+mobile networks. Note that the
corresponding options should be enabled in the settings of the mobile device itself.
If you activate this option, parameters listed below will be applied to messages prepared for sending to
the server. This filtration can be applied only to the messages generated by GPS, because if wireless
technology is used, such data as speed, course, satellites count, etc. is unknown, and accuracy can
exceed 2000 meters.
The conditions of filtration are listed below. The 'logical OR' operation is applied to them, in other words,
a new message is generated if any of the mentioned conditions is met. This is not applicable to the Max
accuracy and Max speed parameters as they are intended to exclude messages with improbably high
values (potentially invalid messages).
Min Distance
- 19 -
WiaTag 1.3 User Guide
Change in Course
Indicate an angle on which a course will be changed (i.e., a motion direction) for new message sending
(in degrees).
Change in Speed
Indicate a speed change (difference between the previous and current messages) which is sufficient for
sending a new message.
Max Accuracy
Maximum accuracy value (in meters). If exceeded, such message is considered invalid and will not be
sent to the server.
Max Speed
Ad d itio n a l Pa ra me te rs
Choose the additional parameters you would like observe in data messages:
LBS Data
Provider name
If this option is chosen, then sent messages contain parameter 'p' showing a source of location data.
Accuracy
If this option is chosen, then sent messages contain parameter ‘a’ showing information about accuracy
of a detected location (in meters).
Battery Level
If this option is chosen, then sent messages contain parameter 'b' showing a battery level (percentage).
Last Status
If this option is chosen, then sent messages contain the last indicated unit status.
- 20 -
WiaTag 1.3 User Guide
Main Screen
Latest Data
Actions
Here you can adjust the list of actions available to a user.
User Mode
The choice of a user mode depends on the goals of monitoring. The modes may differ by their
configuration. A configuration influences both the accuracy of received data and the consumption of
traffic and battery.
Ad min p a sswo rd
Choose the option if you would like to make configuration of WiaTag available only to those who has
administration privileges. Without entering a password user will be unable to stop the service or
view/change settings.
Custom Statuses
Choose this item to set custom statuses.
Remote Control
Choose this item to enable/disable remote control.
Send custom message;
Query snapshot;
Query snapshot from camera;
Query position;
Start/stop;
- 21 -
WiaTag 1.3 User Guide
Torch;
Upload configuration.
- 22 -
WiaTag 1.3 User Guide
- 23 -
WiaTag 1.3 User Guide
Note that values can be presented numerically (0, 1, 2, etc.), alphabetically (true/false), or by flags (0x1, 0x2,
0x20, etc.). Numeric and alphabetic values are used to choose single parameter/status. Using flags, you can
indicate multiple parameters. For example, it is required to show such parameters as 'Contact us' and 'Help'
in the user settings menu. To do so, it is necessary to make an addition of their flags (0x1 + 0x2 = 0x3),
convert a received sum into decimal number system, and indicate a result of conversion as a value of a key.
Example of a configuration file for visible settings:
"visible_settings":{
"connection_settings":1,
"operation_mode":1,
"data_settings":4,
"main_screen_customizer":0,
"administrative_settings":2,
"other_items":2
}
Share Configuration
To share current configuration of the application, tap this item. In the appeared menu choose program for
configuration sending and indicate an addressee. Moreover, you can save a configuration into buffer for a
further usage.
Visib le Se ttin g s
Here you indicate the settings to be shown in the user menu.
No tifica tio n s
- 24 -
WiaTag 1.3 User Guide
Enable this option in order a special indicator of the application activity to be shown in the notifications
panel.
Background Events
Here you can choose events for which notifications will be shown in a status bar:
Invalid ID or password (in case either unit's unique ID or password is invalid);
Connection error (in case a connection with a server cannot be established);
Location determination error (in case of failure to determine location).
Ph o to Qu a lity
Here you can choose image quality which will be used upon photo sending (traffic consumption
depends on the chosen quality). The following variants are available:
Original — original image without quality loss;
High — original image is compressed to 3 megapixels (not more than 600 kb);
Medium — original image is compressed to 2 megapixels (not more than 300 kb);
Low — original image is compressed to 1 megapixel (not more than 100 kb).
Debug Mode
'Send logs' option is available only if debug mode has been enabled. This option serves for sending log
files to the application developers by e-mail. Such fields as address and subject are already filled in, the
log file is attached. All you should do is describe a problem and send e-mail. To use this option make
sure that your mail account is set.
'Clear logs' option delete all the saved log files from the 'WiaTag' folder.
Power save mode provides you with a possibility to decrease battery consumption. This is possible due
to the changing of data sending method to manual.
Enable this option in order the power save mode to be activated upon reaching low battery level (15%).
Tap the option in order to delete all the messages from the black box.
- 25 -
WiaTag 1.3 User Guide
Reset
Tap the option to reset all the settings to default ones.
NFC Reader
To read NFC tags, it is necessary to enable this option. Upon reading a tag, a message containing 'nfc'
parameter is sent to the server. This message is stored in the data base of Wialon Hosting and
afterwards can be used for the monitoring purposes. Note that NFC reader can be enabled if a device is
equipped with NFC chip.
Other
Measurement System
WiaTag supports two systems of measurement — metric and U.S. one. Here choose the system you
would like to work with. If the 'Automatic' item is chosen, then the system of measurements will be set
depending on the settings of your device.
Contact us
This option serves to contact the application developers.
He lp
Tap this item to view WiaTag user manual.
- 26 -