2024年2月29日发(作者：一汽新宝来多少钱)
RAK425使用手册
串口WiFi模块使用说明
RAK425串口WIFI模块 使用手册
深圳市瑞科慧联技术有限公司
微信公众号搜索“瑞科慧联”或“rakwireless”即可每日获取最新物联网行业信息
RAK425使用手册
目录
RAK425串口WIFI模块 ............................................................................. 1
使用手册V1.4 .............................................................................................. 1
1快速使用 ......................................................................................................... - 2 -
STEP1：上电前检查 ................................................................................... - 3 -
STEP2：上电后状态 ................................................................................... - 3 -
STEP3：透传数据测试 ............................................................................... - 6 -
2 功能特性 ....................................................................................................... - 8 -
2.1 概述 ................................................................................................... - 8 -
2.2 应用领域 ............................................................................................ - 8 -
2.3 产品特性 ............................................................................................ - 8 -
2.4 详细功能 ............................................................................................ - 9 -
2.4.1 硬件接口 ................................................................................. - 9 -
2.4.2 无线驱动 ................................................................................. - 9 -
2.4.3 TCP/IP .................................................................................... - 9 -
2.4.4 功耗 ...................................................................................... - 10 -
3 硬件描述 ..................................................................................................... - 11 -
3.1 模块类型 ........................................................................................... - 11 -
3.2 模块高度 ........................................................................................... - 12 -
3.3 参考设计 ........................................................................................... - 12 -
3.4 管脚定义 .......................................................................................... - 13 -
4 使用大全 ..................................................................................................... - 15 -
4.1 基本流程图 ...................................................................................... - 15 -
4.2 多种配置方式 ................................................................................... - 15 -
4.3 WEB配置 ........................................................................................... - 16 -
模式选择页面 ................................................................................... - 17 -
AP接入点设置 .................................................................................. - 17 -
STA节点参数设置 ............................................................................ - 18 -
IO通信参数设置 .............................................................................. - 19 -
网络参数设置 ................................................................................... - 20 -
高级管理 .......................................................................................... - 20 -
固件升级 .......................................................................................... - 21 -
4.4 无线配置工具 ................................................................................... - 22 -
4.5 串口配置工具 ................................................................................... - 23 -
4.6 双Socket应用实例 ......................................................................... - 24 -
4.7 EasyConfig功能演示 ...................................................................... - 29 -
5 辅助AT命令 .............................................................................................. - 31 -
微信公众号搜索“瑞科慧联”或“rakwireless”即可每日获取最新物联网行业信息
RAK425使用手册
5.1 命令格式 .......................................................................................... - 32 -
5.2 开启辅助命令 ................................................................................... - 32 -
5.3 模块管理指令 ................................................................................... - 33 -
5.3.1 打开ASCII显示 .................................................................... - 33 -
5.3.2 查询模块MAC地址 ................................................................ - 33 -
5.3.3 进入透传模式 ....................................................................... - 33 -
5.3.4 查询软件版本 ....................................................................... - 33 -
5.3.5 复位重启模块 ....................................................................... - 34 -
5.3.6 恢复出厂设置 ....................................................................... - 34 -
5.4 参数配置指令 ................................................................................... - 34 -
5.4.1 写入用户配置 ....................................................................... - 34 -
5.4.2 读取用户配置 ....................................................................... - 34 -
5.4.3 读取出厂配置 ....................................................................... - 35 -
5.4.4 修改出厂配置 ....................................................................... - 35 -
5.4.5 复制用户参数 ....................................................................... - 35 -
5.5 AP SAT操作指令 .............................................................................. - 36 -
5.5.1 查询AP连接状态 .................................................................. - 36 -
5.5.2 查询STA 无线信号强度 ........................................................ - 36 -
5.5.3 扫描无线网络 ....................................................................... - 36 -
5.5.4 获取无线网络 ....................................................................... - 36 -
5.5.5 一键入网命令 ....................................................................... - 37 -
5.5.6 WPS配置命令 ........................................................................ - 37 -
5.5.7 查询IP状态 ......................................................................... - 37 -
5.5.8 pin命令 ................................................................................ - 38 -
5.5.9 查询TCP连接状态 ................................................................ - 38 -
5.5.10 AP高级设置 ........................................................................ - 39 -
5.6 收发数据指令 ................................................................................... - 39 -
5.6.1 发送数据 ............................................................................... - 39 -
5.6.2 接收数据 ............................................................................... - 40 -
5.7 附录 ................................................................................................. - 40 -
7 版本 ............................................................................................................ - 43 -
版本历程及修改内容 ............................................................................... - 43 -
微信公众号搜索“瑞科慧联”或“rakwireless”即可每日获取最新物联网行业信息
RAK425使用手册
1快速使用
感谢您选用RAK425串口透传模块，该透传模块使用极其简单方便，且功能丰富，能满足各类客户的需求。首先，我们使用RAK425评估套件来感受下吧。评估套件见下图1-1
图1-1 开发板照片
表1-2 主要外设
功能 名称
5V电源适配器/Mini
电源供电 直流5V输入
USB
描述
对外接口
RS232
RS485
Reset
WPS
Default
按键
2. 按下 < 3S一键配置到网络（配合手机）
进入超低功耗模式按钮
Sleep 按下大于2S，松开进入超低功耗
按下，再松开模块唤醒
主要通信接口 标准串口 母头
辅助通信接口 工业485接口
模块复位按键
WPS功能 一键配置到网络（配合路由器WPS）
1. 按下>=3S 模块将恢复到出厂参数
- 2 -
RAK425使用手册
STEP1：上电前检查
评估套件中 主要包含串口转接线，USB线，外置天线的模块 还提供IPEX连接器接口的天线。若模块为外置天线模块 请将天线插上。将模块串口与电脑串口连接（电脑的COM口或USB转串口）。
STEP2：上电后状态
正常现象
将模块上电后 电源指示灯（Power灯）亮起，紧接着Status灯亮起（Status引脚输出低电平），表示模块正常启动。
如果上电后Status灯不亮，请尝试按下Reset按键，若始终不亮 ，麻烦请联系售后。
模块出厂模式下，上电后会建立一个开放的AP网络，名称为RAK_AP_XXXXXX ,XX为模块的MAC地址后六位，IP地址为192.168.7.1 默认开启DHCPSever 。（出厂参数可修改）
Status灯亮起后 打开电脑的无线网络 会在无线列表中发现RAK_AP_XXXXXX，如下图1-3：
图1-3 出厂AP扫描
双击加入该网络（此时Link会亮起） 等待成功分配到IP地址 如下图1-4：
- 3 -
RAK425使用手册
图1-4 加入出厂AP
打开浏览器 输入模块的网关地址192.168.7.1 ，网页弹出认证界面，输入默认认证，用户名：admin 密码：admin。如下图1-5：
图1-5 WEB网页认证
即可看到模块内置的WEBSever界面 可以查看AP设置和IO通信设置（即UART接口和socket通信设置），如下图1-6，1-7：
- 4 -
RAK425使用手册
图1-6 出厂WEB网页
图1-7 出厂IO通信测试
- 5 -
RAK425使用手册
STEP3：透传数据测试
打开串口工具，选择模块连接的COM口 默认波特率115200 数据位8 停止位1 无奇偶校验，无流控，打开。再打开网络调试工具（TCP/UDP工具），建立TCP client连接 对方IP 192.168.7.1 服务器端口 25000 如下图1-8：
图1-8 建立TCP客户端
TCP连接上后，就可以互传数据了，如下图1-9。此时模块串口就变成了网络上的虚拟串口，串口数据和网络数据互通。
图1-9：出厂透传测试
- 6 -
RAK425使用手册
请记住指示灯的状态
Status指示灯：模块正常启动 —— 亮（输出低电平）
模块启动失败 —— 灭
模块升级固件中 —— 快闪
模块准备进入出厂模式 —— 快闪
模块升级出错 —— 慢闪
Link指示灯： 模块STA模式下连到路由，
模块AP模式下有STA连接 —— 亮（输出低电平）
EasyConfig，WPS一键配置中 —— 快闪
模块恢复出厂方法
开发板上有一个Default按键，用于在配置出错或者忘记当前配置参数时，对模块进行恢复出厂操作：
按下Default按键，status指示灯开始快速闪烁 ，按下大于3秒时，指示灯停止闪烁，此时松开Default按键，模块恢复到出厂模式 （默认建立AP） （出厂参数客户可以修改）
- 7 -
RAK425使用手册
2 功能特性
2.1 概述
RAK425模块是一款完全支持IEEE802.11b/g/n无线协议的超低功耗WIFI模块，具有封装小、易于使用的特点。该模块是完全的串口透传模块，内部集成了TCP/IP协议栈和驱动程序，使用方便，只需用上位机/ WEB浏览器/ APP工具单独或批量配置工作参数，即可正常使用。
RAK425模块性能稳定，超低功耗，使用灵活，能满足各类客户的需求，可提供各项测试报告，让客户快速上手，缩短研发周期。
RAK425模块也提供各类定制服务，如用户WEB网页，生产配置工具和手机APP等。
2.2 应用领域
? 便携产品
? 家电和电器
? 工业传感器
? 销售点终端
? 楼宇自动化
? 物流和货运管理
? 家庭安全与自动化
? 医疗领域，如病人监控、医疗诊断
? 计量（停车计时、计量仪表、电表等）
2.3 产品特性
? 符合802.11b/g/n无线协议
? 内嵌TCP/IP协议栈
? 支持OPEN、WEP、WPA/WPA2-PSK等加密方式
? 支持SoftAP、Station、AD-Hoc模式
? 支持TCP、UDP通讯协议
? 支持DHCP SERVER、DHCP CLIENT
? 支持以透明传输为主AT命令为辅
? 支持带数据流控制的UART通信，最大波特率为921600bps
? 支持多种配置工具 模块配置一步到位
- 8 -
RAK425使用手册
? 支持无线升级模块固件
? 天线连接器
? 工作电压：3.3V
? 3种电源工作模式，最低功耗仅为2uA
? 封装尺寸：常×宽= 20.5mm×15.5mm(竖排针的高度8.7mm弯排针的高度6.4mm)
? 符合FCC、RoHs和CE认证
2.4 详细功能
2.4.1 硬件接口
?
波特率：9600~921600bps
? 接口的实际吞吐率可到600kbps
? 支持硬件流控，可保证数据传输的可靠性
? 485功能设置
2.4.2 无线驱动
? 符合IEEE802.11b/g/n标准
? 支持AP和STA模式
?
支持WEP、WPA/WPA2-PSK加密方式
? 快速联网，模块可在上电后1S内加入网络
? 支持WPS 和EasyConfig 一键加入网络
?
支持断网和socket的自动重连
? 支持局域网内设备的主动发现
? 支持无线配置和升级固件
2.4.3 TCP/IP
? DHCPClient 和 Sever 功能
? DNSClient 和 Sever 功能
? TCPClient,TCPSever,UDPClient,UDPSever和UDP Multicast 功能
? 双socket透传数据（采用uuid区分）
? HTTP协议支持
? TCPC/TCPS 保活时间设置 和TCPC的断开重连功能
- 9 -
RAK425使用手册
2.4.4 功耗
模块支持四种功耗模式
?
全速工作模式，功耗平均值 ~80ma，峰值电流<200ma
?
自动节省功耗模式平均 ~10ma, 峰值电流<200ma，DTIM=100ms
?
保持联网最低功耗平均 ~3ma,峰值电流<200ma，DTIM=100ms
(最大支持115200bps)
?
外部拉线，超低功耗模式 1-2 uA
- 10 -
RAK425使用手册
3 硬件描述
3.1 模块类型
图3-1 RAK425BI 正面 图3-2 RAK425BI反面
图3-3 RAK425BL正面 图3-4 RAK425BL反面
图3-5 RAK425BX正面 图3-6 RAK425BX反面
- 11 -
RAK425使用手册
3.2 模块高度
图3-5 RAK425I高度
3.3 参考设计
图3-6 模块典型参考设计
- 12 -
RAK425使用手册
3.4 管脚定义
表3-1：管脚定义
管脚号
1
2
管脚名称
GND
VCC3V3
管脚类型
Ground
Power
功能描述
将所有的地管脚连接到地焊盘或地覆铜上
模块3.3电源供电
模块配置管脚，实现EasyConfig和DefaultConfig3
CONFIG
I,PU
功能
EasyConfig按下低（<3S）进入一键配置网络
DefaultConfig按下低（>=3S）恢复出厂设置
4
5
6
7
RESET
STATUS
RXD
TXD
I，PU
O，PU
I
O
模块复位管脚，低有效
模块正常启动输出引脚，输出低有效
串口数据通信接口 接收
串口数据通信接口 发送
模块电源管理
8
SLEEP
I，PU
下拉2S，松开——进入超低功耗模式
下拉，再松开——正常功耗模式（full,save）
下降沿唤醒，不用请
WPS功能引脚（默认）
模块复用工作模式选择（可由配置切换）
9 WPS/MODE I，PU “0”——开启辅助命令模式
“1”——仅透传数据模式
不用请悬空
模块联网指示灯
“0”——AP模式下STA连上，
10 LINK O，PU STA模式下连上路由
“1”——未连接
不用请悬空
备注：
1. I-输入 O-输出 PU-内部上拉 PD-内部下拉
Status指示灯：模块正常启动
- 13 -
—— 亮（输出低电平）
RAK425使用手册
模块启动失败
—— 灭
—— 快闪
—— 快闪
—— 慢闪
模块升级固件中
模块准备进入出厂模式
模块升级出错
Link 指示灯： 模块STA模式下连到路由，
模块AP模式下有STA连接 —— 亮（输出低电平）反之灭
EasyConfig，WPS一键配置中 —— 快闪
- 14 -
RAK425使用手册
4 使用大全
4.1 基本流程图
模块工作状态以直接透传模式为主，也提供辅助命令模式，对模块进行参数管理和查询。模块根据MODE引脚电平判读，（默认为高电平）进入透传模式。若引脚为低电平，则开启辅助命令模式。辅助命令模式随时都能进入。下图是模块的基本流程图4-1：
Power on or
ResetBoot SuccessUART initializeAny timeCheck Uart
Input？Check Mode
Pin？Auto connect
WIFI and
sockets+++LowOpen AT
command
interfaceScan,query module
status, send and
recieve dataExit
commandDirect data
transmission
图4-1 模块基本流程图
4.2 多种配置方式
对于透传模块，最终都是为了数据通信，WIFI通信的前提是要进行参数的配置，比较重要的就是网络配置（网络名称，密码，IP地址） 和 采取哪种通信协议socket设置（TCP，UDP）。针对参数，模块定义了如下两个概念。
首先模块定义了出厂参数和用户参数两部分。
- 15 -
RAK425使用手册
出厂参数：模块未被正常使用时，保持初始状态下的参数（一般作为AP接入点），此时模块由独立的网络名称，固定的IP地址等。出厂模式保证了模块的可恢复性，避免用户的误配置带来的问题。（出厂参数可由客户修改）
用户参数：当模块被正常配置过，模块将启用新配置作为用户参数，模块复位时都自动加载用户参数，用户参数为客户实际应用场景中的配置。（可一次性写入）
为了方便的由出厂模式进入用户模式，透传模块提供了四种灵活修改配置的方式：
对于自组网的客户（需要建立自己的网络）:
1.通过浏览器访问模块内置的WEB服务器进行参数修改
2.通过提供的无线发现和配置软件进行参数修改
对于最终应用场景，需要借助于路由器的客户，还提供一键联网的方式:
3.使用WPS功能与路由器快速连接
4.使用EasyConfig功能实现与路由器的连接
4.3 WEB配置
模块建立AP或加入路由器后 ，在浏览器地址栏中输入模块的IP地址即可访问。AP模式时，IP地址默认为网关地址，如192.168.7.1。STA模式时，加入路由器，若IP地址是自动获取的，不能确定模块IP地址，可借助RAK4xx Wireless 无线配置工具，进行本地扫描发现，获取地址后即可访问WEB服务器。如下图4-2：
图4-2 Wireless 工具
在浏览器中打开地址后 ，会弹出需要认证的提示框（可能需要几秒才弹出），输入默认
- 16 -
RAK425使用手册
用户名|密码：admin|admin，浏览器就出现如下配置页面图4-3.
图4-3 WEB主页
模式选择页面
如图4-3选择模块的工作网络模式，分为AP模式和STA模式
AP模式：AP模式设置产生一个可加密的WIFI无线网络，类似我们常用的无线路由器。主要应用于模块出厂的配置 也可用于数据采集点，简单实用。
STA模式：STA模式可配置加入家中的无线路由器，一般设置只需填入路由器名称和密码即可 选择DHCP。主要用于局域网服务，也可进行远程数据应用。
功耗选择：模块可配置功耗模式 可以选择全功耗模式 模块性能达到最大。自动节省功耗将为您在模块未连接网络和连接网络后进行，使模块在空闲时功耗降低。
AP接入点设置
设置建立AP的网络名称，长度限定32位，可以设定该网络是否需要广播（能被WIFI
- 17 -
RAK425使用手册
设备扫描到），出于安全可选择不广播。选择建立的信道和选择网络是否加密。目前支持WPA2加密方式，比较安全可靠。
IP参数设置，可设置AP网关的IP地址和子网掩码，默认开启DHCP服务。如图4-4：
图4-4 模块AP设置页面
STA节点参数设置
将模块应用于STA模式，即加入自己的路由设备。网络名称即路由器的名称 可手动填入也可以点击搜索附近路由器，进入搜索页面发现路由器后 点中确认，如果该路由器是加密
- 18 -
RAK425使用手册
的，网页则会提示输入密码。若模块复位后连接不上所设置路由，将自动恢复到出厂参数（AP）一分钟，再尝试连接所设路由一分钟，如此往复，直至连接上或被重新配置。（默认开启）
IP参数设置，可以选择静态设置 ，如果静态设置，请注意IP地址在网关内。建议选择DHCP功能 由路由器自动分配。如图4-5：
图4-5 模块STA设置页面
IO通信参数设置
IO通信包括串口参数设置和网络参数设置。如图4-6：
串口参数设置包括串口波特率（自动波特率暂不支持），数据位，校验位和停止位。支- 19 -
RAK425使用手册
持硬件流控，和单向485通信功能。串口自由分包间隔为5ms,即若从串口接收的字节超时为5ms,间隔大于5ms 串口数据将被分包发至网络。
图4-6 模块IO通信设置页面
网络参数设置
网络参数即网络通信设置，socket参数设置主要包括对方服务器地址，对方端口号和本地端口号三个参数。
模块支持两个通信Socket，SocketA, SocketB均可为TCP服务器，TCP客户端，UDP服务器，UDP客户端四种之一。使用同一个串口通信，在通信数据前加上两个字节头，“S0”表示SocketA的收发数据，“S1”表示SocketB的收发数据。
TCP超时参数表示，如果TCP连接在设定时间内没有数据通信，模块将主动重新进行TCP连接。该参数，保证了TCP的连接在异常断开时，模块可以自动恢复。该参数的时间范围1-600S。
高级管理
修改登录网页的用户名和密码
修改模块名称和组名称，模块名称默认为出厂参数的AP名称。
- 20 -
RAK425使用手册
模块管理中提供了重启和恢复出厂参数功能按钮。如图4-7：
图4-7 模块高级管理页面
固件升级
模块提供无线升级固件的功能，方便客户进行评估。升级请慎重，有需要请联系RAK 技术支持。如图4-8
- 21 -
RAK425使用手册
图4-8 模块固件升级页面
4.4 无线配置工具
模块的无线配置工具可以完成模块的本地发现，扫描后发现局域网内的RAK模块。单击
- 22 -
RAK425使用手册
选中模块进行认证，输入默认认证。成功后，配置对应参数。保存复位即可。如图4-9：
使用详情参考RAK4xx 配置工具使用说明。
图4-9 无线发现配置页面
4.5 串口配置工具
模块提供辅助命令模式下AT命令的评估，该工具也可以完成对模块出厂设置参数和用
- 23 -
RAK425使用手册
户参数的批量修改。软件开源码，客户也可自主设计。
选择模块对应串口 点击Open,模块进入辅助命令模式，成功进入后 ，可以执行相应命令。界面如下图：使用详情参考RAK4xx 配置工具使用说明 如图4-10：
图4-10 无线发现配置页面
4.6 双Socket应用实例
模块支持开启两路通信的socket，满足客户多socket的需求。下面我演示下如何从出厂模式下配置到路由器并开启双socket。一路socket建立tcp服务器，用于本地访问。另外一路socket建立TCP客户端，可以对局域网或者外网的服务器进行访问。
首先在本地局域网建立一个TCP服务器（如图4-11）192.168.1.101:12345
- 24 -
RAK425使用手册
图4-11 局域网TCP服务器
进入模块出厂AP，加入打开其WEB，主页选择工作模式：STA模式，点击保存。如图4-12再进入STA设置页面，点击扫描，选择对应路由，确定，提示输入密码。如图4-13, 4-14。
图4-12 STA模式
- 25 -
RAK425使用手册
图4-13 选择指定路由
图4-14 填入密码
- 26 -
RAK425使用手册
现在配置IO通信中的socket，开启双socket，设置socketA为TCP服务器，本地端口25000，对方服务器地址和端口号忽略。如下图4-15：。设置SocketB为TCP客户端，服务器地址填写上面（图4-11）建立的192.168.1.101，服务器端口号12345. 保存重启。如图4-16
图4-15 SocketA设置
图4-16 SocketB设置
重启后，等到开发板上link灯亮起，模块连接到指定路由，此时可以看到服务器有客户端连接SocketB 192.168.1.120:12345，这是模块的TCP连接。我们可以打开模块的WEB看下，在浏览器中输入192.168.1.120。打开后 STA部分显示如下图4-17所示：
- 27 -
RAK425使用手册
图4-17 分配IP
在TCP/UDP工具上再创建一个TCP客户端，连接模块的TCP服务器，建立SocketA，192.168.1.120:25000.如下图4-18：
图4-18 双socket建立
- 28 -
RAK425使用手册
进行双socket透传演示，SocketA 发送 “I am SocketA” 串口收到“S0I am
SocketA”，串口回复加上S0 “S0hello SocketA”，工具收到“hello SocketA” 则串口和网络完成了一次透传。同样socketB。如下图4-19：
图4-19 双socket演示
4.7 EasyConfig功能演示
模块支持Easyconfig连接，只要按下模块上的Default按键，将手机连接到模块需要连接的网络，打开提供的手机端配置软件，等待几秒，模块将自动连接到指定网络中。
按一下Default/Easyconfig 按键，模块（Link）联网灯开始快闪，表示进入配置模式，手机按下配置后，等待几秒，Link灯停止闪烁后，又亮起。手机上弹出模块MAC地址。如下图4-20：
提供安卓和IOS端的开发库，也提供定制服务。
注：用户在确认选用EasyConfig功能时，建议将模块Link引脚接LED指示。
如果出现模块Link灯亮起，但是手机上没有MAC地址返回的情况，主要是因为模块已经联网，但是DHCP没有分配到IP所致，请检查该路由的信号值，且是否开启DHCPSever或路由是否繁忙（加入的客户端较多）。
- 29 -
RAK425使用手册
图4-20 安卓配置界面
- 30 -
RAK425使用手册
5 辅助AT命令
表5-1 AT命令集
AT命令
模块管理指令
at+ascii=
at+macrn
at+easy_txrxrn
at+versionrn
at+reset rn
at+restorern
参数配置指令
at+write_config=配置参数长度,配置参数rn
at+read_configrn
at+read_restoreconfigrn
at+write_restoreconfig=配置参数长度,配置参数rn
at+copy_cfg
AP SAT操作指令
at+con_statusrn
at+rssirn
at+scan=
at+get_scan=
at+easy_configrn
at+wpsrn
at+ipconfigrn
at+ping=
at+tcp_status=0rn
at+apconfig=
dtim>rn
收发数据指令
at+send_data=0,dest_port,dest_ip,datalen,databuffer rn
at+recv_data=0,dest_port，dest_ip，datalen,databuffer rn
从SocketA接收数据
从SocketA发送数据
查询AP连接状态
查询STA 无线信号强度
扫描无线网络
获取指定个数的网络信息
模块进入一键配置模式
模块启用WPS功能，加入指定路由
查询当前模块IP等信息
Ping网络主机命令
查询TCP连接状态
AP高级设置
写入用户配置
读取用户配置
读取出厂配置
修改出厂配置
复制用户配置为出厂配置
打开ASCII显示
查询模块MAC地址
进入透传模式
查询软件版本
复位模块
恢复出厂设置
描述
- 31 -
RAK425使用手册
5.1 命令格式
主机到模块： at+<命令>=<参数1>,<参数2>,................<参数n>rn
注：所有AT命令，包括参数均为ASICII码
例：at+scan=0,TP-LINK_2.4GHzrn
每条命令执行完后，模块会发送返回值，格式如下
1) 如果命令执行成功，返回值为 ：OKrn 或者 OK<参数1><参数2>........<参数n>rn
注：除OK外，其他参数均为十六进制
例：OKrn HEX=4F 4B 0D 0A-----------------------------------无参数
OK@rn HEX=4F 4B 64 0D 0A----------------------------参数=0x64
2) 如果命令执行失败，返回值为 ：ERROR
注1：其中ERROR为ASCII码，为十六进制，
例1：ERROR ?rn HEX=45 52 52 4F 52 FE 0D 0A----------------=oxFE AT命令格式说明 AT命令是以 “at+” 开头(均为小写)，以 “rn”作为命令结尾，最大命令长度为80个字节，其他任何格式的的开头均为错误命令。
注2：以上AT命令格式不适用接收数据命令at+recv_data和at+send_data，详细说明请参考at+recv_data, at+send_data.
5.2 开启辅助命令
透传模式时开启辅助命令接口，采用类似握手方式。如图5-2
1.上位机（主控MCU）发送”+++”,请求进入命令模式。
2.定时200ms,等待模块返回”U”(0x55) ,若模块在规定时间内没有返回，则200ms定时到时再次发 送”+++”,请求进入命令模式，直到模块成功返回”U”(0x55) 。表示模块已经准备好进入命令模式，等待最后确认（等待3S）。
3.上位机（主控MCU）接收到”U”(0x55)后，在3S钟内给模块最后的确认信息，发送”U”(0x55)。模块收到后返回”OK”进入命令模式。模块3S钟没有收到将退出准备状态，
- 32 -
RAK425使用手册
重新等待请求命令。重复1-3步骤。
模块接收0x55，确认进入命令模式<3s模块接收到“+++”<200ms模块返回0x55
图5-2 进入命令时序
5.3 模块管理指令
5.3.1 打开ASCII显示
命令： at+ascii=
参数： mode = 0 关闭ASCII显示 （默认设置）
mode = 1 开启ASCII显示
返回： OKrn
ERRORrn
5.3.2 查询模块MAC地址
命令： at+macrn
描述： 查询模块的MAC地址
返回： OK
5.3.3 进入透传模式
命令： at+easy_txrxrn
描述： 发送该命令进入透传模式
返回： OKrn
5.3.4 查询软件版本
命令： at+versionrn
描述： 查询当前固件的软件版本信息，包括主机版本和WLAN版本
返回： OK<2.0.5>rn
ERRORrn
ERRORrn
ERRORrn
- 33 -
RAK425使用手册
5.3.5 复位重启模块
命令： at+reset rn
描述： 复位模块
返回： OKrn
5.3.6 恢复出厂设置
命令： at+restorern
描述： 恢复模块的出厂参数模式
返回： OKrn
ERRORrn
ERRORrn
5.4 参数配置指令
以下配置的关键字及其参数 请查看附录1.
5.4.1 写入用户配置
命令：at+write_config=配置参数长度,配置参数rn
描述：一步写入用户配置参数，用户将所有的配置参数一次性发送给模块,包括
网络模式，功耗模式，网络参数，串口及通信参数等 。也可以使能和关闭模块
的出厂高级功能，如局域网发现，WEBSever和AP/STA切换机制等。
例如：
at+write_config=622,wifi_mode=AP&power_mode=full&ap_channel=1&ap_ssid=RAK_000001&ap_secu_n
返回：
OKrn
ERRORrn
5.4.2 读取用户配置
命令：at+read_configrn
描述：读取用户配置参数，将所有的用户配置参数一次性读取回来，放到对应结构体中。
返回：
- 34 -
RAK425使用手册
OKwifi_mode=AP&power_mode=full&ap_channel=1&ap_ssid=RAK_000001&ap_secu_n
ERRORrn
5.4.3 读取出厂配置
命令：at+read_restoreconfigrn
描述：读取出厂配置参数，将所有的出厂配置参数一次性读取回来，放到对应结构体中。
其中出厂所建AP名称, 将作为模块的名称, 默认为RAK_XXXXXX, 后三个字节为MAC地址后三个字节， 可以由出厂配置修改。
返回：
OKwifi_mode=AP&power_mode=full&ap_channel=1&ap_ssid=RAK_000001&ap_secu_n
ERRORrn
5.4.4 修改出厂配置
命令：at+write_restoreconfig=配置参数长度,配置参数rn
描述：修改出厂配置参数，客户可以根据自己的需要修改出厂配置参数。
例如：
at+write_restoreconfig=602,wifi_mode=AP&power_mode=full&ap_channel=1&ap_ssid=RAK_000001&ap_secu_n
返回：
OKrn
ERRORrn
5.4.5 复制用户参数
命令：at+copy_cfgrn
描述：复制用户参数为出厂参数。
返回：
OKrn
ERRORrn
- 35 -
RAK425使用手册
5.5 AP SAT操作指令
5.5.1 查询AP连接状态
命令： at+con_statusrn
描述： 查询AP或STA下的连接状态。
返回： OKrn
5.5.2 查询STA 无线信号强度
命令： at+rssirn
描述： 查询STA下无线信号强度。
返回： OK
ERRORrn
code=0 未连接
code=1 已连接
备注：无网络连接时，该命令无效。模块作为AP时，默认为-0db。
5.5.3 扫描无线网络
命令：at+scan=
描述：扫描周围的无线网络。
例如： at+scan=0 rn----------------扫描所有信道
at+scan=0,LTHonwayrn--------在所有信道中扫描网络名为“LTHonway”无线网络
at+scan=8,LTHonwayrn--------在8信道中扫描网络名为“LTHonway”无线网络
at+scan=6 rn----------------扫描6信道中所有SSID
返回：OK
ERRORrn
5.5.4 获取无线网络
命令：at+get_scan=
描述：通过命令读取扫描信息，此命令必须在at+scan 命令后调用。
备注：1.如果不需要获取无线网络信息，此命令可省略！
2.扫描信息已经全部读取，如果再次读取，模块会返回错误-2，需调用 at+scan 命令进行重新扫描！
3.此命令在at+ascii=1模式下无效！
- 36 -
RAK425使用手册
表5-3 命令返回
5.5.5 一键入网命令
命令：at+easy_configrn
描述：发送该命令，模块进入一键配置模式，等待手机发送配置信息 。客户可通过查询网络状态命令，查询是否连接上。
返回：OK //表示进入配置模式
5.5.6 WPS配置命令
命令：at+wpsrn
描述：发送该命令，模块进入WPS配置模式，同时按下路由器的WPS按钮 。客户可通过查询网络状态命令，查询是否连接上。
返回： OK //表示进入WPS配置模式
5.5.7 查询IP状态
命令：at+ipconfigrn
描述：查询当前模块IP信息，包括MAC地址、IP地址，子网掩码，网关，DNS服务器
返回：见表5-4
- 37 -
RAK425使用手册
表5-4 ip命令返回
参数
命令执行成功
OK
rn
命令执行错误
ERROR
rn
备注
ASCII
HEX
ASCII
ASCII
HEX
HEX
HEX
HEX
HEX
HEX
ASCII
格式 长度 说明
2
6
4
4
4
4
4
2
查询成功
模块MAC地址
模块IP地址
模块子网掩码
网关
DNS服务器1
DNS服务器2
结束符
5
1
2
错误
0XFE=-2 查询失败
结束符
5.5.8 pin命令
命令： at+ping=
描述： 执行ping命令,测试网络是否连通。
返回： OKrn
ERRORrn
表5-4 ping命令返回
指定主机
数据包的数量，缺省值为1，(可选)
数据包大小，最大数据包为1000bytes，缺省值为64bytes。(可选)
5.5.9 查询TCP连接状态
命令：at+tcp_status=uuidrn
描述：查询对应uuid 的TCPClient连接状态。
uuid=0 表示socketA；
- 38 -
RAK425使用手册
uuid=1 表示socketB
返回：OKrn
code=0 未连接
code=1 已连接
5.5.10 AP高级设置
命令： at+apconfig=
描述： 此命令用于设置无线接入点参数，包括国家代码，不活动时间，beacon帧发包间隔，DTIM阀值。
表5-5 参数说明
参数 参数值 说明
返回：OKrn
ERRORrn
5.6 收发数据指令
5.6.1 发送数据
命令： at+send_data=uuid,dest_port,dest_ip,datalen,databuffer rn
描述：发送数据到对应的Socket (A,B )的uuid。当ASCII显示禁用时，发送为16
进制。排列顺序相同。
参数说明：
uuid=0 (1B)表示socketA；
uuid=1 表示socketB
dest_port (2B)表示目标端口(模块作为UDP服务器时，主动给目标主机发
送数据) (低位字节在前)
dest_ip (4B)表示目标IP (其他类型时，填0即可)
datalen (2B)表示接收数据长度(低位字节在前)
databuffer 表示接收数据内容
返回：
- 39 -
RAK425使用手册
OKrn
ERRORrn
5.6.2 接收数据
命令：at+recv_data=uuid,dest_port,dest_ip,datalen,databuffer rn
描述：接收到对应Socket (A,B )的uuid的数据，当ASCII显示禁用时，接收为16进制。排列顺序相同。
参数说明：
uuid=0 (1B) 表示socketA；uuid=1 表示socketB
dest_port (2B) 表示目标端口(低位字节在前)
dest_ip (4B) 表示目标IP
datalen (2B) 表示接收数据长度(低位字节在前)
databuffer 表示接收数据内容
5.7 附录
读写模块配置的关键字和参数 大全。
关键字
模式选择
AP模式： AP
wifi_mode
STA模式： STA
全功耗： full
power_mode 自动节省：save
最低功耗：deep
AP模式参数
ap_ssid
ap_channel
ap_secu_en
加密: 1
ap_psk
ap_ipaddr
ap_netmask
1234567890
192.168.7.1
255.255.255.0
RAK_AP_SSID (32B ASCII)
6 (1-13)
不加密: 0
参数
- 40 -
RAK425使用手册
不广播: 0 (隐藏)
ap_bdcast_en
广播: 1
STA模式参数
sta_ssid
sta_secu_en
加密: 1
sta_psk
sta_dhcp_en
动态获取: 1
sta_ipaddr
sta_netmask
sta_gateway
sta_dnssever1
sta_dnssever2
UART通信参数
uart_baudrate
uart_datalen
9600,19200,38400,57600,115200,230400,460800,921600
8 (5-8)
无: 0
uart_parity_en 奇校验: 1
偶校验: 3
uart_stoplen 1 (1-2)
禁用: 0
使能: 1
uart_rtscts_en
RS485/RTS: 2
(RTS作为收发切换脚 高电平发送）
Socket通信参数
单Socket: 0
socket_multi_en
双Socket: 1
SocketA参数
socketA_type
UDP服务器)
socketA_localport
socketA_destip
socketA_destport
socketA_tcp_timeout
25000 (1-65535)
192.168.1.101
25000 (1-65535)
禁用: 0
- 41 -
tcp,ltcp,udp,ludp (TCP客户端，TCP服务器，UDP客户端，192.168.1.100
255.255.255.0
192.168.1.1
192.68.1.1
0.0.0.0
1234567890
静态设置: 0
RAK_AP_STA
不加密: 0
RAK425使用手册
有效: 1-600 (S)
SocketB参数
socketB_type
UDP服务器)
socketB_localport
socketB_destip
socketB_destport
socketB_tcp_timeout
有效: 1-600 (S)
模块名称
module_name
module_group
WEB设置
user_name
user_password
web_en
1: 默认中文
附加功能可选
wps功能: wps
mode_pin
命令功能: easy
禁用: 0
net_switch 使能: 1
(连接不上网络时，切换出厂和用户参数启动 每一分钟)
使用原厂网页: 0
web_switch
使用客户网页: 1
禁用WEB配置: 0
web_func_en
使能WEB配置: 1
禁用UDP发现: 0
udp_func_en
使能UDP发现: 1
admin (16B)
admin (16B)
0: 默认英文
RAK_01 (16B)
RAK (16B)
25001 (1-65535)
192.168.1.101
25001 (1-65535)
禁用: 0
tcp,ltcp,udp,ludp (TCP客户端，TCP服务器，UDP客户端，
- 42 -
RAK425使用手册
7 版本
版本历程及修改内容
版本号 修改内容 修改日期
V1.0
V1.1
V1.2
V1.3
建立文档
添加出厂用户参数附录
更新联系方式，更新文档格式
更新实物图片
2014-06-13
2014-07-01
2014-08-22
2014-08-28
- 43 -
更多推荐
模块,配置,模式,参数
发布评论