网络组件配置

各种网络通信协议管理,可视化配置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包基本信息

协议jar包属性参数设置说明如下表。

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

协议脚本基本信息

协议脚本属性参数设置说明如下表。

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

后续操作步骤:

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

网络组件

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官网设备接入 - 图22 (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设备接入 - 图27 (opens new window)软件进行连接测试.

1.使用docker启动

  1. $docker pull emqx/emqx:4.2.3
  3. $docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx:4.2.3

使用EMQ设备接入 - 图28 (opens new window)开发文档查看原始用户名和密码.

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

emq客户端监控

3.点击状态列中的启动状态开启服务.变为蓝色则为启动完成.

启动mqtt客户单

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

emq监控mqtt客户端连接成功

创建设备网关

点击 设备接入→设备网关

add device gateway

设备网关连接测试

前提条件

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

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

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

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

i. 设备基本信息

设备基本信息

ii. 设备运行状态信息

设备运行状态信息

iii. 设备日志

设备日志

使用MQTT.fx设备接入 - 图36 (opens new window)软件进行连接测试

1.启动网关:

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

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

add mqtt server

2.使用MQTT.fx连接上EMQ

add mqtt server

注意：上图第2步中port为EMQ服务所暴露的端口（1883）

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

发送设备上线消息到EMQ中

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

设备上线

网关状态说明:

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

设备连接

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

TCP设备网关

待完成..

CoAP设备网关(Pro)

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

一、 创建CoAP服务并启动

进入系统: 设备接入-网络组件，点击新增组件，在组件类型选择CoAP服务。

add mqtt server

点击启动状态按钮，从灰色变成蓝色代表启动成功。

测试连接

使用Node CoAP CLI设备接入 - 图42 (opens new window)进行连接测试.

1.安装设备接入 - 图43 (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测试

参照使用CoAP接入设备（PRO)进行测试

网关状态说明:

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

设备连接

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