Espressif Systems ESP8266 SDK Einrichtungshandbuch

ESP8266 AT Instruction Set

Version 0.24

Espressif Systems IOT Team

! ! " !

Espressif Systems

ESP8266 AT Instruction Set

Disclaimer and Copyright Notice

Information in this document, including URL references, is subject to change without notice.

THIS DOCUMENT IS PROVIDED AS IS WITH NO WARRANTIES WHATSOEVER, INCLUDING ANY

WARRANTY OF MERCHANTABILITY, NON-INFRINGEMENT, FITNESS FOR ANY PARTICULAR

PURPOSE, OR ANY WARRANTY OTHERWISE ARISING OUT OF ANY PROPOSAL, SPECIFICATION

OR SAMPLE. All liability, including liability for infringement of any proprietary rights, relating to use

of information in this document is disclaimed. No licenses express or implied, by estoppel or

otherwise, to any intellectual property rights are granted herein.

The WiFi Alliance Member Logo is a trademark of the WiFi Alliance.

All trade names, trademarks and registered trademarks mentioned in this document are property of

their respective owners, and are hereby acknowledged.

Espressif Systems Conﬁdential /Friday, May 22, 20152 54

! ! " !

Espressif Systems

ESP8266 AT Instruction Set

1. Preambles 6...................................................................................................

2. Command Description 7...............................................................................

3. Basic AT Command Set 8.............................................................................

3.1. Overview!8"..................................................................................................

3.2. Commands!8"..............................................................................................

1. AT – Test AT startup !8................................................................................

2. AT+RST – Restart module!9........................................................................

3. AT+GMR – View version info!9....................................................................

4. AT+GSLP – Enter deep-sleep mode!9........................................................

5. ATE – AT commands echo!10.....................................................................

6. AT+RESTORE – Factory reset!10................................................................

7. AT+UART – UART conﬁguration!10.............................................................

8. AT+UART_CUR – current UART conﬁguration!11.......................................

9. AT+UART_DEF – default UART conﬁguration!12.........................................

10. AT+SLEEP – sleep mode!13.......................................................................

11. AT+RFPOWER – set RF TX Power!13.........................................................

12. AT+RFVDD – set RF TX Power according to VDD33!14..............................

4. WiFi Functions Overview 15.........................................................................

4.1. Commands!17"............................................................................................

1. AT+CWMODE – WiFi mode!17....................................................................

2. AT+CWMODE_CUR – current WiFi mode !18..............................................

3. AT+CWMODE_DEF – default WiFi mode!19................................................

4. AT+CWJAP – Connect to AP!20..................................................................

5. AT+CWJAP_CUR – Connect to AP，for current!21.....................................

6. AT+CWJAP_DEF – Connect to AP，save as default!22...............................

7. AT+CWLAP – List available APs !23.............................................................

8. AT+CWQAP – Disconnect from AP!23.........................................................

9. AT+CWSAP – Conﬁguration of softAP mode!24..........................................

10. AT+CWSAP_CUR – Current conﬁg of softAP mode!25................................

Espressif Systems Conﬁdential /Friday, May 22, 20153 54

Table of Contents

! ! " !

Espressif Systems

ESP8266 AT Instruction Set

11. AT+CWSAP_DEF – Default conﬁg of softAP mode!26..................................

12. AT+CWLIF – IP of stations !26.....................................................................

13. AT+CWDHCP – Enable/Disable DHCP !27..................................................

14. AT+CWDHCP_CUR – Enable/Disable DHCP!28..........................................

15. AT+CWDHCP_DEF – Enable/Disable DHCP and save to Flash !29..............

16. AT+CWAUTOCONN – Auto connect to AP or not!29...................................

17. AT+CIPSTAMAC – Set mac address of station !30.......................................

18. AT+CIPSTAMAC_CUR – Set mac address of station !30.............................

19. AT+CIPSTAMAC_DEF – Set mac address of station, save as default !31.....

20. AT+CIPAPMAC – Set mac address of softAP !31.........................................

21. AT+CIPAPMAC_CUR – Set mac address of softAP !32...............................

22. AT+CIPAPMAC_DEF – Set mac address of softAP and save as default!32..

23. AT+CIPSTA – Set IP address of station!33...................................................

24. AT+CIPSTA_CUR – Set IP address of station !34.........................................

25. AT+CIPSTA_DEF – Set IP address of station and save as default !35...........

26. AT+ CIPAP – Set IP address of softAP !36...................................................

27. AT+CIPAP_CUR – Set IP address of softAP !37...........................................

28. AT+CIPAP_DEF – Set IP address of softAP, save as default !38...................

29. AT+CWSTARTSMART – Start SmartConﬁg !39............................................

30. AT+CWSTOPSMART – stop SmartConﬁg !39..............................................

5. TCP/IP Related AT Commands 40...............................................................

5.1. Overview !40"...............................................................................................

5.2. TCP/IP!41"...................................................................................................

1. AT+CIPSTATUS – Information about connection!41.....................................

2. AT+CIPSTART – Start connection!42...........................................................

3. AT+CIPSEND – Send data !43.....................................................................

