1 GPRS Command Format GPRS uplink (i.e.: Data is sent from tracker to platform) command format: $$<pack-len>,<ID>,<work-no>,<cmd-code>,<cmd-para>*<checksum>\r\n GPRS downlink (i.e.: Data is sent form platform to tracker) command format: ##<pack-len>,<ID>,<work-no>,<cmd-code>,<cmd-para>*<checksum>\r\n Remarks: Comma (,) is used to separate data fields, and it is necessary. There is no space before or after comma. pack-len: Package Length, decimal string format, the field of pack-len is {,<ID>,<work-no>,<cmd-code>,<cmd-para>}, be careful, comma(,) in front of ID included.
ID: Tracker ID, default IMEI. work-no: working number, hexadecimal string format, cyclic accumulation from 1 to 0xFFFF. cmd-code: Command code, or specification of data type. cmd-para: parameter or description of cmd-code, which is described in the following chapters. checksum: checksum of package, 2 bytes hexadecimal string format, XOR of {<pack-len>,<ID>,<work-no>,<cmd-code>,<cmd-para>}. \r\n: End of package, i.e. <CR><LF>. Without specification, multi-byte binary data in cmd-para uses big endian format, i.e. Most Significant Byte first.
2 SMS Command Format Sending SMS (from mobile to tracker) command format: <password>,<cmd-code>,<cmd-para> Reply SMS (from tracker to mobile) data format: <cmd-code>,<proc-result> 01 password: SMS password, 6 digits, default “000000”. 02 cmd-code: command code, the same as cmd-code filed in GPRS command. 03 cmd-para: command parameter, the same as cmd-para filed in GPRS command. 04 proc-result: command process result OK – Succeed. 05 SMS command with invalid password, or with incorrect format, no reply will be sent.
3 Serial port (COM) Command Format Setting command format: #<cmd-code>,<cmd-para><CR><LF> Reply data format #<cmd-code>,<proc-result><CR><LF> cmd-code, cmd-para: the same as corresponding fileds of GPRS/SMS command. proc-result: COM command procession result OK – Succeed. UNSUPPORT – Command not supported. FAILED –Procession failed. FIFOTRACK S50 GPRS PROTOCOL and COMMAND LIST Copyright @fifotrack 2015 All Rights Reserved 4 Command Writing Specification Comma (,) is used to separate multi-filed, there is no space before and after comma. For command with multi parameters, filed(s) can be empty, the corresponding parameter is set to default. The following chapters describe cmd-code and cmd-para. The “Retrieve” row in the following chapters describes the corresponding query command.
5 GPRS Data Format 5.1 A01 -- GPS Position/Alarm Data Format $$<pack-len>,<ID>,<work-no>,A01,<alm-code|alm-para>,<date-time>,<fix_flag>,<latitude>,<long itude>,<speed>,<course>,<altitude>,<odometer>,<runtime>,<status>,<input-st>,<output-st>,MC C|MNC|LAC|CI,bat-ad|ext-ad|ad1…adN,<rfid_data>,<digital-sensor>*<checksum>\r\n Descriptions of position/alarm data: Example: $$263,863835029419947,29,A01,,170705072751,A,22.621798,114.036116,57,0,126,1627,404, A012007A,02,0,460|0|24A4|F82,A33|13C|0,% ^SUKSAWADDEE$SAITHARN$MISS^^?;6007643100500157891=150619800909=?+ 24 2 0004552 00100 ?,*62 Filed pack-len Description decimal string format, the field of pack-len is {,<ID>,<work-no>,A01,<alm-code|alm-para>,<date-time>,<fix_flag>,<latitude>,<l ongitude>,<speed>,<course>,<altitude>,<odometer>,<runtime>,<status>,<input-s t>,<output-st>,MCC|MNC|LAC|CI,bat-ad|ext-ad|ad1…adN,<rfid_data>,<digital-s ensor>}, be careful, comma(,) in front of ID included. Example 263 Filed ID Description Tracker ID, default IMEI, ASCII string Example 863835029419947 Filed work-no Description working number, hexadecimal string format, cyclic accumulation from 1 to 0xFFFF Example 29, indicates that the value of work-no is 0x0029 Filed alm-code|alm-para Description Alarm code and alarm parameter, refer to Appendix A; For normal position data, this field is empty. Example Empty, the package is a normal position one. Filed date-time Description UTC-0 date & time, in format: YYMMDDHHmmss 01 YY: year, value(year – 2000), 2 characters 02 MM: month, value range 1--12, 2 characters 03 DD: day, value range 1--31, 2 characters 04 HH: hour, value range 0--23, 2 characters 05 mm: minute, value range 0-59, 2 characters FIFOTRACK S50 GPRS PROTOCOL and COMMAND LIST Copyright @fifotrack 2015 All Rights Reserved 06 ss: second, value range 0--59, 2 characters Example 170705072751, which means 2017-07-05 07:27:51 Filed fix_flag Description GPS Status flag, A--valid, V--invalid Example A, means that GPS signal is valid Filed latitude Description Latitude, negative in southern hemisphere, decimal string format Example 22.621798 Filed longitude Description Longitude, negative in western hemisphere, decimal string format Example 114.036116 Filed speed Description Unit km/h, decimal string format Example 57, means 57km/h Filed course Description Running direction, unit degree, clockwise angle, decimal string format Example 0 Filed altitude Description Altitude, unit meter, decimal string format Example 126, means 126m Filed odometer Description Unit meter, decimal string format Example 1627, means odometer 1627 m Filed runtime Description Service time, unit second, decimal string format Example 404, means 404 s Filed status Description Alarm status or vehicle status, hexadecimal string format, as the following table: bit definition description 0 GPS antenna cut Clear when antenna re-connect 1 Ext-power low voltage Clear when voltage normal 2 Ext-power lost Clear when ext-power re-connect 3--7 CSQ GSM signal strength, range [0,31] 8 Fatigue Driving Clear when fatigue relieve 9 Parking Overtime Clear when auto starts running 10 Idling Running Clear when auto starts running or ACC OFF 11-15 Reserve FIFOTRACK S50 GPRS PROTOCOL and COMMAND LIST Copyright @fifotrack 2015 All Rights Reserved 17--26 Reserve GPS HDOP, unit 0.1 27 Reserve 28—31 satellite number satellite number, range [0,12], update from GPS module data Example A012007A: Ext-power low voltage, satellite number 10, GSM signal strength 15, HDOP 0.9 Filed input-st Description state of input, hexadecimal string format: bit[0] – Reserved for future bit[1] – input2 status; bit[2]~bit[6] -- Reserved bit[7] – Vehicle battery protection for low voltage Example 02, means input2 is active Filed output-st Description state of output, hexadecimal string format: bit[0] – output1 status; bit[1]~bit[7] -- Reserved for each bit, 1- output exports high level, 0- output exports low level Example 0, means ALL output exports low level Filed MCC|MNC|LAC|CI Description Mobil base station information. ‘|’ is used to separate each data. MCC, MNC: decimal string format LAC, CI: hexadecimal string format Example 460|0|24A4|F82 : Value of MCC is 460; Value of MNC is 0; Value of LAC is 0x24A4; Value of CI is 0xF82; Filed bat-ad|ext-ad|ad1…adN Description Sample data of AD input, value range[0,0x1000], hexadecimal string format; Using “|” to separate each data; bat-ad: Sample value of internal battery voltage ext-ad: Sample value of ext-power voltage Formula (Convert hex to decimal first)- bat=(X*3.3*2)/4096, unit: V ext= (X*3.3*48)/4096, unit: V ad1 … adN: Sample value of AD1 … ADN input, for S50, one analog input supported Example A33|13C|0: Sample value of battery is 0x0A30, which corresponds to 4.20V; Sample value of ext-power is 0x013C, which corresponds to 12.22V; FIFOTRACK S50 GPRS PROTOCOL and COMMAND LIST Copyright @fifotrack 2015 All Rights Reserved Sample value of AD1 is 0x0000; Filed rfid_data Description Data of magnetic card; Tracker picks all TRACKs, and attaches here TRACK #1: Start with ‘%’, while end with ‘?’ TRACK #2: Start with ‘;’, while end with ‘?’ TRACK #3: Start with ‘+’; while end with ‘?’ There is no other character between TRACKs Example % ^SUKSAWADDEE$SAITHARN$MISS^^?;6007643100500157891=150619800909=? + 24 2 0004552 00100 ? Filed digital-sensor Description Digital sensor data, for tracker supports multiple sensors, there will be multiple data here, using “|” to separate neighboring ones. S50 doesn’t support digital temperature sensor, as a result, digital-sensor field is empty. Example Empty Field checksum Description checksum of package, 2 bytes hexadecimal string format, XOR of {<pack-len>,<ID>,<work-no>,A01,<alm-code|alm-para>,<date-time>,<fix_flag>,<l atitude>,<longitude>,<speed>,<course>,<altitude>,<odometer>,<runtime>,<statu s>,<input-st>,<output-st>,MCC|MNC|LAC|CI,bat-ad|ext-ad|ad1…adN,<rfid_data >,<digital-sensor>}. Example 62 The XOR checksum is 0x62 Field \r\n Description End of package, i.e. <CR><LF> Example \r\n
5.2 A10 – GPRS Heartbeat Data Format $$<pack-len>,<ID>,<work-no>,A10,<status>,<bat-ad|ext-ad>*<checksum>\r\n Descriptions of position/alarm data: Example: $$33,863835029419947,36,A10,2,190|46C*60\r\n Field pack-len Description decimal string format, the field of pack-len is {,<ID>,<work-no>,A10,<status>,<bat-ad|ext-ad>}, be careful, comma(,) in front of ID included. Example 33 Field ID Description Tracker ID, default IMEI, ASCII string Example 863835029419947 Field work-no Description working number, hexadecimal string format, cyclic accumulation from 1 to 0xFFFF Example 36, indicates that the value of work-no is 0x0036 Field A10 Description Data type specification, which is used to define GPRS heartbeat package format. Example Field status Description Alarm status or vehicle status, hexadecimal string format, as the following table: bit definition description 0 GPS antenna cut Clear when antenna re-connect 1 Ext-power low voltage Clear when voltage normal 2 Ext-power lost Clear when ext-power re-connect Example 2, responses to (0010)B, means Ext-power low voltage Field bat-ad|ext-ad Description Voltage of internal battery and external power, using “|” to separate each data; bat-ad: Voltage of internal battery, unit 0.01V ext-ad: Voltage of ext-power voltage, unit 0.01V Example 190|46C: Voltage of battery is 0x01A0, i.e. 4.00V Voltage of ext-power is 0x054D, i.e. 11.32V; Field checksum Description Checksum of package, 2 bytes hexadecimal string format, XOR of {<pack-len>,<ID>,<work-no>,A10,<status>,<bat-ad|ext-ad>}. FIFOTRACK S50 GPRS PROTOCOL and COMMAND LIST Copyright @fifotrack 2015 All Rights Reserved Example 60 The XOR checksum is 0x60 Field \r\n Description End of package, i.e. <CR><LF> Example \r\n FIFOTRACK S50 GPRS PROTOCOL and COMMAND LIST Copyright @fifotrack 2015 All Rights Reserved 5.3 C11 – Received-SMS Uploading Package Format $$<pack-len>,<ID>,<work-no>,C11,<datetime>,<phone-num>,<sms-content>*<checksum>\r\n Descriptions of position/alarm data: Example: $$63,863835029419947,6BD,C11,201109085404,+8615817213914,000000,C06*34\r\n Field pack-len Description decimal string format, the field of pack-len is {,<ID>,<work-no>,C11,<datetime>,<phone-num>,<sms-content>}, be careful, comma(,) in front of ID included. Example 63
|