You are on page 1of 71

ESP8266 AT

Version 2.0.0
Espressif Systems IoT Team
Copyright 2016

Espressif Systems

ESP8266 AT Instruction Set


!

URL

Wi-Fi

Wi-Fi

2016

Espressif Systems Confidential

2 /71

Friday, July 15, 2016

ESP8266 _NONOS_SDK

AT

Chapter

Title

Chapter 1

Chapter 2
Chapter 3
Chapter 4

Subject

Chapter 6
Chapter 7

AT

WiFi AT
TCP/IP

AT

AT

AT

Chapter 5

AT

WiFi AT

AT

Flash AT

Q&A

AT

Date

Version

Release notes

2016.04

V1.5.3

2016.05

V1.5.4

Chapter 5.2.16 Chapter 5.2.19

2016.07

V2.0.0

Chapter 3.2.11 Chapter 1.2

Espressif Systems

ESP8266 AT Instruction Set


!

Table of Contents
1.

...............................................................................................................8
1.1.

AT

1.2.

AT

............................................................................................9

1.

4Mbit Flash ............................................................................................... 9

2.

8Mbit Flash ............................................................................................. 10

3.

16Mbit Flash, map: 512KB + 512KB ......................................................10

4.

16Mbit Flash, map: 1024KB + 1024KB ..................................................10

5.

32Mbit Flash, map: 512KB + 512KB ......................................................11

6.

32Mbit Flash, map: 1024KB + 1024KB ..................................................11

2.
3.

.........................................................................................8

.....................................................................................................13
AT

...............................................................................................14

3.1.

AT

................................................................................14

3.2.

AT

...................................................................................15

1.

AT

2.

AT+RST

3.

AT+GMR

4.

AT+GSLP

5.

ATE

6.

AT+RESTORE

7.

AT+UART UART

.........................................................................17

8.

AT+UART_CUR

UART

......................................... 18

9.

AT+UART_DEF

UART

flash ..................................19

AT

10. AT+SLEEP

.................................................................................

15
............................................................................... 15
......................................................................15
deep-sleep

.............................................................................. 16
.............................................................. 16

sleep

11. AT+WAKEUPGPIO
12. AT+RFPOWER
13. AT+RFVDD
Espressif Systems Confidential

........................................................16

................................................................ 20
GPIO

RF TX Power
VDD33

light-sleep

........................... 21

............................................... 22

RF TX Power ......................................... 22

4 /71

Friday, July 15, 2016

!
4.

Espressif Systems
WiFi

AT

4.1.

ESP8266 AT Instruction Set


!

....................................................................................... 23

Wi-Fi

.......................................................................................25

1.

AT+CWMODE Wi-Fi

2.

AT+CWMODE_CUR

3.

AT+CWMODE_DEF

4.

AT+CWJAP

5.

AT+CWJAP_CUR

6.

AT+CWJAP_DEF

7.

AT+CWLAPOPT

8.

AT+CWLAP

9.

AT+CWQAP

.....................................................................25
Wi-Fi

.......................................... 26

Wi-Fi

flash .............................. 27

AP ............................................................................ 28
AP ............................................................ 29
AP

flash ............................................. 30

CWLAP

......................................... 31

APs .......................................................32
AP

10. AT+CWSAP

............................................................

33

ESP8266 softAP

............................................. 33

11. AT+CWSAP_CUR

ESP8266 softAP

............................ 34

12. AT+CWSAP_DEF

ESP8266 softAP

flash ...............35

13. AT+CWLIF

ESP8266 softAP

14. AT+CWDHCP

stations

....................36

DHCP .................................................................. 37

15. AT+CWDHCP_CUR

DHCP

flash ................................38

16. AT+CWDHCP_DEF

DHCP

Flash .................................39

ESP8266 soft-AP DHCP


IP
17. AT+CWDHCPS_CUR

...............................................................................................................
40
18. AT+CWDHCPS_DEF
41

ESP8266 soft-AP DHCP

19. AT+CWAUTOCONN

IP

Flash ....

AP ......................................... 41

20. AT+CIPSTAMAC

ESP8266 station

MAC

..................42

21. AT+CIPSTAMAC_CUR

ESP8266 station

MAC

............

42

22. AT+CIPSTAMAC_DEF

ESP8266 station

MAC

............ 43

23. AT+CIPAPMAC

ESP8266 softAP

MAC

........................... 43

24. AT+CIPAPMAC_CUR

ESP8266 softAP

MAC

.............. 44

25. AT+CIPAPMAC_DEF

ESP8266 softAP

MAC

................

44

26. AT+CIPSTA
Espressif Systems Confidential

flash

ESP8266 station
5 /71

IP

......................................45
Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

27. AT+CIPSTA_CUR

ESP8266 station

IP

........................ 46

28. AT+CIPSTA_DEF

ESP8266 station

IP

......................... 47

29. AT+CIPAP

ESP8266 softAP

IP

.......................................48

30. AT+CIPAP_CUR

ESP8266 softAP

IP

........................... 49

31. AT+CIPAP_DEF

ESP8266 softAP

IP

........................... 50

32. AT+CWSTARTSMART

SmartConfig ............................................ 51

33. AT+CWSTOPSMART

SmartConfig ............................................. 51

34. AT+CWSTARTDISCOVER

.............................. 52

35. AT+CWSTOPDISCOVER
36. AT+WPS

WPS

37. AT+MDNS

5.

TCP/IP

................................52
.....................................................................53

MDNS

................................................................ 53

AT

..................................................................................54

5.1.

TCP/IP

...............................................................................54

5.2.

TCP/IP ...................................................................................................55

1.

AT+CIPSTATUS

......................................................55

2.

AT+CIPDOMAIN

............................................................ 55

3.

AT+CIPSTART

4.

AT+CIPSSLSIZE

5.

AT+CIPSEND

6.

AT+CIPSENDEX

7.

AT+CIPSENDBUF

TCP

8.

AT+CIPBUFRESET

............................................................... 61

9.

AT+CIPBUFSTATUS

TCP

UDP

SSL buffer

SSL

.................................................57

......................................................................58
.................................................................. 59

TCP

10. AT+CIPCHECKSEQ

TCP

11. AT+CIPCLOSE

TCP / UDP / SSL

12. AT+CIFSR

IP

13. AT+CIPMUX
14. AT+CIPSERVER
15. AT+CIPMODE
Espressif Systems Confidential

....................... 56

......................................... 60

..................................61
...... 62
........................................ 62

............................................................... 63
......................................................................64

TCP server .......................................................65


.............................................................. 65
6 /71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

16. AT+SAVETRANSLINK
17. AT+CIPSTO
18. AT+PING ping
19. AT+CIUPDATE

Flash ............................................. 66

TCP server

..............................................................................

68
WiFi

......................................................68

20. AT+CIPDINFO
21. +IPD

.............................................. 67

IP

...................... 69

.............................................................................

69

6.

.............................................................................................................70

7.

Q&A ............................................................................................................ 71

Espressif Systems Confidential

7 /71

Friday, July 15, 2016

Espressif Systems
!

ESP8266 AT Instruction Set


!

1.

Espressif AT

AT

1.1.

WiFi

AT

TCP/IP

AT
AT
AT


AT

AT

AT

ESP8266_NONOS_SDK
Espressif Systems
AT bin

ESP8266_NONOS_SDK\example\at
AT
libat.a

\ESP8266_NONOS_SDK\examples\at\user\user_main.c
AT+TEST

at_funcationType

AT+TEST

AT+TEST=
at_testCmdTest

AT
at_testCmd

NULL
AT+TEST
at_queryCmd

at_queryCmdTest

AT

NULL
AT+TEST=parameter1,parameter2,
at_setupCmd

at_setupCmdTest

AT

NULL
AT+TEST
at_exeCmd
Espressif Systems Confidential

at_exeCmdTest

AT

8 /71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

NULL

AT

AT
app

ESP8266_NONOS_SDK

ESP8266

1.2.

AT

at

ESP8266_NONOS_SDK\bin\at\readme.txt
Flash size

Espressif
1.

Espressif

http://bbs.espressif.com/viewtopic.php?f=5&t=433

4Mbit Flash
ESP8266_NONOS_SDK_V2.0.0, AT_V1.3

AT

4Mbit Flash

