目  录

1 绿洲物联平台介绍

1.1 概述

1.2 功能介绍

1.3 账号授权机制

1.4 组网架构

1.5 名称解释

1.6 文档使用说明

2 登录绿洲物联平台

2.1 登录绿洲物联平台

2.2 登录系统运维

3 租户系统管理

3.1 登录租户系统管理

3.1.1 登录租户系统管理

3.1.2 账号信息

3.1.3 系统信息

3.1.4 退出登录

3.2 接入管理

3.2.1 物模型管理

3.2.2 产品管理

3.3 产品版本

3.4 账号管理

3.4.1 租户管理

3.4.2 租户账号

3.5 系统配置

3.5.1 报文追踪

3.5.2 数据存储

3.6 软件授权

4 平台管理（物联平台）

4.1 登录平台管理页面

4.2 设备接入

4.2.1 配置流程

4.2.2 物模型管理

4.2.3 产品管理

4.2.4 设备管理

4.2.5 云网关

4.2.6 协议驱动

4.2.7 设备升级

4.3 规则引擎

4.3.1 规则管理

4.4 数据流转

4.4.1 数据推送

4.5 业务模型

4.5.1 配置流程

4.5.2 模型管理

4.5.3 实体管理

4.6 日志管理

4.6.1 审计日志

4.6.2 设备日志

4.7 应用管理

4.7.1 应用管理

4.7.2 应用集成

4.7.3 服务管理

4.7.4 命名空间

4.7.5 镜像列表

4.8 开放中心

4.8.1 配置流程

4.8.2 概览

4.8.3 OpenAPI

5 平台管理（应用中心）

6 平台管理（系统管理）

6.1 登录平台管理页面

6.2 用户管理

6.3 组织管理

6.4 角色管理

6.5 资源管理

6.6 消息网关

6.7 消息中心

6.7.1 收件组

6.7.2 通知模板

6.7.3 发件箱

6.7.4 通知规则

6.7.5 收件箱

 

1 绿洲物联平台介绍

1.1  概述

H3C绿洲物联平台是致力于构建全连接的开放物联网平台。平台专注于设备接入与管理、在线网络监控与运维、设备数据分析并为应用赋能。

H3C绿洲物联平台南向管理H3C自研的物联网网关、终端设备，同时开放第三方设备的接入能力，提供基于设备的基础管理能力。平台拥有完备的设备管理、规则引擎、边缘计算、应用管理、行业场景分类等物联网场景能力。北向开放对接第三方应用，帮助生态合作伙伴搭建场景化的物联网应用，为客户挖掘创造价值。

1.2  功能介绍

绿洲物联平台功能主要分为如下几部分：

·     租户系统管理：主要进行物模型、产品、版本管理以及租户账号管理。

·     平台管理：

¡     物联平台：主要提供设备接入、边缘计算、规则引擎、业务模型、应用管理等功能。

¡     运维中心：主要提供设备智控、巡检运维、告警中心、数据分析等功能。

¡     数据可视化：支持拖拽方式定制大屏，内置丰富的数据图标组件，提供自定义组件扩充能力；支持多种数据接入，包括API、WebSocket、MongoDB、MariaDB、Oracle等等，覆盖大多数物联网领域的数据存储。

¡     应用中心：为内置应用或者新增的第三方应用提供入口。

¡     系统管理：主要提供用户、组织、角色、资源管理以及消息通知等功能。

·     系统运维：管理、配置、查看系统状况、平台状况、数据备份、版本升级以及日志中心等相关运维信息。

1.3  账号授权机制

绿洲物联平台总体上采用了四级账号体系，分为系统管理员、平台管理员、应用管理员、空间管理员，不同授权级别的账号能够使用的功能不同，按照授权级别从高到底排序为：

(1)     系统管理员：有且只有一个，负责整个平台的全局性资源的维护和配置，其中主要包括认证设备库的维护和租户的配置。默认账号与密码为admin、admin。

(2)     平台管理员：即租户账号，由系统管理员创建和维护，平台管理员有权限访问租户中的平台相关的业务资源和所有的应用资源。默认账号与密码为[email protected]、tenant@Passw0rd。

(3)     应用管理员：应用管理员由平台管理员创建，可以对应用进行实时监控、设备管理、空间管理、配置管理、查看消息等操作。

(4)     空间管理员：有应用的一部分权限，仅支持对应用中所授权的空间进行实时监控，无法配置业务。目前仅内置的“智慧空间”应用支持空间管理。

1.4  组网架构

绿洲物联平台组网架构如图1-1所示：

图1-1 绿洲物联平台组网架构

 

1.5  名称解释

表1-1 名称解释

名词	说明
租户和租户账号	租户是一种业务资源隔离单元，租户账号表示是否有权限访问租户的业务资源
产品	设备的型号，指一组具有相同功能的设备，绿洲物联平台为每个产品颁发全局唯一的ProductKey 产品分为自定义产品和认证产品，自定义产品由用户根据产品实际功能通过物模型进行描述的产品，自定义产品属于用户账户；认证产品指通过H3C生态合作平台事先完成对接开发工作，由H3C内置在平台的产品库中的产品，认证产品对所有用户开放
设备	归属于某个产品下的具体设备。绿洲物联平台为设备生成产品内唯一的DeviceId。设备可以直接连接绿洲物联平台，也可以作为子设备通过网关连接绿洲物联平台
分组	绿洲物联平台支持建立设备分组，分组中可包含不同产品下的设备。通过设备分组来进行跨产品管理设备
网关	能够直接连接绿洲物联平台的设备，且具有子设备管理功能，能够代理子设备连接云端
云网关	可以通过云网关完成对第三方子系统的集成
子设备	指ZigBee、RFID、BLE等设备需要通过网关进行设备管理的设备。子设备不能直接连接绿洲物联平台，只能通过网关连接
设备密钥	设备密钥指ProductKey、DeviceSn、DeviceSecret的组合： ·     ProductKey：是绿洲物联平台为产品颁发的全局唯一标识。该参数很重要，在设备认证以及通信中都会用到 ·     DeviceSn：设备在平台的身份标识，整个平台全局唯一。添加设备时，由用户自定义设备标识，可以用SN、IMEI等信息作为设备标识 ·     DeviceSecret：绿洲物联平台为设备颁发的设备密钥，和DeviceSn成对出现。该参数很重要，在设备认证时会用到
产品密钥	由绿洲物联平台颁发的产品密钥，通常与ProductKey成对出现，可用于一型一密的认证方案
设备X.509证书	绿洲物联平台支持设备使用X.509数字证书进行身份验证。您创建认证方式为X.509证书的设备后，可以在绿洲物联平台上上传设备公钥进行认证
MQTT	MQTT（Message Queue Telemetry Transport）是一个物联网传输协议，被设计用于轻量级的发布/订阅式消息传输，旨在为低带宽和不稳定的网络环境中的物联网设备提供可靠的网络服务。MQTTS指MQTT+SSL/TLS，在MQTTS中使用SSL/TLS协议进行加密传输
CoAP	受约束的应用协议CoAP（Constrained Application Protocol）是一种软件协议，旨在使非常简单的电子设备能够在互联网上进行交互式通信 CoAPS指CoAP over DTLS，在CoAPS中使用DTLS协议进行加密传输
HTTP	绿洲物联平台支持接入业务场景为HTTP协议的设备
H3C Link协议	H3C Link协议是针对物联网开发领域设计的一种数据交换规范，数据格式是JSON，用于设备端和绿洲物联平台的双向通信，更便捷地实现和规范了设备端和绿洲物联平台之间的业务数据交互
物模型	产品物模型是对设备的数字化抽象描述，描述该型号设备是什么，能做什么，能对外提供哪些服务
属性	用于描述设备的动态特征，包括运行时的状态，应用可发起对属性的读取和设置请求
事件	设备运行时可以被触发的上行消息，如设备运行的记录信息，设备异常时发出的告警、故障信息等；可包含多个输出参数
服务	用于描述终端设备可被外部调用的能力，可设置输入参数和输出参数。服务可实现复杂的业务逻辑，例如执行某项特定的任务；支持同步或异步返回结果
标签	绿洲物联平台支持定义不同的标签，并对设备打标签，通过标签，可以快速筛选设备
规则引擎	绿洲物联平台根据用户设置的规则和设备上报的数据，当设备满足设置的条件时，即触发对应动作，给设备下发命令
订阅推送	推送：是指订阅成功后，绿洲物联平台根据应用服务器订阅的数据类型，将对应的变更信息推送给应用服务器
数据解析脚本	针对采用透传格式/自定义数据格式的设备，需要在云端编写数据解析脚本，将设备上报的二进制数据，转换为绿洲物联平台支持的H3C JSON数据格式；将平台下发的H3C JSON格式数据，转换为设备支持的格式
设备影子	是一个JSON文档，用于存储设备或者应用的当前状态信息。每个设备都会在云端有唯一的设备影子。无论该设备是否连接到平台，您都可以使用设备影子通过HTTP协议获取和设置设备的状态
token	鉴权参数，访问绿洲物联平台API接口的凭证
镜像	本文的镜像是指容器应用的文件载体，类似于虚机镜像
HES边缘计算框架	HES蜂巢边缘计算系统是H3C自研的云边协同框架，其中边缘网关是物联网的边缘计算单元，在靠近物或数据源头的边缘侧，可以完成数据采集，AI识别

 

1.6  文档使用说明

·     本文档主要介绍租户系统管理、平台管理（包括物联平台、应用中心、系统管理）的相关内容，边缘计算、运维中心以及数据可视化的内容介绍请参见后续开发的相应文档。

·     本文档不严格与具体软、硬件版本对应，如果使用过程中与设备实际情况有差异，请以设备实际情况为准。

2 登录绿洲物联平台

2.1  登录绿洲物联平台

 

(1)     绿洲物联平台支持HTTP和HTTPS服务，在Web浏览器输入物联网私有云的IP地址和端口号http://ip-address:10081或者https://ip-address:10443，回车即可进入绿洲物联平台的Web登录页面。

(2)     输入不同权限管理员的账号、密码和验证码，然后点击<登录>按钮即可登录到绿洲物联平台管理员所具有权限的管理页面。

图2-1 绿洲物联平台登录页面

 

2.2  登录系统运维

系统运维页面可以管理、配置、查看系统状况、平台状况、数据备份、版本升级以及日志中心等相关运维信息，本文档不再详细介绍。

(1)     在Web浏览器输入物联网私有云的IP地址和端口号http://ip-address:18081或者https://ip-address:18443，回车即可进入绿洲物联平台的系统运维登录页面。

(2)     在系统运维登录页面输入缺省用户名devops、密码dev0ps@Admin_，然后点击<登录>按钮即可登录到绿洲物联平台的系统运维页面。

图2-2 登录绿洲物联平台系统运维

 

3 租户系统管理

 

3.1  登录租户系统管理

3.1.1  登录租户系统管理

在绿洲物联平台登录页面，通过系统管理员账号登录后，即可进入租户系统管理页面。

图3-1 租户系统管理页面

 

3.1.2  账号信息

用户可以在账号信息页面修改系统管理员资料和重置系统管理员密码。操作步骤为：点击页面右上角的图标，在弹框中选择“账号信息”选项，进入账号信息页面。

(1)     修改用户资料：选择“用户资料”页签，用户可以编辑姓名、手机号和邮箱，点击<确认>按钮完成操作。

图3-2 编辑用户资料

 

