樂(lè)鑫原廠參考資料4a-espressif at指令集018_W

1、StatusReleasedCurrent versionV0.18AuthorXu JingjieCompletion Date2014.9.25ReviewerCompletion DateEspressifAT 指令集 CONFIDENTIAL INTERNAL PUBLIC 7/ 18Espressif SystemsJune 16, 2014免責(zé)申明和版權(quán)公告本文中的信息，包括供參考的 URL 地址，如有變更，恕不另行。 文檔“按現(xiàn)狀”提供，不負(fù)任何擔(dān)保責(zé)任，包括對(duì)適銷(xiāo)性、適用于特定用途或非侵權(quán)性的任何擔(dān)保，和任何提案、規(guī)格或樣品在他處提到的任何擔(dān)保。本文檔不負(fù)任何責(zé)任，包括使用本文

2、檔內(nèi)信息產(chǎn)生的任何專利權(quán)行為的責(zé)任。本文檔在此未以禁止反言或其他方式授予任何知識(shí)產(chǎn)權(quán)使用許可，不管是明示許可還是暗示許可。 Wi-Fi 聯(lián)盟成員標(biāo)志歸 Wi-Fi 聯(lián)盟所有。 文中提到的所有商標(biāo)名稱、商標(biāo)和注冊(cè)商標(biāo)均屬其各自所有者的財(cái)產(chǎn)，特此聲明。版權(quán)歸 2014 樂(lè)鑫信息技術(shù)有限公司所有。保留所有權(quán)利。 版本信息日期 版本 撰寫(xiě)人 審核人 修改說(shuō)明 2014.6.270.1XuJingjie初稿 2014.7.110.11XuJingjie增加透?jìng)?2014.8.120.15XuJingjie增加超時(shí) AP 的 IP 設(shè)置 修改 server 功能描述修改多連接功能描述 修改關(guān)閉連接功能描述

3、增加域名連接 2014.9.250.18XuJingjie增加 update 功能 添加 CWLAP 設(shè)置指令 目錄版本信息3目錄41概述52 指令說(shuō)明63 基礎(chǔ) AT 指令73.1 基礎(chǔ) AT 指令一覽表73.2 基礎(chǔ) AT 指令描述73.2.1 AT 測(cè)試 AT 啟動(dòng)73.2.2 AT+RST 重啟模塊73.2.3 AT+GMR 查看版本信息74 Wifi 功能 AT 指令84.1 Wifi 功能 AT 指令一覽表84.2 Wifi 功能 AT 指令84.2.1 AT+CWMODE 選擇 WIFI 應(yīng)用模式84.2.2 AT+CWJAP 加入 AP94.2.3 AT+CWLAP 列出當(dāng)前可

4、用 AP94.2.4 AT+CWQAP 退出與 AP 的連接104.2.5 AT+ CWSAP 設(shè)置 AP 模式下的參數(shù)104.2.6 AT+ CWLIF 查看已接入設(shè)備的 IP115 TCP/IP 工具箱 AT 指令115.1 TCP/IP 工具箱 AT 指令一覽表115.2 TCP/IP 工具箱 AT 指令描述125.2.1 AT+ CIPSTATUS 獲得連接狀態(tài)125.2.2 AT+CIPSTART 建立 TCP 連接或注冊(cè) UDP 端125.2.3 AT+CIPSEND 發(fā)送數(shù)據(jù)135.2.4 AT+CIPCLOSE 關(guān)閉 TCP 或 UDP145.2.5 AT+CIFSR 獲取本地