bin
blank.bin

0x78000

esp_init_data_default.bin

0x7C000

RF_CAL

RF_CAL
blank.bin

0x7A000

blank.bin

0x7E000

eagle.flash.bin

0x00000

\bin\at\noboot

eagle.irom0text.bin

0x10000

\bin\at\noboot

Espressif Systems Confidential

9 /71

Friday, July 15, 2016

Espressif Systems

2.

ESP8266 AT Instruction Set


!

8Mbit Flash

AT+CIUPDATE)

Flash

Espressif

8Mbit

Flash size : 8Mbit

boot mode

bin
blank.bin

0xFB000

esp_init_data_default.bin

0xFC000

RF_CAL

RF_CAL
blank.bin

0x7E000

blank.bin

0xFE000

boot.bin

0x00000

\bin\at

user1.1024.new.2.bin

0x01000

\bin\at\512+512

3.

16Mbit Flash, map: 512KB + 512KB


Espressif

Flash size : 16Mbit

bin
blank.bin

0x1FB000

esp_init_data_default.bin

0x1FC000

RF_CAL

RF_CAL
blank.bin

0x7E000

blank.bin

0x1FE000

boot.bin

0x00000

\bin\at

user1.1024.new.2.bin

0x01000

\bin\at\512+512

4.

16Mbit Flash, map: 1024KB + 1024KB


Espressif

Flash size : 16Mbit-C1

bin
blank.bin

0x1FB000

esp_init_data_default.bin

0x1FC000

RF_CAL

RF_CAL

Espressif Systems Confidential

10/71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

bin
blank.bin

0xFE000

blank.bin

0x1FE000

boot.bin

0x00000

\bin\at

user1.2048.new.5.bin

0x01000

\bin\at\1024+1024

5.

32Mbit Flash, map: 512KB + 512KB


Espressif

Flash size : 32Mbit

bin
blank.bin

0x3FB000

esp_init_data_default.bin

0x3FC000

RF_CAL

RF_CAL
blank.bin

0x7E000

blank.bin

0x3FE000

boot.bin

0x00000

\bin\at

user1.1024.new.2.bin

0x01000

\bin\at\512+512

6.

32Mbit Flash, map: 1024KB + 1024KB


Espressif

Flash size : 32Mbit-C1

bin
blank.bin

0x3FB000

esp_init_data_default.bin

0x3FC000

RF_CAL

RF_CAL
blank.bin

0xFE000

blank.bin

0x3FE000

boot.bin

0x00000

\bin\at

user1.2048.new.5.bin

0x01000

\bin\at\1024+1024

Espressif Systems Confidential

11/71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

readme.txt

AT

BIN (\ESP8266_NONOS_SDK\bin\at)
(ESP8266)
0

system_os_task

AT

ESP8266_NONOS_SDK\bin\at

AT

AT

ESP8266 station

AP

WiFi CONNECTED - WiFi

WiFi GOT IP - ESP8266 station

WiFi DISCONNECT - WiFi

Espressif Systems Confidential

AP

IP

12/71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

2.

AT

AT+<x>=?
AT+<x>?
AT+<x>=<>
AT+<x>
:

1.

AT

2.

[]

3.

string:

AT+CWSAP=ESP756290,21030826,1,4

4.
5.

115200

AT

\r\n

Espressif Systems Confidential

13/71

Friday, July 15, 2016

Espressif Systems

3.

ESP8266 AT Instruction Set


!

AT
3.1.

AT

AT

AT

AT

AT+RST
AT+GMR
AT+GSLP

deep-sleep

ATE
AT+RESTORE
AT+UART

UART

AT+UART_CUR

UART

AT+UART_DEF

UART

[@deprecated]

flash

AT+SLEEP

sleep

AT+WAKEUPGPIO

GPIO

AT+RFPOWER

RF TX Power

AT+RFVDD

VDD33

Espressif Systems Confidential

light-sleep

RF TX Power

14/71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

AT

3.2.
1.
AT

AT

AT

AT
:
:

OK

AT

2.

AT+RST

AT+RST
:
:

OK

AT+RST

3.

AT+GMR

AT+GMR
:
AT+GMR

:
<AT version info>
<SDK version info>
<compile time>
OK
:
<AT version info> AT
<SDK version info>
<compile time>

Espressif Systems Confidential

SDK

15/71

Friday, July 15, 2016

Espressif Systems

4.

AT+GSLP

AT+GSLP

ESP8266 AT Instruction Set


!

deep-sleep

deep-sleep

:
AT+GSLP=<time>

:
<time>
OK
:
< time >

ESP8266

deep-sleep
EXT_RSTB

5.

ESP8266
XPD_DCDC

deep-sleep

ATE

ATE
:

ATE
OK
:
ATE0 :
ATE1 :

6.

AT+RESTORE

AT+RESTORE
:
AT+RESTORE

:
OK
flash

Espressif Systems Confidential

16/71

Friday, July 15, 2016

Espressif Systems

7.

ESP8266 AT Instruction Set


!

AT+UART UART

AT+UART UART
[@deprecated]

AT+UART_CUR

AT+UART_DEF

:
:
AT + U A R T = < b a u d r a t e > ,
<databits>,<stopbits>,
OK
<parity>,<flow control>

:
<baudrate> UART
<databits>
5 5 bit
6 6 bit
7 7 bit
8 8 bit
<stopbits>
1 1 bit
2 1.5 bit
3 2 bit
<parity>
0 None
1 Odd
2 Even
<flow control>
0
1
RTS
2
CTS
3
RTS

1.
2.
MTCK
MTDO
3.

CTS

flash user parameter


:
UART0 CTS
UART0 RTS
110~115200*40

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

Espressif Systems Confidential

17/71

Friday, July 15, 2016

Espressif Systems

8.

AT+UART_CUR

AT+UART_CUR

ESP8266 AT Instruction Set


!

UART

UART

flash

:
:
AT+UART_CUR=<baudrate>,
<databits>,<stopbits>,
OK
<parity>,<flow control>

:
<baudrate> UART
<databits>
5 5 bit
6 6 bit
7 7 bit
8 8 bit
<stopbits>
1 1 bit
2 1.5 bit
3 2 bit
<parity>
0 None
1 Odd
2 EVEN
<flow control>
0
1
RTS
2
CTS
3
RTS

1.
2.

flash
:
MTCK
MTDO

3.

CTS

UART0 CTS
UART0 RTS
110~115200*40

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

Espressif Systems Confidential

18/71

Friday, July 15, 2016

Espressif Systems

9.

AT+UART_DEF

AT+UART_DEF

ESP8266 AT Instruction Set


!

UART

UART

flash

flash

:
:
AT+UART_DEF=<baudrate>,
<databits>,<stopbits>,
OK
<parity>,<flow control>

:
<baudrate> UART
<databits>
5 5 bit
6 6 bit
7 7 bit
8 8 bit
<stopbits>
1 1 bit
2 1.5 bit
3 2 bit
<parity>
0 None
1 Odd
2 EVEN
<flow control>
0
1
RTS
2
CTS
3
RTS

1.
2.
MTCK
MTDO
3.

CTS

flash user parameter


:
UART0 CTS
UART0 RTS
110~115200*40

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

Espressif Systems Confidential

19/71

Friday, July 15, 2016

Espressif Systems

10. AT+SLEEP
AT+SLEEP

ESP8266 AT Instruction Set


!

sleep

sleep

:
AT+SLEEP?

:
sleep
OK
:

AT+SLEEP=<sleep mode>

OK

ERROR

<sleep mode>
0
1

light-sleep

modem-sleep

sleep

station

modem-sleep

AT+SLEEP=0

Espressif Systems Confidential

20/71

Friday, July 15, 2016

Espressif Systems

11. AT+WAKEUPGPIO
<trigger_GPIO>
<trigger_GPIO>

GPIO

ESP8266

light-sleep

light-sleep

ESP8266

<trigger_GPIO>

<trigger_GPIO>

AT+WAKEUPGPIO

ESP8266 AT Instruction Set


!

GPIO

modem-sleep
light-sleep
light-sleep

AT+WAKEUPGPIO=<enable>,
<trigger_GPIO>, <trigger_level>, OK
[<awake_GPIO>,<awake_level>]
<enable>
0

