应用开发指南

平台特性

筑联物联网智能平台,以下简称筑联平台或平台,定位于工业级物联网云平台。通过筑联平台,设备开发者能够轻松安全的连接设备,应用开发者可以快速开发物联网应用,通过基于云服务实现海量扩展,具备强大的设备连接和数据处理能力。结合分布式NoSQL数据库,时间序列分析引擎,可以为企业提供对实体世界的洞察,帮助企业实现创新和转型。

平台的主要特性包括:

简化工业联网设备的开发

工业设备数字化,在线化,智能化是大势所趋,通过可扩展的开放物联平台,可以从小规模起步,然后迅速扩展。

加速物联网解决方案交付

物联网解决方案交付复杂,涉及多方,多应用,多系统,并且从硬件,联网,网关,云端到设备端,
在成熟架构,预集成的技术平台上开发,可以大幅度缩短方案交付时间。

保障工业环境的安全可靠

全链路高强度加密,基于单设备的认证和访问控制,基于角色的用户权限,数据加密存储

平台架构

images/dev_flow

终端和接入

采集的信息通过现场网络与云端连接,可选用的组网技术包括:工业WiFi/ZigBee网络,2G/3G/4G运营商网络,LoRa或NB-IoT等低功耗广域网络等等。

平台提供设备开发套件(SDK),置入此SDK的设备能够实现与云端的双向数据连接,即云端能够采集设备端的数据,指令和消息也可以通过云端下发到设备端,实现对设备的远程控制和管理。

对于已经联网的设备,可通过部署在云端的应用网关,进行协议转换后接入物联网智能平台。

设备网关

设备网关系统提供三种模式设备接入到物联网智能平台的模式可供选择:设备直接接入、现场网关接入和第三方平台接入:

平台采用大规模水平扩展架构,能够支持数百万级设备在线。

设备管理

设备管理组件主要提供设备建模和设备镜像(影子)功能。

设备建模允许开发者可以采用GUI方式对设备能力进行描述,包括设备能够提供的数据属性,已经设备支持的操作等。设备建模完成后,所有设备上行和下行的数据,均受到设备模型约束,保证数据有效性,为后续数据处理提供高质量的数据模型。

设备镜像(影子)是在云端根据设备模型维护的一套实体设备状态,即使设备离线,用户也通过设备镜像可以查看设备最后的已知状态,还可以指定希望设备达成的状态,当设备下次在线时,平台可以向设备同步状态,达到离线,异步,远程管理设备的目的。

分布式存储

对于所有设备上行和下行事件,系统默认都会存储,以供应用端追溯和查询。物联网项目的数据量往往很大,对数据的批量统计和实时查询形成一对矛盾。平台批量和实时结合的方式:

实时计算引擎

平台提供灵活的设备事件处理。通过高吞吐量的流式事件处理引擎,开发者可以以SQL的形式对设备消息数据进行筛选,转换,统计,转发。根据场景,事件可以转发至消息中间件主题、应用端,数据存储端等等。(注:此功能即将上线)。

应用和数据API

平台向第三方应用开放应用接口,主要接口有两类:

物联网应用

核心概念

项目(Project)

平台中的项目对应实体世界的一个工程项目。对于物联网平台而言,项目的概念主要用于组织需要管理的设备,是一个设备的分组方式和容器。

按照实际项目的阶段,项目分为筹备中、进行中和已结束三个阶段,一般来说,筹备中表示处于物联网应用开发阶段、进行中表示项目已经开始运营、已结束指项目已经结项,项目中涉及的设备已经撤除或回收。

设备模型(Model)

设备模型是对一类设备抽象,通常将相同型号的设备定义为一个设备模型,如塔吊型号TC5513-6可以定义一个塔吊模型MODEL-TC5513-6。设备模型主要包含设备属性和设备操作信息。

模型支持多版本,根据版本号区分相同设备不同阶段的操作和属性定义;模型定义可以在不同项目中重用。

设备(Device)