5、 IP 地址145.2.6 AT+ CIPMUX 啟動(dòng)多連接155.2.7 AT+ CIPSERVER 配置為服務(wù)器155.2.8 AT+ CIPMODE 設(shè)置模塊傳輸模式165.2.9 AT+ CIPSTO 設(shè)置服務(wù)器超時(shí)時(shí)間165.2.10 AT+ CIUPDATE 網(wǎng)絡(luò)固件升級(jí)175.2.11 +IPD 接收到網(wǎng)絡(luò)數(shù)據(jù)176 問(wèn)題反饋181 概述描述 Espressif AT 指令集功能以及使用方法 指令集主要分為：基礎(chǔ) AT 命令、Wifi 功能 AT 命令、TCP/IP 工具箱 AT 命令等。 2 指令說(shuō)明每條指令可以有細(xì)分四種命令 測(cè)試命令 AT+=?該命令用于查詢?cè)O(shè)置命令或內(nèi)部程

6、序設(shè)置的參數(shù)以及其取值范圍。 查詢命令 AT+?該命令用于返回參數(shù)的當(dāng)前值。 設(shè)置命令 AT+=該命令用于設(shè)置用戶自定義的參數(shù)值。 執(zhí)行命令 AT+該命令用于執(zhí)行受模塊內(nèi)部程序控制的變參數(shù)不可變的功能。 注意：1.不是每條 AT 指令都具備上述 4 類(lèi)命令 2. 內(nèi)數(shù)據(jù)為缺省值，不必填寫(xiě)或可能不顯示 3.使用雙引號(hào)表示字符串?dāng)?shù)據(jù).”string”4.波特率 1152005.輸入已回車(chē)換行結(jié)尾”rn”3 基礎(chǔ) AT 指令3.2 基礎(chǔ) AT 指令描述3.2.1 AT 測(cè)試 AT 啟動(dòng)3.2.2 AT+RST 重啟模塊3.2.3 AT+GMR 查看版本信息3.1 基礎(chǔ) AT 指令一覽表基礎(chǔ) AT 指

7、令 命令 描述 AT測(cè)試 AT 啟動(dòng) AT+RST重啟模塊 AT+GMR查看版本信息 AT 測(cè)試 AT 啟動(dòng) 執(zhí)行指令 AT響應(yīng) OK參數(shù)說(shuō)明 參考 說(shuō)明 AT+RST 重啟模塊 執(zhí)行指令 AT+RST響應(yīng) OK參數(shù)說(shuō)明 參考 說(shuō)明 AT+GMR 查看版本信息 執(zhí)行指令 AT+GMR響應(yīng) OK參數(shù)說(shuō)明 8 位版本號(hào) 參考 說(shuō)明 0017xxxxxx0017 為 AT 版本 4.1 Wifi 功能 AT 指令一覽表4.2 Wifi 功能 AT 指令4.2.1 AT+CWMODE 選擇WIFI 應(yīng)用模式4 Wifi 功能 AT 指令Wifi 功能 AT 指令 命令 描述 AT+CWMODE選擇 W

8、IFI 應(yīng)用模式 AT+CWJAP加入 APAT+CWLAP列出當(dāng)前可用 APAT+CWQAP退出與 AP 的連接 AT+ CWSAP設(shè)置 AP 模式下的參數(shù) AT+ CWLIF查看已接入設(shè)備的 IPAT+CWMODE 選擇 WIFI 應(yīng)用模式 測(cè)試指令 AT+CWMODE=?響應(yīng) +CWMODE:(取值列表)OK參數(shù)說(shuō)明 見(jiàn)設(shè)置命令 查詢命令 AT+CWMODE?響應(yīng) 返回當(dāng)前模塊的模式 +CWMODE:OK參數(shù)說(shuō)明 見(jiàn)設(shè)置指令 設(shè)置指令 AT+CWMODE=響應(yīng) OK8/ 18Espressif SystemsJune 16, 2014參數(shù)說(shuō)明 1Station 模式 2 AP 模式 3