GPIO

light-sleep

GPIO

light-sleep

<trigger_GPIO>
light-sleep

GPIO

[0, 15]

<trigger_level>
0
1
[<awake_GPIO>]
light-sleep

GPIO

[0, 15]

[<awake_level>]
0

light-sleep

light-sleep

<trigger_GPIO>

<awake_GPIO>

GPIO0

light-sleep

AT+WAKEUPGPIO=1,0,0
GPIO0

light-sleep

GPIO13

AT+WAKEUPGPIO=1,0,1,13,1
GPIO

light-sleep

AT+WAKEUPGPIO=0

Espressif Systems Confidential

21/71

Friday, July 15, 2016

Espressif Systems

12. AT+RFPOWER
AT+RFPOWER

ESP8266 AT Instruction Set


!

RF TX Power

RF TX Power

AT+RFPOWER=<TX Power>

OK

<TX Power> RF TX Power

[0, 82]

RF TX Power

0.25dBm

RF TX Power

AT+RFPOWER=50

13. AT+RFVDD
AT+RFVDD

VDD33

VDD33

RF TX Power

RF TX Power

:
ESP8266 VDD33
:
AT+RFVDD?

:
+RFVDD:<VDD33>
OK
TOUT
:
<VDD33> VDD33

:
ESP8266
RF TX Power

<VDD33>
OK

AT+RFVDD=<VDD33>
:
ESP8266
RF TX Power

1/1024 V

<VDD33> VDD33

[1900, 3300]

VDD33
OK

AT+RFVDD

TOUT
AT+RFVDD=2800

Espressif Systems Confidential

22/71

Friday, July 15, 2016

4.
WiFi

Espressif Systems
WiFi

ESP8266 AT Instruction Set


!

AT

AT

AT+CWMODE

WiFi

sta/AP/sta+AP

AT+CWMODE_CUR

WiFi

sta/AP/sta+AP

AT+CWMODE_DEF

WiFi

sta/AP/sta+AP

AT+CWJAP

AP, [@deprecated]

AT+CWJAP_CUR

AP

AT+CWJAP_DEF

AP

AT+CWLAPOPT

AT+CWLAP

AT+CWLAP
AT+CWQAP

[@deprecated]
flash
flash

flash
flash

AP
AP

AT+CWSAP

ESP8266 softAP

AT+CWSAP_CUR

ESP8266 softAP

AT+CWSAP_DEF

ESP8266 softAP

AT+CWLIF

[@deprecated]
flash
flash

ESP8266 softAP

station

AT+CWDHCP

DHCP

[@deprecated]

AT+CWDHCP_CUR

DHCP

AT+CWDHCP_DEF

DHCP

AT+CWDHCPS_CUR

ESP8266 soft-AP DHCP

IP

AT+CWDHCPS_DEF

ESP8266 soft-AP DHCP

IP

flash
flash

AT+CWAUTOCONN

Flash

AP

AT+CIPSTAMAC

ESP8266 station

MAC

AT+CIPSTAMAC_CUR

ESP8266 station

MAC

AT+CIPSTAMAC_DEF

ESP8266 station

MAC

AT+CIPAPMAC

ESP8266 softAP

MAC

AT+CIPAPMAC_CUR

ESP8266 softAP

MAC

AT+CIPAPMAC_DEF

ESP8266 softAP

MAC

Espressif Systems Confidential

Flash

23/71

[@deprecated]
flash
flash
[@deprecated]
flash
flash

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

AT+CIPSTA

ESP8266 station

IP

AT+CIPSTA_CUR

ESP8266 station

IP

AT+CIPSTA_DEF

ESP8266 station

IP

AT+CIPAP

ESP8266 softAP

IP

AT+CIPAP_CUR

ESP8266 softAP

IP

AT+CIPAP_DEF

ESP8266 softAP

IP

AT+CWSTARTSMART

SmartConfig

AT+CWSTOPSMART

SmartConfig

[@deprecated]
flash
flash
[@deprecated]
flash
flash

AT+CWSTARTDISCOVER
AT+CWSTOPDISCOVER
AT+WPS

WPS

AT+MDNS

MDNS

Espressif Systems Confidential

24/71

Friday, July 15, 2016

Espressif Systems

4.1.
1.

ESP8266 AT Instruction Set


!

Wi-Fi
AT+CWMODE Wi-Fi

AT+CWMODE - WiFi

station/softAP/station+softAP

[@deprecated]

AT+CWMODE_CUR

:
AT+CWMODE=?

:
+CWMODE:( <mode>

AT+CWMODE_DEF
)

OK
:
<mode>1 : station
2 : softAP
3 : softAP + station
:
ESP8266
:
AT+CWMODE?

Wi-Fi

:
+CWMODE:<mode>
OK
:
:

ESP8266
Wi-Fi
:
AT+CWMODE=<mode>

OK
:
flash system parameter

AT+CWMODE=3

Espressif Systems Confidential

25/71

Friday, July 15, 2016

Espressif Systems

2.

ESP8266 AT Instruction Set


!

AT+CWMODE_CUR

AT+CWMODE_CUR

Wi-Fi

Wi-Fi

:
AT+CWMODE_CUR=?

sta/AP/sta+AP
:
+CWMODE_CUR:( <mode>

flash
)

OK
:
<mode> 1
2
3
:
ESP8266
Wi-Fi
:
AT+CWMODE_CUR?

station
softAP
softAP + station

:
+CWMODE_CUR:<mode>
OK
:

:
ESP8266
Wi-Fi
:
AT+CWMODE_CUR=
<mode>

:
OK
:
flash
AT+CWMODE_CUR=3

Espressif Systems Confidential

26/71

Friday, July 15, 2016

Espressif Systems

3.

AT+CWMODE_DEF

AT+CWMODE_DEF -

Wi-Fi

:
AT+CWMODE_DEF=?

ESP8266 AT Instruction Set


!
Wi-Fi

flash

(sta/AP/sta+AP)
:
+CWMODE_DEF:( <mode>

flash
)

OK
:
<mode>1
2
3
:
ESP8266 Wi-Fi
:
AT+CWMODE_DEF?

station
softAP
softAP + station

:
+CWMODE_DEF:<mode>
OK
:

:
ESP8266 Wi-Fi
:
AT+CWMODE_DEF=
<mode>

:
OK
:
flash system parameter
AT+CWMODE_DEF=3

Espressif Systems Confidential

27/71

Friday, July 15, 2016

Espressif Systems

4.

AT+CWJAP

AT+CWJAP

AP

AP

[@deprecated]
:
ESP8266
:
AT+CWJAP?

ESP8266 AT Instruction Set


!

AT+CWJAP_CUR

AT+CWJAP_DEF

:
+ CWJAP:<ssid>,<bssid>,<channel>,<rssi>
AP
OK
:
<ssid>

:
ESP8266 station
:
AT+ CWJAP =
<ssid>,<pwd>[,<bssid>]

AP

SSID

:
AP
OK
+CWJAP:<error code>
FAIL
:
<ssid>
<pwd>
[<bssid>]
SSID
AP
<error code>
1
2
3
AP
4

AP

