# 网络组件配置

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

# 证书管理

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

# 新增

操作步骤

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

  2. 输入证书信息。

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

# 编辑

操作步骤

  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软件进行连接测试.

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软件进行连接测试.

1.安装完成EMQ,并启动

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

emq客户端监控

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

启动mqtt客户单

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

emq监控mqtt客户端连接成功

# 创建设备网关

新建设备网关配置

add device gateway

# 设备网关连接测试

# 前提条件

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

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

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

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

i. 设备基本信息

设备基本信息

ii. 设备运行状态信息

设备运行状态信息

iii. 设备日志

设备日志

使用MQTT.fx软件进行连接测试

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进行连接测试.

1.安装完成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

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. 启动:网关处理新的设备连接以及消息。

# 设备连接

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