Released Firmware

[中文]

• Introduction

• ESP32-C2-2MB-G2 Series

• ESP32-C2-4MB-G2 Series

• ESP32-C2-2MB Series

• ESP32-C2-4MB Series

• Subscribe to AT Releases

• AT Released Firmware Differences

Introduction

Note

• Before using the AT firmware below, please read the Disclaimer carefully and comply with its terms and precautions.

• The released AT firmware only supports chip versions with a crystal oscillator frequency of 26 MHz. If your module uses a crystal oscillator frequency of 40 MHz, you can compile the ESP-AT project by following the steps in Compile ESP-AT Project Locally documentation. In the project configuration during the fifth step, make the following selections:

  • Component config > Hardware Settings > Main XTAL Config > Main XTAL frequency > 40 MHz

• If you are unsure which AT firmware your module should use, please read the AT Released Firmware Differences section first. It compares the various ESP32-C2 AT firmwares in terms of supported command sets, hardware configurations, and module compatibility, helping you determine which firmware best matches your module’s hardware configuration.

• If you need to modify the following configurations, you can generate a new firmware by modifying the AT firmware using the at.py Tool.

  • Modify UART Configuration

  • Modify Wi-Fi Configuration

  • Modify Certificate and Key Configuration

  • Modify GATTS Configuration

ESP32-C2-2MB-G2 Series

Note

• This series is no longer releasing new AT firmware. It is recommended to use the compatible ESP32-C2-2MB series instead.

The firmware version below is compatible with ESP32-C2 chip series ECO4 (Rev v2.0) only.

• v3.3.1.0 ESP32-C2-2MB-G2-AT-V3.3.1.0.zip

ESP32-C2-4MB-G2 Series

The firmware versions below are compatible with ESP32-C2 chip series ECO4 (Rev v2.0) only.

• v4.1.1.0 ESP32-C2-4MB-G2-AT-V4.1.1.0.zip (Recommended)

• v4.1.0.0 ESP32-C2-4MB-G2-AT-V4.1.0.0.zip

• v3.3.1.0 ESP32-C2-4MB-G2-AT-V3.3.1.0.zip

ESP32-C2-2MB Series

The firmware versions below are compatible with ESP32-C2 chip series from ECO1 (Rev v1.0) to ECO4 (Rev v2.0), inclusive of both ECO1 and ECO4 variants.

• v4.1.1.0 ESP32-C2-2MB-AT-V4.1.1.0.zip (Recommended)

• v4.1.0.0 ESP32-C2-2MB-AT-V4.1.0.0.zip

The firmware versions below are compatible with ESP32-C2 chip series ECO1 (Rev v1.0) and ECO2 (Rev v1.1) only.

• v3.3.0.0 ESP32-C2-2MB-AT-V3.3.0.0.zip

• v3.1.0.0 ESP32-C2-2MB-AT-V3.1.0.0.zip

• v3.0.0.0 ESP32-C2-2MB-AT-V3.0.0.0.zip

ESP32-C2-4MB Series

Note

• If your hardware is ECO4 (Rev v2.0) chip series, it is recommended to use the ESP32-C2-4MB-G2 series instead.

The firmware versions below are compatible with ESP32-C2 chip series from ECO1 (Rev v1.0) to ECO4 (Rev v2.0), inclusive of both ECO1 and ECO4 variants.

• v4.1.1.0 ESP32-C2-4MB-AT-V4.1.1.0.zip (Recommended)

• v4.1.0.0 ESP32-C2-4MB-AT-V4.1.0.0.zip

The firmware versions below are compatible with ESP32-C2 chip series ECO1 (Rev v1.0) and ECO2 (Rev v1.1) only.

• v3.3.0.0 ESP32-C2-4MB-AT-V3.3.0.0.zip

• v3.1.0.0 ESP32-C2-4MB-AT-V3.1.0.0.zip

• v3.0.0.0 ESP32-C2-4MB-AT-V3.0.0.0.zip

Subscribe to AT Releases

Please refer to the Subscribe to AT Releases documentation to subscribe to our version release notifications and stay updated on the latest releases.

AT Released Firmware Differences

This section compares the ESP32-C2 AT released firmwares in supported command sets, hardware, and supported modules.

• ESP32C2-2MB-AT-Vx.x.x.x.zip (referred to as ESP32C2-2MB Bin in this section);

• ESP32C2-4MB-AT-Vx.x.x.x.zip (referred to as ESP32C2-4MB Bin in this section);

• ESP32C2-2MB-G2-AT-Vx.x.x.x.zip (referred to as ESP32C2-2MB-G2 Bin in this section);

• ESP32C2-4MB-G2-AT-Vx.x.x.x.zip (referred to as ESP32C2-4MB-G2 Bin in this section);

• ESP32C2-2MB-BLE Bin (firmware is not released, but you can download the esp32c2-2mb-ble-at firmware from GitHub Actions, or Compile ESP-AT Project Locally by yourself);

Supported Command Set

The table lists which command set is supported by default in the official AT firmware applicable to ESP32-C2 series of modules (marked with ), which is not supported by default but can be supported after configuration of the ESP-AT project (marked with ), and which is not supported at all (marked with ). Note that the command set that is not shown in this table is not supported either. Applicable firmware that has not been officially released requires compilation by yourself. Those self-compiled firmware cannot be upgraded OTA from Espressif official server.

Command Set	ESP32C2-2MB Bin	ESP32C2-4MB Bin	ESP32C2-2MB-G2 Bin	ESP32C2-4MB-G2 Bin	ESP32C2-2MB-BLE Bin
base
user
Wi-Fi
TCP-IP
mDNS
WPS
SmartConfig
ping
MQTT
HTTP
Bluetooth LE
BluFi
FileSystem
driver
WPA2 enterprise
WEB server
WebSocket
OTA

Hardware Differences

Hardware	ESP32C2-2MB Bin	ESP32C2-4MB Bin	ESP32C2-2MB-G2 Bin	ESP32C2-4MB-G2 Bin	ESP32C2-2MB-BLE Bin
Flash	2 MB	4 MB	2 MB	4 MB	2 MB
PSRAM
UART Pins [1]	TX: 7 RX: 6 CTS: 19 RTS: 20	TX: 7 RX: 6 CTS: 5 RTS: 4	TX: 7 RX: 6 CTS: 19 RTS: 20	TX: 7 RX: 6 CTS: 5 RTS: 4	TX: 7 RX: 6 CTS: 5 RTS: 4

[1]

UART pins can be customized. See How to Set AT Port Pins for details.

Supported Modules

The table below lists the modules or chips that are default supported by the officially released ESP32-C2 series AT firmware (indicated by ), the modules that are not supported by default but can be modified to be supported using the at.py Tool (indicated by ), and the modules that are not supported at all (indicated by ). For modules that are not supported at all, you can refer to Compile ESP-AT Project Locally to modify the configuration as needed for support.

Module/Chip	ESP32C2-2MB Bin	ESP32C2-4MB Bin	ESP32C2-2MB-G2 Bin	ESP32C2-4MB-G2 Bin	ESP32C2-2MB-BLE Bin
ESP8684-MINI-1/1U
ESP8684-WROOM-02C/02UC
ESP8684-WROOM-03
ESP8684-WROOM-05
ESP8684-WROOM-07

Provide feedback about this document