4. AT+CIPSENDEX – Send data !44.................................................................

5. AT+CIPSENDBUF – Write data into TCP-send-buffer!45..............................

6. AT+CIPBUFRESET – Reset segment ID count!45........................................

7. AT+CIPBUFSTATUS – Check status of TCP-send-buffer!46........................

8. AT+CIPCHECKSEG – Check if speciﬁc segment sent successfully or not!47

9. AT+CIPCLOSE – Close TCP or UDP connection!47.....................................

10. AT+CIFSR – Get local IP address !48...........................................................

Espressif Systems Conﬁdential /Friday, May 22, 20154 54

! ! " !

Espressif Systems

ESP8266 AT Instruction Set

11. AT+CIPMUX – Enable multiple connections!49............................................

12. AT+CIPSERVER – Conﬁgure as TCP server !49...........................................

13. AT+CIPMODE – Set transfer mode !50........................................................

14. AT+SAVETRANSLINK – Save transparent transmission link to Flash !50......

15. AT+CIPSTO – Set TCP server timeout !51...................................................

16. AT+CIUPDATE – Update through network!51..............................................

17. AT+PING – Function Ping!52.......................................................................

18. +IPD – Receive network data !52.................................................................

6. Appendix 53....................................................................................................

7. Q&A 54............................................................................................................

Espressif Systems Conﬁdential /Friday, May 22, 20155 54

! ! " !

Espressif Systems

ESP8266 AT Instruction Set

1. Preambles

This is the documentation for Espressif AT command Command set and usage.

Command set is divided into: Basic AT commands, WiFi related AT commands, TCP / IP AT

commands.

Copy all ﬁles in folder "at" to folder "app" in esp_iot_sdk if users need to compile AT.

Download:

boot.bin, downloads to flash 0x00000

user1.bin, downloads to flash 0x01000

blank.bin, factory initialize,

AT_v0.22 or version before that，corresponding to 512KB ﬂash size，blank.bin downloads to ﬂash

both 0x3E000 and 0x7E000

AT_v0.23 or version later than that, corresponding to 1024KB ﬂash size，blank.bin downloads to

ﬂash both 0x7E000 and 0xFE000

Please use Espressif ofﬁcial ﬂash download tool http://bbs.espressif.com/viewtopic.php?f=5&t=433

select corresponding ﬂash size while downloading.

Notes:

• Please make sure that correct BIN (/esp_iot_sdk/bin/at) is already in the chip (ESP8266) before

the AT commands listed in this documentation can be used.

• AT has already taken priority 0 and 1 of system_os_task , so only one task of priority 2 is allowed

to set up by user.

• AT returns messages below to show status of Wi-Fi connection of ESP8266 station

‣WIFI CONNECTED - Wi-Fi connected

‣WIFI GOT IP - ESP8266 station got IP from AP

‣WIFI DISCONNECT - Wi-Fi disconnected"

Espressif Systems Conﬁdential /Friday, May 22, 20156 54

! ! " !

Espressif Systems

ESP8266 AT Instruction Set

2. Command Description

Each Command set contains four types of AT commands.

Notes:

1. Not all AT Command has four commands.

2. [] = default value, not required or may not appear

3. String values require double quotation marks, for example:

AT+CWSAP="ESP756290","21030826",1,4

4. Baudrate = 115200

5. AT Commands has to be capitalized, and end with "/r/n"

Type

Command Format

DescrIPtion

Test

AT+<x>=?

Query the Set command or internal parameters and its range

values.

Query

AT+<x>?

Returns the current value of the parameter.

Set

AT+<x>=<…>

Set the value of user-deﬁned parameters in commands and run.

Execute

AT+<x>

Runs commands with no user-deﬁned parameters.

Espressif Systems Conﬁdential /Friday, May 22, 20157 54

! ! " !

Espressif Systems

ESP8266 AT Instruction Set

3. Basic AT Command Set

3.1. Overview

The ESP8266 wireless WiFi modules can be driven via the serial interface using the standard AT

commands. Here is a list of some basic AT commands that can be used.

3.2. Commands

1. AT – Test AT startup

The type of this command is "executed". It's used to test the setup function of your wireless WiFi

module.

Basic

Command

Description

Test AT startup

AT+RST

Restart module

AT+GMR

View version info

AT+GSLP

Enter deep-sleep mode

ATE

AT commands echo or not

AT+RESTORE

Factory Reset

AT+UART

UART conﬁguration, [@deprecated]

AT+UART_CUR

UART current conﬁguration

AT+UART_DEF

UART default conﬁguration, save to ﬂash

AT+SLEEP

Sleep mode

AT+RFPOWER

Set RF TX Power

AT+RFVDD

Set RF TX Power according to VDD33

AT – Test AT startup

Response

Parameters

null

Espressif Systems Conﬁdential /Friday, May 22, 20158 54

! ! " !

Espressif Systems

ESP8266 AT Instruction Set

2. AT+RST – Restart module

The type of this command is "executed". It’s used to restart the module.

3. AT+GMR – View version info

This AT command is used to check the version of AT commands and SDK that you are using, the type

of which is "executed".

