Daviscomms MTD2000, Command Manual

Page 1: ...MTD2000 AT Command Guide R12 Confidential DAVISCOMMS S PTE LTD 1 105 AT Command Guide Mobile Tracking Device MTD2000 Revision 12 1 Jun 2010...

Page 2: ...power and battery power 10 Removed NA as heartbeat message is not ready 11 Removed PI as debouncing is done via hardware mean 12 Removed PO as OUT will serve the same purpose 04 08 May 09 CF Chan 1 Re...

Page 3: ...120 characters 11 17 May 10 CF Chan 1 Added GF and GS for geo fence 2 Added AI and AO for analog input and output 3 Added FSD and FSO for fail safe output 4 Added MD for motion sensor sensitivity 5 A...

Page 4: ...face 15 5 System Code 16 5 1 MTD System Code 16 5 2 GSM System Code 16 5 3 GPS System Code 17 6 LED Indication 18 6 1 Charging LED 18 6 2 GSM LED 18 6 3 GPS LED 18 7 Basic Command 19 7 1 Command Mode...

Page 5: ...ion AT OS 61 16 2 Harsh Acceleration AT ACC 62 16 3 Harsh Deceleration AT DEC 62 16 4 Mileage Setting AT MS 63 16 5 Mileage Counter AT MC 64 17 Dead Reckoning 66 17 1 Gyro Calibration AT GC 66 17 2 De...

Page 6: ...ery Shutdown 96 25 5 Watchdog Timer 97 25 6 Firmware Upgrade 97 25 7 Test Mode 97 26 Appendix 98 26 1 NMEA Messages 98 26 1 1 GLL Geographic Position Latitude Longitude 98 26 1 2 GGA Global Positionin...

Page 7: ...S PTE LTD 7 105 1 Introduction This document defines the AT commands used for interfacing between a host application and the MTD2000 The MTD2000 comes with a built in event driven engine which allow...

Page 8: ...programmable UDP IP addresses 10 programmable GPRS profiles 10 programmable timers 10 programmable counters 20 geographical fences 20 text messages 20 user defined events 3 Message and Report User de...

Page 9: ...MS and TCP UDP channel 9 Firmware Upgrade Firmware upgrade via serial port Over the air firmware upgrade 10 General Driver ID Panic button Key on reset Dead reckoning Motion detection with programmabl...

Page 10: ...Confidential DAVISCOMMS S PTE LTD 10 105 3 System Overview 3 1 End User Based Reporting SMS The device can be configured to send reports or text messages in SMS to mobile phones as illustrated below G...

Page 11: ...reports in SMS to the server with GSM Modem as illustrated below 3 3 Server Based Reporting TCP UDP Socket The device can be configured to send reports via TCP Socket to the server as illustrated bel...

Page 12: ...t of entry Note 2 The native GSM GPRS AT commands command with prefix AT and AT will be routed to the GSM module for handling and the corresponding response will be sent back to the host via serial po...

Page 13: ...ed to the command that holds only one element e g AT PC port configuration The following query command is used to query the current setting of a single index AT command Command Response AT ABC OK ABC...

Page 14: ...and Command Response AT ABC OK Other responses if any 4 5 Command Response 4 5 1 Normal Response For any command sent to the device it will respond with either OK or ERROR If there is no syntax error...

Page 15: ...ponse will be terminated by carriage return and line feed CR LF if the channel is serial port or TCP channel no carriage return and line feed for SMS channel For example if the user is trying to estab...

Page 16: ...r no battery connected 2106 Resume battery charging when low external voltage goes up Input Output 2201 Invalid input port 2202 Invalid output port Send Report 2301 Network channel is not established...

Page 17: ...5203 TCP UDP channel disconnected by remote via SMS or TCP UDP channel 5204 TCP UDP channel disconnected by local via serial port or event 5 3 GPS System Code 6001 GPS is in sleep mode 6002 GPS is no...

Page 18: ...6 2 GSM LED GSM status is indicated by a green LED as follows 1 Green LED Blinking Fast Blink 600 ms on 600ms off No SIM card inserted or network search in progress Slow Blink 75 ms on 3 s off Registe...

Page 19: ...rial port to check the corresponding communication link OK Note Send to serial port AT Note Send this command via SMS and check the corresponding communication link OK Note Send to SMS number AT Note...

Page 20: ...MTD2000 AT Command Guide R12 Confidential DAVISCOMMS S PTE LTD 20 105 Parameters Nil Example Command Response AT SV Note Query firmware version OK SV R0100 A Note Repeat last command OK SV R0100...

