User Manual

Create account

To create user account please do the following steps:

  • Visit: http://www.bemgps.com
  • Select server where registration is open and click on Registration tab.
  • Enter your e-mail and security code.
  • Click register.

  • After a few minutes check your e-mail for login details.
  • In Login tab enter e-mail and received password (later you can change password in settings section).

Workspace overview

After login you will be redirected to the main page. Main page allows to access most common tracking features and settings, monitor object position on map ant get detailed information such as speed, coordinates, address, movement history and more.

  1. Top panel.
  2. User account panel.
  3. Left panel.
  4. Object details panel.
  5. History panel.
  6. Map controls.
    • Map zoom control
    • objects
    • markers
    • routes
    • zones
    • Clusters – useful feature for those who has large number of objects and markers. Splits markers and objects into groups, which according to map zoom level will reveal content inside of it.
    • Live/traffic (available only with google maps).
  7. Route controls.
  8. Object details.

Top panel

Top panel is used to quickly access frequently used tools (fit objects on map, ruler, address search…) and sections (settings, reports and object control using commands).

  1. About –  allows to check what version of software you are currently using.
  2. Help – redirects to this manual.
  3. Settings settings menu allows to add new objects, events and etc.
  4. Fit objects on map – shows all objects marked as visible on map.
  5. Ruler – simple tool to measure distances on map.
  6. Show point – focus map on entered coordinates.
  7. Search address – helpful and easy to use tool for searching address on map.
  8. Reports allows to create various reports.
  9. RFID and iButton log book – review RFID and iButton activity.
  10. Object control.
  11. Image viewer – can receive images with location from GPS devices.
  12. Chat – allows to send/receive messages from supported devices.
  13. Maps –  allows to change currently used map: OSM map, GOOGLE maps, BING or Yandex maps.

Left panel

Objects list tab allows to view available objects, find them on map, view object route history and edit object settings.

  1. Objects tab – view current objects statistics.
  2. Events tab – history of events can be viewed (overspeending, entering or leaving zones and etc.).
  3. Places tab – allows to create, edit and delete zones and markers.
  4. History tab – view history, create reports, export them to various formats etc.
  5. Search – allows to find objects by name.
  6. Reload – reloads objects list.
  7. Add object – allows to add new object.
  8. Visibility checkbox – turns on or off objects visibility on map.
  9. Follow checkbox – centres selected object in the middle of the screen every time GPS device has refreshed its position, if multiple objects selected – map zooms the way that all of them remain visible.
  10. Object information – object name, date and time of last received location.
  11. Speed indicator – shows current object speed.
  12. GPRS indicator – shows GPRS and GPS status.
    • Grey icon – no GPRS and GPS
    • Orange icon – no GPS signal
    • Green icon – GPRS and GPS are OK
  13. Quick access – allows to see object history, control objects using commands and edit object settings.

Object details panel

This panel allows to view more details about selected object. Panel only appears if Objects, Events or History tab is selected in left panel.

  • Altitude – object height over sea level.
  • Angle – current object angle (0 – 360° clockwise movement).
  • Nearest zone – distance from current point to nearest created zone (learn more about zones).
  • Odometer – object odometer readings.
  • Plate – pre-specified object plate number (learn more about object settings).
  • Position – coordinates of current object location.

Account panel

In account panel you can change interface language, see logged user e-mail (click to edit user details), switch to mobile version and exit system using logout button.

Map

Map shows objects location of GPS devices (learn more about object configuration). To see more details about object, such as address, speed, altitude, angle, time and more, click on object in object list panel.

Settings

Settings section allows to add and edit objects and related elements, such as object groups, drivers, events. Also map interface appearance and user login details can be changed.

Settings section can be found in top panel, press settings button as shown below:

Objects management

Object list section

This section allows to manage objects and check object expiration date.

Name – object name.

IMEI – GPS device IMEI number which is being used to connect device to system.

  1. Edit object – allows to change object details.
  2. Duplicate object – creates object copy with the same details except name and IMEI.
  3. Clean object history and events – removes object history and events entries.
  4. Delete object – permanently removes object.

Add new object

In Objects tab Object list section left bottom corner press + button.

Object window will appear. Enter object name and IMEI.

Edit object

In object list choose object to edit and click  edit object icon.

Object edit window will appear. Information you can add, edit and remove that describes object is contained in 5 tabs: Main, Fuel consumption, Accuracy, Sensors and Service.

Main section contains basic object settings.

  • Name – object name.
  • IMEI – GPS device IMEI number.
  • Transport model – for example: BMW 750.
  • VIN – vehicle VIN number.
  • Plate number – vehicle plate number.
  • Group – choose group from pre created groups list.
  • Driver – choose driver from pre created drivers list.
  • Trailer – choose trailer from pre created trailers list.
  • GPS device – choose pre added GPS device model.
  • SIM card number – enter SIM card number.
  • Odometer (km) – you can set how many kilometres vehicle drove.
    • Off
    • GPS – calculates distance using GPS location points. It is not a precise tool, results of vehicle odometer and system may vary.
    • Sensor – system will get data from device sensor.
  • Engine hours (h) – you can set how many hours engine worked.
    • Off
    • ACC – calculates engine hours using Ingnition sensor. It is not a precise tool, results of vehicle engine hours and system may vary.
    • Sensor – system will get data from device sensor.

Icon

Fuel consumption

Note: system fuel consumption statistics may vary from real fuel consumption of your vehicle. In order to receive fuel consumption statistics in your reports you need to set fuel consumption parameters.

  • Cost per liter – enter liter/galon cost. Currency can be set in user interface section.
  • Summer rate (litres per 100 km ) – enter amount of fuel car consumes per 100 km during summer period.
  • Winter rate (litres per 100 km ) – enter amount of fuel car consumes per 100 km during winter period.
  • Winter from, Winter to – 4 boxes where you set beginning and end of the winter period.

Accuracy

