此系列设备在无网络情况下，数据将存储在设备内部，若需要查看实时数据，可参考以下两种方法：

①在无网络环境下监测完成之后，可将设备拿回至所配置过的网络环境下，单击按键自动上传数据。

②在无WiFi情况下，设备也可通过数据线与电脑连接，利用PC端工具可将数据导出。

自动化管理可快速实现设备之间的联动，当触发设备达到预先设定的触发条件时，执行设备将自动触发操作。

1.点击【数据工厂】-【自动化管理】，进入自动化管理页面。点击【创建自动化】。

2.选择触发设备，并设置触发条件。

3. 选择执行设备及动作。执行设备仅支持智能开关SP1、网络继电器NR1等智能控制设备，最多可同时设置5个执行设备。

4. 确认已设置的自动化规则并保存。

5. 设置成功。

为满足更多RS485类探头的接入需求，轻松连推出通用探头功能，可根据探头通讯协议自行设置并选用，目前仅支持GS1系列v2.0.7及以上固件。使用前请先确认待接探头供电电压，若设备RS485接口输出电压不满足，需对探头单独供电。使用前，请先确认探头通讯协议是否满足以下格式。

发送/问询帧

接收/应答帧

外接探头音频线线序如下图。

通用探头设置

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

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

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

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

示例

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

问询帧

应答帧

寄存器地址

新增探头设置内容如下。

1. 1. 正确连接烟感报警器：烟感报警器需要连接在GS1设备的白色外接音频接口上，GS1需要外接12V适配器，烟感报警器才可以正常工作。

1. 1. 激活添加设备：可以登陆“轻松连”官网www.ubibot.cn或者关注“轻松连”抖音官方账号或微信视频号，查看GS1激活教程视频。
   2. 烟感设置：
      浏览中输入网址https://console.ubibot.cn/进入“轻松连”管理控制台，输入您“轻松连”的账号密码进行登录，点击要设置的设备，进入设备数据空间。

在配置页面中，点击“设置”进入页签，再点击“传感器显示设置”进入对应页签。

烟感采集与CO₂采集绑定，平台需开启CO₂的采集并设置CO₂的field，烟感为CO₂的field-1。如CO₂为field10，则烟感为field9。先将field10传感器替换为“二氧化碳-C1”

再将field9名称和单位变更为“烟感”


点击进入“设备及传感器设置”页签，开启并设置CO₂外接探头的采集时间，采集时间和烟感报警器绑定。

完成以上操作后，设备自动上传数据后，设置生效。

1. 1. 设置烟感报警规则：
      烟感报警器的报警规则与其他规则设置原理相同，可以在手机APP或网页控制端内进行设置。
      在手机APP中，点击设备进入设备配置界面，点击规则页签，点击+号增加自定义规则

选择“创建数据预警”，填写自定义规则名称、预警数据选择“烟感”、预警条件选择“＞”、预警范围选择0，预警类型可根据描述与使用场景自行选择。

点击下一步，选择报警推送方式，例如APP推送，邮件推送等

最后，点击完成，设备下次自动上传数据成功后，设置会生效。
当烟感检测到烟雾时，烟感报警器会自动蜂鸣报警，同时采集的数据会从0变为1，从而触发平台预警，进而产生APP等推送。
注意：由于平台设置的报警指令需要数据上传后，平台才会对数据判断从而触发预警；相比烟感报警器蜂鸣，消息推送会有一定的延迟，延迟时间与数据同步周期相关。
数据同步周期可以在手机APP或网页控制端设备配置中的“设置”界面内进行设置，最短为1分钟。

网页端设置烟感报警器预警，需要在设备配置中的“预警规则”页签中设置，设置方法与原理与APP内相同，方法请参考上文。

1. 1. 正确连接氨气、硫化氢传感器：氨气、硫化氢传感器，须连接到GS1白色外置音频接口，可以使用一拖二音频线来同时接入氨气、硫化氢传感器。若有其他RS485传感器，需要连接到黑色外置音频接口，例如CO₂传感器。
      需注意：使用硫化氢或者氨气传感器，需要配合包装内自带的DC12V适配器给设备进行供电。

1. 1. 添加并激活设备：可以在“轻松连”官网ubibot.cn或者通过关注“轻松连”抖音官方账号或微信视频账号，查找GS1激活教程的相关视频。
   2. 设置氨气、硫化氢传感器：在PC端游览器中输入网址：https://console.ubibot.cn/进入管理控制台，输入您的“轻松连”账号与密码进行登录，选择要设置的设备，点击进入该设备的数据空间