9、AP 兼 Station 模式 參考 說(shuō)明 4.2.3 AT+CWLAP 列出當(dāng)前可用 AP4.2.2 AT+CWJAP 加 入 APAT+CWJAP 加入 AP查詢命令 AT+ CWJAP?響應(yīng) 返回當(dāng)前選擇的 AP+ CWJAP:OK參數(shù)說(shuō)明 見(jiàn)設(shè)置指令 設(shè)置指令 AT+ CWJAP =,響應(yīng) OK ERROR參數(shù)說(shuō)明 字符串參數(shù)，接入點(diǎn)名稱 字符串參數(shù)， 最長(zhǎng) 64 字節(jié) ASCII參考 說(shuō)明 AT+CWLAP 列出當(dāng)前可用 AP設(shè)置指令 響應(yīng) AT+ CWLAP =,返回符合查詢要求的 AP+ CWLAP: ,OK ERROR參數(shù)說(shuō)明 見(jiàn)設(shè)置指令 執(zhí)行指令 響應(yīng) AT+CWLAP終端返

10、回 AP 列表 + CWLAP: ,OKERROR11/ 18Espressif SystemsJune 16, 2014參數(shù)說(shuō)明 0OPEN1 WEP2 WPA_PSK3 WPA2_PSK4 WPA_WPA2_PSK字符串參數(shù)，接入點(diǎn)名稱 信號(hào)強(qiáng)度 字符串參數(shù)，mac 地址 參考 說(shuō)明 4.2.4 AT+CWQAP 退出與 AP 的連接4.2.5 AT+ CWSAP 設(shè)置 AP 模式下的參數(shù)AT+CWQAP 退出與 AP 的連接 測(cè)試指令 AT+CWQAP=?響應(yīng) OK參數(shù)說(shuō)明 執(zhí)行指令 AT+ CWQAP響應(yīng) OK參數(shù)說(shuō)明 參考 說(shuō)明 AT+ CWSAP 設(shè)置 AP 模式下的參數(shù) 查詢命令

11、 AT+ CWSAP?響應(yīng) 返回當(dāng)前 AP 參數(shù) + CWSAP:,參數(shù)說(shuō)明 見(jiàn)設(shè)置指令 設(shè)置指令 響應(yīng) AT+ CWSAP=,OK ERROR參數(shù)說(shuō)明 指令只有在 AP 模式開(kāi)啟后有效 字符串參數(shù)，接入點(diǎn)名稱 字符串參數(shù)， 最長(zhǎng) 64 字節(jié) ASCII通道號(hào) 0OPEN2 WPA_PSK3 WPA2_PSK4 WPA_WPA2_PSK參考 說(shuō)明 通道修改后需要+RST 重啟模塊 5 TCP/IP 工具箱 AT 指令5.1 TCP/IP 工具箱 AT 指令一覽表4.2.6 AT+ CWLIF 查看已接入設(shè)備的 IPAT+ CWLIF 查看已接入設(shè)備的 IP執(zhí)行指令 AT+CWLIF響應(yīng) OK參

12、數(shù)說(shuō)明 已接入設(shè)備的 IP 地址 參考 說(shuō)明 TCP/IP 工具箱 AT 指令 命令 描述 AT+ CIPSTATUS獲得連接狀態(tài) AT+CIPSTART建立 TCP 連接或注冊(cè) UDP 端 AT+CIPSEND發(fā)送數(shù)據(jù) AT+CIPCLOSE關(guān)閉 TCP 或 UDPAT+CIFSR獲取本地 IP 地址 AT+CIPMUX啟動(dòng)多連接 AT+CIPSERVER配置為服務(wù)器 AT+CIPMODE設(shè)置模塊傳輸模式 AT+CIPSTO設(shè)置服務(wù)器超時(shí)時(shí)間 5.2 TCP/IP 工具箱 AT 指令描述5.2.2 AT+CIPSTART 建立 TCP 連接或注冊(cè) UDP 端5.2.1 AT+ CIPSTAT