SSID
64
ASCII
AP
bssid (MAC

station

SSID

password

flash system parameter


AT+CWJAP =abc
AP
password

0123456789

SSID

0123456789\

AT+CWJAP =ab\\\,c
AP

SSID

AT+CWJAP =abc

Espressif Systems Confidential

ab\,c

28/71

0123456789\\\
abc

0123456789

bssid

AP

ca:d7:19:d8:a6:44

Friday, July 15, 2016

Espressif Systems

5.

AT+CWJAP_CUR

AT+CWJAP_CUR

AP

ESP8266 AT Instruction Set


!
AP

Flash

:
ESP8266 station

+ CWJAP_CUR:<ssid>,<bssid>,<channel>,<rssi>
AP
OK

AT+CWJAP_CUR?
<ssid> string, APs SSID
:
ESP8266 station
:
AT+CWJAP_CUR =
<ssid>,<pwd>[,<bssid>]

AP
OK
+CWJAP:<error code>
FAIL
<ssid>
<pwd>
[<bssid>]
SSID
AP
<error code>
1
2
3
AP
4

AP

station

SSID
64
ASCII
AP
bssid (MAC

SSID

password

flash
AT+ CWJAP_CUR =abc
AP
password

SSID

0123456789
ab\,c

0123456789\

AT+CWJAP_CUR =ab\\\,c
AP

SSID

AT+CWJAP_CUR =abc

Espressif Systems Confidential

29/71

0123456789\\\

abc

bssid

AP

0123456789 ca:d7:19:d8:a6:44

Friday, July 15, 2016

Espressif Systems

6.

AT+CWJAP_DEF

AT+CWJAP_DEF

AP

:
ESP8266 station
:
AT+CWJAP_DEF?

ESP8266 AT Instruction Set


!

AP

flash

flash
+ CWJAP_DEF:<ssid>,<bssid>,<channel>,<rssi>
AP

OK
<ssid>

AP

SSID

OK
+CWJAP:<error code>
FAIL

:
ESP8266 station
:
AT+ CWJAP_DEF =
<ssid>,<pwd>[,<bssid>]

AP

<ssid>
<pwd>
[<bssid>]
SSID
AP
<error code>
1
2
3
AP
4

AP

station

SSID
64
ASCII
AP
bssid (MAC

SSID

password

flash system parameter


AT+CWJAP_DEF =abc 0123456789
AP
password

SSID

ab\,c

0123456789\

AT+CWJAP_DEF =ab\\\,c 0123456789\\\


AP

SSID

abc

bssid

AP

AT+CWJAP_DEF =abc 0123456789 ca:d7:19:d8:a6:44

Espressif Systems Confidential

30/71

Friday, July 15, 2016

Espressif Systems

7.

AT+CWLAPOPT

AT+CWLAPOPT -

ESP8266 AT Instruction Set


!

CWLAP

AT+CWLAP
OK
ERROR

:
CWLAP
AT+CWLAPOPT =
<sort_enable>,<mask>

<sort_enable>
AT+CWLAP
0
1
rssi
<mask>
bit
1
AT+CWLAP
bit
0
bit 0
AT+CWLAP
bit 1
AT+CWLAP
bit 2
AT+CWLAP
bit 3
AT+CWLAP
bit 4
AT+CWLAP
bit 5
AT+CWLAP
bit 6
AT+CWLAP
calibration>.

rssi

<ecn>
<ssid>
<rssi>
<mac>
<ch>
<freq offset>
<freq

AT+CWLAPOPT=1,127
1

AT+CWLAP
rssi

127
1

Espressif Systems Confidential

0x7F

<mask>

bit

AT+CWLAP

31/71

Friday, July 15, 2016

Espressif Systems

8.

AT+CWLAP

AT+CWLAP -

ESP8266 AT Instruction Set


!
APs

APs

:
APs.
AT+ CWLAP =
<ssid>[,< mac >,<ch>]

+ CWLAP: <ecn>,<ssid>,<rssi>,<mac>,<ch>,<freq offset>,


<freq calibration>
OK
ERROR

+ CWLAP: <ecn>,<ssid>,<rssi>,<mac>,<ch>,<freq offset>,


<freq calibration>
OK

:
APs.
AT+CWLAP

< ecn >


0 OPEN
1 WEP
2 WPA_PSK
3 WPA2_PSK
4 WPA_WPA2_PSK
5 WPA2_Enterprise (
<ssid>
AP
<rssi>
<mac>
AP
<freq offset> AP
ppm
<freq calibration>

AT
SSID
MAC
KHz

AP)

2.4

AT+CWLAP="WiFi","ca:d7:19:d8:a6:44",6
SSID

AP

AT+CWLAP="WiFi"

Espressif Systems Confidential

32/71

Friday, July 15, 2016

Espressif Systems

9.

AT+CWQAP

AT+CWQAP -

ESP8266 AT Instruction Set


!

AP

AP

:
AP

OK

AT+CWQAP

10. AT+CWSAP
AT+ CWSAP

ESP8266 softAP

ESP8266 softAP

[@deprecated]
:
ESP8266 softAP

AT+CWSAP_CUR

AT+CWSAP_DEF

+ CWSAP:<ssid>,<pwd>,<chl>,<ecn>,<max conn>,<ssid hidden>

AT+CWSAP?

OK
ERROR
:

softAP

<ssid>
<pwd>
8 ~ 64
<chl>
<ecn>
WEP
AT+CWSAP=
0
OPEN
<ssid>,<pwd>,<chl>,
2 WPA_PSK
<ecn>[,<max conn>][,<ssid hidden>]
3 WPA2_PSK
4 WPA_WPA2_PSK
[<max conn>]
ESP8266 soft-AP
station
[<ssid hidden>]
0
ESP8266 soft-AP SSID
0
SSID
1
SSID
:
ESP8266 softAP

ASCII

[1, 4]

flash system parameter


AT+CWSAP="ESP8266","1234567890",5,3

Espressif Systems Confidential

33/71

Friday, July 15, 2016

Espressif Systems

11. AT+CWSAP_CUR
AT+CWSAP_CUR

ESP8266 AT Instruction Set


!

ESP8266 softAP

ESP8266 softAP

:
ESP8266 softAP

flash
+CWSAP_CUR:<ssid>,<pwd>,<chl>,<ecn>,<max conn>,<ssid
hidden>

AT+CWSAP_CUR?

OK
:

:
ESP8266 softAP
AT+CWSAP_CUR=
<ssid>,<pwd>,<chl>,
<ecn>[,<max conn>][,<ssid hidden>]

softAP

<ssid>
<pwd>
8 ~ 64
<chl>
< ecn >
WEP
0 OPEN
2 WPA_PSK
3 WPA2_PSK
4 WPA_WPA2_PSK
[<max conn>]
ESP8266 soft-AP
station
[<ssid hidden>]
0
ESP8266 soft-AP SSID
0
SSID
1
SSID

ASCII

[1, 4]

flash
AT+CWSAP_CUR="ESP8266","1234567890",5,3

Espressif Systems Confidential

34/71

Friday, July 15, 2016

Espressif Systems

12. AT+CWSAP_DEF
AT+ CWSAP_DEF

ESP8266 AT Instruction Set


!

ESP8266 softAP

ESP8266 softAP

:
ESP8266 softAP

flash
flash

+ CWSAP_DEF:<ssid>,<pwd>,<chl>,<ecn>,<max conn>,<ssid
hidden>

AT+ CWSAP_DEF?

OK
ERROR
:

softAP

<ssid>
<pwd>
8 ~ 64
<chl>
< ecn >
WEP
AT+CWSAP_DEF=
0
OPEN
<ssid>,<pwd>,<chl>,
2 WPA_PSK
<ecn>[, <max conn>][,<ssid hidden>]
3 WPA2_PSK
4 WPA_WPA2_PSK
[<max conn>]
ESP8266 soft-AP
station
[<ssid hidden>]
0
ESP8266 soft-AP SSID
0
SSID
1
SSID
:
ESP8266 softAP

ASCII

[1, 4]

flash system parameter


AT+CWSAP_DEF="ESP8266","1234567890",5,3

Espressif Systems Confidential

35/71

Friday, July 15, 2016

Espressif Systems

13. AT+CWLIF
AT+ CWLIF

ESP8266 AT Instruction Set


!

ESP8266 softAP

ESP8266 softAP

stations

stations

<ip addr>,<mac>

:
ESP8266 softAP

stations

AT+CWLIF

OK
<ip addr>
<mac>

ESP8266 softAP
stations IP
ESP8266 softAP stations MAC
IP

ESP8266 softAP

station

DHCP

Espressif Systems Confidential

36/71

Friday, July 15, 2016

Espressif Systems

14. AT+CWDHCP
AT+ CWDHCP

ESP8266 AT Instruction Set


!

DHCP

DHCP

[@deprecated]

AT+CWDHCP_CUR

AT+CWDHCP_DEF

DHCP

AT+CWDHCP?

Bit0

0 - softAP DHCP
1 - softAP DHCP
bit1: 0 - station DHCP
1 - station DHCP

OK
:
DHCP.
AT+CWDHCP=<mode>,<en>

<mode>
0:
1:
2:
<en>
0:
1:

ESP8266 softAP
ESP8266 station
ESP8266 softAP

station

DHCP
DHCP
flash user parameter
IP
DHCP
IP

Espressif Systems Confidential

AT+CIPSTA

AT+CIPAP

IP
DHCP

37/71

Friday, July 15, 2016

Espressif Systems

15. AT+CWDHCP_CUR
AT+CWDHCP_CUR

ESP8266 AT Instruction Set


!
DHCP

DHCP

flash

flash
DHCP

AT+CWDHCP_CUR?

Bit0

0 - softAP DHCP
1 - softAP DHCP
bit1: 0 - station DHCP
1 - station DHCP

OK
:
DHCP.
AT+CWDHCP_CUR=
<mode>,<en>

<mode>
0:
1:
2:
<en>
0:
1:

ESP8266 softAP
ESP8266 station
ESP8266 softAP

station

DHCP
DHCP
flash.
IP
DHCP
IP

AT+CIPSTA

AT+CIPAP

IP
DHCP

AT+CWDHCP_CUR=0,1

Espressif Systems Confidential

38/71

Friday, July 15, 2016

Espressif Systems

16. AT+CWDHCP_DEF
AT+CWDHCP_DEF

ESP8266 AT Instruction Set


!

DHCP

DHCP

Flash

flash
DHCP

AT+CWDHCP_DEF?

Bit0

0 - softAP DHCP
1 - softAP DHCP
bit1: 0 - station DHCP
1 - station DHCP

OK
:
DHCP.
AT+CWDHCP_DEF=
<mode>,<en>

<mode>
0:
1:
2:
<en>
0:
1:

ESP8266 softAP
ESP8266 station
ESP8266 softAP

station

DHCP
DHCP
flash user parameter
IP
DHCP
IP

AT+CIPSTA

AT+CIPAP

IP
DHCP

AT+CWDHCP_DEF=0,1

Espressif Systems Confidential

39/71

Friday, July 15, 2016

Espressif Systems

17. AT+CWDHCPS_CUR
AT+CWDHCPS_CUR

ESP8266 AT Instruction Set


!

ESP8266 soft-AP DHCP

ESP8266 soft-AP DHCP server

IP

IP

flash
flash

+CWDHCPS_CUR=<lease time>,<start IP>,<end IP>


AT+CWDHCPS_CUR?

:
ESP8266 soft-AP DHCP server
IP

AT+CWDHCPS_CUR=<enable>,<lease
time>, <start IP>,<end IP>

OK
<enable> 0 :
IP
1
IP
<lease time>
<start IP> DHCP server IP
<end IP> DHCP server IP

[1, 2880]
IP
IP

Flash
ESP8266 soft-AP
IP

DHCP

ESP8266 soft-AP

AT+CWDHCPS_CUR=1,3,192.168.4.10,192.168.4.15
AT+CWDHCPS_CUR=0 //

Espressif Systems Confidential

40/71

Friday, July 15, 2016

Espressif Systems

18. AT+CWDHCPS_DEF
AT+CWDHCPS_DEF

ESP8266 AT Instruction Set


!
ESP8266 soft-AP DHCP

ESP8266 soft-AP DHCP server

IP

IP

Flash
Flash

+CWDHCPS_DEF=<lease time>,<start IP>,<end IP>


AT+CWDHCPS_DEF?

:
ESP8266 soft-AP DHCP server
IP

AT+CWDHCPS_DEF=<enable>,<lease
time>, <start IP>,<end IP>

OK
<enable> 0 :
IP
1
IP
<lease time>
<start IP> DHCP server IP
<end IP> DHCP server IP

[1, 2880]
IP
IP

Flash user parameter


ESP8266 soft-AP
IP

DHCP

ESP8266 soft-AP

AT+CWDHCPS_DEF=1,3,192.168.4.10,192.168.4.15
AT+CWDHCPS_DEF=0 //

19. AT+CWAUTOCONN
AT+CWAUTOCONN

AP
AP

OK

:
AP
AT+CWAUTOCONN=
<enable>

<enable>
0:
1:

AP
AP

ESP8266 station

AP

flash system parameter


AT+CWAUTOCONN=1

Espressif Systems Confidential

41/71

Friday, July 15, 2016

Espressif Systems

20. AT+CIPSTAMAC
AT+ CIPSTAMAC

ESP8266 AT Instruction Set


!

ESP8266 station

ESP8266 station

[@deprecated]
:
ESP8266 station

MAC
AT+CIPSTAMAC_CUR

AT+CIPSTAMAC_DEF

+CIPSTAMAC:<mac>

MAC

OK

AT+CIPSTAMAC?
:
ESP8266 station

MAC

OK
MAC
<mac>

AT+CIPSTAMAC=<mac>

ESP8266 station

MAC

flash user parameter


ESP8266 soft-AP
station
MAC
MAC
ESP8266 MAC
bit 0
18:
15:

MAC

AT+CIPSTAMAC="18:fe:35:98:d3:7b"

21. AT+CIPSTAMAC_CUR
AT+ CIPSTAMAC_CUR
:
ESP8266 station

ESP8266 station

ESP8266 station

MAC

MAC

MAC
flash

+CIPSTAMAC_CUR:<mac>
OK

AT+CIPSTAMAC_CUR?
:
ESP8266 station

OK
MAC

AT+CIPSTAMAC_CUR=<mac>

<mac>

ESP8266 station

MAC

flash
ESP8266 soft-AP
station
MAC
MAC
ESP8266 MAC
bit 0
18:
15:

MAC

AT+CIPSTAMAC_CUR=18:fe:35:98:d3:7b"

Espressif Systems Confidential

42/71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

22. AT+CIPSTAMAC_DEF
AT+ CIPSTAMAC_DEF
:
ESP8266 station

ESP8266 station

ESP8266 station

MAC

MAC
flash

MAC

+CIPSTAMAC_DEF:<mac>
OK

MAC

OK

AT+CIPSTAMAC_DEF?
:
ESP8266 station

AT+CIPSTAMAC_DEF=<mac>

<mac>

ESP8266 station

MAC

flash user parameter


ESP8266 soft-AP
station
MAC
MAC
ESP8266 MAC
bit 0
18:
15:

MAC

AT+CIPSTAMAC_DEF=18:fe:35:98:d3:7b"

23. AT+CIPAPMAC
AT+ CIPAPMAC

ESP8266 softAP

ESP8266 softAP

[@deprecated]
:
ESP8266 softAP

MAC

MAC
AT+CIPAPMAC_CUR

MAC

+CIPAPMAC:<mac>
OK

MAC

OK

AT+CIPAPMAC_DEF

AT+CIPAPMAC?
:
ESP8266 softAP
AT+CIPAPMAC=<mac>

<mac>

ESP8266 softAP

flash user parameter


ESP8266 soft-AP
station
MAC
MAC
ESP8266 MAC
bit 0
1a:
15:

MAC

MAC

AT+CIPAPMAC="1a:fe:36:97:d5:7b"

Espressif Systems Confidential

43/71

Friday, July 15, 2016

Espressif Systems

24. AT+CIPAPMAC_CUR
AT+ CIPAPMAC_CUR
:
ESP8266 softAP

ESP8266 softAP

ESP8266 softAP
MAC

AT+CIPAPMAC_CUR?
:
ESP8266 softAP

ESP8266 AT Instruction Set


!

MAC

MAC
flash

+CIPAPMAC_CUR:<mac>
OK

MAC

AT+CIPAPMAC_CUR=<mac>

OK
<mac>

ESP8266 softAP

MAC

flash
ESP8266 soft-AP
station
MAC
MAC
ESP8266 MAC
bit 0
1a:
15:

MAC

AT+CIPAPMAC_CUR=1a:fe:36:97:d5:7b"

25. AT+CIPAPMAC_DEF
AT+ CIPAPMAC_DEF
:
ESP8266 softAP

ESP8266 softAP
MAC

AT+CIPAPMAC_DEF?
:
ESP8266 softAP

ESP8266 softAP

MAC

MAC

flash

+CIPAPMAC_DEF:<mac>
OK

MAC

AT+CIPAPMAC_DEF=<mac>

OK
<mac>

ESP8266 soft-AP

MAC

flash user parameter


ESP8266 soft-AP
station
MAC
MAC
ESP8266 MAC
bit 0
1a:
15:

MAC

AT+CIPAPMAC_DEF=1a:fe:36:97:d5:7b"

Espressif Systems Confidential

44/71

Friday, July 15, 2016

Espressif Systems

26. AT+CIPSTA
AT+ CIPSTA

ESP8266 station

ESP8266 station

IP

IP

[@deprecated]

:
ESP8266 station

ESP8266 AT Instruction Set


!

AT+CIPSTA_CUR

AT+CIPSTA_DEF

+CIPSTA:<ip>
IP

OK

AT+CIPSTA?
ESP8266 station IP

:
ESP8266 station

IP

AT+CIPSTA=<ip>
[,<gateway>,<netmask>]

AP

OK
<ip>
ESP8266 station
[<gateway>]
[<netmask>]

IP

flash user parameter


DHCP
IP

AT+CWDHCP

DHCP

DHCP

IP

AT+CIPSTA="192.168.6.100","192.168.6.1","255.255.255.0"

Espressif Systems Confidential

45/71

Friday, July 15, 2016

Espressif Systems

27. AT+CIPSTA_CUR
AT+ CIPSTA_CUR

:
ESP8266 station

ESP8266 AT Instruction Set


!

ESP8266 station

ESP8266 station

IP

IP
flash

+CIPSTA_CUR:<ip>
IP

OK

AT+CIPSTA_CUR?
ESP8266 station IP

:
ESP8266 station

IP

AT+CIPSTA_CUR=<ip>
[,<gateway>,<netmask>]

AP

OK
<ip>
ESP8266 station
[<gateway>]
[<netmask>]

IP

flash
DHCP
IP

AT+CWDHCP

DHCP

DHCP

IP

AT+CIPSTA_CUR=192.168.6.100,"192.168.6.1","255.255.255.0"

Espressif Systems Confidential

46/71

Friday, July 15, 2016

Espressif Systems

28. AT+CIPSTA_DEF
AT+ CIPSTA_DEF

:
ESP8266 station

ESP8266 AT Instruction Set


!

ESP8266 station

ESP8266 station

IP

IP
flash

+CIPSTA_DEF:<ip>
IP

OK

AT+CIPSTA_DEF?

:
ESP8266 station

IP

AT+CIPSTA_DEF=<ip>
[,<gateway>,<netmask>]

OK
<ip>
ESP8266 station
[<gateway>]
[<netmask>]

IP

flash user parameter


DHCP
IP

AT+CWDHCP

DHCP

DHCP

IP

AT+CIPSTA_DEF=192.168.6.100","192.168.6.1","255.255.255.0"

Espressif Systems Confidential

47/71

Friday, July 15, 2016

Espressif Systems

29. AT+CIPAP
AT+ CIPAP

ESP8266 AT Instruction Set


!

ESP8266 softAP

ESP8266 softAP

[@deprecated]

IP

IP
AT+CIPAP_CUR

AT+CIPAP_DEF

+CIPAP:<ip>,<gateway>,<netmask>
:
ESP8266 softAP

IP

AT+CIPAP?

:
ESP8266 softAP

OK
<ip>
[<gateway>]
[<netmask>]

IP

AT+CIPAP=<ip>
[,<gateway>,<netmask>]

ESP8266 softAP

IP

ESP8266 softAP

IP

OK
<ip>
[<gateway>]
[<netmask>]

flash user parameter


C

IP
DHCP

IP

AT+CWDHCP

DHCP

DHCP

IP

AT+CIPAP=192.168.5.1,192.168.5.1,255.255.255.0

Espressif Systems Confidential

48/71

Friday, July 15, 2016

Espressif Systems

30. AT+CIPAP_CUR
AT+ CIPAP_CUR

ESP8266 AT Instruction Set


!

ESP8266 softAP

ESP8266 softAP

IP

IP

flash

+CIPAP_CUR:<ip>,<gateway>,<netmask>
:
ESP8266 softAP

IP

AT+CIPAP_CUR?

:
ESP8266 softAP

OK
<ip>
[<gateway>]
[<netmask>]

IP

AT+CIPAP_CUR=<ip>
[,<gateway>,<netmask>]

ESP8266 softAP

IP

ESP8266 softAP

IP

OK
<ip>
[<gateway>]
[<netmask>]

flash;
C

IP
DHCP

IP
DHCP

AT+CWDHCP

DHCP
IP

AT+CIPAP_CUR=192.168.5.1",192.168.5.1,255.255.255.0

Espressif Systems Confidential

49/71

Friday, July 15, 2016

Espressif Systems

31. AT+CIPAP_DEF
AT+ CIPAP_DEF

ESP8266 AT Instruction Set


!

ESP8266 softAP

ESP8266 softAP

IP

IP

flash

+CIPAP_DEF:<ip>,<gateway>,<netmask>
:
ESP8266 softAP

IP

AT+CIPAP_DEF?

:
ESP8266 softAP

OK
<ip>
[<gateway>]
[<netmask>]

IP

AT+CIPAP_DEF=<ip>
[,<gateway>,<netmask>]

ESP8266 softAP

IP

ESP8266 softAP

IP

OK
<ip>
[<gateway>]
[<netmask>]

flash user parameter


C

IP
DHCP

IP

AT+CWDHCP

DHCP

DHCP

IP

AT+CIPAP_DEF=192.168.5.1",192.168.5.1,255.255.255.0

Espressif Systems Confidential

50/71

Friday, July 15, 2016

Espressif Systems

32. AT+CWSTARTSMART
AT+CWSTARTSMART

ESP8266 AT Instruction Set


!
SmartConfig

SmartConfig

:
SmartConfig.
OK
AT+CWSTARTSMART

SmartConfig

ESP-Touch + AirKiss

OK

:
SmartConfig.
AT+CWSTARTSMART=<type>

<type>
1 : ESP-Touch
2 : AirKiss
3 : ESP-Touch + AirKiss
1.

Espressif

2.

ESP8266

3.

SmartConfig

Smart get WiFi info


ESP8266

4.

station
Smart Config

AP

AP

Smartconfig connected WiFi


AT+CWSTOPSMART

AP

SmartConfig

SmartConfig
5.

AT_v1.0

SmartConfig

AirKiss

ESP-TOUCH
AT+CWMODE=1
AT+CWSTARTSMART

33. AT+CWSTOPSMART
AT+CWSTOPSMART

SmartConfig

SmartConfig

:
SmartConfig.
:
AT+CWSTOPSMART

OK
SmartConfig

AT+CWSTOPSMART

AT+CWSTOPSMART

Espressif Systems Confidential

51/71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

34. AT+CWSTARTDISCOVER
AT+CWSTARTDISCOVER

OK

AT+CWSTARTDISCOVER=
<WeChat number>,<dev_type>,
<time>

<WeChat number>
<dev_type>
<time>
0 : ESP8266
ESP8266
1.
2.

: 0 ~ 24x3600

http://iot.weixin.qq.com
ESP8266 station

IP

AT+CWSTARTDISCOVER="gh_9e2cff3dfa51","122475",10

35. AT+CWSTOPDISCOVER
AT+CWSTOPDISCOVER :
OK
:
AT+CWSTOPDISCOVER

ERROR
AT+CWSTOPDISCOVER

Espressif Systems Confidential

52/71

Friday, July 15, 2016

Espressif Systems

36. AT+WPS
AT+WPS -

ESP8266 AT Instruction Set


!

WPS

WPS

:
WPS

OK

ERROR

<enable>
1:
WPS
0:
WPS

:
AT+WPS=<enable>

1. WPS
2. WPS

ESP8266 station
WEP

AT+CWMODE=1
AT+WPS=1

37. AT+MDNS
AT+MDNS -

MDNS

MDNS

:
MDNS
:
AT+MDNS=<enable>,
<hostname>,
<server_name>,<server_port>

OK

ERROR

<enable>
1:
MDNS
0:
MDNS
<hostname>
MDNS
<server_name> MDNS
<server_port> MDNS
1. <host_name>

<server_name>

.
http

2. ESP8266 softAP

MDNS

AT+MDNS=1,"espressif","iot,8080

Espressif Systems Confidential

53/71

Friday, July 15, 2016

Espressif Systems
!

5.

TCP/IP
5.1.

ESP8266 AT Instruction Set


!

AT

TCP/IP

TCP/IP

AT+CIPSTATUS
AT+CIPDOMAIN
AT+CIPSTART

TCP

UDP

AT+CIPSSLSIZE

SSL buffer

SSL

AT+CIPSEND
AT+CIPSENDEX

/0

AT+CIPSENDBUF

TCP

AT+CIPBUFRESET
AT+CIPBUFSTATUS

TCP
TCP

AT+CIPCHECKSEQ
AT+CIPCLOSE

TCP
TCP/UDP/SSL

AT+CIFSR

IP

AT+CIPMUX
AT+CIPSERVER

TCP

AT+CIPMODE
AT+SAVETRANSLINK

flash

AT+CIPSTO

ESP8266

AT+CIUPDATE

WiFi

AT+PING

PING

AT+CIPDINFO

Espressif Systems Confidential

TCP

+IPD

54/71

IP

Friday, July 15, 2016

Espressif Systems

5.2.
1.

ESP8266 AT Instruction Set


!

TCP/IP
AT+CIPSTATUS

AT+CIPSTATUS
STATUS:<stat>
+CIPSTATUS:<link ID>,<type>,<remote IP>,<remote port> ,<local port>,<tetype>

:
:
AT+CIPSTATUS

2.

<stat> ESP8266 station


2 ESP8266 station
3 ESP8266 station
4 ESP8266 station
5 ESP8266 station
<link ID>
ID (0~4)
<type>
TCP
<remote IP>
IP
<remote port>
<local port> ESP8266
<tetype>
0: ESP8266
client
1: ESP8266
server

AP
TCP

IP
UDP

AP
UDP

AT+CIPDOMAIN

AT+CIPDOMAIN
:
+CIPDOMAIN:<IP address>
:
AT+CIPDOMAIN=
<domain name>

<domain name>
AT+CWMODE=1
// Set station mode
AT+CWJAP="SSID","password"
// access to the internet
AT+CIPDOMAIN="iot.espressif.cn" // DNS function

Espressif Systems Confidential

55/71

Friday, July 15, 2016

Espressif Systems

3.

AT+CIPSTART

AT+CIPSTART

ESP8266 AT Instruction Set


!

TCP

UDP

SSL

TCP
OK

:
1) TCP
(AT+CIPMUX=0) :
AT+CIPSTART=
<type>,<remote IP>,<remote port>
[,<TCP keep alive>]
2) TCP
(AT+CIPMUX=1) :
AT+CIPSTART=<link ID>
<type>,<remote IP>,<remote port>
[,<TCP keep alive>]

ERROR

ALREADY CONNECT
:
<link ID>
ID (0~4)
<type>
TCP
<remote IP>
IP
<remote port>
[<TCP keep alive>] TCP keep alive
0
TCP keep alive
1 ~ 7200
1s

UDP

AT+CIPSTART=TCP,"iot.espressif.cn",8000
AT+CIPSTART="TCP","192.168.101.110",1000
Espressif AT
AT+CIPSTART

UDP
OK

:
1)
(AT+CIPMUX=0) :
AT+CIPSTART=
<type>,<remote IP>,<remote port>
[,(<UDP local port>),(<UDP mode>)]

