跳转至

iRTU指令说明

作者：李源龙　|　最后修改：2026-05-26

一、演示功能概述

本篇文档主要是讲解了 iRTU 的 rrpc 指令

二、准备硬件环境

准备一块 Air780EHM 核心板：点击购买

三、准备软件环境

rrpc 指令处理流程：

1.烧录工具：Luatools 工具

2.Air780EHM 烧录需要的 irtu 固件：固件版本

3.服务器测试地址：iot.luatos.com

四、指令列表

rrpc 的指令可以通过服务器或者串口发送，获取返回结果

4.1 获取固件版本号和软件版本号

1.指令：rrpc,getfwver

2.解释：获取模块的固件版本号和软件版本号

3.返回值示例：rrpc,getfwver,iRTU_5.0.0_V2018，其中 5.0.0 为版本号，V2018 为固件版本号 V2018 版本

4.2 获取网络状态

1.指令：rrpc,getnetmode

2.解释：获取模块的网络状态，0:网络未注册，1:网络已注册，2:正在搜网中，3:网络注册被拒绝，4:网络状态未知，5:漫游,且已注册，6:仅 SMS 可用，7:仅 SMS 可用,且漫游状态，8:仅紧急呼叫. 注意, 国内不支持此状态,模块也不支持紧急呼叫；

3.返回值示例：rrpc,getnetmode,1，1 为网络已注册

4.3 获取软件版本号

1.指令：rrpc,getver

2.解释：获取模块的软件版本号

3.返回值示例：rrpc,getver,5.0.0，其中 5.0.0 为版本号

4.4 获取信号值

1.指令：rrpc,getcsq

2.解释：获取模块的信号值，信号值 0 - 31, 越大越好，若失败返回 0

3.返回值示例：rrpc,getcsq,31，其中 31 为信号值

4.5 获取 ADC 值

1.指令：rrpc,getadc,data

2.解释：获取模块的 ADC 值，data:取值 0-3，代表 adc0-adc3，根据硬件设计选择使用哪个 adc，示例：rrpc,getadc,1

3.返回值示例：rrpc,getadc,1899，其中 1899 为 adc 获取的 mV 值

4.6 重启模块

1.指令：rrpc,reboot

2.解释：重启模块，该操作在收到指令之后，1 秒之后执行。

3.返回值示例：OK

4.7 获取模块 IMEI

1.指令：rrpc,getimei

2.解释：获取模块的 IMEI 值

3.返回值示例：rrpc,getimei,866597072469206

4.8 获取模块的 IMSI

1.指令：rrpc,getimsi

2.解释：获取模块的 imsi 值

3.返回值示例：rrpc,getimsi,460084994103030

4.9 获取模块的 VBAT 值

1.指令：rrpc,getvbatt

2.解释：获取模块的 VBAT 的 mV 值

3.返回值示例：rrpc,getvbatt,4009，其中 4009 为 adc 获取的 mV 值

4.10 获取 SIM 卡的 ICCID

1.指令：rrpc,geticcid

2.解释：获取 sim 卡的 ICCID 值

3.返回值示例：rrpc,geticcid,898604C91024C0283030

4.11 获取实时基站定位

1.指令：rrpc,getreallocation

2.解释：获取基站定位的经纬度数据，该操作会去主动访问 bs.openluat.com 获取基站定位，如果是专网卡客户，可以添加该地址到白名单

3.返回值示例：rrpc,getreallocation,034.5803787,113.8384801，其中，034.5803787 是纬度，113.8384801 是经度

4.12 获取时间

1.指令：rrpc,gettime

2.解释：获取模块的时间，为了确保时间准确，开机会进行一次 ntp 网络授时，使用的是网络授时的时间,因为该操作会去主动访问 ntp.aliyun.com 获取时间，如果是专网卡客户，可以添加该地址到白名单

3.返回值示例：rrpc,gettime,2025-12-11 11:13:01

4.13 设置 gpio 拉高拉低

1.指令：rrpc,setpio,gpio,0/1

2.解释：设置 gpio 拉高拉低，示例：rrpc,setpio,20,1 这个操作的含义是设置 gpio20 拉高。

3.返回值示例：OK

4.14 查询 gpio 状态

1.指令：rrpc,getpio,gpio

2.解释：查询 gpio 的状态，示例：rrpc,getpio,30 其中 30 为 gpio 号，可以填写其他的 gpio

3.返回值示例：rrpc,getpio30,0

4.15 查询服务器连接状态

1.指令：rrpc,netstatus,data

