# 网络组件配置

各种网络通信协议管理,可视化配置HTTP(S),TCP(TLS),CoAP(DTLS),UDP(DTLS) 等客户端及服务端.是设备接入等功能的核心.

# 证书管理

证书管理用于统一管理各个网络组件所需的TLS证书,支持证书格式:JKS,P12,PEM.

# 新增

操作步骤

  1. 进入系统: 网络组件-证书管理-新建

  2. 输入证书信息。

  3. 点击确定进行保存。
    证书新增

# 编辑

操作步骤

  1. 进入系统: 网络组件-证书管理,在操作列点击编辑
  2. 编辑证书信息。
  3. 点击确定进行保存。
    证书编辑

# 删除

进入系统: 网络组件-证书管理,在操作列点击删除

证书删除

# 协议管理

# 什么是协议

协议是设备与平台通信的一种标准,某个设备想与平台进行通信就必须按照某种协议标准进行规定上报的数据格式。

协议管理将提供两类协议类型:jar包形式,脚本形式。定义了这两类中的其中一种,即完成了协议管理的定义。

功能类型 说明
jar 自定义协议打包成jar包,上传至平台中。
脚本 在线编辑协议格式脚本。

# 添加协议

  1. 登录物联网管理平台。
  2. 在左侧导航栏,选择设备管理 > 协议管理。
  3. 在协议管理管理页面协议管理列表中,单击协议管理所对应的新建型号操作按钮。
  4. 在弹出对话框中,填写协议相关信息,然后点击保存

协议jar包基本信息

属性参数设置说明如下表。

参数 描述
名称 协议的名称,例如JetLinks V1.0。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符。
类型 jar:自定义协议打包成jar包,上传至平台中。
类名 上传的jar包所对应的java类的类名。
文件地址 上传的jar包在平台的文件路径。
描述 输入文字,对该功能进行说明或备注。长度限制为100字。

协议脚本基本信息

属性参数设置说明如下表。

参数 描述
名称 协议的名称,例如JetLinks V1.0。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符。
类型 脚本:在线编辑协议格式脚本。
连接协议 常规的连接协议。
协议标识 唯一标识符,在协议中具有唯一性。可包含英文、数字、下划线,长度不超过32个字符,例如PowerComsuption。
脚本类型 脚本编辑器格式。支持groovyjavascript格式
脚本 协议格式,在线编辑。
描述 输入文字,对该功能进行说明或备注。长度限制为100字。

后续操作步骤:

协议jar包基本信息

  1. 在协议管理列表中单击该型号的编辑按钮,可以修改基本信息。
  2. 在协议管理列表中单击该型号的发布按钮,将该协议注册到注册中心,添加设备型号时将会查询消息协议时就能查询到该协议。
    • 协议管理发布后,状态将变为已发布状态,已发布的设备型号或者是已绑定设备实例的设备型号将不支持删除。
  3. 在协议管理列表中单击该型号的删除按钮,将物理删除该协议。
    • 已发布状态的协议将不显示删除按钮

# 网络组件

# MQTT

# 新增

服务: 操作步骤

  1. 进入系统: 网络组件-组件管理-新建

  2. 输入服务配置信息。

  3. 点击确定进行保存。
    mqttserver新增
    参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:MQTT服务。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为MQTT服务,如MQTT服务、HTTP服务、MQTT客户端等
线程数 最大消息处理工作线程数量
HOST 服务地址
PORT 服务端口
TLS 是否开启证书
证书 选择证书
描述 组件描述

客户端: 操作步骤

  1. 进入系统: 网络组件-组件管理-新建

  2. 输入客户端配置信息。

  3. 点击确定进行保存。
    mqttclient新增

参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:MQTT服务。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为MQTT客户端,如MQTT服务、HTTP服务、MQTT客户端等
clientId 客户端ID
HOST 请求服务地址
PORT 请求服务端口
TLS 是否开启证书
证书 选择证书
用户名 访问服务进行验证时所需的用户名
密码 访问服务进行验证时所需的密码
描述 组件描述

# 编辑

服务: 操作步骤

  1. 进入系统: 网络组件-组件管理,点击对应配置的编辑按钮。

  2. 输入服务配置信息。

  3. 点击确定进行保存。
    mqttserver编辑

客户端:

操作步骤与服务端相同。

# 删除

进入系统: 网络组件-组件管理,点击对应配置的删除按钮。

mqttserver删除

# 调试

客户端组件连上服务组件,并发送消息。