进入该配置界面中的“设置”页签，再进入“传感器显示设置”页签

在“传感器显示设置”页面中，需要选择连续三个闲置的field来对氨气、硫化氢传感器进行设置；例如图片中选择field7、field8、field9这三个闲置field。

由于氨气、硫化氢传感器与CO₂传感器的采样率绑定，因此需首先将field9设置为二氧化碳，field8更改名字与单位为硫化氢，field7更改名字与单位为氨气。三者field必须按照氨气→硫化氢→二氧化碳的顺序来排列。示例如下：
①首先在field9中点击“编辑”，“选择外接探头”选择“二氧化碳-C1”并保存。
②在field8中点击单位图标，选择“硫化氢（ppm）”并“确认设置”，在field7中点击单位图标，选择“氨气（ppm）”并“确认设置”。
③再点击编辑，修改它们的名称，field8为硫化氢，field7为氨气，“选择外接探头”此处不需要变动，直接点击保存。

1. 1. 开启氨气、硫化氢的采集时间：由于氨气、硫化氢传感器与CO₂传感器采集时间绑定的，因此需要在【设置】-【设备及传感器设置】界面开启CO₂传感器的采集时间，氨气、硫化氢传感器的采集时间与CO₂外接探头采集时间间隔同步。

1. 1. 查看数据：设置完成后，设备自动上传数据，设备两个数据同步周期后，可以在浏览器端或者APP内查看到氨气、硫化氢传感器采集的数值；也可以手动按一次设备开关键，进行手动数据上传，上传成功两次后，可以在APP内或者浏览器端查看实时数据。

1.设备连接

将土壤氮磷钾探头接入GS1/SP1系列设备的RS485音频接口，如图为GS1设备与氮磷钾探头连接。

2.探头使用

方法一，快速测量：选定合适的测量地点，避开石块，确保钢针不会碰到坚硬的物体，按照所需测量深度抛开表层土，保持下面土壤原有的松紧程度，紧握传感器垂直插入土壤，插入时不可左右晃动。

方法二，连续测量：垂直挖直径>20cm 的坑，在既定的深度将传感器钢针水平插入坑壁，将坑填埋严实，稳 定一段时间后(大约30-60min)，即可进行连续数天，数月乃至更长时间的测量和记录。

注意事项：

①测量时钢针必须全部插入土壤里。
②避免强烈阳光直接照射到传感器上而导致温度过高。野外使用注意防雷击。
③勿暴力折弯钢针，勿用力拉拽传感器引出线，勿摔打或猛烈撞击传感器。

3.设备激活

使用轻松连App激活设备，详细操作可以关注“轻松连”抖音官方视频号或者微信视频号查看对应的激活方法。

4.探头设置

①登录控制台console.ubibot.cn，在网页端进行相关设置。进入平台，点击设备进入设备界面，如图所示。

②点击设置，进入设备设置界面，并点击传感器显示设置。

③在自定义传感器中，分别将field7、field8、field9名称修改为氮磷钾，即field7为氮，field8为磷，field9为钾。

④修改单位。点击单位图标，选择氮磷钾。

⑤完成上述设置后，点击设备与传感器设置，开启外接RS485土壤温湿度，设置采集间隔时间，氮磷钾探头使用土壤探头开关来控制采集时间。

⑥系统中完成设置后，可以点击设备开关键，完成两次上传后即可收到氮磷钾的相关数值，或等待2个上传周期后生效。

注意：field7、8、9默认设定为RS485温度、RS485湿度、RS485土壤温度，若设备同时连接氮磷钾探头及上述3种探头中的某一种，则需要在设置氮磷钾前将占用的探头提前移除，使用其他未接入的传感器替换，如风速传感器。

1. 1. 设备连接

正确连接土壤探头与设备，土壤探头接口分为Micro USB接口和音频接口两种，Micro USB接口可连接WS1 Pro/WS1 Pro-L设备，需接入EXT2接口（即设备右侧下方的Micro USB接口），如图所示。

音频接口连接GS1。、SP1等支持音频接口的设备，如图所示。

2.探头使用

方法一，快速测量：选定合适的测量地点，避开石块，确保钢针不会碰到坚硬的物体，按照所需测量深度抛开表层土，保持下面土壤原有的松紧程度，紧握传感器垂直插入土壤，插入时不可左右晃动。

