# 快速教程

下文介绍了如何在 Docker 容器中快速使用 Neuron 实例

# 环境搭建

# 在 Docker 中运行 Neuron

获取 Docker 镜像

~\$ docker pull emqx/neuron:1.0.0
1

启动 Docker 容器

~\$ docker run -d --name neuron -p 7000:7000 emqx/neuron:1.0.0
1

# 在 Docker 中运行 EMQ X Edge

除运行 Neuron 实例外,我们还需要部署一个 MQTT Broker 来做消息的连接处理,这里推荐使用 EMQ X Edge (opens new window),轻量级的边缘计算消息中间件。同样 EMQ X Edge 可以快速使用 Docker 容器进行安装使用。

获取 Docker 镜像

~\$ docker pull emqx/emqx-edge:4.2.2
1

启动 Docker 容器

~\$ docker run -d --name emqx -p 1883:1883 -p 18083:18083 emqx/emqx-edge:4.2.2
1

# 资源准备

  1. 安装 Modbus 模拟器: PeakHMISlaveSimulator。 安装后,打开 Modbus TCP slave。

  2. 准备一份配置好的对象数据表,可以点击 neuron_batch_modbus_5.xlsx (opens new window) 选择下载到本地。

# 运行和使用

当环境和资源都准备好后,我们可以打开 Web 浏览器,输入您运行的网关地址和端口号,即可进入到管理控制台页面,Neuron 管理控制台的端口号为 7000,例如:http://127.0.0.1:7000 (opens new window)

# 登录

打开页面后,会进入到一个登录页面,此时可以使用初始化用户名密码进行登录,用户名:admin,密码:0000,进入后为安全起见,可以修改初始化的密码。

geting-started

# 配置驱动

登录成功后,此时系统中没有预设好的数据,可能会返回 Function not allowed in current mode 错误提示,该错误提示为正常提示,因为目前系统处于 INACTIVE 状态。

我们选择顶部菜单栏中的配置一栏,点击 Object 设置,进入到对象配置页面。我们首先需要配置驱动,点击 新建驱动 按钮,会有一个配置弹出框。可配置可连接的 MQTT Broker 信息,在下方选择框中选择 MQTT Client,配置刚才使用 Docker 安装好的 EMQ X Edge 的 Host 地址和端口号。端口号默认为 1883,下方表格为连接 MQTT 的可选参数,可配置用户名密码,证书等。

配置驱动,我们选择 Modbus TCP 类型,选择完后需要进行驱动设置,必填项为 Host namePort no,在该实例中即为准备好的 Modbus 模拟器所在机器的 IP 地址,端口一般为 502,下方表格为驱动参数,如有需要可自行修改参数默认值。配置完成后,点击 提交 按钮即可完成一个 Modbus 的驱动的配置。

driver-setup1

driver-setup2

# 配置对象

为快速进行使用数据,我们可以使用刚才下载到本地的对象数据表,进行数据导入操作,来快速配置 Object。此时点击上方的 导入 按钮,选择刚才本地下载好的 Excel 文件,就可以成功导入事先配置好的数据了。

我们也可以一个个进行 Object 的数据的配置,首先需要添加 Object 数据,完成后添加 Object 的属性,每个属性又配置所对应的地址,如下图所示。

object-details

object-result

attribute-setup

attribute-result

# 配置事件

配置完成 Object 后,就可以选择进行事件配置了。我们选择顶部菜单栏中的配置一栏,点击事件设置,进入到事件配置页面,选择 创建 按钮,会有一个事件设置弹出框,我们需要选择 Object 的的属性数据进行对比,触发一条告警信息,类型选择为 alarm。还可填写子程序编号,当事件触发时,可执行子程序,这里没有配置子程序,我们就填写一个默认数值即可。完成后点击提交按钮即可创建该事件。

event-setup

# 发送数据

当配置完驱动,Object 和 事件后,我们就可以向 Neuron 发送刚才的配置好的所有数据,只需点击最右上角的 发送 按钮并确认。发送成功后,会提示系统正在重启,返回到登录页面,等待几秒后,重新登录后进入,此时页面中有了刚才已经配置好的所有数据。当底部系统状态分别为 COMM UPMANUACTIVEMQCONNECTNO ALARM 时,表示 Neuron 数据配置成功并且运行正常。

monitor

# 查看数据点监控

此时我们使用预先准备安装好的 Modbus TCP 模拟器,找到 Object 对应属性对应的地址项,并重新修改该值,设置该值为 12 后,在状态菜单栏下的数据监控页面,可以看到表格中对应属性的值实时发生了变化,变为刚才修改后的值。还可点击当前数据,实时查看当前属性的数据变化图表。

modbus-tcp

monitor-value

# 查看事件告警

我们设置了事件之后,可以看到底部出现一个红色的 UNACK ALARM 的状态提醒,说明出现未确认的告警信息,我们可以选择状态菜单栏,点击当前告警项,进入到告警页面查看告警信息,说明刚才配置的事件已经生效。如果已经发现存在该告警后,可以点击 acknowledge 按钮进行告警确认,底部的 UNACK ALARM 变为了 ALARM,表示存在告警信息,但是已经确认。

alarm-current

alarms

# 查看上报数据

此时如果我们可以查看到底部的 MQCONNECT 状态,说明 Neuron 已经成功连接到 MQTT Broker。我们可以使用 MQTT 客户端连接到刚才部署好的 EMQ X Edge,这里推荐使用 MQTT X。打开 MQTT X 并设置连接成功后,订阅上面 Neuron 发布的主题,主题格式为 Neuron/Telemetry/{neuron-uuid}neuron-uuid 可以通过管理控制台中的 管理 -> 关于 中进行获取,订阅成功后,可以看到 MQTT X 可以一直接收到 Neuron 采集并上报过来的数据。

mqttx