继电器NR1服务支持 - 温湿度传感器-温湿度记录仪-温湿度表-温湿度报警器-轻松连

可以创建哪些预警类型？

轻松连云平台提供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。

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

如何使用通用传感器

接收/应答帧

外接传感器音频线线序如下图。

通用传感器设置 打开【数据工厂】→【通用传感器接入助手】→【新增】，参考待接传感器通讯协议，分别填写传感器名称、波特率、地址、功能码及传感器相关信息等，也可以粘贴指令串后自动解析。

设置完成后，打开【数据仓库】，进入设备页面，点击【设置】→【设备及传感器设置】，下拉至通用传感器，点击【编辑】后下拉选择相应传感器并设置采集周期即可。

点击【传感器显示设置】，在对应field点击编辑，下拉选择传感器设置的传感器数据名称。

点击如图单位，下拉选择对应数据单位或选择“外接电流转RS485转换器”自定义单位。

示例如外接水质氨氮传感器，探头地址为0x05，波特率4800bit/s，支持功能码03，通讯协议及寄存器地址如下表。 问询帧

地址码	功能码	寄存器地址	寄存器长度	CRC校验码低字节	CRC校验码高字节
1字节	1字节	2字节	2字节	1字节	1字节

应答帧

地址码	功能码	有效字节数	数据区1	数据区2	...	数据区n	CRC校验码低字节	CRC校验码高字节
1字节	1字节	1字节	1字节	1字节	...	1字节	1字节	1字节

寄存器地址

寄存器地址	支持功能码	数据类型	说明
0000H	0x03	16 位无符号整数	氨氮浓度值（实际值的10倍）
0001H	0x03	16 位无符号整数	PH 值（实际值的10倍）
0002H	0x03	16 位有符号整数	温度（实际值的10倍）

新增通用传感器设置内容如下。

如何进行数据导入导出

进行数据导入导出操作，需要登录【轻松连】管理控制台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表格进行编辑。

钉钉群预警消息设置

通过使用UbiHTTP，可以实现将预警消息推送至钉钉群内。钉钉机器人相关连接： https://ding-doc.dingtalk.com/doc#/serverapi2/krgddi UbiHTTP交互服务相关连接： https://www.ubibot.cn/platform-api/2960/http-interaction/ 操作教程：一、在钉钉中选择“机器人管理”，并选择“自定义” 机器人管理1

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

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

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

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

五、选择设备，在报警方式中选择设置好的UbiHTTP。机器人管理10

六、预警触发时，预警消息将会推送至钉钉群内。机器人管理11

HTTP交互服务

功能描述

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地址？

以下方式可以进行MAC地址查询： 1.打开网址https://www.ubibot.cn/进入轻松连主页，点击“管理控制台”；

2.进入管理控制台登录页面根据提示输入“邮箱/手机号/用户名”及“密码”，点击登录；

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

轻松连PC工具常见问题解答

1.如何下载PC工具？ PC工具下载地址 2.安装完成PC工具后无法扫描到USB 请将设备开机并使用设备配套USB数据线（WS1 使用Micro-USB接口，WS1Pro设备使用侧面第一个靠上的Micro-USB接口）；请检查电脑的USB端口是否被占用；如果仍然无法扫描到设备USB，请重启设备。 3.WiFi配置失败，弹出对话框Error 506? 输入的WiFi账号或密码有误，WiFi不可用或信号太弱。按照操作说明，检查输入的WiFi账号和密码是否有误，检查WiFi是否可用，尽量将设备靠近路由器方向。 4.读取设备图表时，弹出Error907报错？ 设备插入USB但未被唤醒，可参照以下步骤操作：点按电源键唤醒设备；将设备USB拔出后重新插入电脑，让设备进入USB模式；若仍旧报错，请将设备关机重启。 5.设备激活时以及入网配置时，出现设备报错Error904? 说明USB连接超时，请按照说明进行操作：请重新插入USB数据线，使设备进入USB模式；请确认电脑USB端口是否被占用；请尝试重启设备。 6.加载成功的离线数据图表，为什么会有很多数据在一条竖线上或是只有中间一个数据点的情况？ 设备在很长一段时间内没有离线就会出现很长的时间间隔，比如在2017年有一次离线数据，第二次离线数据在2019年，就会出现数据都在一条竖线的情况，可以考虑将设备数据清除后再测试设备。设备离线数据只有一个点的情况也是正常的，说明设备只离线一下之后都在线。离线使用时间较远.png

7.设备离线数据图表的Field代表什么？ 不同设备的Field代表参数不同，具体参考如下：

数据转发服务

功能描述

此服务功能开通后，设备每次上传到轻松连大数据平台的空间数据（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的数据仓库页面内中找到分享的设备

下载APP之后无法安装

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

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

产品中心	解决方案	技术支持	关于我们	购买渠道
智能感知设备	农牧业	下载中心	品牌简介	线上商城
智能控制设备	机房工厂	技术文档	企业荣誉	线上渠道
智能视频设备	医疗能源	常见问题	新闻中心	项目合作
LoRa通讯设备	机械制造	视频中心	联系我们	招商代表
工业互联网平台	食品监测	管理控制台	行业资讯
外接传感器	科研院校	轻松连代理商	轻松连社区
产品配件
多维厘米级定位系统
计费方式

产品中心	解决方案
智能感知设备	农牧业
智能控制设备	机房工厂
智能视频设备	医疗能源
LoRa通讯设备	机械制造
工业互联网平台	食品监测
外接传感器	科研院校
产品配件
多维厘米级定位系统
计费方式

技术支持	关于我们
下载中心	品牌简介
技术文档	企业荣誉
常见问题	新闻中心
视频中心	联系我们
管理控制台	行业资讯
轻松连代理商	轻松连社区

设备连接

2.探头使用

3.探头设置

1. 数据导出

2. 数据导入

功能描述

创建一个UbiHTTP请求

触发UbiHTTP

功能描述

开通方式

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

转发数据格式及结构

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

第三方服务器端实例

一.使用APP分享

二.使用网页平台分享

轻松连公众平台

轻松连公众平台