Releases: espressif/esp-at
v2.2.0.0_esp32c3
ESP32-C3 AT Release v2.2.0.0
Documentation for Release v2.2.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v2.2.0.0_esp32c3/
ESP32-C3-MINI-1_AT_Bin_V2.2.0.0.zip
ESP32-C3 AT v2.2.0.0 is the first released firmware for ESP32-C3.
Known Issue
- AT command port will print several extra characters when the chip is restarted (affected commands: AT+RST, AT+RESTORE, AT+CIUPDATE)
- The set value of AT+RFPOWER command is inconsistent with the query value, when the value is greater than 80
Feature
Basic AT Commands
- AT: Test AT startup.
- AT+RST: Restart a module.
- AT+GMR: Check version information.
- AT+CMD: List all AT commands and types supported in current firmware.
- AT+GSLP: Enter Deep-sleep mode.
- ATE: Configure AT commands echoing.
- AT+RESTORE: Restore factory default settings of the module.
- AT+UART_CUR: Current UART configuration, not saved in flash.
- AT+UART_DEF: Default UART configuration, saved in flash.
- AT+SLEEP: Set the sleep mode.
- AT+SYSRAM: Query current remaining heap size and minimum heap size.
- AT+SYSMSG: Query/Set System Prompt Information.
- AT+USERRAM: Operate user’s free RAM.
- AT+SYSFLASH: Query/Set User Partitions in Flash.
- AT+FS: Filesystem Operations.
- AT+RFPOWER: Query/Set RF TX Power.
- AT+SYSROLLBACK: Roll back to the previous firmware.
- AT+SYSTIMESTAMP: Query/Set local time stamp.
- AT+SYSLOG: Enable or disable the AT error code prompt.
- AT+SLEEPWKCFG: Query/Set the light-sleep wakeup source and awake GPIO.
- AT+SYSSTORE: Query/Set parameter store mode.
- AT+SYSREG: Read/write the register.
Wi-Fi AT Commands
- AT+CWMODE: Set the Wi-Fi mode (Station/SoftAP/Station+SoftAP).
- AT+CWSTATE: Query the Wi-Fi state and Wi-Fi information.
- AT+CWJAP: Connect to an AP.
- AT+CWRECONNCFG: Query/Set the Wi-Fi reconnecting configuration.
- AT+CWLAPOPT: Set the configuration for the command AT+CWLAP.
- AT+CWLAP: List available APs.
- AT+CWQAP: Disconnect from an AP.
- AT+CWSAP: Query/Set the configuration of an ESP SoftAP.
- AT+CWLIF: Obtain IP address of the station that connects to an ESP SoftAP.
- AT+CWQIF: Disconnect stations from an ESP SoftAP.
- AT+CWDHCP: Enable/disable DHCP.
- AT+CWDHCPS: Query/Set the IP addresses allocated by an ESP SoftAP DHCP server.
- AT+CWAUTOCONN: Connect to an AP automatically when powered on.
- AT+CWAPPROTO: Query/Set the 802.11 b/g/n protocol standard of SoftAP mode.
- AT+CWSTAPROTO: Query/Set the 802.11 b/g/n protocol standard of station mode.
- AT+CIPSTAMAC: Query/Set the MAC address of an ESP station.
- AT+CIPAPMAC: Query/Set the MAC address of an ESP SoftAP.
- AT+CIPSTA: Query/Set the IP address of an ESP station.
- AT+CIPAP: Query/Set the IP address of an ESP SoftAP.
- AT+CWSTARTSMART: Start SmartConfig.
- AT+CWSTOPSMART: Stop SmartConfig.
- AT+WPS: Enable the WPS function.
- AT+MDNS: Configure the mDNS function.
- AT+CWJEAP: Connect to a WPA2 Enterprise AP.
- AT+CWHOSTNAME: Query/Set the host name of an ESP station.
- AT+CWCOUNTRY: Query/Set the Wi-Fi Country Code.
TCP/IP AT Commands
- AT+CIPV6: Enable/disable the network of Internet Protocol Version 6 (IPv6).
- AT+CIPSTATUS: Obtain the TCP/UDP/SSL connection status and information.
- AT+CIPDOMAIN: Resolve a Domain Name.
- AT+CIPSTART: Establish TCP connection, UDP transmission, or SSL connection.
- AT+CIPSTARTEX: Establish TCP connection, UDP transmission, or SSL connection with an automatically assigned ID.
- [Passthrough Mode Only] +++: Exit the passthrough mode.
- AT+CIPSEND: Send data in the normal transmission mode or Wi-Fi passthrough mode.
- AT+CIPSENDEX: Send data in the normal transmission mode in expanded ways.
- AT+CIPCLOSE: Close TCP/UDP/SSL connection.
- AT+CIFSR: Obtain the local IP address and MAC address.
- AT+CIPMUX: Enable/disable the multiple connections mode.
- AT+CIPSERVER: Delete/create a TCP/SSL server.
- AT+CIPSERVERMAXCONN: Query/Set the maximum connections allowed by a server.
- AT+CIPMODE: Query/Set the transmission mode.
- AT+SAVETRANSLINK: Set whether to enter Wi-Fi passthrough mode on power-up.
- AT+CIPSTO: Query/Set the local TCP Server Timeout.
- AT+CIPSNTPCFG: Query/Set the time zone and SNTP server.
- AT+CIPSNTPTIME: Query the SNTP time.
- AT+CIUPDATE: Upgrade the firmware through Wi-Fi.
- AT+CIPDINFO: Set “+IPD” message mode.
- AT+CIPSSLCCONF: Query/Set SSL clients.
- AT+CIPSSLCCN: Query/Set the Common Name of the SSL client.
- AT+CIPSSLCSNI: Query/Set SSL client Server Name Indication (SNI).
- AT+CIPSSLCALPN: Query/Set SSL client Application Layer Protocol Negotiation (ALPN).
- AT+CIPSSLCPSK: Query/Set SSL client Pre-shared Key (PSK).
- AT+CIPRECONNINTV: Query/Set the TCP/UDP/SSL reconnection interval for the Wi-Fi passthrough mode.
- AT+CIPRECVMODE: Query/Set socket receiving mode.
- AT+CIPRECVDATA: Obtain socket data in passive receiving mode.
- AT+CIPRECVLEN: Obtain socket data length in passive receiving mode.
- AT+PING: Ping the remote host.
- AT+CIPDNS: Query/Set DNS server information.
- AT+CIPTCPOPT: Query/Set the socket options.
MQTT AT Commands
- AT+MQTTUSERCFG: Set MQTT user configuration
- AT+MQTTCLIENTID: Set MQTT client ID
- AT+MQTTUSERNAME: Set MQTT username
- AT+MQTTPASSWORD: Set MQTT password
- AT+MQTTCONNCFG: Set configuration of MQTT connection
- AT+MQTTCONN: Connect to MQTT Brokers
- AT+MQTTPUB: Publish MQTT Messages in string
- AT+MQTTPUBRAW: Publish MQTT messages in binary
- AT+MQTTSUB: Subscribe to MQTT topics
- AT+MQTTUNSUB: Unsubscribe from MQTT topics
- AT+MQTTCLEAN: Close MQTT connections
HTTP AT Commands
- AT+HTTPCLIENT: Send HTTP Client Request
- AT+HTTPGETSIZE: Get HTTP Resource Size
- AT+HTTPCPOST: Post HTTP data of specified length
Web server AT Commands
- AT+WEBSERVER: Enable/disable Wi-Fi connection configuration via web server.
Driver AT Commands
- AT+DRVADC: Read ADC channel value.
- AT+DRVPWMINIT: Initialize PWM driver.
- AT+DRVPWMDUTY: Set PWM duty.
- AT+DRVPWMFADE: Set PWM fade.
- AT+DRVI2CINIT: Initialize I2C master driver.
- AT+DRVI2CRD: Read I2C data.
- AT+DRVI2CWRDATA: Write I2C data.
- AT+DRVI2CWRBYTES: Write no more than 4 bytes I2C data.
- AT+DRVSPICONFGPIO: Configure SPI GPIO.
- AT+DRVSPIINIT: Initialize SPI master driver.
- AT+DRVSPIRD: Read SPI data.
- AT+DRVSPIWR: Write SPI data.
v2.1.0.0_esp32s2
ESP32S2-AT v2.1.0.0 Release Notes
Documentation for Release v2.1.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v2.1.0.0_esp32s2/
ESP32-S2-WROOM_AT_Bin_V2.1.0.0.zip
ESP32-S2-WROVER_AT_Bin_V2.1.0.0.zip
ESP32-S2-SOLO_AT_Bin_V2.1.0.0.zip
ESP32-S2-MINI_AT_Bin_V2.1.0.0.zip
ESP32S2-AT v2.1.0.0 is the first released firmware for ESP32S2.
Feature
Basic AT Commands
- AT : Tests AT startup.
- AT+RST : Restarts a module.
- AT+GMR : Checks version information.
- ATE : Configures echoing of AT commands.
- AT+RESTORE : Restores the factory default settings of the module.
- AT+UART_CUR : Current UART configuration.
- AT+UART_DEF : Default UART configuration, saved in flash.
- AT+SYSRAM : Checks current remaining heap size and minimum heap size.
- AT+SYSMSG : Set message format.
- AT+RFPOWER : Set RF TX Power.
- AT+SYSFLASH : Set User Partitions in Flash.
- AT+SYSROLLBACK : Roll back to the previous firmware.
- AT+SYSTIMESTAMP: Set local time stamp.
- AT+SYSLOG : Enable or disable the AT error code prompt.
- AT+SYSSTORE : Config parameter store mode.
Wi-Fi AT Commands
- AT+CWMODE : Sets the Wi-Fi mode (STA/AP/STA+AP).
- AT+CWJAP : Connects to an AP.
- AT+CWLAPOPT : Sets the configuration of command AT+CWLAP.
- AT+CWLAP : Lists available APs.
- AT+CWQAP : Disconnects from the AP.
- AT+CWSAP : Sets the configuration of the ESP SoftAP.
- AT+CWLIF : Gets the Station IP to which the ESP SoftAP is connected.
- AT+CWQIF : Disconnect Station from the ESP SoftAP.
- AT+CWDHCP : Enables/disables DHCP.
- AT+CWDHCPS : Sets the IP range of the ESP SoftAP DHCP server.
- AT+CWAUTOCONN : Connects to the AP automatically on power-up.
- AT+CWAPPROTO : Sets the 802.11 b/g/n protocol standard of SoftAP mode.
- AT+CWSTAPROTO : Sets the 802.11 b/g/n protocol standard of station mode.
- AT+CIPSTAMAC : Sets the MAC address of ESP Station.
- AT+CIPAPMAC : Sets the MAC address of ESP SoftAP.
- AT+CIPSTA : Sets the IP address of ESP Station.
- AT+CIPAP : Sets the IP address of ESP SoftAP.
- AT+CWSTARTSMART : Starts SmartConfig.
- AT+CWSTOPSMART : Stops SmartConfig.
- AT+WPS : Enables the WPS function.
- AT+MDNS : Configurates the MDNS function
- AT+CWHOSTNAME : Configures the Name of ESP Station
- AT+CWCOUNTRY : Configures the Wi-Fi Country Code
TCP/IP AT Commands
- AT+CIPSTATUS : Gets the connection status.
- AT+CIPDOMAIN : Domain Name Resolution Function.
- AT+CIPSTART : Establishes TCP connection, UDP transmission or SSL connection.
- AT+CIPSTARTEX : Establishes TCP connection, UDP transmission or SSL connection with automatically assigned ID.
- AT+CIPSEND : Sends data.
- AT+CIPSENDEX : Sends data when length of data is , or when \0 appears in the data.
- AT+CIPCLOSE : Closes TCP/UDP/SSL connection.
- AT+CIFSR : Gets the local IP address.
- AT+CIPMUX : Configures the multiple connections mode.
- AT+CIPSERVER : Deletes/Creates TCP or SSL server.
- AT+CIPSERVERMAXCONN : Set the Maximum Connections Allowed by Server.
- AT+CIPMODE : Configures the transmission mode.
- AT+SAVETRANSLINK : Saves the transparent transmission link in flash.
- AT+CIPSTO : Sets timeout when ESP32 runs as a TCP server.
- AT+CIPSNTPCFG : Configures the time domain and SNTP server.
- AT+CIPSNTPTIME : Queries the SNTP time.
- AT+CIUPDATE : Updates the software through Wi-Fi.
- AT+CIPDINFO : Shows remote IP and remote port with +IPD.
- AT+CIPSSLCCONF : Config SSL client.
- AT+CIPRECONNINTV: Set Wi-Fi transparent transmitting auto-connect interval.
- AT+CIPRECVMODE: Set Socket Receive Mode.
- AT+CIPRECVDATA: Get Socket Data in Passive Receive Mode.
- AT+CIPRECVLEN: Get Socket Data Length in Passive Receive Mode.
- AT+PING: Ping Packets
- AT+CIPDNS : Configures Domain Name System.
- AT+CIPTCPOPT : Configurates the socket options.
MQTT AT Commands
- AT+MQTTUSERCFG : Set MQTT User Config
- AT+MQTTCLIENTID : Set MQTT Client ID
- AT+MQTTUSERNAME : Set MQTT Username
- AT+MQTTPASSWORD : Set MQTT Password
- AT+MQTTCONNCFG : Set configuration of MQTT Connection
- AT+MQTTCONN : Connect to MQTT Broker
- AT+MQTTPUB : Publish MQTT Data in string
- AT+MQTTPUBRAW : Publish MQTT message in binary
- AT+MQTTSUB : Subscribe to MQTT Topic
- AT+MQTTUNSUB : Unsubscribe from MQTT Topic
- AT+MQTTCLEAN : Close the MQTT Connection
HTTP AT Commands
- AT+HTTPCLIENT - Send HTTP Client Request
- AT+HTTPGETSIZE - Get HTTP Resource Size
v2.1.0.0_esp8266
ESP8266-AT Release v2.1.0.0
Documentation for Release v2.1.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v2.1.0.0_esp8266/
You can download the firmwares to try them, which support OTA from espressif‘s server.
ESP8266-AT v2.1.0.0 is a major update for ESP8266-AT v2.0.0.0.
This is the list of changes since ESP8266-AT Release v2.0.0.0.
SDK Update and Known issue
ESP8266_RTOS_SDKversion update to release v3.3(b6e861a).
1. New Feature & Change List
1.1 Wi-Fi
- AT+CWCOUNTRY: set and query the Wi-Fi country code.
- AT+CWSTAPROTO: set and query the 802.11 b/g/n protocol standard of station mode.
- AT+CWAPPROTO: set and query the 802.11 b/g/n protocol standard of SoftAP mode.
- AT+FACTPLCP: send with long or short PLCP.
- Support scan mode configuration in the command AT+CWJAP.
- Support automatically connect to the previous AP when station mode is enabled again by AT+CWMODE.
1.2 TCP/IP
- AT+CIPTCPOPT: set and query TCP socket options.
- AT+CIPSSLCCN: set and query SSL client common name.
- AT+CIPSSLCSNI: set and query SSL client server name indication.
- AT+CIPSSLCALPN: set and query SSL client application layer protocol negotiation.
- AT+CIPSSLCPSK: set and query SSL client pre-shared key.
- Support multicast in the command AT+CIPSTART.
- Support two-way authentication when create SSL.
1.3 MQTT
- AT+MQTTUSERCFG: set and query MQTT user configuration.
- AT+MQTTCLIENTID: Set and query MQTT client ID.
- AT+MQTTUSERNAME: set and query MQTT username.
- AT+MQTTPASSWORD: set and query MQTT password.
- AT+MQTTCONNCFG: set and query configuration of MQTT Connection.
- AT+MQTTCONN: Connect to MQTT Broker.
- AT+MQTTPUB: Publish MQTT Data in string format.
- AT+MQTTPUBRAW: Publish MQTT message in binary-coded format.
- AT+MQTTSUB: Subscribe MQTT Topic.
- AT+MQTTUNSUB: Unsubscribe from MQTT Topic.
- AT+MQTTCLEAN: Close the MQTT Connection.
1.4 HTTP
- AT+HTTPCLIENT: send HTTP client request.
- AT+HTTPGETSIZE: get HTTP resource size.
1.5 System
- AT+SYSLOG: enable or disable the AT error code prompt.
- AT+SYSSTORE: configure parameter store mode.
- AT+SYSTIMESTAMP: Set local timestamp.
- AT+SYSROLLBACK: roll back to the previous firmware.
- AT+SYSFLASH: set and query user partitions in Flash.
- Support
make SILENCE=1to disable log for saving flash space. - Support ESP8266 power save management.
- Support ESP8266 1MB module without OTA.
- Adjust partition table for more features.
- Adjust AT+RFPOWER command.
2. Bugfix
2.1 Wi-Fi
- Fix AT+CWLAP scans fail sometimes.
- Fix the range of AT+CIPRECONNINTV to be [1, 36000].
- Fix AT+RFPOWER set fail when Wi-Fi commands are disabled.
- Fix incorrect Wi-Fi state when AT+CWJAP failed.
- Fix missing Wi-Fi status information if AT+CIPMODE=1.
2.2 System
- Fix AT responses OK even if command ends with CR.
- Fix AT+SYSMSG parameter check.
- Fix
make factory_bingenerates an incorrect bin when flash works in 80MHz mode. - Fix UART parity configuration error.
2.3 Others
- Fix incorrect last DNS configuration in command AT+CIPDNS.
- Fix the incorrect returned value of DNS command.
- Fix the incorrect response value of SNTP command.
3. Optimization
- Optimize TCP/IP process workflow.
- Optimize Wi-Fi process workflow.
v2.1.0.0_esp32
ESP32-AT Release v2.1.0.0
Documentation for Release v2.1.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v2.1.0.0_esp32/
You can download the firmwares to try them, which support OTA from espressif‘s server.
ESP32-WROOM-32_AT_Bin_V2.1.0.0.zip
ESP32-WROVER_AT_Bin_V2.1.0.0.zip
ESP32-PICO-D4_AT_Bin_V2.1.0.0.zip
ESP32-SOLO_AT_Bin_V2.1.0.0.zip
ESP32-AT v2.1.0.0 is a major update for ESP32-AT v2.0.0.0.
This is the list of changes since ESP32-AT Release v2.0.0.0.
SDK Update and Known issue
- Wakeup fail from light sleep
1.Feature
- esp-idf version update to release v4.0(e7ac221b)
1.1 WiFi
- AT+CWCOUNTRY: configurate and query the WiFi country code
- AT+CWSTAPROTO: set and query the 802.11 b/g/n protocol standard of station mode
- AT+CWAPPROTO: set and query the 802.11 b/g/n protocol standard of SoftAP mode
- Support automatically connect to AP in the command AT+CWMODE after changed to station mode
- Support scan mode configuration in the command AT+CWJAP
1.2 TCP/IP
- AT+CIPTCPOPT: configurate and query the TCP socket options, include SO_LINGER, TCP_NODELAY, SO_SNDTIMEO options
- Support multicast address in the command AT+CIPSTART
1.3 TLS
- AT+CIPSSLCCN: configurate and query SSL client common name(CN)
- AT+CIPSSLCSNI: configurate and query SSL client server name indication(SNI)
- AT+CIPSSLCALPN: configurate and query SSL client application layer protocol negotiation(ALPN)
- AT+CIPSSLCPSK: configurate and query SSL client pre-shared key(PSK)
1.4 BT & BLE
- Enable BLE HID commands by default
- AT+BTCOD: Configure class of BT device
- AT+BLUFI: start and stop BLUFI function(configure Wi-Fi information by ble)
- AT+BLEADVDATAEX: set BLE advertising data automatically
- Add AT+BTSCANMODE query command: query BT scan mode
- Add AT+BLEGATTSSRVCRE multiple services
- Support scan filter in the command AT+BLESCAN
- Support discoverable but not connectable mode in the command AT+BTSCANMODE
- Support retransmission for BT SPP
- Support some BT and BLE parameters store to flash
- Support BLE connection callback for user to customize it
1.5 MQTT
- Enable MQTT commands by default
- AT+MQTTCLIENTID: set and query MQTT client ID
- AT+MQTTUSERNMAE: set and query MQTT username
- AT+MQTTPASSWORD: set and query MQTT password
- Add AT+MQTTUSERCFG query command
- Add AT+MQTTCONNCFG query command
- Add AT+MQTTUSERNAME query command
- Add AT+MQTTCLIENDID query command
- Add AT+MQTTPASSWORD query command
- Add MQTT authentication method configuration in menuconfig
1.6 HTTP
- Enable HTTP commands by default
- AT+HTTPGETSIZE: get HTTP resource size
- Support custom request headers in the command AT+HTTPCLIENT
1.7 System
- AT+SLEEPWKCFG: configurate the light-sleep wakeup source and awake GPIO
- AT+SYSSTORE: control if store parameter into flash
- Separate WPS, PING, SmartConfig and MDNS commands in menuconfig
- Support cmake to compile esp-at project
- OTA use esp-tls instead of openSSL
- Add uart port configuration in the factory parameter binary
- change factory parameter version to v2
1.8 Example
- Add STM32 example for SDIO SPI AT
- Add STM32 SDIO host example
2. Bugfix
2.1 WiFi
- Fix AT+RFPOWER set failed when disable WiFi command
- Fix AT+CWLAP scan fail when WiFi is connecting
- Fix missing WiFi status information if AT+CIPMODE=1
- Fix WiFi state is error after AT+CWJAP failed
- Fix AT+CIPRECONNINTV set range [1, 36000]
2.3 UART
- Fix UART parity configuration error
2.4 BT & BLE
- Fix crash if the notification value of ble is too long
- Fix BLE service discovery works bad in multiple connections status
- Fix crash when re-create BLE services
- Fix re-enter BLE SPP fail
- Fix AT+BLESCAN=2 return OK
- Fix hid init fail
- Fix the data is lost when in BLE SPP
- Fix exit from bluetooth throughput mode failed
- Fix gatt server re-enter spp mode fail
- Fix write characteristic value fail
- Fix exit automatically reconnect status fail after terminating BLE spp mode
- Fix establish a new connection fail after ble connection timeout
- Fix BT default device name is empty
- Fix BT scan result is out of order
- Fix BT SPP exit throughput mode fail after disconnection
- Fix some MAC address informations is missing quotes
2.5 MQTT
- Fix crash when running AT+MQTTCONN?
- Fix crash when running AT+MQTTPUB if the data is too long
- Fix block when running AT+MQTTPUB
- Fix crash when MQTT is disconnected
- Fix MQTT can not automatically reconnect
- Fix crash when running AT+MQTTPUBRAW if the topic length is too long
- Fix the length of the topic is error if the received MQTT data is too large
- Fix AT+MQTTPUB failed when WiFi is reconnected
- Fix the length of the data for AT+MQTTPUBRAW is limited
- Fix the state responded by AT+MQTTCONN? is error when WiFi is reconnected
- Fix AT+MQTTCONN fails when MQTT close and re-build the link
- Fix crash when running AT+MQTTCONNCFG if mqtt is disconnected
- Fix crash when mqtt is established if Wi-Fi is reconnected
2.6 HTTP
- Fix print the data downloaded by HTTP error
- Fix check if http transport type is valid in the command AT+HTTPCLIENT
- Fix crash if some URL is special in the command AT+HTTPCLIENT
2.7 System
- Fix busy sometimes after AT+CIPSEND returned OK
- Fix incorrect information in the factory_parameter.log if module name not defined
- Fix AT command end with CR responses OK
- Fix missing "+QUIT" when quit transmission mode if AT+SYSMSG=1
- Fix AT+CIPSTATUS state unmatched when WiFi disconnected
- Fix AT+SYSMSG parameter check
2.8 DNS
- Fix the last DNS configuration is error when running AT+CIPDNS
2.9 PING
- Fix it returns ERROR when running AT+PING
Optimizations
- Optimize sockets process workflow
- Optimize AT+CIPSTATUS command process
- Optimize transmit terminal process
- check the default max tx power validity
v2.1.0.0-rc2_esp32
#ESP32-AT Relase v2.1.0.0-rc2
Documentation for Relase v2.1.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v2.1.0.0_esp32/
You can download the firmwares to try them, which support OTA from espressif‘s server.
ESP32-WROVER_AT_Bin_V2.1.0.0_rc2.zip
ESP32-WROOM_AT_Bin_V2.1.0.0_rc2.zip
ESP32-PICO-D4_AT_Bin_V2.1.0.0_rc2.zip
ESP32-SOLO-1_AT_Bin_V2.1.0.0_rc2.zip
ESP32-AT v2.1.0.0-rc2 is a major update for ESP32-AT v2.0.0.0.
This is the list of changes since ESP32-AT Relase v2.0.0.0.
SDK Update and Known issue
- Wakeup fail from light sleep
1.Feature
- esp-idf version update to release v4.0(e7ac221b)
1.1 WiFi
- AT+CWCOUNTRY: configurate and query the WiFi country code
- AT+CWSTAPROTO: set and query the 802.11 b/g/n protocol standard of station mode
- AT+CWAPPROTO: set and query the 802.11 b/g/n protocol standard of SoftAP mode
- Support automatically connect to AP in the command AT+CWMODE after changed to station mode
- Support scan mode configuration in the command AT+CWJAP
1.2 TCP/IP
- AT+CIPTCPOPT: configurate and query the TCP socket options, include SO_LINGER, TCP_NODELAY, SO_SNDTIMEO options
- Support multicast address in the command AT+CIPSTART
1.3 TLS
- AT+CIPSSLCCN: configurate and query SSL client common name(CN)
- AT+CIPSSLCSNI: configurate and query SSL client server name indication(SNI)
- AT+CIPSSLCALPN: configurate and query SSL client application layer protocol negotiation(ALPN)
- AT+CIPSSLCPSK: configurate and query SSL client pre-shared key(PSK)
1.4 BT & BLE
- Enable BLE HID commands by default
- AT+BTCOD: Configure class of BT device
- AT+BLUFI: start and stop BLUFI function(configure Wi-Fi information by ble)
- AT+BLEADVDATAEX: set BLE advertising data automatically
- Add AT+BTSCANMODE query command: query BT scan mode
- Add AT+BLEGATTSSRVCRE multiple services
- Support scan filter in the command AT+BLESCAN
- Support discoverable but not connectable mode in the command AT+BTSCANMODE
- Support retransmission for BT SPP
- Support some BT and BLE parameters store to flash
- Support BLE connection callback for user to customize it
1.5 MQTT
- Enable MQTT commands by default
- AT+MQTTCLIENTID: set and query MQTT client ID
- AT+MQTTUSERNMAE: set and query MQTT username
- AT+MQTTPASSWORD: set and query MQTT password
- Add AT+MQTTUSERCFG query command
- Add AT+MQTTCONNCFG query command
- Add AT+MQTTUSERNAME query command
- Add AT+MQTTCLIENDID query command
- Add AT+MQTTPASSWORD query command
- Add MQTT authentication method configuration in menuconfig
1.6 HTTP
- Enable HTTP commands by default
- AT+HTTPGETSIZE: get HTTP resource size
- Support custom request headers in the command AT+HTTPCLIENT
1.7 System
- AT+SLEEPWKCFG: configurate the light-sleep wakeup source and awake GPIO
- AT+SYSSTORE: control if store parameter into flash
- Separate WPS, PING, SmartConfig and MDNS commands in menuconfig
- Support cmake to compile esp-at project
- OTA use esp-tls instead of openSSL
- Add uart port configuration in the factory parameter binary
- change factory parameter version to v2
1.8 Example
- Add STM32 example for SDIO SPI AT
- Add STM32 SDIO host example
2. Bugfix
2.1 WiFi
- Fix AT+RFPOWER set failed when disable WiFi command
- Fix AT+CWLAP scan fail when WiFi is connecting
- Fix missing WiFi status information if AT+CIPMODE=1
- Fix WiFi state is error after AT+CWJAP failed
- Fix AT+CIPRECONNINTV set range [1, 36000]
2.3 UART
- Fix UART parity configuration error
2.4 BT & BLE
- Fix crash if the notification value of ble is too long
- Fix BLE service discovery works bad in multiple connections status
- Fix crash when re-create BLE services
- Fix re-enter BLE SPP fail
- Fix AT+BLESCAN=2 return OK
- Fix hid init fail
- Fix the data is lost when in BLE SPP
- Fix exit from bluetooth throughput mode failed
- Fix gatt server re-enter spp mode fail
- Fix write characteristic value fail
- Fix exit automatically reconnect status fail after terminating BLE spp mode
- Fix establish a new connection fail after ble connection timeout
- Fix BT default device name is empty
- Fix BT scan result is out of order
- Fix BT SPP exit throughput mode fail after disconnection
- Fix some MAC address informations is missing quotes
2.5 MQTT
- Fix crash when running AT+MQTTCONN?
- Fix crash when running AT+MQTTPUB if the data is too long
- Fix block when running AT+MQTTPUB
- Fix crash when MQTT is disconnected
- Fix MQTT can not automatically reconnect
- Fix crash when running AT+MQTTPUBRAW if the topic length is too long
- Fix the length of the topic is error if the received MQTT data is too large
- Fix AT+MQTTPUB failed when WiFi is reconnected
- Fix the length of the data for AT+MQTTPUBRAW is limited
- Fix the state responded by AT+MQTTCONN? is error when WiFi is reconnected
- Fix AT+MQTTCONN fails when MQTT close and re-build the link
- Fix crash when running AT+MQTTCONNCFG if mqtt is disconnected
- Fix crash when mqtt is established if Wi-Fi is reconnected
2.6 HTTP
- Fix print the data downloaded by HTTP error
- Fix check if http transport type is valid in the command AT+HTTPCLIENT
- Fix crash if some URL is special in the command AT+HTTPCLIENT
2.7 System
- Fix busy sometimes after AT+CIPSEND returned OK
- Fix incorrect information in the factory_parameter.log if module name not defined
- Fix AT command end with CR responses OK
- Fix missing "+QUIT" when quit transmission mode if AT+SYSMSG=1
- Fix AT+CIPSTATUS state unmatched when WiFi disconnected
- Fix AT+SYSMSG parameter check
2.8 DNS
- Fix the last DNS configuration is error when running AT+CIPDNS
2.9 PING
- Fix it returns ERROR when running AT+PING
Optimizations
- Optimize sockets process workflow
- Optimize AT+CIPSTATUS command process
- Optimize transmit terminal process
- check the default max tx power validity
v2.1.0.0-rc1_esp8266
ESP8266-AT Release v2.1.0.0-rc1
Documentation for Release v2.1.0.0-rc1 is available at https://docs.espressif.com/projects/esp-at/en/release-v2.1.0.0_esp8266/
You can download ESP8266-IDF-AT_V2.1.0_0_RC1.zip to try it, and this firmware supports OTA from espressif‘s server.
ESP8266-AT v2.1.0.0-rc1 is a major update for ESP8266-AT v2.0.0.0.
This is the list of changes since ESP8266-AT Release v2.0.0.0.
SDK Update and Known issue
ESP8266_RTOS_SDKversion update to release v3.3(b6e861a).
1. New Feature & Change List
1.1 Wi-Fi
- AT+CWCOUNTRY: set and query the Wi-Fi country code.
- AT+CWSTAPROTO: set and query the 802.11 b/g/n protocol standard of station mode.
- AT+CWAPPROTO: set and query the 802.11 b/g/n protocol standard of SoftAP mode.
- AT+FACTPLCP: send with long or short PLCP.
- Support scan mode configuration in the command AT+CWJAP.
- Support automatically connect to the previous AP when station mode is enabled again by AT+CWMODE.
1.2 TCP/IP
- AT+CIPTCPOPT: set and query TCP socket options.
- AT+CIPSSLCCN: set and query SSL client common name.
- AT+CIPSSLCSNI: set and query SSL client server name indication.
- AT+CIPSSLCALPN: set and query SSL client application layer protocol negotiation.
- AT+CIPSSLCPSK: set and query SSL client pre-shared key.
- Support multicast in the command AT+CIPSTART.
- Support two-way authentication when create SSL.
1.3 MQTT
- AT+MQTTUSERCFG: set and query MQTT user configuration.
- AT+MQTTCLIENTID: Set and query MQTT client ID.
- AT+MQTTUSERNAME: set and query MQTT username.
- AT+MQTTPASSWORD: set and query MQTT password.
- AT+MQTTCONNCFG: set and query configuration of MQTT Connection.
- AT+MQTTCONN: Connect to MQTT Broker.
- AT+MQTTPUB: Publish MQTT Data in string format.
- AT+MQTTPUBRAW: Publish MQTT message in binary-coded format.
- AT+MQTTSUB: Subscribe MQTT Topic.
- AT+MQTTUNSUB: Unsubscribe from MQTT Topic.
- AT+MQTTCLEAN: Close the MQTT Connection.
1.4 HTTP
- AT+HTTPCLIENT: send HTTP client request.
- AT+HTTPGETSIZE: get HTTP resource size.
1.5 System
- AT+SYSLOG: enable or disable the AT error code prompt.
- AT+SYSSTORE: configure parameter store mode.
- AT+SYSTIMESTAMP: Set local timestamp.
- AT+SYSROLLBACK: roll back to the previous firmware.
- AT+SYSFLASH: set and query user partitions in Flash.
- Support
make SILENCE=1to disable log for saving flash space. - Support ESP8266 power save management.
- Support ESP8266 1MB module without OTA.
- Adjust partition table for more features.
- Adjust AT+RFPOWER command.
2. Bugfix
2.1 Wi-Fi
- Fix AT+CWLAP scans fail sometimes.
- Fix the range of AT+CIPRECONNINTV to be [1, 36000].
- Fix AT+RFPOWER set fail when Wi-Fi commands are disabled.
- Fix incorrect Wi-Fi state when AT+CWJAP failed.
- Fix missing Wi-Fi status information if AT+CIPMODE=1.
2.2 System
- Fix AT responses OK even if command ends with CR.
- Fix AT+SYSMSG parameter check.
- Fix
make factory_bingenerates an incorrect bin when flash works in 80MHz mode. - Fix UART parity configuration error.
2.3 Others
- Fix incorrect last DNS configuration in command AT+CIPDNS.
- Fix the incorrect returned value of DNS command.
- Fix the incorrect response value of SNTP command.
3. Optimization
- Optimize TCP/IP process workflow.
- Optimize Wi-Fi process workflow.
v2.1.0.0-rc1_esp32
ESP32-AT Release v2.1.0.0-rc1
Documentation for Release v2.1.0.0 is available at https://docs.espressif.com/projects/esp-at/en/release-v2.1.0.0_esp32/
ESP32-AT v2.1.0.0-rc1 is a major update for ESP32-AT v2.0.0.0.
This is the list of changes since ESP32-AT releases v2.0.0.0.
SDK Update and Known issue
- It may wakeup fail from light sleep.
1.Feature
- ESP-IDF version update to release v4.0(e7ac221b).
1.1 Wi-Fi
- AT+CWCOUNTRY: configurate and query the WiFi country code.
- AT+CWSTAPROTO: set and query the 802.11 b/g/n protocol standard of station mode.
- AT+CWAPPROTO: set and query the 802.11 b/g/n protocol standard of SoftAP mode
- Support automatically connect to the previous AP when station mode is enabled again by AT+CWMODE.
- Support scan mode configuration in the command AT+CWJAP.
1.2 TCP/IP
- AT+CIPTCPOPT: configurate and query the TCP socket options, include SO_LINGER, TCP_NODELAY, SO_SNDTIMEO options.
- Support multicast address in the command AT+CIPSTART.
1.3 TLS
- AT+CIPSSLCCN: configurate and query SSL client common name(CN).
- AT+CIPSSLCSNI: configurate and query SSL client server name indication(SNI).
- AT+CIPSSLCALPN: configurate and query SSL client application layer protocol negotiation(ALPN).
- AT+CIPSSLCPSK: configurate and query SSL client pre-shared key(PSK).
1.4 BT & BLE
- Enable BLE HID commands by default.
- AT+BTCOD: Configure class of BT device.
- AT+BLUFI: start and stop BLUFI function(configure Wi-Fi information by BLE).
- AT+BLEADVDATAEX: set BLE advertising data automatically.
- Add query command of AT+BTSCANMODE, to query BT scan mode.
- Support multiple services in AT+BLEGATTSSRVCRE.
- Support scan filter in command AT+BLESCAN.
- Support discoverable but not connectable mode in command AT+BTSCANMODE.
- Support BT Pair Compare key.
- Support retransmission for BT SPP.
- Support store some BT and BLE parameters to flash.
- Support BLE connection callback for user to customize it.
1.5 MQTT
- Enable MQTT commands by default.
- AT+MQTTCLIENTID: set and query MQTT client ID
- AT+MQTTUSERNMAE: set and query MQTT username
- AT+MQTTPASSWORD: set and query MQTT password
- Add query command for AT+MQTTUSERCFG.
- Add query command for AT+MQTTCONNCFG.
- Add query command for AT+MQTTUSERNAME.
- Add query command for AT+MQTTCLIENDID.
- Add query command for AT+MQTTPASSWORD.
- Add MQTT authentication method configuration in menuconfig.
1.6 HTTP
- Enable HTTP commands by default.
- AT+HTTPGETSIZE: get HTTP resource size.
- Support custom request headers in the command AT+HTTPCLIENT.
1.7 System
- AT+SLEEPWKCFG: configurate the light-sleep wakeup source and awake GPIO.
- AT+SYSSTORE: to set whether store parameters into flash or not.
- Separate WPS, PING, SmartConfig and MDNS commands in menuconfig.
- Support cmake to compile esp-at project.
- Use ESP-TLS instead of openSSL when OTA via SSL.
- Add UART port configuration in the factory parameter binary.
- Change factory parameter version to v2.
1.8 Example
- Add STM32 example for SDIO SPI AT.
- Add STM32 SDIO host example.
2. Bugfix
2.1 Wi-Fi
- Fix AT+RFPOWER set fail when Wi-Fi commands are disabled.
- Fix AT+CWLAP scan fail while it is connecting Wi-Fi.
- Fix incorrect Wi-Fi state when AT+CWJAP failed.
- Fix the range of AT+CIPRECONNINTV to be [1, 36000].
- Add missing Wi-Fi status information if AT+CIPMODE=1.
2.3 UART
- Fix UART parity configuration error.
2.4 BT & BLE
- Fix crash issue when the BLE notification value is too long.
- Fix crash issue when re-create BLE services.
- Fix re-enter BLE SPP fail.
- Fix AT+BLESCAN incorrect parameter issue.
- Fix HID init fail.
- Fix data lost issue in BLE SPP.
- Fix exit from bluetooth throughput mode failed
- Optimize BLE service discovery in multiple connections status.
2.5 MQTT
- Fix MQTT crash issue.
- Fix a block issue of AT+MQTTPUB
- Fix MQTT can not automatically reconnect.
- Fix incorrect topic length if the received MQTT data is too long.
- Fix AT+MQTTPUB fail when Wi-Fi is reconnected.
- Fix the limited data length of AT+MQTTPUBRAW.
- Fix the incorrect state responded by AT+MQTTCONN? when Wi-Fi is reconnected.
- Fix AT+MQTTCONN fail when MQTT closes and re-builds the link.
2.6 HTTP
- Fix print error of HTTP-download data.
- Add check of http transport type in the command AT+HTTPCLIENT.
- Fix a crash issue of some special URL in the command AT+HTTPCLIENT.
2.7 System
- Fix probable busy issue after AT+CIPSEND returns OK.
- Fix incorrect information in the factory_parameter.log if module name is not defined.
- Fix an AT command response error.
- Fix incorrect AT+CIPSTATUS state when Wi-Fi disconnected.
- Add missing "+QUIT" message when quit transmission mode and AT+SYSMSG=1
2.8 DNS
- Fix an issue of incorrect last DNS configuration in command AT+CIPDNS.
2.9 PING
- Fix an error of AT+PING
Optimizations
- Optimize sockets process workflow.
- Optimize AT+CIPSTATUS command process.
- Optimize transmit terminal process.
- Check the default max TX power's validity.
v2.0.0.0_esp32
ESP32_AT_V2.0.0.0 Release Note
Documentation:
esp32_at_instruction_set_and_examples_en.pdf or
esp32_at_instruction_set_and_examples_cn.pdf.
Feature
- Update ESP-IDF to version 3.3(6ccb4cf5).
Base command
- AT+SYSROLLBACK: Roll back to the previous firmware.
- AT+SYSTIMESTAMP: Set local time stamp.
Wi-Fi command
- AT+CWHOSTNAME: Configures the host name of ESP station
- AT+CWQIF: Disconnect station from the ESP softAP.
- Update command AT+CWJAP, add a parameter of listen interval
TCPIP command
- AT+CIPSTARTEX: Establishes TCP connection, UDP transmission or SSL connection by auto assigning ID.
- AT+CIPSSLCCONF: Config SSL client.
- AT+CIPRECONNINTV: Set the interval of auto-reconnecting in Wi-Fi UART passthrough mode.
- AT+CIPRECVMODE: Set socket receive Mode.
- AT+CIPRECVDATA: Get socket data in passive receive mode.
- AT+CIPRECVLEN: Get socket data length in passive receive mode.
- AT+PING: Ping packets
- AT+CIPDNS: Configures Domain Name System. The configuration will be saved in flash
- Update command AT+CIUPDATE, support SSL OTA and version parameter
BLE command
- AT+BLESETKEY: Set BLE static pair key
- AT+BLEHIDINIT: BLE HID device profile initialization
- AT+BLEHIDKB: Send BLE HID Keyboard information
- AT+BLEHIDMUS: Send BLE HID mouse information
- AT+BLEHIDCONSUMER: Send BLE HID consumer information
Classic Bluetooth command
- AT+BTINIT : Classic Bluetooth initialization
- AT+BTNAME : Sets BT device's name
- AT+BTSCANMODE : Sets BT SCAN mode
- AT+BTSTARTDISC : Start BT discovery
- AT+BTSPPINIT : Classic Bluetooth SPP profile initialization
- AT+BTSPPCONN : Establishes SPP connection
- AT+BTSPPDISCONN : Ends SPP connection
- AT+BTSPPSTART : Start Classic Bluetooth SPP profile
- AT+BTSPPSEND : Sends data to remote bt spp device
- AT+BTA2DPINIT : Classic Bluetooth A2DP profile initialization
- AT+BTA2DPCONN : Establishes A2DP connection
- AT+BTA2DPDISCONN : Ends A2DP connection
- AT+BTA2DPSRC : Set or query the audio file URL
- AT+BTA2DPCTRL : control the audio play
- AT+BTSECPARAM :Set and query the Classic Bluetooth security parameters
- AT+BTKEYREPLY :Input the Simple Pair Key
- AT+BTPINREPLY :Input the Legacy Pair PIN Code
- AT+BTSECCFM: Reply the confirm value to the peer device in the legacy connection stage
- AT+BTENCDEV : Query BT encryption device list
- AT+BTENCCLEAR : Clear BT encryption device list
MQTT command
- AT+MQTTUSERCFG : Set MQTT User Config
- AT+MQTTCONNCFG : Set configuration of MQTT Connection
- AT+MQTTCONN : Connect to MQTT Broker
- AT+MQTTPUB : Publish MQTT Data in string
- AT+MQTTPUBRAW : Publish MQTT message in binary
- AT+MQTTSUB : Subscribe to MQTT Topic
- AT+MQTTUNSUB : Unsubscribe from MQTT Topic
- AT+MQTTCLEAN : Close the MQTT Connection
HTTP command
- AT+HTTPCLIENT - Send HTTP Client Request
Bugfix
- fix: It may crash if AT command ends without '\r\n'
- fix: Sometimes it may fail to quit from UART-WiFi passthrough mode
- fix: AT+CIPSTART does not work if just enable ethernet
Optimizations
- Add "\r\n" to the end of the +IPD for that MCU distinguishes the new command easily
v2.0.0.0_esp8266
ESP8266_AT_V2.0.0.0 Release Note
This is the first release of ESP8266 RTOS AT firmware, which supports AT commands through UART. Here is a list of AT commands. More details please refer to README.md
Basic AT Commands List.
- AT : Tests AT startup.
- AT+RST : Restarts a module.
- AT+GMR : Checks version information.
- AT+GSLP : Enters Deep-sleep mode.
- ATE : Configures echoing of AT commands.
- AT+RESTORE : Restores the factory default settings of the module.
- AT+UART_CUR : Current UART configuration.
- AT+UART_DEF : Default UART configuration, saved in flash.
- AT+SLEEP : Sets the sleep mode.
- AT+SYSRAM : Checks the remaining space of RAM.
- AT+SYSMSG : Set message format.
- AT+RFPOWER : Set RF TX Power.
Wi-Fi AT Commands List
- AT+CWMODE : Sets the Wi-Fi mode (STA/AP/STA+AP).
- AT+CWJAP : Connects to an AP.
- AT+CWLAPOPT : Sets the configuration of command AT+CWLAP.
- AT+CWLAP : Lists available APs.
- AT+CWQAP : Disconnects from the AP.
- AT+CWSAP : Sets the configuration of the ESP32 SoftAP.
- AT+CWLIF : Gets the Station IP to which the ESP32 SoftAP is connected.
- AT+CWDHCP : Enables/disables DHCP.
- AT+CWDHCPS : Sets the IP range of the ESP32 SoftAP DHCP server. Saves the setting in flash.
- AT+CWAUTOCONN : Connects to the AP automatically on power-up.
- AT+CIPSTAMAC : Sets the MAC address of ESP32 Station.
- AT+CIPAPMAC : Sets the MAC address of ESP32 SoftAP.
- AT+CIPSTA : Sets the IP address of ESP32 Station.
- AT+CIPAP : Sets the IP address of ESP32 SoftAP.
- AT+CWSTARTSMART : Starts SmartConfig.
- AT+CWSTOPSMART : Stops SmartConfig.
- AT+WPS : Enables the WPS function.
- AT+MDNS : Configurates the MDNS function
TCP/IP-Related AT Commands List
- AT+CIPSTATUS : Gets the connection status.
- AT+CIPDOMAIN : DNS function.
- AT+CIPSTART : Establishes TCP connection, UDP transmission or SSL connection.
- AT+CIPSEND : Sends data.
- AT+CIPSENDEX : Sends data when length of data is , or when \0 appears in the data.
- AT+CIPCLOSE : Closes TCP/UDP/SSL connection.
- AT+CIFSR : Gets the local IP address.
- AT+CIPMUX : Configures the multiple connections mode.
- AT+CIPSERVER : Deletes/Creates TCP or SSL server.
- AT+CIPSERVERMAXCONN : Set the Maximum Connections Allowed by Server.
- AT+CIPMODE : Configures the transmission mode.
- AT+SAVETRANSLINK : Saves the transparent transmission link in flash.
- AT+CIPSTO : Sets timeout when ESP32 runs as a TCP server.
- AT+CIPSNTPCFG : Configures the time domain and SNTP server.
- AT+CIPSNTPTIME : Queries the SNTP time.
- AT+CIUPDATE : Updates the software through Wi-Fi.
- AT+CIPDINFO : Shows remote IP and remote port with +IPD.
v1.2.0.0
ESP32 AT V1.2.0.0 Release Note
Documentation
Features
- Update version number to ESP-IDF v3.2.0
- Solve an issue that an ESP device working in SoftAP may reboot unexpectedly under certain special environment.
- Support multiple BLE connections, with a maximum connection number of 3.
Bug fixes
- Fix a bug that an SSL connection is sometimes established even when the CA certificate is incorrect.
- Fix a bug that the auto connecting sometimes fails in the UART-WiFi throughput mode.
- Fix a bug that the URC message that indicates Wi-Fi is disconnected may get lost, when the Wi-Fi router is turned off unexpectedly.
- Fix a bug that the BLE sometimes fails to write Characteristic values, when this remote Characteristic supports multiple properties.
- Fix a bug that the BLE connection parameters sometimes are still inquired even when the BLE connection is ended already.
- Fix a bug that is related to setting the BLE scan parameters.
- Fix a bug that the command of establishing a BLE connection may get stuck.
- Revise the document for the description of the BLE security parameter.