设备直连流程
1、 设备直连对接流程概述
对接完整流程图
如下：
﻿﻿
﻿
下面是对接步骤：
1.申请三方平台账号
a.注册平台账号
b.审批通过收到账号信息
c.登录测试环境 查看设备列表
2.数据上传调试
a.新建支持直连方式的设备
b.查看设备的连接密码
c.DTU配置数据对接
d.确认数据同步成功
3.通过微信或其他渠道确认设备接入（设备和泳池相绑定）
2、申请三方平台账号
2.1 申请方式
通过数据平台的网址点我直达申请三方平台账号。如图：
﻿
2.2 注册平台
填写三方平台名称、联系人姓名、联系电话。 如图：
﻿
2.3 审批通过后，注册手机号可以收到短信(包含以下信息)：
数据平台的登录用户名/密码
2.4 查看设备列表
通过短信中的用户名和密码登录数据平台 点我直达。
在【设备模块】的【设备管理】下面 管理设备  如图:
﻿﻿

3、数据上传调试
3.1 新建支持直连方式的设备
3.1.1  新建单个设备
在【设备模块】下的【设备管理】点击 【新建】 按钮
﻿﻿
设备类型、设备序列号、设备名称、设备对接方式、设备传输协议 必须要填写。
注意:  连接方式 选择  设备直连
﻿
1.填写设备信息
2.填入场所信用代码并搜索,如果场所已录入会弹出场所信息,根据地区和场所地址选择对应的场所,
a.注意相同的信用代码可能会有多个场所,提示的场所中单位和地址均不符合要求时请关闭弹窗,手动录入场所信息
b.选中后会自动填充场所及泳池信息,核对下信息是否有误,有误可直接修改，一般首次对接的 场所营业时间 和 泳池大小数据需要调整确认
﻿﻿
如果没有找到对应的场所信息,则需要将详细信息录入
3.创建完成后则可开始数据接入
●新建完成的设备状态为初始化,收到设备上传数据后自动变更为在线,无需手动修改
●传感器无需手动操作,有数据上传会自动新增出来
3.2 查看设备连接密码
在【设备管理】的列表项 【操作】 中，如果设备是【设备直连】类型的话， 点击 【查看连接配置】按钮
﻿﻿
查看直连的连接配置  下图是MQTT的例子：
﻿﻿
3.3 DTU配置数据对接
根据连接配置 在DTU中配置相关访问参数：
下面是两种连接方式
3.3.1 MQTT
分为两步；第一步 MQTT连接，第二步 数据上传。
3.3.1.1 MQTT连接broker连接参数：
2
正式地址：zjyycs.winhit.cn   端口号(tcp):1883
username、password、clientId则通过直连设备查看mqtt参数
﻿﻿
连接状态码说明：
4
0x00 连接成功 - 成功连接
0x04 连接失败 - 用户名或密码错误。
0x05 连接未授权 - -用户名包含无效的 $ACCESS_TOKEN。
3.3.1.2 数据上传publish消息发送到下面主题:
2
v1/devices/me/telemetry
消息格式：JSON结构，不同设备类型的例子如下：
新水补充：
分为 正向累计，反向累计和实际累计
支持反向累计的水表可以传这个三个参数，只有累计数据的水表，可只传输正向累计和实际累计，两个取值都取水表中的累计值
6
{
	"ZXLJ":1.01,
  "FXLJ":1.02,
  "SJLJ":1.03
 }
泳池水质监测：
8
{
	"PH": 7.6,
	"WD": 28, 
	"YL": 0.03, 
	"ZD": 0.3, 
	"ORP": 600
}
浸脚池水质监测：
4
{
	"YL":0.03
}
客流监测：
5
{
	"ENTRY":1,
  "LEAVE":1
}
控烟传感器：
5
{
	"ALARM":1,
  "HEART_BEAT":1
}
下表是不同设备类型对应的传感器字段
设备类型
传感器类型
传感器code
值（单位)
新水补充
正向累计
ZXLJ
立方米
反向累计
FXLJ
立方米
实际累计
SJLJ
立方米
泳池水质监测
PH
PH
无
ORP （水溶液氧化还原能力）
ORP
mv
浑浊度
ZD
NTU
温度
WD
摄氏度
余氯
YL
mg/L
客流监测
进入
ENTRY
人数
离开
LEAVE
人数
控烟传感器
警告
ALARM
无
心跳
HEART_BEAT
无
浸脚池水质监测
余氯
FTYL
mg/L
3.3.2 HTTP
http接入只需要一步操作，直接上传数据就可以。
上传url：https://zjyycs.winhit.cn:8081/api/v1/$ACCESS_TOKEN/telemetry﻿
token通过3.2的【查看连接配置】按钮查看。
﻿﻿
数据格式跟上面的3.3.1.2的格式保持一致。
3.4 确认数据同步成功
通过数据平台登录账号的用户名和密码登录，查看设备对应的传感器数据是否已经存在，数据存在且正常，代表数据上传成功
设备变为在线状态则已收到数据,点击右侧同步按钮可查询省平台接入状态（接入状态更新较慢，可联系对接人确认）
a.[信息需完善]  则可将数据放到 [接入状态] 上面,查看提示信息,将信息补充完整
b.[待审核] 可等待审核完成或联系对接方
c.已接入则表示省三色平台接入完成,泳池方可通过法人信息登录手机端网页查看泳池信息
下方使用文档可直接发给客户：
﻿https://www.yuque.com/yanfengjie/wrodd4/yxs05lcqz7glcbe6?singleDoc# 《畅心泳-场所端-常见问题》
在【设备模块】下【设备管理】中可以查看数据同步自动创建的设备列表,如图:

点击传感器 可以查询 此设备下的传感器,如图：

点击查看数据，输入起止时间 可以查看数据是否已经同步成功
﻿
﻿