2)
(AT+CIPMUX=1) :
AT+CIPSTART=<link ID>
<type>,<remote IP>,<remote port>
[,(<UDP local port>),(<UDP mode>)]

ERROR

ALREADY CONNECT
:
<link ID>
ID (0~4)
<type>
<remote IP>
<remote port>
[<UDP local port>] UDP
[<UDP mode>] UDP
0
1
2
<UDP mode >
<UDP mode>

TCP
IP

UDP

0
0

UDP
<UDP local port>

AT+CIPSTART=UDP,"192.168.101.110",1000,1002,2
Espressif AT

Espressif Systems Confidential

56/71

Friday, July 15, 2016

Espressif Systems

AT+CIPSTART

ESP8266 AT Instruction Set


!

SSL
OK

ERROR

ALREADY CONNECT

:
AT+CIPSTART=[<link ID>,]
<type>,<remote IP>,<remote port>
[,<TCP keep alive>]

:
<link ID>
ID (0~4)
<type>
<remote IP>
IP
<remote port>
[<TCP keep alive>] keep alive
0
keep alive
1 ~ 7200
1. ESP8266

SSL

1s
SSL

2. SSL
3. SSL
AT+CIPSSLSIZE=<size>

SSL

AT+CIPSSLSIZE=4096
AT+CIPSTART=SSL,"iot.espressif.cn",8443

