LoRa网关GW1系列最多可接入100台标签设备，每个标签可被多个网关同时绑定。

LoRa系列设备具备本地存储，支持30万条离线数据存储。即使在通讯中断的情况下，系统仍能持续记录LoRa标签发送的数据，确保数据的连续性和完整性。设备支持断网数据自动重传功能，有效保障数据的完整性和可追溯性，使每一项记录都能得到安全保存并随时可供查阅。

LoRa有效接收距离为视距1千米，即无遮挡情况下。若因短暂无法正常发送数据，数据将保存在设备中，待通讯恢复后上传至网关。

LoRa网关默认同步周期为1分钟。LoRa网关数据同步周期不应大于5分钟，同步周期过长会导致标签数据上传拥堵，建议数据同步周期为1分钟。

设备配置成功后，由于网络延迟可能会导致无数据上传，请通过以下方法排查：

① 系统设置有默认数据同步时间，请在同步周期之后查看数据。

② 单击设备电源键/功能键（具体以设备说明书为准）手动上传数据。

③ 如仍无数据上传，请将设备恢复出厂设置，重新配置。

轻松连云平台提供4种预警类型，包括突变预警、持续预警、延迟突变预警和延迟持续预警。

• 突变预警: 数据仅在第一次超过设定条件时触发预警，若一直未恢复正常，则后续数据也不会触发。待数据恢复正常后，再次超过时仍然触发。
• 持续预警: 数据每次超过设定条件均会触发预警。（平台端限制每小时最多不可超过5次预警，如果需要设置持续预警，建议将设备上传周期设置为≤15分钟）
• 延迟突变预警:  数据在第一次超过设定条件且在后续持续时间内的数据都超过时，则触发预警。若持续时间内有数据未超过，则不会触发。
• 延迟持续预警:  数据在持续时间内的数据均超过设定条件时，则触发预警。

通过使用UbiHTTP，可以实现将预警消息推送至企业微信群内。

UbiHTTP交互服务相关连接：

https://www.ubibot.cn/platform-api/2960/http-interaction/

操作教程：

一、在企业微信群中选择“添加群机器人”，点击“添加机器人”。

二、添加机器人，设置机器人名称并复制生成的webhook地址，之后我们会将预警消息发送至该地址。

三、新建一个UbiHTTP，将刚才复制的webhook粘贴到网址栏中，方法选择“post”，内容类型为“application/json”，在body里按照以下示例填写。 其中text部分为消息。

举例：

{
 "msgtype": "text",
 "text": {
 "content": "预警提醒-编号为%%channel_id%%的设备(%%name%%)已超出警戒范围。
传感器:%%trigger_field%%, 报警瞬间值：%%trigger%%。"
 
 }
}

四、选择设备，在报警方式中选择设置好的UbiHTTP。

五、预警触发时，预警消息将会推送至企业微信群内。

进行数据导入导出操作，需要登录【轻松连】管理控制台console.ubibot.cn进行操作。

1.  数据导出

平台提供pdf和csv两种数据表格导出格式。

pdf数据表格提供详细的分析报告，图表及原始数据显示；pdf最多显示6000条数据，超过会被平台自动截断，pdf下载不限次数；

csv格式为表格形式可编辑的原始数据，可提供完整数据导出，不限制数据条数。如不勾选完整数据，导出数据条数与pdf相同，均为6000条。每台设备每月可免费导出3次完整数据。如需更多下载权益，请购买设备空间套餐，详情查看https://www.ubibot.cn/video/platform-video/4630。

平台还可提供PDF批量导出功能，导出的数据类型包含所有传感器，不能选择导出的数据。

2.  数据导入

平台提供数据导入操作，可将空间数据以外部CSV文件形式导入到平台中进行存储；csv的原始模板可以使用导出的csv表格进行编辑。

