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

Until SMS credentials are configured SMS interface is active only for first 10 minutes after power-on and uses following format:

setup [SETUP_CODE] APN internet

where [SETUP_CODE] is an unique setup code.

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
  • command is recognized, but not supported in the RECOVERY mode if it is active

For those commands which return multiple values the RETVAL format is:

KEY1:VALUE1 KEY2:VALUE2 ...

Commands

SETAUTH

Arguments:

  • NUMBERS - enable numbers whitelist
  • LOW - disable numbers whitelist
  • DISABLE - disable SMS access
  • <username> <password> - set username and password
-> SETAUTH LOW
<- Q1234567890123456 SETAUTH OK
-> SETAUTH NUMBERS
<- Q1234567890123456 SETAUTH OK
-> SETAUTH DISABLE
<- Q1234567890123456 SETAUTH OK
-> SETAUTH user pass
<- Q1234567890123456 SETAUTH OK

Warning

If SMS interface is DISABLED when APN configuration is not valid, the only way to set APN and get device online will be using USB interface.

APN

Change APN configuration.

Parameters:

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

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

INFO

Respond with network information for troubleshooting:

-> INFO
<- Q1234567890123456 INFO GSM
    CREG:<creg>
    PDP:<pdp>
    APN:"<apn>"
    MCC:<mcc>
    MNC:<mnc>
    ACT:<act>
    RSSI:<rssi>
    LAC:<lac>
    CELL:<cell>
    RSRP:<rsrp>
    RSRQ:<rsrq>
    SINR:<sinr>

RTC

Respond with Real-Time Clock date and time.

-> RTC
<- Q1234567890123456 RTC 2025-05-27 18:20:00

REBOOT

Restart the device.

Note

The device does not respond to this command.

RECOVERY

Switch to recovery mode where most gateway features are disabled.

Warning

This command is documented only for transparency. It is inteded only for trained technical support personel.

Getting device out of recovery mode requires contacting technical support.

Note

The device does not respond to this command.