方法二，连续测量：垂直挖直径>20cm 的坑，在既定的深度将传感器钢针水平插入坑壁，将坑填埋严实，稳定一段时间后(大约30-60min)，即可进行连续数天，数月乃至更长时间的测量和记录。

注意事项：① 测量时钢针必须全部插入土壤里。
② 避免强烈阳光直接照射到传感器上而导致温度过高。野外使用注意防雷击。
③ 勿暴力折弯钢针，勿用力拉拽传感器引出线，勿摔打或猛烈撞击传感器。

设备激活

使用轻松连App激活设备，详细操作可以关注“轻松连”抖音官方视频号或者微信视频号查看对应的激活方法。

3.探头设置

① 在App端或网页端开启土壤探头的采集频率。
App端开启方法：
选择设备，进入设备配置界面

点击“设置”页面找到外接RS485土壤温湿度，设置采集时间间隔。

②　完成以上设置后，可以点击设备开关键，完成两次上传后即可收到相关数值，或等待2个上传周期后生效。
网页端开启方法：
①　登录控制台console.ubibot.cn，点击进入设备数据空间，点击【设置】-【设备及传感器设置】，开启外接RS485土壤温湿度并设置采集时间。

一、声光报警器连接方式

二、功能设置

1. APP设置

(1)打开轻松连APP，选择需要设置报警的设备，进入预警设置界面。请确保设备已经配置好网络并正常连接。

(2)以数据预警为例，离线预警和USB断电预警皆可以设置声光报警器报警。

(3)填写预警名称、预警数据、预警条件、预警范围以及预警类型，并点击下一步。

(4)预警方式选择设备报警，打开对应的开关。

(5)进入设备报警设置界面，确认好对应的温湿度记录仪设备，选择声光报警，可以选择10秒、30秒、60秒的报警时长。

(6)点击完成，即可看到添加预警规则。

1. 
2. 平台设置

(1)进入要设置的设备界面内，选择预警规则，选择对应的预警类型。

(2)创建新的预警规则，填写相应信息，报警方式选择“设备报警”。

(3)回到主界面即可看到新添加的预警。

以上为声光报警器设置与连接方式。同时也可以实现多设备联动报警，即选择其他设备设置预警，触发报警的设备为连接声光报警器的设备。

在您开始使用外接探头前，需在平台进行设置（https://console.ubibot.cn）

1.选择您所搭配外接探头使用的设备，进入设置页面

2.选择传感器显示设置。

3.在field7-10中选择一个点击编辑（注：field 1-6为内置传感器，field 7-10为外接传感器）。

4.在下拉菜单中选择您所接入的外接探头（此处以二氧化碳探头为例），然后点击保存。

5.点击“设备及传感器设置”，在这里可以设置外接探头的数据上传频率。

GS1-AETH1RS版设备，网线接口暂时不支持直接PoE供电；如果想通过PoE交换机为设备供电，需要使用PoE电源分离器。

*PoE电源分离器需单独采购。

①网线正确接入设备。

②打开APP，点击【新设备】，扫描设备正面的二维码。

③选择入网模式，根据APP提示操作。

④激活成功后，设备会发出语音提示，屏幕会显示网线接入标志，并且屏幕上无错误代码；同时在APP或平台内可以查看设备实时数据。

*若激活失败，请确认以下几点：1、网线是否正确接入设备；2、网线是否完好；3、所连接网络能否访问互联网；4、设备电量是否充足。如果以上几点皆无异常，且依然无法激活设备，需检查网络环境是否允许DHCP（自动分配IP）设备接入网络；或者重新扫描设备二维码，入网方式选择以太网入网（手动），按照APP提示操作，手动分配IP给设备。

设备屏幕显示的温度值单位默认为摄氏度，双击电源键可实现摄氏度与华氏度的切换。

可能原因：

①手中把握设备时间太长

②配置时间过长，CPU工作温度高

③发送时间设置过于频繁，会导致温度高出0.2-0.3℃

解决方法:

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

轻松连最新设备光照传感器测量范围为：0.01-157000 lux（主要针对可见光波段），精度可达±10%。使用时请将设备放置于需测量光照环境集中并无遮挡处，避免影响测量数据准确性，若测量范围光照不平均，用户可置放多个轻松连标签以保证您的数据准确和充足。

此系列设备在无网络情况下，数据将存储在设备内部，若需要查看实时数据，可参考以下两种方法：

①在无网络环境下监测完成之后，可将设备拿回至所配置过的网络环境下，单击按键自动上传数据。

②在无WiFi情况下，设备也可通过数据线与电脑连接，利用PC端工具可将数据导出。

