樂鑫原廠參考資料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é)任，包括對適銷性、適用于特定用途或非侵權(quán)性的任何擔(dān)保，和任何提案、規(guī)格或樣品在他處提到的任何擔(dān)保。本文檔不負(fù)任何責(zé)任，包括使用本文

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

3、增加域名連接 2014.9.250.18XuJingjie增加 update 功能 添加 CWLAP 設(shè)置指令 目錄版本信息3目錄41概述52 指令說明63 基礎(chǔ) AT 指令73.1 基礎(chǔ) AT 指令一覽表73.2 基礎(chǔ) AT 指令描述73.2.1 AT 測試 AT 啟動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 連接或注冊 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 啟動多連接155.2.7 AT+ CIPSERVER 配置為服務(wù)器155.2.8 AT+ CIPMODE 設(shè)置模塊傳輸模式165.2.9 AT+ CIPSTO 設(shè)置服務(wù)器超時時間165.2.10 AT+ CIUPDATE 網(wǎng)絡(luò)固件升級175.2.11 +IPD 接收到網(wǎng)絡(luò)數(shù)據(jù)176 問題反饋181 概述描述 Espressif AT 指令集功能以及使用方法 指令集主要分為：基礎(chǔ) AT 命令、Wifi 功能 AT 命令、TCP/IP 工具箱 AT 命令等。 2 指令說明每條指令可以有細分四種命令 測試命令 AT+=?該命令用于查詢設(shè)置命令或內(nèi)部程

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

7、令 命令 描述 AT測試 AT 啟動 AT+RST重啟模塊 AT+GMR查看版本信息 AT 測試 AT 啟動 執(zhí)行指令 AT響應(yīng) OK參數(shù)說明 參考 說明 AT+RST 重啟模塊 執(zhí)行指令 AT+RST響應(yīng) OK參數(shù)說明 參考 說明 AT+GMR 查看版本信息 執(zhí)行指令 AT+GMR響應(yīng) OK參數(shù)說明 8 位版本號 參考 說明 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)用模式 測試指令 AT+CWMODE=?響應(yīng) +CWMODE:(取值列表)OK參數(shù)說明 見設(shè)置命令 查詢命令 AT+CWMODE?響應(yīng) 返回當(dāng)前模塊的模式 +CWMODE:OK參數(shù)說明 見設(shè)置指令 設(shè)置指令 AT+CWMODE=響應(yīng) OK8/ 18Espressif SystemsJune 16, 2014參數(shù)說明 1Station 模式 2 AP 模式 3

9、AP 兼 Station 模式 參考 說明 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ù)說明 見設(shè)置指令 設(shè)置指令 AT+ CWJAP =,響應(yīng) OK ERROR參數(shù)說明 字符串參數(shù)，接入點名稱 字符串參數(shù)， 最長 64 字節(jié) ASCII參考 說明 AT+CWLAP 列出當(dāng)前可用 AP設(shè)置指令 響應(yīng) AT+ CWLAP =,返回符合查詢要求的 AP+ CWLAP: ,OK ERROR參數(shù)說明 見設(shè)置指令 執(zhí)行指令 響應(yīng) AT+CWLAP終端返

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

11、 AT+ CWSAP?響應(yīng) 返回當(dāng)前 AP 參數(shù) + CWSAP:,參數(shù)說明 見設(shè)置指令 設(shè)置指令 響應(yīng) AT+ CWSAP=,OK ERROR參數(shù)說明 指令只有在 AP 模式開啟后有效 字符串參數(shù)，接入點名稱 字符串參數(shù)， 最長 64 字節(jié) ASCII通道號 0OPEN2 WPA_PSK3 WPA2_PSK4 WPA_WPA2_PSK參考 說明 通道修改后需要+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ù)說明 已接入設(shè)備的 IP 地址 參考 說明 TCP/IP 工具箱 AT 指令 命令 描述 AT+ CIPSTATUS獲得連接狀態(tài) AT+CIPSTART建立 TCP 連接或注冊 UDP 端 AT+CIPSEND發(fā)送數(shù)據(jù) AT+CIPCLOSE關(guān)閉 TCP 或 UDPAT+CIFSR獲取本地 IP 地址 AT+CIPMUX啟動多連接 AT+CIPSERVER配置為服務(wù)器 AT+CIPMODE設(shè)置模塊傳輸模式 AT+CIPSTO設(shè)置服務(wù)器超時時間 5.2 TCP/IP 工具箱 AT 指令描述5.2.2 AT+CIPSTART 建立 TCP 連接或注冊 UDP 端5.2.1 AT+ CIPSTAT

13、US 獲得連接狀態(tài)AT+ CIPSTATUS 獲得連接狀態(tài) 測試指令 響應(yīng) OK參數(shù)說明 執(zhí)行指令 響應(yīng) AT+ CIPSTATUS返回當(dāng)前模塊的連接狀態(tài)和連接參數(shù) STATUS:+ CIPSTATUS:,OK參數(shù)說明 2:獲得 ip3:建立連接 4:失去連接 連接的 id 號 0-4字符串參數(shù)，類型 TCP 或 UDP字符串參數(shù)，IP 地址 端 0: 本模塊做 client 的連接 1: 本模塊做 server 的連接 參考 說明 AT+CIPSTART 建立 TCP 連接或注冊 UDP 端 測試指令 響應(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ù)說明 見設(shè)置命令 設(shè)置命令 響應(yīng) 1)單路連接(+CIPMUX=0) AT+CIPSTART=,如果格式正確且連接成功，返回 OK否則返回 ERROR如果連接已經(jīng)存在，返回 1)多路連接(+CIPMUX=1) AT+CIPSTART=,ALREAY CONNECT參數(shù)說明 0

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

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

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

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

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