软件开发-rak43uart软件编程手册

RAK413UART-WiFi市瑞科慧联科©2015瑞科慧联对于此文件保留所利本文所提及的实际公司和产品名称，均为其各自所有者商标。本文档的不得，不得在任何检索系统，或以任经过瑞科慧联同意的形式传送。 编程手册 功能特 模块简 模块特 应用领 详细功 硬件接 无线驱 TCP/IP特 功耗特 UART操 UART参 开机启 操作流 命令大 命令格 管理命 查询模块 查询版本信 设置功耗模 唤醒模 复位模 设置模块主机 获取模块主机 网络命 扫描无线网 扫描信 设置.......................................................................................................................................设置信 创建无线接入 建立/加入Ad-hoc网 连接无线网 EasyConfig联 查询无线网络连接状 查询网络信号强 解 设置侦听间 AP高级参 命 断开无线网 源MAC过滤选 抓扫描 网络命 创建UDP 创建UDP组 关闭已创建的端 发送数 接收数 HTTP HTTP 参数保 配置UART参 保存配置参 配置参 修改WEB启动参 WEB启动参数 启动自动联 销售与服 版本说 模块简RAK413是一款完全符合802.11b/g/n无线协议的Wi-Fi模块，集成完整的TCP/IP协议栈，支ARP、IP、ICMP、TCP、UDP、DHCPCLIENT、DHCPSERVER、DNSAPStation及Ad-hoc。用户可以方便、快速地使用模块实现组网及数据收发。模块的串口波特率最高支持RAK413支持参数保存，可由客户命令启动是否自动联网，实现一步联网，减少系统组网时间。内置WEBWPSEasyConfig模块有4电源管理模式，最小待机功耗为2uA模块特符合802.11b/g/n支持带数据流控制的UART通信，最大波特率为极简的硬件电路设支持OPEN -PSK 2-PSK、WPS支持TCP、UDP通讯协议，最大支持8个UDP/TCP支持WPS，EasyConfig支持深度睡眠下参数保存，最快连接时间仅 板载陶瓷天线或U.FL工作电压：4种电源工作模式，最低功耗仅为应用领医疗领域，如、医疗计量（停车计时、计量仪表、等硬件接接口的实际吞吐率可到无线驱符合IEEE802.11b/g/n支持AP,STA模式及ADHOC支 2-PSK快速联网，模块可在上电后1SWPS和EasyConfigTCP/IP特DHCPClient和Sever 和Sever及功耗特全速工作模式，功耗平均 ~80mA，峰值电流睡眠模式，功耗平均~10mA深度睡眠（115200bps），~5mA,峰值电流<310mA，待机模式，功耗<UART参模块开机以默认--------8----1奇偶校验 流 1.1024Byte2.修改UART115200开机启RAK413启动时间约为210ms,正常启动后,模块自动打印开机信息： etoRAK413\r\n 57656C636F6D6520746F2052414B3431330D操作流RAK413是UART命令操作模块,完成WIFI通信的几个基本步骤，扫描网络，加入网络和获取IP地SocketRAK413对网络部分实现提供了多种方便的操作方式，客户可以轻松地完成网络配置，把研发中心放到管理socket和自己数据协议上。实现网络模块自动管理，客户可以利用WEB，WPSEasyConfig配置模块，成功后模块将自动保命令格at+<命令>=<参数1>,<参数 <参数ATASICII <参数注除OK HEX=4F4B0D HEX=4F4B640D 注其中ERROR为ASCII码，<codeERROR HEX=4552524F52FE0D ATATatr\n80注以上AT命令格式不适用接收数据命令at+recv_data和 d_data，详细说明请参at+recv_data, 错误代码系统错误致命错误at+channel=<channel dnsserver2>\r\n动态分IPAP下开启DHCPat+dns=<>DNS解at+=<host>,<count>,STA模式的UDP组播通at+cls=<h>,<data_stream>\r\nHTTPGETHTTPPOST bits>,<parity>,<flowctrol>\r\n管理命命描通过命令转化所有命令返回值为ASCII显示，方便用户调试，熟悉AT命令。编程时，无需打开0122512查询模块命无 262512查询版本信命例1.0.1-2.1.27无2512设置功耗模命描RAK413支持40123UART数据唤醒 模式控制部分进入浅度休眠，无线部分保持当前连接状态，进入低功耗模式，正常通信，但是会降低模块性能，收发数据速度降低。 模块控制部分进入深度睡眠，无线部分会保持当前连接状态，进入低功耗模式，远端数据或主机发起通信时，唤醒控制部分，进入模式1，无收发数据自动进入模式2。 进入此模式后，模块首先会保存当前连接状态到RAM，并关闭无线部分电源，然后模块控制部分进入深度睡眠，此时模块无法接收命令及无线数据，功耗降到最低。用户可以主机发起通信或复位模块，启动后默认模式0。<01232251详见ERROR2唤醒模22512at+reset描复位模块驱动，但不更改模块的硬件接口状态（115200）。22512设置模块主机设置模块的主机名，模块返回OKat+set_hostname=RAK413\r\n------------------------------把主机名设置成22512获取模块主机获取模块的主机名，模块返回OK例 22512网络命扫描无线网描通过此命令扫描无线网络，并获取无线信息，包括加密信息、信道、信号强度、B等。如不需要获取指定的信息，该条命令可忽略。执行connect命令时，模块自动识别scanchannel1-130，则扫描所有信道，<>为扫描指定，此参数可选。注指定(可选例 在所有信道中扫描网络名为“RAKwireless络at+scan=8,RAKwireless\r\n----------------在8信道中扫描网络名为“RAKwireless”无线网at+scan=6r\n6息，可以调用命令at+get_scan获取。注当at+ascii=1时，模块将返回所有信息 只是为了方便调试观2<SCAN12512扫描信命描通过命令扫描信息，此命令必须在at+scan命令后调用注扫描信息已经全部，如果再次，模块会返回错误-2，需调 命令进行重新描此命令在at+ascii=1<scan_num>为扫描信息数量，如果参数大于实际的扫描数量，命令将返回实际扫描数量大于例at+get_scan=10\r\n------------------------10个无线网络信 2 <B6B11<Security122512<SecurityMode>中bit=1时有效，bit=0时无效，如果多位同时为1，则为混设置描 - 2-PSK，其 2-PSK 2-PSK支持TKIPCCMP与如果模块工作在AP或Ad-hoc模式下，此命令用于设置网络如果为AP模式，网络默认为WAP2-PSK-CCMP，且不支持其他，必须8-63ASCII640-9,a-f如果为Ad-hoc模式，网络默认 ，且不支持其他，必须为5或131、如果需要连接的网络 OPEN，此命令可省略2、 不支持含有逗号(,)的字例at+psk=RAKwireless\r\n----------------8字节的字符型，2或模式22512设置信命描设置Ad-hoc、AP22512创建无线接入命描输入此命令用户可以创建一个无线接入点(AP)，其他无线设备可以连接此网络，进行数据收发。在输入命令之前，用户可以使用t+apconfg、at+channel配置其他无线参数,网络默认信道6(2437MHZDHCPSERVERIP(at+ipstatic)后调用at+ipdhcp=1命令，模块会自动设置DHCPSERVER参数，包括IP地址池范围及租约时间。最大长度为32个字节<例22512建立/加入Ad-hoc网命描通过此命令可以建立/加入一个点对点的网络(Ad-hoc可以通过at+psk、at+channel命令进行和信道设置/输入，在Ad-hoc模式下，网络默认为，且不支持其他。网络默认信道为10(2457MHZ)注2251创2连接无线网命描本命令用于连接到指定的网络，如果网络为加密网络，则此命令必须在输 命令后，可以调用，如果网络为空，则at+scan和at+psk不需调用最大长度为32个字节<例at+connect=RAKwireless\r\n----------------连接为”RAKwireless”的网2251没有找到12设置静态IP地描设置模块静态IP<DNS(可为设置DNS<DNS(可为设置DNS例at+ipstatic=,,,0,0\r\n配置模块 dns服务器dns服务器22512命描设置模块DHCP如果<mode>=0，则模块工作在DHCPCLIENTDHCPSERVERIP如果<mode>=1DHCPSERVERIP地址池范围及租约时间，此功能必须在发送at+ipstatic命令后使用，AP模式下有效。0 DHCP1 DHCP例 264444DNS服务器4DNS服务器2512 WPS联命描通过此命令开启模块WPS功能。WPS成功后，用户可以选择将当前的网络的参数，通过26模块MAC444<DNS4DNS<DNS4DNS2510XFE=-未找2EasyConfig联命描通过此命令开启模块EasyConfig功能,配合APP完成模块自动加入指定网络。成功后，用户可以选择将当前的网络的参数，通过at+storeconfig命令保存到模块，复位后可以使用自动联网命令at+auto_connect（详情见该命令说明）。26444<DNS4DNS<DNS4DNS2510XFE=-未找0XFC=-Easyconfig2命描如果模块工作在AP模式，此命令用于判断设备的连接状态。无2112512查询模块IP信命描查询当前模块IP信息，包括MAC地址、IP地址，子网掩码，网关，DNS无26444<DNS4DNS<DNS4DNS2510XFC=-4查询失2查询网络信号强命描无212512解命转换到对应的IP地址，此命令必须配置可用的 服务器地24251 2设置侦听间命at+listen=<listen描设置模块在Station注<listen22512AP高级参命 描01<contrycodeCN（中国）可加入1~13信道路由器JP（）可加入1~14信道路由器US（）可加入1~11信道路由22512命令命描执行命令,测试网络是否连通例at+=\r\n----------------------------------------执行22510XFE=-2断开无线网命描无22512命描此命令主要结合at+promisc命令一起使用，用于抓包扫描时MACmode=0,清空当前index下macmode1，过滤当前indexmacmode2，不过滤当前index的6个字节的MAC2址22512抓扫描命此命令主要结合at+set_filter命令，关闭抓包功能或在不同信道上对没有过滤掉的MAC地址进mode=0关闭抓包功能mode=1，在6信道抓包mode=21611mode=3，在13信道抓包226MAC62512网络命TCP命描模块作 server并创建端口，如果操作成功，模块会返回一个十六进制的标识符，TCP7TCP创建4个。关闭TCPserver的描述符，连接到该TCPsever的client连接将都会被关闭。例 21端2510XFE=-数多于4个)0XFD=-0XFB=-2TCP命描此命令是模块创建TCPCLIENT并与TCPSERVER进行连接，如果操作成功，模块会返回个十六进制的标识符，用于管理连接，此命令最多可以创 8个连接<dest<dest<local例at+tcp=,25000,25001\r\n--------------使用固定端口连接at+tcp=,25000\r\n--------------使用默认端口连接21=0x00~0x07端口标志符，用于管理端2510XFE=-0XFD=-0XFC=-连接TCPSERVER出2命描此命令是在模块上创建一个 端口并设置IP地址及端，如果建立成功，模块会返<dest<dest<local例 广21=0x00~0x07端口标志符，用于管理端2510XFE=-数多于8个)10XFD=-10XFC=-2UDP命描此命令是在本地上创建一 指定端口，创建成功后返回一个十六进制的标识符，等接收端口数据，如果端口发送数据到本端口，接收数据中会包含对方的IP和端口信息，如果模块需要给对方回复消息，可在发送数据，指定对方的IP和端信息，即可回复。UDP服务器应用比较灵活，能接收单播和广播消息，并能向指定IP和端口主动发送数据。<local例at+ludp=25000\r\n------------------------创建本地端口21端2510XFE=-口数多于8个)10XFD=-2UDP命描此命令是在模块上创建一个 的组播socket，可以指定加入路由的组播IP，在组内进行数参说<dest-<local例1- IP21=0x00~0x07端口标志符，用于管理端2510XFE=-10XFD=-2关闭已创建的端命描通过相对应的标识符，关闭端口或连接<flag例at+cls=0\r\n-------------关闭端口标识符为0 22510XFE=-10XFD=-2发送数命 描通过命令向目标连接(端口标识符)发送数据，最大数据长度 1000，其中<data_stream>可TCPIP0UDP0LUDP送时，填上目标IP和目标端。<<dest<dest例500 \ 向标识符为0的连接发送500bytes500 22512接收数命描此命令是模块发送给主机的数据，包括目标端口、目 IP、端口标识符、数据长度、数据。此无<1=0X00-0X07端口标识24221 2TCPTCP连<socket_status1 <1 242TCP断<socket_status1 <1 242网络连<net_status1 2网络断<net_status1 2RAK413模块网络自动连接，断开连接均会通知主机。2s,4s,8s,16s,32s,1min,1min,模HTTP命描httpgetGET/<url> Accept:*/*\r\nContent-Type:*/*\r\nConnection:Keep-Alive\r\nIP 222512HTTP命描POST/<url>HTTP/1.1\r\nAccept:User-Agent:RAKWirelessContent-Type:*/*Content-Length:XXX\r\nConnection:Keep-Alive\r\n222512参数保命at+uartconfig=<baudrate>,<databits>,<stopbits>,<parity>,<flow描注：软复位时at+rest波特率保持不变。此命令包 5个参数，包括波特率、数据位、停止位、奇偶校验位和流控开<baud678<stop12012<flow01例 UART数据位=8停止位=122512保存配置参命at+storeconfig\r\n描用于保存用户参数，包括、、 地址及扫描信息等，此命令可以带参数结构，也可以不带数。不带参数时，需正确执行scan,connect和IPtypedef net_type; uint8_tdummy[2]; {A_UINT32addr;A_UINT32mask;A_UINT32gw;A_UINT32dnsrv1;A_UINT32dnsrv2;{uint8_thidden;225124.5.3配置参命描用于用户保存的参数，返回保存参数结构体内容typedef{uint8_tnet_type;uint8_tchannel;uint8_tsec_mode;char[33];charuint8_tdummy