4.

AT+CIPSSLSIZE

AT+CIPSSLSIZE

SSL buer

SSL buffer

:
AT+CIPSSLSIZE=<size>

OK

ERROR

:
<size> SSL buffer

[2048, 4096]

AT+CIPSSLSIZE=4096

Espressif Systems Confidential

57/71

Friday, July 15, 2016

Espressif Systems

5.

ESP8266 AT Instruction Set


!

AT+CIPSEND

AT+CIPSEND
:
>
:
1)
:
(+CIPMUX=0)
AT+CIPSEND=<length>
2)
:
(+CIPMUX=1)
AT+CIPSEND=
<link ID>,<length>
3)
UDP
IP
:
AT+CIPSEND=
[<link ID>,]<length>
[,<remote IP>,<remote port>]

length

AT

ERROR

SEND OK

:
<link ID>
ID
<length>
[<remote IP>] UDP
[<remote port>] UDP

(0~4)
2048
IP

>
2048

20ms

:
+++
1

:
AT+CIPSEND
UDP

AT+CIPSTART

Espressif AT

Espressif Systems Confidential

AT

58/71

+++

AT

<UDP mode>

0.

Friday, July 15, 2016

Espressif Systems

6.

ESP8266 AT Instruction Set


!

AT+CIPSENDEX

