文档中心

1.接入帮助

1.1 用户注册

在浏览器打开网址http://user.iiot.htdata.com/register,点击立即注册,选择企业用户,即可设置用户名、密码、企业名称等信息,通过手机短讯验证即注册成功。

1.2 创建设备

创建新设备

平台提供多种方式创建设备:

    1.手工产生设备,适用少量复杂设备的导入;

    2.EXCEL文件批量导入,适用于工厂中已有资料快速导入设备;

    3.通过设备模板批量创建新设备,需先创建设备模板,适用于大量相同设备类型的设备创建。

1 手工创建新设备

进入平台,点击左侧设备管理—设备列表,在右上角有按钮,点击此按扭:

填写设备名称、设备组、设备序列号、接入协议、设备图标、品牌、型号、设备描述、设备地址等内容,然后点设备增加测点(设备数据采集点)。

 

一个设备可以增加多个测点,点击新增测点可以增加不同的测点,数据流名称不能重复,数据流名称需与导入的数据表的对应列名一致,而测点名称表示当前数据流名称对应的中文含义。

 

增加完测点后,点击下一步可以增加这台设备的服务,服务是针对个每个测点数值进行判断后,平台可以通过短信、邮件告警。

输入相应的服务名称,关联测点,该关联测点的阈值范围,同时选择服务类型,勾选短信或邮件,或者两者全部选中,即可对关联测点进行监控。当关联测点大于或者小于您设定的阈值范围时,就会通过短信或邮件的方式提醒你。

增加完设备服务后,可以通过设备名称查看设备相关信息并修改。

 

2 通过设备模板批量创建

进入平台,点击左侧设备管理—设备模板,在右上角有创建模板按钮,点击此按扭可以创建一个设备模板,主要内容包括模板名称、设备组、序列号、接入协议、图标、品牌、型号、描述、省市等信息。

 

设备模板创建与设备创建过程是一致,同样有增加测试、增加服务等信息。

创建好模板后,可以通过模板名称查看模板的内容,可以修改基本信息、相关测点、相关服务、相关看板等信息。

要批量产生设备时,在设备模板右侧操作里点生成设备,填写好生成数量、设备名称前缀、后缀起始值后可一次性增加多台设备。

 

3 EXCEL文件批量导入

进入平台,点击左侧设备管理—设备列表,在右上角有导入模板下载、和导入设备按钮。

导入设备可以支持EXCEL文件批量导入设备功能,在以下模板文件中增加设备组、设备信息。

在填写好EXCEL后,点击设备管理—设备列表—导入设备:

EXCEL导入时为了保证设备有效性,需要选择一个设备模板,设备模板关联了测点、服务、看板等重要信息。

 

 

1.3 采集协议

1 MQTT采集接口

1.1 MQTT协议介绍

    MQTT(Message Queuing Telemetry Transport,消息队列遥测传输)是IBM开发的一个即时通讯协议,访问用户名、密码和topic由接入服务提供方提供。

    MQTT协议是为大量计算能力有限,且工作在低带宽、不可靠的网络的远程传感器和控制设备通讯而设计的协议,它具有以下主要的几项特性:使用发布/订阅消息模式,提供一对多的消息发布,解除应用程序耦合;对负载内容屏蔽的消息传输;使用 TCP/IP 提供网络连接;有三种消息发布服务质量:“至多一次”,消息发布完全依赖底层 TCP/IP 网络。会发生消息丢失或重复。这一级别可用于如下情况,环境传感器数据,丢失一次读记录无所谓,因为不久后还会有第二次发送。“至少一次”,确保消息到达,但消息重复可能会发生。

    “只有一次”,确保消息到达一次。这一级别可用于如下情况,在计费系统中,消息重复或丢失会导致不正确的结果。小型传输,开销很小(固定长度的头部是 2 字节),协议交换最小化,以降低网络流量;使用 Last Will 和 Testament 特性通知有关各方客户端异常中断的机制。

1.2 MQTT实时数据接口

功能描述:主要用于接入设备运行数据的实时采集。

接口地址:tcp://nginx.iiot.htdata.com:8888

支持格式:json

接口调用方式:mqtt协议

请求接口参数列表:   

名称

必填

类型

说明

dn

string

设备序列号

ts

long

时间毫秒值

(测点英文名称)

float

测点值

