Neargrid MQTT 驱动程序

以下集成可用于通过 MQTT 发送现场测量数据，并接收对于不同设备类型的命令。

Python 演示脚本

请联系 Eniris 请求演示脚本。

前提条件

云控制器

现场将通过云控制器进行控制。请联系 Eniris 设置新的云控制器。

现场设置

创建云控制器后，它将包含唯一的序列号（<Controller SN>）。

可以使用唯一的现场过滤器 <site_filter> 在云控制器上生成新现场。

这两个变量必须在 MQTT 主题和正文中使用。

警告

使用相同的现场过滤器将导致错误。

设备选择

Device Type	支持
太阳能逆变器	✅
储能设备
热泵
电网与消费计量器
电动车充电器	❌

信息

现场中的设备在创建后无法编辑。

MQTT 凭证

Eniris 将提供 MQTT 凭证。生成新现场时必须输入 MQTT 用户名。

信息

凭证只能提供一次。一组 MQTT 凭证可用于控制所有现场。

发送测量数据

要将测量数据发送到 SmartgridOne Controller，可以使用以下 MQTT 主题进行发布：standard1/outbound/neargrid_meas/<site_filter>/<Controller SN>/

可选字段以斜体形式表示。

可以按设备类型发送以下字段：

储存
- mean_soc_perc
- active_power_W
- today_charged_Wh
- today_discharged_Wh
- energy_stored_Wh
太阳能
- active_power_W
- today_energy_Wh
热泵
- operation_modes
  - 可能的操作模式为 off, on
- active_power_W
  - 当热泵处于 on 时等于额定功率*
计量器
- active_power_W
- today_imported_energy_Wh
- today_exported_energy_Wh

消息必须按如下结构构建：

{
    "time": "<Unix 时间戳>",
    "data": {
        "state": {
            "grid": {
                "active_power_W": <电网有功功率（以瓦特为单位）>,
                "today_imported_energy_Wh": <电网进口能量（以瓦时为单位）>,
                "today_exported_energy_Wh": <电网出口能量（以瓦时为单位）>
            },
            "meter": {
                "active_power_W": <电网有功功率（以瓦特为单位）>,
                "today_imported_energy_Wh": <电网进口能量（以瓦时为单位）>,
                "today_exported_energy_Wh": <电网出口能量（以瓦时为单位）>
            },
            "storage": {
                "energy_stored_Wh": <存储能量（以瓦时为单位）>,
                "mean_soc_perc": <平均充电状态百分比>,
                "active_power_W": <有功功率（以瓦特为单位）>,
                "today_charged_Wh": <今天充电的能量（以瓦时为单位）>,
                "today_discharged_Wh": <今天放电的能量（以瓦时为单位）>
            },
            "solar": {
                "active_power_W": <太阳能有功功率（以瓦特为单位）>,
                "today_energy_Wh": <今天产生的能量（以瓦时为单位）>
            },
            "heat_pump": {
                "active_power_W": <热泵有功功率（以瓦特为单位）>,
                "operation_modes": <热泵操作模式>
            }
        },
        "response_code": <响应代码>
    },
    "fields": {},
    "requestTime": "<Unix 时间戳>",
    "time": "<Unix 时间戳>",
    "siteNodeId": "<site_filter"
}

测量确认

当测量成功接收时，将在以下主题上发送确认：standard1/rp_one_s/neargrid_ack/<site_filter>/<Controller SN>

此确认可用于：

验证测量消息是否成功接收。
验证测量消息是否包含所有必要数据。

接收命令

要从 SmartgridOne Controller 接收命令，请订阅以下 MQTT 主题：standard1/outbound/neargrid_cmd/<site_filter>/<Controller SN>/

响应的结构如下：

{
    "extraTags": {
        "nodeId": "<Controller SN>_site_0"
    },
    "time": "<Unix 时间戳>",
    "fields": {
        "solar_policy": "<policy>",
        "solar_power_setpoint_w": 5000,
        "storage_policy": "<policy>",
        "storage_power_setpoint_w": -5000
    }
}

可以接收的策略列表在此处找到：潜在策略列表

Python 演示脚本​

前提条件​

云控制器​

现场设置​

设备选择​

MQTT 凭证​

发送测量数据​

测量确认​