轻松连设备在持续优化功能及用户体验，将会不定期更新设备固件。部分设备支持远程升级功能，支持产品id如下：ubibot-ws1a系列、ubibot-ws1pb系列、ubibot-gs1a系列、ubibot-gs2a系列、ubibot-sp1系列、ubibot-sp1a系列、ubibot-ms1系列、ubibot-ms1a系列、ubibot-aqs1系列、ubibot-ld1、ubibot-nr1、ubibot-gw1系列等。
升级前，请确认您的设备产品id是否在以上范围。点击进入设备页面，查看产品ID。

点击【新指令】-【新建指令】，在指令字符串处输入升级指令并点击保存。升级指令请与售后人员确认。

保存后，设备将在下一同步周期执行指令并完成升级，请及时查看设备固件版本并确认。

通过使用UbiHTTP，可以实现将预警消息推送至钉钉群内。

钉钉机器人相关连接：

https://ding-doc.dingtalk.com/doc#/serverapi2/krgddi

UbiHTTP交互服务相关连接：

https://www.ubibot.cn/platform-api/2960/http-interaction/

操作教程：

一、在钉钉中选择“机器人管理”，并选择“自定义”

二、添加机器人，选择预警将要推送至的钉钉群并设置关键词。注意，自定义关键词必须出现在预警消息的内容中。

三、复制生成的webhook地址，之后我们会将预警消息发送至该地址。

四、新建一个UbiHTTP，将刚才复制的webhook粘贴到网址栏中，方法选择“post”，内容类型为“application/json”，在body里按照钉钉文档填写以下实例： 其中text部分为消息，注意消息里的关键词要包含钉钉机器人设置的关键词。 例如“”预警“。

举例：

{
    "msgtype": "text",
    "text": {
        "content": "预警提醒-编号为%%channel_id%%的设备(%%name%%)已超出警戒范围。传感器:%%trigger_field%%, 报警瞬间值：%%trigger%%。请有关同事尽快查看处理。"
    },
    "at": {
        "isAtAll": true
    }
}

五、选择设备，在报警方式中选择设置好的UbiHTTP。

六、预警触发时，预警消息将会推送至钉钉群内。

功能描述

HTTP交互服务又称UbiHTTP，UbiHTTP允许在设备、网站和Web服务之间进行通信，无需在设备级上实现协议。您可以在UbiHTTP中指定操作，然后在其他Ubibot功能中触发这些操作，比如预警功能。

创建一个UbiHTTP请求

1.创建一个新的UbiHTTP请求。单击“数据工厂”->“HTTP交互”，然后单击新建UbiHTTP; 2.指定设置，并非每种类型的请求都需要所有设置。所有UbiHTTP请求都需要以下参数;

针对您发出请求的性质，可以指定其他参数。例如，对需要身份验证的服务器的UbiHTTP请求需要用户名和密码。

3.保存请求。通过添加预警功能并选择UbiHTTP，您的UbiHTTP可供将来使用。

触发UbiHTTP

使用GET或POST请求，通过设置预警规则触发UbiHTTP。

1. 单击进入“数据仓库”->“我的数据仓库”；
2. 选择要设置HTTP交互的设备->“预警规则”->“创建离线/数据/USB断电预警”；
3. 按照应用情景进行预警信息设置；
4. 报警方式选择“HTTP交互”->选择刚刚设置好的UbiHTTP请求名字；
5. 保存预警；

当设备的传感器检测值到达用户设定的阈值时，UbiHTTP 请求被触发。

以下方式可以进行MAC地址查询：

1.打开网址https://www.ubibot.cn/进入轻松连主页，点击“管理控制台”；

2.进入管理控制台登录页面

根据提示输入“邮箱/手机号/用户名”及“密码”，点击登录；

3.进入管理控制台主页面，点击“数据仓库”—“我的数据仓库”，点击进入设备后，可查看MAC地址。

功能描述