(2)     修改密码：选择“密码”页签，填写原始密码，设置新密码并确认密码（8～32字符，必须包含字母、数字和特殊字符），点击<确认>按钮完成操作。

图3-3 修改系统管理员密码

 

3.1.3  系统信息

点击页面右上角的图标，在弹窗中选择“系统信息”选项，进入系统信息页面，用户可以查看本机ID，平台版本号，设备型号，系统当前时间和系统运行时间。

图3-4 查看系统信息

 

3.1.4  退出登录

点击页面右上角的图标，在弹窗中选择“退出登录”选项，系统会退出系统管理员账号并返回图2-1绿洲物联平台登录页面。

3.2  接入管理

3.2.1  物模型管理

物模型是物理空间中的实体（如传感器、车载装置、楼宇、工厂等）在云端的数字化表示，从属性、服务和事件三个维度，分别描述了该实体是什么、能做什么、可以对外提供哪些信息。定义了物模型的这三个维度，即完成了产品功能的定义。

表3-1 功能定义

功能类型	说明
属性（Property）	设备可读取和设置的能力。一般用于描述设备运行时的状态，如环境监测设备所读取的当前环境温度等。属性支持GET和SET请求方式。应用系统可发起对属性的读取和设置请求
服务（Service）	设备可被外部调用的能力或方法，可设置输入参数和输出参数。产品提供了什么功能供云端调用。相比于属性，服务可通过一条指令实现更复杂的业务逻辑，如执行某项特定的任务
事件（Event）	设备运行时，主动上报给云端的事件。事件一般包含需要被外部感知和处理的通知信息，可包含多个输出参数。例如，某项任务完成的信息，或者设备发生故障或告警时的温度等，事件可以被订阅和推送

 

# 点击页面左侧导航栏的“接入管理 > 物模型管理”进入物模型管理页面。

图3-5 物模型管理

 

(1)     添加领域

在物模型管理页面点击<添加领域>按钮，在弹窗中填写领域名称和领域标识，点击<确定>按钮，完成领域添加。

图3-6 添加领域

 

(2)     添加场景

在物模型管理页面点击领域右侧的，然后点击“添加场景”，在弹窗中选择所属领域，填写场景名称和场景标识，点击<确定>按钮，完成场景添加。

图3-7 添加场景

 

(3)     添加品类

在物模型管理页面点击<添加品类>按钮，在弹窗中依次填入信息，点击<确定>按钮，完成品类添加，添加后的品类可以在物模型管理页面列表中查看。

图3-8 添加品类

 

(4)     批量操作

在物模型管理页面点击<批量操作>按钮，可以对品类进行批量导入/导出/删除操作。

(5)     查看物模型

用户可以在物模型管理页面查看已经存在或者新增的物模型信息，点击品类名称或者操作列的查看，进入物模型信息页面。

图3-9 物模型信息页面

 

在物模型信息页面点击<物模型>按钮，在弹窗中可以查看物模型，点击<导出物模型文件>按钮，可导出物模型文件。

图3-10 查看/导出物模型

 

(6)     添加标准功能

可以定义产品的上报属性、服务和事件，标准功能会存在一些默认的功能定义。在物模型信息页面点击<添加标准功能>按钮，勾选想要添加的标准功能，点击<确定>按钮，完成标准功能添加。

图3-11 添加标准功能

 

(7)     添加自定义功能

可以定义产品的上报属性、服务和事件，需要自己为产品添加相关的功能定义。在物模型信息页面点击<添加自定义功能>按钮，依次填入所需的属性、服务、事件信息，点击<确定>按钮，完成自定义功能添加。

图3-12 添加自定义功能

 

(8)     关联产品

在物模型信息页面选择“关联产品”页签，进入关联产品页面；点击<同步全部>按钮，可以将新增的必选物模型功能同步至全部产品，或者勾选部分关联产品，点击<批量同步>按钮，可以将新增的必选物模型功能批量同步至勾选的产品。

图3-13 关联产品

 

3.2.2  产品管理

产品是一组具有相同功能定义的设备集合。认证产品是绿洲物联平台已经完成对接、认证的内置产品。用户无需创建对应产品型号，就可以在物联平台直接添加对应产品型号的设备进行使用。如果没有满足需求的产品，用户可以自定义产品并定义物模型。

# 点击页面左侧导航栏的“接入管理 > 产品管理”进入产品管理页面，用户可以在产品管理页面查看已经存在或者新增的产品信息。

图3-14 产品管理页面

 

(1)     添加自定义产品：在产品管理页面点击<添加产品>按钮，然后依次填入所需信息，点击<确定>按钮，完成产品添加，添加后的产品可以在产品管理页面列表中查看。

图3-15 添加自定义产品

 

(2)     批量操作：在产品管理页面，点击<批量操作>按钮，可以对产品进行批量导入、批量导出、关联分组等操作。

3.3  产品版本

产品版本提供物联平台认证产品版本管理功能。支持设备版本下载地址配置、版本下载等功能。

·     查看平台已存在的版本信息：在左侧导航栏中选择“产品版本”选项，进入产品版本管理页面，用户可以查看上传至平台的版本文件的版本名称、版本号、所属产品和上传时间等信息。

图3-16 查看版本信息

 

·     编辑版本下载地址：点击“版本下载地址”右侧的“编辑”，在弹窗中填写绿洲物联平台的IP地址和端口号。默认为平台本地的IP地址和10081端口号。一般在平台映射到公网提供公网访问的情况下，需要修改为对应的公网地址用于设备请求版本下载。

图3-17 编辑版本下载地址

 

·     复制校验码：点击操作栏中的<复制>按钮，可以复制版本的校验码。

图3-18 复制校验码

 

·     编辑版本信息：点击<编辑>按钮，在弹窗中可以修改版本描述信息，点击<确定>按钮完成操作。

图3-19 编辑版本信息

 

·     下载版本：点击<下载>按钮，可以将版本下载到本地电脑。

图3-20 下载版本

 

3.4  账号管理

绿洲物联平台支持租户间的业务互相隔离。系统管理员可以通过账号管理功能添加租户，并在租户下添加租户账号，租户账号拥有平台管理和应用中心的权限，可以在平台管理中进一步授权空间管理员和应用管理员。

3.4.1  租户管理

用户可以通过租户帐号功能添加、编辑或删除租户，并为租户添加帐号。具体操作如下：首先在左侧导航栏中选择“账号管理 > 租户帐号”，进入租户帐号页面。默认存在一个“Tenant”租户。

图3-21 租户帐号页面

 

(1)     添加租户：点击<添加租户>按钮，在弹窗中填写租户名称和地址等信息，点击<确定>按钮完成操作。

图3-22 添加租户

 

(2)     编辑租户：选择需要编辑信息的租户，在租户右侧选择“编辑”选项，在弹窗中修改租户名称和地址等信息，点击<确定>按钮完成操作。

图3-23 编辑租户

 

(3)     删除租户：选择需要删除的租户名称右侧的“”图标，点击弹窗中的<确定>按钮完成操作。

图3-24 删除租户

 

 

3.4.2  租户账号

系统管理员可以通过租户账号功能创建租户账号（即平台管理员），平台管理员有权限访问租户中的平台相关的业务资源和所有的应用资源。具体操作如下：

(1)     首先在左侧导航栏中选择“账号管理 > 租户账号”，进入租户账号页面。

图3-25 租户账号页面

 

(2)     添加租户账号：点击要添加帐号的租户，然后点击<添加账号>按钮，在弹窗中填写用户账号、密码、确认密码、所属租户、联系人、邮箱、联系地址等信息，点击<确定>按钮，平台将新建租户账号并绑定租户。

图3-26 添加租户账号

 

 

(3)     编辑租户账号：选择租户账号，在操作栏中选择“编辑”选项，在弹框中编辑联系人、手机号、邮箱和联系地址，点击<确定>按钮完成操作。

图3-27 编辑租户账号

 

(4)     删除租户账号：选择租户账号，在操作栏中选择“删除”选项，在弹框中点击<确定>按钮完成操作。

图3-28 删除租户账号

 

(5)     重置密码：选择租户账号，在操作栏中选择“重置密码”选项，在弹窗中填写系统管理员密码，租户账号新密码和确认密码，点击<确定>按钮完成操作。

图3-29 重置租户账号密码

 

(6)     进入平台：选择租户账号，在操作栏中选择“进入平台”选项，系统会自动使用租户账号登录绿洲物联平台。

图3-30 进入平台

 

 

3.5  系统配置

3.5.1  报文追踪

报文追踪是平台提供对设备历史报文的记录。开启相关协议的功能后，平台会记录设备的历史报文信息便于查询。

可以打开或者关闭平台LoRa报文记录功能，默认为开启，开启后平台会记录LoRa设备的交互报文。

图3-31 报文记录配置

 

3.5.2  数据存储

数据存储提供配置设备数据的存储周期。平台默认存储时间为一个月，如果要修改数据存储周期，请点击<编辑>按钮进行修改。

图3-32 数据存储页面

 

3.6  软件授权

软件授权用于平台License的安装来激活平台不同的功能。

4 平台管理（物联平台）

4.1  登录平台管理页面

用户可以在图2-1绿洲物联平台登录页面，通过租户账号（即平台管理员，缺省账号为[email protected]、密码为tenant@Passw0rd）登录绿洲物联平台。或者通过系统管理员账号登录后，在租户系统管理页面的“账号管理 > 租户账号”页面中，选择租户账号，在操作栏中点击“进入平台”进入平台管理页面。

图4-1 平台管理—物联平台页面

 

4.2  设备接入

用户可以通过设备接入功能模块来创建新的产品型号，编辑物模型，调试设备功能以及设备的上线和管理。

4.2.1  配置流程

图4-2 设备接入配置流程

 

4.2.2  物模型管理

功能配置请参考租户系统管理的3.2.1  物模型管理。与租户系统管理的物模型管理不同之处在于此处的物模型管理只针对本租户账号生效。

4.2.3  产品管理

用户可以通过产品管理功能自定义产品并将该产品型号添加至绿洲物联平台，以满足产品的灵活配置需求。

# 在平台管理页面左侧导航栏中选择“设备接入 > 产品管理”，进入产品管理页面。

图4-3 产品管理页面

 

1. 自定义产品

(1)     添加产品

在产品管理页面点击<添加产品>按钮，添加自定义产品，在跳转的页面里依次填入产品名称、厂商名称、所属品类、产品标识、产品类型、接入方式等信息，点击<确定>按钮完成产品添加操作。

图4-4 添加产品

 

表4-1 添加产品配置参数说明

配置项	说明
产品名称	定义产品型号的名称
产品图标	定义产品的图片
厂商名称	定义产品的厂家信息
所属品类	定义产品继承的物模型，可以自定义品类
产品标识	平台内部标识产品的唯一ID，可以自定义，如果不指定，系统会自动生成产品标识
产品类型	定义产品的类型
接入方式	选择的产品类型不同，接入方式也不同
操作系统	定义边缘网关的操作系统类型，支持“linux”和“ComwareV9”，仅当“产品类型”选择“边缘节点”时才支持该配置项
CPU架构	定义边缘网关设备的硬件架构，支持“amd64”、“arm32”、“arm64”三种，请按照实际情况选择，仅当“产品类型”选择“边缘节点”时才支持该配置项
数据类型	定义数据解析的方式
接入密钥	定义设备接入密钥
认证类型	定义设备接入的认证类型
密钥	定义设备接入的密钥，可以自定义，如果不指定，系统会自动生成
保活间隔	定义设备的保活间隔
描述	产品的描述信息

 