In edit object window click on Accuracy tab. This section allows to accurately adjust GPS device data.

  • Detect stops using:
    • GPS – calculates stops using GPS location points.
    • ACC – calculates stops according to ignition sensor state, ignition sensor must be set up properly.Learn more about sensor configuration.
    • GPS + ACC – stops are being calculated according to both options.
  • Min. moving speed in km/h – set minimum movement speed.
  • Min. difference between track points – this option helps to eliminate inacurate GPS device location points (drifting).
  • Min. gpslev value – location point filtering according to GPS signal strenght.
  • Max hdop value – location point filtering according to horizontal dilution of precision.
  • Min. fuel difference to detect fuel fillings (default 10 %) – allows to set minimum amount (in percents) when sensor data changes will be recognized as fuel filling. (Example: if fuel level rises by 10% or more, it will be recognized as fuel filling). Note: In order to use this option, you must configure fuel sensor properly.
  • Min. fuel difference to detect fuel thefts (default 10 %) – allows to set minimum amount (in percents) when sensor data changes will be recognized as fuel theft. (Example: if fuel level drops by 10% or more, it will be recognized as fuel theft). Note: In order to use this option, you must configure fuel sensor properly.
  • Clear detected sensor cache – clears all detected device sensors.

Sensors

This section allows to add GPS device sensors and assign them to objects. There are many types of sensors. When configuring a sensor, the choice of sensor type depends on used device and its principle of operation. For more details refer to GPS device user manual.

To add sensors to your object please perform following steps:

  1. Go to Settings menu located in Top panel, select object and click on  edit object button.
  2. In Edit object window click on Sensors tab. In left bottom corner press + button.

Import/Export sensors – import/export buttons are located in the bottom of the window.

Sensor properties window will appear.

Sensor

  • Name – sensor name.
  • Type – sensor type that is suitable for the specific task. Note: for correct sensor type refer to GPS device user manual.
    • Digital input – displays device sensor value 1 or 0 (enables input fields to enter sensor state text).
    • Digital output – displays device sensor value 1 or 0 (enables input fields to enter sensor state text).
    • Driver assign – this sensor type allows to receive string from RFID or iButton devices. Received string will be checked in system. As a result, information will be seen, which driver is using vehicle. Note:Auto assign must be set in object settings.
    • Engine hours – receives engine hours value.
    • Fuel level – this option requires to specify result type (value or percentage) depending on device information result. For more details refer to GPS device user manual.
    • Ignition (ACC) – displays device sensor value 1 or 0 (enables input fields to enter sensor state text).
    • Odometer – receives odometer value.
    • Passenger assign – this sensor type allows to receive string from RFID or iButton devices. Received string will be checked in system. As a result, information will be seen, which passenger is using vehicle. Note: Auto assign must be set in object settings.
    • Temperature
    • Trailer assign – this sensor type allows to receive string from RFID or iButton devices. Received string will be checked in system. As a result, information will be seen, which trailer is connected to vehicle.Note: Auto assign must be set in object settings.
    • Custom – allows to enter any necessary sensor information. For more details refer to GPS device user manual.
  • Parameter – sensor parameter, refer to sensor parameters section.
  • Show in popup – sensor will be shown in object details popup.

Result

  • Type – option depends on chosen sensor type.
    • Logic – allows to enter text depending on sensor value.
    • Value – this option requires to specify result units of measurement (for example: kg, liters…) and formula (if applicable).
    • Percentage – this option requires to specify result lowest and highest values.
  • Units of measurement – value depending on sensor type (example: liters, galons, volts…)
  • If sensor “1” (text) – allows to show custom text if result value is 1 (examle: if sensor is used to monitor engine state, than if engine is running, text could be ON).
  • If sensor “0” (text) – allows to show custom text if result value is 0 (examle: if sensor is used to monitor engine state, than if engine is not running, text could be OFF).
  • Formula – in some cases need to perform device result calculations to get precise value. Note: for more details refer to your GPS device user manual. In formula field you can multiply, divide, add, subtract, use brackets. X means value which was sent by device.

Depending on sensor and result type parameters you will be able to enter lowest and highest values. This option allows to configure value range. Example: if need to monitor vehicle fuel level and GPS device is sending volts instead of real capacity, we need to know voltage of empty and full fuel tank (example: empty tank: 3 volts, full tank: 10 volts, according to these values: lowest value: 3, highest value: 10).

  • Lowest value – lowest sensor value.
  • Highest value – highest sensor value.

Calibration

This section can be used with Fuel level and Custom sensor type. Calibration allows you to set precise parameters of the sensor. Widely used to calculate fuel tank readings or convert sensor voltage to temperature values.

Example 1: Fuel tank

Different places Inside of the fuel tank may be wider or narrower and to get more accurate data you should use calibration.

In order to perform a more precise measurement of fuel tank, it is necessary to measure fuel tank sensor voltage width different fuel level. The system allows you to set up to 50 points, the more points you specify, the more accurate readings you will get.

Directions: Drain the fuel tank, write down the fuel sensor voltage readings, fill the tank with 5 litres/gallons of fuel, make a note of the fuel sensor voltage readings and so on until the tank is full.

Program will calculate fuel amount according to fuel sensor values.

Example of fuel sensor results:

  • Empty tank: 2 volts
  • 5 litres in tank – 3 volts
  • 10 litres- 4 volts
  • 15 litres- 5 volts
  • 60 litres- 14 volts

Follow these steps to enter data correctly:

  • Choose sensor type: Fuel level
  • Choose result type: Value
  • Enter units of measurement: litres or galons
  • In calibration X field: 2
  • In calibration Y field: 0
  • Click add button
  • In calibration X field: 3
  • In calibration Y field: 5
  • Click add button
  • In calibration X field: 4
  • In calibration Y field: 10
  • Click add button
  • Save sensor

Example 2: Temperature sensor

If temperature sensor sends volts instead of temperature values, then it is possible to convert results.

In this case we need to know temperature sensor voltage at its lowest and highest states.

  • Lowest: 3 volts – 0 degrees
  • Highest: 7 volts – 40 degrees

Program will calculate exact temperature according to set values.

Follow these steps to enter data correctly:

  • Choose sensor type: Custom
  • Choose result type: Value
  • Enter units of measurement: (according to example, you should use degrees)
  • In calibration X field: 3
  • In calibration Y field: 0
  • Click add button
  • In calibration X field: 7
  • In calibration Y field: 40
  • Click add button
  • Save sensor