4. AT+GSLP – Enter deep-sleep mode

This command is used to invoke the deep-sleep mode of the module, the type of which is "set". A

minor adjustment has to be made before the module enter this deep sleep mode, i.e., connect

XPD_DCDC with EXT_RSTB via 0R.

AT+RST – Restart module

Response

Parameters

null

AT+GMR – View version info

Response

< AT version info >

< SDK version info >

< compile time >

Parameters

< AT version info > information about AT version

< SDK version info > information about SDK version

< compile time > time of the bin was compiled

AT+GSLP=<time>

Response

<time>

Parameters

The time unit of < time > is ms. ESP8266 will wake up after X ms and then

enter the deep sleep mode.

Espressif Systems Conﬁdential /Friday, May 22, 20159 54

! ! " !

Espressif Systems

ESP8266 AT Instruction Set

5. ATE – AT commands echo

This command ATE is an AT trigger command echo. It means that entered commands can be echoed

back to the sender when ATE command is used. Two parameters are possible. The command returns

"OK" in normal cases and "ERROR" when a parameter other than 0 or 1 was speciﬁed.

6. AT+RESTORE – Factory reset

This command is used to reset all parameters saved in ﬂash (according to appendix), restore the

factory default settings of the module. The chip will be restarted when this command is executed.

7. AT+UART – UART conﬁguration

This command sets the UART conﬁguration and writes the new conﬁguration to the ﬂash. It is stored

as the default parameter and will also be used as the default baudrate henceforth. [THIS API IS

DEPRECATED.]

ATE – AT commands echo

Response

Parameters

ATE0: Switch echo off

ATE1: Switch echo on

AT+RESTORE – Factory reset

Response

Notes

Restore factory default settings.

The chip will restart.

AT+UART=<baudrate>,<databits>,<stopbits>,<parity>,<ﬂow control>

This API is deprecated, please use AT+UART_CUR or AT+UART_DEF instead.

Example

AT+UART=115200,8,1,0,3

Response

Parameters

Baudrate range: 110 to 115200*40 (4.608 Mega)

<databits>!

5: 5 bits data!

6: 6 bits data!

7: 7 bits data!

8: 8 bits data

1: 1 bit stop bit!

2: 1.5 bit stop bit!

3: 2 bit stop bit

AT+UART=<baudrate>,<databits>,<stopbits>,<parity>,<ﬂow control>

This API is deprecated, please use AT+UART_CUR or AT+UART_DEF instead.

Espressif Systems Conﬁdential /Friday, May 22, 201510 54

Andere Handbücher für ESP8266 SDK

Inhaltsverzeichnis

Andere Espressif Systems Mikrocontroller Handbücher

Espressif Systems

Espressif Systems ESP8266EX Betriebsanleitung

Espressif Systems

Espressif Systems ESP8266EX Installationshandbuch

Espressif Systems

Espressif Systems ESP32 Series Bedienungsanleitung

Espressif Systems

Espressif Systems ESP8266 SDK Bedienungsanleitung

Espressif Systems

Espressif Systems ESP8266 SDK Einrichtungshandbuch

Espressif Systems

Espressif Systems ESP32-C3-DevKitC-02 Bedienungsanleitung

Espressif Systems

Espressif Systems ESP32 Series Bedienungsanleitung

Espressif Systems

Espressif Systems ESP32-C3FH4 Bedienungsanleitung

Espressif Systems

Espressif Systems ESP32-H2 Series Bedienungsanleitung

Espressif Systems

Espressif Systems ESP32-C3 Series Bedienungsanleitung

Espressif Systems

Espressif Systems ESP32-C6 Series Bedienungsanleitung

Espressif Systems

Espressif Systems ESP32 Series Bedienungsanleitung

Beliebte Mikrocontroller Handbücher anderer Marken

AMS

AMS AS7261 Demo Kit Bedienungsanleitung

Novatek

Novatek NT6861 Bedienungsanleitung

Nuvoton

Nuvoton ISD61S00 ChipCorder Leitfaden

STMicrolectronics

STMicrolectronics ST7 Assembler Linker Bedienungsanleitung

Texas Instruments

Texas Instruments Chipcon CC2420DK Bedienungsanleitung

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM Bedienungsanleitung

NEC

NEC 78GK0S/K 1+ Series Montage- und Bedienungsanleitung

Mikroe

Mikroe SEMITECH N-PLC Click Montage- und Bedienungsanleitung

Intel

Intel Agilex Bedienungsanleitung

Cypress

Cypress CY4607 HX2VL Bedienungsanleitung

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE Bedienungsanleitung

Texas Instruments

Texas Instruments TMS320F2837 D Series Bedienungsanleitung

CYPRES

CYPRES CY14NVSRAMKIT-001 Bedienungsanleitung

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM Bedienungsanleitung

Abov

Abov AC33M8128L Bedienungsanleitung

Laird

Laird BL654PA Bedienungsanleitung

Silicon Laboratories

Silicon Laboratories C8051F800 Bedienungsanleitung

Energy micro

Energy micro EFM32 Giant Gecko Starter Kit Bedienungsanleitung