一条json数据传送的测点名称数量不超过1000个,参数示例:

{"ts":1491473503492, " dn":"ffaabbccddeeffab081223de","voltage":123.4,…}

 

返回字段说明:无

1.3 MQTT设备状态接口

功能描述:主要用于传输设备的运行状态。

接口地址:tcp://nginx.iiot.htdata.com:8888

支持格式:json

接口调用方式:mqtt协议

请求接口参数列表:   

名称

必填

类型

说明

dn

string

设备序列号

ts

long

时间毫秒值

status

int

状态编码(1000:运行;2000:待机;3000:故障;4000:离线)

参数示例:

{"ts":1491473503492, "dn":"ffaabbccddeeffab081223de","status":1000}

返回字段说明:无

2 RESTful采集接口

2.1 RESTful介绍

    RESTful web服务是REST 定义了一组体系架构原则,您可以根据这些原则设计以系统资源为中心的 Web 服务,包括使用不同语言编写的客户端如何通过 HTTP 处理和传输资源状态。 如果考虑使用它的 Web 服务的数量,REST 近年来已经成为最主要的 Web 服务设计模型。 事实上,REST 对 Web 的影响非常大,由于其使用相当方便,已经普遍地取代了基于 SOAP 和 WSDL 的接口设计。

    REST 这个概念于 2000 年由 Roy Fielding 在就读加州大学欧文分校期间在学术论文“Architectural Styles and the Design of Network-based Software Architectures”(请参见参考资料以获取此论文的链接)首次提出,他的论文中对使用 Web 服务作为分布式计算平台的一系列软件体系结构原则进行了分析,而其中提出的 REST 概念并没有获得现在这么多关注。 多年以后的今天,REST 的主要框架已经开始出现,但仍然在开发中,因为它已经被广泛接纳到各个平台中,例如通过 JSR-311 成为了 Java™ 6 不可或缺的部分。 ,其特点是(1)显式地使用 HTTP 方法。(2)无状态。(3)公开目录结构式的 URI。(4)传输 XML、JavaScript Object Notation (JSON),或同时传输这两者。

2.2 RESTful实时数据接口

功能描述:主要用于接入设备运行数据的实时采集。

接口地址:http://nginx.iiot.htdata.com:6666/iot/data_acquire

支持格式:application/json

请求方式:post

请求接口参数列表:   

名称

必填

类型

说明

iot

string

由服务提供方提供

accesskey

string

由服务提供方提供

equipment

string

设备序列号

data包含一个或多个数据内容,具体内容如下:

k

string

测点英文名称

v

float

测点值

t

long

时间毫秒值

参数示例:

{"iot":"xx","accesskey":"xxxxxx","equipment":"1",
"data":[{"k":"input-power","v":1.5,"t":1491448161000},
{"k":" output-power ","v":2.3,"t":1491448161000},
{"k":",a-power ","v":0.3,"t":1491448161000},
{"k":" b-power ","v":4.3,"t":1491448161000},
{"k":" c-power ","v":2,"t":1491448161000}]}

 

 返回字段说明

名称

类型

说明

HttpStatus

int

http状态码,其中状态码为200表示正常,其他为异常

 

2.3 RESTful设备状态接口

功能描述:主要用于传输设备的运行状态。

接口地址:http://nginx.iiot.htdata.com:6666/iot/ device_state_acquire

支持格式:application/json

请求方式:post

请求接口参数列表:   

名称

必填

类型

说明

iot

string

由服务提供方提供

accesskey

string

由服务提供方提供

data包含一个或多个数据内容,具体内容如下:

equipment

string

设备序列号

v

int

状态编码(1000:运行;2000:待机;3000:故障;4000:离线)

t

long

时间毫秒值

参数示例:{"iot":"xx","accesskey":"xxxxxx","data":[
{"equipment":"1","v":1000,"t":1491448161000},
{"equipment":"2","v":2000,"t":1491448161000},
{"equipment":"3","v":2000,"t":1491448161000},
{"equipment":"4","v":3000,"t":1491448161000}]} 

返回字段说明

名称

类型

说明

HttpStatus

int

http状态码,其中状态码为200表示正常,其他为异常

1.4 看板管理

设备采集数据上传后,用户可以通过看板等方式查看设备测点数据情况。用户可以登录平台,选择看板管理,然后点击右上角的新增看板,即进入看板设置界面:

    在看板设置里,用户可在左侧自由选择折线图、饼图、柱状图、仪表盘、地图等,在右侧可选择需要查看的设备测点即可观察当前设备的测点数据。

某水力集团水轮机看板

 

某新能源公司光伏逆变器看板

 

某家电企业商用空调看板

某制造工厂设备看板

 

2.开发文档

2.1 平台概述

1 平台概述

工业物联大数据平台作为工业大数据工具,主要提供以下八大功能:

1.具有工厂和设备资产的便捷管理:通过拖拉拽等操作轻松建立企业设备资产组织结构,实现企业数字化管理。

2.设备监控报警与故障诊断:为企业机器、设备组、零件、设施等提供设备/固件实时监控及故障诊断;

3.基于机器学习的设备预测性维护:通过机器学习实现智能故障预测,降低企业非计划性停机;

4.企业在线远程运维及生产托管:解决工业设备远程状态监控、设备维护、生命周期管理问题;

5.实现企业实现透明化生产、企业信息化升级及生产决策支持:大数据技术赋能工业制造生产、销售、研发过程,帮助企业信息化升级;

6.基于人工智能的全新系统交互模式:为客户提供全新的智能人机交互模式,帮助企业打造能听、能识的工业级应用;

7.开发者支持与社区开放平台:协作化的交流平台,帮助应用开发者快速地建立简单高效的大数据应用;

8.动态报表及大屏展示:通过数据可视化快速发现运营与产品问题,为企业决策提供数据支撑等功能,是最具客户价值的工业物联网平台。

 

工业物联大数据平台客户端对计算机硬件和软件要求:

CPU:1.5GHz以上CPU

内存:2G以上内存

硬盘:40G以上

操作系统环境:Windows 2000/XP/2003/2008/Vista/7/8/10

 

2 名词解释

1.测点:测点(observation point)指的是外业测量时被观测的目标点。

2.当前数据点数:数据点是指某个测点某个时间发送上来的一条数据,当前数据点数是指采集的数据总的条数。

3.当天数据点数:当日采集的数据的总的条数。

4.设备关联测点:是指设备包含的测点。

5.EDP协议:(Enhanced Device Protocol)是OneNET平台根据物联网特点专门定制的完全公开的基于TCP的长连接协议,提供设备接入、加密传输、数据存储等功能,协议的特点和功能包括:长连接协议,终端数据点上报,支持的数据点类型包括整型(int)/浮点数(float)/字符串(string)/JSON/二进制数据/平台数据下发/端到端数据转发。

6.Modbus协议:是应用于电子控制器上的一种通用工业标准协议。此协议支持传统的RS-232、RS-422、RS-485和以太网设备。典型工业设备包括 PLC、DTU等均使用Modbus协议作为它们之间的标准协议,协议的特点和功能包括:(1)长连接协议OneNET平台为Modbus主机(2)通过单条数据流的属性确定单条下发命令的内容以及周期(3)自动将终端上报的数据转化为数据流中的数据点。

7.MQTT协议:是一个面向物联网应用的即时通信协议,使用TCP/IP提供网络连接,能够对负载内容实现消息屏蔽传输,开销小,可以有效降低网络流量,协议的特点和功能包括:长连接协议;终端数据点上报,支持的数据点类型包括:整型(int)/浮点数(float)/字符串(string)/JSON格式/平台消息下发/基于Topic的订阅、发布以及消息推送,可以实现设备间的消息单播以及组播。

8.HTTP协议:即遵循RestFul原则接入平台,协议具有接入鉴权、控制命令下发、告警出发等功能,适合平台与平台之间数据对接,其特点和功能包括:短连接协议;终端数据点上报,支持的数据点类型包括:整型(int)/浮点数(float)/字符串(string)/JSON格式/二进制数据/平台侧相关资源管理。

9.JT/T808协议:定义了一个扩展协议JTEXT,可以让已经基于JT/T808协议传输数据的设备快速接入平台,协议的特点和功能包括:交通部定制的用于车辆动态监控的标准通信协议;设备和平台可以保持长连接,可及时检测设备的上/下线状态;标准的“位置信息汇报”等消息格式,方便已支持JT/T808协议的终端快速接入平台基于“上/下数据透传”模式,可以灵活上传用户自定义的数据,查询数据最新响应。

 

3 设备接入流程

     用户进行设备接入的主要流程如下:

 

2.2 用户管理

2.2.1用户注册登陆

2.2.1.1个人注册流程

在浏览器打开网址http://user.iiot.htdata.com/register,点击立即注册,选择个人用户,即可设置用户名和密码,通过手机短讯验证即注册成功。

2.2.1.2 企业注册流程

在浏览器打开网址http://user.iiot.htdata.com/register,点击立即注册,选择企业用户,即可设置用户名、密码、企业名称等信息,通过手机短讯验证即注册成功。

2.2.1.3 用户登录

在IE浏览器输入平台网址:http://user.iiot.htdata.com/login。选择右上角的登录按钮,输入用户名及登录密码,点击登录即可。

 

2.2.2  员工信息管理

2.2.2.1 员工管理信息

选择员工管理信息模块,即可展示当前员工用户状态。同时,点击也可以新建员工信息。操作界面如下:

 

 

2.2.2.2 员工管理信息修改

点击编辑按钮,即可对当前用户进行编写和修改。

 

2.2.2.3 员工信息删除

在员工信息管理页面点击删除按钮, 可以删除当前选中用户的相关信息,系统提示:您确认要删除该项数据。

2.2.2.4 修改登录密码

在员工信息管理页面点击密码修改按钮,即可修改当前选中用户的密码。密码修改界面如下:

2.2.3  企业信息管理

2.2.3.1 企业信息修改

点击按钮,可以对企业相关信息进行修改如下图。

2.2.3.2 联系人信息修改

点击企业信息管理可以对联系人进行修改,截图如下。

点击右下角按钮,可以对联系人信息进行修改如下图。

 

2.2.3.3 我的信息修改

点击我的信息模块,即可进入

点击,即可对这个信息进行修改

 

2.3 资源管理

2.3.1 资源管理

点击资源管理模块,即可进入资源管理模块面板

进入概况面板即可看到设备状态、测点状态、服务状态、看板状态、设备组状态、当前数据点、累计数据点,相关概念解释如下。

1.全厂设备种类占比:不同设备类型的占比,其值为该设备数/总设备数;

2.设备在线:当前在线设备数,在线比例=在线设备数/总设备数;

3.测点接入:当前接入测点数,占总测点数=当前接入测点数/总测点数;

4.当前数据点:今日累计数据点总数;

5.累计数据点:本租户在平台里总数据点数;

6.测点受控率:监控测点总数/总测点数;

7.看板使用率:有看板的设备数/总看板个数;

8.设备组使用率:有设备组的设备数/总设备数;

9.设备接入实况:当日设备增加个数曲线图、累计设备数曲线图;

 

2.3.2 设备管理

2.3.2.1 设备列表

2.3.2.1.1  展示设备信息

 

设备信息包括设备ID,设备名称,设备序列号,接入协议,关联测点数目,关联服务数,创建时间。

其中设备序列号是在创建设备时系统自动产生的,也可以修改。

接入协议是指设备通过什么协议接入系统:目前主要有MQTT协议、HTTP协议、ModBus。

2.3.2.1.2  修改设备信息

点击资源管理里面的“设备管理-设备列表-修改”,即可对设备信息进行编辑或修改。

 

 

2.3.2.1.3  修改设备相关测点

点击“设备管理-设备列表-修改-设备相关测点”,即可对设备相关测点进行编辑或修改。

2.3.2.1.4  修改设备相关服务

点击“设备管理-设备列表-修改-设备相关服务”,即可对设备相关服务进行编辑或修改。

2.3.2.1.5  修改设备相关看板

 

点击“设备管理-设备列表-修改-设备相关看板”,即可对设备相关看板进行编辑或修改。

2.3.2.1.6  删除设备

点击“设备管理-设备列表-删除”,即可删除该设备。

 

2.3.2.1.7  复制设备

点击“设备管理-设备列表-复制”,输入生成数量、名称前缀、后缀起始值,即可对设备进行复制。

2.3.2.1.8  查看设备报警

点击“设备管理-设备列表-查看报警”,即可查看该设备报警监控情况,截图如下。

 

2.3.3 设备组管理

2.3.3.1 查看设备组信息

点击资源管理-设备组管理即可看到当前ID、名称、描述、父组、创建时间、操作等字段参数。

 