AT+CIPSENDEX
:

:
1)
:
(+CIPMUX=0)
AT+CIPSENDEX=<length>
2)
:
(+CIPMUX=1)
AT+CIPSENDEX=
<link ID>,<length>
3)
UDP
IP
:
AT+CIPSENDEX=
[<link ID>,]<length>
[,<remote ip>,<remote port>]

Espressif Systems Confidential

>
\0

length

ERROR

SEND OK

:
<link ID>
<length>

ID

(0~4)
2048;

length
AT
\0

59/71

\0
\\0

Friday, July 15, 2016

Espressif Systems

7.

ESP8266 AT Instruction Set


!

AT+CIPSENDBUF

AT+CIPSENDBUF

TCP

TCP
<
OK
>

segment ID >,<

segment ID>

packet ID

>
length

length
1)
:
(+CIPMUX=0)
AT+CIPSENDBUF =<length>
2)
:
(+CIPMUX=1)
AT+CIPSENDBUF =
<link ID>,<length>

TCP

busy

buffer

ERROR
1)

< segment ID >, SEND OK


2)

< link ID >, < segment ID >, SEND OK

[<link ID>]
ID (0~4)
<segment ID> uint32

ID

1
<length>
TCP

SEND OK
ID

SEND OK
+++

SSL

Espressif Systems Confidential

60/71

Friday, July 15, 2016

Espressif Systems

8.

ESP8266 AT Instruction Set


!

AT+CIPBUFRESET

AT+CIPBUFRESET
1)
:
(+CIPMUX=0)
AT+CIPBUFRESET

OK

2)
:
(+CIPMUX=1)
AT+CIPBUFRESET =<link ID>

ERROR
<link ID>

ID (0~4)
AT+CIPSENDBUF

9.

AT+CIPBUFSTATUS

AT+CIPBUFSTATUS

TCP

TCP

1)
:
(+CIPMUX=0)
AT+CIPBUFSTATUS
2)
:
(+CIPMUX=1)
AT+CIPBUFSTATUS =<link ID>

<
segment ID>,<
segment ID>,<
ID>,<remain buffer size>, <queue number>
OK

segment

<
<

ID

segment ID>:
AT+CIPSENDBUF
segment ID>
TCP
ID
<
segment ID> - <
segment ID> = 1
AT+CIPBUFRESET
<
segment ID>
TCP
ID
<remain buffer size> TCP
<queue number>:
queue
SSL
AT+CIPBUFSTATUS
20,15,10,200,7
20

19

AT+CIPSENDBUF

20
15
10
200
7

15
10
TCP
queue

Espressif Systems Confidential

200 bytes
7

queue

61/71

Friday, July 15, 2016