(2)     批量操作

在产品管理页面勾选需要批量操作的产品，然后选择“批量操作”选项，在下拉选择框里选择需要进行的批量操作，如批量导入、批量导出等。

图4-5 批量操作

 

(3)     产品信息

产品添加成功后，选择需要查看详细信息的产品，点击产品名称或者在操作栏中选择“查看”选项，进入产品信息页面。在该页面可以查看添加的产品名称、接入方式和数据格式等信息。

图4-6 产品信息页签

 

(4)     Topic类列表

设备的接入方式为MQTT时会生成上下行的Topic，设备需要按照该Topic进行数据的发布和订阅。

图4-7 Topic类列表页签

 

(5)     功能定义

在“功能定义”页签点击<添加标准功能>按钮可以将当前产品关联的物模型中新增的未同步物模型功能添加到当前产品中。

图4-8 功能定义页签

 

(6)     版本管理

 

在“版本管理”页签可以进行上传、编辑、删除版本等操作。

图4-9 版本管理

 

a.     上传版本：点击<新增版本>按钮，在弹窗中填写版本名称、版本号、签名算法等信息，点击<选择文件>按钮，将保存于本地的版本文件上传至平台。点击<确定>按钮完成操作。

图4-10 新增版本

 

 

b.     复制校验码：点击操作栏中的“复制”选项，可以复制版本的校验码。

图4-11 复制校验码

 

c.     编辑版本信息：点击操作栏中的“编辑”选项，可以修改版本描述信息。

图4-12 编辑版本描述信息

 

d.     删除版本：点击操作栏中的“删除”选项，删除版本文件，在弹窗中点击<确定>按钮完成操作。

图4-13 删除版本

 

(7)     产品调试

在“产品调试”页签点击<添加设备>按钮可以在当前产品中进行设备添加，便于对当前产品进行调试。

图4-14 产品调试

 

(8)     产品标签

产品标签通常描述一个产品下所有设备所具有的共性信息，形式为标签名（key）-标签值（value）。

图4-15 产品标签

 

(9)     编辑产品

在产品管理页面的操作栏中选择“查看”选项，在产品信息页面，点击<编辑>按钮，即可对产品信息进行修改。

图4-16 编辑产品

 

(10)     删除产品

在自定义产品管理页面，对于需要删除的产品，在操作栏中选择“删除”选项，将产品删除。

图4-17 删除产品

 

2. 认证产品

(1)     在产品管理页面上方导航栏中点击<导入认证产品>按钮，弹窗中勾选需要导入的认证产品，点击<确定>按钮，完成导入。

图4-18 导入认证产品

 

(2)     在产品管理页面，选择想要查看详细信息的认证产品，在操作栏中选择“查看”选项，进入查看认证产品信息页面，选择上方导航栏中不同的页签，可以分别查看认证产品的产品信息、Topic类列表、功能定义、版本管理、产品标签，操作与自定义产品类似。

图4-19 查看认证产品

 

4.2.4  设备管理

物理设备要连接到绿洲物联平台，需要先在设备管理中注册设备，支持单个添加或者批量导入，部分设备如T320系列网关/ZigBee终端支持自动入网上线。

1. 添加设备

 

(1)     在设备管理页面，点击<添加设备>按钮，选择添加方式“手动添加”或者“自动发现”。

图4-20 选择添加方式

 

(2)     如果需要手动添加，则点击<手动添加>按钮，然后填写要添加的设备信息，包括设备名称、所属产品、设备标识、描述等信息。不同类型的产品要求的设备信息可能不同，请按照页面显示填写。点击<确定>按钮完成操作。

图4-21 手动填写设备信息

 

(3)     如果需要自动入网，则点击<自动发现>按钮，然后选择设备类型，当前支持T320系列网关和ZigBee终端。

¡     选择设备类型后，如果是T320系列网关，在选择设备列表中可以看到当前自动连接到平台的设备，勾选需要加入平台管理的设备后，点击<加入平台>按钮即可将设备加入到平台中。

¡     如果是ZigBee终端，进入选择网关设备的步骤，选择终端要连接的ZigBee网关，在操作栏中点击“开启入网”选项，使终端上线并加入到平台。

图4-22 T320系列网关自动发现

 

图4-23 ZigBee终端自动发现

 

2. 批量导入

用户可以通过批量导入功能一次性添加多个相同类型的设备到平台。

(1)     在批量操作下拉框中选择“批量导入”选项，在弹窗中选择所属产品，点击<下载模板>按钮，将导入模板device_import_template下载至本地。

图4-24 批量导入

 

(2)     本地电脑打开导入模板，根据“规格说明”页签填写设备名称、设备标识等信息，编辑完成后保存。

(3)     回到步骤1，点击<下一步>按钮后点击<上传文件>按钮，选择编辑好的批量导入模板并上传，点击<确定>按钮将设备批量导入至平台。

图4-25 上传文件

 

 

3. 分组管理

用户可以自定义分组，将设备关联到不同分组，方便查看和管理。

(1)     在设备管理页面，选择下拉框，选择“分组配置”，点击<添加分组>按钮，填入分组名称，点击<确定>按钮完成分组添加。

图4-26 分组配置

 

图4-27 添加分组

 

(2)     勾选已经添加的设备，点击“关联设备”下拉框中的“关联分组”，在弹出的窗口根据实际情况选择“选择已有分组”或者“创建新分组”，然后点击<确定>按钮完成分组关联。同一个设备可以关联多个分组。

图4-28 关联分组

 

(3)     选择已经关联设备的分组，然后勾选需要解除分组的设备，点击“关联设备”下拉框中的“解除分组”，在弹出的窗口点击<确定>按钮，可以完成分组解除。

图4-29 解除分组

 

4. 组织管理

用于设备权限管理。

(1)     在设备管理页面点击<添加组织>按钮，弹窗中填入所需信息，点击<确定>按钮，完成组织添加。

图4-30 添加组织

(2)     选择某一添加的组织，点击右侧的，可以对组织进行编辑、删除和添加子组织操作。

图4-31 编辑/删除/添加组织

 

(3)     勾选想要移入某个组织的设备，选择“关联设备”下拉框中的“移入组织”，在弹窗中选择所需移入的组织，点击<确定>按钮，完成操作。

图4-32 移入组织

 

(4)     选择某个组织，然后选择“关联设备”下拉框中的“移出组织”，在弹窗中点击<确定>按钮，完成移出组织操作。

图4-33 移出组织

 

5. 配置T320系列网关设备

设备基本信息

(1)     网关按照1. 添加设备添加后，选择需要查看详细信息的网关，点击“设备名称”或者在操作栏中选择“查看”选项，进入网关详情页面的“设备信息”页签。

图4-34 网关详情页面的“设备信息”页签

 

(2)     用户可以在“设备信息”页签中查看网关设备的名称、设备标识（网关的序列号）、所属产品、创建时间等信息。点击<编辑>按钮，可以修改设备名称和描述信息，点击<确定>按钮完成操作。

图4-35 编辑网关信息

 

设备标签

在“设备标签”页面，用户可以为设备添加自定义key-value形式的标签信息。点击<编辑标签>按钮，在弹出的“编辑标签”页面中点击“+添加标签”选项添加标签。

图4-36 添加设备标签

 

位置

在“位置”页面，可以在地图上设置设备位置，以及为设备添加位置的备注信息。点击<编辑>按钮，在地图上选择设备的实际位置，点击<确定>按钮完成设置。

图4-37 添加位置信息

 

配置

(1)     在“配置”页面中可以对网关进行基础配置、网络配置和高级配置。用户可以在“基础配置”栏中配置T320网关接口（插卡）的自动上线功能，CAN速率以及槽位的波特率。点击“基础配置”页签，点击<编辑>按钮，进行相关的配置，配置完后点击<确定>按钮完成操作。

图4-38 基础配置

 

(2)     用户可以在“网络配置”栏中配置网关的网络连接配置和Wi-Fi连接参数。选择“网络配置”页签，点击<网络连接配置>或<Wi-Fi连接配置>，点击<编辑>按钮，进行相关配置。

图4-39 网络配置

 

(3)     在“高级配置”中用户可以根据实际T320网关安装的插卡情况配置BLE、RFID、ZigBee、LoRa和通用配置。其中BLE、RFID、ZigBee、LoRa是针对H3C自研的相关物联网插卡配置，通用配置是针对第三方生态厂家的插卡配置。对于H3C自研的插卡选择要配置的协议，点击<编辑>按钮修改配置，完成后点击<确定>按钮完成操作。

图4-40 高级配置

 

表4-2 BLE配置参数说明

配置项	说明
服务器转发	开启后网关才会将接收到的BLE报文转发至平台
服务器配置类型	自定义，可选IP地址和域名
服务器协议类型	自定义，跟随服务器配置类型，当前仅支持IPv4
服务器地址/域名	BLE服务器地址/域名，跟随服务器地址类型。一般设置为平台地址 若服务器地址/域名发生变化，该配置项需要同步修改，否则数据无法上报至服务器。
服务器端口号	自定义，默认为3502，取值范围为1～65535
射频扫描	开启或关闭网关BLE射频扫描
RSSI过滤门限值	自定义，取值范围为-127～20。网关会基于接收到的BLE报文RSSI信号强度对BLE报文进行过滤。RSSI小于门限的报文将会被丢弃
邻居标准通告	开启或者关闭网关接收iBeacon蓝牙广播报文
邻居非标准通告	开启或关闭网关接收非iBeacon的蓝牙广播报文
广播标准通告	开启或关闭网关对外发送iBeacon蓝牙广播报文
通告Measured Power	自定义，iBeacon报文中的Measured Power字段，取值范围为-127～0
通告Major ID	自定义，iBeacon报文中Major ID字段，取值范围为0～65535
通告Minor ID	自定义，iBeacon报文中Minor ID字段，取值范围为0～65535
通告UUID	自定义，iBeacon报文中UUID字段
通告广播间隔	自定义，iBeacon报文的发送间隔，取值范围为500～10000，且为100的整数倍
射频发送功率	自定义，配置网关的发射功率
主动扫描	开启或关闭网关的主动扫描功能
主动扫描起止时间	配置主动扫描的起止时间
前导码列表	自定义，BLE设备厂商的前导码，8～18位的偶数位十六进制字符串

 

表4-3 RFID配置参数说明

配置项	说明
服务器转发	开启后网关才会将接收到的RFID报文转发至平台
服务器配置类型	自定义，可选IP地址和域名
服务器协议类型	自定义，跟随服务器配置类型，当前仅支持IPv4
服务器地址/域名	RFID服务器地址/域名，跟随服务器地址类型。一般设置为平台地址 若服务器地址/域名发生变化，该配置项需要同步修改，否则数据无法上报至服务器。
服务器端口号	自定义，默认为3500，取值范围为1～65535
射频扫描	开启或关闭网关RFID射频扫描
报文长度	RFID报文头部length字段长度，可选6bit或者8bit
报文格式	RFID报文格式选择，当前支持H3C格式和华士精成格式
RSSI过滤门限值	自定义，取值范围为-100～-5。网关基于接收到的RFID报文RSSI信号强度对RFID报文进行过滤。RSSI小于门限的报文将会丢弃
广播标准通告	开启或关闭网关对外发送iBeacon蓝牙广播报文
通告Measured Power	自定义，iBeacon报文中的Measured Power字段，取值范围为-127～0
通告Major ID	自定义，iBeacon报文中Major ID字段，取值范围为0～65535
通告Minor ID	自定义，iBeacon报文中Minor ID字段，取值范围为0～65535
通告UUID	自定义，iBeacon报文中UUID字段
通告广播间隔	自定义，iBeacon报文的发送间隔，取值范围为500~10000，且为100的整数倍
射频发送功率	自定义，配置网关的发射功率

 

