此系列设备在无网络情况下，数据将存储在设备内部，若需要查看实时数据，可参考以下两种方法： ①在无网络环境下监测完成之后，可将设备拿回至所配置过的网络环境下，单击按键自动上传数据。 ②在无WiFi情况下，设备也可通过数据线与电脑连接，利用PC端工具可将数据导出。

自动化管理可快速实现设备之间的联动，当触发设备达到预先设定的触发条件时，执行设备将自动触发操作。 1.点击【数据工厂】-【自动化管理】，进入自动化管理页面。点击【创建自动化】。 2.选择触发设备，并设置触发条件。 3. 选择执行设备及动作。执行设备仅支持智能开关SP1、网络继电器NR1等智能控制设备，最多可同时设置5个执行设备。 4. 确认已设置的自动化规则并保存。 5. 设置成功。

轻松连设备在持续优化功能及用户体验，将会不定期更新设备固件。部分设备支持远程升级功能，支持产品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。 点击【新指令】-【新建指令】，在指令字符串处输入升级指令并点击保存。升级指令请与售后人员确认。 保存后，设备将在下一同步周期执行指令并完成升级，请及时查看设备固件版本并确认。  

可能原因：

①手中把握设备时间太长 ②配置时间过长，CPU工作温度高 ③发送时间设置过于频繁，会导致温度高出0.2-0.3℃

解决方法:

静置设备15-20分钟，之后发送数据读数。

此系列设备在无网络情况下，数据将存储在设备内部，若需要查看实时数据，可参考以下两种方法： ①在无网络环境下监测完成之后，可将设备拿回至所配置过的网络环境下，单击按键自动上传数据。 ②在无WiFi情况下，设备也可通过数据线与电脑连接，利用PC端工具可将数据导出。

发送数据时红色指示灯闪烁，为设备网络连接异常，请确认以下内容： ① WiFi名称及密码是否正确； ② 设备恢复出厂设置后重新配置设备。 报警方式有六种，可自定义设置：微信报警推送、APP报警推送、手机短信报警、语音电话报警、HTTP交互报警、邮件报警推送。

设备配置成功后，由于网络延迟可能会导致无数据上传，请通过以下方法排查： ① 系统设置有默认数据同步时间，请在同步周期之后查看数据。 ② 单击设备电源键/功能键（具体以设备说明书为准）手动上传数据。 ③ 如仍无数据上传，请将设备恢复出厂设置，重新配置。

设备默认10分钟采集一次数据，30分钟上传一次数据，用户可以在管理控制台或手机APP更改数据采集间隔和数据上传间隔。（增加数据同步间隔时长，会相对应增加设备待机时间，反之同理。）

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

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

功能描述

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

创建一个UbiHTTP请求

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

必选参数	描述
名字	为您的UbiHTTP请求输入一个唯一的名称
API密钥	自动为UbiHTTP请求生成的API密钥
网址	输入请求数据或写入数据的网站网址，以http://或https://开始
方法	选择访问网站网址所需的以下HTTP请求方法之一：GET,POST,PUT,DELETE。

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

可选参数	描述
HTTP 授权用户名	如果您的URL需要身份验证，请输入身份验证用户名以访问私人频道或网站。
HTTP身份验证密码	如果您的URL需要验证，请输入验证密码以访问私人频道或网站。
内容类型	输入请求内容的MIME或表单类型。例如，application/x-www-form-ubibot。
主机	如果您的UbiHTTP请求需要主机地址，请输入域名。例如，webapi.ubibot.cn。
内容	输入想包含在请求中的消息。如果出现以下字符，将被替换成具体字符值，例如:%%trigger_subject%% 后台构建的报警标题 eg: 预警提醒-编号为xxxx的设备(测试开关)已超出警戒范围 %%trigger_body%% 后台构建的报警消息完整内容 eg: 编号为xxxx的设备(测试开关)已超出预设定的警戒范围。 传感器:field1 (开关状态)，报警瞬间值：1。(规则名：智能开关开启)。 本条预警触发记录的ID是：2692595。您可以进入管理控制台进行查看。 %%trigger_field%% 对应field名字 eg: field1 (开关状态) %%channel_id%% 空间编号ID eg: xxxx %%name%% channel的名字 eg: 测试开关 %%trigger_type%% 触发类型，如果为recover则为恢复预警 仅恢复时返回 eg: recover %%sampled_at%% 数据采集时间 （返回时间戳） eg: 1603263103 %%rule_type%% 预警类型 （numeric-数据预警 | no_data_check-离线预警 | status_field-USB断电预警） eg: numeric %%rule_name%% 预警名称 eg: 智能开关开启 %%rule_condition%% 预警阈值 eg: 10 %%action_frequency%% (change_only-突变预警 | change_only_delayed-延迟突变预警 | always-持续预警 | always_delayed-延迟持续预警) eg: change_only %%frequency%% （当预警为延迟预警时所设置的延迟时间单位S） eg: 120 %%criteria%% 预警关系 eg： > %%trigger_id%% 预警ID eg: 2692622 %%trigger%% 预警瞬间值 eg： 1

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+的设备。建议通过轻松连官网下载中心进行下载并安装。