快速上云，合宙AirCloud帮你搞定！

excloud扩展库是AirCloud协议的实现，提供了完整的物联网设备云服务解决方案，并全面兼容所有基于LuatOS开发的产品。

主要功能包括：

• 设备连接管理：
  支持TCP和MQTT协议，自动处理连接建立、认证和重连；

• 数据上报：
  灵活上报设备状态、传感器数据等各类信息；

• 远程控制：
  接收并响应云端的控制指令；

• 文件上传：
  支持图片等文件的上传功能；

• 心跳保活：
  自动维持设备与云端的连接状态；

• 运维支持：
  自动日志上传、故障诊断。

本文将以Air780EPM开发板为例，分享AirCloud云平台配置及excloud扩展库的核心功能示例要点。

Air780EPM系列应用示例持续更新中，本示例演示excloud扩展库的完整使用流程，包括：设备连接与认证、数据上报与接收、运维日志管理、文件上传功能、心跳保活机制。

一、示例核心代码解析

以下是excloud的几种典型场景，用户可根据实际需求选择配置方式，完整demo详见源码仓库最新文件。

1.1 回调函数注册与事件处理

1.2 使用GetIP服务连接（推荐）

负载均衡GetIP服务简介：

1）通信协议要求

• 协议需要兼容老设备，同时兼容负载均衡；

• 便于扩展到更多二进制数据的上传；

• 要包含鉴权，上传后要自动归入设备对应的数据里。

2）通信逻辑

• 负载均衡服务器，支持生成图片上传的url和额外参数；

• 设备通过调用getip接口，获取图片上传所需要的url和参数列表；

• 设备在指定条件下（定时/按键触发），使用上述参数执行上传；

• 设备平台收到数据后，需要展示到页面中。

1.3 使用PC模拟器配置

主要是修改"virtual_phone_number "和"virtual_serial_num "两个参数，以及netdrv_device.lua中的联网方式。

1.4 数据上报功能

1.5 心跳上报功能

1.6 运维日志功能

运维日志功能用作远程查看的设备日志，方便设备部署出去之后，还能远程做日常的诊断可以有效解决设备部署出去之后， 无法查看日志，不方便分析问题的痛点。

1）运维日志的实现方式

在日常运行中，专门开辟四个文件，用于存放代码输出的运维日志。在需要的时候，由Aircloud云平台打开网页，请求设备上传运维日志，然后查看和分析对应日志。

2）运维日志存储机制详解

文件结构：

存储空间管理：

• 默认大小：

  每个文件占用1个block（通常4KB），4个文件共4个block（16KB）。

• 可配置：

  通过（在setup中配置mtn_log_blocks）调整每个文件的大小。

• 覆盖机制：采用循环覆盖机制。

上报逻辑：

3）运维日志功能使用

在setup中配置mtn_log_enabled=true即可，然后在代码中使用excloud.mtn_log接口记录。

1.7 图片上传功能

二、云平台配置

2.1 登录合宙IoT平台

先登录合宙IoT平台（iot.openluat.com），如下图所示；没有账号的，可以先注册一个。

客户向采购4G模块时，如果采购人员没有告知这批模块放在iot.openluat.com上的哪个产品下，则会以采购人的手机号为账号，默认密码888888，创建一个“标准模块”的项目，此次采购的所有模块都会放在这个项目下。

如果你的账号下没有对应imei，可以联系合宙销售帮忙添加模块进对应项目下（如果非官方渠道购买，从哪里买的模块，就让销售方给你转移到你自己名下）；如果不在自己账号下，也可以通过烧录专属固件的方法，把模块归属到指定的项目下，可以点击云平台帮助中心，查看详细说明。

2.2 获取项目key

创建新项目或选择现有项目并获取项目key (auth_key)，并将获取的项目key配置在代码中。

2.3 查看设备报文

然后使用同样的账号登录AirCloud云平台（iot.luatos.com），查看设备上报报文。

三、示例功能验证

根据实操教程搭建好硬件环境，使用Luatools给开发板烧录内核固件和demo脚本代码，运行并查看日志。

3.1 Luatools日志查看

下发运维日志指令：

3.2 云平台数据查看

AirCloud云平台接收到的设备数据展示：

3.3 远程控制测试

通过AirCloud云平台下发控制命令，观察设备响应。

控制命令下发界面：

设备接收并响应控制命令的日志：