From db0a3a275fef7cfc5ba1a053af5d8f245d2352c8 Mon Sep 17 00:00:00 2001 From: QQDQ <76338966@qq.com> Date: Fri, 7 Feb 2025 12:07:31 +0800 Subject: [PATCH] update 2.11 61850+data report type --- .../configuration/north-apps/mqtt/overview.md | 18 +- .../south-devices/iec61850/overview.md | 31 +- zh_CN/configuration/north-apps/mqtt/api.md | 316 ++++++++++++------ .../configuration/north-apps/mqtt/overview.md | 8 +- .../south-devices/iec61850/overview.md | 32 +- 5 files changed, 288 insertions(+), 117 deletions(-) diff --git a/en_US/configuration/north-apps/mqtt/overview.md b/en_US/configuration/north-apps/mqtt/overview.md index b1328ef0..41958740 100644 --- a/en_US/configuration/north-apps/mqtt/overview.md +++ b/en_US/configuration/north-apps/mqtt/overview.md @@ -23,20 +23,20 @@ See the table below for the configuration parameters. | Parameter | Description | | ------------------------------- | ------------------------------------------------------------ | -| **MQTT Version** | The version of MQTT protocol. The default is v3.1.1. | +| **MQTT Version** | The version of MQTT protocol, default v3.1.1. | | **Client ID** | MQTT client id for communication, a required field. | -| **QoS Level** | MQTT QoS level for message delivery, optional, default QoS 0. (since 2.4.0) | -| **Upload Format** | JSON format of reported data, a required field:

- *values-format*, data are split into `values` and `errors` sub-objects.
- *tags-format*, tag data are put in a single array.