表4-4 ZigBee配置参数说明

配置项	说明
服务器转发	开启后网关才会将接收到的ZigBee报文转发至平台
服务器配置类型	自定义，可选地址和域名
服务器协议类型	自定义，跟随服务器地址类型，当前仅支持IPv4
服务器地址/域名	ZigBee服务器地址/域名，跟随服务器地址类型 若服务器地址/域名发生变化，该配置项需要同步修改，否则数据无法上报至服务器。
服务器端口类型	自定义，默认为3501，取值范围为1～65535
射频扫描	开启或关闭网关ZigBee射频扫描
工作信道	自定义，取值范围为11～26 ZigBee插卡与标准ZigBee终端节点必须使用相同的工作信道才能完成连接。
端点标识	自定义，取值范围为1～240 ZigBee插卡与标准ZigBee终端节点必须使用相同的端点标识才能通信。
Profile编号	自定义，取值范围为0～65535 ZigBee插卡与ZigBee终端节点必须配置相同的profile编号才能通信。
网络密钥	自定义，配置规则为32位16进制数，网络密钥是ZigBee网络内部加密报文时使用的密钥 与加密ZigBee终端节点通信时请打开加密开关，与不加密ZigBee终端节点通信时请关闭加密开关。
连接密钥	自定义，配置规则为32位16进制数，ZigBee设备入网时，加密协调器会传输给设备网络密钥报文，连接密钥用来加密该网络密钥报文 与加密ZigBee终端节点通信时请打开加密开关，与不加密ZigBee终端节点通信时请关闭加密开关。

 

表4-5 LoRa配置参数说明

配置项	说明
服务器配置类型	自定义，可选地址和域名
服务器协议类型	自定义，跟随服务器配置类型，当前仅支持IPv4
服务器地址/域名	LoRa服务器地址/域名，跟随服务器配置类型 若服务器地址/域名发生变化，该配置项需要同步修改，否则数据无法上报至服务器。
PULL端口	自定义，默认为1680，取值范围为1025～65535
PUSH端口	自定义，默认为1682，取值范围为1025～65535
LoRa数据链路保活	自定义，取值范围为5～100秒
LoRa数据收发统计上报间隔	自定义，取值范围为20～600秒
GWMP协议版本	GWMP协议版本选择，默认为2.0
LoRa报文转发策略	LoRa网关报文CRC转发策略配置： ·     CRC校验正确：只转发CRC校验正确的报文。 ·     CRC校验错误：只转发CRC校验正确以及CRC校验错误的报文。 ·     无CRC校验：只转发CRC校验正确以及没有进行CRC校验的报文。 ·     所有：转发所有报文。

 

(4)     对于第三方插卡，选择“通用配置”，点击<添加>按钮，在弹出的配置页面中配置。其中“接口型号”中输入实际第三方插卡的型号，开启“服务器转发”，服务器配置类型选择“IP地址”或者“域名”，服务器协议类型选择“IPv4”，服务器地址输入第三方生态厂家插卡的业务服务器地址，服务器端口号输入第三方生态厂家插卡的业务服务器端口号，配置完成后点击<确定>按钮完成操作。

图4-41 高级配置中的通用配置

 

表4-6 通用配置参数说明

配置项	说明
接口型号	第三方插卡的型号，支持下拉选择以及手动输入
服务器转发	开启后网关才会将第三方插卡接收到的报文转发至服务器
服务器配置类型	自定义，可选地址和域名
服务器协议类型	自定义，跟随服务器配置类型，当前仅支持IPv4
服务器地址/域名	插卡数据上送的服务器地址/域名，跟随服务器配置类型 若服务器地址/域名发生变化，该配置项需要同步修改，否则数据无法上报至服务器。
服务器端口号	自定义，取值范围为1～65535

 

拓扑

(1)     拓扑信息显示T320M/T320M-X/T320MX-U设备以及其下所串接的T320/T320X/T320X-U和插卡整条链的拓扑情况，可以通过右上角按钮切换为图表显示或者列表显示模式。

图4-42 拓扑信息

 

(2)     点击<添加接口>按钮，进入“接口基本参数”配置页面，选择设备名称、接口索引和接口协议，点击<下一步>按钮进入“接口高级配置”页面。

 

图4-43 接口基本参数

 

(3)     用户可以在“接口高级配置”页面根据实际需求完成接口的相关高级配置。

图4-44 接口高级配置

 

(4)     配置完成后，点击<下一步>或者<跳过>按钮，进入完成页面。如需继续添加接口，请点击<继续添加>按钮，再次进入“接口基本参数”配置页面进行配置，如不再需要添加接口，请点击<添加完成>按钮完成操作。

图4-45 添加完成

 

(5)     接口添加成功后，用户可以在节点信息栏目点击网关前面的图标查看接口索引、接口类型和协议类型等信息。

图4-46 查看接口信息

 

(6)     点击接口操作栏中的“查看”选项，进入接口详情的信息页面，用户可以在该页面查看接口信息和配置信息。在“接口信息”中可以查看接口的详情，在“配置信息”可以查看接口的配置信息，点击<编辑>按钮，用户可以编辑接口的配置信息，点击<确定>按钮完成操作。

图4-47 查看接口详细信息

 

图4-48 查看接口配置信息

 

接口

(1)     接口信息显示该T320网关下的接口（插卡）信息，也可以为T320网关手动“添加接口”（配置步骤同拓扑章节）。

图4-49 查看接口配置信息

 

(2)     点击操作栏的“查看”选项，可以显示接口的详细信息以及配置信息。

图4-50 查看接口详细信息

 

邻居终端

邻居终端用来显示网关下接入的ZigBee和LoRa终端情况。

图4-51 邻居终端

 

设备运维

(1)     点击“设备运维”页签，在“版本管理”页面可以给网关升级版本，查看版本信息等。点击操作栏中的“升级”选项，选择所需要升级的版本，点击“确定”，开始升级版本。也可以启用自动升级功能。

图4-52 版本升级

 

(2)     点击“设备运维”页签，在“设备日志”页面可以查看网关上报的日志信息。点击<配置>按钮可以选择上报日志的级别，在“上报时间”位置可以根据日志信息的上报时间筛选日志信息。

 

图4-53 设备日志

 

(3)     在“远程命令”页面可以远程连接网关设备，通过命令行对网关设备进行调试和配置。

图4-54 远程命令

 

6. 配置IG系列LoRa网关

LoRa技术主要应用于智慧城市、农业等场景，支持积水监测、农业环境监测、智慧停车等多种应用，大大提高了我们的工作效率并且节约了经济成本，用户可以根据自己的需求选择对应的应用。

LoRaWAN网络是典型的星型拓扑结构，组成包括LoRa终端、LoRa网关和LoRa服务器：

·     LoRa终端：由LoRa模块和传感器等器件组成，可使用电池供电，用于收集物联网信息并发送给LoRa网关。终端设备采用单跳连接到一个或多个网关，所有终端设备与网关均是双向通信。

·     LoRa网关：LoRa网关是一个透明传输的中继，用来在终端和服务器间传递信息。网关通过IP网络连接到LoRa服务器。

·     LoRa服务器：负责数据的处理、LoRa终端接入控制以及通过ADR（Adaptive Date Rate，速率自适应）方案来控制数据传输速率和每一终端设备的射频输出功率，最大化终端的电池使用寿命和整体的网络容量。

网关按照1. 添加设备添加后，点击“设备名称”或者点击操作列的“查看”，进入LoRa网关详情页面。在该页面可以查看、编辑LoRa网关的相关信息。

设备信息

在“设备信息”页签点击<编辑>按钮可以对设备名称和描述信息进行修改。点击<确定>按钮完成编辑操作。

图4-55 编辑基本信息

 

设备标签

在“设备标签”页面，用户可以为设备添加自定义key-value形式的标签信息。点击<编辑标签>按钮，在弹出的“编辑标签”页面中点击“+添加标签”选项添加标签。

图4-56 添加设备标签

 

位置

在“位置”页面，可以在地图上设置设备位置，以及为设备添加位置的备注信息。点击<编辑>按钮，在地图上点击设备的实际位置，点击<确定>按钮完成设置。

图4-57 添加位置信息

 

IOT配置

在IOT配置中可以对网关进行LoRa Server连接配置，默认配置为连接平台内置的LoRa Server。点击<编辑>按钮，可以进行相关的配置修改，配置完后点击<确定>按钮完成操作。

图4-58 LoRa配置修改

 

接口

(1)     接口信息显示该IG LoRa网关下的接口（射频）信息。

图4-59 接口信息

 

(2)     点击“查看”选项可以查看接口的详情信息以及配置信息，配置信息中可以对接口的工作信道组和发送功率进行修改。

图4-60 接口信息和配置信息

 

邻居终端

邻居终端用来显示网关下接入的LoRa终端情况。

图4-61 邻居终端

 

7. 配置LoRa终端

终端按照1. 添加设备添加后，点击“设备名称”或者点击操作列的“查看”，进入“LoRa终端”页面。在该页面可以查看、编辑LoRa终端的设备信息、物理模型数据、服务调用、指令下发、LoRa参数配置、历史数据、缓存队列、邻居网关等信息。

设备信息

在“设备信息”页签点击<编辑>按钮可以对设备名称、保活间隔和描述信息进行修改。点击<保存>按钮完成编辑操作。

图4-62 编辑设备信息

 

LoRa参数配置

 

(1)     在“LoRa参数配置”页签点击<编辑>按钮可以对终端基本配置、终端高级配置、射频基本配置、接收窗口配置进行修改。

(2)     终端基本配置

¡     设备唯一标识（DevEUI）：即LoRa终端设备ID，用来唯一标识终端设备。

¡     终端模式：目前支持Class A和Class C两种类型的LoRa终端：

-     Class A：通过在每个上行传输的后面紧跟两个短下行接收时隙的方式来支持双向通信，是最为低功耗的终端系统方式。

-     Class C：拥有近乎连续的接收窗口，这些窗口只在需要发送报文的时候会关闭一下，拥有比Class A类型终端更低的下行通讯时延，但是会比Class A类型的终端更加耗能。

¡     入网模式—动态加入（OTAA）：即无线激活，终端设备在与服务器数据交换之前，必须先通过Join request和Join accept报文的交互加入服务器。

¡     应用密钥（AppKey）：AppKey分别存储在服务器和终端设备上，用于数据的加密和解密过程。

图4-63 终端基本配置

 

(3)     终端高级配置

¡     ADR开关：自适应速率开关，开启后如果终端支持ADR功能，平台会动态调整终端的通信速率和功率。请根据实际场景合理选择是否开启ADR开关。

¡     调试开关：开启调试开关后，“历史数据”里面会实时显示接收到的终端数据。

图4-64 终端高级配置

 

(4)     射频基本配置

¡     国家/地区：当前仅支持CHINA。

¡     工作频段：当前仅支持CN470。

¡     实际发送速率：表示终端的发包速率等级，0表示SF12，5表示SF7。

¡     发送功率：LoRa的发送功率等级，0表示最大，保持默认的“0”即可。

¡     每个信道组至少需要开启一个信道，否则会造成无法正常通信。

图4-65 射频基本配置

 

(5)     接收窗口配置

每一次上行传输之后，终端都会打开两个短接收窗口RX1和RX2：

