background image

BlackKite, Vehicle Tracking System User Manual

Rev. 1.4.0

Zilogic Systems

Page 48

Digital Outputs

• Tag Type: 0x45
• Length: 2 bytes
• Format: Each bit indicates status of one digital output. Bit position 0, corresponds to digital

output 1, and so on.

• Example: If digital outputs 1 and 3 are low, and rest of the output are high, the field is rep-

resented as 

FA FF

.

Digital Inputs

• Tag Type: 0x46
• Length: 2 bytes
• Format: Each bit indicates status of one digital input. Bit position 0, corresponds to digital

input 1, and so on.

• Example: If digital inputs 1 and 3 are low, and rest of the inputs are high, the field is repre-

sented as 

FA FF

.

Analog Input 1 - 2

• Tag Type: 0x50 - 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 indicates SOS button was not pressed. 1 indicates SOS button was pressed.
– Bit 9: 0 indicates ignition off. 1 indicates ignition on.
– Bit 2: 0 indicates device power is disconnected. 1 indicates car battery is connected.

• Example: If SOS button was pressed, the filed is represented as 

00 80

9.6. Sample Packets

The following is an example packet with just the IMEI and time stamp fields.

01 3C 00 03 33 35 37 38 30 34 30 34 33 33 39 39 39 31 38 90 62 DA 52 70 FC

The meaning of each byte in the packet is listed in the following table.

Bytes

Meaning

01

Type MAIN / HEAD / ALERT

3C 00

Length

03

IMEI Tag

33 35 37 38 30 34 30 34 33 33 39 39

39 31 38

IMEI Number

Summary of Contents for BlackKite

Page 1: ...BlackKite Vehicle Tracking System User Manual 1 4 0 May 2016...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Page 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...

Reviews: