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

3、测试环境联调
3.1 新建支持直连方式的设备
3.1.1  新建单个设备
在【设备模块】下的【设备管理】点击 【新建】 按钮
﻿﻿
设备类型、设备序列号、设备名称、设备对接方式、设备传输协议 必须要填写。
注意:  连接方式 选择  设备直连
●其它的业务信息 所属区县、场所名称、场所业务代码等在测试平台无需输入,正式接入时则必须填写，只有更新了这些信息，泳池业务系统这边才能真正查看到相关数据。
●新建完成的设备状态为初始化,收到设备上传数据后自动变更为在线,无需手动修改
●传感器无需手动操作,有数据上传会自动新增出来
3.1.2 批量新建设备(功能升级中---)
在【设备模块】下的【设备管理】点击 【导入】 按钮 
﻿﻿
下载excel模板，格式如下：
﻿﻿
设备类型、设备序列号、设备名称、设备对接方式、设备传输协议 必须要填写。
其它的业务信息 所属区县、场所名称、场所业务代码等可以后面进行更新，只有更新了这些信息，泳池业务系统这边才能真正查看到相关数据。
点击上传，即可批量创建设备
﻿﻿
3.2 查看设备连接密码
在【设备管理】的列表项 【操作】 中，如果设备是【设备直连】类型的话， 点击 【查看连接配置】按钮
﻿﻿
查看直连的连接配置  下图是MQTT的例子：
﻿﻿
3.3 DTU配置数据对接（待补充）
根据连接配置 在DTU中配置相关访问参数：
下面是两种连接方式
3.3.1 MQTT
分为两步；第一步 MQTT连接，第二步 数据上传。
3.3.1.1 MQTT连接broker连接参数：
3
测试地址：iot.winhit.cn      端口号(tcp):1883
正式地址：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接入只需要一步操作，直接上传数据就可以。
测试地址：https://iot.winhit.cn:8081/api/v1/$ACCESS_TOKEN/telemetry
正式地址：https://zjyycs.winhit.cn:8081/api/v1/$ACCESS_TOKEN/telemetry﻿
token通过3.2的【查看连接配置】按钮查看。
﻿﻿
数据格式跟上面的3.3.1.2的格式保持一致。
3.3.3 CORP(暂未开放)
3
测试地址：iot.winhit.cn      端口号(tcp):5683
正式地址：zjyycs.winhit.cn   端口号(tcp):5683
数据上传url
2
coap://host/api/v1/$ACCESS_TOKEN/telemetry
accessToken通过3.2的【查看连接配置】按钮查看。
﻿﻿
数据格式跟上面的3.3.1.2的格式保持一致。
3.4 确认数据同步成功
通过数据平台登录账号的用户名和密码登录，查看设备对应的传感器数据是否已经存在，数据存在且正常，代表数据同步成功，测试环境联调通过。
在【设备模块】下【设备管理】中可以查看数据同步自动创建的设备列表,如图:

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

点击查看数据，输入起止时间 可以查看数据是否已经同步成功
﻿
﻿
四、正式环境数据对接
1 发起三方平台账号同步
通过数据平台测试环境手动同步平台账号到线上环境。如图:
﻿
2 接口地址改为正式环境地址
将DTU的连接地址从测试环境改为正式环境
3 创建设备泳池信息
登录数据平台正式环境 设备管理
﻿﻿
1.填写设备信息
2.填入场所信用代码并搜索,如果场所已录入会弹出场所信息,根据地区和场所地址选择对应的场所,
a.注意相同的信用代码可能会有多个场所,提示的场所中单位和地址均不符合要求时请关闭弹窗,手动录入场所信息
b.选中后会自动填充场所及泳池信息,核对下信息是否有误,有误可直接修改.
﻿﻿
如果没有找到对应的场所信息,则需要将详细信息录入
3.创建完成后则可开始数据接入
4.设备变为在线状态则已收到数据,点击右侧同步按钮可查询省平台接入状态
a.[信息需完善]  则可将数据放到 [接入状态] 上面,查看提示信息,将信息补充完整
b.[待审核] 可等待审核完成或联系对接方
c.已接入则表示省三色平台接入完成,泳池方可通过法人信息登录手机端网页查看泳池信息
﻿
4 确认数据同步成功
查看设备数据是否对接成功。操作页面跟测试环境保持一致。
5 正式环境日常维护
通过登录数据平台正式环境可查看平台所有的设备的数据的同步情况
六、 FAQ