-     第一个接收窗口RX1使用的频率、数据速率与上行传输时使用的频率、数据速率存在映射关系，RX1在发送完成后第RECEIVE_DELAY1秒开启。

-     第二个接收窗口RX2使用配置的固定频率和数据速率，RX2在发送完成后第RECEIVE_DELAY2秒开启。

¡     RX1速率偏移：设备上行和下行第一接收窗口数据速率之间的偏移，保持默认即可；

¡     RX1延迟时间：第一接收窗口的接收延时时间，保持默认即可；

¡     RX2速率：第二接收窗口使用的数据速率，保持默认即可；

¡     RX2频率：第二接收窗口配置的频率，默认为505.3。如果终端实际为别的频率，修改成对应的频段。一般用于Class C模式终端。

图4-66 接收窗口

 

图4-67 接收窗口配置

 

(6)     修改完成后，点击<保存>按钮完成编辑操作。

物模型数据

在“物模型数据”页面，可以查看终端物模型定义的数据。

图4-68 物模型数据

 

设备影子

在“设备影子”页面，可以查看终端的设备影子数据。设备影子用于存储设备当前状态信息。每个设备都会在云端有唯一的设备影子。无论该设备是否连接到平台，都可以使用设备影子通过HTTP协议获取和设置设备的状态。

图4-69 设备影子

 

服务调用

如果设备在产品定义的时候定义了物模型的服务调用，那么在设备的“服务调用”页面可以直接进行调用，对设备进行操作。勾选要设置的服务，输入相关的命令参数（如果有），点击<设置>按钮完成设置。

 

图4-70 服务调用

 

指令下发

指令下发适用于设备支持下行配置，但是在定义物模型的时候没有将该能力定义成服务的时候使用。用户可以直接下发终端能识别的原始指令。在“基本配置”中输入自定义指令名称和指令内容，选择“是否需要应答”。在高级配置里对下行报文进行LoRa层面的配置，“下行端口”可以指定LoRa下行的端口（FPort），选择是否强制下发（适用于Class C模式，直接下发），选择“消息类型”为Unconfirmed报文还是Confirmed报文，选择是否还有下行（即FPending功能），高级配置中相关参数需要勾选选中才会生效。配置完成后，点击<下发指令>按钮完成下发。

图4-71 指令下发

 

历史数据

历史数据可以查看终端的上下行报文信息，包括报文发送的信道、扩频因子、信号强度、信噪比等射频相关的信息以及报文的原始内容。

图4-72 历史数据

 

缓存队列

“缓存队列”页面可以查看终端待下发的消息。

图4-73 缓存队列

 

邻居网关

邻居网关可以查看能接收到LoRa终端信号的网关。

图4-74 邻居网关

 

8. 配置模板

配置模板用于多个需要相同配置的H3C网关设备的批量快速配置，当前主要支持H3C的IG系列网关/AP/T320系列网关以及T系列插卡。

(1)     在设备管理页面，点击<配置模板>按钮，进入模板配置的页面。

图4-75 模板配置

 

(2)     点击<添加模板>按钮，进行模板配置的添加。找到模板要配置的产品，点击产品图标进入下一步。

图4-76 选择模板产品

 

(3)     添加模板详情。自定义模板名称和描述，输入完点击<下一步>按钮。

图4-77 添加模板详情

 

(4)     选择模板的具体配置。勾选并点击要添加的配置类型，在右侧添加具体的配置。其中“一键配置”平台会自动进行模板的配置，如果要有不符合的配置内容可以单独修改。

图4-78 选择模板具体配置

 

(5)     配置完，点击<确定>按钮完成模板的配置。

图4-79 模板添加成功

 

(6)     点击<应用模板>按钮，选择需要应用模板的设备，点击<应用>按钮完成设备的模板应用，这样即可完成设备的参数配置。

图4-80 应用模板

 

9. 关联规则

关联规则用于对满足关联条件的产品或设备执行指定的关联动作。

(1)     在设备管理页面，点击<关联规则>按钮，进入设备关联规则的配置页面。

图4-81 关联规则

 

(2)     点击<添加规则>按钮，进行规则配置的添加。在“基本信息”栏目配置规则名称和描述信息。

图4-82 基本信息

 

(3)     在“关联条件”栏目，点击<添加条件组>按钮，然后在条件组下点击“添加条件”，分别配置条件类型、选择条件、条件实体。

图4-83 关联条件

 

(4)     在“关联动作”栏目，点击<添加动作>按钮，分别配置动作类型、动作实体。

图4-84 关联动作

 

10. 删除设备

在设备管理页面，选择要删除的设备，在操作栏中选择“删除”选项，将设备删除。

图4-85 删除设备

 

用户也可以勾选所有要删除的设备，在“批量操作”下拉框中选择“批量删除”选项，在弹窗中点击<确定>按钮批量删除设备。

 

图4-86 批量删除设备

 

11. 查看信息

用户可以在设备管理页面查看平台所有设备的名称和设备标识等信息，通过应用添加的设备也会同步到设备管理中。设备管理分成“全部产品”、“H3C网关”、“通用网关”、“边缘节点”、“子设备”和“直连设备”五个页签。

查看设备信息的具体操作为：

(1)     在状态/启用状态栏可以查看设备处于在线/离线/禁用状态，点击状态按钮可以将设备禁用，用户无法对禁用设备配置业务。

图4-87 禁用设备

 

(2)     点击“状态/启用状态”下拉框，可以快速筛选出全部在线、离线或是禁用的设备的信息。

图4-88 按状态筛选设备

 

(3)     点击进行高级筛选，可以基于多个维度，多种信息进行设备的搜索。

图4-89 高级筛选

 

(4)     选择要查看的设备，选择操作栏中的“查看”选项，进入设备信息页面，用户可以查看并编辑设备信息、查看物模型数据。

图4-90 查看设备信息

 

4.2.5  云网关

云网关是将第三方系统管理以系统对接的方式接入绿洲物联网进行统一管理，接入协议支持HTTP、MQTT、RocketMQ等标准协议，同时内嵌AEP等物联网平台的接入。云网关包括云网关管理（协议配置）以及数据转换器。

1. 添加云网关

在云网关管理页面，点击<新增>按钮，在弹窗中填写名称，选择类型、上行数据转换、下行数据转换、输入基础URL等信息，点击<确定>按钮完成云网关添加操作。

 

图4-91 添加云网关

 

云网关配置后平台会自动和第三方系统进行交互，在“设备管理”中可以看到同步到的设备。

2. 查看云网关

(1)     在云网关管理页面，在操作栏点击“查看”选项，可以查看对应云网关的配置信息。

图4-92 查看云网关

 

(2)     在详情页面，可以对云网关的信息进行修改，修改完后点击<确定>按钮完成修改。

图4-93 修改云网关

 

3. 使能/去使能云网关

在云网关管理页面，在“使能”栏开启和关闭云网关。

图4-94 使能云网关

 

4. 删除云网关

在云网关管理页面，在“操作”栏点击“删除”选项，在弹出的确认框中选择<确定>按钮完成云网关删除。

图4-95 删除云网关

 

5. 数据转换器

数据转换器通过编解码脚本实现子系统集成时的数据转换功能。利用数据转换器，可以将各子系统的不同数据格式转换为绿洲物联平台的标准物模型数据，无需子系统调整数据格式以适配绿洲物联平台，从而实现子系统的快速集成。

在云网关管理页面的“数据转换器”栏目点击<新增>按钮可以添加数据转换器用于上下行数据格式的转换。

图4-96 添加数据转换器

 

4.2.6  协议驱动

协议驱动是针对第三方系统以私有协议接入绿洲物联平台的情况下，通过提供SDK实现私有协议驱动服务，从而快速接入绿洲物联平台。同时，绿洲物联平台为这些私有协议驱动服务提供容器化管理，使其能够以容器化的方式运行。平台还提供统一的协议驱动服务监控功能，包括资源管理、资源分配和运行日志查看等。如需了解更多关于服务管理的信息，请参阅4.7.3  服务管理。

1. 添加驱动

(1)     在平台管理页面左侧导航栏中选择“设备接入 > 协议驱动”，进入“协议驱动”页面，点击<添加驱动>按钮，在右边弹窗中填写名称、选择协议类型，勾选允许创建设备，配置驱动配置，点击<确定>按钮完成驱动添加操作。

图4-97 添加驱动

 

(2)     在协议驱动页面添加协议驱动后，在驱动列表里选择想要配置的驱动名称或者点击操作列的“查看”，可以在右边弹窗中修改驱动名称和驱动配置，点击<确定>按钮，完成操作。

2. 关联服务

(1)     在协议驱动管理页面添加协议驱动后，在关联服务栏中选择“配置”选项，跳转到“服务管理”页面进行添加服务配置操作。

(2)     对于已经添加过服务的协议驱动，在协议驱动管理页面关联服务栏中选择已添加的服务，跳转到查看服务页面。

图4-98 查看服务

 

3. 查看驱动

在驱动协议管理页面，选择操作栏中的“查看”选项，可以查看协议驱动的基本信息，也可以对协议驱动的名称和驱动配置进行修改，修改后点击<确定>按钮，完成修改操作。

4. 删除驱动

 

在驱动协议管理页面，选择操作栏中的“删除”选项，弹窗中点击<确定>按钮，完成删除驱动操作。

图4-99 删除驱动

 

4.2.7  设备升级

设备升级功能面向终端提供软固件升级的能力，可对终端模组固件和软件升级，提供升级包管理、在线差分、升级任务通知、版本分布等功能。支持用户在“产品管理”中上传升级包，设备通过发起HTTP请求/MQTT方式完成标准化升级，可按型号或设备进行升级，可查看升级状态。

1. 版本升级

在平台管理页面的左侧导航栏中选择“设备接入 > 设备升级”，进入“设备升级”页面。点击<版本升级>按钮，在弹窗中可以按发布方式（按产品/按设备）来升级版本。按产品升级，可以对该产品下所有的设备进行升级。按设备升级，可以选择产品下指定设备进行升级。

图4-100 设备升级页面

 

(1)     点击<版本升级>按钮，在弹窗中选择按产品或者按设备升级，选择需要升级的产品类型，版本名称，指定要升级的设备（按设备升级时需要）。点击<确定>按钮开始升级。

图4-101 按产品升级

 

图4-102 按设备升级

 

(2)     升级过程中可以在“设备升级”页面查看“升级进度”。

2. 操作记录

进入版本升级页面，可以查看之前操作过升级的设备的各种信息，如设备名称、所属产品、版本类型、当前版本号等。选择操作列的“历史”选项，可以查看设备版本升级的历史操作记录。

图4-103 历史更新记录

 

4.3  规则引擎

4.3.1  规则管理

规则引擎可以配置设备或时间维度的触发及过滤条件，并通过执行动作输出到设备或其他策略。

(1)     在平台管理页面的左侧导航栏中选择“规则引擎 > 规则管理”选项，进入规则管理页面。

图4-104 规则管理页面

 

(2)     点击<添加规则>按钮，在弹窗中填写规则名称和描述（可选），点击<确定>按钮完成操作。

图4-105 添加规则

 

(3)     在规则引擎页面列表中选择需要配置的策略规则，选择操作栏中的“进入”选项，进入规则配置页面。用户可以按需求配置策略规则的触发器、执行条件和执行动作。

图4-106 策略规则配置页面

 

(4)     触发器指达到规则内任一触发条件时，执行规则。触发器的具体配置步骤为：