13、US 獲得連接狀態(tài)AT+ CIPSTATUS 獲得連接狀態(tài) 測(cè)試指令 響應(yīng) OK參數(shù)說(shuō)明 執(zhí)行指令 響應(yīng) AT+ CIPSTATUS返回當(dāng)前模塊的連接狀態(tài)和連接參數(shù) STATUS:+ CIPSTATUS:,OK參數(shù)說(shuō)明 2:獲得 ip3:建立連接 4:失去連接 連接的 id 號(hào) 0-4字符串參數(shù)，類(lèi)型 TCP 或 UDP字符串參數(shù)，IP 地址 端 0: 本模塊做 client 的連接 1: 本模塊做 server 的連接 參考 說(shuō)明 AT+CIPSTART 建立 TCP 連接或注冊(cè) UDP 端 測(cè)試指令 響應(yīng) AT+CIPSTART=?1) 設(shè)置 AT+CIPMUX=0+CIPSTART:(取

14、值列表),(范圍),(范圍)+CIPSTART:(取值列表),(范圍),(范圍)OK2) 設(shè)置 AT+CIPMUX=1+CIPSTART:(id),(取值列表),(范圍),(范圍)+CIPSTART: (id), (取值列表),(范 12/ 18Espressif SystemsJune 16, 2014圍),(范圍)參數(shù)說(shuō)明 見(jiàn)設(shè)置命令 設(shè)置命令 響應(yīng) 1)單路連接(+CIPMUX=0) AT+CIPSTART=,如果格式正確且連接成功，返回 OK否則返回 ERROR如果連接已經(jīng)存在，返回 1)多路連接(+CIPMUX=1) AT+CIPSTART=,ALREAY CONNECT參數(shù)說(shuō)明 0

15、-4 連接的 id 號(hào) 字符串參數(shù)，表明連接類(lèi)型”TCP”建立 tcp 連接”UDP”建立 UDP 連接 字符串參數(shù)，遠(yuǎn)程服務(wù)器 IP 地址 遠(yuǎn)程服務(wù)器端 參考 說(shuō)明 5.2.3 AT+CIPSEND 發(fā)送數(shù)據(jù)AT+CIPSEND 發(fā)送數(shù)據(jù) 測(cè)試指令 AT+CIPSEND=?響應(yīng) OK參數(shù)說(shuō)明 見(jiàn)設(shè)置命令 設(shè)置指令 1)單路連接時(shí)(+CIPMUX=0)AT+CIPSEND=響應(yīng) 發(fā)送指定長(zhǎng)度的數(shù)據(jù)。收到此命令后先換行返回”，然后開(kāi)始接收串口數(shù)據(jù)，當(dāng)數(shù)據(jù)長(zhǎng)度滿 length 時(shí)發(fā)送數(shù)據(jù)。如果未建立連接或連接被斷開(kāi)，返回 1)多路連接時(shí)(+CIPMUX=1) AT+CIPSEND=,ERROR如果

16、數(shù)據(jù)發(fā)送成功，返回 SEND OK參數(shù)說(shuō)明 需要用于傳輸連接的 id 號(hào) 數(shù)字參數(shù)，表明發(fā)送數(shù)據(jù)的長(zhǎng)度，最大長(zhǎng)度為204815/ 18Espressif SystemsJune 16, 2014執(zhí)行指令 響應(yīng) AT+CIPSEND收到此命令后先換行返回”然后就進(jìn)入了透?jìng)髂Ｊ?，每包?shù)據(jù)以 20ms 間隔區(qū)分，每 包最大 2048 字節(jié)。 當(dāng)輸入單獨(dú)一包”+”返回指令模式。 該指令必須在開(kāi)啟透?jìng)髂Ｊ揭约皢芜B接模式下使用 參考 說(shuō)明 5.2.4 AT+CIPCLOSE 關(guān)閉 TCP 或 UDP5.2.5 AT+CIFSR 獲取本地 IP 地址AT+CIPCLOSE 關(guān)閉 TCP 或 UDP測(cè)試指令