Service

This section allows to set a reminder about vehicle maintenance work (example: change engine oil, insurance expiration).

To add reminder entries to your object please perform following steps:

  1. Go to Settings menu located in Top panel, select object and click on  edit object button.
  2. In Edit object window click on Service tab. In left bottom corner press + button.

Import/Export service entries – import/export buttons are located in the bottom of the window.

Service properties window will appear.

Service

Name – service name (example: Change engine oil).

Calculations are made according to odometer results:

  • Odometer interval (km) – distance after which service must be applied.
  • Last service (km) – enter distance when the last time service was done.

Calculations are made according to engine run time:

  • Engine hours (h) – time interval after which service must be applied.
  • Last service (h) – enter the last time service was done.

Calculations are made according to days:

  • Days interval – number of days after which service must be applied.
  • Last service – choose last service date.

Trigger event

  • Odometer left (km) – event will be triggered if chosen distance reached. Option available only if Odometer interval (km) is checked.
  • Engine hours left (h) – event will be triggered if chosen time reached. Option available only if Engine hours interval (h) is checked.
  • Days left – event will be triggered if specified days reached. Option available only if Days interval is checked.
  • Update last service – automatically updates information.

Current object counters

  • Current odometer (km) – current odometer results.
  • Current engine hours (h) – current engine hours results.

Info

More details about object, coordinates, speed, time and device protocol information.

Add object group

This section allows to group objects. This feature is useful managing large amount of objects.

In Object group list tab left bottom corner press + button.

Import/Export groups – import/export buttons are located in the bottom of the window.

In object group properties window enter group name and description (if necessary).

Add driver

Object drivers

This section allows to add drivers and assign them to object. Drivers section purpose is to identify and collect information about person who was using object. Driver information can be seen in object details panel (note: object details panel only appears if Objects, Events or History tab is selected in left panel.). Driver name is available in reports.

Object drivers can be configured to get information about object driver changes. Example: if driver John is using vehicle and after some time he is changed by another driver who’s name is Tom, these changes can be sent to system (GPS device must be configured with iButton or RFID device).

Add driver

In Object driver list tab left bottom corner press + button.

Import/Export drivers – import/export buttons are located in the bottom of the window.

Object driver properties window will appear.

In object driver properties window enter driver name, other fields are not mandatory.

  • Image – upload/delete driver photo.
  • Name – driver name that will be visible in reports.
  • iButton/RFID – enter iButton or RFID unique ID number for driver identification.
  • ID number – enter ID number to identify the driver.
  • Address, Phone, E-mail, Description – fill additional fields if necessary.

Add passenger

In Object passengers list tab left bottom corner press + button.

Import/Export passengers – import/export buttons are located in the bottom of the window.

Object passenger properties window will appear.

Add trailer

In Object trailers list tab left bottom corner press + button.

Import/Export trailers – import/export buttons are located in the bottom of the window.

Object trailer properties window will appear.

Events management

Events are used to simplify objects monitoring. They inform you about breaking setted rules like overspeeding and when object leaves or enters selected zone. This is very useful tool to monitor objects.

Create event

In Events tab left bottom corner press + button.

Event properties window will appear. Event section features are located in tabs depending on feature type.

Main settings

  • Active – Turns on and off event. Useful if you don’t want to receive event messages but want to keep event for further usage.
  • Event name – event name that will be displayed in events list.
  • Event type – current system version supports these events:

Events listed below must be supported by GPS device:

  • SOS – notification of SOS alarm button is pressed on the object.
  • Bracelet on – event is triggered if handcuffs are fastened.
  • Bracelet off – event is triggered if handcuffs are opened.
  • Man down – event is triggered if object lies on the ground (mostly used to monitor people body position).
  • Shock – event is triggered if GPS device was shaked.
  • Tow – event will be sent if GPS device detects object movement with turned off ignition.
  • Power cut – event is triggered if GPS device power leads were disconnected.
  • GPS antenna cut – event is triggered if device GPS antenna is cut, not connected or broken.
  • Signal jamming – event is triggered if GPS device detects signal jamming.
  • Low DC – event is triggered if GPS device DC (direct current) is too low.
  • Low battery – event is triggered if battery voltage is too low.
  • Harsh acceleration – event is triggered if GPS device detects sudden object acelereration.
  • Harsh braking – event is triggered if GPS device detects sudden object braking.
  • Harsh cornering – event is triggered if GPS device detects sudden object cornering.
  • Parameter – event is triggered if parameter received from device meets set condition.
  • Sensor – event is triggered if sensor meets set conditions.

Events listed below are independent from GPS device:

  • Connection yes – event is triggered if GPRS connection with GPS device was established.
  • Connection no – event is triggered if GPRS connection with GPS device was lost.
  • GPS yes – event is triggered if connection with GPS device was established.
  • GPS no – event is triggered if connection with GPS device was lost.
  • Overspeed – object exceeded predefined speed.
  • Underspeed – object have slowed down below the specified speed.
  • Service – allows to set a reminder about vehicle maintenance work (example: change engine oil).
  • Route in – object crossed predefined route.
  • Route out – object distanced from predefined route.
  • Zone in – object entered zone.
  • Zone out – object left zone.
  • Time period (min) – event will be trigerred if there is no GPRS connection for set period of time. Event works with “connection: no” event.
  • Speed limit (kph) – sets speed limit, works with overspeed and underspeed events.
  • Parameter condition – select event type “parameter” and set conditions of event triggering.
  • Sensor condition – select event type “sensor” and set conditions of event triggering.

Time

There are two tipes of time options when event will be triggered.

  • Week days – event will be active only on chosen days.
  • Day time – event will be active in set period of time.

Objects

  • Selected objects – select object for which event is created. To select multiple objects keep “Ctrl”button pressed.

Routes

Zones

  • Trigger event depending on zones
    • Off – disable dependency.
    • In selected zones – event will be associated only to selected zones.
    • Out of selected zones – event will be associated to all zones except selected ones.
  • Selected zones  – select zone from list (learn how to create zone). For multiple selection keep “Ctrl” button pressed.