① GS1设备正确接入探头后，通过平台或APP设置相应的采集周期，即可以自动监测环境数据；

② 探头接入后，按菜单键一次，设备屏幕会切换显示至接入探头检测到的数据，同时采集一次数据；若同时接入多个探头，每按一次菜单键，屏幕会切换一次，同时进行一次采集。不同传感器采集的数据，在当前屏幕上会有不同的标识提醒。每次按键切换完成后，将在左上角显示外接探头数量。

T/H:内置温湿度传感器

E-T/H：外接温湿度传感器*

S-T/H：土壤温湿度传感器*

E-T：外接温度传感器*

LIGHT：照度传感器*

WS：风速传感器*

CO2：二氧化碳传感器*

PH：PH值传感器*

注1、图内标记“*”的传感器为选购；

注2、屏幕显示时，在相应字母标识下，会有“━”提示此时屏幕上显示的何种传感器监测到的数据；

注3、屏幕上更多详细内容与功能请参考说明书。

③ 探头接入后，按开关键一次，设备会将所有传感器采集的数据发送至云平台，登陆APP或官方平台可进行查看；在APP内，查看设备空间数据时，可点击页面右方页签切换显示不同传感器的数据图表。

发送数据时红色指示灯闪烁，为设备网络连接异常，请确认以下内容：

① WiFi名称及密码是否正确；

② 设备恢复出厂设置后重新配置设备。

报警方式有六种，可自定义设置：微信报警推送、APP报警推送、手机短信报警、语音电话报警、HTTP交互报警、邮件报警推送。

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

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

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

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

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

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

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

为满足更多RS485类探头的接入需求，轻松连推出通用探头功能，可根据探头通讯协议自行设置并选用，目前仅支持GS1系列v2.0.7及以上固件。使用前请先确认待接探头供电电压，若设备RS485接口输出电压不满足，需对探头单独供电。使用前，请先确认探头通讯协议是否满足以下格式。

发送/问询帧

接收/应答帧

外接探头音频线线序如下图。

通用探头设置

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

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

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

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

示例

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

问询帧

应答帧

寄存器地址

新增探头设置内容如下。

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

生活中停电或者空气开关跳闸这种情况时有发生，而且还会带来不小的影响。比如冷冻冷藏产业如果空开跳闸没有及时处理，那么所有冰柜内的物品都有可能变质，所以如果电源断电能有预警消息，就可以有效避免财产损失。

为此，轻松连推出了USB断电预警功能，设备的USB供电电源直接接在220V电源适配器上（也可以直接接在USB插排上），设备在USB和电池同时供电时，若USB掉电，即可接收到USB断电预警推送消息，也就代表发生了停电或跳闸等情况。

一、USB断电预警使用前提：

轻松连系列设备使用USB和电池同时供电。当设备USB线断开，设备开始使用电池供电，当设备反馈数据给平台后，平台推送预警消息给客户端，提示USB断电。

二、USB断电预警使用方法：

1）点击“设备预警规则”——“创建USB断电预警”——填写预警名称，选择预警类型，预警推送方式等参数——单击“确定“，完成预警规则建立。

2）预警类型可选择突变预警，也可以选择持续预警。

突变预警即设备满足预警条件时，平台会向客户端发送一次预警消息。

持续预警即设备满足预警条件时，平台会持续向客户端推送预警消息。

为避免频繁预警及耗电量过大，每个预警规则每小时最多发送5条预警消息。建议用户在接收到预警推送消息后，及时处理，恢复USB供电或关闭此预警规则即可。

3) 报警方式有多种选择，如APP报警推送、电子邮件报警、微信报警推送、手机短信报警、语音电话报警、HTTP交互报警、设备报警六种报警推送方式。

需要注意的是，选择微信预警推送时，需扫描二维码，关注轻松连公众号，绑定账户。

4）APP推送的预警消息可以在“管理控制台——消息中心”查看，如下图所示，微信预警消息可在“轻松连”微信公众号中查看。

5）设备触发记录可在“平台——触发记录”中查看，图标显示红色，说明未发送成功，常见于持续预警，预警次数过多，平台自动拦截，避免频繁向客户端发送。图标显示蓝色，说明预警发送成功。

温馨提示：目前USB断电预警仅支持网页端设置，APP的USB断电预警功能，敬请期待…

功能描述

此服务功能开通后，设备每次上传到轻松连大数据平台的空间数据（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+的设备。建议通过轻松连官网下载中心进行下载并安装。