Page 21: ...or version YY is the minor version Example Command Response AT SV Note Query the firmware version OK SV R0100 Note Firmware version is 1 00 8 2 System Identity AT SI This command will set and control...

Page 22: ...D is 0123456789 Example Command Response AT SI 1 ABC1234D Note Set and enable device ID OK AT SI Note Query device ID OK SI 1 ABC1234D ABC1234D AT SV Note Query the firmware version with device ID OK...

Page 23: ...l retrieve and send the device settings all at one go via the command channel This command is not accessible via SMS due to large amount of data Note If the user is trying to retrieve device settings...

Page 24: ...ve device settings OK SV R0100 SI 0 ABC1234D EV 20 NC 0 8 5 System Reset AT ST This command will reset the system or GSM GPS module Syntax Command Response AT ST Mode Note Write setting OK Parameters...

Page 25: ...AT SS Module Note Query setting OK SS Module Mode Parameters Module 0 GSM 1 GPS Mode 0 Awake 1 Sleep Default is 0 Awake Example Command Response AT SS 0 1 Note Place GSM module into sleep mode OK AT...

Page 26: ...response to indicate invalid FTP user password 7 If the device cannot connect to the GPRS gateway via the GPRS profile the device will send out an unsolicited response to indicate invalid GPRS profile...

Page 27: ...This command will place the device into boot mode which is used by Downloader for firmware upgrade via serial port After power is cycled or device is reset the device will remain in boot mode until it...

Page 28: ...ters Mode 0 Disable error and status indication 1 Enable error and status indication Default is 1 enable error and status indication Recipient Send error and status indication to single or multiple re...

Page 29: ...via the programmed call numbers Syntax Command Response AT SL Index SMS Number Note Write setting OK AT SL Index Note Query one setting OK SL Index SMS Number AT SL Note Query all settings not access...

Page 30: ...MTD2000 AT Command Guide R12 Confidential DAVISCOMMS S PTE LTD 30 105...

Page 31: ...1 IP Address Port NT 10 IP Address Port Parameters Index TCP server address 1 to 10 IP Address TCP server IP address in host name or dotted decimal notation maximum 60 characters A hostname may conta...

Page 32: ...te Write setting OK AT NU Index Note Query one setting OK NU Index IP Address Port AT NU Note Query all settings not accessible via SMS OK NU 1 IP Address Port NU 10 IP Address Port Parameters Index U...

Page 33: ...20 2000 NU 2 www yahoo com 80 NU 10 10 3 GPRS Profile List AT NG This command allows user to store maximum 10 GPRS profiles in the device Syntax Command Response AT NG Index APN User Password Note Wri...

Page 34: ...the following characters list 0 9 a z A Z Default is blank Example Command Response AT NG 1 internet 1234 abcd Note Store a GPRS profile OK AT NG 1 Note Query a GPRS profile OK NG 1 internet 1234 abcd...

Page 35: ...0 0 0 this setting will be ignored Otherwise this value can be used to manually configure an alternate server for the DNS1 If DNS1 is not equal 0 0 0 0 and no DNS2 address is given then DNS2 0 0 0 0...

Page 36: ...event table will be set After connected to network The online flag will remain set if GSM network is down The online flag will be cleared if remote server is down Syntax Command Response AT NC Mode Ch...

Page 37: ...Confidential DAVISCOMMS S PTE LTD 37 105 AT NC 1 0 1 1 Note Connect to the TCP server OK AT NC Note Query connection status OK NC 1 0 1 1 AT NC 0 Note Disconnect from the TCP server OK AT NC Note Que...

Page 38: ...w The device will send out an unsolicited response if the TCP UDP connection is not successful For example MTD 5201 Connect to GPRS GPRS Connected Error No Yes Yes No Connect to TCP UDP Server GSM Reg...

Page 39: ...y one setting OK TL Index Message AT TL Note Query all settings not accessible via SMS OK TL 1 Message TL 20 Message Parameters Index Text message 1 to 20 Message Text message of up to 40 alphanumeric...

Page 40: ...l send out an unsolicited response to indicate undefined SMS number Syntax Command Response AT TM Index Recipient Note Execute command OK Parameters Index Text message 1 to 20 Recipient Send a text me...

Page 41: ...MTD2000 AT Command Guide R12 Confidential DAVISCOMMS S PTE LTD 41 105 and SMS number 1 AT TM 1 N M003 Note Send a text message via network channel SMS number 1 and 2 OK Car Alarm...