此服务功能开通后，设备每次上传到轻松连大数据平台的空间数据（feeds）都将会完整的转发到指定第三方服务器端接口地址中。 可实现设备与第三方平台业务逻辑无缝连接。

开通方式

• 登录轻松连大数据平台
• 通过左侧菜单点击进入“数据工厂”->”数据转发服务”
• 按照页面引导创建数据上传转发服务

第三方服务器端接口接收环境要求

• 当有新的设备数据上传到轻松连大数据平台时，平台将该数据以JSON形式转发到指定的转发服务器URL。
• 服务器接收到数据后解析并进行二次开发
• JSON数据中包含channel_id可用于区分不同设备，同时在请求参数中也包含channel_id便于解析。

转发数据格式及结构

转发的数据是通过POST请求，以JSON数据作为Request Body， 并且Header中的Content-Type值为”application/json”

具体结构如下：

• channel_id:  (String) 设备唯一的空间编号
• product_id:  (String) 设备所属产品型号
• serial: (String) 设备序列号
• feeds: (Array) 数组
  • created_at: ISO 8601标准时间格式
  • field1..field10: 传感器数据
  • status: 状态信息
  • *因设备版本不同传感器field值可能会返回字符串型或数值型，请注意区分。

转发数据举例如下：

{
	"channel_id": "123456",
	"product_id": "ubibot-ws1p",
	"serial": "123456XXXXX",
	"feeds": [{
		"created_at": "2022-04-24T09:06:56Z",
		"field1": 24.495308
	}, {
		"created_at": "2022-04-24T09:06:56Z",
		"field2": 82
	}, {
		"created_at": "2022-04-24T09:07:00Z",
		"field5": -34
	}],
	"status": "mac=98:7b:f3:10:a1:e2,usb=1",
	"ssid_base64": "VFBHUw=="
}

 第三方服务器端接口接收返回规范

• 请确保业务逻辑在15秒内完成，否则服务器将断开连接
• 结果内容返回SUCCESS表示成功，ERROR表示失败
• 返回的结果仅用于后台统计成功及失败次数

 第三方服务器端实例

PHP:

<?php

try{
    $data = file_get_contents('php://input'); //get POST payload, 获取post包文
    $json = json_decode($data, true); //parse input data into json, 解析json，并进行业务逻辑
    //-----------注意: 请确保业务逻辑在15秒之内完成，否则服务器端将做超时处理------------//
    $myfile = file_put_contents('log.txt', $data.PHP_EOL , FILE_APPEND | LOCK_EX);
    echo "SUCCESS"; //成功处理请求
}
catch (Exception $ex)
{
    echo "ERROR";//失败处理请求返回
}

NodeJS:

const http = require('http');
const server = http.createServer(function (req, res) {
    let type = req.headers["content-type"];
    if (req.method.toLowerCase() === 'post' && type === "application/json") {
        try{
            ////get POST payload, 获取post包文
            var jsonData = "";
            req.on("data", function(chunk) {
                jsonData += chunk;
            });
            req.on("end", function() {
                //parse input data into json, 解析json，并进行业务逻辑
                var reqObj = JSON.parse(jsonData);
                
                //-----------注意: 请确保业务逻辑在15秒之内完成，否则服务器端将做超时处理------------//
                var fs = require('fs');
                fs.writeFile("log.txt", JSON.stringify(reqObj), function(err) {
                    if(err) {
                        res.end('ERROR');//失败处理请求返回
                    }
                });
                res.end('SUCCESS');//成功处理请求
            });
        }catch{
            res.end('ERROR');//失败处理请求返回
        }
    }else{
        res.end('ERROR');//失败处理请求返回
    }
});
//设置监听端口
server.listen(8080, "127.0.0.1", function () {
    console.log("server is started listen port 8080");
});

Python:

from http.server import BaseHTTPRequestHandler, HTTPServer
import cgi
import json

