rak453參考-uart編程手冊(cè)瑞科慧聯(lián)科技

RAK453UART-WIFI模編程市瑞科目 -模塊簡介....................................................................................................1模塊特性....................................................................................................1應(yīng)用領(lǐng)域....................................................................................................2-硬件接口....................................................................................................3無線驅(qū)動(dòng)....................................................................................................3-功耗特性....................................................................................................3-開機(jī)啟動(dòng)....................................................................................................4操作流程....................................................................................................5-命令格式....................................................................................................6管理命令....................................................................................................9查詢模塊MAC.............................................................................10查詢版本信息..............................................................................10設(shè)置功耗模式..............................................................................11復(fù)位模 .-12設(shè)置模塊主機(jī)名..........................................................................13獲取模塊主機(jī)名..........................................................................13-掃描無線網(wǎng)絡(luò)..............................................................................14掃描信息..............................................................................15-創(chuàng)建無線接入點(diǎn)..........................................................................19連接無線網(wǎng)絡(luò)..............................................................................20--EasyConfig聯(lián)網(wǎng)........................................................................25查詢無線網(wǎng)絡(luò)連接狀態(tài)...........................................................-25查詢模塊IP信息......................................................................26解析....................................................................................28AP高級(jí)參數(shù)...............................................................................29-斷開無線網(wǎng) .-31----創(chuàng)建UDPSERVER......................................................................35-關(guān)閉已創(chuàng)建的端口......................................................................-39-寫數(shù)據(jù)........................................................................................40讀數(shù)據(jù)........................................................................................41-保存配置參數(shù)..............................................................................44配置參數(shù)..............................................................................45啟動(dòng)自動(dòng)聯(lián)網(wǎng)..............................................................................50版 .-53版本歷程、軟件版本和文檔對(duì)應(yīng)關(guān)系 功能特模塊簡RAK453是一款完全符合802.11b/g/n無線協(xié)議的Wi-Fi模塊，內(nèi)部集成完整的ARP、IP、ICMP、TCP、UDP、DHCPCLIENT、DHCPSERVER、DNS、等多種AP模式，StationAd-hoc。用戶可以方便、快速地使用模塊實(shí)現(xiàn)組網(wǎng)及數(shù)據(jù)收發(fā)。模塊的串口波特率最921600bps。完全滿足低速率的應(yīng)用。RAK453支持參數(shù)保存，可由客戶命令啟動(dòng)是否自動(dòng)聯(lián)網(wǎng)，實(shí)現(xiàn)一步聯(lián)網(wǎng)，減少系統(tǒng)組網(wǎng)時(shí)間。內(nèi)WEB服務(wù)器，支持無線配置模塊網(wǎng)絡(luò)參數(shù)，支持無線升級(jí)模塊固件。支持WPSEasyConfig一鍵入網(wǎng)方式。極大的降低了軟件開發(fā)難度。模塊特802.11b/g/n協(xié)支持帶數(shù)據(jù)流控制的UART通信，最大波特率為極簡的硬件電路設(shè)DHCPSERVER、DHCP支持TLSv1.2/1.1/1.0、 支持雙向認(rèn)支持OPEN、WEP、-PSK、2-PSK、WPSTCP、UDP8UDP/TCP連支持WPS，EasyConfig支持參數(shù)保存，客戶命令啟動(dòng)加支持深度睡眠下參數(shù)保存，最快連接時(shí)間僅為支持無線升級(jí)板載陶瓷天U.FL2應(yīng)用領(lǐng)便攜產(chǎn)醫(yī)療領(lǐng)域，如、醫(yī)療診計(jì)量（停車計(jì)時(shí)、計(jì)量儀表、等詳細(xì)功硬件接接口的實(shí)際吞吐率可到支持硬件流控，可保證數(shù)據(jù)傳輸?shù)目煽繜o線驅(qū)IEEE802.11b/g/n標(biāo)AP,STAADHOC模/支持WEP 2-PSK/快速聯(lián)網(wǎng)，模塊可在上電后1S內(nèi)加入網(wǎng)WPSEasyConfig支持無線配置和升級(jí)固TCP/IP特DHCPClientSever功 SeverTCPClient,TCPSever,UDPClient,UDPSeverMulticast8socket1TLS功耗特模塊支2種功耗模全速工作模式，功耗平均 ~80mA，峰值電流~10mA,峰值電流UARTATAT--------8----1奇偶校驗(yàn) 流 RAK453模塊支持以下波特率注1.接口通信的單包最大數(shù)據(jù)長度：收發(fā)都1024Byte開機(jī)啟ASCII------ etoRAK453\r\n 57656C636F6D6520746F2052414B3435330D操作流RAK453是UART命令操作模塊,完成WIFI通信的幾個(gè)基本步驟，掃描網(wǎng)絡(luò)，加入網(wǎng)絡(luò)IPSocket通信。RAK453對(duì)網(wǎng)絡(luò)部分實(shí)現(xiàn)提供了多種方便的操作方式，客戶可以輕松地完成網(wǎng)絡(luò)配置，把研發(fā)中心放到管理socket和自己數(shù)據(jù)協(xié)議上。實(shí)現(xiàn)網(wǎng)絡(luò)模塊自動(dòng)管理，客戶可WEB，WPSEasyConfig配置模塊，成功后模模塊的基本操作流程如下命令大命令格主機(jī)到模塊at+<命令>=<參數(shù)1>,<參數(shù) <參數(shù)每條命令執(zhí)行完后，模塊會(huì)發(fā)送返回值如果命令執(zhí)行成功，返回值 HEX=4F4B0D HEX=4F4B640D 參數(shù)如果命令執(zhí)行失敗，返回值其中ERROR為ASCII碼，<code>為十六進(jìn)ERROR HEX=4552524F52FE0D AT命令格式AT命令是以“at+”開頭(均為小寫)，以“\r\n”80-參數(shù)輸入錯(cuò)誤(參數(shù)無法識(shí)別/缺少參數(shù)/命令太長/其他參數(shù)--(重啟模塊-(聯(lián)系廠家AT操作命令分為模塊管理命令，網(wǎng)絡(luò)操作命令，socket操作命令，保存參數(shù)命令四部AT命打開ASCII顯查詢模塊MACat+scan=<channel>,<at+channel=<channel創(chuàng)建AP創(chuàng)建ADHOC >DNS解at+=<host>,<count>,at+listen=<listen設(shè)置STA省電模式的Socket操作命創(chuàng)建TCP建立TCPat+ludp=<local創(chuàng)建UDP建立UDP創(chuàng)建UDP創(chuàng)建SSLat+cls=<查詢當(dāng)前socket修改內(nèi)置WEB獲取保存內(nèi)置WEBat+uartconfig=<baudrate>,<databits>,<parity>,<flow修改模塊的UART參開啟WEB管理命命描I參數(shù)說01返回值說長度命令執(zhí)行成22512查詢模塊命描查詢模塊的MAC地址信息返回值說長度262512查詢命描1.0.1-2.1.27參數(shù)說無返回值說長度2512設(shè)置命描RAK4532種電源模式，如下01pwrmode=0模塊工作在最大性能，控制部分與無線部分完全打開pwrmode=1參數(shù)說<01返回值說長度22512復(fù)位模命at+reset描復(fù)位模塊內(nèi)部驅(qū)動(dòng)，但不更改模塊的硬件接口狀態(tài)注意波特率，在執(zhí)行該命令后，不會(huì)被恢復(fù)至硬件復(fù)位的狀態(tài)（默認(rèn)115200參數(shù)說返回值說長度2251詳見ERROR2設(shè)置命描設(shè)置模塊的主機(jī)名，模塊返回OK表示設(shè)置成功參數(shù)說at+set_hostname=RAK453\r\n------------------------把主機(jī)名設(shè)置成返回值說長度2251詳見ERROR2獲取命描獲取模塊的主機(jī)名，模塊返回OK表示獲取成功參數(shù)說 獲取主機(jī)返回值說長度2251詳見ERROR2無線命掃描命at+scan=<channel>,<描通過此命令掃描無線網(wǎng)絡(luò)，并獲取無線信息，包括加密信息、信道、信號(hào)強(qiáng)度、等。如果不需要獲取指定的信息，該條命令可忽略。執(zhí)行connect命令時(shí)，模塊內(nèi)參數(shù)說為0，則掃描所有信道，<>為掃描指定，此參數(shù)可選。注如果指定信道掃描，可以減少掃描時(shí)間0-at+scan=0 掃描所有信 在所有信道中掃描網(wǎng)絡(luò)名為“RAKwireless”無線絡(luò)at+scan=8,RAKwireless\r\n-------------在8信道中掃描網(wǎng)絡(luò)名為“RAKwireless”at+scan=6\r\n6信道中所有OK與掃描到的無線網(wǎng)絡(luò)數(shù)量(16個(gè))，如果用戶需要使用網(wǎng)絡(luò)信息，可以調(diào)用命令at+get_scan獲取。注at+ascii=1時(shí)，模塊將返回所有信息！只是為了方便調(diào)試觀長度2<SCAN12510XFE=-2命描通過命令掃描信息，此命令必須在at+scan命令后調(diào)用注如果不需要獲取無線網(wǎng)絡(luò)信息，此命令可省略掃描信息已經(jīng)全部，如果再次，模塊會(huì)返回錯(cuò)誤-2，需調(diào)用 命令進(jìn)重新掃描此命令在at+ascii=1模式下參數(shù)說scan_n>為大于例at+get_scan=10\r\n-------------------10個(gè)無線網(wǎng)絡(luò)信返回值說2 6B11信號(hào)強(qiáng)度(負(fù)值<Security1PKPP22510XFE=-2設(shè)命描如果模塊工作在station模式下，此命令用于輸入網(wǎng)絡(luò)，RAK411支持WEP、-PSK、2-PSK與-PSK+2-PSK，其中2-PSK與2-PSKTKIP、CCMPTKIP+CCMP混合加密算法在WEP下，必須為5或13個(gè)字節(jié)的ASCII碼字符，或者為10或26個(gè)/節(jié)的十六進(jìn)制字符(0-9,a-f). 2下，RAK411支持長度為8-63個(gè)字節(jié)/ASCII碼字符或者64個(gè)字節(jié)的十六進(jìn)制字符(0-9,a-如果模塊工作在AP或Ad-hoc模式下，此命令用于設(shè)置網(wǎng)絡(luò)如果為AP 必須為8-63個(gè)字節(jié)的ASCII碼字符或者64個(gè)字節(jié)的十六進(jìn)制字符(0-9,a-f)。如果為Ad-hoc模式，網(wǎng)絡(luò)默認(rèn)為WEP，且不支持其他，必須513ASCII1026個(gè)字節(jié)的十六進(jìn)制字符(0-9,a-f)。1、如果需要連接的網(wǎng)絡(luò)為OPEN，此命令可省略2、 不支持含有逗號(hào)(,)的字參數(shù)說at+psk=2a334e5d12\r\n--------10字節(jié)十六進(jìn)制，WEP模式返回值說長度22512設(shè)置信命at+channel=<channel描設(shè)置Ad-hoc、AP模式網(wǎng)絡(luò)信道，此參數(shù)必須在建立網(wǎng)絡(luò)之前調(diào)用參數(shù)說1-設(shè)置信返回值說長度22512創(chuàng)建命描輸入此命令用戶可以創(chuàng)建一個(gè)無線接入點(diǎn)(AP)，其他無線設(shè)備可以連接此網(wǎng)絡(luò)，進(jìn)行據(jù)收發(fā)at+apconfig、at+channel配置其他無線參數(shù),網(wǎng)絡(luò)默認(rèn)信道為6(2437MHZ)。建立完成后，模塊將自動(dòng)開DHCPSERVER，用戶必須在配置完IP(at+ipstatic)后調(diào)at+ipdhcp=1命令，模塊會(huì)自動(dòng)設(shè)DHCPSERVER參數(shù)，包括IP地址池范圍及租參數(shù)說

需要連接的，最大支持長度為例返回值說長度22510XFE=-2建立/加入Ad-hoc網(wǎng)命描通過此命令可以建立/加入一個(gè)點(diǎn)對(duì)點(diǎn)的網(wǎng)絡(luò)(Ad-hoc)，如果是建立網(wǎng)絡(luò)，在使用此命之前，可以通過at+psk、at+channel命令進(jìn)行和信道設(shè)置/輸入，在Ad-hoc模式下，網(wǎng)絡(luò)默認(rèn)為WEP，且不支持其他。網(wǎng)絡(luò)默認(rèn)信道為10(2457MHZ)參數(shù)說如果在Ad-hoc模式下，DHCPSERVER無法使用。長度22512連接命描本命令用于連接到指定的網(wǎng)絡(luò)，如果網(wǎng)絡(luò)為加密網(wǎng)絡(luò)，則此命令必須在輸入 令后，才可以調(diào)用，如果網(wǎng)絡(luò)為空，則at+scan和at+psk不需調(diào)用參數(shù)說

at+connect=RAKwireless\r\n-------------連接為”RAKwireless”的網(wǎng)返回值說長度22510XFE=-10XFD=-2命描設(shè)置模塊靜IP地參數(shù)說<DNS可為<DNS可為例at+ipstatic=192.168.9.5,255.255.255.0,192.168.9.1,0,0\r\n-------配置模塊網(wǎng) dnsdns返回值說長度22510XFE=-2DHCP模命描設(shè)置模DHCP功參數(shù)說取IP地址等信息。如果<mode>=1DHCPSERVERIP地址池范圍及租約時(shí)間，此功能必須在發(fā)送at+ipstatic命令后使用，AP模式下有效。0 DHCP1 DHCP例at+ipdhcp=0\r\n模塊工作在DHCPClIENT模式at+ipdhcp=1\r\n模塊工作在DHCPSERVER模式返回值說長度26模塊MAC44444251(<mode>=0有效2WPS聯(lián)命描通過此命令開啟模塊WPS功能。WPS成功后，用戶可以選擇將當(dāng)前的網(wǎng)絡(luò)的參數(shù)，返回值說長度26444<DNS4<DNS42510XFE=-未找到0XFD=-0XFC=-0XFB=-2EasyConfig聯(lián)命描通過此命令開啟模塊EasyConfig功能,配合APP軟 完成模塊自動(dòng)加入指定網(wǎng)絡(luò)aoecong命令保存到模塊內(nèi)部，復(fù)auo_conect）。返回值說長度26444<DNS4<DNS42510XFE=-未找到0XFD=-0XFC=-0XFA=-Easyconfig2命描如果模塊工作在AP模式，此命令用于判斷設(shè)備的連接狀態(tài)。參數(shù)說無返回值說長度2112512命描查詢當(dāng)前模塊IP信息，包括MAC地址、IP地址，子網(wǎng)掩碼，網(wǎng)關(guān)，DNS服務(wù)參數(shù)說無返回值說長度26444<DNS4<DNS42510XFC=-42查詢網(wǎng)絡(luò)信號(hào)強(qiáng)命描參數(shù)說無返回值說長度212512解命at+dns=<>描轉(zhuǎn)換到對(duì)應(yīng)的IP地址，此命令必須配置可用的DNS服務(wù)器地參數(shù)說無返回值說長度24IP2510XFD=- 2設(shè)置命at+listen=<listen描設(shè)置模塊在Station模式下的信標(biāo)間隔注時(shí)參數(shù)說<listen返回值說長度22512AP高級(jí)參命at+apconfig=<hidden>,<contry描此命令用于設(shè)置無線接入點(diǎn)參數(shù)，包括國家代碼，接入點(diǎn)是否隱藏參數(shù)說01<contrycode國家代碼，如中國JP（）可加入1~14信道路由US（）可加入1~11信道路由返回值說長度22512命令命描執(zhí)行命令,測試網(wǎng)絡(luò)是否連通參數(shù)說例at+=192.168.9.5\r\n--------------------------------執(zhí)行返回值說長度22512斷開命描斷開當(dāng)前無線連參數(shù)說無返回值說長度225122網(wǎng)絡(luò)命命描模塊作為TCPserver并創(chuàng)建端口，如果操作成功，模塊會(huì)返回一個(gè)十六進(jìn)制的標(biāo)符，用于管理連接。建立一TCP服務(wù)器,最多可以連接7個(gè)客戶端。在不同端口建立TCP服務(wù)器，最多允許創(chuàng)4TCPserver的描述符，連接到TCPseverclient連接注意：端低位參數(shù)說1-例at+ltcp=25000r\nTCP返回值說長度21=0x08~0x0B2510XFE=-0XFD=-本地端口0XFB=-2命描此命令是模塊創(chuàng)建TCPCLIENT并與TCPSERVER進(jìn)行連接，如果操作成功，塊會(huì)返回一個(gè)十六進(jìn)制的標(biāo)識(shí)符，用于管理連接，此命令最多可以創(chuàng)建 個(gè)連接參數(shù)說<dest<dest1-<local1-本地端口(可以省略at+tcp=192.168.9.5,25000,25001\r\n-----------使用固定端口連接Serverat+tcp=192.168.9.5,25000\r\n使用默認(rèn)端口連接Server返回值說長度21=0x00~0x072510XFE=-0XFD=-0XFC=-連接TCPSERVER2UDP連命描此命令是在模塊上創(chuàng)建一個(gè) 端口并設(shè)置IP地址及端，如果建立成功模塊會(huì)返回一個(gè)十六進(jìn)制的標(biāo)識(shí)符，用于管理連接，此命令最多可以創(chuàng)建 個(gè)連接參數(shù)說參參數(shù)說<dest<dest1-<local1- 連接目標(biāo)端 廣返回值說長度21=0x00~0x072510XFE=-10XFD=-10XFC=-2UDP命at+ludp=<local描此命令是在本地上創(chuàng)建一個(gè) 指定端口，創(chuàng)建成功后返回一個(gè)十六進(jìn)制的標(biāo)IP和端口信息，如果模塊需要給對(duì)方回復(fù)消息，可在發(fā)送數(shù)據(jù)，指定對(duì)方的IP和端信息，即可回復(fù)。UDP服務(wù)器應(yīng)用比較靈能接收單播和廣播消息，并能向指IP和端注意：端低位參數(shù)說<local1-例at+ludp=25000\r\n創(chuàng)建本地端口返回值說長度21=0x00~0x072510XFE=-10XFD=-2UDP組命描此命令是在模塊上創(chuàng)建一個(gè) 的組播socket，可以指定加入路由的組播IP，在組進(jìn)行數(shù)據(jù)通信，一般適用于組內(nèi)一主多從的應(yīng)參數(shù)說<dest<dest1-<local1-例 =224.255.255.252,25001,25000\r\n------------------- 加入組 返回值說長度21=0x00~0x072510XFE=-10XFD=-2SSL命描此命令是模塊創(chuàng)建SSLCLIENT并與SSLSERVER進(jìn)行連接，如果操作成功，塊會(huì)返回一個(gè)十六進(jìn)制的標(biāo)識(shí)符，用于管理連接，此命令最多可1個(gè)連接。模塊內(nèi)部支持TLSv1.1，調(diào)用此命令之前，必須用at+set_cert設(shè)置文件參數(shù)說<dest<dest1-返回值說長度21=0x00~0x072510XFE=-0XFD=-0XFC=-連接TCPSERVER0XFA=-0XF9=-創(chuàng)建SSL2設(shè)命描參數(shù)說<cert_type0SSLClientPrivate1SSLClient2SSLCA>返回值說22命令執(zhí)行失510XFE=-2關(guān)閉已創(chuàng)建的端命at+cls=<描通過相對(duì)應(yīng)的標(biāo)識(shí)符，關(guān)閉端 或連接參數(shù)說<flag0-例at+cls=0\r\n關(guān)閉端口標(biāo)識(shí)符為0的連返回值說22命令執(zhí)行失510XFE=-10XFD=-2socket狀命描通過命令可以查詢當(dāng)前socket狀態(tài)，socket詳細(xì)信息參數(shù)說<0-連接標(biāo)識(shí)符返回值說21122socket2寫數(shù)命 描通過命令向目標(biāo)連接(端口標(biāo)識(shí)符)1000daa_eam>可以為任何格式的數(shù)據(jù)，模塊會(huì)保持?jǐn)?shù)據(jù)的原樣發(fā)送，不做任何處理。如果該連接是P0DP0為UDP標(biāo)P。參數(shù)說<0-連接標(biāo)識(shí)符<dest1-<dest將要發(fā)送的數(shù)據(jù)例at+write=0,0,0,4,ABCD\r\n-----------向標(biāo)識(shí)符為 的連接發(fā)送4bytes的數(shù)據(jù)，數(shù)據(jù)內(nèi)為返回值說22510XFE=-0XFD=-2讀數(shù)命at+read=<flag>,<data_length>描此命令用于緩存區(qū)數(shù)據(jù)，緩存區(qū)總共4K用于保存數(shù)據(jù)，如果接收數(shù)據(jù)超過緩存大小，模塊將停止接收數(shù)據(jù)，如果接收緩存區(qū)為空，命令將等待10s，超時(shí)后返回0參數(shù)說<0-連接標(biāo)識(shí)符返回值說長度222參數(shù)保UART參命at+uartconfig=<baudrate>,<databits>,<stopbits>,<parity>,<flow描注：軟復(fù)位時(shí)at+rest波特率保持不變。參數(shù)說此命令包含5個(gè)參數(shù)，包括波特率、數(shù)據(jù)位、停止位、