GAgent功能

H在开发

机智云文档

(https://devdocs.gizwits.com/zh-cn/ProductDev/DevAccess/GAgentTutorial.html#1-GAgent%E5%8A%9F%E8%83%BD%E6%A6%82%E8%BF%B0)

GAgent主要用于设备数据、机智云和应用端之间的数据交互。它可以被移植到各种平台和模组，包括WiFi模组、GPRS模组和PC端等。

目前，机智云提供了一系列针对不同模组的固件，以便将GAgent移植到这些模组上。一些支持的WiFi模组包括：汉枫 LPB100、LPB120、LPT120、LPT220，乐鑫8266，高通4004，RealTek 8711AM，联胜德 TLN13SP01，锐凌微 TinyCon3350-M26，庆科3162 等。此外，GPRS模组中广和通G510也支持GAgent的固件。

通过将GAgent移植到这些模组上，可以方便地实现设备和机智云之间的数据传输和通信

GAgent接入机智云流程

1.设备上电

A、GAgent请求设备信息

B、回复GAgent设备信息

C、设备正常工作，需回复GAgent发出的心跳包

D、GAgent网络状态发生变化通知mcu。

2.配置入网

让设备连接到路由器的过程，通常有三种主要的配网方式：Airkiss（微信配网）、AirLink和SoftAP。

1. Airkiss：Airkiss 是一种由微信提供的配网方式，可以通过微信的功能将设备和路由器进行配对。用户只需要打开微信并选择设备配网功能，然后按照提示操作，将设备和路由器连接在一起。

2. AirLink：AirLink 是一种通过射频信号进行无线配网的方式。用户需要使用手机或其他设备连接到设备的AP热点，然后打开配网工具，通过扫描设备的二维码或手动输入设备信息来完成设备和路由器的配对。

3. SoftAP：SoftAP 是一种通过设备自身作为热点的方式进行配网。用户需要将设备设置为软件热点，并连接到设备的热点。然后打开配网工具，通过扫描设备的二维码或手动输入设备信息来将设备和路由器连接在一起。

这三种配网方式都可以让设备连接到路由器，并实现设备和应用端（如手机APP）之间的数据交互。具体选择哪种方式我们要根据具体的使用场景和设备的支持情况来决定。

3.绑定设备

控制设备之前必须先将设备绑定到应用程序中。对于Wi-Fi设备，通常采用局域网发现的方式进行绑定。应用程序在与设备连接同一个局域网的情况下，可以通过扫描局域网中的设备来发现设备，并将其添加到应用程序中进行控制。

对于GPRS模组，由于它不在局域网内，因此无法采用局域网发现的方式进行绑定。相反，通常将设备上贴有二维码或其他形式的识别码。在应用程序中，用户可以通过扫描这些二维码或输入识别码来将设备添加到应用程序中进行控制。

需要注意的是，每种设备的绑定方法可能略有不同，具体细节取决于设备和应用程序的实现。用户应该仔细查阅设备和应用程序的文档以了解绑定设备的详细过程。

4.下发、上报设备数据

       下发和上报都要经过GAgent。

下发，APP、云端控制设备，

上报，设备主动上报当前状况。

5.GAgent OTA流程

       通过机智云官网创建的远程推送GAgent固件规则后，通知当前模组更新到对应新固件。

       有两种出发动作：云端主动通知OTA动作；GAgent连接云端检查是否需要OTA。

6.MCU OTA流程

MCU OTA是指通过机智云官网创建远程推送MCU固件规则后，通知当前MCU更新到对应新固件。MCU OTA过程，即GAgen向MCU进行大文件传输。

7.MCU上传大文件至机智云

设备采集的数据过大时，MCU可以通过GAgent向机智云传输大文件。上传到机智云后，可通过相应接口接收。目前APP暂不支持获取MCU上传的大文件

8.产测流程

产测主要应用在设备生产检测过程中，对设备检测的一种方法。目前产测适用于WiFi模组，不适用GPRS模组。