From MikroTik Wiki
< Manual:Tools
Revision as of 12:01, 19 February 2008 by Eep (talk | contribs) (Protected "Sms": will be in manual [edit=sysop:move=sysop])
Jump to: navigation, search

Send SMS using GSM AT commands.

It is possible to connect GSM modem to RouterOS device and use it to send SMS messages. RouterOS lists such modem as serial port that appears in '/port print' listing. GSM standard defines AT commands for sending SMS messages, and defines how messages should be encoded in these commands.

'advanced-tools' package provides command '/tool sms send' that uses standard GSM AT commands to send SMS.


'/tool sms port dst smsc=smsc message=message type=type

  • port - Name of port from '/port' list that GSM modem is attached to.
  • dst - Recepient phone number. Allowed characters are "0123456789*#abc". If first character is "+" then phone number type is set to 'international', otherwise it is set to 'unknown'.
  • message - Message contents. It is encoded using GSM 7 encoding (UCS2 currently is not supported), so message length is limited to 160 characters (characters ^{}\[]~| are counted as two characters each). Concatenated messages and non-ASCII characters are currently not supported.
  • type - If set to 'class-0', then send class 0 SMS message. It is displayed immedeately and not stored in phone.


/tool sms send usb3 "20000000" message="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz!@#\$%^&*(){}[]\"'~"


'/tool sms send' command logs data it writes and reads. It is logged with tags gsm,debug,write and gsm,debug,read.

Implementation details

This command uses "AT+CMGS" and "AT+CMGF" commands. Port is acquired for the duration of this command, and cannot be used concurently by another RouterOS component. Sending message can take a long time, this command timeouts after a minute while sending message data, and after two seconds during initial AT command exchange.

See also