操作步骤

  1. 进入系统:网络组件-组件管理

  2. 选择对应的MQTT服务组件,点击启动,点击调试

  3. 点击开始
    网络组件调试1

  4. 在浏览器新建一个标签页,进入组件管理

  5. 选择对应的MQTT客户端组件,点击启动,此时服务组件调试窗口将会收到客户端上线消息。

网络组件调试2
网络组件调试3

6.点击客户端组件调试按钮进入调试页面,选择推送消息,点击发送,服务调试页收到消息表示调试成功。 网络组件调试4
网络组件调试5

# TCP

功能使用请参考MQTT
服务组件新建参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:TCP服务。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为TCP服务,如MQTT服务、HTTP服务、MQTT客户端等
SSL 是否开启SSL
HOST 服务地址
PORT 服务端口
证书 选择证书
解析方式 TCP服务接收消息时的解析方式,如固定长度、自定义脚本等
描述 组件描述

客户端组件新建参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:TCP客户端。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为TCP客户端,如MQTT服务、HTTP服务、MQTT客户端等
SSL 是否开启SSL
HOST 请求服务地址
PORT 请求服务端口
证书 选择证书
解析方式 TCP服务接收消息时的解析方式,如固定长度、自定义脚本等
描述 组件描述

# CoAP(Pro)

功能使用请参考MQTT
服务组件新建参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:CoAP服务。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为CoAP服务,如MQTT服务、HTTP服务、MQTT客户端等
DTSL 是否开启DTSL
address 服务地址
PORT 服务端口
证书 选择证书
私钥别名
描述 组件描述

客户端组件新建参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:TCoAP客户端。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为CoAP客户端,如MQTT服务、HTTP服务、MQTT客户端等
DTSL 是否开启DTSL
URL 请求服务地址
超时时间 请求超时时间
证书 选择证书
描述 组件描述

# WebSocket(Pro)

功能使用请参考MQTT
服务组件新建参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:WebSocket服务。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为WebSocket服务,如MQTT服务、HTTP服务、MQTT客户端等
SSL 是否开启SSL
HOST 服务地址
PORT 服务端口
证书 选择证书
解析方式 TCP服务接收消息时的解析方式,如固定长度、自定义脚本等
描述 组件描述

客户端组件新建参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:WebSocket客户端。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为WebSocket客户端,如MQTT服务、HTTP服务、MQTT客户端等
SSL 是否开启SSL
HOST 请求服务地址
PORT 请求服务端口
证书 选择证书
uri 请求服务uri
验证host 是否验证host
描述 组件描述

# HTTP(Pro)

功能使用请参考MQTT
服务组件新建参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:HTTP服务。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为HTTP服务,如MQTT服务、HTTP服务、MQTT客户端等
SSL 是否开启SSL
PORT 服务端口
证书 选择证书
描述 组件描述

客户端组件新建参数说明

名称 说明 是否必填
组件名称 组件的名称,例如:HTTP客户端。支持中文、大小写字母、数字、短划线和下划线,且必须以中文、英文或数字开头,不超过32个字符
组件类型 组件支持的类型,此处为HTTP客户端,如MQTT服务、HTTP服务、MQTT客户端等
SSL 是否开启SSL
baseUrl 请求服务地址
证书 选择证书
验证host 是否验证host
信任所有 是否信任所有
描述 组件描述

# 设备网关

# MQTT服务设备网关

创建MQTT服务设备网关,用于直连设备、处理设备消息。

# 启动MQTT服务

进入系统: 网络组件-组件管理 点击左侧菜单中的MQTT服务 添加一个MQTT服务.

add mqtt server

点击状态列中的已停止开启服务. 状态变为已启动则为启动完成.

# 测试连接

  1. 点击表格中的操作-调试.
  2. 点击调试界面中的开始按钮.
  3. 使用MQTT.fx (opens new window)软件进行连接测试.

add mqtt server

在调试MQTT服务界面打印出相关连接消息则表示服务正常.

注意:

  1. 一定要先在调试界面中点击开始.否则会拒绝MQTT连接.
  2. 在没有配置网关服务前,mqtt客户端的clientId,username,password可以填写任意字符,但是不能留空.

# 创建设备网关

  1. 新建设备网关配置: add device gateway

  2. 启动网关:

点击操作列中的启动按钮,启动网关.