a.     配置触发方式为设备触发或定时触发，定时触发指仅在指定时间触发策略，需通过cron表达式配置指定时间。

b.     设备触发指仅特定设备可以触发策略，具体配置步骤如下。

c.     配置设备型号。

d.     选择设备。

e.     配置设备触发参数与比较值。

(5)     执行条件指满足规则内所有条件时，执行动作。执行条件的具体配置步骤为：

a.     配置执行条件为设备状态或时间范围，时间范围指仅在起止日期内触发策略，需配置起止日期。

b.     设备状态指特定设备在特定状态时，进行下一步执行动作，具体配置步骤如下。

c.     配置设备型号。

d.     选择设备。

e.     配置设备状态参数与比较值。

(6)     执行动作指设备执行特定的动作，或启用/停用/触发特定的规则。执行动作的具体配置步骤为：

a.     配置执行动作为设备输出或规则输出，规则输出指执行动作为启用/停用/触发一个已存在的规则，需要配置联动的规则名称和动作。

b.     设备输出指特定设备执行特定动作，具体配置步骤如下。

c.     配置设备型号。

d.     选择设备。

e.     配置向设备下发的配置与比较值。

4.4  数据流转

4.4.1  数据推送

数据推送是平台提供数据推送功能，将设备生命周期数据以MQTT、KAFKA、HTTP或者RocketMQ的方式，发送给第三方，支持按应用、设备分组、组织、全部四个维度推送数据。

1.  数据推送

(1)     在平台管理页面的左侧导航栏中选择“数据流转 > 数据推送”，进入“数据推送”页面。

图4-107 数据推送页面

 

(2)     点击<添加推送>按钮，在弹出的页面配置推送名称、选择推送服务（如无可选择的推送服务，请先在“推送服务”页签进行添加）和数据来源等信息，点击<确定>按钮完成添加推送操作。

图4-108 添加推送

 

表4-7 添加推送配置参数说明

配置项	说明
基本信息	·     选择推送服务，包括MQTT、KAFKA、HTTP或者RocketMQ四种服务类型 ·     配置推送的名称 ·     配置推送的描述信息
其他配置	·     Token：用于连接认证（选择MQTT服务类型时支持该参数） ·     Topic：Kafka消息的订阅主题（选择KAFKA服务类型时支持该参数） ·     推送Topic：RocketMQ消息队列的订阅主题（选择RocketMQ服务类型时支持该参数） ·     生产组：消息队列生产者组名（选择RocketMQ服务类型时支持该参数） ·     tag：消费标签（选择RocketMQ服务类型时支持该参数）
数据来源	应用数据的来源，支持按应用、设备分组、组织、全部四个维度推送数据
消息类型	推送的消息类型
消息转换	开启/关闭消息转换

 

(3)     点击数据推送页面操作栏的“查看”选项，可以查看已经添加的推送信息。

图4-109 查看推送信息

 

(4)     点击数据推送页面操作栏的“编辑”选项，可以对已经添加的推送信息进行修改。

图4-110 编辑推送信息

 

(5)     点击数据推送页面操作栏的“删除”选项，可以删除已经添加的推送信息。

图4-111 删除推送信息

 

2.  推送服务

(1)     在“数据推送”页面选择“推送服务”页签，进入推送服务页签。

图4-112 推送服务页签

 

(2)     点击<添加服务>按钮，在弹出的页面选择服务类型，配置服务名称，在下方其他属性框（可选），点击<添加>，添加属性名称和属性值，点击<确定>按钮完成添加操作。

图4-113 添加服务

 

表4-8 添加服务配置参数说明

配置项	说明
服务类型（HTTP）	·     服务名称：定义服务的名称 ·     推送地址：第三方服务作为HTTP服务器接受消息的URL地址信息 ·     Token：绿洲物联平台推送消息时携带的认证消息，用于消息鉴权
服务类型（KAFKA）	·     服务名称：定义服务的名称 ·     BootstrapServer：KAFKA消息broker的服务器地址 ·     其他属性：支持以Key-Value方式对KAFKA消息队列进行参数配置
服务类型（RocketMQ）	·     服务名称：定义服务的名称 ·     NameServerAddress：RocketMQ消息队列的服务器地址 ·     开启鉴权：配置连接的鉴权方式

 

(3)     用户可以在推送服务页签下对已添加的服务进行删除操作，共有两种方法：

a.     点击推送服务页面操作列的“删除”选项，在弹窗中点击<确定>按钮，删除服务。

图4-114 删除服务

 

b.     勾选推送服务页面列表中要删除的服务，点击<批量删除>按钮，在弹窗中点击<确定>按钮，删除服务。

图4-115 批量删除服务

 

4.5  业务模型

业务模型是指除了设备模型以外，物联平台需要集成的业务数据模型。通过建立业务模型，可以集成子系统的一些业务数据，如人员信息、权限信息等。

4.5.1  配置流程

图4-116 业务模型配置流程

 

4.5.2  模型管理

模型管理提供绿洲物联平台数据中台模型管理功能。

1. 新增模型

(1)     在平台管理页面的左侧导航栏中选择“业务模型 > 模型管理”，进入“模型管理”页面。

图4-117 模型管理

 

(2)     在模型管理页面点击<新增模型>按钮，在弹窗中选择“自定义”，点击<下一步>按钮进入填写模型信息弹窗，填写模型名称、基础标识、数据类型、长度限制、描述（可选），点击<确定>按钮，完成自定义模型新增操作。

 

图4-118 新增自定义模型

 

图4-119 填写自定义模板模型信息

 

2. 管理模型

(1)     查看/编辑模型信息

a.     在模型管理页面下可以看到已经添加的模型，默认呈现为矩形框，矩形框里显示模型名称、创建时间、描述信息。点击想要查看的模型矩形框，可以查看模型具体的基本信息、属性信息、服务信息。

图4-120 查看模型信息

 

b.     选择模型信息页面上方的“基本信息”页签，可以查看模型名称、基础标识等信息，点击<编辑>按钮，可以编辑基本信息。

图4-121 查看/编辑基本信息

 

c.     选择模型信息页面上方的“属性信息”页签，可以查看模型的属性名称、属性标识等。点击<添加属性>按钮，在弹窗中依次填入所需信息，可以添加属性信息。点击<历史数据存储>按钮，在弹窗中勾选“是否存储属性”，再勾选所要存储的具体属性信息，点击<绑定>按钮，再点击<确定>按钮，完成操作。开启该功能，系统将存储一年的实体历史数据。

图4-122 属性信息

 

图4-123 添加属性信息

 

图4-124 配置历史存储数据

 

d.     选择模型信息页面上方的“服务信息”页签，进入查看模型的南向/北向服务信息页签。用户可以在此页面下查看服务信息、启用/停用服务、配置定时任务以及编辑服务信息。选择下图“南向服务”页签，进入南向服务信息列表页面。

图4-125 服务信息

 

e.     在服务信息页面中选择“北向服务”页签，进入北向服务信息列表页签。选择下图操作栏的“编辑”选项，可以编辑北向服务信息。

图4-126 北向服务

 

(2)     删除模型

在模型管理页面下，点击想要删除的模型矩形框右上角的删除图标，在弹窗中点击<确定>按钮，完成模型删除操作。

图4-127 删除模型

 

3. 关联模型

(1)     在模型管理页面点击<关联模型>按钮，进入模型关联页面，如下图，页面中间展示图形化模型关联。

图4-128 模型关联

 

(2)     在模型关联页面点击<添加关联>按钮，在弹窗中选择父模型、子模型、关联属性参数，点击<确定>按钮，完成添加。

图4-129 添加关联

 

4.5.3  实体管理

实体管理提供绿洲物联平台数据中台实体管理功能。

1. 实体管理

(1)     在平台管理页面的左侧导航栏中选择“业务模型 > 实体管理”，进入“实体管理”页面，在中选择所需要操作的模型。

图4-130 实体管理页面

 

(2)     在实体管理页面中点击<添加>按钮添加实体，弹窗中填写相应参数，点击<确定>按钮完成实体添加。

图4-131 添加实体

 

(3)     在实体管理页面下方列表第一列index栏中，点击想要查看的实体index，弹窗中会呈现图形化实体信息。

图4-132 图形化展示

 

(4)     在实体管理页面下方列表中勾选所需调用的实体，点击<批量调用>按钮，在弹窗中选择所需调用的服务，修改参数值（可选），点击<调用>按钮，完成调用操作。

图4-133 批量调用

 

(5)     在实体管理页面下方列表中勾选要操作的实体，点击<表格定义>按钮，在弹窗中可以自由选择想要在表格中显示的字段。

图4-134 表格定义

 

2. 服务管理

(1)     在实体管理页面导航栏中选择“服务管理”页签，在选择框中选择所需要操作的模型。

图4-135 服务管理

 

(2)     用户可以在服务管理页面搜索框里搜索需要查看的服务。

(3)     用户可以在服务管理页面操作栏里选择“查看参数”选项，查看对应服务的参数，如Query、响应字段；在操作栏里选择“同步”选项，可以同步Query参数。

图4-136 查看参数

 

3. 日志管理

(1)     在实体管理页面导航栏中选择“日志管理”页签，在选择框中选择所需要操作的模型。

图4-137 日志管理

 

(2)     进入日志管理页面，在页签下面的搜索框里根据实体基础标识、服务名称、开始/结束日期等参数来搜索想要查看的日志。

4.6  日志管理

4.6.1  审计日志

审计日志记录用户的操作日志以及登录日志，方便进行追溯和审查。

在平台管理页面的左侧导航栏中选择“日志管理 > 审计日志”，进入“审计日志”页面，用户可以根据实际需求筛选并查看某一段时间内的审计日志信息。

图4-138 查看审计日志

 

4.6.2  设备日志

设备日志用于设备上下线记录查询。

在平台管理页面的左侧导航栏中选择“日志管理 > 设备日志”，进入“设备日志”页面，用户可以根据实际需求筛选并查看某一段时间内的设备日志信息。

图4-139 设备日志页面

 

4.7  应用管理

4.7.1  应用管理

在该页面，您可以对内置应用进行安装/卸载，对第三方应用进行增删查改等操作；本页面还支持列表和卡片视图互切，可根据需求进行显示切换。

在平台管理页面的左侧导航栏中选择“应用管理 > 应用管理”，进入应用管理页面。

图4-140 应用管理页面

 

1. 内置应用

(1)     在应用管理页面可以看到平台内置的应用，选择想要安装的应用点击<安装>按钮，在弹窗中点击<确定>按钮，完成安装操作。

图4-141 安装应用

 

(2)     在应用管理页面可以看到平台内置的应用，选择想要卸载的应用点击<卸载>按钮，在弹窗中点击<确定>按钮，完成卸载操作。卸载该应用后将无法恢复，请谨慎操作。

图4-142 卸载应用

 

2. 第三方应用

(1)     在应用管理页面选择“第三方应用”页签，进入第三方应用管理页面。

图4-143 第三方应用管理页面

 

(2)     点击<添加应用>按钮，在弹窗中填入应用名称、应用主页URL、应用场景等信息，点击<确定>按钮，完成应用添加。

图4-144 添加应用

 

(3)     选择第三方应用，可以对应用进行删除和编辑；点击图标，应用展示切换成列表形式；在搜索框中可以根据应用名称搜索第三方应用。

4.7.2  应用集成

认证中心应用接入提供OAuth接入能力，您可以通过创建应用获取接入ID与接入密钥。应用可以遵守OAuth协议中的授权码模式完成用户认证，从而获取用户信息等相关资源。

