TAVL4 application user manual v1.
1. Contents 1. CONTENTS ............................................................................................................................................................ 2 2. INTRODUCTION .................................................................................................................................................. 3 3. GETTING STARTED ...........................................................................................................................................
2. INTRODUCTION TAVL application is software used to connect to the server and retrieve and display information that FM1100, FM1200, FM2200, FM3100, FM3200, FM4100, FM4200, FM5300 or/and GH 1201, GH 1202, GH 3000 stores there. TAVL user manual provides information to fully understand and operate TAVL applications basic functions. Here you will find application installation guide, interface, reports, configuration and event description, operation list.
3. GETTING STARTED 3.1 Recommended PC requirements TAVL application runs on a PC with MS Windows XP (x86) with Service Pack 3 or later, MS Windows Vista (x86 & x64) with Service Pack 2 or later or MS Windows 7 (x86 & x64). MS .NET Framework v3.5 Service Pack 1 and Crystal Reports are also necessary components 1. Personal Computer Requirements: Supported Architectures: 32-Bit (x86) 64-Bit (x64) Minimum Hardware requirements: Pentium IV Computer with 2.
3.5 Launching TAVL application You can enter TAVL client application as: User – has basic permissions. User see devices which is assigned to it only. Power User – have advanced permissions. Power User can see all devices from all groups. Administrator – have more advanced permissions (including User and Power User permissions and more), can connect to any user on the server, often this permission has owner of the server. Launch tavl.exe ( ) and enter your user name and password2, see pic. 3.1: Pic. 3.1.
Also you can set Connection Settings: Default Connection Settings Proxy Connection Settings Pic. 3.3. Proxy settings By default Connection Settings are set to default connection settings, but if proxy server used to access the internet then in Address field type the IP address of the proxy server and in Port field enter the port number that is used by proxy server for client connections (by default 8080).
4. INTERFACE Pic. 4.1. TAVL Interface TAVL application consists of these basic parts: 1. Quick menu – possibility to add most used functions to reach them as fast as possible; 2. Client name – information about name of client to which user is connected; 3. TAVL application version; 4. Menu toolbar; 5. Client information – Name of client, possibility to choose Group or Local Group. 6. Tools – tools connected to the name of toolbar; 7.
5. MAIN 5.1 Objects Object window contains a list of all available objects that are available for the client. It is loaded with TAVL application by default, if you close the window and want to see it again you need to click “Objects” button in Main ribbon (see pic. 5.1). Pic. 5.1. Main Object – show objects list; Refresh – refresh objects list showing last possible possition of them; Zoom mode – used to zoom map after each refresh.
Pic. 5.2. Objects list After clicking 'Objects' in toolbar, TAVL displays them on a map. Left-click on the object in the list centers view on that object. Right-click on the object displays the following menu, see pic. 5.3: Pic. 5.3. Object right-click menu Info – displays object information entered in database; Edit Object – ability to modify object number and comments for login with Administrator or Power User rights, login with simple user rights can only add comment.
Geofence – opens Geofence menu; Routes planning – ability to plane route by adress points. Send Command – displays available SMS commands for FM series devices; 5.2 Track 'Track' toolbar, enables to set time interval to see the track of the object for that period. All additional properties are displayed as well for every timestamp, see pic. 5.4. Pic. 5.4.
Track window enables also such options as Track Play, Info in balloon on track, export data to KML and create Geo Tunnel (Geozone by route), see pic. 5.5. Play mode displays each coordinate for defined time. 'Play', 'Pause' and 'Stop' buttons are used to start, hold and stop preview, while 'Reverse' button replays track from the end to beginning. You can choose 6 different speeds to play track data. Graphic Reports Pic. 5.
Available graphics settings: Line Show – enable/disable line on Graph Fill – fill the graph Step type: ForwardStep – draw the curve as a stair-step in which each point defines the beginning (left side) of a new stair. This implies the points are defined at the beginning of an "event." ReawardStep – draw the curve as a stair-step in which each point defines the end (right side) of a new stair. This implies the points are defined at the end of an "event.
There is possibility to compare graphs with each other. Select icon “Graphs” and then on main ribbon select “Compare Graphs”. You can compare any graphs you want by marking check-box on right side of window (on Legend) in examples below (see pic. 5.11. and pic. 5.12.) its showed how easy you can compare difference between GPS and CAN speed graphs, GPS and Odometer distance graphs. Pic. 5.11.
Pic. 5.12. GPS and Odometer distance graphs 5.3 Find Address “Find address” function enable you to find any location on map and add it to “My Places”(points of interest) or to a “route”. Press on “Find Address” icon as showed below. Then press on empty field named “Find”and specify location, which you want to find. Location name can contain: city name, street name, village name or something like that. When you entered location and pressed find is should appear yellow circle on map.
Pic. 5.15 "My places"(points of interest) Pic 5.14. Location on map “Append to route” - add your location as a start of new route It is also possible to make new route from saved “My Places”list locations. Pic 5.16. Route 5.4 Other Route Planing Route planning is available on TAVL. There are two different kinds of route planning. From last object location to destination point; From point A to point B (user can add more than 2 points by adding additional route stops); Start planning route.
When routing is selected user can start to plan your own route. Write your destination points and click “search for route”. Additional point can be added by selecting “Add route stop”. (see figure 2) When all data is set click “Search for route”, trip duration and distance will be calculated below menu bar. Route will appear on the map. Fig. 2 Route planning 6. EVENTS 6.
Pic 6.2. Module selection 'Event Configuration'menu allows configuring events for IO elements. In the picture a sample is shown how to configure Ignition event that will send email to defined recipient. Choose an IO lement from available in 'Available Events' window (more can be added by enabling IO elements in database) and click 'Add'. Enter minimum and maximum values and condition like do this before in I/O elements configuration in the fields.
Select Events tab and press find (pic. 6.4) event window will be oppened, where all the events will be shown (pic. 6.5) Pic. 6.4. Events tab Pic. 6.5. Events window 6.2 Geofencing GeoFence When coordinates are sent to the server, they are proceeded using application’s algorithms. If coordinate is in the specified area, a notification can be sent. In the toolbar click 'Events' – >'zones', see pic. 6.6. Pic. 6.6. Geofencing tab Zone creation In the Zone window, see pic. 6.7, select New (1).
Pic. 6.7. New Geozone creation In order to get a warning when a certain object enters or leaves the determined zone the Warning Recipients, Warning Policies and geofencing rules must be configured (see pic. 6.8). Pic. 6.8. Warning recipients and policies In Warning policies, see pic. 6.9, create new policy (1), then pick a name (2), and save new warning policy Pic. 6.9.
Flood timeout – time (in minutes) to prevent exactly same warning. For example, if you set Flood timeout to 5 minutes, warning was sent and exactly the same warning(type, object, message, client, text and so on) will true to be sent, TAVL will ignore it. If after Flood timeout will come same warning as before, it will be sent. Comment – you can leave a comment about new policy Also you can choose to what group assign the policy. In Recipients, see pic. 6.
Pic. 6.12. Objects tab Select zones for rule (several Zones or Zone Groups can be selected), see pic. 6.13: Pic. 6.13. Zones and Zone Groups tab When objects, zones and zone groups are assigned for the rule, the last thing to do is to configure when warnings will be generated (‘Warnings’ tab, see pic. 6.14): Recipient: Select a recipient the geofencing warning will be delivered to. Select [Console] if you want to generate warnings in Warning Console (see pic. 6.15.).
6.3 Warnings To get warnings on events or geozone warnings Warning console must be configured. Select Events tab and click on Console icon. In console window pres on Gear icon to configure warning console, see pic. 6.15. Pic. 6.15. Warning console In settings window, see pic. 6.
7. MESSAGING 7.1 SMS7 SMS operations There are four types of SMS operations: Sending/receiving SMS messages to/from virtual drivers; Sending SMS user templates; Object location request; SMS predefined commands sending; SMS mailbox can be found in “Messaging” section, see pic 7.1. SMS mailbox has two tabs: “SMS Mailbox” and “Object Location Request”, see pic. 7.2. Pic. 7.1. SMS Pic. 7.2. SMS Window In “SMS Mailbox” tab received and sent messages can be reviewed using date filter.
Pic. 7.3. SMS Messages (Inbox/Outbox) New messages also can be composed in SMS SMS Mailbox window. In order to compose and send SMS message, virtual driver has to be created. Virtual driver is created by following steps: 1. Press green “+” sign in the middle of “SMS” window, see pic. 7.4. Pic. 7.4. Driver's window creation invoke 2. “New driver” window will appear. There is other way to invoke this window, more information in 8 chapter.
1. To enter a vehicle driver name and GSM number for a possibility to send SMS from TAVL application; 2. To enter a device number and GSM number for a possibility to send FM commands to the unit; 3. To enter object number or driver name and iButton ID or RFID for identification. Driver ID - vehicle tachograph number. IButton ID – vehicle Ibutton number. RFID – radio frequence identification number.
Pic. 7.7. Template Creation Table “Object Location Request” tab can be used to get location of objects, see pic. 7.8. Three request types are possible: Get 24 coordinate – requests object to send 24 coordinate SMS to server; Get Location – requests last stored GPS data to be sent to server; Flush using GPRS – requests all available records in FM series device memory, to be sent to server; Pic. 7.8.
It is possible to send the same command to multiple objects. To send SMS command to more than one unit, the SMS command must be common to these units. 7.2 Garmin functionality TAVL client application lets user to use the following features of GARMIN FMI: 1. Text messaging; 2. Destination message; 3. ETA request; Text messaging Text messaging feature lets user to communicate with driver (user that uses Garmin device) by sending text messages via GPRS.
Destination message Destination message is used to inform a driver of a new destination. When Garmin device receives a destination message from server it displays it as “Stop” to the driver and also gives the driver ability to start navigating to the “Stop” location. New destination in TAVL client is represented as GeoZone so new GeoZone (as destination) has to be created first. After at least one GeoZone is created, it can be sent to Garmin device as destination.
ETA request message ETA (Estimated Time of Arrival) request message is used when user wants to know expected arrival time to currently active destination in Garmin device and distance (in meters) from current object location to currently active destination. ETA requesting in TAVL client interface is shown below. Click “ETA” in “Messaging” tab - “ETA Request” window will appear, see pic. 7.12. Available objects will be shown in this window – select one or multiple devices and press “Request ETA” button.
Pic. 7.14. Object and module type window GPRS mail box, see pic. 7.15, allow monitor situation and check history about sent and received GPRS command for selected period. Pic. 7.15. GPRS commands mail box Note: FM5300 has to be connected to the server in order to receive commands. Table 2 . GPRS commands and description Command Description #GET DATAORDER Get info about records sorting parameter #SET Set records sorting parameter, X – profile, Y – value (0/1).
#GET VERSION #GET NETWORK #GET IMSI #GET OUT #DO REPORT #DO RESET=XXX #GET ROAMINGX=Y #SET ROAMINGX=Y,Z #GET REMIPX #SET REMIPX=Y:Z #GET AUPX #SET AUPX=Y,Z,W #GET REPRTX #SET REPRTX=Y #GET REPDISTX #SET REPDISTX=Y #GET REPANGX #SET REPANGX=Y #GET SENDPERIODX #SET SENDPERIODX=Y #GET REPMRX #SET REPMRX=Y #GET IBTNX #SET IBTNX=Y,Z #GET EXTERR #SET EXTERR=X getstatus getweektime getops readops# getnmeainfo Receive firmware version Get GSM operator to which device is connected Get IMSI of the device Get DOUT v
getcfgtime getgps loadprofile# cpureset resetallprof getver getinfo deleterecords getio readio # setdigout XXXX Y1 Y2 Y3 Y4 getparam # setparam # # flush #,#,#,#,#,#,# sn x [x=0;1] banlist crashlog delete_all_sms braminfo getgnss Date and Time of last successful configuration Current GPS data and time Load specified profile into RAM Engine Profile.
8. Tools 8.1 Grouping8 TAVL server administrator can allow or deny 'Power User' to use Grouping feature. This feature can define that certain object or driver belongs to certain group and the simple user, which belongs to the same group can see only those objects, while Power User can see all available objects, see pic. 8.1. Pic. 8.1. Grouping Like you can see above grouping feature have several dedicated buttons: 'Groups', 'Users', 'Drivers' and 'Objects'.
2) And you will jump to table ‘Details’ where you must type information about your new group (pic. 8.3): Pic. 8.3. New Group Description 3) Push ‘Save’ icon. 4) Result (pic. 8.4): Pic. 8.4. Created Groups First decide which created users will be available for a User. Power User is allowed to create groups. Each user can be assigned to different groups. Power User can create a simple user logins for TAVL application (click Users button in the toolbar and select 'New').
TAVL application can also store a driver list with assigned GSM numbers and it is possible to communicate with those drivers using SMS (see SMS Communication chapter for more information). Just like objects, each driver can be assigned to different groups too. Driver grouping is available from Tools -> Grouping -> Drivers, see pic. 8.6. Pic. 8.6. Driver Grouping Power User is allowed to create groups. Each Object can be assigned to different groups. Select objects one by one and assign a group to it.
Pic. 8.8. Local Grouping New window with empty field pops-up where you can fill in group which you want to add, see pic. 8.9. Pic. 8.9. Add new local group And then new group will appear in available group list, see pic 8.10.
Pic. 8.10. New Local Group When group is created it can be attached to all objects one by one. To ‘Delete” group uncheck it in all objects and then it will be not in use group will be erased automatically. If group is dedicated minimum to one object it can not be deleted. 8.2 Configuration Module Configuration TAVL application has an interface for remote FM configuration via GPRS and SMS.
‘Synchronizing’ – a configuration that is queued for update. When saving new settings (configuration), new configuration is renamed to ‘Synchronizing’ until process is successful or time-out expires. If configuration is successful, then ‘Synchronizing’ is renamed to ‘Active’ and new data can be seen indicating when it became available. If configuration is not successful, ‘Synchronizing’ is renamed to ‘Failure’. ‘Failure’ – last unsuccessful configuration. Pic. 8.11.
‘Monitoring’, ‘Hysteresis’. Event can be set as Panic Event. Also, Validity period of event can be set on configuration. Pic. 8.12. Event Configuration 8.3 Bulk configuration TAVL configuration can be performed for several objects at the same time by TAVL administrators and Power users. Bulk configuration is available in Tools -> Bulk Configuration, see picture 8.13. Bulk configuration can be created, edited or deleted by right-clicking in 'Bulk Configuration' window and selecting an appropriate action.
8.4 Settings Settings window allows you to customize TAVL applications settings. In the Tools -> Settings, see pic. 8.14 and pic. 8.15., menu choose ‘Common’ button or hit F9 on keyboard to configure parameters. Pic. 8.14. Settings Pic. 8.14.
Pi c. 8.15. Common settings second part Following parameter can be edited: 1) Data Representation a) Measure system – allows to choose measurement system for metric or imperial. b) Stop Speed – maximum speed value when object is treated as not moving. This is used when coordinates error occurs and object is displayed on new location. If speed will not be exceeded configured value, object will not change its location.
2) Events. a) Sound on new event – enabled or disabled sound used for warnings b) Trace event - sets if program should automatically check for new events. c) Trace events interval - sets the period in seconds for new events checking. 3) Geofence a) Always Show Geozones - let you choose to show or not Geozones on map. b) Show geozone names on map – sets whether to show or not geofence names on map. If several geofence zones were created without names, it will be numbered.
d) Min distance in track when engine is off – same as ‘Min distance in track’ except that points is being removed only then engine is off. e) Min satellites in map – if record was made with lower number for satellites then this parameter then this point will not be shown in track. f) Min stop time to show stop point in track – time interval after which if all stop conditions are true object is treated as not moving.
9. REPORTS TAVL application has ability to generate statistic reports based on GPS data and/or external sensors or properties. These reports can be launched by clicking 'Reports' and choosing one of available. Pic. 9.1. Reports ribbon 9.1 Basic Reports Tavl has report functions. Select Report -> Distance Basic. This report show information about object driven distance see pic 4.2.
Trip stop basic report gives information about object stop and driving durations. It also contains date, time and location of each stop. For this report you should enable odometer and DIN1(ignition) during module configuration. Pic. 9.3. Trip Stop Basic Repor Work time basic report show object every day work time and in the last line it sum all days work time. Work time is beging to count when engine on and ending to count when engine off.
Fuel tank basic report report shows how much fuel vehicle have poured in and how much fuel driver have poured out vehicle tank during a day. Fuel tank data about fuel can be read from CAN connection but it give data about percentage left fuel not about liters so you will have to calculate a proportion to get correct data in TAVL application. Pic 9.5.
Pic. 9.6 Route by object report 9.2 Driven day activity by tachograph In a picture below is shown Driver day activity by tachograph: Pic. 9.7.
In report is shown time diagram, in which could be seen sequence of activities. Status shows the name and icon of the activity (Driving, Working time, Rest time, Availability time, Group driving). Also there is possibility to see start time, end time and total time of the action. In group shows was drived alone (only one card inserted in tachograph) or two drivers were in one vehicle. Report also shows number of the driver and odometer value is shown of endtime of activity.
Differentiation Driving Tachograph data Driving Other works Working time Availability time Availability time Rest Rest time Comment or explanation Time, while driver is driving the vehicle. Status set in tachograph is driving. Time, while driver is do other work, but do not drive. Time, when to drivers driving, while for one driver Driving time is counter, the same time for other driver is counted as Availability time. Status set in tachiograph is driving. Time, while driver is resting.
Pic. 9.10. Example for tachograph Driver violation report 10.FILTER Filtering enables object and data filters refine the information, see pic. 10.1. Pic. 10.1. Filtering 10.1 Filter Objects Loading lots of objects takes more time and sometimes it can be very confusing. Filtering lets you choose which object you want to view, and hides the rest. When refreshing objects, data is sent only about those that are marked, so it takes less time.
In the new window click on object you want to be displayed and click 'Ok', see pic. 10.3. Before filtering After filtering Pic. 10.3. Filtering Results 10.2 Filter Pic. 10.4 Data Filtering To check which object do not send data or send rarely takes more time and sometimes it can be very confusing. Filtering lets to see which object do not send data for set period or send rarely, see 10.4.
11.LOCALIZATION TAVL language localization tool is used to build localized (translated) version of TAVL application. On excel file you will find all fields in english language, make changes on this file - translate each field named in english to desired name in your language. Localization will be completed by compiling this file. For more information and excel file for localization, please contact your sales manager. After Localization when you run the TAVL application, you will be able to set new language.
12. FREQUENTLY ASKED QUESTIONS (FAQ) 100 Horizontal Probability, % 1. Why doesn't objects trail match roads that are shown in the map? What is the accuracy of GPS? 80 Vertical (altitude) 60 Object trail doesn’t coincide Error Hor. Alt. with roads shown in the maps because 40 CEP (50%) 2.9 m 4.1 m of GPS limited accuracy. GPS accuracy 95% 6.9 m 13.7 m depends on location (geographic 20 99% 10.1 m 19.6 m latitude, longitude), satellites’ location and ionosphere’s conditions.
7. Why is object changing its coordinates even when engine is off? It is because of GPS accuracy. If object is standing between tall buildings or in from of the wall, module doesn't see enough satellites to set its exact coordinates. Then each coordinate is calculated with a slight error. Error depends on number of visible satellites. If object is standing between tall buildings or in front of a wall it may not be enough for module to set its position correctly. 8.
13.CHANGE LOG 2013-02-28 New version number 1.0 Version Draft Release 2 2013-03-01 1.3 Minor changes 2 2013-08-09 1.4 Reports updates Nr.