跳转至

01 基础参数

作者:李源龙 | 最后修改:2026-04-01

一、演示功能概述

本篇文档主要是讲解了 iRTU 的参数设置的基本参数选项里面的内容都是做什么用的,主要功能包括,添加设备识别码 IMEI,首次登录服务器发送注册信息,自动更新,串口分帧超时,电源模式,配置密码,日志输出,RNDIS,iPv6 功能。

二、准备硬件环境

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

三、准备软件环境

1.烧录工具:Luatools 工具

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

3.tcp 服务器测试地址:https://iot.luatos.com/#/page6/netlab。 详细使用说明参考:合宙 TCP/UDP web 测试工具使用说明

4.ipv6 服务器测试地址:https://netlab.luatos.org/,需要注意的是,卡需要支持 ipv6 才可以。

四、功能选项讲解

本次功能展示统一使用该串口配置和网络通道配置:

使用串口 1,波特率 115200,默认配置,服务器选择为 tcp 服务器

4.1 添加设备识别码 IMEI:

1.功能解释:加:在串口设备发往服务器的时候,结果为 IMEI+ 数据内容,不加:默认串口透传内容,默认是不加

2.举例:配置内容如下

测试结果:

串口这边发送的内容为 data,发送到服务器的内容为模块 IMEI+ 内容 data

如果选择不加,内容为原本的透传数据 data:

4.2 首次登录服务器发送注册信息

1.功能解释:不发:连接服务器不发送任何信息。发送{csq:rssi,imei:imei,iccid:iccid,ver:Version}:连接服务器之后会往服务器发送 csq,imei,iccid,版本号等信息。自定义:可以自己写 lua 代码实现内容。默认是不发

2.举例:配置内容如下

不发的情况也就是连上服务器之后不发送任何数据,就不做任何举例了

发送{csq:rssi,imei:imei,iccid:iccid,ver:Version}

服务器接收内容结果:

自定义:

可以在里面编写 lua 代码,返回想要发送到服务器的首包内容

举例:

代码内容:

function end 为固定格式,return 为返回内容,这些是必填的内容,一定要 return 返回数据才可以。

--其中function end为固定格式,return为返回内容,然后其他和写lua函数是一样的,在里面写逻辑即可。
function
    return "first data"..mobile.imei()
end

服务器接收结果,内容为 first data866597072469206

4.3 自动更新

1.功能解释:否:每次开机不去 iot 平台进行请求 ota,是:开机会去 iot 平台请求 ota,一般如果没有遇到 bug 需要 ota,可以不选择 ota,只对配置做修改即可。默认是否

2.举例:

默认是否的状态,如果后续版本有解决 bug 或者更新功能,可以选择是进行自行 ota,ota 流程可以参考 780EHM 的 OTA 文档:https://docs.openluat.com/air780epm/luatos/app/ota/fota/#642-tcp

本文简单做下版本号 +1 的 ota 流程,当前版本为 5.0.0,更新版本为 5.0.1,底层 core 不变,后续出新版本会提供.bin 文件进行 ota,把.bin 文件放入到固件升级的创建固件里面,即可完成升级

重启模块即可完成升级。

4.4 串口分帧超时

1.功能解释:串口发送过来的数据,多长时间之后,发送到服务器端,该功能主要是针对有些设备串口发送时间可能过长,导致有时候会被分包,该功能主要是为了解决分包问题。该功能设置的时间单位为 ms,数据发送到服务器的时间为最后一包数据之后的 + 串口分帧超时的时间,假设设置的 2000 毫秒,串口在 5 秒内每 1 秒都会发送一包数据过来,那么发送到服务器的时间为第 7 秒,模块接收 5 包数据之后等待 2000ms,如果没有数据再过来就发送到服务器。默认是 25ms

2.举例:配置内容如下,默认为 25ms,举例设置的 2000ms,即为 2 秒,具体根据实际需求而定,25ms 可满足大部分需求。

4.5 电源模式

1.功能解释:正常:该模式为常规模式;pm.power(pm.WORK_MODE,0),节能:该模式为低功耗模式;;pm.power(pm.WORK_MODE,1),具体功耗细节数据可以参考 780EHM 的低功耗文档,默认是正常模式 https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/

注:低功耗模式下,波特率为 9600 才可以保证必定接收到数据唤醒

2.举例:

4.6 配置密码

1.功能解释:该功能用于服务器可以发送 config,readconfig 来读取模块的配置内容,如果添加了密码之后,服务器端必须要添加密码才能读取配置。默认是空,无密码

2.举例:

4.7 日志输出

1.功能解释:关闭:静默所有日志,即禁止日志有任何内容输出;开启:有日志输出。默认是开启

2.举例:

关闭日志代码应用层打印的日志都会没有,但是底层的日志没办法做到完全屏蔽。数据交互会有结果

4.8 RNDIS

1.功能解释:RNDIS(Remote NDIS):基于 USB 实现的 TCP/IP over USB,让 USB 设备在 Windows 系统上呈现为一块网卡,从而使 Windows/Linux 可以通过 USB 设备连接网络。关闭:不开启 RNDIS 功能。开启:打开 RNDIS 功能。默认是关闭

2.举例:

4.9 ipv6

1.功能解释:是否默认开启 IPV6 功能,开启:开启 IPV6 功能,关闭:不开启

2.举例:选择开启

网络通道配置:

测试地址:https://netlab.luatos.org/

可以看到模块可以正常连接到 ipv6 的服务器,进行数据收发。

五、总结

本文演示如何在 Air780EHM 核心板上面,用 irtu 固件,展示基本参数的配置功能