# Commands
Commands are a way to Set/Get parameters on/from a device or get information or status of the device. There are 3 main paths to send commands to and receive a response from the device
- SMS (Needs password)
- GPRS (Server protocol)
- Bluetooth/Serial with configuration App
All commands are case sensitive. While DO107 operates in Deep Sleep mode and if you try to send SMS message it cannot receive to DO107 device, because GSM/GPRS module is disabled most of the time (wake up depends on Send Period parameter). DO107 will receive the SMS when it wakes up (exits deep sleep mode). While DO107 is in GPS Sleep or Online Deep Sleep mode and if you try to send SMS message it will receive to the device, because the GSM module is enabled.
# Command Format
if sending with SMS:
[password] Command [Parameters]
if sending from GPRS Bluetooth or Serial port through the config app:
Command [Parameters]
# Command List
| Command | Description |
|---|---|
| getinfo | Device runtime system information |
| getver | Returns code version, device IMEI, modem app version, RTC time, Init time, Uptime and BT MAC address. |
| getstatus | Modem Status information |
| getgps | Current GPS data, date and time. |
| getio | Readout analog input,digital input and output |
| ggps | Returns location information with Google maps link |
| resetgps | Restart GPS module (Hard cold start) |
| readio # | Returns IO status, # IO ID |
| cpureset | Resets device |
| getparam | Returns selected parameter value, # param ID |
| setparam #:# | Sets selected parameter value. 1. # - ID value. 2. # - New Parameter Value |
| setbaud | Set current baudrate of serial port |
| countrecs | Returns records number |
| deleterecords | Delete all records from device memory |
| setdigout # # | Set digital output 1. # – 0 or 1 (0 - OFF or 1 – ON) 2. # – timeout value if needed (in seconds) |
| battery | Returns battery state info. |
| autoupdate | Trigger auto update |
| factoryreset | Reset the system configuration to initial factory configuration. |
| resetcounters | Resets device counters such as TotalDistance |
| accreset | Calibrate accelerometer engine off mode(Stationary) |
| autocalibrate | Calibrate position of device if car start move and then break |
| accstatus | Returns accelerometer calibration status |
| odoset # | Set total odometer value. # - new odometer value in km |
| odoget | Display current odometer value |
| btfree | Free the bluetooth connection |
| defaultcfg | Load default configuration. |
| obdinfo | Displays all available information from OBD. |
| faultcodes | Display all visible fault codes. |
| clearfaultcodes | Clears all OBD fault codes |
| pgninfo | Display all active pgns whom a truck broadcasting |
| pgndata # | Returns the data of requested # PGN ID. Put space between each ones |
| getdebug | Returns debug information for support purposes |
| geterror | Return all system errors |
| setkey | Set new or change the configuration keyword |
| delkey | Deletes configuration keyword |
| ussd | Send USSD command to Mobile Operator |
| onlinelog | Sending device log to server for specific time |
| reportpos | Pick a point and sent it to server immediately |
| ecuvin | Get ECU VIN code from vehicle |
| fmslog | Sending CAN Bus FMS data to server in specific duration |
| onlinepos | Start sending online (real time) position of device to server |
| onlineposstop | Stop current onlinepos command |
# getinfo
Device runtime system information
Command:
getinfo
Response:
RTC:#1 Init:#2 Uptime:#3 RST:#4 GPS:#5 SAT:#6 NOGPS:#7 SR:#8 FG:#9 FL:#10 SMS:#11 REC:#12 MD:#13
DETAILS
| Parameter | Description |
|---|---|
| 1. RTC | Current RTC Time |
| 2. Init | Device initialization time |
| 3. UpTime | Total uptime (in seconds) |
| 4. RST | Total restarts count |
| 5. GPS | GPS receiver state. 0 – OFF, 1 – ON without fix, 2 – ON with fix, 3 – In sleep mode. |
| 6. SAT | Satellites |
| 7. NOGPS | How much time no GPS fix (in seconds) |
| 8. SR | Number of Sent Records |
| 9. FG | Failed GPRS counter |
| 10. FL | Failed link counter |
| 11. SMS | Sent SMS Counter |
| 12. REC | Records Found – number of records in the memory. |
| 13. MD | Data Mode state. 0 – Home and Stop, 1 – Home and Moving, 2 – Roaming and Stop, 3 – Roaming and Moving, 4 – Unknown and Stop, 5 – Unknown |
Example
RTC:2017/6/16 7:13 Init:2017/6/16 5:44 UpTime:4744s RST:0 GPS:1 SAT:0 NOGPS: 118 SR:0 FG:200 FL:0 SMS:3 REC:42 MD:1
# getver
Returns code version, device IMEI, modem app version, RTC time, Init time, Uptime and BT MAC address Command:
getver
Response:
Ver:#1 Hw:#2 IMEI:#3 Uptime:#4 BT:#5 ECUInterface:#6
DETAILS
| Parameter | Description |
|---|---|
| 1. Ver | Firmware version |
| 2. HW | Hardware version |
| 3. IMEI | Device IMEI |
| 4. Uptime | Total uptime (in seconds) |
| 5. BT | Device MAC address |
| 6. ECUInterface | ECU Interface (STM32) version |
# getstatus
Command:
getstatus
Response:
Data Link:#1 GPRS:#2(#3) Phone:#4 OP:#5 Signal:#6 Roaming:#7 LAC:#8 Cell ID:#9 PWR:#10
DETAILS
| Parameter | Description |
|---|---|
| 1. Data Link | Indicate module connected to the server at the moment: 0 – Not connected, 1 – connected |
| 2,3. GPRS | Indicate if GPRS is available at the moment. With showing the current IP |
| 4. Phone | Voice Call status: 0 – ready, 1 – unavailable, 2 – unknown, 3 – ringing, 4 – call in progress, 5 – asleep |
| 5. OP | Connected to GSM Operator: numerical id of operator |
| 6. Signal | GSM Signal Quality [0-31] |
| 7. Roaming | 0 – Home Network, 1 – roaming |
| 8. LAC | GSM Tower Location Area Code |
| 9. Cell ID | GSM Tower Cell ID Code |
| 10. PWR | Last restart reason: "Unknown" – unknown reasons, "PwrVoltage" – device is started after connecting voltage supply, "SoftReset" – device expected restart, ie. Cpureset or after FOTA success process, "SwWatchdog" – Modem FW issue, something is wrong with modem FW, "HwWatchdog - Teltonika FW issue, something is wrong with firmware", "Abnormal" - fatal. |
# getgps
Command:
getgps
Response:
GPS:#1 Sat:#2 Lat:#3 Long:#4 Alt:#5 Speed:#6 Dir:#7 Date:#8 Time:#9 TTFF:#10 TTLF:#11
DETAILS
| Parameter | Description |
|---|---|
| 1. GPS | Indicates valid (1) or invalid (0) Gps data |
| 2. Sat | Count of currently available satellites |
| 3. Lat | Latitude (Last good Latitude) |
| 4. Long | Longitude (Last good Longitude) |
| 5. Alt | Altitude |
| 6. Speed | Ground speed, km/h |
| 7. Dir | Ground direction, degrees |
| 8. Date | Current date |
| 9. Time | Current GMT time |
| 10. TTFF | Time To the First Fix |
| 11. TTLF | Time To the Last Fix |
Example
GPS:1 Sat:0 Lat:48.857164 Long:2.346864 Alt:0 Speed:0 Dir:0 Date: 2017/6/16 Time: 12:52:30
# getio
Command:
getio
Response:
DIN1:#1 AIN1:#2 DO1:#3
DETAILS
| Parameter | Description |
|---|---|
| 1. DIN1 | Digital input 1 value |
| 2. AIN1 | Analog input 1 value |
| 3. DO1 | Digital output 1 value |
Example
DIN1:0 AIN1:0 DO1:0
# ggps
Command:
ggps
Response:
D:#1 T:#2 S:#3 C:#4,#5
Url: #6
DETAILS
| Parameter | Description |
|---|---|
| 1. D | Date |
| 2. T | Time |
| 3. S | Actual Speed |
| 4,5. C | Latitude (Last good Latitude), Longitude (Last good Longitude) |
| 6. Url | Google Maps Link |
Example
(if GNSS NOT FIXED): “GPS Data not Available. No GPS signal”.
(if GNSS FIXED): “D:17/1/9 T:12:52:30 S:0.00 C:54.666042, 25.225032 Url: http://maps.google.com/?q=48.857164,2.346864”
# resetgps
Restart GPS module (Hard cold start) Command:
resetgps
Response:
GPS Reset successfully
# readio
Command:
readio #
DETAILS
| Parameter | Description |
|---|---|
| 1. IO Alarm ID | I/O element ID. A detailed list of parameters and identifiers can be found in IO List |
Response:
IO ID:#1 Value:#2
DETAILS
| Parameter | Description |
|---|---|
| 1. IO ID | I/O element ID |
| 2. Value | I/O Element value |
Example
(if wrong ID): “Not supported or not enabled IO element requested”.
“IO ID:239 Value:0”.
# cpureset
Resets the module. Note that there may no response for this command.
Command:
cpureset
Response:
Restarting System...
# getparam
Reads parameter value. ID consists of digits and is the Tag id of a parameter in the configuration protocol buffer. A detailed list of parameters and identifiers can be found in Config.proto file. By using space between different parameters one or more parameters can be read in one command request.
Command:
getparam #[ #...]
DETAILS
| Parameter | Description |
|---|---|
| 1. IO Alarm ID | I/O element ID. A detailed list of parameters and identifiers can be found in Config.proto file |
Example
getparam 2008 2009
Response:
Param ID:#1 Value:#2
...
[Param ID:# Value:#]
DETAILS
| Parameter | Description |
|---|---|
| 1. Param ID | Parameter ID |
| 2. Value | Value of parameter |
Example
Param ID:2008 Value:domain Param ID:2009 Value:5050
# setparam
Set the value of the parameter of the device. ID consists of digits and is the Tag id of a parameter in the configuration protocol buffer. A detailed list of parameters and identifiers can be found in Config.proto. By using semicolon between different parameters one or more parameters can be set in one command.
Command:
setparam #1:#2[;#1:#2]
DETAILS
| Parameter | Description |
|---|---|
| 1. Param ID | Parameter ID |
| 2. Value | Value of parameter |
Example
setparam 2008:example.com;2009:5050;
Response:
Set parameter OK
# setbaud
Set the current baud rate of a serial port (Needed by some special serial port expansionary sensors)
Command:
setbaud #1
DETAILS
| Parameter | Description |
|---|---|
| 1. baudrate | Possible values: 115200, 57600, 38400, 28800, 19200, 14400, 9600, 4800, 2400, 1200, 600 |
Response:
Serial port baudrate will update to #
# countrecs
Returns current records number in device memory.
Command:
countrecs
Response:
Records:#1
Example
| Parameter | Description |
|---|---|
| 1. Records | Count of records in device memory. |
# deleterecords
Delete all records from device memory.
Command:
deleterecords
Response:
All records removed from device memory
# setdigout
Sets a digital output to ON or OFF state (timeout for output is controllable)
Command:
setdigout #1[ #2]
DETAILS
| Parameter | Description |
|---|---|
| #1 Output | 0: Low 1: High |
| #2 Time of state | The duration of the time (in second) being placed in the output. If the value is given, it returns to the previous state after the specified duration. Otherwise the statement remains stable. |
Example
‘setdigout 1 60’ will set digital output 1 to high level for 60 seconds,
‘setdigout 1’ will set digital output 1 to high level for infinite time.
Response:
Digital output set to #1 for #2 seconds
DETAILS
| Parameter | Description |
|---|---|
| #1 | New state of digital output (ON or OFF) |
| #2 | Duration of new state |
# battery
Returns battery and external voltage state info.
Command:
battery
Response:
BatV:#1 ExtV Present:#2
DETAILS
| Parameter | Description |
|---|---|
| #1. BatV | Battery voltage |
| #2. ExtV | External voltage indication. 0. External voltage not present 1. External voltage presents |
# autoupdate
if Auto Firmware Update configurations sets in config trigger the AutoUpdate manually
Command:
autoupdate
Response:
Success
Firmware AutoUpdate requested. Server: ServerAddress:Port
Fail if not configured
Firmware Autoupdate not configured
# factoryreset
Resets all configuration parameters to factory configuration. please note ACC calibration data, fault codes memory, pending firmware data, sms memory, and ssl certifications are also affected by this command. after execution, the system restarting.
Command:
factoryreset
Response:
System restored to factory settings. Restarting...
# resetcounters
Resets device counters such as GPRS_TotalBytesSent, EngineOnTime and ...
Command:
resetcounters
Response:
System counters restarted
# accreset
Calibrate accelerometer engine off mode(Stationary). This state is required for dynamic calibration of the device
Command:
accreset
Response:
Static calibration OK.
# autocalibrate
Calibrating device installation position. For calibrating there is 2 way. You can send this command to the device and then move the vehicle to the front for some meters and then push on the brake. Also, you can send the position state based on pictures available in Dolphin support team
Command:
autocalibrate [#1]
#1: Mode: Can be set based on device installation position
Response:
Success
Dynamic calibration finished. Mode: %d
Fail
Static calibration not found. Dynamic calibration failed
Fail If mode presents
Dynamic calibration failed. Wrong mode.
# accstatus
Returns accelerometer calibration status
Command:
accstatus
Response:
Static calibration: [Calibrate/Not Calibrated]
Dynamic calibration: [Calibrated. Mode: N/Not Calibrated]
# odoset
Set new total odometer value in km.
Command:
odoset #1
DETAILS
| Parameter | Description |
|---|---|
| #1. odometer | Odometer value in kilometer |
Response:
Saved Odometer Value: #1 km
# odoget
Get total odometer value in km.
Command:
odoget
Response:
Current Odometer Value: #Km
# btfree
Free bluetooth connection and unpair all paired devices.
Command:
btfree
Response:
Bluetooth freed
# defaultcfg
Set the configuration to its default values.
Command:
defaultcfg
Response:
Configuration set to default
# obdinfo
shows OBD Interface and Supported PIDs
Command:
obdinfo
Response:
OBD Interface: #
Supported Pids:
Pid 0x00 = #
Pid 0x20 = #
Pid 0x40 = #
Pid 0x60 = #
# faultcodes
Returns list of fault codes
Command:
faultcodes
Response:
If there is faults: OBD Fault Coodes
else: Has no faults!
# clearfaultcodes
Cleares OBD fault codes.
Command:
clearfaultcodes
Response:
Success
Clear fault codes OK.
Fail
Clear fault codes error. ECU not connected or engine is off
Fail if not supported
If not supported: Clear fault codes not supported
# pgninfo
Returns list of active pgns Whom a truck sent. This command is valid when the truck is on.
Command:
pgninfo
Response:
Success If there is PGN
PGN List(#1): #2
There is no PNG or engine is off
No PGN data available
DETAILS
| Parameter | Description |
|---|---|
| 1. Count | Total pgn counts that a truck broadcasting |
| 2. Pgn ID | The actual pgn id |
# pgndata
Returns the value of pgns provided. Put space between each pgn. if wouldn't provided any pgn, it returns the value of all pgns the target truck supported. The truck must be on.
Command:
pgndata
Response:
Success If the pgn has value:
#1: #2
else:
No PGN data available
DETAILS
| Parameter | Description |
|---|---|
| 1. Pgn ID | The requested Pgn Id |
| 2. value | The value of requested pgn |
# getdebug
Command:
getdebug
# geterror
Command:
geterror
# setkey
Set new or change the configuration keyword Command:
setkey #1 #2
DETAILS
| Parameter | Description |
|---|---|
| 1. oldkeyword | Old configuration keyword. if not provided type nothing |
| 2. new | New configuration keyword. if want to delete keyword type nothing |
Response:
Success
New key is set successfully
Wrong key
Old key is wrong
Wrong parameters
setkey wrong parameters
# delkey
Deletes current configuration keyword Command:
delkey #1
DETAILS
| Parameter | Description |
|---|---|
| 1. oldkeyword | Old configuration keyword |
Response:
Success
Key removed successfully
WARNING
Old key is wrong
# ussd
Command:
ussd #1
DETAILS
| Parameter | Description |
|---|---|
| 1. USSD code | USSD messages that need to be sent to the operator. Sample: 5552*1# |
WARNING
USSD Code must be a complete message
Response:
Success
USSD Response: #
Fail
"Failed to request USSD" or "Network not connected. USSD failed"
# onlinelog
Start saving system log for a specific time and level and then send log data to the server
Command:
onlinelog #L #T
DETAILS
| Parameter | Description |
|---|---|
| #L. Log Level | Log level one of characters "d i w e f r" d: Debug i: info w: warning e: error f :fatal r: Real time log that will sent to server continiusely on availabale connection |
| #T. Duration | Duration of logging in seconds |
Response:
Success
Online log started. Level: #L, Time: #Ts
Fail
Failed to start OnlineLog
Fail with bad parameters
Invalid log parameters
# reportpos
This command will use when you need your device to connect to the server and send its data to the server immediately
Command:
reportpos
Response:
Success
Time: #/#/# #:#"
Location: #Latitude,#Longitude Speed:#"
Online position reported
Fail
GPS Data not Available. No GPS signal!
# ecuvin
If the device connected through OBD or FMS to the vehicle it will report ECU VIN code
Command:
ecuvin
Response:
Success
ECU VIN: #
Fail
There is no VIN in FMS!
# fmslog
After sending this command to device it starts sending FMS log data to server by FMSOnlineDataPack message
Command:
fmslog #1
DETAILS
| Parameter | Description |
|---|---|
| 1. Duration | Duration of log sending to server. Min: 0 Max: 60 |
Response:
Success
FMS online log started successfully
Fail
Invalid number of parameters for start FMS online log!!
Fail
Duration must between 0 and 60 second
# onlinepos
Start sending online position (real time) of device to the server in duration provided by command parameter
Command:
onlinepos #1 #2
DETAILS
| Parameter | Description |
|---|---|
| 1. Duration | Duration of sending data to server in seconds. Min: 1 Max: 900 |
| 1. Period | Time between each point data in seconds. Min: 1 Max: Duration |
Response:
Success
Online position started successfully
Fail
Invalid number of parameters for start online position!!
Fail
Invalid duration and period for online position!!
# onlineposstop
Stop current onlinepos command
Command:
onlineposstop
Response:
Success
Online position stopped successfully