All you need to know about the basics of AT Commands for Cellular IoT Modems
An Introduction to Cellular AT Commands
AT Command or ‘ATtention’ Commands is the basis of communication between any cellular (or RF) modems and its host controller. Any firmware or hardware developer working with these modems will make use of these ‘instructions’ for the modems to essentially send commands to the modem for various functions.
AT Commands, which are now a universal instruction standard for all cellular modems, even by different manufacturers, was originally created by Dennis Heyes as the Heyes Command Set for the ‘Heyes 300 Baud SmartModem’ in 1981.
AT Commands are mainly used to configure and debug modems as well as to enable network connection to a carrier in GSM, GPRS, and mobile phone modems. The commands allow developers to send and receive several device and network parameters from the modem such as the current network status indication, roaming, network technology currently being used (4G, NB-IoT, 2G, etc. ), and other such information. The data being transmitted is crucial during any debugging or developing activities.
The AT commands for GSM/IoT modules can be used to access a few crucial services such as:
- Device and SIM information
- SMS & MMS services
- Fax services (if supported)
- Voice & data services
Even today, AT Commands, are still being used to establish and configure network connections on modern 5G modems as well.
How are AT Commands being communicated?
AT Command instructions are single-line instructions that need to be sent to the device in sequential order while the user has to wait for the response (in most cases) before sending the next command. Sending across the relevant AT Commands and receiving its responses usually requires a host device such as a microcontroller that is connected to the modem via a UART (Universal Asynchronous Receiver/Transmitter). A UART is a two-wire communication protocol that allows two devices to communicate with each other in a half-duplex fashion. In newer modems, the AT Command instructions can be directly sent across via a USB connection or even wirelessly over the network for remote diagnostics.
AT Command Syntax & Types
Similar to a programming language syntax, AT Commands also have syntaxes that the user has to follow in order to send valid commands to the device. The general syntax for a command is as follows:
Any AT Command will need to be preceded by “AT” in order to invoke the AT Command functions within the modem which is then followed by the actual command that needs to be sent to the modem which is trailed by the suffix in order to indicate the command mode or ‘type’ and then the data that is needed to be sent, although this field might not be required for all commands.
This structure is known as the command line structure and is terminated by a single carrier return or the user can send multiple commands in a single line separated by a semi-colon.
AT Commands can be broadly classified into two sets, Basic Commands, and Extended Commands.
These are commands that do not begin with the “+” symbol. Some of the common commands under the basic set are D (Dial), A (Answer), H (Hook control), and O (Return to online data state).
Extended Commands are those that start with the “+” symbol. All GSM AT Commands fall under this category and a few of the common commands are +CMGS (Send SMS message), +CMGL (List SMS messages), and +CMGR (Read SMS messages).
Further, the AT Commands are of 4 categories primarily — Test Commands, Read Commands, Set & Execution Commands.
The response given by the modem is known as the ‘Result Code’. This code lets the user know the status of the given command response. An ‘OK’response signifies that the command has been executed successfully while an ‘ERROR’response may be returned for the following reasons:
- Syntax of the AT Command is Incorrect
- The modem is incompatible with the AT Command issued
- The modem is currently unable to process the command (eg. when trying to change settings while the modem is active and transmitting)
These are primarily used to check whether the given command is supported by the modem or not. Depending on the specific modem, some AT Commands may or may not be supported due to hardware or software limitations. The test commands allow the user to confirm the support of the modem before pushing the instruction.
ATD stands for Dial Command and ATD=? Is used to check if the modem supports Dialing functionality.
Read Commands are used to extract information from the modem. This information can be regarding certain parameters or settings that have been configured in the modem or even network-related parameters.
Set Commands are used to modify and configure modem parameters/settings. This is mostly used during the initial setup of the modem
AT<COMMAND NAME>=value1, value2, …, valueN
Execution Commands are used to perform an operation with or on the modem. This command is the most common type of command.
AT<COMMAND NAME>=parameter1,…, parameterN
Most Commonly used AT Command References
Although different vendors have different sets of AT Commands for their specific modems, there are two sets of commands that can be used:
- Universal AT Commands: Common commands can be used on any modem.
- Proprietary AT Commands: Specific commands developed by the modem’s vendor for use with their modems.
There are 7 basic universal commands that can be easily familiarized with for any modem.
This is the most basic command that lets the user check whether a connection has been established between the modem and the host system. If the interface is correct, the modem returns “OK” else, it will return an “ERROR” if there is a misconfiguration in the connection, and in cases where the physical connection is not correct, no response would be received.
This command sets up the SMS mode of the modem. By preceding the command with a 0 or a 1, text or PDU mode can be selected. The text-mode operation is quite simple with a direct textual interface but is quite limited by its capabilities. PDU on the other hand allows the user to gain more detailed access to the SMS service with HEX values being used in place of plain text.
The +CMGW command is used to store a message in the SIM card of the modem. After executing the command, the ‘>’ sign will be displayed and the user can enter the message to be stored. These messages are stored in a serial fashion.
AT+CMGW=”Phone number” > <Message to be stored>For example:
AT+CMGW=’+123456789’ > Hello world
The CMGS command allows the user to send a saved SMS message from the SIM card.
AT+CMGS=<Serial Number of SMS to be sent>
ATD is the simplest command to dial a provided number.
ATA is a command used to answer any incoming calls to the modem. The call will be denoted by a message “RING” which is repeated at every ring of the incoming call. If the user does not answer/the call ends, “NO CARRIER” will be displayed.
ATH is a command used to disconnect a remote user connects to the modem.
List of AT commands
Major AT Commands for GSM modems areas are listed below. Not all commands are supposed by all modems due to hardware or software limitations
Call control :
Data card Control :
Computer data interface :
Network Communication parameter :
SMS Text mode :
SMS PDU mode :
Wireless AT Commands and Cavli Hubble IoT Platform
Over the years of modem technology, AT Commands and their implementations have mostly stayed stagnant, and the requirement of physical access in order to push the commands to modems has been proven cumbersome in situations where the device has already been deployed.
With this in mind, Cavli has engineered our SmartModules with the capability to receive AT Commands over cellular networks through Cavli Hubble. This allows developers to send AT Commands to deployed devices across the world through the Hubble platform which allows for easy and quick device diagnostics and configuration through an easy-to-use terminal interface on the Hubble platform.