Object control

  • Send command – read service manual of your GPS device to get all available commands.
  • Gateway – GPRS or SMS, choose approapriate type according to tracking device manual.
  • Type – ASCII or HEX, choose approapriate type according to tracking device manual.
  • Command – enter command according to your device manual.

Notification about event

  • System message – turns on and off system message. Note: system message will be seen only in used browser window.
  • Auto hide – automatically hide message after some period of time.
  • Sound alert – choose notification sound.
  • Message to e-mail box – turns on and off message to e-mail which is triggered by selected event. Note: notification may be sent to different e-mails, separate e-mail addresses with comma.
  • SMS to mobile phone – sends event message via SMS. Note: SMS gateway must be configured.
  • Email template – choose template, which will be used for email notifications. Email templates can be created in settings, templates tab.
  • SMS template – choose template, which will be used for SMS notifications. SMS templates can be created in settings, templates tab

Templates section allows to create templates for email and SMS notifications.

To create template, press + button in left bottom corner.

Template properties window will appear.

Note: HTML is allowed.

Allows every user to separately use SMS gateway server.

SMS gateway type – mobile application or HTTP.

Note: in case of mobile application gateway type, application should be downloaded to use mobile device as SMS Gateway, download app from here.

User interface section allows to set map settings, language, measurement units and time zone.

Chat

  • New chat message sount alert – choose chat message sound.

Map

  • Remember last map position – every time you login to system user interface map will be in the same place you left it (this option requires browser to accept cookies).
  • History route color – color of route viewed in history.
  • History route highlight color – color of highlighted route viewed in history.

Other

  • Language – user interface language.
  • Unit of distance – select miles or kilometres as distance measuring units.
  • Unit of capacity – select litres or gallons as capacity measuring units.
  • Unit of temperature – select Celsius or Fahrenheit as temperature measuring scale.
  • Currency – currency appears with fuel consumption cost.
  • Time zone – Indicate your time zone accurately because all time values are displayed in accordance with time zone selected. Make sure that your GPS device time zone is set to 0 UTC.
  • Daylight saving time (DST) – or summer time is the practice of advancing clocks during summer months by one hour so that evening daylight lasts an hour longer, while sacrificing normal sunrise times. Typically, regions with summer time adjust clocks forward one hour close to the start of spring and adjust them backward in the autumn to standard time.

My account section allows to enter personal information and change account password.

This feature allows to split main account into smaller accounts with limited privileges, such as: assign only particular objects and zones.

To create new sub account  press + button in left bottom corner.

Sub account properties window will appear.

Sub account

  • Active – turn sub account on or off.
  • E-mail – set e-mail that will be used to login to sub account.
  • Password – set password for sub account.
  • Expire account – set account expiration date. At due date account will become inactive.

Privileges

  • History – allow sub account user to view history section.
  • Reports – allow sub account user to view reports section.
  • RFID and iButton logbook – allow sub account user to view logbook section.
  • Object control – allow sub account user to view object control section.
  • Image gallery – allow sub account user to view image gallery section.
  • Chat – allow sub account user to view chat section.

Objects

List of available objects, select one or few that will be monitored in your sub account.

Markers

List of available markers, select one or few that will be monitored in your sub account.

Routes

List of available routes, select one or few that will be monitored in your sub account.

Zones

List of available zones, select one or few (hold “Ctrl” key to select multiple items) that will be monitored in your sub account.

Access via url

Simple way to access account via URL without need to login, two urls provided for standard and mobile interface version.

After setting parameters press save. Details of created sub account will be sent to entered E-mail.

CPanel Manual

Login

After installing software to be able to administrate server you need to login as administrator.

If installation process was done correctly, as described in software installation and configuration
manual
, you should be able to access web application by using similar link: http://www.yourdomain.com/track.

In Login window enter login and password.

Important! By default software login: admin, password: 123456.

After login you will see user interface. User interface allows to manage and monitor objects, view history, reports and create subaccounts with limited privileges. Learn more here.

To acces administrator panel click CPanel button in top right corner.

Control panel

Control panel allows to manage users, objects and some server settings. You are free to add/edit users, change user privileges, add/edit objects, set object expiration dates, change server name/logo, set billing and e-mail settings.

After login to control panel you will see user list section. It allows to add/edit users, view user activity.

  1. Back – goes back to administrator user account.
  2. View as – allows to view users and objects as another administrator/manager user.
  3. User list – view list of users in selected order (user order can be changed by selecting column heading).
  4. Object list – view list of objects in selected order (objects order can be changed by selecting column heading).
  5. Manage server – server settings.
  6. User information and privileges – logged user e-mail.
  7. Statistics – registered users, available and online objects count.
  8. Language – control panel’s default language.
  9. Logout – exit system.
  10. Search – search current visible list.
  11. Mass mail – send e-mail to all users.
  12. ID – user id number.
  13. Active – indicates current user account status.
  14. Privileges – shows user current privileges.
  15. Username – user username.
  16. E-mail – user e-mail address.
  17. API – Allows to use server data in web applications (currently under development).
  18. Reg. date – user registration date.
  19. Login date – date and time when user logged in.
  20. IP – user IP address.
  21. Sub acc. – number of sub accounts in user account.
  22. Objects – number of objects in user account.
  23. Edit – edit user account.
  24. Delete – delete user.
  25. Login as user – login to user account.
  26. Add new user – add new user.
  27. Reload – reload user list.
  28. Pages control – allows to navigate through results.

Add user

In user list section bottom left corner click add new user icon as shown below:

Add new user window will appear.

Enter user e-mail and click Register button. New user will appear in user list. User account details (e-mail and password) will be sent to entered e-mail address.

Edit user

To edit user data click  edit icon as shown below:

User account section will appear.

User account

This section keeps all user account settings and private data.

