应用和设备配置

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

Tip: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]]</span>

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 的模版文件 进行修改，需包含如下配置节：

[ 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</span>

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]</span>

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]]</span>

AREA ADDRESS

例子：

.BIT

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

例子：

.LEN[H][L]

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

例子：

Mitsubishi MELSEC-Q E71

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

设备配置

支持的数据类型

• INT16

• UINT16

• INT32

• UINT32

• FLOAT

• DOUBLE

• BIT

• STRING

地址格式

AREA ADDRESS[.BIT][.LEN[H][L]]</span>

AREA ADDRESS

例子：

.BIT

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

.LEN[H][L]

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

例子：

IEC 60870-5-104

设备配置

支持的数据类型

• UINT16

• INT16

• FLOAT

• BIT

地址格式

IOA</span>

KNXnet/IP

支持的数据类型

• BIT

• BOOL

• INT8

• UINT8

• INT16

• UINT16

• FLOAT

地址格式

两种地址格式：

• GROUP_ADDRESS</span>

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

例子：

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

• GROUP_ADDRESS,INDIVIDUAL_ADDRESS</span>

代表 KNX 组下的设备地址，只能在 Neuron 中读取。

例子：

0/0/1,1.1.1 代表 KNX 组地址 0/0/1下的设备地址 1.1.1，并且在 Neuron 中只读。

BACnet/IP

设备配置

支持的数据类型

• FLOAT

• BIT

地址格式

AREA ADDRESS</span>

例子：

DL/T645-2007

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

设备配置

serival

TCP

支持的数据类型

• DOUBLE

• UIN8

• UIN64

地址格式

DATA </span>

DATA

Data 代表的是数据标识

Sparkplug_B

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

应用配置

非 A11

设备设置

支持的数据类型

• INT16

• UINT16

• INT32

• UINT32

• FLOAT

• STRING

地址格式

COMMAND ! OFFSET[.LEN]</span>

Example: