Skip to content

SMS commands

Authorization

Each SMS command must be prepended with username and password, eg.:

user secret APN internet

Info

  • User names and password are NOT case sensitive.
  • Username max length: 16
  • Password max length: 16

Responses

For most of the commands response format is: 

Q1234567890123456 COMMAND RETVAL

Q1234567890123456 - device UID
COMMAND - issued command
RETVAL - OK / ERROR / value(s) returned by the issued COMMAND

If the command is not recognized, the device doesn't send the response.

ERROR is returned when:

  • arguments provided for the given command are not correct
  • execution of the action specified in the command has failed (e.g. SETOUT with not existing extension ID)
  • command is recognized, but not supported in the current SLOT (e.g. SETOUT in SLOT0)

For those commands which return multiple values (e.g. IO), the RETVAL format is:

KEY1:VALUE1 KEY2:VALUE2 ...

Basic commands

SETAUTH

Arguments:

  • 0 - reset to default
  • 1 - NUMBERS / LOW (disable/enable numbers list authorization)
  • 2 - set username and password
-> SETAUTH
<- Q1234567890123456 SETAUTH OK
-> SETAUTH NUMBERS
<- Q1234567890123456 SETAUTH OK
-> SETAUTH user pass
<- Q1234567890123456 SETAUTH OK

REBOOT

Restart the device.

Note

The device does not respond to this command.

SETOUT

Parameters:

  • extension id (optional)
  • relay number
  • time (0 means deactivate)

Examples without extension id:

  • SETOUT 1 - activate built-in output relay
  • SETOUT 1 10 - activate built-in output relay for 10 seconds
  • SETOUT 1 0 - deactivate built-in output relay

Example with extension id:

  • SETOUT R2 3 60 - activate output relay 3 on extension with id (modbus address) = 3 for 60 seconds.
-> SETOUT 1
<- Q1234567890123456 SETOUT OK
-> SETOUT R2 3 60
<- Q1234567890123456 SETOUT OK

IO

Respond with status of Digital input (DI) and relay output (DO).

-> IO
<- Q1234567890123456 IO DI:1 DO:0

Configuration commands

APN

Change APN configuration.

Parameters:

  • name - APN name parameter, must be obtained from mobile carrier
  • username
  • password

Examples:

  • APN internet - set APN name to internet
  • APN m2msims m2msims m2msims - set APN name, username and password to m2msims

Invalid examples:

  • APN - at least name parameter must be provided
  • APN internet orange - both username and password must be provided

Effects:

  • APN configuration is changed permanently.
-> APN internet
<- Q1234567890123456 APN OK
-> APN internet orange
<- Q1234567890123456 APN ERROR

TZ

Set timezone offset used by internal clock.

Examples:

  • TZ 2 - set timezone offest to two hours (CEST)
  • TZ -1 - set timezone offset to minues 1 hour
  • TZ 0 - set timezone offeset to 0 hours (UTC)
-> TZ 2
<- Q1234567890123456 TZ OK