设备对应现实中一个具体的设备。

设备镜像(Device Shadow)

设备镜像(或设备影子)是一个实体设备在云端的数字分身,可以用于存储和检索设备的当前状态信息。控制设备、查询设备状态或向设备发送消息可以直接对设备镜像进行访问操作,再由设备镜像与实体设备完成同步。建立设备镜像的优势在于:不管设备是否在线,通过设备镜像都可获取设备最后报告的状态信息。

设备镜像在创建设备时由系统自动生成,用户无需直接对其进行处理。

虚拟设备(Virtual Device)

在项目开发阶段,应用侧开发和设备侧开发往往是并行进行的,采用虚拟设备,应用开发过程可以和硬件开发过程解耦,提升开发效率。

虚拟设备是平台根据指定的设备模型在云端生成的一个仿真硬件,可模拟正在开发的智能硬件完成数据上报,设备控制、手机APP控制等功能。

通过虚拟设备,开发者可以利用浏览器模拟虚拟设备的数据上行和下行,在应用端能够像实体设备一样获取虚拟设备的数据,并对虚拟设备进行控制。

事件(Event)

设备和平台通信的每一个数据项称为一个设备事件,比如上报一个温度数据项。设备事件可分为上行和下行方向,从设备发往平台为上行事件,反之为下行事件。

需要注意的是,设备事件并不等同于数据报文,设备和平台的每个数据报文中可以包含多个数据属性,比如对于环境监控设备,一个上行数据报文可能包括温度,湿度,风向,噪声等数据项,因此一个上行报文,往往会包括多个设备事件。

应用访问令牌(Token)

应用访问令牌是用于访问平台API的凭据,平台要求:

应用访问令牌有过期和失效机制,一般来说,一个有效令牌的有效期为7天,过期需重新申请。
另外,当用户帐号修改密码后,此用户帐号之前颁发的所有令牌均失效,需重新申请。设计此机制的目的是当用户发现原有令牌泄漏时,能够快速失效所有令牌,保证数据安全。

开发流程

images/dev_flow

获取邀请码

平台目前处于内测阶段,需获取邀请码后注册,邀请码获取请发信联系:
联系人:刘明, 邮箱:lium-n@glodon.com

注册 & 登录

获取邀请码后可以注册成为平台用户。点击注册

images/reg

注册后登录到管理平台。点击登录

images/login

创建项目

登录到管理平台后,可以创建新项目。
images/createproject

获取应用访问令牌

在创建项目后,可以从项目信息的开发接口中获取tokn信息。
images/gettoken

创建设备模型

业务系统需要访问和控制设备需要预先在管理平台对设备进行建模操作,生成设备模型。
设备模型创建:模型>添加设备模型

images/createmodel

开始应用开发

应用开发阶段,可使用平台提供的接口进行控制设备和设置/查询设备属性。物联网平台提供提两种方式访问设备数据。

images/application

获取API访问的token后,可以按照物联网智能平台Restful API接口完成接口开发。

开始设备开发

可以按照硬件开发指南开始进行设备测开发。

联调和测试

完成接口开发后,实体设备未开发完成时,可以使用虚拟设备功能进行模拟测试。通过虚拟设备可以实现:

创建虚拟设备

images/createdevice

虚拟设备模拟数据上传

在虚拟设备控制台设置模拟数据规则,打开设备开关。虚拟设备将上传模拟数据。可以通过API查看上传的数据。可以模拟一次同时上传多条属性

images/senddata

控制虚拟设备

通过开发好的API借口,可以调用控制接口向虚拟设备发送控制指令,在虚拟设备的实时监控页上可以看到控制指令。

images/monitor

创建告警规则

可以创建设备上报数据告警规则,可以定义多属性告警条件,可以过滤租户和项目来精确匹配告警规则。

images/monitor

查询告警记录

通过设置的告警规则,云端可以计算出符合告警条件的数据,并保存一条告警记录,在后台可以看到告警记录

images/monitor