模块配置

本节主要介绍了北向应用和南向设备的参数配置，南向设备的点位信息配置规范。

提示

uint16 对应 word 类型。uint32 对应 dword 类型。

MQTT

Neuron 从设备采集到的数据可以通过 MQTT 应用程序传输到 MQTT Broker 中，用户也可以通过 MQTT 应用程序向 Neuron 发送指令。

应用配置

Modbus

Modbus 协议包括三种协议：Modbus TCP、Modbus RTU 和 Modbus RTU over TCP。三种协议除了设备配置方式不一致外，支持的数据类型及地址格式都一致。

Modbus TCP / Modbus RTU over TCP 设备配置

Modbus RTU 设备配置

支持的数据类型

• INT16
• INT32
• UINT16
• UINT32
• FLOAT
• BIT
• STRING

地址格式

SLAVE!ADDRESS[.BIT][#ENDIAN][.LEN[H][L][D][E]]

SLAVE

必填，指从机地址或者是站点号。

ADDRESS

必填，指寄存器地址。Modbus 协议有四个区域，每个区域最大有 65536 个寄存器，每个区域的地址范围如下表所示。需要注意的是实际应用中一般不需要 65536 这么大的存储区，一般 PLC 厂家普遍采用 10000 以内的地址范围，请注意根据设备的区域及功能码，正确填写点位地址。

提示

一些设备文件会使用功能码和寄存器地址来描述指令，因为寄存器地址编号是从 0 开始的，所以每个区域的寄存器地址范围为 0 ～ 65535。首先，根据功能码确定地址的最高位数，并在寄存器地址上加1，作为 Neuron 的使用地址。

例如，功能码是 0x03，寄存器地址是 0，Neuron 使用的地址是 400001。功能码是 0x02，寄存器地址是 5，Neuron 使用的地址是 100006。

.BIT

选填，一个寄存器地址的某一位，例如：

#ENDIAN

选填，字节顺序，适用于 int16/uint16/int32/uint32/float 数据类型，详细说明见下表。

例子：

.LEN[H][L][D][E]

当数据类型为 string 类型时，.LEN 是必填项，表示字符串需要占用的字节长度，每个寄存器中包含H，L，D 和E 四种存储方式，如下列表格所示。

例子：

OPC UA

设备配置

认证方式：

• anonymos，需要 OPCUA 服务端开启匿名登录；
• username-password，需要 OPCUA 服务端已经创建好具备访问权限的 username，Neuron 自动会匹配 OPCUA 服务端的安全设置并尝试登录；
• cert-key + anonymos，需要 OPCUA 服务端开启合适的安全设置并设置证书，并且开启匿名登录；
• cert-key + username-password，需要 OPCUA 服务端已经创建好具备访问权限的username，并开启合适的安全设置并设置证书；

证书设置

OPCUA可通过用户自签名证书登录到 OPC-UA 服务器，certificate 和 key 必须满足以下条件：

• CERTIFICATE 和 KEYFILE 必须同时设置
• Certificate 必须以X.509v3标准生成
• Certficate 的SAN字段必须包含URI:urn:xxx.xxx.xxx,“xxx”部分为自定义部分
• Certificate 文件和 Key 文件必须使用DER格式编码

证书文件可以提前导入到目标服务器中并设置为信任，也可以由 neuron 设置后自动提交再由服务端设置为信任。注：老版本的 kepware 或者 IGS 可能需要手动导入证书。

证书生成步骤（Windows/Linux/Mac）：

openssl req -config localhost.cnf -new -nodes -x509 -sha256 -newkey rsa:2048 -keyout localhost.key -days 365 -subj "/C=DE/O=neuron/CN=NeuronClient@localhost" -out localhost.crt
openssl x509 -in localhost.crt -outform der -out client_cert.der
openssl rsa -inform PEM -in localhost.key -outform DER -out client_key.der
rm localhost.crt
rm localhost.key

-config指定的 *.cnf 文件可以使用 openssl 的模版文件 (opens new window) 进行修改，需包含如下配置节：

[ v3_req ]
# Extensions to add to a certificate request
basicConstraints = CA:FALSE
keyUsage = nonRepudiation, digitalSignature, keyEncipherment
subjectAltName = @alt_names
[ alt_names ]
URI.1 = urn:xxx.xxx.xxx
DNS.1 = localhost
#DNS.2 = localhost
IP.1 = 127.0.0.1
#IP.2 = 0.0.0.0

-days可以根据需要设置数值。

证书转换

可以通过以下步骤和命令将 PEM 证书以及私钥转换为 DER 格式

1. 将包括”——-BEGIN CERTIFICATE——-“和”——-END CERTIFICATE——-“的所有内容保存为1.crt;
2. 将包括”——-BEGIN PRIVATE KEY——-“和”——-END PRIVATE KEY——-“的所有内容保存为1.key;
3. 执行如下命令:

openssl x509 -in 1.crt -outform der -out cert.der   
openssl rsa -inform PEM -in 1.key -outform DER -out key.der

支持的数据类型

• INT8（用于表示 SBYTE 类型）
• INT16
• INT32
• INT64
• UINT8（用于表示 BYTE 类型）
• UINT16
• UINT32（同时用于表示 DATETIME 类型）
• UINT64
• FLOAT
• DOUBLE
• BOOL
• STRING

地址格式

IX!NODEID

IX 名字空间索引。

NODEID 节点 ID，可以设置为数字形式或者字符串形式。

例子：

可以使用 UaExpert 软件协助查看所需点位的名字空间和节点 ID 信息。

提示

关于命名空间索引和节点 ID 的解释，请参考 OPC UA 标准。

Neuron 设置的数据类型必须与 OPCUA 数据类型相匹配。

Siemens S7 ISOTCP

s7comm 插件用于带有网络端口的西门子PLC，如，s7-200/300/400/1200/1500。

设备配置

提示

当使用S7COMM插件访问S7 1200/1500 PLC时，你需要使用西门子软件（TIA16）对PLC进行一些设置。( 详细设置请参考 PLC 设置 )

• 优化块访问必须被关闭。
• 访问级别必须是完全，连接机制必须允许 GET/PUT。

支持的数据类型

• INT16
• UINT16
• INT32
• UINT32
• FLOAT
• DOUBLE
• BIT
• STRING

地址格式

AREA ADDRESS[.BIT][.LEN]

AREA ADDRESS

例子：

.BIT

选填，指某一地址的某一位。

例子：

.LEN

当数据类型为 string 类型时，是必填项，表示字符串长度。

例子：

OMRON FINS on TCP

fins插件用于带有网口的欧姆龙 PLC，如 CP2E。

设备配置

支持的数据类型

• UINT8
• INT8
• INT16
• UINT16
• INT32
• UINT32
• FLOAT
• DOUBLE
• BIT
• STRING

地址格式

AREA ADDRESS[.BIT][.LEN[H][L]]

AREA ADDRESS

例子：

.BIT

选填，指某一地址的某一位。

例子：

.LEN[H][L]

当数据类型是 string 类型时，是必填项，.LEN 表示字符串长度，包含 H 和 L 两种字节顺序，不填默认是 H 字节顺序。

例子：

Mitsubishi MELSEC QnA3E

qna3e 插件用于通过以太网访问三菱的QnA兼容PLC，包括Q系列（MC）、iQ-F系列（SLMP）和iQ-L系列。

设备配置

支持的数据类型

• INT16
• UINT16
• INT32
• UINT32
• FLOAT
• DOUBLE
• BIT
• STRING

地址格式

AREA ADDRESS[.BIT][.LEN[H][L]]

AREA ADDRESS

例子：

.BIT

只可用于非bit类型区域，表示读取指定地址的指定二进制位，二进制位索引区间为[0, 15]。

.LEN[H][L]

当数据类型是 string 类型时，.LEN 表示的是字符串长度；可以选填 H和 L 表示两种字节顺序，默认的是 H 的字节顺序。

例子：

IEC 60870-5-104

设备配置

支持的数据类型

• UINT16
• INT16
• FLOAT
• BIT
• UINT8
• INT8

地址格式

IOA

KNXnet/IP

设备配置

注意如果使用多拨地址224.0.23.12进行配置，通常要求设备与Neuron部署在同一网段中。

由于KNXnet/IP协议的工作原理，如果使用虚拟化技术如虚拟机或docker部署Neuron，KNX插件可能 无法正常工作。如果是在Linux主机中使用docker镜像部署Neuron，那么需要使用docker选项--net=host。 在其他情况下，推荐您使用二进制安装包部署Neuron。

支持的数据类型

• BIT
• BOOL
• INT8
• UINT8
• INT16
• UINT16
• FLOAT

地址格式

代表 KNX 组地址，只能在 Neuron 中写入，属于该组的 KNX 设备将对发送到该组的消息做出响应。

例子：

0/0/1 是一个 KNX 组地址，只在 Neuron 中写入，属于 0/0/1 组的 KNX 设备将对发送到 0/0/1 组的消息做出响应。

• GROUP_ADDRESS,INDIVIDUAL_ADDRESS

表示一个KNX设备地址及其所属的组地址。进行读操作时，KNX插件发送GroupValueRead 隧道请求，在收到匹配设备地址的GroupValueResp报文时更新点位数据。 进行写操作时， KNX插件发送一个GroupValueWrite隧道请求报文。

例子：

0/0/1,1.1.1 代表 KNX 组地址 0/0/1下的设备地址 1.1.1。

• GROUP_ADDRESS,INDIVIDUAL_ADDRESS,BIT

与上相同，但为读取比特位数少于8的uint8类型数据时使用，如KNX data point类型B2和B1U3等。 其中BIT表示数据比特位数。

例子：

0/0/1,1.1.1,2 代表 KNX 组地址 0/0/1下的设备地址 1.1.1，数据为两个比特。

BACnet/IP

设备配置

支持的数据类型

• FLOAT
• BIT

地址格式

AREA ADDRESS

例子：

DL/T645-2007

dlt645 驱动支持串口和 TCP 连接。

设备配置

serival

TCP

支持的数据类型

• UIN8
• UINT16
• UINT32
• UIN64

地址格式

mail_address#DI3-DI2-DI1-DI0

• mail_address 代表电表的通信地址。
• DI3-DI2-DI1-DI0 代表的是数据标识，所有点位只支持读属性，且用十六进制表示。

例如，123456789012#02-01-01-00，代表通信地址为 123456789012 的电表设备的 A 相电压的值。

提示

支持一个节点配置多个通信地址的点位，即单串口的多设备连接。

具体的数据标识对应的数据项名称请参考 DL/T645-2007 行业标准的数据编码表格。

• 数据长度为 1，数据类型选择 UINT8；
• 数据长度为 2，数据类型选择 UINT16；
• 数据长度为 3 或 4，数据类型选择 UINT32；
• 数据长度为 5 或 6 或 7 或 8，数据类型选择 UINT64；
• 根据数据格式设置 Decimal 的值，例如数据格式为 XXX.X，则 Decimal 设置为 0.1；

Sparkplug_B

Neuron 从设备采集到的数据可以通过Sparkplug_B协议从边缘端传输到Sparkplug_B应用中，用户也可以从应用程序向 Neuron 发送数据修改指令。Sparkplug_B是运行再MQTT之上的应用型协议，所以在Neuron中的设置与MQTT驱动相似。

应用配置

非 A11

设备设置

支持的数据类型

• INT16
• UINT16
• INT32
• UINT32
• FLOAT
• STRING

地址格式

COMMAND ! OFFSET[.LEN]

Example:

ADS

通过ads插件可以连接Beckhoff ADS/AMS设备.

设备设置

请注意，为了让neuron能与PLC正常通信，需要在目标TC runtime (PLC) 中添加和设置对应的 ADS路由.

支持的数据类型

• BOOL
• INT8
• UINT8
• INT16
• UINT16
• INT32
• UINT32
• INT64
• UINT64
• FLOAT
• DOUBLE
• STRING

地址格式

INDEX_GROUP,INDEX_OFFSET

INDEX_GROUP和INDEX_OFFSET可以分别独立使用十进制或十六进制指定.

示例:

OPC DA

Neuron 可通过外部辅助程序 neuopc.exe 间接访问运行于 Windows 操作系统的 OPCDA 服务器。neuopc 通过将 DA 协议转换为 UA 协议，再通过 Neuron已有的 opcua driver 进行数据获取，DA 的所有可访问点位都被映射至 UA 的”命名空间2”当中，点位的 ID 则与 DA 保持一致。

设备配置

neuopc 的组件包可以前往 neuopc 的项目页面 (opens new window)下载（neuopc是GPL协议下的开源项目）。安装以及远程连接的系统配置参考 neuopc 运行环境设置。

neuopc配置

步骤：

1. 填写 DA Host，可以填写 IP 或 Hostname，不填写则默认为本机；
2. 尝试点击 DA Server 的下拉按钮，可以尝试获取目标 Host 的 DA Server 列表，如果下拉为空则说明检测不到任何目标主机上的 DA Server；
3. 点击 Connect 按钮，服务器连接成功后会显示当前 DA Server 的所有可获取的测点信息，状态栏会出现当前服务器的连接信息，如图示8；
4. 设置 UA Port；
5. 设置 UA User；
6. 设置 UA Password；
7. 点击 Run 按钮，UA 服务器启动后，所有列表中的测点都会被映射到 UA Server 的 NeuOPC 目录下，所有测点的 UA namespace 为2，此时 UA 的相关设置项目会变为不可设置状态；
8. 通过鼠标双击 neuopc 测点列表的 Name 列可将对应的测点名称复制到剪贴板中，然后在 neuron 的 tag 表单中粘贴。

Neuron opcua 连接配置

步骤：

1. 在 neuron 南向设备管理中添加一个 opcua 设备；
2. 在设备配置中修改 endpoint url 为 neuopc 的 UA Server 地址；
3. 在设备配置中填写 Username，与 neuopc 中设置的一致；
4. 在设备配置中填写 Password，与neuopc 中设置的一直；
5. 无需填写 Cert 和 Key，直接提交设置表单。

支持的数据类型

• INT8（用于表示 SBYTE 类型）
• INT16
• INT32
• INT64
• UINT8（用于表示 BYTE 类型）
• UINT16
• UINT32（同时用于表示 DATETIME 类型）
• UINT64
• FLOAT
• DOUBLE
• BOOL
• STRING

地址格式

IX!NODEID

IX 名字空间索引，访问 neuopc 时，IX只能为2。

NODEID 节点 ID，与 DA 服务器中的字符串一致。

例子：

CNC FANUC FOCAS

支持架构: amd64, arm/v7

设备设置

支持的数据类型

• uint8
• int8
• uint16
• int16
• uint32
• int32
• uint64
• int64
• float
• double
• bit
• string

CNC 数据

CNC地址示例

PMC数据

PMC点位示例

Mitsubishi MELSEC A1E

a1e 插件用于通过以太网访问三菱的 A 系列、FX3U、FX3G、iQ-F 系列 PLC（iQ-F 需要特定固件版本支持）。

设备配置

支持的数据类型

• INT16
• UINT16
• INT32
• UINT32
• FLOAT
• DOUBLE
• BIT
• STRING

地址格式

AREA ADDRESS[.BIT][.LEN[H][L]]

AREA ADDRESS

例子：

.BIT

只可用于非bit类型区域，表示读取指定地址的指定二进制位，二进制位索引区间为[0, 15]。

.LEN[H][L]

当数据类型是 string 类型时，.LEN 表示的是字符串长度；可以选填 H和 L 表示两种字节顺序，默认的是 H 的字节顺序。

例子：

EtherNet/IP(CIP)

此驱动主要用于支持EtherNet/IP协议的设备。

设备配置

支持的数据类型

• INT8
• UINT8
• INT16
• UINT16
• INT32
• UINT32
• INT64
• UINT64
• FLOAT
• DOUBLE
• BOOL
• BIT
• STRING
• WORD
• DWORD
• LWORD

PLC数据地址

TAG NAME