class testHTTPServer_RequestHandler(BaseHTTPRequestHandler):
    def do_POST(self):
        try:
            ctype, pdict = cgi.parse_header(self.headers.get('content-type'))
            if ctype == 'application/json':
                #get POST payload, 获取post包文, parse input data into json, 解析json，并进行业务逻辑
                length = int(self.headers['content-length'])
                jsonArray = json.loads(self.rfile.read(length))
                #-----------注意: 请确保业务逻辑在15秒之内完成，否则服务器端将做超时处理------------#
                myfile = open("log.txt",'a')
                myfile.write(json.dumps(jsonArray))
                myfile.write("\n")
                myfile.close()
                #成功处理请求
                self.protocal_version = 'HTTP/1.1'
                self.send_response(200)
                self.send_header("Welcome", "Contect")
                self.end_headers()
                self.wfile.write(bytes("SUCCESS", "utf-8"))
                return
            else:
                #失败处理请求返回
                self.protocal_version = 'HTTP/1.1'  
                self.send_response(300)
                self.send_header("Welcome", "Contect")
                self.end_headers()
                self.wfile.write(bytes("ERROR", "utf-8"))
                return
        except:
            #失败处理请求返回
            self.protocal_version = 'HTTP/1.1'
            self.send_response(300)
            self.send_header("Welcome", "Contect")
            self.end_headers()
            self.wfile.write(bytes("ERROR", "utf-8"))
            return

def run():
    port = 8080
    print('starting server, port', port)
    # Server settings
    server_address = ('', port)
    httpd = HTTPServer(server_address, testHTTPServer_RequestHandler)
    print('running server...')
    httpd.serve_forever()

if __name__ == '__main__':
    run()

C# ASP.NET

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace demo1.Controllers
{
    public class FeedData
    {
        public DateTime created_at { get; set; }
        public object field1 { get; set; }
        public object field2 { get; set; }
        public object field3 { get; set; }
        public object field4 { get; set; }
        public object field5 { get; set; }
        public object field6 { get; set; }
        public object field7 { get; set; }
        public object field8 { get; set; }
        public object field9 { get; set; }
        public object field10 { get; set; }

    }
    public class DeviceData
    {
        public string channel_id { get; set; }
        public string status { get; set; }
        public List feeds { get; set; }

        public string ssid_base64 { get; set; }
    }

    [Route("api/[controller]")]
    [ApiController]
    public class RestApiController : ControllerBase
    {
        [HttpPost]
        [Route("recv")]
        public string ReceiveData([FromBody] DeviceData data)
        {
            try
            {
                //使用data进行业务处理
                return "SUCCESS";//成功处理请求
            }
            catch (Exception)
            {
                return "ERROR";//失败处理请求返回
            }
        }
    }
}

一.使用APP分享

1.点击指定设备头像，进入设备数据空间；
2.在上方页签栏，向右侧拉动，点击找到“分享”按钮，并点击“+” ，如图位置：

3.在弹窗中输入已注册的轻松连账号（用户名/手机/邮箱等）
如果输入正确，app将自动识别对应账号并弹出选项，点击匹配的账号，完成分享操作。

被分享人在登录app或者网页端后，可以在Ta的设备中找到分享的设备，被分享人可以点击查看数据，但没有修改设备配置的权限。

二.使用网页平台分享

打开网页数据平台登录https://console.ubibot.cn/，勾选您想要分享的设备，可多选，点击分享按钮，输入已注册的轻松连账号（用户名/手机号/邮箱等）输入正确后，平台会自动匹配账户，点击匹配的账户，完成分享。

被分享人在登录app后或网页端，可以在Ta的数据仓库页面内中找到分享的设备

1. 安装时，提示手机禁止外来软件安装：请自行调整手机权限，一般为设置-安全-允许安装未知来源软件。

2.解析时出现问题，一般为软件与系统不兼容，轻松连APP支持系统版本为Android11+，iOS16+的设备。建议通过轻松连官网下载中心进行下载并安装。