AT shell

You can use this library to add an AT shell command to a shell. This enables you to send AT commands to the modem and receive responses.

Configuration

The library expects that you have enabled a shell using CONFIG_SHELL. To enable and configure the AT shell, use the following Kconfig options:

• CONFIG_AT_SHELL - Enables the AT shell library

• CONFIG_AT_SHELL_CMD_RESPONSE_MAX_LEN - Maximum AT command response length

• CONFIG_AT_SHELL_CMD_MODE - Enables AT command mode (shell bypass)

• CONFIG_AT_SHELL_CMD_MODE_TERMINATION - Default line termination in AT command mode (default is CR)

• CONFIG_AT_SHELL_CMD_MODE_ECHO_DEFAULT - Default local echo in AT command mode

To send AT read commands (ending with ?), disable the shell wildcards using the following Kconfig option:

• CONFIG_SHELL_WILDCARD

Usage

When the library is enabled, the shell will have a command at. To send AT commands, use the following syntax:

at AT+CEREG?

Known subcommands are registered as shell subcommands, so at <Tab> completes them.

You can also enable AT command notifications and disable them.

• Enable AT command notifications:

  at events_enable
  

• Disable AT command notifications:

  at events_disable
  

AT command mode is an interactive shell bypass where input is forwarded as AT commands. Output is printed using printk() because the shell is bypassed in raw mode.

• Start AT command mode:

  at at_cmd_mode start
  

Dependencies

This library uses the following nRF Connect SDK library:

• AT monitor

This library uses the following sdk-nrfxlib library:

• AT commands

API documentation

Header file: include/modem/at_shell.h

Source files: lib/at_shell/

AT shell