HomeWizard#

HomeWizard 平台的集成。它可以从 HomeWizard 产品本地收集数据，并在 Home Assistant 中创建为传感器。使用此集成，你可以监控电力、燃气和用水情况，从而优化能源使用。此集成收集的信息可用于 Energy dashboard。

#支持的设备

• P1 Meter：提供电力输入/输出、能耗（单相或三相），以及智能电表和燃气信息的传感器（型号：HWE-P1）
• Energy Socket：提供电力输入/输出和能耗传感器，以及用于控制插座的开关（型号：HWE-SKT）
• Watermeter：提供当前和总用水量传感器（型号：HWE-WTR）
• kWh Meter 1-Phase：提供电力输入/输出和能耗传感器（型号：HWE-KWH1、SDM230-wifi）
• kWh Meter 3-Phase：提供电力输入/输出和能耗传感器（型号：HWE-KWH3、SDM630-wifi）
• Plug-In Battery：提供电力输入/输出、能耗、发电量和荷电状态传感器（型号：HWE-BAT）

#启用 API

你必须启用本地 API，Home Assistant 才能与你的设备通信。请在 HomeWizard 应用中完成此操作：

1. 进入 Settings（右上角齿轮图标）。
2. 进入 Meters。
3. 选择你的设备。
4. 向下滚动并开启 Local API。

IP address:
  description: "设备的 IP 地址。你可以在路由器中找到它。"

#支持的功能

HomeWizard 集成会提供与你设备测量内容或运行状态相关的传感器。所有这些都会在 Home Assistant 中作为实体提供。下面概述此集成提供的实体。

#P1 Meter

并非所有智能电表都会提供全部传感器，集成中只会显示可用的传感器。

• Energy import/export (kWh)：自智能电表安装以来累计输入或输出的总电量。每个费率都有单独传感器（例如 T1、T2），同时也有一个合计值传感器
• Power (W)：当前测得的有功功率消耗，每个相位都有独立传感器。如果是在发电，传感器读数会为负值
• Voltage (V)：当前测得的电压，每个相位都有独立传感器
• Current (A)：当前测得的电流，每个相位都有独立传感器
• Tariff：当前使用的费率。你可以用它来尽量降低高峰时段的用电量
• Frequency (Hz)：电网频率
• Voltage sags and swells：检测到电压跌落或电压升高的次数
• Power failures：两个传感器用于指示智能电表检测到的停电次数，一个表示全部停电次数，另一个表示“长时间”停电次数
• Peak demand：比利时用户开始按每月峰值用电收费（参见 capaciteitstarief）。有两个传感器可用：一个显示当前季度平均值，另一个显示本月测得的峰值。两者都由智能电表直接提供，可用于尽量降低峰值
• Status light brightness：控制绿色状态灯的亮度。即使亮度设为 0，错误状态仍会被可视化显示

外部计量设备，如燃气表或水表，可以连接到智能电表。每个设备都会作为单独设备暴露，并带有各自的测量值。

#kWh Meter

• Energy import/export (kWh)：由 kWh Meter 测得的总输入或输出电量
• Power (W)：当前测得的有功功率消耗，每个相位都有独立传感器。如果是在发电，传感器读数会为负值
• Production power (W)：当前测得的发电功率。如果是在用电，读数会为负值。这个传感器可以在能源仪表板中作为太阳能发电功率传感器使用
• Voltage (V)：当前测得的电压，每个相位都有独立传感器
• Current (A)：当前测得的电流，每个相位都有独立传感器
• Frequency (Hz)：电网频率
• Reactive power (VAR)：当前测得的无功功率，每个相位都有独立传感器
• Apparent power (VA)：当前测得的视在功率，每个相位都有独立传感器

#Energy Socket

• Energy import/export (kWh)：由 Energy Socket 测得的总输入或输出电量
• Power (W)：当前测得的有功功率。如果是在发电，传感器读数会为负值
• Production power (W)：当前测得的发电功率。如果是在用电，读数会为负值。这个传感器可以在能源仪表板中作为太阳能发电功率传感器使用
• Voltage (V)：当前测得的电压
• Current (A)：当前测得的电流
• Frequency (Hz)：电网频率
• Reactive power (VAR)*：当前测得的无功功率
• Apparent power (VA)*：当前测得的视在功率