Page 42: ...not operational the device will send out an unsolicited response to indicate GPS not operational 4 If the user is trying to send standard report via inactive network channel the device will send out...

Page 43: ...ingle SMS number in decimal 1 to 10 Mulitple SMS numbers in hexadecimal 001 to 3FF Bit presentation for multiple SMS numbers Bit 9 8 7 6 5 4 3 2 1 0 SMS 10 9 8 7 6 5 4 3 2 1 Interval Interval between...

Page 44: ...AT Command Guide R12 Confidential DAVISCOMMS S PTE LTD 44 105 AT SR Location N M003 300 100 Note Send 100 reports with interval 5 min via network channel SMS number 1 and 2 OK Standard Report Standard...

Page 45: ...us V v 0 invalid location data 1 valid location data Date D ddmmyy dd day mm month yy year Time T hhmmss hh hour mm minute ss second Location Latitude Longtitude L Aaa bbbbbb Brrr hhhhhh Aaa bbbbbb A...

Page 46: ...1 Valid GPS data SR Location V1D061208T143500L 01 225296 103 521991S067 231H403 412W0FP03 Example 2 No valid GPS data use last valid position SR Location V0D061208T143500L 01 225296 103 521991S067 23...

Page 47: ...ill send out an unsolicited response to indicate GPS not operational 4 If the user is trying to send NMEA report via inactive network channel the device will send out an unsolicited response to indica...

Page 48: ...er Channel 1 to 65000 sec Cycle Number of reports to be sent 1 to 65000 reports 0 is non stop sending Example Command Response AT NR 0 U Note Send one report via serial port OK NMEA Report AT NR 0 N S...

Page 49: ...If the user is trying to send Cell ID report to a SMS number which is not defined the device will send out an unsolicited response to indicate undefined SMS number 6 If any field in the cell ID infor...

Page 50: ...port Cell ID Report AT CR U Note Send one report via serial port while GSM is in sleep mode OK CR Note Send only the report type in sleep mode Cell ID Report Format Syntax CR Serving Cell Neighbor Cel...

Page 51: ...DAVISCOMMS S PTE LTD 51 105 Example 1 Information of all cells available CR 0103 50 0104 84 0105 90 0106 91 0107 96 0108 96 0109 100 1 Example 2 Information of last two neighbor cells not available CR...

Page 52: ...mand Response AT DB Memory Note Write setting OK AT DB Note Query setting DB Memory Parameters Memory 0 Data memory of 5000 reports 1 Data memory of 300 reports Default is 1 300 reports Example Comman...

Page 53: ...reports will be cleared from the memory 4 At the end of the data dump it will send out another unsolicited response to indicate data dump completed 5 If the connection between the remote host and the...

Page 54: ...Confidential DAVISCOMMS S PTE LTD 54 105 This command will clear the logged data in the device memory Syntax Command Response AT DC Note Execute command OK Parameters Nil Example Command Response AT D...

Page 55: ...ng call in progress will not trigger the event but end the call 2 If the panic button is pressed while normal call is being established or in the midst of active normal call the device will end the ca...

Page 56: ...uto answer is disabled the device will reject incoming call Note If the incoming call number is not in the SMS number list the device will send out an unsolicited response to indicate undefined SMS nu...

Page 57: ...hich higher volume will be set for external speaker 4 The device will assume external speaker is used when external MIC is detected If external MIC is inserted the device will switch to external MIC a...

Page 58: ...nse AT GF Index Mode Latitude Longitude Radius Note Write setting OK AT GF Index Note Query one setting OK GF Index Mode Latitude Longitude Radius AT GF Note Query all settings not accessible via SMS...

Page 59: ...89 121432 103 242351 0 1 AT GF Note Query setting of geo fences OK GF 1 1 89 121432 103 242351 0 1 GF 20 0 0 0 15 2 Geo Fence Status AT GS This command allows user to query the current status of all g...

Page 60: ...tial DAVISCOMMS S PTE LTD 60 105 Bit 19 18 17 2 1 0 Geo Fence 20 19 18 3 2 1 Example Command Response AT GS Note Query status of all geo fences OK GS 00001 Note Enter geo fence 1 exit the rest of geo...

Page 61: ...ERROR if user sets the high speed threshold equal or less than the normal speed threshold Syntax Command Response AT OS Mode High Speed Normal Speed Note Write setting OK AT OS Note Query setting OK...

Page 62: ...Change Duration Parameters Mode 0 Disable 1 Enable Default is 0 Disable Speed Change Sudden increase in speed in km h 10 to 40 km h caused by harsh accelerating Default is 20 km h Duration Duration i...