User

  • Active – allows to activate/deactivate user.
  • Username – user username.
  • E-mail – user e-mail.
  • Password – user password.
  • Expire account – set account expiration date (if needed). On due date account will become inactive.
  • Privileges – user rights.
    • Viewer – user can only see results without possibility to do any changes in account.
    • User – regular user with possibility to manage account on his own.
    • Manager – user with manager rights can access other users objects assigned to him (note: this option requires to choose object limit for manager user). To assign object to manager visit Object management section. Objects can be assigned to Manager only through CPanel.
    • Administrator – can access all available system features except Manage server tab.
    • Super Administrator – can access all available system features.
  • Manager – choose account manager. Note: user with manager rights must be created first!

Objects (Account/Manager)

  • Add from settings – allows to set object adding permission for user.
    • No – prohibits to add new objects.
    • Trial – allows to add unlimited number of objects for only 7 days.
    • Limited – limit object creation by number set in Object limit field.
    • Unlimited – allows to add unlimited number of objects.
  • Object limit – allows to set object limit.
  • Date limit – allows to add unlimited number of objects untill chosen date.

Other

  • History – turns on/off history section in user account.
  • Reports – turns on/off reports section in user account.
  • RFID and iButton logbook – turns on/off logbook section in user account.
  • Object control – turns on/off object control using commands section in user account.
  • Image gallery – turns on/off image gallery in user account.
  • Chat – turns on/off chat section in user account.
  • Use server SMS gateway – SMS gateway configured in Control panel will be used for chosen account.
  • Allow to clear history – turns on/off clear history button in Settings -> Objects.
  • Use server SMS Gateway – allows account owner to use predefined server SMS gateway. Also individual SMS gateway can be configured in account settings.
  • Max. number of markers – set maximum number of markers which can be added. Leave empty to use default server settings configured in Manage server -> User section.
  • Max. number of routes – set maximum number of routes which can be added. Leave empty to use default server settings configured in Manage server -> User section.
  • Max. number of zones – set maximum number of zones which can be added. Leave empty to use default server settings configured in Manage server -> User section.
  • Allow to use API – turns on/off API support. API key field – unique API key.

Contact information

Sub accounts

Sub accounts

This section allows to manage user sub accounts. You can change sub account username, e-mail, password, delete sub accounts.

To save changes click  save icon.

To remove sub account click  delete icon.

Objects

This section allows to manage user objects, extend object expiration date, set average date to all objects, view last connection time and status.

  • Name – object name.
  • IMEI – object IMEI number.
  • Active – allows to activate/deactivate object.
  • Active till – object expiration date.
  • Last connection – object last connection to server time.
  • Status – device connection status.
    • Grey icon – no GPRS and GPS
    • Orange icon – no GPS signal
    • Green icon – GPRS and GPS are OK
  •  Save – save changes.
  •  Clear history – clear object history.
  •  Delete – delete object.

Object management

Control panel allows to view, add, edit and delete objects located in object list tab.

  • Select box – select multiple objects to make particular actions (remove).
  • Name – object name.
  • IMEI – object IMEI number.
  • Sim card number
  • Active – allows to activate/deactivate object.
  • Active till – object expiration date.
  • Last connection – time of the last device connection to server.
  • Protocol – protocol used by device.
  • Port – port used by device.
  • Status – device connection status.
    Grey icon – no GPRS and GPS
    Orange icon – no GPS sygnal
    Green icon – GPRS and GPS are OK.
  • User account – object belongs to account with available e-mail address.
  • Edit – edit object settings.
  • Clear history – clear object history.
  • Remove – delete object.

Add object

In object list section bottom left corner click Add object icon as shown below:

Add new object window will appear.

  • Name – object name.
  • IMEI – device IMEI or ID.
  • Transport model
  • VIN – Vehicle Identification Number.
  • Plate number – vehicle plate numer.
  • GPS device – select device model.
  • SIM card number
  • Manager – allows to assign IMEI to user with manager rights (list appears only if manager privileges are set to one or more users with manager rights).
  • Active – activate/deactivate IMEI.
  • Active till –  set IMEI expiration date.
  • Text area – In text area enter account username or email to which IMEI should be assigned.

Edit object

To edit object data click  edit icon as shown below:

Edit object window will appear.

  • Name – object name.
  • IMEI – device IMEI or ID.
  • Transport model
  • VIN – Vehicle Identification Number.
  • Plate number – vehicle plate numer.
  • GPS device – select device model.
  • SIM card number
  • Manager – allows to assign IMEI to user with manager rights (list appears only if manager privileges are set to one or more users with manager rights).
  • Active – activate/deactivate IMEI.
  • Active till –  set IMEI expiration date.
  • Text area – In text area enter account username or email to which IMEI should be assigned.

Unused object list

This section allows to check all devices, which are sending data to server and are not assigned to any account. If listed IMEI will be assigned to account, it will be automatically removed from unused object list section.

Server management

Server management

This section consists of four tabs (server, user, e-mail, tools). Click manage server button as shown below:

Server

Server

This section contains basic software information, such as server name, IP address, logo, default interface language, etc..

Press  save icon if any changes must be saved.

Information

  • Hardware key – unique hardware key.
  • Server IP – IP address of server where software is hosted.
  • Server PORTS – URL address to a list of available server ports.

General

  • GPS server name – server name.
  • Show about button in top panel – enable/disable about button in user interface.

Logo

Allows to upload own logos which will be seen in user interface.

Additional URL’s

  • URL to login dialog – URL, which points to login dialog.
  • URL to help page (help button in top panel) – URL address which will be opened after clicking on help button.
  • URL to contact page (shown when user has to contact you)
  • URL to your shop where user can purchase subscriptions

Geocoder

  • Use geocoder cache, this will reduce API calls to geocoder servers and make some address responces faster– object location is received and saved in GPS server database to improve software performance.
  • Clear geocode cache – if for any reason you would like to erase memory press Clear button.

History

Keep history period (days) – object history data will be kept for set number of days.

Maps

Maps

This section allows to choose maps which will be available in front-end. Set default map zoom level and coordinates.

User

User

This section allows to configure user and payment settings.

Registration

Turns on and off user registration.