(1)     在平台管理页面的左侧导航栏中选择“应用管理 > 应用集成”，进入“应用集成”页面。

图4-145 应用集成

 

(2)     在应用集成页面点击<添加应用>按钮，在弹窗中填入对应信息，点击<确定>按钮，完成添加应用操作。

图4-146 添加应用

 

表4-9 添加应用配置参数说明

配置项	说明
应用名称	定义应用的名称
重定向地址	用户认证成功之后，认证中心会携带授权码跳转到该地址
登录地址	在列表页面点击“进入应用”会跳转到该地址
描述	定义应用的描述信息

 

(3)     在应用集成页面列表操作栏中选择“编辑”选项，在弹窗中可以编辑应用信息。

图4-147 编辑应用

 

(4)     在应用集成页面列表操作栏中选择“删除”选项，弹窗中点击<确定>按钮，完成删除应用操作。

图4-148 删除应用

 

4.7.3  服务管理

服务管理旨在提供通用的可以根据目标镜像、配置参数来在绿洲物联平台上运行目标服务的功能，并提供扩容、重启、日志查看等运维操作，同时服务管理中提供协议驱动的类型可选项，便于与协议驱动进行绑定。

1. 添加服务

(1)     在平台管理页面的左侧导航栏中选择“应用管理 > 服务管理”，进入“服务管理”页面。

图4-149 服务管理页面

 

(2)     在服务管理页面点击<添加服务>按钮，进入填写服务基本信息页面，选择服务类型、驱动名称，填写服务名称、服务标识（可选）、描述（可选），点击<下一步>按钮，进入协议驱动服务的服务配置页面。

图4-150 填写服务基本信息

 

表4-10 服务信息配置参数说明

配置项	说明
服务类型	·     协议驱动：第三方服务作为协议驱动服务，提供私有协议接入 ·     第三方应用：第三方服务作为第三方应用服务运行在绿洲物联平台
驱动名称	协议驱动的名称
服务名称	第三方服务的名称
服务标识	绿洲物联平台运行该驱动或者应用服务的标识信息
描述	描述信息

 

(3)     在添加服务的服务配置页面，选择“容器镜像”页签，选择已存在镜像或者点击<添加镜像>按钮跳转到容器镜像页面进行添加镜像配置。

图4-151 镜像选择

 

(4)     在添加服务的服务配置页面，选择“资源类型”页签，选择资源类型，配置实例个数，配置完资源类型后点击<完成>按钮，完成服务添加操作，或者可以继续后面的配置，再完成添加。

图4-152 资源类型配置

 

表4-11 资源类型配置参数说明

配置项	说明
资源类型	绿洲物联平台以k8s对第三方应用服务或者协议驱动服务进行管理，即服务运行的k8s资源类型
实例个数	服务启动的实例个数

 

(5)     （可选）在添加服务的服务配置页面，选择“网络配置”页签，完成内部网络配置和外部网络配置。“内部配置”中的端口仅支持平台内部服务之间的访问，“外部配置”将会暴露宿主机端口，同时支持平台内部和外部访问。

图4-153 网络配置

 

表4-12 网络配置参数说明

配置项	说明
容器端口	容器应用的端口，取值范围为1～65535
宿主机端口	把容器应用端口映射到宿主机端口提供服务，取值范围为50000～59999
接口类型	支持TCP或者UDP类型

 

(6)     （可选）在添加服务的服务配置页面，选择“环境变量”页签，配置环境变量。环境变量是提供容器应用运行时的环境参数，对于某些固定不变或不经常变化的参数可以通过环境变量的方式提供给容器应用。

图4-154 配置环境变量

 

(7)     （可选）在添加服务配置页面，选择“启动参数”页签，配置启动参数。启动参数是配置容器内运行的进程名称和进程运行的参数，如果容器镜像制作过程中编写的Dockerfile文件已经使用CMD指令指定运行进程和参数，则无需配置。如果配置了启动参数，优先使用启动参数的配置，忽略CMD指令。

图4-155 配置启动参数

 

表4-13 启动参数配置说明

配置项	说明
运行命令	定义容器内运行的命令。支持英文、数字、下划线_、短连接符-、斜线/，长度不超过32个字符
运行参数	定义容器内运行命令的参数，格式同Dockerfile的CMD命令。支持任意字符，每个参数输入后按回车确认输入，各项配置参数字符串总长度不超过256字符

 

(8)     （可选）在添加服务的服务配置页面，选择“资源限制”页签，可以配置容器运行的内存、CPU资源限制。

图4-156 配置资源限制

 

2. 服务管理

(1)     在服务管理页面服务名称栏选择要想查看的服务名称，或选择操作栏的“查看”选项，进入查看服务页面。

图4-157 查看服务

 

a.     在查看服务页面上方导航栏中选择“服务信息”页签，查看服务信息，如上图点击<编辑>按钮，可以编辑服务描述信息，然后点击<确定>按钮，完成编辑。

图4-158 查看/编辑服务信息

 

b.     在查看服务页面上方导航栏中选择“服务配置”页签，查看服务配置信息，点击<编辑>按钮，可以编辑服务的各种配置信息；点击<全部收起>按钮，可以收起所有配置信息，收起后<全部收起>按钮会变成<全部展开>，点击<全部展开>可展开所有配置信息。

图4-159 查看/编辑服务配置

 

c.     在查看服务页面上方导航栏中选择“实例信息”页签，查看服务实例信息，选择操作栏中的“重启”选项，弹窗中点击<确定>按钮，完成重启实例操作。

图4-160 查看实例信息

 

图4-161 重启实例

 

d.     在查看服务页面上方导航栏中选择“日志信息”页签，可查看服务日志信息。

图4-162 查看服务日志

 

(2)     在服务管理页面操作栏中选择[更多/启动]或[更多/停止]，在弹窗中选择实例格式，可以启动/停止服务（在服务的运行状态是停止的时候可操作，服务状态是开启的时候“启动”选项是置灰的）。

图4-163 启动服务

 

(3)     在服务管理页面操作栏中选择[更多/重启]，在弹窗中点击<确定>按钮，完成重启服务操作。

图4-164 重启服务

 

(4)     在服务管理页面操作栏中选择[更多/删除]，弹窗中点击<确定>按钮，完成删除服务操作。

图4-165 删除服务

 

(5)     在服务管理页面勾选想要删除的服务，点击<批量删除>按钮，在弹窗中点击<确定>按钮，可批量删除服务。

图4-166 批量删除服务

 

(6)     在服务管理页面点击<高级筛选>按钮，可以根据服务名称、服务标识、资源类型、服务类型来筛选服务。

图4-167 高级筛选服务

 

4.7.4  命名空间

命名空间是一类镜像仓库的集合。访问级别如果为“公开”，任何人都有此命名空间下镜像的读权限；访问级别如果为“私有”，则只能该账号内部使用此命名空间下的镜像。

(1)     在平台管理页面的左侧导航栏中选择“应用管理 > 命名空间”，进入“命名空间”页面。

图4-168 命名空间页面

 

(2)     在命名空间页面点击<添加命名空间>按钮，弹窗中填入对应信息，点击<确定>按钮，完成命名空间添加。

图4-169 添加命名空间

 

表4-14 添加命名空间配置参数说明

配置项	说明
空间名称	定义命名空间的名称
访问级别	当命名空间设为公开后，任何人都有此命名空间下镜像的读权限。命令行用户不需要执行“docker login”就可以拉取此命名空间下的镜像
存储容量	命名空间的大小，最大支持1024TB，“-1”表示不做限制

 

(3)     在命名空间页面勾选命名空间，点击<批量删除>按钮，弹窗中点击<确定>按钮，可以批量删除命名空间。

图4-170 批量删除命名空间

 

(4)     在命名空间页面点击某个空间名称，进入命名空间管理页面。

图4-171 空间名称

 

图4-172 命名空间管理页面

 

(5)     在命名空间管理页面点击<上传镜像文件>按钮，弹窗中选择<点击上传>按钮，选择镜像文件，再点击<确定>按钮，完成镜像上传。

图4-173 上传镜像文件

 

(6)     在命名空间管理页面列表中点击需要查看的镜像，可以查看镜像信息，也可以对镜像进行复制摘要、拷贝、删除和添加标签的操作。

图4-174 查看镜像

 

(7)     在命名空间管理页面勾选镜像，点击<批量删除>按钮，弹窗中点击<确定>按钮，完成镜像批量删除操作。

图4-175 批量删除镜像

 

(8)     在命名空间管理页面选择“成员”页签，然后点击<添加用户>按钮，可以为命名空间添加成员。可以给其它租户进行授权，授权的角色支持系统管理员、维护人员、开发者、访客、受限访客。

图4-176 添加用户

 

不同的角色具有不同的权限，如下表所示：

表4-15 命名空间角色对应的权限

角色	拉取镜像	推送镜像	删除镜像	打标签	扫描镜像	管理其他用户
系统管理员	√	√	√	√	√	√
维护人员	√	√	√	√	√	×
开发者	√	√	×	√	×	×
访客	√	×	×	√	×	×
受限访客	√	×	×	×	×	×

 

(9)     在命名空间管理页面选择“配置管理”页签，在此页面下对镜像进行配置，如是否公开、部署安全等。

图4-177 配置管理页签

 

表4-16 配置管理参数说明

配置项	说明
项目仓库	当命名空间设为公开后，任何人都有此命名空间下镜像的读权限。命令行用户不需要“docker login”就可以拉取此命名空间下的镜像
部署安全	配置后，可以阻止潜在漏洞镜像，防止达到危害级别的镜像运行
漏洞扫描	选择“自动扫描镜像”，当镜像上传后，会自动对镜像进行漏洞扫描，该功能需要联网才能使用Trivy进行扫描

 

(10)     配置镜像策略：可以通过配置策略实现清理镜像仓库无效镜像以及保留符合规则的镜像。在命名空间管理页面选择“策略”页签，在此页面下配置镜像策略。

图4-178 策略页签

 

(11)     在命名空间管理页面选择“日志”页签，在此页面下查看镜像操作的日志。

图4-179 镜像日志

 

(12)     在命名空间管理页面选择“标签”页签，在此页面下为镜像添加标签。点击<新建标签>按钮，输入标签名字，选择颜色等，点击<确定>按钮，完成标签添加。

图4-180 标签页签

 

(13)     点击图标，回到命名空间页面，选择“所有命名空间”下拉框，可以筛选所有/私有/公开命名空间。

图4-181 筛选命名空间

 

4.7.5  镜像列表

(1)     在平台管理页面的左侧导航栏中选择“应用管理 > 镜像列表”，进入“镜像列表”页面。

图4-182 镜像列表页面

 

(2)     在镜像列表页面点击<上传镜像文件>可以为已存在的命名空间添加镜像文件，弹窗中先选择命名空间，选择是否多镜像架构，然后点击<点击上传>按钮，选择镜像文件后，点击<确定>按钮，完成对命名空间的镜像添加。

图4-183 上传镜像文件

 

表4-17 上传镜像文件配置参数说明

配置项	说明
命名空间	选择镜像所属的命名空间
多架构镜像	对于多种CPU架构的镜像，可以选择“是”
镜像仓库	镜像仓库的名称，仅当“多架构镜像”选择“是”时才支持该配置项
镜像文件	选择本地镜像文件，该镜像文件为通过docker save命令保存的镜像文件

 

(3)     在镜像列表页面勾选需要删除的镜像，点击<批量删除>按钮，弹窗中点击<确定>按钮，可以对镜像进行批量删除。