For data communication format, see [Upstream/Downstream Data Format](./api.md#write-tag)
· *ECP-format*：Add tag types on the basis of *tags-format*.| -| **Upload Tag Error Code** | When data tag collection reports an error, report the tag error code. Default enabled. | -| **Write Request Topic** | MQTT topic to which the plugin subscribes for write requests. For data communication format, see [Upstream/Downstream Data Format](./api.md#write-tag) (since 2.4.5). If tracing is enabled, configure the user properties `traceparent` and `tracestate` according to the W3C standard. | -| **Write Response Topic** | MQTT topic to which the plugin sends write responses. (since 2.4.5) | +| **QoS Level** | MQTT QoS level for message delivery, optional, default QoS 0. | +| **Upload Format** | JSON format of reported data, a required field:

- *values-format*, data are split into `values` and `errors` sub-objects.
- *tags-format*, tag data are put in a single array.
- *ECP-format*：Add tag types on the basis of *tags-format*.
- *Custom*：Customize the reported data format.

For data communication format, see [Upstream/Downstream Data Format](./api.md#write-tag) | +| **Upload Tag Error Code** | When data tag collection reports an error, report the tag error code, default enabled. | +| **Write Request Topic** | MQTT topic to which the plugin subscribes for write requests. For data communication format, see [Upstream/Downstream Data Format](./api.md#write-tag) . If tracing is enabled, configure the user properties `traceparent` and `tracestate` according to the W3C standard. | +| **Write Response Topic** | MQTT topic to which the plugin sends write responses. | | **Driver Status Report** | Reports status of all the southbound nodes to the specified topic. | | **Status Report Topic** | The topic for status reporting. | -| **Status Report Interval** | The time interval for reporting the status of the southbound node, in seconds. The range is 1-3600, with a default of 1. | -| **Offline Data Caching** | Offline data caching switch. Cache MQTT messages when offline, and sync cached messages when back online. (Since 2.4.3) | +| **Status Report Interval** | The time interval for reporting the status of the southbound node, in seconds. The range is 1-3600, default 1. | +| **Offline Data Caching** | Offline data caching switch. Cache MQTT messages when offline, and sync cached messages when back online. | | **Cache Memory Size** | In-memory cache limit (MB) in case of communication failure, a required field. Range in [0, 1024]. Should not be larger than *Cache Disk Size*. For details about the cache feature, see [Offline Data Caching](#offline-data-caching) | | **Cache Disk Size** | In-disk cache limit (MB) in case of communication failure, a required field. Range in [0, 10240]. If nonzero, *cache-mem-size* should also be nonzero. | -| **Cache Sync Interval** | Time interval (MS) between each message to sync when communication restores. Range in [10, 120000]. (since 2.6.0) | +| **Cache Sync Interval** | Time interval (MS) between each message to sync when communication restores. Range in [10, 120000]. | | **Broker Host** | MQTT Broker host, a required field. | | **Broker Port** | MQTT Broker port number, a required field. | | **Username** | Username when connecting to the broker, optional. | diff --git a/en_US/configuration/south-devices/iec61850/overview.md b/en_US/configuration/south-devices/iec61850/overview.md index a61b2c6b..b2c5f73a 100644 --- a/en_US/configuration/south-devices/iec61850/overview.md +++ b/en_US/configuration/south-devices/iec61850/overview.md @@ -24,10 +24,39 @@ After clicking **Create**, you will be redirected to the **Device Configuration* | **GI Interval** | The interval at which the device sends a general interrogation. Set to 0 to disable general interrogation. Unit: seconds | ## Configure Data Groups and Tags -After the plug-in is added and configured, the next step is to establish communication between your device and Neuron by adding groups and tags to the Southbound driver. +After the plugin is added and configured, the next step is to establish communication between your device and IEC61850 driver by adding groups and tags to the Southbound driver. The IEC61850 plugin only supports the automatic addition of groups and tags by importing an SCL file. The Report block in the SCL file generates readable data groups, and the points are generated based on the referenced DataSet. Points are generated for data with FC as CO, SP, and SG. Writable points are generated in a separate Control group. +IEC61850 plugin defines a special data reporting structure according to industry standards, with timestamp and quality fields in addition to the point value. + +```json +{ + "timestamp": 1647497389075, + "node": "iec61850", + "group": "grp1", + "tags": [{ + "name": "tag1", + "value": 123, + "q": 3, + "t": 129401039041 + }, + { + "name": "tag2", + "value": 123, + "q": 3, + "t": 129401039088 + } + ] +} +``` + +::: tip + +Since the IEC61850 plugin uses a special data reporting structure, when selecting the data format for the northbound plugin, you need to select the **Tags-format** format. + +::: + ## Use Case You can access the LibIEC61850 server through the Neuron IEC61850 plugin. For specific steps, refer to [libiec61850](../iec61850/libiec61850.md). diff --git a/zh_CN/configuration/north-apps/mqtt/api.md b/zh_CN/configuration/north-apps/mqtt/api.md index 12685729..6e9305e7 100644 --- a/zh_CN/configuration/north-apps/mqtt/api.md +++ b/zh_CN/configuration/north-apps/mqtt/api.md @@ -1,51 +1,20 @@ # 数据上下行格式 -以下内容描述 Neuron MQTT 插件如何上报采集的数据，以及如何通过 MQTT 插件实现读写点位数据。 - -注意下文中涉及的 MQTT 主题中出现的 **{node_name}** 指代的是实际的 MQTT 北向节点名字， **{driver_name}** 指代南向驱动节点名字，**{group_name}** 指代南向节点下的组的名字。 +以下内容描述 MQTT 插件如何上报采集的数据，以及如何通过 MQTT 插件实现读写点位数据。 ## 数据上报 -Neuron MQTT 插件将采集到的数据以 JSON 形式发布到指定的主题。 +MQTT 插件将采集到的数据以 JSON 形式发布到指定的主题。 上报数据的具体格式由**上报数据格式**参数指定，有多种格式可选。 ### 上报主题 -上报主题在北向节点订阅中指定，其默认值为 **/neuron/{node_name}/{driver_name}/{group_name}** - -### Tags 格式 - -在 *tags-format* 格式中， 上报的数据由以下字段构成： -* `timestamp` : 数据采集时的 UNIX 时间戳。 -* `node` : 被采集的南向节点的名字。 -* `group` : 被采集的南向节点的点位组的名字。 -* `tags` : 点位数据数组，每个元素对应一个点位。 - - -以下为使用 *tags-format* 格式的数据样例，其中所有点位数据存放在一个数组中，每个数组元素包含点位的名字，采集成功时的数据值或者采集失败时的错误码。 - -```json -{ - "timestamp": 1647497389075, - "node": "modbus", - "group": "grp", - "tags": [ - { - "name": "tag0", - "value": 123, - }, - { - "name": "tag1", - "error": 2014 - } - ] -} -``` +上报主题在北向节点订阅中指定，其默认值为 **/neuron/{MQTT driver name}** ，见下图 -### Values 格式 +### Values-format 格式 -在 *values-format* 格式中， 上报的数据由以下字段构成： +在 **Values-format** 格式中， 上报的数据由以下字段构成： * `timestamp` : 数据采集时的 UNIX 时间戳。 * `node` : 被采集的南向节点的名字。 * `group` : 被采集的南向节点的点位组的名字。 @@ -53,8 +22,7 @@ Neuron MQTT 插件将采集到的数据以 JSON 形式发布到指定的主题 * `errors` : 存储采集失败的错误码的字典。 * `metas` : 驱动相关的元数据信息。 -以下为使用 **values-format** 格式的数据样例，采集成功的点位数据值存放在一个字典中，采集失败的点位错误码存放在另一个字典中。 - +以下为使用 **values-format** 格式的数据样例，采集成功的点位数据值存放在`values`键中，采集失败的点位错误码存放在`errors`键中。 ```json { "timestamp": 1650006388943, @@ -72,86 +40,62 @@ Neuron MQTT 插件将采集到的数据以 JSON 形式发布到指定的主题 } ``` -### 自定义格式 +::: tip 注意 -在自定义格式中，可以使用内置支持的变量自定义数据上报格式。 +当点位采集成功时，返回采集到的数据。当点位采集发生错误时，返回错误码，不再返回数值。 -#### 内置变量 +当 MQTT 插件配置项 **上报点位错误码** 为 **False** 时，不上报点位错误码。 +::: -| *变量名称* | *说明* | -| ------------------ | ---------------------- | -| `${timestamp}` | 数据采集时的 UNIX 时间戳。 | -| `${node}` | 被采集的南向节点的名字。 | -| `${group}` | 被采集的南向节点的点位组的名字。 | -| `${tags}` | 南向采集点位有效值的数组。 | -| `${tag_values}` | 南向采集点位有效值的数组，Value 格式。 | -| `${tag_errors}` | 南向采集点位报错的数组。 | -| `${tag_error_values}` | 南向采集点位报错的数组，Value 格式。 | -| `${static_tags}` | 订阅时自定义配置的静态点位。 | -| `${static_tag_values}` | 订阅时自定义配置的静态点位，Value 格式。 | - -#### 示例 - -自定义数据格式配置为： -```json -{ - "timestamp": "${timestamp}", - "node": "${node}", - "group": "${group}", - "tags": "${tags}", - "values": "${tag_values}", - "static_tags": "${static_tags}", - "static_tag_values": "${static_tag_values}", - "errors": "${tag_errors}", - "error_values": "${tag_error_values}" -} -``` +### Tags-format 格式 + +在 **Tags-format** 格式中， 上报的数据由以下字段构成： +* `timestamp` : 数据采集时的 UNIX 时间戳。 +* `node` : 被采集的南向节点的名字。 +* `group` : 被采集的南向节点的点位组的名字。 +* `tags` : 点位数据数组，每个元素对应一个点位。 +* `name` : 具体的点位名称字段。 +* `value` : 具体点位对应的值。 +* `error` : 具体点位对应的错误码。 + +以下为使用 **Tags-format** 格式的数据样例，其中所有点位数据存放在一个数组中，每个数组元素包含点位的名字，采集成功时的数据值或者采集失败时的错误码。 -数据上报的格式为： ```json { - "timestamp": 1650006388943, - "node": "modbus", - "group": "group", - "tags": [ - { - "name": "tag0", - "value": 123 - }, - { - "name": "tag1", - "value": false - } - ], - "values": {"tag0": 123, "tag1": false}, - "static_tags": [ - { - "name": "static_tag1", - "value": 456 - } - ], - "static_tag_values": {"static_tag1": 456}, - "errors": [ - { - "name": "tag2", - "error": 2014 - } - ], - "error_values": {"tag2": 2014} + "timestamp": 1647497389075, + "node": "modbus", + "group": "grp", + "tags": [ + { + "name": "tag0", + "value": 123, + }, + { + "name": "tag1", + "error": 2014 + } + ] } ``` -::: tip +::: tip 注意 + 当点位采集成功时，返回采集到的数据。当点位采集发生错误时，返回错误码，不再返回数值。 + +当 MQTT 插件配置项 **上报点位错误码** 为 **False** 时，不上报点位错误码。 ::: -### ECP 格式 +### ECP-format 格式 -在 *ECP-format* 格式中， 上报的数据由以下字段构成： +在 **ECP-format** 格式中， 上报的数据由以下字段构成： * `timestamp` : 数据采集时的 UNIX 时间戳。 * `node` : 被采集的南向节点的名字。 * `group` : 被采集的南向节点的点位组的名字。 * `tags` : 点位数据数组，每个元素对应一个点位。 +* `name` : 具体的点位名称字段。 +* `value` : 具体点位对应的值。 +* `type` : 具体点位对应的数据类型，共包含布尔、整型、浮点型、字符串四种数据类型。 + 以下为使用 *ECP-format* 格式的数据样例，其中所有点位数据存放在一个数组中，每个数组元素包含点位的名字，点位的数据类型和采集成功时的数据值，不包含采集失败的点位。 数据类分为布尔、整型、浮点型、字符串四种。 @@ -190,6 +134,176 @@ Neuron MQTT 插件将采集到的数据以 JSON 形式发布到指定的主题 } ``` +::: tip 注意 +ECP-format 格式不支持上报点位错误码。 +不管 MQTT 插件配置项 **上报点位错误码** 为 **False** 或为 **True** ，都不上报点位错误码。 +::: + +### Custom 自定义格式 + +在自定义格式中，可以使用内置支持的变量自定义数据上报格式。 + +#### 内置变量 + +| **变量名称** | **说明** | +| ------------------ | ---------------------- | +| `${timestamp}` | 数据采集时的 UNIX 时间戳。 | +| `${node}` | 南向采集点位所属的南向驱动名称。
示例：`modbus` | +| `${group}` | 南向采集点位所属的南向驱动的采集组的名称。
示例：`group` | +| `${tags}` | 南向采集点位有效值的数组集合。
示例：`[{"name": "tag1", "value": 123}, {"name": "tag2", "value": 456}]` | +| `${tag_values}` | 南向采集点位有效值的Json集合。
示例：`{"tag1": 123, "tag2": 456}` | +| `${tag_errors}` | 南向采集点位报错值的数组集合。
示例：`[{"name": "tag3", "error": 2014}, {"name": "tag4", "error": 2015}]` | +| `${tag_error_values}` | 南向采集点位报错值的Json集合。
示例：`{"tag3": 2014, "tag4": 2015}` | +| `${static_tags}` | 订阅采集组时，自定义配置的静态点位的数组集合。
示例： `[{"name": "static_tag1", "value": "abc"}, {"name": "static_tag2", "value": "def"}]`
详见 [静态点位](#静态点位)| +| `${static_tag_values}` | 订阅采集组时，自定义配置的静态点位的Json集合。
示例： `{"static_tag1": "abc", "static_tag2": "def"}`
详见 [静态点位](#静态点位) | + +::: tip 注意 +`${tags}` 和 `${tag_values}` 是采集数据点的2种不同格式，`${tags}` 是数组格式，`${tag_values}` 是Json格式。一般在构建自定义数据上报格式时，使用 `${tags}` 或 `${tag_values}` 中的一种即可。 + +`${static_tags}` 和 `${static_tag_values}`、`${tag_errors}`和`${tag_error_values}` 同理，使用其中一种即可。 + + MQTT 插件配置项 **上报点位错误码** 为 **False** 时，即使配置了`${tag_errors}` 和或 `${tag_error_values}`，也不上报点位错误码信息。 + +::: + + + +上表中示例部分，原始南向驱动`modbus1`采集组`group1`下，包含4个点位，其中`tag1`和`tag2`的点位采集数据正常，`tag3`和`tag4`的点位采集数据异常。在北向节点订阅时，自定义配置的静态点位为`static_tag1`和`static_tag2`，其值分别为`abc`和`def`。 + +以上配置，以 Values-format 数据格式上报时，内容如下： + + +```json +{ + "timestamp": 1650006388943, + "node": "modbus1", + "group": "group1", + "values": {"tag1": 123, "tag2": 456, "static_tag1": "abc", "static_tag2": "def"}, + "errors": {"tag3": 2014, "tag4": 2015}, + "metas":{} +} +``` + +以下示例通过设定不同的 Custom 配置，将上面 Json 报文输出为不同的数据上报格式。 +#### 示例一 + +将数据点位转换为数组格式，并自定义Json 键名。 + +```json +{ + "timestamp": "${timestamp}", + "node": "${node}", + "group": "${group}", + "custom_tag_name": "${tags}", + "custom_tag_errors": "${tag_errors}", +} +``` + +实际输出结果如下： + +```json +{ + "timestamp": 1650006388943, + "node": "modbus1", + "group": "group1", + "custom_tag_name": [{"name": "tag1", "value": 123}, {"name": "tag2", "value": 456}], + "custom_tag_errors": [{"name": "tag3", "error": 2014}, {"name": "tag4", "error": 2015}] +} +``` + +#### 示例二 + +通过自定义数据格式，添加全局静态点位。该静态点位在所有驱动采集组上报数据时，均会携带。如 NeuronEX 部署在一个物理网关上，可将网关的SN号、IP地址、位置信息等信息，添加到所有驱动采集组中。 + +```json +{ + "timestamp": "${timestamp}", + "node": "${node}", + "group": "${group}", + "values": "${tag_values}", + "gateway_info": { + "ip": "192.168.1.100", + "sn": "SN123456789", + "location": "shanghai" + } +} +``` +实际输出结果如下： + +```json +{ + "timestamp": 1650006388943, + "node": "modbus1", + "group": "group1", + "values": {"tag1": 123, "tag2": 456}, + "gateway_info": { + "ip": "192.168.1.100", + "sn": "SN123456789", + "location": "shanghai" + } +} +``` + +#### 示例三 + +将采集数据点位、静态点位、驱动、采集组信息放入 Json 子节点中，可自定义 Json 节点名称。目前自定义数据结构做多支持三层子层级。 + +```json +{ + "timestamp": "${timestamp}", + "data": { + "child_node": { + "node": "${node}", + "group": "${group}", + "tag_values": "${tag_values}", + "static_tag_values": "${static_tag_values}", + "tag_error_values": "${tag_error_values}" + } + } +} +``` + +数据上报的格式为： +```json +{ + "timestamp": 1650006388943, + "data": { + "child_node": { + "node": "modbus", + "group": "group", + "tag_values": {"tag1": 123, "tag2": 456}, + "static_tag_values": {"static_tag1": "abc", "static_tag2": "def"}, + "tag_error_values": {"tag3": 2014, "tag4": 2015} + } + } +} +``` + + +## 静态点位 + +静态点位功能，支持在南向驱动数据上报时，由用户在**北向应用组列表**页面手动配置静态点位，在数据上报时，将静态点位数据一并上报。 + +静态点位配置，需输入标准JSON格式内容，每个静态点位均为JSON对象中的键值对。静态点位将根据配置的数据上报格式（Values-format、Tags-format、ECP-format）与采集组数据一并上报。 + +```json + { + "location": "sh", + "sn_number": "123456" + } + +``` + +每个南向采集组，可分别配置不同静态点位。表示该采集组代表的物理设备，具有哪些静态属性信息。 + +静态点位功能支持布尔、整型、浮点型、字符串四种数据类型。复杂数据类型，如数组、结构体等，将以字符串形式上报。 + +如果添加的静态点位，为 NeuronEX 实例中所有采集组共用，既可以勾选**所有采集组**，添加静态点位，也可以在 Custom 自定义格式中，统一添加静态点位，参考 [自定义格式：示例二](#自定义格式)。 + +::: tip +静态点位命名，不能和南向驱动采集的点位名称相同。如相同，则静态点位数据将覆盖南向驱动采集的点位数据。 +::: + ## 读 Tags ### 请求 diff --git a/zh_CN/configuration/north-apps/mqtt/overview.md b/zh_CN/configuration/north-apps/mqtt/overview.md index 341ddf7a..927a51f7 100644 --- a/zh_CN/configuration/north-apps/mqtt/overview.md +++ b/zh_CN/configuration/north-apps/mqtt/overview.md @@ -23,17 +23,17 @@ Neuron 支持 MQTT 插件作为其数据汇聚上报的方式之一，Neuron MQT | **MQTT 版本** | MQTT 协议的版本，默认为 v3.1.1。 | | **客户端 ID** | MQTT 通信的客户端 id，必填。 | | **QoS 等级** | MQTT 通信的服务质量等级，可选，默认为 QoS 0 。 | -| **上报数据格式** | 上报数据的 JSON 格式：
· *values-format*：数据被分成 `values` 和 `errors` 的子对象。
· *tags-format*：数据被放在一个数组中。关于通信数据格式，见 [数据上下行格式](./api.md#数据上报)
· *ECP-format*：在 *tags-format* 的基础上增加数据类型。| -| **上报点位错误码** | 点位采集报错时，上报点位错误码。默认开启。 | +| **上报数据格式** | 上报数据的 JSON 格式：
· **values-format**：数据被分成 `values` 和 `errors` 的子对象。
· **tags-format**：数据被放在一个数组中。
· **ECP-format**：在 **tags-format** 的基础上增加数据类型。
· **Custom**：自定义上报数据格式。
关于通信数据格式，见 [数据上下行格式](./api.md#数据上报)| +| **上报点位错误码** | 点位采集报错时，上报点位错误码，默认开启。 | | **写请求主题** | 接收点位写入请求的 MQTT 主题。关于通信数据格式，见 [数据上下行格式](./api.md#写-tag)。如开启链路追踪，请按 W3C 标准配置用户属性 `traceparent` 和 `tracestate`。| | **写响应主题** | 发送点位写入响应的 MQTT 主题。 | | **驱动状态上报** | 上报所有南向驱动状态到指定的 MQTT 主题。 | | **状态上报主题** | 状态上报的主题。 | | **状态上报间隔** | 上报南向节点状态的时间间隔，单位为秒，可填范围为 1-3600，默认1 | -| **离线缓存** | 离线缓存开关。连接断开时缓存 MQTT 消息，连接重建时同步缓存的消息到MQTT服务器。（2.4.3 版新增），关于离线缓存功能的详细介绍，见[离线数据缓存](#离线数据缓存) | +| **离线缓存** | 离线缓存开关。连接断开时缓存 MQTT 消息，连接重建时同步缓存的消息到MQTT服务器。关于离线缓存功能的详细介绍，见[离线数据缓存](#离线数据缓存) | | **缓存内存大小** | 通信失败时内存消息缓存大小 (MB) 限制，必填；范围：[0, 1024]，不能大于缓存磁盘大小。 | | **缓存磁盘大小** | 通信失败时磁盘消息缓存大小 (MB) 限制，必填，范围：[0, 10240]。
设为非零值时，缓存内存大小 也须为非零值。 | -| **缓存消息重传间隔** | 通信恢复、消息重传时每条消息之间的时间间隔 (MS)，必填；范围：[10, 120000]. （2.6.0 版新增） | +| **缓存消息重传间隔** | 通信恢复、消息重传时每条消息之间的时间间隔 (MS)，必填；范围：[10, 120000] | | **服务器地址** | MQTT Broker 地址，必填。 | | **服务器端口** | MQTT Broker 端口号，必填。 | | **用户名** | 连接到 Broker 时使用的用户名，选填。 | diff --git a/zh_CN/configuration/south-devices/iec61850/overview.md b/zh_CN/configuration/south-devices/iec61850/overview.md index 040b61e7..48040a66 100644 --- a/zh_CN/configuration/south-devices/iec61850/overview.md +++ b/zh_CN/configuration/south-devices/iec61850/overview.md @@ -12,7 +12,7 @@ IEC61850 插件用于对 IEC61850 服务器的读/写，目前支持 MMS 协议 ## 设备配置 -点击插件卡片或插件列，进入**设备配置**页。配置 Neuron 与设备建立连接所需的参数，下表为插件相关的配置项。 +点击插件卡片或插件列，进入**设备配置**页。配置 IEC61850 驱动与设备建立连接所需的参数，下表为插件相关的配置项。 | 参数 | 说明 | | -------- | -------------------------- | @@ -22,10 +22,38 @@ IEC61850 插件用于对 IEC61850 服务器的读/写，目前支持 MMS 协议 ## 设置组和点位 -完成插件的添加和配置后，要建立设备与 Neuron 之间的通信，首先为南向驱动程序添加组和点位。 +完成插件的添加和配置后，要建立设备与驱动之间的通信，首先为南向驱动程序添加组和点位。 IEC61850 插件只支持通过导入 SCL 文件自动添加组与点位，SCL 文件中的 Report 块生成可读性数据组，根据引用的 DataSet 生成点位；根据 FC 为 CO、SP、SG 的数据生成可写点位，可写点位单独在一个 Control 组中。 +IEC61850 插件根据行业规范，单独定义了数据上报结构，在每个数据点位中，除了点位值外，还包含 timestamp、quality 字段。 + +```json +{ + "timestamp": 1647497389075, + "node": "iec61850", + "group": "grp1", + "tags": [{ + "name": "tag1", + "value": 123, + "q": 3, + "t": 129401039041 + }, + { + "name": "tag2", + "value": 123, + "q": 3, + "t": 129401039088 + } + ] +} +``` + +::: tip 注意 + +由于 IEC61850 插件采用特殊数据上报结构，所以在北向插件选择数据格式时，需要对应选择 **Tags-format** 格式。 +::: + ## 应用场景 您可通过 Neuron IEC61850 插件接入 LibIEC61850 服务器，具体步骤，见 [libiec61850](libiec61850.md)。