Defaults

  • Language – default server language.
  • Unit of distance
  • Unit of capacity
  • Unit of temperature
  • Currency
  • Time zone – default server time zone.
  • History
  • Reports
  • RFID and iButton logbook
  • Object control
  • Image gallery
  • Chat
  • Allow to clear history – enables/disables possibility to clean history of each object.
  • Allow to add objects – allow to add objects for newly registered users (later these settings can be changed for each user separately).
    • No – prohibits to add new objects.
    • Trial – allows to add unlimited number of objects for 7 days.
    • Limited – limit object creation by number set in Object limit field.
    • Unlimited – allows to add unlimited number of objects.
  • Obect limit (number) – set maximum object number for newly registered users.
  • Object validity period after account registation (days) – specify number of days when objects will be active. After expiration object becomes disabled until user makes payment.
  • Object Trial period (days) – specify object trial period in days.
  • Expire account (days after account registration) – account will be disabled after set period of time.

Notifications

  • Remind user about expiring objects (days before expire) – specify period in days.
  • Remind user about expiring account (days before expire) – specify period in days.

Billing

  • Payment type
    • None – payment can’t be accepted.
    • URL – URL address to custom page with payment information.
    • PayPal – redirects to PayPal to proceed payment.
  • URL to payment – URL address to custom page with payment information (available if URL is set in payment type).
  • Paypal account – PayPal account e-mail address.
  • PayPal payment name – payment name, visible in payment summary.
  • PayPal payment currency – currency accepted by paypal system (PayPal currency codes).
  • PayPal payment amount for one object – price for one object.
  • PayPal custom – PayPal custom identifier.

Other

  • Allow to schedule reports – allows users to use schedule reports.
  • Max. number of markers – limit markers for all users. (Also limit can be set for each user separately in Cpaneledit user section)
  • Max. number of routes – limit routes for all users. (Also limit can be set for each user separately in Cpanel edit user section)
  • Max. number of zones – limit zones for all users. (Also limit can be set for each user separately in Cpanel edit user section)

Templates

Templates

This section allows to edit system notification templates.

E-mail

This section allows to configure e-mail settings. For more details about SMTP configuration contact your e-mail server provider.

Gmail account configuration example:

  • SMTP server host: smtp.gmail.com
  • SMTP server Port: 465
  • SMTP Authentication: Yes
  • SMTP Security: SSL
  • SMTP username: your gmail username
  • SMTP password: your gmail password

SMS

SMS

This sections allows to configure SMS gateway.

SMS gateway type – mobile application or HTTP.

Note: in case of mobile application gateway type, application should be downloaded to use mobile device as SMS Gateway, download app from here.

Tools

Tools

This section allows to clean unnecessary GPS server data. Auto execute feature will perform task once a day.

Server Software

License agreement

This license is a legal agreement between Customer and bemgps.com for the use of Licensed Software. By installing or using any version of Licensed Software you agree to be bound by the terms and conditions of this license.

If Customer does not agree to this agreement, Customer may not install, copy, or use the Licensed Software.

Definitions

License Key – means, the specific license file which locks Licensed Software issued by http://www.bemgps.com to Customer using his provided domain name.

License Fee – means the applicable fee for which Customer licenses the Licensed Software.

Licensed Software – means the specific software licensed to Customer under the terms of this Agreement (as specified in the License and License Key issued to Customer). Does not include any Updates.

Update – means a revision to the Licensed Software or patch that improves the functionality of the Licensed Software, and may contain new features or enhancements (sold separately).

Software license

bemgps.com shall issue Customer a “Lifetime License Key” via e-mail that sets forth the specific Licensed Software. bemgps.com grants to Customer a non-assignable, nontransferable license, without the right to sublicense. Customer may install and run only one (1) copy of the Licensed Software at the same time. Additional installations require additional license purchases.

Documentation license

Subject to the terms and conditions of this Agreement, bemgps.com grants to Customer a non-assignable, nontransferable license, without the right to sublicense, to use the Documentation in connection with Customer’s authorized use of the Licensed Software. Customer may not reproduce or distribute the Documentation in any manner, whether physically or electronically, without the express written permission of bemgps.com. Entity Customer may access Documentation available on bemgps.com website.

Language files license

Software is provided with all available language files.

Ownership

The Licensed Software and source codes belongs to bemgps.com. Source code parts which are provided with Licensed Software can be modified by Customer and used on his server. Software files and source codes can‘t be sold, distributed, reproduced or transferred to any third party.

Technical support

bemgps.com agrees to provide Customer with technical support services which include periodic distribution of bug fixes and minor enhancements as Updates. Technical support e-mail inquiries are accepted at any time and will be answered during normal bemgps.com business hours. bemgps.com will attempt to respond to inquiries within 12 hours for requests from Monday to Friday and for requests received during the weekend, we will respond within 24 hours or the following Monday.

Updates

To receive and use an Update, Customer must pay the applicable fees for that Update and agree to bemgps.com standard terms and conditions governing the use of that Update.

Payment and delivery

Customer licenses the Licensed Software from bemgps.com. This Agreement is between Customer and bemgps.com

solely. The applicable License Fee is specified on the bemgps.com specific price proposal. The payment terms and conditions for the License Fee payable to bemgps.com are specified on the bemgps.com invoice. Licensed Software is delivered via e-mail by download link and installed for free on customer’s server using remote desktop access during 24 hours after payment is received. Refunds are not possible.

Software can be installed on any of server types which has at least Windows OS 7. It can be real PC server or virtual servers like VPS or VDS. If you chose  virtual server, we can recommend to use http://www.kickassvps.com services.

Make sure that you have Plesk with IIS or WAMP environment installed with PHP 5.4, 5.5 or 5.6 and MySQL 5.6 or above versions.

Below you will find a table or minimum server configurations to handle amount of objects constantly online. Not depending from number of objects you will need also static IP and web domain name.

Objects Requirements
100-500 CPU: One Core 2.0 GHz, RAM: 3 GB, HD: 10 GB, OS: Windows 32 bit, Bandwidth: 5MBit/s
500-1000 CPU: Two Cores 2.0 GHz, RAM: 8 GB, HD: 20 GB, OS: Windows 64 bit, Bandwidth: 10MBit/s
1000-5000 CPU: Two Cores 2.0 GHz, RAM: 16 GB, HD: 50 GB, OS: Windows 64 bit, Bandwidth: 50MBit/s
5000-10000 CPU: Four Cores 2.0 GHz, RAM: 32 GB, HD: 100 GB, OS: Windows 64 bit, Bandwidth: 100MBit/s