2.解释：查询对应网络通道号的连接状态，data 为网络通道号 1-7，如果没有 data 值，默认是通道 1，示例：rrpc,netstatus，如果添加网络通道号，示例：rrpc,netstatus,1

3.返回值示例：如果没有通道号，默认返回值为通道 1 状态：rrpc,netstatus,RDY，其中 RDY 为连接服务器，NORDY 为未连接服务器。如果有网络通道号，返回值为：rrpc,netstatus,1,RDY，其中 1 为网络通道号 1，对应发送指令的网络通道号，RDY 为连接服务器，NORDY 为未连接服务器

4.16 请求更新配置参数

1.指令：rrpc,upconfig

2.解释：请求更新配置参数，请求 OTA，发送该指令之后进行一轮请求配置参数和 OTA 流程。如果没有更新参数则无事发生，有配置更新会获取配置更新然后重启模块

3.返回值示例：rrpc,upconfig,OK

4.17 切换 SIM 卡

1.指令：rrpc,simcross,data

2.解释：切换 sim 卡，data 可选值 0,1,2。0 为固定使用 SIM0，1 为固定使用 SIM1，2 为自动识别 SIM0, SIM1。

3.返回值示例：simcross,ok,2 其中 2 为设置的 data 值

4.18 写入配置参数

1.指令：config,writeconfig,data

2.解释：写入配置参数，data 为配置参数，配置参数的获取可以从http://iot.openluat.com/irtu/project-list 配置网页的导出参数中获取

3.返回值示例：OK/JSON ERROR/PASSWORD ERROR,其中 JSON ERROR 为配置参数格式错误，PASSWORD ERROR 为配置参数密码错误，OK 为配置参数写入成功

4.具体示例： 第一步，先通过网页端获取配置参数，然后点击一键复制，配置参数的获取可以从http://iot.openluat.com/irtu/project-list 配置网页的导出参数中获取。 alt text 第二步，通过串口将配置参数写入模块，示例：config,writeconfig,配置参数，需要把配置参数里面的"source":"web"改成"source":"uart",这样的话，模块就会从串口接收配置参数，后续都不会从网页端接收。 alt text

4.19 获取配置参数

1.指令：config,readconfig,password

2.解释：获取配置参数，password为配置的密码，如果没有可不填，有密码的示例：config,readconfig,123456，如果没有密码，示例：config,readconfig

3.返回值示例：配置内容的 JSON 字符串/PASSWORD ERROR，其中 PASSWORD ERROR 为密码错误，JSON 字符串为配置参数的 JSON 字符串

4.20 设置 airlbs 配置

1.指令：rrpc,setairlbsconfig,project_id,project_key,timeout

2.解释：设置 airlbs（付费基站定位）的配置，需要先在 iot 平台申请项目并获取 project_id 和 project_key。timeout 为超时时间（单位：ms），可选参数，默认 10000ms。

3.返回值示例：rrpc,setairlbsconfig,OK,project_id,project_key,10000，其中 project_id 为项目ID，project_key 为项目密钥，10000 为超时时间。

4.21 获取 airlbs 配置

1.指令：rrpc,getairlbsconfig

2.解释：获取当前 airlbs（付费基站定位）的配置信息，包括项目ID、项目密钥和超时时间。

3.返回值示例：rrpc,getairlbsconfig,OK,project_id,project_key,10000，其中 project_id 为项目ID，project_key 为项目密钥，10000 为超时时间。

4.22 获取付费基站定位数据

1.指令：rrpc,getairlbslocation,usewifi

2.解释：获取 airlbs（付费基站定位）的经纬度数据。可选参数 usewifi 用于指定是否使用 WiFi 辅助定位（1 表示使用，0 或不填表示不使用）。

3.返回值示例：rrpc,getairlbslocation,OK,034.5803787,113.8384801，其中 034.5803787 是纬度，113.8384801 是经度。如果使用 WiFi 定位，会额外添加 WiFi 信息辅助定位，提高定位精度。

五、功能展示

1.本次测试使用的服务器地址为：iot.luatos.com

2.本次的配置页面内容为：

3.Aircloud 页面的操作示例

点击下发，命令类型选择 iRTU 下行命令，发送消息内容选择 rrpc 指令，点击下发

这边可以看到下发内容和回复结果

4.串口查询示例：

串口波特率选择 115200，发送 rrpc,getimei，模块返回 IMEI 查询结果

六、总结

本文演示如何在 Air780EHM 核心板上面，用 irtu 固件，展示了 rrpc 指令的功能