AT application for ESP32 ESP-IDF with PPP server and web browser additions
Branch: master
Clone or download
Pull request Compare This branch is 29 commits ahead, 32 commits behind espressif:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
esp-idf @ 221eced
example feat: add ESP32 sdio host demo Oct 15, 2018
main First commit of mini web browser code from the contiki project. Dec 2, 2018
.gitignore feat: Ignore .DS_Store in .gitignore Jun 30, 2018
LICENSE feat: Add ESPRESSIF MIT License Aug 14, 2018
Makefile update README with instrucitons for web command. Jan 24, 2019
sdkconfig.defaults feat: Enable mbedtls certificate expiry check Nov 9, 2018

This Fork

Contains code to run the webbrowser from Contiki that is modified to use the ESP32 web client (with SSL) and a VT52/VT100 interface.

  • AT+WEB : start the web browser.
  • AT+WEB= : <URI> open web browser at URI.
  • AT+GET= : <URI> download raw html at URI.

Contains code to use lwip PPP client or server.

  • AT+PPPD : Standard way to start PPP.
  • AT+PPPD? : Shows current settings.
  • AT+PPPD=? : Shows format for settings.
  • AT+PPPD= : <local_IP_address>:<remote_IP_address>, (0-127) IP setting is the same as pppd. The trailing number is a register for enabling and disabling server settings (not implemented).
  • ATDTPPPD; : Modem script compatible command to start PPPD. Enter 'PPPD' as the phone number in a modem script and it will issue this command to start PPPD.
  • ATDTPPPD : See above.

To update esp-idf and esp-lwip with changes to enable PPPD server and have an error-free build, run:

$ make patch

Exit out of the framework configuration menus (since the settings we need have not been added yet).

Then, to configure, build and flash, run:

$ make menuconfig flash

You will need to enable PPP support and PPP server support in the framework configuration:

Component config ---> LWIP ---> Enable PPP support (new/experimental) ---> Enable PPP server support (new/experimental)

Also, enable the web command:

Component config ---> AT ---> AT web command support.

If you want, you can unpatch the source with:

$ make unpatch

Full espressif AT command documentation


libat_core.a is AT Command Core, and it is the core of AT command, including the default AT instruction set, the AT command parsing, execution and responding. The lib contains 4 kinds of command, such as AT+TEST=?, AT+TEST?, AT+TEST=“abc” and AT+TEST. It supports custom AT commands based on the lib and related APIs, and ones can also define input and output medium, like uart, spi, socket, bt, etc.

The demo is the AT command set based on uart. You can replace the uart driver with other drivers whichever you want to use. But you have to make some changes in at_task.c. In addition, you can add some custom AT commands in at_custom_cmd like AT+CIUPDATE if necessary.

More details are in documentation esp32_at_instruction_set_and_examples_en.pdf or esp32_at_instruction_set_and_examples_cn.pdf. And if you enable the ethernet commands, please refer to

Hardware Introduction

The ESP32 Board sends AT commands through UART1 by default.

  • GPIO16 is RXD
  • GPIO17 is TXD
  • GPIO14 is RTS
  • GPIO15 is CTS

The debug log will output through UART0 by default, which TXD0 is GPIO1 and RXD0 is GPIO3, but user can change it in menuconfig if needed.

  • make menuconfig --> Component config --> ESP32-specific --> UART for console output

Notes: Please pay attention to conflict of the pin

  • If choose AT through HSPI, you can get the information of the hspi pin by make menuconfig --> Component config --> AT --> AT hspi settings
  • If enable AT ethernet support, you can get the information of the ethernet pin from

Compiling and flashing the project

Compiling the esp32-at is the same as compiling any other project based on the ESP-IDF:

  1. You can clone the project into an empty directory using command:
git clone --recursive
  • Note the --recursive option! The esp32-at project already has an ESP-IDF as a submodule, which should be used to compile the project, in order to avoid any compatibility issues (e.g. compile failure or running problems, etc.).
  • If you have already cloned the esp32-at without this option, run another command to get all the submodules:
git submodule update --init --recursive
  1. rm sdkconfig to remove the old configuration.
  2. Set the latest default configuration by make defconfig.
  3. make menuconfig -> Serial flasher config to configure the serial port for downloading.
  4. make flash to compile the project and download it into the flash.
  • Or you can call make to compile it, and follow the printed instructions to download the bin files into flash by yourself.
  • make print_flash_cmd can be used to print the addresses of downloading.
  • More details are in the esp-idf README.
  1. make factory_bin to combine factory bin, by default, the factory bin is 4MB flash size, DIO flash mode and 40MHz flash speed. If you want use this command, you must fisrt run make print_flash_cmd | tail -n 1 > build/download.config to generate build/download.config.
  2. If the ESP32-AT bin fails to boot, and prints "ota data partition invalid", you should run make erase_flash to erase the entire flash.
  3. Since we updated the toolchain recently, it is not compatible with the old version. Please use the toolchain we provided in the esp32-at/esp-idf/docs/get-started/linux-setup.rst and esp32-at/esp-idf/docs/get-started/windows-setup.rst to build your ESP32 AT project.