Software package preparation

  1. Make sure Microsoft .NET Framework 4.5.1 is installed. It can be downloaded here: microsoft.com.
  2. Send to our e-mail info@bemtop.com full domain which is pointed to server IP where software will be installed.
  3. Package download link will be delivered via e-mail during 24 hours.

Installation preparation

  1. Download software package and extract it.
  2. Make sure that you have Plesk with IIS or WAMP environment installed with PHP 5.4, 5.5 or 5.6 and MySQL 5.6 or above versions.
  3. Set “short_open_tag” to “On” in php.ini.
  4. Let’s say you would like to access installed software via domain and folder “track”. Then “YOUR_DOMAIN/track” is full web address to installed software.

Web part installation

  1. Open phpMyAdmin from web server (IIS, WAMP, XAMP or others) and create new database.
  2. Set created database username and password.
  3. Select your database from list on the left and open “SQL” tab. You will see big text box.
  4. From software package open “database\db.sql” with text editor.
  5. Copy and paste everything to “SQL” tab text box and click “Go”.
  6. If everything is correct it will create needed tables for your database.
  7. From software package open “track\config.php” with text editor and set important variables:
    • $gsValues[‘PATH_ROOT’] = ‘LOCAL_PATH_TO_ROOT’;
    • $gsValues[‘URL_ROOT’] = ‘http://YOUR_DOMAIN/track’;
    • $gsValues[‘URL_GC’] = ‘http://YOUR_DOMAIN/track/tools/gc/google.php’;
    • $gsValues[‘HW_KEY’] = ‘YOUR_HARDWARE_KEY’;
    • $gsValues[‘DB_HOSTNAME’] = ‘localhost’;
    • $gsValues[‘DB_PORT’] = ‘3306’;
    • $gsValues[‘DB_NAME’] = ‘YOUR _DATABASE_NAME’;
    • $gsValues[‘DB_USERNAME’] = ‘YOUR _DATABASE_USERNAME’;
    • $gsValues[‘DB_PASSWORD’] = ‘YOUR _DATABASE_PASSWORD’;
  8. Using file manager or FTP client create folder “track” on web server. It should be accessible like this “YOUR_DOMAIN/track”.
  9. From software package upload “track” folder contents to created “track” folder on web server.
  10. Set CHMOD 777 for:
    • “YOUR_DOMAIN/track/config.custom.php”
    • “YOUR_DOMAIN/track/data/img”
    • “YOUR_DOMAIN/track/data/user/drivers”
    • “YOUR_DOMAIN/track/data/user/objects”
    • “YOUR_DOMAIN/track/data/user/places”
    • “YOUR_DOMAIN/track/img”
    • “YOUR_DOMAIN/track/logs”
  11. Now you should be able to access web application using this link: “YOUR_DOMAIN/track”
    • Login: admin
    • Password: 123456
  12. After login to CPanel go to Manage server section, E-mail tab and configure e-mail, otherwise users will not be able to register.

Server EXE part installation

  1. From software package copy “gs” folder to “c:\gs”.
  2. Run “c:\gs\GPS-server.exe”.
  3. Check “Autostart server”.
  4. Enable all needed protocols from the list. Just check checkboxes in “Enabled” column.
  5. Click “Save settings”.
  6. Click “Start server”. After that you may see firewall warnings, so you have firewall to allow these protocol ports to be open.
  7. If all protocols started successfully you can click “Stop server”.

License

  • Server –  server domain where software is installed (set by license key).
  • Hardware key – unique server key, used for some server services.

Settings

  • Autostart server – once GPS-server.exe is started, TCP/IP and UDP listeners will start together.
  • Print location messages to console – enable or disable location messages printing in console window.
  • Protocol console window – sets console window state on start: normal, minimized or maximized.
  • Protocol restart interval (mins.) – restarts TCP/IP and UDP listeners after set period of time.
  • Database upload threads – number of upload threads, which upload data independently at same time to database.
  • Locations in one upload – number or locations uploaded by thread in one packed.
  • Location filter – filters duplicate points during last minutes and eliminates some drifting when GPS device signal is low.
  • Skip locations if time difference lower (sec) – skips location data if time period is lower between current and last location, prevents server flood.
  • Skip locations if older (hours) – prevents too old location upload from GPS device buffer.

Do not forget to make backup

Once you get your GPS server running, do not forget to make backup of “c:\gs” folder contents. Also make regular backups of “YOUR_DOMAIN/track” and your GPS server MySQL database.

GPS device configuration

  1. While configuring GPS devices, use your PC, VPS or VDS server external IP address and port from protocols list in “GSP-Server.exe”, depending from GPS device model.
  2. Make sure that ports used by “GSP-Server.exe” are not blocked by your LAN router or Firewall.

Run GPS-server.exe as Windows OS service

For production server it is highly recommended to run “GPS-server.exe” as Windows OS service, because in that case there is no need to login into Windows OS user account, it will run in background silently.

  1. With mouse right click open menu on “c:\gs\service\install_win32.bat” or “c:\gs\service\install_win64.bat” file and select “Run as administrator”.
  2. Select “Path” to “c:\gs\GPS-server.exe”. Startup directory should be “c:\gs”.
  3. Click “Install service”.
  4. Execute “services.msc” from “Run” tool under Windows OS Start menu.
  5. Find “GPS-server” and make sure “Startup type” is set as “Automatic”.
  6. Restart your server and if everything was done right, “GPS-server.exe” should work as a service application.
  7. Service application runs wihout GUI, so it will be not possible to do any changes to “GPS-server.exe” settings.
  8. In case you want to change settings, stop “GPS-server” service via “services.msc” and open it as simple application from “c:\gs\GPS-server.exe”.

Run GPS-server.exe as Windows OS application

It is recommend to run “GPS-server.exe” as Windows OS service, but if you still want to monitor what is happening in console, follow below steps:

  1. Make sure that “GPS-server” service is not running. Run “services.msc”, and stop “GPS-server” service.
  2. After service is stopped, make sure that processes “protocolstcp.exe” and “protocolsudp.exe” are stopped.
  3. Now you are able to start “GPS-server.exe” as Windows OS application.

