SMS Commands
Commands Format
All commands sent not from the owner number, must start with a password.
- The commands must be typed in Latin characters (case-insensitive)
- Command parameters must be listed separated by space
- Only one command must be send in one message
- All system commands must start with a password
- Primary terminal setting must start with the owner telephone setup with the use of Omnicomm Configurator or SMS
Command format:
| Command head | Password | Command | Command parameters | Command end |
|---|---|---|---|---|
| * | not-mandatory field | mandatory field | not-mandatory field | # |
Command example: *3245 channel sms#
| Command head | Password | Command | Command parameters | Command end |
|---|---|---|---|---|
| * | 3245 | channel | sms | # |
System Commands
Owner telephone number change
To setup or change the owner telephone number, the password will be required. Default password: 0000. The response is sent to the number which the command had been sent from.
| Command text in SMS | Comments | Example |
|---|---|---|
| *pass tel +yyyyyyyyyy# | pass — password +yyyyyyyyyy is the new number (international format, 20 characters maximum) | *1234 tel +79099091122# |
| Response to command | Comments |
|---|---|
| tel changed | telephone number was changed |
| Potential Errors | Comments |
| tel. Wrong pass | Wrong password |
| tel. Wrong number. Start from '+',⇐20digits | invalid number format |
Changing Password
Password can be changed only from the owner telephone.
| Command text in SMS | Comments | Example |
|---|---|---|
| *pass xxxx# | xxxx — new password. Max 8 characters (Latin letters, numbers). Password is case-insensitive. Default value – 0000 | *pass 12345# |
| Response to command | Comments |
|---|---|
| pass changed | password was changed |
| Potential Errors | Comments |
| pass. Wrong owner number | invalid owner number |
| pass. Wrong pass. Only digits,⇐8digits | invalid password format |
Changing Device Name
| Command text in SMS | Comments | Example |
|---|---|---|
| * **** name NAME DEVICE# | **** – password DEVICE NAME – device name up to 20 characters no spaces (Latin letters, digits, symbols) | *1234 name SuperOBD_22# |
| Response to command | Comments |
|---|---|
| name changed | device name was changed |
| Potential Errors | Comments |
| name. Wrong pass | Wrong password |
| name. Wrong name. Only ASCII,⇐20 symbols | invalid name format |
Setting Date and Time
| Command text in SMS | Comments | Example |
|---|---|---|
| * **** time DD-MM-YYYY HH:mm# | DD-MM-YYYY HH:mm – day / month / year / hours / minutes | *1234 time 21-07-2018 12:50# |
| Response to command | Comments |
|---|---|
| time changed to DD-MM-YYYY HH:mm | date and time were changed |
| Potential Errors | Comments |
| time. Wrong pass | Wrong password |
| time. Wrong args | invalid date and time format |
Enabling/Disabling SMS Notifications
| Command text in SMS | Comments | Example |
|---|---|---|
| * **** SMS on# * **** SMS off# | on — enabled off — disabled | *1234 SMS on# |
| Response to command | Comments |
|---|---|
| SMS on SMS off | on — enabled off — disabled |
| Potential Errors | Comments |
| SMS. Wrong pass | Wrong password |
| SMS. Wrong args | invalid command format |
Configuring Network
| Command text in SMS | Comments | Example |
|---|---|---|
| * **** net APN login password# | depends on mobile operator login, password are optional | *1234 net internet.mts.ru mts mts#, *1234 net internet.mts.ru# |
| Response to command | Comments |
|---|---|
| APN changed to ХХХ | ХХХ – set APN |
| Potential Errors | Comments |
| net. Wrong pass | Wrong password |
| net. Wrong args | invalid command format |
Configuring CS
| Command text in SMS | Comments | Example |
|---|---|---|
| * **** server CS address port protocol# | default values: cs.omnicomm.ru 9977 Omnicomm | *1234 cs.omnicomm.ru 9977 Omnicomm# |
| Response to command | Comments |
|---|---|
| server changed to CS address: port, protocol | settings were changed |
| Potential Errors | Comments |
| server. Wrong pass | Wrong password |
| server. Wrong args | invalid command format |
Terminal Reboot
| Command text in SMS | Comments | Example |
|---|---|---|
| * **** restart# | terminal reboot | *1234 restart# |
| Response to command | Comments |
|---|---|
| restart ОК | terminal was restarted |
| Potential Errors | Comments |
| restart. Wrong pass | Wrong password |
Connecting to the Remote Configuration Server
| Command text in SMS | Comments | Example |
|---|---|---|
| * **** update# | connecting to the RCS | *1234 update# |
| Response to command | Comments |
|---|---|
| update started | |
| Potential Errors | Comments |
| update. Wrong pass | Wrong password |
Resetting to Defaults
| Command text in SMS | Comments | Example |
|---|---|---|
| * **** default settings# | *1234 default settings# |
| Response to command | Comments |
|---|---|
| reset settings ОК | reset to default settings is completed |
| Potential Errors | Comments |
| reset settings. Wrong pass | Wrong password |
Settings
Setting the Data Sending Interval
| Command text in SMS | Comments | Example |
|---|---|---|
| *period XXXX YYYYZ# | XXXX — sending interval for data within the home network, min. Default value: 10. YYYY – sending interval for data in roaming 0 – sending is not performed. Z: min – sending data in roaming (by time), k – sending data in roaming (by package size). Default values: ХХХХ – 10 min, YYYYmin – 0 min | *period 100 150k#, *period 50 150min#, *period 1000 0# |
| Response to command | Comments |
|---|---|
| period changed to XXXX YYYY min period changed to XXXX YYYY kb period changed to XXXX. Roaming disabled | XXXX – data sending interval in the home network, min; YYYY – data sending interval in roaming, min XXXX – data sending interval in the home network, min; YYYY – data package size to be sent in roaming, kB XXXX – data sending interval in the home network, min; roaming disabled |
| Potential Errors | Comments |
| period. Wrong pass | Wrong password |
| period. Wrong args | invalid command format |
Setting the Data Collection Interval
| Command text in SMS | Comments | Example |
|---|---|---|
| *interval XXXX# | XXXX – data collection, sec 0 – collection/sending blocking (timer value remains unchanged). Possible values: from 15 to 240 sec | *interval 100# |
| Response to command | Comments |
|---|---|
| interval changed to XXХ interval. Block enabled | XXX – data collection interval, sec blocking is enabled |
| Potential Errors | Comments |
| interval. Wrong pass | Wrong password |
| interval. Wrong args | invalid command format |
Setting Fuel Tank Volume
| Command text in SMS | Comments | Example |
|---|---|---|
| *volume XXX# | XXX – tank volume, l. Possible options: from 0 to 65000 | *volume 100# |
| Response to command | Comments |
|---|---|
| volume changed to XXХ | XXX – tank volume, l |
| Potential Errors | Comments |
| volume. Wrong pass | Wrong password |
| volume. Wrong args | invalid command format |
Selecting OBD Parameters Sent
The parameter selection command starts with 'obd' and then list parameters, values of which must be sent in SMS.
The current fuel volume is calculated at the terminal based on the data acquired via the OBD bus, and the set tank volume.
| Command text in SMS | Comments | Example |
|---|---|---|
| *obd speed voltage rpm fuel rate temp key engine# | speed – speed voltage – voltage of the on-board power supply rpm – engine RPM fuel – volume of fuel in the tank (l) rate – fuel consumption rate temp – oil temperature key – ignition engine – error indications Check Engine off – disable sending of all parameters | *obd speed fuel# and *obd off# |
| Response to command | Comments |
|---|---|
| obd. speed on, fuel on obd. Disable all | only those parameters are listed, data of which will be sent data Data of all parameters are parameters |
| Potential Errors | Comments |
|---|---|
| obd. Wrong pass | Wrong password |
Enabling / Disabling Message Sending when Removing the OBD Terminal
| Command text in SMS | Comments | Example |
|---|---|---|
| *remove on# *remove off# | on — enabled off — disabled | *remove on#, *remove off# |
| Response to command | Comments |
|---|---|
| remove on remove off | on — enabled off — disabled |
| Potential Errors | Comments |
| remove. Wrong pass | Wrong password |
| remove. Wrong args | invalid command format |
Enabling Automatic Message Sending in Case of a Vehicle Position Change
Autotilt — enables tilt mode 2 minutes after ignition off without an SMS sent. Disables tilt upon ignition on. SMS is sent to the user with a two-minute delay, if the ignition was not on during this time.
The command is sent with the only one parameter.
| Command text in SMS | Comments | Example |
|---|---|---|
| *autotilt X# | Х – sensitivity off – no sending performed on – sending enabled 1 – low 9 – high. If the command is sent without parameters, the mode will be enabled with the present sensitivity. Default value: 5 | *autotilt on# |
| Response to command | Comments |
|---|---|
| autotilt on X autotilt. SMS on autotilt. SMS off | Х – sensitivity off – no sending performed on – sending enabled 1 – low 9 – high |
Enabling Message Sending During Dangerous Driving
Dangerous Driving is the consequence of accelerations and decelerations, as well as in the direction perpendicular to the vehicle movement trajectory, caused by swift lane switches or a sharp movement direction change.
The command is sent with the only one parameter.
| Command text in SMS | Comments | Example |
|---|---|---|
| *danger on# *danger off# *danger sms on# *danger sms off# *danger acc 5 or acc on or acc off# *danger turn 5 or turn on or turn off# *danger brake 5 or brake on or brake off# *danger vertacc 5 or vertacc on or vertacc off# | activation of dangerous driving control disabling dangerous driving control enabling SMS notifications by preset parameters disabling SMS notifications by preset parameters setting acceleration threshold setting lateral acceleration threshold setting braking threshold setting vertical acceleration threshold threshold values: from 1 (low) to 9 (high) | *danger on#, *danger sms off#, *danger acc 1#, *danger turn 1#, *danger brake 1#, *danger vertacc 1# |
| Response to command | Comments |
|---|---|
| danger on danger. sms on danger. sms off danger. acc on - 5 danger. brake off | dangerous driving control enabled SMS notifications enabled SMS notifications disabled acceleration threshold control enabled and set equal to 5 braking threshold control disabled |
Enabling Message Sending in Case of Emergency
Emergency is a harsh braking or acceleration that may be caused by an accident (crash)
The command is sent with the only one parameter.
| Command text in SMS | Comments | Example |
|---|---|---|
| *crash on# *crash off# *crash sms on# *crash sms off# *crash acc X# *crash turn X# *crash brake X# | enabling crash control disabling crash control enabling SMS notifications by preset parameters disabling SMS notifications by preset parameters setting acceleration threshold setting lateral acceleration threshold setting braking threshold X – threshold values: from 1 (low) to 9 (high) | *crash on#, *crash sms off#, *crash acc 1#, *crash turn 1#, *crash brake 1# |
| Response to command | Comments |
|---|---|
| crash on crash. sms on crash. sms off crash. acc on - 5 crash. brake off | crash control enabled SMS notifications enabled SMS notifications disabled acceleration threshold control enabled and set equal to 5 braking threshold control disabled |
Parameter Setting Request
Requesting Device Info
| Command text in SMS | Comments | Example |
|---|---|---|
| *info?# | *info?# |
| Response to command | Comments |
|---|---|
| info: SW Dev XXXXXXX HW Dev YYYYYY time DD-MM-YYYY HH:mm | XXXXXXX – firmware version DD-MM-YYYY HH:mm – device time |
Requesting Command Info
| Command text in SMS | Comments | Example |
|---|---|---|
| *?# | Requesting Command List | *?# |
| Response to command | Comments |
|---|---|
| help: info, period, interval, volume, obd, remove, autotilt, danger, crash, balance, dervice, gps | list of commands without parameters |
Requesting Present Data Sending Interval in the Home Network and in Roaming
| Command text in SMS | Comments | Example |
|---|---|---|
| *period?# | *period?# |
| Response to command | Comments |
|---|---|
| period: home XXXXmin roam YYYYmin | XXXX – data sending interval in the home network, min YYYY – data sending interval in roaming, min |
Requesting Preset Data Collection Interval
| Command text in SMS | Comments | Example |
|---|---|---|
| *interval?# | *interval?# |
| Response to command | Comments |
|---|---|
| interval: XХХХ | XXXX – data collection interval, s |
Requesting Preset Fuel Tank Volume
| Command text in SMS | Comments | Example |
|---|---|---|
| *volume?# | *volume?# |
| Response to command | Comments |
|---|---|
| volume: XXX | XXX – fuel tank volume, l |
Requesting OBD Parameters Sent
| Command text in SMS | Comments | Example |
|---|---|---|
| *obd?# | *obd?# |
| Response to command | Comments |
|---|---|
| obd speed X voltage X rpm X fuel X rate X temp X key X engine X | Х – on (enabled) / off (disabled) |
Current Values Request
Requesting Balance
| Command text in SMS | Comments | Example |
|---|---|---|
| *balance,*100## | *100# – balance request code that depends on operator | *balance,*102## |
| Response to command | Comments |
|---|---|
| balance: ХХХ | ХХХ – current balance of the active SIM |
Mileage After Error Reset, km
| Command text in SMS | Comments | Example |
|---|---|---|
| *service# | *service# |
| Response to command | Comments |
|---|---|
| service: distance XXXX time YYYY | XXXX – mileage after error reset, km |
Requesting Current GPS Parameters
| Command text in SMS | Comments | Example |
|---|---|---|
| *gps# | *gps# |
| Response to command | Comments | Example |
|---|---|---|
| gps sats X speed YYY point ZZZZ,NNNN | X – number of satellites YYY – speed ZZZZ,NNNN – coordinates in the URL form | GPS: sats - 5, speed - 69, point: http://google.com/maps?q=55.7885,37.5891 |
| Potential Errors | Comments | |
| GPS. No valid data | GPS data not obtained |
Requesting Current OBD Parameters
| Command text in SMS | Comments | Example |
|---|---|---|
| *obd# | *obd# |
| Response to command | Comments |
|---|---|
| obd: current values | current values are displayed depending on settings. Fuel volume (% of the fuel tank volume). Volume format depends on the vehicle type |
Event Notifications
Messages are sent to the owner telephone once the event is logged.
| Event | SMS Content | Event Description |
|---|---|---|
| remove | remove current date and time GPS coordinates in the URL form | terminal removal |
| danger | danger current date and time GPS coordinates in the URL form | dangerous driving |
| crash | crash current date and time GPS coordinates in the URL form | accident (crash) |