图4-184 批量删除镜像

 

(4)     在镜像列表页面勾选需要导出镜像文件的镜像，点击<导出镜像文件>按钮，可以导出镜像文件（如果想要导出镜像文件，那么在4.7.4  (9)中不要勾选部署安全）。

(5)     在镜像列表页面列表的操作栏中选择“查看”选项，可以跳转到查看镜像页面，对镜像进行复制摘要、拷贝、删除和添加标签的操作。

图4-185 查看镜像

 

(6)     在镜像列表页面列表的操作栏中选择“删除”选项，弹窗中点击<确定>按钮，完成删除镜像操作。

图4-186 删除镜像

 

4.8  开放中心

API（Application Programming Interface，应用程序编程接口）接口是软件应用之间进行通信和数据交换的一组标准、方法和协议。API接口定义了不同软硬件组件之间的交互规则，包括函数调用、数据格式和错误处理等方面的内容。它允许开发者通过调用预定义的函数或发送特定格式的请求，来访问其他程序甚至硬件的功能和数据。

OpenAPI提供了一种标准化的方式来定义API，使得API接口的描述完整且一致。开发者可以使用OpenAPI定义文件生成客户端SDK、服务器端代码模版以及API测试脚本，大大提高开发效率。

4.8.1  配置流程

图4-187 OpenAPI配置流程

 

4.8.2  概览

使用仪表盘的形式为您直观的展示当前租户下OpenAPI相关的统计信息。

在平台管理页面的左侧导航栏中选择“开放中心 > 概览”，进入“概览”页面查看OpenAPI相关的统计信息。

图4-188 概览页面

 

4.8.3  OpenAPI

对OpenAPI进行管理，通过OpenAPI可以使第三方平台访问对外api。

(1)     在平台管理页面的左侧导航栏中选择“开放中心 > OpenAPI”，进入“OpenAPI”页面。

图4-189 OpenAPI页面

 

(2)     在OpenAPI页面点击<添加>按钮，弹窗中填入对应信息，点击<确定>按钮，完成OpenAPI添加。

图4-190 添加OpenAPI

 

(3)     添加OpenAPI后，点击的“查看”选项查看OpenAPI。

图4-191 查看OpenAPI

 

(4)     进入OpenAPI查看页面后，需要对OpenAPI进行产品绑定、设备绑定、模型绑定、实体绑定、API授权和数据订阅操作。

¡     绑定产品和设备后，配置“物联平台”的授权API，以供第三方用户进行API调用。

¡     绑定模型和实体后，配置“物联中台”的授权API，以供第三方用户进行API调用。

图4-192 配置OpenAPI

 

5 平台管理（应用中心）

绿洲物联应用中心通过整合内置与第三方应用，为用户提供全面、便捷、智能的物联网数据展示与分析解决方案。既支持内置应用，也能够兼容第三方应用，以满足用户多样化的需求，助力各行业实现高效管理和智能决策。

绿洲物联应用中心适用于多个行业和应用场景，包括但不限于：

·     智能锁：通过联网的智能锁系统，实现远程开锁、门禁管理和安全监控，提升家居和办公环境的安全性和便捷性。

·     智慧空间：物联网基础应用，适合智慧园区、智慧办公等场景使用。

·     智慧教室：通过智能设备和系统，实现课堂互动、智能考勤和资源管理，提升教学质量和学生参与度，同时方便教师高效管理课程。

·     城市运营中心：集成和管控各类城市设备，并将数据可视化展示到大屏。

在4.7.1  应用管理页面，安装内置应用或者新增第三方应用后，点击顶部导航栏的“应用中心”可以在该页面查看到对应的应用。点击应用图标即可进入应用的详细信息页面。

图5-1 绿洲物联应用中心

 

图5-2 智能锁应用页面

 

6 平台管理（系统管理）

6.1  登录平台管理页面

用户可以在图2-1绿洲物联平台登录页面，通过租户账号（即平台管理员，缺省账号为[email protected]、密码为tenant@Passw0rd）登录绿洲物联平台。或者通过系统管理员账号登录后，在租户系统管理页面的“账号管理 > 租户账号”页面中，选择租户账号，在操作栏中点击“进入平台”进入平台管理页面。

图6-1 平台管理—系统管理页面

 

6.2  用户管理

用户管理提供对系统中的用户进行创建、修改、删除和授权的功能。

(1)     首先在左侧导航栏中选择“用户管理”，进入用户管理页面。

图6-2 用户管理页面

 

(2)     添加组织：如果已有组织不满足需求时，可直接在此页面点击<添加组织>按钮，在弹窗中填写组织名称、显示排序、组织编码等信息，点击<确定>按钮，完成新组织添加。

图6-3 添加组织

 

(3)     添加用户：点击<添加用户>按钮，在弹窗中填写用户账号、用户姓名、手机号码、邮箱、用户角色等信息，点击<确定>按钮，完成新用户的添加。

图6-4 添加用户

 

(4)     查看/编辑用户：在操作栏中选择“查看”选项，可以查看用户的详细信息；选择“编辑”选项，可以对用户信息进行修改操作。

图6-5 编辑用户信息

 

(5)     重置密码：在操作栏中选择“更多操作 > 重置密码”选项，在弹出的“重置密码”页面输入当前用户密码，点击<确定>按钮即可将用户密码重置为初始密码123456@Aa。

图6-6 重置密码

 

(6)     分配设备：在操作栏中选择“更多操作 >分配设备”选项，然后点击<绑定设备>按钮，在弹出的“绑定设备”页面勾选需要绑定的设备，点击<绑定>按钮即可将用户与设备进行绑定。

图6-7 绑定设备

 

(7)     其他操作：在操作栏中选择“更多操作”选项，还可以对用户进行“删除”和“强制下线”操作。选择“批量操作”选项，还可以对用户进行批量启用、禁用、强制下线和删除操作。

6.3  组织管理

组织管理可以在系统中对组织结构进行创建、修改、删除。设备可以基于组织管理实现权限的精细化管理。

(1)     首先在左侧导航栏中选择“组织管理”，进入组织管理页面。

图6-8 组织管理页面

 

(2)     添加组织：点击<添加组织>按钮，在弹窗中填写组织名称、显示排序、组织编码（即组织的标识）等信息，点击<确定>按钮，完成新组织添加。

图6-9 添加组织

 

(3)     其他操作：在操作栏中还可以对组织进行“删除”、“编辑”、“添加子组织”操作。勾选组织，点击<批量删除>按钮可批量删除组织。

6.4  角色管理

角色管理提供对系统中的角色进行创建、修改、删除和授权的功能。通过建立“权限<->角色”的关联实现将权限赋予给角色，并通过建立“角色<->用户”的关联实现为用户指定角色，从而使用户获得相应角色所具有的权限。

(1)     首先在左侧导航栏中选择“角色管理”，进入角色管理页面。

图6-10 角色管理页面

 

(2)     添加角色：点击<添加角色>按钮，在弹窗中填写角色名称、角色code、所属组织等信息，点击<确定>按钮，完成角色添加。

图6-11 添加角色

 

(3)     权限配置：添加完角色后，需要为该角色进行权限配置。在角色列表的操作栏中点击“查看”，然后在“权限配置”页面即可为角色配置平台权限和应用权限。还可在“基本信息”页面修改角色的基本信息；在“绑定用户”页面将角色与用户进行绑定操作。

图6-12 权限配置

 

(4)     其他操作：在角色列表的操作栏中还可以对角色进行“删除”、“绑定用户”操作。勾选角色，选择“批量操作”选项，还可以对角色进行批量启用、禁用和删除操作。

6.5  资源管理

资源管理提供将平台资源（如产品分组、设备分组等）分配组织的功能，提供绑定、批量解绑等操作。用于实现对资源的层级权限控制，提升系统安全性和管理灵活性。

(1)     首先在左侧导航栏中选择“资源管理”，进入资源管理页面。

图6-13 资源管理页面

 

(2)     绑定设备分组：选中需要绑定设备分组的组织，点击<绑定设备分组>按钮，在弹窗中勾选设备分组，点击<绑定>按钮，即可完成设备分组绑定。

图6-14 绑定设备分组

 

(3)     绑定产品分组：选中需要绑定产品分组的组织，点击<绑定产品分组>按钮，在弹窗中勾选产品分组，点击<绑定>按钮，即可完成产品分组绑定。

图6-15 绑定产品分组

 

6.6  消息网关

消息网关提供消息通知网关的配置，消息通知支持短信、邮件、语音方式。

配置消息网关的具体步骤为：在左侧导航栏中选择“消息网关”选项，进入消息网关页面。点击<添加推送>按钮，用户可以在弹窗中选择短信、邮件或语音播报的推送类型，配置完成后点击<确定>按钮完成操作。

·     当选择短信的推送类型时，需要选择运营商并输入KEY和SN。

·     当选择邮件的推送类型时，需要输入协议类型、服务器地址、邮箱和授权码。

·     当选择语音播报的推送类型时，需要选择运营商并输入KEY、SN和templateId。

图6-16 添加推送

 

 

6.7  消息中心

6.7.1  收件组

(1)     首先在左侧导航栏中选择“消息中心 > 收件组”，进入收件组页面。

图6-17 收件组页面

 

(2)     添加收件组：点击<添加>按钮，在弹窗中输入收件组名称、选择类型，点击<确定>按钮，即可完成收件组添加。

图6-18 添加收件组

 

6.7.2  通知模板

用户可以通过通知模板功能配置推送的信息的格式与内容。

通知模板的配置步骤如下：

(1)     在左侧导航栏中选择“消息中心 > 通知模板”，进入通知模板页面。

图6-19 通知模板页面

 

(2)     点击<添加>按钮，用户可以配置模板名称、通知类型、通知方式。

图6-20 模板基本信息

 

(3)     点击<下一步>按钮，用户可以配置所选通知方式的模板内容。编辑模板内容时，单击关键字按钮，可以将关键字添加在文本中光标位置，可重复添加。

图6-21 配置模板内容

 

(4)     所有通知方式配置完毕后，点击<下一步>按钮，用户可在预览页面进行信息预览。如不满足需求可继续编辑模板内容；完成编辑后，请点击<确定>按钮。

图6-22 信息预览

 

6.7.3  发件箱

发件箱的配置步骤如下：

(1)     在左侧导航栏中选择“消息中心 > 发件箱”，进入发件箱页面。

图6-23 发件箱页面

 

(2)     点击<发送通知>按钮，用户可以配置收件组、定时通知、选择配置方式等内容。

图6-24 发送通知基本信息

 

(3)     点击<下一步>按钮，对勾选的短信通知方式进行配置。配置完毕后，点击<下一步>按钮，可以查看发送通知的预览信息。

图6-25 发送通知预览

 

6.7.4  通知规则

通知规则的配置步骤如下：

(1)     在左侧导航栏中选择“消息中心 > 通知规则”，进入通知规则页面。

图6-26 通知规则页面

 

(2)     点击<添加>按钮，用户可以配置规则名称、通知类型、通知模板等内容。

图6-27 通知规则基本配置

 

(3)     点击<下一步>按钮，用户可以进行规则配置。选择告警类型、告警级别以及触发条件，点击<确定>按钮完成通知规则添加。

图6-28 规则配置

 

6.7.5  收件箱

在左侧导航栏中选择“消息中心 > 收件箱”选项，进入收件箱页面。在该页面可以查看“网页”通知方式收到的所有消息以及未读消息。

图6-29 收件箱