Page 63: ...e place 1 to 5 sec Default is 3 sec Example Command Response AT DEC 1 12 3 Note Set speed change threshold OK AT DEC Note Query current setting OK DEC 1 12 3 16 4 Mileage Setting AT MS This command al...

Page 64: ...equivalent to 1 km 100 to 5000 pulses Default is 100 pulses Example Command Response AT MS 1 10 200 Note Set odometer reading OK AT MS Note Query odometer setting MS 1 10 200 16 5 Mileage Counter AT M...

Page 65: ...Threshold Current Parameters Mode 0 Disable 1 Enable Default is 0 Disable Threshold Odometer threshold in km 1 to 800 000 km Default is 1 km Current Current odometer reading in km 0 to 800 000 km Exa...

Page 66: ...result Note 1 When the reset button is long pressed for 3 seconds the device will enter calibration mode and send out an unsolicited response to indicate calibration entry 2 Once the gyro is calibrate...

Page 67: ...thout dead reckoning it will send out unsolicited response to indicate dead reckoning not supported Syntax Command Response AT GA or AT GA Note Query setting OK GA Speed Gyro Parameters Speed Speed ti...

Page 68: ...figured in factory 2 Port 4 is typically used to connect to the ignition switch as it comes with a key on reset feature which allows the hardware reset button to take effect only if ignition is switch...

Page 69: ...n output is set to HIGH activate output In this case set the output to LOW will deactivate the output 2 If the output port is used as current sink the current direction is from load to the device when...

Page 70: ...PD Note Query default value of output ports OK PD 30 18 3 Port Status AT PS This command will return the current value of both input and output ports Syntax Command Response AT PS or AT PS Note Query...

Page 71: ...nsolicited response to indicate invalid input port Syntax Command Response AT IN Index Note Get input port status OK IN Index Status Parameters Index Port 1 to 8 only input ports are effective port 1...

Page 72: ...t In this case set the output to HIGH will deactivate the output 3 If the user is trying to set an input port the device will send out an unsolicited response to indicate invalid output port Syntax Co...

Page 73: ...the ADC channel For the conversion from digital value to actual voltage refer to ADC Conversion Formula below The factor value for external power level is 31 For example the voltage of 12 V is corres...

Page 74: ...ommand allows user to set the analog output maximum capped at the external power level Syntax Command Response AT AO Value Note Write setting OK AT AO Note Query setting AO Value Parameters Value Anal...

Page 75: ...et to LOW activate output In this case set the output to HIGH will deactivate the output 2 If the fail safe output port is used as current sink the current direction is from load to the device when ou...

Page 76: ...his case set the output to LOW will deactivate output 2 If the fail safe output port is used as current sink the current direction is from load to the device when output is set to LOW In this case set...

Page 77: ...ice will return 0000000000000000 after 5 sec when no driver ID Tag is connected 2 The device will return FFFFFFFFFFFFFFFF after 5 sec when there is error in reading the driver ID Tag Syntax Command Re...

Page 78: ...te Query setting SIM Mode Parameters Mode 0 Auto switch to another SIM when roaming take place or current network connection is down GSM GPRS down or TCP UDP connection down 1 Select SIM1 for GSM regi...

Page 79: ...reset feature Once this feature is turned on the hardware reset button will take effect only when the digital input port 4 is set to HIGH normally connected to ignition switch Syntax Command Response...

Page 80: ...threshold the device will send out an unsolicited response to indicate resume battery charging Syntax Command Response AT BC Mode Threshold Note Write setting OK AT BC Note Query setting OK AT BC Mod...

Page 81: ...ote 1 When the reset button is long pressed for 3 seconds the device will enter calibration mode and send out an unsolicited response to indicate calibration entry 2 Once the motion detect is calibrat...

Page 82: ...the motion Sensor ranged from 7 to 255 Default sensitivity is 200 Note Range 0 to 6 is too sensitive for MTD application on vehicle and is disabled To turn off Motion Detection set sensitivity value t...

Page 83: ...P channel the device will return ERROR Syntax Command Response AT GM Note Write setting OK Parameters Nil Example Command Response AT GM Note Set the device as GSM modem OK 21 9 UART Control AT UM Thi...

Page 84: ...idential DAVISCOMMS S PTE LTD 84 105 Example Command Response AT UM 0 Note Disable RS232 interface OK UM Note Query RS232 interface status via SMS or TCP UDP channel OK UM 0 UM 1 Note Enable RS232 int...

