The documentation for ESP-AT v2.3.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v2.3.0.0_esp8266/
This release is a minor update to ESP-AT v2.2.2.0.
The firmware:
Breaking ChangesESP8266_RTOS_SDK
to commit c965e03d, upgrading the bundled mbedtls library from v2.16.5
to commit 1d34215a
(a few commits after v3.6.3
). Important: If you want to use this version firmware, please ensure your server is compatible with mbedtls commit 1d34215a
before proceeding. If it works fine, you can upgrade your products by AT+CIUPDATE=0,"v2.3.0.0"
.AT+CIPSSLCCIPHER
command to configure the SSL cipher‑suite listv4.1.1.0 is released for ESP32-C2, ESP32-C3, ESP32-C6, ESP32, and ESP32-S2. The changes since the previous version are as follows.
ESP32C2-ATDocumentation for Release v4.1.1.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v4.1.0.0/esp32c2/index.html. ESP32C2-AT v4.1.1.0 is a minor update for ESP32C2-AT v4.1.0.0.
The firmware:
This is the list of changes since release v4.1.0.0:
Known IssuesAT+FS
may fail after repeated read/write operationsAT+MQTTSUB
with QoS 1, triggered by a fast SUBACK response from the brokerAT+MQTTPUB
with QoS 1 or 2, AT+MQTTSUB
with QoS 1, or AT+MQTTUNSUB
, if the ESP does not receive the corresponding PUBACK, SUBACK, or UNSUBACK within 30 seconds,Documentation for Release v4.1.1.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v4.1.0.0/esp32c3/index.html. ESP32C3-AT v4.1.1.0 is a minor update for ESP32C3-AT v4.1.0.0.
The firmwares:
This is the list of changes since release v4.1.0.0:
Known IssuesAT+FS
may fail after repeated read/write operationsAT+MQTTSUB
with QoS 1, triggered by a fast SUBACK response from the brokerAT+MQTTPUB
with QoS 1 or 2, AT+MQTTSUB
with QoS 1, or AT+MQTTUNSUB
, if the ESP does not receive the corresponding PUBACK, SUBACK, or UNSUBACK within 30 seconds,Documentation for Release v4.1.1.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v4.1.0.0/esp32c6/index.html. ESP32C6-AT v4.1.1.0 is a minor update for ESP32C6-AT v4.1.0.0.
The firmwares:
This is the list of changes since release v4.1.0.0:
Known IssuesAT+FS
may fail after repeated read/write operationsAT+MQTTSUB
with QoS 1, triggered by a fast SUBACK response from the brokerAT+MQTTPUB
with QoS 1 or 2, AT+MQTTSUB
with QoS 1, or AT+MQTTUNSUB
, if the ESP does not receive the corresponding PUBACK, SUBACK, or UNSUBACK within 30 seconds,Documentation for Release v4.1.1.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v4.1.0.0/esp32/index.html. ESP32-AT v4.1.1.0 is a minor update for ESP32-AT v4.1.0.0.
The firmwares:
This is the list of changes since release v4.1.0.0:
Known IssuesAT+FS
may fail after repeated read/write operationsAT+BLUFI=1
command, if the device was previously in SoftAP or Station+SoftAP mode, the SoftAP interface may briefly restart.AT+BLUFI
after disabling and re-enabling BLUFI without power cycling, BLE advertising may fail to start.AT+MQTTSUB
with QoS 1, triggered by a fast SUBACK response from the brokerAT+MQTTPUB
with QoS 1 or 2, AT+MQTTSUB
with QoS 1, or AT+MQTTUNSUB
, if the ESP does not receive the corresponding PUBACK, SUBACK, or UNSUBACK within 30 seconds,Documentation for Release v4.1.1.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v4.1.0.0/esp32s2/index.html. ESP32S2-AT v4.1.1.0 is a major update for ESP32S2-AT v3.4.0.0.
The firmwares:
This is the list of changes since release v3.4.0.0:
Known IssuesAT+FS
may fail after repeated read/write operationsAT+SYSRAM
setup command to detail memory capacityAT+SYSROLLBACK
query command to obtain the address and version of the current and rollback firmwareAT+RFCAL
command to support RF full calibrationAT+SYSMFG
commandAT+SYSMSGFILTER
did not work when the data contained \r\n
AT+CWBANDWIDTH
command to set Wi‑Fi bandwidthAT+CWCONFIG
command to set the global inactive time and listen intervalAT+CWLAPOPT
, AT+WPS
, AT+CWSTARTSMART
and AT+BLUFI
AT+CWJAP
after connecting to an Enterprise AP with AT+CWJEAP
AT+CWHOSTNAME
AT+CWLAP
did not return valid APs when BLUFI was enabledAT+CWQAP
and AT+CWRECONNCFG
commandsAT+CWRECONNCFG
command twicenetif
parameter to the AT+CIPSERVER
commandAT+CIPSSLCCIPHER
command to configure the SSL cipher‑suite listAT+CIPSTART
and AT+CIPDOMAIN
commandsAT+CIPDNS
AT+CWDHCP
returning an incorrect DHCP state after the DHCP server was disabledAT+CIPRECVLEN?
always returned a fixed set of five connectionsAT+CIPSTATUS
returned incorrect statusesAT+CIPCLOSE
could not close a connection after reaching the maximum number of open socketsAT+CIPSTART
did not work in passive‑read modeAT+CIPRECVLEN
AT+CIPSTO
did not take effect when data transmission failedAT+MDNS
instance
, proto
, and txt
parameters to the AT+MDNS
commandAT+HTTPCFG
command to configure certificates for HTTPAT+HTTPCHEAD
commandAT+MQTTPUB
with QoS 1 or 2, AT+MQTTSUB
with QoS 1, or AT+MQTTUNSUB
, if the ESP does not receive the corresponding PUBACK, SUBACK, or UNSUBACK within 30 seconds,fatfs.bin
size and the required sizefatfs.bin
was not pre‑burned before flashingfwrite()
returned OK
but data was not written to the file systemv4.1.0.0 is released for ESP32-C2, ESP32-C3, ESP32-C6, and ESP32. The changes since the previous version are as follows.
ESP32C2-ATDocumentation for Release v4.1.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v4.1.0.0/esp32c2/index.html. ESP32C2-AT v4.1.0.0 is a major update for ESP32C2-AT v3.3.0.0.
The firmware:
This is the list of changes since release v3.3.0.0:
Known IssuesAT+FS
may fail after repeated read/write operationsAT+SYSRAM
setup command to detail memory capacityAT+SYSROLLBACK
query command to obtain the address and version of the current and rollback firmwareAT+RFCAL
command to support RF full calibrationAT+SYSMFG
commandAT+SYSMSGFILTER
did not work when the data contained \r\n
AT+CWBANDWIDTH
command to set Wi‑Fi bandwidthAT+CWCONFIG
command to set the global inactive time and listen intervalAT+CWLAPOPT
, AT+WPS
, AT+CWSTARTSMART
and AT+BLUFI
AT+CWJAP
after connecting to an Enterprise AP with AT+CWJEAP
AT+CWHOSTNAME
AT+CWLAP
did not return valid APs when BLUFI was enabledAT+CWQAP
and AT+CWRECONNCFG
commandsAT+CWRECONNCFG
command twicenetif
parameter to the AT+CIPSERVER
commandAT+CIPSSLCCIPHER
command to configure the SSL cipher‑suite listAT+CIPSTART
and AT+CIPDOMAIN
commandsAT+CIPDNS
in AT+CIPDNS
AT+CWDHCP
returning an incorrect DHCP state after the DHCP server was disabledAT+CIPRECVLEN?
always returned a fixed set of five connectionsAT+CIPSTATUS
returned incorrect statusesAT+CIPCLOSE
could not close a connection after reaching the maximum number of open socketsAT+CIPSTART
did not work in passive‑read modeAT+CIPRECVLEN
AT+CIPSTO
did not take effect when data transmission failedAT+MDNS
instance
, proto
, and txt
parameters to the AT+MDNS
commandesp32c2‑2mb
firmwareAT+HTTPCFG
command to configure certificates for HTTPAT+HTTPCHEAD
commandAT+MQTTSUB
failed but returned OK
fatfs.bin
size and the required sizefatfs.bin
was not pre‑burned before flashingfwrite()
returned OK
but data was not written to the file systemslist
issues where the pointer fail_item
was used after free
AT+WSCFG
command to configure certificates in WebSocket\r
character was missing+BLESCANDONE
issueAT+BTENCCLEAR
not properly clearing BT pairing informationBLE_TT_MODE
printed twice in BLE passthrough mode+WRITE
responseBLUFI
memory leakAT+RFPOWER
query not returning BLE power when using nimble protocol+BLEDISCONN
message when sending AT+BLEDISCONN=0esp-idf
version updated to ~v5.4.2*.defaults
pre_wakeup_callback
and process_light_sleep
hook eventsesp_at_ready_before()
API to perform tasks before ESP‑AT is readyat_exe_cmd()
API to execute AT commands via ESP‑AT itselfesp_at_get_netconn_count()
to esp_at_get_netconn_max_count()
esp_at_get_smartconfig_start_config()
APITCP & SSL
: TCP/SSL connections are now proactively closed immediately when their associated netif state changes (netif down, stop, or lost IP). In previous versions, the connections would remain open until a keep-alive timeout, send timeout, or max retry threshold was reached - often taking tens of seconds to close. This change significantly reduces latency in connection teardown and improves system responsiveness.esptool.py merge_bin
gatts_cfg
was excessively modified by the at.py
scriptfatfs_to_http_server
examplehttp_get_to_fatfs
exampledocs.espressif.com/projects/esp-at
Documentation for Release v4.1.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v4.1.0.0/esp32c3/index.html. ESP32C3-AT v4.1.0.0 is a major update for ESP32C3-AT v3.3.0.0.
The firmwares:
This is the list of changes since release v3.3.0.0:
Known IssuesAT+FS
may fail after repeated read/write operationsAT+SYSRAM
setup command to detail memory capacityThe documentation for ESP-AT v2.2.2.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v2.2.0.0_esp8266/. This release is a minor update to ESP-AT v2.2.1.0.
Breaking Changes Since Release v2.2.1.0ESP8266_RTOS_SDK
version update: Upgraded to release v3.4 (ff16a35c).AT+USERWKMCUCFG
and AT+USERMCUSLEEP
commands to wake up MCU.AT+CIPSSLCCIPHER
command to specify ssl cipher suite.AT+CIPSTATE
command to query connection state.AT+MQTTLONGCLIENTID
command to set MQTT client ID.AT+MQTTLONGUSERNAME
command to set MQTT username.AT+MQTTLONGPASSWORD
command to set MQTT password.AT+WEBSERVER
: Wi-Fi provisioning supports the special character in SSID and password.AT+CWJAP
occasionally returned an incorrect reason code.AT+CWSTATE
occasionally returned an incorrect state.AT+CWLAP
occasionally returned an ERROR.AT+CWJEAP
to connect to a WPA2 Enterprise AP.+CWJAP
error code might be printed before the "WIFI DISCONNECT" message.AT+CIPDNS
query command returned an incorrect configuration.AT+CIPSERVER=0,1
did not correctly close clients connected to the ESP TCP server.AT+CIPSERVER=5
returned "Have 255 Connections" sometimes.AT+CIPTCPOPT
send timeout parameter failed to work sometimes.+IPD
report loss when the TCP connection was reopened while AT was acting as a server.AT+CIPSERVERMAXCONN=5
was set.AT+CIPSTO
did not reset the timer after sending data.AT+CIPRECVMODE=1
was used.AT+CIPTCPOPT
command in multiple connections.AT+CIPTCPOPT
did not work when ESP-AT operated as a server.AT+CIPSTART
could not establish multiple UDP transmissions on the same port.AT+CIPSSLCCN
and AT+CIPSSLCSNI
could not be set to 64 bytes.AT+HTTPCLIENT
HEAD response.AT+HTTPCPOST
response returned the wrong command name when additional POST data was appended.AT+CWMODE=0
was set.busy p...
issues occurring occasionally.AT+CIPTCPOPT
command.v3.4.0.0 is released for ESP32 and ESP32-S2. The changes since the previous version are as follows.
ESP32-ATDocumentation for Release v3.4.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v3.4.0.0/esp32/index.html. ESP32-AT v3.4.0.0 is a major update for ESP32-AT v3.2.0.0.
The firmwares:
This is the list of changes since release v3.2.0.0:
Breaking Changesesp-idf
version updated to v5.0.6RF power
: Fixed the issue that the actual wifi transmit power didn't match the settings. The default configuration of wifi transmit power is 19.5 dBm, but the actual wifi transmit power may be slightly lower than the settings. This is because the wifi transmit power is limited by your country code according to phy_multiple_init_data.bin
configuration. In the current version, esp-at disabled multiple phy init data bin to improve the wifi transmit power (rf power is no longer limited by your country code).AT+CIPRECVTYPE
command to set recv mode for each connectionAT+CIPRECVLEN
query command can return the real data length nowAT+MQTTCONNCFG
: Enlarged lwt msg length to 128 bytesAT+MQTTSNI
command to set MQTT server name indicationAT+CWLAP
: Fixed an issue where executing AT+CWLAP
may return an ERROR when the AT+CWRECONNCFG
command is sent immediately after the Wi-Fi disconnectionAT+PING
: Fixed an issue that cannot ping a linklocal ipv6 addressAT+SYSFLASH
crash issue if a large amount of data is readDocumentation for Release v3.4.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v3.4.0.0/esp32s2/index.html. ESP32S2-AT v3.4.0.0 is a major update for ESP32S2-AT v2.1.0.0.
The firmware:
This is the list of changes since release v2.1.0.0:
Breaking Changesesp-idf
version updated to v5.0.6Added more Basic AT commands:
Added more Wi-Fi AT commands:
Added more TCP/IP AT Commands:
Added more MQTT AT Commands:
Added more HTTP AT Commands:
Added new User AT Commands:
Due to the long time without a new firmware release for ESP32-S2, this release has significant changes. If you want to know more information, please refer to some ESP32 release notes:
v3.3.0.0 v3.3.0.0 Release Notesv3.3.0.0 is released for ESP32-C2 and ESP32-C3. The changes since the previous version are as follows.
ESP32C2-ATDocumentation for Release v3.3.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v3.3.0.0/esp32c2/index.html ESP32C2-AT v3.3.0.0 is a major update for ESP32C2-AT v3.1.0.0.
The firmwares:
This is the list of changes since release v3.1.0.0:
Breaking Changesesp-idf
version updated to v5.0.6AT+CIPSSLCPSKHEX
command to set SSL client pre-shared key in hexadecimal formatAT+CIPRECVTYPE
command to set recv mode for each connectionAT+CIPRECVLEN
query command can return the real data length nowAT+CIPSNTPCFG
: Added timezone query and timezone set when SNTP was disabledAT+MQTTCONNCFG
: Enlarged lwt msg length to 128 bytesAT+MQTTSNI
command to set MQTT server name indicationAT+CWLAP
: Fixed an issue where executing AT+CWLAP
may return an ERROR when the AT+CWRECONNCFG
command is sent immediately after the Wi-Fi disconnectionAT+PING
: Fixed an issue that cannot ping a linklocal ipv6 addressAT+SYSMFG
read operation returned wrong lengthAT+SYSFLASH
crash issue if read a large amount of dataDocumentation for Release v3.3.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v3.3.0.0/esp32c3/index.html ESP32C3-AT v3.3.0.0 is a major update for ESP32C3-AT v3.2.0.0.
The firmware:
This is the list of changes since release v3.2.0.0:
Breaking Changesesp-idf
version updated to v5.0.6RF power
: Fixed an issue where the actual wifi transmit power didn't match the settings. The default configuration of wifi transmit power is 19.5 dBm, but the actual wifi transmit power may be slightly lower than the settings, this is because the wifi transmit power is limited by your country code according to phy_multiple_init_data.bin
configuration. In the current version, esp-at disabled multiple phy init data bin to improve the wifi transmit power (RF power is no longer limited by your country code).AT+CIPRECVTYPE
command to set recv mode for each connectionAT+CIPRECVLEN
query command can return the real data length nowAT+MQTTCONNCFG
: Enlarged lwt msg length to 128 bytesAT+MQTTSNI
command to set MQTT server name indicationAT+CWLAP
: Fixed an issue where executing AT+CWLAP
may return an ERROR when the AT+CWRECONNCFG
command is sent immediately after the Wi-Fi disconnectionAT+PING
: Fixed an issue that cannot ping a link-local ipv6 addressAT+SYSFLASH
crash issue if a large amount of data is readv3.2.0.0 is released for ESP32 and ESP32-C3. The changes since the previous version are as follows.
ESP32-ATDocumentation for Release v3.2.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v3.2.0.0/esp32/index.html
ESP32-AT v3.2.0.0 is a major update for ESP32-AT v2.4.0.0.
The firmwares:
This is the list of changes since release v2.4.0.0:
Breaking Changesesp-idf
version updated to release/v5.0 (24b9d38a)AT+SYSFLASH
: If you previously used v2.4.0.0 firmware and now directly flash v3.2.0.0 firmware, and MCU reads/writes parameters through AT+SYSFLASH
command, the two versions will return different data, causing incompatibility (because v2.4.0.0 reads/writes parameters using partition method, while v3.2.0.0 uses NVS method). You can choose any of the following methods to resolve the compatibility issue:
AT+SYSFLASH
command to read/write parameters; for v3.2.0.0 firmware version, use AT+SYSMFG
command to read/write parameters.AT+USEROTA
or AT+CIUPDATE
command instead of directly flashing firmware.AT+RFPOWER
: The default value of ble tx power changed from 2 to 0AT+CWSTAPROTO
and AT+CWAPPROTO
commands added WIFI_PROTOCOL_LR
supportAT+CWINIT
command to init or deinit Wi-FiAT+WEBSERVER
: Wi-Fi provisioning supports special characters in SSIDs and passwordsAT+CIPFWVER?
command to query firmware versionsAT+CIUPDATE
: Added CDN network supportAT+TRANSINTVL
command to support configurable intervals in passthrough modeAT+MQTTLONGCLIENTID
command to set MQTT client IDAT+MQTTLONGUSERNAME
command to set MQTT usernameAT+MQTTLONGPASSWORD
command to set MQTT passwordAT+HTTPCHEAD
commands to set more request headersAT+HTTPCPUT
command to put HTTP data of specified lengthAT+HTTPGETSIZE
: Added tx_size, rx_size, timeout parametersAT+WEBSERVER
: Added the customized partition upgrade functionAT+CIPSNTPCFG
: Added timezone query and timezone set when SNTP was disabledAT+SYSMSGFILTER
and AT+SYSMSGFILTERCFG
commands to filter system messagesAT+USERWKMCUCFG
and AT+USERMCUSLEEP
commands to wake up MCUesp_at_get_para_as_float()
API to get the float type parameterAT+BLUFI
: BluFi supports getting AP lists and sending custom dataAT+BLEWL
: Added ble whitelist commandAT+BLUFINAME
: Modified maximum length of BluFi name to 29 bytesAT+SAVETRANSLINK
: Support Bluetooth LE passthrough modeAT+BLERDRSSI
: Support reading the RSSI of Bluetooth LE connectionAT+GSLP
)AT+CWQIF
fails to disconnect the station if connected by multiple stationsAT+CWJAP
returned the wrong reason code sometimesAT+WEBSERVER
)AT+BLUFI
command was sentAT+CWJEAP
: Fixed the issue that the EAP-TLS
method does not work due to the last byte of PKI was not NULL terminatedAT+RFPOWER
command could not set ble tx power when Wi-Fi mode was 0AT+CIPSTO
could not work in passthrough modeAT+CIPTCPOPT
cannot work if AT works as a serverAT+CIPTCPOPT
query command may return the wrong keep-alive valueAT+CIPCLOSE
might block forever if ESP-AT works as a TCP client and SO_LINGER
option is set (due to the LwIP SO_LINGER issue in some cases)AT+CIPRECVDATA
may cause a busy p issueAT+CIPSSLCCONF
, AT+CIPSSLCCN
, AT+CIPSSLCSNI
, AT+CIPSSLCALPN
, AT+CIPSSLCPSK
, AT+CIPTCPOPT
returns multiple items in single connectionAT+CIPSTART
commandAT+CIPSTART
commandAT+CIPSEND
: Fixed a data sent issue due to the changed link_idAT+CIUPDATE
returned ERROR if the OTA server returned too many OTA versionsAT+CIPSTART
could not establish multiple UDP transmissions on the same portAT+CIPSERVER
twiceAT+HTTPURLCFG?
returned the wrong URLrx_size
parameter could not work when set to 0 in AT+HTTPCGET
commandAT+HTTPCPOST
response returns the wrong command name if appended more post dataesp_at_port_write_data()
crashed if input length < 0AT+FS
commandSPI
: Fixed a global issue where incorrect length was returned when reading data by SPI (For example, AT+HTTPCPOST command cannot read out all the data from SPI due to wanted data length being returned instead of the actual data length)build.py
: Installed compilation environment depends on the targetbuild.py
: Used the python of esp-idf environment instead of external deprecated pythonat.py
Support modifying manufacturing NVSbuild.py
download.espressif.com
server to dl.espressif.com
serverDocumentation for Release v3.2.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v3.2.0.0/esp32c3/index.html
ESP32C3-AT v3.2.0.0 is a major update for ESP32C3-AT v2.4.2.0.
The firmwares:
This is the list of changes since release v2.4.2.0:
Breaking Changesesp-idf
version updated to release/v5.0 (24b9d38a)AT+SYSFLASH
: If you previously used v2.4.0.0 firmware and now directly flash v3.2.0.0 firmware, and MCU reads/writes parameters through AT+SYSFLASH
command, the two versions will return different data, causing incompatibility (because v2.4.0.0 reads/writes parameters using partition method, while v3.2.0.0 uses NVS method). You can choose any of the following methods to resolve the compatibility issue:
AT+SYSFLASH
command to read/write parameters; for v3.2.0.0 firmware version, use AT+SYSMFG
command to read/write parameters.RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4