05 网络通道AirCloud

作者：李源龙　|　最后修改：2025-12-17

一、演示功能概述

本篇文档主要是讲解了 iRTU 的参数设置的网络通道里面的 AirCloud，合宙 AirCloud 平台 iot.luatos.com 是一个物联网设备管理平台，提供设备连接、数据采集、远程控制、运维监控等功能。用户可以通过该平台：

设备管理：注册、认证、监控设备状态。
数据可视化：查看传感器数据、历史曲线。
远程控制：下发指令控制设备行为。
文件上传：支持图片、音频、日志文件上传。
运维支持：自动日志上传、故障诊断。

配置的主要功能包含协议的选择，心跳间隔时间，自动采集任务间隔时间，AuthKey，

二、准备硬件环境

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

三、准备软件环境

1.烧录工具：Luatools 工具

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

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

四、功能选项讲解

本次功能展示统一使用该串口配置：

使用串口 1，波特率 115200，默认配置

4.1 通道的开启和关闭

1.功能解释：关闭：不开启网络通道配置，无法进行服务器连接。开启：开启服务器通道配置

2.举例：

4.2 通道类型

1.功能解释：Socket：配置 Socket，Mqtt：配置 Mqtt，AirCloud：配置 AirCloud

2.举例：

4.3 协议

1.功能解释：TCP：配置 TCP 协议。MQTT：配置 MQTT 协议，默认 TCP 协议，在数据应用处理方面，客户体验基本上是无感的，只会有数据接收处理。推荐使用 TCP 协议即可。

2.举例：

4.4 心跳间隔时间

1.功能解释：TCP 的心跳包机制就像是通信双方定期互发“我还活着”的信号，通过定时收发一个小数据包来确认连接是否有效，防止长时间无数据交互时连接被中断，默认时间是 300 秒。发送到服务器的数据内容为：{"csq":csq,"eci":eci,"rsrp":rsrp,"band":band}

2.举例：

4.5 自动采集任务间隔时间

1.功能解释：该功能主要是搭配预置信息里面的自动采集任务使用，填写的时间是进行一轮数据采集的时间

2.举例：

本章节主要是简单讲解一下，后续在自动任务采集里面会详细讲解该功能，只需要记住这里面设置的时间是两次发送消息时间的间隔。

4.6 AuthKey

1.功能解释：Iot 平台 IMEI 对应的项目 key,该参数主要是作为连接 AirCloud 的密钥，必填，不填或者错误会连接不上

2.举例：

4.7 TCP 通道捆绑的串口 ID

1.功能解释：进行数据传输的串口号，根据在串口配置的内容进行选择，1：串口 1,2：串口 2,3：串口 3

2.举例：

4.8 SSL

1.功能解释：ssl 加密配置；启用：无证书最简单的加密，不启用：不加密，默认为不启用

2.举例：

4.9 MQTT 的 QOS 级别

1.功能解释：该选项只会在选择 MQTT 的时候需要选择，QoS 0（最多一次）：消息可能丢失，但传输最快，适用于非关键数据（如传感器读数）。QoS 1（至少一次）：消息保证必达，但可能重复，需应用层处理。QoS 2（恰好一次）：消息不丢不重，最可靠但开销最大，用于金融交易等场景。默认 0

2.举例

4.10 整体测试

1.我们先进行网页端配置，主要是填入 AuthKey，这个值可以从 IOT 平台的 IMEI 所在的项目获取，然后我们的配置就配置好了

2.登录 iot.luatos.com 平台，然后选择 AirCloud，选择 AirCloud 上报消息记录

3.这个时候选择项目，输入 IMEI，就可以查询到我们的交互信息了

4.下发透传数据，点击右侧操作的下发功能

选择透传消息，在发送消息内容里面输出要发送的内容，点击下发

这个时候模块收到就会透传到串口

5.下发 rrpc 指令

还是点击右侧的下发按钮

选择 iRTU 下行命令，发送内容选择获取模块的 IMEI 号指令内容为 rrpc,getimei，点击下发

6.数据流处理控制命令

对于 AirCloud 需要注意的是有 3 种消息类型，iRTU 指令，透传数据，还有控制命令这三种下发数据的类型，其中 iRTU 指令不需要进行数据流控制，仅用来获取模块自身的一些值，用数据流可以对控制命令和透传数据进行处理，

下面这部分数据流格式还是固定的 function end，local data,datatype=...表示获取参数值，其中 AirCloud 有两个参数 data 为数据，datatype 为数据类型，然后对数据类型进行判断，选择不同的处理方式，代码里面如果收到控制命令，并且数据内容为 reboot，则模块选择重启，如果收到是透传数据，则在透传数据前，拼接上 1281。当然可以根据自己的需求进行修改，做到更丰富的处理功能。

数据流的配置：

数据流里面的代码：

function
    local data,datatype=...
    log.info("接收到数据",data,"数据类型"..datatype)
    if datatype==19 and data=="reboot" then
        log.info("接收到重启指令，进行重启")
        pm.reboot()
    elseif datatype==1281 then
        return "1821"..data
    end
    return data
end

接收到重启命令示例：

接收到透传数据示例，服务器发送的内容为 data，拼接上 1281，组成 1281data：

7.模块上传透传示例

串口助手这边发送消息 data1111111111111111

服务器这边收到消息内容，为 1281 透传消息

五、总结

本文演示如何在 Air780EHM 核心板上面，用 irtu 固件，展示网络通道 AirCloud 的收发使用