Page 85: ...efore connecting to the ADC channel For the conversion from digital value to actual voltage refer to ADC Conversion Formula below The factor value for external power level is 29 For example the voltag...

Page 86: ...2 Battery Power Status AT XB This command allows user to set maximum 5 battery power thresholds for monitoring which is in term of digital value When the battery power level is equal or higher than th...

Page 87: ...dex Battery power status 1 to 5 Mode 0 Disable 1 Enable Default is 0 Disable Threshold Battery power threshold in digital value 0 to 1023 units Default is 0 units Current Current battery power level i...

Page 88: ...the user specified interval 3 When timer is disabled reset the timer will set the current tick to 0 4 When timer is enabled reset the timer will set the current tick to 0 and then start running again...

Page 89: ...nce timer Current Current timer tick in second Example Command Response AT FT 1 1 10 0 Note Start timer 1 of interval 10 seconds OK AT FT 1 Note Query timer 1 setting and current tick OK FT 1 1 10 0 3...

Page 90: ...rement decrement if the counter is disabled 5 The current counter value is saved and will not be reset when the power of the device is cycled 6 Note that excessive use of counter e g frequent incremen...

Page 91: ...Current Current counter value Example Command Response AT FC 1 1 10 Note Start counter 1 of user defined counter value 10 OK AT FC 1 3 Note Increment counter 1 OK AT FC 1 Note Query counter 1 setting...

Page 92: ...S external antenna Online Flag N1 1 network connected 0 network disconnected Geo Fence Z1 to Z20 1 enter zone 0 exit zone Digital Input P1 to P8 1 high 0 low External Power E1 to E5 1 preset threshold...

Page 93: ...separator 3 The event will be triggered when the condition changes state and become true again 4 The events will be saved in the flash and will execute after power is cycled or reset 5 The event will...

Page 94: ...to example 2 for event with OR condition OK AT EV 1 Note Query an event OK AT EV 1 1 0 P1 1 P3 1 SR Alarm S1 NR 0 N AT EV Note Query setting of all events OK AT EV 1 1 0 P1 1 P3 1 SR Alarm S1 NR 0 N...

Page 95: ...MTD2000 AT Command Guide R12 Confidential DAVISCOMMS S PTE LTD 95 105 Condition External OR Battery power level drops below preset threshold Event AT EV 2 1 1 E1 0 B1 0 OUT 1 1 TM 1 S1...

Page 96: ...ther SIM when roaming take places 25 2 GPS Monitoring The firmware will monitor the GPS module every 10 seconds to check if the GPS module is alive It will reset the GPS module and clear the GPS opera...

Page 97: ...6 Firmware Upgrade The firmware of the device can be upgraded over the air using the SU command or via the serial port using the Downloader on PC 25 7 Test Mode The device provides a test mode for pe...

Page 98: ...S Either character N or character S N North S South yyymm dddd Longitude yyy degrees mm minutes dddd decimal part of minutes E W Either character E or character W E East W West hhmmss dd UTC time hh...

Page 99: ...dddd decimal part of minutes E W Either character E or character W E East W West V Fix valid indicator 0 Fix not valid 1 Fix valid Ss Number of satellites used in position fix 00 12 Fixed length d d H...

Page 100: ...hat there can be also theoretical satellites in the GSV message These are satellites of which the angles elevation azimuth are known but for some reasons e g due to an obstruction have not been found...

Page 101: ...ode indicator A autonomous GNSS fix D differential GNSS fix E estimated dead reckoning fix N no fix Example GPVTG 202 60 T 0 38 N 0 7 K A 0D 26 1 6 RMC Recommended Minimum Specific GNSS Data It is to...

Page 102: ...it is updated even when navigation fix is unavailable The RTC time is maintained also while the module is in sleep mode Note The time output in ZDA message slightly differs from the time output by ot...

Page 103: ...OMMS S PTE LTD 103 105 xx Local zone hours Not implemented output always 00 yy Local zone minutes Not implemented output always 00 Example The following message corresponds to UTC time 06 17 24 46 on...

Page 104: ...D set the server IP address and Port AT NT 1 192 168 123 120 1000 2 In MTD set GPRS Profile AT NG 1 internet 3 In MTD start TCP connection AT NC 1 0 1 1 26 2 2 Disconnecting TCP Server from MTD Steps...

Page 105: ...D set the server IP address and Port AT NT 1 192 168 123 120 1000 2 In MTD set GPRS Profile AT NG 1 internet 3 In MTD start UDP connection AT NC 1 1 1 1 26 3 2 Disconnecting UDP Server from MTD Steps...