2.3.3.2 修改设备组

点击资源管理-设置管理组即可看到当前ID、名称、描述、父组、创建时间、操作等字段参数。

点击资源管理里面的设备组管理,双击修改即可对组名称、父级组、组描述。

 

2.3.3.3 设备组关联设备

点击 “设备管理-设备组-关联设备”,点击“选择设备”,在下拉框中选择设备后单击,即可实现组设备关联。

 

2.3.3.4 删除设备组

点击 “设备管理-设备组-删除”即可删除当前模块组数据,同时系统会给出相应提出。

 

2.3.3.5 增加设备子组

点击 “设备管理-设备组-添加子组”,在提示框中输入组名称、组描述,选择上一级的父级组,即可实现添加子组。

 

2.3.3.6 查看设备组看板

点击 “设备管理-设备组-设备组看板”,可查看该租户下全部设备组情况,可隐藏、显示关联的设备,还可以选择某个设备组查看“组信息”、“添加子组”、“关联设备”等操作。

 

2.3.4  设备模板管理

2.3.4.1 查看设备模板

点击资源管理-设备模块管理即可看到当前模版ID、模版名称、接入协议、关联测点数据、关联服务数、创建时间、操作等字段参数。

 

2.3.4.2 修改设备模板

点击资源管理-设备模块管理点击修改即可修改里面的信息、相关测点、相关服务、相关看板、关联设备等信息。

2.3.4.3 删除设备模板

点击“设备管理-设备模板-删除”,即可删除当前模块组数据,系统给出相应提示。

 

2.3.4.4 批量生成设备

点击“设备管理-设备模板-生成设备”,输入生成设备个数即可。

 

 

 

2.4 服务管理及可视化

2.4.1  我的服务

2.4.1.1 查看服务

点击“我的服务-服务列表”,即可看到当前服务ID、服务名称、关联测点、服务类型、手机号、邮箱、创建时间等字段参数。

 

2.4.1.2 修改服务

点击“我的服务-服务列表-修改”,即可修改当前服务名称、选择关联测点、编辑服务阈值和服务类型信息。

 

2.4.1.3 删除服务

点击“我的服务-服务列表-删除”,即可删除当前该条服务信息。

 

2.4.2   我的看板

2.4.2.1 查看看板

点击“我的看板-看板列表”,即可看到当前CNC加工中心、高温保护检测、空调、成都设备温度等设备看板。

 

2.4.2.2 设置看板

点击“我的看板-看板列表-设置”,在看板管理提示框中可编辑或修改看板名称和概述。

 

2.4.2.3 修改看板

点击“我的看板-看板列表-修改”,可对看板里的模版、背景颜色、图层导航、尺寸、相对位置、文本、图片、折线图、柱状图、仪盘表、地图、开关、旋钮的属性进行编辑、修改或删除。。

 

2.4.2.4 删除看板

点击资源管理-看板管理点击删除即可删除模块组。

 

2.4.3   云监控

2.4.3.1 监控概况

 

  点击“云监控-监控概况”,即可看到设备的监控概览,如当前监控设备数、测点数、服务数、数据点数、平台报警数、今日报警数、解除报警数、故障设备数等信息。

 

2.4.3.2 设备监控

点击“云监控-设备监控”,即可看到监控日志列表,如当前设备ID、设备名称、状态、通知方式、email、mobile、操作和平台报警等字段信息。

 

2.4.3.3 设备监控图表

点击“云监控-设备监控-查看设备详情-监控图表”,即可查看设备所有测点的监控详情,可视化图表显示。还可以设置监控的始末时间段筛选查看,如1小时、12小时、1天、7天、30天和自定义时间段。此外,还可以切换图片布局方便查看数据。

 

2.4.3.2.4 设备报警历史

 

点击“云监控-设备监控-查看设备详情-报警历史”,即可查看设备所有测点的监控详情,列表显示,如当前设备ID、设备名称、测点名称、数据点名称、测点值、手机号、邮箱、报警时间、设备状态等字段信息。

3.资源文档

3.1 用户操作指南

请下载文档查看。

3.2 设备接入指南

请下载文档查看。

 

3.3 C++ SDK

敬请期待...

3.4 JAVA SDK

敬请期待...

0851-8899887
二维码
二维码