Espressif Systems

10. AT+CIPCHECKSEQ
AT+CIPCHECKSEQ

ESP8266 AT Instruction Set


!
TCP

TCP

1)
:
(+CIPMUX=0)
AT+CIPCHECKSEQ=
<segment ID>

[<link ID>,]<segment ID> ,<status>


OK

2)
:
(+CIPMUX=1)
AT+CIPCHECKSEQ=
<link ID>,<segment ID>

32
[<link ID>]
< segment ID>:
<status> : FALSE,

segment ID
ID (0~4)
AT+CIPSENDBUF
TRUE,

ID;

AT+CIPSENDBUF

11. AT+CIPCLOSE
AT+CIPCLOSE

TCP / UDP / SSL

TCP / UDP / SSL

:
TCP / UDP
:

AT+CIPCLOSE=<link ID>

OK
<link ID>
ID
5

ID
server

ID

:
AT+CIPCLOSE

Espressif Systems Confidential

OK

62/71

Friday, July 15, 2016

Espressif Systems

12. AT+CIFSR
AT+CIFSR

ESP8266 AT Instruction Set


!

IP

IP
+ CIFSR:<IP address>
+ CIFSR:<IP address>

:
IP
:
AT+CIFSR

OK
<IP address>
ESP8266 softAP
ESP8266 station

IP
IP

ESP8266 station IP

Espressif Systems Confidential

63/71

AP

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

13. AT+CIPMUX
AT+CIPMUX
+ CIPMUX:<mode>
:
AT+CIPMUX?

:
:
AT+CIPMUX=<mode>

OK

OK
<mode>
0
1
1.
2.
3.
4.

( AT+CIPMODE=0)
TCP
AT+CIPSERVER=0

AT+CIPMUX=1

Espressif Systems Confidential

64/71

Friday, July 15, 2016

Espressif Systems

14. AT+CIPSERVER
AT+ CIPSERVER

ESP8266 AT Instruction Set


!

TCP server

TCP server
OK

:
TCP server.
:
AT+ CIPSERVER=
<mode>[,<port>]

<mode>
0
1
<port>
1.
2.
3.

server
server
333

TCP
TCP client

AT+CIPMUX=1
TCP server

TCP
id

AT+CIPMUX=1
AT+CIPSERVER=1,1001

15. AT+CIPMODE
AT+ CIPMODE

:
:
AT+CIPMODE?

:
:
AT+CIPMODE=<mode>

+CIPMODE:<mode>
OK

OK
<mode>
0
1

TCP

UDP

Flash.

1.
2.

ESP8266

++

+
AT+CIPMODE=1

Espressif Systems Confidential

65/71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

16. AT+SAVETRANSLINK

Flash

AT+SAVETRANSLINK

TCP

Flash
OK

:
Flash.
:
AT+SAVETRANSLINK
=<mode>,<remote IP or domain
name>,<remote port>[,<type>,<TCP
keep alive>]

ERROR

<mode>
0
1
<remote IP>
IP
<remote port>
port
[<type>]
TCP
UDP
TCP
[<TCP keep alive>]
TCP keep alive
0
TCP keep alive
1 ~ 7200
TCP

1.
parameter

Flash user
TCP

IP port

2.

Flash

AT+SAVETRANSLINK=1,192.168.6.110,1002,TCP
AT+SAVETRANSLINK

UDP

Flash
OK

:
Flash.
:
AT+SAVETRANSLINK
=<mode>,<remote IP>,<remote
port>,<type>[,<UDP local port>]

ERROR

<mode>
0
1
<remote IP>
IP
<remote port>
port
<type> UDP
[<UDP local port>]
UDP
UDP

1.
parameter
2.

TCP

Flash user
UDP

IP port

Flash

AT+SAVETRANSLINK=1,192.168.6.110,1002,UDP,1005

Espressif Systems Confidential

66/71

Friday, July 15, 2016

Espressif Systems

17. AT+CIPSTO
AT+ CIPSTO

ESP8266 AT Instruction Set


!

TCP server

TCP server
+ CIPSTO:<time>

:
TCP server
:
AT+CIPSTO?

:
TCP server
:
AT+CIPSTO=<time>

OK

OK
< time> TCP server
TCP server
1. ESP8266
client
2.
AT+CIPSTO=0

0~7200
TCP

AT+CIPMUX=1
AT+CIPSERVER=1,1001
AT+CIPSTO=10

Espressif Systems Confidential

67/71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

18. AT+PING ping


AT+PING ping
+<time>
OK

:
ping

ERROR //

:
AT+PING=<IP>

ping

<IP> :
<time> : ping

IP

AT+PING=192.168.1.1
AT+PING=www.baidu.com

19. AT+CIUPDATE
1.

Espressif
AT

Cloud
2.

WiFi
AT BIN (\ESP8266_NONOS_SDK\bin\at)

AT
Demo

3.
4.

AT

AT+ CIUPDATE

AT+CIUPDATE
\ESP8266_NONOS_SDK\example\at
AT BIN
user1.bin user2.bin
"AT+RESTORE"

Espressif
Espressif

WiFi
+CIPUPDATE:<n>

:
:
AT+ CIUPDATE

OK
<n>
1
2
3
4
ERROR

Espressif Systems Confidential

68/71

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

20. AT+CIPDINFO
AT+CIPDINFO

IP
+IPD

:
+IPD

IP

OK

IP
:
AT+CIPDINFO=<mode>

<mode>
0
1

IP
IP

AT+CIPDINFO=1

21. +IPD
+IPD
:
1)
:
(+CIPMUX=0)
+IPD,<len>[,<remote IP>,<remote
port>]:<data>
2)
(+CIPMUX=1)
+IPD,<link ID>,<len>[,<remote
IP>,<remote port>]:<data>

Espressif Systems Confidential

ESP8266
+IPD
[<remote IP>]
[<remote port>]
<link ID>
<len>
<data>

69/71

IP

AT+CIPDINFO=1
AT+CIPDINFO=1

ID

Friday, July 15, 2016

Espressif Systems

ESP8266 AT Instruction Set


!

6.
ESP8266 AT

Flash:

Flash user parameter


AT+UART_DEF

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

AT+CWDHCP_DEF

AT+CWDHCP_DEF=1,1

AT+CIPSTAMAC_DEF

AT+CIPSTAMAC_DEF="18:fe:35:98:d3:7b"

AT+CIPAPMAC_DEF

AT+CIPAPMAC_DEF="1a:fe:36:97:d5:7b"

AT+CIPSTA_DEF

AT+CIPSTA_DEF="192.168.6.100"

AT+CIPAP_DEF

AT+CIPAP_DEF="192.168.5.1"

AT+CWDHCPS_DEF

AT+CWDHCPS_DEF=1,3,192.168.4.10,192.168.4.15

AT+SAVETRANSLINK

AT+SAVETRANSLINK =1,"192.168.6.10,1001

Flash system parameter


AT+CWMODE_DEF

AT+CWMODE_DEF=3

AT+CWJAP_DEF

AT+CWJAP_DEF=abc 0123456789

AT+CWSAP_DEF

AT+CWSAP_DEF="ESP8266","12345678",5,3

AT+CWAUTOCONN

AT+CWAUTOCONN=1

Flash

512KB+512KB Flash Map:

Flash

0x7C000 ~ 0x80000, 16KB;

1024KB+1024KB Flash Map:

0xFC000 ~ 0x100000, 16KB;

Flash

Espressif Systems Confidential

16KB

70/71

Friday, July 15, 2016

7.

Espressif Systems

ESP8266 AT Instruction Set


!

Q&A

AT

feedback@espressif.com

AT

AT+GMR

ESP-01

log

log

ets Jan 8 2013,rst cause: 1, boot mode: (3,3)

load 0x40100000, len 26336, room 16

tail 0

chksum 0xde

load 0x3e8000, len 5672, room 8

tail 0

chksum 0x69

load 0x3e9630, len 8348, room 8

tail 4

chksum 0xcb

csum 0xcb

SDK version: 0.9.1

addr not ack when tx write cmd

mode : sta(18: fe: 34: 97: d5: 7b) + softAP(1a: fe: 34: 97: d5: 7b)

Espressif Systems Confidential

71/71

Friday, July 15, 2016

You might also like