网关状态说明:

  1. 停止:网关完全停止.不再接受设备连接,以及消息.重新启动后只会接受最新的连接以及消息.
  2. 暂停:网关不再接受新的设备连接,以及消息.重新启动后恢复处理之前的所有连接的消息.
  3. 启动:网关处理新的设备连接以及消息.

# 设备连接

参照使用自定义消息协议接入设备进行设备配置,注册,以及连接,消息收发测试.

# MQTT客户端设备网关

创建MQTT客户端设备网关,用于设备已连接到第三方MQTT服务上时,处理设备消息。

# 创建MQTT客户端

进入系统: 网络组件-组件管理 点击左侧菜单中的MQTT客户端 添加一个MQTT客户端。

add mqtt server

# 测试连接

使用EMQ (opens new window)软件进行连接测试.

1.安装 (opens new window)完成EMQ,并启动

2.进入emq客户端监控界面

emq客户端监控

3.点击状态列中的已停止开启服务. 状态变为已启动则为启动完成.

启动mqtt客户单

4.在EMQ客户端监控列表中,看到客户端连接成功。表示mqtt客户端正常。

emq监控mqtt客户端连接成功

# 创建设备网关

新建设备网关配置

add device gateway

# 设备网关连接测试

# 前提条件

i. 已在平台中创建产品和设备

创建产品和设备具体操作细节,请参考添加设备型号添加设备实例

设备接入平台,请参考设备接入教程

# 创建成功的设备实例信息展示

i. 设备基本信息

设备基本信息

ii. 设备运行状态信息

设备运行状态信息

iii. 设备日志

设备日志

使用MQTT.fx (opens new window)软件进行连接测试

1.启动网关:

i. 点击操作列中的启动按钮,启动网关。

ii. 在EMQ订阅监控列表中,看到有MQTT客户端设备网关新建时,设置的topics订阅记录,表示网关topic订阅成功。

add mqtt server

2.使用MQTT.fx连接上EMQ

add mqtt server

注意:上图第2步中port为EMQ服务所暴露的端口

3.发送设备上线消息到EMQ中

发送设备上线消息到EMQ中

4.设备上线表示设备设备网关连接成功

设备上线

网关状态说明:

  1. 停止:网关完全停止.不再接受设备连接,以及消息.重新启动后只会接受最新的连接以及消息。
  2. 暂停:网关不再接受新的设备连接,以及消息.重新启动后恢复处理之前的所有连接的消息。
  3. 启动:网关处理新的设备连接以及消息。

# 设备连接

参照使用自定义消息协议接入设备进行设备配置,注册,以及连接,消息收发测试。

# TCP设备网关

待完成..

# CoAP设备网关(Pro)

创建CoAP服务设备网关,处理设备消息。

# 一、 创建CoAP服务并启动

进入系统: 网络组件-组件管理 点击左侧菜单中的CoAP服务 添加一个CoAP服务。

add mqtt server

点击状态列中的已停止开启服务. 状态变为已启动则为启动完成.

# 测试连接

使用Node CoAP CLI (opens new window)进行连接测试.

1.安装 (opens new window)完成coap cli

2.打开终端,输入 coap get coap://127.0.0.1:12344 返回结果为404则表示coap服务启动成功

coap服务连接测试

# 二、创建设备网关

新建设备网关配置

add device gateway

# 设备网关消息处理测试

前提条件

i. 已在平台中创建产品和设备

ii. 设备已接入平台(设备已上线)

创建产品和设备具体操作细节,请参考添加设备型号添加设备实例

设备接入平台,请参考设备接入教程

创建成功的设备实例信息展示

i. 设备基本信息

设备基本信息

ii. 设备运行状态信息

设备运行状态信息

iii. 设备日志

设备日志

使用Node CoAP CLI测试

i. 安装Node CoAP CLI (opens new window)

ii. 点击操作列中的启动按钮,启动网关。

iii. 终端输入: coap post coap://127.0.0.1:12344/chiefdata/push/fire_alarm/department/1/area/1/dev/test001 -p {\"devid\":\"test001\"} -O 2100,test001

send-device-event

vi. 设备收到一条上报事件则代表CoAP网关测试成功

设备事件展示

网关状态说明:

  1. 停止:网关完全停止.不再接受设备连接,以及消息.重新启动后只会接受最新的连接以及消息。
  2. 暂停:网关不再接受新的设备连接,以及消息.重新启动后恢复处理之前的所有连接的消息。
  3. 启动:网关处理新的设备连接以及消息。

# 设备连接

参照使用自定义消息协议接入设备进行设备配置,注册,以及连接,消息收发测试。