Change web application configuration

Most of changes can be done via “CPanel/Manage server”, but some changes are still accessible only
via configuration files due to security reasons.

Follow configuration files comments to change server configuration:

  • “YOUR_DOMAIN/track/config.php”
  • “YOUR_DOMAIN/track/js/gs.config.js”

Translate English language to other languages

  1. Open “YOUR_DOMAIN/track/lng”, make “english” folder copy and rename copied folder to your language name.
  2. Open every file from copied folder in text editor and make translations.
  3. Open “YOUR_DOMAIN/track/config.php” in text editor and make modifications to language array. Below is an example for French language:

$gsValues[‘LANGUAGES’] = array(‘english’, ‘russian’, ‘french’);

If you are going to use secure e-mail SMTP server (SSL)

Make sure that “extension=php_openssl.dll” is uncommented in php.ini.

Software update steps

  1. Make sure you are running at least Windows OS 7 and NET Framework 4.5.1 or higher version.
  2. Extract delivered software update package.
  3. Turn off GPS-server.exe.
  4. Make backup of software MySQL database.
  5. Let’s say your software is installed at “YOUR_DOMAIN/track”.
  6. Rename old “track” folder to “track_old”.
  7. Create new folder “track” for new version files.
  8. Copy new version files to “track” folder.
  9. Apply old “track_old/config.php” settings to new “track/config.php”.
  10. Apply old “track_old/config.custom.php” settings to new “track/config.custom.php”.
  11. If “db.sql” file exists in “YOUR_DOMAIN/track/update” folder, then run that file via phpMyAdmin SQL query to add extra database tables.
  12. Open web browser and run all update scripts from “YOUR_DOMAIN/track/update” folder in ascending order. Some update scripts may take more time to execute.
  13. Copy new “gs” folder files on top of old files in “c:\gs” folder.
  14. Start GPS-server.exe.

FAQS

Note: document contents may change due to software changes or updates without any notice.

1. How can I use tracking software with my language?
If your language is not listed in language selection box, you can download our software English language files and translate them using text editor. Send us translated files and we will add your language.

English language files can be downloaded here.

2. If I press SOS button, will any sound signal appear on PC?
Yes, you will hear alarm sound signal.

3. Can I add more than one e-mail to event?
Yes, you can. Simply split them with comma.

4. How big is location packet that GPS device is sending to server?
It depends on set intervals and what kind of device you are using, usually it’s from 50 to 150 bytesper location packet.

5. Can I change the way of how some things are displayed on the GPS tracking application, for example I want the driver or/and the plate number to be displayed with the name of the object ?
We may add this feature configuration to settings in feature updates, but now it is not available. Please have in mind that if you purchase our GPS software, you can do various changes on your own by just editing PHP and JavaScript code, change design, type how information is displayed, develop custom feature and lots of other things.

6. Can I connect camera to my GPS device and view it on server?
Currently our server doesn’t support video streaming. Keep in mind that most of GPS trackers don’t support video streaming via GPRS, only via 3G calls. Also GPRS traffic would grow rapidly.

7. Why I don’t see Administrator panel when I use your server?
To have access to administrator panel you must build own server using our software.

8. Can I show on my website map from your server so my customers can see how cars are moving?
No, we do not allow this to avoid high traffic and lots of connections.

9. Can I use your tracking software on my mobile phone?
Yes, here is link to mobile version: link

10. I have GPS tracker, which is not listed in your supported devices list, what should I do? 
You need to request GPRS protocol documentation from device manufacturer and send it to us, we will develop GPRS protocol for it.

11. When I add new device for trial I receive “Inactive Object” error message, why?
This may happen when you are trying to add object with expired trial for second time. To make this device work again you need to pay annual fee.

Frequently asked questions – software

Note: document contents may change due to software changes or updates without any notice.

1. What is payment method?
Once we prepare invoice for you, payment can be done via Bank Transfer or Western Union.

2. Is payment for software lifetime or annual?
Payment is for lifetime.

3. How many users and GPS devices I can add to my server?
You can add unlimited number of users and GPS devices.

4. Once software updates are released, how I can get them?
If you want to get our latest software version, cost is 100 EUR if it is installed by you. If update is installed by our team, cost is 150 EUR.

5. After payment is received how fast will you prepare software package?
It will take up to 24 hours, depending on our company load.

6. If my PC/VPS/VDS down or broken, can I transfer the software to another server?
Yes, you can.

7. Can I run the software on Linux?
No, Windows OS is needed.

8. Can I install it on my own?
Yes, we will provide step by step installation manual. Everything is simple and can be installed during 20-30 minutes.

9. If I have any problems with installation or configuration, can you help me?
Yes, we will help you via Teamviewer or Remote Desktop. First installation is free.

10. Can I make my server to keep history longer than 30 days?
Yes, you can.

11. Can I change logo and brand of your software?
Yes, you can.

12. Can I charge my server users for using my services?
Yes, you can.

13. Is it possible to integrate payment method like PayPal for user charging?
Yes, it is. We also use PayPal as main payment method in our GPS server.

14. How can I translate the software to another language?
Our software has English language files. Using simple text editor it can be translated to any language. You can have English and one or more of your translated languages.

15. Can I integrate new maps to the software?
Yes, if you have JavaScript programming skills.

16. If I buy software will I also get source codes?
You will get source codes for front end application, so you will be able to customize it using PHP and JavaScript. It allows to change design, work behavior and develop custom features. Communication and protocol applications are compiled and source codes are not provided.

17. Will you also provide Android, BlackBerry, iOS and Windows Phone mobile applications in package?
All mobile applications should be downloaded from application stores to avoid mobile device rooting or jailbreaking. They won’t have our logo, brand or web page address. In application settings custom server URL must be used to work with your server.

18. For better system performance, what is more important, ping time or Internet speed?
Ping time is more important, as you will get lots of TCP/IP connections from GPS trackers and data
packet size is only about 50-150 bytes.