#Identify 按钮

你可以按下 identify 按钮，让状态灯闪烁几秒钟。 kWh Meter 不支持此功能。

#云通信

HomeWizard Energy 设备被设计为与 HomeWizard Energy 应用配合使用，并且需要与 HomeWizard 云通信，应用才能正常工作。你可以使用 “Cloud connection” 配置开关关闭所有与 HomeWizard 云的通信，从而让设备完全本地化。这样设备将无法再与应用通信，也无法接收未来的固件更新。

Plug-In Battery 不支持此功能。当你再次打开该开关时，云通信会恢复。恢复出厂设置或让设备进入配对模式后，云通信也会恢复。

#示例

#当洗衣机完成时发送通知

如果你了解洗衣机的功耗特征，可以创建一个自动化，在能耗低于某个阈值时发送通知。这样就能在洗衣机完成后提醒你。你可以使用下面这个 blueprint：

• Appliance Power Monitor Blueprint With Elapsed Time and Energy Used Variables，由 @Jhonattan-Souza 创建

#将能源数据添加到 Energy dashboard

HomeWizard Energy 集成提供的数据可用于 Energy dashboard。要将你的数据添加到 Energy dashboard，请参阅 Energy dashboard documentation。

#数据获取间隔

此集成每 5 秒轮询一次新数据。对设备发出的请求数量和频率没有限制。

如果你想自定义设备轮询数据的间隔，可以禁用默认轮询间隔并创建自己的轮询自动化。

1. 进入 Settings > Devices & services，选择你的集成。
2. 在集成条目上，选择 。
   • 然后，选择 System options 并关闭 polling。
3. 要定义自定义轮询间隔，创建一个自动化。
   • 进入 Settings > Automations & scenes 并创建新自动化。
   • 定义你需要的触发器和条件。
   • 选择 Add action，然后选择 Other actions。
   • 选择 Perform action，再从列表中选择 homeassistant.update_entity action。
   • 选择要更新的区域、设备、实体或标签。
4. 保存自动化。

#已知限制

#Watermeter 不能使用电池供电配合本集成

Watermeter 可以通过 USB-C 线缆供电，也可以使用电池供电。使用电池时，它只会每隔几个小时连接一次 Wi-Fi。因此，只有在通过 USB-C 线缆供电时才能使用 API。Watermeter 使用电池供电时，无法使用此集成。

#P1 Meter 可能更新较慢

P1 Meter 的更新取决于智能电表，而智能电表通常每 1 秒或 10 秒更新一次。这意味着 P1 Meter 的更新速度可能比其他设备慢。

#故障排除

#我的设备没有显示出来

如果你找不到设备，或者它们没有出现在集成设置中，可能由以下原因导致：

• 设备未连接到网络。你必须先通过 HomeWizard Energy 应用将新设备连接到网络
• 请确认设备已更新到最新固件。了解更新方法请参阅：How do I check if I have the latest software on my HomeWizard product?
• 请确认已在 HomeWizard Energy 应用的设备设置中启用本地 API
• 请确认 Home Assistant 和设备位于同一网络中

#配置设备时需要按哪个按钮？

1. 在设置过程中，系统可能会要求你按下设备上的一个按钮，以便设备与 Home Assistant 进行身份验证。
   • P1 Meter：按下 P1 Meter 正面的白色按钮。
   • Plug-In Battery：按下设备正面的黑色触摸按钮。你会听到一声蜂鸣。
   • kWh Meter：按住带有 Wi-Fi 图标的按钮两秒钟。在显示屏出现 AP 之前松开按钮。
   • Energy Socket 和 Watermeter：不需要这一步。
2. 按下按钮后，你必须在 30 秒内选择 Continue 以完成设置。
   • 如果设置超时，你可能需要再次按下按钮。

#I can't find entities like voltage, current, or battery group mode

某些实体默认处于禁用状态。你可以在集成设置中启用它们。更多信息请参阅启用或禁用实体。

#删除集成

此集成遵循标准的集成删除流程。

1. 进入 Settings > Devices & services 并选择集成卡片。
2. 从设备列表中，选择你要删除的集成实例。
3. 在条目旁边，选择三点 菜单，然后选择 Delete。

删除集成后，如果没有其他集成仍在使用本地 API，请前往 HomeWizard 应用并禁用本地 API。