17、AT+CIPCLOSE=?響應(yīng) OK設(shè)置命令 多路連接時(shí) AT+CIPCLOSE=響應(yīng) 如果輸入正確，返回 OK如果沒(méi)有該連接則，返回 Link is not參數(shù)說(shuō)明 需要關(guān)閉的連接 id當(dāng) id=5 時(shí)關(guān)閉所有連接（開(kāi)啟 server 后 id=5 無(wú)效） 執(zhí)行指令 單路連接時(shí) AT+CIPCLOSE響應(yīng) 如果輸入正確，返回 OK如果沒(méi)有連接則，返回 ERROR當(dāng)沒(méi)有連接時(shí)返回狀態(tài)打印 unlink參考 說(shuō)明 AT+CIFSR 獲取本地 IP 地址 測(cè)試指令 AT+CIFSR=?響應(yīng) OK執(zhí)行命令 AT+ CIFSR響應(yīng) + CIFSR:+ CIFSR:OKERROR參數(shù)說(shuō)明 本機(jī)目前的 I

18、P 地址 第一行為 AP 下的 IP，第二行為 STA下的 IP參考 說(shuō)明 5.2.6 AT+ CIPMUX 啟動(dòng)多連接5.2.7 AT+ CIPSERVER 配置為服務(wù)器AT+ CIPMUX 啟動(dòng)多連接 查詢命令 AT+ CIPMUX?響應(yīng) + CIPMUX:OK參數(shù)說(shuō)明 見(jiàn)設(shè)置指令 設(shè)置指令 AT+ CIPMUX=響應(yīng) OK如果已經(jīng)處于連接狀態(tài)則，返回 Link is builded參數(shù)說(shuō)明 0單路連接模式 1多路連接模式 參考 說(shuō)明 只有當(dāng)連接都斷開(kāi)后才能更改，如果開(kāi)啟過(guò) server 需要重啟模塊 AT+ CIPSERVER 配置為服務(wù)器 設(shè)置指令 AT+ CIPSERVER=,響應(yīng)

19、OK關(guān)閉 server 需要重啟 參數(shù)說(shuō)明 0關(guān)閉 server 模式 1開(kāi)啟 server 模式 端 ，缺省值為 333參考 說(shuō)明 開(kāi)啟 server 后自動(dòng)建立 server 當(dāng)有 client 接入會(huì)自動(dòng)按順序占用一個(gè)連接 AT+ CIPMUX=1 時(shí)才能開(kāi)啟服務(wù)器 5.2.9 AT+ CIPSTO 設(shè)置服務(wù)器超時(shí)時(shí)間5.2.8 AT+ CIPMODE 設(shè)置模塊傳輸模式AT+ CIPMODE 設(shè)置模塊傳輸模式 查詢命令 AT+ CIPMODE?響應(yīng) + CIPMODE:OK參數(shù)說(shuō)明 見(jiàn)設(shè)置指令 設(shè)置指令 響應(yīng) AT+CIPMODE=OK如果已經(jīng)處于連接狀態(tài)則，返回 Link is builded參數(shù)說(shuō)明 0非透?jìng)髂Ｊ?1透?jìng)髂Ｊ?參考 說(shuō)明 AT+ CIPSTO 設(shè)置服務(wù)器超時(shí)時(shí)間 查詢指令 AT+CIPSTO?響應(yīng) + CIPSTO:OK參數(shù)說(shuō)明 見(jiàn)設(shè)置指令 設(shè)置指令 AT+CIPSTO=響應(yīng) OK參數(shù)說(shuō)明 028800 服務(wù)器超時(shí)時(shí)間，單位為 s參考 說(shuō)明 16/ 18Espressif SystemsJune 16, 20145.2.11 + IPD 接收到網(wǎng)絡(luò)數(shù)據(jù)5.2.10 AT+ CIUPDATE 網(wǎng)絡(luò)固件升級(jí)AT+ CIUPDATE 網(wǎng)絡(luò)固件升級(jí) 執(zhí)行指令 響應(yīng) AT+ CIUPDATE+ CIPSTO:OK參數(shù)說(shuō)明 1found