background image

BlackKite, Vehicle Tracking System User Manual

Rev. 1.4.0

Zilogic Systems

Page 33

If the 

<mode>

 argument is not specified then the current mode is returned as response.

Reboot. 

The device can be rebooted using the following command.

Command

REBOOT

Response

OK: REBOOT

Link Status. 

The device network connectivity status can be queried using the following com-

mand.

Command

LINKSTAT

Response

OK: GPRS: <gprs> SERVER: <server>

The field definitions are listed below.

gprs

1

 indicates GPRS connected, 

0

 indicates GPRS disconnected

server

1

 indicates connected to server, 

0

 indicates disconnected from server

Firmware Upgrade. 

The device firmware can be upgraded using the following command.

Command

UPGRADE <filename>

Response

`OK: Upgrade request received."

The detailed upgrade procedure is provided in Chapter 8, 

Firmware Upgrade

.

7.3. SOS Commands

The SOS commands and their meanings are listed below. These commands require admin privi-

leges. These commands are available only in main application mode (

MAIN

).

SOS Reset. 

When the SOS button is triggered, the SOS flag is set in messages sent to the server.

The following command is used to clear the SOS flag.

Command

SOSRESET

Response

OK: SOS turned off

7.4. Location and IO Commands

The location and IO commands and their meanings are listed below. These commands do not

require admin privileges. These commands are available only in main application mode (

MAIN

).

Location. 

The vehicle location and status can be obtained using the following command.

Command

STATUS

Response

OK: LOC: <l>, SPD: <s>, DIR: <d>, IGN: <i>, BATT: <b>.

The field definitions are listed below.

l

Link to Google maps, indicating current location of the vehicle.

s

Speed of the device in kmph.

d

Direction is one of 

N

E

W

S

NE

NW

SE

SW

.

i

State of ignition 

On

 or 

Off

b

State of vehicle battery, 

On

 indicates connected, 

Off

 indicates disconnected.

Set Digital Output. 

The digital outputs can be set using the following command.

Command

IOSET <id> <state>

Response

OK: DO <id>: <state>

Содержание BlackKite

Страница 1: ...BlackKite Vehicle Tracking System User Manual 1 4 0 May 2016...

Страница 2: ...is licensed under the Creative Commons Attribution Share Alike 2 5 India License To view a copy of this license visit http creativecommons org licenses by sa 2 5 in or send a letter to Creative Commo...

Страница 3: ...Parameter Selection 14 4 3 Location Tracking 15 4 4 IO Monitoring and Control 17 4 5 Alerts 20 5 Quick Start 26 5 1 Initial Device Setup 26 5 2 Vehicle Installation 28 6 Interfaces 29 6 1 Connector L...

Страница 4: ...ser Manual Rev 1 4 0 Zilogic Systems Page iv B 1 LIMITED HARDWARE WARRANTY 51 B 2 EXCLUSIONS 51 B 3 HARDWARE RETURN PROCEDURES 51 B 4 HARDWARE REPLACEMENT PROCEDURES 52 B 5 ADDITIONAL RESPONSIBILITIES...

Страница 5: ...y control in vehicle appliances like AC vehicle audio and infotain ment systems Analog inputs to monitor parameters like fuel level vehicle load and temperature Dedicated SOS ignition inputs with devi...

Страница 6: ...g Monitor and analyze vehicle fuel usage and pilferage Emergency alerts Communicate location information on emergency situation 1 4 Specification 1 4 1 GPS GPS engine 48 Channels SiRF star IV Position...

Страница 7: ...tery Wire harness Quick Start Guide The BlackKite Fleet Starter Kit contains the following items that is necessary for device configura tion BlackKite Fleet Unit Battery Wire harness 12V Power adapter...

Страница 8: ...are placed nearby Warning The device is susceptible to water and humidity Warning Any installation and or handling during a lightning storm is prohibited 2 2 LED Indications INT PWR LED ON indicates o...

Страница 9: ...H2 H H1 H2 Table 2 1 Dimensions Dimension Measurement mm Length L 137 Width W 72 Height H 25 2 4 Electrical Parameter Min Typ Max Unit Supply Voltage 9 12 36 V Average Supply Current 30 sec Transmiss...

Страница 10: ...mission Period at 12V supply 4 Hours 15 min Transmission Period at 12V supply 4 Hours Charging Current at 12V supply 100 mA Digital Output Open Collector Sink Current at 12V supply 100 mA Digital Inpu...

Страница 11: ...Kite device BlackKite Configurator USB Serial Driver 3 2 1 BlackKite Configurator The Windows installer for the software is included in the CD ROM The Configurator requires Java Runtime Environment 7...

Страница 12: ...s Menu and shows the device con nectivity information Configuration Menu which is on left side of the window and allows to switch between the different configurations screens Screens which is the main...

Страница 13: ...are properly updated to the device 3 5 1 1 Importing Configuration From The Device The existing device configuration can be read from device to the in memory configuration either by selecting Menu De...

Страница 14: ...mbers and their privi leges Vehicle Parameters Configurations for vehicle parameters that can be sent to server Alerts Configurations for alert notifications to be sent through SMS and GPRS FOTA Confi...

Страница 15: ...for the following purposes Share common configuration across different computers Archive and reuse default configuration for similar devices 3 5 2 3 Loading Configuration From A File The configuration...

Страница 16: ...BlackKite Vehicle Tracking System User Manual Rev 1 4 0 Zilogic Systems Page 12 Figure 3 11 Save the Configuration to File Figure 3 12 Error on Saving Misconfigured Data...

Страница 17: ...eceived from authorized users in accordance to their privilege level The managers have the below privileges Set Reset digital outputs Receive device generated alerts Request location and IO status The...

Страница 18: ...dd the manager 3 Send SAVE for the changes to take effect 4 2 Vehicle Parameter Selection BlackKite Fleet is capable of sending various vehicle parameters like location speed and IO status to the serv...

Страница 19: ...ble Table 7 1 Tag Name Definitions The command sequence for adding the required tags is provided below 1 Send ADD MAINPACK LOC to add the location information 2 Send ADD MAINPACK TIME to add the date...

Страница 20: ...r each state Refer Section 6 2 Connecting Ignition for connecting vehicle ignition to the device Let s consider an example scenario in which the APN name is www the APN username and pass word is empty...

Страница 21: ...trol More than location user would want to monitor many other parameters of the vehicle to effec tively manage the fleets BlackKite Fleet has multiple input outputs to monitor and control other parame...

Страница 22: ...tputs using automotive relays When enabled BlackKite Fleet continuously monitors and sends the digital output status to the server Refer Section 6 4 Connecting a Relay for connecting a relay to the di...

Страница 23: ...r temperature sensor load sensor etc When enabled the device monitors and sends the sensor data to the server Primarily the fuel sensor is connected to the analog input to monitor the fuel level Refer...

Страница 24: ...lege field 3 In the row corresponding to 919123456789 select Disable in the Alerts Privilege field 4 5 1 2 Configuring through Commands The command sequence is provided below 1 Send ADD SMSACL 9194441...

Страница 25: ...GPRS packet to the server when there is a state change Let s assume a scenario in which 1 The user would like to get SMS alerts and GPRS alerts for any change in the door sensor connected to digital...

Страница 26: ...here is a state change in the vehicle ignition SMS Alert When enabled the device notifies the status change of the vehicle ignition to the au thorized users GPRS Alert When enabled the device sends ou...

Страница 27: ...t message will be sent every 2 min until the vehicle speed drops below the set thresh old GPRS Alerts When enabled the device sends out additional GPRS packets whenever the vehicle exceeds the thresho...

Страница 28: ...itional GPRS packet to the server with the battery status Enabling battery Alert The device also generates an alert message Device battery low when the internal battery is low and the device is about...

Страница 29: ...stored All data transmitted from the internal storage will be sent with Archive Indicator bit set The device can store data for a maximum of 24 hours and this enables the user to receive infor mation...

Страница 30: ...tery and SIM slot can only be accessed by opening the device casing Unscrew the screws located at positions 1 2 3 and 4 as shown in picture below 5 1 2 Inserting the SIM Card With the device case open...

Страница 31: ...nternal battery 1 to the battery connector 2 as shown in the picture below 5 1 4 Powering the Device The battery shipped with the device is not charged and hence the device needs to operate from AC ma...

Страница 32: ...the device version as response The device is configured by default to send data to a demo server Go to http bkdemo zilogic com and enter your device IMEI no The data from the device should be visible...

Страница 33: ...1 8 RSVD 20 DOUT2 9 RSVD 21 RSVD 10 AIN0 22 SOS_LED 11 AIN1 23 VOUT 12 GND 24 GND 6 2 Connecting Ignition The ignition input of the BlackKite Fleet is used to identify whether the vehicle is stationar...

Страница 34: ...puts The below figure shows how to connect a relay to the digital output 6 5 Connecting a Resistive Fuel Level Sensor A fuel gauge consists of two parts a fuel level sensor and a fuel level indicator...

Страница 35: ...el A simple way to calibrate is to fill the fuel tank at various levels full half and empty and note down the output voltage for each level With the obtained readings the fuel tank levels for any volt...

Страница 36: ...do not require admin privileges Version The software version MODEM firmware version GPS firmware version can be obtained using the following command Command VERSION Response OK APP av MDM mv GPS gv HW...

Страница 37: ...ted below These commands require admin privi leges These commands are available only in main application mode MAIN SOS Reset When the SOS button is triggered the SOS flag is set in messages sent to th...

Страница 38: ...modified are not activated until saved using the following command Command SAVE Response OK Saved GPRS Enable Disable When GPRS is enabled data is pushed to the server When GPRS is dis abled data is...

Страница 39: ...figured using the following command Command ADD SMSACL phoneno admin alert reserved Response OK SMSACL phoneno1 phoneno2 The current access control settings for a mobile no can be retrieved using the...

Страница 40: ...the interval between SMS alerts in minutes Vehicle Parameter Tags A tag to be sent as part of the main and alert packets can be added using the following command Command ADD MAINPACK tag Response OK...

Страница 41: ...nding input goes from high to low or from low to high DOn SMS alert will be sent when the corresponding output is changed from high to low or from low to high OST SMS alerts will be sent every 2 min a...

Страница 42: ...t will be sent when the vehicle battery is disconnected or connected IGN GPRS alert packet will be sent when the ignition is turned ON or turned OFF Enable AGPS AGPS can be enabled and disabled using...

Страница 43: ...following command Command SET FTP ip port username password Response OK FTP ip port username password The current FTP server IP address port username and password settings can be obtained using the f...

Страница 44: ...consider an example scenario in which the current firmware version 1 2 0 and the new firmware version is 1 3 0 The sequence for the upgrade is provided below The description of each step in the upgra...

Страница 45: ...g format ALERT Upgrade Error error info An error can occur for example when the filename is incorrect or the file was corrupted during the FTP transfer After resolving the issue the UPGRADE command ca...

Страница 46: ...type indicates the message type It is 0x01 for HEAD MAIN and ALERT messages Length Archive Indicator 2 Bits 14 0 the packet length in bytes The length includes all the fields except the checksum Bit...

Страница 47: ...receiver can use the fact that the tags within the record are ordered to determine the start of a new record 9 4 ALERT Message ALERT messages are sent after a change in vehicle parameters Refer Secti...

Страница 48: ...mber of seconds since 1st Jan 1970 as unsigned integer Example 18th Jan 2014 16 46 28 UTC which is 1390063588 seconds since 1st Jan 1970 UTC is represented as E4 AF DA 52 Coordinates and Satellites Ta...

Страница 49: ...byte val return int val 0xFF Convert 4 byte coordinate representation to degrees private static double getCoordinate byte bytes int microdegrees b2i bytes 0 0 b2i bytes 1 8 b2i bytes 2 16 b2i bytes 3...

Страница 50: ...Example For the following values the speed and direction field is represented as 5C 00 48 08 Sub field Value Representation Speed 9 2 km hr 5C 00 Direction 212 degrees 48 08 Java Code to Compute Spee...

Страница 51: ...Type 0x34 Length 2 bytes Format Altitude in meters above sea level as signed integer Example 23 meters 75 feet is represented as 17 00 Java Code to Compute Altitude public class BlackKite Convert byt...

Страница 52: ...0x51 Length 2 bytes Format Voltage at the input pin in mV as unsigned integer Example If the analog input is 2V the field is represented as D0 07 Status Tag Type 0x40 Length 2 bytes Format Bit 15 0 i...

Страница 53: ...D8 Received Packet Checksum 9 7 Archive Messages are stored in the archive in the following situations 1 GSM Signal is too low 2 Server is not accessible 3 Server is accessible but ACK is not receive...

Страница 54: ...A Document Revision Revision Date Description 1 0 0 23 Oct 2015 Initial release 1 1 0 11 Nov 2015 Added aggregate packet information 1 2 0 09 Jan 2016 Support file changes No content change 1 3 0 21...

Страница 55: ...by anyone other than Zilogic Systems 3 modifications alterations or additions to the Hard ware Products by personnel not certified by Zilogic Systems or Zilogic Systems authorized engi neers to perfo...

Страница 56: ...ogic Systems or its partner with sufficient and safe access to your facilities to permit Zilogic Systems to fulfill its obligations To ship back the faulty Hardware Product or replaceable unit suitabl...

Страница 57: ...ATE THE CAUSE OF ACTION AROSE WARRANTY DISCLAIMER EXCEPT AS STATED HEREIN ZILOGIC SYSTEMS MAKES NO WARRANTIES WITH RESPECT TO any PRODUCT license or SERVICE AND DISCLAIMS ALL Statutory or IMPLIED WARR...

Отзывы: